diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml new file mode 100644 index 0000000000..a94a63b09e --- /dev/null +++ b/.github/ISSUE_TEMPLATE/config.yml @@ -0,0 +1,8 @@ +blank_issues_enabled: true +contact_links: + - name: Discord Python Polska + url: https://discord.com/invite/VCyBDGH38e + about: Dyskusje o tłumaczeniach. + - name: Transifex + url: https://explore.transifex.com/python-doc/python-newest/ + about: Strona do tłumaczenia. diff --git a/.github/ISSUE_TEMPLATE/typo.yml b/.github/ISSUE_TEMPLATE/typo.yml new file mode 100644 index 0000000000..ccd748c824 --- /dev/null +++ b/.github/ISSUE_TEMPLATE/typo.yml @@ -0,0 +1,36 @@ +name: Błąd w tłumaczeniu +description: Zgłoś błąd w tłumaczeniu +labels: ["bug"] +body: + - type: markdown + attributes: + value: | + **Chcesz to naprawić samemu??** + + - 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 znajdziesz w naszym (README)[https://github.com/python/python-docs-pl/blob/3.14/README.md]. + - type: textarea + attributes: + label: "Opis błędu:" + description: > + Opisz szczegółowo lokalizację błędu. + validations: + required: true + - type: dropdown + attributes: + label: "Wersja dokumentacji:" + multiple: true + options: + - "3.9" + - "3.10" + - "3.11" + - "3.12" + - "3.13" + - "3.14" + validations: + required: false diff --git a/.github/workflows/update-lint-and-build.yml b/.github/workflows/update-lint-and-build.yml deleted file mode 100644 index 0e955283ca..0000000000 --- a/.github/workflows/update-lint-and-build.yml +++ /dev/null @@ -1,140 +0,0 @@ -name: Translation and Linting Workflow - -on: - schedule: - - cron: '0 * * * *' - push: - branches: - - '*' - workflow_dispatch: - -jobs: - update-translation: - runs-on: ubuntu-latest - strategy: - fail-fast: false - matrix: - version: [3.13, 3.12, 3.11, '3.10', 3.9] - steps: - - uses: styfle/cancel-workflow-action@main - with: - access_token: ${{ secrets.GITHUB_TOKEN }} - - uses: actions/setup-python@master - with: - python-version: 3 - - name: Install dependencies - run: | - sudo apt-get install -y gettext - pip install requests cogapp polib transifex-python sphinx-intl blurb six - curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash - working-directory: /usr/local/bin - - uses: actions/checkout@master - with: - ref: ${{ matrix.version }} - fetch-depth: 0 - - name: Recreate Transifex config - run: ./manage_translation.py recreate_tx_config - env: - TX_TOKEN: ${{ secrets.TX_TOKEN }} - - name: Fetch translations - run: ./manage_translation.py fetch - env: - TX_TOKEN: ${{ secrets.TX_TOKEN }} - - name: Update README.md - run: python -Werror -m cogapp -rP README.md - if: ${{ hashFiles('README.md') != '' }} - env: - TX_TOKEN: ${{ secrets.TX_TOKEN }} - - name: Update README.en.md - run: python -Werror -m cogapp -rP README.en.md - if: ${{ hashFiles('README.en.md') != '' }} - env: - TX_TOKEN: ${{ secrets.TX_TOKEN }} - - run: git config --local user.email github-actions@github.com - - run: git config --local user.name "GitHub Action's update-translation job" - - name: Check changes significance - run: | - ! git diff -I'^"POT-Creation-Date: ' \ - -I'^"Language-Team: ' \ - -I'^# ' -I'^"Last-Translator: ' \ - --exit-code \ - && echo "SIGNIFICANT_CHANGES=1" >> $GITHUB_ENV || exit 0 - - run: git add . - - run: git commit -m 'Update translation from Transifex' - if: env.SIGNIFICANT_CHANGES - - name: Push commit - uses: ad-m/github-push-action@master - if: env.SIGNIFICANT_CHANGES - with: - branch: ${{ matrix.version }} - github_token: ${{ secrets.GITHUB_TOKEN }} - - lint: - runs-on: ubuntu-latest - strategy: - fail-fast: false - matrix: - version: [3.13, 3.12, 3.11] - needs: ['update-translation'] - continue-on-error: true - steps: - - uses: actions/setup-python@master - with: - python-version: 3 - - run: pip install sphinx-lint - - uses: actions/checkout@master - with: - ref: ${{ matrix.version }} - - uses: rffontenelle/sphinx-lint-problem-matcher@v1.0.0 - - run: sphinx-lint - - build-translation: - runs-on: ubuntu-latest - strategy: - fail-fast: false - matrix: - version: [3.13, 3.12, 3.11, '3.10', 3.9, 3.8] - format: [html, latex] - needs: ['update-translation'] - steps: - - uses: actions/setup-python@master - with: - python-version: 3.12 # pin for Sphinx 3.4.3 in 3.10 branch (see #63) - - uses: actions/checkout@master - with: - repository: python/cpython - ref: ${{ matrix.version }} - - run: make venv - working-directory: ./Doc - - uses: actions/checkout@master - with: - ref: ${{ matrix.version }} - path: Doc/locales/pl/LC_MESSAGES - - run: git pull - working-directory: ./Doc/locales/pl/LC_MESSAGES - - uses: sphinx-doc/github-problem-matcher@v1.1 - - run: make -e SPHINXOPTS="--color -D language='pl' -W --keep-going" ${{ matrix.format }} - working-directory: ./Doc - - uses: actions/upload-artifact@master - if: success() || failure() - with: - name: build-${{ matrix.version }}-${{ matrix.format }} - path: Doc/build/${{ matrix.format }} - - output-pdf: - runs-on: ubuntu-latest - strategy: - matrix: - version: [3.13, 3.12, 3.11, '3.10', 3.9, 3.8] - needs: ['build-translation'] - steps: - - uses: actions/download-artifact@master - with: - name: build-${{ matrix.version }}-latex - - run: sudo apt-get update - - run: sudo apt-get install -y latexmk texlive-xetex fonts-freefont-otf xindy - - run: make - - uses: actions/upload-artifact@master - with: - name: build-${{ matrix.version }}-pdf - path: . diff --git a/.tx/config b/.tx/config index 7af31da39e..c940961290 100644 --- a/.tx/config +++ b/.tx/config @@ -1,7 +1,7 @@ [main] host = https://www.transifex.com -[o:python-doc:p:python-newest:r:about] +[o:python-doc:p:python-313:r:about] file_filter = about.po source_file = gettext/about.pot type = PO @@ -10,7 +10,7 @@ resource_name = about replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:bugs] +[o:python-doc:p:python-313:r:bugs] file_filter = bugs.po source_file = gettext/bugs.pot type = PO @@ -19,7 +19,52 @@ resource_name = bugs replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--abstract] +[o:python-doc:p:python-313:r:builtins--constants] +file_filter = builtins/constants.po +source_file = gettext/builtins/constants.pot +type = PO +minimum_perc = 0 +resource_name = builtins--constants +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:builtins--exceptions] +file_filter = builtins/exceptions.po +source_file = gettext/builtins/exceptions.pot +type = PO +minimum_perc = 0 +resource_name = builtins--exceptions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:builtins--functions] +file_filter = builtins/functions.po +source_file = gettext/builtins/functions.pot +type = PO +minimum_perc = 0 +resource_name = builtins--functions +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:builtins--index] +file_filter = builtins/index.po +source_file = gettext/builtins/index.pot +type = PO +minimum_perc = 0 +resource_name = builtins--index +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:builtins--stdtypes] +file_filter = builtins/stdtypes.po +source_file = gettext/builtins/stdtypes.pot +type = PO +minimum_perc = 0 +resource_name = builtins--stdtypes +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:c-api--abstract] file_filter = c-api/abstract.po source_file = gettext/c-api/abstract.pot type = PO @@ -28,7 +73,7 @@ resource_name = c-api--abstract replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--allocation] +[o:python-doc:p:python-313:r:c-api--allocation] file_filter = c-api/allocation.po source_file = gettext/c-api/allocation.pot type = PO @@ -37,7 +82,7 @@ resource_name = c-api--allocation replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--apiabiversion] +[o:python-doc:p:python-313:r:c-api--apiabiversion] file_filter = c-api/apiabiversion.po source_file = gettext/c-api/apiabiversion.pot type = PO @@ -46,7 +91,7 @@ resource_name = c-api--apiabiversion replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--arg] +[o:python-doc:p:python-313:r:c-api--arg] file_filter = c-api/arg.po source_file = gettext/c-api/arg.pot type = PO @@ -55,7 +100,7 @@ resource_name = c-api--arg replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--bool] +[o:python-doc:p:python-313:r:c-api--bool] file_filter = c-api/bool.po source_file = gettext/c-api/bool.pot type = PO @@ -64,7 +109,7 @@ resource_name = c-api--bool replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--buffer] +[o:python-doc:p:python-313:r:c-api--buffer] file_filter = c-api/buffer.po source_file = gettext/c-api/buffer.pot type = PO @@ -73,7 +118,7 @@ resource_name = c-api--buffer replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--bytearray] +[o:python-doc:p:python-313:r:c-api--bytearray] file_filter = c-api/bytearray.po source_file = gettext/c-api/bytearray.pot type = PO @@ -82,7 +127,7 @@ resource_name = c-api--bytearray replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--bytes] +[o:python-doc:p:python-313:r:c-api--bytes] file_filter = c-api/bytes.po source_file = gettext/c-api/bytes.pot type = PO @@ -91,7 +136,7 @@ resource_name = c-api--bytes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--call] +[o:python-doc:p:python-313:r:c-api--call] file_filter = c-api/call.po source_file = gettext/c-api/call.pot type = PO @@ -100,7 +145,7 @@ resource_name = c-api--call replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--capsule] +[o:python-doc:p:python-313:r:c-api--capsule] file_filter = c-api/capsule.po source_file = gettext/c-api/capsule.pot type = PO @@ -109,7 +154,7 @@ resource_name = c-api--capsule replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--cell] +[o:python-doc:p:python-313:r:c-api--cell] file_filter = c-api/cell.po source_file = gettext/c-api/cell.pot type = PO @@ -118,7 +163,7 @@ resource_name = c-api--cell replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--code] +[o:python-doc:p:python-313:r:c-api--code] file_filter = c-api/code.po source_file = gettext/c-api/code.pot type = PO @@ -127,7 +172,7 @@ resource_name = c-api--code replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--codec] +[o:python-doc:p:python-313:r:c-api--codec] file_filter = c-api/codec.po source_file = gettext/c-api/codec.pot type = PO @@ -136,7 +181,7 @@ resource_name = c-api--codec replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--complex] +[o:python-doc:p:python-313:r:c-api--complex] file_filter = c-api/complex.po source_file = gettext/c-api/complex.pot type = PO @@ -145,7 +190,7 @@ resource_name = c-api--complex replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--concrete] +[o:python-doc:p:python-313:r:c-api--concrete] file_filter = c-api/concrete.po source_file = gettext/c-api/concrete.pot type = PO @@ -154,7 +199,7 @@ resource_name = c-api--concrete replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--contextvars] +[o:python-doc:p:python-313:r:c-api--contextvars] file_filter = c-api/contextvars.po source_file = gettext/c-api/contextvars.pot type = PO @@ -163,7 +208,7 @@ resource_name = c-api--contextvars replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--conversion] +[o:python-doc:p:python-313:r:c-api--conversion] file_filter = c-api/conversion.po source_file = gettext/c-api/conversion.pot type = PO @@ -172,7 +217,7 @@ resource_name = c-api--conversion replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--coro] +[o:python-doc:p:python-313:r:c-api--coro] file_filter = c-api/coro.po source_file = gettext/c-api/coro.pot type = PO @@ -181,7 +226,16 @@ resource_name = c-api--coro replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--datetime] +[o:python-doc:p:python-313:r:c-api--curses] +file_filter = c-api/curses.po +source_file = gettext/c-api/curses.pot +type = PO +minimum_perc = 0 +resource_name = c-api--curses +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:c-api--datetime] file_filter = c-api/datetime.po source_file = gettext/c-api/datetime.pot type = PO @@ -190,7 +244,7 @@ resource_name = c-api--datetime replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--descriptor] +[o:python-doc:p:python-313:r:c-api--descriptor] file_filter = c-api/descriptor.po source_file = gettext/c-api/descriptor.pot type = PO @@ -199,7 +253,7 @@ resource_name = c-api--descriptor replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--dict] +[o:python-doc:p:python-313:r:c-api--dict] file_filter = c-api/dict.po source_file = gettext/c-api/dict.pot type = PO @@ -208,7 +262,7 @@ resource_name = c-api--dict replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--exceptions] +[o:python-doc:p:python-313:r:c-api--exceptions] file_filter = c-api/exceptions.po source_file = gettext/c-api/exceptions.pot type = PO @@ -217,7 +271,7 @@ resource_name = c-api--exceptions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--file] +[o:python-doc:p:python-313:r:c-api--file] file_filter = c-api/file.po source_file = gettext/c-api/file.pot type = PO @@ -226,7 +280,7 @@ resource_name = c-api--file replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--float] +[o:python-doc:p:python-313:r:c-api--float] file_filter = c-api/float.po source_file = gettext/c-api/float.pot type = PO @@ -235,7 +289,7 @@ resource_name = c-api--float replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--frame] +[o:python-doc:p:python-313:r:c-api--frame] file_filter = c-api/frame.po source_file = gettext/c-api/frame.pot type = PO @@ -244,7 +298,7 @@ resource_name = c-api--frame replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--function] +[o:python-doc:p:python-313:r:c-api--function] file_filter = c-api/function.po source_file = gettext/c-api/function.pot type = PO @@ -253,7 +307,7 @@ resource_name = c-api--function replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--gcsupport] +[o:python-doc:p:python-313:r:c-api--gcsupport] file_filter = c-api/gcsupport.po source_file = gettext/c-api/gcsupport.pot type = PO @@ -262,7 +316,7 @@ resource_name = c-api--gcsupport replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--gen] +[o:python-doc:p:python-313:r:c-api--gen] file_filter = c-api/gen.po source_file = gettext/c-api/gen.pot type = PO @@ -271,7 +325,7 @@ resource_name = c-api--gen replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--hash] +[o:python-doc:p:python-313:r:c-api--hash] file_filter = c-api/hash.po source_file = gettext/c-api/hash.pot type = PO @@ -280,7 +334,7 @@ resource_name = c-api--hash replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--import] +[o:python-doc:p:python-313:r:c-api--import] file_filter = c-api/import.po source_file = gettext/c-api/import.pot type = PO @@ -289,7 +343,7 @@ resource_name = c-api--import replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--index] +[o:python-doc:p:python-313:r:c-api--index] file_filter = c-api/index.po source_file = gettext/c-api/index.pot type = PO @@ -298,7 +352,7 @@ resource_name = c-api--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--init] +[o:python-doc:p:python-313:r:c-api--init] file_filter = c-api/init.po source_file = gettext/c-api/init.pot type = PO @@ -307,7 +361,7 @@ resource_name = c-api--init replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--init_config] +[o:python-doc:p:python-313:r:c-api--init_config] file_filter = c-api/init_config.po source_file = gettext/c-api/init_config.pot type = PO @@ -316,7 +370,7 @@ resource_name = c-api--init_config replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--intro] +[o:python-doc:p:python-313:r:c-api--intro] file_filter = c-api/intro.po source_file = gettext/c-api/intro.pot type = PO @@ -325,7 +379,7 @@ resource_name = c-api--intro replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--iter] +[o:python-doc:p:python-313:r:c-api--iter] file_filter = c-api/iter.po source_file = gettext/c-api/iter.pot type = PO @@ -334,7 +388,7 @@ resource_name = c-api--iter replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--iterator] +[o:python-doc:p:python-313:r:c-api--iterator] file_filter = c-api/iterator.po source_file = gettext/c-api/iterator.pot type = PO @@ -343,7 +397,7 @@ resource_name = c-api--iterator replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--list] +[o:python-doc:p:python-313:r:c-api--list] file_filter = c-api/list.po source_file = gettext/c-api/list.pot type = PO @@ -352,7 +406,7 @@ resource_name = c-api--list replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--long] +[o:python-doc:p:python-313:r:c-api--long] file_filter = c-api/long.po source_file = gettext/c-api/long.pot type = PO @@ -361,7 +415,7 @@ resource_name = c-api--long replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--mapping] +[o:python-doc:p:python-313:r:c-api--mapping] file_filter = c-api/mapping.po source_file = gettext/c-api/mapping.pot type = PO @@ -370,7 +424,7 @@ resource_name = c-api--mapping replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--marshal] +[o:python-doc:p:python-313:r:c-api--marshal] file_filter = c-api/marshal.po source_file = gettext/c-api/marshal.pot type = PO @@ -379,7 +433,7 @@ resource_name = c-api--marshal replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--memory] +[o:python-doc:p:python-313:r:c-api--memory] file_filter = c-api/memory.po source_file = gettext/c-api/memory.pot type = PO @@ -388,7 +442,7 @@ resource_name = c-api--memory replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--memoryview] +[o:python-doc:p:python-313:r:c-api--memoryview] file_filter = c-api/memoryview.po source_file = gettext/c-api/memoryview.pot type = PO @@ -397,7 +451,7 @@ resource_name = c-api--memoryview replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--method] +[o:python-doc:p:python-313:r:c-api--method] file_filter = c-api/method.po source_file = gettext/c-api/method.pot type = PO @@ -406,7 +460,7 @@ resource_name = c-api--method replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--module] +[o:python-doc:p:python-313:r:c-api--module] file_filter = c-api/module.po source_file = gettext/c-api/module.pot type = PO @@ -415,7 +469,7 @@ resource_name = c-api--module replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--monitoring] +[o:python-doc:p:python-313:r:c-api--monitoring] file_filter = c-api/monitoring.po source_file = gettext/c-api/monitoring.pot type = PO @@ -424,7 +478,7 @@ resource_name = c-api--monitoring replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--none] +[o:python-doc:p:python-313:r:c-api--none] file_filter = c-api/none.po source_file = gettext/c-api/none.pot type = PO @@ -433,7 +487,7 @@ resource_name = c-api--none replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--number] +[o:python-doc:p:python-313:r:c-api--number] file_filter = c-api/number.po source_file = gettext/c-api/number.pot type = PO @@ -442,7 +496,7 @@ resource_name = c-api--number replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--object] +[o:python-doc:p:python-313:r:c-api--object] file_filter = c-api/object.po source_file = gettext/c-api/object.pot type = PO @@ -451,7 +505,7 @@ resource_name = c-api--object replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--objimpl] +[o:python-doc:p:python-313:r:c-api--objimpl] file_filter = c-api/objimpl.po source_file = gettext/c-api/objimpl.pot type = PO @@ -460,7 +514,7 @@ resource_name = c-api--objimpl replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--perfmaps] +[o:python-doc:p:python-313:r:c-api--perfmaps] file_filter = c-api/perfmaps.po source_file = gettext/c-api/perfmaps.pot type = PO @@ -469,7 +523,16 @@ resource_name = c-api--perfmaps replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--refcounting] +[o:python-doc:p:python-313:r:c-api--picklebuffer] +file_filter = c-api/picklebuffer.po +source_file = gettext/c-api/picklebuffer.pot +type = PO +minimum_perc = 0 +resource_name = c-api--picklebuffer +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:c-api--refcounting] file_filter = c-api/refcounting.po source_file = gettext/c-api/refcounting.pot type = PO @@ -478,7 +541,7 @@ resource_name = c-api--refcounting replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--reflection] +[o:python-doc:p:python-313:r:c-api--reflection] file_filter = c-api/reflection.po source_file = gettext/c-api/reflection.pot type = PO @@ -487,7 +550,7 @@ resource_name = c-api--reflection replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--sequence] +[o:python-doc:p:python-313:r:c-api--sequence] file_filter = c-api/sequence.po source_file = gettext/c-api/sequence.pot type = PO @@ -496,7 +559,7 @@ resource_name = c-api--sequence replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--set] +[o:python-doc:p:python-313:r:c-api--set] file_filter = c-api/set.po source_file = gettext/c-api/set.pot type = PO @@ -505,7 +568,7 @@ resource_name = c-api--set replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--slice] +[o:python-doc:p:python-313:r:c-api--slice] file_filter = c-api/slice.po source_file = gettext/c-api/slice.pot type = PO @@ -514,7 +577,7 @@ resource_name = c-api--slice replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--stable] +[o:python-doc:p:python-313:r:c-api--stable] file_filter = c-api/stable.po source_file = gettext/c-api/stable.pot type = PO @@ -523,7 +586,7 @@ resource_name = c-api--stable replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--structures] +[o:python-doc:p:python-313:r:c-api--structures] file_filter = c-api/structures.po source_file = gettext/c-api/structures.pot type = PO @@ -532,7 +595,7 @@ resource_name = c-api--structures replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--sys] +[o:python-doc:p:python-313:r:c-api--sys] file_filter = c-api/sys.po source_file = gettext/c-api/sys.pot type = PO @@ -541,7 +604,7 @@ resource_name = c-api--sys replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--time] +[o:python-doc:p:python-313:r:c-api--time] file_filter = c-api/time.po source_file = gettext/c-api/time.pot type = PO @@ -550,7 +613,7 @@ resource_name = c-api--time replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--tuple] +[o:python-doc:p:python-313:r:c-api--tuple] file_filter = c-api/tuple.po source_file = gettext/c-api/tuple.pot type = PO @@ -559,7 +622,7 @@ resource_name = c-api--tuple replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--type] +[o:python-doc:p:python-313:r:c-api--type] file_filter = c-api/type.po source_file = gettext/c-api/type.pot type = PO @@ -568,7 +631,7 @@ resource_name = c-api--type replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--typehints] +[o:python-doc:p:python-313:r:c-api--typehints] file_filter = c-api/typehints.po source_file = gettext/c-api/typehints.pot type = PO @@ -577,7 +640,7 @@ resource_name = c-api--typehints replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--typeobj] +[o:python-doc:p:python-313:r:c-api--typeobj] file_filter = c-api/typeobj.po source_file = gettext/c-api/typeobj.pot type = PO @@ -586,7 +649,7 @@ resource_name = c-api--typeobj replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--unicode] +[o:python-doc:p:python-313:r:c-api--unicode] file_filter = c-api/unicode.po source_file = gettext/c-api/unicode.pot type = PO @@ -595,7 +658,7 @@ resource_name = c-api--unicode replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--utilities] +[o:python-doc:p:python-313:r:c-api--utilities] file_filter = c-api/utilities.po source_file = gettext/c-api/utilities.pot type = PO @@ -604,7 +667,7 @@ resource_name = c-api--utilities replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--veryhigh] +[o:python-doc:p:python-313:r:c-api--veryhigh] file_filter = c-api/veryhigh.po source_file = gettext/c-api/veryhigh.pot type = PO @@ -613,7 +676,7 @@ resource_name = c-api--veryhigh replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:c-api--weakref] +[o:python-doc:p:python-313:r:c-api--weakref] file_filter = c-api/weakref.po source_file = gettext/c-api/weakref.pot type = PO @@ -622,7 +685,7 @@ resource_name = c-api--weakref replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:contents] +[o:python-doc:p:python-313:r:contents] file_filter = contents.po source_file = gettext/contents.pot type = PO @@ -631,7 +694,7 @@ resource_name = contents replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:copyright] +[o:python-doc:p:python-313:r:copyright] file_filter = copyright.po source_file = gettext/copyright.pot type = PO @@ -640,7 +703,7 @@ resource_name = copyright replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--c-api-pending-removal-in-3_14] +[o:python-doc:p:python-313:r:deprecations--c-api-pending-removal-in-3_14] file_filter = deprecations/c-api-pending-removal-in-3.14.po source_file = gettext/deprecations/c-api-pending-removal-in-3.14.pot type = PO @@ -649,7 +712,7 @@ resource_name = deprecations--c-api-pending-removal-in-3_14 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--c-api-pending-removal-in-3_15] +[o:python-doc:p:python-313:r:deprecations--c-api-pending-removal-in-3_15] file_filter = deprecations/c-api-pending-removal-in-3.15.po source_file = gettext/deprecations/c-api-pending-removal-in-3.15.pot type = PO @@ -658,7 +721,16 @@ resource_name = deprecations--c-api-pending-removal-in-3_15 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--c-api-pending-removal-in-future] +[o:python-doc:p:python-313:r:deprecations--c-api-pending-removal-in-3_16] +file_filter = deprecations/c-api-pending-removal-in-3.16.po +source_file = gettext/deprecations/c-api-pending-removal-in-3.16.pot +type = PO +minimum_perc = 0 +resource_name = deprecations--c-api-pending-removal-in-3_16 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:deprecations--c-api-pending-removal-in-future] file_filter = deprecations/c-api-pending-removal-in-future.po source_file = gettext/deprecations/c-api-pending-removal-in-future.pot type = PO @@ -667,7 +739,7 @@ resource_name = deprecations--c-api-pending-removal-in-future replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--index] +[o:python-doc:p:python-313:r:deprecations--index] file_filter = deprecations/index.po source_file = gettext/deprecations/index.pot type = PO @@ -676,7 +748,7 @@ resource_name = deprecations--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_13] +[o:python-doc:p:python-313:r:deprecations--pending-removal-in-3_13] file_filter = deprecations/pending-removal-in-3.13.po source_file = gettext/deprecations/pending-removal-in-3.13.pot type = PO @@ -685,7 +757,7 @@ resource_name = deprecations--pending-removal-in-3_13 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_14] +[o:python-doc:p:python-313:r:deprecations--pending-removal-in-3_14] file_filter = deprecations/pending-removal-in-3.14.po source_file = gettext/deprecations/pending-removal-in-3.14.pot type = PO @@ -694,7 +766,7 @@ resource_name = deprecations--pending-removal-in-3_14 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_15] +[o:python-doc:p:python-313:r:deprecations--pending-removal-in-3_15] file_filter = deprecations/pending-removal-in-3.15.po source_file = gettext/deprecations/pending-removal-in-3.15.pot type = PO @@ -703,7 +775,7 @@ resource_name = deprecations--pending-removal-in-3_15 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-3_16] +[o:python-doc:p:python-313:r:deprecations--pending-removal-in-3_16] file_filter = deprecations/pending-removal-in-3.16.po source_file = gettext/deprecations/pending-removal-in-3.16.pot type = PO @@ -712,7 +784,25 @@ resource_name = deprecations--pending-removal-in-3_16 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:deprecations--pending-removal-in-future] +[o:python-doc:p:python-313:r:deprecations--pending-removal-in-3_17] +file_filter = deprecations/pending-removal-in-3.17.po +source_file = gettext/deprecations/pending-removal-in-3.17.pot +type = PO +minimum_perc = 0 +resource_name = deprecations--pending-removal-in-3_17 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:deprecations--pending-removal-in-3_18] +file_filter = deprecations/pending-removal-in-3.18.po +source_file = gettext/deprecations/pending-removal-in-3.18.pot +type = PO +minimum_perc = 0 +resource_name = deprecations--pending-removal-in-3_18 +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:deprecations--pending-removal-in-future] file_filter = deprecations/pending-removal-in-future.po source_file = gettext/deprecations/pending-removal-in-future.pot type = PO @@ -721,7 +811,7 @@ resource_name = deprecations--pending-removal-in-future replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:distributing--index] +[o:python-doc:p:python-313:r:distributing--index] file_filter = distributing/index.po source_file = gettext/distributing/index.pot type = PO @@ -730,7 +820,7 @@ resource_name = distributing--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--building] +[o:python-doc:p:python-313:r:extending--building] file_filter = extending/building.po source_file = gettext/extending/building.pot type = PO @@ -739,7 +829,7 @@ resource_name = extending--building replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--embedding] +[o:python-doc:p:python-313:r:extending--embedding] file_filter = extending/embedding.po source_file = gettext/extending/embedding.pot type = PO @@ -748,7 +838,7 @@ resource_name = extending--embedding replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--extending] +[o:python-doc:p:python-313:r:extending--extending] file_filter = extending/extending.po source_file = gettext/extending/extending.pot type = PO @@ -757,7 +847,7 @@ resource_name = extending--extending replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--index] +[o:python-doc:p:python-313:r:extending--index] file_filter = extending/index.po source_file = gettext/extending/index.pot type = PO @@ -766,7 +856,7 @@ resource_name = extending--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--newtypes] +[o:python-doc:p:python-313:r:extending--newtypes] file_filter = extending/newtypes.po source_file = gettext/extending/newtypes.pot type = PO @@ -775,7 +865,7 @@ resource_name = extending--newtypes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--newtypes_tutorial] +[o:python-doc:p:python-313:r:extending--newtypes_tutorial] file_filter = extending/newtypes_tutorial.po source_file = gettext/extending/newtypes_tutorial.pot type = PO @@ -784,7 +874,7 @@ resource_name = extending--newtypes_tutorial replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:extending--windows] +[o:python-doc:p:python-313:r:extending--windows] file_filter = extending/windows.po source_file = gettext/extending/windows.pot type = PO @@ -793,7 +883,7 @@ resource_name = extending--windows replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--design] +[o:python-doc:p:python-313:r:faq--design] file_filter = faq/design.po source_file = gettext/faq/design.pot type = PO @@ -802,7 +892,7 @@ resource_name = faq--design replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--extending] +[o:python-doc:p:python-313:r:faq--extending] file_filter = faq/extending.po source_file = gettext/faq/extending.pot type = PO @@ -811,7 +901,7 @@ resource_name = faq--extending replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--general] +[o:python-doc:p:python-313:r:faq--general] file_filter = faq/general.po source_file = gettext/faq/general.pot type = PO @@ -820,7 +910,7 @@ resource_name = faq--general replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--gui] +[o:python-doc:p:python-313:r:faq--gui] file_filter = faq/gui.po source_file = gettext/faq/gui.pot type = PO @@ -829,7 +919,7 @@ resource_name = faq--gui replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--index] +[o:python-doc:p:python-313:r:faq--index] file_filter = faq/index.po source_file = gettext/faq/index.pot type = PO @@ -838,7 +928,7 @@ resource_name = faq--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--installed] +[o:python-doc:p:python-313:r:faq--installed] file_filter = faq/installed.po source_file = gettext/faq/installed.pot type = PO @@ -847,7 +937,7 @@ resource_name = faq--installed replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--library] +[o:python-doc:p:python-313:r:faq--library] file_filter = faq/library.po source_file = gettext/faq/library.pot type = PO @@ -856,7 +946,7 @@ resource_name = faq--library replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--programming] +[o:python-doc:p:python-313:r:faq--programming] file_filter = faq/programming.po source_file = gettext/faq/programming.pot type = PO @@ -865,7 +955,7 @@ resource_name = faq--programming replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:faq--windows] +[o:python-doc:p:python-313:r:faq--windows] file_filter = faq/windows.po source_file = gettext/faq/windows.pot type = PO @@ -874,7 +964,7 @@ resource_name = faq--windows replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:glossary_] +[o:python-doc:p:python-313:r:glossary_] file_filter = glossary.po source_file = gettext/glossary.pot type = PO @@ -883,7 +973,16 @@ resource_name = glossary_ replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--annotations] +[o:python-doc:p:python-313:r:howto--a-conceptual-overview-of-asyncio] +file_filter = howto/a-conceptual-overview-of-asyncio.po +source_file = gettext/howto/a-conceptual-overview-of-asyncio.pot +type = PO +minimum_perc = 0 +resource_name = howto--a-conceptual-overview-of-asyncio +replace_edited_strings = false +keep_translations = false + +[o:python-doc:p:python-313:r:howto--annotations] file_filter = howto/annotations.po source_file = gettext/howto/annotations.pot type = PO @@ -892,7 +991,7 @@ resource_name = howto--annotations replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--argparse] +[o:python-doc:p:python-313:r:howto--argparse] file_filter = howto/argparse.po source_file = gettext/howto/argparse.pot type = PO @@ -901,7 +1000,7 @@ resource_name = howto--argparse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--argparse-optparse] +[o:python-doc:p:python-313:r:howto--argparse-optparse] file_filter = howto/argparse-optparse.po source_file = gettext/howto/argparse-optparse.pot type = PO @@ -910,7 +1009,7 @@ resource_name = howto--argparse-optparse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--clinic] +[o:python-doc:p:python-313:r:howto--clinic] file_filter = howto/clinic.po source_file = gettext/howto/clinic.pot type = PO @@ -919,7 +1018,7 @@ resource_name = howto--clinic replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--cporting] +[o:python-doc:p:python-313:r:howto--cporting] file_filter = howto/cporting.po source_file = gettext/howto/cporting.pot type = PO @@ -928,7 +1027,7 @@ resource_name = howto--cporting replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--curses] +[o:python-doc:p:python-313:r:howto--curses] file_filter = howto/curses.po source_file = gettext/howto/curses.pot type = PO @@ -937,7 +1036,7 @@ resource_name = howto--curses replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--descriptor] +[o:python-doc:p:python-313:r:howto--descriptor] file_filter = howto/descriptor.po source_file = gettext/howto/descriptor.pot type = PO @@ -946,7 +1045,7 @@ resource_name = howto--descriptor replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--enum] +[o:python-doc:p:python-313:r:howto--enum] file_filter = howto/enum.po source_file = gettext/howto/enum.pot type = PO @@ -955,7 +1054,7 @@ resource_name = howto--enum replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--free-threading-extensions] +[o:python-doc:p:python-313:r:howto--free-threading-extensions] file_filter = howto/free-threading-extensions.po source_file = gettext/howto/free-threading-extensions.pot type = PO @@ -964,7 +1063,7 @@ resource_name = howto--free-threading-extensions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--free-threading-python] +[o:python-doc:p:python-313:r:howto--free-threading-python] file_filter = howto/free-threading-python.po source_file = gettext/howto/free-threading-python.pot type = PO @@ -973,7 +1072,7 @@ resource_name = howto--free-threading-python replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--functional] +[o:python-doc:p:python-313:r:howto--functional] file_filter = howto/functional.po source_file = gettext/howto/functional.pot type = PO @@ -982,7 +1081,7 @@ resource_name = howto--functional replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--gdb_helpers] +[o:python-doc:p:python-313:r:howto--gdb_helpers] file_filter = howto/gdb_helpers.po source_file = gettext/howto/gdb_helpers.pot type = PO @@ -991,7 +1090,7 @@ resource_name = howto--gdb_helpers replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--index] +[o:python-doc:p:python-313:r:howto--index] file_filter = howto/index.po source_file = gettext/howto/index.pot type = PO @@ -1000,7 +1099,7 @@ resource_name = howto--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--instrumentation] +[o:python-doc:p:python-313:r:howto--instrumentation] file_filter = howto/instrumentation.po source_file = gettext/howto/instrumentation.pot type = PO @@ -1009,7 +1108,7 @@ resource_name = howto--instrumentation replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--ipaddress] +[o:python-doc:p:python-313:r:howto--ipaddress] file_filter = howto/ipaddress.po source_file = gettext/howto/ipaddress.pot type = PO @@ -1018,7 +1117,7 @@ resource_name = howto--ipaddress replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--isolating-extensions] +[o:python-doc:p:python-313:r:howto--isolating-extensions] file_filter = howto/isolating-extensions.po source_file = gettext/howto/isolating-extensions.pot type = PO @@ -1027,7 +1126,7 @@ resource_name = howto--isolating-extensions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--logging] +[o:python-doc:p:python-313:r:howto--logging] file_filter = howto/logging.po source_file = gettext/howto/logging.pot type = PO @@ -1036,7 +1135,7 @@ resource_name = howto--logging replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--logging-cookbook] +[o:python-doc:p:python-313:r:howto--logging-cookbook] file_filter = howto/logging-cookbook.po source_file = gettext/howto/logging-cookbook.pot type = PO @@ -1045,7 +1144,7 @@ resource_name = howto--logging-cookbook replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--mro] +[o:python-doc:p:python-313:r:howto--mro] file_filter = howto/mro.po source_file = gettext/howto/mro.pot type = PO @@ -1054,7 +1153,7 @@ resource_name = howto--mro replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--perf_profiling] +[o:python-doc:p:python-313:r:howto--perf_profiling] file_filter = howto/perf_profiling.po source_file = gettext/howto/perf_profiling.pot type = PO @@ -1063,7 +1162,7 @@ resource_name = howto--perf_profiling replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--pyporting] +[o:python-doc:p:python-313:r:howto--pyporting] file_filter = howto/pyporting.po source_file = gettext/howto/pyporting.pot type = PO @@ -1072,7 +1171,7 @@ resource_name = howto--pyporting replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--regex] +[o:python-doc:p:python-313:r:howto--regex] file_filter = howto/regex.po source_file = gettext/howto/regex.pot type = PO @@ -1081,7 +1180,7 @@ resource_name = howto--regex replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--sockets] +[o:python-doc:p:python-313:r:howto--sockets] file_filter = howto/sockets.po source_file = gettext/howto/sockets.pot type = PO @@ -1090,7 +1189,7 @@ resource_name = howto--sockets replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--sorting] +[o:python-doc:p:python-313:r:howto--sorting] file_filter = howto/sorting.po source_file = gettext/howto/sorting.pot type = PO @@ -1099,7 +1198,7 @@ resource_name = howto--sorting replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--timerfd] +[o:python-doc:p:python-313:r:howto--timerfd] file_filter = howto/timerfd.po source_file = gettext/howto/timerfd.pot type = PO @@ -1108,7 +1207,7 @@ resource_name = howto--timerfd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--unicode] +[o:python-doc:p:python-313:r:howto--unicode] file_filter = howto/unicode.po source_file = gettext/howto/unicode.pot type = PO @@ -1117,7 +1216,7 @@ resource_name = howto--unicode replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:howto--urllib2] +[o:python-doc:p:python-313:r:howto--urllib2] file_filter = howto/urllib2.po source_file = gettext/howto/urllib2.pot type = PO @@ -1126,7 +1225,7 @@ resource_name = howto--urllib2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:installing--index] +[o:python-doc:p:python-313:r:installing--index] file_filter = installing/index.po source_file = gettext/installing/index.pot type = PO @@ -1135,7 +1234,7 @@ resource_name = installing--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--__future__] +[o:python-doc:p:python-313:r:library--__future__] file_filter = library/__future__.po source_file = gettext/library/__future__.pot type = PO @@ -1144,7 +1243,7 @@ resource_name = library--__future__ replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--__main__] +[o:python-doc:p:python-313:r:library--__main__] file_filter = library/__main__.po source_file = gettext/library/__main__.pot type = PO @@ -1153,7 +1252,7 @@ resource_name = library--__main__ replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--_thread] +[o:python-doc:p:python-313:r:library--_thread] file_filter = library/_thread.po source_file = gettext/library/_thread.pot type = PO @@ -1162,7 +1261,7 @@ resource_name = library--_thread replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--abc] +[o:python-doc:p:python-313:r:library--abc] file_filter = library/abc.po source_file = gettext/library/abc.pot type = PO @@ -1171,7 +1270,7 @@ resource_name = library--abc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--aifc] +[o:python-doc:p:python-313:r:library--aifc] file_filter = library/aifc.po source_file = gettext/library/aifc.pot type = PO @@ -1180,7 +1279,7 @@ resource_name = library--aifc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--allos] +[o:python-doc:p:python-313:r:library--allos] file_filter = library/allos.po source_file = gettext/library/allos.pot type = PO @@ -1189,7 +1288,7 @@ resource_name = library--allos replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--archiving] +[o:python-doc:p:python-313:r:library--archiving] file_filter = library/archiving.po source_file = gettext/library/archiving.pot type = PO @@ -1198,7 +1297,7 @@ resource_name = library--archiving replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--argparse] +[o:python-doc:p:python-313:r:library--argparse] file_filter = library/argparse.po source_file = gettext/library/argparse.pot type = PO @@ -1207,7 +1306,7 @@ resource_name = library--argparse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--array] +[o:python-doc:p:python-313:r:library--array] file_filter = library/array.po source_file = gettext/library/array.pot type = PO @@ -1216,7 +1315,7 @@ resource_name = library--array replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ast] +[o:python-doc:p:python-313:r:library--ast] file_filter = library/ast.po source_file = gettext/library/ast.pot type = PO @@ -1225,7 +1324,7 @@ resource_name = library--ast replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asynchat] +[o:python-doc:p:python-313:r:library--asynchat] file_filter = library/asynchat.po source_file = gettext/library/asynchat.pot type = PO @@ -1234,7 +1333,7 @@ resource_name = library--asynchat replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio] +[o:python-doc:p:python-313:r:library--asyncio] file_filter = library/asyncio.po source_file = gettext/library/asyncio.pot type = PO @@ -1243,7 +1342,7 @@ resource_name = library--asyncio replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-api-index] +[o:python-doc:p:python-313:r:library--asyncio-api-index] file_filter = library/asyncio-api-index.po source_file = gettext/library/asyncio-api-index.pot type = PO @@ -1252,7 +1351,7 @@ resource_name = library--asyncio-api-index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-dev] +[o:python-doc:p:python-313:r:library--asyncio-dev] file_filter = library/asyncio-dev.po source_file = gettext/library/asyncio-dev.pot type = PO @@ -1261,7 +1360,7 @@ resource_name = library--asyncio-dev replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-eventloop] +[o:python-doc:p:python-313:r:library--asyncio-eventloop] file_filter = library/asyncio-eventloop.po source_file = gettext/library/asyncio-eventloop.pot type = PO @@ -1270,7 +1369,7 @@ resource_name = library--asyncio-eventloop replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-exceptions] +[o:python-doc:p:python-313:r:library--asyncio-exceptions] file_filter = library/asyncio-exceptions.po source_file = gettext/library/asyncio-exceptions.pot type = PO @@ -1279,7 +1378,7 @@ resource_name = library--asyncio-exceptions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-extending] +[o:python-doc:p:python-313:r:library--asyncio-extending] file_filter = library/asyncio-extending.po source_file = gettext/library/asyncio-extending.pot type = PO @@ -1288,7 +1387,7 @@ resource_name = library--asyncio-extending replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-future] +[o:python-doc:p:python-313:r:library--asyncio-future] file_filter = library/asyncio-future.po source_file = gettext/library/asyncio-future.pot type = PO @@ -1297,7 +1396,7 @@ resource_name = library--asyncio-future replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-llapi-index] +[o:python-doc:p:python-313:r:library--asyncio-llapi-index] file_filter = library/asyncio-llapi-index.po source_file = gettext/library/asyncio-llapi-index.pot type = PO @@ -1306,7 +1405,7 @@ resource_name = library--asyncio-llapi-index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-platforms] +[o:python-doc:p:python-313:r:library--asyncio-platforms] file_filter = library/asyncio-platforms.po source_file = gettext/library/asyncio-platforms.pot type = PO @@ -1315,7 +1414,7 @@ resource_name = library--asyncio-platforms replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-policy] +[o:python-doc:p:python-313:r:library--asyncio-policy] file_filter = library/asyncio-policy.po source_file = gettext/library/asyncio-policy.pot type = PO @@ -1324,7 +1423,7 @@ resource_name = library--asyncio-policy replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-protocol] +[o:python-doc:p:python-313:r:library--asyncio-protocol] file_filter = library/asyncio-protocol.po source_file = gettext/library/asyncio-protocol.pot type = PO @@ -1333,7 +1432,7 @@ resource_name = library--asyncio-protocol replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-queue] +[o:python-doc:p:python-313:r:library--asyncio-queue] file_filter = library/asyncio-queue.po source_file = gettext/library/asyncio-queue.pot type = PO @@ -1342,7 +1441,7 @@ resource_name = library--asyncio-queue replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-runner] +[o:python-doc:p:python-313:r:library--asyncio-runner] file_filter = library/asyncio-runner.po source_file = gettext/library/asyncio-runner.pot type = PO @@ -1351,7 +1450,7 @@ resource_name = library--asyncio-runner replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-stream] +[o:python-doc:p:python-313:r:library--asyncio-stream] file_filter = library/asyncio-stream.po source_file = gettext/library/asyncio-stream.pot type = PO @@ -1360,7 +1459,7 @@ resource_name = library--asyncio-stream replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-subprocess] +[o:python-doc:p:python-313:r:library--asyncio-subprocess] file_filter = library/asyncio-subprocess.po source_file = gettext/library/asyncio-subprocess.pot type = PO @@ -1369,7 +1468,7 @@ resource_name = library--asyncio-subprocess replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-sync] +[o:python-doc:p:python-313:r:library--asyncio-sync] file_filter = library/asyncio-sync.po source_file = gettext/library/asyncio-sync.pot type = PO @@ -1378,7 +1477,7 @@ resource_name = library--asyncio-sync replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncio-task] +[o:python-doc:p:python-313:r:library--asyncio-task] file_filter = library/asyncio-task.po source_file = gettext/library/asyncio-task.pot type = PO @@ -1387,7 +1486,7 @@ resource_name = library--asyncio-task replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--asyncore] +[o:python-doc:p:python-313:r:library--asyncore] file_filter = library/asyncore.po source_file = gettext/library/asyncore.pot type = PO @@ -1396,7 +1495,7 @@ resource_name = library--asyncore replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--atexit] +[o:python-doc:p:python-313:r:library--atexit] file_filter = library/atexit.po source_file = gettext/library/atexit.pot type = PO @@ -1405,7 +1504,7 @@ resource_name = library--atexit replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--audioop] +[o:python-doc:p:python-313:r:library--audioop] file_filter = library/audioop.po source_file = gettext/library/audioop.pot type = PO @@ -1414,7 +1513,7 @@ resource_name = library--audioop replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--audit_events] +[o:python-doc:p:python-313:r:library--audit_events] file_filter = library/audit_events.po source_file = gettext/library/audit_events.pot type = PO @@ -1423,7 +1522,7 @@ resource_name = library--audit_events replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--base64] +[o:python-doc:p:python-313:r:library--base64] file_filter = library/base64.po source_file = gettext/library/base64.pot type = PO @@ -1432,7 +1531,7 @@ resource_name = library--base64 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--bdb] +[o:python-doc:p:python-313:r:library--bdb] file_filter = library/bdb.po source_file = gettext/library/bdb.pot type = PO @@ -1441,7 +1540,7 @@ resource_name = library--bdb replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--binary] +[o:python-doc:p:python-313:r:library--binary] file_filter = library/binary.po source_file = gettext/library/binary.pot type = PO @@ -1450,7 +1549,7 @@ resource_name = library--binary replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--binascii] +[o:python-doc:p:python-313:r:library--binascii] file_filter = library/binascii.po source_file = gettext/library/binascii.pot type = PO @@ -1459,7 +1558,7 @@ resource_name = library--binascii replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--bisect] +[o:python-doc:p:python-313:r:library--bisect] file_filter = library/bisect.po source_file = gettext/library/bisect.pot type = PO @@ -1468,7 +1567,7 @@ resource_name = library--bisect replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--builtins] +[o:python-doc:p:python-313:r:library--builtins] file_filter = library/builtins.po source_file = gettext/library/builtins.pot type = PO @@ -1477,7 +1576,7 @@ resource_name = library--builtins replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--bz2] +[o:python-doc:p:python-313:r:library--bz2] file_filter = library/bz2.po source_file = gettext/library/bz2.pot type = PO @@ -1486,7 +1585,7 @@ resource_name = library--bz2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--calendar] +[o:python-doc:p:python-313:r:library--calendar] file_filter = library/calendar.po source_file = gettext/library/calendar.pot type = PO @@ -1495,7 +1594,7 @@ resource_name = library--calendar replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cgi] +[o:python-doc:p:python-313:r:library--cgi] file_filter = library/cgi.po source_file = gettext/library/cgi.pot type = PO @@ -1504,7 +1603,7 @@ resource_name = library--cgi replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cgitb] +[o:python-doc:p:python-313:r:library--cgitb] file_filter = library/cgitb.po source_file = gettext/library/cgitb.pot type = PO @@ -1513,7 +1612,7 @@ resource_name = library--cgitb replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--chunk] +[o:python-doc:p:python-313:r:library--chunk] file_filter = library/chunk.po source_file = gettext/library/chunk.pot type = PO @@ -1522,7 +1621,7 @@ resource_name = library--chunk replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cmath] +[o:python-doc:p:python-313:r:library--cmath] file_filter = library/cmath.po source_file = gettext/library/cmath.pot type = PO @@ -1531,7 +1630,7 @@ resource_name = library--cmath replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cmd] +[o:python-doc:p:python-313:r:library--cmd] file_filter = library/cmd.po source_file = gettext/library/cmd.pot type = PO @@ -1540,7 +1639,7 @@ resource_name = library--cmd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cmdline] +[o:python-doc:p:python-313:r:library--cmdline] file_filter = library/cmdline.po source_file = gettext/library/cmdline.pot type = PO @@ -1549,7 +1648,7 @@ resource_name = library--cmdline replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--cmdlinelibs] +[o:python-doc:p:python-313:r:library--cmdlinelibs] file_filter = library/cmdlinelibs.po source_file = gettext/library/cmdlinelibs.pot type = PO @@ -1558,7 +1657,7 @@ resource_name = library--cmdlinelibs replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--code] +[o:python-doc:p:python-313:r:library--code] file_filter = library/code.po source_file = gettext/library/code.pot type = PO @@ -1567,7 +1666,7 @@ resource_name = library--code replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--codecs] +[o:python-doc:p:python-313:r:library--codecs] file_filter = library/codecs.po source_file = gettext/library/codecs.pot type = PO @@ -1576,7 +1675,7 @@ resource_name = library--codecs replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--codeop] +[o:python-doc:p:python-313:r:library--codeop] file_filter = library/codeop.po source_file = gettext/library/codeop.pot type = PO @@ -1585,7 +1684,7 @@ resource_name = library--codeop replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--collections] +[o:python-doc:p:python-313:r:library--collections] file_filter = library/collections.po source_file = gettext/library/collections.pot type = PO @@ -1594,7 +1693,7 @@ resource_name = library--collections replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--collections_abc] +[o:python-doc:p:python-313:r:library--collections_abc] file_filter = library/collections.abc.po source_file = gettext/library/collections.abc.pot type = PO @@ -1603,7 +1702,7 @@ resource_name = library--collections_abc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--colorsys] +[o:python-doc:p:python-313:r:library--colorsys] file_filter = library/colorsys.po source_file = gettext/library/colorsys.pot type = PO @@ -1612,7 +1711,7 @@ resource_name = library--colorsys replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--compileall] +[o:python-doc:p:python-313:r:library--compileall] file_filter = library/compileall.po source_file = gettext/library/compileall.pot type = PO @@ -1621,7 +1720,7 @@ resource_name = library--compileall replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--concurrency] +[o:python-doc:p:python-313:r:library--concurrency] file_filter = library/concurrency.po source_file = gettext/library/concurrency.pot type = PO @@ -1630,7 +1729,7 @@ resource_name = library--concurrency replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--concurrent] +[o:python-doc:p:python-313:r:library--concurrent] file_filter = library/concurrent.po source_file = gettext/library/concurrent.pot type = PO @@ -1639,7 +1738,7 @@ resource_name = library--concurrent replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--concurrent_futures] +[o:python-doc:p:python-313:r:library--concurrent_futures] file_filter = library/concurrent.futures.po source_file = gettext/library/concurrent.futures.pot type = PO @@ -1648,7 +1747,7 @@ resource_name = library--concurrent_futures replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--configparser] +[o:python-doc:p:python-313:r:library--configparser] file_filter = library/configparser.po source_file = gettext/library/configparser.pot type = PO @@ -1657,16 +1756,7 @@ resource_name = library--configparser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--constants] -file_filter = library/constants.po -source_file = gettext/library/constants.pot -type = PO -minimum_perc = 0 -resource_name = library--constants -replace_edited_strings = false -keep_translations = false - -[o:python-doc:p:python-newest:r:library--contextlib] +[o:python-doc:p:python-313:r:library--contextlib] file_filter = library/contextlib.po source_file = gettext/library/contextlib.pot type = PO @@ -1675,7 +1765,7 @@ resource_name = library--contextlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--contextvars] +[o:python-doc:p:python-313:r:library--contextvars] file_filter = library/contextvars.po source_file = gettext/library/contextvars.pot type = PO @@ -1684,7 +1774,7 @@ resource_name = library--contextvars replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--copy] +[o:python-doc:p:python-313:r:library--copy] file_filter = library/copy.po source_file = gettext/library/copy.pot type = PO @@ -1693,7 +1783,7 @@ resource_name = library--copy replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--copyreg] +[o:python-doc:p:python-313:r:library--copyreg] file_filter = library/copyreg.po source_file = gettext/library/copyreg.pot type = PO @@ -1702,7 +1792,7 @@ resource_name = library--copyreg replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--crypt] +[o:python-doc:p:python-313:r:library--crypt] file_filter = library/crypt.po source_file = gettext/library/crypt.pot type = PO @@ -1711,7 +1801,7 @@ resource_name = library--crypt replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--crypto] +[o:python-doc:p:python-313:r:library--crypto] file_filter = library/crypto.po source_file = gettext/library/crypto.pot type = PO @@ -1720,7 +1810,7 @@ resource_name = library--crypto replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--csv] +[o:python-doc:p:python-313:r:library--csv] file_filter = library/csv.po source_file = gettext/library/csv.pot type = PO @@ -1729,7 +1819,7 @@ resource_name = library--csv replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ctypes] +[o:python-doc:p:python-313:r:library--ctypes] file_filter = library/ctypes.po source_file = gettext/library/ctypes.pot type = PO @@ -1738,7 +1828,7 @@ resource_name = library--ctypes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--curses] +[o:python-doc:p:python-313:r:library--curses] file_filter = library/curses.po source_file = gettext/library/curses.pot type = PO @@ -1747,7 +1837,7 @@ resource_name = library--curses replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--curses_ascii] +[o:python-doc:p:python-313:r:library--curses_ascii] file_filter = library/curses.ascii.po source_file = gettext/library/curses.ascii.pot type = PO @@ -1756,7 +1846,7 @@ resource_name = library--curses_ascii replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--curses_panel] +[o:python-doc:p:python-313:r:library--curses_panel] file_filter = library/curses.panel.po source_file = gettext/library/curses.panel.pot type = PO @@ -1765,7 +1855,7 @@ resource_name = library--curses_panel replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--custominterp] +[o:python-doc:p:python-313:r:library--custominterp] file_filter = library/custominterp.po source_file = gettext/library/custominterp.pot type = PO @@ -1774,7 +1864,7 @@ resource_name = library--custominterp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--dataclasses] +[o:python-doc:p:python-313:r:library--dataclasses] file_filter = library/dataclasses.po source_file = gettext/library/dataclasses.pot type = PO @@ -1783,7 +1873,7 @@ resource_name = library--dataclasses replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--datatypes] +[o:python-doc:p:python-313:r:library--datatypes] file_filter = library/datatypes.po source_file = gettext/library/datatypes.pot type = PO @@ -1792,7 +1882,7 @@ resource_name = library--datatypes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--datetime] +[o:python-doc:p:python-313:r:library--datetime] file_filter = library/datetime.po source_file = gettext/library/datetime.pot type = PO @@ -1801,7 +1891,7 @@ resource_name = library--datetime replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--dbm] +[o:python-doc:p:python-313:r:library--dbm] file_filter = library/dbm.po source_file = gettext/library/dbm.pot type = PO @@ -1810,7 +1900,7 @@ resource_name = library--dbm replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--debug] +[o:python-doc:p:python-313:r:library--debug] file_filter = library/debug.po source_file = gettext/library/debug.pot type = PO @@ -1819,7 +1909,7 @@ resource_name = library--debug replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--decimal] +[o:python-doc:p:python-313:r:library--decimal] file_filter = library/decimal.po source_file = gettext/library/decimal.pot type = PO @@ -1828,7 +1918,7 @@ resource_name = library--decimal replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--development] +[o:python-doc:p:python-313:r:library--development] file_filter = library/development.po source_file = gettext/library/development.pot type = PO @@ -1837,7 +1927,7 @@ resource_name = library--development replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--devmode] +[o:python-doc:p:python-313:r:library--devmode] file_filter = library/devmode.po source_file = gettext/library/devmode.pot type = PO @@ -1846,7 +1936,7 @@ resource_name = library--devmode replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--dialog] +[o:python-doc:p:python-313:r:library--dialog] file_filter = library/dialog.po source_file = gettext/library/dialog.pot type = PO @@ -1855,7 +1945,7 @@ resource_name = library--dialog replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--difflib] +[o:python-doc:p:python-313:r:library--difflib] file_filter = library/difflib.po source_file = gettext/library/difflib.pot type = PO @@ -1864,7 +1954,7 @@ resource_name = library--difflib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--dis] +[o:python-doc:p:python-313:r:library--dis] file_filter = library/dis.po source_file = gettext/library/dis.pot type = PO @@ -1873,7 +1963,7 @@ resource_name = library--dis replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--distribution] +[o:python-doc:p:python-313:r:library--distribution] file_filter = library/distribution.po source_file = gettext/library/distribution.pot type = PO @@ -1882,7 +1972,7 @@ resource_name = library--distribution replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--distutils] +[o:python-doc:p:python-313:r:library--distutils] file_filter = library/distutils.po source_file = gettext/library/distutils.pot type = PO @@ -1891,7 +1981,7 @@ resource_name = library--distutils replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--doctest] +[o:python-doc:p:python-313:r:library--doctest] file_filter = library/doctest.po source_file = gettext/library/doctest.pot type = PO @@ -1900,7 +1990,7 @@ resource_name = library--doctest replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email] +[o:python-doc:p:python-313:r:library--email] file_filter = library/email.po source_file = gettext/library/email.pot type = PO @@ -1909,7 +1999,7 @@ resource_name = library--email replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_charset] +[o:python-doc:p:python-313:r:library--email_charset] file_filter = library/email.charset.po source_file = gettext/library/email.charset.pot type = PO @@ -1918,7 +2008,7 @@ resource_name = library--email_charset replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_compat32-message] +[o:python-doc:p:python-313:r:library--email_compat32-message] file_filter = library/email.compat32-message.po source_file = gettext/library/email.compat32-message.pot type = PO @@ -1927,7 +2017,7 @@ resource_name = library--email_compat32-message replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_contentmanager] +[o:python-doc:p:python-313:r:library--email_contentmanager] file_filter = library/email.contentmanager.po source_file = gettext/library/email.contentmanager.pot type = PO @@ -1936,7 +2026,7 @@ resource_name = library--email_contentmanager replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_encoders] +[o:python-doc:p:python-313:r:library--email_encoders] file_filter = library/email.encoders.po source_file = gettext/library/email.encoders.pot type = PO @@ -1945,7 +2035,7 @@ resource_name = library--email_encoders replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_errors] +[o:python-doc:p:python-313:r:library--email_errors] file_filter = library/email.errors.po source_file = gettext/library/email.errors.pot type = PO @@ -1954,7 +2044,7 @@ resource_name = library--email_errors replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_examples] +[o:python-doc:p:python-313:r:library--email_examples] file_filter = library/email.examples.po source_file = gettext/library/email.examples.pot type = PO @@ -1963,7 +2053,7 @@ resource_name = library--email_examples replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_generator] +[o:python-doc:p:python-313:r:library--email_generator] file_filter = library/email.generator.po source_file = gettext/library/email.generator.pot type = PO @@ -1972,7 +2062,7 @@ resource_name = library--email_generator replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_header] +[o:python-doc:p:python-313:r:library--email_header] file_filter = library/email.header.po source_file = gettext/library/email.header.pot type = PO @@ -1981,7 +2071,7 @@ resource_name = library--email_header replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_headerregistry] +[o:python-doc:p:python-313:r:library--email_headerregistry] file_filter = library/email.headerregistry.po source_file = gettext/library/email.headerregistry.pot type = PO @@ -1990,7 +2080,7 @@ resource_name = library--email_headerregistry replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_iterators] +[o:python-doc:p:python-313:r:library--email_iterators] file_filter = library/email.iterators.po source_file = gettext/library/email.iterators.pot type = PO @@ -1999,7 +2089,7 @@ resource_name = library--email_iterators replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_message] +[o:python-doc:p:python-313:r:library--email_message] file_filter = library/email.message.po source_file = gettext/library/email.message.pot type = PO @@ -2008,7 +2098,7 @@ resource_name = library--email_message replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_mime] +[o:python-doc:p:python-313:r:library--email_mime] file_filter = library/email.mime.po source_file = gettext/library/email.mime.pot type = PO @@ -2017,7 +2107,7 @@ resource_name = library--email_mime replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_parser] +[o:python-doc:p:python-313:r:library--email_parser] file_filter = library/email.parser.po source_file = gettext/library/email.parser.pot type = PO @@ -2026,7 +2116,7 @@ resource_name = library--email_parser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_policy] +[o:python-doc:p:python-313:r:library--email_policy] file_filter = library/email.policy.po source_file = gettext/library/email.policy.pot type = PO @@ -2035,7 +2125,7 @@ resource_name = library--email_policy replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--email_utils] +[o:python-doc:p:python-313:r:library--email_utils] file_filter = library/email.utils.po source_file = gettext/library/email.utils.pot type = PO @@ -2044,7 +2134,7 @@ resource_name = library--email_utils replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ensurepip] +[o:python-doc:p:python-313:r:library--ensurepip] file_filter = library/ensurepip.po source_file = gettext/library/ensurepip.pot type = PO @@ -2053,7 +2143,7 @@ resource_name = library--ensurepip replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--enum] +[o:python-doc:p:python-313:r:library--enum] file_filter = library/enum.po source_file = gettext/library/enum.pot type = PO @@ -2062,7 +2152,7 @@ resource_name = library--enum replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--errno] +[o:python-doc:p:python-313:r:library--errno] file_filter = library/errno.po source_file = gettext/library/errno.pot type = PO @@ -2071,16 +2161,7 @@ resource_name = library--errno replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--exceptions] -file_filter = library/exceptions.po -source_file = gettext/library/exceptions.pot -type = PO -minimum_perc = 0 -resource_name = library--exceptions -replace_edited_strings = false -keep_translations = false - -[o:python-doc:p:python-newest:r:library--faulthandler] +[o:python-doc:p:python-313:r:library--faulthandler] file_filter = library/faulthandler.po source_file = gettext/library/faulthandler.pot type = PO @@ -2089,7 +2170,7 @@ resource_name = library--faulthandler replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fcntl] +[o:python-doc:p:python-313:r:library--fcntl] file_filter = library/fcntl.po source_file = gettext/library/fcntl.pot type = PO @@ -2098,7 +2179,7 @@ resource_name = library--fcntl replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--filecmp] +[o:python-doc:p:python-313:r:library--filecmp] file_filter = library/filecmp.po source_file = gettext/library/filecmp.pot type = PO @@ -2107,7 +2188,7 @@ resource_name = library--filecmp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fileformats] +[o:python-doc:p:python-313:r:library--fileformats] file_filter = library/fileformats.po source_file = gettext/library/fileformats.pot type = PO @@ -2116,7 +2197,7 @@ resource_name = library--fileformats replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fileinput] +[o:python-doc:p:python-313:r:library--fileinput] file_filter = library/fileinput.po source_file = gettext/library/fileinput.pot type = PO @@ -2125,7 +2206,7 @@ resource_name = library--fileinput replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--filesys] +[o:python-doc:p:python-313:r:library--filesys] file_filter = library/filesys.po source_file = gettext/library/filesys.pot type = PO @@ -2134,7 +2215,7 @@ resource_name = library--filesys replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fnmatch] +[o:python-doc:p:python-313:r:library--fnmatch] file_filter = library/fnmatch.po source_file = gettext/library/fnmatch.pot type = PO @@ -2143,7 +2224,7 @@ resource_name = library--fnmatch replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--fractions] +[o:python-doc:p:python-313:r:library--fractions] file_filter = library/fractions.po source_file = gettext/library/fractions.pot type = PO @@ -2152,7 +2233,7 @@ resource_name = library--fractions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--frameworks] +[o:python-doc:p:python-313:r:library--frameworks] file_filter = library/frameworks.po source_file = gettext/library/frameworks.pot type = PO @@ -2161,7 +2242,7 @@ resource_name = library--frameworks replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ftplib] +[o:python-doc:p:python-313:r:library--ftplib] file_filter = library/ftplib.po source_file = gettext/library/ftplib.pot type = PO @@ -2170,7 +2251,7 @@ resource_name = library--ftplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--functional] +[o:python-doc:p:python-313:r:library--functional] file_filter = library/functional.po source_file = gettext/library/functional.pot type = PO @@ -2179,16 +2260,7 @@ resource_name = library--functional replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--functions] -file_filter = library/functions.po -source_file = gettext/library/functions.pot -type = PO -minimum_perc = 0 -resource_name = library--functions -replace_edited_strings = false -keep_translations = false - -[o:python-doc:p:python-newest:r:library--functools] +[o:python-doc:p:python-313:r:library--functools] file_filter = library/functools.po source_file = gettext/library/functools.pot type = PO @@ -2197,7 +2269,7 @@ resource_name = library--functools replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--gc] +[o:python-doc:p:python-313:r:library--gc] file_filter = library/gc.po source_file = gettext/library/gc.pot type = PO @@ -2206,7 +2278,7 @@ resource_name = library--gc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--getopt] +[o:python-doc:p:python-313:r:library--getopt] file_filter = library/getopt.po source_file = gettext/library/getopt.pot type = PO @@ -2215,7 +2287,7 @@ resource_name = library--getopt replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--getpass] +[o:python-doc:p:python-313:r:library--getpass] file_filter = library/getpass.po source_file = gettext/library/getpass.pot type = PO @@ -2224,7 +2296,7 @@ resource_name = library--getpass replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--gettext] +[o:python-doc:p:python-313:r:library--gettext] file_filter = library/gettext.po source_file = gettext/library/gettext.pot type = PO @@ -2233,7 +2305,7 @@ resource_name = library--gettext replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--glob] +[o:python-doc:p:python-313:r:library--glob] file_filter = library/glob.po source_file = gettext/library/glob.pot type = PO @@ -2242,7 +2314,7 @@ resource_name = library--glob replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--graphlib] +[o:python-doc:p:python-313:r:library--graphlib] file_filter = library/graphlib.po source_file = gettext/library/graphlib.pot type = PO @@ -2251,7 +2323,7 @@ resource_name = library--graphlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--grp] +[o:python-doc:p:python-313:r:library--grp] file_filter = library/grp.po source_file = gettext/library/grp.pot type = PO @@ -2260,7 +2332,7 @@ resource_name = library--grp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--gzip] +[o:python-doc:p:python-313:r:library--gzip] file_filter = library/gzip.po source_file = gettext/library/gzip.pot type = PO @@ -2269,7 +2341,7 @@ resource_name = library--gzip replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--hashlib] +[o:python-doc:p:python-313:r:library--hashlib] file_filter = library/hashlib.po source_file = gettext/library/hashlib.pot type = PO @@ -2278,7 +2350,7 @@ resource_name = library--hashlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--heapq] +[o:python-doc:p:python-313:r:library--heapq] file_filter = library/heapq.po source_file = gettext/library/heapq.pot type = PO @@ -2287,7 +2359,7 @@ resource_name = library--heapq replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--hmac] +[o:python-doc:p:python-313:r:library--hmac] file_filter = library/hmac.po source_file = gettext/library/hmac.pot type = PO @@ -2296,7 +2368,7 @@ resource_name = library--hmac replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--html] +[o:python-doc:p:python-313:r:library--html] file_filter = library/html.po source_file = gettext/library/html.pot type = PO @@ -2305,7 +2377,7 @@ resource_name = library--html replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--html_entities] +[o:python-doc:p:python-313:r:library--html_entities] file_filter = library/html.entities.po source_file = gettext/library/html.entities.pot type = PO @@ -2314,7 +2386,7 @@ resource_name = library--html_entities replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--html_parser] +[o:python-doc:p:python-313:r:library--html_parser] file_filter = library/html.parser.po source_file = gettext/library/html.parser.pot type = PO @@ -2323,7 +2395,7 @@ resource_name = library--html_parser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http] +[o:python-doc:p:python-313:r:library--http] file_filter = library/http.po source_file = gettext/library/http.pot type = PO @@ -2332,7 +2404,7 @@ resource_name = library--http replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http_client] +[o:python-doc:p:python-313:r:library--http_client] file_filter = library/http.client.po source_file = gettext/library/http.client.pot type = PO @@ -2341,7 +2413,7 @@ resource_name = library--http_client replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http_cookiejar] +[o:python-doc:p:python-313:r:library--http_cookiejar] file_filter = library/http.cookiejar.po source_file = gettext/library/http.cookiejar.pot type = PO @@ -2350,7 +2422,7 @@ resource_name = library--http_cookiejar replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http_cookies] +[o:python-doc:p:python-313:r:library--http_cookies] file_filter = library/http.cookies.po source_file = gettext/library/http.cookies.pot type = PO @@ -2359,7 +2431,7 @@ resource_name = library--http_cookies replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--http_server] +[o:python-doc:p:python-313:r:library--http_server] file_filter = library/http.server.po source_file = gettext/library/http.server.pot type = PO @@ -2368,7 +2440,7 @@ resource_name = library--http_server replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--i18n] +[o:python-doc:p:python-313:r:library--i18n] file_filter = library/i18n.po source_file = gettext/library/i18n.pot type = PO @@ -2377,7 +2449,7 @@ resource_name = library--i18n replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--idle] +[o:python-doc:p:python-313:r:library--idle] file_filter = library/idle.po source_file = gettext/library/idle.pot type = PO @@ -2386,7 +2458,7 @@ resource_name = library--idle replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--imaplib] +[o:python-doc:p:python-313:r:library--imaplib] file_filter = library/imaplib.po source_file = gettext/library/imaplib.pot type = PO @@ -2395,7 +2467,7 @@ resource_name = library--imaplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--imghdr] +[o:python-doc:p:python-313:r:library--imghdr] file_filter = library/imghdr.po source_file = gettext/library/imghdr.pot type = PO @@ -2404,7 +2476,7 @@ resource_name = library--imghdr replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--imp] +[o:python-doc:p:python-313:r:library--imp] file_filter = library/imp.po source_file = gettext/library/imp.pot type = PO @@ -2413,7 +2485,7 @@ resource_name = library--imp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--importlib] +[o:python-doc:p:python-313:r:library--importlib] file_filter = library/importlib.po source_file = gettext/library/importlib.pot type = PO @@ -2422,7 +2494,7 @@ resource_name = library--importlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--importlib_metadata] +[o:python-doc:p:python-313:r:library--importlib_metadata] file_filter = library/importlib.metadata.po source_file = gettext/library/importlib.metadata.pot type = PO @@ -2431,7 +2503,7 @@ resource_name = library--importlib_metadata replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--importlib_resources] +[o:python-doc:p:python-313:r:library--importlib_resources] file_filter = library/importlib.resources.po source_file = gettext/library/importlib.resources.pot type = PO @@ -2440,7 +2512,7 @@ resource_name = library--importlib_resources replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--importlib_resources_abc] +[o:python-doc:p:python-313:r:library--importlib_resources_abc] file_filter = library/importlib.resources.abc.po source_file = gettext/library/importlib.resources.abc.pot type = PO @@ -2449,7 +2521,7 @@ resource_name = library--importlib_resources_abc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--index] +[o:python-doc:p:python-313:r:library--index] file_filter = library/index.po source_file = gettext/library/index.pot type = PO @@ -2458,7 +2530,7 @@ resource_name = library--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--inspect] +[o:python-doc:p:python-313:r:library--inspect] file_filter = library/inspect.po source_file = gettext/library/inspect.pot type = PO @@ -2467,7 +2539,7 @@ resource_name = library--inspect replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--internet] +[o:python-doc:p:python-313:r:library--internet] file_filter = library/internet.po source_file = gettext/library/internet.pot type = PO @@ -2476,7 +2548,7 @@ resource_name = library--internet replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--intro] +[o:python-doc:p:python-313:r:library--intro] file_filter = library/intro.po source_file = gettext/library/intro.pot type = PO @@ -2485,7 +2557,7 @@ resource_name = library--intro replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--io] +[o:python-doc:p:python-313:r:library--io] file_filter = library/io.po source_file = gettext/library/io.pot type = PO @@ -2494,7 +2566,7 @@ resource_name = library--io replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ipaddress] +[o:python-doc:p:python-313:r:library--ipaddress] file_filter = library/ipaddress.po source_file = gettext/library/ipaddress.pot type = PO @@ -2503,7 +2575,7 @@ resource_name = library--ipaddress replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ipc] +[o:python-doc:p:python-313:r:library--ipc] file_filter = library/ipc.po source_file = gettext/library/ipc.pot type = PO @@ -2512,7 +2584,7 @@ resource_name = library--ipc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--itertools] +[o:python-doc:p:python-313:r:library--itertools] file_filter = library/itertools.po source_file = gettext/library/itertools.pot type = PO @@ -2521,7 +2593,7 @@ resource_name = library--itertools replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--json] +[o:python-doc:p:python-313:r:library--json] file_filter = library/json.po source_file = gettext/library/json.pot type = PO @@ -2530,7 +2602,7 @@ resource_name = library--json replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--keyword] +[o:python-doc:p:python-313:r:library--keyword] file_filter = library/keyword.po source_file = gettext/library/keyword.pot type = PO @@ -2539,7 +2611,7 @@ resource_name = library--keyword replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--language] +[o:python-doc:p:python-313:r:library--language] file_filter = library/language.po source_file = gettext/library/language.pot type = PO @@ -2548,7 +2620,7 @@ resource_name = library--language replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--linecache] +[o:python-doc:p:python-313:r:library--linecache] file_filter = library/linecache.po source_file = gettext/library/linecache.pot type = PO @@ -2557,7 +2629,7 @@ resource_name = library--linecache replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--locale] +[o:python-doc:p:python-313:r:library--locale] file_filter = library/locale.po source_file = gettext/library/locale.pot type = PO @@ -2566,7 +2638,7 @@ resource_name = library--locale replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--logging] +[o:python-doc:p:python-313:r:library--logging] file_filter = library/logging.po source_file = gettext/library/logging.pot type = PO @@ -2575,7 +2647,7 @@ resource_name = library--logging replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--logging_config] +[o:python-doc:p:python-313:r:library--logging_config] file_filter = library/logging.config.po source_file = gettext/library/logging.config.pot type = PO @@ -2584,7 +2656,7 @@ resource_name = library--logging_config replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--logging_handlers] +[o:python-doc:p:python-313:r:library--logging_handlers] file_filter = library/logging.handlers.po source_file = gettext/library/logging.handlers.pot type = PO @@ -2593,7 +2665,7 @@ resource_name = library--logging_handlers replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--lzma] +[o:python-doc:p:python-313:r:library--lzma] file_filter = library/lzma.po source_file = gettext/library/lzma.pot type = PO @@ -2602,7 +2674,7 @@ resource_name = library--lzma replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mailbox] +[o:python-doc:p:python-313:r:library--mailbox] file_filter = library/mailbox.po source_file = gettext/library/mailbox.pot type = PO @@ -2611,7 +2683,7 @@ resource_name = library--mailbox replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mailcap] +[o:python-doc:p:python-313:r:library--mailcap] file_filter = library/mailcap.po source_file = gettext/library/mailcap.pot type = PO @@ -2620,7 +2692,7 @@ resource_name = library--mailcap replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--markup] +[o:python-doc:p:python-313:r:library--markup] file_filter = library/markup.po source_file = gettext/library/markup.pot type = PO @@ -2629,7 +2701,7 @@ resource_name = library--markup replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--marshal] +[o:python-doc:p:python-313:r:library--marshal] file_filter = library/marshal.po source_file = gettext/library/marshal.pot type = PO @@ -2638,7 +2710,7 @@ resource_name = library--marshal replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--math] +[o:python-doc:p:python-313:r:library--math] file_filter = library/math.po source_file = gettext/library/math.pot type = PO @@ -2647,7 +2719,7 @@ resource_name = library--math replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mimetypes] +[o:python-doc:p:python-313:r:library--mimetypes] file_filter = library/mimetypes.po source_file = gettext/library/mimetypes.pot type = PO @@ -2656,7 +2728,7 @@ resource_name = library--mimetypes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mm] +[o:python-doc:p:python-313:r:library--mm] file_filter = library/mm.po source_file = gettext/library/mm.pot type = PO @@ -2665,7 +2737,7 @@ resource_name = library--mm replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--mmap] +[o:python-doc:p:python-313:r:library--mmap] file_filter = library/mmap.po source_file = gettext/library/mmap.pot type = PO @@ -2674,7 +2746,7 @@ resource_name = library--mmap replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--modulefinder] +[o:python-doc:p:python-313:r:library--modulefinder] file_filter = library/modulefinder.po source_file = gettext/library/modulefinder.pot type = PO @@ -2683,7 +2755,7 @@ resource_name = library--modulefinder replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--modules] +[o:python-doc:p:python-313:r:library--modules] file_filter = library/modules.po source_file = gettext/library/modules.pot type = PO @@ -2692,7 +2764,7 @@ resource_name = library--modules replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--msilib] +[o:python-doc:p:python-313:r:library--msilib] file_filter = library/msilib.po source_file = gettext/library/msilib.pot type = PO @@ -2701,7 +2773,7 @@ resource_name = library--msilib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--msvcrt] +[o:python-doc:p:python-313:r:library--msvcrt] file_filter = library/msvcrt.po source_file = gettext/library/msvcrt.pot type = PO @@ -2710,7 +2782,7 @@ resource_name = library--msvcrt replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--multiprocessing] +[o:python-doc:p:python-313:r:library--multiprocessing] file_filter = library/multiprocessing.po source_file = gettext/library/multiprocessing.pot type = PO @@ -2719,7 +2791,7 @@ resource_name = library--multiprocessing replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--multiprocessing_shared_memory] +[o:python-doc:p:python-313:r:library--multiprocessing_shared_memory] file_filter = library/multiprocessing.shared_memory.po source_file = gettext/library/multiprocessing.shared_memory.pot type = PO @@ -2728,7 +2800,7 @@ resource_name = library--multiprocessing_shared_memory replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--netdata] +[o:python-doc:p:python-313:r:library--netdata] file_filter = library/netdata.po source_file = gettext/library/netdata.pot type = PO @@ -2737,7 +2809,7 @@ resource_name = library--netdata replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--netrc] +[o:python-doc:p:python-313:r:library--netrc] file_filter = library/netrc.po source_file = gettext/library/netrc.pot type = PO @@ -2746,7 +2818,7 @@ resource_name = library--netrc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--nis] +[o:python-doc:p:python-313:r:library--nis] file_filter = library/nis.po source_file = gettext/library/nis.pot type = PO @@ -2755,7 +2827,7 @@ resource_name = library--nis replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--nntplib] +[o:python-doc:p:python-313:r:library--nntplib] file_filter = library/nntplib.po source_file = gettext/library/nntplib.pot type = PO @@ -2764,7 +2836,7 @@ resource_name = library--nntplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--numbers] +[o:python-doc:p:python-313:r:library--numbers] file_filter = library/numbers.po source_file = gettext/library/numbers.pot type = PO @@ -2773,7 +2845,7 @@ resource_name = library--numbers replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--numeric] +[o:python-doc:p:python-313:r:library--numeric] file_filter = library/numeric.po source_file = gettext/library/numeric.pot type = PO @@ -2782,7 +2854,7 @@ resource_name = library--numeric replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--operator] +[o:python-doc:p:python-313:r:library--operator] file_filter = library/operator.po source_file = gettext/library/operator.pot type = PO @@ -2791,7 +2863,7 @@ resource_name = library--operator replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--optparse] +[o:python-doc:p:python-313:r:library--optparse] file_filter = library/optparse.po source_file = gettext/library/optparse.pot type = PO @@ -2800,7 +2872,7 @@ resource_name = library--optparse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--os] +[o:python-doc:p:python-313:r:library--os] file_filter = library/os.po source_file = gettext/library/os.pot type = PO @@ -2809,7 +2881,7 @@ resource_name = library--os replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--os_path] +[o:python-doc:p:python-313:r:library--os_path] file_filter = library/os.path.po source_file = gettext/library/os.path.pot type = PO @@ -2818,7 +2890,7 @@ resource_name = library--os_path replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ossaudiodev] +[o:python-doc:p:python-313:r:library--ossaudiodev] file_filter = library/ossaudiodev.po source_file = gettext/library/ossaudiodev.pot type = PO @@ -2827,7 +2899,7 @@ resource_name = library--ossaudiodev replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pathlib] +[o:python-doc:p:python-313:r:library--pathlib] file_filter = library/pathlib.po source_file = gettext/library/pathlib.pot type = PO @@ -2836,7 +2908,7 @@ resource_name = library--pathlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pdb] +[o:python-doc:p:python-313:r:library--pdb] file_filter = library/pdb.po source_file = gettext/library/pdb.pot type = PO @@ -2845,7 +2917,7 @@ resource_name = library--pdb replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--persistence] +[o:python-doc:p:python-313:r:library--persistence] file_filter = library/persistence.po source_file = gettext/library/persistence.pot type = PO @@ -2854,7 +2926,7 @@ resource_name = library--persistence replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pickle] +[o:python-doc:p:python-313:r:library--pickle] file_filter = library/pickle.po source_file = gettext/library/pickle.pot type = PO @@ -2863,7 +2935,7 @@ resource_name = library--pickle replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pickletools] +[o:python-doc:p:python-313:r:library--pickletools] file_filter = library/pickletools.po source_file = gettext/library/pickletools.pot type = PO @@ -2872,7 +2944,7 @@ resource_name = library--pickletools replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pipes] +[o:python-doc:p:python-313:r:library--pipes] file_filter = library/pipes.po source_file = gettext/library/pipes.pot type = PO @@ -2881,7 +2953,7 @@ resource_name = library--pipes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pkgutil] +[o:python-doc:p:python-313:r:library--pkgutil] file_filter = library/pkgutil.po source_file = gettext/library/pkgutil.pot type = PO @@ -2890,7 +2962,7 @@ resource_name = library--pkgutil replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--platform] +[o:python-doc:p:python-313:r:library--platform] file_filter = library/platform.po source_file = gettext/library/platform.pot type = PO @@ -2899,7 +2971,7 @@ resource_name = library--platform replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--plistlib] +[o:python-doc:p:python-313:r:library--plistlib] file_filter = library/plistlib.po source_file = gettext/library/plistlib.pot type = PO @@ -2908,7 +2980,7 @@ resource_name = library--plistlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--poplib] +[o:python-doc:p:python-313:r:library--poplib] file_filter = library/poplib.po source_file = gettext/library/poplib.pot type = PO @@ -2917,7 +2989,7 @@ resource_name = library--poplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--posix] +[o:python-doc:p:python-313:r:library--posix] file_filter = library/posix.po source_file = gettext/library/posix.pot type = PO @@ -2926,7 +2998,7 @@ resource_name = library--posix replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pprint] +[o:python-doc:p:python-313:r:library--pprint] file_filter = library/pprint.po source_file = gettext/library/pprint.pot type = PO @@ -2935,7 +3007,7 @@ resource_name = library--pprint replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--profile] +[o:python-doc:p:python-313:r:library--profile] file_filter = library/profile.po source_file = gettext/library/profile.pot type = PO @@ -2944,7 +3016,7 @@ resource_name = library--profile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pty] +[o:python-doc:p:python-313:r:library--pty] file_filter = library/pty.po source_file = gettext/library/pty.pot type = PO @@ -2953,7 +3025,7 @@ resource_name = library--pty replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pwd] +[o:python-doc:p:python-313:r:library--pwd] file_filter = library/pwd.po source_file = gettext/library/pwd.pot type = PO @@ -2962,7 +3034,7 @@ resource_name = library--pwd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--py_compile] +[o:python-doc:p:python-313:r:library--py_compile] file_filter = library/py_compile.po source_file = gettext/library/py_compile.pot type = PO @@ -2971,7 +3043,7 @@ resource_name = library--py_compile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pyclbr] +[o:python-doc:p:python-313:r:library--pyclbr] file_filter = library/pyclbr.po source_file = gettext/library/pyclbr.pot type = PO @@ -2980,7 +3052,7 @@ resource_name = library--pyclbr replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pydoc] +[o:python-doc:p:python-313:r:library--pydoc] file_filter = library/pydoc.po source_file = gettext/library/pydoc.pot type = PO @@ -2989,7 +3061,7 @@ resource_name = library--pydoc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--pyexpat] +[o:python-doc:p:python-313:r:library--pyexpat] file_filter = library/pyexpat.po source_file = gettext/library/pyexpat.pot type = PO @@ -2998,7 +3070,7 @@ resource_name = library--pyexpat replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--python] +[o:python-doc:p:python-313:r:library--python] file_filter = library/python.po source_file = gettext/library/python.pot type = PO @@ -3007,7 +3079,7 @@ resource_name = library--python replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--queue] +[o:python-doc:p:python-313:r:library--queue] file_filter = library/queue.po source_file = gettext/library/queue.pot type = PO @@ -3016,7 +3088,7 @@ resource_name = library--queue replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--quopri] +[o:python-doc:p:python-313:r:library--quopri] file_filter = library/quopri.po source_file = gettext/library/quopri.pot type = PO @@ -3025,7 +3097,7 @@ resource_name = library--quopri replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--random] +[o:python-doc:p:python-313:r:library--random] file_filter = library/random.po source_file = gettext/library/random.pot type = PO @@ -3034,7 +3106,7 @@ resource_name = library--random replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--re] +[o:python-doc:p:python-313:r:library--re] file_filter = library/re.po source_file = gettext/library/re.pot type = PO @@ -3043,7 +3115,7 @@ resource_name = library--re replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--readline] +[o:python-doc:p:python-313:r:library--readline] file_filter = library/readline.po source_file = gettext/library/readline.pot type = PO @@ -3052,7 +3124,7 @@ resource_name = library--readline replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--removed] +[o:python-doc:p:python-313:r:library--removed] file_filter = library/removed.po source_file = gettext/library/removed.pot type = PO @@ -3061,7 +3133,7 @@ resource_name = library--removed replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--reprlib] +[o:python-doc:p:python-313:r:library--reprlib] file_filter = library/reprlib.po source_file = gettext/library/reprlib.pot type = PO @@ -3070,7 +3142,7 @@ resource_name = library--reprlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--resource] +[o:python-doc:p:python-313:r:library--resource] file_filter = library/resource.po source_file = gettext/library/resource.pot type = PO @@ -3079,7 +3151,7 @@ resource_name = library--resource replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--rlcompleter] +[o:python-doc:p:python-313:r:library--rlcompleter] file_filter = library/rlcompleter.po source_file = gettext/library/rlcompleter.pot type = PO @@ -3088,7 +3160,7 @@ resource_name = library--rlcompleter replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--runpy] +[o:python-doc:p:python-313:r:library--runpy] file_filter = library/runpy.po source_file = gettext/library/runpy.pot type = PO @@ -3097,7 +3169,7 @@ resource_name = library--runpy replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sched] +[o:python-doc:p:python-313:r:library--sched] file_filter = library/sched.po source_file = gettext/library/sched.pot type = PO @@ -3106,7 +3178,7 @@ resource_name = library--sched replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--secrets] +[o:python-doc:p:python-313:r:library--secrets] file_filter = library/secrets.po source_file = gettext/library/secrets.pot type = PO @@ -3115,7 +3187,7 @@ resource_name = library--secrets replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--security_warnings] +[o:python-doc:p:python-313:r:library--security_warnings] file_filter = library/security_warnings.po source_file = gettext/library/security_warnings.pot type = PO @@ -3124,7 +3196,7 @@ resource_name = library--security_warnings replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--select] +[o:python-doc:p:python-313:r:library--select] file_filter = library/select.po source_file = gettext/library/select.pot type = PO @@ -3133,7 +3205,7 @@ resource_name = library--select replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--selectors] +[o:python-doc:p:python-313:r:library--selectors] file_filter = library/selectors.po source_file = gettext/library/selectors.pot type = PO @@ -3142,7 +3214,7 @@ resource_name = library--selectors replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--shelve] +[o:python-doc:p:python-313:r:library--shelve] file_filter = library/shelve.po source_file = gettext/library/shelve.pot type = PO @@ -3151,7 +3223,7 @@ resource_name = library--shelve replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--shlex] +[o:python-doc:p:python-313:r:library--shlex] file_filter = library/shlex.po source_file = gettext/library/shlex.pot type = PO @@ -3160,7 +3232,7 @@ resource_name = library--shlex replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--shutil] +[o:python-doc:p:python-313:r:library--shutil] file_filter = library/shutil.po source_file = gettext/library/shutil.pot type = PO @@ -3169,7 +3241,7 @@ resource_name = library--shutil replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--signal] +[o:python-doc:p:python-313:r:library--signal] file_filter = library/signal.po source_file = gettext/library/signal.pot type = PO @@ -3178,7 +3250,7 @@ resource_name = library--signal replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--site] +[o:python-doc:p:python-313:r:library--site] file_filter = library/site.po source_file = gettext/library/site.pot type = PO @@ -3187,7 +3259,7 @@ resource_name = library--site replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--smtpd] +[o:python-doc:p:python-313:r:library--smtpd] file_filter = library/smtpd.po source_file = gettext/library/smtpd.pot type = PO @@ -3196,7 +3268,7 @@ resource_name = library--smtpd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--smtplib] +[o:python-doc:p:python-313:r:library--smtplib] file_filter = library/smtplib.po source_file = gettext/library/smtplib.pot type = PO @@ -3205,7 +3277,7 @@ resource_name = library--smtplib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sndhdr] +[o:python-doc:p:python-313:r:library--sndhdr] file_filter = library/sndhdr.po source_file = gettext/library/sndhdr.pot type = PO @@ -3214,7 +3286,7 @@ resource_name = library--sndhdr replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--socket] +[o:python-doc:p:python-313:r:library--socket] file_filter = library/socket.po source_file = gettext/library/socket.pot type = PO @@ -3223,7 +3295,7 @@ resource_name = library--socket replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--socketserver] +[o:python-doc:p:python-313:r:library--socketserver] file_filter = library/socketserver.po source_file = gettext/library/socketserver.pot type = PO @@ -3232,7 +3304,7 @@ resource_name = library--socketserver replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--spwd] +[o:python-doc:p:python-313:r:library--spwd] file_filter = library/spwd.po source_file = gettext/library/spwd.pot type = PO @@ -3241,7 +3313,7 @@ resource_name = library--spwd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sqlite3] +[o:python-doc:p:python-313:r:library--sqlite3] file_filter = library/sqlite3.po source_file = gettext/library/sqlite3.pot type = PO @@ -3250,7 +3322,7 @@ resource_name = library--sqlite3 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--ssl] +[o:python-doc:p:python-313:r:library--ssl] file_filter = library/ssl.po source_file = gettext/library/ssl.pot type = PO @@ -3259,7 +3331,7 @@ resource_name = library--ssl replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--stat] +[o:python-doc:p:python-313:r:library--stat] file_filter = library/stat.po source_file = gettext/library/stat.pot type = PO @@ -3268,7 +3340,7 @@ resource_name = library--stat replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--statistics] +[o:python-doc:p:python-313:r:library--statistics] file_filter = library/statistics.po source_file = gettext/library/statistics.pot type = PO @@ -3277,16 +3349,7 @@ resource_name = library--statistics replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--stdtypes] -file_filter = library/stdtypes.po -source_file = gettext/library/stdtypes.pot -type = PO -minimum_perc = 0 -resource_name = library--stdtypes -replace_edited_strings = false -keep_translations = false - -[o:python-doc:p:python-newest:r:library--string] +[o:python-doc:p:python-313:r:library--string] file_filter = library/string.po source_file = gettext/library/string.pot type = PO @@ -3295,7 +3358,7 @@ resource_name = library--string replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--stringprep] +[o:python-doc:p:python-313:r:library--stringprep] file_filter = library/stringprep.po source_file = gettext/library/stringprep.pot type = PO @@ -3304,7 +3367,7 @@ resource_name = library--stringprep replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--struct] +[o:python-doc:p:python-313:r:library--struct] file_filter = library/struct.po source_file = gettext/library/struct.pot type = PO @@ -3313,7 +3376,7 @@ resource_name = library--struct replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--subprocess] +[o:python-doc:p:python-313:r:library--subprocess] file_filter = library/subprocess.po source_file = gettext/library/subprocess.pot type = PO @@ -3322,7 +3385,7 @@ resource_name = library--subprocess replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sunau] +[o:python-doc:p:python-313:r:library--sunau] file_filter = library/sunau.po source_file = gettext/library/sunau.pot type = PO @@ -3331,7 +3394,7 @@ resource_name = library--sunau replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--superseded] +[o:python-doc:p:python-313:r:library--superseded] file_filter = library/superseded.po source_file = gettext/library/superseded.pot type = PO @@ -3340,7 +3403,7 @@ resource_name = library--superseded replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--symtable] +[o:python-doc:p:python-313:r:library--symtable] file_filter = library/symtable.po source_file = gettext/library/symtable.pot type = PO @@ -3349,7 +3412,7 @@ resource_name = library--symtable replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sys] +[o:python-doc:p:python-313:r:library--sys] file_filter = library/sys.po source_file = gettext/library/sys.pot type = PO @@ -3358,7 +3421,7 @@ resource_name = library--sys replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sys_monitoring] +[o:python-doc:p:python-313:r:library--sys_monitoring] file_filter = library/sys.monitoring.po source_file = gettext/library/sys.monitoring.pot type = PO @@ -3367,7 +3430,7 @@ resource_name = library--sys_monitoring replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sys_path_init] +[o:python-doc:p:python-313:r:library--sys_path_init] file_filter = library/sys_path_init.po source_file = gettext/library/sys_path_init.pot type = PO @@ -3376,7 +3439,7 @@ resource_name = library--sys_path_init replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--sysconfig] +[o:python-doc:p:python-313:r:library--sysconfig] file_filter = library/sysconfig.po source_file = gettext/library/sysconfig.pot type = PO @@ -3385,7 +3448,7 @@ resource_name = library--sysconfig replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--syslog] +[o:python-doc:p:python-313:r:library--syslog] file_filter = library/syslog.po source_file = gettext/library/syslog.pot type = PO @@ -3394,7 +3457,7 @@ resource_name = library--syslog replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tabnanny] +[o:python-doc:p:python-313:r:library--tabnanny] file_filter = library/tabnanny.po source_file = gettext/library/tabnanny.pot type = PO @@ -3403,7 +3466,7 @@ resource_name = library--tabnanny replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tarfile] +[o:python-doc:p:python-313:r:library--tarfile] file_filter = library/tarfile.po source_file = gettext/library/tarfile.pot type = PO @@ -3412,7 +3475,7 @@ resource_name = library--tarfile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--telnetlib] +[o:python-doc:p:python-313:r:library--telnetlib] file_filter = library/telnetlib.po source_file = gettext/library/telnetlib.pot type = PO @@ -3421,7 +3484,7 @@ resource_name = library--telnetlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tempfile] +[o:python-doc:p:python-313:r:library--tempfile] file_filter = library/tempfile.po source_file = gettext/library/tempfile.pot type = PO @@ -3430,7 +3493,7 @@ resource_name = library--tempfile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--termios] +[o:python-doc:p:python-313:r:library--termios] file_filter = library/termios.po source_file = gettext/library/termios.pot type = PO @@ -3439,7 +3502,7 @@ resource_name = library--termios replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--test] +[o:python-doc:p:python-313:r:library--test] file_filter = library/test.po source_file = gettext/library/test.pot type = PO @@ -3448,7 +3511,7 @@ resource_name = library--test replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--text] +[o:python-doc:p:python-313:r:library--text] file_filter = library/text.po source_file = gettext/library/text.pot type = PO @@ -3457,7 +3520,7 @@ resource_name = library--text replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--textwrap] +[o:python-doc:p:python-313:r:library--textwrap] file_filter = library/textwrap.po source_file = gettext/library/textwrap.pot type = PO @@ -3466,7 +3529,7 @@ resource_name = library--textwrap replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--threading] +[o:python-doc:p:python-313:r:library--threading] file_filter = library/threading.po source_file = gettext/library/threading.pot type = PO @@ -3475,7 +3538,7 @@ resource_name = library--threading replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--time] +[o:python-doc:p:python-313:r:library--time] file_filter = library/time.po source_file = gettext/library/time.pot type = PO @@ -3484,7 +3547,7 @@ resource_name = library--time replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--timeit] +[o:python-doc:p:python-313:r:library--timeit] file_filter = library/timeit.po source_file = gettext/library/timeit.pot type = PO @@ -3493,7 +3556,7 @@ resource_name = library--timeit replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tk] +[o:python-doc:p:python-313:r:library--tk] file_filter = library/tk.po source_file = gettext/library/tk.pot type = PO @@ -3502,7 +3565,7 @@ resource_name = library--tk replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter] +[o:python-doc:p:python-313:r:library--tkinter] file_filter = library/tkinter.po source_file = gettext/library/tkinter.pot type = PO @@ -3511,7 +3574,7 @@ resource_name = library--tkinter replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_colorchooser] +[o:python-doc:p:python-313:r:library--tkinter_colorchooser] file_filter = library/tkinter.colorchooser.po source_file = gettext/library/tkinter.colorchooser.pot type = PO @@ -3520,7 +3583,7 @@ resource_name = library--tkinter_colorchooser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_dnd] +[o:python-doc:p:python-313:r:library--tkinter_dnd] file_filter = library/tkinter.dnd.po source_file = gettext/library/tkinter.dnd.pot type = PO @@ -3529,7 +3592,7 @@ resource_name = library--tkinter_dnd replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_font] +[o:python-doc:p:python-313:r:library--tkinter_font] file_filter = library/tkinter.font.po source_file = gettext/library/tkinter.font.pot type = PO @@ -3538,7 +3601,7 @@ resource_name = library--tkinter_font replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_messagebox] +[o:python-doc:p:python-313:r:library--tkinter_messagebox] file_filter = library/tkinter.messagebox.po source_file = gettext/library/tkinter.messagebox.pot type = PO @@ -3547,7 +3610,7 @@ resource_name = library--tkinter_messagebox replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_scrolledtext] +[o:python-doc:p:python-313:r:library--tkinter_scrolledtext] file_filter = library/tkinter.scrolledtext.po source_file = gettext/library/tkinter.scrolledtext.pot type = PO @@ -3556,7 +3619,7 @@ resource_name = library--tkinter_scrolledtext replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tkinter_ttk] +[o:python-doc:p:python-313:r:library--tkinter_ttk] file_filter = library/tkinter.ttk.po source_file = gettext/library/tkinter.ttk.pot type = PO @@ -3565,7 +3628,7 @@ resource_name = library--tkinter_ttk replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--token] +[o:python-doc:p:python-313:r:library--token] file_filter = library/token.po source_file = gettext/library/token.pot type = PO @@ -3574,7 +3637,7 @@ resource_name = library--token replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tokenize] +[o:python-doc:p:python-313:r:library--tokenize] file_filter = library/tokenize.po source_file = gettext/library/tokenize.pot type = PO @@ -3583,7 +3646,7 @@ resource_name = library--tokenize replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tomllib] +[o:python-doc:p:python-313:r:library--tomllib] file_filter = library/tomllib.po source_file = gettext/library/tomllib.pot type = PO @@ -3592,7 +3655,7 @@ resource_name = library--tomllib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--trace] +[o:python-doc:p:python-313:r:library--trace] file_filter = library/trace.po source_file = gettext/library/trace.pot type = PO @@ -3601,7 +3664,7 @@ resource_name = library--trace replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--traceback] +[o:python-doc:p:python-313:r:library--traceback] file_filter = library/traceback.po source_file = gettext/library/traceback.pot type = PO @@ -3610,7 +3673,7 @@ resource_name = library--traceback replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tracemalloc] +[o:python-doc:p:python-313:r:library--tracemalloc] file_filter = library/tracemalloc.po source_file = gettext/library/tracemalloc.pot type = PO @@ -3619,7 +3682,7 @@ resource_name = library--tracemalloc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--tty] +[o:python-doc:p:python-313:r:library--tty] file_filter = library/tty.po source_file = gettext/library/tty.pot type = PO @@ -3628,7 +3691,7 @@ resource_name = library--tty replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--turtle] +[o:python-doc:p:python-313:r:library--turtle] file_filter = library/turtle.po source_file = gettext/library/turtle.pot type = PO @@ -3637,7 +3700,7 @@ resource_name = library--turtle replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--types] +[o:python-doc:p:python-313:r:library--types] file_filter = library/types.po source_file = gettext/library/types.pot type = PO @@ -3646,7 +3709,7 @@ resource_name = library--types replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--typing] +[o:python-doc:p:python-313:r:library--typing] file_filter = library/typing.po source_file = gettext/library/typing.pot type = PO @@ -3655,7 +3718,7 @@ resource_name = library--typing replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unicodedata] +[o:python-doc:p:python-313:r:library--unicodedata] file_filter = library/unicodedata.po source_file = gettext/library/unicodedata.pot type = PO @@ -3664,7 +3727,7 @@ resource_name = library--unicodedata replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unittest] +[o:python-doc:p:python-313:r:library--unittest] file_filter = library/unittest.po source_file = gettext/library/unittest.pot type = PO @@ -3673,7 +3736,7 @@ resource_name = library--unittest replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unittest_mock] +[o:python-doc:p:python-313:r:library--unittest_mock] file_filter = library/unittest.mock.po source_file = gettext/library/unittest.mock.pot type = PO @@ -3682,7 +3745,7 @@ resource_name = library--unittest_mock replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unittest_mock-examples] +[o:python-doc:p:python-313:r:library--unittest_mock-examples] file_filter = library/unittest.mock-examples.po source_file = gettext/library/unittest.mock-examples.pot type = PO @@ -3691,7 +3754,7 @@ resource_name = library--unittest_mock-examples replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--unix] +[o:python-doc:p:python-313:r:library--unix] file_filter = library/unix.po source_file = gettext/library/unix.pot type = PO @@ -3700,7 +3763,7 @@ resource_name = library--unix replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib] +[o:python-doc:p:python-313:r:library--urllib] file_filter = library/urllib.po source_file = gettext/library/urllib.pot type = PO @@ -3709,7 +3772,7 @@ resource_name = library--urllib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib_error] +[o:python-doc:p:python-313:r:library--urllib_error] file_filter = library/urllib.error.po source_file = gettext/library/urllib.error.pot type = PO @@ -3718,7 +3781,7 @@ resource_name = library--urllib_error replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib_parse] +[o:python-doc:p:python-313:r:library--urllib_parse] file_filter = library/urllib.parse.po source_file = gettext/library/urllib.parse.pot type = PO @@ -3727,7 +3790,7 @@ resource_name = library--urllib_parse replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib_request] +[o:python-doc:p:python-313:r:library--urllib_request] file_filter = library/urllib.request.po source_file = gettext/library/urllib.request.pot type = PO @@ -3736,7 +3799,7 @@ resource_name = library--urllib_request replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--urllib_robotparser] +[o:python-doc:p:python-313:r:library--urllib_robotparser] file_filter = library/urllib.robotparser.po source_file = gettext/library/urllib.robotparser.pot type = PO @@ -3745,7 +3808,7 @@ resource_name = library--urllib_robotparser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--uu] +[o:python-doc:p:python-313:r:library--uu] file_filter = library/uu.po source_file = gettext/library/uu.pot type = PO @@ -3754,7 +3817,7 @@ resource_name = library--uu replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--uuid] +[o:python-doc:p:python-313:r:library--uuid] file_filter = library/uuid.po source_file = gettext/library/uuid.pot type = PO @@ -3763,7 +3826,7 @@ resource_name = library--uuid replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--venv] +[o:python-doc:p:python-313:r:library--venv] file_filter = library/venv.po source_file = gettext/library/venv.pot type = PO @@ -3772,7 +3835,7 @@ resource_name = library--venv replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--warnings] +[o:python-doc:p:python-313:r:library--warnings] file_filter = library/warnings.po source_file = gettext/library/warnings.pot type = PO @@ -3781,7 +3844,7 @@ resource_name = library--warnings replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--wave] +[o:python-doc:p:python-313:r:library--wave] file_filter = library/wave.po source_file = gettext/library/wave.pot type = PO @@ -3790,7 +3853,7 @@ resource_name = library--wave replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--weakref] +[o:python-doc:p:python-313:r:library--weakref] file_filter = library/weakref.po source_file = gettext/library/weakref.pot type = PO @@ -3799,7 +3862,7 @@ resource_name = library--weakref replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--webbrowser] +[o:python-doc:p:python-313:r:library--webbrowser] file_filter = library/webbrowser.po source_file = gettext/library/webbrowser.pot type = PO @@ -3808,7 +3871,7 @@ resource_name = library--webbrowser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--windows] +[o:python-doc:p:python-313:r:library--windows] file_filter = library/windows.po source_file = gettext/library/windows.pot type = PO @@ -3817,7 +3880,7 @@ resource_name = library--windows replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--winreg] +[o:python-doc:p:python-313:r:library--winreg] file_filter = library/winreg.po source_file = gettext/library/winreg.pot type = PO @@ -3826,7 +3889,7 @@ resource_name = library--winreg replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--winsound] +[o:python-doc:p:python-313:r:library--winsound] file_filter = library/winsound.po source_file = gettext/library/winsound.pot type = PO @@ -3835,7 +3898,7 @@ resource_name = library--winsound replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--wsgiref] +[o:python-doc:p:python-313:r:library--wsgiref] file_filter = library/wsgiref.po source_file = gettext/library/wsgiref.pot type = PO @@ -3844,7 +3907,7 @@ resource_name = library--wsgiref replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xdrlib] +[o:python-doc:p:python-313:r:library--xdrlib] file_filter = library/xdrlib.po source_file = gettext/library/xdrlib.pot type = PO @@ -3853,7 +3916,7 @@ resource_name = library--xdrlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml] +[o:python-doc:p:python-313:r:library--xml] file_filter = library/xml.po source_file = gettext/library/xml.pot type = PO @@ -3862,7 +3925,7 @@ resource_name = library--xml replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_dom] +[o:python-doc:p:python-313:r:library--xml_dom] file_filter = library/xml.dom.po source_file = gettext/library/xml.dom.pot type = PO @@ -3871,7 +3934,7 @@ resource_name = library--xml_dom replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_dom_minidom] +[o:python-doc:p:python-313:r:library--xml_dom_minidom] file_filter = library/xml.dom.minidom.po source_file = gettext/library/xml.dom.minidom.pot type = PO @@ -3880,7 +3943,7 @@ resource_name = library--xml_dom_minidom replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_dom_pulldom] +[o:python-doc:p:python-313:r:library--xml_dom_pulldom] file_filter = library/xml.dom.pulldom.po source_file = gettext/library/xml.dom.pulldom.pot type = PO @@ -3889,7 +3952,7 @@ resource_name = library--xml_dom_pulldom replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_etree_elementtree] +[o:python-doc:p:python-313:r:library--xml_etree_elementtree] file_filter = library/xml.etree.elementtree.po source_file = gettext/library/xml.etree.elementtree.pot type = PO @@ -3898,7 +3961,7 @@ resource_name = library--xml_etree_elementtree replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_sax] +[o:python-doc:p:python-313:r:library--xml_sax] file_filter = library/xml.sax.po source_file = gettext/library/xml.sax.pot type = PO @@ -3907,7 +3970,7 @@ resource_name = library--xml_sax replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_sax_handler] +[o:python-doc:p:python-313:r:library--xml_sax_handler] file_filter = library/xml.sax.handler.po source_file = gettext/library/xml.sax.handler.pot type = PO @@ -3916,7 +3979,7 @@ resource_name = library--xml_sax_handler replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_sax_reader] +[o:python-doc:p:python-313:r:library--xml_sax_reader] file_filter = library/xml.sax.reader.po source_file = gettext/library/xml.sax.reader.pot type = PO @@ -3925,7 +3988,7 @@ resource_name = library--xml_sax_reader replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xml_sax_utils] +[o:python-doc:p:python-313:r:library--xml_sax_utils] file_filter = library/xml.sax.utils.po source_file = gettext/library/xml.sax.utils.pot type = PO @@ -3934,7 +3997,7 @@ resource_name = library--xml_sax_utils replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xmlrpc] +[o:python-doc:p:python-313:r:library--xmlrpc] file_filter = library/xmlrpc.po source_file = gettext/library/xmlrpc.pot type = PO @@ -3943,7 +4006,7 @@ resource_name = library--xmlrpc replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xmlrpc_client] +[o:python-doc:p:python-313:r:library--xmlrpc_client] file_filter = library/xmlrpc.client.po source_file = gettext/library/xmlrpc.client.pot type = PO @@ -3952,7 +4015,7 @@ resource_name = library--xmlrpc_client replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--xmlrpc_server] +[o:python-doc:p:python-313:r:library--xmlrpc_server] file_filter = library/xmlrpc.server.po source_file = gettext/library/xmlrpc.server.pot type = PO @@ -3961,7 +4024,7 @@ resource_name = library--xmlrpc_server replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zipapp] +[o:python-doc:p:python-313:r:library--zipapp] file_filter = library/zipapp.po source_file = gettext/library/zipapp.pot type = PO @@ -3970,7 +4033,7 @@ resource_name = library--zipapp replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zipfile] +[o:python-doc:p:python-313:r:library--zipfile] file_filter = library/zipfile.po source_file = gettext/library/zipfile.pot type = PO @@ -3979,7 +4042,7 @@ resource_name = library--zipfile replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zipimport] +[o:python-doc:p:python-313:r:library--zipimport] file_filter = library/zipimport.po source_file = gettext/library/zipimport.pot type = PO @@ -3988,7 +4051,7 @@ resource_name = library--zipimport replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zlib] +[o:python-doc:p:python-313:r:library--zlib] file_filter = library/zlib.po source_file = gettext/library/zlib.pot type = PO @@ -3997,7 +4060,7 @@ resource_name = library--zlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--zoneinfo] +[o:python-doc:p:python-313:r:library--zoneinfo] file_filter = library/zoneinfo.po source_file = gettext/library/zoneinfo.pot type = PO @@ -4006,7 +4069,7 @@ resource_name = library--zoneinfo replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:license] +[o:python-doc:p:python-313:r:license] file_filter = license.po source_file = gettext/license.pot type = PO @@ -4015,7 +4078,7 @@ resource_name = license replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--compound_stmts] +[o:python-doc:p:python-313:r:reference--compound_stmts] file_filter = reference/compound_stmts.po source_file = gettext/reference/compound_stmts.pot type = PO @@ -4024,7 +4087,7 @@ resource_name = reference--compound_stmts replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--datamodel] +[o:python-doc:p:python-313:r:reference--datamodel] file_filter = reference/datamodel.po source_file = gettext/reference/datamodel.pot type = PO @@ -4033,7 +4096,7 @@ resource_name = reference--datamodel replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--executionmodel] +[o:python-doc:p:python-313:r:reference--executionmodel] file_filter = reference/executionmodel.po source_file = gettext/reference/executionmodel.pot type = PO @@ -4042,7 +4105,7 @@ resource_name = reference--executionmodel replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--expressions] +[o:python-doc:p:python-313:r:reference--expressions] file_filter = reference/expressions.po source_file = gettext/reference/expressions.pot type = PO @@ -4051,7 +4114,7 @@ resource_name = reference--expressions replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--grammar] +[o:python-doc:p:python-313:r:reference--grammar] file_filter = reference/grammar.po source_file = gettext/reference/grammar.pot type = PO @@ -4060,7 +4123,7 @@ resource_name = reference--grammar replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--import] +[o:python-doc:p:python-313:r:reference--import] file_filter = reference/import.po source_file = gettext/reference/import.pot type = PO @@ -4069,7 +4132,7 @@ resource_name = reference--import replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--index] +[o:python-doc:p:python-313:r:reference--index] file_filter = reference/index.po source_file = gettext/reference/index.pot type = PO @@ -4078,7 +4141,7 @@ resource_name = reference--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--introduction] +[o:python-doc:p:python-313:r:reference--introduction] file_filter = reference/introduction.po source_file = gettext/reference/introduction.pot type = PO @@ -4087,7 +4150,7 @@ resource_name = reference--introduction replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--lexical_analysis] +[o:python-doc:p:python-313:r:reference--lexical_analysis] file_filter = reference/lexical_analysis.po source_file = gettext/reference/lexical_analysis.pot type = PO @@ -4096,7 +4159,7 @@ resource_name = reference--lexical_analysis replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--simple_stmts] +[o:python-doc:p:python-313:r:reference--simple_stmts] file_filter = reference/simple_stmts.po source_file = gettext/reference/simple_stmts.pot type = PO @@ -4105,7 +4168,7 @@ resource_name = reference--simple_stmts replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:reference--toplevel_components] +[o:python-doc:p:python-313:r:reference--toplevel_components] file_filter = reference/toplevel_components.po source_file = gettext/reference/toplevel_components.pot type = PO @@ -4114,7 +4177,7 @@ resource_name = reference--toplevel_components replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:sphinx] +[o:python-doc:p:python-313:r:sphinx] file_filter = sphinx.po source_file = gettext/sphinx.pot type = PO @@ -4123,7 +4186,7 @@ resource_name = sphinx replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--appendix] +[o:python-doc:p:python-313:r:tutorial--appendix] file_filter = tutorial/appendix.po source_file = gettext/tutorial/appendix.pot type = PO @@ -4132,7 +4195,7 @@ resource_name = tutorial--appendix replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--appetite] +[o:python-doc:p:python-313:r:tutorial--appetite] file_filter = tutorial/appetite.po source_file = gettext/tutorial/appetite.pot type = PO @@ -4141,7 +4204,7 @@ resource_name = tutorial--appetite replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--classes] +[o:python-doc:p:python-313:r:tutorial--classes] file_filter = tutorial/classes.po source_file = gettext/tutorial/classes.pot type = PO @@ -4150,7 +4213,7 @@ resource_name = tutorial--classes replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--controlflow] +[o:python-doc:p:python-313:r:tutorial--controlflow] file_filter = tutorial/controlflow.po source_file = gettext/tutorial/controlflow.pot type = PO @@ -4159,7 +4222,7 @@ resource_name = tutorial--controlflow replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--datastructures] +[o:python-doc:p:python-313:r:tutorial--datastructures] file_filter = tutorial/datastructures.po source_file = gettext/tutorial/datastructures.pot type = PO @@ -4168,7 +4231,7 @@ resource_name = tutorial--datastructures replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--errors] +[o:python-doc:p:python-313:r:tutorial--errors] file_filter = tutorial/errors.po source_file = gettext/tutorial/errors.pot type = PO @@ -4177,7 +4240,7 @@ resource_name = tutorial--errors replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--floatingpoint] +[o:python-doc:p:python-313:r:tutorial--floatingpoint] file_filter = tutorial/floatingpoint.po source_file = gettext/tutorial/floatingpoint.pot type = PO @@ -4186,7 +4249,7 @@ resource_name = tutorial--floatingpoint replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--index] +[o:python-doc:p:python-313:r:tutorial--index] file_filter = tutorial/index.po source_file = gettext/tutorial/index.pot type = PO @@ -4195,7 +4258,7 @@ resource_name = tutorial--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--inputoutput] +[o:python-doc:p:python-313:r:tutorial--inputoutput] file_filter = tutorial/inputoutput.po source_file = gettext/tutorial/inputoutput.pot type = PO @@ -4204,7 +4267,7 @@ resource_name = tutorial--inputoutput replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--interactive] +[o:python-doc:p:python-313:r:tutorial--interactive] file_filter = tutorial/interactive.po source_file = gettext/tutorial/interactive.pot type = PO @@ -4213,7 +4276,7 @@ resource_name = tutorial--interactive replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--interpreter] +[o:python-doc:p:python-313:r:tutorial--interpreter] file_filter = tutorial/interpreter.po source_file = gettext/tutorial/interpreter.pot type = PO @@ -4222,7 +4285,7 @@ resource_name = tutorial--interpreter replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--introduction] +[o:python-doc:p:python-313:r:tutorial--introduction] file_filter = tutorial/introduction.po source_file = gettext/tutorial/introduction.pot type = PO @@ -4231,7 +4294,7 @@ resource_name = tutorial--introduction replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--modules] +[o:python-doc:p:python-313:r:tutorial--modules] file_filter = tutorial/modules.po source_file = gettext/tutorial/modules.pot type = PO @@ -4240,7 +4303,7 @@ resource_name = tutorial--modules replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--stdlib] +[o:python-doc:p:python-313:r:tutorial--stdlib] file_filter = tutorial/stdlib.po source_file = gettext/tutorial/stdlib.pot type = PO @@ -4249,7 +4312,7 @@ resource_name = tutorial--stdlib replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--stdlib2] +[o:python-doc:p:python-313:r:tutorial--stdlib2] file_filter = tutorial/stdlib2.po source_file = gettext/tutorial/stdlib2.pot type = PO @@ -4258,7 +4321,7 @@ resource_name = tutorial--stdlib2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--venv] +[o:python-doc:p:python-313:r:tutorial--venv] file_filter = tutorial/venv.po source_file = gettext/tutorial/venv.pot type = PO @@ -4267,7 +4330,7 @@ resource_name = tutorial--venv replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:tutorial--whatnow] +[o:python-doc:p:python-313:r:tutorial--whatnow] file_filter = tutorial/whatnow.po source_file = gettext/tutorial/whatnow.pot type = PO @@ -4276,7 +4339,7 @@ resource_name = tutorial--whatnow replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--android] +[o:python-doc:p:python-313:r:using--android] file_filter = using/android.po source_file = gettext/using/android.pot type = PO @@ -4285,7 +4348,7 @@ resource_name = using--android replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--cmdline] +[o:python-doc:p:python-313:r:using--cmdline] file_filter = using/cmdline.po source_file = gettext/using/cmdline.pot type = PO @@ -4294,7 +4357,7 @@ resource_name = using--cmdline replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--configure] +[o:python-doc:p:python-313:r:using--configure] file_filter = using/configure.po source_file = gettext/using/configure.pot type = PO @@ -4303,7 +4366,7 @@ resource_name = using--configure replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--editors] +[o:python-doc:p:python-313:r:using--editors] file_filter = using/editors.po source_file = gettext/using/editors.pot type = PO @@ -4312,7 +4375,7 @@ resource_name = using--editors replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--index] +[o:python-doc:p:python-313:r:using--index] file_filter = using/index.po source_file = gettext/using/index.pot type = PO @@ -4321,7 +4384,7 @@ resource_name = using--index replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--ios] +[o:python-doc:p:python-313:r:using--ios] file_filter = using/ios.po source_file = gettext/using/ios.pot type = PO @@ -4330,7 +4393,7 @@ resource_name = using--ios replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--mac] +[o:python-doc:p:python-313:r:using--mac] file_filter = using/mac.po source_file = gettext/using/mac.pot type = PO @@ -4339,7 +4402,7 @@ resource_name = using--mac replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--unix] +[o:python-doc:p:python-313:r:using--unix] file_filter = using/unix.po source_file = gettext/using/unix.pot type = PO @@ -4348,7 +4411,7 @@ resource_name = using--unix replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:using--windows] +[o:python-doc:p:python-313:r:using--windows] file_filter = using/windows.po source_file = gettext/using/windows.pot type = PO @@ -4357,7 +4420,7 @@ resource_name = using--windows replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_0] +[o:python-doc:p:python-313:r:whatsnew--2_0] file_filter = whatsnew/2.0.po source_file = gettext/whatsnew/2.0.pot type = PO @@ -4366,7 +4429,7 @@ resource_name = whatsnew--2_0 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_1] +[o:python-doc:p:python-313:r:whatsnew--2_1] file_filter = whatsnew/2.1.po source_file = gettext/whatsnew/2.1.pot type = PO @@ -4375,7 +4438,7 @@ resource_name = whatsnew--2_1 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_2] +[o:python-doc:p:python-313:r:whatsnew--2_2] file_filter = whatsnew/2.2.po source_file = gettext/whatsnew/2.2.pot type = PO @@ -4384,7 +4447,7 @@ resource_name = whatsnew--2_2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_3] +[o:python-doc:p:python-313:r:whatsnew--2_3] file_filter = whatsnew/2.3.po source_file = gettext/whatsnew/2.3.pot type = PO @@ -4393,7 +4456,7 @@ resource_name = whatsnew--2_3 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_4] +[o:python-doc:p:python-313:r:whatsnew--2_4] file_filter = whatsnew/2.4.po source_file = gettext/whatsnew/2.4.pot type = PO @@ -4402,7 +4465,7 @@ resource_name = whatsnew--2_4 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_5] +[o:python-doc:p:python-313:r:whatsnew--2_5] file_filter = whatsnew/2.5.po source_file = gettext/whatsnew/2.5.pot type = PO @@ -4411,7 +4474,7 @@ resource_name = whatsnew--2_5 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_6] +[o:python-doc:p:python-313:r:whatsnew--2_6] file_filter = whatsnew/2.6.po source_file = gettext/whatsnew/2.6.pot type = PO @@ -4420,7 +4483,7 @@ resource_name = whatsnew--2_6 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--2_7] +[o:python-doc:p:python-313:r:whatsnew--2_7] file_filter = whatsnew/2.7.po source_file = gettext/whatsnew/2.7.pot type = PO @@ -4429,7 +4492,7 @@ resource_name = whatsnew--2_7 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_0] +[o:python-doc:p:python-313:r:whatsnew--3_0] file_filter = whatsnew/3.0.po source_file = gettext/whatsnew/3.0.pot type = PO @@ -4438,7 +4501,7 @@ resource_name = whatsnew--3_0 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_1] +[o:python-doc:p:python-313:r:whatsnew--3_1] file_filter = whatsnew/3.1.po source_file = gettext/whatsnew/3.1.pot type = PO @@ -4447,7 +4510,7 @@ resource_name = whatsnew--3_1 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_10] +[o:python-doc:p:python-313:r:whatsnew--3_10] file_filter = whatsnew/3.10.po source_file = gettext/whatsnew/3.10.pot type = PO @@ -4456,7 +4519,7 @@ resource_name = whatsnew--3_10 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_11] +[o:python-doc:p:python-313:r:whatsnew--3_11] file_filter = whatsnew/3.11.po source_file = gettext/whatsnew/3.11.pot type = PO @@ -4465,7 +4528,7 @@ resource_name = whatsnew--3_11 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_12] +[o:python-doc:p:python-313:r:whatsnew--3_12] file_filter = whatsnew/3.12.po source_file = gettext/whatsnew/3.12.pot type = PO @@ -4474,7 +4537,7 @@ resource_name = whatsnew--3_12 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_13] +[o:python-doc:p:python-313:r:whatsnew--3_13] file_filter = whatsnew/3.13.po source_file = gettext/whatsnew/3.13.pot type = PO @@ -4483,7 +4546,7 @@ resource_name = whatsnew--3_13 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_2] +[o:python-doc:p:python-313:r:whatsnew--3_2] file_filter = whatsnew/3.2.po source_file = gettext/whatsnew/3.2.pot type = PO @@ -4492,7 +4555,7 @@ resource_name = whatsnew--3_2 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_3] +[o:python-doc:p:python-313:r:whatsnew--3_3] file_filter = whatsnew/3.3.po source_file = gettext/whatsnew/3.3.pot type = PO @@ -4501,7 +4564,7 @@ resource_name = whatsnew--3_3 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_4] +[o:python-doc:p:python-313:r:whatsnew--3_4] file_filter = whatsnew/3.4.po source_file = gettext/whatsnew/3.4.pot type = PO @@ -4510,7 +4573,7 @@ resource_name = whatsnew--3_4 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_5] +[o:python-doc:p:python-313:r:whatsnew--3_5] file_filter = whatsnew/3.5.po source_file = gettext/whatsnew/3.5.pot type = PO @@ -4519,7 +4582,7 @@ resource_name = whatsnew--3_5 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_6] +[o:python-doc:p:python-313:r:whatsnew--3_6] file_filter = whatsnew/3.6.po source_file = gettext/whatsnew/3.6.pot type = PO @@ -4528,7 +4591,7 @@ resource_name = whatsnew--3_6 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_7] +[o:python-doc:p:python-313:r:whatsnew--3_7] file_filter = whatsnew/3.7.po source_file = gettext/whatsnew/3.7.pot type = PO @@ -4537,7 +4600,7 @@ resource_name = whatsnew--3_7 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_8] +[o:python-doc:p:python-313:r:whatsnew--3_8] file_filter = whatsnew/3.8.po source_file = gettext/whatsnew/3.8.pot type = PO @@ -4546,7 +4609,7 @@ resource_name = whatsnew--3_8 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--3_9] +[o:python-doc:p:python-313:r:whatsnew--3_9] file_filter = whatsnew/3.9.po source_file = gettext/whatsnew/3.9.pot type = PO @@ -4555,7 +4618,7 @@ resource_name = whatsnew--3_9 replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--changelog] +[o:python-doc:p:python-313:r:whatsnew--changelog] file_filter = whatsnew/changelog.po source_file = gettext/whatsnew/changelog.pot type = PO @@ -4564,7 +4627,7 @@ resource_name = whatsnew--changelog replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:whatsnew--index] +[o:python-doc:p:python-313:r:whatsnew--index] file_filter = whatsnew/index.po source_file = gettext/whatsnew/index.pot type = PO diff --git a/README.en.md b/README.en.md index ff488a289f..8fb6ac3fa1 100644 --- a/README.en.md +++ b/README.en.md @@ -13,8 +13,8 @@ f'''![build](https://github.com/python/python-docs-pl/actions/workflows/update-l ![{translators} Translators](https://img.shields.io/badge/Translators-{translators}-0.svg)''') ]]] --> ![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg) -![Total Translation of Documentation](https://img.shields.io/badge/Total-4.953%25-0.svg) -![24 Translators](https://img.shields.io/badge/Translators-24-0.svg) +![Total Translation of Documentation](https://img.shields.io/badge/Total-5.889%25-0.svg) +![11 Translators](https://img.shields.io/badge/Translators-11-0.svg) *Przeczytaj to w innym języku: [polski](README.md)* diff --git a/README.md b/README.md index 92543db9f6..5eaa5d067d 100644 --- a/README.md +++ b/README.md @@ -13,8 +13,8 @@ f'''![build](https://github.com/python/python-docs-pl/actions/workflows/update-l ![{translators} tłumaczy](https://img.shields.io/badge/tłumaczy-{translators}-0.svg)''') ]]] --> ![build](https://github.com/python/python-docs-pl/actions/workflows/update-lint-and-build.yml/badge.svg) -![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-4.953%25-0.svg) -![24 tłumaczy](https://img.shields.io/badge/tłumaczy-24-0.svg) +![postęp tłumaczenia całości dokumentacji](https://img.shields.io/badge/całość-5.889%25-0.svg) +![11 tłumaczy](https://img.shields.io/badge/tłumaczy-11-0.svg) *Read this in another language: [English](README.en.md)* diff --git a/about.po b/about.po index 7d538f733c..d84fc65492 100644 --- a/about.po +++ b/about.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 -# Maciej Olko , 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/bugs.po b/bugs.po index 215d168b82..5d2419e8ae 100644 --- a/bugs.po +++ b/bugs.po @@ -1,21 +1,21 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Ciarbin , 2021 -# ac4a8e5d3d92195fc6d50ffd472aae19_7eb0c45, 2022 -# Maciej Olko , 2024 +# python-doc bot, 2025 +# Stan Ulbrych, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -39,26 +39,36 @@ msgstr "" msgid "" "It can be sometimes faster to fix bugs yourself and contribute patches to " -"Python as it streamlines the process and involves less people. Learn how to :" -"ref:`contribute `." +"Python as it streamlines the process and involves fewer people. Learn how " +"to :ref:`contribute `." msgstr "" "Czasem szybsze może być własnoręczne naprawienie błędu i wysłanie patchy do " -"Pythona, usprawnia to proces i angażuje mniej osób. Dowiedz się, jak :ref:" -"`kontrybuować `." +"Pythona, usprawnia to proces i angażuje mniej osób. Dowiedz się, " +"jak :ref:`kontrybuować `." msgid "Documentation bugs" msgstr "Błędy w dokumentacji" msgid "" "If you find a bug in this documentation or would like to propose an " -"improvement, please submit a bug report on the :ref:`tracker `. If you have a suggestion on how to fix it, include that as well." +"improvement, please submit a bug report on the :ref:`issue tracker `. If you have a suggestion on how to fix it, include that as " +"well." msgstr "" "Jeśli znajdziesz błąd w tej dokumentacji lub chciałbyś zaproponować " -"poprawkę, wyślij, prosimy, zgłoszenie błędu do :ref:`systemu `. Jeżeli błąd dotyczy jedynie polskiego tłumaczenia, zgłoś błąd pod " -"adresem: https://github.com/python/python-docs-pl. Jeśli masz sugestię, jak " -"naprawić błąd, zawrzyj ją w zgłoszeniu." +"poprawkę, wyślij, zgłoszenie błędu do :ref:`systemu `. " +"Jeżeli błąd dotyczy jedynie polskiego tłumaczenia, zgłoś błąd `tutaj " +"`_. Jeśli masz sugestię, " +"jak naprawić błąd, zawrzyj ją w zgłoszeniu." + +msgid "" +"If the bug or suggested improvement concerns the translation of this " +"documentation, submit the report to the `translation’s repository " +"`_ instead." +msgstr "" +"Jeżeli błąd lub sugestia dotyczy jedynie polskiego tłumaczenia, zgłoś je " +"`tutaj `_. Jeśli masz sugestię, jak naprawić tłumaczenie, " +"zawrzyj ją w zgłoszeniu." msgid "" "You can also open a discussion item on our `Documentation Discourse forum " @@ -69,25 +79,13 @@ msgstr "" msgid "" "If you find a bug in the theme (HTML / CSS / JavaScript) of the " -"documentation, please submit a bug report on the `python-doc-theme bug " +"documentation, please submit a bug report on the `python-doc-theme issue " "tracker `_." msgstr "" "Jeśli znajdziesz błąd w motywie (HTML / CSS / JavaScript) dokumentacji, " "zgłoś raport o błędzie w `projekcie python-doc-theme `_." -msgid "" -"If you're short on time, you can also email documentation bug reports to " -"docs@python.org (behavioral bugs can be sent to python-list@python.org). " -"'docs@' is a mailing list run by volunteers; your request will be noticed, " -"though it may take a while to be processed." -msgstr "" -"Jeśli brakuje ci czasu, możesz też wysyłać zgłoszenia błędów w dokumentacji " -"na docs@python.org (błędy behawioralne mogą być wysyłane na python-" -"list@python.org). 'docs@' jest listą mailingową prowadzoną przez " -"wolontariuszy; twoje zgłoszenie zostanie zauważone, aczkolwiek jego " -"przetworzenie może chwilę zająć." - msgid "`Documentation bugs`_" msgstr "`Błędy w dokumentacji`_" diff --git a/builtins/constants.po b/builtins/constants.po new file mode 100644 index 0000000000..d8de9b6850 --- /dev/null +++ b/builtins/constants.po @@ -0,0 +1,182 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2026 +# Rafael Fontenelle , 2026 +# Mariusz Krzaczkowski, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2026-09-13 19:06+0000\n" +"Last-Translator: Mariusz Krzaczkowski, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Built-in Constants" +msgstr "Wbudowane stałe" + +msgid "A small number of constants live in the built-in namespace. They are:" +msgstr "We wbudowanej przestrzeni nazw znajduje się kilka stałych. Są to:" + +msgid "" +"The false value of the :class:`bool` type. Assignments to ``False`` are " +"illegal and raise a :exc:`SyntaxError`." +msgstr "" +"Wartość \"fałsz\" typu :class:`bool`. Przypisania do ``False`` są " +"niedozwolone i rzucają wyjątkiem :exc:`SyntaxError`." + +msgid "" +"The true value of the :class:`bool` type. Assignments to ``True`` are " +"illegal and raise a :exc:`SyntaxError`." +msgstr "" +"Wartość \"prawda\" typu :class:`bool`. Przypisania do ``True`` są " +"niedozwolone i rzucają wyjątkiem :exc:`SyntaxError`." + +msgid "" +"An object frequently used to represent the absence of a value, as when " +"default arguments are not passed to a function. Assignments to ``None`` are " +"illegal and raise a :exc:`SyntaxError`. ``None`` is the sole instance of " +"the :class:`~types.NoneType` type." +msgstr "" + +msgid "" +"A special value which should be returned by the binary special methods " +"(e.g. :meth:`~object.__eq__`, :meth:`~object.__lt__`, :meth:`~object.__add__`, :meth:`~object.__rsub__`, " +"etc.) to indicate that the operation is not implemented with respect to the " +"other type; may be returned by the in-place binary special methods " +"(e.g. :meth:`~object.__imul__`, :meth:`~object.__iand__`, etc.) for the same " +"purpose. It should not be evaluated in a boolean context. :data:`!" +"NotImplemented` is the sole instance of " +"the :class:`types.NotImplementedType` type." +msgstr "" + +msgid "" +"When a binary (or in-place) method returns :data:`!NotImplemented` the " +"interpreter will try the reflected operation on the other type (or some " +"other fallback, depending on the operator). If all attempts return :data:`!" +"NotImplemented`, the interpreter will raise an appropriate exception. " +"Incorrectly returning :data:`!NotImplemented` will result in a misleading " +"error message or the :data:`!NotImplemented` value being returned to Python " +"code." +msgstr "" +"Gdy metoda binarna (albo operująca w miejscu) zwróci :data:`!" +"NotImplemented`, interpreter spróbuje wykonać odpowiadającą jej operację na " +"drugim typie (albo innego mechanizmu rezerwowego, w zależności od rodzaju " +"operatora). Dopiero gdy wszystkie próby zwrócą :data:`!NotImplemented`, " +"interpreter rzuci odpowiednim wyjątkiem. Nieprawidłowe zwracanie :data:`!" +"NotImplemented` spowoduje wyświetlenie mylnego komunikatu błędu lub też " +"zwrócenie wartości :data:`!NotImplemented` do kodu Pythona." + +msgid "See :ref:`implementing-the-arithmetic-operations` for examples." +msgstr "Zobacz przykłady w :ref:`implementing-the-arithmetic-operations`." + +msgid "" +":data:`!NotImplemented` and :exc:`!NotImplementedError` are not " +"interchangeable. This constant should only be used as described above; " +"see :exc:`NotImplementedError` for details on correct usage of the exception." +msgstr "" + +msgid "" +"Evaluating :data:`!NotImplemented` in a boolean context 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 \"``...``\", an object frequently used to " +"indicate that something is omitted. Assignment to ``Ellipsis`` is possible, " +"but assignment to ``...`` raises a :exc:`SyntaxError`. ``Ellipsis`` is the " +"sole instance of the :class:`types.EllipsisType` type." +msgstr "" + +msgid "" +"This constant is true if Python was not started with an :option:`-O` option. " +"See also the :keyword:`assert` statement." +msgstr "" +"Ta stała ma wartość True jeśli Python nie został uruchomiony z " +"opcją :option:`-O`. Zobacz także deklarację :keyword:`assert`." + +msgid "" +"The names :data:`None`, :data:`False`, :data:`True` and :data:`__debug__` " +"cannot be reassigned (assignments to them, even as an attribute name, " +"raise :exc:`SyntaxError`), so they can be considered \"true\" constants." +msgstr "" +"Nazwy :data:`None`, :data:`False`, :data:`True` oraz :data:`__debug__` nie " +"mogą być przypisane ponownie (przypisania do nich, nawet jako nazwa " +"atrybutu, rzucają :exc:`SyntaxError`), więc mogą być uważane za „prawdziwe” " +"stałe." + +msgid "Constants added by the :mod:`site` module" +msgstr "Stałe dodane przez moduł :mod:`site`" + +msgid "" +"The :mod:`site` module (which is imported automatically during startup, " +"except if the :option:`-S` command-line option is given) adds several " +"constants to the built-in namespace. They are useful for the interactive " +"interpreter shell and should not be used in programs." +msgstr "" +"Moduł :mod:`site` (który jest importowany automatycznie podczas " +"uruchamiania, z wyjątkiem sytuacji, gdy podano opcję wiersza " +"poleceń :option:`-S`) dodaje kilka stałych do wbudowanej przestrzeni nazw. " +"Są one przydatne w interaktywnej powłoce interpretera i nie powinny być " +"używane w programach." + +msgid "" +"Objects that when printed, print a message like \"Use quit() or Ctrl-D (i.e. " +"EOF) to exit\", and when accessed directly in the interactive interpreter or " +"called as functions, raise :exc:`SystemExit` with the specified exit code." +msgstr "" +"Obiekty, które po wypisaniu wyświetlają komunikat w rodzaju \"Use quit() or " +"Ctrl-D (i.e. EOF) to exit\", a gdy wywołane - rzucą " +"wyjątek :exc:`SystemExit` z podanym kodem wyjścia." + +msgid "" +"Object that when printed, prints the message \"Type help() for interactive " +"help, or help(object) for help about object.\", and when accessed directly " +"in the interactive interpreter, invokes the built-in help system " +"(see :func:`help`)." +msgstr "" +"Obiekt, który po wydrukowaniu wyświetla komunikat „Type help() for " +"interactive help, or help(object) for help about object.”, a przy " +"bezpośrednim wywołaniu w interpreterze interaktywnym uruchamia wbudowany " +"system pomocy (zobacz :func:`help`)." + +msgid "" +"Objects that when printed or called, print the text of copyright or credits, " +"respectively." +msgstr "" +"Obiekty, które, gdy wypisane lub wywołane - wyświetlają treść odpowiednio " +"praw autorskich i słów uznania." + +msgid "" +"Object that when printed, prints the message \"Type license() to see the " +"full license text\", and when called, displays the full license text in a " +"pager-like fashion (one screen at a time)." +msgstr "" +"Obiekt, który, gdy jego nazwa zostanie wpisana w powłoce - wyświetla " +"wiadomość \"Type license() to see the full license text\", a gdy wywołany - " +"wyświetla pełny tekst licencji w sposób podobny do pagera (jeden ekran na " +"raz)." + +msgid "..." +msgstr "..." + +msgid "ellipsis literal" +msgstr "Literalny zapis wielokropka" diff --git a/builtins/exceptions.po b/builtins/exceptions.po new file mode 100644 index 0000000000..34ad956477 --- /dev/null +++ b/builtins/exceptions.po @@ -0,0 +1,1184 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2026-09-13 19:06+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Built-in Exceptions" +msgstr "" + +msgid "" +"In Python, all exceptions must be instances of a class that derives " +"from :class:`BaseException`. In a :keyword:`try` statement with " +"an :keyword:`except` clause that mentions a particular class, that clause " +"also handles any exception classes derived from that class (but not " +"exception classes from which *it* is derived). Two exception classes that " +"are not related via subclassing are never equivalent, even if they have the " +"same name." +msgstr "" + +msgid "" +"The built-in exceptions listed in this chapter can be generated by the " +"interpreter or built-in functions. Except where mentioned, they have an " +"\"associated value\" indicating the detailed cause of the error. This may " +"be a string or a tuple of several items of information (e.g., an error code " +"and a string explaining the code). The associated value is usually passed " +"as arguments to the exception class's constructor." +msgstr "" + +msgid "" +"User code can raise built-in exceptions. This can be used to test an " +"exception handler or to report an error condition \"just like\" the " +"situation in which the interpreter raises the same exception; but beware " +"that there is nothing to prevent user code from raising an inappropriate " +"error." +msgstr "" + +msgid "" +"The built-in exception classes can be subclassed to define new exceptions; " +"programmers are encouraged to derive new exceptions from " +"the :exc:`Exception` class or one of its subclasses, and not " +"from :exc:`BaseException`. More information on defining exceptions is " +"available in the Python Tutorial under :ref:`tut-userexceptions`." +msgstr "" + +msgid "Exception context" +msgstr "" + +msgid "" +"Three attributes on exception objects provide information about the context " +"in which the exception was raised:" +msgstr "" + +msgid "" +"When raising a new exception while another exception is already being " +"handled, the new exception's :attr:`!__context__` attribute is automatically " +"set to the handled exception. An exception may be handled when " +"an :keyword:`except` or :keyword:`finally` clause, or a :keyword:`with` " +"statement, is used." +msgstr "" + +msgid "" +"This implicit exception context can be supplemented with an explicit cause " +"by using :keyword:`!from` with :keyword:`raise`::" +msgstr "" + +msgid "raise new_exc from original_exc" +msgstr "" + +msgid "" +"The expression following :keyword:`from` must be an exception or " +"``None``. It will be set as :attr:`!__cause__` on the raised exception. " +"Setting :attr:`!__cause__` also implicitly sets the :attr:`!" +"__suppress_context__` attribute to ``True``, so that using ``raise new_exc " +"from None`` effectively replaces the old exception with the new one for " +"display purposes (e.g. converting :exc:`KeyError` to :exc:`AttributeError`), " +"while leaving the old exception available in :attr:`!__context__` for " +"introspection when debugging." +msgstr "" + +msgid "" +"The default traceback display code shows these chained exceptions in " +"addition to the traceback for the exception itself. An explicitly chained " +"exception in :attr:`!__cause__` is always shown when present. An implicitly " +"chained exception in :attr:`!__context__` is shown only if :attr:`!" +"__cause__` is :const:`None` and :attr:`!__suppress_context__` is false." +msgstr "" + +msgid "" +"In either case, the exception itself is always shown after any chained " +"exceptions so that the final line of the traceback always shows the last " +"exception that was raised." +msgstr "" + +msgid "Inheriting from built-in exceptions" +msgstr "" + +msgid "" +"User code can create subclasses that inherit from an exception type. It's " +"recommended to only subclass one exception type at a time to avoid any " +"possible conflicts between how the bases handle the ``args`` attribute, as " +"well as due to possible memory layout incompatibilities." +msgstr "" + +msgid "" +"Most built-in exceptions are implemented in C for efficiency, " +"see: :source:`Objects/exceptions.c`. Some have custom memory layouts which " +"makes it impossible to create a subclass that inherits from multiple " +"exception types. The memory layout of a type is an implementation detail and " +"might change between Python versions, leading to new conflicts in the " +"future. Therefore, it's recommended to avoid subclassing multiple exception " +"types altogether." +msgstr "" + +msgid "Base classes" +msgstr "" + +msgid "" +"The following exceptions are used mostly as base classes for other " +"exceptions." +msgstr "" + +msgid "" +"The base class for all built-in exceptions. It is not meant to be directly " +"inherited by user-defined classes (for that, use :exc:`Exception`). " +"If :func:`str` is called on an instance of this class, the representation of " +"the argument(s) to the instance are returned, or the empty string when there " +"were no arguments." +msgstr "" + +msgid "" +"The tuple of arguments given to the exception constructor. Some built-in " +"exceptions (like :exc:`OSError`) expect a certain number of arguments and " +"assign a special meaning to the elements of this tuple, while others are " +"usually called only with a single string giving an error message." +msgstr "" + +msgid "" +"This method sets *tb* as the new traceback for the exception and returns the " +"exception object. It was more commonly used before the exception chaining " +"features of :pep:`3134` became available. The following example shows how " +"we can convert an instance of ``SomeException`` into an instance of " +"``OtherException`` while preserving the traceback. Once raised, the current " +"frame is pushed onto the traceback of the ``OtherException``, as would have " +"happened to the traceback of the original ``SomeException`` had we allowed " +"it to propagate to the caller. ::" +msgstr "" + +msgid "" +"try:\n" +" ...\n" +"except SomeException:\n" +" tb = sys.exception().__traceback__\n" +" raise OtherException(...).with_traceback(tb)" +msgstr "" + +msgid "" +"A writable field that holds the :ref:`traceback object ` " +"associated with this exception. See also: :ref:`raise`." +msgstr "" + +msgid "" +"Add the string ``note`` to the exception's notes which appear in the " +"standard traceback after the exception string. A :exc:`TypeError` is raised " +"if ``note`` is not a string." +msgstr "" + +msgid "" +"A list of the notes of this exception, which were added " +"with :meth:`add_note`. This attribute is created when :meth:`add_note` is " +"called." +msgstr "" + +msgid "" +"All built-in, non-system-exiting exceptions are derived from this class. " +"All user-defined exceptions should also be derived from this class." +msgstr "" + +msgid "" +"The base class for those built-in exceptions that are raised for various " +"arithmetic " +"errors: :exc:`OverflowError`, :exc:`ZeroDivisionError`, :exc:`FloatingPointError`." +msgstr "" + +msgid "" +"Raised when a :ref:`buffer ` related operation cannot be " +"performed." +msgstr "" + +msgid "" +"The base class for the exceptions that are raised when a key or index used " +"on a mapping or sequence is invalid: :exc:`IndexError`, :exc:`KeyError`. " +"This can be raised directly by :func:`codecs.lookup`." +msgstr "" + +msgid "Concrete exceptions" +msgstr "" + +msgid "The following exceptions are the exceptions that are usually raised." +msgstr "" + +msgid "Raised when an :keyword:`assert` statement fails." +msgstr "" + +msgid "" +"Raised when an attribute reference (see :ref:`attribute-references`) or " +"assignment fails. (When an object does not support attribute references or " +"attribute assignments at all, :exc:`TypeError` is raised.)" +msgstr "" + +msgid "" +"The optional *name* and *obj* keyword-only arguments set the corresponding " +"attributes:" +msgstr "" + +msgid "The name of the attribute that was attempted to be accessed." +msgstr "" + +msgid "The object that was accessed for the named attribute." +msgstr "" + +msgid "Added the :attr:`name` and :attr:`obj` attributes." +msgstr "" + +msgid "" +"Raised when the :func:`input` function hits an end-of-file condition (EOF) " +"without reading any data. (Note: the :meth:`io.TextIOBase.read` " +"and :meth:`io.IOBase.readline` methods return an empty string when they hit " +"EOF.)" +msgstr "" + +msgid "Not currently used." +msgstr "" + +msgid "" +"Raised when a :term:`generator` or :term:`coroutine` is closed; " +"see :meth:`generator.close` and :meth:`coroutine.close`. It directly " +"inherits from :exc:`BaseException` instead of :exc:`Exception` since it is " +"technically not an error." +msgstr "" + +msgid "" +"Raised when the :keyword:`import` statement has troubles trying to load a " +"module. Also raised when the \"from list\" in ``from ... import`` has a " +"name that cannot be found." +msgstr "" + +msgid "" +"The optional *name* and *path* keyword-only arguments set the corresponding " +"attributes:" +msgstr "" + +msgid "The name of the module that was attempted to be imported." +msgstr "" + +msgid "The path to any file which triggered the exception." +msgstr "" + +msgid "Added the :attr:`name` and :attr:`path` attributes." +msgstr "" + +msgid "" +"A subclass of :exc:`ImportError` which is raised by :keyword:`import` when a " +"module could not be located. It is also raised when ``None`` is found " +"in :data:`sys.modules`." +msgstr "" + +msgid "" +"Raised when a sequence subscript is out of range. (Slice indices are " +"silently truncated to fall in the allowed range; if an index is not an " +"integer, :exc:`TypeError` is raised.)" +msgstr "" + +msgid "" +"Raised when a mapping (dictionary) key is not found in the set of existing " +"keys." +msgstr "" + +msgid "" +"Raised when the user hits the interrupt key (normally :kbd:`Control-C` " +"or :kbd:`Delete`). During execution, a check for interrupts is made " +"regularly. The exception inherits from :exc:`BaseException` so as to not be " +"accidentally caught by code that catches :exc:`Exception` and thus prevent " +"the interpreter from exiting." +msgstr "" + +msgid "" +"Catching a :exc:`KeyboardInterrupt` requires special consideration. Because " +"it can be raised at unpredictable points, it may, in some circumstances, " +"leave the running program in an inconsistent state. It is generally best to " +"allow :exc:`KeyboardInterrupt` to end the program as quickly as possible or " +"avoid raising it entirely. (See :ref:`handlers-and-exceptions`.)" +msgstr "" + +msgid "" +"Raised when an operation runs out of memory but the situation may still be " +"rescued (by deleting some objects). The associated value is a string " +"indicating what kind of (internal) operation ran out of memory. Note that " +"because of the underlying memory management architecture " +"(C's :c:func:`malloc` function), the interpreter may not always be able to " +"completely recover from this situation; it nevertheless raises an exception " +"so that a stack traceback can be printed, in case a run-away program was the " +"cause." +msgstr "" + +msgid "" +"Raised when a local or global name is not found. This applies only to " +"unqualified names. The associated value is an error message that includes " +"the name that could not be found." +msgstr "" + +msgid "The optional *name* keyword-only argument sets the attribute:" +msgstr "" + +msgid "The name of the variable that was attempted to be accessed." +msgstr "" + +msgid "Added the :attr:`name` attribute." +msgstr "" + +msgid "" +"This exception is derived from :exc:`RuntimeError`. In user defined base " +"classes, abstract methods should raise this exception when they require " +"derived classes to override the method, or while the class is being " +"developed to indicate that the real implementation still needs to be added." +msgstr "" + +msgid "" +"It should not be used to indicate that an operator or method is not meant to " +"be supported at all -- in that case either leave the operator / method " +"undefined or, if a subclass, set it to :data:`None`." +msgstr "" + +msgid "" +":exc:`!NotImplementedError` and :data:`!NotImplemented` are not " +"interchangeable. This exception should only be used as described above; " +"see :data:`NotImplemented` for details on correct usage of the built-in " +"constant." +msgstr "" + +msgid "" +"This exception is raised when a system function returns a system-related " +"error, including I/O failures such as \"file not found\" or \"disk full\" " +"(not for illegal argument types or other incidental errors)." +msgstr "" + +msgid "" +"The second form of the constructor sets the corresponding attributes, " +"described below. The attributes default to :const:`None` if not specified. " +"For backwards compatibility, if three arguments are passed, " +"the :attr:`~BaseException.args` attribute contains only a 2-tuple of the " +"first two constructor arguments." +msgstr "" + +msgid "" +"The constructor often actually returns a subclass of :exc:`OSError`, as " +"described in `OS exceptions`_ below. The particular subclass depends on the " +"final :attr:`.errno` value. This behaviour only occurs when " +"constructing :exc:`OSError` directly or via an alias, and is not inherited " +"when subclassing." +msgstr "" + +msgid "A numeric error code from the C variable :c:data:`errno`." +msgstr "" + +msgid "" +"Under Windows, this gives you the native Windows error code. " +"The :attr:`.errno` attribute is then an approximate translation, in POSIX " +"terms, of that native error code." +msgstr "" + +msgid "" +"Under Windows, if the *winerror* constructor argument is an integer, " +"the :attr:`.errno` attribute is determined from the Windows error code, and " +"the *errno* argument is ignored. On other platforms, the *winerror* " +"argument is ignored, and the :attr:`winerror` attribute does not exist." +msgstr "" + +msgid "" +"The corresponding error message, as provided by the operating system. It is " +"formatted by the C functions :c:func:`!perror` under POSIX, and :c:func:`!" +"FormatMessage` under Windows." +msgstr "" + +msgid "" +"For exceptions that involve a file system path (such as :func:`open` " +"or :func:`os.unlink`), :attr:`filename` is the file name passed to the " +"function. For functions that involve two file system paths (such " +"as :func:`os.rename`), :attr:`filename2` corresponds to the second file name " +"passed to the function." +msgstr "" + +msgid "" +":exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`, :exc:`socket.error`, :exc:`select.error` " +"and :exc:`!mmap.error` have been merged into :exc:`OSError`, and the " +"constructor may return a subclass." +msgstr "" + +msgid "" +"The :attr:`filename` attribute is now the original file name passed to the " +"function, instead of the name encoded to or decoded from " +"the :term:`filesystem encoding and error handler`. Also, the *filename2* " +"constructor argument and attribute was added." +msgstr "" + +msgid "" +"Raised when the result of an arithmetic operation is too large to be " +"represented. This cannot occur for integers (which would rather " +"raise :exc:`MemoryError` than give up). However, for historical reasons, " +"OverflowError is sometimes raised for integers that are outside a required " +"range. Because of the lack of standardization of floating-point exception " +"handling in C, most floating-point operations are not checked." +msgstr "" + +msgid "" +"This exception is derived from :exc:`RuntimeError`. It is raised when an " +"operation is blocked during interpreter shutdown also known as :term:`Python " +"finalization `." +msgstr "" + +msgid "" +"Examples of operations which can be blocked with " +"a :exc:`PythonFinalizationError` during the Python finalization:" +msgstr "" + +msgid "Creating a new Python thread." +msgstr "" + +msgid ":func:`os.fork`." +msgstr ":func:`os.fork`." + +msgid "See also the :func:`sys.is_finalizing` function." +msgstr "" + +msgid "Previously, a plain :exc:`RuntimeError` was raised." +msgstr "" + +msgid "" +"This exception is derived from :exc:`RuntimeError`. It is raised when the " +"interpreter detects that the maximum recursion depth " +"(see :func:`sys.getrecursionlimit`) is exceeded." +msgstr "" + +msgid "" +"This exception is raised when a weak reference proxy, created by " +"the :func:`weakref.proxy` function, is used to access an attribute of the " +"referent after it has been garbage collected. For more information on weak " +"references, see the :mod:`weakref` module." +msgstr "" + +msgid "" +"Raised when an error is detected that doesn't fall in any of the other " +"categories. The associated value is a string indicating what precisely went " +"wrong." +msgstr "" + +msgid "" +"Raised by built-in function :func:`next` and " +"an :term:`iterator`\\'s :meth:`~iterator.__next__` method to signal that " +"there are no further items produced by the iterator." +msgstr "" + +msgid "" +"The exception object has a single attribute :attr:`!value`, which is given " +"as an argument when constructing the exception, and defaults " +"to :const:`None`." +msgstr "" + +msgid "" +"When a :term:`generator` or :term:`coroutine` function returns, a " +"new :exc:`StopIteration` instance is raised, and the value returned by the " +"function is used as the :attr:`value` parameter to the constructor of the " +"exception." +msgstr "" + +msgid "" +"If a generator code directly or indirectly raises :exc:`StopIteration`, it " +"is converted into a :exc:`RuntimeError` (retaining the :exc:`StopIteration` " +"as the new exception's cause)." +msgstr "" + +msgid "" +"Added ``value`` attribute and the ability for generator functions to use it " +"to return a value." +msgstr "" + +msgid "" +"Introduced the RuntimeError transformation via ``from __future__ import " +"generator_stop``, see :pep:`479`." +msgstr "" + +msgid "" +"Enable :pep:`479` for all code by default: a :exc:`StopIteration` error " +"raised in a generator is transformed into a :exc:`RuntimeError`." +msgstr "" + +msgid "" +"Must be raised by :meth:`~object.__anext__` method of an :term:`asynchronous " +"iterator` object to stop the iteration." +msgstr "" + +msgid "" +"Raised when the parser encounters a syntax error. This may occur in " +"an :keyword:`import` statement, in a call to the built-in " +"functions :func:`compile`, :func:`exec`, or :func:`eval`, or when reading " +"the initial script or standard input (also interactively)." +msgstr "" + +msgid "" +"The :func:`str` of the exception instance returns only the error message. " +"Details is a tuple whose members are also available as separate attributes." +msgstr "" + +msgid "The name of the file the syntax error occurred in." +msgstr "" + +msgid "" +"Which line number in the file the error occurred in. This is 1-indexed: the " +"first line in the file has a ``lineno`` of 1." +msgstr "" + +msgid "" +"The column in the line where the error occurred. This is 1-indexed: the " +"first character in the line has an ``offset`` of 1." +msgstr "" + +msgid "The source code text involved in the error." +msgstr "" + +msgid "" +"Which line number in the file the error occurred ends in. This is 1-indexed: " +"the first line in the file has a ``lineno`` of 1." +msgstr "" + +msgid "" +"The column in the end line where the error occurred finishes. This is 1-" +"indexed: the first character in the line has an ``offset`` of 1." +msgstr "" + +msgid "" +"For errors in f-string fields, the message is prefixed by \"f-string: \" and " +"the offsets are offsets in a text constructed from the replacement " +"expression. For example, compiling f'Bad {a b} field' results in this args " +"attribute: ('f-string: ...', ('', 1, 2, '(a b)\\n', 1, 5))." +msgstr "" + +msgid "Added the :attr:`end_lineno` and :attr:`end_offset` attributes." +msgstr "" + +msgid "" +"Base class for syntax errors related to incorrect indentation. This is a " +"subclass of :exc:`SyntaxError`." +msgstr "" + +msgid "" +"Raised when indentation contains an inconsistent use of tabs and spaces. " +"This is a subclass of :exc:`IndentationError`." +msgstr "" + +msgid "" +"Raised when the interpreter finds an internal error, but the situation does " +"not look so serious to cause it to abandon all hope. The associated value is " +"a string indicating what went wrong (in low-level terms). " +"In :term:`CPython`, this could be raised by incorrectly using Python's C " +"API, such as returning a ``NULL`` value without an exception set." +msgstr "" + +msgid "" +"If you're confident that this exception wasn't your fault, or the fault of a " +"package you're using, you should report this to the author or maintainer of " +"your Python interpreter. Be sure to report the version of the Python " +"interpreter (``sys.version``; it is also printed at the start of an " +"interactive Python session), the exact error message (the exception's " +"associated value) and if possible the source of the program that triggered " +"the error." +msgstr "" + +msgid "" +"This exception is raised by the :func:`sys.exit` function. It inherits " +"from :exc:`BaseException` instead of :exc:`Exception` so that it is not " +"accidentally caught by code that catches :exc:`Exception`. This allows the " +"exception to properly propagate up and cause the interpreter to exit. When " +"it is not handled, the Python interpreter exits; no stack traceback is " +"printed. The constructor accepts the same optional argument passed " +"to :func:`sys.exit`. If the value is an integer, it specifies the system " +"exit status (passed to C's :c:func:`!exit` function); if it is ``None``, the " +"exit status is zero; if it has another type (such as a string), the object's " +"value is printed and the exit status is one." +msgstr "" + +msgid "" +"A call to :func:`sys.exit` is translated into an exception so that clean-up " +"handlers (:keyword:`finally` clauses of :keyword:`try` statements) can be " +"executed, and so that a debugger can execute a script without running the " +"risk of losing control. The :func:`os._exit` function can be used if it is " +"absolutely positively necessary to exit immediately (for example, in the " +"child process after a call to :func:`os.fork`)." +msgstr "" + +msgid "" +"The exit status or error message that is passed to the constructor. " +"(Defaults to ``None``.)" +msgstr "" + +msgid "" +"Raised when an operation or function is applied to an object of " +"inappropriate type. The associated value is a string giving details about " +"the type mismatch." +msgstr "" + +msgid "" +"This exception may be raised by user code to indicate that an attempted " +"operation on an object is not supported, and is not meant to be. If an " +"object is meant to support a given operation but has not yet provided an " +"implementation, :exc:`NotImplementedError` is the proper exception to raise." +msgstr "" + +msgid "" +"Passing arguments of the wrong type (e.g. passing a :class:`list` when " +"an :class:`int` is expected) should result in a :exc:`TypeError`, but " +"passing arguments with the wrong value (e.g. a number outside expected " +"boundaries) should result in a :exc:`ValueError`." +msgstr "" + +msgid "" +"Raised when a reference is made to a local variable in a function or method, " +"but no value has been bound to that variable. This is a subclass " +"of :exc:`NameError`." +msgstr "" + +msgid "" +"Raised when a Unicode-related encoding or decoding error occurs. It is a " +"subclass of :exc:`ValueError`." +msgstr "" + +msgid "" +":exc:`UnicodeError` has attributes that describe the encoding or decoding " +"error. For example, ``err.object[err.start:err.end]`` gives the particular " +"invalid input that the codec failed on." +msgstr "" + +msgid "The name of the encoding that raised the error." +msgstr "" + +msgid "A string describing the specific codec error." +msgstr "" + +msgid "The object the codec was attempting to encode or decode." +msgstr "" + +msgid "The first index of invalid data in :attr:`object`." +msgstr "" + +msgid "The index after the last invalid data in :attr:`object`." +msgstr "" + +msgid "" +"Raised when a Unicode-related error occurs during encoding. It is a " +"subclass of :exc:`UnicodeError`." +msgstr "" + +msgid "" +"Raised when a Unicode-related error occurs during decoding. It is a " +"subclass of :exc:`UnicodeError`." +msgstr "" + +msgid "" +"Raised when a Unicode-related error occurs during translating. It is a " +"subclass of :exc:`UnicodeError`." +msgstr "" + +msgid "" +"Raised when an operation or function receives an argument that has the right " +"type but an inappropriate value, and the situation is not described by a " +"more precise exception such as :exc:`IndexError`." +msgstr "" + +msgid "" +"Raised when the second argument of a division or modulo operation is zero. " +"The associated value is a string indicating the type of the operands and the " +"operation." +msgstr "" + +msgid "" +"The following exceptions are kept for compatibility with previous versions; " +"starting from Python 3.3, they are aliases of :exc:`OSError`." +msgstr "" + +msgid "Only available on Windows." +msgstr "" + +msgid "OS exceptions" +msgstr "" + +msgid "" +"The following exceptions are subclasses of :exc:`OSError`, they get raised " +"depending on the system error code." +msgstr "" + +msgid "" +"Raised when an operation would block on an object (e.g. socket) set for non-" +"blocking operation. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EAGAIN`, :py:const:`~errno.EALREADY`, :py:const:`~errno.EWOULDBLOCK` " +"and :py:const:`~errno.EINPROGRESS`." +msgstr "" + +msgid "" +"In addition to those of :exc:`OSError`, :exc:`BlockingIOError` can have one " +"more attribute:" +msgstr "" + +msgid "" +"An integer containing the number of **bytes** written to the stream before " +"it blocked. This attribute is available when using the buffered I/O classes " +"from the :mod:`io` module." +msgstr "" + +msgid "" +"Raised when an operation on a child process failed. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECHILD`." +msgstr "" + +msgid "A base class for connection-related issues." +msgstr "" + +msgid "" +"Subclasses " +"are :exc:`BrokenPipeError`, :exc:`ConnectionAbortedError`, :exc:`ConnectionRefusedError` " +"and :exc:`ConnectionResetError`." +msgstr "" + +msgid "" +"A subclass of :exc:`ConnectionError`, raised when trying to write on a pipe " +"while the other end has been closed, or trying to write on a socket which " +"has been shutdown for writing. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EPIPE` and :py:const:`~errno.ESHUTDOWN`." +msgstr "" + +msgid "" +"A subclass of :exc:`ConnectionError`, raised when a connection attempt is " +"aborted by the peer. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECONNABORTED`." +msgstr "" + +msgid "" +"A subclass of :exc:`ConnectionError`, raised when a connection attempt is " +"refused by the peer. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECONNREFUSED`." +msgstr "" + +msgid "" +"A subclass of :exc:`ConnectionError`, raised when a connection is reset by " +"the peer. Corresponds to :c:data:`errno` :py:const:`~errno.ECONNRESET`." +msgstr "" + +msgid "" +"Raised when trying to create a file or directory which already exists. " +"Corresponds to :c:data:`errno` :py:const:`~errno.EEXIST`." +msgstr "" + +msgid "" +"Raised when a file or directory is requested but doesn't exist. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ENOENT`." +msgstr "" + +msgid "" +"Raised when a system call is interrupted by an incoming signal. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EINTR`." +msgstr "" + +msgid "" +"Python now retries system calls when a syscall is interrupted by a signal, " +"except if the signal handler raises an exception (see :pep:`475` for the " +"rationale), instead of raising :exc:`InterruptedError`." +msgstr "" + +msgid "" +"Raised when a file operation (such as :func:`os.remove`) is requested on a " +"directory. Corresponds to :c:data:`errno` :py:const:`~errno.EISDIR`." +msgstr "" + +msgid "" +"Raised when a directory operation (such as :func:`os.listdir`) is requested " +"on something which is not a directory. On most POSIX platforms, it may also " +"be raised if an operation attempts to open or traverse a non-directory file " +"as if it were a directory. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ENOTDIR`." +msgstr "" + +msgid "" +"Raised when trying to run an operation without the adequate access rights - " +"for example filesystem permissions. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EACCES`, :py:const:`~errno.EPERM`, " +"and :py:const:`~errno.ENOTCAPABLE`." +msgstr "" + +msgid "" +"WASI's :py:const:`~errno.ENOTCAPABLE` is now mapped " +"to :exc:`PermissionError`." +msgstr "" + +msgid "" +"Raised when a given process doesn't exist. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ESRCH`." +msgstr "" + +msgid "" +"Raised when a system function timed out at the system level. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ETIMEDOUT`." +msgstr "" + +msgid "All the above :exc:`OSError` subclasses were added." +msgstr "" + +msgid ":pep:`3151` - Reworking the OS and IO exception hierarchy" +msgstr "" + +msgid "Warnings" +msgstr "" + +msgid "" +"The following exceptions are used as warning categories; see " +"the :ref:`warning-categories` documentation for more details." +msgstr "" + +msgid "Base class for warning categories." +msgstr "" + +msgid "Base class for warnings generated by user code." +msgstr "" + +msgid "" +"Base class for warnings about deprecated features when those warnings are " +"intended for other Python developers." +msgstr "" + +msgid "" +"Ignored by the default warning filters, except in the ``__main__`` module " +"(:pep:`565`). Enabling the :ref:`Python Development Mode ` shows " +"this warning." +msgstr "" + +msgid "The deprecation policy is described in :pep:`387`." +msgstr "" + +msgid "" +"Base class for warnings about features which are obsolete and expected to be " +"deprecated in the future, but are not deprecated at the moment." +msgstr "" + +msgid "" +"This class is rarely used as emitting a warning about a possible upcoming " +"deprecation is unusual, and :exc:`DeprecationWarning` is preferred for " +"already active deprecations." +msgstr "" + +msgid "" +"Ignored by the default warning filters. Enabling the :ref:`Python " +"Development Mode ` shows this warning." +msgstr "" + +msgid "Base class for warnings about dubious syntax." +msgstr "" + +msgid "" +"This warning is typically emitted when compiling Python source code, and " +"usually won't be reported when running already compiled code." +msgstr "" + +msgid "Base class for warnings about dubious runtime behavior." +msgstr "" + +msgid "" +"Base class for warnings about deprecated features when those warnings are " +"intended for end users of applications that are written in Python." +msgstr "" + +msgid "Base class for warnings about probable mistakes in module imports." +msgstr "" + +msgid "Base class for warnings related to Unicode." +msgstr "" + +msgid "Base class for warnings related to encodings." +msgstr "" + +msgid "See :ref:`io-encoding-warning` for details." +msgstr "" + +msgid "" +"Base class for warnings related to :class:`bytes` and :class:`bytearray`." +msgstr "" + +msgid "Base class for warnings related to resource usage." +msgstr "" + +msgid "Exception groups" +msgstr "" + +msgid "" +"The following are used when it is necessary to raise multiple unrelated " +"exceptions. They are part of the exception hierarchy so they can be handled " +"with :keyword:`except` like all other exceptions. In addition, they are " +"recognised by :keyword:`except*`, which matches their subgroups " +"based on the types of the contained exceptions." +msgstr "" + +msgid "" +"Both of these exception types wrap the exceptions in the sequence ``excs``. " +"The ``msg`` parameter must be a string. The difference between the two " +"classes is that :exc:`BaseExceptionGroup` extends :exc:`BaseException` and " +"it can wrap any exception, while :exc:`ExceptionGroup` " +"extends :exc:`Exception` and it can only wrap subclasses " +"of :exc:`Exception`. This design is so that ``except Exception`` catches " +"an :exc:`ExceptionGroup` but not :exc:`BaseExceptionGroup`." +msgstr "" + +msgid "" +"The :exc:`BaseExceptionGroup` constructor returns an :exc:`ExceptionGroup` " +"rather than a :exc:`BaseExceptionGroup` if all contained exceptions " +"are :exc:`Exception` instances, so it can be used to make the selection " +"automatic. The :exc:`ExceptionGroup` constructor, on the other hand, raises " +"a :exc:`TypeError` if any contained exception is not an :exc:`Exception` " +"subclass." +msgstr "" + +msgid "" +"Exception groups are :ref:`generic ` over the type of their " +"contained exceptions." +msgstr "" + +msgid "" +"The ``excs`` parameter may be any sequence, but lists and tuples are " +"specifically processed more efficiently here. For optimal performance, pass " +"a tuple as ``excs``." +msgstr "" + +msgid "The ``msg`` argument to the constructor. This is a read-only attribute." +msgstr "" + +msgid "" +"A tuple of the exceptions in the ``excs`` sequence given to the constructor. " +"This is a read-only attribute." +msgstr "" + +msgid "" +"Returns an exception group that contains only the exceptions from the " +"current group that match *condition*, or ``None`` if the result is empty." +msgstr "" + +msgid "" +"The condition can be an exception type or tuple of exception types, in which " +"case each exception is checked for a match using the same check that is used " +"in an ``except`` clause. The condition can also be a callable (other than a " +"type object) that accepts an exception as its single argument and returns " +"true for the exceptions that should be in the subgroup." +msgstr "" + +msgid "" +"The nesting structure of the current exception is preserved in the result, " +"as are the values of " +"its :attr:`message`, :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` " +"and :attr:`~BaseException.__notes__` fields. Empty nested groups are omitted " +"from the result." +msgstr "" + +msgid "" +"The condition is checked for all exceptions in the nested exception group, " +"including the top-level and any nested exception groups. If the condition is " +"true for such an exception group, it is included in the result in full." +msgstr "" + +msgid "``condition`` can be any callable which is not a type object." +msgstr "" + +msgid "" +"Like :meth:`subgroup`, but returns the pair ``(match, rest)`` where " +"``match`` is ``subgroup(condition)`` and ``rest`` is the remaining non-" +"matching part." +msgstr "" + +msgid "" +"Returns an exception group with the same :attr:`message`, but which wraps " +"the exceptions in ``excs``." +msgstr "" + +msgid "" +"This method is used by :meth:`subgroup` and :meth:`split`, which are used in " +"various contexts to break up an exception group. A subclass needs to " +"override it in order to make :meth:`subgroup` and :meth:`split` return " +"instances of the subclass rather than :exc:`ExceptionGroup`." +msgstr "" + +msgid "" +":meth:`subgroup` and :meth:`split` copy " +"the :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` " +"and :attr:`~BaseException.__notes__` fields from the original exception " +"group to the one returned by :meth:`derive`, so these fields do not need to " +"be updated by :meth:`derive`." +msgstr "" + +msgid "" +">>> class MyGroup(ExceptionGroup):\n" +"... def derive(self, excs):\n" +"... return MyGroup(self.message, excs)\n" +"...\n" +">>> e = MyGroup(\"eg\", [ValueError(1), TypeError(2)])\n" +">>> e.add_note(\"a note\")\n" +">>> e.__context__ = Exception(\"context\")\n" +">>> e.__cause__ = Exception(\"cause\")\n" +">>> try:\n" +"... raise e\n" +"... except Exception as e:\n" +"... exc = e\n" +"...\n" +">>> match, rest = exc.split(ValueError)\n" +">>> exc, exc.__context__, exc.__cause__, exc.__notes__\n" +"(MyGroup('eg', [ValueError(1), TypeError(2)]), Exception('context'), " +"Exception('cause'), ['a note'])\n" +">>> match, match.__context__, match.__cause__, match.__notes__\n" +"(MyGroup('eg', [ValueError(1)]), Exception('context'), Exception('cause'), " +"['a note'])\n" +">>> rest, rest.__context__, rest.__cause__, rest.__notes__\n" +"(MyGroup('eg', [TypeError(2)]), Exception('context'), Exception('cause'), " +"['a note'])\n" +">>> exc.__traceback__ is match.__traceback__ is rest.__traceback__\n" +"True" +msgstr "" + +msgid "" +"Note that :exc:`BaseExceptionGroup` defines :meth:`~object.__new__`, so " +"subclasses that need a different constructor signature need to override that " +"rather than :meth:`~object.__init__`. For example, the following defines an " +"exception group subclass which accepts an exit_code and constructs the " +"group's message from it. ::" +msgstr "" + +msgid "" +"class Errors(ExceptionGroup):\n" +" def __new__(cls, errors, exit_code):\n" +" self = super().__new__(Errors, f\"exit code: {exit_code}\", errors)\n" +" self.exit_code = exit_code\n" +" return self\n" +"\n" +" def derive(self, excs):\n" +" return Errors(excs, self.exit_code)" +msgstr "" + +msgid "" +"Like :exc:`ExceptionGroup`, any subclass of :exc:`BaseExceptionGroup` which " +"is also a subclass of :exc:`Exception` can only wrap instances " +"of :exc:`Exception`." +msgstr "" + +msgid "Exception hierarchy" +msgstr "" + +msgid "The class hierarchy for built-in exceptions is:" +msgstr "" + +msgid "" +"BaseException\n" +" ├── BaseExceptionGroup\n" +" ├── GeneratorExit\n" +" ├── KeyboardInterrupt\n" +" ├── SystemExit\n" +" └── Exception\n" +" ├── ArithmeticError\n" +" │ ├── FloatingPointError\n" +" │ ├── OverflowError\n" +" │ └── ZeroDivisionError\n" +" ├── AssertionError\n" +" ├── AttributeError\n" +" ├── BufferError\n" +" ├── EOFError\n" +" ├── ExceptionGroup [BaseExceptionGroup]\n" +" ├── ImportError\n" +" │ └── ModuleNotFoundError\n" +" ├── LookupError\n" +" │ ├── IndexError\n" +" │ └── KeyError\n" +" ├── MemoryError\n" +" ├── NameError\n" +" │ └── UnboundLocalError\n" +" ├── OSError\n" +" │ ├── BlockingIOError\n" +" │ ├── ChildProcessError\n" +" │ ├── ConnectionError\n" +" │ │ ├── BrokenPipeError\n" +" │ │ ├── ConnectionAbortedError\n" +" │ │ ├── ConnectionRefusedError\n" +" │ │ └── ConnectionResetError\n" +" │ ├── FileExistsError\n" +" │ ├── FileNotFoundError\n" +" │ ├── InterruptedError\n" +" │ ├── IsADirectoryError\n" +" │ ├── NotADirectoryError\n" +" │ ├── PermissionError\n" +" │ ├── ProcessLookupError\n" +" │ └── TimeoutError\n" +" ├── ReferenceError\n" +" ├── RuntimeError\n" +" │ ├── NotImplementedError\n" +" │ ├── PythonFinalizationError\n" +" │ └── RecursionError\n" +" ├── StopAsyncIteration\n" +" ├── StopIteration\n" +" ├── SyntaxError\n" +" │ └── IndentationError\n" +" │ └── TabError\n" +" ├── SystemError\n" +" ├── TypeError\n" +" ├── ValueError\n" +" │ └── UnicodeError\n" +" │ ├── UnicodeDecodeError\n" +" │ ├── UnicodeEncodeError\n" +" │ └── UnicodeTranslateError\n" +" └── Warning\n" +" ├── BytesWarning\n" +" ├── DeprecationWarning\n" +" ├── EncodingWarning\n" +" ├── FutureWarning\n" +" ├── ImportWarning\n" +" ├── PendingDeprecationWarning\n" +" ├── ResourceWarning\n" +" ├── RuntimeWarning\n" +" ├── SyntaxWarning\n" +" ├── UnicodeWarning\n" +" └── UserWarning\n" +msgstr "" + +msgid "statement" +msgstr "instrukcja" + +msgid "try" +msgstr "" + +msgid "except" +msgstr "" + +msgid "raise" +msgstr "" + +msgid "exception" +msgstr "" + +msgid "chaining" +msgstr "" + +msgid "__cause__ (exception attribute)" +msgstr "" + +msgid "__context__ (exception attribute)" +msgstr "" + +msgid "__suppress_context__ (exception attribute)" +msgstr "" + +msgid "assert" +msgstr "" + +msgid "module" +msgstr "moduł" + +msgid "errno" +msgstr "" diff --git a/builtins/functions.po b/builtins/functions.po new file mode 100644 index 0000000000..fb8273c553 --- /dev/null +++ b/builtins/functions.po @@ -0,0 +1,4086 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2026 +# python-doc bot, 2026 +# Maciej Olko, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2026-09-13 19:06+0000\n" +"Last-Translator: Maciej Olko, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Built-in Functions" +msgstr "Wbudowane funkcje" + +msgid "" +"The Python interpreter has a number of functions and types built into it " +"that are always available. They are listed here in alphabetical order." +msgstr "" +"Interpreter Pythona ma wbudowane wiele funkcji i typów, które zawsze są " +"dostępne. Spisane są tutaj w kolejności alfabetycznej." + +msgid "**A**" +msgstr "**A**" + +msgid ":func:`abs`" +msgstr ":func:`abs`" + +msgid ":func:`aiter`" +msgstr ":func:`aiter`" + +msgid ":func:`all`" +msgstr ":func:`all`" + +msgid ":func:`anext`" +msgstr ":func:`anext`" + +msgid ":func:`any`" +msgstr ":func:`any`" + +msgid ":func:`ascii`" +msgstr ":func:`ascii`" + +msgid "**B**" +msgstr "**B**" + +msgid ":func:`bin`" +msgstr ":func:`bin`" + +msgid ":func:`bool`" +msgstr ":func:`bool`" + +msgid ":func:`breakpoint`" +msgstr ":func:`breakpoint`" + +msgid "|func-bytearray|_" +msgstr "|func-bytearray|_" + +msgid "|func-bytes|_" +msgstr "|func-bytes|_" + +msgid "**C**" +msgstr "**C**" + +msgid ":func:`callable`" +msgstr ":func:`callable`" + +msgid ":func:`chr`" +msgstr ":func:`chr`" + +msgid ":func:`classmethod`" +msgstr ":func:`classmethod`" + +msgid ":func:`compile`" +msgstr ":func:`compile`" + +msgid ":func:`complex`" +msgstr ":func:`complex`" + +msgid "**D**" +msgstr "**D**" + +msgid ":func:`delattr`" +msgstr ":func:`delattr`" + +msgid "|func-dict|_" +msgstr "|func-dict|_" + +msgid ":func:`dir`" +msgstr ":func:`dir`" + +msgid ":func:`divmod`" +msgstr ":func:`divmod`" + +msgid "**E**" +msgstr "**E**" + +msgid ":func:`enumerate`" +msgstr ":func:`enumerate`" + +msgid ":func:`eval`" +msgstr ":func:`eval`" + +msgid ":func:`exec`" +msgstr ":func:`exec`" + +msgid "**F**" +msgstr "**F**" + +msgid ":func:`filter`" +msgstr ":func:`filter`" + +msgid ":func:`float`" +msgstr ":func:`float`" + +msgid ":func:`format`" +msgstr ":func:`format`" + +msgid "|func-frozenset|_" +msgstr "|func-frozenset|_" + +msgid "**G**" +msgstr "**G**" + +msgid ":func:`getattr`" +msgstr ":func:`getattr`" + +msgid ":func:`globals`" +msgstr ":func:`globals`" + +msgid "**H**" +msgstr "**H**" + +msgid ":func:`hasattr`" +msgstr ":func:`hasattr`" + +msgid ":func:`hash`" +msgstr ":func:`hash`" + +msgid ":func:`help`" +msgstr ":func:`help`" + +msgid ":func:`hex`" +msgstr ":func:`hex`" + +msgid "**I**" +msgstr "**I**" + +msgid ":func:`id`" +msgstr ":func:`id`" + +msgid ":func:`input`" +msgstr ":func:`input`" + +msgid ":func:`int`" +msgstr ":func:`int`" + +msgid ":func:`isinstance`" +msgstr ":func:`isinstance`" + +msgid ":func:`issubclass`" +msgstr ":func:`issubclass`" + +msgid ":func:`iter`" +msgstr ":func:`iter`" + +msgid "**L**" +msgstr "**L**" + +msgid ":func:`len`" +msgstr ":func:`len`" + +msgid "|func-list|_" +msgstr "|func-list|_" + +msgid ":func:`locals`" +msgstr ":func:`locals`" + +msgid "**M**" +msgstr "**M**" + +msgid ":func:`map`" +msgstr ":func:`map`" + +msgid ":func:`max`" +msgstr ":func:`max`" + +msgid "|func-memoryview|_" +msgstr "|func-memoryview|_" + +msgid ":func:`min`" +msgstr ":func:`min`" + +msgid "**N**" +msgstr "**N**" + +msgid ":func:`next`" +msgstr ":func:`next`" + +msgid "**O**" +msgstr "**O**" + +msgid ":func:`object`" +msgstr ":func:`object`" + +msgid ":func:`oct`" +msgstr ":func:`oct`" + +msgid ":func:`open`" +msgstr ":func:`open`" + +msgid ":func:`ord`" +msgstr ":func:`ord`" + +msgid "**P**" +msgstr "**P**" + +msgid ":func:`pow`" +msgstr ":func:`pow`" + +msgid ":func:`print`" +msgstr ":func:`print`" + +msgid ":func:`property`" +msgstr ":func:`property`" + +msgid "**R**" +msgstr "**R**" + +msgid "|func-range|_" +msgstr "|func-range|_" + +msgid ":func:`repr`" +msgstr ":func:`repr`" + +msgid ":func:`reversed`" +msgstr ":func:`reversed`" + +msgid ":func:`round`" +msgstr ":func:`round`" + +msgid "**S**" +msgstr "**S**" + +msgid "|func-set|_" +msgstr "|func-set|_" + +msgid ":func:`setattr`" +msgstr ":func:`setattr`" + +msgid ":func:`slice`" +msgstr ":func:`slice`" + +msgid ":func:`sorted`" +msgstr ":func:`sorted`" + +msgid ":func:`staticmethod`" +msgstr ":func:`staticmethod`" + +msgid "|func-str|_" +msgstr "|func-str|_" + +msgid ":func:`sum`" +msgstr ":func:`sum`" + +msgid ":func:`super`" +msgstr ":func:`super`" + +msgid "**T**" +msgstr "**T**" + +msgid "|func-tuple|_" +msgstr "|func-tuple|_" + +msgid ":func:`type`" +msgstr ":func:`type`" + +msgid "**V**" +msgstr "**V**" + +msgid ":func:`vars`" +msgstr ":func:`vars`" + +msgid "**Z**" +msgstr "**Z**" + +msgid ":func:`zip`" +msgstr ":func:`zip`" + +msgid "**_**" +msgstr "**_**" + +msgid ":func:`__import__`" +msgstr ":func:`__import__`" + +msgid "" +"Return the absolute value of a number. The argument may be an integer, a " +"floating-point number, or an object implementing :meth:`~object.__abs__`. If " +"the argument is a complex number, its magnitude is returned." +msgstr "" +"Zwraca wartość bezwzględną liczby. Argument może być liczbą całkowitą, " +"zmiennoprzecinkową lub obiektem implementującym :meth:`~object.__abs__`. " +"Jeśli argument jest liczbą zespoloną, zwracany jest jej moduł." + +msgid "" +"Return an :term:`asynchronous iterator` for an :term:`asynchronous " +"iterable`. Equivalent to calling ``x.__aiter__()``." +msgstr "" +"Zwraca :term:`asynchroniczny iterator ` " +"dla :term:`asynchronicznego iterable'a `. Ekwiwalent " +"wywołania ``x.__aiter__()``." + +msgid "Note: Unlike :func:`iter`, :func:`aiter` has no 2-argument variant." +msgstr "" +"Uwaga: W przeciwieństwie do :func:`iter`, :func:`aiter` nie ma " +"dwuargumentowego wariantu." + +msgid "" +"Return ``True`` if all elements of the *iterable* are true (or if the " +"iterable is empty). Equivalent to::" +msgstr "" +"Zwraca ``True`` jeśli wszystkie elementy *iterable*'a są prawdziwe (lub " +"jeśli iterable jest pusty). Ekwiwalent kodu::" + +msgid "" +"def all(iterable):\n" +" for element in iterable:\n" +" if not element:\n" +" return False\n" +" return True" +msgstr "" +"def all(iterable):\n" +" for element in iterable:\n" +" if not element:\n" +" return False\n" +" return True" + +msgid "" +"When awaited, return the next item from the given :term:`asynchronous " +"iterator`, or *default* if given and the iterator is exhausted." +msgstr "" +"W przypadku oczekiwania zwraca następny element z " +"podanego :term:`asynchronicznego iteratora ` lub " +"wartość *default*, jeżeli jest ona podana, a iterator został wyczerpany." + +msgid "" +"This is the async variant of the :func:`next` builtin, and behaves similarly." +msgstr "" +"Jest to asynchroniczny wariant wbudowanej funkcji :func:`next` i zachowuje " +"się podobnie." + +msgid "" +"This calls the :meth:`~object.__anext__` method of *async_iterator*, " +"returning an :term:`awaitable`. Awaiting this returns the next value of the " +"iterator. If *default* is given, it is returned if the iterator is " +"exhausted, otherwise :exc:`StopAsyncIteration` is raised." +msgstr "" +"Wywołuje on metodę :meth:`~object.__anext__` *async_iteratora*, " +"zwracając :term:`awaitable`. Oczekiwanie zwraca następną wartość iteratora. " +"Jeśli podano wartość *default*, jest ona zwracana, jeśli iterator zostanie " +"wyczerpany, w przeciwnym razie zostanie podniesiony " +"wyjątek :exc:`StopAsyncIteration`." + +msgid "" +"Return ``True`` if any element of the *iterable* is true. If the iterable " +"is empty, return ``False``. Equivalent to::" +msgstr "" +"Zwraca ``True`` jeśli jakikolwiek element *iterable*'a jest prawdziwy. Jeśli " +"iterable jest pusty, zwraca ``False``. Ekwiwalent kodu::" + +msgid "" +"def any(iterable):\n" +" for element in iterable:\n" +" if element:\n" +" return True\n" +" return False" +msgstr "" +"def any(iterable):\n" +" for element in iterable:\n" +" if element:\n" +" return True\n" +" return False" + +msgid "" +"As :func:`repr`, return a string containing a printable representation of an " +"object, but escape the non-ASCII characters in the string returned " +"by :func:`repr` using ``\\x``, ``\\u``, or ``\\U`` escapes. This generates " +"a string similar to that returned by :func:`repr` in Python 2." +msgstr "" +"Tak jak :func:`repr`, zwraca ciąg znaków zawierający reprezentację obiektu, " +"ale wypisuje znaki nie-ASCII w zwracanym przez :func:`repr` ciągu przy " +"użyciu escape'ów ``\\x``, ``\\u`` lub ``\\U``. Generuje ciąg znaków podobny " +"do tego zwracanego przez :func:`repr` w Pythonie 2." + +msgid "" +"Convert an integer number to a binary string prefixed with \"0b\". The " +"result is a valid Python expression. If *integer* is not a " +"Python :class:`int` object, it has to define an :meth:`~object.__index__` " +"method that returns an integer. Some examples:" +msgstr "" +"Konwertuje liczbę całkowitą do binarnego ciągu znaków z prefiksem „0b”. " +"Wynik jest poprawnym wyrażeniem Pythona. Jeśli *integer* nie jest pythonowym " +"obiektem :class:`int`, musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbę całkowitą. Kilka przykładów:" + +msgid "" +"If the prefix \"0b\" is desired or not, you can use either of the following " +"ways." +msgstr "" +"Jeśli prefiks „0b” nie jest pożądany, możesz użyć któregoś z poniższych " +"sposobów." + +msgid "" +"See also :func:`enum.bin` to represent negative values as twos-complement." +msgstr "" +"Patrz również :func:`enum.bin` do reprezentowania ujemnych wartości w kodzie " +"uzupełnień do dwóch." + +msgid "See also :func:`format` for more information." +msgstr "Zobacz też :func:`format` by uzyskać więcej informacji." + +msgid "" +"Return a Boolean value, i.e. one of ``True`` or ``False``. The argument is " +"converted using the standard :ref:`truth testing procedure `. If the " +"argument is false or omitted, this returns ``False``; otherwise, it returns " +"``True``. The :class:`bool` class is a subclass of :class:`int` " +"(see :ref:`typesnumeric`). It cannot be subclassed further. Its only " +"instances are ``False`` and ``True`` (see :ref:`typebool`)." +msgstr "" +"Zwraca wartość logiczną, tj. jedno z ``True`` lub ``False``. Wartość " +"argumentu jest konwertowana przy użyciu standardowej procedury " +"testowania :ref:`truth testing procedure`. Jeśli argument jest " +"fałszywy lub pominięty, zwraca ``False``; w przeciwnym razie, zwraca " +"``True``. Klasa :class:`bool` jest podklasą klasy :class:`int` " +"(zobacz :ref:`typesnumeric`). Nie może być dalej podklasowana. Jej jedynymi " +"instancjami są ``False`` i ``True`` (zobacz :ref:`typebool`)." + +msgid "The parameter is now positional-only." +msgstr "Parametr jest teraz tylko-pozycyjny." + +msgid "" +"This function drops you into the debugger at the call site. Specifically, " +"it calls :func:`sys.breakpointhook`, passing ``args`` and ``kws`` straight " +"through. By default, ``sys.breakpointhook()`` calls :func:`pdb.set_trace` " +"expecting no arguments. In this case, it is purely a convenience function " +"so you don't have to explicitly import :mod:`pdb` or type as much code to " +"enter the debugger. However, :func:`sys.breakpointhook` can be set to some " +"other function and :func:`breakpoint` will automatically call that, allowing " +"you to drop into the debugger of choice. If :func:`sys.breakpointhook` is " +"not accessible, this function will raise :exc:`RuntimeError`." +msgstr "" +"Ta funkcja powoduje przejście do debuggera w miejscu wywołania. W " +"szczególności wywołuje :func:`sys.breakpointhook`, przekazując do niego " +"bezpośrednio ``args`` i ``kws``. Domyślnie ``sys.breakpointhook()`` wywołuje " +"funkcję :func:`pdb.set_trace` nie oczekującą argumentu. W tym przypadku jest " +"to wyłącznie funkcja dla wygody, aby nie trzeba było jawnie " +"importować :mod:`pdb` ani wpisywać tak dużo kodu, aby wejść do debuggera. " +"Jednakże :func:`sys.breakpointhook` może być ustawiony na inną funkcję " +"i :func:`breakpoint` automatycznie wywoła ją, pozwalając na przejście do " +"wybranego debuggera. Jeśli :func:`sys.breakpointhook` nie jest dostępny, " +"funkcja rzuci :exc:`RuntimeError`." + +msgid "" +"By default, the behavior of :func:`breakpoint` can be changed with " +"the :envvar:`PYTHONBREAKPOINT` environment variable. " +"See :func:`sys.breakpointhook` for usage details." +msgstr "" +"Domyślnie zachowanie funkcji :func:`breakpoint` można zmienić za pomocą " +"zmiennej środowiskowej :envvar:`PYTHONBREAKPOINT`. Szczegółowe informacje " +"można znaleźć w :func:`sys.breakpointhook`." + +msgid "" +"Note that this is not guaranteed if :func:`sys.breakpointhook` has been " +"replaced." +msgstr "" +"Należy pamiętać, że nie jest to gwarantowane, " +"jeśli :func:`sys.breakpointhook` został wymieniony." + +msgid "" +"Raises an :ref:`auditing event ` ``builtins.breakpoint`` with " +"argument ``breakpointhook``." +msgstr "" +"Rzuca :ref:`auditing event ` ``builtins.breakpoint`` z argumentem " +"``breakpointhook``." + +msgid "" +"Return a new array of bytes. The :class:`bytearray` class is a mutable " +"sequence of integers in the range 0 <= x < 256. It has most of the usual " +"methods of mutable sequences, described in :ref:`typesseq-mutable`, as well " +"as most methods that the :class:`bytes` type has, see :ref:`bytes-methods`." +msgstr "" +"Zwraca nową tablicę bajtów. Klasa :class:`bytearray` jest mutowalną " +"sekwencją liczb całkowitych w zakresie 0 <= x < 256. Ma większość metod " +"mutowalnych sekwencji, opisanych w :ref:`typesseq-mutable`, jak również " +"większość metod, które ma typ :class:`bytes`, patrz :ref:`bytes-methods`." + +msgid "" +"The optional *source* parameter can be used to initialize the array in a few " +"different ways:" +msgstr "" +"Opcjonalny parametr *source* może być użyty do inicjalizacji tablicy na " +"kilka różnych sposobów:" + +msgid "" +"If it is a *string*, you must also give the *encoding* (and optionally, " +"*errors*) parameters; :func:`bytearray` then converts the string to bytes " +"using :meth:`str.encode`." +msgstr "" +"Jeśli jest *stringiem*, musisz podać również parametr *encoding* (i " +"opcjonalnie *errors*); :func:`bytearray` konwertuje string na bajty " +"używając :meth:`str.encode`." + +msgid "" +"If it is an *integer*, the array will have that size and will be initialized " +"with null bytes." +msgstr "" +"Jeśli jest *liczbą całkowitą*, tablica będzie miała taki rozmiar i będzie " +"zainicjowana bajtami zerowymi." + +msgid "" +"If it is an object conforming to the :ref:`buffer interface " +"`, a read-only buffer of the object will be used to " +"initialize the bytes array." +msgstr "" +"Jeśli jest to obiekt spełniający :ref:`interfejs bufora `, " +"bufor tylko-do-odczytu obiektu zostanie użyty do zainicjowania tablicy " +"bajtów." + +msgid "" +"If it is an *iterable*, it must be an iterable of integers in the range ``0 " +"<= x < 256``, which are used as the initial contents of the array." +msgstr "" +"Jeśli jest *iterablem*, musi być iterablem składającym się z liczb " +"całkowitych w zakresie ``0 <= x < 256``, które są użyte do zainicjowania " +"tablicy." + +msgid "Without an argument, an array of size 0 is created." +msgstr "Bez argumentu tworzona jest tablica o rozmiarze 0." + +msgid "See also :ref:`binaryseq` and :ref:`typebytearray`." +msgstr "Zobacz też :ref:`binaryseq` i :ref:`typebytearray`." + +msgid "" +"Return a new \"bytes\" object which is an immutable sequence of integers in " +"the range ``0 <= x < 256``. :class:`bytes` is an immutable version " +"of :class:`bytearray` -- it has the same non-mutating methods and the same " +"indexing and slicing behavior." +msgstr "" +"Zwraca nowy obiekt „bajtów”, który jest niemutowalną sekwencją liczb " +"całkowitych z zakresu ``0 <= x < 256``. :class:`bytes` jest niemutowalną " +"wersją :class:`bytearray` -- ma te same niemutujące metody i to samo " +"zachowanie indeksowania i slice'owania." + +msgid "" +"Accordingly, constructor arguments are interpreted as for :func:`bytearray`." +msgstr "" +"Argumenty konstruktora są interpretowane tak jak dla :func:`bytearray`." + +msgid "Bytes objects can also be created with literals, see :ref:`strings`." +msgstr "" +"Obiekty bytes mogą być również tworzone z literałami, patrz :ref:`strings`." + +msgid "See also :ref:`binaryseq`, :ref:`typebytes`, and :ref:`bytes-methods`." +msgstr "Zobacz też :ref:`binaryseq`, :ref:`typebytes` i :ref:`bytes-methods`." + +msgid "" +"Return :const:`True` if the *object* argument appears " +"callable, :const:`False` if not. If this returns ``True``, it is still " +"possible that a call fails, but if it is ``False``, calling *object* will " +"never succeed. Note that classes are callable (calling a class returns a new " +"instance); instances are callable if their class has " +"a :meth:`~object.__call__` method." +msgstr "" +"Zwraca :const:`True` jeśli argument *object* jest " +"wywoływalny, :const:`False` jeśli nie. Jeśli zwraca ``True``, nadal możliwe " +"jest, że wywołanie nie powiedzie się, ale jeśli zwraca ``False``, wywołanie " +"*object* nigdy się nie powiedzie. Należy pamiętać, że klasy są wywoływalne " +"(wywołanie klasy zwraca nową instancję); instancje są wywoływalne, jeśli ich " +"klasa ma metodę :meth:`~object.__call__`." + +msgid "" +"This function was first removed in Python 3.0 and then brought back in " +"Python 3.2." +msgstr "" +"Ta funkcja była wpierw usunięta w Pythonie 3.0 a następnie przywrócona w " +"Pythonie 3.2." + +msgid "" +"Return the string representing a character with the specified Unicode code " +"point. For example, ``chr(97)`` returns the string ``'a'``, while " +"``chr(8364)`` returns the string ``'€'``. This is the inverse of :func:`ord`." +msgstr "" +"Zwraca ciąg znaków reprezentujący znak dla podanego punktu kodowego Unicode. " +"Na przykład ``chr(97)`` zwraca ciąg znaków ``'a'``, a ``chr(8364)`` zwraca " +"ciąg ``'€'``. Jest odwrotnością :func:`ord`." + +msgid "" +"The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in " +"base 16). :exc:`ValueError` will be raised if it is outside that range." +msgstr "" +"Poprawnym zakresem argumentu są wartości od 0 do 1 114 111 (0x10FFFF w " +"systemie szesnastkowym). Dla wartości poza tym zakresem zostanie " +"rzucony :exc:`ValueError`." + +msgid "Transform a method into a class method." +msgstr "Przekształca metodę w metodę klasową." + +msgid "" +"A class method receives the class as an implicit first argument, just like " +"an instance method receives the instance. To declare a class method, use " +"this idiom::" +msgstr "" +"Metoda klasowa otrzymuje klasę jako niejawny pierwszy argument, podobnie jak " +"metoda instancji otrzymuje instancję. Aby zadeklarować metodę klasową, użyj " +"tego idiomu::" + +msgid "" +"class C:\n" +" @classmethod\n" +" def f(cls, arg1, arg2): ..." +msgstr "" +"class C:\n" +" @classmethod\n" +" def f(cls, arg1, arg2): ..." + +msgid "" +"The ``@classmethod`` form is a function :term:`decorator` -- " +"see :ref:`function` for details." +msgstr "" +"Forma ``@classmethod`` jest :term:`dekoratorem ` funkcji – " +"szczegóły znajdziesz w :ref:`function`." + +msgid "" +"A class method can be called either on the class (such as ``C.f()``) or on " +"an instance (such as ``C().f()``). The instance is ignored except for its " +"class. If a class method is called for a derived class, the derived class " +"object is passed as the implied first argument." +msgstr "" +"Metoda klasowa może być wywoływana albo na klasie (na przykład ``C.f()``) " +"albo na instancji (na przykład ``C().f()``). Instancja jest ignorowana, " +"brana jest pod uwagę tylko jej klasa. Jeśli metoda klasowa jest wywołana dla " +"klasy dziedziczącej, obiekt klasy dziedziczącej jest przekazywany jako " +"pierwszy argument." + +msgid "" +"Class methods are different than C++ or Java static methods. If you want " +"those, see :func:`staticmethod` in this section. For more information on " +"class methods, see :ref:`types`." +msgstr "" +"Metody klasowe różnią się od statycznych metod C++ lub Javy. Jeśli chcesz " +"takie, sprawdź :func:`staticmethod` w tej sekcji. Więcej informacji o " +"metodach klasowych znajdziesz w :ref:`types`." + +msgid "" +"Class methods can now wrap other :term:`descriptors ` such " +"as :func:`property`." +msgstr "" +"Metody klasowe mogą teraz opakowywać inne :term:`deskryptory `, " +"takie jak :func:`property`." + +msgid "" +"Class methods now inherit the method attributes " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"and :attr:`~function.__annotations__`) and have a new ``__wrapped__`` " +"attribute." +msgstr "" +"Metody klasowe dziedziczą teraz atrybuty metod " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"i :attr:`~function.__annotations__`) i mają nowy atrybut ``__wrapped__``." + +msgid "" +"Class methods can no longer wrap other :term:`descriptors ` such " +"as :func:`property`." +msgstr "" +"Metody klas nie mogą już opakowywać innych :term:`deskryptorów ` " +"takich jak :func:`property`." + +msgid "" +"Compile the *source* into a code or AST object. Code objects can be " +"executed by :func:`exec` or :func:`eval`. *source* can either be a normal " +"string, a byte string, or an AST object. Refer to the :mod:`ast` module " +"documentation for information on how to work with AST objects." +msgstr "" +"Kompiluje *source* do obiektu kodu lub obiektu AST. Obiekty kodu mogą wyć " +"wykonywane przy użyciu :func:`exec` lub :func:`eval`. *source* może być " +"zwykłym ciągiem znaków, ciągiem bajtów lub obiektem AST. W dokumentacji " +"modułu :mod:`ast` znajdziesz informacje o tym jak pracować z obiektami AST." + +msgid "" +"The *filename* argument should give the file from which the code was read; " +"pass some recognizable value if it wasn't read from a file (``''`` " +"is commonly used)." +msgstr "" +"Argument *filename* powinien dawać plik, z którego kod został przeczytany; " +"przekaż jakąś rozpoznawalną wartość, jeśli nie został przeczytany z pliku " +"(często używa się ``''``)." + +msgid "" +"The *mode* argument specifies what kind of code must be compiled; it can be " +"``'exec'`` if *source* consists of a sequence of statements, ``'eval'`` if " +"it consists of a single expression, or ``'single'`` if it consists of a " +"single interactive statement (in the latter case, expression statements that " +"evaluate to something other than ``None`` will be printed)." +msgstr "" +"Argument *mode* określa, jaki rodzaj kodu ma zostać skompilowany; może mieć " +"wartość ``'exec'`` jeśli *source* składa się z sekwencji instrukcji, " +"``'eval'`` jeśli składa się z jednego wyrażenia lub ``'single'`` jeśli " +"składa się z jednej interaktywnej instrukcji (w ostatnim przypadku, " +"instrukcje wyrażeń, które ewaluują się do czegoś innego niż ``None``, " +"zostaną wydrukowane na standardowe wyjście)." + +msgid "" +"The optional arguments *flags* and *dont_inherit* control " +"which :ref:`compiler options ` should be activated and " +"which :ref:`future features ` should be allowed. If neither is " +"present (or both are zero) the code is compiled with the same flags that " +"affect the code that is calling :func:`compile`. If the *flags* argument is " +"given and *dont_inherit* is not (or is zero) then the compiler options and " +"the future statements specified by the *flags* argument are used in addition " +"to those that would be used anyway. If *dont_inherit* is a non-zero integer " +"then the *flags* argument is it -- the flags (future features and compiler " +"options) in the surrounding code are ignored." +msgstr "" +"Opcjonalne argumenty *flags* i *dont_inherit* kontrolują, które :ref:`opcje " +"kompilatora ` powinny być aktywowane i " +"które :ref:`przyszłe funkcje ` powinne być dozwolone. Jeśli żaden z " +"nich nie jest obecny (lub oba są zerowe), kod jest kompilowany z tymi samymi " +"flagami, które wpływają na kod wywołujący :func:`compile`. Jeśli argument " +"*flags* jest podany, a *dont_inherit* nie jest (lub wynosi zero), to opcje " +"kompilatora i przyszłe instrukcje określone przez argument *flags* są " +"używane w dodatku do tych, które i tak byłyby użyte. Jeśli *dont_inherit* " +"jest niezerową liczbą całkowitą, to argument *flags* jest nim – flagi " +"(przyszłe funkcje i opcje kompilatora) w otaczającym kodzie są ignorowane." + +msgid "" +"Compiler options and future statements are specified by bits which can be " +"bitwise ORed together to specify multiple options. The bitfield required to " +"specify a given future feature can be found as " +"the :attr:`~__future__._Feature.compiler_flag` attribute on " +"the :class:`~__future__._Feature` instance in the :mod:`__future__` " +"module. :ref:`Compiler flags ` can be found " +"in :mod:`ast` module, with ``PyCF_`` prefix." +msgstr "" +"Opcje kompilatora i przyszłe instrukcja są określone przez bity, które mogą " +"być łączone bitowo w celu określenia wielu opcji. Pole bitowe wymagane do " +"określenia danej przyszłej funkcji można znaleźć " +"jako :attr:`~__future__._Feature.compiler_flag` atrybut na " +"instancji :class:`~__future__._Feature` w " +"module :mod:`__future__` . :ref:`Flagi kompilatora ` " +"można znaleźć w module :mod:`ast` , z prefiksem ``PyCF_``." + +msgid "" +"The argument *optimize* specifies the optimization level of the compiler; " +"the default value of ``-1`` selects the optimization level of the " +"interpreter as given by :option:`-O` options. Explicit levels are ``0`` (no " +"optimization; ``__debug__`` is true), ``1`` (asserts are removed, " +"``__debug__`` is false) or ``2`` (docstrings are removed too)." +msgstr "" +"Wartość argumentu *optimize* określa poziom optymalizacji kompilatora; " +"wartość domyślna ``-1`` wybiera poziom optymalizacji interpretera podany " +"przez opcje :option:`-O`. Wyraźne poziomy to ``0`` (brak optymalizacji; " +"``__debug__`` to prawda), ``1`` (asercje są usuwane, ``__debug__`` to fałsz) " +"lub ``2`` (docstrings są również usuwane)." + +msgid "" +"This function raises :exc:`SyntaxError` if the compiled source is invalid, " +"including a *source* containing a null character or that cannot be " +"decoded; :exc:`ValueError` if *mode* or *flags* is invalid, or if a string " +"*source* contains surrogate characters; :exc:`MemoryError` " +"or :exc:`RecursionError` if *source* is too complex to parse or compile, for " +"example an expression with many thousands of nested operators; " +"and :exc:`OverflowError` if *source* is too large." +msgstr "" +"Funkcja rzuca :exc:`SyntaxError`, jeśli skompilowany kod źródłowy jest " +"nieprawidłowy, w tym jeśli *source* zawiera znak null lub nie można go " +"zdekodować; :exc:`ValueError` jeśli *mode* lub *flags* są nieprawidłowe, lub " +"jeśli ciąg znaków *source* zawiera znaki zastępcze; :exc:`MemoryError` " +"lub :exc:`RecursionError`, jeśli *source* jest zbyt złożone, by można było " +"je przeanalizować lub skompilować, na przykład wyrażenie zawierające wiele " +"tysięcy zagnieżdżonych operatorów; oraz :exc:`OverflowError`, jeśli *source* " +"jest zbyt duże." + +msgid "" +"If you want to parse Python code into its AST representation, " +"see :func:`ast.parse`." +msgstr "" +"Jeśli chcesz przeanalizować kod Python do jego reprezentacji AST, " +"zobacz :func:`ast.parse`." + +msgid "" +"Raises an :ref:`auditing event ` ``compile`` with arguments " +"``source`` and ``filename``. This event may also be raised by implicit " +"compilation." +msgstr "" +"Rzuci zdarzenie :ref:`auditing ` ``compile`` z argumentem " +"``source`` i ``filename``. To zdarzenie może być również rzucone przez " +"niejawną kompilację." + +msgid "" +"When compiling a string with multi-line code in ``'single'`` or ``'eval'`` " +"mode, input must be terminated by at least one newline character. This is " +"to facilitate detection of incomplete and complete statements in " +"the :mod:`code` module." +msgstr "" +"Podczas kompilacji napisem z kodem wielowierszowym w trybie ``'single'`` lub " +"``'eval'``, dane wejściowe muszą być zakończone co najmniej jedną znak nowej " +"lini. Ma to na celu ułatwienie wykrywania niekompletnych i kompletnych " +"instrukcja w module :mod:`code` ." + +msgid "" +"It is possible to crash the Python interpreter with a sufficiently large/" +"complex string when compiling to an AST object due to stack depth " +"limitations in Python's AST compiler." +msgstr "" +"Możliwe jest zawieszenie interpretera Python z wystarczająco dużym/złożonym " +"napisem podczas kompilacji do obiektu AST z powodu ograniczeń głębokości " +"stosu w kompilatorze AST Python." + +msgid "" +"Allowed use of Windows and Mac newlines. Also, input in ``'exec'`` mode " +"does not have to end in a newline anymore. Added the *optimize* parameter." +msgstr "" +"Zezwolono na używanie nowej linii w systemach Windows i Mac. Ponadto " +"wprowadzanie danych w trybie ``'exec'`` nie musi już kończyć się nową " +"linią. Dodano funkcję *optimize* parametr." + +msgid "" +"Previously, :exc:`TypeError` was raised when null bytes were encountered in " +"*source*." +msgstr "" +"Poprzednio, :exc:`TypeError` został rzucony gdy napotkano bajty null w " +"*source*." + +msgid "" +"``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` can now be passed in flags to enable " +"support for top-level ``await``, ``async for``, and ``async with``." +msgstr "" +"``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` można teraz przekazywać we flagach, aby " +"włączyć obsługę najwyższego poziomu ``await``, ``async for`` i ``async " +"with``." + +msgid "" +":exc:`SyntaxError` is raised instead of :exc:`ValueError` when null bytes " +"are encountered in *source*." +msgstr "" +":exc:`SyntaxError` jest rzucane zamiast :exc:`ValueError`, gdy w *source* " +"napotkano bajty null." + +msgid "" +"Convert a single string or number to a complex number, or create a complex " +"number from real and imaginary parts." +msgstr "" +"Konwertowanie pojedynczego napisu lub liczby na liczba zespolona lub " +"tworzenie liczba zespolona z części rzeczywistej i urojonej." + +msgid "Examples:" +msgstr "Przykłady:" + +msgid "" +">>> complex('+1.23')\n" +"(1.23+0j)\n" +">>> complex('-4.5j')\n" +"-4.5j\n" +">>> complex('-1.23+4.5j')\n" +"(-1.23+4.5j)\n" +">>> complex('\\t( -1.23+4.5J )\\n')\n" +"(-1.23+4.5j)\n" +">>> complex('-Infinity+NaNj')\n" +"(-inf+nanj)\n" +">>> complex(1.23)\n" +"(1.23+0j)\n" +">>> complex(imag=-4.5)\n" +"-4.5j\n" +">>> complex(-1.23, 4.5)\n" +"(-1.23+4.5j)" +msgstr "" +">>> complex('+1.23')\n" +"(1.23+0j)\n" +">>> complex('-4.5j')\n" +"-4.5j\n" +">>> complex('-1.23+4.5j')\n" +"(-1.23+4.5j)\n" +">>> complex('\\t( -1.23+4.5J )\\n')\n" +"(-1.23+4.5j)\n" +">>> complex('-Infinity+NaNj')\n" +"(-inf+nanj)\n" +">>> complex(1.23)\n" +"(1.23+0j)\n" +">>> complex(imag=-4.5)\n" +"-4.5j\n" +">>> complex(-1.23, 4.5)\n" +"(-1.23+4.5j)" + +msgid "" +"If the argument is a string, it must contain either a real part (in the same " +"format as for :func:`float`) or an imaginary part (in the same format but " +"with a ``'j'`` or ``'J'`` suffix), or both real and imaginary parts (the " +"sign of the imaginary part is mandatory in this case). The string can " +"optionally be surrounded by whitespaces and the round parentheses ``'('`` " +"and ``')'``, which are ignored. The string must not contain whitespace " +"between ``'+'``, ``'-'``, the ``'j'`` or ``'J'`` suffix, and the decimal " +"number. For example, ``complex('1+2j')`` is fine, but ``complex('1 + 2j')`` " +"raises :exc:`ValueError`. More precisely, the input must conform to " +"the :token:`~float:complexvalue` production rule in the following grammar, " +"after parentheses and leading and trailing whitespace characters are removed:" +msgstr "" +"Jeśli argument jest napisem, musi zawierać albo część rzeczywistą (w tym " +"samym formacie co :func:`float`), albo część urojoną (w tym samym formacie, " +"ale z przyrostkiem ``'j'`` lub ``'J'`` ), albo zarówno część rzeczywistą, " +"jak i urojoną (znak części urojonej jest w tym przypadku obowiązkowy). " +"Wartość napis może być opcjonalnie otoczona białymi znakami i okrągłymi " +"nawiasami ``'('`` i ``')'``, które są ignorowane. napis nie może zawierać " +"białych znaków między ``'+'``, ``'-'``, przyrostkiem ``'j'`` lub ``'J'`` a " +"liczbą dziesiętną. Na przykład, ``complex('1+2j')`` jest w porządku, ale " +"``complex('1 + 2j')`` rzuci :exc:`ValueError` . Dokładniej, dane wejściowe " +"muszą być zgodne z regułą produkcji :token:`~float:complexvalue` w poniższej " +"gramatyce, po usunięciu nawiasów oraz początkowych i końcowych znaków:" + +msgid "" +"If the argument is a number, the constructor serves as a numeric conversion " +"like :class:`int` and :class:`float`. For a general Python object ``x``, " +"``complex(x)`` delegates to ``x.__complex__()``. " +"If :meth:`~object.__complex__` is not defined then it falls back " +"to :meth:`~object.__float__`. If :meth:`!__float__` is not defined then it " +"falls back to :meth:`~object.__index__`." +msgstr "" +"Jeśli argument jest liczbą, konstruktor służy jako konwersja numeryczna, " +"podobnie jak :class:`int` i :class:`float`. Dla ogólnego obiektu Python " +"``x`` , ``complex(x)`` deleguje do ``x.__complex__()``. " +"Jeśli :meth:`~object.__complex__` nie jest zdefiniowane, to spada z powrotem " +"do :meth:`~object.__float__`. Jeśli :meth:`!__float__` nie jest " +"zdefiniowane, to spada z powrotem do :meth:`~object.__index__`." + +msgid "" +"If two arguments are provided or keyword arguments are used, each argument " +"may be any numeric type (including complex). If both arguments are real " +"numbers, return a complex number with the real component *real* and the " +"imaginary component *imag*. If both arguments are complex numbers, return a " +"complex number with the real component ``real.real-imag.imag`` and the " +"imaginary component ``real.imag+imag.real``. If one of arguments is a real " +"number, only its real component is used in the above expressions." +msgstr "" +"Jeśli podano dwa argumenty lub argument nazwany, każdy argument może być " +"dowolnego typu liczbowego (w tym liczbą zespoloną). Jeśli oba argumenty są " +"liczbami rzeczywistymi, zwracana jest liczba zespolona ze składnikiem " +"rzeczywistym *real* i składnikiem urojonym *imag*. Jeśli oba argumenty są " +"liczbami zespolonymi, zwracana jest liczba zespolona ze składnikiem " +"rzeczywistym ``real.real-imag.imag`` i składnikiem urojonym " +"``real.imag+imag.real``. Jeśli jeden z argumentów jest liczbą rzeczywistą, w " +"powyższych wyrażeniach używany jest tylko jego składnik rzeczywisty." + +msgid "If all arguments are omitted, returns ``0j``." +msgstr "Jeśli wszystkie argumenty zostaną pominięte, zwraca ``0j`` ." + +msgid "The complex type is described in :ref:`typesnumeric`." +msgstr "Typ Complex został opisany na stronie :ref:`typesnumeric`." + +msgid "Grouping digits with underscores as in code literals is allowed." +msgstr "" +"Dozwolone jest grupowanie cyfr za pomocą podkreślników, tak jak w literałach " +"kodu." + +msgid "" +"Falls back to :meth:`~object.__index__` if :meth:`~object.__complex__` " +"and :meth:`~object.__float__` are not defined." +msgstr "" +"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__complex__` " +"i :meth:`~object.__float__` nie są zdefiniowane." + +msgid "" +"This is a relative of :func:`setattr`. The arguments are an object and a " +"string. The string must be the name of one of the object's attributes. The " +"function deletes the named attribute, provided the object allows it. For " +"example, ``delattr(x, 'foobar')`` is equivalent to ``del x.foobar``. *name* " +"need not be a Python identifier (see :func:`setattr`)." +msgstr "" +"Jest to krewny :func:`setattr`. Argumenty są obiektem i napisem. Napis musi " +"być nazwą jednego z atrybut obiektu. Funkcja usuwa nazwany atrybut, pod " +"warunkiem, że obiekt na to pozwala. Na przykład, ``delattr(x, 'foobar')`` " +"jest równoważne ``del x.foobar``. *name* nie musi być identyfikatorem Python " +"(zobacz :func:`setattr`)." + +msgid "" +"Create a new dictionary. The :class:`dict` object is the dictionary class. " +"See also :ref:`typesmapping` for documentation about this class." +msgstr "" +"Tworzy nowy słownik. Obiekt :class:`dict` jest klasą wbudowaną. Zobacz " +"też :ref:`typesmapping` po więcej dokumentacji na temat tej klasy." + +msgid "" +"For other containers see the built-in :class:`list`, :class:`set`, " +"and :class:`tuple` classes, as well as the :mod:`collections` module." +msgstr "" +"Inne kontenery można znaleźć w klasach " +"wbudowanych :class:`list` , :class:`set` i :class:`tuple`, a także " +"moduł :mod:`collections` ." + +msgid "" +"Without arguments, return the list of names in the current local scope. " +"With an argument, attempt to return a list of valid attributes for that " +"object." +msgstr "" +"Bez argumentów, zwraca listę nazw w bieżącym zakresie lokalnym. Z " +"argumentem, próbuje zwrócić listę prawidłowych atrybutów dla tego obiektu." + +msgid "" +"If the object has a method named :meth:`~object.__dir__`, this method will " +"be called and must return the list of attributes. This allows objects that " +"implement a custom :func:`~object.__getattr__` " +"or :func:`~object.__getattribute__` function to customize the " +"way :func:`dir` reports their attributes." +msgstr "" +"Jeśli obiekt posiada metodę o nazwie :meth:`~object.__dir__`, metoda ta " +"zostanie wywołana i musi zwracać listę atrybut. Pozwala to obiektom, które " +"implementują niestandardowe :func:`~object.__getattr__` " +"lub :func:`~object.__getattribute__` funkcje na dostosowanie sposobu, w " +"jaki :func:`dir` zgłasza ich atrybuty." + +msgid "" +"If the object does not provide :meth:`~object.__dir__`, the function tries " +"its best to gather information from the object's :attr:`~object.__dict__` " +"attribute, if defined, and from its type object. The resulting list is not " +"necessarily complete and may be inaccurate when the object has a " +"custom :func:`~object.__getattr__`." +msgstr "" +"Jeśli obiekt nie udostępnia :meth:`~object.__dir__`, funkcja stara się " +"zebrać informacje z :attr:`~object.__dict__` atrybut obiektu, jeśli jest " +"zdefiniowany, oraz z jego obiektu typu. Wynikowa lista niekoniecznie jest " +"kompletna i może być niedokładna, jeśli obiekt ma " +"niestandardowy :func:`~object.__getattr__`." + +msgid "" +"The default :func:`dir` mechanism behaves differently with different types " +"of objects, as it attempts to produce the most relevant, rather than " +"complete, information:" +msgstr "" +"Mechanizm domyślny :func:`dir` zachowuje się inaczej w przypadku różnych " +"typów obiektów, ponieważ stara się uzyskać najbardziej istotne, a nie " +"kompletne informacje:" + +msgid "" +"If the object is a module object, the list contains the names of the " +"module's attributes." +msgstr "" +"Jeśli obiekt jest obiektem moduł, lista zawiera nazwy obiektów moduł " +"atrybutow." + +msgid "" +"If the object is a type or class object, the list contains the names of its " +"attributes, and recursively of the attributes of its bases." +msgstr "" +"Jeśli obiekt jest obiektem typu lub klasy, lista zawiera nazwy jego atrybut " +"i rekurencyjnie atrybut jego baz." + +msgid "" +"Otherwise, the list contains the object's attributes' names, the names of " +"its class's attributes, and recursively of the attributes of its class's " +"base classes." +msgstr "" +"W przeciwnym razie lista zawiera nazwy atrybut' obiektow, nazwy atrybut jego " +"klasy i rekurencyjnie atrybut klas bazowych jego klasy." + +msgid "The resulting list is sorted alphabetically. For example:" +msgstr "Wynikowa lista jest posortowana alfabetycznie. Na przykład:" + +msgid "" +"Because :func:`dir` is supplied primarily as a convenience for use at an " +"interactive prompt, it tries to supply an interesting set of names more than " +"it tries to supply a rigorously or consistently defined set of names, and " +"its detailed behavior may change across releases. For example, metaclass " +"attributes are not in the result list when the argument is a class." +msgstr "" +"Ponieważ :func:`dir` jest dostarczany głównie jako udogodnienie do użycia w " +"interaktywnym wierszu polecenia, stara się dostarczyć interesujący zestaw " +"nazw bardziej niż rygorystycznie lub konsekwentnie zdefiniowany zestaw nazw, " +"a jego szczegółowy zachowanie może się zmieniać w różnych wydaniach. Na " +"przykład, atrybut metaklasy nie znajduje się na liście wyników, gdy argument " +"jest klasą." + +msgid "" +"Take two (non-complex) numbers as arguments and return a pair of numbers " +"consisting of their quotient and remainder when using integer division. " +"With mixed operand types, the rules for binary arithmetic operators apply. " +"For integers, the result is the same as ``(a // b, a % b)``. For floating-" +"point numbers the result is ``(q, a % b)``, where *q* is usually " +"``math.floor(a / b)`` but may be 1 less than that. In any case ``q * b + a " +"% b`` is very close to *a*, if ``a % b`` is non-zero it has the same sign as " +"*b*, and ``0 <= abs(a % b) < abs(b)``." +msgstr "" +"Weź dwie (niezłożone) liczby jako argumenty i zwraca parę liczb składającą " +"się z ich ilorazu i reszty, gdy używasz liczba całkowita dzielenia. W " +"przypadku mieszanych typów operandów obowiązują reguły dla binarnych " +"operatorów arytmetycznych. Dla liczb całkowitych wynik jest taki sam jak " +"``(a // b, a % b)``. Dla liczb zmiennoprzecinkowych wynikiem jest ``(q, a % " +"b)``, gdzie *q* jest zwykle ``math.floor(a / b)``, ale może być o 1 " +"mniejsze. W każdym przypadku ``q * b + a % b`` jest bardzo zbliżone do *a*, " +"jeśli ``a % b`` jest niezerowe, to ma taki sam znak jak *b* i ``0 <= abs(a % " +"b) < abs(b)``." + +msgid "" +"Return an enumerate object. *iterable* must be a sequence, " +"an :term:`iterator`, or some other object which supports iteration. " +"The :meth:`~iterator.__next__` method of the iterator returned " +"by :func:`enumerate` returns a tuple containing a count (from *start* which " +"defaults to 0) and the values obtained from iterating over *iterable*." +msgstr "" +"Zwraca obiekt wyliczeniowy. *iterable* musi być sekwencją, :term:`iteratorem " +"` lub innym obiektem obsługującym iterację. " +"Metoda :meth:`~iterator.__next__` iteratora zwróconego " +"przez :func:`enumerate` zwraca dwukrotkę zawierającą licznik (od *start*, " +"który domyślnie wynosi 0) i wartości uzyskane z iteracji na argumencie " +"*iterable*." + +msgid "Equivalent to::" +msgstr "Odpowiednik::" + +msgid "" +"def enumerate(iterable, start=0):\n" +" n = start\n" +" for elem in iterable:\n" +" yield n, elem\n" +" n += 1" +msgstr "" +"def enumerate(iterable, start=0):\n" +" n = start\n" +" for elem in iterable:\n" +" yield n, elem\n" +" n += 1" + +msgid "Parameters" +msgstr "parametry" + +msgid "A Python expression." +msgstr "Expresja Python." + +msgid "The global namespace (default: ``None``)." +msgstr "Globalna przestrzeń nazw (domyślny: ``None``)." + +msgid "The local namespace (default: ``None``)." +msgstr "Lokalna przestrzeń nazw (domyślny: ``None``)." + +msgid "Returns" +msgstr "Zwraca" + +msgid "The result of the evaluated expression." +msgstr "Wynik obliczonej ekspresji." + +msgid "raises" +msgstr "rzuca" + +msgid "Syntax errors are reported as exceptions." +msgstr "Błędy składni są zgłaszane jako wyjątki." + +msgid "" +"This function executes arbitrary code. Calling it with untrusted user-" +"supplied input will lead to security vulnerabilities." +msgstr "" +"Ta funkcja wykonuje dowolny kod. Wywołanie go z niezaufanymi danymi " +"wejściowymi dostarczonymi przez użytkownika prowadzi do luk w " +"zabezpieczeniach." + +msgid "" +"The *source* argument is parsed and evaluated as a Python expression " +"(technically speaking, an :ref:`expression list `) using the " +"*globals* and *locals* mappings as global and local namespace. If the " +"*globals* dictionary is present and does not contain a value for the key " +"``__builtins__``, a reference to the dictionary of the built-in " +"module :mod:`builtins` is inserted under that key before *source* is parsed. " +"Overriding ``__builtins__`` can be used to restrict or change the available " +"names, but this is **not** a security mechanism: the executed code can still " +"access all builtins. If the *locals* mapping is omitted it defaults to the " +"*globals* dictionary. If both mappings are omitted, the source is executed " +"with the *globals* and *locals* in the environment where :func:`eval` is " +"called. Note, *eval()* will only have access to the :term:`nested scopes " +"` (non-locals) in the enclosing environment if they are " +"already referenced in the scope that is calling :func:`eval` (e.g. via " +"a :keyword:`nonlocal` statement)." +msgstr "" +"Argument *source* jest analizowany i ewaluowany jako wyrażenie Python " +"(technicznie rzecz biorąc, :ref:`expression list `) przy użyciu " +"mapowań *globals* i *locals* jako globalnej i lokalnej przestrzeni nazw. " +"Jeśli słownik *globals* jest obecny i nie zawiera wartości dla klucza " +"``__builtins__``, odwołanie do słownika wbudowanego modułu :mod:`builtins` " +"jest wstawiane pod tym kluczem, zanim *source* zostanie przeanalizowane. " +"Nadpisywanie ``__builtins__`` może służyć do ograniczenia lub zmiany " +"dostępnych nazw, ale **nie** jest to mechanizm zabezpieczający: wykonywany " +"kod nadal ma dostęp do wszystkich wbudowanych funkcji. Jeśli mapowanie " +"*locals* zostanie pominięte, domyślnie będzie to słownik *globals*. Jeśli " +"oba mapowania są pominięte, wyrażenie jest wykonywane z *globals* i *locals* " +"w środowisku, w którym wywoływany jest :func:`eval`. Uwaga, *eval()* będzie " +"miał dostęp do :term:`zagnieżdżonych zakresów ` (non-locals) w " +"otaczającym środowisku tylko wtedy, gdy są one już przywoływane w zakresie, " +"który wywołuje :func:`eval` (np. poprzez instrukcję :keyword:`nonlocal`)." + +msgid "Example:" +msgstr "Przykład:" + +msgid "" +"This function can also be used to execute arbitrary code objects (such as " +"those created by :func:`compile`). In this case, pass a code object instead " +"of a string. If the code object has been compiled with ``'exec'`` as the " +"*mode* argument, :func:`eval`\\'s return value will be ``None``." +msgstr "" +"Ta funkcja może być również używana do wykonywania dowolnych obiektów kodu " +"(takich jak te utworzone przez :func:`compile`). W tym przypadku należy " +"przekazać obiekt kodu zamiast napisu. Jeśli obiekt kodu został skompilowany " +"z ``'exec'`` jako *mode* argument, :func:`eval` wartością zwracana będzie " +"``None``." + +msgid "" +"Hints: dynamic execution of statements is supported by the :func:`exec` " +"function. The :func:`globals` and :func:`locals` functions return the " +"current global and local dictionary, respectively, which may be useful to " +"pass around for use by :func:`eval` or :func:`exec`." +msgstr "" +"Wskazówki: dynamiczne wykonywanie instrukcji jest obsługiwane " +"przez :func:`exec` funkcja . Adresy :func:`globals` i :func:`locals` " +"funkcje zwracaja określaaą odpowiednio bieżący globalny i lokalny adres " +"słownika, który może być przydatny do przekazania do użycia przez " +"adresy :func:`eval` lub :func:`exec`." + +msgid "" +"If the given source is a string, then leading and trailing spaces and tabs " +"are stripped." +msgstr "" +"Jeśli podane źródło to napis, początkowe i końcowe spacje i tabulatory są " +"usuwane." + +msgid "" +"See :func:`ast.literal_eval` for a function to evaluate strings with " +"expressions containing only literals." +msgstr "" +"Zobacz :func:`ast.literal_eval` dla funkcja do oceny napisów z wyrażeniami " +"zawierającymi tylko literały." + +msgid "" +"Raises an :ref:`auditing event ` ``exec`` with the code object as " +"the argument. Code compilation events may also be raised." +msgstr "" +"Rzuci zdarzenie :ref:`auditing event ` ``exec`` z obiektem kodu " +"jako argument. Zdarzenia kompilacji kodu mogą być również rzucone." + +msgid "The *globals* and *locals* arguments can now be passed as keywords." +msgstr "" +"Funkcje *globals* i *locals* argumenty mogą być teraz przekazywane jako " +"słowa kluczowe." + +msgid "" +"The semantics of the default *locals* namespace have been adjusted as " +"described for the :func:`locals` builtin." +msgstr "" +"Semantyka przestrzeni nazw domyślnych *locals* została dostosowana zgodnie z " +"opisem dla wbudowanej :func:`locals` ." + +msgid "" +"This function supports dynamic execution of Python code. *source* must be " +"either a string or a code object. If it is a string, the string is parsed " +"as a suite of Python statements which is then executed (unless a syntax " +"error occurs). [#]_ If it is a code object, it is simply executed. In all " +"cases, the code that's executed is expected to be valid as file input (see " +"the section :ref:`file-input` in the Reference Manual). Be aware that " +"the :keyword:`nonlocal`, :keyword:`yield`, and :keyword:`return` statements " +"may not be used outside of function definitions even within the context of " +"code passed to the :func:`exec` function. The return value is ``None``." +msgstr "" +"Ta funkcja obsługuje dynamiczne wykonywanie kodu Python. *source* musi być " +"albo napis albo obiektem kodu. Jeśli jest to napis, napis jest analizowany " +"jako zestaw instrukcji Pythona, które sa następnie wykonywany (chyba że " +"wystąpi błąd składni). [#]_ Jeśli jest to obiekt kodu, jest on po prostu " +"wykonywany. We wszystkich przypadkach wykonywany kod powinien być " +"prawidłowy jako plik wejściowy (patrz sekcja :ref:`file-input` w Podręczniku " +"referencyjnym). Należy pamiętać, że " +"wartości :keyword:`nonlocal`, :keyword:`yield` i :keyword:`return` " +"instrukcije nie mogą być używane poza definicjami funkcji, nawet w " +"kontekście kodu przekazywanego do :func:`exec` . Wartość zwracana to " +"``None``." + +msgid "" +"In all cases, if the optional parts are omitted, the code is executed in the " +"current scope. If only *globals* is provided, it must be a dictionary (and " +"not a subclass of dictionary), which will be used for both the global and " +"the local variables. If *globals* and *locals* are given, they are used for " +"the global and local variables, respectively. If provided, *locals* can be " +"any mapping object. Remember that at the module level, globals and locals " +"are the same dictionary." +msgstr "" +"We wszystkich przypadkach, jeśli części opcjonalne są pominięte, kod jest " +"wykonywany w bieżącym zakresie. Jeśli podano tylko *globals*, musi to być " +"słownik (a nie podklasa z słownikem), który będzie używany zarówno dla " +"zmiennych globalnych, jak i lokalnych. Jeśli podano *globals* i *locals*, " +"są one używane odpowiednio dla zmiennych globalnych i lokalnych. Jeśli " +"podano *locals*, może to być dowolny obiekt mapowania. Należy pamiętać, że " +"na poziomie moduł, globals i locals są tym samym słownikem." + +msgid "" +"When ``exec`` gets two separate objects as *globals* and *locals*, the code " +"will be executed as if it were embedded in a class definition. This means " +"functions and classes defined in the executed code will not be able to " +"access variables assigned at the top level (as the \"top level\" variables " +"are treated as class variables in a class definition)." +msgstr "" +"Gdy ``exec`` pobiera dwa oddzielne obiekty jako *globals* i *locals*, kod " +"zostanie wykonany tak, jakby był osadzony w definicja klasy. Oznacza to, że " +"funkcja i klasy zdefiniowane w wykonywanym kodzie nie będą mogły uzyskać " +"dostępu do zmiennych przypisanych na najwyższym poziomie (ponieważ zmienne " +"\"najwyższego poziomu\" są traktowane jako zmienne klasowe w definicja " +"klasy)." + +msgid "" +"If the *globals* dictionary does not contain a value for the key " +"``__builtins__``, a reference to the dictionary of the built-in " +"module :mod:`builtins` is inserted under that key. Overriding " +"``__builtins__`` can be used to restrict or change the available names, but " +"this is **not** a security mechanism: the executed code can still access all " +"builtins." +msgstr "" +"Jeśli słownik *globals* nie zawiera wartości dla klucza ``__builtins__``, " +"odwołanie do słownika z wbudowanego modułu :mod:`builtins` jest wstawiane " +"pod tym kluczem. Nadpisywanie ``__builtins__`` może służyć do ograniczenia " +"lub zmiany dostępnych nazw, ale **nie** jest to mechanizm zabezpieczający: " +"wykonywany kod nadal ma dostęp do wszystkich wbudowanych funkcji." + +msgid "" +"The *closure* argument specifies a closure--a tuple of cellvars. It's only " +"valid when the *object* is a code object containing :term:`free (closure) " +"variables `. The length of the tuple must exactly match " +"the length of the code object's :attr:`~codeobject.co_freevars` attribute." +msgstr "" +"Wyrażenie *closure* określa zamknięcie - krotka zmiennych komórkowych. Jest " +"ważne tylko wtedy, gdy *obiekt* jest obiektem kodu zawierającym :term:`wolne " +"(zamknięcie) zmienne `. Długość krotka musi dokładnie " +"odpowiadać długości :attr:`~codeobject.co_freevars` atrybutem obiektu kodu." + +msgid "" +"The built-in functions :func:`globals` and :func:`locals` return the current " +"global and local namespace, respectively, which may be useful to pass around " +"for use as the second and third argument to :func:`exec`." +msgstr "" +"Adresy wbudowane funkcji :func:`globals` i :func:`locals` zwraca to " +"odpowiednio bieżąca globalna i lokalna przestrzeń nazw, które mogą być " +"przydatne do przekazania jako drugi i trzeci argument do :func:`exec`." + +msgid "" +"The default *locals* act as described for function :func:`locals` below. " +"Pass an explicit *locals* dictionary if you need to see effects of the code " +"on *locals* after function :func:`exec` returns." +msgstr "" +"Elementy domyślne *locals* działają w sposób opisany dla " +"funkcji :func:`locals` poniżej. Przekaż jawne *locals* słownik jeśli chcesz " +"zobaczyć efekty kodu na *locals* po funkcji :func:`exec` ." + +msgid "Added the *closure* parameter." +msgstr "Dodano parametr *zamknięcie*." + +msgid "" +"Construct an iterator from those elements of *iterable* for which *function* " +"is true. *iterable* may be either a sequence, a container which supports " +"iteration, or an iterator. If *function* is ``None``, the identity function " +"is assumed, that is, all elements of *iterable* that are false are removed." +msgstr "" +"Konstruuje iterator z tych elementów *iterable*, dla których *funkcja* jest " +"prawdą. *iterable* może być sekwencją, kontenerem obsługującym iterację lub " +"iterator. Jeśli *funkcja* jest ``None``, zakłada się tożsamość funkcji, to " +"znaczy wszystkie elementy *iterable*, które są fałszywe, są usuwane." + +msgid "" +"Note that ``filter(function, iterable)`` is equivalent to the generator " +"expression ``(item for item in iterable if function(item))`` if function is " +"not ``None`` and ``(item for item in iterable if item)`` if function is " +"``None``." +msgstr "" +"Należy zauważyć, że ``filter(function, iterable)`` jest równoważne wyrażeniu " +"generator ``(item for item in iterable if function(item))`` jeśli funkcja " +"nie jest ``None`` i ``(item for item in iterable if item)`` jeśli funkcja " +"jest ``None``." + +msgid "" +"See :func:`itertools.filterfalse` for the complementary function that " +"returns elements of *iterable* for which *function* is false." +msgstr "" +"Zobacz :func:`itertools.filterfalse` dla komplementarnych funkci ktore " +"zwracaja elementy *iterable* dla których *funkcja* jest fałszywe." + +msgid "Return a floating-point number constructed from a number or a string." +msgstr "Zwraca liczba zmiennoprzecinkowa zbudowana z liczby lub napisu." + +msgid "" +">>> float('+1.23')\n" +"1.23\n" +">>> float(' -12345\\n')\n" +"-12345.0\n" +">>> float('1e-003')\n" +"0.001\n" +">>> float('+1E6')\n" +"1000000.0\n" +">>> float('-Infinity')\n" +"-inf" +msgstr "" +">>> float('+1.23')\n" +"1.23\n" +">>> float(' -12345\\n')\n" +"-12345.0\n" +">>> float('1e-003')\n" +"0.001\n" +">>> float('+1E6')\n" +"1000000.0\n" +">>> float('-Infinity')\n" +"-inf" + +msgid "" +"If the argument is a string, it should contain a decimal number, optionally " +"preceded by a sign, and optionally embedded in whitespace. The optional " +"sign may be ``'+'`` or ``'-'``; a ``'+'`` sign has no effect on the value " +"produced. The argument may also be a string representing a NaN (not-a-" +"number), or positive or negative infinity. More precisely, the input must " +"conform to the :token:`~float:floatvalue` production rule in the following " +"grammar, after leading and trailing whitespace characters are removed:" +msgstr "" +"Jeśli argument jest napisem, powinien zawierać liczbę dziesiętną, " +"opcjonalnie poprzedzoną znakiem i opcjonalnie osadzoną w białych znakach. " +"Znak opcjonalny może być ``'+'`` lub ``'-'``; znak ``'+'`` nie ma wpływu na " +"otrzymaną wartość. argument może być również napisem reprezentującym NaN " +"(not-a-number) lub dodatnią lub ujemną nieskończoność. Dokładniej, dane " +"wejściowe muszą być zgodne z regułą produkcji :token:`~float:floatvalue` w " +"poniższej gramatyce, po usunięciu początkowych i końcowych białych znaków " +"znak:" + +msgid "" +"Case is not significant, so, for example, \"inf\", \"Inf\", \"INFINITY\", " +"and \"iNfINity\" are all acceptable spellings for positive infinity." +msgstr "" +"Wielkość liter nie ma znaczenia, więc na przykład \"inf\", \"Inf\", " +"\"INFINITY\" i \"iNfINity\" są akceptowalnymi pisowniami dla dodatniej " +"nieskończoności." + +msgid "" +"Otherwise, if the argument is an integer or a floating-point number, a " +"floating-point number with the same value (within Python's floating-point " +"precision) is returned. If the argument is outside the range of a Python " +"float, an :exc:`OverflowError` will be raised." +msgstr "" +"W przeciwnym razie, jeśli argument jest liczba całkowita lub liczbą " +"zmiennoprzecinkową, zwracana jest liczba zmiennoprzecinkowa o tej samej " +"wartości (w zakresie precyzji zmiennoprzecinkowej Python). Rzuci jeśli " +"argument jest poza zakresem liczby zmiennoprzecinkowej Python, zwrócona " +"zostanie :exc:`OverflowError`." + +msgid "" +"For a general Python object ``x``, ``float(x)`` delegates to " +"``x.__float__()``. If :meth:`~object.__float__` is not defined then it " +"falls back to :meth:`~object.__index__`." +msgstr "" +"W przypadku ogólnego obiektu Python ``x`` , ``float(x)`` deleguje do " +"``x.__float__()``. Jeśli :meth:`~object.__float__` nie jest zdefiniowana, to " +"spada z powrotem do :meth:`~object.__index__`." + +msgid "If no argument is given, ``0.0`` is returned." +msgstr "Jeśli nie podano argumentu, zwracane jest ``0.0``." + +msgid "The float type is described in :ref:`typesnumeric`." +msgstr "Typ float został opisany na stronie :ref:`typesnumeric`." + +msgid "" +"Falls back to :meth:`~object.__index__` if :meth:`~object.__float__` is not " +"defined." +msgstr "" +"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__float__` nie " +"jest zdefiniowane." + +msgid "" +"Convert a *value* to a \"formatted\" representation, as controlled by " +"*format_spec*. The interpretation of *format_spec* will depend on the type " +"of the *value* argument; however, there is a standard formatting syntax that " +"is used by most built-in types: :ref:`formatspec`." +msgstr "" +"Konwertuje *value* na \"formatted\" reprezentację, kontrolowaną przez " +"*format_spec*. Interpretacja *format_spec* będzie zależeć od typu *value* " +"argument; jednak istnieje standardowa składnia formatowania, która jest " +"używana przez większość typów wbudowanych: :ref:`formatspec`." + +msgid "" +"The default *format_spec* is an empty string which usually gives the same " +"effect as calling :func:`str(value) `." +msgstr "" +"Parametr domyślny *format_spec* jest pustym napisem, co zwykle daje taki sam " +"efekt jak wywołanie :func:`str(value) `." + +msgid "" +"A call to ``format(value, format_spec)`` is translated to " +"``type(value).__format__(value, format_spec)`` which bypasses the instance " +"dictionary when searching for the value's :meth:`~object.__format__` method. " +"A :exc:`TypeError` exception is raised if the method search " +"reaches :mod:`object` and the *format_spec* is non-empty, or if either the " +"*format_spec* or the return value are not strings." +msgstr "" +"Wywołanie ``format(value, format_spec)`` jest tłumaczone na " +"``type(value).__format__(value, format_spec)``, które omija instancję " +"słownika podczas wyszukiwania metody :meth:`~object.__format__` wartości . " +"Wyjątek :exc:`TypeError` jest rzucony, jeśli wyszukiwanie metody " +"osiągnie :mod:`object` i *format_spec* jest niepusty, lub jeśli " +"*format_spec* lub wartość zwracana nie są napisem." + +msgid "" +"``object().__format__(format_spec)`` raises :exc:`TypeError` if " +"*format_spec* is not an empty string." +msgstr "" +"``object().__format__(format_spec)`` rzuci :exc:`TypeError` jeśli " +"*format_spec* nie jest pustym napisem." + +msgid "" +"Return a new :class:`frozenset` object, optionally with elements taken from " +"*iterable*. :class:`frozenset` is a built-in class. See also :ref:`types-" +"set` for documentation about this class." +msgstr "" +"Zwraca nowy obiekt :class:`frozenset`, opcjonalnie z elementami z " +"*iterable*. :class:`frozenset` jest klasą wbudowaną. Zobacz też dokumentację " +"dotycząca tej klasy w :ref:`types-set`." + +msgid "" +"For other containers see the built-" +"in :class:`set`, :class:`list`, :class:`tuple`, and :class:`dict` classes, " +"as well as the :mod:`collections` module." +msgstr "" +"Dla innych kontenerów zobacz klasy " +"wbudowane :class:`set` , :class:`list`, :class:`tuple` i :class:`dict`, jak " +"również moduł :mod:`collections` ." + +msgid "" +"Return the value of the named attribute of *object*. *name* must be a " +"string. If the string is the name of one of the object's attributes, the " +"result is the value of that attribute. For example, ``getattr(x, " +"'foobar')`` is equivalent to ``x.foobar``. If the named attribute does not " +"exist, *default* is returned if provided, otherwise :exc:`AttributeError` is " +"raised. *name* need not be a Python identifier (see :func:`setattr`)." +msgstr "" +"Zwraca wartość nazwanego atrybut obiektu *object*. *name* musi być napisem. " +"Jeśli napis jest nazwą jednego z atrybut obiektu, wynikiem jest wartość tego " +"atrybutu. Na przykład, ``getattr(x, 'foobar')`` jest równoważne " +"``x.foobar``. Jeśli nazwany atrybut nie istnieje, *default* jest zwracany, " +"jeśli został podany, w przeciwnym razie :exc:`AttributeError` jest rzucony. " +"*name* nie musi być identyfikatorem Pythona (Zobacz :func:`setattr`)." + +msgid "" +"Since :ref:`private name mangling ` happens at " +"compilation time, one must manually mangle a private attribute's (attributes " +"with two leading underscores) name in order to retrieve it " +"with :func:`getattr`." +msgstr "" +"Ponieważ :ref:`manipulowanie nazwami prywatnymi ` " +"odbywa się w czasie kompilacji, należy ręcznie zmanipulować nazwę prywatną " +"atrybutu (atrybuty z dwoma wiodącymi podkreśleniami), aby pobrać ją za " +"pomocą :func:`getattr`." + +msgid "" +"Return the dictionary implementing the current module namespace. For code " +"within functions, this is set when the function is defined and remains the " +"same regardless of where the function is called." +msgstr "" +"Zwraca słownik implementującą bieżącą przestrzeń nazw moduł. W przypadku " +"kodu w funkcja, jest on ustawiany, gdy funkcja jest zdefiniowana i pozostaje " +"taki sam niezależnie od tego, gdzie wywoływana jest funkcja." + +msgid "" +"The arguments are an object and a string. The result is ``True`` if the " +"string is the name of one of the object's attributes, ``False`` if not. " +"(This is implemented by calling ``getattr(object, name)`` and seeing whether " +"it raises an :exc:`AttributeError` or not.)" +msgstr "" +"Argumenty to obiekt i napis. Wynikiem jest ``True`` jeśli napis jest nazwą " +"jednego z obiektów atrybut, ``False`` jeśli nie. (Jest to zaimplementowane " +"poprzez wywołanie ``getattr(object, name)`` i sprawdzenie, czy rzucone " +"jest :exc:`AttributeError` )." + +msgid "" +"Return the hash value of the object (if it has one). Hash values are " +"integers. They are used to quickly compare dictionary keys during a " +"dictionary lookup. Numeric values that compare equal have the same hash " +"value (even if they are of different types, as is the case for 1 and 1.0)." +msgstr "" +"Zwraca wartość skrótu obiektu (jeśli taki posiada). Wartości skrótu są " +"liczbami całkowitymi. Są one używane do szybkiego porównywania kluczy " +"słownika podczas wyszukiwania słownika. Wartości numeryczne, które są " +"równe, mają tę samą wartość skrótu (nawet jeśli są różnych typów, jak w " +"przypadku 1 i 1.0)." + +msgid "" +"For objects with custom :meth:`~object.__hash__` methods, note " +"that :func:`hash` truncates the return value based on the bit width of the " +"host machine." +msgstr "" +"W przypadku obiektów z niestandardowymi metodami :meth:`~object.__hash__` " +"należy pamiętać, że :func:`hash` obcina wartość zwracaną w oparciu o " +"szerokość bitową maszyny hosta." + +msgid "" +"Invoke the built-in help system. (This function is intended for interactive " +"use.) If no argument is given, the interactive help system starts on the " +"interpreter console. If the argument is a string, then the string is looked " +"up as the name of a module, function, class, method, keyword, or " +"documentation topic, and a help page is printed on the console. If the " +"argument is any other kind of object, a help page on the object is generated." +msgstr "" +"Wywołuje system pomocy wbudowany. (Ta funkcja jest przeznaczona do użytku " +"interaktywnego.) Jeśli nie podano argumentu, interaktywny system pomocy " +"uruchamia się na konsoli interpretera. Jeśli argument jest napisem, to " +"napis jest wyszukiwany jako nazwa modułu, funkcja, klasa, metoda, słowo " +"kluczowe lub temat dokumentacji, a strona pomocy jest drukowana na konsoli. " +"Jeśli argument jest jakimkolwiek innym rodzajem obiektu, generowana jest " +"strona pomocy dotycząca tego obiektu." + +msgid "" +"Note that if a slash(/) appears in the parameter list of a function when " +"invoking :func:`help`, it means that the parameters prior to the slash are " +"positional-only. For more info, see :ref:`the FAQ entry on positional-only " +"parameters `." +msgstr "" +"Zauważ, że jeśli ukośnik (/) pojawia się na liście parametrów w funkcji " +"podczas wywoływania :func:`help`, oznacza to, że parametry przed ukośnikiem " +"są tylko-pozycyjne. Aby uzyskać więcej informacji, zobacz :ref:`wpis FAQ na " +"temat parametrów tylko-pozycyjnych ` ." + +msgid "" +"This function is added to the built-in namespace by the :mod:`site` module." +msgstr "" +"Ta funkcja jest dodawana do przestrzeni nazw wbudowanych przez " +"moduł :mod:`site` ." + +msgid "" +"Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures " +"for callables are now more comprehensive and consistent." +msgstr "" +"Zmiany do :mod:`pydoc` i :mod:`inspect` oznaczają, że zgłoszone sygnatury " +"dla callables są teraz bardziej kompleksowe i spójne." + +msgid "" +"Convert an integer number to a lowercase hexadecimal string prefixed with " +"\"0x\". If *integer* is not a Python :class:`int` object, it has to define " +"an :meth:`~object.__index__` method that returns an integer. Some examples:" +msgstr "" +"Konwertuje liczbę całkowitą na zapis szesnastkowy małymi literami " +"poprzedzony „0x”. Jeśli *integer* nie jest pythonowym " +"obiektem :class:`int` , musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbę całkowitą. Kilka przykładów:" + +msgid "" +"If you want to convert an integer number to an uppercase or lower " +"hexadecimal string with prefix or not, you can use either of the following " +"ways:" +msgstr "" +"Jeśli chcesz przekonwertować liczbe całkowita na wielką lub małą liczbę " +"szesnastkową napis z prefiksem lub bez, możesz użyć jednego z poniższych " +"sposobów:" + +msgid "" +"See also :func:`int` for converting a hexadecimal string to an integer using " +"a base of 16." +msgstr "" +"Zobacz także :func:`int`, aby przekonwertować szesnastkowy napis na liczba " +"całkowita przy użyciu podstawy 16." + +msgid "" +"To obtain a hexadecimal string representation for a float, use " +"the :meth:`float.hex` method." +msgstr "" +"Aby uzyskać napis szesnastkowej reprezentacj dla zmiennoprzecinkowej, należy " +"użyć metody :meth:`float.hex`." + +msgid "" +"Return the \"identity\" of an object. This is an integer which is " +"guaranteed to be unique and constant for this object during its lifetime. " +"Two objects with non-overlapping lifetimes may have the same :func:`id` " +"value." +msgstr "" +"Zwraca \"tożsamość\" obiektu. Jest to liczba całkowita, która jest " +"gwarantowana jako unikalny i stały dla tego obiektu przez cały okres jego " +"życia. Dwa obiekty o nienakładających się okresach życia mogą mieć tę samą " +"wartość :func:`id`." + +msgid "This is the address of the object in memory." +msgstr "Jest to adres obiektu w pamięci." + +msgid "" +"Raises an :ref:`auditing event ` ``builtins.id`` with argument " +"``id``." +msgstr "" +"Rzuci :ref:`auditing event ` ``builtins.id`` bez argumentu " +"``id`` ." + +msgid "" +"If the *prompt* argument is present, it is written to standard output " +"without a trailing newline. The function then reads a line from input, " +"converts it to a string (stripping a trailing newline), and returns that. " +"When EOF is read, :exc:`EOFError` is raised. Example::" +msgstr "" +"Jeśli *prompt* argument jest obecny, jest on zapisywany na standardowe " +"wyjście bez końcowej nowej linii. Następnie funkcja odczytuje linię z " +"wejścia, konwertuje ją na napis (usuwając końcową nową linię) i zwraca. Po " +"odczytaniu EOF, :exc:`EOFError` jest rzucone. Przykład::" + +msgid "" +">>> s = input('--> ')\n" +"--> Monty Python's Flying Circus\n" +">>> s\n" +"\"Monty Python's Flying Circus\"" +msgstr "" +">>> s = input('--> ')\n" +"--> Monty Python's Flying Circus\n" +">>> s\n" +"\"Monty Python's Flying Circus\"" + +msgid "" +"If the :mod:`readline` module was loaded, then :func:`input` will use it to " +"provide elaborate line editing and history features." +msgstr "" +"Jeśli załadowano moduł :mod:`readline` , to :func:`input` użyje go do " +"zapewnienia rozbudowanych funkcji edycji wierszy i historii." + +msgid "" +"Raises an :ref:`auditing event ` ``builtins.input`` with argument " +"``prompt`` before reading input" +msgstr "" +"Rzuca :ref:`auditing event ` ``builtins.input`` z argumentem " +"``prompt`` przed odczytaniem wpisu" + +msgid "" +"Raises an :ref:`auditing event ` ``builtins.input/result`` with " +"the result after successfully reading input." +msgstr "" +"Rzuca zdarzenie :ref:`auditing ` ``builtins.input/result`` z " +"wynikiem po pomyślnym odczytaniu danych wejściowych." + +msgid "" +"Return an integer object constructed from a number or a string, or return " +"``0`` if no arguments are given." +msgstr "" +"Zwraca obiekt liczba całkowita zbudowana z liczby lub napisu, lub zwraca " +"``0`` jeśli nie podano argumentu." + +msgid "" +">>> int(123.45)\n" +"123\n" +">>> int('123')\n" +"123\n" +">>> int(' -12_345\\n')\n" +"-12345\n" +">>> int('FACE', 16)\n" +"64206\n" +">>> int('0xface', 0)\n" +"64206\n" +">>> int('01110011', base=2)\n" +"115" +msgstr "" +">>> int(123.45)\n" +"123\n" +">>> int('123')\n" +"123\n" +">>> int(' -12_345\\n')\n" +"-12345\n" +">>> int('FACE', 16)\n" +"64206\n" +">>> int('0xface', 0)\n" +"64206\n" +">>> int('01110011', base=2)\n" +"115" + +msgid "" +"If the argument defines :meth:`~object.__int__`, ``int(x)`` returns " +"``x.__int__()``. If the argument defines :meth:`~object.__index__`, it " +"returns ``x.__index__()``. If the argument " +"defines :meth:`~object.__trunc__`, it returns ``x.__trunc__()``. For " +"floating-point numbers, this truncates towards zero." +msgstr "" +"Jeśli argument definiuje :meth:`~object.__int__`, ``int(x)`` zwraca " +"``x.__int__()`` . Jeśli argument definiuje :meth:`~object.__index__`, to " +"zwraca ``x.__index__()`` . Jeśli argument " +"definiuje :meth:`~object.__trunc__`, to zwraca ``x.__trunc__()`` . W " +"przypadku liczb zmiennoprzecinkowych jest ona obcinana w kierunku zera." + +msgid "" +"If the argument is not a number or if *base* is given, then it must be a " +"string, :class:`bytes`, or :class:`bytearray` instance representing an " +"integer in radix *base*. Optionally, the string can be preceded by ``+`` or " +"``-`` (with no space in between), have leading zeros, be surrounded by " +"whitespace, and have single underscores interspersed between digits." +msgstr "" +"Jeśli argument nie jest liczbą lub jeśli podano *base*, musi to być " +"instancja napisu, :class:`bytes` lub :class:`bytearray` reprezentująca " +"liczba całkowita w radix *base*. Opcjonalnie, napis może być poprzedzony " +"przez ``+`` lub ``-`` (bez spacji pomiędzy nimi), mieć początkowe zera, być " +"otoczone białymi znakami i mieć pojedyncze podkreślenia pomiędzy cyframi." + +msgid "" +"A base-n integer string contains digits, each representing a value from 0 to " +"n-1. The values 0--9 can be represented by any Unicode decimal digit. The " +"values 10--35 can be represented by ``a`` to ``z`` (or ``A`` to ``Z``). The " +"default *base* is 10. The allowed bases are 0 and 2--36. Base-2, -8, and -16 " +"strings can be optionally prefixed with ``0b``/``0B``, ``0o``/``0O``, or " +"``0x``/``0X``, as with integer literals in code. For base 0, the string is " +"interpreted in a similar way to an :ref:`integer literal in code " +"`, in that the actual base is 2, 8, 10, or 16 as determined by the " +"prefix. Base 0 also disallows leading zeros: ``int('010', 0)`` is not legal, " +"while ``int('010')`` and ``int('010', 8)`` are." +msgstr "" +"Baza-n liczba całkowita napis zawiera cyfry, z których każda reprezentuje " +"wartość od 0 do n-1. Wartości 0--9 mogą być reprezentowane przez dowolną " +"cyfrę dziesiętną Unicode. Wartości 10-35 mogą być reprezentowane przez ``a`` " +"do ``z`` (lub ``A`` do ``Z``). Domyślna baza jest 10. Dozwolone wartości " +"bazowe to 0 i 2--36. Podstawy 2, -8 i -16 napis mogą być opcjonalnie " +"poprzedzone przedrostkiem ``0b``/``0B``, ``0o``/``0O``, lub ``0x``/``0X``, " +"tak jak w przypadku literałów liczba całkowita w kodzie. Dla podstawy 0, " +"napis jest interpretowane w podobny sposób jak :ref:`liczba całkowita w " +"kodzie `, w którym rzeczywista podstawa wynosi 2, 8, 10 lub 16, " +"zgodnie z przedrostkiem. Podstawa 0 również nie zezwala na zera wiodące: " +"``int('010', 0)`` nie jest legalne, podczas gdy ``int('010')`` i " +"``int('010', 8)`` są." + +msgid "The integer type is described in :ref:`typesnumeric`." +msgstr "Typ liczba całkowita (integer) został opisany w :ref:`typesnumeric`." + +msgid "" +"If *base* is not an instance of :class:`int` and the *base* object has " +"a :meth:`base.__index__ ` method, that method is called to " +"obtain an integer for the base. Previous versions used :meth:`base.__int__ " +"` instead of :meth:`base.__index__ `." +msgstr "" +"Jeśli *base* nie jest instancją :class:`int` i obiekt *base* posiada " +"metodę :meth:`base.__index__ `, metoda ta jest wywoływana " +"w celu uzyskania liczba całkowitych dla bazy. Poprzednie wersje " +"używały :meth:`base.__int__ ` zamiast :meth:`base.__index__ " +"`." + +msgid "The first parameter is now positional-only." +msgstr "Pierwszy parametr jest teraz tylko pozycyjny." + +msgid "" +"Falls back to :meth:`~object.__index__` if :meth:`~object.__int__` is not " +"defined." +msgstr "" +"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__int__` nie jest " +"zdefiniowane." + +msgid "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 " +"avoid denial of service attacks. A :exc:`ValueError` is raised when the " +"limit is exceeded while converting a string to an :class:`int` or when " +"converting an :class:`int` into a string would exceed the limit. See " +"the :ref:`integer string conversion length limitation ` " +"documentation." +msgstr "" +":class:`int` napis wejścia i reprezentacje napisa mogą być ograniczone, aby " +"pomóc uniknąć ataków typu \"odmowa usługi\". :exc:`ValueError` jest rzucone, " +"gdy limit zostanie przekroczony podczas konwersji napisa na :class:`int` lub " +"gdy konwersja :class:`int` na napis przekroczy limit. Zobacz " +"dokumentację :ref:`liczba całkowita napis ograniczenia długości konwersji " +"`." + +msgid "" +"Return ``True`` if the *object* argument is an instance of the *classinfo* " +"argument, or of a (direct, indirect, or :term:`virtual `) subclass thereof. If *object* is not an object of the given type, " +"the function always returns ``False``. If *classinfo* is a tuple of type " +"objects (or recursively, other such tuples) or a :ref:`types-union` of " +"multiple types, return ``True`` if *object* is an instance of any of the " +"types. If *classinfo* is not a type or tuple of types and such tuples, " +"a :exc:`TypeError` exception is raised. :exc:`TypeError` may not be raised " +"for an invalid type if an earlier check succeeds." +msgstr "" +"Zwraca ``True`` jeśli argument *object* jest instancją argumentu " +"*classinfo*, lub jego (bezpośrednią, pośrednią lub :term:`wirtualną " +"`) podklasą. Jeśli *object* nie jest obiektem " +"danego typu, funkcja zawsze zwraca ``False``. Jeśli *classinfo* jest krotką " +"obiektów typu (lub rekurencyjnie, innych takich krotek) lub :ref:`types-" +"union` wielu typów, zwraca ``True`` jeśli *obiekt* jest instancją " +"któregokolwiek z typów. Jeśli *classinfo* nie jest typem lub krotką typów i " +"takich krotek, rzucany jest wyjątek :exc:`TypeError`. :exc:`TypeError` może " +"nie być rzucony dla nieprawidłowego typu, jeśli wcześniejsze sprawdzenie " +"powiedzie się." + +msgid "*classinfo* can be a :ref:`types-union`." +msgstr "*classinfo* może być :ref:`types-union`." + +msgid "" +"Return ``True`` if *class* is a subclass (direct, indirect, " +"or :term:`virtual `) of *classinfo*. A class is " +"considered a subclass of itself. *classinfo* may be a tuple of class objects " +"(or recursively, other such tuples) or a :ref:`types-union`, in which case " +"return ``True`` if *class* is a subclass of any entry in *classinfo*. In " +"any other case, a :exc:`TypeError` exception is raised." +msgstr "" +"Zwraca ``True`` jeśli *class* jest podklasą (bezpośrednią, pośrednią " +"lub :term:`wirtualną `) *classinfo*. Klasa jest " +"uważana za podklasę samej siebie. *classinfo* może być krotką obiektów klasy " +"(lub rekurencyjnie, innych takich krotek) lub :ref:`types-union`, w którym " +"to przypadku zwraca ``True`` jeśli *class* jest podklasą dowolnego wpisu w " +"*classinfo*. W każdym innym przypadku rzucany jest wyjątek :exc:`TypeError`." + +msgid "" +"Return an :term:`iterator` object. The first argument is interpreted very " +"differently depending on the presence of the second argument. Without a " +"second argument, the single argument must be a collection object which " +"supports the :term:`iterable` protocol (the :meth:`~object.__iter__` " +"method), or it must support the sequence protocol " +"(the :meth:`~object.__getitem__` method with integer arguments starting at " +"``0``). If it does not support either of those protocols, :exc:`TypeError` " +"is raised. If the second argument, *sentinel*, is given, then the first " +"argument must be a callable object. The iterator created in this case will " +"call *callable* with no arguments for each call to " +"its :meth:`~iterator.__next__` method; if the value returned is equal to " +"*sentinel*, :exc:`StopIteration` will be raised, otherwise the value will be " +"returned." +msgstr "" +"Zwraca obiekt :term:`iteratora `. Pierwszy argument jest " +"interpretowany bardzo różnie w zależności od obecności drugiego argumentu. " +"Bez drugiego argumentu, jedyny argument musi być obiektem kolekcji, która " +"obsługuje protokół :term:`iterable` (metoda :meth:`~object.__iter__` ), lub " +"musi obsługiwać protokół sekwencji (metoda :meth:`~object.__getitem__` z " +"argumentami liczb całkowitych zaczynających się od ``0``). Jeśli nie " +"obsługuje żadnego z tych protokołów, zostanie rzucony :exc:`TypeError`. " +"Jeśli podano drugi argument, *sentinel*, to pierwszy argument musi być " +"obiektem wywoływalnym. Utworzony w tym przypadku iterator będzie wywoływał " +"*callable* bez argumentu dla każdego wywołania jego " +"metody :meth:`~iterator.__next__`; jeśli zwrócona wartość jest równa " +"*sentinel*, zostanie rzucone :exc:`StopIteration`, w przeciwnym razie " +"zostanie zwrócona wartość." + +msgid "See also :ref:`typeiter`." +msgstr "Zobacz także :ref:`typeiter`." + +msgid "" +"One useful application of the second form of :func:`iter` is to build a " +"block-reader. For example, reading fixed-width blocks from a binary database " +"file until the end of file is reached::" +msgstr "" +"Jednym z przydatnych aplikacji drugiej formy :func:`iter` jest zbudowanie " +"blok czytnika. Na przykład, odczytywanie stałej szerokości bloku z binarnego " +"pliku bazy danych aż do osiągnięcia końca pliku::" + +msgid "" +"from functools import partial\n" +"with open('mydata.db', 'rb') as f:\n" +" for block in iter(partial(f.read, 64), b''):\n" +" process_block(block)" +msgstr "" +"from functools import partial\n" +"with open('mojedane.db', 'rb') as f:\n" +" for block in iter(partial(f.read, 64), b''):\n" +" process_block(block)" + +msgid "" +"Return the length (the number of items) of an object. The argument may be a " +"sequence (such as a string, bytes, tuple, list, or range) or a collection " +"(such as a dictionary, set, or frozen set)." +msgstr "" +"Zwraca długość (liczba elementów) obiektu. Obiekt argument może być " +"sekwencją (taką jak napis, bajty, krotka, lista lub zakres) lub kolekcją " +"(taką jak słownik, zbiór lub zbiór zamrożony)." + +msgid "" +"``len`` raises :exc:`OverflowError` on lengths larger " +"than :data:`sys.maxsize`, such as :class:`range(2 ** 100) `." +msgstr "" +"``len`` rzuca :exc:`OverflowError` dla długości większych " +"niż :data:`sys.maxsize`, takich jak :class:`range(2 ** 100) `." + +msgid "" +"Rather than being a function, :class:`list` is actually a mutable sequence " +"type, as documented in :ref:`typesseq-list` and :ref:`typesseq`." +msgstr "" +"Zamiast być funkcją, :class:`list` jest w rzeczywistości typem mutowalnej " +"(zmiennej) sekwencji, jak udokumentowano w :ref:`typesseq-list` " +"i :ref:`typesseq`." + +msgid "" +"Return a mapping object representing the current local symbol table, with " +"variable names as the keys, and their currently bound references as the " +"values." +msgstr "" +"Zwraca obiekt mapowania reprezentujący bieżącą lokalną tablicę symboli, z " +"nazwami zmiennych jako kluczami i ich aktualnie powiązanymi referencjami " +"jako wartościami." + +msgid "" +"At module scope, as well as when using :func:`exec` or :func:`eval` with a " +"single namespace, this function returns the same namespace " +"as :func:`globals`." +msgstr "" +"W zakresie moduł, a także podczas korzystania z :func:`exec` " +"lub :func:`eval` z pojedynczą przestrzenią nazw, ta funkcja zwraca ta sama " +"przestrzeń nazw co :func:`globals`." + +msgid "" +"At class scope, it returns the namespace that will be passed to the " +"metaclass constructor." +msgstr "" +"W zakresie klasy, zwraca przestrzeń nazw, która zostanie przekazana do " +"konstruktora metaklasy." + +msgid "" +"When using ``exec()`` or ``eval()`` with separate local and global " +"arguments, it returns the local namespace passed in to the function call." +msgstr "" +"W przypadku korzystania z ``exec()`` lub ``eval()`` z oddzielnymi lokalnymi " +"i globalnymi argumentami, zwraca lokalną przestrzeń nazw przekazaną do " +"wywołania funkcji." + +msgid "" +"In all of the above cases, each call to ``locals()`` in a given frame of " +"execution will return the *same* mapping object. Changes made through the " +"mapping object returned from ``locals()`` will be visible as assigned, " +"reassigned, or deleted local variables, and assigning, reassigning, or " +"deleting local variables will immediately affect the contents of the " +"returned mapping object." +msgstr "" +"We wszystkich powyższych przypadkach każde wywołanie ``locals()`` w danej " +"ramce wykonania spowoduje zwracanie *tego samego* obiektu mapowania. Zmiany " +"dokonane za pośrednictwem obiektu mapowania zwróconego z ``locals()`` będą " +"widoczne jako przypisane, ponownie przypisane lub usunięte zmienne lokalne, " +"a przypisanie, ponowne przypisanie lub usunięcie zmiennych lokalnych " +"natychmiast wpłynie na zawartość zwróconego obiektu mapowania." + +msgid "" +"In an :term:`optimized scope` (including functions, generators, and " +"coroutines), each call to ``locals()`` instead returns a fresh dictionary " +"containing the current bindings of the function's local variables and any " +"nonlocal cell references. In this case, name binding changes made via the " +"returned dict are *not* written back to the corresponding local variables or " +"nonlocal cell references, and assigning, reassigning, or deleting local " +"variables and nonlocal cell references does *not* affect the contents of " +"previously returned dictionaries." +msgstr "" +"W :term:`optimized scope` (włączając w to funkcja, generatory i coroutines), " +"każde wywołanie ``locals()`` zamiast zwracania świeżego słownika zawierający " +"aktualne wiązania zmiennych lokalnych funkcji i wszelkie nielokalne " +"odwołania do komórek. W tym przypadku zmiany powiązań nazw dokonane za " +"pośrednictwem zwróconego dict *nie* są zapisywane z powrotem do odpowiednich " +"zmiennych lokalnych lub nielokalnych odwołań do komórek, a przypisywanie, " +"ponowne przypisywanie lub usuwanie zmiennych lokalnych i nielokalnych " +"odwołań do komórek *nie* wpływa na zawartość wcześniej zwróconego słownika." + +msgid "" +"Calling ``locals()`` as part of a comprehension in a function, generator, or " +"coroutine is equivalent to calling it in the containing scope, except that " +"the comprehension's initialised iteration variables will be included. In " +"other scopes, it behaves as if the comprehension were running as a nested " +"function." +msgstr "" +"Wywołanie ``locals()`` jako części rozumienia w funkcji, generator lub " +"coroutine jest równoważne wywołaniu go w zakresie zawierającym, z wyjątkiem " +"tego, że zainicjowane zmienne iteracyjne rozumienia zostaną uwzględnione. W " +"innych zakresach zachowuje się tak, jakby rozumienie działało jako " +"zagnieżdżone funkcja." + +msgid "" +"Calling ``locals()`` as part of a generator expression is equivalent to " +"calling it in a nested generator function." +msgstr "" +"Wywołanie ``locals()`` jako części wyrażenia generator jest równoważne " +"wywołaniu go w zagnieżdżonym generatorze funkcji ." + +msgid "" +"The behaviour of ``locals()`` in a comprehension has been updated as " +"described in :pep:`709`." +msgstr "" +"Zachowanie ``locals()`` w zrozumieniu została zaktualizowana zgodnie z " +"opisem w :pep:`709`." + +msgid "" +"As part of :pep:`667`, the semantics of mutating the mapping objects " +"returned from this function are now defined. The behavior " +"in :term:`optimized scopes ` is now as described above. " +"Aside from being defined, the behaviour in other scopes remains unchanged " +"from previous versions." +msgstr "" +"Jako część :pep:`667`, semantyka mutowania obiektów mapowania zwróconych z " +"tej funkcji jest teraz zdefiniowana. Zachowanie w :term:`zoptymalizowanych " +"zakresach ` jest teraz opisane powyżej. Poza " +"zdefiniowaniem, zachowanie w innych zakresach pozostaje niezmienione w " +"stosunku do poprzednich wersji." + +msgid "" +"Return an iterator that applies *function* to every item of *iterable*, " +"yielding the results. If additional *iterables* arguments are passed, " +"*function* must take that many arguments and is applied to the items from " +"all iterables in parallel. With multiple iterables, the iterator stops when " +"the shortest iterable is 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'u lub największy z dwóch lub więcej " +"argumentów." + +msgid "" +"If one positional argument is provided, it should be an :term:`iterable`. " +"The largest item in the iterable is returned. If two or more positional " +"arguments are provided, the largest of the positional arguments is returned." +msgstr "" +"Jeśli podano jeden pozycyjny argument, powinien to być :term:`iterable`. " +"Zwracany jest największy element w iterable. Jeśli podano dwa lub więcej " +"argumenty pozycyjne, zwracany jest największy z argumentów pozycyjnych." + +msgid "" +"There are two optional keyword-only arguments. The *key* argument specifies " +"a one-argument ordering function like that used for :meth:`list.sort`. The " +"*default* argument specifies an object to return if the provided iterable is " +"empty. If the iterable is empty and *default* is not provided, " +"a :exc:`ValueError` is raised." +msgstr "" +"Istnieją dwa opcjonalne tylko ze słowem kluczowym argument. *Kluczowy* " +"argument określa jedno-argumentowy uporządkowanie funkcji jak to używane " +"dla :meth:`list.sort`. *Domyślny* argument określa obiekt do zwracania, " +"jeśli podany iterable jest pusty. Jeśli iterable jest pusty i *domyślny* nie " +"jest podany, :exc:`ValueError` jest rzucony." + +msgid "" +"If multiple items are maximal, the function returns the first one " +"encountered. This is consistent with other sort-stability preserving tools " +"such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and " +"``heapq.nlargest(1, iterable, key=keyfunc)``." +msgstr "" +"Jeśli wiele elementów jest maksymalnych, funkcja zwraca pierwszy napotkany " +"element. Jest to zgodne z innymi narzędziami zachowującymi stabilność " +"sortowania, takimi jak ``sorted(iterable, key=keyfunc, reverse=True)[0]`` i " +"``heapq.nlargest(1, iterable, key=keyfunc)``." + +msgid "Added the *default* keyword-only parameter." +msgstr "Dodano *default* tylko słowo kluczowe parametr." + +msgid "The *key* can be ``None``." +msgstr "*Kluczem* może być ``None``." + +msgid "" +"Return a \"memory view\" object created from the given argument. " +"See :ref:`typememoryview` for more information." +msgstr "" +"Zwraca obiekt \"memory view\" utworzony z podanego argumentu. Więcej " +"informacji można znaleźć na stronie :ref:`typememoryview`." + +msgid "" +"Return the smallest item in an iterable or the smallest of two or more " +"arguments." +msgstr "" +"Zwraca najmniejszy element w iterable'u lub najmniejszy z dwóch lub więcej " +"argumentów." + +msgid "" +"If one positional argument is provided, it should be an :term:`iterable`. " +"The smallest item in the iterable is returned. If two or more positional " +"arguments are provided, the smallest of the positional arguments is returned." +msgstr "" +"Jeśli podano jeden pozycjny argument, powinien to być :term:`iterable`. " +"Zwracany jest najmniejszy element w iterable. Jeśli podano dwa lub więcej " +"argumenty pozycyjne, zwracany jest najmniejszy z argumentów pozycyjnych." + +msgid "" +"If multiple items are minimal, the function returns the first one " +"encountered. This is consistent with other sort-stability preserving tools " +"such as ``sorted(iterable, key=keyfunc)[0]`` and ``heapq.nsmallest(1, " +"iterable, key=keyfunc)``." +msgstr "" +"Jeśli wiele elementów jest minimalnych, funkcja zwraca pierwszy napotkany. " +"Jest to zgodne z innymi narzędziami zachowującymi stabilność sortowania, " +"takimi jak ``sorted(iterable, key=keyfunc)[0]`` i ``heapq.nsmallest(1, " +"iterable, key=keyfunc)``." + +msgid "" +"Retrieve the next item from the :term:`iterator` by calling " +"its :meth:`~iterator.__next__` method. If *default* is given, it is " +"returned if the iterator is exhausted, otherwise :exc:`StopIteration` is " +"raised." +msgstr "" +"Pobiera następny element z :term:`iterator` poprzez wywołanie jego " +"metody :meth:`~iterator.__next__`. Jeśli *domyślny* jest podany, jest " +"zwracany, jeśli iterator jest wyczerpany, w przeciwnym " +"razie :exc:`StopIteration` jest rzucony." + +msgid "" +"This is the ultimate base class of all other classes. It has methods that " +"are common to all instances of Python classes. When the constructor is " +"called, it returns a new featureless object. The constructor does not accept " +"any arguments." +msgstr "" +"Jest to ostateczna klasa bazowa wszystkich innych klas. Posiada metody, " +"które są wspólne dla wszystkich instancji klas Pythona. Kiedy konstruktor " +"jest wywoływany, zwraca nowy obiekt bez funkcji. Konstruktor nie akceptuje " +"żadnych argumentów." + +msgid "" +":class:`object` instances do *not* have :attr:`~object.__dict__` attributes, " +"so you can't assign arbitrary attributes to an instance of :class:`object`." +msgstr "" +":class:`object` instancje *nie* mają :attr:`~object.__dict__` atrybut , więc " +"nie można przypisać dowolnego atrybuta do instancji :class:`object`." + +msgid "" +"Convert an integer number to an octal string prefixed with \"0o\". The " +"result is a valid Python expression. If *integer* is not a " +"Python :class:`int` object, it has to define an :meth:`~object.__index__` " +"method that returns an integer. For example:" +msgstr "" +"Konwertuje liczbę całkowitą na ósemkowy ciąg znaków z prefiksem \"0o\". " +"Wynik jest poprawnym wyrażeniem Pythona. Jeśli *integer* nie jest pythonowym " +"obiektem :class:`int`, musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbę całkowitą. Na przykład:" + +msgid "" +"If you want to convert an integer number to an octal string either with the " +"prefix \"0o\" or not, you can use either of the following ways." +msgstr "" +"Jeśli chcesz przekonwertować liczbę całkowita na ósemkowy napis z " +"przedrostkiem \"0o\" lub bez, możesz użyć jednego z poniższych sposobów." + +msgid "" +"Open *file* and return a corresponding :term:`file object`. If the file " +"cannot be opened, an :exc:`OSError` is raised. See :ref:`tut-files` for more " +"examples of how to use this function." +msgstr "" +"Otwiera *file* i zwraca odpowiedni :term:`obiekt pliku `. " +"Jeśli pliku nie da się otworzyć, rzucany jest :exc:`OSError`. Więcej " +"przykładów użycia tej funkcji można znaleźć w :ref:`tut-files`." + +msgid "" +"*file* is a :term:`path-like object` giving the pathname (absolute or " +"relative to the current working directory) of the file to be opened or an " +"integer file descriptor of the file to be wrapped. (If a file descriptor is " +"given, it is closed when the returned I/O object is closed unless *closefd* " +"is set to ``False``.)" +msgstr "" +"*file* jest :term:`obiektem path-like ` podającym nazwę " +"ścieżki (bezwzględną lub względną do bieżącego katalogu roboczego) pliku, " +"który ma zostać otwarty, lub liczbą całkowitą deskryptora pliku, który ma " +"zostać opakowany. (Jeśli podano deskryptor pliku, jest on zamykany, gdy " +"zwrócony obiekt I/O jest zamykany, chyba że *closefd* jest ustawione na " +"``False``.)" + +msgid "" +"*mode* is an optional string that specifies the mode in which the file is " +"opened. It defaults to ``'r'`` which means open for reading in text mode. " +"Other common values are ``'w'`` for writing (truncating the file if it " +"already exists), ``'x'`` for exclusive creation, and ``'a'`` for appending " +"(which on *some* Unix systems, means that *all* writes append to the end of " +"the file regardless of the current seek position). In text mode, if " +"*encoding* is not specified the encoding used is platform-" +"dependent: :func:`locale.getencoding` is called to get the current locale " +"encoding. (For reading and writing raw bytes use binary mode and leave " +"*encoding* unspecified.) The available modes are:" +msgstr "" +"*mode* to opcjonalny napis , który określa tryb, w którym plik jest " +"otwierany. Domyślnie jest to ``'r'``, co oznacza otwarcie do odczytu w " +"trybie tekstowym. Inne popularne wartości to ``'w'`` dla zapisu (obcinanie " +"pliku, jeśli już istnieje), ``'x'`` dla wyłącznego tworzenia i ``'a'`` dla " +"dołączania (co w *niektórych* systemach Unix oznacza, że *wszystkie* zapisy " +"są dołączane do końca pliku niezależnie od bieżącej pozycji wyszukiwania). " +"W trybie tekstowym, jeśli nie podano *encoding*, używane kodowanie jest " +"zależne od platformy: :func:`locale.getencoding` jest wywoływane w celu " +"uzyskania bieżącego kodowania locale. (Do odczytu i zapisu nieprzetworzonych " +"bajtów należy użyć trybu binarnego i pozostawić *encoding* nieokreślone). " +"Dostępne tryby to:" + +msgid "Character" +msgstr "Znak" + +msgid "Meaning" +msgstr "Znaczenie" + +msgid "``'r'``" +msgstr "``'r'``" + +msgid "open for reading (default)" +msgstr "otwarte do czytania (domyślny)" + +msgid "``'w'``" +msgstr "``'w'``" + +msgid "open for writing, truncating the file first" +msgstr "otworzyć do zapisu, najpierw obcinając plik" + +msgid "``'x'``" +msgstr "``'x'``" + +msgid "open for exclusive creation, failing if the file already exists" +msgstr "" +"otwarcie do wyłącznego utworzenia, niepowodzenie, jeśli plik już istnieje" + +msgid "``'a'``" +msgstr "``'a'``" + +msgid "open for writing, appending to the end of file if it exists" +msgstr "otwarte do zapisu, dołączenie do końca pliku, jeśli istnieje" + +msgid "``'b'``" +msgstr "``'b'``" + +msgid "binary mode" +msgstr "tryb binarny" + +msgid "``'t'``" +msgstr "``'t'``" + +msgid "text mode (default)" +msgstr "tryb tekstowy (domyślny)" + +msgid "``'+'``" +msgstr "``'+'``" + +msgid "open for updating (reading and writing)" +msgstr "otwarte na aktualizację (odczyt i zapis)" + +msgid "" +"The default mode is ``'r'`` (open for reading text, a synonym of ``'rt'``). " +"Modes ``'w+'`` and ``'w+b'`` open and truncate the file. Modes ``'r+'`` and " +"``'r+b'`` open the file with no truncation." +msgstr "" +"Tryb domyślny to ``'r'`` (otwarty do odczytu tekstu, synonim ``'rt'``). " +"Tryby ``'w+'`` i ``'w+b'`` otwierają i obcinają plik. Tryby ``'r+'`` i " +"``'r+b'`` otwierają plik bez obcinania." + +msgid "" +"As mentioned in the :ref:`io-overview`, Python distinguishes between binary " +"and text I/O. Files opened in binary mode (including ``'b'`` in the *mode* " +"argument) return contents as :class:`bytes` objects without any decoding. " +"In text mode (the default, or when ``'t'`` is included in the *mode* " +"argument), the contents of the file are returned as :class:`str`, the bytes " +"having been first decoded using a platform-dependent encoding or using the " +"specified *encoding* if given." +msgstr "" +"Jak wspomniano w :ref:`io-overview`, Python rozróżnia binarne i tekstowe I/" +"O. Pliki otwierane w trybie binarnym (w tym ``'b'`` w *mode* argument) " +"zwracają zawartość jako obiekty :class:`bytes` bez żadnego dekodowania. W " +"trybie tekstowym ( domyślny, lub gdy ``'t'`` jest zawarte w *mode* " +"argument), zawartość pliku jest zwracana jako :class:`str`, bajty zostały " +"najpierw zdekodowane przy użyciu kodowania zależnego od platformy lub przy " +"użyciu określonego *kodowania*, jeśli zostało podane." + +msgid "" +"Python doesn't depend on the underlying operating system's notion of text " +"files; all the processing is done by Python itself, and is therefore " +"platform-independent." +msgstr "" +"Python nie zależy od pojęcia plików tekstowych w systemie operacyjnym; całe " +"przetwarzanie jest wykonywane przez Pythoan i dlatego jest niezależne od " +"platformy." + +msgid "" +"*buffering* is an optional integer used to set the buffering policy. Pass 0 " +"to switch buffering off (only allowed in binary mode), 1 to select line " +"buffering (only usable when writing in text mode), and an integer > 1 to " +"indicate the size in bytes of a fixed-size chunk buffer. Note that " +"specifying a buffer size this way applies for binary buffered I/O, but " +"``TextIOWrapper`` (i.e., files opened with ``mode='r+'``) would have another " +"buffering. To disable buffering in ``TextIOWrapper``, consider using the " +"``write_through`` flag for :func:`io.TextIOWrapper.reconfigure`. When no " +"*buffering* argument is given, the default buffering policy works as follows:" +msgstr "" +"*buffering* to opcjonalna liczba całkowita używana do ustawiania polityki " +"buforowania. Przekaż 0, aby wyłączyć buforowanie (dozwolone tylko w trybie " +"binarnym), 1, aby wybrać buforowanie liniowe (używane tylko podczas pisania " +"w trybie tekstowym) i liczba całkowita > 1, aby wskazać rozmiar w bajtach " +"bufora o stałym rozmiarze. Należy zauważyć, że określenie rozmiaru bufora w " +"ten sposób dotyczy binarnie buforowanego wejścia/wyjścia, ale " +"``TextIOWrapper`` (tj. pliki otwierane za pomocą ``mode='r+'``) będą miały " +"inne buforowanie. Aby wyłączyć buforowanie w ``TextIOWrapper``, należy " +"rozważyć użycie flagi ``write_through`` " +"dla :func:`io.TextIOWrapper.reconfigure`. Gdy nie podano *buforowania* " +"argument, polityka buforowania domyślny działa w następujący sposób:" + +msgid "" +"Binary files are buffered in fixed-size chunks; the size of the buffer is " +"chosen using a heuristic trying to determine the underlying device's \"block " +"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. " +"This should only be used in text mode. The default encoding is platform " +"dependent (whatever :func:`locale.getencoding` returns), but any :term:`text " +"encoding` supported by Python can be used. See the :mod:`codecs` module for " +"the list of supported encodings." +msgstr "" +"*encoding* to nazwa kodowania używanego do dekodowania lub kodowania pliku. " +"Powinno być używane tylko w trybie tekstowym. Kodowanie domyślne jest " +"zależne od platformy (cokolwiek :func:`locale.getencoding` zwraca ), ale " +"można użyć dowolnego :term:`kodowanie tekstu` obsługiwanego przez Python. " +"Lista obsługiwanych kodowań znajduje się na stronie :mod:`codecs` modułu ." + +msgid "" +"*errors* is an optional string that specifies how encoding and decoding " +"errors are to be handled—this cannot be used in binary mode. A variety of " +"standard error handlers are available (listed under :ref:`error-handlers`), " +"though any error handling name that has been registered " +"with :func:`codecs.register_error` is also valid. The standard names " +"include:" +msgstr "" +"*errors* to opcjonalny napis, który określa sposób obsługi błędów kodowania " +"i dekodowania - nie może być używany w trybie binarnym. Dostępnych jest " +"wiele standardowych programów obsługi błędów (wymienionych w :ref:`error-" +"handlers`), choć każda nazwa obsługi błędów zarejestrowana " +"w :func:`codecs.register_error` jest również ważna. Standardowe nazwy " +"obejmują:" + +msgid "" +"``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding " +"error. The default value of ``None`` has the same effect." +msgstr "" +"``'strict'`` do rzucenja wyjątek :exc:`ValueError`, jeśli wystąpi błąd " +"kodowania. Wartość domyślna z ``None`` ma ten sam efekt." + +msgid "" +"``'ignore'`` ignores errors. Note that ignoring encoding errors can lead to " +"data loss." +msgstr "" +"``'ignore'`` ignoruje błędy. Należy pamiętać, że ignorowanie błędów " +"kodowania może prowadzić do utraty danych." + +msgid "" +"``'replace'`` causes a replacement marker (such as ``'?'``) to be inserted " +"where there is malformed data." +msgstr "" +"``'replace'`` powoduje wstawienie znacznika zastępczego (takiego jak " +"``'?'``) tam, gdzie występują zniekształcone dane." + +msgid "" +"``'surrogateescape'`` will represent any incorrect bytes as low surrogate " +"code units ranging from U+DC80 to U+DCFF. These surrogate code units will " +"then be turned back into the same bytes when the ``surrogateescape`` error " +"handler is used when writing data. This is useful for processing files in " +"an unknown encoding." +msgstr "" +"``'surrogateescape'`` będzie reprezentować wszelkie nieprawidłowe bajty jako " +"niskie jednostki kodu zastępczego w zakresie od U+DC80 do U+DCFF. Te " +"jednostki kodu zastępczego zostaną następnie przekształcone z powrotem w te " +"same bajty, gdy podczas zapisu danych zostanie użyta obsługa błędów " +"``surrogateescape``. Jest to przydatne do przetwarzania plików w nieznanym " +"kodowaniu." + +msgid "" +"``'xmlcharrefreplace'`` is only supported when writing to a file. Characters " +"not supported by the encoding are replaced with the appropriate XML " +"character reference :samp:`&#{nnn};`." +msgstr "" +"``'xmlcharrefreplace'`` jest obsługiwany tylko podczas zapisu do pliku. Znak " +"nieobsługiwany przez kodowanie jest zastępowany odpowiednim odniesieniem XML " +"znak :samp:`&#{nnn};` ." + +msgid "" +"``'backslashreplace'`` replaces malformed data by Python's backslashed " +"escape sequences." +msgstr "" +"``'backslashreplace'`` zastępuje zniekształcone dane przez sekwencje " +"specjalne Python'z ukośnikiem wstecznym." + +msgid "" +"``'namereplace'`` (also only supported when writing) replaces unsupported " +"characters with ``\\N{...}`` escape sequences." +msgstr "" +"``'namereplace'`` (również obsługiwane tylko podczas zapisu) zastępuje " +"nieobsługiwane znak sekwencjami ucieczki ``\\N{...}``." + +msgid "" +"*newline* determines how to parse newline characters from the stream. It can " +"be ``None``, ``''``, ``'\\n'``, ``'\\r'``, and ``'\\r\\n'``. It works as " +"follows:" +msgstr "" +"*newline* określa sposób analizowania nowej linii znak ze strumienia. Może " +"to być ``None``, ``''``, ``'\\n'``, ``'\\r'`` i ``'\\r\\n'``. Działa to w " +"następujący sposób:" + +msgid "" +"When reading input from the stream, if *newline* is ``None``, universal " +"newlines mode is enabled. Lines in the input can end in ``'\\n'``, " +"``'\\r'``, or ``'\\r\\n'``, and these are translated into ``'\\n'`` before " +"being returned to the caller. If it is ``''``, universal newlines mode is " +"enabled, but line endings are returned to the caller untranslated. If it " +"has any of the other legal values, input lines are only terminated by the " +"given string, and the line ending is returned to the caller untranslated." +msgstr "" +"Podczas odczytu danych wejściowych ze strumienia, jeśli *newline* to " +"``None``, włączony jest uniwersalny tryb nowych linii. Linie na wejściu " +"mogą kończyć się na ``'\\n'``, ``'\\r'``, lub ``'\\r\\n'``, które są " +"tłumaczone na ``'\\n'`` przed zwróceniem do wywołującego. Jeśli jest to " +"``''``, włączony jest uniwersalny tryb nowych linii, ale zakończenia linii " +"są zwracane do wywołującego bez tłumaczenia. Jeśli ma dowolną z pozostałych " +"legalnych wartości, linie wejściowe są kończone tylko przez podany napis, a " +"zakończenie linii jest zwracane bez tłumaczenia." + +msgid "" +"When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` " +"characters written are translated to the system default line " +"separator, :data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no " +"translation takes place. If *newline* is any of the other legal values, any " +"``'\\n'`` characters written are translated to the given string." +msgstr "" +"Podczas zapisywania danych wyjściowych do strumienia, jeśli *newline* ma " +"wartość ``None``, wszelkie zapisane ``'\\n'`` znaki są tłumaczone na " +"systemowy domyślny separator linii, :data:`os.linesep`. Jeśli *newline* ma " +"wartość ``''`` lub ``'\\n'``, tłumaczenie nie jest wykonywane. Jeśli " +"*newline* jest dowolną z pozostałych legalnych wartości, wszelkie zapisane " +"``'\\n'`` znaki są tłumaczone na podany napis." + +msgid "" +"If *closefd* is ``False`` and a file descriptor rather than a filename was " +"given, the underlying file descriptor will be kept open when the file is " +"closed. If a filename is given *closefd* must be ``True`` (the default); " +"otherwise, an error will be raised." +msgstr "" +"Jeśli *closefd* ma wartość ``False`` i podano deskryptor pliku, a nie nazwę " +"pliku, to bazowy deskryptor pliku pozostanie otwarty po zamknięciu pliku. " +"Jeśli podano nazwę pliku, *closefd* musi mieć wartość ``True`` ( domyślny); " +"w przeciwnym razie wystąpi błąd." + +msgid "" +"A custom opener can be used by passing a callable as *opener*. The " +"underlying file descriptor for the file object is then obtained by calling " +"*opener* with (*file*, *flags*). *opener* must return an open file " +"descriptor (passing :mod:`os.open` as *opener* results in functionality " +"similar to passing ``None``)." +msgstr "" +"Niestandardowy otwieracz może być użyty poprzez przekazanie wywołania jako " +"*opener*. Podstawowy deskryptor pliku dla obiektu pliku jest następnie " +"uzyskiwany przez wywołanie *opener* z (*file*, *flags*). *opener* musi " +"zwracać otwarty deskryptor pliku (przekazanie :mod:`os.open` jako *opener* " +"skutkuje funkcjonalnością podobną do przekazania ``None``)." + +msgid "The newly created file is :ref:`non-inheritable `." +msgstr "Nowo utworzony plik jest :ref:`non-inheritable `." + +msgid "" +"The following example uses the :ref:`dir_fd ` parameter of " +"the :func:`os.open` function to open a file relative to a given directory::" +msgstr "" +"Poniższy przykład używa :ref:`dir_fd ` parametr z :func:`os.open` " +"funkcji do otwarcia pliku względem danego katalogu::" + +msgid "" +">>> import os\n" +">>> dir_fd = os.open('somedir', os.O_RDONLY)\n" +">>> def opener(path, flags):\n" +"... return os.open(path, flags, dir_fd=dir_fd)\n" +"...\n" +">>> with open('spamspam.txt', 'w', opener=opener) as f:\n" +"... print('This will be written to somedir/spamspam.txt', file=f)\n" +"...\n" +">>> os.close(dir_fd) # don't leak a file descriptor" +msgstr "" +">>> import os\n" +">>> dir_fd = os.open('somedir', os.O_RDONLY)\n" +">>> def opener(path, flags):\n" +"... return os.open(path, flags, dir_fd=dir_fd)\n" +"...\n" +">>> with open('spamspam.txt', 'w', opener=opener) as f:\n" +"... print('To zostanie zapisane w somedir/spamspam.txt', file=f)\n" +"...\n" +">>> os.close(dir_fd) # nie ujawniaj deskryptora pliku" + +msgid "" +"The type of :term:`file object` returned by the :func:`open` function " +"depends on the mode. When :func:`open` is used to open a file in a text " +"mode (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass " +"of :class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When " +"used to open a file in a binary mode with buffering, the returned class is a " +"subclass of :class:`io.BufferedIOBase`. The exact class varies: in read " +"binary mode, it returns an :class:`io.BufferedReader`; in write binary and " +"append binary modes, it returns an :class:`io.BufferedWriter`, and in read/" +"write mode, it returns an :class:`io.BufferedRandom`. When buffering is " +"disabled, the raw stream, a subclass " +"of :class:`io.RawIOBase`, :class:`io.FileIO`, is returned." +msgstr "" +"Typ :term:`file object` zwracany przez :func:`open` zależy od trybu. " +"Gdy :func:`open` jest używany do otwarcia pliku w trybie tekstowym (``'w'``, " +"``'r'``, ``'wt'``, ``'rt'``, itd.), to zwracana jest podklasa " +"klasy :class:`io.TextIOBase` (w szczególności :class:`io.TextIOWrapper`). W " +"przypadku użycia do otwarcia pliku w trybie binarnym z buforowaniem, " +"zwracana klasą jest podklasa z :class:`io.BufferedIOBase`. Dokładna klasa " +"różni się: w trybie odczytu binarnego, jest to zwracane " +"z :class:`io.BufferedReader`; w trybach zapisu binarnego i dołączania " +"binarnego, jest to zwracane z :class:`io.BufferedWriter`, a w trybie odczytu/" +"zapisu, jest to zwracane z :class:`io.BufferedRandom`. Gdy buforowanie jest " +"wyłączone, zwracany jest nieprzetworzony strumień, podklasa " +"z :class:`io.RawIOBase`, :class:`io.FileIO`." + +msgid "" +"See also the file handling modules, such as :mod:`fileinput`, :mod:`io` " +"(where :func:`open` is " +"declared), :mod:`os`, :mod:`os.path`, :mod:`tempfile`, and :mod:`shutil`." +msgstr "" +"Zobacz także moduły obsługę plików, takich jak :mod:`fileinput`, :mod:`io` " +"(gdzie " +"zadeklarowano :func:`open` ), :mod:`os`, :mod:`os.path`, :mod:`tempfile` " +"i :mod:`shutil`." + +msgid "" +"Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " +"``mode``, ``flags``." +msgstr "" +"Rzuca :ref:`auditing event ` ``open`` z argumentami ``path`` , " +"``mode``, ``flags``." + +msgid "" +"The ``mode`` and ``flags`` arguments may have been modified or inferred from " +"the original call." +msgstr "" +"Adresy ``mode`` i ``flags`` argumenty mogły zostać zmodyfikowane lub " +"wywnioskowane z oryginalnego połączenia." + +msgid "The *opener* parameter was added." +msgstr "Dodano *opener* parametr." + +msgid "The ``'x'`` mode was added." +msgstr "Dodano tryb ``'x'``." + +msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." +msgstr ":exc:`IOError` kiedyś był rzucony, teraz jest alias z :exc:`OSError`." + +msgid "" +":exc:`FileExistsError` is now raised if the file opened in exclusive " +"creation mode (``'x'``) already exists." +msgstr "" +":exc:`FileExistsError` jest teraz rzucane, jeśli plik otwarty w trybie " +"wyłącznego tworzenia (``'x'``) już istnieje." + +msgid "The file is now non-inheritable." +msgstr "Plik nie jest teraz dziedziczony." + +msgid "" +"If the system call is interrupted and the signal handler does not raise an " +"exception, the function now retries the system call instead of raising " +"an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)." +msgstr "" +"Jeśli wywołanie systemowe zostanie przerwane, a program obsługi sygnału nie " +"rzuci wyjątku, funkcji ponawia teraz wywołanie systemowe zamiast rzucenja " +"wyjątku :exc:`InterruptedError` (zobacz :pep:`475` dla uzasadnienia)." + +msgid "The ``'namereplace'`` error handler was added." +msgstr "Dodano obsługę błędów ``'namereplace'``." + +msgid "Support added to accept objects implementing :class:`os.PathLike`." +msgstr "" +"Dodano obsługę akceptowania obiektów implementujących :class:`os.PathLike`." + +msgid "" +"On Windows, opening a console buffer may return a subclass " +"of :class:`io.RawIOBase` other than :class:`io.FileIO`." +msgstr "" +"W systemie Windows, otwarcie bufora konsoli może zwracać podklasa " +"z :class:`io.RawIOBase` innego niż :class:`io.FileIO`." + +msgid "The ``'U'`` mode has been removed." +msgstr "Tryb ``'U'`` został usunięty." + +msgid "Return the ordinal value of a character." +msgstr "Zwraca wartość porządkową znaku." + +msgid "" +"If the argument is a one-character string, return the Unicode code point of " +"that character. For example, ``ord('a')`` returns the integer ``97`` and " +"``ord('€')`` (Euro sign) returns ``8364``. This is the inverse " +"of :func:`chr`." +msgstr "" +"Jeśli argument jest jedno-znakowym ciągiem znaków, zwraca punkt kodowy " +"Unicode tego znaku. Na przykład, ``ord('a')`` zwraca liczbę całkowitą ``97`` " +"i ``ord('€')`` (znak euro) zwraca ``8364`` . Jest to odwrotność :func:`chr`." + +msgid "" +"If the argument is a :class:`bytes` or :class:`bytearray` object of length " +"1, return its single byte value. For example, ``ord(b'a')`` returns the " +"integer ``97``." +msgstr "" +"Jeśli argument jest obiektem :class:`bytes` lub :class:`bytearray` o " +"długości 1, zwraca wartość pojedynczego bajtu. Na przykład ``ord(b'a')`` " +"zwraca liczbę całkowitą ``97``." + +msgid "" +"Return *base* to the power *exp*; if *mod* is present, return *base* to the " +"power *exp*, modulo *mod* (computed more efficiently than ``pow(base, exp) % " +"mod``). The two-argument form ``pow(base, exp)`` is equivalent to using the " +"power operator: ``base**exp``." +msgstr "" +"Zwraca *base* do potęgi *exp*; jeśli *mod* jest obecny, zwraca *base* do " +"potęgi *exp*, modulo *mod* (obliczane bardziej efektywnie niż ``pow(base, " +"exp) % mod``). Forma dwóch argumentów ``pow(base, exp)`` jest równoważna " +"użyciu operatora potęgi: ``base**exp``." + +msgid "" +"When arguments are builtin numeric types with mixed operand types, the " +"coercion rules for binary arithmetic operators apply. For :class:`int` " +"operands, the result has the same type as the operands (after coercion) " +"unless the second argument is negative; in that case, all arguments are " +"converted to float and a float result is delivered. For example, ``pow(10, " +"2)`` returns ``100``, but ``pow(10, -2)`` returns ``0.01``. For a negative " +"base of type :class:`int` or :class:`float` and a non-integral exponent, a " +"complex result is delivered. For example, ``pow(-9, 0.5)`` returns a value " +"close to ``3j``. Whereas, for a negative base of type :class:`int` " +"or :class:`float` with an integral exponent, a float result is delivered. " +"For example, ``pow(-9, 2.0)`` returns ``81.0``." +msgstr "" +"Gdy argumenty są wbudowanymi typami numerycznymi z mieszanymi typami " +"operandów, obowiązują zasady koercji dla binarnych operatorów " +"arytmetycznych. Dla operandów :class:`int` wynik ma ten sam typ co operandy " +"(po koercji), chyba że drugi argument jest ujemny; w takim przypadku " +"wszystkie argument są konwertowane na float i dostarczany jest wynik float. " +"Na przykład, ``pow(10, 2)`` zwracać ``100`` , ale ``pow(10, -2)`` zwracać " +"``0.01`` . W przypadku ujemnej podstawy typu :class:`int` " +"lub :class:`float` i wykładnika niecałkowitego wynikiem jest liczba " +"zespolona. Na przykład, ``pow(-9, 0.5)`` zwraca wartość zbliżoną do ``3j``. " +"Natomiast dla ujemnej podstawy typu :class:`int` lub :class:`float` z " +"wykładnikiem całkowitym, dostarczany jest wynik zmiennoprzecinkowy. Na " +"przykład ``pow(-9, 2.0)`` zwraca ``81.0`` ." + +msgid "" +"For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must " +"also be of integer type and *mod* must be nonzero. If *mod* is present and " +"*exp* is negative, *base* must be relatively prime to *mod*. In that case, " +"``pow(inv_base, -exp, mod)`` is returned, where *inv_base* is an inverse to " +"*base* modulo *mod*." +msgstr "" +"Dla operandów :class:`int` *base* i *exp*, jeśli *mod* jest obecny, *mod* " +"musi być również typu liczba całkowita i *mod* musi być niezerowy. Jeśli " +"*mod* jest obecny, a *exp* jest ujemny, *base* musi być względnie pierwsze " +"do *mod*. W takim przypadku zwracana jest wartość ``pow(inv_base, -exp, " +"mod)``, gdzie *inv_base* jest odwrotnością *base* modulo *mod*." + +msgid "Here's an example of computing an inverse for ``38`` modulo ``97``::" +msgstr "Oto przykład obliczania odwrotności dla ``38`` modulo ``97``::" + +msgid "" +">>> pow(38, -1, mod=97)\n" +"23\n" +">>> 23 * 38 % 97 == 1\n" +"True" +msgstr "" +">>> pow(38, -1, mod=97)\n" +"23\n" +">>> 23 * 38 % 97 == 1\n" +"True" + +msgid "" +"For :class:`int` operands, the three-argument form of ``pow`` now allows the " +"second argument to be negative, permitting computation of modular inverses." +msgstr "" +"W przypadku operandów :class:`int`, trzy-argumentowa forma ``pow`` pozwala " +"teraz, aby drugi argument był ujemny, umożliwiając obliczanie odwrotności " +"modularnych." + +msgid "" +"Allow keyword arguments. Formerly, only positional arguments were supported." +msgstr "" +"Zezwalane na argumenty nazwane. Wcześniej obsługiwane były tylko argumenty " +"pozycyjne." + +msgid "" +"Print *objects* to the text stream *file*, separated by *sep* and followed " +"by *end*. *sep*, *end*, *file*, and *flush*, if present, must be given as " +"keyword arguments." +msgstr "" +"Wypisuje *obiekty* do strumienia tekstowego *file*, oddzielone *sep* i " +"zakończone *end*. *sep*, *end*, *file* i *flush*, jeśli występują, muszą " +"być podane jako argument nazwany." + +msgid "" +"All non-keyword arguments are converted to strings like :func:`str` does and " +"written to the stream, separated by *sep* and followed by *end*. Both *sep* " +"and *end* must be strings; they can also be ``None``, which means to use the " +"default values. If no *objects* are given, :func:`print` will just write " +"*end*." +msgstr "" +"Wszystkie non-argumenty nazwane są konwertowane na napis tak jak :func:`str` " +"i zapisywane do strumienia, oddzielone *sep* i *end*. Zarówno *sep* jak i " +"*end* muszą być napisem; mogą być również ``None``, co oznacza użycie " +"wartości domyślne. Jeśli nie podano *objects*, :func:`print` po prostu " +"zapisze *end*." + +msgid "" +"The *file* argument must be an object with a ``write(string)`` method; if it " +"is not present or ``None``, :data:`sys.stdout` will be used. Since printed " +"arguments are converted to text strings, :func:`print` cannot be used with " +"binary mode file objects. For these, use ``file.write(...)`` instead." +msgstr "" +"*Plik* argument musi być obiektem z metodą ``write(string)``; jeśli nie jest " +"obecny lub ``None``, zostanie użyty :data:`sys.stdout`. Ponieważ drukowane " +"argument są konwertowane na tekst napis, :func:`print` nie może być używany " +"z obiektami plików w trybie binarnym. Zamiast tego należy uży " +"``file.write(...)``." + +msgid "" +"Output buffering is usually determined by *file*. However, if *flush* is " +"true, the stream is forcibly flushed." +msgstr "" +"Buforowanie wyjścia jest zwykle określane przez *file*. Jednakże, jeśli " +"*flush* jest prawdą, strumień jest przymusowo opróżniany." + +msgid "Added the *flush* keyword argument." +msgstr "Dodano *flush* argument nazwany." + +msgid "Return a property attribute." +msgstr "Zwraca atrybut właściwości." + +msgid "" +"*fget* is a function for getting an attribute value. *fset* is a function " +"for setting an attribute value. *fdel* is a function for deleting an " +"attribute value. And *doc* creates a docstring for the attribute." +msgstr "" +"*fget* to funkcja do pobierania wartości atrybut. *fset* to funkcja do " +"ustawiania wartości atrybut. *fdel* to funkcja do usuwania wartości " +"atrybut. Z kolei *doc* tworzy docstring dla atrybut." + +msgid "A typical use is to define a managed attribute ``x``::" +msgstr "" +"Typowym zastosowaniem jest zdefiniowanie zarządzanego atrybutu ``x`` ::" + +msgid "" +"class C:\n" +" def __init__(self):\n" +" self._x = None\n" +"\n" +" def getx(self):\n" +" return self._x\n" +"\n" +" def setx(self, value):\n" +" self._x = value\n" +"\n" +" def delx(self):\n" +" del self._x\n" +"\n" +" x = property(getx, setx, delx, \"I'm the 'x' property.\")" +msgstr "" +"class C:\n" +" def __init__(self):\n" +" self._x = None\n" +"\n" +" def getx(self):\n" +" return self._x\n" +"\n" +" def setx(self, value):\n" +" self._x = value\n" +"\n" +" def delx(self):\n" +" del self._x\n" +"\n" +" x = property(getx, setx, delx, \"I'm the 'x' property.\")" + +msgid "" +"If *c* is an instance of *C*, ``c.x`` will invoke the getter, ``c.x = " +"value`` will invoke the setter, and ``del c.x`` the deleter." +msgstr "" +"Jeśli *c* jest instancją *C*, ``c.x`` wywoła getter, ``c.x = value`` wywoła " +"setter, a ``del c.x`` deleter." + +msgid "" +"If given, *doc* will be the docstring of the property attribute. Otherwise, " +"the property will copy *fget*'s docstring (if it exists). This makes it " +"possible to create read-only properties easily using :deco:`property` as " +"a :term:`decorator`::" +msgstr "" +"Jeśli zostanie podana, *doc* będzie docstringiem atrybutu właściwości. W " +"przeciwnym razie właściwość skopiuje docstring *fget* (jeśli istnieje). " +"Umożliwia to łatwe tworzenie właściwości tylko do odczytu przy " +"użyciu :deco:`property` jako :term:`dekoratora `::" + +msgid "" +"class Parrot:\n" +" def __init__(self):\n" +" self._voltage = 100000\n" +"\n" +" @property\n" +" def voltage(self):\n" +" \"\"\"Get the current voltage.\"\"\"\n" +" return self._voltage" +msgstr "" +"class Parrot:\n" +" def __init__(self):\n" +" self._voltage = 100000\n" +"\n" +" @property\n" +" def voltage(self):\n" +" \"\"\"Uzyska aktualne napięcie.\"\"\n" +" return self._voltage" + +msgid "" +"The ``@property`` decorator turns the :meth:`!voltage` method into a " +"\"getter\" for a read-only attribute with the same name, and it sets the " +"docstring for *voltage* to \"Get the current voltage.\"" +msgstr "" +"``@property`` dekorator zamienia metodę :meth:`!voltage` w \"getter\" dla " +"tylko do odczytu atrybut o tej samej nazwie i ustawia docstring dla " +"*voltage* na \"Get the current voltage\"." + +msgid "" +"A property object has ``getter``, ``setter``, and ``deleter`` methods usable " +"as decorators that create a copy of the property with the corresponding " +"accessor function set to the decorated function. This is best explained " +"with an example:" +msgstr "" +"Obiekt właściwości ma metody ``getter``, ``setter`` i ``deleter`` używane " +"jako dekorator, które tworzą kopię właściwości z odpowiednim akcesorem " +"funkcji ustawionym na dekorowany funkcja. Najlepiej wyjaśnić to na " +"przykładzie:" + +msgid "" +"class C:\n" +" def __init__(self):\n" +" self._x = None\n" +"\n" +" @property\n" +" def x(self):\n" +" \"\"\"I'm the 'x' property.\"\"\"\n" +" return self._x\n" +"\n" +" @x.setter\n" +" def x(self, value):\n" +" self._x = value\n" +"\n" +" @x.deleter\n" +" def x(self):\n" +" del self._x" +msgstr "" +"class C:\n" +" def __init__(self):\n" +" self._x = None\n" +"\n" +" @property\n" +" def x(self):\n" +" \"\"\"I'm the 'x' property.\"\"\"\n" +" return self._x\n" +"\n" +" @x.setter\n" +" def x(self, value):\n" +" self._x = value\n" +"\n" +" @x.deleter\n" +" def x(self):\n" +" del self._x" + +msgid "" +"This code is exactly equivalent to the first example. Be sure to give the " +"additional functions the same name as the original property (``x`` in this " +"case.)" +msgstr "" +"Ten kod jest dokładnie taki sam jak w pierwszym przykładzie. Pamiętaj, aby " +"nadać dodatkowym funkcjom takie same nazwy jak oryginalnej właściwości (w " +"tym przypadku ``x``)." + +msgid "" +"The returned property object also has the attributes ``fget``, ``fset``, and " +"``fdel`` corresponding to the constructor arguments." +msgstr "" +"Zwrócony obiekt właściwości ma również atrybutow ``fget`` , ``fset`` i " +"``fdel`` odpowiadające konstruktor argumentu." + +msgid "The docstrings of property objects are now writeable." +msgstr "Dokumentacja obiektów właściwości sa teraz zapisywalne." + +msgid "" +"Attribute holding the name of the property. The name of the property can be " +"changed at runtime." +msgstr "" +"Atrybut przechowująca nazwę właściwości. Nazwa właściwości może zostać " +"zmieniona w czasie wykonywania." + +msgid "" +"Rather than being a function, :class:`range` is actually an immutable " +"sequence type, as documented in :ref:`typesseq-range` and :ref:`typesseq`." +msgstr "" +"Zamiast być funkcja, :class:`range` jest w rzeczywistości niezmiennym typem " +"sekwencji, jak udokumentowano w :ref:`typesseq-range` i :ref:`typesseq`." + +msgid "" +"Return a string containing a printable representation of an object. For " +"many types, this function makes an attempt to return a string that would " +"yield an object with the same value when passed to :func:`eval`; otherwise, " +"the representation is a string enclosed in angle brackets that contains the " +"name of the type of the object together with additional information often " +"including the name and address of the object. A class can control what this " +"function returns for its instances by defining a :meth:`~object.__repr__` " +"method. If :func:`sys.displayhook` is not accessible, this function will " +"raise :exc:`RuntimeError`." +msgstr "" +"Zwraca napis zawierający nadającą się do druku reprezentację obiektu. W " +"przypadku wielu typów, ta funkcja podejmuje próbę zwracanja napisu, która " +"dałaby obiekt o tej samej wartości po przekazaniu do :func:`eval`; w " +"przeciwnym razie reprezentacja jest napisem ujęta w nawiasy kątowe, które " +"zawierają nazwę typu obiektu wraz z dodatkowymi informacjami, często " +"zawierającymi nazwę i adres obiektu. Klasa może kontrolować co funkcja " +"zwraca dla swoich instancji, definiując metodę :meth:`~object.__repr__`. " +"Jeśli :func:`sys.displayhook` nie jest dostępna, ta funkcja będzie " +"rzucona :exc:`RuntimeError` ." + +msgid "This class has a custom representation that can be evaluated::" +msgstr "Ta klasa ma niestandardową reprezentację, którą można ocenić::" + +msgid "" +"class Person:\n" +" def __init__(self, name, age):\n" +" self.name = name\n" +" self.age = age\n" +"\n" +" def __repr__(self):\n" +" return f\"Person('{self.name}', {self.age})\"" +msgstr "" +"class Osoba:\n" +" def __init__(self, imie, wiek):\n" +" self.imie = imie\n" +" self.wiek = wiek\n" +"\n" +" def __repr__(self):\n" +" zwracać f \"Person('{self.imie}', {self.wiek})\"." + +msgid "" +"Return a reverse :term:`iterator`. The argument must be an object which has " +"a :meth:`~object.__reversed__` method or supports the sequence protocol " +"(the :meth:`~object.__len__` method and the :meth:`~object.__getitem__` " +"method with integer arguments starting at ``0``)." +msgstr "" +"Zwraca odwrócony :term:`iterator`. Argument musi być obiektem, który ma " +"metodę :meth:`~object.__reversed__` lub obsługuje protokół sekwencji " +"(metoda :meth:`~object.__len__` i metoda :meth:`~object.__getitem__` z " +"całkowitymi argumentami począwszy od ``0``)." + +msgid "" +"Return *number* rounded to *ndigits* precision after the decimal point. If " +"*ndigits* is omitted or is ``None``, it returns the nearest integer to its " +"input." +msgstr "" +"Zwraca *liczba* zaokrąglona do *cyfr* po przecinku dziesiętnym. Jeśli " +"*ndigits* zostanie pominięte lub będzie ``None``, to zwraca najbliższa " +"liczbe całkowita wartości wejściowej." + +msgid "" +"For the built-in types supporting :func:`round`, values are rounded to the " +"closest multiple of 10 to the power minus *ndigits*; if two multiples are " +"equally close, rounding is done toward the even choice (so, for example, " +"both ``round(0.5)`` and ``round(-0.5)`` are ``0``, and ``round(1.5)`` is " +"``2``). Any integer value is valid for *ndigits* (positive, zero, or " +"negative). The return value is an integer if *ndigits* is omitted or " +"``None``. Otherwise, the return value has the same type as *number*." +msgstr "" +"Dla typów wbudowanych wspierających :func:`round`, wartości są zaokrąglane " +"do najbliższej wielokrotności 10 do potęgi minus *ndigits*; jeśli dwie " +"wielokrotności są równie bliskie, zaokrąglanie jest wykonywane w kierunku " +"parzystego wyboru (więc, na przykład, zarówno ``round(0.5)`` jak i " +"``round(-0.5)`` są ``0``, a ``round(1.5)`` jest ``2``). Każda wartość " +"liczby całkowitej jest ważna dla *cyfr* (dodatnich, zerowych lub ujemnych). " +"zwracana wartość jest liczba całkowita jeśli *ndigits* jest pominięte lub " +"``None``. W przeciwnym razie zwracana wartość ma ten sam typ co *number*." + +msgid "" +"For a general Python object ``number``, ``round`` delegates to " +"``number.__round__``." +msgstr "" +"Dla ogólnego obiektu Python ``number`` , ``round`` deleguje do " +"``number.__round__``." + +msgid "" +"The behavior of :func:`round` for floats can be surprising: for example, " +"``round(2.675, 2)`` gives ``2.67`` instead of the expected ``2.68``. This is " +"not a bug: it's a result of the fact that most decimal fractions can't be " +"represented exactly as a float. See :ref:`tut-fp-issues` for more " +"information." +msgstr "" +"Zachowanie :func:`round` dla zmiennoprzecinkowych może być zaskakujący: na " +"przykład, ``round(2.675, 2)`` daje ``2.67`` zamiast oczekiwanego ``2.68``. " +"Nie jest to błąd: wynika to z faktu, że większość ułamków dziesiętnych nie " +"może być reprezentowana dokładnie jako liczba zmiennoprzecinkowa. Więcej " +"informacji można znaleźć na stronie :ref:`tut-fp-issues`." + +msgid "" +"Return a new :class:`set` object, optionally with elements taken from " +"*iterable*. :class:`set` is a built-in class. See also :ref:`types-set` " +"for documentation about this class." +msgstr "" +"Zwraca nowy obiekt :class:`set`, opcjonalnie z elementami z " +"*iterable*. :class:`set` jest klasą wbudowaną. Zobacz też dokumentację " +"dotycząca tej klasy w :ref:`types-set`." + +msgid "" +"For other containers see the built-" +"in :class:`frozenset`, :class:`list`, :class:`tuple`, and :class:`dict` " +"classes, as well as the :mod:`collections` module." +msgstr "" +"Dla innych kontenerów zobacz klasy " +"wbudowane :class:`frozenset` , :class:`list`, :class:`tuple` " +"i :class:`dict`, jak również :mod:`collections` moduł ." + +msgid "" +"This is the counterpart of :func:`getattr`. The arguments are an object, a " +"string, and an arbitrary value. The string may name an existing attribute " +"or a new attribute. The function assigns the value to the attribute, " +"provided the object allows it. For example, ``setattr(x, 'foobar', 123)`` " +"is equivalent to ``x.foobar = 123``." +msgstr "" +"Jest to odpowiednik :func:`getattr`. Argumenty to obiekt, napis i dowolna " +"wartość. Napis może nazywać istniejący atrybut lub nowy atrybut. Funkcja " +"przypisuje wartość do atrybut, pod warunkiem, że obiekt na to pozwala. Na " +"przykład, ``setattr(x, 'foobar', 123)`` jest równoważne ``x.foobar = 123``." + +msgid "" +"*name* need not be a Python identifier as defined in :ref:`identifiers` " +"unless the object chooses to enforce that, for example in a " +"custom :meth:`~object.__getattribute__` or via :attr:`~object.__slots__`. An " +"attribute whose name is not an identifier will not be accessible using the " +"dot notation, but is accessible through :func:`getattr` etc.." +msgstr "" +"*name* nie musi być identyfikatorem Pythona zdefiniowanym " +"w :ref:`identifiers`, chyba że obiekt zdecyduje się to wymusić, na przykład " +"w niestandardowym :meth:`~object.__getattribute__` lub " +"poprzez :attr:`~object.__slots__`. Obiekt atrybut, którego nazwa nie jest " +"identyfikatorem, nie będzie dostępny przy użyciu notacji kropkowej, ale " +"będzie dostępny za pośrednictwem :func:`getattr` itd." + +msgid "" +"Since :ref:`private name mangling ` happens at " +"compilation time, one must manually mangle a private attribute's (attributes " +"with two leading underscores) name in order to set it with :func:`setattr`." +msgstr "" +"Ponieważ :ref:`mangling nazwy prywatnej ` ma miejsce " +"w czasie kompilacji, należy ręcznie zmienić nazwę prywatnego atrybutu " +"(atrybut z dwoma wiodącymi podkreśleniami), aby ustawić ją z :func:`setattr`." + +msgid "" +"Return a :term:`slice` object representing the set of indices specified by " +"``range(start, stop, step)``. The *start* and *step* arguments default to " +"``None``." +msgstr "" +"Zwraca obiekt :term:`slice` reprezentujący zbiór indeksów określonych przez " +"``range(start, stop, step)``. *start* i *step* argumenty domyślne do " +"``None``." + +msgid "" +"Slice objects 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 "" +"Slice objects are now :term:`hashable` " +"(provided :attr:`~slice.start`, :attr:`~slice.stop`, and :attr:`~slice.step` " +"are hashable)." +msgstr "" +"Obiekty Slice są teraz :term:`hashable` (pod warunkiem, " +"że :attr:`~slice.start`, :attr:`~slice.stop` i :attr:`~slice.step` są " +"hashable)." + +msgid "Return a new sorted list from the items in *iterable*." +msgstr "Zwraca nową posortowaną listę z elementów w *iterable*." + +msgid "" +"Has two optional arguments which must be specified as keyword arguments." +msgstr "" +"Posiada dwa opcjonalne argumenty, które muszą być określone jako argument " +"nazwany." + +msgid "" +"*key* specifies a function of one argument that is used to extract a " +"comparison key from each element in *iterable* (for example, " +"``key=str.lower``). The default value is ``None`` (compare the elements " +"directly)." +msgstr "" +"*key* określa funkcje jednego argumentu, który jest używany do wyodrębnienia " +"klucza porównania z każdego elementu w *iterable* (na przykład " +"``key=str.lower``). Wartość domyślna to ``None`` (bezpośrednie porównanie " +"elementów)." + +msgid "" +"*reverse* is a boolean value. If set to ``True``, then the list elements " +"are sorted as if each comparison were reversed." +msgstr "" +"*reverse* jest wartością logiczną. Jeśli jest ustawiona na ``True``, " +"elementy listy są sortowane tak, jakby każde porównanie było odwrócone." + +msgid "" +"Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function to a " +"*key* function." +msgstr "" +"Użyj :func:`functools.cmp_to_key` do konwersji starego stylu *cmp* funkcja " +"na *key* funkcja." + +msgid "" +"The built-in :func:`sorted` function is guaranteed to be stable. A sort is " +"stable if it guarantees not to change the relative order of elements that " +"compare equal --- this is helpful for sorting in multiple passes (for " +"example, sort by department, then by salary grade)." +msgstr "" +"Wbudowana :func:`sorted` funkcja ma gwarancję stabilności. Sortowanie jest " +"stabilne, jeśli gwarantuje, że nie zmieni względnej kolejności elementów, " +"które porównują równe --- jest to pomocne przy sortowaniu w wielu " +"przejściach (na przykład sortowanie według działu, a następnie według " +"kategorii wynagrodzenia)." + +msgid "" +"The sort algorithm uses only ``<`` comparisons between items. While " +"defining an :meth:`~object.__lt__` method will suffice for sorting, :PEP:`8` " +"recommends that all six :ref:`rich comparisons ` be " +"implemented. This will help avoid bugs when using the same data with other " +"ordering tools such as :func:`max` that rely on a different underlying " +"method. Implementing all six comparisons also helps avoid confusion for " +"mixed type comparisons which can call the reflected :meth:`~object.__gt__` " +"method." +msgstr "" +"Algorytm sortowania używa tylko porównań ``<`` między elementami. Podczas " +"gdy zdefiniowanie metoda :meth:`~object.__lt__` wystarczy do " +"sortowania, :PEP:`8` zaleca zaimplementowanie wszystkich " +"sześciu :ref:`bogatych porównań `. Pomoże to uniknąć błędów " +"podczas korzystania z tych samych danych z innymi narzędziami " +"porządkującymi, takimi jak :func:`max`, które opierają się na innej metodzie " +"bazowej. Zaimplementowanie wszystkich sześciu porównań pomaga również " +"uniknąć nieporozumień w przypadku porównań typów mieszanych, które mogą " +"wywoływać metodę :meth:`~object.__gt__`." + +msgid "" +"For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." +msgstr "" +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." + +msgid "Transform a method into a static method." +msgstr "Przekształcenie metody w metodę statyczną." + +msgid "" +"A static method does not receive an implicit first argument. To declare a " +"static method, use this idiom::" +msgstr "" +"Metoda statyczna nie otrzymuje niejawnego pierwszego argumentu. Aby " +"zadeklarować metodę statyczną, użyj tego idiomu::" + +msgid "" +"class C:\n" +" @staticmethod\n" +" def f(arg1, arg2, argN): ..." +msgstr "" +"class C:\n" +" @staticmethod\n" +" def f(arg1, arg2, argN): ..." + +msgid "" +"The ``@staticmethod`` form is a function :term:`decorator` -- " +"see :ref:`function` for details." +msgstr "" +"Forma ``@staticmethod`` to :term:`dekorator` funkcji -- " +"zobacz :ref:`function` po szczegóły." + +msgid "" +"A static method can be called either on the class (such as ``C.f()``) or on " +"an instance (such as ``C().f()``). Moreover, the static " +"method :term:`descriptor` is also callable, so it can be used in the class " +"definition (such as ``f()``)." +msgstr "" +"Metoda statyczna może być wywołana na klasie (np. ``C.f()``) lub na " +"instancji (np. ``C().f()``). Co więcej, metoda statyczna :term:`descriptor` " +"jest również wywoływalna, więc może być użyta w definicja klasy (np. " +"``f()``)." + +msgid "" +"Static methods in Python are similar to those found in Java or C++. Also, " +"see :deco:`classmethod` for a variant that is useful for creating alternate " +"class constructors." +msgstr "" +"Metody statyczne w Pythonie są podobne do tych, które można znaleźć w Java " +"lub C++. Zobacz także :deco:`classmethod`, aby zapoznać się z wariantem, " +"który jest przydatny do tworzenia alternatywnych konstruktorów klas." + +msgid "" +"Like all decorators, it is also possible to call ``staticmethod`` as a " +"regular function and do something with its result. This is needed in some " +"cases where you need a reference to a function from a class body and you " +"want to avoid the automatic transformation to instance method. For these " +"cases, use this idiom::" +msgstr "" +"Podobnie jak wszystkie dekoratory, możliwe jest również wywołanie " +"``staticmethod`` jako zwykłoł funkcje i zrobienie czegoś z jego wynikiem. " +"Jest to potrzebne w niektórych przypadkach, gdy potrzebujesz odniesienia do " +"funkcji z ciałej klasy i chcesz uniknąć automatycznej transformacji do " +"metody instancji. W takich przypadkach należy użyć tego idiomu::" + +msgid "" +"def regular_function():\n" +" ...\n" +"\n" +"class C:\n" +" method = staticmethod(regular_function)" +msgstr "" +"def regular_function():\n" +" ...\n" +"\n" +"class C:\n" +" method = staticmethod(regular_function)" + +msgid "For more information on static methods, see :ref:`types`." +msgstr "" +"Więcej informacji na temat metod statycznych można znaleźć na " +"stronie :ref:`types`." + +msgid "" +"Static methods now inherit the method attributes " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"and :attr:`~function.__annotations__`), have a new ``__wrapped__`` " +"attribute, and are now callable as regular functions." +msgstr "" +"Metody statyczne dziedziczą teraz metodę atrybut " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"i :attr:`~function.__annotations__`), mają nową ``__wrapped__`` atrybut i są " +"teraz wywoływane jako zwykła funkcja." + +msgid "" +"Return a :class:`str` version of *object*. See :func:`str` for details." +msgstr "" +"Zwraca :class:`str` wersja of *object*. Szczegółowe informacje można " +"znaleźć na stronie :func:`str`." + +msgid "" +"``str`` is the built-in string :term:`class`. For general information about " +"strings, see :ref:`textseq`." +msgstr "" +"``str`` jest wbudowanem napisem :term:`class`. Aby uzyskać ogólne " +"informacje na temat napisow, zobacz :ref:`textseq`." + +msgid "" +"Sums *start* and the items of an *iterable* from left to right and returns " +"the total. The *iterable*'s items are normally numbers, and the start value " +"is not allowed to be a string." +msgstr "" +"Sumuje *start* i elementy *iterable* od lewej do prawej i zwraca sumę. " +"Elementy *iterable* są zwykle liczbami, a wartością początkową nie może być " +"napisem." + +msgid "" +"For some use cases, there are good alternatives to :func:`sum`. The " +"preferred, fast way to concatenate a sequence of strings is by calling " +"``''.join(sequence)``. To add floating-point values with extended " +"precision, see :func:`math.fsum`\\. To concatenate a series of iterables, " +"consider using :func:`itertools.chain`." +msgstr "" +"W niektórych przypadkach istnieją dobra alternatywa dla :func:`sum`. " +"Preferowanym, szybkim sposobem na łączyć sekwencji napisów jest wywołanie " +"``''.join(sequence)``. Aby dodać wartości zmiennoprzecinkowe z rozszerzoną " +"precyzją, zobacz :func:`math.fsum`\\. Aby łączyć serię iterable, należy " +"rozważyć użycie :func:`itertools.chain`." + +msgid "The *start* parameter can be specified as a keyword argument." +msgstr "Parametr *start* można określić jako argument nazwany." + +msgid "" +"Summation of floats switched to an algorithm that gives higher accuracy and " +"better commutativity on most builds." +msgstr "" +"Sumowanie zmiennoprzecinkowe zostało przełączone na algorytm, który zapewnia " +"większą dokładność i lepszą przemienność w większości kompilacji." + +msgid "" +"Return a proxy object that delegates method calls to a parent or sibling " +"class of *type*. This is useful for accessing inherited methods that have " +"been overridden in a class." +msgstr "" +"Zwraca obiekt proxy, który deleguje wywołania metod do klasy nadrzędnej lub " +"rodzeństwa *type*. Jest to przydatne do uzyskiwania dostępu do " +"odziedziczonych metod, które zostały przesłonięte w klasie." + +msgid "" +"The *object_or_type* determines the :term:`method resolution order` to be " +"searched. The search starts from the class right after the *type*." +msgstr "" +"*object_or_type* określa :term:`method resolution order` do przeszukania. " +"Wyszukiwanie rozpoczyna się od klasy zaraz po *type*." + +msgid "" +"For example, if :attr:`~type.__mro__` of *object_or_type* is ``D -> B -> C " +"-> A -> object`` and the value of *type* is ``B``, then :func:`super` " +"searches ``C -> A -> object``." +msgstr "" +"Na przykład, jeśli :attr:`~type.__mro__` z *object_or_type* jest ``D -> B -> " +"C -> A -> object`` i wartość *type* jest ``B``, to :func:`super` wyszukuje " +"``C -> A -> object``." + +msgid "" +"The :attr:`~type.__mro__` attribute of the class corresponding to " +"*object_or_type* lists the method resolution search order used by " +"both :func:`getattr` and :func:`super`. The attribute is dynamic and can " +"change whenever the inheritance hierarchy is updated." +msgstr "" +":attr:`~type.__mro__` atrybut klasy odpowiadającej *object_or_type* wymienia " +"kolejność wyszukiwania metod używaną zarówno przez :func:`getattr` jak " +"i :func:`super`. Adres atrybut jest dynamiczny i może ulec zmianie przy " +"każdej aktualizacji hierarchii dziedziczenia." + +msgid "" +"If the second argument is omitted, the super object returned is unbound. If " +"the second argument is an object, ``isinstance(obj, type)`` must be true. " +"If the second argument is a type, ``issubclass(type2, type)`` must be true " +"(this is useful for classmethods)." +msgstr "" +"Jeśli drugi argument zostanie pominięty, zwrócony superobiekt jest " +"niezwiązany. Jeśli drugi argument jest obiektem, ``isinstance(obj, type)`` " +"musi być prawda. Jeśli drugi argument jest typem, ``issubclass(type2, " +"type)`` musi być prawda (jest to przydatne dla metod klasowych)." + +msgid "" +"When called directly within an ordinary method of a class, both arguments " +"may be omitted (\"zero-argument :func:`!super`\"). In this case, *type* will " +"be the enclosing class, and *obj* will be the first argument of the " +"immediately enclosing function (typically ``self``). (This means that zero-" +"argument :func:`!super` will not work as expected within nested functions, " +"including generator expressions, which implicitly create nested functions.)" +msgstr "" +"W przypadku wywołania bezpośrednio w zwykłej metodzie klasy, obie argument " +"mogą zostać pominięte (\"zero-argument :func:`!super` \"). W takim przypadku " +"*type* będzie klasą otaczającą, a *obj* będzie pierwszym argumentem " +"bezpośrednio otaczającego funkcje (zazwyczaj ``self``). (Oznacza to, że zero-" +"argument :func:`!super` nie będzie działać zgodnie z oczekiwaniami wewnątrz " +"zagnieżdżonych funkci, w tym wyrażeń generator, które domyślnie tworzą " +"zagnieżdżone funkcje)." + +msgid "" +"There are two typical use cases for *super*. In a class hierarchy with " +"single inheritance, *super* can be used to refer to parent classes without " +"naming them explicitly, thus making the code more maintainable. This use " +"closely parallels the use of *super* in other programming languages." +msgstr "" +"Istnieją dwa typowe przypadki użycia *super*. W hierarchii klas z " +"pojedynczym dziedziczeniem, *super* może być używany do odwoływania się do " +"klas nadrzędnych bez ich jawnego nazywania, dzięki czemu kod jest łatwiejszy " +"w utrzymaniu. To zastosowanie jest bardzo podobne do użycia *super* w " +"innych językach programowania." + +msgid "" +"The second use case is to support cooperative multiple inheritance in a " +"dynamic execution environment. This use case is unique to Python and is not " +"found in statically compiled languages or languages that only support single " +"inheritance. This makes it possible to implement \"diamond diagrams\" where " +"multiple base classes implement the same method. Good design dictates that " +"such implementations have the same calling signature in every case (because " +"the order of calls is determined at runtime, because that order adapts to " +"changes in the class hierarchy, and because that order can include sibling " +"classes that are unknown prior to runtime)." +msgstr "" +"Drugim przypadkiem użycia jest obsługa kooperatywnego dziedziczenia " +"wielokrotnego w dynamicznym środowisku wykonawczym. Ten przypadek użycia " +"jest unikalny dla Python i nie występuje w statycznie kompilowanych językach " +"lub językach, które obsługują tylko pojedyncze dziedziczenie. Umożliwia to " +"implementację \"diagramów diamentowych\", w których wiele klas bazowych " +"implementuje tę samą metodę. Dobry projekt nakazuje, aby takie " +"implementacje miały tę samą sygnaturę wywołania w każdym przypadku (ponieważ " +"kolejność wywołań jest określana w czasie wykonywania, ponieważ kolejność ta " +"dostosowuje się do zmian w hierarchii klas i ponieważ kolejność ta może " +"obejmować klasy rodzeństwa, które są nieznane przed uruchomieniem)." + +msgid "For both use cases, a typical superclass call looks like this::" +msgstr "W obu przypadkach typowe wywołanie superklasy wygląda następująco::" + +msgid "" +"class C(B):\n" +" def method(self, arg):\n" +" super().method(arg) # This does the same thing as:\n" +" # super(C, self).method(arg)" +msgstr "" +"class C(B):\n" +" def methoda(self, arg):\n" +" super().methoda(arg) # To robi to samo co:\n" +" # super(C, self).methoda(arg)" + +msgid "" +"In addition to method lookups, :func:`super` also works for attribute " +"lookups. One possible use case for this is calling :term:`descriptors " +"` in a parent or sibling class." +msgstr "" +"Oprócz wyszukiwania metod, :func:`super` działa również dla wyszukiwania " +"atrybut. Jednym z możliwych przypadków użycia jest " +"wywołanie :term:`descriptors ` w klasie nadrzędnej lub " +"podrzędnej." + +msgid "" +"Note that :func:`super` is implemented as part of the binding process for " +"explicit dotted attribute lookups such as ``super().__getitem__(name)``. It " +"does so by implementing its own :meth:`~object.__getattribute__` method for " +"searching classes in a predictable order that supports cooperative multiple " +"inheritance. Accordingly, :func:`super` is undefined for implicit lookups " +"using statements or operators such as ``super()[name]``." +msgstr "" +"Należy zauważyć, że :func:`super` jest zaimplementowany jako część wiązania " +"przetwarzanie/proces dla jawnego wyszukiwania kropkowego atrybut, takiego " +"jak ``super().__getitem__(name)``. Czyni to poprzez implementację własnej " +"metody :meth:`~object.__getattribute__` do wyszukiwania klas w " +"przewidywalnej kolejności, która obsługuje wielokrotne dziedziczenie oparte " +"na współpracy. Odpowiednio, :func:`super` jest niezdefiniowany dla " +"niejawnych wyszukiwań przy użyciu instrukcja lub operatorów takich jak " +"``super()[name]``." + +msgid "" +"Also note that, aside from the zero argument form, :func:`super` is not " +"limited to use inside methods. The two argument form specifies the " +"arguments exactly and makes the appropriate references. The zero argument " +"form only works inside a class definition, as the compiler fills in the " +"necessary details to correctly retrieve the class being defined, as well as " +"accessing the current instance for ordinary methods." +msgstr "" +"Należy również pamiętać, że poza formą zero argument, :func:`super` nie jest " +"ograniczona do użycia wewnątrz metod. Dwie formy argumentów dokładnie " +"określają argumenty i tworzą odpowiednie odniesienia. Forma zero argumentów " +"działa tylko wewnątrz definicja klasy, ponieważ kompilator wypełnia " +"niezbędne szczegóły, aby poprawnie pobrać definiowaną klasę, a także uzyskać " +"dostęp do bieżącej instancji dla zwykłych metod." + +msgid "" +"For practical suggestions on how to design cooperative classes " +"using :func:`super`, see `guide to using super() `_." +msgstr "" +"Praktyczne sugestie dotyczące projektowania klas współpracujących przy " +"użyciu :func:`super` można znaleźć w `poradniku korzystania z super() " +"`_." + +msgid "" +"Rather than being a function, :class:`tuple` is actually an immutable " +"sequence type, as documented in :ref:`typesseq-tuple` and :ref:`typesseq`." +msgstr "" +"Zamiast być funkcja, :class:`tuple` jest w rzeczywistości niezmiennym typem " +"sekwencji, jak udokumentowano w :ref:`typesseq-tuple` i :ref:`typesseq`." + +msgid "" +"With one argument, return the type of an *object*. The return value is a " +"type object and generally the same object as returned " +"by :attr:`object.__class__`." +msgstr "" +"Z jednym argumentem, zwraca typ obiektu *object*. Zwracana wartość to " +"obiekt typu i generalnie jest to ten sam obiekt, który został zwrócony " +"przez :attr:`object.__class__`." + +msgid "" +"The :func:`isinstance` built-in function is recommended for testing the type " +"of an object, because it takes subclasses into account." +msgstr "" +"Funkcja wbudowana :func:`isinstance` jest zalecana do testowania typu " +"obiektu, ponieważ uwzględnia podklasy." + +msgid "" +"With three arguments, return a new type object. This is essentially a " +"dynamic form of the :keyword:`class` statement. The *name* string is the " +"class name and becomes the :attr:`~type.__name__` attribute. The *bases* " +"tuple contains the base classes and becomes the :attr:`~type.__bases__` " +"attribute; if empty, :class:`object`, the ultimate base of all classes, is " +"added. The *dict* dictionary contains attribute and method definitions for " +"the class body; it may be copied or wrapped before becoming " +"the :attr:`~type.__dict__` attribute. The following two statements create " +"identical :class:`!type` objects:" +msgstr "" +"Z trzema argumentami, zwraca nowy typ obiektu. Jest to zasadniczo dynamiczna " +"forma instrukcji :keyword:`class`. Ciąg znaków *name* jest nazwą klasy i " +"staje się atrybutem :attr:`~type.__name__`. Krotka *bases* zawiera klasy " +"bazowe i staje się atrybutem :attr:`~type.__bases__`; jeśli jest pusta, " +"dodawana jest :class:`object`, ostateczna baza wszystkich klas. Słownik " +"*dict* zawiera definicje atrybutów i metod dla ciała klasy; może być " +"kopiowany lub wrapowany zanim stanie się atrybutem :attr:`~type.__dict__`. " +"Następujące dwie instrukcja tworzą identyczne obiekty :class:`!type`:" + +msgid "See also:" +msgstr "Zobacz także:" + +msgid "" +":ref:`Documentation on attributes and methods on classes `." +msgstr "" +":ref:`Dokumentacja atrybutow i metod na klasach `." + +msgid ":ref:`bltin-type-objects`" +msgstr ":ref:`bltin-type-objects`" + +msgid "" +"Keyword arguments provided to the three argument form are passed to the " +"appropriate metaclass machinery (usually :meth:`~object.__init_subclass__`) " +"in the same way that keywords in a class definition (besides *metaclass*) " +"would." +msgstr "" +"Argument nazwane dostarczone do trzech formularzy argumenty są przekazywane " +"do odpowiedniego mechanizmu metaklas " +"(zwykle :meth:`~object.__init_subclass__`) w taki sam sposób, jak słowa " +"kluczowe w definicja klasy (poza *metaclass*)." + +msgid "" +"Unlike a :keyword:`class` statement, the three argument form does not call " +"the metaclass ``__prepare__`` method (see :ref:`prepare`). " +"Use :func:`types.new_class` to dynamically create a class using the " +"appropriate metaclass." +msgstr "" +"W przeciwieństwie do instrukcji :keyword:`class`, forma z trzema argumentami " +"nie wywołuje metody ``__prepare__`` metaklasy (zobacz :ref:`prepare`). Aby " +"dynamicznie utworzyć klasę przy użyciu odpowiedniej metaklasy, należy " +"skorzystać z :func:`types.new_class`." + +msgid "See also :ref:`class-customization`." +msgstr "Zobacz także :ref:`class-customization`." + +msgid "" +"Subclasses of :class:`!type` which don't override ``type.__new__`` may no " +"longer use the one-argument form to get the type of an object." +msgstr "" +"Podklasy z :class:`!type`, które nie nadpisują ``type.__new__`` nie mogą już " +"używać formy jednego-argumentu do uzyskania typu obiektu." + +msgid "" +"Return the :attr:`~object.__dict__` attribute for a module, class, instance, " +"or any other object with a :attr:`!__dict__` attribute." +msgstr "" +"Zwraca atrybut :attr:`~object.__dict__` dla moduł, klas, instancji lub " +"dowolnego innego obiektu z :attr:`!__dict__` atrybut ." + +msgid "" +"Objects such as modules and instances have an " +"updateable :attr:`~object.__dict__` attribute; however, other objects may " +"have write restrictions on their :attr:`!__dict__` attributes (for example, " +"classes use a :class:`types.MappingProxyType` to prevent direct dictionary " +"updates)." +msgstr "" +"Obiekty takie jak moduł i instancje mają możliwość " +"aktualizacji :attr:`~object.__dict__` atrybut; jednak inne obiekty mogą mieć " +"ograniczenia zapisu na ich :attr:`!__dict__` atrybut (na przykład klasy " +"używają :class:`types.MappingProxyType`, aby zapobiec bezpośrednim " +"aktualizacjom słownika)." + +msgid "Without an argument, :func:`vars` acts like :func:`locals`." +msgstr "Bez argumenta, :func:`vars` działa jak :func:`locals`." + +msgid "" +"A :exc:`TypeError` exception is raised if an object is specified but it " +"doesn't have a :attr:`~object.__dict__` attribute (for example, if its class " +"defines the :attr:`~object.__slots__` attribute)." +msgstr "" +"Wyjątek :exc:`TypeError` jest rzucony, jeśli obiekt jest określony, ale nie " +"ma :attr:`~object.__dict__` atrybut (na przykład, jeśli jego klasa " +"definiuje :attr:`~object.__slots__` atrybut )." + +msgid "" +"The result of calling this function without an argument has been updated as " +"described for the :func:`locals` builtin." +msgstr "" +"Wynik wywołania tej funkcji bez argumentów został zaktualizowany zgodnie z " +"opisem dla wbudowanej funkcji :func:`locals`." + +msgid "" +"Iterate over several iterables in parallel, producing tuples with an item " +"from each one." +msgstr "" +"Iteruje równolegle po kilku iterables, tworząc krotke z elementem z każdej z " +"nich." + +msgid "Example::" +msgstr "Przykład::" + +msgid "" +">>> for item in zip([1, 2, 3], ['sugar', 'spice', 'everything nice']):\n" +"... print(item)\n" +"...\n" +"(1, 'sugar')\n" +"(2, 'spice')\n" +"(3, 'everything nice')" +msgstr "" +">>> for item in zip([1, 2, 3], ['cukier', 'przyprawa', 'wszystko fajnie']):\n" +"... print(item)\n" +"...\n" +"(1, 'cukier')\n" +"(2, \"przyprawa\")\n" +"(3, \"wszystko fajnie\")" + +msgid "" +"More formally: :func:`zip` returns an iterator of tuples, where the *i*-th " +"tuple contains the *i*-th element from each of the argument iterables." +msgstr "" +"Bardziej formalnie: :func:`zip` zwraca i iterator z krotka, gdzie *i*-ty " +"krotka zawiera *i*-ty element z każdego z argument iterable ." + +msgid "" +"Another way to think of :func:`zip` is that it turns rows into columns, and " +"columns into rows. This is similar to `transposing a matrix `_." +msgstr "" +"Innym sposobem myślenia o :func:`zip` jest to, że zamienia wiersze w " +"kolumny, a kolumny w wiersze. Jest to podobne do `przekształcania macierzy " +"`_." + +msgid "" +":func:`zip` is lazy: The elements won't be processed until the iterable is " +"iterated on, e.g. by a :keyword:`!for` loop or by wrapping in " +"a :class:`list`." +msgstr "" +":func:`zip` jest leniwy: Elementy nie będą przetwarzane, dopóki iterable nie " +"zostanie poddany iteracji, np. przez pętlę :keyword:`!for` lub przez " +"zawinięcie w :class:`list`." + +msgid "" +"One thing to consider is that the iterables passed to :func:`zip` could have " +"different lengths; sometimes by design, and sometimes because of a bug in " +"the code that prepared these iterables. Python offers three different " +"approaches to dealing with this issue:" +msgstr "" +"Jedną rzeczą, którą należy wziąć pod uwagę, jest to, że iterable " +"przekazywane do :func:`zip` mogą mieć różne długości; czasami z założenia, a " +"czasami z powodu błędu w kodzie, który przygotował te iterable. Python " +"oferuje trzy różne podejścia do radzenia sobie z tym problemem:" + +msgid "" +"By default, :func:`zip` stops when the shortest iterable is exhausted. It " +"will ignore the remaining items in the longer iterables, cutting off the " +"result to the length of the shortest iterable::" +msgstr "" +"Przez domyślny, :func:`zip` zatrzymuje się, gdy najkrótszy iterable jest " +"wyczerpany. Zignoruje pozostałe elementy w dłuższym iterable, obcinając " +"wynik do długości najkrótszego iterable::" + +msgid "" +">>> list(zip(range(3), ['fee', 'fi', 'fo', 'fum']))\n" +"[(0, 'fee'), (1, 'fi'), (2, 'fo')]" +msgstr "" +">>> list(zip(range(3), ['fee', 'fi', 'fo', 'fum']))\n" +"[(0, 'fee'), (1, 'fi'), (2, 'fo')]" + +msgid "" +":func:`zip` is often used in cases where the iterables are assumed to be of " +"equal length. In such cases, it's recommended to use the ``strict=True`` " +"option. Its output is the same as regular :func:`zip`::" +msgstr "" +":func:`zip` jest często używana w przypadkach, gdy zakłada się, że iterable " +"są równej długości. W takich przypadkach zaleca się użycie opcji " +"``strict=True``. Jej wynik jest taki sam jak zwykłego :func:`zip`::" + +msgid "" +">>> list(zip(('a', 'b', 'c'), (1, 2, 3), strict=True))\n" +"[('a', 1), ('b', 2), ('c', 3)]" +msgstr "" +">>> list(zip(('a', 'b', 'c'), (1, 2, 3), strict=True))\n" +"[('a', 1), ('b', 2), ('c', 3)]" + +msgid "" +"Unlike the default behavior, it raises a :exc:`ValueError` if one iterable " +"is 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 "Wskazówki i porady:" + +msgid "" +"The left-to-right evaluation order of the iterables is guaranteed. This " +"makes possible an idiom for clustering a data series into n-length groups " +"using ``zip(*[iter(s)]*n, strict=True)``. This repeats the *same* iterator " +"``n`` times so that each output tuple has the result of ``n`` calls to the " +"iterator. This has the effect of dividing the input into n-length chunks." +msgstr "" +"Kolejność oceny od lewej do prawej strony iterable jest gwarantowana. " +"Umożliwia to idiom grupowania serii danych w grupy o długości n przy użyciu " +"``zip(*[iter(s)]*n, strict=True)``. Powtarza to *tę samą* iterator ``n`` " +"razy, tak że każde wyjście krotka ma wynik wywołań ``n`` do iteratora. " +"Powoduje to podzielenie danych wejściowych na fragmenty o długości n." + +msgid "" +":func:`zip` in conjunction with the ``*`` operator can be used to unzip a " +"list::" +msgstr "" +":func:`zip` w połączeniu z operatorem ``*`` może być użyty do rozpakowania " +"listy::" + +msgid "" +">>> x = [1, 2, 3]\n" +">>> y = [4, 5, 6]\n" +">>> list(zip(x, y))\n" +"[(1, 4), (2, 5), (3, 6)]\n" +">>> x2, y2 = zip(*zip(x, y))\n" +">>> x == list(x2) and y == list(y2)\n" +"True" +msgstr "" +">>> x = [1, 2, 3]\n" +">>> y = [4, 5, 6]\n" +">>> list(zip(x, y))\n" +"[(1, 4), (2, 5), (3, 6)]\n" +">>> x2, y2 = zip(*zip(x, y))\n" +">>> x == list(x2) and y == list(y2)\n" +"True" + +msgid "Added the ``strict`` argument." +msgstr "Dodano argument ``strict`` ." + +msgid "" +"This is an advanced function that is not needed in everyday Python " +"programming, unlike :func:`importlib.import_module`." +msgstr "" +"Jest to zaawansowana funkcja, która nie jest potrzebna w codziennym " +"programowaniu Pythona, w przeciwieństwie do :func:`importlib.import_module`." + +msgid "" +"This function is invoked by the :keyword:`import` statement. It can be " +"replaced (by importing the :mod:`builtins` module and assigning to " +"``builtins.__import__``) in order to change semantics of the :keyword:`!" +"import` statement, but doing so is **strongly** discouraged as it is usually " +"simpler to use import hooks (see :pep:`302`) to attain the same goals and " +"does not cause issues with code which assumes the default import " +"implementation is in use. Direct use of :func:`__import__` is also " +"discouraged in favor of :func:`importlib.import_module`." +msgstr "" +"Ten funkcja jest wywoływany przez :keyword:`import` instrukcja . Można go " +"zastąpić (importując :mod:`builtins` moduł i przypisując do " +"``builtins.__import__``) w celu zmiany semantyki :keyword:`!import` " +"instrukcja , ale jest to **bardżo** odradzane, ponieważ zwykle prostsze jest " +"użycie haków importu (zobacz :pep:`302`), aby osiągnąć te same cele i nie " +"powoduje problemów z kodem, który zakłada, że implementacja importu domyślny " +"jest w użyciu. Bezpośrednie użycie :func:`__import__` jest również " +"odradzane na korzyść :func:`importlib.import_module`." + +msgid "" +"The function imports the module *name*, potentially using the given " +"*globals* and *locals* to determine how to interpret the name in a package " +"context. The *fromlist* gives the names of objects or submodules that should " +"be imported from the module given by *name*. The standard implementation " +"does not use its *locals* argument at all and uses its *globals* only to " +"determine the package context of the :keyword:`import` statement." +msgstr "" +"Funkcja importuje moduł *name*, potencjalnie używając podanych *globals* i " +"*locals* do określenia, jak interpretować nazwę w kontekście pakietu. " +"*fromlist* podaje nazwy obiektów lub submodułów, które powinny zostać " +"zaimportowane z moduł podanego przez *name*. Standardowa implementacja nie " +"używa *locals* argumentu w ogóle i używa *globals* tylko do określenia " +"kontekstu pakietu :keyword:`import` instrukcja ." + +msgid "" +"*level* specifies whether to use absolute or relative imports. ``0`` (the " +"default) means only perform absolute imports. Positive values for *level* " +"indicate the number of parent directories to search relative to the " +"directory of the module calling :func:`__import__` (see :pep:`328` for the " +"details)." +msgstr "" +"*level* określa, czy ma być używany import bezwzględny czy względny. ``0`` " +"(domyślnie) oznacza tylko import bezwzględny. Dodatnie wartości dla *level* " +"wskazują liczbę katalogów nadrzędnych do przeszukania względem katalogu " +"moduł wywołującego :func:`__import__` (zobacz :pep:`328` dla szczegółów)." + +msgid "" +"When the *name* variable is of the form ``package.module``, normally, the " +"top-level package (the name up till the first dot) is returned, *not* the " +"module named by *name*. However, when a non-empty *fromlist* argument is " +"given, the module named by *name* is returned." +msgstr "" +"Gdy zmienna *name* ma postać ``package.module``, zwykle zwracany jest pakiet " +"najwyższego poziomu (nazwa do pierwszej kropki), *nie* moduł nazwany przez " +"*name*. Jednakże, gdy podana jest niepusta *fromlist* argument, zwracany " +"jest moduł nazwany przez *name*." + +msgid "" +"For example, the statement ``import spam`` results in bytecode resembling " +"the following code::" +msgstr "" +"Na przykład, instrukcja ``import spam`` skutkuje kodem bajtowym " +"przypominającym następujący kod::" + +msgid "spam = __import__('spam', globals(), locals(), [], 0)" +msgstr "spam = __import__('spam', globals(), locals(), [], 0)" + +msgid "The statement ``import spam.ham`` results in this call::" +msgstr "Instrukcja ``import spam.ham`` skutkuje następującym połączeniem::" + +msgid "spam = __import__('spam.ham', globals(), locals(), [], 0)" +msgstr "spam = __import__('spam.ham', globals(), locals(), [], 0)" + +msgid "" +"Note how :func:`__import__` returns the toplevel module here because this is " +"the object that is bound to a name by the :keyword:`import` statement." +msgstr "" +"Zauważ, że :func:`__import__` zwraca toplevel moduł tutaj, ponieważ jest to " +"obiekt, który jest powiązany z nazwą przez :keyword:`import` instrukcje ." + +msgid "" +"On the other hand, the statement ``from spam.ham import eggs, sausage as " +"saus`` results in ::" +msgstr "" +"Z drugiej strony, instrukcja ``from spam.ham import eggs, sausage as saus`` " +"skutkuje ::" + +msgid "" +"_temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], 0)\n" +"eggs = _temp.eggs\n" +"saus = _temp.sausage" +msgstr "" +"_temp = __import__('spam.ham', globals(), locals(), ['eggs', 'sausage'], 0)\n" +"eggs = _temp.eggs\n" +"saus = _temp.sausage" + +msgid "" +"Here, the ``spam.ham`` module is returned from :func:`__import__`. From " +"this object, the names to import are retrieved and assigned to their " +"respective names." +msgstr "" +"Tutaj obiekt ``spam.ham`` jest zwracany z :func:`__import__`. Z tego " +"obiektu pobierane są nazwy do zaimportowania i przypisywane do odpowiednich " +"nazw." + +msgid "" +"If you simply want to import a module (potentially within a package) by " +"name, use :func:`importlib.import_module`." +msgstr "" +"Jeśli chcesz po prostu zaimportować moduł (potencjalnie w ramach pakietu) " +"według nazwy, użyj :func:`importlib.import_module`." + +msgid "" +"Negative values for *level* are no longer supported (which also changes the " +"default value to 0)." +msgstr "" +"Ujemne wartości dla *level* nie są już obsługiwane (co również zmienia " +"wartość domyślny na 0)." + +msgid "" +"When the command line options :option:`-E` or :option:`-I` are being used, " +"the environment variable :envvar:`PYTHONCASEOK` is now ignored." +msgstr "" +"Gdy używane są opcje wiersza poleceń :option:`-E` lub :option:`-I`, opcja " +"zmienna środowiskowa :envvar:`PYTHONCASEOK` jest teraz ignorowana." + +msgid "Footnotes" +msgstr "Przypisy" + +msgid "" +"Note that the parser only accepts the Unix-style end of line convention. If " +"you are reading the code from a file, make sure to use newline conversion " +"mode to convert Windows or Mac-style newlines." +msgstr "" +"Zwróć uwagę, że parser akceptuje tylko Unixowy styl końca linii. Jeśli " +"wczytujesz kod z pliku, wykorzystaj konwersję linii aby przekonwertować " +"style końca linii Winows albo Mac." + +msgid "Boolean" +msgstr "Wartość logiczna" + +msgid "type" +msgstr "typ" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "exec" +msgstr "exec" + +msgid "NaN" +msgstr "NaN" + +msgid "Infinity" +msgstr "Nieskończoność" + +msgid "__format__" +msgstr "__format__" + +msgid "string" +msgstr "ciąg znaków" + +msgid "format() (built-in function)" +msgstr "format() (wbudowana funkcja)" + +msgid "file object" +msgstr "obiekt plik" + +msgid "open() built-in function" +msgstr "open() wbudowana funkcja" + +msgid "file" +msgstr "plik" + +msgid "modes" +msgstr "tryby" + +msgid "universal newlines" +msgstr "uniwersalne nowe linie" + +msgid "line-buffered I/O" +msgstr "Buforowane liniowo I/O" + +msgid "unbuffered I/O" +msgstr "niebuforowane I/O" + +msgid "buffer size, I/O" +msgstr "rozmiar bufora, I/O" + +msgid "I/O control" +msgstr "Kontrola I/O" + +msgid "buffering" +msgstr "buforowanie" + +msgid "text mode" +msgstr "tryb tekstowy" + +msgid "module" +msgstr "moduł" + +msgid "sys" +msgstr "sys" + +msgid "str() (built-in function)" +msgstr "str() (wbudowana funkcja)" + +msgid "object" +msgstr "obiekt" + +msgid "statement" +msgstr "instrukcja" + +msgid "import" +msgstr "import" + +msgid "builtins" +msgstr "builtins" diff --git a/builtins/stdtypes.po b/builtins/stdtypes.po new file mode 100644 index 0000000000..aa9b8035f9 --- /dev/null +++ b/builtins/stdtypes.po @@ -0,0 +1,7501 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Rafael Fontenelle , 2026 +# python-doc bot, 2026 +# Maciej Olko, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2026-09-13 19:06+0000\n" +"Last-Translator: Maciej Olko, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Built-in Types" +msgstr "Wbudowane typy" + +msgid "" +"The following sections describe the standard types that are built into the " +"interpreter." +msgstr "" +"W poniższych sekcjach opisano standardowe typy wbudowane w interpreter." + +msgid "" +"The principal built-in types are numerics, sequences, mappings, classes, " +"instances and exceptions." +msgstr "" +"Głównymi typami wbudowanymi są typy liczbowe, sekwencje, mapowania, klasy, " +"instancje i wyjątki." + +msgid "" +"Some collection classes are mutable. The methods that add, subtract, or " +"rearrange their members in place, and don't return a specific item, never " +"return the collection instance itself but ``None``." +msgstr "" +"Niektóre klasy kolekcji są mutowalne (zmienne). Metody, które dodają, " +"odejmują lub zmieniają kolejność swoich elementów w miejscu, a nie zwracają " +"konkretnego elementu, nigdy nie zwracają instancji kolekcji, lecz ``None``." + +msgid "" +"Some operations are supported by several object types; in particular, " +"practically all objects can be compared for equality, tested for truth " +"value, and converted to a string (with the :func:`repr` function or the " +"slightly different :func:`str` function). The latter function is implicitly " +"used when an object is written by the :func:`print` function." +msgstr "" +"Niektóre operacje są obsługiwane przez kilka typów obiektów; w szczególności " +"praktycznie wszystkie obiekty można porównywać pod kątem równości, sprawdzać " +"ich „prawdziwość” oraz konwertować na ciąg znaków (za pomocą " +"funkcji:func:`repr` lub nieco innej funkcji :func:`str`). Ta ostatnia " +"funkcja jest używana domyślnie, gdy obiekt jest zapisywany za pomocą " +"funkcji :func:`print`." + +msgid "Truth Value Testing" +msgstr "Sprawdzanie wartości logicznej" + +msgid "" +"Any object can be tested for truth value, for use in an :keyword:`if` " +"or :keyword:`while` condition or as operand of the Boolean operations below." +msgstr "" +"Każdy obiekt można poddać testowi „prawdziwości” jego wartości – w celu " +"wykorzystania w warunku typu :keyword:`if` lub :keyword:`while` albo jako " +"operand w poniższych operacjach logicznych." + +msgid "" +"By default, an object is considered true unless its class defines either " +"a :meth:`~object.__bool__` method that returns ``False`` or " +"a :meth:`~object.__len__` method that returns zero, when called with the " +"object. [1]_ Here are most of the built-in objects considered false:" +msgstr "" + +msgid "constants defined to be false: ``None`` and ``False``" +msgstr "stałe zdefiniowane jako fałsz: ``None`` oraz ``False``" + +msgid "" +"zero of any numeric type: ``0``, ``0.0``, ``0j``, ``Decimal(0)``, " +"``Fraction(0, 1)``" +msgstr "" + +msgid "" +"empty sequences and collections: ``''``, ``()``, ``[]``, ``{}``, ``set()``, " +"``range(0)``" +msgstr "" +"puste sekwencje oraz kolekcje: ``''``, ``()``, ``[]``, ``{}``, ``set()``, " +"``range(0)``" + +msgid "" +"Operations and built-in functions that have a Boolean result always return " +"``0`` or ``False`` for false and ``1`` or ``True`` for true, unless " +"otherwise stated. (Important exception: the Boolean operations ``or`` and " +"``and`` always return one of their operands.)" +msgstr "" +"Operacje oraz funkcje wbudowane, których wynikiem jest wartość logiczna, " +"zawsze zwracają ``0`` lub ``False`` dla fałszu oraz ``1`` lub ``True`` dla " +"prawdy, o ile nie zaznaczono inaczej. (Ważny wyjątek: operacje logiczne " +"``or`` oraz ``and`` zawsze zwracają jeden ze swoich operandów.)" + +msgid "Boolean Operations --- :keyword:`!and`, :keyword:`!or`, :keyword:`!not`" +msgstr "" + +msgid "These are the Boolean operations, ordered by ascending priority:" +msgstr "" + +msgid "Operation" +msgstr "" + +msgid "Result" +msgstr "" + +msgid "Notes" +msgstr "Notatki" + +msgid "``x or y``" +msgstr "``x or y``" + +msgid "if *x* is true, then *x*, else *y*" +msgstr "" + +msgid "\\(1)" +msgstr "\\(1)" + +msgid "``x and y``" +msgstr "``x and y``" + +msgid "if *x* is false, then *x*, else *y*" +msgstr "" + +msgid "\\(2)" +msgstr "\\(2)" + +msgid "``not x``" +msgstr "``not x``" + +msgid "if *x* is false, then ``True``, else ``False``" +msgstr "" + +msgid "\\(3)" +msgstr "\\(3)" + +msgid "Notes:" +msgstr "Uwagi:" + +msgid "" +"This is a short-circuit operator, so it only evaluates the second argument " +"if the first one is false." +msgstr "" + +msgid "" +"This is a short-circuit operator, so it only evaluates the second argument " +"if the first one is true." +msgstr "" + +msgid "" +"``not`` has a lower priority than non-Boolean operators, so ``not a == b`` " +"is interpreted as ``not (a == b)``, and ``a == not b`` is a syntax error." +msgstr "" + +msgid "Comparisons" +msgstr "" + +msgid "" +"There are eight comparison operations in Python. They all have the same " +"priority (which is higher than that of the Boolean operations). Comparisons " +"can be chained arbitrarily; for example, ``x < y <= z`` is equivalent to ``x " +"< y and y <= z``, except that *y* is evaluated only once (but in both cases " +"*z* is not evaluated at all when ``x < y`` is found to be false)." +msgstr "" + +msgid "This table summarizes the comparison operations:" +msgstr "" + +msgid "Meaning" +msgstr "Znaczenie" + +msgid "``<``" +msgstr "``<``" + +msgid "strictly less than" +msgstr "" + +msgid "``<=``" +msgstr "``<=``" + +msgid "less than or equal" +msgstr "" + +msgid "``>``" +msgstr "``>``" + +msgid "strictly greater than" +msgstr "" + +msgid "``>=``" +msgstr "``>=``" + +msgid "greater than or equal" +msgstr "" + +msgid "``==``" +msgstr "``==``" + +msgid "equal" +msgstr "" + +msgid "``!=``" +msgstr "``!=``" + +msgid "not equal" +msgstr "" + +msgid "``is``" +msgstr "``is``" + +msgid "object identity" +msgstr "" + +msgid "``is not``" +msgstr "``is not``" + +msgid "negated object identity" +msgstr "" + +msgid "" +"Unless stated otherwise, objects of different types never compare equal. The " +"``==`` operator is always defined but for some object types (for example, " +"class objects) is equivalent to :keyword:`is`. The ``<``, ``<=``, ``>`` and " +"``>=`` operators are only defined where they make sense; for example, they " +"raise a :exc:`TypeError` exception when one of the arguments is a complex " +"number." +msgstr "" + +msgid "" +"Non-identical instances of a class normally compare as non-equal unless the " +"class defines the :meth:`~object.__eq__` method." +msgstr "" + +msgid "" +"Instances of a class cannot be ordered with respect to other instances of " +"the same class, or other types of object, unless the class defines enough of " +"the " +"methods :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__`, " +"and :meth:`~object.__ge__` (in general, :meth:`~object.__lt__` " +"and :meth:`~object.__eq__` are sufficient, if you want the conventional " +"meanings of the comparison operators)." +msgstr "" + +msgid "" +"The behavior of the :keyword:`is` and :keyword:`is not` operators cannot be " +"customized; also they can be applied to any two objects and never raise an " +"exception." +msgstr "" + +msgid "" +"Two more operations with the same syntactic priority, :keyword:`in` " +"and :keyword:`not in`, are supported by types that are :term:`iterable` or " +"implement the :meth:`~object.__contains__` method." +msgstr "" + +msgid "Numeric Types --- :class:`int`, :class:`float`, :class:`complex`" +msgstr "" + +msgid "" +"There are three distinct numeric types: :dfn:`integers`, :dfn:`floating-" +"point numbers`, and :dfn:`complex numbers`. In addition, Booleans are a " +"subtype of integers. Integers have unlimited precision. Floating-point " +"numbers are usually implemented using :c:expr:`double` in C; information " +"about the precision and internal representation of floating-point numbers " +"for the machine on which your program is running is available " +"in :data:`sys.float_info`. Complex numbers have a real and imaginary part, " +"which are each a floating-point number. To extract these parts from a " +"complex number *z*, use ``z.real`` and ``z.imag``. (The standard library " +"includes the additional numeric types :mod:`fractions.Fraction`, for " +"rationals, and :mod:`decimal.Decimal`, for floating-point numbers with user-" +"definable precision.)" +msgstr "" + +msgid "" +"Numbers are created by numeric literals or as the result of built-in " +"functions and operators. Unadorned integer literals (including hex, octal " +"and binary numbers) yield integers. Numeric literals containing a decimal " +"point or an exponent sign yield floating-point numbers. Appending ``'j'`` " +"or ``'J'`` to a numeric literal yields an imaginary number (a complex number " +"with a zero real part) which you can add to an integer or float to get a " +"complex number with real and imaginary parts." +msgstr "" + +msgid "" +"Python fully supports mixed arithmetic: when a binary arithmetic operator " +"has operands of different numeric types, the operand with the \"narrower\" " +"type is widened to that of the other, where integer is narrower than " +"floating point, which is narrower than complex. A comparison between numbers " +"of different types behaves as though the exact values of those numbers were " +"being compared. [2]_" +msgstr "" + +msgid "" +"The constructors :func:`int`, :func:`float`, and :func:`complex` can be used " +"to produce numbers of a specific type." +msgstr "" + +msgid "" +"All numeric types (except complex) support the following operations (for " +"priorities of the operations, see :ref:`operator-summary`):" +msgstr "" + +msgid "Full documentation" +msgstr "" + +msgid "``x + y``" +msgstr "``x + y``" + +msgid "sum of *x* and *y*" +msgstr "" + +msgid "``x - y``" +msgstr "``x - y``" + +msgid "difference of *x* and *y*" +msgstr "" + +msgid "``x * y``" +msgstr "``x * y``" + +msgid "product of *x* and *y*" +msgstr "" + +msgid "``x / y``" +msgstr "``x / y``" + +msgid "quotient of *x* and *y*" +msgstr "" + +msgid "``x // y``" +msgstr "``x // y``" + +msgid "floored quotient of *x* and *y*" +msgstr "" + +msgid "\\(1)\\(2)" +msgstr "" + +msgid "``x % y``" +msgstr "``x % y``" + +msgid "remainder of ``x / y``" +msgstr "" + +msgid "``-x``" +msgstr "``-x``" + +msgid "*x* negated" +msgstr "" + +msgid "``+x``" +msgstr "``+x``" + +msgid "*x* unchanged" +msgstr "" + +msgid "``abs(x)``" +msgstr "``abs(x)``" + +msgid "absolute value or magnitude of *x*" +msgstr "" + +msgid ":func:`abs`" +msgstr ":func:`abs`" + +msgid "``int(x)``" +msgstr "``int(x)``" + +msgid "*x* converted to integer" +msgstr "" + +msgid "\\(3)\\(6)" +msgstr "" + +msgid ":func:`int`" +msgstr ":func:`int`" + +msgid "``float(x)``" +msgstr "``float(x)``" + +msgid "*x* converted to floating point" +msgstr "" + +msgid "\\(4)\\(6)" +msgstr "" + +msgid ":func:`float`" +msgstr ":func:`float`" + +msgid "``complex(re, im)``" +msgstr "``complex(re, im)``" + +msgid "" +"a complex number with real part *re*, imaginary part *im*. *im* defaults to " +"zero." +msgstr "" + +msgid "\\(6)" +msgstr "\\(6)" + +msgid ":func:`complex`" +msgstr ":func:`complex`" + +msgid "``c.conjugate()``" +msgstr "``c.conjugate()``" + +msgid "conjugate of the complex number *c*" +msgstr "" + +msgid "``divmod(x, y)``" +msgstr "``divmod(x, y)``" + +msgid "the pair ``(x // y, x % y)``" +msgstr "" + +msgid ":func:`divmod`" +msgstr ":func:`divmod`" + +msgid "``pow(x, y)``" +msgstr "``pow(x, y)``" + +msgid "*x* to the power *y*" +msgstr "" + +msgid "\\(5)" +msgstr "\\(5)" + +msgid ":func:`pow`" +msgstr ":func:`pow`" + +msgid "``x ** y``" +msgstr "``x ** y``" + +msgid "" +"Also referred to as integer division. For operands of type :class:`int`, " +"the result has type :class:`int`. For operands of type :class:`float`, the " +"result has type :class:`float`. In general, the result is a whole integer, " +"though the result's type is not necessarily :class:`int`. The result is " +"always rounded towards minus infinity: ``1//2`` is ``0``, ``(-1)//2`` is " +"``-1``, ``1//(-2)`` is ``-1``, and ``(-1)//(-2)`` is ``0``." +msgstr "" + +msgid "" +"Not for complex numbers. Instead convert to floats using :func:`abs` if " +"appropriate." +msgstr "" + +msgid "" +"Conversion from :class:`float` to :class:`int` truncates, discarding the " +"fractional part. See functions :func:`math.floor` and :func:`math.ceil` for " +"alternative conversions." +msgstr "" + +msgid "" +"float also accepts the strings \"nan\" and \"inf\" with an optional prefix " +"\"+\" or \"-\" for Not a Number (NaN) and positive or negative infinity." +msgstr "" + +msgid "" +"Python defines ``pow(0, 0)`` and ``0 ** 0`` to be ``1``, as is common for " +"programming languages." +msgstr "" + +msgid "" +"The numeric literals accepted include the digits ``0`` to ``9`` or any " +"Unicode equivalent (code points with the ``Nd`` property)." +msgstr "" + +msgid "" +"See `the Unicode Standard `_ for a complete list of code points with the ``Nd`` " +"property." +msgstr "" + +msgid "" +"All :class:`numbers.Real` types (:class:`int` and :class:`float`) also " +"include the following operations:" +msgstr "" + +msgid ":func:`math.trunc(\\ x) `" +msgstr ":func:`math.trunc(\\ x) `" + +msgid "*x* truncated to :class:`~numbers.Integral`" +msgstr "" + +msgid ":func:`round(x[, n]) `" +msgstr ":func:`round(x[, n]) `" + +msgid "" +"*x* rounded to *n* digits, rounding half to even. If *n* is omitted, it " +"defaults to 0." +msgstr "" + +msgid ":func:`math.floor(\\ x) `" +msgstr ":func:`math.floor(\\ x) `" + +msgid "the greatest :class:`~numbers.Integral` <= *x*" +msgstr "" + +msgid ":func:`math.ceil(x) `" +msgstr "" + +msgid "the least :class:`~numbers.Integral` >= *x*" +msgstr "" + +msgid "" +"For additional numeric operations see the :mod:`math` and :mod:`cmath` " +"modules." +msgstr "" + +msgid "Bitwise Operations on Integer Types" +msgstr "" + +msgid "" +"Bitwise operations only make sense for integers. The result of bitwise " +"operations is calculated as though carried out in two's complement with an " +"infinite number of sign bits." +msgstr "" + +msgid "" +"The priorities of the binary bitwise operations are all lower than the " +"numeric operations and higher than the comparisons; the unary operation " +"``~`` has the same priority as the other unary numeric operations (``+`` and " +"``-``)." +msgstr "" + +msgid "This table lists the bitwise operations sorted in ascending priority:" +msgstr "" + +msgid "``x | y``" +msgstr "``x | y``" + +msgid "bitwise :dfn:`or` of *x* and *y*" +msgstr "" + +msgid "\\(4)" +msgstr "\\(4)" + +msgid "``x ^ y``" +msgstr "``x ^ y``" + +msgid "bitwise :dfn:`exclusive or` of *x* and *y*" +msgstr "" + +msgid "``x & y``" +msgstr "``x & y``" + +msgid "bitwise :dfn:`and` of *x* and *y*" +msgstr "" + +msgid "``x << n``" +msgstr "``x << n``" + +msgid "*x* shifted left by *n* bits" +msgstr "" + +msgid "(1)(2)" +msgstr "(1)(2)" + +msgid "``x >> n``" +msgstr "``x >> n``" + +msgid "*x* shifted right by *n* bits" +msgstr "" + +msgid "(1)(3)" +msgstr "" + +msgid "``~x``" +msgstr "``~x``" + +msgid "the bits of *x* inverted" +msgstr "" + +msgid "" +"Negative shift counts are illegal and cause a :exc:`ValueError` to be raised." +msgstr "" + +msgid "" +"A left shift by *n* bits is equivalent to multiplication by ``pow(2, n)``." +msgstr "" + +msgid "" +"A right shift by *n* bits is equivalent to floor division by ``pow(2, n)``." +msgstr "" + +msgid "" +"Performing these calculations with at least one extra sign extension bit in " +"a finite two's complement representation (a working bit-width of ``1 + " +"max(x.bit_length(), y.bit_length())`` or more) is sufficient to get the same " +"result as if there were an infinite number of sign bits." +msgstr "" + +msgid "Additional Methods on Integer Types" +msgstr "" + +msgid "" +"The int type implements the :class:`numbers.Integral` :term:`abstract base " +"class`. In addition, it provides a few more methods:" +msgstr "" + +msgid "" +"Return the number of bits necessary to represent an integer in binary, " +"excluding the sign and leading zeros::" +msgstr "" + +msgid "" +">>> n = -37\n" +">>> bin(n)\n" +"'-0b100101'\n" +">>> n.bit_length()\n" +"6" +msgstr "" +">>> n = -37\n" +">>> bin(n)\n" +"'-0b100101'\n" +">>> n.bit_length()\n" +"6" + +msgid "" +"More precisely, if ``x`` is nonzero, then ``x.bit_length()`` is the unique " +"positive integer ``k`` such that ``2**(k-1) <= abs(x) < 2**k``. " +"Equivalently, when ``abs(x)`` is small enough to have a correctly rounded " +"logarithm, then ``k = 1 + int(log(abs(x), 2))``. If ``x`` is zero, then " +"``x.bit_length()`` returns ``0``." +msgstr "" + +msgid "Equivalent to::" +msgstr "Odpowiednik::" + +msgid "" +"def bit_length(self):\n" +" s = bin(self) # binary representation: bin(-37) --> '-0b100101'\n" +" s = s.lstrip('-0b') # remove leading zeros and minus sign\n" +" return len(s) # len('100101') --> 6" +msgstr "" + +msgid "" +"Return the number of ones in the binary representation of the absolute value " +"of the integer. This is also known as the population count. Example::" +msgstr "" + +msgid "" +">>> n = 19\n" +">>> bin(n)\n" +"'0b10011'\n" +">>> n.bit_count()\n" +"3\n" +">>> (-n).bit_count()\n" +"3" +msgstr "" +">>> n = 19\n" +">>> bin(n)\n" +"'0b10011'\n" +">>> n.bit_count()\n" +"3\n" +">>> (-n).bit_count()\n" +"3" + +msgid "" +"def bit_count(self):\n" +" return bin(self).count(\"1\")" +msgstr "" + +msgid "Return an array of bytes representing an integer." +msgstr "" + +msgid "" +"The integer is represented using *length* bytes, and defaults to 1. " +"An :exc:`OverflowError` is raised if the integer is not representable with " +"the given number of bytes." +msgstr "" + +msgid "" +"The *byteorder* argument determines the byte order used to represent the " +"integer, and defaults to ``\"big\"``. If *byteorder* is ``\"big\"``, the " +"most significant byte is at the beginning of the byte array. If *byteorder* " +"is ``\"little\"``, the most significant byte is at the end of the byte array." +msgstr "" + +msgid "" +"The *signed* argument determines whether two's complement is used to " +"represent the integer. If *signed* is ``False`` and a negative integer is " +"given, an :exc:`OverflowError` is raised. The default value for *signed* is " +"``False``." +msgstr "" + +msgid "" +"The default values can be used to conveniently turn an integer into a single " +"byte object::" +msgstr "" + +msgid "" +">>> (65).to_bytes()\n" +"b'A'" +msgstr "" +">>> (65).to_bytes()\n" +"b'A'" + +msgid "" +"However, when using the default arguments, don't try to convert a value " +"greater than 255 or you'll get an :exc:`OverflowError`." +msgstr "" + +msgid "" +"def to_bytes(n, length=1, byteorder='big', signed=False):\n" +" if byteorder == 'little':\n" +" order = range(length)\n" +" elif byteorder == 'big':\n" +" order = reversed(range(length))\n" +" else:\n" +" raise ValueError(\"byteorder must be either 'little' or 'big'\")\n" +"\n" +" return bytes((n >> i*8) & 0xff for i in order)" +msgstr "" + +msgid "Added default argument values for ``length`` and ``byteorder``." +msgstr "" + +msgid "Return the integer represented by the given array of bytes." +msgstr "" + +msgid "" +"The argument *bytes* must either be a :term:`bytes-like object` or an " +"iterable producing bytes." +msgstr "" + +msgid "" +"The *byteorder* argument determines the byte order used to represent the " +"integer, and defaults to ``\"big\"``. If *byteorder* is ``\"big\"``, the " +"most significant byte is at the beginning of the byte array. If *byteorder* " +"is ``\"little\"``, the most significant byte is at the end of the byte " +"array. To request the native byte order of the host system, " +"use :data:`sys.byteorder` as the byte order value." +msgstr "" + +msgid "" +"The *signed* argument indicates whether two's complement is used to " +"represent the integer." +msgstr "" + +msgid "" +"def from_bytes(bytes, byteorder='big', signed=False):\n" +" if byteorder == 'little':\n" +" little_ordered = list(bytes)\n" +" elif byteorder == 'big':\n" +" little_ordered = list(reversed(bytes))\n" +" else:\n" +" raise ValueError(\"byteorder must be either 'little' or 'big'\")\n" +"\n" +" n = sum(b << i*8 for i, b in enumerate(little_ordered))\n" +" if signed and little_ordered and (little_ordered[-1] & 0x80):\n" +" n -= 1 << 8*len(little_ordered)\n" +"\n" +" return n" +msgstr "" + +msgid "Added default argument value for ``byteorder``." +msgstr "" + +msgid "" +"Return a pair of integers whose ratio is equal to the original integer and " +"has a positive denominator. The integer ratio of integers (whole numbers) " +"is always the integer as the numerator and ``1`` as the denominator." +msgstr "" + +msgid "" +"Returns ``True``. Exists for duck type compatibility " +"with :meth:`float.is_integer`." +msgstr "" + +msgid "Additional Methods on Float" +msgstr "" + +msgid "" +"The float type implements the :class:`numbers.Real` :term:`abstract base " +"class`. float also has the following additional methods." +msgstr "" + +msgid "" +"Return a pair of integers whose ratio is exactly equal to the original " +"float. The ratio is in lowest terms and has a positive denominator. " +"Raises :exc:`OverflowError` on infinities and a :exc:`ValueError` on NaNs." +msgstr "" + +msgid "" +"Return ``True`` if the float instance is finite with integral value, and " +"``False`` otherwise::" +msgstr "" + +msgid "" +">>> (-2.0).is_integer()\n" +"True\n" +">>> (3.2).is_integer()\n" +"False" +msgstr "" +">>> (-2.0).is_integer()\n" +"True\n" +">>> (3.2).is_integer()\n" +"False" + +msgid "" +"Two methods support conversion to and from hexadecimal strings. Since " +"Python's floats are stored internally as binary numbers, converting a float " +"to or from a *decimal* string usually involves a small rounding error. In " +"contrast, hexadecimal strings allow exact representation and specification " +"of floating-point numbers. This can be useful when debugging, and in " +"numerical work." +msgstr "" + +msgid "" +"Return a representation of a floating-point number as a hexadecimal string. " +"For finite floating-point numbers, this representation will always include a " +"leading ``0x`` and a trailing ``p`` and exponent." +msgstr "" + +msgid "" +"Class method to return the float represented by a hexadecimal string *s*. " +"The string *s* may have leading and trailing whitespace." +msgstr "" + +msgid "" +"Note that :meth:`float.hex` is an instance method, " +"while :meth:`float.fromhex` is a class method." +msgstr "" + +msgid "A hexadecimal string takes the form::" +msgstr "" + +msgid "[sign] ['0x'] integer ['.' fraction] ['p' exponent]" +msgstr "" + +msgid "" +"where the optional ``sign`` may be either ``+`` or ``-``, ``integer`` and " +"``fraction`` are strings of hexadecimal digits, and ``exponent`` is a " +"decimal integer with an optional leading sign. Case is not significant, and " +"there must be at least one hexadecimal digit in either the integer or the " +"fraction. This syntax is similar to the syntax specified in section 6.4.4.2 " +"of the C99 standard, and also to the syntax used in Java 1.5 onwards. In " +"particular, the output of :meth:`float.hex` is usable as a hexadecimal " +"floating-point literal in C or Java code, and hexadecimal strings produced " +"by C's ``%a`` format character or Java's ``Double.toHexString`` are accepted " +"by :meth:`float.fromhex`." +msgstr "" + +msgid "" +"Note that the exponent is written in decimal rather than hexadecimal, and " +"that it gives the power of 2 by which to multiply the coefficient. For " +"example, the hexadecimal string ``0x3.a7p10`` represents the floating-point " +"number ``(3 + 10./16 + 7./16**2) * 2.0**10``, or ``3740.0``::" +msgstr "" + +msgid "" +">>> float.fromhex('0x3.a7p10')\n" +"3740.0" +msgstr "" +">>> float.fromhex('0x3.a7p10')\n" +"3740.0" + +msgid "" +"Applying the reverse conversion to ``3740.0`` gives a different hexadecimal " +"string representing the same number::" +msgstr "" + +msgid "" +">>> float.hex(3740.0)\n" +"'0x1.d380000000000p+11'" +msgstr "" +">>> float.hex(3740.0)\n" +"'0x1.d380000000000p+11'" + +msgid "Hashing of numeric types" +msgstr "" + +msgid "" +"For numbers ``x`` and ``y``, possibly of different types, it's a requirement " +"that ``hash(x) == hash(y)`` whenever ``x == y`` (see " +"the :meth:`~object.__hash__` method documentation for more details). For " +"ease of implementation and efficiency across a variety of numeric types " +"(including :class:`int`, :class:`float`, :class:`decimal.Decimal` " +"and :class:`fractions.Fraction`) Python's hash for numeric types is based on " +"a single mathematical function that's defined for any rational number, and " +"hence applies to all instances of :class:`int` " +"and :class:`fractions.Fraction`, and all finite instances of :class:`float` " +"and :class:`decimal.Decimal`. Essentially, this function is given by " +"reduction modulo ``P`` for a fixed prime ``P``. The value of ``P`` is made " +"available to Python as the :attr:`~sys.hash_info.modulus` attribute " +"of :data:`sys.hash_info`." +msgstr "" + +msgid "" +"Currently, the prime used is ``P = 2**31 - 1`` on machines with 32-bit C " +"longs and ``P = 2**61 - 1`` on machines with 64-bit C longs." +msgstr "" + +msgid "Here are the rules in detail:" +msgstr "" + +msgid "" +"If ``x = m / n`` is a nonnegative rational number and ``n`` is not divisible " +"by ``P``, define ``hash(x)`` as ``m * invmod(n, P) % P``, where ``invmod(n, " +"P)`` gives the inverse of ``n`` modulo ``P``." +msgstr "" + +msgid "" +"If ``x = m / n`` is a nonnegative rational number and ``n`` is divisible by " +"``P`` (but ``m`` is not) then ``n`` has no inverse modulo ``P`` and the rule " +"above doesn't apply; in this case define ``hash(x)`` to be the constant " +"value ``sys.hash_info.inf``." +msgstr "" + +msgid "" +"If ``x = m / n`` is a negative rational number define ``hash(x)`` as ``-" +"hash(-x)``. If the resulting hash is ``-1``, replace it with ``-2``." +msgstr "" + +msgid "" +"The particular values ``sys.hash_info.inf`` and ``-sys.hash_info.inf`` are " +"used as hash values for positive infinity or negative infinity " +"(respectively)." +msgstr "" + +msgid "" +"For a :class:`complex` number ``z``, the hash values of the real and " +"imaginary parts are combined by computing ``hash(z.real) + " +"sys.hash_info.imag * hash(z.imag)``, reduced modulo " +"``2**sys.hash_info.width`` so that it lies in " +"``range(-2**(sys.hash_info.width - 1), 2**(sys.hash_info.width - 1))``. " +"Again, if the result is ``-1``, it's replaced with ``-2``." +msgstr "" + +msgid "" +"To clarify the above rules, here's some example Python code, equivalent to " +"the built-in hash, for computing the hash of a rational " +"number, :class:`float`, or :class:`complex`::" +msgstr "" + +msgid "" +"import sys, math\n" +"\n" +"def hash_fraction(m, n):\n" +" \"\"\"Compute the hash of a rational number m / n.\n" +"\n" +" Assumes m and n are integers, with n positive.\n" +" Equivalent to hash(fractions.Fraction(m, n)).\n" +"\n" +" \"\"\"\n" +" P = sys.hash_info.modulus\n" +" # Remove common factors of P. (Unnecessary if m and n already " +"coprime.)\n" +" while m % P == n % P == 0:\n" +" m, n = m // P, n // P\n" +"\n" +" if n % P == 0:\n" +" hash_value = sys.hash_info.inf\n" +" else:\n" +" # Fermat's Little Theorem: pow(n, P-1, P) is 1, so\n" +" # pow(n, P-2, P) gives the inverse of n modulo P.\n" +" hash_value = (abs(m) % P) * pow(n, P - 2, P) % P\n" +" if m < 0:\n" +" hash_value = -hash_value\n" +" if hash_value == -1:\n" +" hash_value = -2\n" +" return hash_value\n" +"\n" +"def hash_float(x):\n" +" \"\"\"Compute the hash of a float x.\"\"\"\n" +"\n" +" if math.isnan(x):\n" +" return object.__hash__(x)\n" +" elif math.isinf(x):\n" +" return sys.hash_info.inf if x > 0 else -sys.hash_info.inf\n" +" else:\n" +" return hash_fraction(*x.as_integer_ratio())\n" +"\n" +"def hash_complex(z):\n" +" \"\"\"Compute the hash of a complex number z.\"\"\"\n" +"\n" +" hash_value = hash_float(z.real) + sys.hash_info.imag * " +"hash_float(z.imag)\n" +" # do a signed reduction modulo 2**sys.hash_info.width\n" +" M = 2**(sys.hash_info.width - 1)\n" +" hash_value = (hash_value & (M - 1)) - (hash_value & M)\n" +" if hash_value == -1:\n" +" hash_value = -2\n" +" return hash_value" +msgstr "" + +msgid "Boolean Type - :class:`bool`" +msgstr "" + +msgid "" +"Booleans represent truth values. The :class:`bool` type has exactly two " +"constant instances: ``True`` and ``False``." +msgstr "" + +msgid "" +"The built-in function :func:`bool` converts any value to a boolean, if the " +"value can be interpreted as a truth value (see section :ref:`truth` above)." +msgstr "" + +msgid "" +"For logical operations, use the :ref:`boolean operators ` ``and``, " +"``or`` and ``not``. When applying the bitwise operators ``&``, ``|``, ``^`` " +"to two booleans, they return a bool equivalent to the logical operations " +"\"and\", \"or\", \"xor\". However, the logical operators ``and``, ``or`` and " +"``!=`` should be preferred over ``&``, ``|`` and ``^``." +msgstr "" + +msgid "" +"The use of the bitwise inversion operator ``~`` is deprecated and will raise " +"an error in Python 3.16." +msgstr "" + +msgid "" +":class:`bool` is a subclass of :class:`int` (see :ref:`typesnumeric`). In " +"many numeric contexts, ``False`` and ``True`` behave like the integers 0 and " +"1, respectively. However, relying on this is discouraged; explicitly convert " +"using :func:`int` instead." +msgstr "" + +msgid "Iterator Types" +msgstr "" + +msgid "" +"Python supports a concept of iteration over containers. This is implemented " +"using two distinct methods; these are used to allow user-defined classes to " +"support iteration. Sequences, described below in more detail, always " +"support the iteration methods." +msgstr "" + +msgid "" +"One method needs to be defined for container objects to " +"provide :term:`iterable` support:" +msgstr "" + +msgid "" +"Return an :term:`iterator` object. The object is required to support the " +"iterator protocol described below. If a container supports different types " +"of iteration, additional methods can be provided to specifically request " +"iterators for those iteration types. (An example of an object supporting " +"multiple forms of iteration would be a tree structure which supports both " +"breadth-first and depth-first traversal.) This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iter` slot of the type structure for Python " +"objects in the Python/C API." +msgstr "" + +msgid "" +"The iterator objects themselves are required to support the following two " +"methods, which together form the :dfn:`iterator protocol`:" +msgstr "" + +msgid "" +"Return the :term:`iterator` object itself. This is required to allow both " +"containers and iterators to be used with the :keyword:`for` " +"and :keyword:`in` statements. This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iter` slot of the type structure for Python " +"objects in the Python/C API." +msgstr "" + +msgid "" +"Return the next item from the :term:`iterator`. If there are no further " +"items, raise the :exc:`StopIteration` exception. This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iternext` slot of the type structure for " +"Python objects in the Python/C API." +msgstr "" + +msgid "" +"Python defines several iterator objects to support iteration over general " +"and specific sequence types, dictionaries, and other more specialized " +"forms. The specific types are not important beyond their implementation of " +"the iterator protocol." +msgstr "" + +msgid "" +"Once an iterator's :meth:`~iterator.__next__` method " +"raises :exc:`StopIteration`, it must continue to do so on subsequent calls. " +"Implementations that do not obey this property are deemed broken." +msgstr "" + +msgid "Generator Types" +msgstr "" + +msgid "" +"Python's :term:`generator`\\s provide a convenient way to implement the " +"iterator protocol. If a container object's :meth:`~object.__iter__` method " +"is implemented as a generator, it will automatically return an iterator " +"object (technically, a generator object) supplying " +"the :meth:`~iterator.__iter__` and :meth:`~generator.__next__` methods. More " +"information about generators can be found in :ref:`the documentation for the " +"yield expression `." +msgstr "" + +msgid "Sequence Types --- :class:`list`, :class:`tuple`, :class:`range`" +msgstr "" + +msgid "" +"There are three basic sequence types: lists, tuples, and range objects. " +"Additional sequence types tailored for processing of :ref:`binary data " +"` and :ref:`text strings ` are described in dedicated " +"sections." +msgstr "" + +msgid "Common Sequence Operations" +msgstr "" + +msgid "" +"The operations in the following table are supported by most sequence types, " +"both mutable and immutable. The :class:`collections.abc.Sequence` ABC is " +"provided to make it easier to correctly implement these operations on custom " +"sequence types." +msgstr "" + +msgid "" +"This table lists the sequence operations sorted in ascending priority. In " +"the table, *s* and *t* are sequences of the same type, *n*, *i*, *j* and *k* " +"are integers and *x* is an arbitrary object that meets any type and value " +"restrictions imposed by *s*." +msgstr "" + +msgid "" +"The ``in`` and ``not in`` operations have the same priorities as the " +"comparison operations. The ``+`` (concatenation) and ``*`` (repetition) " +"operations have the same priority as the corresponding numeric operations. " +"[3]_" +msgstr "" + +msgid "``x in s``" +msgstr "``x in s``" + +msgid "``True`` if an item of *s* is equal to *x*, else ``False``" +msgstr "" + +msgid "``x not in s``" +msgstr "" + +msgid "``False`` if an item of *s* is equal to *x*, else ``True``" +msgstr "" + +msgid "``s + t``" +msgstr "``s + t``" + +msgid "the concatenation of *s* and *t*" +msgstr "" + +msgid "(6)(7)" +msgstr "" + +msgid "``s * n`` or ``n * s``" +msgstr "" + +msgid "equivalent to adding *s* to itself *n* times" +msgstr "" + +msgid "(2)(7)" +msgstr "" + +msgid "``s[i]``" +msgstr "``s[i]``" + +msgid "*i*\\ th item of *s*, origin 0" +msgstr "" + +msgid "(3)(8)" +msgstr "" + +msgid "``s[i:j]``" +msgstr "``s[i:j]``" + +msgid "slice of *s* from *i* to *j*" +msgstr "" + +msgid "(3)(4)" +msgstr "" + +msgid "``s[i:j:k]``" +msgstr "``s[i:j:k]``" + +msgid "slice of *s* from *i* to *j* with step *k*" +msgstr "" + +msgid "(3)(5)" +msgstr "" + +msgid "``len(s)``" +msgstr "``len(s)``" + +msgid "length of *s*" +msgstr "" + +msgid "``min(s)``" +msgstr "``min(s)``" + +msgid "smallest item of *s*" +msgstr "" + +msgid "``max(s)``" +msgstr "``max(s)``" + +msgid "largest item of *s*" +msgstr "" + +msgid "" +"Sequences of the same type also support comparisons. In particular, tuples " +"and lists are compared lexicographically by comparing corresponding " +"elements. This means that to compare equal, every element must compare equal " +"and the two sequences must be of the same type and have the same length. " +"(For full details see :ref:`comparisons` in the language reference.)" +msgstr "" + +msgid "" +"Forward and reversed iterators over mutable sequences access values using an " +"index. That index will continue to march forward (or backward) even if the " +"underlying sequence is mutated. The iterator terminates only when " +"an :exc:`IndexError` or a :exc:`StopIteration` is encountered (or when the " +"index drops below zero)." +msgstr "" + +msgid "" +"While the ``in`` and ``not in`` operations are used only for simple " +"containment testing in the general case, some specialised sequences (such " +"as :class:`str`, :class:`bytes` and :class:`bytearray`) also use them for " +"subsequence testing::" +msgstr "" + +msgid "" +">>> \"gg\" in \"eggs\"\n" +"True" +msgstr "" +">>> \"gg\" in \"eggs\"\n" +"True" + +msgid "" +"Values of *n* less than ``0`` are treated as ``0`` (which yields an empty " +"sequence of the same type as *s*). Note that items in the sequence *s* are " +"not copied; they are referenced multiple times. This often haunts new " +"Python programmers; consider::" +msgstr "" + +msgid "" +">>> lists = [[]] * 3\n" +">>> lists\n" +"[[], [], []]\n" +">>> lists[0].append(3)\n" +">>> lists\n" +"[[3], [3], [3]]" +msgstr "" + +msgid "" +"What has happened is that ``[[]]`` is a one-element list containing an empty " +"list, so all three elements of ``[[]] * 3`` are references to this single " +"empty list. Modifying any of the elements of ``lists`` modifies this single " +"list. You can create a list of different lists this way::" +msgstr "" + +msgid "" +">>> lists = [[] for i in range(3)]\n" +">>> lists[0].append(3)\n" +">>> lists[1].append(5)\n" +">>> lists[2].append(7)\n" +">>> lists\n" +"[[3], [5], [7]]" +msgstr "" + +msgid "" +"Further explanation is available in the FAQ entry :ref:`faq-multidimensional-" +"list`." +msgstr "" + +msgid "" +"If *i* or *j* is negative, the index is relative to the end of sequence *s*: " +"``len(s) + i`` or ``len(s) + j`` is substituted. But note that ``-0`` is " +"still ``0``." +msgstr "" + +msgid "" +"The slice of *s* from *i* to *j* is defined as the sequence of items with " +"index *k* such that ``i <= k < j``." +msgstr "" + +msgid "If *i* is omitted or ``None``, use ``0``." +msgstr "" + +msgid "If *j* is omitted or ``None``, use ``len(s)``." +msgstr "" + +msgid "If *i* or *j* is less than ``-len(s)``, use ``0``." +msgstr "" + +msgid "If *i* or *j* is greater than ``len(s)``, use ``len(s)``." +msgstr "" + +msgid "If *i* is greater than or equal to *j*, the slice is empty." +msgstr "" + +msgid "" +"The slice of *s* from *i* to *j* with step *k* is defined as the sequence of " +"items with index ``x = i + n*k`` such that ``0 <= n < (j-i)/k``. In other " +"words, the indices are ``i``, ``i+k``, ``i+2*k``, ``i+3*k`` and so on, " +"stopping when *j* is reached (but never including *j*). When *k* is " +"positive, *i* and *j* are reduced to ``len(s)`` if they are greater. When " +"*k* is negative, *i* and *j* are reduced to ``len(s) - 1`` if they are " +"greater. If *i* or *j* are omitted or ``None``, they become \"end\" values " +"(which end depends on the sign of *k*). Note, *k* cannot be zero. If *k* is " +"``None``, it is treated like ``1``." +msgstr "" + +msgid "" +"Concatenating immutable sequences always results in a new object. This " +"means that building up a sequence by repeated concatenation will have a " +"quadratic runtime cost in the total sequence length. To get a linear " +"runtime cost, you must switch to one of the alternatives below:" +msgstr "" + +msgid "" +"if concatenating :class:`str` objects, you can build a list and " +"use :meth:`str.join` at the end or else write to an :class:`io.StringIO` " +"instance and retrieve its value when complete" +msgstr "" + +msgid "" +"if concatenating :class:`bytes` objects, you can similarly " +"use :meth:`bytes.join` or :class:`io.BytesIO`, or you can do in-place " +"concatenation with a :class:`bytearray` object. :class:`bytearray` objects " +"are mutable and have an efficient overallocation mechanism" +msgstr "" + +msgid "if concatenating :class:`tuple` objects, extend a :class:`list` instead" +msgstr "" + +msgid "for other types, investigate the relevant class documentation" +msgstr "" + +msgid "" +"Some sequence types (such as :class:`range`) only support item sequences " +"that follow specific patterns, and hence don't support sequence " +"concatenation or repetition." +msgstr "" + +msgid "An :exc:`IndexError` is raised if *i* is outside the sequence range." +msgstr "" + +msgid "Sequence Methods" +msgstr "" + +msgid "Sequence types also support the following methods:" +msgstr "" + +msgid "Return the total number of occurrences of *value* in *sequence*." +msgstr "" + +msgid "Return the index of the first occurrence of *value* in *sequence*." +msgstr "" + +msgid "Raises :exc:`ValueError` if *value* is not found in *sequence*." +msgstr "" + +msgid "" +"The *start* or *stop* arguments allow for efficient searching of subsections " +"of the sequence, beginning at *start* and ending at *stop*. This is roughly " +"equivalent to ``start + sequence[start:stop].index(value)``, only without " +"copying any data." +msgstr "" + +msgid "" +"Not all sequence types support passing the *start* and *stop* arguments." +msgstr "" + +msgid "Immutable Sequence Types" +msgstr "" + +msgid "" +"The only operation that immutable sequence types generally implement that is " +"not also implemented by mutable sequence types is support for " +"the :func:`hash` built-in." +msgstr "" + +msgid "" +"This support allows immutable sequences, such as :class:`tuple` instances, " +"to be used as :class:`dict` keys and stored in :class:`set` " +"and :class:`frozenset` instances." +msgstr "" + +msgid "" +"Attempting to hash an immutable sequence that contains unhashable values " +"will result in :exc:`TypeError`." +msgstr "" + +msgid "Mutable Sequence Types" +msgstr "" + +msgid "" +"The operations in the following table are defined on mutable sequence types. " +"The :class:`collections.abc.MutableSequence` ABC is provided to make it " +"easier to correctly implement these operations on custom sequence types." +msgstr "" + +msgid "" +"In the table *s* is an instance of a mutable sequence type, *t* is any " +"iterable object and *x* is an arbitrary object that meets any type and value " +"restrictions imposed by *s* (for example, :class:`bytearray` only accepts " +"integers that meet the value restriction ``0 <= x <= 255``)." +msgstr "" + +msgid "``s[i] = x``" +msgstr "``s[i] = x``" + +msgid "item *i* of *s* is replaced by *x*" +msgstr "" + +msgid "``del s[i]``" +msgstr "``del s[i]``" + +msgid "removes item *i* of *s*" +msgstr "" + +msgid "``s[i:j] = t``" +msgstr "``s[i:j] = t``" + +msgid "" +"slice of *s* from *i* to *j* is replaced by the contents of the iterable *t*" +msgstr "" + +msgid "``del s[i:j]``" +msgstr "``del s[i:j]``" + +msgid "" +"removes the elements of ``s[i:j]`` from the list (same as ``s[i:j] = []``)" +msgstr "" + +msgid "``s[i:j:k] = t``" +msgstr "``s[i:j:k] = t``" + +msgid "the elements of ``s[i:j:k]`` are replaced by those of *t*" +msgstr "" + +msgid "``del s[i:j:k]``" +msgstr "``del s[i:j:k]``" + +msgid "removes the elements of ``s[i:j:k]`` from the list" +msgstr "" + +msgid "``s += t``" +msgstr "" + +msgid "" +"extends *s* with the contents of *t* (for the most part the same as " +"``s[len(s):len(s)] = t``)" +msgstr "" + +msgid "``s *= n``" +msgstr "``s *= n``" + +msgid "updates *s* with its contents repeated *n* times" +msgstr "" + +msgid "" +"If *k* is not equal to ``1``, *t* must have the same length as the slice it " +"is replacing." +msgstr "" + +msgid "" +"The value *n* is an integer, or an object " +"implementing :meth:`~object.__index__`. Zero and negative values of *n* " +"clear the sequence. Items in the sequence are not copied; they are " +"referenced multiple times, as explained for ``s * n`` under :ref:`typesseq-" +"common`." +msgstr "" + +msgid "Mutable Sequence Methods" +msgstr "" + +msgid "Mutable sequence types also support the following methods:" +msgstr "" + +msgid "" +"Append *value* to the end of the sequence. This is equivalent to writing " +"``seq[len(seq):len(seq)] = [value]``." +msgstr "" + +msgid "" +"Remove all items from *sequence*. This is equivalent to writing ``del " +"sequence[:]``." +msgstr "" + +msgid "" +"Create a shallow copy of *sequence*. This is equivalent to writing " +"``sequence[:]``." +msgstr "" + +msgid "" +"The :meth:`!copy` method is not part of " +"the :class:`~collections.abc.MutableSequence` :class:`~abc.ABC`, but most " +"concrete mutable sequence types provide it." +msgstr "" + +msgid "" +"Extend *sequence* with the contents of *iterable*. For the most part, this " +"is the same as writing ``seq[len(seq):len(seq)] = iterable``." +msgstr "" + +msgid "" +"Insert *value* into *sequence* at the given *index*. This is equivalent to " +"writing ``sequence[index:index] = [value]``." +msgstr "" + +msgid "" +"Retrieve the item at *index* and also remove it from *sequence*. By default, " +"the last item in *sequence* is removed and returned." +msgstr "" + +msgid "Remove the first item from *sequence* where ``sequence[i] == value``." +msgstr "" + +msgid "" +"Reverse the items of *sequence* in place. This method maintains economy of " +"space when reversing a large sequence. To remind users that it operates by " +"side-effect, it returns ``None``." +msgstr "" + +msgid "Lists" +msgstr "Listy" + +msgid "" +"Lists are mutable sequences, typically used to store collections of " +"homogeneous items (where the precise degree of similarity will vary by " +"application)." +msgstr "" + +msgid "Lists may be constructed in several ways:" +msgstr "" + +msgid "Using a pair of square brackets to denote the empty list: ``[]``" +msgstr "" + +msgid "" +"Using square brackets, separating items with commas: ``[a]``, ``[a, b, c]``" +msgstr "" + +msgid "Using a list comprehension: ``[x for x in iterable]``" +msgstr "" + +msgid "Using the type constructor: ``list()`` or ``list(iterable)``" +msgstr "" + +msgid "" +"The constructor builds a list whose items are the same and in the same order " +"as *iterable*'s items. *iterable* may be either a sequence, a container " +"that supports iteration, or an iterator object. If *iterable* is already a " +"list, a copy is made and returned, similar to ``iterable[:]``. For example, " +"``list('abc')`` returns ``['a', 'b', 'c']`` and ``list( (1, 2, 3) )`` " +"returns ``[1, 2, 3]``. If no argument is given, the constructor creates a " +"new empty list, ``[]``." +msgstr "" + +msgid "" +"Many other operations also produce lists, including the :func:`sorted` built-" +"in." +msgstr "" + +msgid "Lists are :ref:`generic ` over the types of their items." +msgstr "" + +msgid "" +"Lists implement all of the :ref:`common ` and :ref:`mutable " +"` sequence operations. Lists also provide the following " +"additional method:" +msgstr "" + +msgid "" +"This method sorts the list in place, using only ``<`` comparisons between " +"items. Exceptions are not suppressed - if any comparison operations fail, " +"the entire sort operation will fail (and the list will likely be left in a " +"partially modified state)." +msgstr "" + +msgid "" +":meth:`sort` accepts two arguments that can only be passed by keyword " +"(:ref:`keyword-only arguments `):" +msgstr "" + +msgid "" +"*key* specifies a function of one argument that is used to extract a " +"comparison key from each list element (for example, ``key=str.lower``). The " +"key corresponding to each item in the list is calculated once and then used " +"for the entire sorting process. The default value of ``None`` means that " +"list items are sorted directly without calculating a separate key value." +msgstr "" + +msgid "" +"The :func:`functools.cmp_to_key` utility is available to convert a 2.x style " +"*cmp* function to a *key* function." +msgstr "" + +msgid "" +"*reverse* is a boolean value. If set to ``True``, then the list elements " +"are sorted as if each comparison were reversed." +msgstr "" +"*reverse* jest wartością logiczną. Jeśli jest ustawiona na ``True``, " +"elementy listy są sortowane tak, jakby każde porównanie było odwrócone." + +msgid "" +"This method modifies the sequence in place for economy of space when sorting " +"a large sequence. To remind users that it operates by side effect, it does " +"not return the sorted sequence (use :func:`sorted` to explicitly request a " +"new sorted list instance)." +msgstr "" + +msgid "" +"The :meth:`sort` method is guaranteed to be stable. A sort is stable if it " +"guarantees not to change the relative order of elements that compare equal " +"--- this is helpful for sorting in multiple passes (for example, sort by " +"department, then by salary grade)." +msgstr "" + +msgid "" +"For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." +msgstr "" +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." + +msgid "" +"While a list is being sorted, the effect of attempting to mutate, or even " +"inspect, the list is undefined. The C implementation of Python makes the " +"list appear empty for the duration, and raises :exc:`ValueError` if it can " +"detect that the list has been mutated during a sort." +msgstr "" + +msgid "Tuples" +msgstr "" + +msgid "" +"Tuples are immutable sequences, typically used to store collections of " +"heterogeneous data (such as the 2-tuples produced by the :func:`enumerate` " +"built-in). Tuples are also used for cases where an immutable sequence of " +"homogeneous data is needed (such as allowing storage in a :class:`set` " +"or :class:`dict` instance)." +msgstr "" + +msgid "Tuples may be constructed in a number of ways:" +msgstr "Krotki mogą być konstruowane na kilka sposobów:" + +msgid "Using a pair of parentheses to denote the empty tuple: ``()``" +msgstr "Przy użyciu pary nawiasów, by oznaczyć pustą krotkę: ``()``" + +msgid "Using a trailing comma for a singleton tuple: ``a,`` or ``(a,)``" +msgstr "" +"Przy użyciu przecinka, by oznaczyć jednoelementową krotkę: ``a,`` lub " +"``(a,)``" + +msgid "Separating items with commas: ``a, b, c`` or ``(a, b, c)``" +msgstr "" + +msgid "Using the :func:`tuple` built-in: ``tuple()`` or ``tuple(iterable)``" +msgstr "" +"Przy użyciu wbudowanej funkcji :func:`tuple`: ``tuple()`` lub " +"``tuple(iterable)``" + +msgid "" +"The constructor builds a tuple whose items are the same and in the same " +"order as *iterable*'s items. *iterable* may be either a sequence, a " +"container that supports iteration, or an iterator object. If *iterable* is " +"already a tuple, it is returned unchanged. For example, ``tuple('abc')`` " +"returns ``('a', 'b', 'c')`` and ``tuple( [1, 2, 3] )`` returns ``(1, 2, " +"3)``. If no argument is given, the constructor creates a new empty tuple, " +"``()``." +msgstr "" + +msgid "" +"Note that it is actually the comma which makes a tuple, not the parentheses. " +"The parentheses are optional, except in the empty tuple case, or when they " +"are needed to avoid syntactic ambiguity. For example, ``f(a, b, c)`` is a " +"function call with three arguments, while ``f((a, b, c))`` is a function " +"call with a 3-tuple as the sole argument." +msgstr "" + +msgid "" +"Tuples implement all of the :ref:`common ` sequence " +"operations." +msgstr "" + +msgid "" +"Tuples are :ref:`generic ` over the types of their contents. For " +"more information, refer to :ref:`the typing documentation on annotating " +"tuples `." +msgstr "" + +msgid "" +"For heterogeneous collections of data where access by name is clearer than " +"access by index, :func:`collections.namedtuple` may be a more appropriate " +"choice than a simple tuple object." +msgstr "" + +msgid "Ranges" +msgstr "" + +msgid "" +"The :class:`range` type represents an immutable sequence of numbers and is " +"commonly used for looping a specific number of times in :keyword:`for` loops." +msgstr "" + +msgid "" +"The arguments to the range constructor must be integers (either built-" +"in :class:`int` or any object that implements the :meth:`~object.__index__` " +"special method). If the *step* argument is omitted, it defaults to ``1``. " +"If the *start* argument is omitted, it defaults to ``0``. If *step* is " +"zero, :exc:`ValueError` is raised." +msgstr "" + +msgid "" +"For a positive *step*, the contents of a range ``r`` are determined by the " +"formula ``r[i] = start + step*i`` where ``i >= 0`` and ``r[i] < stop``." +msgstr "" + +msgid "" +"For a negative *step*, the contents of the range are still determined by the " +"formula ``r[i] = start + step*i``, but the constraints are ``i >= 0`` and " +"``r[i] > stop``." +msgstr "" + +msgid "" +"A range object will be empty if ``r[0]`` does not meet the value constraint. " +"Ranges do support negative indices, but these are interpreted as indexing " +"from the end of the sequence determined by the positive indices." +msgstr "" + +msgid "" +"Ranges containing absolute values larger than :data:`sys.maxsize` are " +"permitted but some features (such as :func:`len`) may " +"raise :exc:`OverflowError`." +msgstr "" + +msgid "Range examples::" +msgstr "" + +msgid "" +">>> list(range(10))\n" +"[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]\n" +">>> list(range(1, 11))\n" +"[1, 2, 3, 4, 5, 6, 7, 8, 9, 10]\n" +">>> list(range(0, 30, 5))\n" +"[0, 5, 10, 15, 20, 25]\n" +">>> list(range(0, 10, 3))\n" +"[0, 3, 6, 9]\n" +">>> list(range(0, -10, -1))\n" +"[0, -1, -2, -3, -4, -5, -6, -7, -8, -9]\n" +">>> list(range(0))\n" +"[]\n" +">>> list(range(1, 0))\n" +"[]" +msgstr "" + +msgid "" +"Ranges implement all of the :ref:`common ` sequence " +"operations except concatenation and repetition (due to the fact that range " +"objects can only represent sequences that follow a strict pattern and " +"repetition and concatenation will usually violate that pattern)." +msgstr "" + +msgid "" +"The value of the *start* parameter (or ``0`` if the parameter was not " +"supplied)" +msgstr "" + +msgid "The value of the *stop* parameter" +msgstr "" + +msgid "" +"The value of the *step* parameter (or ``1`` if the parameter was not " +"supplied)" +msgstr "" + +msgid "" +"The advantage of the :class:`range` type over a regular :class:`list` " +"or :class:`tuple` is that a :class:`range` object will always take the same " +"(small) amount of memory, no matter the size of the range it represents (as " +"it only stores the ``start``, ``stop`` and ``step`` values, calculating " +"individual items and subranges as needed)." +msgstr "" + +msgid "" +"Range objects implement the :class:`collections.abc.Sequence` ABC, and " +"provide features such as containment tests, element index lookup, slicing " +"and support for negative indices (see :ref:`typesseq`):" +msgstr "" + +msgid "" +"Testing range objects for equality with ``==`` and ``!=`` compares them as " +"sequences. That is, two range objects are considered equal if they " +"represent the same sequence of values. (Note that two range objects that " +"compare equal might have different :attr:`~range.start`, :attr:`~range.stop` " +"and :attr:`~range.step` attributes, for example ``range(0) == range(2, 1, " +"3)`` or ``range(0, 3, 2) == range(0, 4, 2)``.)" +msgstr "" + +msgid "" +"Implement the Sequence ABC. Support slicing and negative indices. " +"Test :class:`int` objects for membership in constant time instead of " +"iterating through all items." +msgstr "" + +msgid "" +"Define '==' and '!=' to compare range objects based on the sequence of " +"values they define (instead of comparing based on object identity)." +msgstr "" + +msgid "" +"Added the :attr:`~range.start`, :attr:`~range.stop` and :attr:`~range.step` " +"attributes." +msgstr "" + +msgid "" +"The `linspace recipe `_ shows how to implement a lazy version of range " +"suitable for floating-point applications." +msgstr "" + +msgid "Text Sequence Type --- :class:`str`" +msgstr "" + +msgid "" +"Textual data in Python is handled with :class:`str` objects, " +"or :dfn:`strings`. Strings are immutable :ref:`sequences ` of " +"Unicode code points. String literals are written in a variety of ways:" +msgstr "" + +msgid "Single quotes: ``'allows embedded \"double\" quotes'``" +msgstr "" + +msgid "Double quotes: ``\"allows embedded 'single' quotes\"``" +msgstr "" + +msgid "" +"Triple quoted: ``'''Three single quotes'''``, ``\"\"\"Three double " +"quotes\"\"\"``" +msgstr "" + +msgid "" +"Triple quoted strings may span multiple lines - all associated whitespace " +"will be included in the string literal." +msgstr "" + +msgid "" +"String literals that are part of a single expression and have only " +"whitespace between them will be implicitly converted to a single string " +"literal. That is, ``(\"spam \" \"eggs\") == \"spam eggs\"``." +msgstr "" + +msgid "" +"See :ref:`strings` for more about the various forms of string literal, " +"including supported :ref:`escape sequences `, and the " +"``r`` (\"raw\") prefix that disables most escape sequence processing." +msgstr "" + +msgid "" +"Strings may also be created from other objects using the :class:`str` " +"constructor." +msgstr "" + +msgid "" +"Since there is no separate \"character\" type, indexing a string produces " +"strings of length 1. That is, for a non-empty string *s*, ``s[0] == s[0:1]``." +msgstr "" + +msgid "" +"There is also no mutable string type, but :meth:`str.join` " +"or :class:`io.StringIO` can be used to efficiently construct strings from " +"multiple fragments." +msgstr "" + +msgid "" +"For backwards compatibility with the Python 2 series, the ``u`` prefix is " +"once again permitted on string literals. It has no effect on the meaning of " +"string literals and cannot be combined with the ``r`` prefix." +msgstr "" + +msgid "" +"Return a :ref:`string ` version of *object*. If *object* is not " +"provided, returns the empty string. Otherwise, the behavior of ``str()`` " +"depends on whether *encoding* or *errors* is given, as follows." +msgstr "" + +msgid "" +"If neither *encoding* nor *errors* is given, ``str(object)`` " +"returns :meth:`type(object).__str__(object) `, which is the " +"\"informal\" or nicely printable string representation of *object*. For " +"string objects, this is the string itself. If *object* does not have " +"a :meth:`~object.__str__` method, then :func:`str` falls back to " +"returning :func:`repr(object) `." +msgstr "" + +msgid "" +"If at least one of *encoding* or *errors* is given, *object* should be " +"a :term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " +"this case, if *object* is a :class:`bytes` (or :class:`bytearray`) object, " +"then ``str(bytes, encoding, errors)`` is equivalent " +"to :meth:`bytes.decode(encoding, errors) `. Otherwise, the " +"bytes object underlying the buffer object is obtained before " +"calling :meth:`bytes.decode`. See :ref:`binaryseq` and :ref:`bufferobjects` " +"for information on buffer objects." +msgstr "" + +msgid "" +"Passing a :class:`bytes` object to :func:`str` without the *encoding* or " +"*errors* arguments falls under the first case of returning the informal " +"string representation (see also the :option:`-b` command-line option to " +"Python). For example::" +msgstr "" + +msgid "" +">>> str(b'Zoot!')\n" +"\"b'Zoot!'\"" +msgstr "" +">>> str(b'Zoot!')\n" +"\"b'Zoot!'\"" + +msgid "" +"For more information on the ``str`` class and its methods, " +"see :ref:`textseq` and the :ref:`string-methods` section below. To output " +"formatted strings, see the :ref:`f-strings` and :ref:`formatstrings` " +"sections. In addition, see the :ref:`stringservices` section." +msgstr "" + +msgid "String Methods" +msgstr "Metody ciągów" + +msgid "" +"Strings implement all of the :ref:`common ` sequence " +"operations, along with the additional methods described below." +msgstr "" + +msgid "" +"Strings also support two styles of string formatting, one providing a large " +"degree of flexibility and customization " +"(see :meth:`str.format`, :ref:`formatstrings` and :ref:`string-formatting`) " +"and the other based on C ``printf`` style formatting that handles a narrower " +"range of types and is slightly harder to use correctly, but is often faster " +"for the cases it can handle (:ref:`old-string-formatting`)." +msgstr "" + +msgid "" +"The :ref:`textservices` section of the standard library covers a number of " +"other modules that provide various text related utilities (including regular " +"expression support in the :mod:`re` module)." +msgstr "" + +msgid "" +"Return a copy of the string with its first character capitalized and the " +"rest lowercased." +msgstr "" + +msgid "" +"The first character is now put into titlecase rather than uppercase. This " +"means that characters like digraphs will only have their first letter " +"capitalized, instead of the full character." +msgstr "" + +msgid "" +"Return a casefolded copy of the string. Casefolded strings may be used for " +"caseless matching." +msgstr "" + +msgid "" +"Casefolding is similar to lowercasing but more aggressive because it is " +"intended to remove all case distinctions in a string. For example, the " +"German lowercase letter ``'ß'`` is equivalent to ``\"ss\"``. Since it is " +"already lowercase, :meth:`lower` would do nothing to " +"``'ß'``; :meth:`casefold` converts it to ``\"ss\"``. For example:" +msgstr "" + +msgid "" +">>> 'straße'.lower()\n" +"'straße'\n" +">>> 'straße'.casefold()\n" +"'strasse'" +msgstr "" + +msgid "" +"The casefolding algorithm is `described in section 3.13 'Default Case " +"Folding' of the Unicode Standard `__." +msgstr "" + +msgid "" +"Return centered in a string of length *width*. Padding is done using the " +"specified *fillchar* (default is an ASCII space). The original string is " +"returned if *width* is less than or equal to ``len(s)``. For example::" +msgstr "" + +msgid "" +">>> 'Python'.center(10)\n" +"' Python '\n" +">>> 'Python'.center(10, '-')\n" +"'--Python--'\n" +">>> 'Python'.center(4)\n" +"'Python'" +msgstr "" + +msgid "" +"Return the number of non-overlapping occurrences of substring *sub* in the " +"range [*start*, *end*]. Optional arguments *start* and *end* are " +"interpreted as in slice notation." +msgstr "" + +msgid "" +"If *sub* is empty, returns the number of empty strings between characters " +"which is the length of the string plus one. For example::" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.count('spam')\n" +"3\n" +">>> 'spam, spam, spam'.count('spam', 5)\n" +"2\n" +">>> 'spam, spam, spam'.count('spam', 5, 10)\n" +"1\n" +">>> 'spam, spam, spam'.count('eggs')\n" +"0\n" +">>> 'spam, spam, spam'.count('')\n" +"17" +msgstr "" + +msgid "Return the string encoded to :class:`bytes`." +msgstr "" + +msgid "" +"*encoding* defaults to ``'utf-8'``; see :ref:`standard-encodings` for " +"possible values." +msgstr "" + +msgid "" +"*errors* controls how encoding errors are handled. If ``'strict'`` (the " +"default), a :exc:`UnicodeError` exception is raised. Other possible values " +"are ``'ignore'``, ``'replace'``, ``'xmlcharrefreplace'``, " +"``'backslashreplace'`` and any other name registered " +"via :func:`codecs.register_error`. See :ref:`error-handlers` for details." +msgstr "" + +msgid "" +"For performance reasons, the value of *errors* is not checked for validity " +"unless an encoding error actually occurs, :ref:`devmode` is enabled or " +"a :ref:`debug build ` is used. For example::" +msgstr "" + +msgid "" +">>> encoded_str_to_bytes = 'Python'.encode()\n" +">>> type(encoded_str_to_bytes)\n" +"\n" +">>> encoded_str_to_bytes\n" +"b'Python'" +msgstr "" + +msgid "Added support for keyword arguments." +msgstr "" + +msgid "" +"The value of the *errors* argument is now checked in :ref:`devmode` and " +"in :ref:`debug mode `." +msgstr "" + +msgid "" +"Return ``True`` if the string ends with the specified *suffix*, otherwise " +"return ``False``. *suffix* can also be a tuple of suffixes to look for. " +"With optional *start*, test beginning at that position. With optional " +"*end*, stop comparing at that position. Using *start* and *end* is " +"equivalent to ``str[start:end].endswith(suffix)``. For example::" +msgstr "" + +msgid "" +">>> 'Python'.endswith('on')\n" +"True\n" +">>> 'a tuple of suffixes'.endswith(('at', 'in'))\n" +"False\n" +">>> 'a tuple of suffixes'.endswith(('at', 'es'))\n" +"True\n" +">>> 'Python is amazing'.endswith('is', 0, 9)\n" +"True" +msgstr "" + +msgid "See also :meth:`startswith` and :meth:`removesuffix`." +msgstr "" + +msgid "" +"Return a copy of the string where all tab characters are replaced by one or " +"more spaces, depending on the current column and the given tab size. Tab " +"positions occur every *tabsize* characters (default is 8, giving tab " +"positions at columns 0, 8, 16 and so on). To expand the string, the current " +"column is set to zero and the string is examined character by character. If " +"the character is a tab (``\\t``), one or more space characters are inserted " +"in the result until the current column is equal to the next tab position. " +"(The tab character itself is not copied.) If the character is a newline " +"(``\\n``) or return (``\\r``), it is copied and the current column is reset " +"to zero. Any other character is copied unchanged and the current column is " +"incremented by one regardless of how the character is represented when " +"printed. For example::" +msgstr "" + +msgid "" +">>> '01\\t012\\t0123\\t01234'.expandtabs()\n" +"'01 012 0123 01234'\n" +">>> '01\\t012\\t0123\\t01234'.expandtabs(4)\n" +"'01 012 0123 01234'\n" +">>> print('01\\t012\\n0123\\t01234'.expandtabs(4))\n" +"01 012\n" +"0123 01234" +msgstr "" + +msgid "" +"Return the lowest index in the string where substring *sub* is found within " +"the slice ``s[start:end]``. Optional arguments *start* and *end* are " +"interpreted as in slice notation. Return ``-1`` if *sub* is not found. For " +"example::" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.find('sp')\n" +"0\n" +">>> 'spam, spam, spam'.find('sp', 5)\n" +"6" +msgstr "" + +msgid "See also :meth:`rfind` and :meth:`index`." +msgstr "" + +msgid "" +"The :meth:`~str.find` method should be used only if you need to know the " +"position of *sub*. To check if *sub* is a substring or not, use " +"the :keyword:`in` operator::" +msgstr "" + +msgid "" +">>> 'Py' in 'Python'\n" +"True" +msgstr "" +">>> 'Py' in 'Python'\n" +"True" + +msgid "" +"Perform a string formatting operation. The string on which this method is " +"called can contain literal text or replacement fields delimited by braces " +"``{}``. Each replacement field contains either the numeric index of a " +"positional argument, or the name of a keyword argument. Returns a copy of " +"the string where each replacement field is replaced with the string value of " +"the corresponding argument. For example:" +msgstr "" + +msgid "" +">>> \"The sum of 1 + 2 is {0}\".format(1+2)\n" +"'The sum of 1 + 2 is 3'\n" +">>> \"The sum of {a} + {b} is {answer}\".format(answer=1+2, a=1, b=2)\n" +"'The sum of 1 + 2 is 3'\n" +">>> \"{1} expects the {0} Inquisition!\".format(\"Spanish\", \"Nobody\")\n" +"'Nobody expects the Spanish Inquisition!'" +msgstr "" + +msgid "" +"See :ref:`formatstrings` for a description of the various formatting options " +"that can be specified in format strings." +msgstr "" + +msgid "" +"When formatting a number " +"(:class:`int`, :class:`float`, :class:`complex`, :class:`decimal.Decimal` " +"and subclasses) with the ``n`` type (ex: ``'{:n}'.format(1234)``), the " +"function temporarily sets the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` " +"locale to decode ``decimal_point`` and ``thousands_sep`` fields " +"of :c:func:`localeconv` if they are non-ASCII or longer than 1 byte, and the " +"``LC_NUMERIC`` locale is different than the ``LC_CTYPE`` locale. This " +"temporary change affects other threads." +msgstr "" + +msgid "" +"When formatting a number with the ``n`` type, the function sets temporarily " +"the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` locale in some cases." +msgstr "" + +msgid "" +"Similar to ``str.format(**mapping)``, except that ``mapping`` is used " +"directly and not copied to a :class:`dict`. This is useful if for example " +"``mapping`` is a dict subclass:" +msgstr "" + +msgid "" +"Like :meth:`~str.find`, but raise :exc:`ValueError` when the substring is " +"not found. For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.index('spam')\n" +"0\n" +">>> 'spam, spam, spam'.index('eggs')\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +" 'spam, spam, spam'.index('eggs')\n" +" ~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^\n" +"ValueError: substring not found" +msgstr "" + +msgid "See also :meth:`rindex`." +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are alphanumeric and there " +"is at least one character, ``False`` otherwise. A character ``c`` is " +"alphanumeric if one of the following returns ``True``: ``c.isalpha()``, " +"``c.isdecimal()``, ``c.isdigit()``, or ``c.isnumeric()``. For example:" +msgstr "" + +msgid "" +">>> 'abc123'.isalnum()\n" +"True\n" +">>> 'abc123!@#'.isalnum()\n" +"False\n" +">>> ''.isalnum()\n" +"False\n" +">>> ' '.isalnum()\n" +"False" +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are alphabetic and there is " +"at least one character, ``False`` otherwise. Alphabetic characters are " +"those characters defined in the Unicode character database as \"Letter\", " +"i.e., those with general category property being one of \"Lm\", \"Lt\", " +"\"Lu\", \"Ll\", or \"Lo\". Note that this is different from the `Alphabetic " +"property defined in section 4.10 'Letters, Alphabetic, and Ideographic' of " +"the Unicode Standard `_. For example:" +msgstr "" + +msgid "" +">>> 'Letters and spaces'.isalpha()\n" +"False\n" +">>> 'LettersOnly'.isalpha()\n" +"True\n" +">>> 'µ'.isalpha() # non-ASCII characters can be considered alphabetical " +"too\n" +"True" +msgstr "" + +msgid "See :ref:`unicode-properties`." +msgstr "" + +msgid "" +"Return ``True`` if the string is empty or all characters in the string are " +"ASCII, ``False`` otherwise. ASCII characters have code points in the range " +"U+0000-U+007F. For example:" +msgstr "" + +msgid "" +">>> 'ASCII characters'.isascii()\n" +"True\n" +">>> 'µ'.isascii()\n" +"False" +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are decimal characters and " +"there is at least one character, ``False`` otherwise. Decimal characters are " +"those that can be used to form numbers in base 10, such as U+0660, ARABIC-" +"INDIC DIGIT ZERO. Formally a decimal character is a character in the " +"Unicode General Category \"Nd\". For example:" +msgstr "" + +msgid "" +">>> '0123456789'.isdecimal()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isdecimal() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> 'alphabetic'.isdecimal()\n" +"False" +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are digits and there is at " +"least one character, ``False`` otherwise. Digits include decimal characters " +"and digits that need special handling, such as the compatibility superscript " +"digits. This covers digits which cannot be used to form numbers in base 10, " +"like the `Kharosthi numbers `__. Formally, a digit is a character that has the " +"property value Numeric_Type=Digit or Numeric_Type=Decimal." +msgstr "" + +msgid "For example:" +msgstr "Na przykład::" + +msgid "" +">>> '0123456789'.isdigit()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isdigit() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> '⅕'.isdigit() # Vulgar fraction one fifth\n" +"False\n" +">>> '²'.isdecimal(), '²'.isdigit(), '²'.isnumeric()\n" +"(False, True, True)" +msgstr "" + +msgid "See also :meth:`isdecimal` and :meth:`isnumeric`." +msgstr "" + +msgid "" +"Return ``True`` if the string is a valid identifier according to the " +"language definition, section :ref:`identifiers`." +msgstr "" + +msgid "" +":func:`keyword.iskeyword` can be used to test whether string ``s`` is a " +"reserved identifier, such as :keyword:`def` and :keyword:`class`." +msgstr "" + +msgid "Example: ::" +msgstr "" + +msgid "" +">>> from keyword import iskeyword\n" +"\n" +">>> 'hello'.isidentifier(), iskeyword('hello')\n" +"(True, False)\n" +">>> 'def'.isidentifier(), iskeyword('def')\n" +"(True, True)" +msgstr "" + +msgid "" +"Return ``True`` if all cased characters [4]_ in the string are lowercase and " +"there is at least one cased character, ``False`` otherwise." +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are numeric characters, and " +"there is at least one character, ``False`` otherwise. Numeric characters " +"include digit characters, and all characters that have the Unicode numeric " +"value property, e.g. U+2155, VULGAR FRACTION ONE FIFTH. Formally, numeric " +"characters are those with the property value Numeric_Type=Digit, " +"Numeric_Type=Decimal or Numeric_Type=Numeric. For example:" +msgstr "" + +msgid "" +">>> '0123456789'.isnumeric()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isnumeric() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> '⅕'.isnumeric() # Vulgar fraction one fifth\n" +"True\n" +">>> '²'.isdecimal(), '²'.isdigit(), '²'.isnumeric()\n" +"(False, True, True)" +msgstr "" + +msgid "See also :meth:`isdecimal` and :meth:`isdigit`." +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are printable, ``False`` if " +"it contains at least one non-printable character." +msgstr "" + +msgid "" +"Here \"printable\" means the character is suitable for :func:`repr` to use " +"in its output; \"non-printable\" means that :func:`repr` on built-in types " +"will hex-escape the character. It has no bearing on the handling of strings " +"written to :data:`sys.stdout` or :data:`sys.stderr`." +msgstr "" + +msgid "" +"The printable characters are those which in the Unicode character database " +"(see :mod:`unicodedata`) have a general category in group Letter, Mark, " +"Number, Punctuation, or Symbol (L, M, N, P, or S); plus the ASCII space " +"0x20. Nonprintable characters are those in group Separator or Other (Z or " +"C), except the ASCII space." +msgstr "" + +msgid "" +">>> ''.isprintable(), ' '.isprintable()\n" +"(True, True)\n" +">>> '\\t'.isprintable(), '\\n'.isprintable()\n" +"(False, False)" +msgstr "" + +msgid "See also :meth:`isspace`." +msgstr "" + +msgid "" +"Return ``True`` if there are only whitespace characters in the string and " +"there is at least one character, ``False`` otherwise." +msgstr "" + +msgid "" +">>> ''.isspace()\n" +"False\n" +">>> ' '.isspace()\n" +"True\n" +">>> '\\t\\n'.isspace() # TAB and BREAK LINE\n" +"True\n" +">>> '\\u3000'.isspace() # IDEOGRAPHIC SPACE\n" +"True" +msgstr "" + +msgid "" +"A character is *whitespace* if in the Unicode character database " +"(see :mod:`unicodedata`), either its general category is ``Zs`` " +"(\"Separator, space\"), or its bidirectional class is one of ``WS``, ``B``, " +"or ``S``." +msgstr "" + +msgid "See also :meth:`isprintable`." +msgstr "" + +msgid "" +"Return ``True`` if the string is a titlecased string and there is at least " +"one character, for example uppercase characters may only follow uncased " +"characters and lowercase characters only cased ones. Return ``False`` " +"otherwise." +msgstr "" + +msgid "" +">>> 'Spam, Spam, Spam'.istitle()\n" +"True\n" +">>> 'spam, spam, spam'.istitle()\n" +"False\n" +">>> 'SPAM, SPAM, SPAM'.istitle()\n" +"False" +msgstr "" + +msgid "See also :meth:`title`." +msgstr "" + +msgid "" +"Return ``True`` if all cased characters [4]_ in the string are uppercase and " +"there is at least one cased character, ``False`` otherwise." +msgstr "" + +msgid "" +"Return a string which is the concatenation of the strings in *iterable*. " +"A :exc:`TypeError` will be raised if there are any non-string values in " +"*iterable*, including :class:`bytes` objects. The separator between " +"elements is the string providing this method. For example:" +msgstr "" + +msgid "" +">>> ', '.join(['spam', 'spam', 'spam'])\n" +"'spam, spam, spam'\n" +">>> '-'.join('Python')\n" +"'P-y-t-h-o-n'" +msgstr "" + +msgid "See also :meth:`split`." +msgstr "" + +msgid "" +"Return the string left justified in a string of length *width*. Padding is " +"done using the specified *fillchar* (default is an ASCII space). The " +"original string is returned if *width* is less than or equal to ``len(s)``." +msgstr "" + +msgid "" +">>> 'Python'.ljust(10)\n" +"'Python '\n" +">>> 'Python'.ljust(10, '.')\n" +"'Python....'\n" +">>> 'Monty Python'.ljust(10, '.')\n" +"'Monty Python'" +msgstr "" + +msgid "See also :meth:`rjust`." +msgstr "" + +msgid "" +"Return a copy of the string with all the cased characters [4]_ converted to " +"lowercase. For example:" +msgstr "" + +msgid "" +">>> 'Lower Method Example'.lower()\n" +"'lower method example'" +msgstr "" + +msgid "" +"The lowercasing algorithm used is `described in section 3.13 'Default Case " +"Folding' of the Unicode Standard `__." +msgstr "" + +msgid "" +"Return a copy of the string with leading characters removed. The *chars* " +"argument is a string specifying the set of characters to be removed. If " +"omitted or ``None``, the *chars* argument defaults to removing whitespace. " +"The *chars* argument is not a prefix; rather, all combinations of its values " +"are stripped::" +msgstr "" + +msgid "" +">>> ' spacious '.lstrip()\n" +"'spacious '\n" +">>> 'www.example.com'.lstrip('cmowz.')\n" +"'example.com'" +msgstr "" +">>> ' spacious '.lstrip()\n" +"'spacious '\n" +">>> 'www.example.com'.lstrip('cmowz.')\n" +"'example.com'" + +msgid "" +"See :meth:`str.removeprefix` for a method that will remove a single prefix " +"string rather than all of a set of characters. For example::" +msgstr "" + +msgid "" +">>> 'Arthur: three!'.lstrip('Arthur: ')\n" +"'ee!'\n" +">>> 'Arthur: three!'.removeprefix('Arthur: ')\n" +"'three!'" +msgstr "" +">>> 'Arthur: three!'.lstrip('Arthur: ')\n" +"'ee!'\n" +">>> 'Arthur: three!'.removeprefix('Arthur: ')\n" +"'three!'" + +msgid "" +"This static method returns a translation table usable " +"for :meth:`str.translate`." +msgstr "" + +msgid "" +"If there is only one argument, it must be a dictionary mapping Unicode " +"ordinals (integers) or characters (strings of length 1) to Unicode ordinals, " +"strings (of arbitrary lengths) or ``None``. Character keys will then be " +"converted to ordinals." +msgstr "" + +msgid "" +"If there are two arguments, they must be strings of equal length, and in the " +"resulting dictionary, each character in *from* will be mapped to the " +"character at the same position in *to*. If there is a third argument, it " +"must be a string, whose characters will be mapped to ``None`` in the result." +msgstr "" + +msgid "" +"Split the string at the first occurrence of *sep*, and return a 3-tuple " +"containing the part before the separator, the separator itself, and the part " +"after the separator. If the separator is not found, return a 3-tuple " +"containing the string itself, followed by two empty strings." +msgstr "" + +msgid "" +">>> 'Monty Python'.partition(' ')\n" +"('Monty', ' ', 'Python')\n" +">>> \"Monty Python's Flying Circus\".partition(' ')\n" +"('Monty', ' ', \"Python's Flying Circus\")\n" +">>> 'Monty Python'.partition('-')\n" +"('Monty Python', '', '')" +msgstr "" + +msgid "See also :meth:`rpartition`." +msgstr "" + +msgid "" +"If the string starts with the *prefix* string, return " +"``string[len(prefix):]``. Otherwise, return a copy of the original string:" +msgstr "" + +msgid "" +">>> 'TestHook'.removeprefix('Test')\n" +"'Hook'\n" +">>> 'BaseTestCase'.removeprefix('Test')\n" +"'BaseTestCase'" +msgstr "" +">>> 'TestHook'.removeprefix('Test')\n" +"'Hook'\n" +">>> 'BaseTestCase'.removeprefix('Test')\n" +"'BaseTestCase'" + +msgid "See also :meth:`removesuffix` and :meth:`startswith`." +msgstr "" + +msgid "" +"If the string ends with the *suffix* string and that *suffix* is not empty, " +"return ``string[:-len(suffix)]``. Otherwise, return a copy of the original " +"string:" +msgstr "" + +msgid "" +">>> 'MiscTests'.removesuffix('Tests')\n" +"'Misc'\n" +">>> 'TmpDirMixin'.removesuffix('Tests')\n" +"'TmpDirMixin'" +msgstr "" +">>> 'MiscTests'.removesuffix('Tests')\n" +"'Misc'\n" +">>> 'TmpDirMixin'.removesuffix('Tests')\n" +"'TmpDirMixin'" + +msgid "See also :meth:`removeprefix` and :meth:`endswith`." +msgstr "" + +msgid "" +"Return a copy of the string with all occurrences of substring *old* replaced " +"by *new*. If *count* is given, only the first *count* occurrences are " +"replaced. If *count* is not specified or ``-1``, then all occurrences are " +"replaced. For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.replace('spam', 'eggs')\n" +"'eggs, eggs, eggs'\n" +">>> 'spam, spam, spam'.replace('spam', 'eggs', 1)\n" +"'eggs, spam, spam'" +msgstr "" + +msgid "*count* is now supported as a keyword argument." +msgstr "" + +msgid "" +"Return the highest index in the string where substring *sub* is found, such " +"that *sub* is contained within ``s[start:end]``. Optional arguments *start* " +"and *end* are interpreted as in slice notation. Return ``-1`` on failure. " +"For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.rfind('sp')\n" +"12\n" +">>> 'spam, spam, spam'.rfind('sp', 0, 10)\n" +"6" +msgstr "" + +msgid "See also :meth:`find` and :meth:`rindex`." +msgstr "" + +msgid "" +"Like :meth:`rfind` but raises :exc:`ValueError` when the substring *sub* is " +"not found. For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.rindex('spam')\n" +"12\n" +">>> 'spam, spam, spam'.rindex('eggs')\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +" 'spam, spam, spam'.rindex('eggs')\n" +" ~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^\n" +"ValueError: substring not found" +msgstr "" + +msgid "See also :meth:`index` and :meth:`find`." +msgstr "" + +msgid "" +"Return the string right justified in a string of length *width*. Padding is " +"done using the specified *fillchar* (default is an ASCII space). The " +"original string is returned if *width* is less than or equal to ``len(s)``." +msgstr "" + +msgid "" +">>> 'Python'.rjust(10)\n" +"' Python'\n" +">>> 'Python'.rjust(10, '.')\n" +"'....Python'\n" +">>> 'Monty Python'.rjust(10, '.')\n" +"'Monty Python'" +msgstr "" + +msgid "See also :meth:`ljust` and :meth:`zfill`." +msgstr "" + +msgid "" +"Split the string at the last occurrence of *sep*, and return a 3-tuple " +"containing the part before the separator, the separator itself, and the part " +"after the separator. If the separator is not found, return a 3-tuple " +"containing two empty strings, followed by the string itself." +msgstr "" + +msgid "" +">>> 'Monty Python'.rpartition(' ')\n" +"('Monty', ' ', 'Python')\n" +">>> \"Monty Python's Flying Circus\".rpartition(' ')\n" +"(\"Monty Python's Flying\", ' ', 'Circus')\n" +">>> 'Monty Python'.rpartition('-')\n" +"('', '', 'Monty Python')" +msgstr "" + +msgid "See also :meth:`partition`." +msgstr "" + +msgid "" +"Return a list of the words in the string, using *sep* as the delimiter " +"string. If *maxsplit* is given, at most *maxsplit* splits are done, the " +"*rightmost* ones. If *sep* is not specified or ``None``, " +"any :meth:`whitespace ` string is a separator. Except for " +"splitting from the right, :meth:`rsplit` behaves like :meth:`split` which is " +"described in detail below." +msgstr "" + +msgid "" +"Return a copy of the string with trailing characters removed. The *chars* " +"argument is a string specifying the set of characters to be removed. If " +"omitted or ``None``, the *chars* argument defaults to removing whitespace. " +"The *chars* argument is not a suffix; rather, all combinations of its values " +"are stripped. For example:" +msgstr "" + +msgid "" +">>> ' spacious '.rstrip()\n" +"' spacious'\n" +">>> 'mississippi'.rstrip('ipz')\n" +"'mississ'" +msgstr "" +">>> ' spacious '.rstrip()\n" +"' spacious'\n" +">>> 'mississippi'.rstrip('ipz')\n" +"'mississ'" + +msgid "" +"See :meth:`removesuffix` for a method that will remove a single suffix " +"string rather than all of a set of characters. For example::" +msgstr "" + +msgid "" +">>> 'Monty Python'.rstrip(' Python')\n" +"'M'\n" +">>> 'Monty Python'.removesuffix(' Python')\n" +"'Monty'" +msgstr "" +">>> 'Monty Python'.rstrip(' Python')\n" +"'M'\n" +">>> 'Monty Python'.removesuffix(' Python')\n" +"'Monty'" + +msgid "See also :meth:`strip`." +msgstr "" + +msgid "" +"Return a list of the words in the string, using *sep* as the delimiter " +"string. If *maxsplit* is given, at most *maxsplit* splits are done (thus, " +"the list will have at most ``maxsplit+1`` elements). If *maxsplit* is not " +"specified or ``-1``, then there is no limit on the number of splits (all " +"possible splits are made)." +msgstr "" + +msgid "" +"If *sep* is given, consecutive delimiters are not grouped together and are " +"deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " +"``['1', '', '2']``). The *sep* argument may consist of multiple characters " +"as a single delimiter (to split with multiple delimiters, " +"use :func:`re.split`). Splitting an empty string with a specified separator " +"returns ``['']``." +msgstr "" + +msgid "" +">>> '1,2,3'.split(',')\n" +"['1', '2', '3']\n" +">>> '1,2,3'.split(',', maxsplit=1)\n" +"['1', '2,3']\n" +">>> '1,2,,3,'.split(',')\n" +"['1', '2', '', '3', '']\n" +">>> '1<>2<>3<4'.split('<>')\n" +"['1', '2', '3<4']" +msgstr "" + +msgid "" +"If *sep* is not specified or is ``None``, a different splitting algorithm is " +"applied: runs of consecutive :meth:`whitespace ` are regarded " +"as a single separator, and the result will contain no empty strings at the " +"start or end if the string has leading or trailing whitespace. " +"Consequently, splitting an empty string or a string consisting of just " +"whitespace with a ``None`` separator returns ``[]``." +msgstr "" + +msgid "" +">>> '1 2 3'.split()\n" +"['1', '2', '3']\n" +">>> '1 2 3'.split(maxsplit=1)\n" +"['1', '2 3']\n" +">>> ' 1 2 3 '.split()\n" +"['1', '2', '3']" +msgstr "" + +msgid "" +"If *sep* is not specified or is ``None`` and *maxsplit* is ``0``, only " +"leading runs of consecutive whitespace are considered." +msgstr "" + +msgid "" +">>> \"\".split(None, 0)\n" +"[]\n" +">>> \" \".split(None, 0)\n" +"[]\n" +">>> \" foo \".split(maxsplit=0)\n" +"['foo ']" +msgstr "" + +msgid "See also :meth:`join` and :meth:`rsplit`." +msgstr "" + +msgid "" +"Return a list of the lines in the string, breaking at line boundaries. Line " +"breaks are not included in the resulting list unless *keepends* is given and " +"true." +msgstr "" + +msgid "" +"This method splits on the following line boundaries. In particular, the " +"boundaries are a superset of :term:`universal newlines`." +msgstr "" + +msgid "Representation" +msgstr "" + +msgid "Description" +msgstr "Opis" + +msgid "``\\n``" +msgstr "``\\n``" + +msgid "Line Feed" +msgstr "" + +msgid "``\\r``" +msgstr "``\\r``" + +msgid "Carriage Return" +msgstr "" + +msgid "``\\r\\n``" +msgstr "``\\r\\n``" + +msgid "Carriage Return + Line Feed" +msgstr "" + +msgid "``\\v`` or ``\\x0b``" +msgstr "" + +msgid "Line Tabulation" +msgstr "" + +msgid "``\\f`` or ``\\x0c``" +msgstr "" + +msgid "Form Feed" +msgstr "" + +msgid "``\\x1c``" +msgstr "``\\x1c``" + +msgid "File Separator" +msgstr "" + +msgid "``\\x1d``" +msgstr "``\\x1d``" + +msgid "Group Separator" +msgstr "" + +msgid "``\\x1e``" +msgstr "``\\x1e``" + +msgid "Record Separator" +msgstr "" + +msgid "``\\x85``" +msgstr "``\\x85``" + +msgid "Next Line (C1 Control Code)" +msgstr "" + +msgid "``\\u2028``" +msgstr "``\\u2028``" + +msgid "Line Separator" +msgstr "" + +msgid "``\\u2029``" +msgstr "``\\u2029``" + +msgid "Paragraph Separator" +msgstr "" + +msgid "``\\v`` and ``\\f`` added to list of line boundaries." +msgstr "" + +msgid "For example::" +msgstr "Dla przykładu::" + +msgid "" +">>> 'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines()\n" +"['ab c', '', 'de fg', 'kl']\n" +">>> 'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines(keepends=True)\n" +"['ab c\\n', '\\n', 'de fg\\r', 'kl\\r\\n']" +msgstr "" + +msgid "" +"Unlike :meth:`~str.split` when a delimiter string *sep* is given, this " +"method returns an empty list for the empty string, and a terminal line break " +"does not result in an extra line::" +msgstr "" + +msgid "" +">>> \"\".splitlines()\n" +"[]\n" +">>> \"One line\\n\".splitlines()\n" +"['One line']" +msgstr "" +">>> \"\".splitlines()\n" +"[]\n" +">>> \"One line\\n\".splitlines()\n" +"['One line']" + +msgid "For comparison, ``split('\\n')`` gives::" +msgstr "" + +msgid "" +">>> ''.split('\\n')\n" +"['']\n" +">>> 'Two lines\\n'.split('\\n')\n" +"['Two lines', '']" +msgstr "" +">>> ''.split('\\n')\n" +"['']\n" +">>> 'Two lines\\n'.split('\\n')\n" +"['Two lines', '']" + +msgid "" +"Return ``True`` if string starts with the *prefix*, otherwise return " +"``False``. *prefix* can also be a tuple of prefixes to look for. With " +"optional *start*, test string beginning at that position. With optional " +"*end*, stop comparing string at that position." +msgstr "" + +msgid "" +">>> 'Python'.startswith('Py')\n" +"True\n" +">>> 'a tuple of prefixes'.startswith(('at', 'a'))\n" +"True\n" +">>> 'Python is amazing'.startswith('is', 7)\n" +"True" +msgstr "" + +msgid "See also :meth:`endswith` and :meth:`removeprefix`." +msgstr "" + +msgid "" +"Return a copy of the string with the leading and trailing characters " +"removed. The *chars* argument is a string specifying the set of characters " +"to be removed. If omitted or ``None``, the *chars* argument defaults to " +"removing whitespace. The *chars* argument is not a prefix or suffix; rather, " +"all combinations of its values are stripped." +msgstr "" + +msgid "Whitespace characters are defined by :meth:`str.isspace`." +msgstr "" + +msgid "" +">>> ' spacious '.strip()\n" +"'spacious'\n" +">>> 'www.example.com'.strip('cmowz.')\n" +"'example'" +msgstr "" +">>> ' spacious '.strip()\n" +"'spacious'\n" +">>> 'www.example.com'.strip('cmowz.')\n" +"'example'" + +msgid "" +"The outermost leading and trailing *chars* argument values are stripped from " +"the string. Characters are removed from the leading end until reaching a " +"string character that is not contained in the set of characters in *chars*. " +"A similar action takes place on the trailing end." +msgstr "" + +msgid "" +">>> comment_string = '#....... Section 3.2.1 Issue #32 .......'\n" +">>> comment_string.strip('.#! ')\n" +"'Section 3.2.1 Issue #32'" +msgstr "" + +msgid "See also :meth:`rstrip`." +msgstr "" + +msgid "" +"Return a copy of the string with uppercase characters converted to lowercase " +"and vice versa. For example:" +msgstr "" + +msgid "" +">>> 'Hello World'.swapcase()\n" +"'hELLO wORLD'" +msgstr "" + +msgid "" +"Note that it is not necessarily true that ``s.swapcase().swapcase() == s``. " +"For example:" +msgstr "" + +msgid "" +">>> 'straße'.swapcase().swapcase()\n" +"'strasse'" +msgstr "" + +msgid "See also :meth:`str.lower` and :meth:`str.upper`." +msgstr "" + +msgid "" +"Return a titlecased version of the string where words start with an " +"uppercase character and the remaining characters are lowercase." +msgstr "" + +msgid "" +">>> 'Hello world'.title()\n" +"'Hello World'" +msgstr "" +">>> 'Hello world'.title()\n" +"'Hello World'" + +msgid "" +"The algorithm uses a simple language-independent definition of a word as " +"groups of consecutive letters. The definition works in many contexts but it " +"means that apostrophes in contractions and possessives form word boundaries, " +"which may not be the desired result::" +msgstr "" + +msgid "" +">>> \"they're bill's friends from the UK\".title()\n" +"\"They'Re Bill'S Friends From The Uk\"" +msgstr "" +">>> \"they're bill's friends from the UK\".title()\n" +"\"They'Re Bill'S Friends From The Uk\"" + +msgid "" +"The :func:`string.capwords` function does not have this problem, as it " +"splits words on spaces only." +msgstr "" + +msgid "" +"Alternatively, a workaround for apostrophes can be constructed using regular " +"expressions::" +msgstr "" + +msgid "" +">>> import re\n" +">>> def titlecase(s):\n" +"... return re.sub(r\"[A-Za-z]+('[A-Za-z]+)?\",\n" +"... lambda mo: mo.group(0).capitalize(),\n" +"... s)\n" +"...\n" +">>> titlecase(\"they're bill's friends.\")\n" +"\"They're Bill's Friends.\"" +msgstr "" + +msgid "See also :meth:`istitle`." +msgstr "" + +msgid "" +"Return a copy of the string in which each character has been mapped through " +"the given translation table. The table must be an object that implements " +"indexing via :meth:`~object.__getitem__`, typically a :term:`mapping` " +"or :term:`sequence`. When indexed by a Unicode ordinal (an integer), the " +"table object can do any of the following: return a Unicode ordinal or a " +"string, to map the character to one or more other characters; return " +"``None``, to delete the character from the return string; or raise " +"a :exc:`LookupError` exception, to map the character to itself." +msgstr "" + +msgid "" +"You can use :meth:`str.maketrans` to create a translation map from character-" +"to-character mappings in different formats." +msgstr "" + +msgid "" +"See also the :mod:`codecs` module for a more flexible approach to custom " +"character mappings." +msgstr "" + +msgid "" +"Return a copy of the string with all the cased characters [4]_ converted to " +"uppercase. Note that ``s.upper().isupper()`` might be ``False`` if ``s`` " +"contains uncased characters or if the Unicode category of the resulting " +"character(s) is not \"Lu\" (Letter, uppercase), but e.g. \"Lt\" (Letter, " +"titlecase)." +msgstr "" + +msgid "" +"The uppercasing algorithm used is `described in section 3.13 'Default Case " +"Folding' of the Unicode Standard `__." +msgstr "" + +msgid "" +"Return a copy of the string left filled with ASCII ``'0'`` digits to make a " +"string of length *width*. A leading sign prefix (``'+'``/``'-'``) is handled " +"by inserting the padding *after* the sign character rather than before. The " +"original string is returned if *width* is less than or equal to ``len(s)``." +msgstr "" + +msgid "" +">>> \"42\".zfill(5)\n" +"'00042'\n" +">>> \"-42\".zfill(5)\n" +"'-0042'" +msgstr "" +">>> \"42\".zfill(5)\n" +"'00042'\n" +">>> \"-42\".zfill(5)\n" +"'-0042'" + +msgid "Formatted String Literals (f-strings)" +msgstr "" + +msgid "" +"The :keyword:`await` and :keyword:`async for` can be used in expressions " +"within f-strings." +msgstr "" + +msgid "Added the debugging operator (``=``)" +msgstr "" + +msgid "" +"Many restrictions on expressions within f-strings have been removed. " +"Notably, nested strings, comments, and backslashes are now permitted." +msgstr "" + +msgid "" +"An :dfn:`f-string` (formally a :dfn:`formatted string literal`) is a string " +"literal that is prefixed with ``f`` or ``F``. This type of string literal " +"allows embedding arbitrary Python expressions within *replacement fields*, " +"which are delimited by curly brackets (``{}``). These expressions are " +"evaluated at runtime, similarly to :meth:`str.format`, and are converted " +"into regular :class:`str` objects. For example:" +msgstr "" + +msgid "" +">>> who = 'nobody'\n" +">>> nationality = 'Spanish'\n" +">>> f'{who.title()} expects the {nationality} Inquisition!'\n" +"'Nobody expects the Spanish Inquisition!'" +msgstr "" + +msgid "It is also possible to use a multi line f-string:" +msgstr "" + +msgid "" +">>> f'''This is a string\n" +"... on two lines'''\n" +"'This is a string\\non two lines'" +msgstr "" + +msgid "" +"A single opening curly bracket, ``'{'``, marks a *replacement field* that " +"can contain any Python expression:" +msgstr "" + +msgid "" +">>> nationality = 'Spanish'\n" +">>> f'The {nationality} Inquisition!'\n" +"'The Spanish Inquisition!'" +msgstr "" + +msgid "To include a literal ``{`` or ``}``, use a double bracket:" +msgstr "" + +msgid "" +">>> x = 42\n" +">>> f'{{x}} is {x}'\n" +"'{x} is 42'" +msgstr "" + +msgid "" +"Functions can also be used, and :ref:`format specifiers `:" +msgstr "" + +msgid "" +">>> from math import sqrt\n" +">>> f'√2 \\N{ALMOST EQUAL TO} {sqrt(2):.5f}'\n" +"'√2 ≈ 1.41421'" +msgstr "" + +msgid "Any non-string expression is converted using :func:`str`, by default:" +msgstr "" + +msgid "" +">>> from fractions import Fraction\n" +">>> f'{Fraction(1, 3)}'\n" +"'1/3'" +msgstr "" + +msgid "" +"To use an explicit conversion, use the ``!`` (exclamation mark) operator, " +"followed by any of the valid formats, which are:" +msgstr "" + +msgid "Conversion" +msgstr "" + +msgid "``!a``" +msgstr "``!a``" + +msgid ":func:`ascii`" +msgstr ":func:`ascii`" + +msgid "``!r``" +msgstr "``!r``" + +msgid ":func:`repr`" +msgstr ":func:`repr`" + +msgid "``!s``" +msgstr "``!s``" + +msgid ":func:`str`" +msgstr ":func:`str`" + +msgid "" +">>> from fractions import Fraction\n" +">>> f'{Fraction(1, 3)!s}'\n" +"'1/3'\n" +">>> f'{Fraction(1, 3)!r}'\n" +"'Fraction(1, 3)'\n" +">>> question = '¿Dónde está el Presidente?'\n" +">>> print(f'{question!a}')\n" +"'\\xbfD\\xf3nde est\\xe1 el Presidente?'" +msgstr "" + +msgid "" +"While debugging it may be helpful to see both the expression and its value, " +"by using the equals sign (``=``) after the expression. This preserves spaces " +"within the brackets, and can be used with a converter. By default, the " +"debugging operator uses the :func:`repr` (``!r``) conversion. For example:" +msgstr "" + +msgid "" +">>> from fractions import Fraction\n" +">>> calculation = Fraction(1, 3)\n" +">>> f'{calculation=}'\n" +"'calculation=Fraction(1, 3)'\n" +">>> f'{calculation = }'\n" +"'calculation = Fraction(1, 3)'\n" +">>> f'{calculation = !s}'\n" +"'calculation = 1/3'" +msgstr "" + +msgid "" +"Once the output has been evaluated, it can be formatted using a :ref:`format " +"specifier ` following a colon (``':'``). After the expression " +"has been evaluated, and possibly converted to a string, the :meth:`!" +"__format__` method of the result is called with the format specifier, or the " +"empty string if no format specifier is given. The formatted result is then " +"used as the final value for the replacement field. For example:" +msgstr "" + +msgid "" +">>> from fractions import Fraction\n" +">>> f'{Fraction(1, 7):.6f}'\n" +"'0.142857'\n" +">>> f'{Fraction(1, 7):_^+10}'\n" +"'___+1/7___'" +msgstr "" + +msgid "``printf``-style String Formatting" +msgstr "" + +msgid "" +"The formatting operations described here exhibit a variety of quirks that " +"lead to a number of common errors (such as failing to display tuples and " +"dictionaries correctly). Using the newer :ref:`formatted string literals `, the :meth:`str.format` interface, or :ref:`template strings " +"` may help avoid these errors. Each of these alternatives " +"provides their own trade-offs and benefits of simplicity, flexibility, and/" +"or extensibility." +msgstr "" + +msgid "" +"String objects have one unique built-in operation: the ``%`` operator " +"(modulo). This is also known as the string *formatting* or *interpolation* " +"operator. Given ``format % values`` (where *format* is a string), ``%`` " +"conversion specifications in *format* are replaced with zero or more " +"elements of *values*. The effect is similar to using the :c:func:`sprintf` " +"function in the C language. For example:" +msgstr "" + +msgid "" +">>> print('%s has %d quote types.' % ('Python', 2))\n" +"Python has 2 quote types." +msgstr "" + +msgid "" +"If *format* requires a single argument, *values* may be a single non-tuple " +"object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " +"items specified by the format string, or a single mapping object (for " +"example, a dictionary)." +msgstr "" + +msgid "" +"A conversion specifier contains two or more characters and has the following " +"components, which must occur in this order:" +msgstr "" + +msgid "The ``'%'`` character, which marks the start of the specifier." +msgstr "" + +msgid "" +"Mapping key (optional), consisting of a parenthesised sequence of characters " +"(for example, ``(somename)``)." +msgstr "" + +msgid "" +"Conversion flags (optional), which affect the result of some conversion " +"types." +msgstr "" + +msgid "" +"Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " +"actual width is read from the next element of the tuple in *values*, and the " +"object to convert comes after the minimum field width and optional precision." +msgstr "" + +msgid "" +"Precision (optional), given as a ``'.'`` (dot) followed by the precision. " +"If specified as ``'*'`` (an asterisk), the actual precision is read from the " +"next element of the tuple in *values*, and the value to convert comes after " +"the precision." +msgstr "" + +msgid "Length modifier (optional)." +msgstr "" + +msgid "Conversion type." +msgstr "" + +msgid "" +"When the right argument is a dictionary (or other mapping type), then the " +"formats in the string *must* include a parenthesised mapping key into that " +"dictionary inserted immediately after the ``'%'`` character. The mapping key " +"selects the value to be formatted from the mapping. For example:" +msgstr "" + +msgid "" +"In this case no ``*`` specifiers may occur in a format (since they require a " +"sequential parameter list)." +msgstr "" + +msgid "The conversion flag characters are:" +msgstr "" + +msgid "Flag" +msgstr "" + +msgid "``'#'``" +msgstr "``'#'``" + +msgid "" +"The value conversion will use the \"alternate form\" (where defined below)." +msgstr "" + +msgid "``'0'``" +msgstr "``'0'``" + +msgid "The conversion will be zero padded for numeric values." +msgstr "" + +msgid "``'-'``" +msgstr "``'-'``" + +msgid "" +"The converted value is left adjusted (overrides the ``'0'`` conversion if " +"both are given)." +msgstr "" + +msgid "``' '``" +msgstr "``' '``" + +msgid "" +"(a space) A blank should be left before a positive number (or empty string) " +"produced by a signed conversion." +msgstr "" + +msgid "``'+'``" +msgstr "``'+'``" + +msgid "" +"A sign character (``'+'`` or ``'-'``) will precede the conversion (overrides " +"a \"space\" flag)." +msgstr "" + +msgid "" +"A length modifier (``h``, ``l``, or ``L``) may be present, but is ignored as " +"it is not necessary for Python -- so e.g. ``%ld`` is identical to ``%d``." +msgstr "" + +msgid "The conversion types are:" +msgstr "" + +msgid "``'d'``" +msgstr "``'d'``" + +msgid "Signed integer decimal." +msgstr "" + +msgid "``'i'``" +msgstr "``'i'``" + +msgid "``'o'``" +msgstr "``'o'``" + +msgid "Signed octal value." +msgstr "" + +msgid "``'u'``" +msgstr "``'u'``" + +msgid "Obsolete type -- it is identical to ``'d'``." +msgstr "" + +msgid "``'x'``" +msgstr "``'x'``" + +msgid "Signed hexadecimal (lowercase)." +msgstr "" + +msgid "``'X'``" +msgstr "``'X'``" + +msgid "Signed hexadecimal (uppercase)." +msgstr "" + +msgid "``'e'``" +msgstr "``'e'``" + +msgid "Floating-point exponential format (lowercase)." +msgstr "" + +msgid "``'E'``" +msgstr "``'E'``" + +msgid "Floating-point exponential format (uppercase)." +msgstr "" + +msgid "``'f'``" +msgstr "``'f'``" + +msgid "Floating-point decimal format." +msgstr "" + +msgid "``'F'``" +msgstr "``'F'``" + +msgid "``'g'``" +msgstr "``'g'``" + +msgid "" +"Floating-point format. Uses lowercase exponential format if exponent is less " +"than -4 or not less than precision, decimal format otherwise." +msgstr "" + +msgid "``'G'``" +msgstr "``'G'``" + +msgid "" +"Floating-point format. Uses uppercase exponential format if exponent is less " +"than -4 or not less than precision, decimal format otherwise." +msgstr "" + +msgid "``'c'``" +msgstr "``'c'``" + +msgid "Single character (accepts integer or single character string)." +msgstr "" + +msgid "``'r'``" +msgstr "``'r'``" + +msgid "String (converts any Python object using :func:`repr`)." +msgstr "" + +msgid "``'s'``" +msgstr "``'s'``" + +msgid "String (converts any Python object using :func:`str`)." +msgstr "" + +msgid "``'a'``" +msgstr "``'a'``" + +msgid "String (converts any Python object using :func:`ascii`)." +msgstr "" + +msgid "``'%'``" +msgstr "``'%'``" + +msgid "No argument is converted, results in a ``'%'`` character in the result." +msgstr "" + +msgid "" +"For floating-point formats, the result should be correctly rounded to a " +"given precision ``p`` of digits after the decimal point. The rounding mode " +"matches that of the :func:`round` builtin." +msgstr "" + +msgid "" +"The alternate form causes a leading octal specifier (``'0o'``) to be " +"inserted before the first digit." +msgstr "" + +msgid "" +"The alternate form causes a leading ``'0x'`` or ``'0X'`` (depending on " +"whether the ``'x'`` or ``'X'`` format was used) to be inserted before the " +"first digit." +msgstr "" + +msgid "" +"The alternate form causes the result to always contain a decimal point, even " +"if no digits follow it." +msgstr "" + +msgid "" +"The precision determines the number of digits after the decimal point and " +"defaults to 6." +msgstr "" + +msgid "" +"The alternate form causes the result to always contain a decimal point, and " +"trailing zeroes are not removed as they would otherwise be." +msgstr "" + +msgid "" +"The precision determines the number of significant digits before and after " +"the decimal point and defaults to 6." +msgstr "" + +msgid "If precision is ``N``, the output is truncated to ``N`` characters." +msgstr "" + +msgid "See :pep:`237`." +msgstr "Zob. :pep:`237`." + +msgid "" +"Since Python strings have an explicit length, ``%s`` conversions do not " +"assume that ``'\\0'`` is the end of the string." +msgstr "" + +msgid "" +"``%f`` conversions for numbers whose absolute value is over 1e50 are no " +"longer replaced by ``%g`` conversions." +msgstr "" + +msgid "" +"Binary Sequence Types " +"--- :class:`bytes`, :class:`bytearray`, :class:`memoryview`" +msgstr "" + +msgid "" +"The core built-in types for manipulating binary data are :class:`bytes` " +"and :class:`bytearray`. They are supported by :class:`memoryview` which uses " +"the :ref:`buffer protocol ` to access the memory of other " +"binary objects without needing to make a copy." +msgstr "" + +msgid "" +"The :mod:`array` module supports efficient storage of basic data types like " +"32-bit integers and IEEE754 double-precision floating values." +msgstr "" + +msgid "Bytes Objects" +msgstr "" + +msgid "" +"Bytes objects are immutable sequences of single bytes. Since many major " +"binary protocols are based on the ASCII text encoding, bytes objects offer " +"several methods that are only valid when working with ASCII compatible data " +"and are closely related to string objects in a variety of other ways." +msgstr "" + +msgid "" +"Firstly, the syntax for bytes literals is largely the same as that for " +"string literals, except that a ``b`` prefix is added:" +msgstr "" + +msgid "Single quotes: ``b'still allows embedded \"double\" quotes'``" +msgstr "" + +msgid "Double quotes: ``b\"still allows embedded 'single' quotes\"``" +msgstr "" + +msgid "" +"Triple quoted: ``b'''3 single quotes'''``, ``b\"\"\"3 double quotes\"\"\"``" +msgstr "" + +msgid "" +"Only ASCII characters are permitted in bytes literals (regardless of the " +"declared source code encoding). Any binary values over 127 must be entered " +"into bytes literals using the appropriate escape sequence." +msgstr "" + +msgid "" +"As with string literals, bytes literals may also use a ``r`` prefix to " +"disable processing of escape sequences. See :ref:`strings` for more about " +"the various forms of bytes literal, including supported escape sequences." +msgstr "" + +msgid "" +"While bytes literals and representations are based on ASCII text, bytes " +"objects actually behave like immutable sequences of integers, with each " +"value in the sequence restricted such that ``0 <= x < 256`` (attempts to " +"violate this restriction will trigger :exc:`ValueError`). This is done " +"deliberately to emphasise that while many binary formats include ASCII based " +"elements and can be usefully manipulated with some text-oriented algorithms, " +"this is not generally the case for arbitrary binary data (blindly applying " +"text processing algorithms to binary data formats that are not ASCII " +"compatible will usually lead to data corruption)." +msgstr "" + +msgid "" +"In addition to the literal forms, bytes objects can be created in a number " +"of other ways:" +msgstr "" + +msgid "A zero-filled bytes object of a specified length: ``bytes(10)``" +msgstr "" + +msgid "From an iterable of integers: ``bytes(range(20))``" +msgstr "" + +msgid "Copying existing binary data via the buffer protocol: ``bytes(obj)``" +msgstr "" + +msgid "Also see the :ref:`bytes ` built-in." +msgstr "" + +msgid "" +"Since 2 hexadecimal digits correspond precisely to a single byte, " +"hexadecimal numbers are a commonly used format for describing binary data. " +"Accordingly, the bytes type has an additional class method to read data in " +"that format:" +msgstr "" + +msgid "" +"This :class:`bytes` class method returns a bytes object, decoding the given " +"string object. The string must contain two hexadecimal digits per byte, " +"with ASCII whitespace being ignored." +msgstr "" + +msgid "" +":meth:`bytes.fromhex` now skips all ASCII whitespace in the string, not just " +"spaces." +msgstr "" + +msgid "" +"A reverse conversion function exists to transform a bytes object into its " +"hexadecimal representation." +msgstr "" + +msgid "" +"Return a string object containing two hexadecimal digits for each byte in " +"the instance." +msgstr "" + +msgid "" +"If you want to make the hex string easier to read, you can specify a single " +"character separator *sep* parameter to include in the output. By default, " +"this separator will be included between each byte. A second optional " +"*bytes_per_sep* parameter controls the spacing. Positive values calculate " +"the separator position from the right, negative values from the left." +msgstr "" + +msgid "" +":meth:`bytes.hex` now supports optional *sep* and *bytes_per_sep* parameters " +"to insert separators between bytes in the hex output." +msgstr "" + +msgid "" +"Since bytes objects are sequences of integers (akin to a tuple), for a bytes " +"object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be a bytes " +"object of length 1. (This contrasts with text strings, where both indexing " +"and slicing will produce a string of length 1)" +msgstr "" + +msgid "" +"The representation of bytes objects uses the literal format (``b'...'``) " +"since it is often more useful than e.g. ``bytes([46, 46, 46])``. You can " +"always convert a bytes object into a list of integers using ``list(b)``." +msgstr "" + +msgid "Bytearray Objects" +msgstr "" + +msgid "" +":class:`bytearray` objects are a mutable counterpart to :class:`bytes` " +"objects." +msgstr "" + +msgid "" +"There is no dedicated literal syntax for bytearray objects, instead they are " +"always created by calling the constructor:" +msgstr "" + +msgid "Creating an empty instance: ``bytearray()``" +msgstr "" + +msgid "Creating a zero-filled instance with a given length: ``bytearray(10)``" +msgstr "" + +msgid "From an iterable of integers: ``bytearray(range(20))``" +msgstr "" + +msgid "" +"Copying existing binary data via the buffer protocol: ``bytearray(b'Hi!')``" +msgstr "" + +msgid "" +"As bytearray objects are mutable, they support the :ref:`mutable ` sequence operations in addition to the common bytes and bytearray " +"operations described in :ref:`bytes-methods`." +msgstr "" + +msgid "Also see the :ref:`bytearray ` built-in." +msgstr "" + +msgid "" +"Since 2 hexadecimal digits correspond precisely to a single byte, " +"hexadecimal numbers are a commonly used format for describing binary data. " +"Accordingly, the bytearray type has an additional class method to read data " +"in that format:" +msgstr "" + +msgid "" +"This :class:`bytearray` class method returns a bytearray object, decoding " +"the given string object. The string must contain two hexadecimal digits per " +"byte, with ASCII whitespace being ignored." +msgstr "" + +msgid "" +":meth:`bytearray.fromhex` now skips all ASCII whitespace in the string, not " +"just spaces." +msgstr "" + +msgid "" +"A reverse conversion function exists to transform a bytearray object into " +"its hexadecimal representation." +msgstr "" + +msgid "" +"Similar to :meth:`bytes.hex`, :meth:`bytearray.hex` now supports optional " +"*sep* and *bytes_per_sep* parameters to insert separators between bytes in " +"the hex output." +msgstr "" + +msgid "" +"Since bytearray objects are sequences of integers (akin to a list), for a " +"bytearray object *b*, ``b[0]`` will be an integer, while ``b[0:1]`` will be " +"a bytearray object of length 1. (This contrasts with text strings, where " +"both indexing and slicing will produce a string of length 1)" +msgstr "" + +msgid "" +"The representation of bytearray objects uses the bytes literal format " +"(``bytearray(b'...')``) since it is often more useful than e.g. " +"``bytearray([46, 46, 46])``. You can always convert a bytearray object into " +"a list of integers using ``list(b)``." +msgstr "" + +msgid "Bytes and Bytearray Operations" +msgstr "" + +msgid "" +"Both bytes and bytearray objects support the :ref:`common ` " +"sequence operations. They interoperate not just with operands of the same " +"type, but with any :term:`bytes-like object`. Due to this flexibility, they " +"can be freely mixed in operations without causing errors. However, the " +"return type of the result may depend on the order of operands." +msgstr "" + +msgid "" +"The methods on bytes and bytearray objects don't accept strings as their " +"arguments, just as the methods on strings don't accept bytes as their " +"arguments. For example, you have to write::" +msgstr "" + +msgid "" +"a = \"abc\"\n" +"b = a.replace(\"a\", \"f\")" +msgstr "" + +msgid "and::" +msgstr "" + +msgid "" +"a = b\"abc\"\n" +"b = a.replace(b\"a\", b\"f\")" +msgstr "" + +msgid "" +"Some bytes and bytearray operations assume the use of ASCII compatible " +"binary formats, and hence should be avoided when working with arbitrary " +"binary data. These restrictions are covered below." +msgstr "" + +msgid "" +"Using these ASCII based operations to manipulate binary data that is not " +"stored in an ASCII based format may lead to data corruption." +msgstr "" + +msgid "" +"The following methods on bytes and bytearray objects can be used with " +"arbitrary binary data." +msgstr "" + +msgid "" +"Return the number of non-overlapping occurrences of subsequence *sub* in the " +"range [*start*, *end*]. Optional arguments *start* and *end* are " +"interpreted as in slice notation." +msgstr "" + +msgid "" +"The subsequence to search for may be any :term:`bytes-like object` or an " +"integer in the range 0 to 255." +msgstr "" + +msgid "" +"If *sub* is empty, returns the number of empty slices between characters " +"which is the length of the bytes object plus one." +msgstr "" + +msgid "Also accept an integer in the range 0 to 255 as the subsequence." +msgstr "" + +msgid "" +"If the binary data starts with the *prefix* string, return " +"``bytes[len(prefix):]``. Otherwise, return a copy of the original binary " +"data::" +msgstr "" + +msgid "" +">>> b'TestHook'.removeprefix(b'Test')\n" +"b'Hook'\n" +">>> b'BaseTestCase'.removeprefix(b'Test')\n" +"b'BaseTestCase'" +msgstr "" +">>> b'TestHook'.removeprefix(b'Test')\n" +"b'Hook'\n" +">>> b'BaseTestCase'.removeprefix(b'Test')\n" +"b'BaseTestCase'" + +msgid "The *prefix* may be any :term:`bytes-like object`." +msgstr "" + +msgid "" +"The bytearray version of this method does *not* operate in place - it always " +"produces a new object, even if no changes were made." +msgstr "" + +msgid "" +"If the binary data ends with the *suffix* string and that *suffix* is not " +"empty, return ``bytes[:-len(suffix)]``. Otherwise, return a copy of the " +"original binary data::" +msgstr "" + +msgid "" +">>> b'MiscTests'.removesuffix(b'Tests')\n" +"b'Misc'\n" +">>> b'TmpDirMixin'.removesuffix(b'Tests')\n" +"b'TmpDirMixin'" +msgstr "" +">>> b'MiscTests'.removesuffix(b'Tests')\n" +"b'Misc'\n" +">>> b'TmpDirMixin'.removesuffix(b'Tests')\n" +"b'TmpDirMixin'" + +msgid "The *suffix* may be any :term:`bytes-like object`." +msgstr "" + +msgid "Return the bytes decoded to a :class:`str`." +msgstr "" + +msgid "" +"*errors* controls how decoding errors are handled. If ``'strict'`` (the " +"default), a :exc:`UnicodeError` exception is raised. Other possible values " +"are ``'ignore'``, ``'replace'``, and any other name registered " +"via :func:`codecs.register_error`. See :ref:`error-handlers` for details." +msgstr "" + +msgid "" +"For performance reasons, the value of *errors* is not checked for validity " +"unless a decoding error actually occurs, :ref:`devmode` is enabled or " +"a :ref:`debug build ` is used." +msgstr "" + +msgid "" +"Passing the *encoding* argument to :class:`str` allows decoding " +"any :term:`bytes-like object` directly, without needing to make a " +"temporary :class:`!bytes` or :class:`!bytearray` object." +msgstr "" + +msgid "" +"Return ``True`` if the binary data ends with the specified *suffix*, " +"otherwise return ``False``. *suffix* can also be a tuple of suffixes to " +"look for. With optional *start*, test beginning at that position. With " +"optional *end*, stop comparing at that position." +msgstr "" + +msgid "The suffix(es) to search for may be any :term:`bytes-like object`." +msgstr "" + +msgid "" +"Return the lowest index in the data where the subsequence *sub* is found, " +"such that *sub* is contained in the slice ``s[start:end]``. Optional " +"arguments *start* and *end* are interpreted as in slice notation. Return " +"``-1`` if *sub* is not found." +msgstr "" + +msgid "" +"The :meth:`~bytes.find` method should be used only if you need to know the " +"position of *sub*. To check if *sub* is a substring or not, use " +"the :keyword:`in` operator::" +msgstr "" + +msgid "" +">>> b'Py' in b'Python'\n" +"True" +msgstr "" +">>> b'Py' in b'Python'\n" +"True" + +msgid "" +"Like :meth:`~bytes.find`, but raise :exc:`ValueError` when the subsequence " +"is not found." +msgstr "" + +msgid "" +"Return a bytes or bytearray object which is the concatenation of the binary " +"data sequences in *iterable*. A :exc:`TypeError` will be raised if there " +"are any values in *iterable* that are not :term:`bytes-like objects `, including :class:`str` objects. The separator between " +"elements is the contents of the bytes or bytearray object providing this " +"method." +msgstr "" + +msgid "" +"This static method returns a translation table usable " +"for :meth:`bytes.translate` that will map each character in *from* into the " +"character at the same position in *to*; *from* and *to* must both " +"be :term:`bytes-like objects ` and have the same length." +msgstr "" + +msgid "" +"Split the sequence at the first occurrence of *sep*, and return a 3-tuple " +"containing the part before the separator, the separator itself or its " +"bytearray copy, and the part after the separator. If the separator is not " +"found, return a 3-tuple containing a copy of the original sequence, followed " +"by two empty bytes or bytearray objects." +msgstr "" + +msgid "The separator to search for may be any :term:`bytes-like object`." +msgstr "" + +msgid "" +"Return a copy of the sequence with all occurrences of subsequence *old* " +"replaced by *new*. If the optional argument *count* is given, only the " +"first *count* occurrences are replaced." +msgstr "" + +msgid "" +"The subsequence to search for and its replacement may be any :term:`bytes-" +"like object`." +msgstr "" + +msgid "" +"Return the highest index in the sequence where the subsequence *sub* is " +"found, such that *sub* is contained within ``s[start:end]``. Optional " +"arguments *start* and *end* are interpreted as in slice notation. Return " +"``-1`` on failure." +msgstr "" + +msgid "" +"Like :meth:`~bytes.rfind` but raises :exc:`ValueError` when the subsequence " +"*sub* is not found." +msgstr "" + +msgid "" +"Split the sequence at the last occurrence of *sep*, and return a 3-tuple " +"containing the part before the separator, the separator itself or its " +"bytearray copy, and the part after the separator. If the separator is not " +"found, return a 3-tuple containing two empty bytes or bytearray objects, " +"followed by a copy of the original sequence." +msgstr "" + +msgid "" +"Return ``True`` if the binary data starts with the specified *prefix*, " +"otherwise return ``False``. *prefix* can also be a tuple of prefixes to " +"look for. With optional *start*, test beginning at that position. With " +"optional *end*, stop comparing at that position." +msgstr "" + +msgid "The prefix(es) to search for may be any :term:`bytes-like object`." +msgstr "" + +msgid "" +"Return a copy of the bytes or bytearray object where all bytes occurring in " +"the optional argument *delete* are removed, and the remaining bytes have " +"been mapped through the given translation table, which must be a bytes " +"object of length 256." +msgstr "" + +msgid "" +"You can use the :func:`bytes.maketrans` method to create a translation table." +msgstr "" + +msgid "" +"Set the *table* argument to ``None`` for translations that only delete " +"characters::" +msgstr "" + +msgid "" +">>> b'read this short text'.translate(None, b'aeiou')\n" +"b'rd ths shrt txt'" +msgstr "" +">>> b'read this short text'.translate(None, b'aeiou')\n" +"b'rd ths shrt txt'" + +msgid "*delete* is now supported as a keyword argument." +msgstr "" + +msgid "" +"The following methods on bytes and bytearray objects have default behaviours " +"that assume the use of ASCII compatible binary formats, but can still be " +"used with arbitrary binary data by passing appropriate arguments. Note that " +"all of the bytearray methods in this section do *not* operate in place, and " +"instead produce new objects." +msgstr "" + +msgid "" +"Return a copy of the object centered in a sequence of length *width*. " +"Padding is done using the specified *fillbyte* (default is an ASCII space). " +"For :class:`bytes` objects, the original sequence is returned if *width* is " +"less than or equal to ``len(s)``." +msgstr "" + +msgid "" +"Return a copy of the object left justified in a sequence of length *width*. " +"Padding is done using the specified *fillbyte* (default is an ASCII space). " +"For :class:`bytes` objects, the original sequence is returned if *width* is " +"less than or equal to ``len(s)``." +msgstr "" + +msgid "" +"Return a copy of the sequence with specified leading bytes removed. The " +"*bytes* argument is a binary sequence specifying the set of byte values to " +"be removed. If omitted or ``None``, the *bytes* argument defaults to " +"removing :meth:`ASCII whitespace `. The *bytes* argument is " +"not a prefix; rather, all combinations of its values are stripped::" +msgstr "" + +msgid "" +">>> b' spacious '.lstrip()\n" +"b'spacious '\n" +">>> b'www.example.com'.lstrip(b'cmowz.')\n" +"b'example.com'" +msgstr "" +">>> b' spacious '.lstrip()\n" +"b'spacious '\n" +">>> b'www.example.com'.lstrip(b'cmowz.')\n" +"b'example.com'" + +msgid "" +"The binary sequence of byte values to remove may be any :term:`bytes-like " +"object`. See :meth:`~bytes.removeprefix` for a method that will remove a " +"single prefix string rather than all of a set of characters. For example::" +msgstr "" + +msgid "" +">>> b'Arthur: three!'.lstrip(b'Arthur: ')\n" +"b'ee!'\n" +">>> b'Arthur: three!'.removeprefix(b'Arthur: ')\n" +"b'three!'" +msgstr "" +">>> b'Arthur: three!'.lstrip(b'Arthur: ')\n" +"b'ee!'\n" +">>> b'Arthur: three!'.removeprefix(b'Arthur: ')\n" +"b'three!'" + +msgid "" +"Return a copy of the object right justified in a sequence of length *width*. " +"Padding is done using the specified *fillbyte* (default is an ASCII space). " +"For :class:`bytes` objects, the original sequence is returned if *width* is " +"less than or equal to ``len(s)``." +msgstr "" + +msgid "" +"Split the binary sequence into subsequences of the same type, using *sep* as " +"the delimiter string. If *maxsplit* is given, at most *maxsplit* splits are " +"done, the *rightmost* ones. If *sep* is not specified or ``None``, any " +"subsequence consisting solely of :meth:`ASCII whitespace ` is " +"a separator. Except for splitting from the right, :meth:`rsplit` behaves " +"like :meth:`split` which is described in detail below." +msgstr "" + +msgid "" +"Return a copy of the sequence with specified trailing bytes removed. The " +"*bytes* argument is a binary sequence specifying the set of byte values to " +"be removed. If omitted or ``None``, the *bytes* argument defaults to " +"removing :meth:`ASCII whitespace `. The *bytes* argument is " +"not a suffix; rather, all combinations of its values are stripped::" +msgstr "" + +msgid "" +">>> b' spacious '.rstrip()\n" +"b' spacious'\n" +">>> b'mississippi'.rstrip(b'ipz')\n" +"b'mississ'" +msgstr "" +">>> b' spacious '.rstrip()\n" +"b' spacious'\n" +">>> b'mississippi'.rstrip(b'ipz')\n" +"b'mississ'" + +msgid "" +"The binary sequence of byte values to remove may be any :term:`bytes-like " +"object`. See :meth:`~bytes.removesuffix` for a method that will remove a " +"single suffix string rather than all of a set of characters. For example::" +msgstr "" + +msgid "" +">>> b'Monty Python'.rstrip(b' Python')\n" +"b'M'\n" +">>> b'Monty Python'.removesuffix(b' Python')\n" +"b'Monty'" +msgstr "" +">>> b'Monty Python'.rstrip(b' Python')\n" +"b'M'\n" +">>> b'Monty Python'.removesuffix(b' Python')\n" +"b'Monty'" + +msgid "" +"Split the binary sequence into subsequences of the same type, using *sep* as " +"the delimiter string. If *maxsplit* is given and non-negative, at most " +"*maxsplit* splits are done (thus, the list will have at most ``maxsplit+1`` " +"elements). If *maxsplit* is not specified or is ``-1``, then there is no " +"limit on the number of splits (all possible splits are made)." +msgstr "" + +msgid "" +"If *sep* is given, consecutive delimiters are not grouped together and are " +"deemed to delimit empty subsequences (for example, ``b'1,,2'.split(b',')`` " +"returns ``[b'1', b'', b'2']``). The *sep* argument may consist of a " +"multibyte sequence as a single delimiter. Splitting an empty sequence with a " +"specified separator returns ``[b'']`` or ``[bytearray(b'')]`` depending on " +"the type of object being split. The *sep* argument may be any :term:`bytes-" +"like object`." +msgstr "" + +msgid "" +">>> b'1,2,3'.split(b',')\n" +"[b'1', b'2', b'3']\n" +">>> b'1,2,3'.split(b',', maxsplit=1)\n" +"[b'1', b'2,3']\n" +">>> b'1,2,,3,'.split(b',')\n" +"[b'1', b'2', b'', b'3', b'']\n" +">>> b'1<>2<>3<4'.split(b'<>')\n" +"[b'1', b'2', b'3<4']" +msgstr "" + +msgid "" +"If *sep* is not specified or is ``None``, a different splitting algorithm is " +"applied: runs of consecutive :meth:`ASCII whitespace ` are " +"regarded as a single separator, and the result will contain no empty strings " +"at the start or end if the sequence has leading or trailing whitespace. " +"Consequently, splitting an empty sequence or a sequence consisting solely of " +"ASCII whitespace without a specified separator returns ``[]``." +msgstr "" + +msgid "" +">>> b'1 2 3'.split()\n" +"[b'1', b'2', b'3']\n" +">>> b'1 2 3'.split(maxsplit=1)\n" +"[b'1', b'2 3']\n" +">>> b' 1 2 3 '.split()\n" +"[b'1', b'2', b'3']" +msgstr "" + +msgid "" +"Return a copy of the sequence with specified leading and trailing bytes " +"removed. The *bytes* argument is a binary sequence specifying the set of " +"byte values to be removed. If omitted or ``None``, the *bytes* argument " +"defaults to removing :meth:`ASCII whitespace `. The *bytes* " +"argument is not a prefix or suffix; rather, all combinations of its values " +"are stripped::" +msgstr "" + +msgid "" +">>> b' spacious '.strip()\n" +"b'spacious'\n" +">>> b'www.example.com'.strip(b'cmowz.')\n" +"b'example'" +msgstr "" +">>> b' spacious '.strip()\n" +"b'spacious'\n" +">>> b'www.example.com'.strip(b'cmowz.')\n" +"b'example'" + +msgid "" +"The binary sequence of byte values to remove may be any :term:`bytes-like " +"object`." +msgstr "" + +msgid "" +"The following methods on bytes and bytearray objects assume the use of ASCII " +"compatible binary formats and should not be applied to arbitrary binary " +"data. Note that all of the bytearray methods in this section do *not* " +"operate in place, and instead produce new objects." +msgstr "" + +msgid "" +"Return a copy of the sequence with each byte interpreted as an ASCII " +"character, and the first byte capitalized and the rest lowercased. Non-ASCII " +"byte values are passed through unchanged." +msgstr "" + +msgid "" +"Return a copy of the sequence where all ASCII tab characters are replaced by " +"one or more ASCII spaces, depending on the current column and the given tab " +"size. Tab positions occur every *tabsize* bytes (default is 8, giving tab " +"positions at columns 0, 8, 16 and so on). To expand the sequence, the " +"current column is set to zero and the sequence is examined byte by byte. If " +"the byte is an ASCII tab character (``b'\\t'``), one or more space " +"characters are inserted in the result until the current column is equal to " +"the next tab position. (The tab character itself is not copied.) If the " +"current byte is an ASCII newline (``b'\\n'``) or carriage return " +"(``b'\\r'``), it is copied and the current column is reset to zero. Any " +"other byte value is copied unchanged and the current column is incremented " +"by one regardless of how the byte value is represented when printed::" +msgstr "" + +msgid "" +">>> b'01\\t012\\t0123\\t01234'.expandtabs()\n" +"b'01 012 0123 01234'\n" +">>> b'01\\t012\\t0123\\t01234'.expandtabs(4)\n" +"b'01 012 0123 01234'" +msgstr "" +">>> b'01\\t012\\t0123\\t01234'.expandtabs()\n" +"b'01 012 0123 01234'\n" +">>> b'01\\t012\\t0123\\t01234'.expandtabs(4)\n" +"b'01 012 0123 01234'" + +msgid "" +"Return ``True`` if all bytes in the sequence are alphabetical ASCII " +"characters or ASCII decimal digits and the sequence is not empty, ``False`` " +"otherwise. Alphabetic ASCII characters are those byte values in the sequence " +"``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``. ASCII decimal " +"digits are those byte values in the sequence ``b'0123456789'``." +msgstr "" + +msgid "" +">>> b'ABCabc1'.isalnum()\n" +"True\n" +">>> b'ABC abc1'.isalnum()\n" +"False" +msgstr "" +">>> b'ABCabc1'.isalnum()\n" +"True\n" +">>> b'ABC abc1'.isalnum()\n" +"False" + +msgid "" +"Return ``True`` if all bytes in the sequence are alphabetic ASCII characters " +"and the sequence is not empty, ``False`` otherwise. Alphabetic ASCII " +"characters are those byte values in the sequence " +"``b'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'``." +msgstr "" + +msgid "" +">>> b'ABCabc'.isalpha()\n" +"True\n" +">>> b'ABCabc1'.isalpha()\n" +"False" +msgstr "" +">>> b'ABCabc'.isalpha()\n" +"True\n" +">>> b'ABCabc1'.isalpha()\n" +"False" + +msgid "" +"Return ``True`` if the sequence is empty or all bytes in the sequence are " +"ASCII, ``False`` otherwise. ASCII bytes are in the range 0-0x7F." +msgstr "" + +msgid "" +"Return ``True`` if all bytes in the sequence are ASCII decimal digits and " +"the sequence is not empty, ``False`` otherwise. ASCII decimal digits are " +"those byte values in the sequence ``b'0123456789'``." +msgstr "" + +msgid "" +">>> b'1234'.isdigit()\n" +"True\n" +">>> b'1.23'.isdigit()\n" +"False" +msgstr "" +">>> b'1234'.isdigit()\n" +"True\n" +">>> b'1.23'.isdigit()\n" +"False" + +msgid "" +"Return ``True`` if there is at least one lowercase ASCII character in the " +"sequence and no uppercase ASCII characters, ``False`` otherwise." +msgstr "" + +msgid "" +">>> b'hello world'.islower()\n" +"True\n" +">>> b'Hello world'.islower()\n" +"False" +msgstr "" +">>> b'hello world'.islower()\n" +"True\n" +">>> b'Hello world'.islower()\n" +"False" + +msgid "" +"Lowercase ASCII characters are those byte values in the sequence " +"``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " +"values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``." +msgstr "" + +msgid "" +"Return ``True`` if all bytes in the sequence are ASCII whitespace and the " +"sequence is not empty, ``False`` otherwise. ASCII whitespace characters are " +"those byte values in the sequence ``b' \\t\\n\\r\\x0b\\f'`` (space, tab, " +"newline, carriage return, vertical tab, form feed)." +msgstr "" + +msgid "" +"Return ``True`` if the sequence is ASCII titlecase and the sequence is not " +"empty, ``False`` otherwise. See :meth:`bytes.title` for more details on the " +"definition of \"titlecase\"." +msgstr "" + +msgid "" +">>> b'Hello World'.istitle()\n" +"True\n" +">>> b'Hello world'.istitle()\n" +"False" +msgstr "" +">>> b'Hello World'.istitle()\n" +"True\n" +">>> b'Hello world'.istitle()\n" +"False" + +msgid "" +"Return ``True`` if there is at least one uppercase alphabetic ASCII " +"character in the sequence and no lowercase ASCII characters, ``False`` " +"otherwise." +msgstr "" + +msgid "" +">>> b'HELLO WORLD'.isupper()\n" +"True\n" +">>> b'Hello world'.isupper()\n" +"False" +msgstr "" +">>> b'HELLO WORLD'.isupper()\n" +"True\n" +">>> b'Hello world'.isupper()\n" +"False" + +msgid "" +"Return a copy of the sequence with all the uppercase ASCII characters " +"converted to their corresponding lowercase counterpart." +msgstr "" + +msgid "" +">>> b'Hello World'.lower()\n" +"b'hello world'" +msgstr "" +">>> b'Hello World'.lower()\n" +"b'hello world'" + +msgid "" +"Return a list of the lines in the binary sequence, breaking at ASCII line " +"boundaries. This method uses the :term:`universal newlines` approach to " +"splitting lines. Line breaks are not included in the resulting list unless " +"*keepends* is given and true." +msgstr "" + +msgid "" +">>> b'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines()\n" +"[b'ab c', b'', b'de fg', b'kl']\n" +">>> b'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines(keepends=True)\n" +"[b'ab c\\n', b'\\n', b'de fg\\r', b'kl\\r\\n']" +msgstr "" + +msgid "" +"Unlike :meth:`~bytes.split` when a delimiter string *sep* is given, this " +"method returns an empty list for the empty string, and a terminal line break " +"does not result in an extra line::" +msgstr "" + +msgid "" +">>> b\"\".split(b'\\n'), b\"Two lines\\n\".split(b'\\n')\n" +"([b''], [b'Two lines', b''])\n" +">>> b\"\".splitlines(), b\"One line\\n\".splitlines()\n" +"([], [b'One line'])" +msgstr "" + +msgid "" +"Return a copy of the sequence with all the lowercase ASCII characters " +"converted to their corresponding uppercase counterpart and vice-versa." +msgstr "" + +msgid "" +">>> b'Hello World'.swapcase()\n" +"b'hELLO wORLD'" +msgstr "" +">>> b'Hello World'.swapcase()\n" +"b'hELLO wORLD'" + +msgid "" +"Unlike :func:`str.swapcase`, it is always the case that " +"``bin.swapcase().swapcase() == bin`` for the binary versions. Case " +"conversions are symmetrical in ASCII, even though that is not generally true " +"for arbitrary Unicode code points." +msgstr "" + +msgid "" +"Return a titlecased version of the binary sequence where words start with an " +"uppercase ASCII character and the remaining characters are lowercase. " +"Uncased byte values are left unmodified." +msgstr "" + +msgid "" +">>> b'Hello world'.title()\n" +"b'Hello World'" +msgstr "" +">>> b'Hello world'.title()\n" +"b'Hello World'" + +msgid "" +"Lowercase ASCII characters are those byte values in the sequence " +"``b'abcdefghijklmnopqrstuvwxyz'``. Uppercase ASCII characters are those byte " +"values in the sequence ``b'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``. All other byte " +"values are uncased." +msgstr "" + +msgid "" +">>> b\"they're bill's friends from the UK\".title()\n" +"b\"They'Re Bill'S Friends From The Uk\"" +msgstr "" +">>> b\"they're bill's friends from the UK\".title()\n" +"b\"They'Re Bill'S Friends From The Uk\"" + +msgid "" +"A workaround for apostrophes can be constructed using regular expressions::" +msgstr "" + +msgid "" +">>> import re\n" +">>> def titlecase(s):\n" +"... return re.sub(rb\"[A-Za-z]+('[A-Za-z]+)?\",\n" +"... lambda mo: mo.group(0)[0:1].upper() +\n" +"... mo.group(0)[1:].lower(),\n" +"... s)\n" +"...\n" +">>> titlecase(b\"they're bill's friends.\")\n" +"b\"They're Bill's Friends.\"" +msgstr "" + +msgid "" +"Return a copy of the sequence with all the lowercase ASCII characters " +"converted to their corresponding uppercase counterpart." +msgstr "" + +msgid "" +">>> b'Hello World'.upper()\n" +"b'HELLO WORLD'" +msgstr "" +">>> b'Hello World'.upper()\n" +"b'HELLO WORLD'" + +msgid "" +"Return a copy of the sequence left filled with ASCII ``b'0'`` digits to make " +"a sequence of length *width*. A leading sign prefix (``b'+'``/ ``b'-'``) is " +"handled by inserting the padding *after* the sign character rather than " +"before. For :class:`bytes` objects, the original sequence is returned if " +"*width* is less than or equal to ``len(seq)``." +msgstr "" + +msgid "" +">>> b\"42\".zfill(5)\n" +"b'00042'\n" +">>> b\"-42\".zfill(5)\n" +"b'-0042'" +msgstr "" +">>> b\"42\".zfill(5)\n" +"b'00042'\n" +">>> b\"-42\".zfill(5)\n" +"b'-0042'" + +msgid "``printf``-style Bytes Formatting" +msgstr "" + +msgid "" +"The formatting operations described here exhibit a variety of quirks that " +"lead to a number of common errors (such as failing to display tuples and " +"dictionaries correctly). If the value being printed may be a tuple or " +"dictionary, wrap it in a tuple." +msgstr "" + +msgid "" +"Bytes objects (``bytes``/``bytearray``) have one unique built-in operation: " +"the ``%`` operator (modulo). This is also known as the bytes *formatting* or " +"*interpolation* operator. Given ``format % values`` (where *format* is a " +"bytes object), ``%`` conversion specifications in *format* are replaced with " +"zero or more elements of *values*. The effect is similar to using " +"the :c:func:`sprintf` function in the C language." +msgstr "" + +msgid "" +"If *format* requires a single argument, *values* may be a single non-tuple " +"object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " +"items specified by the format bytes object, or a single mapping object (for " +"example, a dictionary)." +msgstr "" + +msgid "" +"When the right argument is a dictionary (or other mapping type), then the " +"formats in the bytes object *must* include a parenthesised mapping key into " +"that dictionary inserted immediately after the ``'%'`` character. The " +"mapping key selects the value to be formatted from the mapping. For example:" +msgstr "" + +msgid "\\(8)" +msgstr "\\(8)" + +msgid "Single byte (accepts integer or single byte objects)." +msgstr "" + +msgid "``'b'``" +msgstr "``'b'``" + +msgid "" +"Bytes (any object that follows the :ref:`buffer protocol ` or " +"has :meth:`~object.__bytes__`)." +msgstr "" + +msgid "" +"``'s'`` is an alias for ``'b'`` and should only be used for Python2/3 code " +"bases." +msgstr "" + +msgid "" +"Bytes (converts any Python object using ``repr(obj).encode('ascii', " +"'backslashreplace')``)." +msgstr "" + +msgid "" +"``'r'`` is an alias for ``'a'`` and should only be used for Python2/3 code " +"bases." +msgstr "" + +msgid "\\(7)" +msgstr "\\(7)" + +msgid "``b'%s'`` is deprecated, but will not be removed during the 3.x series." +msgstr "" + +msgid "``b'%r'`` is deprecated, but will not be removed during the 3.x series." +msgstr "" + +msgid ":pep:`461` - Adding % formatting to bytes and bytearray" +msgstr "" + +msgid "Memory Views" +msgstr "" + +msgid "" +":class:`memoryview` objects allow Python code to access the internal data of " +"an object that supports the :ref:`buffer protocol ` without " +"copying." +msgstr "" + +msgid "" +"Create a :class:`memoryview` that references *object*. *object* must " +"support the buffer protocol. Built-in objects that support the buffer " +"protocol include :class:`bytes` and :class:`bytearray`." +msgstr "" + +msgid "" +"A :class:`memoryview` has the notion of an *element*, which is the atomic " +"memory unit handled by the originating *object*. For many simple types such " +"as :class:`bytes` and :class:`bytearray`, an element is a single byte, but " +"other types such as :class:`array.array` may have bigger elements." +msgstr "" + +msgid "" +"``len(view)`` is equal to the length of :class:`~memoryview.tolist`, which " +"is the nested list representation of the view. If ``view.ndim == 1``, this " +"is equal to the number of elements in the view." +msgstr "" + +msgid "" +"If ``view.ndim == 0``, ``len(view)`` now raises :exc:`TypeError` instead of " +"returning 1." +msgstr "" + +msgid "" +"The :class:`~memoryview.itemsize` attribute will give you the number of " +"bytes in a single element." +msgstr "" + +msgid "" +"A :class:`memoryview` supports slicing and indexing to expose its data. One-" +"dimensional slicing will result in a subview::" +msgstr "" + +msgid "" +">>> v = memoryview(b'abcefg')\n" +">>> v[1]\n" +"98\n" +">>> v[-1]\n" +"103\n" +">>> v[1:4]\n" +"\n" +">>> bytes(v[1:4])\n" +"b'bce'" +msgstr "" + +msgid "" +"If :class:`~memoryview.format` is one of the native format specifiers from " +"the :mod:`struct` module, indexing with an integer or a tuple of integers is " +"also supported and returns a single *element* with the correct type. One-" +"dimensional memoryviews can be indexed with an integer or a one-integer " +"tuple. Multi-dimensional memoryviews can be indexed with tuples of exactly " +"*ndim* integers where *ndim* is the number of dimensions. Zero-dimensional " +"memoryviews can be indexed with the empty tuple." +msgstr "" + +msgid "Here is an example with a non-byte format::" +msgstr "" + +msgid "" +">>> import array\n" +">>> a = array.array('l', [-11111111, 22222222, -33333333, 44444444])\n" +">>> m = memoryview(a)\n" +">>> m[0]\n" +"-11111111\n" +">>> m[-1]\n" +"44444444\n" +">>> m[::2].tolist()\n" +"[-11111111, -33333333]" +msgstr "" + +msgid "" +"If the underlying object is writable, the memoryview supports one-" +"dimensional slice assignment. Resizing is not allowed::" +msgstr "" + +msgid "" +">>> data = bytearray(b'abcefg')\n" +">>> v = memoryview(data)\n" +">>> v.readonly\n" +"False\n" +">>> v[0] = ord(b'z')\n" +">>> data\n" +"bytearray(b'zbcefg')\n" +">>> v[1:4] = b'123'\n" +">>> data\n" +"bytearray(b'z123fg')\n" +">>> v[2:3] = b'spam'\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"ValueError: memoryview assignment: lvalue and rvalue have different " +"structures\n" +">>> v[2:6] = b'spam'\n" +">>> data\n" +"bytearray(b'z1spam')" +msgstr "" + +msgid "" +"One-dimensional memoryviews of :term:`hashable` (read-only) types with " +"formats 'B', 'b' or 'c' are also hashable. The hash is defined as ``hash(m) " +"== hash(m.tobytes())``::" +msgstr "" + +msgid "" +">>> v = memoryview(b'abcefg')\n" +">>> hash(v) == hash(b'abcefg')\n" +"True\n" +">>> hash(v[2:4]) == hash(b'ce')\n" +"True\n" +">>> hash(v[::-2]) == hash(b'abcefg'[::-2])\n" +"True" +msgstr "" + +msgid "" +"One-dimensional memoryviews can now be sliced. One-dimensional memoryviews " +"with formats 'B', 'b' or 'c' are now :term:`hashable`." +msgstr "" + +msgid "" +"memoryview is now registered automatically " +"with :class:`collections.abc.Sequence`" +msgstr "" + +msgid "memoryviews can now be indexed with a tuple of integers." +msgstr "" + +msgid ":class:`memoryview` has several methods:" +msgstr "" + +msgid "" +"A memoryview and a :pep:`3118` exporter are equal if their shapes are " +"equivalent and if all corresponding values are equal when the operands' " +"respective format codes are interpreted using :mod:`struct` syntax." +msgstr "" + +msgid "" +"For the subset of :mod:`struct` format strings currently supported " +"by :meth:`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == " +"w.tolist()``::" +msgstr "" + +msgid "" +">>> import array\n" +">>> a = array.array('I', [1, 2, 3, 4, 5])\n" +">>> b = array.array('d', [1.0, 2.0, 3.0, 4.0, 5.0])\n" +">>> c = array.array('b', [5, 3, 1])\n" +">>> x = memoryview(a)\n" +">>> y = memoryview(b)\n" +">>> x == a == y == b\n" +"True\n" +">>> x.tolist() == a.tolist() == y.tolist() == b.tolist()\n" +"True\n" +">>> z = y[::-2]\n" +">>> z == c\n" +"True\n" +">>> z.tolist() == c.tolist()\n" +"True" +msgstr "" + +msgid "" +"If either format string is not supported by the :mod:`struct` module, then " +"the objects will always compare as unequal (even if the format strings and " +"buffer contents are identical)::" +msgstr "" + +msgid "" +">>> from ctypes import BigEndianStructure, c_long\n" +">>> class BEPoint(BigEndianStructure):\n" +"... _fields_ = [(\"x\", c_long), (\"y\", c_long)]\n" +"...\n" +">>> point = BEPoint(100, 200)\n" +">>> a = memoryview(point)\n" +">>> b = memoryview(point)\n" +">>> a == point\n" +"False\n" +">>> a == b\n" +"False" +msgstr "" + +msgid "" +"Note that, as with floating-point numbers, ``v is w`` does *not* imply ``v " +"== w`` for memoryview objects." +msgstr "" + +msgid "" +"Previous versions compared the raw memory disregarding the item format and " +"the logical array structure." +msgstr "" + +msgid "" +"Return the data in the buffer as a bytestring. This is equivalent to " +"calling the :class:`bytes` constructor on the memoryview. ::" +msgstr "" + +msgid "" +">>> m = memoryview(b\"abc\")\n" +">>> m.tobytes()\n" +"b'abc'\n" +">>> bytes(m)\n" +"b'abc'" +msgstr "" +">>> m = memoryview(b\"abc\")\n" +">>> m.tobytes()\n" +"b'abc'\n" +">>> bytes(m)\n" +"b'abc'" + +msgid "" +"For non-contiguous arrays the result is equal to the flattened list " +"representation with all elements converted to bytes. :meth:`tobytes` " +"supports all format strings, including those that are not in :mod:`struct` " +"module syntax." +msgstr "" + +msgid "" +"*order* can be {'C', 'F', 'A'}. When *order* is 'C' or 'F', the data of the " +"original array is converted to C or Fortran order. For contiguous views, 'A' " +"returns an exact copy of the physical memory. In particular, in-memory " +"Fortran order is preserved. For non-contiguous views, the data is converted " +"to C first. *order=None* is the same as *order='C'*." +msgstr "" + +msgid "" +"Return a string object containing two hexadecimal digits for each byte in " +"the buffer. ::" +msgstr "" + +msgid "" +">>> m = memoryview(b\"abc\")\n" +">>> m.hex()\n" +"'616263'" +msgstr "" +">>> m = memoryview(b\"abc\")\n" +">>> m.hex()\n" +"'616263'" + +msgid "" +"Similar to :meth:`bytes.hex`, :meth:`memoryview.hex` now supports optional " +"*sep* and *bytes_per_sep* parameters to insert separators between bytes in " +"the hex output." +msgstr "" + +msgid "Return the data in the buffer as a list of elements. ::" +msgstr "" + +msgid "" +">>> memoryview(b'abc').tolist()\n" +"[97, 98, 99]\n" +">>> import array\n" +">>> a = array.array('d', [1.1, 2.2, 3.3])\n" +">>> m = memoryview(a)\n" +">>> m.tolist()\n" +"[1.1, 2.2, 3.3]" +msgstr "" + +msgid "" +":meth:`tolist` now supports all single character native formats " +"in :mod:`struct` module syntax as well as multi-dimensional representations." +msgstr "" + +msgid "" +"Return a readonly version of the memoryview object. The original memoryview " +"object is unchanged. ::" +msgstr "" + +msgid "" +">>> m = memoryview(bytearray(b'abc'))\n" +">>> mm = m.toreadonly()\n" +">>> mm.tolist()\n" +"[97, 98, 99]\n" +">>> mm[0] = 42\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"TypeError: cannot modify read-only memory\n" +">>> m[0] = 43\n" +">>> mm.tolist()\n" +"[43, 98, 99]" +msgstr "" + +msgid "" +"Release the underlying buffer exposed by the memoryview object. Many " +"objects take special actions when a view is held on them (for example, " +"a :class:`bytearray` would temporarily forbid resizing); therefore, calling " +"release() is handy to remove these restrictions (and free any dangling " +"resources) as soon as possible." +msgstr "" + +msgid "" +"After this method has been called, any further operation on the view raises " +"a :class:`ValueError` (except :meth:`release` itself which can be called " +"multiple times)::" +msgstr "" + +msgid "" +">>> m = memoryview(b'abc')\n" +">>> m.release()\n" +">>> m[0]\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"ValueError: operation forbidden on released memoryview object" +msgstr "" + +msgid "" +"The context management protocol can be used for a similar effect, using the " +"``with`` statement::" +msgstr "" + +msgid "" +">>> with memoryview(b'abc') as m:\n" +"... m[0]\n" +"...\n" +"97\n" +">>> m[0]\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"ValueError: operation forbidden on released memoryview object" +msgstr "" + +msgid "" +"Cast a memoryview to a new format or shape. *shape* defaults to " +"``[byte_length//new_itemsize]``, which means that the result view will be " +"one-dimensional. The return value is a new memoryview, but the buffer itself " +"is not copied. Supported casts are 1D -> C-:term:`contiguous` and C-" +"contiguous -> 1D." +msgstr "" + +msgid "" +"The destination format is restricted to a single element native format " +"in :mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' " +"or 'c'). The byte length of the result must be the same as the original " +"length. Note that all byte lengths may depend on the operating system." +msgstr "" + +msgid "Cast 1D/long to 1D/unsigned bytes::" +msgstr "" + +msgid "" +">>> import array\n" +">>> a = array.array('l', [1,2,3])\n" +">>> x = memoryview(a)\n" +">>> x.format\n" +"'l'\n" +">>> x.itemsize\n" +"8\n" +">>> len(x)\n" +"3\n" +">>> x.nbytes\n" +"24\n" +">>> y = x.cast('B')\n" +">>> y.format\n" +"'B'\n" +">>> y.itemsize\n" +"1\n" +">>> len(y)\n" +"24\n" +">>> y.nbytes\n" +"24" +msgstr "" + +msgid "Cast 1D/unsigned bytes to 1D/char::" +msgstr "" + +msgid "" +">>> b = bytearray(b'zyz')\n" +">>> x = memoryview(b)\n" +">>> x[0] = b'a'\n" +"Traceback (most recent call last):\n" +" ...\n" +"TypeError: memoryview: invalid type for format 'B'\n" +">>> y = x.cast('c')\n" +">>> y[0] = b'a'\n" +">>> b\n" +"bytearray(b'ayz')" +msgstr "" + +msgid "Cast 1D/bytes to 3D/ints to 1D/signed char::" +msgstr "" + +msgid "" +">>> import struct\n" +">>> buf = struct.pack(\"i\"*12, *list(range(12)))\n" +">>> x = memoryview(buf)\n" +">>> y = x.cast('i', shape=[2,2,3])\n" +">>> y.tolist()\n" +"[[[0, 1, 2], [3, 4, 5]], [[6, 7, 8], [9, 10, 11]]]\n" +">>> y.format\n" +"'i'\n" +">>> y.itemsize\n" +"4\n" +">>> len(y)\n" +"2\n" +">>> y.nbytes\n" +"48\n" +">>> z = y.cast('b')\n" +">>> z.format\n" +"'b'\n" +">>> z.itemsize\n" +"1\n" +">>> len(z)\n" +"48\n" +">>> z.nbytes\n" +"48" +msgstr "" + +msgid "Cast 1D/unsigned long to 2D/unsigned long::" +msgstr "" + +msgid "" +">>> buf = struct.pack(\"L\"*6, *list(range(6)))\n" +">>> x = memoryview(buf)\n" +">>> y = x.cast('L', shape=[2,3])\n" +">>> len(y)\n" +"2\n" +">>> y.nbytes\n" +"48\n" +">>> y.tolist()\n" +"[[0, 1, 2], [3, 4, 5]]" +msgstr "" + +msgid "The source format is no longer restricted when casting to a byte view." +msgstr "" + +msgid "There are also several readonly attributes available:" +msgstr "" + +msgid "The underlying object of the memoryview::" +msgstr "" + +msgid "" +">>> b = bytearray(b'xyz')\n" +">>> m = memoryview(b)\n" +">>> m.obj is b\n" +"True" +msgstr "" +">>> b = bytearray(b'xyz')\n" +">>> m = memoryview(b)\n" +">>> m.obj is b\n" +"True" + +msgid "" +"``nbytes == product(shape) * itemsize == len(m.tobytes())``. This is the " +"amount of space in bytes that the array would use in a contiguous " +"representation. It is not necessarily equal to ``len(m)``::" +msgstr "" + +msgid "" +">>> import array\n" +">>> a = array.array('i', [1,2,3,4,5])\n" +">>> m = memoryview(a)\n" +">>> len(m)\n" +"5\n" +">>> m.nbytes\n" +"20\n" +">>> y = m[::2]\n" +">>> len(y)\n" +"3\n" +">>> y.nbytes\n" +"12\n" +">>> len(y.tobytes())\n" +"12" +msgstr "" + +msgid "Multi-dimensional arrays::" +msgstr "" + +msgid "" +">>> import struct\n" +">>> buf = struct.pack(\"d\"*12, *[1.5*x for x in range(12)])\n" +">>> x = memoryview(buf)\n" +">>> y = x.cast('d', shape=[3,4])\n" +">>> y.tolist()\n" +"[[0.0, 1.5, 3.0, 4.5], [6.0, 7.5, 9.0, 10.5], [12.0, 13.5, 15.0, 16.5]]\n" +">>> len(y)\n" +"3\n" +">>> y.nbytes\n" +"96" +msgstr "" + +msgid "A bool indicating whether the memory is read only." +msgstr "" + +msgid "" +"A string containing the format (in :mod:`struct` module style) for each " +"element in the view. A memoryview can be created from exporters with " +"arbitrary format strings, but some methods (e.g. :meth:`tolist`) are " +"restricted to native single element formats." +msgstr "" + +msgid "" +"format ``'B'`` is now handled according to the struct module syntax. This " +"means that ``memoryview(b'abc')[0] == b'abc'[0] == 97``." +msgstr "" + +msgid "The size in bytes of each element of the memoryview::" +msgstr "" + +msgid "" +">>> import array, struct\n" +">>> m = memoryview(array.array('H', [32000, 32001, 32002]))\n" +">>> m.itemsize\n" +"2\n" +">>> m[0]\n" +"32000\n" +">>> struct.calcsize('H') == m.itemsize\n" +"True" +msgstr "" + +msgid "" +"An integer indicating how many dimensions of a multi-dimensional array the " +"memory represents." +msgstr "" + +msgid "" +"A tuple of integers the length of :attr:`ndim` giving the shape of the " +"memory as an N-dimensional array." +msgstr "" + +msgid "An empty tuple instead of ``None`` when ndim = 0." +msgstr "" + +msgid "" +"A tuple of integers the length of :attr:`ndim` giving the size in bytes to " +"access each element for each dimension of the array." +msgstr "" + +msgid "Used internally for PIL-style arrays. The value is informational only." +msgstr "" + +msgid "A bool indicating whether the memory is C-:term:`contiguous`." +msgstr "" + +msgid "A bool indicating whether the memory is Fortran :term:`contiguous`." +msgstr "" + +msgid "A bool indicating whether the memory is :term:`contiguous`." +msgstr "" + +msgid "Set Types --- :class:`set`, :class:`frozenset`" +msgstr "" + +msgid "" +"A :dfn:`set` object is an unordered collection of distinct :term:`hashable` " +"objects. Common uses include membership testing, removing duplicates from a " +"sequence, and computing mathematical operations such as intersection, union, " +"difference, and symmetric difference. (For other containers see the built-" +"in :class:`dict`, :class:`list`, and :class:`tuple` classes, and " +"the :mod:`collections` module.)" +msgstr "" + +msgid "" +"Like other collections, sets support ``x in set``, ``len(set)``, and ``for x " +"in set``. Being an unordered collection, sets do not record element " +"position or order of insertion. Accordingly, sets do not support indexing, " +"slicing, or other sequence-like behavior." +msgstr "" + +msgid "" +"There are currently two built-in set types, :class:`set` " +"and :class:`frozenset`. The :class:`set` type is mutable --- the contents " +"can be changed using methods like :meth:`~set.add` and :meth:`~set.remove`. " +"Since it is mutable, it has no hash value and cannot be used as either a " +"dictionary key or as an element of another set. The :class:`frozenset` type " +"is immutable and :term:`hashable` --- its contents cannot be altered after " +"it is created; it can therefore be used as a dictionary key or as an element " +"of another set." +msgstr "" + +msgid "" +"Non-empty sets (not frozensets) can be created by placing a comma-separated " +"list of elements within braces, for example: ``{'jack', 'sjoerd'}``, in " +"addition to the :class:`set` constructor." +msgstr "" + +msgid "The constructors for both classes work the same:" +msgstr "" + +msgid "" +"Return a new set or frozenset object whose elements are taken from " +"*iterable*. The elements of a set must be :term:`hashable`. To represent " +"sets of sets, the inner sets must be :class:`frozenset` objects. If " +"*iterable* is not specified, a new empty set is returned." +msgstr "" + +msgid "Sets can be created by several means:" +msgstr "" + +msgid "" +"Use a comma-separated list of elements within braces: ``{'jack', 'sjoerd'}``" +msgstr "" + +msgid "" +"Use a set comprehension: ``{c for c in 'abracadabra' if c not in 'abc'}``" +msgstr "" + +msgid "" +"Use the type constructor: ``set()``, ``set('foobar')``, ``set(['a', 'b', " +"'foo'])``" +msgstr "" + +msgid "" +"Instances of :class:`set` and :class:`frozenset` provide the following " +"operations:" +msgstr "" + +msgid "Return the number of elements in set *s* (cardinality of *s*)." +msgstr "" + +msgid "Test *x* for membership in *s*." +msgstr "" + +msgid "Test *x* for non-membership in *s*." +msgstr "" + +msgid "" +"Return ``True`` if the set has no elements in common with *other*. Sets are " +"disjoint if and only if their intersection is the empty set." +msgstr "" + +msgid "Test whether every element in the set is in *other*." +msgstr "" + +msgid "" +"Test whether the set is a proper subset of *other*, that is, ``set <= other " +"and set != other``." +msgstr "" + +msgid "Test whether every element in *other* is in the set." +msgstr "" + +msgid "" +"Test whether the set is a proper superset of *other*, that is, ``set >= " +"other and set != other``." +msgstr "" + +msgid "Return a new set with elements from the set and all others." +msgstr "" + +msgid "Return a new set with elements common to the set and all others." +msgstr "" + +msgid "Return a new set with elements in the set that are not in the others." +msgstr "" + +msgid "" +"Return a new set with elements in either the set or *other* but not both." +msgstr "" + +msgid "Return a shallow copy of the set." +msgstr "" + +msgid "" +"Note, the non-operator versions " +"of :meth:`~frozenset.union`, :meth:`~frozenset.intersection`, :meth:`~frozenset.difference`, :meth:`~frozenset.symmetric_difference`, :meth:`~frozenset.issubset`, " +"and :meth:`~frozenset.issuperset` methods will accept any iterable as an " +"argument. In contrast, their operator based counterparts require their " +"arguments to be sets. This precludes error-prone constructions like " +"``set('abc') & 'cbs'`` in favor of the more readable " +"``set('abc').intersection('cbs')``." +msgstr "" + +msgid "" +"Both :class:`set` and :class:`frozenset` support set to set comparisons. Two " +"sets are equal if and only if every element of each set is contained in the " +"other (each is a subset of the other). A set is less than another set if and " +"only if the first set is a proper subset of the second set (is a subset, but " +"is not equal). A set is greater than another set if and only if the first " +"set is a proper superset of the second set (is a superset, but is not equal)." +msgstr "" + +msgid "" +"Instances of :class:`set` are compared to instances of :class:`frozenset` " +"based on their members. For example, ``set('abc') == frozenset('abc')`` " +"returns ``True`` and so does ``set('abc') in set([frozenset('abc')])``." +msgstr "" + +msgid "" +"The subset and equality comparisons do not generalize to a total ordering " +"function. For example, any two nonempty disjoint sets are not equal and are " +"not subsets of each other, so *all* of the following return ``False``: " +"``ab``." +msgstr "" + +msgid "" +"Since sets only define partial ordering (subset relationships), the output " +"of the :meth:`list.sort` method is undefined for lists of sets." +msgstr "" + +msgid "Set elements, like dictionary keys, must be :term:`hashable`." +msgstr "" + +msgid "" +"Binary operations that mix :class:`set` instances with :class:`frozenset` " +"return the type of the first operand. For example: ``frozenset('ab') | " +"set('bc')`` returns an instance of :class:`frozenset`." +msgstr "" + +msgid "" +"The following table lists operations available for :class:`set` that do not " +"apply to immutable instances of :class:`frozenset`:" +msgstr "" + +msgid "Update the set, adding elements from all others." +msgstr "" + +msgid "Update the set, keeping only elements found in it and all others." +msgstr "" + +msgid "Update the set, removing elements found in others." +msgstr "" + +msgid "" +"Update the set, keeping only elements found in either set, but not in both." +msgstr "" + +msgid "Add element *elem* to the set." +msgstr "" + +msgid "" +"Remove element *elem* from the set. Raises :exc:`KeyError` if *elem* is not " +"contained in the set." +msgstr "" + +msgid "Remove element *elem* from the set if it is present." +msgstr "" + +msgid "" +"Remove and return an arbitrary element from the set. Raises :exc:`KeyError` " +"if the set is empty." +msgstr "" + +msgid "Remove all elements from the set." +msgstr "" + +msgid "" +"Note, the non-operator versions of " +"the :meth:`~set.update`, :meth:`~set.intersection_update`, :meth:`~set.difference_update`, " +"and :meth:`~set.symmetric_difference_update` methods will accept any " +"iterable as an argument." +msgstr "" + +msgid "" +"Note, the *elem* argument to " +"the :meth:`~object.__contains__`, :meth:`~set.remove`, " +"and :meth:`~set.discard` methods may be a set. To support searching for an " +"equivalent frozenset, a temporary one is created from *elem*." +msgstr "" + +msgid "" +"Sets and frozensets are :ref:`generic ` over the type of their " +"elements." +msgstr "" + +msgid "Mapping Types --- :class:`dict`" +msgstr "" + +msgid "" +"A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " +"Mappings are mutable objects. There is currently only one standard mapping " +"type, the :dfn:`dictionary`. (For other containers see the built-" +"in :class:`list`, :class:`set`, and :class:`tuple` classes, and " +"the :mod:`collections` module.)" +msgstr "" + +msgid "" +"A dictionary's keys are *almost* arbitrary values. Values that are " +"not :term:`hashable`, that is, values containing lists, dictionaries or " +"other mutable types (that are compared by value rather than by object " +"identity) may not be used as keys. Values that compare equal (such as ``1``, " +"``1.0``, and ``True``) can be used interchangeably to index the same " +"dictionary entry." +msgstr "" + +msgid "" +"Return a new dictionary initialized from an optional positional argument and " +"a possibly empty set of keyword arguments." +msgstr "" + +msgid "Dictionaries can be created by several means:" +msgstr "" + +msgid "" +"Use a comma-separated list of ``key: value`` pairs within braces: ``{'jack': " +"4098, 'sjoerd': 4127}`` or ``{4098: 'jack', 4127: 'sjoerd'}``" +msgstr "" + +msgid "Use a dict comprehension: ``{}``, ``{x: x ** 2 for x in range(10)}``" +msgstr "" + +msgid "" +"Use the type constructor: ``dict()``, ``dict([('foo', 100), ('bar', " +"200)])``, ``dict(foo=100, bar=200)``" +msgstr "" + +msgid "" +"If no positional argument is given, an empty dictionary is created. If a " +"positional argument is given and it defines a ``keys()`` method, a " +"dictionary is created by calling :meth:`~object.__getitem__` on the argument " +"with each returned key from the method. Otherwise, the positional argument " +"must be an :term:`iterable` object. Each item in the iterable must itself " +"be an iterable with exactly two elements. The first element of each item " +"becomes a key in the new dictionary, and the second element the " +"corresponding value. If a key occurs more than once, the last value for " +"that key becomes the corresponding value in the new dictionary." +msgstr "" + +msgid "" +"If keyword arguments are given, the keyword arguments and their values are " +"added to the dictionary created from the positional argument. If a key " +"being added is already present, the value from the keyword argument replaces " +"the value from the positional argument." +msgstr "" + +msgid "" +"Dictionaries compare equal if and only if they have the same ``(key, " +"value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', " +"'>') raise :exc:`TypeError`. To illustrate dictionary creation and " +"equality, the following examples all return a dictionary equal to " +"``{\"one\": 1, \"two\": 2, \"three\": 3}``::" +msgstr "" + +msgid "" +">>> a = dict(one=1, two=2, three=3)\n" +">>> b = {'one': 1, 'two': 2, 'three': 3}\n" +">>> c = dict(zip(['one', 'two', 'three'], [1, 2, 3]))\n" +">>> d = dict([('two', 2), ('one', 1), ('three', 3)])\n" +">>> e = dict({'three': 3, 'one': 1, 'two': 2})\n" +">>> f = dict({'one': 1, 'three': 3}, two=2)\n" +">>> a == b == c == d == e == f\n" +"True" +msgstr "" + +msgid "" +"Providing keyword arguments as in the first example only works for keys that " +"are valid Python identifiers. Otherwise, any valid keys can be used." +msgstr "" + +msgid "" +"Dictionaries preserve insertion order. Note that updating a key does not " +"affect the order. Keys added after deletion are inserted at the end. ::" +msgstr "" + +msgid "" +">>> d = {\"one\": 1, \"two\": 2, \"three\": 3, \"four\": 4}\n" +">>> d\n" +"{'one': 1, 'two': 2, 'three': 3, 'four': 4}\n" +">>> list(d)\n" +"['one', 'two', 'three', 'four']\n" +">>> list(d.values())\n" +"[1, 2, 3, 4]\n" +">>> d[\"one\"] = 42\n" +">>> d\n" +"{'one': 42, 'two': 2, 'three': 3, 'four': 4}\n" +">>> del d[\"two\"]\n" +">>> d[\"two\"] = None\n" +">>> d\n" +"{'one': 42, 'three': 3, 'four': 4, 'two': None}" +msgstr "" + +msgid "" +"Dictionary order is guaranteed to be insertion order. This behavior was an " +"implementation detail of CPython from 3.6." +msgstr "" + +msgid "" +"Dictionaries are :ref:`generic ` over two types, signifying " +"(respectively) the types of the dictionary's keys and values." +msgstr "" + +msgid "" +"These are the operations that dictionaries support (and therefore, custom " +"mapping types should support too):" +msgstr "" + +msgid "Return a list of all the keys used in the dictionary *d*." +msgstr "" + +msgid "Return the number of items in the dictionary *d*." +msgstr "" + +msgid "" +"Return the item of *d* with key *key*. Raises a :exc:`KeyError` if *key* is " +"not in the map." +msgstr "" + +msgid "" +"If a subclass of dict defines a method :meth:`~object.__missing__` and *key* " +"is not present, the ``d[key]`` operation calls that method with the key " +"*key* as argument. The ``d[key]`` operation then returns or raises whatever " +"is returned or raised by the ``__missing__(key)`` call. No other operations " +"or methods invoke :meth:`~object.__missing__`. " +"If :meth:`~object.__missing__` is not defined, :exc:`KeyError` is " +"raised. :meth:`~object.__missing__` must be a method; it cannot be an " +"instance variable::" +msgstr "" + +msgid "" +">>> class Counter(dict):\n" +"... def __missing__(self, key):\n" +"... return 0\n" +"...\n" +">>> c = Counter()\n" +">>> c['red']\n" +"0\n" +">>> c['red'] += 1\n" +">>> c['red']\n" +"1" +msgstr "" + +msgid "" +"The example above shows part of the implementation " +"of :class:`collections.Counter`. A different :meth:`!__missing__` method is " +"used by :class:`collections.defaultdict`." +msgstr "" + +msgid "Set ``d[key]`` to *value*." +msgstr "" + +msgid "" +"Remove ``d[key]`` from *d*. Raises a :exc:`KeyError` if *key* is not in the " +"map." +msgstr "" + +msgid "Return ``True`` if *d* has a key *key*, else ``False``." +msgstr "" + +msgid "Equivalent to ``not key in d``." +msgstr "" + +msgid "" +"Return an iterator over the keys of the dictionary. This is a shortcut for " +"``iter(d.keys())``." +msgstr "" + +msgid "Remove all items from the dictionary." +msgstr "" + +msgid "Return a shallow copy of the dictionary." +msgstr "" + +msgid "" +"Create a new dictionary with keys from *iterable* and values set to *value*." +msgstr "" + +msgid "" +":meth:`fromkeys` is a class method that returns a new dictionary. *value* " +"defaults to ``None``. All of the values refer to just a single instance, so " +"it generally doesn't make sense for *value* to be a mutable object such as " +"an empty list. To get distinct values, use a :ref:`dict comprehension " +"` instead." +msgstr "" + +msgid "" +"Return the value for *key* if *key* is in the dictionary, else *default*. If " +"*default* is not given, it defaults to ``None``, so that this method never " +"raises a :exc:`KeyError`." +msgstr "" + +msgid "" +"Return a new view of the dictionary's items (``(key, value)`` pairs). See " +"the :ref:`documentation of view objects `." +msgstr "" + +msgid "" +"Return a new view of the dictionary's keys. See the :ref:`documentation of " +"view objects `." +msgstr "" + +msgid "" +"If *key* is in the dictionary, remove it and return its value, else return " +"*default*. If *default* is not given and *key* is not in the dictionary, " +"a :exc:`KeyError` is raised." +msgstr "" + +msgid "" +"Remove and return a ``(key, value)`` pair from the dictionary. Pairs are " +"returned in :abbr:`LIFO (last-in, first-out)` order." +msgstr "" + +msgid "" +":meth:`popitem` is useful to destructively iterate over a dictionary, as " +"often used in set algorithms. If the dictionary is empty, " +"calling :meth:`popitem` raises a :exc:`KeyError`." +msgstr "" + +msgid "" +"LIFO order is now guaranteed. In prior versions, :meth:`popitem` would " +"return an arbitrary key/value pair." +msgstr "" + +msgid "" +"Return a reverse iterator over the keys of the dictionary. This is a " +"shortcut for ``reversed(d.keys())``." +msgstr "" + +msgid "" +"If *key* is in the dictionary, return its value. If not, insert *key* with " +"a value of *default* and return *default*. *default* defaults to ``None``." +msgstr "" + +msgid "" +"Update the dictionary with the key/value pairs from *mapping* or *iterable* " +"and *kwargs*, overwriting existing keys. Return ``None``." +msgstr "" + +msgid "" +":meth:`update` accepts either another object with a ``keys()`` method (in " +"which case :meth:`~object.__getitem__` is called with every key returned " +"from the method) or an iterable of key/value pairs (as tuples or other " +"iterables of length two). If keyword arguments are specified, the dictionary " +"is then updated with those key/value pairs: ``d.update(red=1, blue=2)``." +msgstr "" + +msgid "" +"Return a new view of the dictionary's values. See the :ref:`documentation " +"of view objects `." +msgstr "" + +msgid "" +"An equality comparison between one ``dict.values()`` view and another will " +"always return ``False``. This also applies when comparing ``dict.values()`` " +"to itself::" +msgstr "" + +msgid "" +">>> d = {'a': 1}\n" +">>> d.values() == d.values()\n" +"False" +msgstr "" +">>> d = {'a': 1}\n" +">>> d.values() == d.values()\n" +"False" + +msgid "" +"Create a new dictionary with the merged keys and values of *d* and *other*, " +"which must both be dictionaries. The values of *other* take priority when " +"*d* and *other* share keys." +msgstr "" + +msgid "" +"Update the dictionary *d* with keys and values from *other*, which may be " +"either a :term:`mapping` or an :term:`iterable` of key/value pairs. The " +"values of *other* take priority when *d* and *other* share keys." +msgstr "" + +msgid "Dictionaries and dictionary views are reversible. ::" +msgstr "" + +msgid "" +">>> d = {\"one\": 1, \"two\": 2, \"three\": 3, \"four\": 4}\n" +">>> d\n" +"{'one': 1, 'two': 2, 'three': 3, 'four': 4}\n" +">>> list(reversed(d))\n" +"['four', 'three', 'two', 'one']\n" +">>> list(reversed(d.values()))\n" +"[4, 3, 2, 1]\n" +">>> list(reversed(d.items()))\n" +"[('four', 4), ('three', 3), ('two', 2), ('one', 1)]" +msgstr "" + +msgid "Dictionaries are now reversible." +msgstr "" + +msgid "" +":class:`types.MappingProxyType` can be used to create a read-only view of " +"a :class:`dict`." +msgstr "" + +msgid "Dictionary view objects" +msgstr "" + +msgid "" +"The objects returned by :meth:`dict.keys`, :meth:`dict.values` " +"and :meth:`dict.items` are *view objects*. They provide a dynamic view on " +"the dictionary's entries, which means that when the dictionary changes, the " +"view reflects these changes." +msgstr "" + +msgid "" +"Dictionary views can be iterated over to yield their respective data, and " +"support membership tests:" +msgstr "" + +msgid "Return the number of entries in the dictionary." +msgstr "" + +msgid "" +"Return an iterator over the keys, values or items (represented as tuples of " +"``(key, value)``) in the dictionary." +msgstr "" + +msgid "" +"Keys and values are iterated over in insertion order. This allows the " +"creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = " +"zip(d.values(), d.keys())``. Another way to create the same list is ``pairs " +"= [(v, k) for (k, v) in d.items()]``." +msgstr "" + +msgid "" +"Iterating views while adding or deleting entries in the dictionary may raise " +"a :exc:`RuntimeError` or fail to iterate over all entries." +msgstr "" + +msgid "Dictionary order is guaranteed to be insertion order." +msgstr "" + +msgid "" +"Return ``True`` if *x* is in the underlying dictionary's keys, values or " +"items (in the latter case, *x* should be a ``(key, value)`` tuple)." +msgstr "" + +msgid "" +"Return a reverse iterator over the keys, values or items of the dictionary. " +"The view will be iterated in reverse order of the insertion." +msgstr "" + +msgid "Dictionary views are now reversible." +msgstr "" + +msgid "" +"Return a :class:`types.MappingProxyType` that wraps the original dictionary " +"to which the view refers." +msgstr "" + +msgid "" +"Keys views are set-like since their entries are unique and :term:`hashable`. " +"Items views also have set-like operations since the (key, value) pairs are " +"unique and the keys are hashable. If all values in an items view are " +"hashable as well, then the items view can interoperate with other sets. " +"(Values views are not treated as set-like since the entries are generally " +"not unique.) For set-like views, all of the operations defined for the " +"abstract base class :class:`collections.abc.Set` are available (for example, " +"``==``, ``<``, or ``^``). While using set operators, set-like views accept " +"any iterable as the other operand, unlike sets which only accept sets as the " +"input." +msgstr "" + +msgid "An example of dictionary view usage::" +msgstr "" + +msgid "" +">>> dishes = {'eggs': 2, 'sausage': 1, 'bacon': 1, 'spam': 500}\n" +">>> keys = dishes.keys()\n" +">>> values = dishes.values()\n" +"\n" +">>> # iteration\n" +">>> n = 0\n" +">>> for val in values:\n" +"... n += val\n" +"...\n" +">>> print(n)\n" +"504\n" +"\n" +">>> # keys and values are iterated over in the same order (insertion order)\n" +">>> list(keys)\n" +"['eggs', 'sausage', 'bacon', 'spam']\n" +">>> list(values)\n" +"[2, 1, 1, 500]\n" +"\n" +">>> # view objects are dynamic and reflect dict changes\n" +">>> del dishes['eggs']\n" +">>> del dishes['sausage']\n" +">>> list(keys)\n" +"['bacon', 'spam']\n" +"\n" +">>> # set operations\n" +">>> keys & {'eggs', 'bacon', 'salad'}\n" +"{'bacon'}\n" +">>> keys ^ {'sausage', 'juice'} == {'juice', 'sausage', 'bacon', 'spam'}\n" +"True\n" +">>> keys | ['juice', 'juice', 'juice'] == {'bacon', 'spam', 'juice'}\n" +"True\n" +"\n" +">>> # get back a read-only proxy for the original dictionary\n" +">>> values.mapping\n" +"mappingproxy({'bacon': 1, 'spam': 500})\n" +">>> values.mapping['spam']\n" +"500" +msgstr "" + +msgid "Context Manager Types" +msgstr "" + +msgid "" +"Python's :keyword:`with` statement supports the concept of a runtime context " +"defined by a context manager. This is implemented using a pair of methods " +"that allow user-defined classes to define a runtime context that is entered " +"before the statement body is executed and exited when the statement ends:" +msgstr "" + +msgid "" +"Enter the runtime context and return either this object or another object " +"related to the runtime context. The value returned by this method is bound " +"to the identifier in the :keyword:`!as` clause of :keyword:`with` statements " +"using this context manager." +msgstr "" + +msgid "" +"An example of a context manager that returns itself is a :term:`file " +"object`. File objects return themselves from __enter__() to " +"allow :func:`open` to be used as the context expression in a :keyword:`with` " +"statement." +msgstr "" + +msgid "" +"An example of a context manager that returns a related object is the one " +"returned by :func:`decimal.localcontext`. These managers set the active " +"decimal context to a copy of the original decimal context and then return " +"the copy. This allows changes to be made to the current decimal context in " +"the body of the :keyword:`with` statement without affecting code outside " +"the :keyword:`!with` statement." +msgstr "" + +msgid "" +"Exit the runtime context and return a Boolean flag indicating if any " +"exception that occurred should be suppressed. If an exception occurred while " +"executing the body of the :keyword:`with` statement, the arguments contain " +"the exception type, value and traceback information. Otherwise, all three " +"arguments are ``None``." +msgstr "" + +msgid "" +"Returning a true value from this method will cause the :keyword:`with` " +"statement to suppress the exception and continue execution with the " +"statement immediately following the :keyword:`!with` statement. Otherwise " +"the exception continues propagating after this method has finished executing." +msgstr "" + +msgid "" +"If this method raises an exception while handling an earlier exception from " +"the :keyword:`with` block, the new exception is raised, and the original " +"exception is stored in its :attr:`~BaseException.__context__` attribute." +msgstr "" + +msgid "" +"The exception passed in should never be reraised explicitly - instead, this " +"method should return a false value to indicate that the method completed " +"successfully and does not want to suppress the raised exception. This allows " +"context management code to easily detect whether or not " +"an :meth:`~object.__exit__` method has actually failed." +msgstr "" + +msgid "" +"Python defines several context managers to support easy thread " +"synchronisation, prompt closure of files or other objects, and simpler " +"manipulation of the active decimal arithmetic context. The specific types " +"are not treated specially beyond their implementation of the context " +"management protocol. See the :mod:`contextlib` module for some examples." +msgstr "" + +msgid "" +"Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " +"decorator provide a convenient way to implement these protocols. If a " +"generator function is decorated with the :class:`contextlib.contextmanager` " +"decorator, it will return a context manager implementing the " +"necessary :meth:`~contextmanager.__enter__` " +"and :meth:`~contextmanager.__exit__` methods, rather than the iterator " +"produced by an undecorated generator function." +msgstr "" + +msgid "" +"Note that there is no specific slot for any of these methods in the type " +"structure for Python objects in the Python/C API. Extension types wanting to " +"define these methods must provide them as a normal Python accessible method. " +"Compared to the overhead of setting up the runtime context, the overhead of " +"a single class dictionary lookup is negligible." +msgstr "" + +msgid "" +"Type Annotation Types --- :ref:`Generic Alias `, :ref:`Union `" +msgstr "" + +msgid "" +"The core built-in types for :term:`type annotations ` " +"are :ref:`Generic Alias ` and :ref:`Union `." +msgstr "" + +msgid "Generic Alias Type" +msgstr "" + +msgid "" +"``GenericAlias`` objects are generally created by :ref:`subscripting " +"` a class. They are most often used with :ref:`container " +"classes `, such as :class:`list` or :class:`dict`. For " +"example, ``list[int]`` is a ``GenericAlias`` object created by subscripting " +"the ``list`` class with the argument :class:`int`. ``GenericAlias`` objects " +"are intended primarily for use with :term:`type annotations `." +msgstr "" + +msgid "" +"It is generally only possible to subscript a class if the class implements " +"the special method :meth:`~object.__class_getitem__`." +msgstr "" + +msgid "" +"A ``GenericAlias`` object acts as a proxy for a :term:`generic type`, " +"implementing *parameterized generics*." +msgstr "" + +msgid "" +"For a container class, the argument(s) supplied to a :ref:`subscription " +"` of the class may indicate the type(s) of the elements an " +"object contains. For example, ``set[bytes]`` can be used in type annotations " +"to signify a :class:`set` in which all the elements are of " +"type :class:`bytes`." +msgstr "" + +msgid "" +"For a class which defines :meth:`~object.__class_getitem__` but is not a " +"container, the argument(s) supplied to a subscription of the class will " +"often indicate the return type(s) of one or more methods defined on an " +"object. For example, :mod:`regular expressions ` can be used on both " +"the :class:`str` data type and the :class:`bytes` data type:" +msgstr "" + +msgid "" +"If ``x = re.search('foo', 'foo')``, ``x`` will be a :ref:`re.Match ` object where the return values of ``x.group(0)`` and ``x[0]`` will " +"both be of type :class:`str`. We can represent this kind of object in type " +"annotations with the ``GenericAlias`` ``re.Match[str]``." +msgstr "" + +msgid "" +"If ``y = re.search(b'bar', b'bar')``, (note the ``b`` for :class:`bytes`), " +"``y`` will also be an instance of ``re.Match``, but the return values of " +"``y.group(0)`` and ``y[0]`` will both be of type :class:`bytes`. In type " +"annotations, we would represent this variety of :ref:`re.Match ` objects with ``re.Match[bytes]``." +msgstr "" + +msgid "" +"``GenericAlias`` objects are instances of the " +"class :class:`types.GenericAlias`, which can also be used to create " +"``GenericAlias`` objects directly. Specializations of user-" +"defined :ref:`generic classes ` may not be instances " +"of :class:`types.GenericAlias`, but they provide similar functionality." +msgstr "" + +msgid "" +"Creates a ``GenericAlias`` representing a type ``T`` parameterized by types " +"*X*, *Y*, and more depending on the ``T`` used. For example, a function " +"expecting a :class:`list` containing :class:`float` elements::" +msgstr "" + +msgid "" +"def average(values: list[float]) -> float:\n" +" return sum(values) / len(values)" +msgstr "" + +msgid "" +"Another example for :term:`mapping` objects, using a :class:`dict`, which is " +"a generic type expecting two type parameters representing the key type and " +"the value type. In this example, the function expects a ``dict`` with keys " +"of type :class:`str` and values of type :class:`int`::" +msgstr "" + +msgid "" +"def send_post_request(url: str, body: dict[str, int]) -> None:\n" +" ..." +msgstr "" + +msgid "" +"The builtin functions :func:`isinstance` and :func:`issubclass` do not " +"accept ``GenericAlias`` types for their second argument::" +msgstr "" + +msgid "" +">>> isinstance([1, 2], list[str])\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"TypeError: isinstance() argument 2 cannot be a parameterized generic" +msgstr "" + +msgid "" +"The Python runtime does not enforce :term:`type annotations `. " +"This extends to generic types and their type parameters. When creating a " +"container object from a ``GenericAlias``, the elements in the container are " +"not checked against their type. For example, the following code is " +"discouraged, but will run without errors::" +msgstr "" + +msgid "" +">>> t = list[str]\n" +">>> t([1, 2, 3])\n" +"[1, 2, 3]" +msgstr "" +">>> t = list[str]\n" +">>> t([1, 2, 3])\n" +"[1, 2, 3]" + +msgid "" +"Furthermore, parameterized generics erase type parameters during object " +"creation::" +msgstr "" + +msgid "" +">>> t = list[str]\n" +">>> type(t)\n" +"\n" +"\n" +">>> l = t()\n" +">>> type(l)\n" +"" +msgstr "" + +msgid "" +"Instances of ``GenericAlias`` are not classes at runtime, even though they " +"behave like classes (they can be instantiated and subclassed)::" +msgstr "" + +msgid "" +">>> import inspect\n" +">>> inspect.isclass(list[int])\n" +"False" +msgstr "" + +msgid "" +"This is true for :ref:`user-defined generics ` also." +msgstr "" + +msgid "" +"Calling :func:`repr` or :func:`str` on a generic shows the parameterized " +"type::" +msgstr "" + +msgid "" +">>> repr(list[int])\n" +"'list[int]'\n" +"\n" +">>> str(list[int])\n" +"'list[int]'" +msgstr "" +">>> repr(list[int])\n" +"'list[int]'\n" +"\n" +">>> str(list[int])\n" +"'list[int]'" + +msgid "" +"The :meth:`~object.__getitem__` method of generic containers will raise an " +"exception to disallow mistakes like ``dict[str][str]``::" +msgstr "" + +msgid "" +">>> dict[str][str]\n" +"Traceback (most recent call last):\n" +" ...\n" +"TypeError: dict[str] is not a generic class" +msgstr "" + +msgid "" +"However, such expressions are valid when :ref:`type variables ` " +"are used. The index must have as many elements as there are type variable " +"items in the ``GenericAlias`` object's :attr:`~genericalias.__args__`. ::" +msgstr "" + +msgid "" +">>> from typing import TypeVar\n" +">>> Y = TypeVar('Y')\n" +">>> dict[str, Y][int]\n" +"dict[str, int]" +msgstr "" + +msgid "Standard Generic Classes" +msgstr "" + +msgid "" +"The following standard library classes support parameterized generics. This " +"list is non-exhaustive." +msgstr "" + +msgid ":class:`tuple`" +msgstr ":class:`tuple`" + +msgid ":class:`list`" +msgstr ":class:`list`" + +msgid ":class:`dict`" +msgstr ":class:`dict`" + +msgid ":class:`set`" +msgstr ":class:`set`" + +msgid ":class:`frozenset`" +msgstr ":class:`frozenset`" + +msgid ":class:`type`" +msgstr ":class:`type`" + +msgid ":class:`asyncio.Future`" +msgstr ":class:`asyncio.Future`" + +msgid ":class:`asyncio.Task`" +msgstr ":class:`asyncio.Task`" + +msgid ":class:`collections.deque`" +msgstr ":class:`collections.deque`" + +msgid ":class:`collections.defaultdict`" +msgstr ":class:`collections.defaultdict`" + +msgid ":class:`collections.OrderedDict`" +msgstr ":class:`collections.OrderedDict`" + +msgid ":class:`collections.Counter`" +msgstr ":class:`collections.Counter`" + +msgid ":class:`collections.ChainMap`" +msgstr ":class:`collections.ChainMap`" + +msgid ":class:`collections.abc.Awaitable`" +msgstr ":class:`collections.abc.Awaitable`" + +msgid ":class:`collections.abc.Coroutine`" +msgstr ":class:`collections.abc.Coroutine`" + +msgid ":class:`collections.abc.AsyncIterable`" +msgstr ":class:`collections.abc.AsyncIterable`" + +msgid ":class:`collections.abc.AsyncIterator`" +msgstr ":class:`collections.abc.AsyncIterator`" + +msgid ":class:`collections.abc.AsyncGenerator`" +msgstr ":class:`collections.abc.AsyncGenerator`" + +msgid ":class:`collections.abc.Iterable`" +msgstr ":class:`collections.abc.Iterable`" + +msgid ":class:`collections.abc.Iterator`" +msgstr ":class:`collections.abc.Iterator`" + +msgid ":class:`collections.abc.Generator`" +msgstr ":class:`collections.abc.Generator`" + +msgid ":class:`collections.abc.Reversible`" +msgstr ":class:`collections.abc.Reversible`" + +msgid ":class:`collections.abc.Container`" +msgstr ":class:`collections.abc.Container`" + +msgid ":class:`collections.abc.Collection`" +msgstr ":class:`collections.abc.Collection`" + +msgid ":class:`collections.abc.Callable`" +msgstr ":class:`collections.abc.Callable`" + +msgid ":class:`collections.abc.Set`" +msgstr ":class:`collections.abc.Set`" + +msgid ":class:`collections.abc.MutableSet`" +msgstr ":class:`collections.abc.MutableSet`" + +msgid ":class:`collections.abc.Mapping`" +msgstr ":class:`collections.abc.Mapping`" + +msgid ":class:`collections.abc.MutableMapping`" +msgstr ":class:`collections.abc.MutableMapping`" + +msgid ":class:`collections.abc.Sequence`" +msgstr ":class:`collections.abc.Sequence`" + +msgid ":class:`collections.abc.MutableSequence`" +msgstr ":class:`collections.abc.MutableSequence`" + +msgid ":class:`collections.abc.ByteString`" +msgstr ":class:`collections.abc.ByteString`" + +msgid ":class:`collections.abc.MappingView`" +msgstr ":class:`collections.abc.MappingView`" + +msgid ":class:`collections.abc.KeysView`" +msgstr ":class:`collections.abc.KeysView`" + +msgid ":class:`collections.abc.ItemsView`" +msgstr ":class:`collections.abc.ItemsView`" + +msgid ":class:`collections.abc.ValuesView`" +msgstr ":class:`collections.abc.ValuesView`" + +msgid ":class:`contextlib.AbstractContextManager`" +msgstr ":class:`contextlib.AbstractContextManager`" + +msgid ":class:`contextlib.AbstractAsyncContextManager`" +msgstr ":class:`contextlib.AbstractAsyncContextManager`" + +msgid ":class:`dataclasses.Field`" +msgstr ":class:`dataclasses.Field`" + +msgid ":class:`functools.cached_property`" +msgstr ":class:`functools.cached_property`" + +msgid ":class:`functools.partialmethod`" +msgstr ":class:`functools.partialmethod`" + +msgid ":class:`os.PathLike`" +msgstr ":class:`os.PathLike`" + +msgid ":class:`queue.LifoQueue`" +msgstr ":class:`queue.LifoQueue`" + +msgid ":class:`queue.Queue`" +msgstr ":class:`queue.Queue`" + +msgid ":class:`queue.PriorityQueue`" +msgstr ":class:`queue.PriorityQueue`" + +msgid ":class:`queue.SimpleQueue`" +msgstr ":class:`queue.SimpleQueue`" + +msgid ":ref:`re.Pattern `" +msgstr "" + +msgid ":ref:`re.Match `" +msgstr "" + +msgid ":class:`shelve.BsdDbShelf`" +msgstr ":class:`shelve.BsdDbShelf`" + +msgid ":class:`shelve.DbfilenameShelf`" +msgstr ":class:`shelve.DbfilenameShelf`" + +msgid ":class:`shelve.Shelf`" +msgstr ":class:`shelve.Shelf`" + +msgid ":class:`types.MappingProxyType`" +msgstr ":class:`types.MappingProxyType`" + +msgid ":class:`weakref.WeakKeyDictionary`" +msgstr ":class:`weakref.WeakKeyDictionary`" + +msgid ":class:`weakref.WeakMethod`" +msgstr ":class:`weakref.WeakMethod`" + +msgid ":class:`weakref.WeakSet`" +msgstr ":class:`weakref.WeakSet`" + +msgid ":class:`weakref.WeakValueDictionary`" +msgstr ":class:`weakref.WeakValueDictionary`" + +msgid "Special Attributes of ``GenericAlias`` objects" +msgstr "" + +msgid "All parameterized generics implement special read-only attributes." +msgstr "" + +msgid "This attribute points at the non-parameterized generic class::" +msgstr "" + +msgid "" +">>> list[int].__origin__\n" +"" +msgstr "" +">>> list[int].__origin__\n" +"" + +msgid "" +"This attribute is a :class:`tuple` (possibly of length 1) of generic types " +"passed to the original :meth:`~object.__class_getitem__` of the generic " +"class::" +msgstr "" + +msgid "" +">>> dict[str, list[int]].__args__\n" +"(, list[int])" +msgstr "" +">>> dict[str, list[int]].__args__\n" +"(, list[int])" + +msgid "" +"This attribute is a lazily computed tuple (possibly empty) of unique type " +"variables found in ``__args__``::" +msgstr "" + +msgid "" +">>> from typing import TypeVar\n" +"\n" +">>> T = TypeVar('T')\n" +">>> list[T].__parameters__\n" +"(~T,)" +msgstr "" +">>> from typing import TypeVar\n" +"\n" +">>> T = TypeVar('T')\n" +">>> list[T].__parameters__\n" +"(~T,)" + +msgid "" +"A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " +"have correct ``__parameters__`` after substitution " +"because :class:`typing.ParamSpec` is intended primarily for static type " +"checking." +msgstr "" + +msgid "" +"A boolean that is true if the alias has been unpacked using the ``*`` " +"operator (see :data:`~typing.TypeVarTuple`)." +msgstr "" + +msgid ":pep:`484` - Type Hints" +msgstr "" + +msgid "Introducing Python's framework for type annotations." +msgstr "" + +msgid ":pep:`585` - Type Hinting Generics In Standard Collections" +msgstr "" + +msgid "" +"Introducing the ability to natively parameterize standard-library classes, " +"provided they implement the special class " +"method :meth:`~object.__class_getitem__`." +msgstr "" + +msgid "" +":ref:`Generics`, :ref:`user-defined generics ` " +"and :class:`typing.Generic`" +msgstr "" + +msgid "" +"Documentation on how to implement generic classes that can be parameterized " +"at runtime and understood by static type-checkers." +msgstr "" + +msgid "Union Type" +msgstr "" + +msgid "" +"A union object holds the value of the ``|`` (bitwise or) operation on " +"multiple :ref:`type objects `. These types are intended " +"primarily for :term:`type annotations `. The union type " +"expression enables cleaner type hinting syntax compared " +"to :data:`typing.Union`." +msgstr "" + +msgid "" +"Defines a union object which holds types *X*, *Y*, and so forth. ``X | Y`` " +"means either X or Y. It is equivalent to ``typing.Union[X, Y]``. For " +"example, the following function expects an argument of type :class:`int` " +"or :class:`float`::" +msgstr "" + +msgid "" +"def square(number: int | float) -> int | float:\n" +" return number ** 2" +msgstr "" + +msgid "" +"The ``|`` operator cannot be used at runtime to define unions where one or " +"more members is a forward reference. For example, ``int | \"Foo\"``, where " +"``\"Foo\"`` is a reference to a class not yet defined, will fail at runtime. " +"For unions which include forward references, present the whole expression as " +"a string, e.g. ``\"int | Foo\"``." +msgstr "" + +msgid "" +"Union objects can be tested for equality with other union objects. Details:" +msgstr "" + +msgid "Unions of unions are flattened::" +msgstr "" + +msgid "(int | str) | float == int | str | float" +msgstr "" + +msgid "Redundant types are removed::" +msgstr "" + +msgid "int | str | int == int | str" +msgstr "int | str | int == int | str" + +msgid "When comparing unions, the order is ignored::" +msgstr "" + +msgid "int | str == str | int" +msgstr "int | str == str | int" + +msgid "It is compatible with :data:`typing.Union`::" +msgstr "" + +msgid "int | str == typing.Union[int, str]" +msgstr "int | str == typing.Union[int, str]" + +msgid "Optional types can be spelled as a union with ``None``::" +msgstr "" + +msgid "str | None == typing.Optional[str]" +msgstr "str | None == typing.Optional[str]" + +msgid "" +"Calls to :func:`isinstance` and :func:`issubclass` are also supported with a " +"union object::" +msgstr "" + +msgid "" +">>> isinstance(\"\", int | str)\n" +"True" +msgstr "" +">>> isinstance(\"\", int | str)\n" +"True" + +msgid "" +"However, :ref:`parameterized generics ` in union objects " +"cannot be checked::" +msgstr "" + +msgid "" +">>> isinstance(1, int | list[int]) # short-circuit evaluation\n" +"True\n" +">>> isinstance([1], int | list[int])\n" +"Traceback (most recent call last):\n" +" ...\n" +"TypeError: isinstance() argument 2 cannot be a parameterized generic" +msgstr "" + +msgid "" +"The user-exposed type for the union object can be accessed " +"from :data:`types.UnionType` and used for :func:`isinstance` checks. An " +"object cannot be instantiated from the type::" +msgstr "" + +msgid "" +">>> import types\n" +">>> isinstance(int | str, types.UnionType)\n" +"True\n" +">>> types.UnionType()\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"TypeError: cannot create 'types.UnionType' instances" +msgstr "" + +msgid "" +"The :meth:`!__or__` method for type objects was added to support the syntax " +"``X | Y``. If a metaclass implements :meth:`!__or__`, the Union may " +"override it:" +msgstr "" + +msgid "" +">>> class M(type):\n" +"... def __or__(self, other):\n" +"... return \"Hello\"\n" +"...\n" +">>> class C(metaclass=M):\n" +"... pass\n" +"...\n" +">>> C | int\n" +"'Hello'\n" +">>> int | C\n" +"int | C" +msgstr "" + +msgid ":pep:`604` -- PEP proposing the ``X | Y`` syntax and the Union type." +msgstr "" + +msgid "Other Built-in Types" +msgstr "" + +msgid "" +"The interpreter supports several other kinds of objects. Most of these " +"support only one or two operations." +msgstr "" + +msgid "Modules" +msgstr "Moduły" + +msgid "" +"The only special operation on a module is attribute access: ``m.name``, " +"where *m* is a module and *name* accesses a name defined in *m*'s symbol " +"table. Module attributes can be assigned to. (Note that " +"the :keyword:`import` statement is not, strictly speaking, an operation on a " +"module object; ``import foo`` does not require a module object named *foo* " +"to exist, rather it requires an (external) *definition* for a module named " +"*foo* somewhere.)" +msgstr "" + +msgid "" +"A special attribute of every module is :attr:`~object.__dict__`. This is the " +"dictionary containing the module's symbol table. Modifying this dictionary " +"will actually change the module's symbol table, but direct assignment to " +"the :attr:`~object.__dict__` attribute is not possible (you can write " +"``m.__dict__['a'] = 1``, which defines ``m.a`` to be ``1``, but you can't " +"write ``m.__dict__ = {}``). Modifying :attr:`~object.__dict__` directly is " +"not recommended." +msgstr "" + +msgid "" +"Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." +msgstr "" + +msgid "Classes and Class Instances" +msgstr "" + +msgid "See :ref:`objects` and :ref:`class` for these." +msgstr "" + +msgid "Functions" +msgstr "Zadania" + +msgid "" +"Function objects are created by function definitions. The only operation on " +"a function object is to call it: ``func(argument-list)``." +msgstr "" + +msgid "" +"There are really two flavors of function objects: built-in functions and " +"user-defined functions. Both support the same operation (to call the " +"function), but the implementation is different, hence the different object " +"types." +msgstr "" + +msgid "See :ref:`function` for more information." +msgstr "" + +msgid "Methods" +msgstr "" + +msgid "" +"Methods are functions that are called using the attribute notation. There " +"are two flavors: :ref:`built-in methods ` (such " +"as :meth:`~list.append` on lists) and :ref:`class instance methods `. Built-in methods are described with the types that support them." +msgstr "" + +msgid "" +"If you access a method (a function defined in a class namespace) through an " +"instance, you get a special object: a :dfn:`bound method` (also " +"called :ref:`instance method `) object. When called, it " +"will add the ``self`` argument to the argument list. Bound methods have two " +"special read-only attributes: :attr:`m.__self__ ` is the " +"object on which the method operates, and :attr:`m.__func__ " +"` is the function implementing the method. Calling " +"``m(arg-1, arg-2, ..., arg-n)`` is completely equivalent to calling " +"``m.__func__(m.__self__, arg-1, arg-2, ..., arg-n)``." +msgstr "" + +msgid "" +"Like :ref:`function objects `, bound method objects " +"support getting arbitrary attributes. However, since method attributes are " +"actually stored on the underlying function object (:attr:`method.__func__`), " +"setting method attributes on bound methods is disallowed. Attempting to set " +"an attribute on a method results in an :exc:`AttributeError` being raised. " +"In order to set a method attribute, you need to explicitly set it on the " +"underlying function object:" +msgstr "" + +msgid "" +">>> class C:\n" +"... def method(self):\n" +"... pass\n" +"...\n" +">>> c = C()\n" +">>> c.method.whoami = 'my name is method' # can't set on the method\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +"AttributeError: 'method' object has no attribute 'whoami'\n" +">>> c.method.__func__.whoami = 'my name is method'\n" +">>> c.method.whoami\n" +"'my name is method'" +msgstr "" + +msgid "See :ref:`instance-methods` for more information." +msgstr "" + +msgid "Code Objects" +msgstr "" + +msgid "" +"Code objects are used by the implementation to represent \"pseudo-compiled\" " +"executable Python code such as a function body. They differ from function " +"objects because they don't contain a reference to their global execution " +"environment. Code objects are returned by the built-in :func:`compile` " +"function and can be extracted from function objects through " +"their :attr:`~function.__code__` attribute. See also the :mod:`code` module." +msgstr "" + +msgid "" +"Accessing :attr:`~function.__code__` raises an :ref:`auditing event " +"` ``object.__getattr__`` with arguments ``obj`` and " +"``\"__code__\"``." +msgstr "" + +msgid "" +"A code object can be executed or evaluated by passing it (instead of a " +"source string) to the :func:`exec` or :func:`eval` built-in functions." +msgstr "" + +msgid "See :ref:`types` for more information." +msgstr "" + +msgid "Type Objects" +msgstr "" + +msgid "" +"Type objects represent the various object types. An object's type is " +"accessed by the built-in function :func:`type`. There are no special " +"operations on types. The standard module :mod:`types` defines names for all " +"standard built-in types." +msgstr "" + +msgid "Types are written like this: ````." +msgstr "" + +msgid "The Null Object" +msgstr "" + +msgid "" +"This object is returned by functions that don't explicitly return a value. " +"It supports no special operations. There is exactly one null object, named " +"``None`` (a built-in name). ``type(None)()`` produces the same singleton." +msgstr "" + +msgid "It is written as ``None``." +msgstr "" + +msgid "The Ellipsis Object" +msgstr "" + +msgid "" +"This object is commonly used to indicate that something is omitted. It " +"supports no special operations. There is exactly one ellipsis object, " +"named :const:`Ellipsis` (a built-in name). ``type(Ellipsis)()`` produces " +"the :const:`Ellipsis` singleton." +msgstr "" + +msgid "It is written as ``Ellipsis`` or ``...``." +msgstr "" + +msgid "" +"In typical use, ``...`` as the ``Ellipsis`` object appears in a few " +"different places, for instance:" +msgstr "" + +msgid "" +"In type annotations, such as :ref:`callable arguments ` or :ref:`tuple elements `." +msgstr "" + +msgid "" +"As the body of a function instead of a :ref:`pass statement `." +msgstr "" + +msgid "" +"In third-party libraries, such as `Numpy's slicing and striding `_." +msgstr "" + +msgid "" +"Python also uses three dots in ways that are not ``Ellipsis`` objects, for " +"instance:" +msgstr "" + +msgid "" +"Doctest's :const:`ELLIPSIS `, as a pattern for missing " +"content." +msgstr "" + +msgid "" +"The default Python prompt of the :term:`interactive` shell when partial " +"input is incomplete." +msgstr "" + +msgid "" +"Lastly, the Python documentation often uses three dots in conventional " +"English usage to mean omitted content, even in code examples that also use " +"them as the ``Ellipsis``." +msgstr "" + +msgid "The NotImplemented Object" +msgstr "" + +msgid "" +"This object is returned from comparisons and binary operations when they are " +"asked to operate on types they don't support. See :ref:`comparisons` for " +"more information. There is exactly one :data:`NotImplemented` " +"object. :code:`type(NotImplemented)()` produces the singleton instance." +msgstr "" + +msgid "It is written as :code:`NotImplemented`." +msgstr "" + +msgid "Internal Objects" +msgstr "" + +msgid "" +"See :ref:`types` for this information. It describes :ref:`stack frame " +"objects `, :ref:`traceback objects `, and " +"slice objects." +msgstr "" + +msgid "Special Attributes" +msgstr "" + +msgid "" +"The implementation adds a few special read-only attributes to several object " +"types, where they are relevant. Some of these are not reported by " +"the :func:`dir` built-in function." +msgstr "" + +msgid "" +"The name of the class, function, method, descriptor, or generator instance." +msgstr "" + +msgid "" +"The :term:`qualified name` of the class, function, method, descriptor, or " +"generator instance." +msgstr "" + +msgid "The name of the module in which a class or function was defined." +msgstr "" + +msgid "" +"The documentation string of a class or function, or ``None`` if undefined." +msgstr "" + +msgid "" +"The :ref:`type parameters ` of generic classes, functions, " +"and :ref:`type aliases `. For classes and functions that are " +"not generic, this will be an empty tuple." +msgstr "" + +msgid "Integer string conversion length limitation" +msgstr "" + +msgid "" +"CPython has a global limit for converting between :class:`int` " +"and :class:`str` to mitigate denial of service attacks. This limit *only* " +"applies to decimal or other non-power-of-two number bases. Hexadecimal, " +"octal, and binary conversions are unlimited. The limit can be configured." +msgstr "" + +msgid "" +"The :class:`int` type in CPython is an arbitrary length number stored in " +"binary form (commonly known as a \"bignum\"). There exists no algorithm that " +"can convert a string to a binary integer or a binary integer to a string in " +"linear time, *unless* the base is a power of 2. Even the best known " +"algorithms for base 10 have sub-quadratic complexity. Converting a large " +"value such as ``int('1' * 500_000)`` can take over a second on a fast CPU." +msgstr "" + +msgid "" +"Limiting conversion size offers a practical way to avoid :cve:`2020-10735`." +msgstr "" + +msgid "" +"The limit is applied to the number of digit characters in the input or " +"output string when a non-linear conversion algorithm would be involved. " +"Underscores and the sign are not counted towards the limit." +msgstr "" + +msgid "" +"When an operation would exceed the limit, a :exc:`ValueError` is raised:" +msgstr "" + +msgid "" +">>> import sys\n" +">>> sys.set_int_max_str_digits(4300) # Illustrative, this is the default.\n" +">>> _ = int('2' * 5432)\n" +"Traceback (most recent call last):\n" +"...\n" +"ValueError: Exceeds the limit (4300 digits) for integer string conversion: " +"value has 5432 digits; use sys.set_int_max_str_digits() to increase the " +"limit\n" +">>> i = int('2' * 4300)\n" +">>> len(str(i))\n" +"4300\n" +">>> i_squared = i*i\n" +">>> len(str(i_squared))\n" +"Traceback (most recent call last):\n" +"...\n" +"ValueError: Exceeds the limit (4300 digits) for integer string conversion; " +"use sys.set_int_max_str_digits() to increase the limit\n" +">>> len(hex(i_squared))\n" +"7144\n" +">>> assert int(hex(i_squared), base=16) == i*i # Hexadecimal is unlimited." +msgstr "" + +msgid "" +"The default limit is 4300 digits as provided " +"in :data:`sys.int_info.default_max_str_digits `. The lowest " +"limit that can be configured is 640 digits as provided " +"in :data:`sys.int_info.str_digits_check_threshold `." +msgstr "" + +msgid "Verification:" +msgstr "" + +msgid "" +">>> import sys\n" +">>> assert sys.int_info.default_max_str_digits == 4300, sys.int_info\n" +">>> assert sys.int_info.str_digits_check_threshold == 640, sys.int_info\n" +">>> msg = int('578966293710682886880994035146873798396722250538762761564'\n" +"... '9252925514383915483333812743580549779436104706260696366600'\n" +"... '571186405732').to_bytes(53, 'big')\n" +"..." +msgstr "" + +msgid "Affected APIs" +msgstr "" + +msgid "" +"The limitation only applies to potentially slow conversions " +"between :class:`int` and :class:`str` or :class:`bytes`:" +msgstr "" + +msgid "``int(string)`` with default base 10." +msgstr "" + +msgid "``int(string, base)`` for all bases that are not a power of 2." +msgstr "" + +msgid "``str(integer)``." +msgstr "``str(integer)``." + +msgid "``repr(integer)``." +msgstr "``repr(integer)``." + +msgid "" +"any other string conversion to base 10, for example ``f\"{integer}\"``, " +"``\"{}\".format(integer)``, or ``b\"%d\" % integer``." +msgstr "" + +msgid "The limitations do not apply to functions with a linear algorithm:" +msgstr "" + +msgid "``int(string, base)`` with base 2, 4, 8, 16, or 32." +msgstr "" + +msgid ":func:`int.from_bytes` and :func:`int.to_bytes`." +msgstr "" + +msgid ":func:`hex`, :func:`oct`, :func:`bin`." +msgstr ":func:`hex`, :func:`oct`, :func:`bin`." + +msgid ":ref:`formatspec` for hex, octal, and binary numbers." +msgstr "" + +msgid ":class:`str` to :class:`float`." +msgstr "" + +msgid ":class:`str` to :class:`decimal.Decimal`." +msgstr "" + +msgid "Configuring the limit" +msgstr "" + +msgid "" +"Before Python starts up you can use an environment variable or an " +"interpreter command line flag to configure the limit:" +msgstr "" + +msgid "" +":envvar:`PYTHONINTMAXSTRDIGITS`, e.g. ``PYTHONINTMAXSTRDIGITS=640 python3`` " +"to set the limit to 640 or ``PYTHONINTMAXSTRDIGITS=0 python3`` to disable " +"the limitation." +msgstr "" + +msgid "" +":option:`-X int_max_str_digits <-X>`, e.g. ``python3 -X " +"int_max_str_digits=640``" +msgstr "" + +msgid "" +":data:`sys.flags.int_max_str_digits` contains the value " +"of :envvar:`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. " +"If both the env var and the ``-X`` option are set, the ``-X`` option takes " +"precedence. A value of *-1* indicates that both were unset, thus a value " +"of :data:`sys.int_info.default_max_str_digits` was used during " +"initialization." +msgstr "" + +msgid "" +"From code, you can inspect the current limit and set a new one using " +"these :mod:`sys` APIs:" +msgstr "" + +msgid "" +":func:`sys.get_int_max_str_digits` and :func:`sys.set_int_max_str_digits` " +"are a getter and setter for the interpreter-wide limit. Subinterpreters have " +"their own limit." +msgstr "" + +msgid "" +"Information about the default and minimum can be found " +"in :data:`sys.int_info`:" +msgstr "" + +msgid "" +":data:`sys.int_info.default_max_str_digits ` is the compiled-" +"in default limit." +msgstr "" + +msgid "" +":data:`sys.int_info.str_digits_check_threshold ` is the lowest " +"accepted value for the limit (other than 0 which disables it)." +msgstr "" + +msgid "" +"Setting a low limit *can* lead to problems. While rare, code exists that " +"contains integer constants in decimal in their source that exceed the " +"minimum threshold. A consequence of setting the limit is that Python source " +"code containing decimal integer literals longer than the limit will " +"encounter an error during parsing, usually at startup time or import time or " +"even at installation time - anytime an up to date ``.pyc`` does not already " +"exist for the code. A workaround for source that contains such large " +"constants is to convert them to ``0x`` hexadecimal form as it has no limit." +msgstr "" + +msgid "" +"Test your application thoroughly if you use a low limit. Ensure your tests " +"run with the limit set early via the environment or flag so that it applies " +"during startup and even during any installation step that may invoke Python " +"to precompile ``.py`` sources to ``.pyc`` files." +msgstr "" + +msgid "Recommended configuration" +msgstr "" + +msgid "" +"The default :data:`sys.int_info.default_max_str_digits` is expected to be " +"reasonable for most applications. If your application requires a different " +"limit, set it from your main entry point using Python version agnostic code " +"as these APIs were added in security patch releases in versions before 3.12." +msgstr "" + +msgid "Example::" +msgstr "Przykład::" + +msgid "" +">>> import sys\n" +">>> if hasattr(sys, \"set_int_max_str_digits\"):\n" +"... upper_bound = 68000\n" +"... lower_bound = 4004\n" +"... current_limit = sys.get_int_max_str_digits()\n" +"... if current_limit == 0 or current_limit > upper_bound:\n" +"... sys.set_int_max_str_digits(upper_bound)\n" +"... elif current_limit < lower_bound:\n" +"... sys.set_int_max_str_digits(lower_bound)" +msgstr "" + +msgid "If you need to disable it entirely, set it to ``0``." +msgstr "" + +msgid "Footnotes" +msgstr "Przypisy" + +msgid "" +"Additional information on these special methods may be found in the Python " +"Reference Manual (:ref:`customization`)." +msgstr "" + +msgid "" +"As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, " +"and similarly for tuples." +msgstr "" + +msgid "They must have since the parser can't tell the type of the operands." +msgstr "" + +msgid "" +"Cased characters are those with general category property being one of " +"\"Lu\" (Letter, uppercase), \"Ll\" (Letter, lowercase), or \"Lt\" (Letter, " +"titlecase)." +msgstr "" + +msgid "" +"To format only a tuple you should therefore provide a singleton tuple whose " +"only element is the tuple to be formatted." +msgstr "" + +msgid "built-in" +msgstr "" + +msgid "types" +msgstr "" + +msgid "statement" +msgstr "instrukcja" + +msgid "if" +msgstr "" + +msgid "while" +msgstr "" + +msgid "truth" +msgstr "" + +msgid "value" +msgstr "" + +msgid "Boolean" +msgstr "Wartość logiczna" + +msgid "operations" +msgstr "" + +msgid "false" +msgstr "" + +msgid "true" +msgstr "" + +msgid "None (Built-in object)" +msgstr "" + +msgid "False (Built-in object)" +msgstr "" + +msgid "operator" +msgstr "" + +msgid "or" +msgstr "" + +msgid "and" +msgstr "" + +msgid "False" +msgstr "" + +msgid "True" +msgstr "" + +msgid "not" +msgstr "" + +msgid "chaining" +msgstr "" + +msgid "comparisons" +msgstr "" + +msgid "comparison" +msgstr "" + +msgid "==" +msgstr "==" + +msgid "< (less)" +msgstr "" + +msgid "<=" +msgstr "" + +msgid "> (greater)" +msgstr "" + +msgid ">=" +msgstr "" + +msgid "!=" +msgstr "" + +msgid "is" +msgstr "" + +msgid "is not" +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "numeric" +msgstr "" + +msgid "objects" +msgstr "" + +msgid "comparing" +msgstr "" + +msgid "__eq__() (instance method)" +msgstr "" + +msgid "__ne__() (instance method)" +msgstr "" + +msgid "__lt__() (instance method)" +msgstr "" + +msgid "__le__() (instance method)" +msgstr "" + +msgid "__gt__() (instance method)" +msgstr "" + +msgid "__ge__() (instance method)" +msgstr "" + +msgid "in" +msgstr "" + +msgid "not in" +msgstr "" + +msgid "integer" +msgstr "" + +msgid "floating-point" +msgstr "" + +msgid "complex number" +msgstr "liczba zespolona" + +msgid "C" +msgstr "C" + +msgid "language" +msgstr "" + +msgid "literals" +msgstr "" + +msgid "hexadecimal" +msgstr "" + +msgid "octal" +msgstr "" + +msgid "binary" +msgstr "" + +msgid "arithmetic" +msgstr "" + +msgid "built-in function" +msgstr "funkcja wbudowana" + +msgid "int" +msgstr "int" + +msgid "float" +msgstr "typ (float) zmiennoprzecinkowy pojedynczej precyzji" + +msgid "complex" +msgstr "" + +msgid "+ (plus)" +msgstr "" + +msgid "unary operator" +msgstr "" + +msgid "binary operator" +msgstr "" + +msgid "- (minus)" +msgstr "" + +msgid "* (asterisk)" +msgstr "* (asterysk)" + +msgid "/ (slash)" +msgstr "" + +msgid "//" +msgstr "" + +msgid "% (percent)" +msgstr "" + +msgid "**" +msgstr "**" + +msgid "operations on" +msgstr "" + +msgid "conjugate() (complex number method)" +msgstr "" + +msgid "module" +msgstr "moduł" + +msgid "math" +msgstr "" + +msgid "floor() (in module math)" +msgstr "" + +msgid "ceil() (in module math)" +msgstr "" + +msgid "trunc() (in module math)" +msgstr "" + +msgid "conversions" +msgstr "" + +msgid "bitwise" +msgstr "" + +msgid "shifting" +msgstr "" + +msgid "masking" +msgstr "" + +msgid "| (vertical bar)" +msgstr "" + +msgid "^ (caret)" +msgstr "" + +msgid "& (ampersand)" +msgstr "" + +msgid "<<" +msgstr "" + +msgid ">>" +msgstr "" + +msgid "~ (tilde)" +msgstr "" + +msgid "values" +msgstr "" + +msgid "iterator protocol" +msgstr "" + +msgid "protocol" +msgstr "" + +msgid "iterator" +msgstr "iterator" + +msgid "sequence" +msgstr "sekwencja" + +msgid "iteration" +msgstr "" + +msgid "container" +msgstr "" + +msgid "iteration over" +msgstr "" + +msgid "len" +msgstr "len" + +msgid "min" +msgstr "" + +msgid "max" +msgstr "" + +msgid "concatenation" +msgstr "" + +msgid "operation" +msgstr "" + +msgid "repetition" +msgstr "" + +msgid "subscript" +msgstr "" + +msgid "slice" +msgstr "" + +msgid "loop" +msgstr "" + +msgid "over mutable sequence" +msgstr "" + +msgid "mutable sequence" +msgstr "" + +msgid "loop over" +msgstr "" + +msgid "immutable" +msgstr "" + +msgid "tuple" +msgstr "tuple" + +msgid "hash" +msgstr "" + +msgid "mutable" +msgstr "" + +msgid "list" +msgstr "lista" + +msgid "bytearray" +msgstr "" + +msgid "type" +msgstr "typ" + +msgid "assignment" +msgstr "" + +msgid "del" +msgstr "" + +msgid "range" +msgstr "" + +msgid "string" +msgstr "ciąg znaków" + +msgid "text sequence type" +msgstr "" + +msgid "str (built-in class)" +msgstr "" + +msgid "(see also string)" +msgstr "" + +msgid "io.StringIO" +msgstr "" + +msgid "buffer protocol" +msgstr "" + +msgid "bytes" +msgstr "" + +msgid "methods" +msgstr "" + +msgid "re" +msgstr "" + +msgid "universal newlines" +msgstr "uniwersalne nowe linie" + +msgid "str.splitlines method" +msgstr "" + +msgid "! formatted string literal" +msgstr "" + +msgid "formatted string literals" +msgstr "" + +msgid "! f-string" +msgstr "" + +msgid "f-strings" +msgstr "" + +msgid "fstring" +msgstr "fstring" + +msgid "interpolated string literal" +msgstr "interpolowany literał ciąg znaków" + +msgid "formatted literal" +msgstr "sformatowany literał" + +msgid "interpolated literal" +msgstr "interpolowany literał" + +msgid "{} (curly brackets)" +msgstr "" + +msgid "in formatted string literal" +msgstr "" + +msgid "! (exclamation mark)" +msgstr "" + +msgid ": (colon)" +msgstr ": (dwukropek)" + +msgid "= (equals)" +msgstr "" + +msgid "for help in debugging using string literals" +msgstr "" + +msgid "formatting, string (%)" +msgstr "" + +msgid "interpolation, string (%)" +msgstr "" + +msgid "formatting, printf" +msgstr "" + +msgid "interpolation, printf" +msgstr "" + +msgid "printf-style formatting" +msgstr "" + +msgid "sprintf-style formatting" +msgstr "" + +msgid "() (parentheses)" +msgstr "" + +msgid "in printf-style formatting" +msgstr "" + +msgid ". (dot)" +msgstr "" + +msgid "# (hash)" +msgstr "# (hash)" + +msgid "space" +msgstr "" + +msgid "binary sequence types" +msgstr "" + +msgid "memoryview" +msgstr "" + +msgid "array" +msgstr "" + +msgid "bytes.splitlines method" +msgstr "" + +msgid "bytearray.splitlines method" +msgstr "" + +msgid "formatting" +msgstr "" + +msgid "bytes (%)" +msgstr "bytes (%)" + +msgid "bytearray (%)" +msgstr "" + +msgid "interpolation" +msgstr "" + +msgid "set" +msgstr "zestaw" + +msgid "mapping" +msgstr "" + +msgid "dictionary" +msgstr "słownik" + +msgid "__missing__()" +msgstr "__missing__()" + +msgid "context manager" +msgstr "" + +msgid "context management protocol" +msgstr "" + +msgid "context management" +msgstr "" + +msgid "annotation" +msgstr "adnotacja" + +msgid "type annotation; type hint" +msgstr "" + +msgid "GenericAlias" +msgstr "" + +msgid "Generic" +msgstr "" + +msgid "Alias" +msgstr "" + +msgid "Union" +msgstr "" + +msgid "union" +msgstr "" + +msgid "method" +msgstr "metoda" + +msgid "code" +msgstr "" + +msgid "code object" +msgstr "" + +msgid "compile" +msgstr "" + +msgid "__code__ (function object attribute)" +msgstr "" + +msgid "exec" +msgstr "exec" + +msgid "eval" +msgstr "" + +msgid "..." +msgstr "..." + +msgid "ellipsis literal" +msgstr "Literalny zapis wielokropka" diff --git a/c-api/abstract.po b/c-api/abstract.po index 3c41817d25..0168cacf19 100644 --- a/c-api/abstract.po +++ b/c-api/abstract.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Krzysztof Wierzbicki , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,9 +39,9 @@ msgstr "" msgid "" "It is not possible to use these functions on objects that are not properly " -"initialized, such as a list object that has been created by :c:func:" -"`PyList_New`, but whose items have not been set to some non-\\ ``NULL`` " -"value yet." +"initialized, such as a list object that has been created " +"by :c:func:`PyList_New`, but whose items have not been set to some non-\\ " +"``NULL`` value yet." msgstr "" "Nie da się używać tych funckcji na obiektach, które nie zostały prawidłowo " "zainicjowane jak np. lista utworzona za pomocą :c:func:`PyList_New`, której " diff --git a/c-api/allocation.po b/c-api/allocation.po index 36375a8c3d..fc0f55d599 100644 --- a/c-api/allocation.po +++ b/c-api/allocation.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Waldemar Stoczkowski, 2023 +# python-doc bot, 2025 +# Krzysztof Czarnota, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Krzysztof Czarnota, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,8 +24,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 "Allocating Objects on the Heap" -msgstr "Przydzielanie obiektów na stercie" +msgid "Allocating objects on the heap" +msgstr " Alokowanie obiektów na stercie" msgid "" "Initialize a newly allocated object *op* with its type and initial " @@ -45,14 +45,14 @@ msgid "" "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." +"the memory allocation is determined from " +"the :c:member:`~PyTypeObject.tp_basicsize` field of the type object." msgstr "" msgid "" -"Note that this function is unsuitable if *typeobj* has :c:macro:" -"`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_New` " -"instead." +"Note that this function is unsuitable if *typeobj* " +"has :c:macro:`Py_TPFLAGS_HAVE_GC` set. For such objects, " +"use :c:func:`PyObject_GC_New` instead." msgstr "" msgid "" @@ -68,17 +68,9 @@ msgid "" msgstr "" msgid "" -"Note that this function is unsuitable if *typeobj* has :c:macro:" -"`Py_TPFLAGS_HAVE_GC` set. For such objects, use :c:func:`PyObject_GC_NewVar` " -"instead." -msgstr "" - -msgid "" -"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." +"Note that this function is unsuitable if *typeobj* " +"has :c:macro:`Py_TPFLAGS_HAVE_GC` set. For such objects, " +"use :c:func:`PyObject_GC_NewVar` instead." msgstr "" msgid "" @@ -90,8 +82,43 @@ msgstr "" "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`" +msgid ":ref:`moduleobjects`" +msgstr "" msgid "To allocate and create extension modules." msgstr "Przydzielanie i tworzenie modułów rozszerzeń." + +msgid "Soft-deprecated aliases" +msgstr "" + +msgid "" +"These are aliases to existing functions and macros. They exist solely for " +"backwards compatibility." +msgstr "" + +msgid "Soft-deprecated alias" +msgstr "" + +msgid "Function" +msgstr "Funkcja" + +msgid ":c:macro:`PyObject_New`" +msgstr "" + +msgid ":c:macro:`PyObject_NewVar`" +msgstr "" + +msgid ":c:func:`PyObject_Init`" +msgstr "" + +msgid ":c:func:`PyObject_InitVar`" +msgstr "" + +msgid ":c:func:`PyObject_Malloc`" +msgstr ":c:func:`PyObject_Malloc`" + +msgid ":c:func:`PyObject_Realloc`" +msgstr ":c:func:`PyObject_Realloc`" + +msgid ":c:func:`PyObject_Free`" +msgstr ":c:func:`PyObject_Free`" diff --git a/c-api/apiabiversion.po b/c-api/apiabiversion.po index 65b0205a05..0a63841333 100644 --- a/c-api/apiabiversion.po +++ b/c-api/apiabiversion.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +153,8 @@ msgstr "Służy do porównywania liczb, np. ``#if PY_VERSION_HEX >= ...``." 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`." +"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 " diff --git a/c-api/arg.po b/c-api/arg.po index adc19b5a50..ff5ac884a8 100644 --- a/c-api/arg.po +++ b/c-api/arg.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,16 +29,16 @@ msgstr "" msgid "" "These functions are useful when creating your own extension functions and " -"methods. Additional information and examples are available in :ref:" -"`extending-index`." +"methods. Additional information and examples are available " +"in :ref:`extending-index`." msgstr "" msgid "" -"The first three of these functions described, :c:func:`PyArg_ParseTuple`, :c:" -"func:`PyArg_ParseTupleAndKeywords`, and :c:func:`PyArg_Parse`, all use " -"*format strings* which are used to tell the function about the expected " -"arguments. The format strings use the same syntax for each of these " -"functions." +"The first three of these functions " +"described, :c:func:`PyArg_ParseTuple`, :c:func:`PyArg_ParseTupleAndKeywords`, " +"and :c:func:`PyArg_Parse`, all use *format strings* which are used to tell " +"the function about the expected arguments. The format strings use the same " +"syntax for each of these functions." msgstr "" msgid "Parsing arguments" @@ -116,10 +114,10 @@ msgid "" msgstr "" msgid "" -"To ensure that the underlying buffer may be safely borrowed, the object's :c:" -"member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. This " -"disallows common mutable objects such as :class:`bytearray`, but also some " -"read-only objects such as :class:`memoryview` of :class:`bytes`." +"To ensure that the underlying buffer may be safely borrowed, the " +"object's :c:member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. " +"This disallows common mutable objects such as :class:`bytearray`, but also " +"some read-only objects such as :class:`memoryview` of :class:`bytes`." msgstr "" msgid "" @@ -143,8 +141,8 @@ msgstr "" msgid "" "This format does not accept :term:`bytes-like objects `. " "If you want to accept filesystem paths and convert them to C character " -"strings, it is preferable to use the ``O&`` format with :c:func:" -"`PyUnicode_FSConverter` as *converter*." +"strings, it is preferable to use the ``O&`` format " +"with :c:func:`PyUnicode_FSConverter` as *converter*." msgstr "" msgid "" @@ -163,8 +161,8 @@ msgid "" msgstr "" msgid "" -"``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char \\*, :" -"c:type:`Py_ssize_t`]" +"``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char " +"\\*, :c:type:`Py_ssize_t`]" msgstr "" msgid "" @@ -226,8 +224,8 @@ msgid "" msgstr "" msgid "" -"``y#`` (read-only :term:`bytes-like object`) [const char \\*, :c:type:" -"`Py_ssize_t`]" +"``y#`` (read-only :term:`bytes-like object`) [const char " +"\\*, :c:type:`Py_ssize_t`]" msgstr "" msgid "" @@ -251,9 +249,9 @@ msgstr "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]" msgid "" "Requires that the Python object is a :class:`bytearray` object, without " -"attempting any conversion. Raises :exc:`TypeError` if the object is not a :" -"class:`bytearray` object. The C variable may also be declared as :c:expr:" -"`PyObject*`." +"attempting any conversion. Raises :exc:`TypeError` if the object is not " +"a :class:`bytearray` object. The C variable may also be declared " +"as :c:expr:`PyObject*`." msgstr "" msgid "``U`` (:class:`str`) [PyObject \\*]" @@ -271,8 +269,8 @@ msgstr "" msgid "" "This format accepts any object which implements the read-write buffer " "interface. It fills a :c:type:`Py_buffer` structure provided by the caller. " -"The buffer may contain embedded null bytes. The caller have to call :c:func:" -"`PyBuffer_Release` when it is done with the buffer." +"The buffer may contain embedded null bytes. The caller has to " +"call :c:func:`PyBuffer_Release` when it is done with the buffer." msgstr "" msgid "``es`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer]" @@ -298,8 +296,8 @@ msgstr "" msgid "" ":c:func:`PyArg_ParseTuple` will allocate a buffer of the needed size, copy " "the encoded data into this buffer and adjust *\\*buffer* to reference the " -"newly allocated storage. The caller is responsible for calling :c:func:" -"`PyMem_Free` to free the allocated buffer after use." +"newly allocated storage. The caller is responsible for " +"calling :c:func:`PyMem_Free` to free the allocated buffer after use." msgstr "" msgid "" @@ -317,8 +315,8 @@ msgstr "" "że obiekt łańcucha znaków wykorzystuje kodowanie przekazane jako parametr." msgid "" -"``es#`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer, :c:type:" -"`Py_ssize_t` \\*buffer_length]" +"``es#`` (:class:`str`) [const char \\*encoding, char " +"\\*\\*buffer, :c:type:`Py_ssize_t` \\*buffer_length]" msgstr "" msgid "" @@ -392,10 +390,11 @@ msgstr "Liczby" msgid "" "These formats allow representing Python numbers or single characters as C " -"numbers. Formats that require :class:`int`, :class:`float` or :class:" -"`complex` can also use the corresponding special methods :meth:`~object." -"__index__`, :meth:`~object.__float__` or :meth:`~object.__complex__` to " -"convert the Python object to the required type." +"numbers. Formats that require :class:`int`, :class:`float` " +"or :class:`complex` can also use the corresponding special " +"methods :meth:`~object.__index__`, :meth:`~object.__float__` " +"or :meth:`~object.__complex__` to convert the Python object to the required " +"type." msgstr "" msgid "" @@ -528,9 +527,9 @@ msgstr "``O`` (object) [PyObject \\*]" msgid "" "Store a Python object (without any conversion) in a C object pointer. The C " -"program thus receives the actual object that was passed. A new :term:" -"`strong reference` to the object is not created (i.e. its reference count is " -"not increased). The pointer stored is not ``NULL``." +"program thus receives the actual object that was passed. A " +"new :term:`strong reference` to the object is not created (i.e. its " +"reference count is not increased). The pointer stored is not ``NULL``." msgstr "" msgid "``O!`` (object) [*typeobject*, PyObject \\*]" @@ -558,12 +557,12 @@ msgid "status = converter(object, address);" msgstr "" msgid "" -"where *object* is the Python object to be converted and *address* is the :c:" -"expr:`void*` argument that was passed to the ``PyArg_Parse*`` function. The " -"returned *status* should be ``1`` for a successful conversion and ``0`` if " -"the conversion has failed. When the conversion fails, the *converter* " -"function should raise an exception and leave the content of *address* " -"unmodified." +"where *object* is the Python object to be converted and *address* is " +"the :c:expr:`void*` argument that was passed to the ``PyArg_Parse*`` " +"function. The returned *status* should be ``1`` for a successful conversion " +"and ``0`` if the conversion has failed. When the conversion fails, the " +"*converter* function should raise an exception and leave the content of " +"*address* unmodified." msgstr "" msgid "" @@ -575,8 +574,8 @@ msgid "" msgstr "" msgid "" -"Examples of converters: :c:func:`PyUnicode_FSConverter` and :c:func:" -"`PyUnicode_FSDecoder`." +"Examples of converters: :c:func:`PyUnicode_FSConverter` " +"and :c:func:`PyUnicode_FSDecoder`." msgstr "" msgid ":c:macro:`!Py_CLEANUP_SUPPORTED` was added." @@ -621,7 +620,8 @@ msgid "" "optional. The C variables corresponding to optional arguments should be " "initialized to their default value --- when an optional argument is not " "specified, :c:func:`PyArg_ParseTuple` does not touch the contents of the " -"corresponding C variable(s)." +"corresponding C variable(s). For example, the format string ``\"OO|OO\"`` " +"corresponds to the Python signature ``f(a, b, c=None, d=None)``." msgstr "" msgid "``$``" @@ -629,9 +629,11 @@ msgstr "``$``" msgid "" ":c:func:`PyArg_ParseTupleAndKeywords` only: Indicates that the remaining " -"arguments in the Python argument list are keyword-only. Currently, all " -"keyword-only arguments must also be optional arguments, so ``|`` must always " -"be specified before ``$`` in the format string." +"arguments in the Python argument list are keyword-only. They are optional if " +"``|`` was specified before ``$``, and required otherwise. ``|`` cannot be " +"specified after ``$``. For example, the format string ``\"O|O$O\"`` " +"corresponds to the Python signature ``f(a, b=None, *, c=None)``, and the " +"format string ``\"OO$OO\"`` corresponds to ``f(a, b, *, c, d)``." msgstr "" msgid "``:``" @@ -648,8 +650,8 @@ msgstr "``;``" msgid "" "The list of format units ends here; the string after the semicolon is used " -"as the error message *instead* of the default error message. ``:`` and ``;" -"`` mutually exclude each other." +"as the error message *instead* of the default error message. ``:`` and " +"``;`` mutually exclude each other." msgstr "" "Na tym kończy się lista jednostek formatu; ciąg po średniku jest traktowany " "jako informacja o błędzie do użycia *zamiast* automatycznej wiadomości o " @@ -709,9 +711,9 @@ msgid "" msgstr "" msgid "" -"The *keywords* parameter declaration is :c:expr:`char * const *` in C and :c:" -"expr:`const char * const *` in C++. This can be overridden with the :c:macro:" -"`PY_CXX_CONST` macro." +"The *keywords* parameter declaration is :c:expr:`char * const *` in C " +"and :c:expr:`const char * const *` in C++. This can be overridden with " +"the :c:macro:`PY_CXX_CONST` macro." msgstr "" msgid "" @@ -720,9 +722,9 @@ msgid "" msgstr "" msgid "" -"The *keywords* parameter has now type :c:expr:`char * const *` in C and :c:" -"expr:`const char * const *` in C++, instead of :c:expr:`char **`. Added " -"support for non-ASCII keyword parameter names." +"The *keywords* parameter has now type :c:expr:`char * const *` in C " +"and :c:expr:`const char * const *` in C++, instead of :c:expr:`char **`. " +"Added support for non-ASCII keyword parameter names." msgstr "" msgid "" @@ -833,10 +835,10 @@ msgid "" "When memory buffers are passed as parameters to supply data to build " "objects, as for the ``s`` and ``s#`` formats, the required data is copied. " "Buffers provided by the caller are never referenced by the objects created " -"by :c:func:`Py_BuildValue`. In other words, if your code invokes :c:func:" -"`malloc` and passes the allocated memory to :c:func:`Py_BuildValue`, your " -"code is responsible for calling :c:func:`free` for that memory once :c:func:" -"`Py_BuildValue` returns." +"by :c:func:`Py_BuildValue`. In other words, if your code " +"invokes :c:func:`malloc` and passes the allocated memory " +"to :c:func:`Py_BuildValue`, your code is responsible for " +"calling :c:func:`free` for that memory once :c:func:`Py_BuildValue` returns." msgstr "" msgid "" @@ -986,9 +988,9 @@ msgid "" "Pass a Python object untouched but create a new :term:`strong reference` to " "it (i.e. its reference count is incremented by one). If the object passed in " "is a ``NULL`` pointer, it is assumed that this was caused because the call " -"producing the argument found an error and set an exception. Therefore, :c:" -"func:`Py_BuildValue` will return ``NULL`` but won't raise an exception. If " -"no exception has been raised yet, :exc:`SystemError` is set." +"producing the argument found an error and set an exception. " +"Therefore, :c:func:`Py_BuildValue` will return ``NULL`` but won't raise an " +"exception. If no exception has been raised yet, :exc:`SystemError` is set." msgstr "" msgid "``S`` (object) [PyObject \\*]" @@ -1011,9 +1013,9 @@ msgstr "``O&`` (object) [*converter*, *anything*]" msgid "" "Convert *anything* to a Python object through a *converter* function. The " -"function is called with *anything* (which should be compatible with :c:expr:" -"`void*`) as its argument and should return a \"new\" Python object, or " -"``NULL`` if an error occurred." +"function is called with *anything* (which should be compatible " +"with :c:expr:`void*`) as its argument and should return a \"new\" Python " +"object, or ``NULL`` if an error occurred." msgstr "" msgid "" diff --git a/c-api/bool.po b/c-api/bool.po index e317bc7893..49fc4f9d16 100644 --- a/c-api/bool.po +++ b/c-api/bool.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -47,16 +46,16 @@ msgstr "" "zawsze kończy się powodzeniem." msgid "" -"The Python ``False`` object. This object has no methods and is :term:" -"`immortal`." +"The Python ``False`` object. This object has no methods and " +"is :term:`immortal`." msgstr "" msgid ":c:data:`Py_False` is :term:`immortal`." msgstr ":c:data:`Py_False` jest :term:`immortal`." msgid "" -"The Python ``True`` object. This object has no methods and is :term:" -"`immortal`." +"The Python ``True`` object. This object has no methods and " +"is :term:`immortal`." msgstr "" msgid ":c:data:`Py_True` is :term:`immortal`." diff --git a/c-api/buffer.po b/c-api/buffer.po index 42fe8d7203..75e6825810 100644 --- a/c-api/buffer.po +++ b/c-api/buffer.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,10 +28,10 @@ msgstr "" msgid "" "Certain objects available in Python wrap access to an underlying memory " -"array or *buffer*. Such objects include the built-in :class:`bytes` and :" -"class:`bytearray`, and some extension types like :class:`array.array`. Third-" -"party libraries may define their own types for special purposes, such as " -"image processing or numeric analysis." +"array or *buffer*. Such objects include the built-in :class:`bytes` " +"and :class:`bytearray`, and some extension types like :class:`array.array`. " +"Third-party libraries may define their own types for special purposes, such " +"as image processing or numeric analysis." msgstr "" msgid "" @@ -44,19 +42,21 @@ msgid "" msgstr "" msgid "" -"Python provides such a facility at the C level in the form of the :ref:" -"`buffer protocol `. This protocol has two sides:" +"Python provides such a facility at the C and Python level in the form of " +"the :ref:`buffer protocol `. This protocol has two sides:" msgstr "" msgid "" "on the producer side, a type can export a \"buffer interface\" which allows " "objects of that type to expose information about their underlying buffer. " -"This interface is described in the section :ref:`buffer-structs`;" +"This interface is described in the section :ref:`buffer-structs`; for Python " +"see :ref:`python-buffer-protocol`." msgstr "" msgid "" "on the consumer side, several means are available to obtain a pointer to the " -"raw underlying data of an object (for example a method parameter)." +"raw underlying data of an object (for example a method parameter). For " +"Python see :class:`memoryview`." msgstr "" msgid "" @@ -67,14 +67,14 @@ msgid "" msgstr "" msgid "" -"An example consumer of the buffer interface is the :meth:`~io.BufferedIOBase." -"write` method of file objects: any object that can export a series of bytes " -"through the buffer interface can be written to a file. While :meth:`!write` " -"only needs read-only access to the internal contents of the object passed to " -"it, other methods such as :meth:`~io.BufferedIOBase.readinto` need write " -"access to the contents of their argument. The buffer interface allows " -"objects to selectively allow or reject exporting of read-write and read-only " -"buffers." +"An example consumer of the buffer interface is " +"the :meth:`~io.BufferedIOBase.write` method of file objects: any object that " +"can export a series of bytes through the buffer interface can be written to " +"a file. While :meth:`!write` only needs read-only access to the internal " +"contents of the object passed to it, other methods such " +"as :meth:`~io.BufferedIOBase.readinto` need write access to the contents of " +"their argument. The buffer interface allows objects to selectively allow or " +"reject exporting of read-write and read-only buffers." msgstr "" msgid "" @@ -96,6 +96,11 @@ msgid "" "resource leaks." msgstr "" +msgid "" +"The buffer protocol is now accessible in Python, see :ref:`python-buffer-" +"protocol` and :class:`memoryview`." +msgstr "" + msgid "Buffer structure" msgstr "" @@ -120,8 +125,8 @@ msgstr "" msgid "" "For short instructions how to write an exporting object, see :ref:`Buffer " -"Object Structures `. For obtaining a buffer, see :c:func:" -"`PyObject_GetBuffer`." +"Object Structures `. For obtaining a buffer, " +"see :c:func:`PyObject_GetBuffer`." msgstr "" msgid "" @@ -144,9 +149,9 @@ msgid "" msgstr "" msgid "" -"As a special case, for *temporary* buffers that are wrapped by :c:func:" -"`PyMemoryView_FromBuffer` or :c:func:`PyBuffer_FillInfo` this field is " -"``NULL``. In general, exporting objects MUST NOT use this scheme." +"As a special case, for *temporary* buffers that are wrapped " +"by :c:func:`PyMemoryView_FromBuffer` or :c:func:`PyBuffer_FillInfo` this " +"field is ``NULL``. In general, exporting objects MUST NOT use this scheme." msgstr "" msgid "" @@ -159,8 +164,8 @@ msgstr "" msgid "" "Accessing ``((char *)buf)[0] up to ((char *)buf)[len-1]`` is only valid if " "the buffer has been obtained by a request that guarantees contiguity. In " -"most cases such a request will be :c:macro:`PyBUF_SIMPLE` or :c:macro:" -"`PyBUF_WRITABLE`." +"most cases such a request will be :c:macro:`PyBUF_SIMPLE` " +"or :c:macro:`PyBUF_WRITABLE`." msgstr "" msgid "" @@ -169,27 +174,29 @@ msgid "" msgstr "" msgid "" -"Item size in bytes of a single element. Same as the value of :func:`struct." -"calcsize` called on non-``NULL`` :c:member:`~Py_buffer.format` values." +"Item size in bytes of a single element. Same as the value " +"of :func:`struct.calcsize` called on non-" +"``NULL`` :c:member:`~Py_buffer.format` values." msgstr "" msgid "" -"Important exception: If a consumer requests a buffer without the :c:macro:" -"`PyBUF_FORMAT` flag, :c:member:`~Py_buffer.format` will be set to " -"``NULL``, but :c:member:`~Py_buffer.itemsize` still has the value for the " -"original format." +"Important exception: If a consumer requests a buffer without " +"the :c:macro:`PyBUF_FORMAT` flag, :c:member:`~Py_buffer.format` will be set " +"to ``NULL``, but :c:member:`~Py_buffer.itemsize` still has the value for " +"the original format." msgstr "" msgid "" "If :c:member:`~Py_buffer.shape` is present, the equality ``product(shape) * " -"itemsize == len`` still holds and the consumer can use :c:member:`~Py_buffer." -"itemsize` to navigate the buffer." +"itemsize == len`` still holds and the consumer can " +"use :c:member:`~Py_buffer.itemsize` to navigate the buffer." msgstr "" msgid "" -"If :c:member:`~Py_buffer.shape` is ``NULL`` as a result of a :c:macro:" -"`PyBUF_SIMPLE` or a :c:macro:`PyBUF_WRITABLE` request, the consumer must " -"disregard :c:member:`~Py_buffer.itemsize` and assume ``itemsize == 1``." +"If :c:member:`~Py_buffer.shape` is ``NULL`` as a result of " +"a :c:macro:`PyBUF_SIMPLE` or a :c:macro:`PyBUF_WRITABLE` request, the " +"consumer must disregard :c:member:`~Py_buffer.itemsize` and assume " +"``itemsize == 1``." msgstr "" msgid "" @@ -204,16 +211,17 @@ msgstr "" msgid "" "The number of dimensions the memory represents as an n-dimensional array. If " "it is ``0``, :c:member:`~Py_buffer.buf` points to a single item representing " -"a scalar. In this case, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer." -"strides` and :c:member:`~Py_buffer.suboffsets` MUST be ``NULL``. The maximum " -"number of dimensions is given by :c:macro:`PyBUF_MAX_NDIM`." +"a scalar. In this " +"case, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer.strides` " +"and :c:member:`~Py_buffer.suboffsets` MUST be ``NULL``. The maximum number " +"of dimensions is given by :c:macro:`PyBUF_MAX_NDIM`." msgstr "" msgid "" "An array of :c:type:`Py_ssize_t` of length :c:member:`~Py_buffer.ndim` " "indicating the shape of the memory as an n-dimensional array. Note that " -"``shape[0] * ... * shape[ndim-1] * itemsize`` MUST be equal to :c:member:" -"`~Py_buffer.len`." +"``shape[0] * ... * shape[ndim-1] * itemsize`` MUST be equal " +"to :c:member:`~Py_buffer.len`." msgstr "" msgid "" @@ -295,9 +303,8 @@ msgstr "" msgid "" "The following fields are not influenced by *flags* and must always be filled " -"in with the correct values: :c:member:`~Py_buffer.obj`, :c:member:" -"`~Py_buffer.buf`, :c:member:`~Py_buffer.len`, :c:member:`~Py_buffer." -"itemsize`, :c:member:`~Py_buffer.ndim`." +"in with the correct " +"values: :c:member:`~Py_buffer.obj`, :c:member:`~Py_buffer.buf`, :c:member:`~Py_buffer.len`, :c:member:`~Py_buffer.itemsize`, :c:member:`~Py_buffer.ndim`." msgstr "" msgid "readonly, format" @@ -311,6 +318,9 @@ msgid "" "PyBUF_WRITABLE` can be used to request a simple writable buffer." msgstr "" +msgid "This is a :term:`soft deprecated` alias to :c:macro:`PyBUF_WRITABLE`." +msgstr "" + msgid "" "Controls the :c:member:`~Py_buffer.format` field. If set, this field MUST be " "filled in correctly. Otherwise, this field MUST be ``NULL``." @@ -318,15 +328,15 @@ msgstr "" msgid "" ":c:macro:`PyBUF_WRITABLE` can be \\|'d to any of the flags in the next " -"section. Since :c:macro:`PyBUF_SIMPLE` is defined as 0, :c:macro:" -"`PyBUF_WRITABLE` can be used as a stand-alone flag to request a simple " -"writable buffer." +"section. Since :c:macro:`PyBUF_SIMPLE` is defined as " +"0, :c:macro:`PyBUF_WRITABLE` can be used as a stand-alone flag to request a " +"simple writable buffer." msgstr "" msgid "" -":c:macro:`PyBUF_FORMAT` must be \\|'d to any of the flags except :c:macro:" -"`PyBUF_SIMPLE`, because the latter already implies format ``B`` (unsigned " -"bytes). :c:macro:`!PyBUF_FORMAT` cannot be used on its own." +":c:macro:`PyBUF_FORMAT` must be \\|'d to any of the flags " +"except :c:macro:`PyBUF_SIMPLE`, because the latter already implies format " +"``B`` (unsigned bytes). :c:macro:`!PyBUF_FORMAT` cannot be used on its own." msgstr "" msgid "shape, strides, suboffsets" @@ -419,16 +429,17 @@ msgid "NumPy-style: shape and strides" msgstr "" msgid "" -"The logical structure of NumPy-style arrays is defined by :c:member:" -"`~Py_buffer.itemsize`, :c:member:`~Py_buffer.ndim`, :c:member:`~Py_buffer." -"shape` and :c:member:`~Py_buffer.strides`." +"The logical structure of NumPy-style arrays is defined " +"by :c:member:`~Py_buffer.itemsize`, :c:member:`~Py_buffer.ndim`, :c:member:`~Py_buffer.shape` " +"and :c:member:`~Py_buffer.strides`." msgstr "" msgid "" -"If ``ndim == 0``, the memory location pointed to by :c:member:`~Py_buffer." -"buf` is interpreted as a scalar of size :c:member:`~Py_buffer.itemsize`. In " -"that case, both :c:member:`~Py_buffer.shape` and :c:member:`~Py_buffer." -"strides` are ``NULL``." +"If ``ndim == 0``, the memory location pointed to " +"by :c:member:`~Py_buffer.buf` is interpreted as a scalar of " +"size :c:member:`~Py_buffer.itemsize`. In that case, " +"both :c:member:`~Py_buffer.shape` and :c:member:`~Py_buffer.strides` are " +"``NULL``." msgstr "" msgid "" @@ -522,8 +533,8 @@ msgstr "" msgid "" "Send a request to *exporter* to fill in *view* as specified by *flags*. If " -"the exporter cannot provide a buffer of the exact type, it MUST raise :exc:" -"`BufferError`, set ``view->obj`` to ``NULL`` and return ``-1``." +"the exporter cannot provide a buffer of the exact type, it MUST " +"raise :exc:`BufferError`, set ``view->obj`` to ``NULL`` and return ``-1``." msgstr "" msgid "" @@ -535,9 +546,9 @@ msgstr "" msgid "" "Successful calls to :c:func:`PyObject_GetBuffer` must be paired with calls " -"to :c:func:`PyBuffer_Release`, similar to :c:func:`malloc` and :c:func:" -"`free`. Thus, after the consumer is done with the buffer, :c:func:" -"`PyBuffer_Release` must be called exactly once." +"to :c:func:`PyBuffer_Release`, similar to :c:func:`malloc` " +"and :c:func:`free`. Thus, after the consumer is done with the " +"buffer, :c:func:`PyBuffer_Release` must be called exactly once." msgstr "" msgid "" @@ -548,13 +559,14 @@ msgid "" msgstr "" msgid "" -"It is an error to call this function on a buffer that was not obtained via :" -"c:func:`PyObject_GetBuffer`." +"It is an error to call this function on a buffer that was not obtained " +"via :c:func:`PyObject_GetBuffer`." msgstr "" msgid "" -"Return the implied :c:member:`~Py_buffer.itemsize` from :c:member:" -"`~Py_buffer.format`. On error, raise an exception and return -1." +"Return the implied :c:member:`~Py_buffer.itemsize` " +"from :c:member:`~Py_buffer.format`. On error, raise an exception and return " +"-1." msgstr "" msgid "" diff --git a/c-api/bytearray.po b/c-api/bytearray.po index 3fe2512fbc..39bc4d72b2 100644 --- a/c-api/bytearray.po +++ b/c-api/bytearray.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,6 +30,13 @@ msgid "" "This subtype of :c:type:`PyObject` represents a Python bytearray object." msgstr "" +msgid "" +"The internal buffer of :c:type:`PyByteArrayObject` always includes an extra " +"trailing null byte for compatibility with null terminated C strings. This " +"extra byte is not counted in :c:func:`PyByteArray_Size` nor in the *len* " +"arguments of the functions below." +msgstr "" + msgid "" "This instance of :c:type:`PyTypeObject` represents the Python bytearray " "type; it is the same object as :class:`bytearray` in the Python layer." @@ -52,8 +59,8 @@ msgid "Direct API functions" msgstr "" msgid "" -"Return a new bytearray object from any object, *o*, that implements the :ref:" -"`buffer protocol `." +"Return a new bytearray object from any object, *o*, that implements " +"the :ref:`buffer protocol `." msgstr "" msgid "On failure, return ``NULL`` with an exception set." diff --git a/c-api/bytes.po b/c-api/bytes.po index ee3ad6e346..54e657847f 100644 --- a/c-api/bytes.po +++ b/c-api/bytes.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,6 +31,13 @@ msgid "" "called with a non-bytes parameter." msgstr "" +msgid "" +"The internal buffer of :c:type:`PyBytesObject` always includes an extra " +"trailing null byte for compatibility with null terminated C strings. This " +"extra byte is not counted in :c:func:`PyBytes_Size` nor in the various " +"*length* and *size* arguments of the functions below." +msgstr "" + msgid "This subtype of :c:type:`PyObject` represents a Python bytes object." msgstr "" @@ -136,7 +141,7 @@ msgid "``%zd``" msgstr "``%zd``" msgid ":c:type:`\\ Py_ssize_t`" -msgstr "" +msgstr ":c:type:`\\ Py_ssize_t`" msgid "Equivalent to ``printf(\"%zd\")``. [1]_" msgstr "" @@ -215,8 +220,8 @@ msgid "" "buffer is always null, regardless of whether there are any other null " "bytes. The data must not be modified in any way, unless the object was just " "created using ``PyBytes_FromStringAndSize(NULL, size)``. It must not be " -"deallocated. If *o* is not a bytes object at all, :c:func:" -"`PyBytes_AsString` returns ``NULL`` and raises :exc:`TypeError`." +"deallocated. If *o* is not a bytes object at " +"all, :c:func:`PyBytes_AsString` returns ``NULL`` and raises :exc:`TypeError`." msgstr "" msgid "Similar to :c:func:`PyBytes_AsString`, but without error checking." @@ -249,10 +254,11 @@ msgstr "" msgid "" "Create a new bytes object in *\\*bytes* containing the contents of *newpart* " -"appended to *bytes*; the caller will own the new reference. The reference " -"to the old value of *bytes* will be stolen. If the new object cannot be " -"created, the old reference to *bytes* will still be discarded and the value " -"of *\\*bytes* will be set to ``NULL``; the appropriate exception will be set." +"appended to *bytes*; the caller will own the new reference. The reference to " +"the old value of *bytes* will be \":term:`stolen `\". If the new " +"object cannot be created, the old reference to *bytes* will still be " +"\"stolen\", the value of *\\*bytes* will be set to ``NULL``, and the " +"appropriate exception will be set." msgstr "" msgid "" @@ -272,6 +278,49 @@ msgid "" "``NULL``, :exc:`MemoryError` is set, and ``-1`` is returned." msgstr "" +msgid "" +"Get the string representation of *bytes*. This function is currently used to " +"implement :meth:`!bytes.__repr__` in Python." +msgstr "" + +msgid "" +"This function does not do type checking; it is undefined behavior to pass " +"*bytes* as a non-bytes object or ``NULL``." +msgstr "" + +msgid "" +"If *smartquotes* is true, the representation will use a double-quoted string " +"instead of single-quoted string when single-quotes are present in *bytes*. " +"For example, the byte string ``'Python'`` would be represented as " +"``b\"'Python'\"`` when *smartquotes* is true, or ``b'\\'Python\\''`` when it " +"is false." +msgstr "" + +msgid "" +"On success, this function returns a :term:`strong reference` to " +"a :class:`str` object containing the representation. On failure, this " +"returns ``NULL`` with an exception set." +msgstr "" + +msgid "" +"Unescape a backslash-escaped string *s*. *s* must not be ``NULL``. *len* " +"must be the size of *s*." +msgstr "" + +msgid "" +"*errors* must be one of ``\"strict\"``, ``\"replace\"``, or ``\"ignore\"``. " +"If *errors* is ``NULL``, then ``\"strict\"`` is used by default." +msgstr "" + +msgid "" +"On success, this function returns a :term:`strong reference` to a " +"Python :class:`bytes` object containing the unescaped string. On failure, " +"this function returns ``NULL`` with an exception set." +msgstr "" + +msgid "*unicode* and *recode_encoding* are now unused." +msgstr "" + msgid "object" msgstr "obiekt" diff --git a/c-api/call.po b/c-api/call.po index badd2f989b..c86548a79f 100644 --- a/c-api/call.po +++ b/c-api/call.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +50,9 @@ msgid "" msgstr "" msgid "" -"This convention is not only used by *tp_call*: :c:member:`~PyTypeObject." -"tp_new` and :c:member:`~PyTypeObject.tp_init` also pass arguments this way." +"This convention is not only used by " +"*tp_call*: :c:member:`~PyTypeObject.tp_new` " +"and :c:member:`~PyTypeObject.tp_init` also pass arguments this way." msgstr "" msgid "" @@ -72,17 +71,18 @@ msgstr "" msgid "" "As rule of thumb, CPython will prefer the vectorcall for internal calls if " "the callable supports it. However, this is not a hard rule. Additionally, " -"some third-party extensions use *tp_call* directly (rather than using :c:" -"func:`PyObject_Call`). Therefore, a class supporting vectorcall must also " -"implement :c:member:`~PyTypeObject.tp_call`. Moreover, the callable must " -"behave the same regardless of which protocol is used. The recommended way to " -"achieve this is by setting :c:member:`~PyTypeObject.tp_call` to :c:func:" -"`PyVectorcall_Call`. This bears repeating:" +"some third-party extensions use *tp_call* directly (rather than " +"using :c:func:`PyObject_Call`). Therefore, a class supporting vectorcall " +"must also implement :c:member:`~PyTypeObject.tp_call`. Moreover, the " +"callable must behave the same regardless of which protocol is used. The " +"recommended way to achieve this is by " +"setting :c:member:`~PyTypeObject.tp_call` to :c:func:`PyVectorcall_Call`. " +"This bears repeating:" msgstr "" msgid "" -"A class supporting vectorcall **must** also implement :c:member:" -"`~PyTypeObject.tp_call` with the same semantics." +"A class supporting vectorcall **must** also " +"implement :c:member:`~PyTypeObject.tp_call` with the same semantics." msgstr "" msgid "" @@ -102,11 +102,11 @@ msgid "" msgstr "" msgid "" -"Classes can implement the vectorcall protocol by enabling the :c:macro:" -"`Py_TPFLAGS_HAVE_VECTORCALL` flag and setting :c:member:`~PyTypeObject." -"tp_vectorcall_offset` to the offset inside the object structure where a " -"*vectorcallfunc* appears. This is a pointer to a function with the following " -"signature:" +"Classes can implement the vectorcall protocol by enabling " +"the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag and " +"setting :c:member:`~PyTypeObject.tp_vectorcall_offset` to the offset inside " +"the object structure where a *vectorcallfunc* appears. This is a pointer to " +"a function with the following signature:" msgstr "" msgid "*callable* is the object being called." @@ -168,8 +168,8 @@ msgstr "Kontrola Rekursji" msgid "" "When using *tp_call*, callees do not need to worry about :ref:`recursion " -"`: CPython uses :c:func:`Py_EnterRecursiveCall` and :c:func:" -"`Py_LeaveRecursiveCall` for calls made using *tp_call*." +"`: CPython uses :c:func:`Py_EnterRecursiveCall` " +"and :c:func:`Py_LeaveRecursiveCall` for calls made using *tp_call*." msgstr "" msgid "" @@ -212,10 +212,10 @@ msgid "" msgstr "" msgid "" -"This is a specialized function, intended to be put in the :c:member:" -"`~PyTypeObject.tp_call` slot or be used in an implementation of ``tp_call``. " -"It does not check the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag and it does " -"not fall back to ``tp_call``." +"This is a specialized function, intended to be put in " +"the :c:member:`~PyTypeObject.tp_call` slot or be used in an implementation " +"of ``tp_call``. It does not check the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` " +"flag and it does not fall back to ``tp_call``." msgstr "" msgid "Object Calling API" @@ -366,8 +366,8 @@ msgid "" msgstr "" msgid "" -"Note that if you only pass :c:expr:`PyObject *` args, :c:func:" -"`PyObject_CallFunctionObjArgs` is a faster alternative." +"Note that if you only pass :c:expr:`PyObject *` " +"args, :c:func:`PyObject_CallFunctionObjArgs` is a faster alternative." msgstr "" msgid "The type of *format* was changed from ``char *``." @@ -388,17 +388,17 @@ msgid "" msgstr "" msgid "" -"Note that if you only pass :c:expr:`PyObject *` args, :c:func:" -"`PyObject_CallMethodObjArgs` is a faster alternative." +"Note that if you only pass :c:expr:`PyObject *` " +"args, :c:func:`PyObject_CallMethodObjArgs` is a faster alternative." msgstr "" msgid "The types of *name* and *format* were changed from ``char *``." msgstr "" msgid "" -"Call a callable Python object *callable*, with a variable number of :c:expr:" -"`PyObject *` arguments. The arguments are provided as a variable number of " -"parameters followed by *NULL*." +"Call a callable Python object *callable*, with a variable number " +"of :c:expr:`PyObject *` arguments. The arguments are provided as a variable " +"number of parameters followed by *NULL*." msgstr "" msgid "" @@ -425,9 +425,17 @@ msgid "" msgstr "" msgid "" -"Call a callable Python object *callable*. The arguments are the same as for :" -"c:type:`vectorcallfunc`. If *callable* supports vectorcall_, this directly " -"calls the vectorcall function stored in *callable*." +"Call a callable Python object *callable*. The arguments are the same as " +"for :c:type:`vectorcallfunc`. If *callable* supports vectorcall_, this " +"directly calls the vectorcall function stored in *callable*." +msgstr "" + +msgid "as ``_PyObject_Vectorcall``" +msgstr "" + +msgid "" +"Renamed to the current name, without the leading underscore. The old " +"provisional name is :term:`soft deprecated`." msgstr "" msgid "" @@ -448,10 +456,10 @@ msgid "" "method is given as a Python string *name*. The object whose method is called " "is *args[0]*, and the *args* array starting at *args[1]* represents the " "arguments of the call. There must be at least one positional argument. " -"*nargsf* is the number of positional arguments including *args[0]*, plus :c:" -"macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` if the value of ``args[0]`` may " -"temporarily be changed. Keyword arguments can be passed just like in :c:func:" -"`PyObject_Vectorcall`." +"*nargsf* is the number of positional arguments including *args[0]*, " +"plus :c:macro:`PY_VECTORCALL_ARGUMENTS_OFFSET` if the value of ``args[0]`` " +"may temporarily be changed. Keyword arguments can be passed just like " +"in :c:func:`PyObject_Vectorcall`." msgstr "" msgid "" diff --git a/c-api/capsule.po b/c-api/capsule.po index 1a4ae7dc27..1e03610e0c 100644 --- a/c-api/capsule.po +++ b/c-api/capsule.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: haaritsubaki, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,13 +32,18 @@ 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*` " +"extension modules which 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 object corresponding to capsule objects. This is the same object " +"as :class:`types.CapsuleType` in the Python layer." +msgstr "" + msgid "The type of a destructor callback for a capsule. Defined as::" msgstr "" @@ -99,8 +104,8 @@ msgstr "" msgid "" "It is legal for a capsule to have a ``NULL`` destructor. This makes a " -"``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :" -"c:func:`PyErr_Occurred` to disambiguate." +"``NULL`` return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` " +"or :c:func:`PyErr_Occurred` to disambiguate." msgstr "" msgid "" @@ -110,8 +115,8 @@ msgstr "" msgid "" "It is legal for a capsule to have a ``NULL`` context. This makes a ``NULL`` " -"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:" -"`PyErr_Occurred` to disambiguate." +"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` " +"or :c:func:`PyErr_Occurred` to disambiguate." msgstr "" msgid "" @@ -121,8 +126,8 @@ msgstr "" msgid "" "It is legal for a capsule to have a ``NULL`` name. This makes a ``NULL`` " -"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:" -"`PyErr_Occurred` to disambiguate." +"return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` " +"or :c:func:`PyErr_Occurred` to disambiguate." msgstr "" msgid "" @@ -132,11 +137,23 @@ msgid "" "string exactly." msgstr "" +msgid "" +"This function splits *name* on the ``.`` character, and imports the first " +"element. It then processes further elements using attribute lookups." +msgstr "" + msgid "" "Return the capsule's internal *pointer* on success. On failure, set an " "exception and return ``NULL``." msgstr "" +msgid "" +"If *name* points to an attribute of some submodule or subpackage, this " +"submodule or subpackage must be previously imported using other means (for " +"example, by using :c:func:`PyImport_ImportModule`) for the attribute lookups " +"to succeed." +msgstr "" + msgid "*no_block* has no effect anymore." msgstr "" diff --git a/c-api/cell.po b/c-api/cell.po index 56b5b045c4..eb427ff786 100644 --- a/c-api/cell.po +++ b/c-api/cell.po @@ -4,16 +4,16 @@ # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2024\n" +"POT-Creation-Date: 2025-10-25 15:01+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/c-api/code.po b/c-api/code.po index 1a7d0080c4..ffddff3e57 100644 --- a/c-api/code.po +++ b/c-api/code.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: haaritsubaki, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +38,8 @@ msgid "" msgstr "" msgid "" -"This is an instance of :c:type:`PyTypeObject` representing the Python :ref:" -"`code object `." +"This is an instance of :c:type:`PyTypeObject` representing the " +"Python :ref:`code object `." msgstr "" msgid "" @@ -69,8 +69,9 @@ msgid "" msgstr "" msgid "" -"Since the definition of the bytecode changes often, calling :c:func:" -"`PyUnstable_Code_New` directly can bind you to a precise Python version." +"Since the definition of the bytecode changes often, " +"calling :c:func:`PyUnstable_Code_New` directly can bind you to a precise " +"Python version." msgstr "" msgid "" @@ -117,8 +118,9 @@ msgid "" msgstr "" msgid "" -"For efficiently iterating over the line numbers in a code object, use :pep:" -"`the API described in PEP 626 <0626#out-of-process-debuggers-and-profilers>`." +"For efficiently iterating over the line numbers in a code object, " +"use :pep:`the API described in PEP 626 <0626#out-of-process-debuggers-and-" +"profilers>`." msgstr "" msgid "" @@ -157,9 +159,9 @@ msgstr "" msgid "" "Equivalent to the Python code ``getattr(co, 'co_freevars')``. Returns a new " -"reference to a :c:type:`PyTupleObject` containing the names of the :term:" -"`free (closure) variables `. On error, ``NULL`` is " -"returned and an exception is raised." +"reference to a :c:type:`PyTupleObject` containing the names of " +"the :term:`free (closure) variables `. On error, ``NULL`` " +"is returned and an exception is raised." msgstr "" msgid "" @@ -170,10 +172,10 @@ msgid "" msgstr "" msgid "" -"Clear watcher identified by *watcher_id* previously returned from :c:func:" -"`PyCode_AddWatcher` for the current interpreter. Return ``0`` on success, or " -"``-1`` and set an exception on error (e.g. if the given *watcher_id* was " -"never registered.)" +"Clear watcher identified by *watcher_id* previously returned " +"from :c:func:`PyCode_AddWatcher` for the current interpreter. Return ``0`` " +"on success, or ``-1`` and set an exception on error (e.g. if the given " +"*watcher_id* was never registered.)" msgstr "" msgid "" @@ -186,7 +188,7 @@ msgstr "" msgid "" "If *event* is ``PY_CODE_EVENT_CREATE``, then the callback is invoked after " -"`co` has been fully initialized. Otherwise, the callback is invoked before " +"*co* has been fully initialized. Otherwise, the callback is invoked before " "the destruction of *co* takes place, so the prior state of *co* can be " "inspected." msgstr "" @@ -209,8 +211,8 @@ msgstr "" msgid "" "If the callback sets an exception, it must return ``-1``; this exception " -"will be printed as an unraisable exception using :c:func:" -"`PyErr_WriteUnraisable`. Otherwise it should return ``0``." +"will be printed as an unraisable exception " +"using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``." msgstr "" msgid "" @@ -221,6 +223,93 @@ msgid "" "it before returning." msgstr "" +msgid "This is a :term:`soft deprecated` function that does nothing." +msgstr "" + +msgid "" +"Prior to Python 3.10, this function would perform basic optimizations to a " +"code object." +msgstr "" + +msgid "This function now does nothing." +msgstr "" + +msgid "Code Object Flags" +msgstr "" + +msgid "" +"Code objects contain a bit-field of flags, which can be retrieved as " +"the :attr:`~codeobject.co_flags` Python attribute (for example " +"using :c:func:`PyObject_GetAttrString`), and set using a *flags* argument " +"to :c:func:`PyUnstable_Code_New` and similar functions." +msgstr "" + +msgid "" +"Flags whose names start with ``CO_FUTURE_`` correspond to features normally " +"selectable by :ref:`future statements `. These flags can be used " +"in :c:member:`PyCompilerFlags.cf_flags`. Note that many ``CO_FUTURE_`` flags " +"are mandatory in current versions of Python, and setting them has no effect." +msgstr "" + +msgid "" +"The following flags are available. For their meaning, see the linked " +"documentation of their Python equivalents." +msgstr "" + +msgid "Flag" +msgstr "" + +msgid "Meaning" +msgstr "Znaczenie" + +msgid ":py:data:`inspect.CO_OPTIMIZED`" +msgstr "" + +msgid ":py:data:`inspect.CO_NEWLOCALS`" +msgstr "" + +msgid ":py:data:`inspect.CO_VARARGS`" +msgstr "" + +msgid ":py:data:`inspect.CO_VARKEYWORDS`" +msgstr "" + +msgid ":py:data:`inspect.CO_NESTED`" +msgstr "" + +msgid ":py:data:`inspect.CO_GENERATOR`" +msgstr "" + +msgid ":py:data:`inspect.CO_COROUTINE`" +msgstr "" + +msgid ":py:data:`inspect.CO_ITERABLE_COROUTINE`" +msgstr "" + +msgid ":py:data:`inspect.CO_ASYNC_GENERATOR`" +msgstr "" + +msgid "no effect (:py:data:`__future__.division`)" +msgstr "" + +msgid "no effect (:py:data:`__future__.absolute_import`)" +msgstr "" + +msgid "no effect (:py:data:`__future__.with_statement`)" +msgstr "" + +msgid "no effect (:py:data:`__future__.print_function`)" +msgstr "" + +msgid "no effect (:py:data:`__future__.unicode_literals`)" +msgstr "" + +msgid "no effect (:py:data:`__future__.generator_stop`)" +msgstr "" + +msgid ":py:data:`__future__.annotations`" +msgstr "" + msgid "Extra information" msgstr "" @@ -236,7 +325,7 @@ msgid "" "warnings." msgstr "" -msgid "Return a new an opaque index value used to adding data to code objects." +msgid "Return a new opaque index value used to adding data to code objects." msgstr "" msgid "" @@ -247,8 +336,8 @@ msgstr "" msgid "" "If *free* is not ``NULL``: when a code object is deallocated, *free* will be " -"called on non-``NULL`` data stored under the new index. Use :c:func:" -"`Py_DecRef` when storing :c:type:`PyObject`." +"called on non-``NULL`` data stored under the new index. " +"Use :c:func:`Py_DecRef` when storing :c:type:`PyObject`." msgstr "" msgid "as ``_PyEval_RequestCodeExtraIndex``" @@ -301,15 +390,3 @@ msgstr "" msgid "PyCode_New (C function)" msgstr "" - -msgid "PyCode_NewWithPosOnlyArgs (C function)" -msgstr "" - -msgid "_PyEval_RequestCodeExtraIndex (C function)" -msgstr "" - -msgid "_PyCode_GetExtra (C function)" -msgstr "" - -msgid "_PyCode_SetExtra (C function)" -msgstr "" diff --git a/c-api/codec.po b/c-api/codec.po index 8814b09302..55a935e031 100644 --- a/c-api/codec.po +++ b/c-api/codec.po @@ -51,8 +51,8 @@ msgstr "" msgid "" "*object* is passed through the encoder function found for the given " "*encoding* using the error handling method defined by *errors*. *errors* " -"may be ``NULL`` to use the default method defined for the codec. Raises a :" -"exc:`LookupError` if no encoder can be found." +"may be ``NULL`` to use the default method defined for the codec. Raises " +"a :exc:`LookupError` if no encoder can be found." msgstr "" msgid "Generic codec based decoding API." @@ -61,8 +61,8 @@ msgstr "" msgid "" "*object* is passed through the decoder function found for the given " "*encoding* using the error handling method defined by *errors*. *errors* " -"may be ``NULL`` to use the default method defined for the codec. Raises a :" -"exc:`LookupError` if no encoder can be found." +"may be ``NULL`` to use the default method defined for the codec. Raises " +"a :exc:`LookupError` if no encoder can be found." msgstr "" msgid "Codec lookup API" @@ -71,8 +71,8 @@ msgstr "" msgid "" "In the following functions, the *encoding* string is looked up converted to " "all lower-case characters, which makes encodings looked up through this " -"mechanism effectively case-insensitive. If no codec is found, a :exc:" -"`KeyError` is set and ``NULL`` returned." +"mechanism effectively case-insensitive. If no codec is found, " +"a :exc:`KeyError` is set and ``NULL`` returned." msgstr "" msgid "Get an encoder function for the given *encoding*." @@ -110,9 +110,9 @@ msgid "" msgstr "" msgid "" -"The callback gets a single argument, an instance of :exc:" -"`UnicodeEncodeError`, :exc:`UnicodeDecodeError` or :exc:" -"`UnicodeTranslateError` that holds information about the problematic " +"The callback gets a single argument, an instance " +"of :exc:`UnicodeEncodeError`, :exc:`UnicodeDecodeError` " +"or :exc:`UnicodeTranslateError` that holds information about the problematic " "sequence of characters or bytes and their offset in the original string " "(see :ref:`unicodeexceptions` for functions to extract this information). " "The callback must either raise the given exception, or return a two-item " diff --git a/c-api/complex.po b/c-api/complex.po index ebf255047f..0d13f97e68 100644 --- a/c-api/complex.po +++ b/c-api/complex.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# gresm, 2024 -# Maciej Olko , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -69,43 +67,43 @@ msgid "" "Return the sum of two complex numbers, using the C :c:type:`Py_complex` " "representation." msgstr "" -"Zwraca sumę dwóch liczb zespolonych wykorzystując strukturę :c:type:" -"`Py_complex` jako reprezentację." +"Zwraca sumę dwóch liczb zespolonych wykorzystując " +"strukturę :c:type:`Py_complex` jako reprezentację." msgid "" -"Return the difference between two complex numbers, using the C :c:type:" -"`Py_complex` representation." +"Return the difference between two complex numbers, using the " +"C :c:type:`Py_complex` representation." msgstr "" -"Zwraca różnicę dwóch liczb zespolonych wykorzystując strukturę :c:type:" -"`Py_complex` jako reprezentację." +"Zwraca różnicę dwóch liczb zespolonych wykorzystując " +"strukturę :c:type:`Py_complex` jako reprezentację." msgid "" -"Return the negation of the complex number *num*, using the C :c:type:" -"`Py_complex` representation." +"Return the negation of the complex number *num*, using the " +"C :c:type:`Py_complex` representation." msgstr "" msgid "" "Return the product of two complex numbers, using the C :c:type:`Py_complex` " "representation." msgstr "" -"Zwraca iloczyn dwóch liczb zespolonych wykorzystując strukturę :c:type:" -"`Py_complex` jako reprezentację." +"Zwraca iloczyn dwóch liczb zespolonych wykorzystując " +"strukturę :c:type:`Py_complex` jako reprezentację." msgid "" "Return the quotient of two complex numbers, using the C :c:type:`Py_complex` " "representation." msgstr "" -"Zwraca iloraz dwóch liczb zespolonych wykorzystując strukturę :c:type:" -"`Py_complex` jako reprezentację." +"Zwraca iloraz dwóch liczb zespolonych wykorzystując " +"strukturę :c:type:`Py_complex` jako reprezentację." msgid "" -"If *divisor* is null, this method returns zero and sets :c:data:`errno` to :" -"c:macro:`!EDOM`." +"If *divisor* is null, this method returns zero and sets :c:data:`errno` " +"to :c:macro:`!EDOM`." msgstr "" msgid "" -"Return the exponentiation of *num* by *exp*, using the C :c:type:" -"`Py_complex` representation." +"Return the exponentiation of *num* by *exp*, using the " +"C :c:type:`Py_complex` representation." msgstr "" msgid "" @@ -126,8 +124,8 @@ msgid "" msgstr "" msgid "" -"Return true if its argument is a :c:type:`PyComplexObject` or a subtype of :" -"c:type:`PyComplexObject`. This function always succeeds." +"Return true if its argument is a :c:type:`PyComplexObject` or a subtype " +"of :c:type:`PyComplexObject`. This function always succeeds." msgstr "" msgid "" @@ -149,10 +147,11 @@ msgid "Return the real part of *op* as a C :c:expr:`double`." msgstr "" msgid "" -"If *op* is not a Python complex number object but has a :meth:`~object." -"__complex__` method, this method will first be called to convert *op* to a " -"Python complex number object. If :meth:`!__complex__` is not defined then " -"it falls back to call :c:func:`PyFloat_AsDouble` and returns its result." +"If *op* is not a Python complex number object but has " +"a :meth:`~object.__complex__` method, this method will first be called to " +"convert *op* to a Python complex number object. If :meth:`!__complex__` is " +"not defined then it falls back to call :c:func:`PyFloat_AsDouble` and " +"returns its result." msgstr "" msgid "" @@ -167,28 +166,28 @@ msgid "Return the imaginary part of *op* as a C :c:expr:`double`." msgstr "" msgid "" -"If *op* is not a Python complex number object but has a :meth:`~object." -"__complex__` method, this method will first be called to convert *op* to a " -"Python complex number object. If :meth:`!__complex__` is not defined then " -"it falls back to call :c:func:`PyFloat_AsDouble` and returns ``0.0`` on " -"success." +"If *op* is not a Python complex number object but has " +"a :meth:`~object.__complex__` method, this method will first be called to " +"convert *op* to a Python complex number object. If :meth:`!__complex__` is " +"not defined then it falls back to call :c:func:`PyFloat_AsDouble` and " +"returns ``0.0`` on success." msgstr "" msgid "Return the :c:type:`Py_complex` value of the complex number *op*." msgstr "" msgid "" -"If *op* is not a Python complex number object but has a :meth:`~object." -"__complex__` method, this method will first be called to convert *op* to a " -"Python complex number object. If :meth:`!__complex__` is not defined then " -"it falls back to :meth:`~object.__float__`. If :meth:`!__float__` is not " -"defined then it falls back to :meth:`~object.__index__`." +"If *op* is not a Python complex number object but has " +"a :meth:`~object.__complex__` method, this method will first be called to " +"convert *op* to a Python complex number object. If :meth:`!__complex__` is " +"not defined then it falls back to :meth:`~object.__float__`. If :meth:`!" +"__float__` is not defined then it falls back to :meth:`~object.__index__`." msgstr "" msgid "" -"Upon failure, this method returns :c:type:`Py_complex` with :c:member:" -"`~Py_complex.real` set to ``-1.0`` and with an exception set, so one should " -"call :c:func:`PyErr_Occurred` to check for errors." +"Upon failure, this method returns :c:type:`Py_complex` " +"with :c:member:`~Py_complex.real` set to ``-1.0`` and with an exception set, " +"so one should call :c:func:`PyErr_Occurred` to check for errors." msgstr "" msgid "Use :meth:`~object.__index__` if available." diff --git a/c-api/concrete.po b/c-api/concrete.po index 6759741071..bfda066785 100644 --- a/c-api/concrete.po +++ b/c-api/concrete.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -73,6 +71,9 @@ msgstr "Obiekty Funkcja" msgid "Other Objects" msgstr "" +msgid "C API for extension modules" +msgstr "" + msgid "object" msgstr "obiekt" diff --git a/c-api/contextvars.po b/c-api/contextvars.po index fbc94180fc..ed2f165b15 100644 --- a/c-api/contextvars.po +++ b/c-api/contextvars.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +28,9 @@ msgstr "" msgid "" "In Python 3.7.1 the signatures of all context variables C APIs were " -"**changed** to use :c:type:`PyObject` pointers instead of :c:type:" -"`PyContext`, :c:type:`PyContextVar`, and :c:type:`PyContextToken`, e.g.::" +"**changed** to use :c:type:`PyObject` pointers instead " +"of :c:type:`PyContext`, :c:type:`PyContextVar`, " +"and :c:type:`PyContextToken`, e.g.::" msgstr "" msgid "" @@ -153,7 +154,7 @@ msgid "" msgstr "" msgid "" -"Reset the state of the *var* context variable to that it was in before :c:" -"func:`PyContextVar_Set` that returned the *token* was called. This function " -"returns ``0`` on success and ``-1`` on error." +"Reset the state of the *var* context variable to that it was in " +"before :c:func:`PyContextVar_Set` that returned the *token* was called. This " +"function returns ``0`` on success and ``-1`` on error." msgstr "" diff --git a/c-api/conversion.po b/c-api/conversion.po index f980a8955b..b8532a00f1 100644 --- a/c-api/conversion.po +++ b/c-api/conversion.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,22 +24,28 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "String conversion and formatting" -msgstr "" +msgstr "Konwersja i formatowanie ciągów znaków" msgid "Functions for number conversion and formatted string output." -msgstr "" +msgstr "funkcja do konwersji liczb i formatowania napis wyjście." msgid "" "Output not more than *size* bytes to *str* according to the format string " -"*format* and the extra arguments. See the Unix man page :manpage:" -"`snprintf(3)`." +"*format* and the extra arguments. See the Unix man " +"page :manpage:`snprintf(3)`." msgstr "" +"Wyjście nie więcej niż *size* bajtów do *str* zgodnie z format napis " +"*format* i ekstra argument. Zobacz stronę podręcznika " +"Unix :manpage:`snprintf(3)`." msgid "" "Output not more than *size* bytes to *str* according to the format string " -"*format* and the variable argument list *va*. Unix man page :manpage:" -"`vsnprintf(3)`." +"*format* and the variable argument list *va*. Unix man " +"page :manpage:`vsnprintf(3)`." msgstr "" +"Wyprowadzaj nie więcej niż *size* bajtów do *str* zgodnie z ciągiem format " +"napis ującym *format* i listą argumentów zmiennych *va*. Strona podręcznika " +"systemu Unix :manpage:`vsnprintf(3)`." msgid "" ":c:func:`PyOS_snprintf` and :c:func:`PyOS_vsnprintf` wrap the Standard C " @@ -47,6 +53,10 @@ msgid "" "is to guarantee consistent behavior in corner cases, which the Standard C " "functions do not." msgstr "" +":c:func:`PyOS_snprintf` I :c:func:`PyOS_vsnprintf` owinąć Standardowe C " +"biblioteka funkcja :c:func:`snprintf` I :c:func:`vsnprintf`. Ich celem jest " +"zagwarantowanie spójnego zachowania w skrajnych przypadkach, czego nie " +"zapewniają standardowe funkcje języka C." msgid "" "The wrappers ensure that ``str[size-1]`` is always ``'\\0'`` upon return. " @@ -56,33 +66,108 @@ msgid "" "equivalent to the C99 ``n = snprintf(NULL, 0, ...)`` which would determine " "the necessary buffer size." msgstr "" +"Wraptory zapewniają, że ``str[size-1]`` zawsze jest to ``'\\0'`` wartość " +"zwracaćz. Nigdy nie zapisują więcej niż *size* bajtów (wliczając " +"końcowy``'\\0'`` ) do str. Obie funkcja wymagają aby ``str != NULL``, " +"``size > 0``, ``format != NULL`` i ``size < INT_MAX``. Należy pamiętać, że " +"oznacza to brak odpowiednika C99 ``n = snprintf(NULL, 0, ...)``, który " +"określałby wymagany rozmiar bufor size." msgid "" "The return value (*rv*) for these functions should be interpreted as follows:" msgstr "" +"The zwracana wartość (*rv*) dla tych funkcja należy interpretować je " +"następująco:" msgid "" "When ``0 <= rv < size``, the output conversion was successful and *rv* " "characters were written to *str* (excluding the trailing ``'\\0'`` byte at " "``str[rv]``)." msgstr "" +"Gdy ``0 <= rv < size``, konwersja danych wyjściowych zakończyła się " +"powodzeniem, a znaki *rv* znak zapisane w *str* (z wyłączeniem końcowego " +"``'\\0'`` bajt o godz ``str[rv]``)" msgid "" "When ``rv >= size``, the output conversion was truncated and a buffer with " "``rv + 1`` bytes would have been needed to succeed. ``str[size-1]`` is " "``'\\0'`` in this case." msgstr "" +"Gdy ``rv >= size``, konwersja wyjściowa została skrócona, a bufor z ``rv + " +"1`` bajtów byłoby potrzebnych do osiągnięcia sukcesu. ``str[size-1]`` w " +"``'\\0'`` tym przypadku." msgid "" -"When ``rv < 0``, \"something bad happened.\" ``str[size-1]`` is ``'\\0'`` in " -"this case too, but the rest of *str* is undefined. The exact cause of the " -"error depends on the underlying platform." +"When ``rv < 0``, the output conversion failed and ``str[size-1]`` is " +"``'\\0'`` in this case too, but the rest of *str* is undefined. The exact " +"cause of the error depends on the underlying platform." msgstr "" +"Gdy ``rv < 0``, konwersja wyjściowa nie powiodła się i ``str[size-1]`` w " +"``'\\0'`` W tym przypadku również, ale reszta *str* jest niezdefiniowana. " +"Dokładna przyczyna błędu zależy od platformy bazowej." msgid "" "The following functions provide locale-independent string to number " "conversions." msgstr "" +"Poniższe funkcje umożliwiają niezależną od ustawień regionalnych konwersję " +"ciągów znaków na liczby." + +msgid "" +"Convert the initial part of the string in ``str`` to an :c:expr:`unsigned " +"long` value according to the given ``base``, which must be between ``2`` and " +"``36`` inclusive, or be the special value ``0``." +msgstr "" +"Konwertuj początkową część ciągu napis na ``str`` do " +"wartości :c:expr:`unsigned long` zgodnie z podanym ``base`` , który musi " +"zawierać się pomiędzy ``2`` i ``36`` inkluzywny lub będący szczególną " +"wartość, ``0`` ." + +msgid "" +"Leading white space and case of characters are ignored. If ``base`` is zero " +"it looks for a leading ``0b``, ``0o`` or ``0x`` to tell which base. If " +"these are absent it defaults to ``10``. Base must be 0 or between 2 and 36 " +"(inclusive). If ``ptr`` is non-``NULL`` it will contain a pointer to the " +"end of the scan." +msgstr "" +"Spacje wiodące i wielkość liter są znak ignorowane. Jeśli ``base`` jest " +"zero, szuka wiodącego ``0b``, ``0o`` lub ``0x`` aby wskazać bazę. Jeżeli ich " +"brakuje, domyślnie ``10``. Podstawa musi wynosić 0 lub mieścić się w " +"przedziale od 2 do 36 (włącznie). Jeśli ``ptr`` jest różna od 0 ``NULL``, " +"będzie zawierać wskaźnik do końca skanowania." + +msgid "" +"If the converted value falls out of range of corresponding return type, " +"range error occurs (:c:data:`errno` is set to :c:macro:`!ERANGE`) " +"and :c:macro:`!ULONG_MAX` is returned. If no conversion can be performed, " +"``0`` is returned." +msgstr "" +"Jeśli przekonwertowana wartość wykracza poza zakres odpowiedniego typu " +"zwracać zwracanego, występuje błąd zakresu (:c:data:`errno` jest ustawiony " +"na :c:macro:`!ERANGE`) i :c:macro:`!ULONG_MAX` zwracana jest wartość. Jeśli " +"nie można wykonać konwersji, ``0`` zwracana jest wartość ." + +msgid "See also the Unix man page :manpage:`strtoul(3)`." +msgstr "patrz również the Unix man page :manpage:`strtoul(3)`." + +msgid "" +"Convert the initial part of the string in ``str`` to an :c:expr:`long` value " +"according to the given ``base``, which must be between ``2`` and ``36`` " +"inclusive, or be the special value ``0``." +msgstr "" +"Konwertuj początkową część napis ciągu na ``str`` do :c:expr:`long` wartość " +"zgodnie z podanym ``base``, która musi być pomiędzy ``2`` i ``36`` włącznie, " +"lub być wartość specjalną ``0``." + +msgid "" +"Same as :c:func:`PyOS_strtoul`, but return a :c:expr:`long` value instead " +"and :c:macro:`LONG_MAX` on overflows." +msgstr "" +"Taki sam jak :c:func:`PyOS_strtoul`, Ale zwracać A :c:expr:`long` wartość " +"zamiast i :c:macro:`LONG_MAX` na przepełnieniach." + +msgid "See also the Unix man page :manpage:`strtol(3)`." +msgstr "patrz również the Unix man page :manpage:`strtol(3)`." msgid "" "Convert a string ``s`` to a :c:expr:`double`, raising a Python exception on " @@ -91,12 +176,20 @@ msgid "" "have leading or trailing whitespace. The conversion is independent of the " "current locale." msgstr "" +"Konwertuj ciąg napis ``s`` a :c:expr:`double`, rzucić a Python Wyjątek w " +"przypadku błędu. Zestaw akceptowanych ciągów znaków odpowiada zestawowi " +"ciągów znaków akceptowanych :func:`float`przez konstruktor Python ``s``, z " +"tym wyjątkiem, że nie mogą one zawierać spacji na początku ani na końcu. " +"Konwersja jest niezależna od bieżącej lokalizacji." msgid "" -"If ``endptr`` is ``NULL``, convert the whole string. Raise :exc:" -"`ValueError` and return ``-1.0`` if the string is not a valid representation " -"of a floating-point number." +"If ``endptr`` is ``NULL``, convert the whole string. " +"Raise :exc:`ValueError` and return ``-1.0`` if the string is not a valid " +"representation of a floating-point number." msgstr "" +"Jeśli ``endptr`` jest ``NULL``, przekonwertować cały napis. " +"Rzucić :exc:`ValueError` I zwracać ``-1.0`` jeśli napis nie jest ważny " +"prawidłową reprezentacją liczby zmiennoprzecinkowej." msgid "" "If endptr is not ``NULL``, convert as much of the string as possible and set " @@ -105,6 +198,11 @@ msgid "" "number, set ``*endptr`` to point to the beginning of the string, raise " "ValueError, and return ``-1.0``." msgstr "" +"Jeśli endptr jest różny od ``NULL`` , konwertuj tak dużą część napis jak to " +"możliwe ``*endptr``, i ustaw wskaźnik na pierwszy nieprzekonwertowany znak. " +"Jeżeli żaden początkowy segment napis nie jest prawidłową reprezentacją " +"liczby zmiennoprzecinkowej, ustaw go tak ``*endptr``, aby wskazywał na " +"początek ciągu, zgłoś wyjątek ValueError i zwróć ``-1.0`` ." msgid "" "If ``s`` represents a value that is too large to store in a float (for " @@ -120,11 +218,15 @@ msgid "" "If any other error occurs during the conversion (for example an out-of-" "memory error), set the appropriate Python exception and return ``-1.0``." msgstr "" +"Jeżeli podczas konwersji wystąpi jakikolwiek inny błąd (na przykład błąd " +"braku pamięci), ustaw odpowiedni wyjątek Pythona i zwracać ``-1.0``." msgid "" "Convert a :c:expr:`double` *val* to a string using supplied *format_code*, " "*precision*, and *flags*." msgstr "" +"Konwertuje :c:expr:`double` *val* na napis ciąg znaków przy użyciu " +"dostarczonych *format_code*, *precision* i *flags*." msgid "" "*format_code* must be one of ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, " @@ -132,31 +234,43 @@ msgid "" "ignored. The ``'r'`` format code specifies the standard :func:`repr` format." msgstr "" -msgid "" -"*flags* can be zero or more of the values ``Py_DTSF_SIGN``, " -"``Py_DTSF_ADD_DOT_0``, or ``Py_DTSF_ALT``, or-ed together:" +msgid "*flags* can be zero or more of the following values or-ed together:" msgstr "" msgid "" -"``Py_DTSF_SIGN`` means to always precede the returned string with a sign " -"character, even if *val* is non-negative." +"Always precede the returned string with a sign character, even if *val* is " +"non-negative." msgstr "" -msgid "" -"``Py_DTSF_ADD_DOT_0`` means to ensure that the returned string will not look " -"like an integer." +msgid "Ensure that the returned string will not look like an integer." msgstr "" msgid "" -"``Py_DTSF_ALT`` means to apply \"alternate\" formatting rules. See the " -"documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier for details." +"Apply \"alternate\" formatting rules. See the documentation for " +"the :c:func:`PyOS_snprintf` ``'#'`` specifier for details." +msgstr "" + +msgid "Negative zero is converted to positive zero." msgstr "" msgid "" "If *ptype* is non-``NULL``, then the value it points to will be set to one " -"of ``Py_DTST_FINITE``, ``Py_DTST_INFINITE``, or ``Py_DTST_NAN``, signifying " -"that *val* is a finite number, an infinite number, or not a number, " -"respectively." +"of the following constants depending on the type of *val*:" +msgstr "" + +msgid "*\\*ptype*" +msgstr "" + +msgid "type of *val*" +msgstr "" + +msgid "finite number" +msgstr "" + +msgid "infinite number" +msgstr "" + +msgid "not a number" msgstr "" msgid "" @@ -166,11 +280,91 @@ msgid "" msgstr "" msgid "" -"Case insensitive comparison of strings. The function works almost " -"identically to :c:func:`strcmp` except that it ignores the case." +"Case insensitive comparison of strings. These functions work almost " +"identically to :c:func:`!strcmp` and :c:func:`!strncmp` (respectively), " +"except that they ignore the case of ASCII characters." +msgstr "" +"Porównywanie ciągów znaków bez uwzględniania wielkości napis liter. Funkcja " +"te działają niemal identycznie :c:func:`!strcmp` I :c:func:`!strncmp` " +"(odpowiednio), z tą różnicą, że ignorują wielkość liter znak ASCII." + +msgid "" +"Return ``0`` if the strings are equal, a negative value if *str1* sorts " +"lexicographically before *str2*, or a positive value if it sorts after." +msgstr "" + +msgid "" +"In the *str1* or *str2* arguments, a NUL byte marks the end of the string. " +"For :c:func:`!PyOS_mystrnicmp`, the *size* argument gives the maximum size " +"of the string, as if NUL was present at the index given by *size*." +msgstr "" +"W argumentach *str1* lub *str2* bajt NUL oznacza koniec ciągu. For :c:func:`!" +"PyOS_mystrnicmp`, Argument *size* podaje maksymalny rozmiar napis ciągu, tak " +"jakby pod indeksem określonym przez *size* znajdowała się wartość NUL." + +msgid "These functions do not use the locale." +msgstr "" + +msgid "Case insensitive comparison of strings." +msgstr "Porównywanie ciągów znaków bez uwzględniania wielkości napisnapis." + +msgid "" +"On Windows, these are aliases of :c:func:`!stricmp` and :c:func:`!strnicmp`, " +"respectively." msgstr "" +"W systemie Windows są to odpowiednio alias :c:func:`!stricmp` i :c:func:`!" +"strnicmp`, ." msgid "" -"Case insensitive comparison of strings. The function works almost " -"identically to :c:func:`strncmp` except that it ignores the case." +"On other platforms, they are aliases of :c:func:`PyOS_mystricmp` " +"and :c:func:`PyOS_mystrnicmp`, respectively." +msgstr "" +"Na innych platformach są to odpowiednio alias :c:func:`PyOS_mystricmp` " +"i :c:func:`PyOS_mystrnicmp` ." + +msgid "Character classification and conversion" +msgstr "Klasyfikacja i znak konwersja postaci" + +msgid "" +"The following macros provide locale-independent (unlike the C standard " +"library ``ctype.h``) character classification and conversion. The argument " +"must be a signed or unsigned :c:expr:`char`." +msgstr "" +"Poniższe makra zapewniają niezależną od ustawień regionalnych (w " +"przeciwieństwie do biblioteka standardowa C ``ctype.h``) klasyfikację i " +"konwersję znaków. Argument musi być znakiem lub znakiem :c:expr:`char`." + +msgid "Return true if the character *c* is an alphanumeric character." msgstr "" + +msgid "" +"Return true if the character *c* is an alphabetic character (``a-z`` and ``A-" +"Z``)." +msgstr "" + +msgid "Return true if the character *c* is a decimal digit (``0-9``)." +msgstr "" + +msgid "Return true if the character *c* is a lowercase ASCII letter (``a-z``)." +msgstr "" +"Zwraca prawda wartość true, jeśli znak *c* jest małą literą ASCII (``a-z``)." + +msgid "" +"Return true if the character *c* is an uppercase ASCII letter (``A-Z``)." +msgstr "Zwraca prawda jeśli znak *c* to wielka litera ASCII (``A-Z``)." + +msgid "" +"Return true if the character *c* is a whitespace character (space, tab, " +"carriage return, newline, vertical tab, or form feed)." +msgstr "" + +msgid "" +"Return true if the character *c* is a hexadecimal digit (``0-9``, ``a-f``, " +"and ``A-F``)." +msgstr "" + +msgid "Return the lowercase equivalent of the character *c*." +msgstr "Zwraca odpowiednik małej litery znak *c*." + +msgid "Return the uppercase equivalent of the character *c*." +msgstr "Zwraca odpowiednik wielkiej litery znak *c*." diff --git a/c-api/datetime.po b/c-api/datetime.po index 9678df1c96..2f4d6215e0 100644 --- a/c-api/datetime.po +++ b/c-api/datetime.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,11 +29,44 @@ msgstr "" msgid "" "Various date and time objects are supplied by the :mod:`datetime` module. " "Before using any of these functions, the header file :file:`datetime.h` must " -"be included in your source (note that this is not included by :file:`Python." -"h`), and the macro :c:macro:`!PyDateTime_IMPORT` must be invoked, usually as " -"part of the module initialisation function. The macro puts a pointer to a C " -"structure into a static variable, :c:data:`!PyDateTimeAPI`, that is used by " -"the following macros." +"be included in your source (note that this is not included " +"by :file:`Python.h`), and the macro :c:macro:`PyDateTime_IMPORT` must be " +"invoked, usually as part of the module initialisation function. The macro " +"puts a pointer to a C structure into a static " +"variable, :c:data:`PyDateTimeAPI`, that is used by the following macros." +msgstr "" + +msgid "Import the datetime C API." +msgstr "" + +msgid "" +"On success, populate the :c:var:`PyDateTimeAPI` pointer. On failure, " +"set :c:var:`PyDateTimeAPI` to ``NULL`` and set an exception. The caller must " +"check if an error occurred via :c:func:`PyErr_Occurred`:" +msgstr "" + +msgid "" +"PyDateTime_IMPORT;\n" +"if (PyErr_Occurred()) { /* cleanup */ }" +msgstr "" + +msgid "This is not compatible with subinterpreters." +msgstr "" + +msgid "Structure containing the fields for the datetime C API." +msgstr "" + +msgid "The fields of this structure are private and subject to change." +msgstr "" + +msgid "Do not use this directly; prefer ``PyDateTime_*`` APIs instead." +msgstr "" + +msgid "Dynamically allocated object containing the datetime C API." +msgstr "" + +msgid "" +"This variable is only available once :c:macro:`PyDateTime_IMPORT` succeeds." msgstr "" msgid "This subtype of :c:type:`PyObject` represents a Python date object." @@ -66,9 +99,9 @@ msgid "" 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." +"This instance of :c:type:`PyTypeObject` represents the Python type for the " +"difference between two datetime values; it is the same object " +"as :class:`datetime.timedelta` in the Python layer." msgstr "" msgid "" @@ -80,8 +113,8 @@ msgid "Macro for access to the UTC singleton:" msgstr "" msgid "" -"Returns the time zone singleton representing UTC, the same object as :attr:" -"`datetime.timezone.utc`." +"Returns the time zone singleton representing UTC, the same object " +"as :attr:`datetime.timezone.utc`." msgstr "" msgid "Type-check macros:" @@ -189,9 +222,9 @@ msgstr "" msgid "" "Macros to extract fields from date objects. The argument must be an " -"instance of :c:type:`PyDateTime_Date`, including subclasses (such as :c:type:" -"`PyDateTime_DateTime`). The argument must not be ``NULL``, and the type is " -"not checked:" +"instance of :c:type:`PyDateTime_Date`, including subclasses (such " +"as :c:type:`PyDateTime_DateTime`). The argument must not be ``NULL``, and " +"the type is not checked:" msgstr "" msgid "Return the year, as a positive int." @@ -260,3 +293,17 @@ msgid "" "Create and return a new :class:`datetime.date` object given an argument " "tuple suitable for passing to :meth:`datetime.date.fromtimestamp`." msgstr "" + +msgid "Internal data" +msgstr "" + +msgid "" +"The following symbols are exposed by the C API but should be considered " +"internal-only." +msgstr "" + +msgid "Name of the datetime capsule to pass to :c:func:`PyCapsule_Import`." +msgstr "" + +msgid "Internal usage only. Use :c:macro:`PyDateTime_IMPORT` instead." +msgstr "" diff --git a/c-api/dict.po b/c-api/dict.po index 6a0dc2c096..fb6888fa39 100644 --- a/c-api/dict.po +++ b/c-api/dict.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Tadeusz Karpiński , 2023 -# haaritsubaki, 2023 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -64,48 +60,58 @@ msgid "" "modification of the dictionary for non-dynamic class types." msgstr "" +msgid "" +"The type object for mapping proxy objects created " +"by :c:func:`PyDictProxy_New` and for the read-only ``__dict__`` attribute of " +"many built-in types. A :c:type:`PyDictProxy_Type` instance provides a " +"dynamic, read-only view of an underlying dictionary: changes to the " +"underlying dictionary are reflected in the proxy, but the proxy itself does " +"not support mutation operations. This corresponds " +"to :class:`types.MappingProxyType` in Python." +msgstr "" + msgid "Empty an existing dictionary of all key-value pairs." msgstr "" msgid "" -"Determine if dictionary *p* contains *key*. If an item in *p* is matches " +"Determine if dictionary *p* contains *key*. If an item in *p* matches " "*key*, return ``1``, otherwise return ``0``. On error, return ``-1``. This " "is equivalent to the Python expression ``key in p``." msgstr "" msgid "" -"This is the same as :c:func:`PyDict_Contains`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyDict_Contains`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "Return a new dictionary that contains the same key-value pairs as *p*." msgstr "Zwraca nowy słownik zawierający te same pary klucz-wartość co *p*." msgid "" -"Insert *val* into the dictionary *p* with a key of *key*. *key* must be :" -"term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return ``0`` " -"on success or ``-1`` on failure. This function *does not* steal a reference " -"to *val*." +"Insert *val* into the dictionary *p* with a key of *key*. *key* must " +"be :term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return " +"``0`` on success or ``-1`` on failure. This function *does not* " +"\":term:`steal`\" a reference to *val*." msgstr "" msgid "" -"This is the same as :c:func:`PyDict_SetItem`, but *key* is specified as a :c:" -"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyDict_SetItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" -"Remove the entry in dictionary *p* with key *key*. *key* must be :term:" -"`hashable`; if it isn't, :exc:`TypeError` is raised. If *key* is not in the " -"dictionary, :exc:`KeyError` is raised. Return ``0`` on success or ``-1`` on " -"failure." +"Remove the entry in dictionary *p* with key *key*. *key* must " +"be :term:`hashable`; if it isn't, :exc:`TypeError` is raised. If *key* is " +"not in the dictionary, :exc:`KeyError` is raised. Return ``0`` on success or " +"``-1`` on failure." msgstr "" msgid "" -"This is the same as :c:func:`PyDict_DelItem`, but *key* is specified as a :c:" -"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyDict_DelItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -121,7 +127,8 @@ msgstr "" msgid "If the key is missing, set *\\*result* to ``NULL`` and return ``0``." msgstr "" -msgid "On error, raise an exception and return ``-1``." +msgid "" +"On error, raise an exception, set *\\*result* to ``NULL`` and return ``-1``." msgstr "" msgid "See also the :c:func:`PyObject_GetItem` function." @@ -134,9 +141,9 @@ msgid "" msgstr "" msgid "" -"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:" -"`~object.__eq__` methods are silently ignored. Prefer the :c:func:" -"`PyDict_GetItemWithError` function instead." +"Exceptions that occur while this calls :meth:`~object.__hash__` " +"and :meth:`~object.__eq__` methods are silently ignored. Prefer " +"the :c:func:`PyDict_GetItemWithError` function instead." msgstr "" msgid "" @@ -151,21 +158,23 @@ msgid "" msgstr "" msgid "" -"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:" -"expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" -"Exceptions that occur while this calls :meth:`~object.__hash__` and :meth:" -"`~object.__eq__` methods or while creating the temporary :class:`str` object " -"are silently ignored. Prefer using the :c:func:`PyDict_GetItemWithError` " -"function with your own :c:func:`PyUnicode_FromString` *key* instead." +"Exceptions that occur while this calls :meth:`~object.__hash__` " +"and :meth:`~object.__eq__` methods or while creating the " +"temporary :class:`str` object are silently ignored. Prefer using " +"the :c:func:`PyDict_GetItemWithError` function with your " +"own :c:func:`PyUnicode_FromString` *key* instead." msgstr "" msgid "" -"Similar to :c:func:`PyDict_GetItemRef`, but *key* is specified as a :c:expr:" -"`const char*` UTF-8 encoded bytes string, rather than a :c:expr:`PyObject*`." +"Similar to :c:func:`PyDict_GetItemRef`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -197,7 +206,7 @@ msgstr "" msgid "" "Remove *key* from dictionary *p* and optionally return the removed value. Do " -"not raise :exc:`KeyError` if the key missing." +"not raise :exc:`KeyError` if the key is missing." msgstr "" msgid "" @@ -210,9 +219,12 @@ msgid "" "``NULL``, and return ``0``." msgstr "" +msgid "On error, raise an exception and return ``-1``." +msgstr "" + msgid "" -"Similar to :meth:`dict.pop`, but without the default value and not raising :" -"exc:`KeyError` if the key missing." +"Similar to :meth:`dict.pop`, but without the default value and not " +"raising :exc:`KeyError` if the key is missing." msgstr "" msgid "" @@ -239,17 +251,20 @@ msgid "" "``len(p)`` on a dictionary." msgstr "" +msgid "Similar to :c:func:`PyDict_Size`, but without error checking." +msgstr "" + msgid "" -"Iterate over all key-value pairs in the dictionary *p*. The :c:type:" -"`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` prior to the " -"first call to this function to start the iteration; the function returns " -"true for each pair in the dictionary, and false once all pairs have been " -"reported. The parameters *pkey* and *pvalue* should either point to :c:expr:" -"`PyObject*` variables that will be filled in with each key and value, " -"respectively, or may be ``NULL``. Any references returned through them are " -"borrowed. *ppos* should not be altered during iteration. Its value " -"represents offsets within the internal dictionary structure, and since the " -"structure is sparse, the offsets are not consecutive." +"Iterate over all key-value pairs in the dictionary *p*. " +"The :c:type:`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` " +"prior to the first call to this function to start the iteration; the " +"function returns true for each pair in the dictionary, and false once all " +"pairs have been reported. The parameters *pkey* and *pvalue* should either " +"point to :c:expr:`PyObject*` variables that will be filled in with each key " +"and value, respectively, or may be ``NULL``. Any references returned " +"through them are borrowed. *ppos* should not be altered during iteration. " +"Its value represents offsets within the internal dictionary structure, and " +"since the structure is sparse, the offsets are not consecutive." msgstr "" msgid "For example::" @@ -293,8 +308,9 @@ msgstr "" msgid "" "The function is not thread-safe in the :term:`free-threaded ` build without external synchronization. You can use :c:macro:" -"`Py_BEGIN_CRITICAL_SECTION` to lock the dictionary while iterating over it::" +"threading>` build without external synchronization. You can " +"use :c:macro:`Py_BEGIN_CRITICAL_SECTION` to lock the dictionary while " +"iterating over it::" msgstr "" msgid "" @@ -315,10 +331,10 @@ msgid "" msgstr "" msgid "" -"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to ``a." -"update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall back " -"to the iterating over a sequence of key value pairs if the second argument " -"has no \"keys\" attribute. Return ``0`` on success or ``-1`` if an " +"This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to " +"``a.update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall " +"back to the iterating over a sequence of key value pairs if the second " +"argument has no \"keys\" attribute. Return ``0`` on success or ``-1`` if an " "exception was raised." msgstr "" @@ -345,14 +361,14 @@ msgid "" msgstr "" msgid "" -"Clear watcher identified by *watcher_id* previously returned from :c:func:" -"`PyDict_AddWatcher`. Return ``0`` on success, ``-1`` on error (e.g. if the " -"given *watcher_id* was never registered.)" +"Clear watcher identified by *watcher_id* previously returned " +"from :c:func:`PyDict_AddWatcher`. Return ``0`` on success, ``-1`` on error " +"(e.g. if the given *watcher_id* was never registered.)" msgstr "" msgid "" -"Mark dictionary *dict* as watched. The callback granted *watcher_id* by :c:" -"func:`PyDict_AddWatcher` will be called when *dict* is modified or " +"Mark dictionary *dict* as watched. The callback granted *watcher_id* " +"by :c:func:`PyDict_AddWatcher` will be called when *dict* is modified or " "deallocated. Return ``0`` on success or ``-1`` on error." msgstr "" @@ -409,8 +425,8 @@ msgstr "" msgid "" "If the callback sets an exception, it must return ``-1``; this exception " -"will be printed as an unraisable exception using :c:func:" -"`PyErr_WriteUnraisable`. Otherwise it should return ``0``." +"will be printed as an unraisable exception " +"using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``." msgstr "" msgid "" @@ -421,6 +437,129 @@ msgid "" "it before returning." msgstr "" +msgid "Dictionary View Objects" +msgstr "" + +msgid "" +"Return true if *op* is a view of a set inside a dictionary. This is " +"currently equivalent to :c:expr:`PyDictKeys_Check(op) || " +"PyDictItems_Check(op)`. This function always succeeds." +msgstr "" + +msgid "" +"Type object for a view of dictionary keys. In Python, this is the type of " +"the object returned by :meth:`dict.keys`." +msgstr "" + +msgid "" +"Return true if *op* is an instance of a dictionary keys view. This function " +"always succeeds." +msgstr "" + +msgid "" +"Type object for a view of dictionary values. In Python, this is the type of " +"the object returned by :meth:`dict.values`." +msgstr "" + +msgid "" +"Return true if *op* is an instance of a dictionary values view. This " +"function always succeeds." +msgstr "" + +msgid "" +"Type object for a view of dictionary items. In Python, this is the type of " +"the object returned by :meth:`dict.items`." +msgstr "" + +msgid "" +"Return true if *op* is an instance of a dictionary items view. This function " +"always succeeds." +msgstr "" + +msgid "Ordered Dictionaries" +msgstr "" + +msgid "" +"Python's C API provides interface for :class:`collections.OrderedDict` from " +"C. Since Python 3.7, dictionaries are ordered by default, so there is " +"usually little need for these functions; prefer ``PyDict*`` where possible." +msgstr "" + +msgid "" +"Type object for ordered dictionaries. This is the same object " +"as :class:`collections.OrderedDict` in the Python layer." +msgstr "" + +msgid "" +"Return true if *od* is an ordered dictionary object or an instance of a " +"subtype of the :class:`~collections.OrderedDict` type. This function always " +"succeeds." +msgstr "" + +msgid "" +"Return true if *od* is an ordered dictionary object, but not an instance of " +"a subtype of the :class:`~collections.OrderedDict` type. This function " +"always succeeds." +msgstr "" + +msgid "Analogous to :c:type:`PyDictKeys_Type` for ordered dictionaries." +msgstr "" + +msgid "Analogous to :c:type:`PyDictValues_Type` for ordered dictionaries." +msgstr "" + +msgid "Analogous to :c:type:`PyDictItems_Type` for ordered dictionaries." +msgstr "" + +msgid "Return a new empty ordered dictionary, or ``NULL`` on failure." +msgstr "" + +msgid "This is analogous to :c:func:`PyDict_New`." +msgstr "" + +msgid "" +"Insert *value* into the ordered dictionary *od* with a key of *key*. Return " +"``0`` on success or ``-1`` with an exception set on failure." +msgstr "" + +msgid "This is analogous to :c:func:`PyDict_SetItem`." +msgstr "" + +msgid "" +"Remove the entry in the ordered dictionary *od* with key *key*. Return ``0`` " +"on success or ``-1`` with an exception set on failure." +msgstr "" + +msgid "This is analogous to :c:func:`PyDict_DelItem`." +msgstr "" + +msgid "These are :term:`soft deprecated` aliases to ``PyDict`` APIs:" +msgstr "" + +msgid "``PyODict``" +msgstr "" + +msgid "``PyDict``" +msgstr "" + +msgid ":c:func:`PyDict_GetItem`" +msgstr ":c:func:`PyDict_GetItem`" + +msgid ":c:func:`PyDict_GetItemWithError`" +msgstr ":c:func:`PyDict_GetItemWithError`" + +msgid ":c:func:`PyDict_GetItemString`" +msgstr ":c:func:`PyDict_GetItemString`" + +msgid ":c:func:`PyDict_Contains`" +msgstr "" + +msgid ":c:func:`PyDict_Size`" +msgstr "" + +msgid ":c:func:`PyDict_GET_SIZE`" +msgstr "" + msgid "object" msgstr "obiekt" diff --git a/c-api/exceptions.po b/c-api/exceptions.po index 3181743309..a2875bea83 100644 --- a/c-api/exceptions.po +++ b/c-api/exceptions.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stefan Ocetkiewicz , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -101,9 +99,9 @@ msgstr "" msgid "" "If *set_sys_last_vars* is nonzero, the variable :data:`sys.last_exc` is set " "to the printed exception. For backwards compatibility, the deprecated " -"variables :data:`sys.last_type`, :data:`sys.last_value` and :data:`sys." -"last_traceback` are also set to the type, value and traceback of this " -"exception, respectively." +"variables :data:`sys.last_type`, :data:`sys.last_value` " +"and :data:`sys.last_traceback` are also set to the type, value and traceback " +"of this exception, respectively." msgstr "" msgid "The setting of :data:`sys.last_exc` was added." @@ -153,6 +151,23 @@ msgid "" "chained exceptions and notes." msgstr "" +msgid "Legacy variant of :c:func:`PyErr_DisplayException`." +msgstr "" + +msgid "" +"Print the exception *value* with its traceback to :data:`sys.stderr`. If " +"*value* has no traceback set, *tb* is used as its traceback. The first " +"argument is ignored." +msgstr "" + +msgid "" +"If :data:`sys.stderr` is ``None``, nothing is printed. If :data:`sys.stderr` " +"is not set, the exception is dumped to the C ``stderr`` stream instead." +msgstr "" + +msgid "Use :c:func:`PyErr_DisplayException` instead." +msgstr "" + msgid "Raising exceptions" msgstr "" @@ -178,8 +193,8 @@ msgstr "" msgid "" "This function sets the error indicator and returns ``NULL``. *exception* " "should be a Python exception class. The *format* and subsequent parameters " -"help format the error message; they have the same meaning and values as in :" -"c:func:`PyUnicode_FromFormat`. *format* is an ASCII-encoded string." +"help format the error message; they have the same meaning and values as " +"in :c:func:`PyUnicode_FromFormat`. *format* is an ASCII-encoded string." msgstr "" msgid "" @@ -206,13 +221,14 @@ msgid "" "This is a convenience function to raise an exception when a C library " "function has returned an error and set the C variable :c:data:`errno`. It " "constructs a tuple object whose first item is the integer :c:data:`errno` " -"value and whose second item is the corresponding error message (gotten from :" -"c:func:`!strerror`), and then calls ``PyErr_SetObject(type, object)``. On " -"Unix, when the :c:data:`errno` value is :c:macro:`!EINTR`, indicating an " -"interrupted system call, this calls :c:func:`PyErr_CheckSignals`, and if " -"that set the error indicator, leaves it set to that. The function always " -"returns ``NULL``, so a wrapper function around a system call can write " -"``return PyErr_SetFromErrno(type);`` when the system call returns an error." +"value and whose second item is the corresponding error message (gotten " +"from :c:func:`!strerror`), and then calls ``PyErr_SetObject(type, " +"object)``. On Unix, when the :c:data:`errno` value is :c:macro:`!EINTR`, " +"indicating an interrupted system call, this " +"calls :c:func:`PyErr_CheckSignals`, and if that set the error indicator, " +"leaves it set to that. The function always returns ``NULL``, so a wrapper " +"function around a system call can write ``return PyErr_SetFromErrno(type);`` " +"when the system call returns an error." msgstr "" msgid "" @@ -258,9 +274,9 @@ msgstr "" msgid "" "Similar to :c:func:`PyErr_SetFromWindowsErr`, with the additional behavior " "that if *filename* is not ``NULL``, it is decoded from the filesystem " -"encoding (:func:`os.fsdecode`) and passed to the constructor of :exc:" -"`OSError` as a third parameter to be used to define the :attr:`!filename` " -"attribute of the exception instance." +"encoding (:func:`os.fsdecode`) and passed to the constructor " +"of :exc:`OSError` as a third parameter to be used to define the :attr:`!" +"filename` attribute of the exception instance." msgstr "" msgid "" @@ -299,6 +315,11 @@ msgid "" "is a :exc:`SyntaxError`." msgstr "" +msgid "" +"Similar to :c:func:`PyErr_SyntaxLocationObject`, but also sets the " +"*end_lineno* and *end_col_offset* information for the current exception." +msgstr "" + msgid "" "Like :c:func:`PyErr_SyntaxLocationObject`, but *filename* is a byte string " "decoded from the :term:`filesystem encoding and error handler`." @@ -316,6 +337,22 @@ msgid "" "use." msgstr "" +msgid "" +"Get the source line in *filename* at line *lineno*. *filename* should be a " +"Python :class:`str` object." +msgstr "" + +msgid "" +"On success, this function returns a Python string object with the found " +"line. On failure, this function returns ``NULL`` without an exception set." +msgstr "" + +msgid "" +"Similar to :c:func:`PyErr_ProgramTextObject`, but *filename* is " +"a :c:expr:`const char *`, which is decoded with the :term:`filesystem " +"encoding and error handler`, instead of a Python object reference." +msgstr "" + msgid "Issuing warnings" msgstr "" @@ -339,47 +376,55 @@ msgid "" "below) or ``NULL``; the *message* argument is a UTF-8 encoded string. " "*stack_level* is a positive number giving a number of stack frames; the " "warning will be issued from the currently executing line of code in that " -"stack frame. A *stack_level* of 1 is the function calling :c:func:" -"`PyErr_WarnEx`, 2 is the function above that, and so forth." +"stack frame. A *stack_level* of 1 is the function " +"calling :c:func:`PyErr_WarnEx`, 2 is the function above that, and so forth." msgstr "" msgid "" -"Warning categories must be subclasses of :c:data:`PyExc_Warning`; :c:data:" -"`PyExc_Warning` is a subclass of :c:data:`PyExc_Exception`; the default " -"warning category is :c:data:`PyExc_RuntimeWarning`. The standard Python " -"warning categories are available as global variables whose names are " -"enumerated at :ref:`standardwarningcategories`." +"Warning categories must be subclasses " +"of :c:data:`PyExc_Warning`; :c:data:`PyExc_Warning` is a subclass " +"of :c:data:`PyExc_Exception`; the default warning category " +"is :c:data:`PyExc_RuntimeWarning`. The standard Python warning categories " +"are available as global variables whose names are enumerated " +"at :ref:`standardwarningcategories`." msgstr "" msgid "" -"For information about warning control, see the documentation for the :mod:" -"`warnings` module and the :option:`-W` option in the command line " +"For information about warning control, see the documentation for " +"the :mod:`warnings` module and the :option:`-W` option in the command line " "documentation. There is no C API for warning control." msgstr "" msgid "" "Issue a warning message with explicit control over all warning attributes. " -"This is a straightforward wrapper around the Python function :func:`warnings." -"warn_explicit`; see there for more information. The *module* and *registry* " -"arguments may be set to ``NULL`` to get the default effect described there." +"This is a straightforward wrapper around the Python " +"function :func:`warnings.warn_explicit`; see there for more information. " +"The *module* and *registry* arguments may be set to ``NULL`` to get the " +"default effect described there." msgstr "" msgid "" "Similar to :c:func:`PyErr_WarnExplicitObject` except that *message* and " -"*module* are UTF-8 encoded strings, and *filename* is decoded from the :term:" -"`filesystem encoding and error handler`." +"*module* are UTF-8 encoded strings, and *filename* is decoded from " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "" -"Function similar to :c:func:`PyErr_WarnEx`, but use :c:func:" -"`PyUnicode_FromFormat` to format the warning message. *format* is an ASCII-" -"encoded string." +"Function similar to :c:func:`PyErr_WarnEx`, but " +"uses :c:func:`PyUnicode_FromFormat` to format the warning message. *format* " +"is an ASCII-encoded string." msgstr "" msgid "" -"Function similar to :c:func:`PyErr_WarnFormat`, but *category* is :exc:" -"`ResourceWarning` and it passes *source* to :class:`!warnings." -"WarningMessage`." +"Similar to :c:func:`PyErr_WarnExplicit`, but " +"uses :c:func:`PyUnicode_FromFormat` to format the warning message. *format* " +"is an ASCII-encoded string." +msgstr "" + +msgid "" +"Function similar to :c:func:`PyErr_WarnFormat`, but *category* " +"is :exc:`ResourceWarning` and it passes *source* to :class:`!" +"warnings.WarningMessage`." msgstr "" msgid "Querying the error indicator" @@ -389,18 +434,19 @@ msgid "" "Test whether the error indicator is set. If set, return the exception " "*type* (the first argument to the last call to one of the ``PyErr_Set*`` " "functions or to :c:func:`PyErr_Restore`). If not set, return ``NULL``. You " -"do not own a reference to the return value, so you do not need to :c:func:" -"`Py_DECREF` it." +"do not own a reference to the return value, so you do not need " +"to :c:func:`Py_DECREF` it." msgstr "" msgid "The caller must hold the GIL." msgstr "" msgid "" -"Do not compare the return value to a specific exception; use :c:func:" -"`PyErr_ExceptionMatches` instead, shown below. (The comparison could easily " -"fail since the exception may be an instance instead of a class, in the case " -"of a class exception, or it may be a subclass of the expected exception.)" +"Do not compare the return value to a specific exception; " +"use :c:func:`PyErr_ExceptionMatches` instead, shown below. (The comparison " +"could easily fail since the exception may be an instance instead of a class, " +"in the case of a class exception, or it may be a subclass of the expected " +"exception.)" msgstr "" msgid "" @@ -446,10 +492,14 @@ msgstr "" msgid "" "Set *exc* as the exception currently being raised, clearing the existing " -"exception if one is set." +"exception if one is set. If *exc* is ``NULL``, just clear the existing " +"exception." +msgstr "" + +msgid "*exc* must be a valid exception or ``NULL``." msgstr "" -msgid "This call steals a reference to *exc*, which must be a valid exception." +msgid "This call \":term:`steals `\" a reference to *exc*." msgstr "" msgid "Use :c:func:`PyErr_GetRaisedException` instead." @@ -515,9 +565,10 @@ msgid "" msgstr "" msgid "" -"This function *does not* implicitly set the :attr:`~BaseException." -"__traceback__` attribute on the exception value. If setting the traceback " -"appropriately is desired, the following additional snippet is needed::" +"This function *does not* implicitly set " +"the :attr:`~BaseException.__traceback__` attribute on the exception value. " +"If setting the traceback appropriately is desired, the following additional " +"snippet is needed::" msgstr "" msgid "" @@ -527,10 +578,11 @@ msgid "" msgstr "" msgid "" -"Retrieve the active exception instance, as would be returned by :func:`sys." -"exception`. This refers to an exception that was *already caught*, not to an " -"exception that was freshly raised. Returns a new reference to the exception " -"or ``NULL``. Does not modify the interpreter's exception state." +"Retrieve the active exception instance, as would be returned " +"by :func:`sys.exception`. This refers to an exception that was *already " +"caught*, not to an exception that was freshly raised. Returns a new " +"reference to the exception or ``NULL``. Does not modify the interpreter's " +"exception state." msgstr "" msgid "" @@ -554,12 +606,12 @@ msgid "" msgstr "" msgid "" -"Retrieve the old-style representation of the exception info, as known from :" -"func:`sys.exc_info`. This refers to an exception that was *already caught*, " -"not to an exception that was freshly raised. Returns new references for the " -"three objects, any of which may be ``NULL``. Does not modify the exception " -"info state. This function is kept for backwards compatibility. Prefer " -"using :c:func:`PyErr_GetHandledException`." +"Retrieve the old-style representation of the exception info, as known " +"from :func:`sys.exc_info`. This refers to an exception that was *already " +"caught*, not to an exception that was freshly raised. Returns new " +"references for the three objects, any of which may be ``NULL``. Does not " +"modify the exception info state. This function is kept for backwards " +"compatibility. Prefer using :c:func:`PyErr_GetHandledException`." msgstr "" msgid "" @@ -572,10 +624,10 @@ msgstr "" msgid "" "Set the exception info, as known from ``sys.exc_info()``. This refers to an " "exception that was *already caught*, not to an exception that was freshly " -"raised. This function steals the references of the arguments. To clear the " -"exception state, pass ``NULL`` for all three arguments. This function is " -"kept for backwards compatibility. Prefer using :c:func:" -"`PyErr_SetHandledException`." +"raised. This function \":term:`steals `\" the references of the " +"arguments. To clear the exception state, pass ``NULL`` for all three " +"arguments. This function is kept for backwards compatibility. Prefer " +"using :c:func:`PyErr_SetHandledException`." msgstr "" msgid "" @@ -588,43 +640,63 @@ msgstr "" msgid "" "The ``type`` and ``traceback`` arguments are no longer used and can be NULL. " "The interpreter now derives them from the exception instance (the ``value`` " -"argument). The function still steals references of all three arguments." +"argument). The function still \":term:`steals `\" references of all " +"three arguments." msgstr "" msgid "Signal Handling" msgstr "" -msgid "This function interacts with Python's signal handling." +msgid "" +"Handle external interruptions, such as signals or activating a debugger, " +"whose processing has been delayed until it is safe to run Python code and/or " +"raise exceptions." msgstr "" msgid "" -"If the function is called from the main thread and under the main Python " -"interpreter, it checks whether a signal has been sent to the processes and " -"if so, invokes the corresponding signal handler. If the :mod:`signal` " -"module is supported, this can invoke a signal handler written in Python." +"For example, pressing :kbd:`Ctrl-C` causes a terminal to send " +"the :py:data:`signal.SIGINT` signal. This function executes the " +"corresponding Python signal handler, which, by default, raises " +"the :exc:`KeyboardInterrupt` exception." msgstr "" msgid "" -"The function attempts to handle all pending signals, and then returns ``0``. " -"However, if a Python signal handler raises an exception, the error indicator " -"is set and the function returns ``-1`` immediately (such that other pending " -"signals may not have been handled yet: they will be on the next :c:func:" -"`PyErr_CheckSignals()` invocation)." +":c:func:`!PyErr_CheckSignals` should be called by long-running C code " +"frequently enough so that the response appears immediate to humans." +msgstr "" + +msgid "Handlers invoked by this function currently include:" msgstr "" msgid "" -"If the function is called from a non-main thread, or under a non-main Python " -"interpreter, it does nothing and returns ``0``." +"Signal handlers, including Python functions registered using " +"the :mod:`signal` module." msgstr "" msgid "" -"This function can be called by long-running C code that wants to be " -"interruptible by user requests (such as by pressing Ctrl-C)." +"Signal handlers are only run in the main thread of the main interpreter." msgstr "" msgid "" -"The default Python signal handler for :c:macro:`!SIGINT` raises the :exc:" -"`KeyboardInterrupt` exception." +"(This is where the function got the name: originally, signals were the only " +"way to interrupt the interpreter.)" +msgstr "" + +msgid "Running the garbage collector, if necessary." +msgstr "" + +msgid "" +"If any handler raises an exception, immediately return ``-1`` with that " +"exception set. Any remaining interruptions are left to be processed on the " +"next :c:func:`PyErr_CheckSignals()` invocation, if appropriate." +msgstr "" + +msgid "" +"If all handlers finish successfully, or there are no handlers to run, return " +"``0``." +msgstr "" + +msgid "This function may now invoke the garbage collector." msgstr "" msgid "" @@ -633,14 +705,14 @@ msgid "" msgstr "" msgid "" -"This function is async-signal-safe. It can be called without the :term:" -"`GIL` and from a C signal handler." +"This function is async-signal-safe. It can be called without " +"the :term:`GIL` and from a C signal handler." msgstr "" msgid "" -"Simulate the effect of a signal arriving. The next time :c:func:" -"`PyErr_CheckSignals` is called, the Python signal handler for the given " -"signal number will be called." +"Simulate the effect of a signal arriving. The next " +"time :c:func:`PyErr_CheckSignals` is called, the Python signal handler for " +"the given signal number will be called." msgstr "" msgid "" @@ -651,8 +723,9 @@ msgid "" msgstr "" msgid "" -"If the given signal isn't handled by Python (it was set to :py:const:`signal." -"SIG_DFL` or :py:const:`signal.SIG_IGN`), it will be ignored." +"If the given signal isn't handled by Python (it was set " +"to :py:const:`signal.SIG_DFL` or :py:const:`signal.SIG_IGN`), it will be " +"ignored." msgstr "" msgid "" @@ -703,9 +776,25 @@ msgid "" "as the docstring for the exception class." msgstr "" +msgid "" +"Return non-zero if *ob* is an exception class, zero otherwise. This function " +"always succeeds." +msgstr "" + +msgid "Return :c:member:`~PyTypeObject.tp_name` of the exception class *ob*." +msgstr "" + msgid "Exception Objects" msgstr "Przedmioty Sytuacji Wyjątkowych" +msgid "" +"Return true if *op* is an instance of :class:`BaseException`, false " +"otherwise. This function always succeeds." +msgstr "" + +msgid "Equivalent to :c:func:`Py_TYPE(op) `." +msgstr "" + msgid "" "Return the traceback associated with the exception as a new reference, as " "accessible from Python through the :attr:`~BaseException.__traceback__` " @@ -727,7 +816,7 @@ msgstr "" msgid "" "Set the context associated with the exception to *ctx*. Use ``NULL`` to " "clear it. There is no type check to make sure that *ctx* is an exception " -"instance. This steals a reference to *ctx*." +"instance. This \":term:`steals `\" a reference to *ctx*." msgstr "" msgid "" @@ -740,7 +829,8 @@ msgstr "" msgid "" "Set the cause associated with the exception to *cause*. Use ``NULL`` to " "clear it. There is no type check to make sure that *cause* is either an " -"exception instance or ``None``. This steals a reference to *cause*." +"exception instance or ``None``. This \":term:`steals `\" a reference " +"to *cause*." msgstr "" msgid "" @@ -758,11 +848,11 @@ msgid "" "Implement part of the interpreter's implementation of :keyword:`!except*`. " "*orig* is the original exception that was caught, and *excs* is the list of " "the exceptions that need to be raised. This list contains the unhandled part " -"of *orig*, if any, as well as the exceptions that were raised from the :" -"keyword:`!except*` clauses (so they have a different traceback from *orig*) " -"and those that were reraised (and have the same traceback as *orig*). Return " -"the :exc:`ExceptionGroup` that needs to be reraised in the end, or ``None`` " -"if there is nothing to reraise." +"of *orig*, if any, as well as the exceptions that were raised from " +"the :keyword:`!except*` clauses (so they have a different traceback from " +"*orig*) and those that were reraised (and have the same traceback as " +"*orig*). Return the :exc:`ExceptionGroup` that needs to be reraised in the " +"end, or ``None`` if there is nothing to reraise." msgstr "" msgid "Unicode Exception Objects" @@ -860,10 +950,10 @@ msgstr "" msgid "" "Properly implementing :c:member:`~PyTypeObject.tp_repr` for container types " -"requires special recursion handling. In addition to protecting the stack, :" -"c:member:`~PyTypeObject.tp_repr` also needs to track objects to prevent " -"cycles. The following two functions facilitate this functionality. " -"Effectively, these are the C equivalent to :func:`reprlib.recursive_repr`." +"requires special recursion handling. In addition to protecting the " +"stack, :c:member:`~PyTypeObject.tp_repr` also needs to track objects to " +"prevent cycles. The following two functions facilitate this functionality. " +"Effectively, these are the C equivalent to :deco:`reprlib.recursive_repr`." msgstr "" msgid "" @@ -874,8 +964,9 @@ msgstr "" msgid "" "If the object has already been processed, the function returns a positive " "integer. In that case the :c:member:`~PyTypeObject.tp_repr` implementation " -"should return a string object indicating a cycle. As examples, :class:" -"`dict` objects return ``{...}`` and :class:`list` objects return ``[...]``." +"should return a string object indicating a cycle. As " +"examples, :class:`dict` objects return ``{...}`` and :class:`list` objects " +"return ``[...]``." msgstr "" msgid "" @@ -885,370 +976,222 @@ msgid "" msgstr "" msgid "" -"Otherwise, the function returns zero and the :c:member:`~PyTypeObject." -"tp_repr` implementation can continue normally." +"Otherwise, the function returns zero and " +"the :c:member:`~PyTypeObject.tp_repr` implementation can continue normally." +msgstr "" + +msgid "" +"Ends a :c:func:`Py_ReprEnter`. Must be called once for each invocation " +"of :c:func:`Py_ReprEnter` that returns zero." msgstr "" msgid "" -"Ends a :c:func:`Py_ReprEnter`. Must be called once for each invocation of :" -"c:func:`Py_ReprEnter` that returns zero." +"Get the recursion limit for the current interpreter. It can be set " +"with :c:func:`Py_SetRecursionLimit`. The recursion limit prevents the Python " +"interpreter stack from growing infinitely." +msgstr "" + +msgid "This function cannot fail, and the caller must hold the :term:`GIL`." +msgstr "" + +msgid ":py:func:`sys.getrecursionlimit`" +msgstr "" + +msgid "Set the recursion limit for the current interpreter." +msgstr "" + +msgid ":py:func:`sys.setrecursionlimit`" msgstr "" -msgid "Standard Exceptions" -msgstr "Sztandarowe Sytuacje Wyjątkowe" +msgid "Exception and warning types" +msgstr "" msgid "" -"All standard Python exceptions are available as global variables whose names " -"are ``PyExc_`` followed by the Python exception name. These have the type :" -"c:expr:`PyObject*`; they are all class objects. For completeness, here are " -"all the variables:" +"All standard Python exceptions and warning categories are available as " +"global variables whose names are ``PyExc_`` followed by the Python exception " +"name. These have the type :c:expr:`PyObject*`; they are all class objects." msgstr "" -msgid "C Name" -msgstr "Nazwa C" +msgid "For completeness, here are all the variables:" +msgstr "" -msgid "Python Name" -msgstr "Nazwa w języku pytonowskim" +msgid "Exception types" +msgstr "" -msgid "Notes" -msgstr "Notatki" +msgid "C name" +msgstr "" -msgid ":c:data:`PyExc_BaseException`" -msgstr ":c:data:`PyExc_BaseException`" +msgid "Python name" +msgstr "" msgid ":exc:`BaseException`" msgstr ":exc:`BaseException`" -msgid "[1]_" -msgstr "" - -msgid ":c:data:`PyExc_Exception`" -msgstr ":c:data:`PyExc_Exception`" +msgid ":exc:`BaseExceptionGroup`" +msgstr ":exc:`BaseExceptionGroup`" msgid ":exc:`Exception`" msgstr ":exc:`Exception`" -msgid ":c:data:`PyExc_ArithmeticError`" -msgstr ":c:data:`PyExc_ArithmeticError`" - msgid ":exc:`ArithmeticError`" msgstr ":exc:`ArithmeticError`" -msgid ":c:data:`PyExc_AssertionError`" -msgstr ":c:data:`PyExc_AssertionError`" - msgid ":exc:`AssertionError`" msgstr ":exc:`AssertionError`" -msgid ":c:data:`PyExc_AttributeError`" -msgstr ":c:data:`PyExc_AttributeError`" - msgid ":exc:`AttributeError`" msgstr ":exc:`AttributeError`" -msgid ":c:data:`PyExc_BlockingIOError`" -msgstr ":c:data:`PyExc_BlockingIOError`" - msgid ":exc:`BlockingIOError`" msgstr ":exc:`BlockingIOError`" -msgid ":c:data:`PyExc_BrokenPipeError`" -msgstr ":c:data:`PyExc_BrokenPipeError`" - msgid ":exc:`BrokenPipeError`" msgstr ":exc:`BrokenPipeError`" -msgid ":c:data:`PyExc_BufferError`" -msgstr ":c:data:`PyExc_BufferError`" - msgid ":exc:`BufferError`" msgstr ":exc:`BufferError`" -msgid ":c:data:`PyExc_ChildProcessError`" -msgstr ":c:data:`PyExc_ChildProcessError`" - msgid ":exc:`ChildProcessError`" msgstr ":exc:`ChildProcessError`" -msgid ":c:data:`PyExc_ConnectionAbortedError`" -msgstr ":c:data:`PyExc_ConnectionAbortedError`" - msgid ":exc:`ConnectionAbortedError`" msgstr ":exc:`ConnectionAbortedError`" -msgid ":c:data:`PyExc_ConnectionError`" -msgstr ":c:data:`PyExc_ConnectionError`" - msgid ":exc:`ConnectionError`" msgstr ":exc:`ConnectionError`" -msgid ":c:data:`PyExc_ConnectionRefusedError`" -msgstr ":c:data:`PyExc_ConnectionRefusedError`" - msgid ":exc:`ConnectionRefusedError`" msgstr ":exc:`ConnectionRefusedError`" -msgid ":c:data:`PyExc_ConnectionResetError`" -msgstr ":c:data:`PyExc_ConnectionResetError`" - msgid ":exc:`ConnectionResetError`" msgstr ":exc:`ConnectionResetError`" -msgid ":c:data:`PyExc_EOFError`" -msgstr ":c:data:`PyExc_EOFError`" - msgid ":exc:`EOFError`" msgstr ":exc:`EOFError`" -msgid ":c:data:`PyExc_FileExistsError`" -msgstr ":c:data:`PyExc_FileExistsError`" - msgid ":exc:`FileExistsError`" msgstr ":exc:`FileExistsError`" -msgid ":c:data:`PyExc_FileNotFoundError`" -msgstr ":c:data:`PyExc_FileNotFoundError`" - msgid ":exc:`FileNotFoundError`" msgstr ":exc:`FileNotFoundError`" -msgid ":c:data:`PyExc_FloatingPointError`" -msgstr ":c:data:`PyExc_FloatingPointError`" - msgid ":exc:`FloatingPointError`" msgstr ":exc:`FloatingPointError`" -msgid ":c:data:`PyExc_GeneratorExit`" -msgstr ":c:data:`PyExc_GeneratorExit`" - msgid ":exc:`GeneratorExit`" msgstr ":exc:`GeneratorExit`" -msgid ":c:data:`PyExc_ImportError`" -msgstr ":c:data:`PyExc_ImportError`" - msgid ":exc:`ImportError`" msgstr ":exc:`ImportError`" -msgid ":c:data:`PyExc_IndentationError`" -msgstr ":c:data:`PyExc_IndentationError`" - msgid ":exc:`IndentationError`" msgstr ":exc:`IndentationError`" -msgid ":c:data:`PyExc_IndexError`" -msgstr ":c:data:`PyExc_IndexError`" - msgid ":exc:`IndexError`" msgstr ":exc:`IndexError`" -msgid ":c:data:`PyExc_InterruptedError`" -msgstr ":c:data:`PyExc_InterruptedError`" - msgid ":exc:`InterruptedError`" msgstr ":exc:`InterruptedError`" -msgid ":c:data:`PyExc_IsADirectoryError`" -msgstr ":c:data:`PyExc_IsADirectoryError`" - msgid ":exc:`IsADirectoryError`" msgstr ":exc:`IsADirectoryError`" -msgid ":c:data:`PyExc_KeyError`" -msgstr ":c:data:`PyExc_KeyError`" - msgid ":exc:`KeyError`" msgstr ":exc:`KeyError`" -msgid ":c:data:`PyExc_KeyboardInterrupt`" -msgstr ":c:data:`PyExc_KeyboardInterrupt`" - msgid ":exc:`KeyboardInterrupt`" msgstr ":exc:`KeyboardInterrupt`" -msgid ":c:data:`PyExc_LookupError`" -msgstr ":c:data:`PyExc_LookupError`" - msgid ":exc:`LookupError`" msgstr ":exc:`LookupError`" -msgid ":c:data:`PyExc_MemoryError`" -msgstr ":c:data:`PyExc_MemoryError`" - msgid ":exc:`MemoryError`" msgstr ":exc:`MemoryError`" -msgid ":c:data:`PyExc_ModuleNotFoundError`" -msgstr ":c:data:`PyExc_ModuleNotFoundError`" - msgid ":exc:`ModuleNotFoundError`" msgstr ":exc:`ModuleNotFoundError`" -msgid ":c:data:`PyExc_NameError`" -msgstr ":c:data:`PyExc_NameError`" - msgid ":exc:`NameError`" msgstr ":exc:`NameError`" -msgid ":c:data:`PyExc_NotADirectoryError`" -msgstr ":c:data:`PyExc_NotADirectoryError`" - msgid ":exc:`NotADirectoryError`" msgstr ":exc:`NotADirectoryError`" -msgid ":c:data:`PyExc_NotImplementedError`" -msgstr ":c:data:`PyExc_NotImplementedError`" - msgid ":exc:`NotImplementedError`" msgstr ":exc:`NotImplementedError`" -msgid ":c:data:`PyExc_OSError`" -msgstr ":c:data:`PyExc_OSError`" - msgid ":exc:`OSError`" msgstr ":exc:`OSError`" -msgid ":c:data:`PyExc_OverflowError`" -msgstr ":c:data:`PyExc_OverflowError`" - msgid ":exc:`OverflowError`" msgstr ":exc:`OverflowError`" -msgid ":c:data:`PyExc_PermissionError`" -msgstr ":c:data:`PyExc_PermissionError`" - msgid ":exc:`PermissionError`" msgstr ":exc:`PermissionError`" -msgid ":c:data:`PyExc_ProcessLookupError`" -msgstr ":c:data:`PyExc_ProcessLookupError`" - msgid ":exc:`ProcessLookupError`" msgstr ":exc:`ProcessLookupError`" -msgid ":c:data:`PyExc_PythonFinalizationError`" -msgstr ":c:data:`PyExc_PythonFinalizationError`" - msgid ":exc:`PythonFinalizationError`" msgstr ":exc:`PythonFinalizationError`" -msgid ":c:data:`PyExc_RecursionError`" -msgstr ":c:data:`PyExc_RecursionError`" - msgid ":exc:`RecursionError`" msgstr ":exc:`RecursionError`" -msgid ":c:data:`PyExc_ReferenceError`" -msgstr ":c:data:`PyExc_ReferenceError`" - msgid ":exc:`ReferenceError`" msgstr ":exc:`ReferenceError`" -msgid ":c:data:`PyExc_RuntimeError`" -msgstr ":c:data:`PyExc_RuntimeError`" - msgid ":exc:`RuntimeError`" msgstr ":exc:`RuntimeError`" -msgid ":c:data:`PyExc_StopAsyncIteration`" -msgstr ":c:data:`PyExc_StopAsyncIteration`" - msgid ":exc:`StopAsyncIteration`" msgstr ":exc:`StopAsyncIteration`" -msgid ":c:data:`PyExc_StopIteration`" -msgstr ":c:data:`PyExc_StopIteration`" - msgid ":exc:`StopIteration`" msgstr ":exc:`StopIteration`" -msgid ":c:data:`PyExc_SyntaxError`" -msgstr ":c:data:`PyExc_SyntaxError`" - msgid ":exc:`SyntaxError`" msgstr ":exc:`SyntaxError`" -msgid ":c:data:`PyExc_SystemError`" -msgstr ":c:data:`PyExc_SystemError`" - msgid ":exc:`SystemError`" msgstr ":exc:`SystemError`" -msgid ":c:data:`PyExc_SystemExit`" -msgstr ":c:data:`PyExc_SystemExit`" - msgid ":exc:`SystemExit`" msgstr ":exc:`SystemExit`" -msgid ":c:data:`PyExc_TabError`" -msgstr ":c:data:`PyExc_TabError`" - msgid ":exc:`TabError`" msgstr ":exc:`TabError`" -msgid ":c:data:`PyExc_TimeoutError`" -msgstr ":c:data:`PyExc_TimeoutError`" - msgid ":exc:`TimeoutError`" msgstr ":exc:`TimeoutError`" -msgid ":c:data:`PyExc_TypeError`" -msgstr ":c:data:`PyExc_TypeError`" - msgid ":exc:`TypeError`" msgstr ":exc:`TypeError`" -msgid ":c:data:`PyExc_UnboundLocalError`" -msgstr ":c:data:`PyExc_UnboundLocalError`" - msgid ":exc:`UnboundLocalError`" msgstr ":exc:`UnboundLocalError`" -msgid ":c:data:`PyExc_UnicodeDecodeError`" -msgstr ":c:data:`PyExc_UnicodeDecodeError`" - msgid ":exc:`UnicodeDecodeError`" msgstr ":exc:`UnicodeDecodeError`" -msgid ":c:data:`PyExc_UnicodeEncodeError`" -msgstr ":c:data:`PyExc_UnicodeEncodeError`" - msgid ":exc:`UnicodeEncodeError`" msgstr ":exc:`UnicodeEncodeError`" -msgid ":c:data:`PyExc_UnicodeError`" -msgstr ":c:data:`PyExc_UnicodeError`" - msgid ":exc:`UnicodeError`" msgstr ":exc:`UnicodeError`" -msgid ":c:data:`PyExc_UnicodeTranslateError`" -msgstr ":c:data:`PyExc_UnicodeTranslateError`" - msgid ":exc:`UnicodeTranslateError`" msgstr ":exc:`UnicodeTranslateError`" -msgid ":c:data:`PyExc_ValueError`" -msgstr ":c:data:`PyExc_ValueError`" - msgid ":exc:`ValueError`" msgstr ":exc:`ValueError`" -msgid ":c:data:`PyExc_ZeroDivisionError`" -msgstr ":c:data:`PyExc_ZeroDivisionError`" - msgid ":exc:`ZeroDivisionError`" msgstr ":exc:`ZeroDivisionError`" msgid "" -":c:data:`PyExc_BlockingIOError`, :c:data:`PyExc_BrokenPipeError`, :c:data:" -"`PyExc_ChildProcessError`, :c:data:`PyExc_ConnectionError`, :c:data:" -"`PyExc_ConnectionAbortedError`, :c:data:`PyExc_ConnectionRefusedError`, :c:" -"data:`PyExc_ConnectionResetError`, :c:data:`PyExc_FileExistsError`, :c:data:" -"`PyExc_FileNotFoundError`, :c:data:`PyExc_InterruptedError`, :c:data:" -"`PyExc_IsADirectoryError`, :c:data:`PyExc_NotADirectoryError`, :c:data:" -"`PyExc_PermissionError`, :c:data:`PyExc_ProcessLookupError` and :c:data:" -"`PyExc_TimeoutError` were introduced following :pep:`3151`." +":c:data:`PyExc_BlockingIOError`, :c:data:`PyExc_BrokenPipeError`, :c:data:`PyExc_ChildProcessError`, :c:data:`PyExc_ConnectionError`, :c:data:`PyExc_ConnectionAbortedError`, :c:data:`PyExc_ConnectionRefusedError`, :c:data:`PyExc_ConnectionResetError`, :c:data:`PyExc_FileExistsError`, :c:data:`PyExc_FileNotFoundError`, :c:data:`PyExc_InterruptedError`, :c:data:`PyExc_IsADirectoryError`, :c:data:`PyExc_NotADirectoryError`, :c:data:`PyExc_PermissionError`, :c:data:`PyExc_ProcessLookupError` " +"and :c:data:`PyExc_TimeoutError` were introduced following :pep:`3151`." msgstr "" msgid ":c:data:`PyExc_StopAsyncIteration` and :c:data:`PyExc_RecursionError`." @@ -1257,339 +1200,117 @@ msgstr "" msgid ":c:data:`PyExc_ModuleNotFoundError`." msgstr ":c:data:`PyExc_ModuleNotFoundError`." -msgid "These are compatibility aliases to :c:data:`PyExc_OSError`:" -msgstr "" - -msgid ":c:data:`!PyExc_EnvironmentError`" -msgstr ":c:data:`!PyExc_EnvironmentError`" +msgid ":c:data:`PyExc_BaseExceptionGroup`." +msgstr ":c:data:`PyExc_BaseExceptionGroup`." -msgid ":c:data:`!PyExc_IOError`" -msgstr ":c:data:`!PyExc_IOError`" - -msgid ":c:data:`!PyExc_WindowsError`" -msgstr ":c:data:`!PyExc_WindowsError`" +msgid "OSError aliases" +msgstr "" -msgid "[2]_" +msgid "The following are a compatibility aliases to :c:data:`PyExc_OSError`." msgstr "" msgid "These aliases used to be separate exception types." msgstr "" -msgid "Notes:" -msgstr "Uwagi:" - -msgid "This is a base class for other standard exceptions." -msgstr "" -"To jest podstawowy rodzaj przedmiotu dla innych sztandarowych sytuacji " -"wyjątkowych." +msgid "Notes" +msgstr "Notatki" -msgid "" -"Only defined on Windows; protect code that uses this by testing that the " -"preprocessor macro ``MS_WINDOWS`` is defined." +msgid "[win]_" msgstr "" -"Zdefiniowane tylko w systemie Windows; Kod chroniony który używa tego przez " -"sprawdzenie czy makrodefinicja preprocesora ``MS_WINDOWS`` jest określona." -msgid "Standard Warning Categories" -msgstr "" +msgid "Notes:" +msgstr "Uwagi:" msgid "" -"All standard Python warning categories are available as global variables " -"whose names are ``PyExc_`` followed by the Python exception name. These have " -"the type :c:expr:`PyObject*`; they are all class objects. For completeness, " -"here are all the variables:" +":c:var:`!PyExc_WindowsError` is only defined on Windows; protect code that " +"uses this by testing that the preprocessor macro ``MS_WINDOWS`` is defined." msgstr "" -msgid ":c:data:`PyExc_Warning`" -msgstr ":c:data:`PyExc_Warning`" +msgid "Warning types" +msgstr "" msgid ":exc:`Warning`" msgstr ":exc:`Warning`" -msgid "[3]_" -msgstr "" - -msgid ":c:data:`PyExc_BytesWarning`" -msgstr ":c:data:`PyExc_BytesWarning`" - msgid ":exc:`BytesWarning`" msgstr ":exc:`BytesWarning`" -msgid ":c:data:`PyExc_DeprecationWarning`" -msgstr ":c:data:`PyExc_DeprecationWarning`" - msgid ":exc:`DeprecationWarning`" msgstr ":exc:`DeprecationWarning`" -msgid ":c:data:`PyExc_FutureWarning`" -msgstr ":c:data:`PyExc_FutureWarning`" +msgid ":exc:`EncodingWarning`" +msgstr ":exc:`EncodingWarning`" msgid ":exc:`FutureWarning`" msgstr ":exc:`FutureWarning`" -msgid ":c:data:`PyExc_ImportWarning`" -msgstr ":c:data:`PyExc_ImportWarning`" - msgid ":exc:`ImportWarning`" msgstr ":exc:`ImportWarning`" -msgid ":c:data:`PyExc_PendingDeprecationWarning`" -msgstr ":c:data:`PyExc_PendingDeprecationWarning`" - msgid ":exc:`PendingDeprecationWarning`" msgstr ":exc:`PendingDeprecationWarning`" -msgid ":c:data:`PyExc_ResourceWarning`" -msgstr ":c:data:`PyExc_ResourceWarning`" - msgid ":exc:`ResourceWarning`" msgstr ":exc:`ResourceWarning`" -msgid ":c:data:`PyExc_RuntimeWarning`" -msgstr ":c:data:`PyExc_RuntimeWarning`" - msgid ":exc:`RuntimeWarning`" msgstr ":exc:`RuntimeWarning`" -msgid ":c:data:`PyExc_SyntaxWarning`" -msgstr ":c:data:`PyExc_SyntaxWarning`" - msgid ":exc:`SyntaxWarning`" msgstr ":exc:`SyntaxWarning`" -msgid ":c:data:`PyExc_UnicodeWarning`" -msgstr ":c:data:`PyExc_UnicodeWarning`" - msgid ":exc:`UnicodeWarning`" msgstr ":exc:`UnicodeWarning`" -msgid ":c:data:`PyExc_UserWarning`" -msgstr ":c:data:`PyExc_UserWarning`" - msgid ":exc:`UserWarning`" msgstr ":exc:`UserWarning`" msgid ":c:data:`PyExc_ResourceWarning`." msgstr ":c:data:`PyExc_ResourceWarning`." -msgid "This is a base class for other standard warning categories." -msgstr "" +msgid ":c:data:`PyExc_EncodingWarning`." +msgstr ":c:data:`PyExc_EncodingWarning`." -msgid "strerror (C function)" +msgid "Tracebacks" msgstr "" -msgid "module" -msgstr "moduł" - -msgid "signal" -msgstr "" - -msgid "SIGINT (C macro)" -msgstr "" - -msgid "KeyboardInterrupt (built-in exception)" -msgstr "" - -msgid "PyExc_BaseException (C var)" -msgstr "" - -msgid "PyExc_Exception (C var)" -msgstr "" - -msgid "PyExc_ArithmeticError (C var)" -msgstr "" - -msgid "PyExc_AssertionError (C var)" -msgstr "" - -msgid "PyExc_AttributeError (C var)" -msgstr "" - -msgid "PyExc_BlockingIOError (C var)" -msgstr "" - -msgid "PyExc_BrokenPipeError (C var)" -msgstr "" - -msgid "PyExc_BufferError (C var)" -msgstr "" - -msgid "PyExc_ChildProcessError (C var)" -msgstr "" - -msgid "PyExc_ConnectionAbortedError (C var)" -msgstr "" - -msgid "PyExc_ConnectionError (C var)" -msgstr "" - -msgid "PyExc_ConnectionRefusedError (C var)" -msgstr "" - -msgid "PyExc_ConnectionResetError (C var)" -msgstr "" - -msgid "PyExc_EOFError (C var)" -msgstr "" - -msgid "PyExc_FileExistsError (C var)" -msgstr "" - -msgid "PyExc_FileNotFoundError (C var)" -msgstr "" - -msgid "PyExc_FloatingPointError (C var)" -msgstr "" - -msgid "PyExc_GeneratorExit (C var)" -msgstr "" - -msgid "PyExc_ImportError (C var)" -msgstr "" - -msgid "PyExc_IndentationError (C var)" -msgstr "" - -msgid "PyExc_IndexError (C var)" -msgstr "" - -msgid "PyExc_InterruptedError (C var)" -msgstr "" - -msgid "PyExc_IsADirectoryError (C var)" -msgstr "" - -msgid "PyExc_KeyError (C var)" -msgstr "" - -msgid "PyExc_KeyboardInterrupt (C var)" -msgstr "" - -msgid "PyExc_LookupError (C var)" -msgstr "" - -msgid "PyExc_MemoryError (C var)" -msgstr "" - -msgid "PyExc_ModuleNotFoundError (C var)" -msgstr "" - -msgid "PyExc_NameError (C var)" -msgstr "" - -msgid "PyExc_NotADirectoryError (C var)" -msgstr "" - -msgid "PyExc_NotImplementedError (C var)" -msgstr "" - -msgid "PyExc_OSError (C var)" -msgstr "" - -msgid "PyExc_OverflowError (C var)" -msgstr "" - -msgid "PyExc_PermissionError (C var)" -msgstr "" - -msgid "PyExc_ProcessLookupError (C var)" -msgstr "" - -msgid "PyExc_PythonFinalizationError (C var)" -msgstr "" - -msgid "PyExc_RecursionError (C var)" -msgstr "" - -msgid "PyExc_ReferenceError (C var)" -msgstr "" - -msgid "PyExc_RuntimeError (C var)" -msgstr "" - -msgid "PyExc_StopAsyncIteration (C var)" -msgstr "" - -msgid "PyExc_StopIteration (C var)" -msgstr "" - -msgid "PyExc_SyntaxError (C var)" -msgstr "" - -msgid "PyExc_SystemError (C var)" -msgstr "" - -msgid "PyExc_SystemExit (C var)" -msgstr "" - -msgid "PyExc_TabError (C var)" -msgstr "" - -msgid "PyExc_TimeoutError (C var)" -msgstr "" - -msgid "PyExc_TypeError (C var)" -msgstr "" - -msgid "PyExc_UnboundLocalError (C var)" -msgstr "" - -msgid "PyExc_UnicodeDecodeError (C var)" -msgstr "" - -msgid "PyExc_UnicodeEncodeError (C var)" -msgstr "" - -msgid "PyExc_UnicodeError (C var)" -msgstr "" - -msgid "PyExc_UnicodeTranslateError (C var)" -msgstr "" - -msgid "PyExc_ValueError (C var)" -msgstr "" - -msgid "PyExc_ZeroDivisionError (C var)" -msgstr "" - -msgid "PyExc_EnvironmentError (C var)" -msgstr "" - -msgid "PyExc_IOError (C var)" -msgstr "" - -msgid "PyExc_WindowsError (C var)" -msgstr "" - -msgid "PyExc_Warning (C var)" +msgid "" +"Type object for traceback objects. This is available " +"as :class:`types.TracebackType` in the Python layer." msgstr "" -msgid "PyExc_BytesWarning (C var)" +msgid "" +"Return true if *op* is a traceback object, false otherwise. This function " +"does not account for subtypes." msgstr "" -msgid "PyExc_DeprecationWarning (C var)" +msgid "" +"Replace the :attr:`~BaseException.__traceback__` attribute on the current " +"exception with a new traceback prepending *f* to the existing chain." msgstr "" -msgid "PyExc_FutureWarning (C var)" +msgid "Calling this function without an exception set is undefined behavior." msgstr "" -msgid "PyExc_ImportWarning (C var)" +msgid "" +"This function returns ``0`` on success, and returns ``-1`` with an exception " +"set on failure." msgstr "" -msgid "PyExc_PendingDeprecationWarning (C var)" +msgid "Write the traceback *tb* into the file *f*." msgstr "" -msgid "PyExc_ResourceWarning (C var)" +msgid "strerror (C function)" msgstr "" -msgid "PyExc_RuntimeWarning (C var)" -msgstr "" +msgid "module" +msgstr "moduł" -msgid "PyExc_SyntaxWarning (C var)" +msgid "signal" msgstr "" -msgid "PyExc_UnicodeWarning (C var)" +msgid "SIGINT (C macro)" msgstr "" -msgid "PyExc_UserWarning (C var)" +msgid "KeyboardInterrupt (built-in exception)" msgstr "" diff --git a/c-api/file.po b/c-api/file.po index db4d8af6b8..ab30ed7d3a 100644 --- a/c-api/file.po +++ b/c-api/file.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Michał Frontczak, 2021 -# haaritsubaki, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,12 +29,12 @@ msgstr "" msgid "" "These APIs are a minimal emulation of the Python 2 C API for built-in file " "objects, which used to rely on the buffered I/O (:c:expr:`FILE*`) support " -"from the C standard library. In Python 3, files and streams use the new :" -"mod:`io` module, which defines several layers over the low-level unbuffered " -"I/O of the operating system. The functions described below are convenience " -"C wrappers over these new APIs, and meant mostly for internal error " -"reporting in the interpreter; third-party code is advised to access the :mod:" -"`io` APIs instead." +"from the C standard library. In Python 3, files and streams use the " +"new :mod:`io` module, which defines several layers over the low-level " +"unbuffered I/O of the operating system. The functions described below are " +"convenience C wrappers over these new APIs, and meant mostly for internal " +"error reporting in the interpreter; third-party code is advised to access " +"the :mod:`io` APIs instead." msgstr "" msgid "" @@ -58,22 +57,22 @@ msgstr "Zignoruj atrybut *name*." msgid "" "Return the file descriptor associated with *p* as an :c:expr:`int`. If the " -"object is an integer, its value is returned. If not, the object's :meth:" -"`~io.IOBase.fileno` method is called if it exists; the method must return an " -"integer, which is returned as the file descriptor value. Sets an exception " -"and returns ``-1`` on failure." +"object is an integer, its value is returned. If not, the " +"object's :meth:`~io.IOBase.fileno` method is called if it exists; the method " +"must return an integer, which is returned as the file descriptor value. " +"Sets an exception and returns ``-1`` on failure." msgstr "" msgid "" "Equivalent to ``p.readline([n])``, this function reads one line from the " -"object *p*. *p* may be a file object or any object with a :meth:`~io.IOBase." -"readline` method. If *n* is ``0``, exactly one line is read, regardless of " -"the length of the line. If *n* is greater than ``0``, no more than *n* " -"bytes will be read from the file; a partial line can be returned. In both " -"cases, an empty string is returned if the end of the file is reached " -"immediately. If *n* is less than ``0``, however, one line is read " -"regardless of length, but :exc:`EOFError` is raised if the end of the file " -"is reached immediately." +"object *p*. *p* may be a file object or any object with " +"a :meth:`~io.IOBase.readline` method. If *n* is ``0``, exactly one line is " +"read, regardless of the length of the line. If *n* is greater than ``0``, " +"no more than *n* bytes will be read from the file; a partial line can be " +"returned. In both cases, an empty string is returned if the end of the file " +"is reached immediately. If *n* is less than ``0``, however, one line is " +"read regardless of length, but :exc:`EOFError` is raised if the end of the " +"file is reached immediately." msgstr "" msgid "" @@ -116,11 +115,39 @@ msgid "" "arguments." msgstr "" +msgid "" +"Open *path* with the mode ``'rb'``. *path* must be a Python :class:`str` " +"object. The behavior of this function may be overridden " +"by :c:func:`PyFile_SetOpenCodeHook` to allow for some preprocessing of the " +"text." +msgstr "" + +msgid "This is analogous to :func:`io.open_code` in Python." +msgstr "" + +msgid "" +"On success, this function returns a :term:`strong reference` to a Python " +"file object. On failure, this function returns ``NULL`` with an exception " +"set." +msgstr "" + +msgid "" +"Similar to :c:func:`PyFile_OpenCodeObject`, but *path* is a UTF-8 " +"encoded :c:expr:`const char*`." +msgstr "" + msgid "" "Write object *obj* to file object *p*. The only supported flag for *flags* " "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." +"written instead of the :func:`repr`." +msgstr "" + +msgid "If *obj* is ``NULL``, write the string ``\"\"``." +msgstr "" + +msgid "" +"Return ``0`` on success or ``-1`` on failure; the appropriate exception will " +"be set." msgstr "" msgid "" diff --git a/c-api/float.po b/c-api/float.po index a8c454743b..b5272250f3 100644 --- a/c-api/float.po +++ b/c-api/float.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +36,8 @@ msgid "" msgstr "" msgid "" -"Return true if its argument is a :c:type:`PyFloatObject` or a subtype of :c:" -"type:`PyFloatObject`. This function always succeeds." +"Return true if its argument is a :c:type:`PyFloatObject` or a subtype " +"of :c:type:`PyFloatObject`. This function always succeeds." msgstr "" msgid "" @@ -56,11 +56,11 @@ msgstr "" msgid "" "Return a C :c:expr:`double` representation of the contents of *pyfloat*. If " -"*pyfloat* is not a Python floating-point object but has a :meth:`~object." -"__float__` method, this method will first be called to convert *pyfloat* " -"into a float. If :meth:`!__float__` is not defined then it falls back to :" -"meth:`~object.__index__`. This method returns ``-1.0`` upon failure, so one " -"should call :c:func:`PyErr_Occurred` to check for errors." +"*pyfloat* is not a Python floating-point object but has " +"a :meth:`~object.__float__` method, this method will first be called to " +"convert *pyfloat* into a float. If :meth:`!__float__` is not defined then it " +"falls back to :meth:`~object.__index__`. This method returns ``-1.0`` upon " +"failure, so one should call :c:func:`PyErr_Occurred` to check for errors." msgstr "" msgid "Use :meth:`~object.__index__` if available." @@ -78,23 +78,114 @@ msgid "" msgstr "" msgid "" -"Return the maximum representable finite float *DBL_MAX* as C :c:expr:" -"`double`." +"Return the maximum representable finite float *DBL_MAX* as " +"C :c:expr:`double`." msgstr "" msgid "" "Return the minimum normalized positive float *DBL_MIN* as C :c:expr:`double`." msgstr "" +msgid "" +"This macro expands to a constant expression of type :c:expr:`double`, that " +"represents the positive infinity." +msgstr "" + +msgid "" +"On most platforms, this is equivalent to the :c:macro:`!INFINITY` macro from " +"the C11 standard ```` header." +msgstr "" + +msgid "" +"This macro expands to a constant expression of type :c:expr:`double`, that " +"represents a quiet not-a-number (qNaN) value." +msgstr "" + +msgid "" +"On most platforms, this is equivalent to the :c:macro:`!NAN` macro from the " +"C11 standard ```` header." +msgstr "" + +msgid "Equivalent to :c:macro:`!INFINITY`." +msgstr "" + +msgid "The macro is :term:`soft deprecated`." +msgstr "" + +msgid "" +"The definition (accurate for a :c:expr:`double` type) of the :data:`math.e` " +"constant." +msgstr "" + +msgid "High precision (long double) definition of :data:`~math.e` constant." +msgstr "" + +msgid "" +"The definition (accurate for a :c:expr:`double` type) of the :data:`math.pi` " +"constant." +msgstr "" + +msgid "High precision (long double) definition of :data:`~math.pi` constant." +msgstr "" + +msgid "" +"The definition (accurate for a :c:expr:`double` type) of " +"the :data:`math.tau` constant." +msgstr "" + +msgid "Return :data:`math.nan` from a function." +msgstr "" + +msgid "" +"On most platforms, this is equivalent to ``return PyFloat_FromDouble(NAN)``." +msgstr "" + +msgid "" +"Return :data:`math.inf` or :data:`-math.inf ` from a function, " +"depending on the sign of *sign*." +msgstr "" + +msgid "On most platforms, this is equivalent to the following::" +msgstr "" + +msgid "return PyFloat_FromDouble(copysign(INFINITY, sign));" +msgstr "" + +msgid "" +"Return ``1`` if the given floating-point number *X* is finite, that is, it " +"is normal, subnormal or zero, but not infinite or NaN. Return ``0`` " +"otherwise." +msgstr "" + +msgid "" +"The macro is :term:`soft deprecated`. Use :c:macro:`!isfinite` instead." +msgstr "" + +msgid "" +"Return ``1`` if the given floating-point number *X* is positive or negative " +"infinity. Return ``0`` otherwise." +msgstr "" + +msgid "The macro is :term:`soft deprecated`. Use :c:macro:`!isinf` instead." +msgstr "" + +msgid "" +"Return ``1`` if the given floating-point number *X* is a not-a-number (NaN) " +"value. Return ``0`` otherwise." +msgstr "" + +msgid "The macro is :term:`soft deprecated`. Use :c:macro:`!isnan` instead." +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." +"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 "" @@ -119,12 +210,13 @@ 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." +"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 "" @@ -154,18 +246,18 @@ msgid "Unpack functions" msgstr "" msgid "" -"The unpack routines read 2, 4 or 8 bytes, starting at *p*. *le* is an :c:" -"expr:`int` argument, non-zero if the bytes string is in little-endian format " -"(exponent last, at ``p+1``, ``p+3`` or ``p+6`` and ``p+7``), zero if big-" -"endian (exponent first, at *p*). The :c:macro:`PY_BIG_ENDIAN` constant can " -"be used to use the native endian: it is equal to ``1`` on big endian " +"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`)." +"Return value: The unpacked double. On error, this is ``-1.0`` " +"and :c:func:`PyErr_Occurred` is true (and an exception is set, most " +"likely :exc:`OverflowError`)." msgstr "" msgid "" diff --git a/c-api/frame.po b/c-api/frame.po index 48e09b2dc6..98a81958c8 100644 --- a/c-api/frame.po +++ b/c-api/frame.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2022-11-05 19:48+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -23,7 +23,7 @@ msgstr "" "(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" -msgid "Frame Objects" +msgid "Frame objects" msgstr "" msgid "The C structure of the objects used to describe frame objects." @@ -46,30 +46,37 @@ msgid "See also :ref:`Reflection `." msgstr "" msgid "" -"The type of frame objects. It is the same object as :py:class:`types." -"FrameType` in the Python layer." +"The type of frame objects. It is the same object " +"as :py:class:`types.FrameType` in the Python layer." msgstr "" msgid "" "Previously, this type was only available after including ````." msgstr "" +msgid "" +"Create a new frame object. This function returns a :term:`strong reference` " +"to the new frame object on success, and returns ``NULL`` with an exception " +"set on failure." +msgstr "" + msgid "Return non-zero if *obj* is a frame object." msgstr "" msgid "" -"Previously, this function was only available after including ````." +"Previously, this function was only available after including " +"````." msgstr "" msgid "Get the *frame* next outer frame." msgstr "" msgid "" -"Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer frame." +"Return a :term:`strong reference`, or ``NULL`` if *frame* has no outer " +"frame. This raises no exceptions." msgstr "" -msgid "Get the *frame*'s ``f_builtins`` attribute." +msgid "Get the *frame*'s :attr:`~frame.f_builtins` attribute." msgstr "" msgid "Return a :term:`strong reference`. The result cannot be ``NULL``." @@ -93,17 +100,160 @@ msgstr "" msgid "Return a :term:`strong reference`, or ``NULL``." msgstr "" -msgid "Get the *frame*'s ``f_globals`` attribute." +msgid "Get the *frame*'s :attr:`~frame.f_globals` attribute." msgstr "" -msgid "Get the *frame*'s ``f_lasti`` attribute." +msgid "Get the *frame*'s :attr:`~frame.f_lasti` attribute." msgstr "" msgid "Returns -1 if ``frame.f_lasti`` is ``None``." msgstr "" -msgid "Get the *frame*'s ``f_locals`` attribute (:class:`dict`)." +msgid "Get the variable *name* of *frame*." +msgstr "" + +msgid "Return a :term:`strong reference` to the variable value on success." +msgstr "" + +msgid "" +"Raise :exc:`NameError` and return ``NULL`` if the variable does not exist." +msgstr "" + +msgid "Raise an exception and return ``NULL`` on error." +msgstr "" + +msgid "*name* type must be a :class:`str`." +msgstr "" + +msgid "" +"Similar to :c:func:`PyFrame_GetVar`, but the variable name is a C string " +"encoded in UTF-8." +msgstr "" + +msgid "" +"Get the *frame*'s :attr:`~frame.f_locals` attribute. If the frame refers to " +"an :term:`optimized scope`, this returns a write-through proxy object that " +"allows modifying the locals. In all other cases (classes, " +"modules, :func:`exec`, :func:`eval`) it returns the mapping representing the " +"frame locals directly (as described for :func:`locals`)." +msgstr "" + +msgid "" +"As part of :pep:`667`, return an instance " +"of :c:var:`PyFrameLocalsProxy_Type`." msgstr "" msgid "Return the line number that *frame* is currently executing." msgstr "" + +msgid "Frame locals proxies" +msgstr "" + +msgid "" +"The :attr:`~frame.f_locals` attribute on a :ref:`frame object ` is an instance of a \"frame-locals proxy\". The proxy object " +"exposes a write-through view of the underlying locals dictionary for the " +"frame. This ensures that the variables exposed by ``f_locals`` are always up " +"to date with the live local variables in the frame itself." +msgstr "" + +msgid "See :pep:`667` for more information." +msgstr "" + +msgid "The type of frame :func:`locals` proxy objects." +msgstr "" + +msgid "Return non-zero if *obj* is a frame :func:`locals` proxy." +msgstr "" + +msgid "Legacy local variable APIs" +msgstr "" + +msgid "" +"These APIs are :term:`soft deprecated`. As of Python 3.13, they do nothing. " +"They exist solely for backwards compatibility." +msgstr "" + +msgid "" +"Prior to Python 3.13, this function would copy the :attr:`~frame.f_locals` " +"attribute of *f* to the internal \"fast\" array of local variables, allowing " +"changes in frame objects to be visible to the interpreter. If *clear* was " +"true, this function would process variables that were unset in the locals " +"dictionary." +msgstr "" + +msgid "This function now does nothing." +msgstr "" + +msgid "" +"Prior to Python 3.13, this function would copy the internal \"fast\" array " +"of local variables (which is used by the interpreter) to " +"the :attr:`~frame.f_locals` attribute of *f*, allowing changes in local " +"variables to be visible to frame objects." +msgstr "" + +msgid "" +"Prior to Python 3.13, this function was similar " +"to :c:func:`PyFrame_FastToLocals`, but would return ``0`` on success, and " +"``-1`` with an exception set on failure." +msgstr "" + +msgid ":pep:`667`" +msgstr "" + +msgid "Internal frames" +msgstr "" + +msgid "Unless using :pep:`523`, you will not need this." +msgstr "" + +msgid "The interpreter's internal frame representation." +msgstr "" + +msgid "Return a :term:`strong reference` to the code object for the frame." +msgstr "" + +msgid "Return the byte offset into the last executed instruction." +msgstr "" + +msgid "" +"Return the currently executing line number, or -1 if there is no line number." +msgstr "" + +msgid "" +"An array of executable kinds (executor types) for frames, used for internal " +"debugging and tracing." +msgstr "" + +msgid "" +"Tools like debuggers and profilers can use this to identify the type of " +"execution context associated with a frame (such as to filter out internal " +"frames). The entries are indexed by the following constants:" +msgstr "" + +msgid "Constant" +msgstr "Stała" + +msgid "Description" +msgstr "Opis" + +msgid "" +"The frame is internal (For example: inlined) and should be skipped by tools." +msgstr "" + +msgid "The frame corresponds to a standard Python function." +msgstr "" + +msgid "The frame corresponds to a function defined in native code." +msgstr "" + +msgid "The frame corresponds to a method on a class instance." +msgstr "" + +msgid "" +"Note that reading the executable kind from a frame is currently only " +"possible with undocumented internal APIs." +msgstr "" + +msgid "The number of entries in :c:data:`PyUnstable_ExecutableKinds`." +msgstr "" diff --git a/c-api/function.po b/c-api/function.po index 58ced46cf2..7c3a884197 100644 --- a/c-api/function.po +++ b/c-api/function.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# haaritsubaki, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,14 +34,14 @@ msgstr "Struktura C używana dla funkcji." msgid "" "This is an instance of :c:type:`PyTypeObject` and represents the Python " -"function type. It is exposed to Python programmers as ``types." -"FunctionType``." +"function type. It is exposed to Python programmers as " +"``types.FunctionType``." msgstr "" msgid "" -"Return true if *o* is a function object (has type :c:data:" -"`PyFunction_Type`). The parameter must not be ``NULL``. This function " -"always succeeds." +"Return true if *o* is a function object (has " +"type :c:data:`PyFunction_Type`). The parameter must not be ``NULL``. This " +"function always succeeds." msgstr "" msgid "" @@ -53,18 +51,19 @@ msgid "" msgstr "" msgid "" -"The function's docstring and name are retrieved from the code object. :attr:" -"`~function.__module__` is retrieved from *globals*. The argument defaults, " -"annotations and closure are set to ``NULL``. :attr:`~function.__qualname__` " -"is set to the same value as the code object's :attr:`~codeobject." -"co_qualname` field." +"The function's docstring and name are retrieved from the code " +"object. :attr:`~function.__module__` is retrieved from *globals*. The " +"argument defaults, annotations and closure are set to " +"``NULL``. :attr:`~function.__qualname__` is set to the same value as the " +"code object's :attr:`~codeobject.co_qualname` field." msgstr "" msgid "" -"As :c:func:`PyFunction_New`, but also allows setting the function object's :" -"attr:`~function.__qualname__` attribute. *qualname* should be a unicode " -"object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute is set " -"to the same value as the code object's :attr:`~codeobject.co_qualname` field." +"As :c:func:`PyFunction_New`, but also allows setting the function " +"object's :attr:`~function.__qualname__` attribute. *qualname* should be a " +"unicode object or ``NULL``; if ``NULL``, the :attr:`!__qualname__` attribute " +"is set to the same value as the code " +"object's :attr:`~codeobject.co_qualname` field." msgstr "" msgid "Return the code object associated with the function object *op*." @@ -105,6 +104,21 @@ msgid "" "unaltered (default) vectorcall function!" msgstr "" +msgid "" +"Return the keyword-only argument default values of the function object *op*. " +"This can be a dictionary of arguments or ``NULL``." +msgstr "" + +msgid "" +"Set the keyword-only argument default values of the function object *op*. " +"*defaults* must be a dictionary of keyword-only arguments or ``Py_None``." +msgstr "" + +msgid "" +"This function returns ``0`` on success, and returns ``-1`` with an exception " +"set on failure." +msgstr "" + msgid "" "Return the closure associated with the function object *op*. This can be " "``NULL`` or a tuple of cell objects." @@ -125,6 +139,12 @@ msgid "" "dictionary or ``Py_None``." msgstr "" +msgid "" +"These functions are similar to their ``PyFunction_Get*`` counterparts, but " +"do not do type checking. Passing anything other than an instance " +"of :c:data:`PyFunction_Type` is undefined behavior." +msgstr "" + msgid "" "Register *callback* as a function watcher for the current interpreter. " "Return an ID which may be passed to :c:func:`PyFunction_ClearWatcher`. In " @@ -133,38 +153,38 @@ msgid "" msgstr "" msgid "" -"Clear watcher identified by *watcher_id* previously returned from :c:func:" -"`PyFunction_AddWatcher` for the current interpreter. Return ``0`` on " -"success, or ``-1`` and set an exception on error (e.g. if the given " -"*watcher_id* was never registered.)" +"Clear watcher identified by *watcher_id* previously returned " +"from :c:func:`PyFunction_AddWatcher` for the current interpreter. Return " +"``0`` on success, or ``-1`` and set an exception on error (e.g. if the " +"given *watcher_id* was never registered.)" msgstr "" msgid "Enumeration of possible function watcher events:" msgstr "" msgid "``PyFunction_EVENT_CREATE``" -msgstr "" +msgstr "``PyFunction_EVENT_CREATE``" msgid "``PyFunction_EVENT_DESTROY``" -msgstr "" +msgstr "``PyFunction_EVENT_DESTROY``" msgid "``PyFunction_EVENT_MODIFY_CODE``" -msgstr "" +msgstr "``PyFunction_EVENT_MODIFY_CODE``" msgid "``PyFunction_EVENT_MODIFY_DEFAULTS``" -msgstr "" +msgstr "``PyFunction_EVENT_MODIFY_DEFAULTS``" msgid "``PyFunction_EVENT_MODIFY_KWDEFAULTS``" -msgstr "" +msgstr "``PyFunction_EVENT_MODIFY_KWDEFAULTS``" msgid "Type of a function watcher callback function." msgstr "" msgid "" "If *event* is ``PyFunction_EVENT_CREATE`` or ``PyFunction_EVENT_DESTROY`` " -"then *new_value* will be ``NULL``. Otherwise, *new_value* will hold a :term:" -"`borrowed reference` to the new value that is about to be stored in *func* " -"for the attribute that is being modified." +"then *new_value* will be ``NULL``. Otherwise, *new_value* will hold " +"a :term:`borrowed reference` to the new value that is about to be stored in " +"*func* for the attribute that is being modified." msgstr "" msgid "" @@ -174,7 +194,7 @@ msgstr "" msgid "" "If *event* is ``PyFunction_EVENT_CREATE``, then the callback is invoked " -"after `func` has been fully initialized. Otherwise, the callback is invoked " +"after *func* has been fully initialized. Otherwise, the callback is invoked " "before the modification to *func* takes place, so the prior state of *func* " "can be inspected. The runtime is permitted to optimize away the creation of " "function objects when possible. In such cases no event will be emitted. " @@ -192,8 +212,8 @@ msgstr "" msgid "" "If the callback sets an exception, it must return ``-1``; this exception " -"will be printed as an unraisable exception using :c:func:" -"`PyErr_WriteUnraisable`. Otherwise it should return ``0``." +"will be printed as an unraisable exception " +"using :c:func:`PyErr_WriteUnraisable`. Otherwise it should return ``0``." msgstr "" msgid "" diff --git a/c-api/gcsupport.po b/c-api/gcsupport.po index edcde1cd8c..5242bc1ef3 100644 --- a/c-api/gcsupport.po +++ b/c-api/gcsupport.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +71,8 @@ msgid "" msgstr "" msgid "" -"Before fields which refer to other containers are invalidated, :c:func:" -"`PyObject_GC_UnTrack` must be called." +"Before fields which refer to other containers are " +"invalidated, :c:func:`PyObject_GC_UnTrack` must be called." msgstr "" msgid "" @@ -80,29 +80,29 @@ msgid "" msgstr "" msgid "" -"If a type adds the Py_TPFLAGS_HAVE_GC, then it *must* implement at least a :" -"c:member:`~PyTypeObject.tp_traverse` handler or explicitly use one from its " -"subclass or subclasses." +"If a type adds the Py_TPFLAGS_HAVE_GC, then it *must* implement at least " +"a :c:member:`~PyTypeObject.tp_traverse` handler or explicitly use one from " +"its subclass or subclasses." msgstr "" msgid "" "When calling :c:func:`PyType_Ready` or some of the APIs that indirectly call " "it like :c:func:`PyType_FromSpecWithBases` or :c:func:`PyType_FromSpec` the " -"interpreter will automatically populate the :c:member:`~PyTypeObject." -"tp_flags`, :c:member:`~PyTypeObject.tp_traverse` and :c:member:" -"`~PyTypeObject.tp_clear` fields if the type inherits from a class that " -"implements the garbage collector protocol and the child class does *not* " -"include the :c:macro:`Py_TPFLAGS_HAVE_GC` flag." +"interpreter will automatically populate " +"the :c:member:`~PyTypeObject.tp_flags`, :c:member:`~PyTypeObject.tp_traverse` " +"and :c:member:`~PyTypeObject.tp_clear` fields if the type inherits from a " +"class that implements the garbage collector protocol and the child class " +"does *not* include the :c:macro:`Py_TPFLAGS_HAVE_GC` flag." msgstr "" msgid "" -"Analogous to :c:macro:`PyObject_New` but for container objects with the :c:" -"macro:`Py_TPFLAGS_HAVE_GC` flag set." +"Analogous to :c:macro:`PyObject_New` but for container objects with " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag set." msgstr "" msgid "" -"Analogous to :c:macro:`PyObject_NewVar` but for container objects with the :" -"c:macro:`Py_TPFLAGS_HAVE_GC` flag set." +"Analogous to :c:macro:`PyObject_NewVar` but for container objects with " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag set." msgstr "" msgid "" @@ -120,8 +120,8 @@ msgstr "" msgid "" "The function is marked as unstable because the final mechanism for reserving " "extra data after an instance is not yet decided. For allocating a variable " -"number of fields, prefer using :c:type:`PyVarObject` and :c:member:" -"`~PyTypeObject.tp_itemsize` instead." +"number of fields, prefer using :c:type:`PyVarObject` " +"and :c:member:`~PyTypeObject.tp_itemsize` instead." msgstr "" msgid "" @@ -170,17 +170,17 @@ msgid "This is analogous to the Python function :func:`gc.is_finalized`." msgstr "" msgid "" -"Releases memory allocated to an object using :c:macro:`PyObject_GC_New` or :" -"c:macro:`PyObject_GC_NewVar`." +"Releases memory allocated to an object using :c:macro:`PyObject_GC_New` " +"or :c:macro:`PyObject_GC_NewVar`." msgstr "" msgid "" "Remove the object *op* from the set of container objects tracked by the " "collector. Note that :c:func:`PyObject_GC_Track` can be called again on " -"this object to add it back to the set of tracked objects. The deallocator (:" -"c:member:`~PyTypeObject.tp_dealloc` handler) should call this for the object " -"before any of the fields used by the :c:member:`~PyTypeObject.tp_traverse` " -"handler become invalid." +"this object to add it back to the set of tracked objects. The deallocator " +"(:c:member:`~PyTypeObject.tp_dealloc` handler) should call this for the " +"object before any of the fields used by " +"the :c:member:`~PyTypeObject.tp_traverse` handler become invalid." msgstr "" msgid "" @@ -194,12 +194,12 @@ msgid "" msgstr "" msgid "" -"Type of the visitor function passed to the :c:member:`~PyTypeObject." -"tp_traverse` handler. The function should be called with an object to " -"traverse as *object* and the third parameter to the :c:member:`~PyTypeObject." -"tp_traverse` handler as *arg*. The Python core uses several visitor " -"functions to implement cyclic garbage detection; it's not expected that " -"users will need to write their own visitor functions." +"Type of the visitor function passed to " +"the :c:member:`~PyTypeObject.tp_traverse` handler. The function should be " +"called with an object to traverse as *object* and the third parameter to " +"the :c:member:`~PyTypeObject.tp_traverse` handler as *arg*. The Python core " +"uses several visitor functions to implement cyclic garbage detection; it's " +"not expected that users will need to write their own visitor functions." msgstr "" msgid "" @@ -217,16 +217,23 @@ msgid "" msgstr "" msgid "" -"To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:" -"func:`Py_VISIT` macro is provided. In order to use this macro, the :c:" -"member:`~PyTypeObject.tp_traverse` implementation must name its arguments " -"exactly *visit* and *arg*:" +"The traversal function must not have any side effects. Implementations may " +"not modify the reference counts of any Python objects nor create or destroy " +"any Python objects." +msgstr "" + +msgid "" +"To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, " +"a :c:func:`Py_VISIT` macro is provided. In order to use this macro, " +"the :c:member:`~PyTypeObject.tp_traverse` implementation must name its " +"arguments exactly *visit* and *arg*:" msgstr "" msgid "" -"If *o* is not ``NULL``, call the *visit* callback, with arguments *o* and " -"*arg*. If *visit* returns a non-zero value, then return it. Using this " -"macro, :c:member:`~PyTypeObject.tp_traverse` handlers look like::" +"If the :c:expr:`PyObject *` *o* is not ``NULL``, call the *visit* callback, " +"with arguments *o* and *arg*. If *visit* returns a non-zero value, then " +"return it. Using this macro, :c:member:`~PyTypeObject.tp_traverse` handlers " +"look like::" msgstr "" msgid "" @@ -240,8 +247,8 @@ msgid "" msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_clear` handler must be of the :c:type:" -"`inquiry` type, or ``NULL`` if the object is immutable." +"The :c:member:`~PyTypeObject.tp_clear` handler must be of " +"the :c:type:`inquiry` type, or ``NULL`` if the object is immutable." msgstr "" msgid "" @@ -269,8 +276,8 @@ msgstr "" msgid "" "Returns the number of collected + unreachable objects which cannot be " "collected. If the garbage collector is disabled or already collecting, " -"returns ``0`` immediately. Errors during garbage collection are passed to :" -"data:`sys.unraisablehook`. This function does not raise exceptions." +"returns ``0`` immediately. Errors during garbage collection are passed " +"to :data:`sys.unraisablehook`. This function does not raise exceptions." msgstr "" msgid "" @@ -313,9 +320,9 @@ msgid "" msgstr "" msgid "" -"Type of the visitor function to be passed to :c:func:" -"`PyUnstable_GC_VisitObjects`. *arg* is the same as the *arg* passed to " -"``PyUnstable_GC_VisitObjects``. Return ``1`` to continue iteration, return " -"``0`` to stop iteration. Other return values are reserved for now so " -"behavior on returning anything else is undefined." +"Type of the visitor function to be passed " +"to :c:func:`PyUnstable_GC_VisitObjects`. *arg* is the same as the *arg* " +"passed to ``PyUnstable_GC_VisitObjects``. Return ``1`` to continue " +"iteration, return ``0`` to stop iteration. Other return values are reserved " +"for now so behavior on returning anything else is undefined." msgstr "" diff --git a/c-api/gen.po b/c-api/gen.po index d7260df3d9..cd238b5d1e 100644 --- a/c-api/gen.po +++ b/c-api/gen.po @@ -29,8 +29,8 @@ msgstr "" msgid "" "Generator objects are what Python uses to implement generator iterators. " "They are normally created by iterating over a function that yields values, " -"rather than explicitly calling :c:func:`PyGen_New` or :c:func:" -"`PyGen_NewWithQualName`." +"rather than explicitly calling :c:func:`PyGen_New` " +"or :c:func:`PyGen_NewWithQualName`." msgstr "" msgid "The C structure used for generator objects." diff --git a/c-api/import.po b/c-api/import.po index c29b375f9e..340d5451ab 100644 --- a/c-api/import.po +++ b/c-api/import.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# haaritsubaki, 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,8 +27,8 @@ msgid "Importing Modules" msgstr "" msgid "" -"This is a wrapper around :c:func:`PyImport_Import()` which takes a :c:expr:" -"`const char *` as an argument instead of a :c:expr:`PyObject *`." +"This is a wrapper around :c:func:`PyImport_Import()` which takes " +"a :c:expr:`const char *` as an argument instead of a :c:expr:`PyObject *`." msgstr "" msgid "This function is a deprecated alias of :c:func:`PyImport_ImportModule`." @@ -53,14 +51,15 @@ msgstr "" msgid "" "The return value is a new reference to the imported module or top-level " -"package, or ``NULL`` with an exception set on failure. Like for :func:" -"`__import__`, the return value when a submodule of a package was requested " -"is normally the top-level package, unless a non-empty *fromlist* was given." +"package, or ``NULL`` with an exception set on failure. Like " +"for :func:`__import__`, the return value when a submodule of a package was " +"requested is normally the top-level package, unless a non-empty *fromlist* " +"was given." msgstr "" msgid "" -"Failing imports remove incomplete module objects, like with :c:func:" -"`PyImport_ImportModule`." +"Failing imports remove incomplete module objects, like " +"with :c:func:`PyImport_ImportModule`." msgstr "" msgid "" @@ -112,10 +111,10 @@ msgstr "" msgid "" "This function does not load or import the module; if the module wasn't " -"already loaded, you will get an empty module object. Use :c:func:" -"`PyImport_ImportModule` or one of its variants to import a module. Package " -"structures implied by a dotted name for *name* are not created if not " -"already present." +"already loaded, you will get an empty module object. " +"Use :c:func:`PyImport_ImportModule` or one of its variants to import a " +"module. Package structures implied by a dotted name for *name* are not " +"created if not already present." msgstr "" msgid "" @@ -134,11 +133,11 @@ msgid "" "function :func:`compile`, load the module. Return a new reference to the " "module object, or ``NULL`` with an exception set if an error occurred. " "*name* is removed from :data:`sys.modules` in error cases, even if *name* " -"was already in :data:`sys.modules` on entry to :c:func:" -"`PyImport_ExecCodeModule`. Leaving incompletely initialized modules in :" -"data:`sys.modules` is dangerous, as imports of such modules have no way to " -"know that the module object is an unknown (and probably damaged with respect " -"to the module author's intents) state." +"was already in :data:`sys.modules` on entry " +"to :c:func:`PyImport_ExecCodeModule`. Leaving incompletely initialized " +"modules in :data:`sys.modules` is dangerous, as imports of such modules have " +"no way to know that the module object is an unknown (and probably damaged " +"with respect to the module author's intents) state." msgstr "" msgid "" @@ -150,13 +149,13 @@ msgstr "" msgid "" "The module's :attr:`~module.__file__` attribute will be set to the code " -"object's :attr:`~codeobject.co_filename`. If applicable, :attr:`~module." -"__cached__` will also be set." +"object's :attr:`~codeobject.co_filename`. If " +"applicable, :attr:`~module.__cached__` will also be set." msgstr "" msgid "" -"This function will reload the module if it was already imported. See :c:" -"func:`PyImport_ReloadModule` for the intended way to reload a module." +"This function will reload the module if it was already imported. " +"See :c:func:`PyImport_ReloadModule` for the intended way to reload a module." msgstr "" msgid "" @@ -165,8 +164,8 @@ msgid "" msgstr "" msgid "" -"See also :c:func:`PyImport_ExecCodeModuleEx` and :c:func:" -"`PyImport_ExecCodeModuleWithPathnames`." +"See also :c:func:`PyImport_ExecCodeModuleEx` " +"and :c:func:`PyImport_ExecCodeModuleWithPathnames`." msgstr "" msgid "" @@ -189,8 +188,8 @@ msgid "" msgstr "" msgid "" -"Setting :attr:`~module.__cached__` is deprecated. See :class:`~importlib." -"machinery.ModuleSpec` for alternatives." +"Setting :attr:`~module.__cached__` is deprecated. " +"See :class:`~importlib.machinery.ModuleSpec` for alternatives." msgstr "" msgid "" @@ -224,8 +223,8 @@ msgid "" msgstr "" msgid "" -"Return the dictionary used for the module administration (a.k.a. ``sys." -"modules``). Note that this is a per-interpreter variable." +"Return the dictionary used for the module administration (a.k.a. " +"``sys.modules``). Note that this is a per-interpreter variable." msgstr "" msgid "" @@ -240,16 +239,17 @@ msgid "" "dict. If it wasn't yet cached, traverse :data:`sys.path_hooks` until a hook " "is found that can handle the path item. Return ``None`` if no hook could; " "this tells our caller that the :term:`path based finder` could not find a " -"finder for this path item. Cache the result in :data:`sys." -"path_importer_cache`. Return a new reference to the finder object." +"finder for this path item. Cache the result " +"in :data:`sys.path_importer_cache`. Return a new reference to the finder " +"object." msgstr "" msgid "" "Load a frozen module named *name*. Return ``1`` for success, ``0`` if the " "module is not found, and ``-1`` with an exception set if the initialization " -"failed. To access the imported module on a successful load, use :c:func:" -"`PyImport_ImportModule`. (Note the misnomer --- this function would reload " -"the module if it was already imported.)" +"failed. To access the imported module on a successful load, " +"use :c:func:`PyImport_ImportModule`. (Note the misnomer --- this function " +"would reload the module if it was already imported.)" msgstr "" msgid "The ``__file__`` attribute is no longer set on the module." @@ -263,8 +263,8 @@ msgstr "" msgid "" "This is the structure type definition for frozen module descriptors, as " "generated by the :program:`freeze` utility (see :file:`Tools/freeze/` in the " -"Python source distribution). Its definition, found in :file:`Include/import." -"h`, is::" +"Python source distribution). Its definition, found in :file:`Include/" +"import.h`, is::" msgstr "" msgid "" @@ -313,12 +313,12 @@ msgstr "" msgid "" "Add a collection of modules to the table of built-in modules. The *newtab* " -"array must end with a sentinel entry which contains ``NULL`` for the :c:" -"member:`~_inittab.name` field; failure to provide the sentinel value can " -"result in a memory fault. Returns ``0`` on success or ``-1`` if insufficient " -"memory could be allocated to extend the internal table. In the event of " -"failure, no modules are added to the internal table. This must be called " -"before :c:func:`Py_Initialize`." +"array must end with a sentinel entry which contains ``NULL`` for " +"the :c:member:`~_inittab.name` field; failure to provide the sentinel value " +"can result in a memory fault. Returns ``0`` on success or ``-1`` if " +"insufficient memory could be allocated to extend the internal table. In the " +"event of failure, no modules are added to the internal table. This must be " +"called before :c:func:`Py_Initialize`." msgstr "" msgid "" @@ -327,6 +327,12 @@ msgid "" "initialization." msgstr "" +msgid "" +"The table of built-in modules used by Python initialization. Do not use this " +"directly; use :c:func:`PyImport_AppendInittab` " +"and :c:func:`PyImport_ExtendInittab` instead." +msgstr "" + msgid "package variable" msgstr "" diff --git a/c-api/index.po b/c-api/index.po index d82c3bfd39..a0a776223b 100644 --- a/c-api/index.po +++ b/c-api/index.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:48+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,11 +28,11 @@ msgstr "Python/C API Podręcznik" msgid "" "This manual documents the API used by C and C++ programmers who want to " -"write extension modules or embed Python. It is a companion to :ref:" -"`extending-index`, which describes the general principles of extension " -"writing but does not document the API functions in detail." +"write extension modules or embed Python. It is a companion " +"to :ref:`extending-index`, which describes the general principles of " +"extension writing but does not document the API functions in detail." msgstr "" "Ten podręcznik dokumentuje API używany przez programistów C i C++, którzy " -"chcą napisać rozszerzenie moduł lub osadzić Pythona. Jest to dodatek do :" -"ref:`extending-index`, który opisuje ogólne zasady pisania rozszerzeń, ale " -"nie dokumentuje szczegółowo API ." +"chcą napisać rozszerzenie moduł lub osadzić Pythona. Jest to dodatek " +"do :ref:`extending-index`, który opisuje ogólne zasady pisania rozszerzeń, " +"ale nie dokumentuje szczegółowo API ." diff --git a/c-api/init.po b/c-api/init.po index f51c6e3246..f99018a8e1 100644 --- a/c-api/init.po +++ b/c-api/init.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -164,10 +163,8 @@ msgstr ":c:func:`PyMutex_Unlock`" msgid "" "Despite their apparent similarity to some of the functions listed above, the " "following functions **should not be called** before the interpreter has been " -"initialized: :c:func:`Py_EncodeLocale`, :c:func:`Py_GetPath`, :c:func:" -"`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, :c:func:" -"`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:" -"`Py_GetProgramName`, :c:func:`PyEval_InitThreads`, and :c:func:`Py_RunMain`." +"initialized: :c:func:`Py_EncodeLocale`, :c:func:`Py_GetPath`, :c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, :c:func:`Py_GetProgramFullPath`, :c:func:`Py_GetPythonHome`, :c:func:`Py_GetProgramName`, :c:func:`PyEval_InitThreads`, " +"and :c:func:`Py_RunMain`." msgstr "" msgid "Global configuration variables" @@ -175,36 +172,36 @@ msgstr "" msgid "" "Python has variables for the global configuration to control different " -"features and options. By default, these flags are controlled by :ref:" -"`command line options `." +"features and options. By default, these flags are controlled " +"by :ref:`command line options `." msgstr "" msgid "" "When a flag is set by an option, the value of the flag is the number of " -"times that the option was set. For example, ``-b`` sets :c:data:" -"`Py_BytesWarningFlag` to 1 and ``-bb`` sets :c:data:`Py_BytesWarningFlag` to " -"2." +"times that the option was set. For example, ``-b`` " +"sets :c:data:`Py_BytesWarningFlag` to 1 and ``-bb`` " +"sets :c:data:`Py_BytesWarningFlag` to 2." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"bytes_warning` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.bytes_warning` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Issue a warning when comparing :class:`bytes` or :class:`bytearray` with :" -"class:`str` or :class:`bytes` with :class:`int`. Issue an error if greater " -"or equal to ``2``." +"Issue a warning when comparing :class:`bytes` or :class:`bytearray` " +"with :class:`str` or :class:`bytes` with :class:`int`. Issue an error if " +"greater or equal to ``2``." msgstr "" msgid "Set by the :option:`-b` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"parser_debug` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.parser_debug` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -218,9 +215,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"write_bytecode` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.write_bytecode` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -234,22 +231,23 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"pathconfig_warnings` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.pathconfig_warnings` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Suppress error messages when calculating the module search path in :c:func:" -"`Py_GetPath`." +"Suppress error messages when calculating the module search path " +"in :c:func:`Py_GetPath`." msgstr "" msgid "Private flag used by ``_freeze_module`` and ``frozenmain`` programs." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"hash_seed` and :c:member:`PyConfig.use_hash_seed` should be used instead, " +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.hash_seed` " +"and :c:member:`PyConfig.use_hash_seed` should be used instead, " "see :ref:`Python Initialization Configuration `." msgstr "" @@ -264,23 +262,23 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"use_environment` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.use_environment` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Ignore all :envvar:`!PYTHON*` environment variables, e.g. :envvar:" -"`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set." +"Ignore all :envvar:`!PYTHON*` environment variables, " +"e.g. :envvar:`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set." msgstr "" msgid "Set by the :option:`-E` and :option:`-I` options." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"inspect` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.inspect` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -295,18 +293,18 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"interactive` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.interactive` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "Set by the :option:`-i` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"isolated` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.isolated` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -318,9 +316,9 @@ msgid "Set by the :option:`-I` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyPreConfig." -"legacy_windows_fs_encoding` should be used instead, see :ref:`Python " -"Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyPreConfig.legacy_windows_fs_encoding` should be used " +"instead, see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -341,14 +339,14 @@ msgid "Availability" msgstr "Dostępność" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"legacy_windows_stdio` should be used instead, see :ref:`Python " -"Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.legacy_windows_stdio` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"If the flag is non-zero, use :class:`io.FileIO` instead of :class:`!io." -"_WindowsConsoleIO` for :mod:`sys` standard streams." +"If the flag is non-zero, use :class:`io.FileIO` instead of :class:`!" +"io._WindowsConsoleIO` for :mod:`sys` standard streams." msgstr "" msgid "" @@ -360,41 +358,41 @@ msgid "See :pep:`528` for more details." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"site_import` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.site_import` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" "Disable the import of the module :mod:`site` and the site-dependent " "manipulations of :data:`sys.path` that it entails. Also disable these " -"manipulations if :mod:`site` is explicitly imported later (call :func:`site." -"main` if you want them to be triggered)." +"manipulations if :mod:`site` is explicitly imported later " +"(call :func:`site.main` if you want them to be triggered)." msgstr "" msgid "Set by the :option:`-S` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"user_site_directory` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.user_site_directory` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" -"Don't add the :data:`user site-packages directory ` to :data:" -"`sys.path`." +"Don't add the :data:`user site-packages directory ` " +"to :data:`sys.path`." msgstr "" msgid "" -"Set by the :option:`-s` and :option:`-I` options, and the :envvar:" -"`PYTHONNOUSERSITE` environment variable." +"Set by the :option:`-s` and :option:`-I` options, and " +"the :envvar:`PYTHONNOUSERSITE` environment variable." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"optimization_level` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.optimization_level` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -403,9 +401,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"quiet` should be used instead, see :ref:`Python Initialization Configuration " -"`." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.quiet` should be used instead, see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -416,9 +414,9 @@ msgid "Set by the :option:`-q` option." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"buffered_stdio` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.buffered_stdio` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "Force the stdout and stderr streams to be unbuffered." @@ -430,9 +428,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"verbose` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.verbose` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -452,8 +450,9 @@ msgstr "" msgid "" "Initialize the Python interpreter. In an application embedding Python, " -"this should be called before using any other Python/C API functions; see :" -"ref:`Before Python Initialization ` for the few exceptions." +"this should be called before using any other Python/C API functions; " +"see :ref:`Before Python Initialization ` for the few " +"exceptions." msgstr "" msgid "" @@ -507,18 +506,19 @@ msgstr "" msgid "" "Undo all initializations made by :c:func:`Py_Initialize` and subsequent use " -"of Python/C API functions, and destroy all sub-interpreters (see :c:func:" -"`Py_NewInterpreter` below) that were created and not yet destroyed since the " -"last call to :c:func:`Py_Initialize`. Ideally, this frees all memory " -"allocated by the Python interpreter. This is a no-op when called for a " -"second time (without calling :c:func:`Py_Initialize` again first)." +"of Python/C API functions, and destroy all sub-interpreters " +"(see :c:func:`Py_NewInterpreter` below) that were created and not yet " +"destroyed since the last call to :c:func:`Py_Initialize`. Ideally, this " +"frees all memory allocated by the Python interpreter. This is a no-op when " +"called for a second time (without calling :c:func:`Py_Initialize` again " +"first)." msgstr "" msgid "" "Since this is the reverse of :c:func:`Py_Initialize`, it should be called in " "the same thread with the same interpreter active. That means the main " -"thread and the main interpreter. This should never be called while :c:func:" -"`Py_RunMain` is running." +"thread and the main interpreter. This should never be called " +"while :c:func:`Py_RunMain` is running." msgstr "" msgid "" @@ -547,12 +547,16 @@ msgid "" "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." +"more than once. :c:func:`Py_FinalizeEx` must not be called recursively from " +"within itself. Therefore, it must not be called by any code that may be run " +"as part of the interpreter shutdown process, such as :py:mod:`atexit` " +"handlers, object finalizers, or any code that may be run while flushing the " +"stdout and stderr files." msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"_PySys_ClearAuditHooks`` with no arguments." +"Raises an :ref:`auditing event ` " +"``cpython._PySys_ClearAuditHooks`` with no arguments." msgstr "" msgid "" @@ -590,24 +594,14 @@ msgid "" msgstr "" msgid "" -"The return value will be ``0`` if the interpreter exits normally (i.e., " -"without an exception), ``1`` if the interpreter exits due to an exception, " -"or ``2`` if the argument list does not represent a valid Python command line." -msgstr "" - -msgid "" -"Note that if an otherwise unhandled :exc:`SystemExit` is raised, this " -"function will not return ``1``, but exit the process, as long as " -"``Py_InspectFlag`` is not set. If ``Py_InspectFlag`` is set, execution will " -"drop into the interactive Python prompt, at which point a second otherwise " -"unhandled :exc:`SystemExit` will still exit the process, while any other " -"means of exiting will set the return value as described above." +"The return value is ``2`` if the argument list does not represent a valid " +"Python command line, and otherwise the same as :c:func:`Py_RunMain`." msgstr "" msgid "" -"In terms of the CPython runtime configuration APIs documented in the :ref:" -"`runtime configuration ` section (and without accounting for " -"error handling), ``Py_Main`` is approximately equivalent to::" +"In terms of the CPython runtime configuration APIs documented in " +"the :ref:`runtime configuration ` section (and without " +"accounting for error handling), ``Py_Main`` is approximately equivalent to::" msgstr "" msgid "" @@ -622,33 +616,32 @@ msgstr "" msgid "" "In normal usage, an embedding application will call this function *instead* " -"of calling :c:func:`Py_Initialize`, :c:func:`Py_InitializeEx` or :c:func:" -"`Py_InitializeFromConfig` directly, and all settings will be applied as " -"described elsewhere in this documentation. If this function is instead " -"called *after* a preceding runtime initialization API call, then exactly " -"which environmental and command line configuration settings will be updated " -"is version dependent (as it depends on which settings correctly support " -"being modified after they have already been set once when the runtime was " -"first initialized)." +"of calling :c:func:`Py_Initialize`, :c:func:`Py_InitializeEx` " +"or :c:func:`Py_InitializeFromConfig` directly, and all settings will be " +"applied as described elsewhere in this documentation. If this function is " +"instead called *after* a preceding runtime initialization API call, then " +"exactly which environmental and command line configuration settings will be " +"updated is version dependent (as it depends on which settings correctly " +"support being modified after they have already been set once when the " +"runtime was first initialized)." msgstr "" msgid "Executes the main module in a fully configured CPython runtime." msgstr "" msgid "" -"Executes the command (:c:member:`PyConfig.run_command`), the script (:c:" -"member:`PyConfig.run_filename`) or the module (:c:member:`PyConfig." -"run_module`) specified on the command line or in the configuration. If none " -"of these values are set, runs the interactive Python prompt (REPL) using the " -"``__main__`` module's global namespace." +"Executes the command (:c:member:`PyConfig.run_command`), the script " +"(:c:member:`PyConfig.run_filename`) or the module " +"(:c:member:`PyConfig.run_module`) specified on the command line or in the " +"configuration. If none of these values are set, runs the interactive Python " +"prompt (REPL) using the ``__main__`` module's global namespace." msgstr "" msgid "" "If :c:member:`PyConfig.inspect` is not set (the default), the return value " "will be ``0`` if the interpreter exits normally (that is, without raising an " -"exception), or ``1`` if the interpreter exits due to an exception. If an " -"otherwise unhandled :exc:`SystemExit` is raised, the function will " -"immediately exit the process instead of returning ``1``." +"exception), the exit status of an unhandled :exc:`SystemExit`, or ``1`` for " +"any other unhandled exception." msgstr "" msgid "" @@ -657,22 +650,18 @@ msgid "" "instead resume in an interactive Python prompt (REPL) using the ``__main__`` " "module's global namespace. If the interpreter exited with an exception, it " "is immediately raised in the REPL session. The function return value is then " -"determined by the way the *REPL session* terminates: returning ``0`` if the " -"session terminates without raising an unhandled exception, exiting " -"immediately for an unhandled :exc:`SystemExit`, and returning ``1`` for any " -"other unhandled exception." +"determined by the way the *REPL session* terminates: ``0``, ``1``, or the " +"status of a :exc:`SystemExit`, as specified above." msgstr "" msgid "" -"This function always finalizes the Python interpreter regardless of whether " -"it returns a value or immediately exits the process due to an unhandled :exc:" -"`SystemExit` exception." +"This function always finalizes the Python interpreter before it returns." msgstr "" msgid "" "See :ref:`Python Configuration ` for an example of a " -"customized Python that always runs in isolated mode using :c:func:" -"`Py_RunMain`." +"customized Python that always runs in isolated mode " +"using :c:func:`Py_RunMain`." msgstr "" msgid "" @@ -688,9 +677,9 @@ msgid "Process-wide parameters" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"program_name` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.program_name` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -707,8 +696,8 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get a :c:expr:" -"`wchar_t*` string." +"Use :c:func:`Py_DecodeLocale` to decode a bytes string to get " +"a :c:expr:`wchar_t*` string." msgstr "" msgid "" @@ -752,11 +741,11 @@ msgid "" "with :c:member:`PyConfig.program_name` and some environment variables; for " "example, if the program name is ``'/usr/local/bin/python'``, the exec-prefix " "is ``'/usr/local'``. The returned string points into static storage; the " -"caller should not modify its value. This corresponds to the :makevar:" -"`exec_prefix` variable in the top-level :file:`Makefile` and the ``--exec-" -"prefix`` argument to the :program:`configure` script at build time. The " -"value is available to Python code as ``sys.base_exec_prefix``. It is only " -"useful on Unix." +"caller should not modify its value. This corresponds to " +"the :makevar:`exec_prefix` variable in the top-level :file:`Makefile` and " +"the ``--exec-prefix`` argument to the :program:`configure` script at build " +"time. The value is available to Python code as ``sys.base_exec_prefix``. " +"It is only useful on Unix." msgstr "" msgid "" @@ -781,15 +770,15 @@ msgid "" msgstr "" msgid "" -"System administrators will know how to configure the :program:`mount` or :" -"program:`automount` programs to share :file:`/usr/local` between platforms " -"while having :file:`/usr/local/plat` be a different filesystem for each " -"platform." +"System administrators will know how to configure the :program:`mount` " +"or :program:`automount` programs to share :file:`/usr/local` between " +"platforms while having :file:`/usr/local/plat` be a different filesystem for " +"each platform." msgstr "" msgid "" -"Get :data:`sys.base_exec_prefix` instead, or :data:`sys.exec_prefix` if :ref:" -"`virtual environments ` need to be handled." +"Get :data:`sys.base_exec_prefix` instead, or :data:`sys.exec_prefix` " +"if :ref:`virtual environments ` need to be handled." msgstr "" msgid "" @@ -827,8 +816,8 @@ msgid "" "The first word (up to the first space character) is the current Python " "version; the first characters are the major and minor version separated by a " "period. The returned string points into static storage; the caller should " -"not modify its value. The value is available to Python code as :data:`sys." -"version`." +"not modify its value. The value is available to Python code " +"as :data:`sys.version`." msgstr "" msgid "See also the :c:var:`Py_Version` constant." @@ -880,10 +869,10 @@ msgid "\"#67, Aug 1 1997, 22:34:28\"" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"argv`, :c:member:`PyConfig.parse_argv` and :c:member:`PyConfig.safe_path` " -"should be used instead, see :ref:`Python Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.argv`, :c:member:`PyConfig.parse_argv` " +"and :c:member:`PyConfig.safe_path` should be used instead, see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -904,8 +893,8 @@ msgstr "" msgid "" "If the name of an existing script is passed in ``argv[0]``, the absolute " -"path of the directory where the script is located is prepended to :data:`sys." -"path`." +"path of the directory where the script is located is prepended " +"to :data:`sys.path`." msgstr "" msgid "" @@ -927,32 +916,33 @@ msgstr "" msgid "" "On versions before 3.1.3, you can achieve the same effect by manually " -"popping the first :data:`sys.path` element after having called :c:func:" -"`PySys_SetArgv`, for example using::" +"popping the first :data:`sys.path` element after having " +"called :c:func:`PySys_SetArgv`, for example using::" msgstr "" msgid "PyRun_SimpleString(\"import sys; sys.path.pop(0)\\n\");" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"argv` and :c:member:`PyConfig.parse_argv` should be used instead, see :ref:" -"`Python Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.argv` and :c:member:`PyConfig.parse_argv` should " +"be used instead, see :ref:`Python Initialization Configuration `." msgstr "" msgid "" "This function works like :c:func:`PySys_SetArgvEx` with *updatepath* set to " -"``1`` unless the :program:`python` interpreter was started with the :option:" -"`-I`." +"``1`` unless the :program:`python` interpreter was started with " +"the :option:`-I`." msgstr "" msgid "The *updatepath* value depends on :option:`-I`." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"home` should be used instead, see :ref:`Python Initialization Configuration " -"`." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.home` should be used instead, see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -969,9 +959,9 @@ msgid "" msgstr "" msgid "" -"Return the default \"home\", that is, the value set by :c:member:`PyConfig." -"home`, or the value of the :envvar:`PYTHONHOME` environment variable if it " -"is set." +"Return the default \"home\", that is, the value set " +"by :c:member:`PyConfig.home`, or the value of the :envvar:`PYTHONHOME` " +"environment variable if it is set." msgstr "" msgid "" @@ -994,12 +984,13 @@ msgid "" msgstr "" msgid "" -"Therefore, the rule exists that only the thread that has acquired the :term:" -"`GIL` may operate on Python objects or call Python/C API functions. In order " -"to emulate concurrency of execution, the interpreter regularly tries to " -"switch threads (see :func:`sys.setswitchinterval`). The lock is also " -"released around potentially blocking I/O operations like reading or writing " -"a file, so that other Python threads can run in the meantime." +"Therefore, the rule exists that only the thread that has acquired " +"the :term:`GIL` may operate on Python objects or call Python/C API " +"functions. In order to emulate concurrency of execution, the interpreter " +"regularly tries to switch threads (see :func:`sys.setswitchinterval`). The " +"lock is also released around potentially blocking I/O operations like " +"reading or writing a file, so that other Python threads can run in the " +"meantime." msgstr "" msgid "" @@ -1074,10 +1065,10 @@ msgid "Non-Python created threads" msgstr "" msgid "" -"When threads are created using the dedicated Python APIs (such as the :mod:" -"`threading` module), a thread state is automatically associated to them and " -"the code showed above is therefore correct. However, when threads are " -"created from C (for example by a third-party library with its own thread " +"When threads are created using the dedicated Python APIs (such as " +"the :mod:`threading` module), a thread state is automatically associated to " +"them and the code showed above is therefore correct. However, when threads " +"are created from C (for example by a third-party library with its own thread " "management), they don't hold the GIL, nor is there a thread state structure " "for them." msgstr "" @@ -1113,9 +1104,9 @@ msgstr "" msgid "" "Note that the ``PyGILState_*`` functions assume there is only one global " "interpreter (created automatically by :c:func:`Py_Initialize`). Python " -"supports the creation of additional interpreters (using :c:func:" -"`Py_NewInterpreter`), but mixing multiple interpreters and the " -"``PyGILState_*`` API is unsupported." +"supports the creation of additional interpreters " +"(using :c:func:`Py_NewInterpreter`), but mixing multiple interpreters and " +"the ``PyGILState_*`` API is unsupported." msgstr "" msgid "Cautions about fork()" @@ -1138,11 +1129,11 @@ msgid "" "of additional (non-Python) locks that need to be acquired before or reset " "after a fork. OS facilities such as :c:func:`!pthread_atfork` would need to " "be used to accomplish the same thing. Additionally, when extending or " -"embedding Python, calling :c:func:`fork` directly rather than through :func:" -"`os.fork` (and returning to or calling into Python) may result in a deadlock " -"by one of Python's internal locks being held by a thread that is defunct " -"after the fork. :c:func:`PyOS_AfterFork_Child` tries to reset the necessary " -"locks, but is not always able to." +"embedding Python, calling :c:func:`fork` directly rather than " +"through :func:`os.fork` (and returning to or calling into Python) may result " +"in a deadlock by one of Python's internal locks being held by a thread that " +"is defunct after the fork. :c:func:`PyOS_AfterFork_Child` tries to reset the " +"necessary locks, but is not always able to." msgstr "" msgid "" @@ -1157,6 +1148,41 @@ msgid "" "called immediately after." msgstr "" +msgid "Cautions regarding runtime finalization" +msgstr "" + +msgid "" +"In the late stage of :term:`interpreter shutdown`, after attempting to wait " +"for non-daemon threads to exit (though this can be interrupted " +"by :class:`KeyboardInterrupt`) and running the :mod:`atexit` functions, the " +"runtime is marked as *finalizing*: :c:func:`Py_IsFinalizing` " +"and :func:`sys.is_finalizing` return true. At this point, only the " +"*finalization thread* that initiated finalization (typically the main " +"thread) is allowed to acquire the :term:`GIL`." +msgstr "" + +msgid "" +"If any thread, other than the finalization thread, attempts to acquire the " +"GIL during finalization, either explicitly " +"via :c:func:`PyGILState_Ensure`, :c:macro:`Py_END_ALLOW_THREADS`, :c:func:`PyEval_AcquireThread`, " +"or :c:func:`!PyEval_AcquireLock`, or implicitly when the interpreter " +"attempts to reacquire it after having yielded it, the thread enters **a " +"permanently blocked state** where it remains until the program exits. In " +"most cases this is harmless, but this can result in deadlock if a later " +"stage of finalization attempts to acquire a lock owned by the blocked " +"thread, or otherwise waits on the blocked thread." +msgstr "" + +msgid "" +"Gross? Yes. This prevents random crashes and/or unexpectedly skipped C++ " +"finalizations further up the call stack when such threads were forcibly " +"exited here in CPython 3.13.7 and earlier. The CPython runtime GIL acquiring " +"C APIs have never had any error reporting or handling expectations at GIL " +"acquisition time that would've allowed for graceful exit from this " +"situation. Changing that would require new stable C APIs and rewriting the " +"majority of C code in the CPython ecosystem to use those with error handling." +msgstr "" + msgid "High-level API" msgstr "" @@ -1179,6 +1205,11 @@ msgid "" "which interpreter they belong." msgstr "" +msgid "" +":pep:`684` introduced the possibility of a :ref:`per-interpreter GIL `. See :c:func:`Py_NewInterpreterFromConfig`." +msgstr "" + msgid "" "This data structure represents the state of a single thread. The only " "public data member is:" @@ -1221,11 +1252,15 @@ msgid "" 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." +"Calling this function from a thread when the runtime is finalizing will hang " +"the thread until the program exits, even if the thread was not created by " +"Python. Refer to :ref:`cautions-regarding-runtime-finalization` for more " +"details." +msgstr "" + +msgid "" +"Hangs the current thread, rather than terminating it, if called while the " +"interpreter is finalizing." msgstr "" msgid "" @@ -1250,8 +1285,12 @@ msgstr "" msgid "" "Swap the current thread state with the thread state given by the argument " -"*tstate*, which may be ``NULL``. The global interpreter lock must be held " -"and is not released." +"*tstate*, which may be ``NULL``." +msgstr "" + +msgid "" +"The :term:`GIL` does not need to be held, but will be held upon returning if " +"*tstate* is non-``NULL``." msgstr "" msgid "" @@ -1259,25 +1298,36 @@ msgid "" "with sub-interpreters:" msgstr "" +msgid "" +"The type of the value returned by :c:func:`PyGILState_Ensure` and passed " +"to :c:func:`PyGILState_Release`." +msgstr "" + +msgid "The GIL was already held when :c:func:`PyGILState_Ensure` was called." +msgstr "" + +msgid "The GIL was not held when :c:func:`PyGILState_Ensure` was called." +msgstr "" + msgid "" "Ensure that the current thread is ready to call the Python C API regardless " "of the current state of Python, or of the global interpreter lock. This may " "be called as many times as desired by a thread as long as each call is " "matched with a call to :c:func:`PyGILState_Release`. In general, other " -"thread-related APIs may be used between :c:func:`PyGILState_Ensure` and :c:" -"func:`PyGILState_Release` calls as long as the thread state is restored to " -"its previous state before the Release(). For example, normal usage of the :" -"c:macro:`Py_BEGIN_ALLOW_THREADS` and :c:macro:`Py_END_ALLOW_THREADS` macros " -"is acceptable." +"thread-related APIs may be used between :c:func:`PyGILState_Ensure` " +"and :c:func:`PyGILState_Release` calls as long as the thread state is " +"restored to its previous state before the Release(). For example, normal " +"usage of the :c:macro:`Py_BEGIN_ALLOW_THREADS` " +"and :c:macro:`Py_END_ALLOW_THREADS` macros is acceptable." msgstr "" msgid "" -"The return value is an opaque \"handle\" to the thread state when :c:func:" -"`PyGILState_Ensure` was called, and must be passed to :c:func:" -"`PyGILState_Release` to ensure Python is left in the same state. Even though " -"recursive calls are allowed, these handles *cannot* be shared - each unique " -"call to :c:func:`PyGILState_Ensure` must save the handle for its call to :c:" -"func:`PyGILState_Release`." +"The return value is an opaque \"handle\" to the thread state " +"when :c:func:`PyGILState_Ensure` was called, and must be passed " +"to :c:func:`PyGILState_Release` to ensure Python is left in the same state. " +"Even though recursive calls are allowed, these handles *cannot* be shared - " +"each unique call to :c:func:`PyGILState_Ensure` must save the handle for its " +"call to :c:func:`PyGILState_Release`." msgstr "" msgid "" @@ -1287,14 +1337,14 @@ msgstr "" msgid "" "Release any resources previously acquired. After this call, Python's state " -"will be the same as it was prior to the corresponding :c:func:" -"`PyGILState_Ensure` call (but generally this state will be unknown to the " -"caller, hence the use of the GILState API)." +"will be the same as it was prior to the " +"corresponding :c:func:`PyGILState_Ensure` call (but generally this state " +"will be unknown to the caller, hence the use of the GILState API)." msgstr "" msgid "" -"Every call to :c:func:`PyGILState_Ensure` must be matched by a call to :c:" -"func:`PyGILState_Release` on the same thread." +"Every call to :c:func:`PyGILState_Ensure` must be matched by a call " +"to :c:func:`PyGILState_Release` on the same thread." msgstr "" msgid "" @@ -1320,27 +1370,27 @@ msgid "" msgstr "" msgid "" -"This macro expands to ``{ PyThreadState *_save; _save = PyEval_SaveThread();" -"``. Note that it contains an opening brace; it must be matched with a " -"following :c:macro:`Py_END_ALLOW_THREADS` macro. See above for further " -"discussion of this macro." +"This macro expands to ``{ PyThreadState *_save; _save = " +"PyEval_SaveThread();``. Note that it contains an opening brace; it must be " +"matched with a following :c:macro:`Py_END_ALLOW_THREADS` macro. See above " +"for further discussion of this macro." msgstr "" msgid "" "This macro expands to ``PyEval_RestoreThread(_save); }``. Note that it " -"contains a closing brace; it must be matched with an earlier :c:macro:" -"`Py_BEGIN_ALLOW_THREADS` macro. See above for further discussion of this " -"macro." +"contains a closing brace; it must be matched with an " +"earlier :c:macro:`Py_BEGIN_ALLOW_THREADS` macro. See above for further " +"discussion of this macro." msgstr "" msgid "" -"This macro expands to ``PyEval_RestoreThread(_save);``: it is equivalent to :" -"c:macro:`Py_END_ALLOW_THREADS` without the closing brace." +"This macro expands to ``PyEval_RestoreThread(_save);``: it is equivalent " +"to :c:macro:`Py_END_ALLOW_THREADS` without the closing brace." msgstr "" msgid "" -"This macro expands to ``_save = PyEval_SaveThread();``: it is equivalent to :" -"c:macro:`Py_BEGIN_ALLOW_THREADS` without the opening brace and variable " +"This macro expands to ``_save = PyEval_SaveThread();``: it is equivalent " +"to :c:macro:`Py_BEGIN_ALLOW_THREADS` without the opening brace and variable " "declaration." msgstr "" @@ -1361,8 +1411,8 @@ msgid "" msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_New`` with no arguments." +"Raises an :ref:`auditing event ` " +"``cpython.PyInterpreterState_New`` with no arguments." msgstr "" msgid "" @@ -1371,8 +1421,8 @@ msgid "" msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``cpython." -"PyInterpreterState_Clear`` with no arguments." +"Raises an :ref:`auditing event ` " +"``cpython.PyInterpreterState_Clear`` with no arguments." msgstr "" msgid "" @@ -1393,24 +1443,24 @@ msgid "" msgstr "" msgid "" -"This function now calls the :c:member:`PyThreadState.on_delete` callback. " +"This function now calls the :c:member:`!PyThreadState.on_delete` callback. " "Previously, that happened in :c:func:`PyThreadState_Delete`." msgstr "" -msgid "The :c:member:`PyThreadState.on_delete` callback was removed." +msgid "The :c:member:`!PyThreadState.on_delete` callback was removed." msgstr "" msgid "" "Destroy a thread state object. The global interpreter lock need not be " -"held. The thread state must have been reset with a previous call to :c:func:" -"`PyThreadState_Clear`." +"held. The thread state must have been reset with a previous call " +"to :c:func:`PyThreadState_Clear`." msgstr "" msgid "" "Destroy the current thread state and release the global interpreter lock. " "Like :c:func:`PyThreadState_Delete`, the global interpreter lock must be " -"held. The thread state must have been reset with a previous call to :c:func:" -"`PyThreadState_Clear`." +"held. The thread state must have been reset with a previous call " +"to :c:func:`PyThreadState_Clear`." msgstr "" msgid "Get the current frame of the Python thread state *tstate*." @@ -1453,7 +1503,7 @@ msgid "Get the current interpreter." msgstr "" msgid "" -"Issue a fatal error if there no current Python thread state or no current " +"Issue a fatal error if there is no current Python thread state or no current " "interpreter. It cannot return NULL." msgstr "" @@ -1476,6 +1526,11 @@ msgid "" "extensions should use to store interpreter-specific state information." msgstr "" +msgid "" +"The returned dictionary is borrowed from the interpreter and is valid until " +"interpreter shutdown." +msgstr "" + msgid "" "Return a :term:`strong reference` to the ``__main__`` :ref:`module object " "` for the given interpreter." @@ -1526,8 +1581,8 @@ msgid "" msgstr "" msgid "" -"The type of the *id* parameter changed from :c:expr:`long` to :c:expr:" -"`unsigned long`." +"The type of the *id* parameter changed from :c:expr:`long` " +"to :c:expr:`unsigned long`." msgstr "" msgid "" @@ -1537,9 +1592,10 @@ msgid "" msgstr "" msgid "" -"Updated to be consistent with :c:func:`PyEval_RestoreThread`, :c:func:" -"`Py_END_ALLOW_THREADS`, and :c:func:`PyGILState_Ensure`, and terminate the " -"current thread if called while the interpreter is finalizing." +"Updated to be consistent " +"with :c:func:`PyEval_RestoreThread`, :c:func:`Py_END_ALLOW_THREADS`, " +"and :c:func:`PyGILState_Ensure`, and terminate the current thread if called " +"while the interpreter is finalizing." msgstr "" msgid "" @@ -1581,9 +1637,9 @@ msgid "" msgstr "" msgid "" -"You can switch between sub-interpreters using the :c:func:" -"`PyThreadState_Swap` function. You can create and destroy them using the " -"following functions:" +"You can switch between sub-interpreters using " +"the :c:func:`PyThreadState_Swap` function. You can create and destroy them " +"using the following functions:" msgstr "" msgid "" @@ -1601,10 +1657,10 @@ msgid "" msgstr "" msgid "" -"If this is ``0`` then :c:member:`~PyInterpreterConfig." -"check_multi_interp_extensions` must be ``1`` (non-zero). If this is ``1`` " -"then :c:member:`~PyInterpreterConfig.gil` must not be :c:macro:" -"`PyInterpreterConfig_OWN_GIL`." +"If this is ``0`` " +"then :c:member:`~PyInterpreterConfig.check_multi_interp_extensions` must be " +"``1`` (non-zero). If this is ``1`` then :c:member:`~PyInterpreterConfig.gil` " +"must not be :c:macro:`PyInterpreterConfig_OWN_GIL`." msgstr "" msgid "" @@ -1634,21 +1690,21 @@ msgstr "" msgid "" "If this is ``0`` then the sub-interpreter's :mod:`threading` module won't " -"create daemon threads. Otherwise daemon threads are allowed (as long as :c:" -"member:`~PyInterpreterConfig.allow_threads` is non-zero)." +"create daemon threads. Otherwise daemon threads are allowed (as long " +"as :c:member:`~PyInterpreterConfig.allow_threads` is non-zero)." msgstr "" msgid "" "If this is ``0`` then all extension modules may be imported, including " "legacy (single-phase init) modules, in any thread where the sub-interpreter " -"is currently active. Otherwise only multi-phase init extension modules (see :" -"pep:`489`) may be imported. (Also see :c:macro:" -"`Py_mod_multiple_interpreters`.)" +"is currently active. Otherwise only multi-phase init extension modules " +"(see :pep:`489`) may be imported. (Also " +"see :c:macro:`Py_mod_multiple_interpreters`.)" msgstr "" msgid "" -"This must be ``1`` (non-zero) if :c:member:`~PyInterpreterConfig." -"use_main_obmalloc` is ``0``." +"This must be ``1`` (non-zero) " +"if :c:member:`~PyInterpreterConfig.use_main_obmalloc` is ``0``." msgstr "" msgid "" @@ -1666,20 +1722,20 @@ msgid "Use the sub-interpreter's own GIL." msgstr "" msgid "" -"If this is :c:macro:`PyInterpreterConfig_OWN_GIL` then :c:member:" -"`PyInterpreterConfig.use_main_obmalloc` must be ``0``." +"If this is :c:macro:`PyInterpreterConfig_OWN_GIL` " +"then :c:member:`PyInterpreterConfig.use_main_obmalloc` must be ``0``." msgstr "" msgid "" "Create a new sub-interpreter. This is an (almost) totally separate " "environment for the execution of Python code. In particular, the new " "interpreter has separate, independent versions of all imported modules, " -"including the fundamental modules :mod:`builtins`, :mod:`__main__` and :mod:" -"`sys`. The table of loaded modules (``sys.modules``) and the module search " -"path (``sys.path``) are also separate. The new environment has no ``sys." -"argv`` variable. It has new standard I/O stream file objects ``sys.stdin``, " -"``sys.stdout`` and ``sys.stderr`` (however these refer to the same " -"underlying file descriptors)." +"including the fundamental modules :mod:`builtins`, :mod:`__main__` " +"and :mod:`sys`. The table of loaded modules (``sys.modules``) and the " +"module search path (``sys.path``) are also separate. The new environment " +"has no ``sys.argv`` variable. It has new standard I/O stream file objects " +"``sys.stdin``, ``sys.stdout`` and ``sys.stderr`` (however these refer to the " +"same underlying file descriptors)." msgstr "" msgid "" @@ -1732,47 +1788,48 @@ msgstr "" msgid "" "Note that the config is used only briefly and does not get modified. During " -"initialization the config's values are converted into various :c:type:" -"`PyInterpreterState` values. A read-only copy of the config may be stored " -"internally on the :c:type:`PyInterpreterState`." +"initialization the config's values are converted into " +"various :c:type:`PyInterpreterState` values. A read-only copy of the config " +"may be stored internally on the :c:type:`PyInterpreterState`." msgstr "" msgid "Extension modules are shared between (sub-)interpreters as follows:" msgstr "" msgid "" -"For modules using multi-phase initialization, e.g. :c:func:" -"`PyModule_FromDefAndSpec`, a separate module object is created and " -"initialized for each interpreter. Only C-level static and global variables " -"are shared between these module objects." +"For modules using multi-phase initialization, " +"e.g. :c:func:`PyModule_FromDefAndSpec`, a separate module object is created " +"and initialized for each interpreter. Only C-level static and global " +"variables are shared between these module objects." msgstr "" msgid "" -"For modules using single-phase initialization, e.g. :c:func:" -"`PyModule_Create`, the first time a particular extension is imported, it is " -"initialized normally, and a (shallow) copy of its module's dictionary is " -"squirreled away. When the same extension is imported by another " -"(sub-)interpreter, a new module is initialized and filled with the contents " -"of this copy; the extension's ``init`` function is not called. Objects in " -"the module's dictionary thus end up shared across (sub-)interpreters, which " -"might cause unwanted behavior (see `Bugs and caveats`_ below)." +"For modules using single-phase initialization, " +"e.g. :c:func:`PyModule_Create`, the first time a particular extension is " +"imported, it is initialized normally, and a (shallow) copy of its module's " +"dictionary is squirreled away. When the same extension is imported by " +"another (sub-)interpreter, a new module is initialized and filled with the " +"contents of this copy; the extension's ``init`` function is not called. " +"Objects in the module's dictionary thus end up shared across " +"(sub-)interpreters, which might cause unwanted behavior (see `Bugs and " +"caveats`_ below)." msgstr "" msgid "" "Note that this is different from what happens when an extension is imported " -"after the interpreter has been completely re-initialized by calling :c:func:" -"`Py_FinalizeEx` and :c:func:`Py_Initialize`; in that case, the extension's " -"``initmodule`` function *is* called again. As with multi-phase " -"initialization, this means that only C-level static and global variables are " -"shared between these modules." +"after the interpreter has been completely re-initialized by " +"calling :c:func:`Py_FinalizeEx` and :c:func:`Py_Initialize`; in that case, " +"the extension's ``initmodule`` function *is* called again. As with multi-" +"phase initialization, this means that only C-level static and global " +"variables are shared between these modules." msgstr "" msgid "" -"Create a new sub-interpreter. This is essentially just a wrapper around :c:" -"func:`Py_NewInterpreterFromConfig` with a config that preserves the existing " -"behavior. The result is an unisolated sub-interpreter that shares the main " -"interpreter's GIL, allows fork/exec, allows daemon threads, and allows " -"single-phase init modules." +"Create a new sub-interpreter. This is essentially just a wrapper " +"around :c:func:`Py_NewInterpreterFromConfig` with a config that preserves " +"the existing behavior. The result is an unisolated sub-interpreter that " +"shares the main interpreter's GIL, allows fork/exec, allows daemon threads, " +"and allows single-phase init modules." msgstr "" msgid "" @@ -1800,7 +1857,7 @@ msgid "" "interpreters or blocking any others. Thus a single Python process can truly " "take advantage of multiple CPU cores when running Python code. The " "isolation also encourages a different approach to concurrency than that of " -"just using threads. (See :pep:`554`.)" +"just using threads. (See :pep:`554` and :pep:`684`.)" msgstr "" msgid "" @@ -1860,10 +1917,10 @@ msgid "" "delicate, because these APIs assume a bijection between Python thread states " "and OS-level threads, an assumption broken by the presence of sub-" "interpreters. It is highly recommended that you don't switch sub-" -"interpreters between a pair of matching :c:func:`PyGILState_Ensure` and :c:" -"func:`PyGILState_Release` calls. Furthermore, extensions (such as :mod:" -"`ctypes`) using these APIs to allow calling of Python code from non-Python " -"created threads will probably be broken when using sub-interpreters." +"interpreters between a pair of matching :c:func:`PyGILState_Ensure` " +"and :c:func:`PyGILState_Release` calls. Furthermore, extensions (such " +"as :mod:`ctypes`) using these APIs to allow calling of Python code from non-" +"Python created threads will probably be broken when using sub-interpreters." msgstr "" msgid "Asynchronous Notifications" @@ -1919,8 +1976,8 @@ msgid "" "no guarantee that *func* will be called as quick as possible. If the main " "thread is busy executing a system call, *func* won't be called before the " "system call returns. This function is generally **not** suitable for " -"calling Python code from arbitrary C threads. Instead, use the :ref:" -"`PyGILState API`." +"calling Python code from arbitrary C threads. Instead, use " +"the :ref:`PyGILState API`." msgstr "" msgid "" @@ -1930,6 +1987,29 @@ msgid "" "scheduled calls." msgstr "" +msgid "" +"This function now always schedules *func* to be run in the main interpreter." +msgstr "" + +msgid "" +"Execute all pending calls. This is usually executed automatically by the " +"interpreter." +msgstr "" + +msgid "" +"This function returns ``0`` on success, and returns ``-1`` with an exception " +"set on failure." +msgstr "" + +msgid "" +"If this is not called in the main thread of the main interpreter, this " +"function does nothing and returns ``0``. The caller must hold " +"the :term:`GIL`." +msgstr "" + +msgid "This function only runs pending calls in the main interpreter." +msgstr "" + msgid "Profiling and Tracing" msgstr "" @@ -1952,11 +2032,9 @@ msgid "" "The type of the trace function registered using :c:func:`PyEval_SetProfile` " "and :c:func:`PyEval_SetTrace`. The first parameter is the object passed to " "the registration function as *obj*, *frame* is the frame object to which the " -"event pertains, *what* is one of the constants :c:data:`PyTrace_CALL`, :c:" -"data:`PyTrace_EXCEPTION`, :c:data:`PyTrace_LINE`, :c:data:`PyTrace_RETURN`, :" -"c:data:`PyTrace_C_CALL`, :c:data:`PyTrace_C_EXCEPTION`, :c:data:" -"`PyTrace_C_RETURN`, or :c:data:`PyTrace_OPCODE`, and *arg* depends on the " -"value of *what*:" +"event pertains, *what* is one of the " +"constants :c:data:`PyTrace_CALL`, :c:data:`PyTrace_EXCEPTION`, :c:data:`PyTrace_LINE`, :c:data:`PyTrace_RETURN`, :c:data:`PyTrace_C_CALL`, :c:data:`PyTrace_C_EXCEPTION`, :c:data:`PyTrace_C_RETURN`, " +"or :c:data:`PyTrace_OPCODE`, and *arg* depends on the value of *what*:" msgstr "" msgid "Value of *what*" @@ -2017,15 +2095,15 @@ msgid "" "exception becomes set within the frame being executed. The effect of this " "is that as exception propagation causes the Python stack to unwind, the " "callback is called upon return to each frame as the exception propagates. " -"Only trace functions receives these events; they are not needed by the " +"Only trace functions receive these events; they are not needed by the " "profiler." msgstr "" msgid "" "The value passed as the *what* parameter to a :c:type:`Py_tracefunc` " "function (but not a profiling function) when a line-number event is being " -"reported. It may be disabled for a frame by setting :attr:`~frame." -"f_trace_lines` to *0* on that frame." +"reported. It may be disabled for a frame by " +"setting :attr:`~frame.f_trace_lines` to *0* on that frame." msgstr "" msgid "" @@ -2051,8 +2129,8 @@ msgstr "" msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions (but " "not profiling functions) when a new opcode is about to be executed. This " -"event is not emitted by default: it must be explicitly requested by setting :" -"attr:`~frame.f_trace_opcodes` to *1* on the frame." +"event is not emitted by default: it must be explicitly requested by " +"setting :attr:`~frame.f_trace_opcodes` to *1* on the frame." msgstr "" msgid "" @@ -2060,8 +2138,9 @@ msgid "" "function as its first parameter, and may be any Python object, or ``NULL``. " "If the profile function needs to maintain state, using a different value for " "*obj* for each thread provides a convenient and thread-safe place to store " -"it. The profile function is called for all monitored events except :c:data:" -"`PyTrace_LINE` :c:data:`PyTrace_OPCODE` and :c:data:`PyTrace_EXCEPTION`." +"it. The profile function is called for all monitored events " +"except :c:data:`PyTrace_LINE` :c:data:`PyTrace_OPCODE` " +"and :c:data:`PyTrace_EXCEPTION`." msgstr "" msgid "See also the :func:`sys.setprofile` function." @@ -2082,13 +2161,13 @@ msgid "" msgstr "" msgid "" -"Set the tracing function to *func*. This is similar to :c:func:" -"`PyEval_SetProfile`, except the tracing function does receive line-number " -"events and per-opcode events, but does not receive any event related to C " -"function objects being called. Any trace function registered using :c:func:" -"`PyEval_SetTrace` will not receive :c:data:`PyTrace_C_CALL`, :c:data:" -"`PyTrace_C_EXCEPTION` or :c:data:`PyTrace_C_RETURN` as a value for the " -"*what* parameter." +"Set the tracing function to *func*. This is similar " +"to :c:func:`PyEval_SetProfile`, except the tracing function does receive " +"line-number events and per-opcode events, but does not receive any event " +"related to C function objects being called. Any trace function registered " +"using :c:func:`PyEval_SetTrace` will not " +"receive :c:data:`PyTrace_C_CALL`, :c:data:`PyTrace_C_EXCEPTION` " +"or :c:data:`PyTrace_C_RETURN` as a value for the *what* parameter." msgstr "" msgid "See also the :func:`sys.settrace` function." @@ -2109,12 +2188,12 @@ msgid "Reference tracing" msgstr "" msgid "" -"The type of the trace function registered using :c:func:" -"`PyRefTracer_SetTracer`. The first parameter is a Python object that has " -"been just created (when **event** is set to :c:data:`PyRefTracer_CREATE`) or " -"about to be destroyed (when **event** is set to :c:data:" -"`PyRefTracer_DESTROY`). The **data** argument is the opaque pointer that was " -"provided when :c:func:`PyRefTracer_SetTracer` was called." +"The type of the trace function registered " +"using :c:func:`PyRefTracer_SetTracer`. The first parameter is a Python " +"object that has been just created (when **event** is set " +"to :c:data:`PyRefTracer_CREATE`) or about to be destroyed (when **event** is " +"set to :c:data:`PyRefTracer_DESTROY`). The **data** argument is the opaque " +"pointer that was provided when :c:func:`PyRefTracer_SetTracer` was called." msgstr "" msgid "" @@ -2136,7 +2215,7 @@ msgid "" msgstr "" msgid "" -"Not that tracer functions **must not** create Python objects inside or " +"Note that tracer functions **must not** create Python objects inside or " "otherwise the call will be re-entrant. The tracer also **must not** clear " "any existing exception or set an exception. The GIL will be held every time " "the tracer function is called." @@ -2205,10 +2284,10 @@ msgid "" msgstr "" msgid "" -"None of these API functions handle memory management on behalf of the :c:" -"expr:`void*` values. You need to allocate and deallocate them yourself. If " -"the :c:expr:`void*` values happen to be :c:expr:`PyObject*`, these functions " -"don't do refcount operations on them either." +"None of these API functions handle memory management on behalf of " +"the :c:expr:`void*` values. You need to allocate and deallocate them " +"yourself. If the :c:expr:`void*` values happen to be :c:expr:`PyObject*`, " +"these functions don't do refcount operations on them either." msgstr "" msgid "Thread Specific Storage (TSS) API" @@ -2250,8 +2329,9 @@ msgid "" msgstr "" msgid "" -"Return a value which is the same state as a value initialized with :c:macro:" -"`Py_tss_NEEDS_INIT`, or ``NULL`` in the case of dynamic allocation failure." +"Return a value which is the same state as a value initialized " +"with :c:macro:`Py_tss_NEEDS_INIT`, or ``NULL`` in the case of dynamic " +"allocation failure." msgstr "" msgid "" @@ -2270,8 +2350,8 @@ msgstr "" msgid "" "The parameter *key* of these functions must not be ``NULL``. Moreover, the " "behaviors of :c:func:`PyThread_tss_set` and :c:func:`PyThread_tss_get` are " -"undefined if the given :c:type:`Py_tss_t` has not been initialized by :c:" -"func:`PyThread_tss_create`." +"undefined if the given :c:type:`Py_tss_t` has not been initialized " +"by :c:func:`PyThread_tss_create`." msgstr "" msgid "" @@ -2290,9 +2370,9 @@ msgstr "" msgid "" "Destroy a TSS key to forget the values associated with the key across all " "threads, and change the key's initialization state to uninitialized. A " -"destroyed key is able to be initialized again by :c:func:" -"`PyThread_tss_create`. This function can be called repeatedly on the same " -"key -- calling it on an already destroyed key is a no-op." +"destroyed key is able to be initialized again " +"by :c:func:`PyThread_tss_create`. This function can be called repeatedly on " +"the same key -- calling it on an already destroyed key is a no-op." msgstr "" msgid "" @@ -2375,13 +2455,23 @@ msgid "" "no-ops in versions of Python with the global interpreter lock." msgstr "" +msgid "" +"Critical sections are intended to be used for custom types implemented in C-" +"API extensions. They should generally not be used with built-in types " +"like :class:`list` and :class:`dict` because their public C-APIs already use " +"critical sections internally, with the notable exception " +"of :c:func:`PyDict_Next`, which requires critical section to be acquired " +"externally." +msgstr "" + msgid "" "Critical sections avoid deadlocks by implicitly suspending active critical " -"sections and releasing the locks during calls to :c:func:" -"`PyEval_SaveThread`. When :c:func:`PyEval_RestoreThread` is called, the most " -"recent critical section is resumed, and its locks reacquired. This means " -"the critical section API provides weaker guarantees than traditional locks " -"-- they are useful because their behavior is similar to the :term:`GIL`." +"sections, hence, they do not provide exclusive access such as provided by " +"traditional locks like :c:type:`PyMutex`. When a critical section is " +"started, the per-object lock for the object is acquired. If the code " +"executed inside the critical section calls C-API functions then it can " +"suspend the critical section thereby releasing the per-object lock, so other " +"threads can acquire the per-object lock for the same object." msgstr "" msgid "" @@ -2392,11 +2482,11 @@ msgid "" msgstr "" msgid "" -"Operations that need to lock two objects at once must use :c:macro:" -"`Py_BEGIN_CRITICAL_SECTION2`. You *cannot* use nested critical sections to " -"lock more than one object at once, because the inner critical section may " -"suspend the outer critical sections. This API does not provide a way to " -"lock more than two objects at once." +"Operations that need to lock two objects at once must " +"use :c:macro:`Py_BEGIN_CRITICAL_SECTION2`. You *cannot* use nested critical " +"sections to lock more than one object at once, because the inner critical " +"section may suspend the outer critical sections. This API does not provide " +"a way to lock more than two objects at once." msgstr "" msgid "Example usage::" @@ -2418,8 +2508,8 @@ msgid "" "can call arbitrary code through an object's deallocation function. The " "critical section API avoids potential deadlocks due to reentrancy and lock " "ordering by allowing the runtime to temporarily suspend the critical section " -"if the code triggered by the finalizer blocks and calls :c:func:" -"`PyEval_SaveThread`." +"if the code triggered by the finalizer blocks and " +"calls :c:func:`PyEval_SaveThread`." msgstr "" msgid "" @@ -2470,6 +2560,204 @@ msgid "" "}" msgstr "" +msgid "Legacy Locking APIs" +msgstr "" + +msgid "" +"These APIs are obsolete since Python 3.13 with the introduction " +"of :c:type:`PyMutex`." +msgstr "" + +msgid "These APIs are now a simple wrapper around ``PyMutex``." +msgstr "" + +msgid "A pointer to a mutual exclusion lock." +msgstr "" + +msgid "The result of acquiring a lock with a timeout." +msgstr "" + +msgid "Failed to acquire the lock." +msgstr "" + +msgid "The lock was successfully acquired." +msgstr "" + +msgid "The lock was interrupted by a signal." +msgstr "" + +msgid "Allocate a new lock." +msgstr "" + +msgid "" +"On success, this function returns a lock; on failure, this function returns " +"``0`` without an exception set." +msgstr "" + +msgid "The caller does not need to hold the :term:`GIL`." +msgstr "" + +msgid "" +"This function now always uses :c:type:`PyMutex`. In prior versions, this " +"would use a lock provided by the operating system." +msgstr "" + +msgid "" +"Destroy *lock*. The lock should not be held by any thread when calling this." +msgstr "" + +msgid "Acquire *lock* with a timeout." +msgstr "" + +msgid "" +"This will wait for *microseconds* microseconds to acquire the lock. If the " +"timeout expires, this function returns :c:enumerator:`PY_LOCK_FAILURE`. If " +"*microseconds* is ``-1``, this will wait indefinitely until the lock has " +"been released." +msgstr "" + +msgid "" +"If *intr_flag* is ``1``, acquiring the lock may be interrupted by a signal, " +"in which case this function returns :c:enumerator:`PY_LOCK_INTR`. Upon " +"interruption, it's generally expected that the caller makes a call " +"to :c:func:`Py_MakePendingCalls` to propagate an exception to Python code." +msgstr "" + +msgid "" +"If the lock is successfully acquired, this function " +"returns :c:enumerator:`PY_LOCK_ACQUIRED`." +msgstr "" + +msgid "Acquire *lock*." +msgstr "" + +msgid "" +"If *waitflag* is ``1`` and another thread currently holds the lock, this " +"function will wait until the lock can be acquired and will always return " +"``1``." +msgstr "" + +msgid "" +"If *waitflag* is ``0`` and another thread holds the lock, this function will " +"not wait and instead return ``0``. If the lock is not held by any other " +"thread, then this function will acquire it and return ``1``." +msgstr "" + +msgid "" +"Unlike :c:func:`PyThread_acquire_lock_timed`, acquiring the lock cannot be " +"interrupted by a signal." +msgstr "" + +msgid "" +"Release *lock*. If *lock* is not held, then this function issues a fatal " +"error." +msgstr "" + +msgid "Operating System Thread APIs" +msgstr "" + +msgid "Sentinel value for an invalid thread ID." +msgstr "" + +msgid "This is currently equivalent to ``(unsigned long)-1``." +msgstr "" + +msgid "" +"Start function *func* in a new thread with argument *arg*. The resulting " +"thread is not intended to be joined." +msgstr "" + +msgid "*func* must not be ``NULL``, but *arg* may be ``NULL``." +msgstr "" + +msgid "" +"On success, this function returns the identifier of the new thread; on " +"failure, this returns :c:macro:`PYTHREAD_INVALID_THREAD_ID`." +msgstr "" + +msgid "Return the identifier of the current thread, which will never be zero." +msgstr "" + +msgid "" +"This function cannot fail, and the caller does not need to hold " +"the :term:`GIL`." +msgstr "" + +msgid ":py:func:`threading.get_ident`" +msgstr "" + +msgid "" +"Get general information about the current thread in the form of " +"a :ref:`struct sequence ` object. This information " +"is accessible as :py:attr:`sys.thread_info` in Python." +msgstr "" + +msgid "" +"On success, this returns a new :term:`strong reference` to the thread " +"information; on failure, this returns ``NULL`` with an exception set." +msgstr "" + +msgid "This macro is defined when the system supports native thread IDs." +msgstr "" + +msgid "" +"Get the native identifier of the current thread as it was assigned by the " +"operating system's kernel, which will never be less than zero." +msgstr "" + +msgid "" +"This function is only available when :c:macro:`PY_HAVE_THREAD_NATIVE_ID` is " +"defined." +msgstr "" + +msgid ":py:func:`threading.get_native_id`" +msgstr "" + +msgid "" +"Terminate the current thread. This function is generally considered unsafe " +"and should be avoided. It is kept solely for backwards compatibility." +msgstr "" + +msgid "" +"This function is only safe to call if all functions in the full call stack " +"are written to safely allow it." +msgstr "" + +msgid "" +"If the current system uses POSIX threads (also known as \"pthreads\"), this " +"calls :manpage:`pthread_exit(3)`, which attempts to unwind the stack and " +"call C++ destructors on some libc implementations. However, if a " +"``noexcept`` function is reached, it may terminate the process. Other " +"systems, such as macOS, do unwinding." +msgstr "" + +msgid "" +"On Windows, this function calls ``_endthreadex()``, which kills the thread " +"without calling C++ destructors." +msgstr "" + +msgid "In any case, there is a risk of corruption on the thread's stack." +msgstr "" + +msgid "" +"Initialize ``PyThread*`` APIs. Python executes this function automatically, " +"so there's little need to call it from an extension module." +msgstr "" + +msgid "Set the stack size of the current thread to *size* bytes." +msgstr "" + +msgid "" +"This function returns ``0`` on success, ``-1`` if *size* is invalid, or " +"``-2`` if the system does not support changing the stack size. This function " +"does not set exceptions." +msgstr "" + +msgid "" +"Return the stack size of the current thread in bytes, or ``0`` if the " +"system's default stack size is in use." +msgstr "" + msgid "PyEval_InitThreads()" msgstr "" diff --git a/c-api/init_config.po b/c-api/init_config.po index 79c96df816..042bf3ab44 100644 --- a/c-api/init_config.po +++ b/c-api/init_config.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 -# Rafael Fontenelle , 2024 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Rafael Fontenelle , 2024\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -25,12 +25,12 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Python Initialization Configuration" -msgstr "" +msgstr "Konfiguracja inicjalizacji Pythona" msgid "" -"Python can be initialized with :c:func:`Py_InitializeFromConfig` and the :c:" -"type:`PyConfig` structure. It can be preinitialized with :c:func:" -"`Py_PreInitialize` and the :c:type:`PyPreConfig` structure." +"Python can be initialized with :c:func:`Py_InitializeFromConfig` and " +"the :c:type:`PyConfig` structure. It can be preinitialized " +"with :c:func:`Py_PreInitialize` and the :c:type:`PyPreConfig` structure." msgstr "" msgid "There are two kinds of configuration:" @@ -54,10 +54,14 @@ msgid "" "The :c:func:`Py_RunMain` function can be used to write a customized Python " "program." msgstr "" +"Funkcja ta może być użyta do napisania dostosowanego programu w języku " +"Python.:c:func:`Py_RunMain`" msgid "" "See also :ref:`Initialization, Finalization, and Threads `." msgstr "" +"Funkcja ta może być używana do pisania spersonalizowanego programu w języku " +"Python." msgid ":pep:`587` \"Python Initialization Configuration\"." msgstr "" @@ -271,8 +275,8 @@ msgid "``PYMEM_ALLOCATOR_MALLOC`` (``3``): use ``malloc()`` of the C library." msgstr "" msgid "" -"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` with :" -"ref:`debug hooks `." +"``PYMEM_ALLOCATOR_MALLOC_DEBUG`` (``4``): force usage of ``malloc()`` " +"with :ref:`debug hooks `." msgstr "" msgid "" @@ -317,8 +321,8 @@ msgid "Set the LC_CTYPE locale to the user preferred locale." msgstr "" msgid "" -"If equals to ``0``, set :c:member:`~PyPreConfig.coerce_c_locale` and :c:" -"member:`~PyPreConfig.coerce_c_locale_warn` members to ``0``." +"If equals to ``0``, set :c:member:`~PyPreConfig.coerce_c_locale` " +"and :c:member:`~PyPreConfig.coerce_c_locale_warn` members to ``0``." msgstr "" msgid "See the :term:`locale encoding`." @@ -380,15 +384,15 @@ msgid "Default: ``0``." msgstr "" msgid "" -"If non-zero, :c:func:`Py_PreInitializeFromArgs` and :c:func:" -"`Py_PreInitializeFromBytesArgs` parse their ``argv`` argument the same way " -"the regular Python parses command line arguments: see :ref:`Command Line " -"Arguments `." +"If non-zero, :c:func:`Py_PreInitializeFromArgs` " +"and :c:func:`Py_PreInitializeFromBytesArgs` parse their ``argv`` argument " +"the same way the regular Python parses command line arguments: " +"see :ref:`Command Line Arguments `." msgstr "" msgid "" -"Use :ref:`environment variables `? See :c:member:`PyConfig." -"use_environment`." +"Use :ref:`environment variables `? " +"See :c:member:`PyConfig.use_environment`." msgstr "" msgid "Default: ``1`` in Python config and ``0`` in isolated config." @@ -421,8 +425,8 @@ msgid "Configure the LC_CTYPE locale (:term:`locale encoding`)" msgstr "" msgid "" -"Set the :ref:`Python UTF-8 Mode ` (:c:member:`PyPreConfig." -"utf8_mode`)" +"Set the :ref:`Python UTF-8 Mode ` " +"(:c:member:`PyPreConfig.utf8_mode`)" msgstr "" msgid "" @@ -440,34 +444,34 @@ msgid "*preconfig* must not be ``NULL``." msgstr "" msgid "" -"Parse *argv* command line arguments (bytes strings) if :c:member:" -"`~PyPreConfig.parse_argv` of *preconfig* is non-zero." +"Parse *argv* command line arguments (bytes strings) " +"if :c:member:`~PyPreConfig.parse_argv` of *preconfig* is non-zero." msgstr "" msgid "" -"Parse *argv* command line arguments (wide strings) if :c:member:" -"`~PyPreConfig.parse_argv` of *preconfig* is non-zero." +"Parse *argv* command line arguments (wide strings) " +"if :c:member:`~PyPreConfig.parse_argv` of *preconfig* is non-zero." msgstr "" msgid "" -"The caller is responsible to handle exceptions (error or exit) using :c:func:" -"`PyStatus_Exception` and :c:func:`Py_ExitStatusException`." +"The caller is responsible to handle exceptions (error or exit) " +"using :c:func:`PyStatus_Exception` and :c:func:`Py_ExitStatusException`." msgstr "" msgid "" -"For :ref:`Python Configuration ` (:c:func:" -"`PyPreConfig_InitPythonConfig`), if Python is initialized with command line " -"arguments, the command line arguments must also be passed to preinitialize " -"Python, since they have an effect on the pre-configuration like encodings. " -"For example, the :option:`-X utf8 <-X>` command line option enables the :ref:" -"`Python UTF-8 Mode `." +"For :ref:`Python Configuration ` " +"(:c:func:`PyPreConfig_InitPythonConfig`), if Python is initialized with " +"command line arguments, the command line arguments must also be passed to " +"preinitialize Python, since they have an effect on the pre-configuration " +"like encodings. For example, the :option:`-X utf8 <-X>` command line option " +"enables the :ref:`Python UTF-8 Mode `." msgstr "" msgid "" "``PyMem_SetAllocator()`` can be called after :c:func:`Py_PreInitialize` and " "before :c:func:`Py_InitializeFromConfig` to install a custom memory " -"allocator. It can be called before :c:func:`Py_PreInitialize` if :c:member:" -"`PyPreConfig.allocator` is set to ``PYMEM_ALLOCATOR_NOT_SET``." +"allocator. It can be called before :c:func:`Py_PreInitialize` " +"if :c:member:`PyPreConfig.allocator` is set to ``PYMEM_ALLOCATOR_NOT_SET``." msgstr "" msgid "" @@ -543,8 +547,8 @@ msgstr "" msgid "" "Set command line arguments (:c:member:`~PyConfig.argv` member of *config*) " -"from the *argv* list of bytes strings. Decode bytes using :c:func:" -"`Py_DecodeLocale`." +"from the *argv* list of bytes strings. Decode bytes " +"using :c:func:`Py_DecodeLocale`." msgstr "" msgid "Set the list of wide strings *list* to *length* and *items*." @@ -564,15 +568,16 @@ msgstr "" msgid "" "The :c:func:`PyConfig_Read` function only parses :c:member:`PyConfig.argv` " "arguments once: :c:member:`PyConfig.parse_argv` is set to ``2`` after " -"arguments are parsed. Since Python arguments are stripped from :c:member:" -"`PyConfig.argv`, parsing arguments twice would parse the application options " -"as Python options." +"arguments are parsed. Since Python arguments are stripped " +"from :c:member:`PyConfig.argv`, parsing arguments twice would parse the " +"application options as Python options." msgstr "" msgid "" -"The :c:member:`PyConfig.argv` arguments are now only parsed once, :c:member:" -"`PyConfig.parse_argv` is set to ``2`` after arguments are parsed, and " -"arguments are only parsed if :c:member:`PyConfig.parse_argv` equals ``1``." +"The :c:member:`PyConfig.argv` arguments are now only parsed " +"once, :c:member:`PyConfig.parse_argv` is set to ``2`` after arguments are " +"parsed, and arguments are only parsed if :c:member:`PyConfig.parse_argv` " +"equals ``1``." msgstr "" msgid "" @@ -586,10 +591,10 @@ msgstr "" msgid "" "Most ``PyConfig`` methods :ref:`preinitialize Python ` if needed. " -"In that case, the Python preinitialization configuration (:c:type:" -"`PyPreConfig`) in based on the :c:type:`PyConfig`. If configuration fields " -"which are in common with :c:type:`PyPreConfig` are tuned, they must be set " -"before calling a :c:type:`PyConfig` method:" +"In that case, the Python preinitialization configuration " +"(:c:type:`PyPreConfig`) is based on the :c:type:`PyConfig`. If configuration " +"fields which are in common with :c:type:`PyPreConfig` are tuned, they must " +"be set before calling a :c:type:`PyConfig` method:" msgstr "" msgid ":c:member:`PyConfig.dev_mode`" @@ -607,8 +612,8 @@ msgstr ":c:member:`PyConfig.use_environment`" msgid "" "Moreover, if :c:func:`PyConfig_SetArgv` or :c:func:`PyConfig_SetBytesArgv` " "is used, this method must be called before other methods, since the " -"preinitialization configuration depends on command line arguments (if :c:" -"member:`~PyConfig.parse_argv` is non-zero)." +"preinitialization configuration depends on command line arguments " +"(if :c:member:`~PyConfig.parse_argv` is non-zero)." msgstr "" msgid "" @@ -617,18 +622,20 @@ msgid "" msgstr "" msgid "" -"Set :data:`sys.argv` command line arguments based on :c:member:`~PyConfig." -"argv`. These parameters are similar to those passed to the program's :c:" -"func:`main` function with the difference that the first entry should refer " -"to the script file to be executed rather than the executable hosting the " -"Python interpreter. If there isn't a script that will be run, the first " -"entry in :c:member:`~PyConfig.argv` can be an empty string." +"Set :data:`sys.argv` command line arguments based " +"on :c:member:`~PyConfig.argv`. These parameters are similar to those passed " +"to the program's :c:func:`main` function with the difference that the first " +"entry should refer to the script file to be executed rather than the " +"executable hosting the Python interpreter. If there isn't a script that " +"will be run, the first entry in :c:member:`~PyConfig.argv` can be an empty " +"string." msgstr "" msgid "" -"Set :c:member:`~PyConfig.parse_argv` to ``1`` to parse :c:member:`~PyConfig." -"argv` the same way the regular Python parses Python command line arguments " -"and then to strip Python arguments from :c:member:`~PyConfig.argv`." +"Set :c:member:`~PyConfig.parse_argv` to ``1`` to " +"parse :c:member:`~PyConfig.argv` the same way the regular Python parses " +"Python command line arguments and then to strip Python arguments " +"from :c:member:`~PyConfig.argv`." msgstr "" msgid "" @@ -643,8 +650,8 @@ msgid "See also the :c:member:`~PyConfig.orig_argv` member." msgstr "" msgid "" -"If equals to zero, ``Py_RunMain()`` prepends a potentially unsafe path to :" -"data:`sys.path` at startup:" +"If equals to zero, ``Py_RunMain()`` prepends a potentially unsafe path " +"to :data:`sys.path` at startup:" msgstr "" msgid "" @@ -663,8 +670,8 @@ msgid "" msgstr "" msgid "" -"Set to ``1`` by the :option:`-P` command line option and the :envvar:" -"`PYTHONSAFEPATH` environment variable." +"Set to ``1`` by the :option:`-P` command line option and " +"the :envvar:`PYTHONSAFEPATH` environment variable." msgstr "" msgid "Default: ``0`` in Python config, ``1`` in isolated config." @@ -679,10 +686,10 @@ msgstr "" msgid "See also :c:member:`PyConfig.exec_prefix`." msgstr "" -msgid "Python base executable: :data:`sys._base_executable`." +msgid "Python base executable: ``sys._base_executable``." msgstr "" -msgid "Set by the :envvar:`__PYVENV_LAUNCHER__` environment variable." +msgid "Set by the ``__PYVENV_LAUNCHER__`` environment variable." msgstr "" msgid "Set from :c:member:`PyConfig.executable` if ``NULL``." @@ -703,8 +710,8 @@ msgid "" msgstr "" msgid "" -"Set to ``0`` by the :option:`-u` command line option and the :envvar:" -"`PYTHONUNBUFFERED` environment variable." +"Set to ``0`` by the :option:`-u` command line option and " +"the :envvar:`PYTHONUNBUFFERED` environment variable." msgstr "" msgid "stdin is always opened in buffered mode." @@ -714,8 +721,9 @@ msgid "Default: ``1``." msgstr "Domyślny: ``1``." msgid "" -"If equals to ``1``, issue a warning when comparing :class:`bytes` or :class:" -"`bytearray` with :class:`str`, or comparing :class:`bytes` with :class:`int`." +"If equals to ``1``, issue a warning when comparing :class:`bytes` " +"or :class:`bytearray` with :class:`str`, or comparing :class:`bytes` " +"with :class:`int`." msgstr "" msgid "" @@ -727,9 +735,9 @@ msgid "Incremented by the :option:`-b` command line option." msgstr "" msgid "" -"If non-zero, emit a :exc:`EncodingWarning` warning when :class:`io." -"TextIOWrapper` uses its default encoding. See :ref:`io-encoding-warning` for " -"details." +"If non-zero, emit a :exc:`EncodingWarning` warning " +"when :class:`io.TextIOWrapper` uses its default encoding. See :ref:`io-" +"encoding-warning` for details." msgstr "" msgid "" @@ -744,8 +752,8 @@ msgid "" msgstr "" msgid "" -"Control the validation behavior of hash-based ``.pyc`` files: value of the :" -"option:`--check-hash-based-pycs` command line option." +"Control the validation behavior of hash-based ``.pyc`` files: value of " +"the :option:`--check-hash-based-pycs` command line option." msgstr "" msgid "Valid values:" @@ -791,8 +799,8 @@ msgid "If non-zero, enable the :ref:`Python Development Mode `." msgstr "" msgid "" -"Set to ``1`` by the :option:`-X dev <-X>` option and the :envvar:" -"`PYTHONDEVMODE` environment variable." +"Set to ``1`` by the :option:`-X dev <-X>` option and " +"the :envvar:`PYTHONDEVMODE` environment variable." msgstr "" msgid "Dump Python references?" @@ -818,8 +826,8 @@ msgid "See also :c:member:`PyConfig.base_exec_prefix`." msgstr "" msgid "" -"The absolute path of the executable binary for the Python interpreter: :data:" -"`sys.executable`." +"The absolute path of the executable binary for the Python " +"interpreter: :data:`sys.executable`." msgstr "" msgid "See also :c:member:`PyConfig.base_executable`." @@ -832,22 +840,22 @@ msgid "If non-zero, call :func:`faulthandler.enable` at startup." msgstr "" msgid "" -"Set to ``1`` by :option:`-X faulthandler <-X>` and the :envvar:" -"`PYTHONFAULTHANDLER` environment variable." +"Set to ``1`` by :option:`-X faulthandler <-X>` and " +"the :envvar:`PYTHONFAULTHANDLER` environment variable." msgstr "" msgid "" -":term:`Filesystem encoding `: :func:" -"`sys.getfilesystemencoding`." +":term:`Filesystem encoding `: :func:`sys.getfilesystemencoding`." msgstr "" msgid "On macOS, Android and VxWorks: use ``\"utf-8\"`` by default." msgstr "" msgid "" -"On Windows: use ``\"utf-8\"`` by default, or ``\"mbcs\"`` if :c:member:" -"`~PyPreConfig.legacy_windows_fs_encoding` of :c:type:`PyPreConfig` is non-" -"zero." +"On Windows: use ``\"utf-8\"`` by default, or ``\"mbcs\"`` " +"if :c:member:`~PyPreConfig.legacy_windows_fs_encoding` " +"of :c:type:`PyPreConfig` is non-zero." msgstr "" msgid "Default encoding on other platforms:" @@ -878,14 +886,14 @@ msgid "See also the :c:member:`~PyConfig.filesystem_errors` member." msgstr "" msgid "" -":term:`Filesystem error handler `: :" -"func:`sys.getfilesystemencodeerrors`." +":term:`Filesystem error handler `: :func:`sys.getfilesystemencodeerrors`." msgstr "" msgid "" -"On Windows: use ``\"surrogatepass\"`` by default, or ``\"replace\"`` if :c:" -"member:`~PyPreConfig.legacy_windows_fs_encoding` of :c:type:`PyPreConfig` is " -"non-zero." +"On Windows: use ``\"surrogatepass\"`` by default, or ``\"replace\"`` " +"if :c:member:`~PyPreConfig.legacy_windows_fs_encoding` " +"of :c:type:`PyPreConfig` is non-zero." msgstr "" msgid "On other platforms: use ``\"surrogateescape\"`` by default." @@ -936,8 +944,8 @@ msgid "If non-zero, profile import time." msgstr "" msgid "" -"Set the ``1`` by the :option:`-X importtime <-X>` option and the :envvar:" -"`PYTHONPROFILEIMPORTTIME` environment variable." +"Set the ``1`` by the :option:`-X importtime <-X>` option and " +"the :envvar:`PYTHONPROFILEIMPORTTIME` environment variable." msgstr "" msgid "Enter interactive mode after executing a script or a command." @@ -951,8 +959,8 @@ msgid "" msgstr "" msgid "" -"Incremented by the :option:`-i` command line option. Set to ``1`` if the :" -"envvar:`PYTHONINSPECT` environment variable is non-empty." +"Incremented by the :option:`-i` command line option. Set to ``1`` if " +"the :envvar:`PYTHONINSPECT` environment variable is non-empty." msgstr "" msgid "Install Python signal handlers?" @@ -970,10 +978,11 @@ msgstr "" msgid "" "Configures the :ref:`integer string conversion length limitation " "`. An initial value of ``-1`` means the value will be " -"taken from the command line or environment or otherwise default to 4300 (:" -"data:`sys.int_info.default_max_str_digits`). A value of ``0`` disables the " -"limitation. Values greater than zero but less than 640 (:data:`sys.int_info." -"str_digits_check_threshold`) are unsupported and will produce an error." +"taken from the command line or environment or otherwise default to 4300 " +"(:data:`sys.int_info.default_max_str_digits`). A value of ``0`` disables " +"the limitation. Values greater than zero but less than 640 " +"(:data:`sys.int_info.str_digits_check_threshold`) are unsupported and will " +"produce an error." msgstr "" msgid "" @@ -982,19 +991,20 @@ msgid "" msgstr "" msgid "" -"Default: ``-1`` in Python mode. 4300 (:data:`sys.int_info." -"default_max_str_digits`) in isolated mode." +"Default: ``-1`` in Python mode. 4300 " +"(:data:`sys.int_info.default_max_str_digits`) in isolated mode." msgstr "" msgid "" "If the value of :c:member:`~PyConfig.cpu_count` is not ``-1`` then it will " -"override the return values of :func:`os.cpu_count`, :func:`os." -"process_cpu_count`, and :func:`multiprocessing.cpu_count`." +"override the return values " +"of :func:`os.cpu_count`, :func:`os.process_cpu_count`, " +"and :func:`multiprocessing.cpu_count`." msgstr "" msgid "" -"Configured by the :samp:`-X cpu_count={n|default}` command line flag or the :" -"envvar:`PYTHON_CPU_COUNT` environment variable." +"Configured by the :samp:`-X cpu_count={n|default}` command line flag or " +"the :envvar:`PYTHON_CPU_COUNT` environment variable." msgstr "" msgid "Default: ``-1``." @@ -1028,14 +1038,14 @@ msgid "Set to ``1`` by the :option:`-I` command line option." msgstr "" msgid "" -"See also the :ref:`Isolated Configuration ` and :c:" -"member:`PyPreConfig.isolated`." +"See also the :ref:`Isolated Configuration ` " +"and :c:member:`PyPreConfig.isolated`." msgstr "" msgid "" -"If non-zero, use :class:`io.FileIO` instead of :class:`!io." -"_WindowsConsoleIO` for :data:`sys.stdin`, :data:`sys.stdout` and :data:`sys." -"stderr`." +"If non-zero, use :class:`io.FileIO` instead of :class:`!" +"io._WindowsConsoleIO` for :data:`sys.stdin`, :data:`sys.stdout` " +"and :data:`sys.stderr`." msgstr "" msgid "" @@ -1066,9 +1076,9 @@ msgid "Set by the :envvar:`PYTHONPLATLIBDIR` environment variable." msgstr "" msgid "" -"Default: value of the ``PLATLIBDIR`` macro which is set by the :option:" -"`configure --with-platlibdir option <--with-platlibdir>` (default: " -"``\"lib\"``, or ``\"DLLs\"`` on Windows)." +"Default: value of the ``PLATLIBDIR`` macro which is set by " +"the :option:`configure --with-platlibdir option <--with-platlibdir>` " +"(default: ``\"lib\"``, or ``\"DLLs\"`` on Windows)." msgstr "" msgid "" @@ -1079,8 +1089,8 @@ msgid "" msgstr "" msgid "" -"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` (:" -"data:`os.pathsep`)." +"Module search paths (:data:`sys.path`) as a string separated by ``DELIM`` " +"(:data:`os.pathsep`)." msgstr "" msgid "Set by the :envvar:`PYTHONPATH` environment variable." @@ -1090,10 +1100,10 @@ msgid "Module search paths: :data:`sys.path`." msgstr "" msgid "" -"If :c:member:`~PyConfig.module_search_paths_set` is equal to ``0``, :c:func:" -"`Py_InitializeFromConfig` will replace :c:member:`~PyConfig." -"module_search_paths` and sets :c:member:`~PyConfig.module_search_paths_set` " -"to ``1``." +"If :c:member:`~PyConfig.module_search_paths_set` is equal to " +"``0``, :c:func:`Py_InitializeFromConfig` will " +"replace :c:member:`~PyConfig.module_search_paths` and " +"sets :c:member:`~PyConfig.module_search_paths_set` to ``1``." msgstr "" msgid "" @@ -1114,8 +1124,8 @@ msgid "``2``: Level 1, strip docstrings." msgstr "" msgid "" -"Incremented by the :option:`-O` command line option. Set to the :envvar:" -"`PYTHONOPTIMIZE` environment variable value." +"Incremented by the :option:`-O` command line option. Set to " +"the :envvar:`PYTHONOPTIMIZE` environment variable value." msgstr "" msgid "" @@ -1124,16 +1134,17 @@ msgid "" msgstr "" msgid "" -"If :c:member:`~PyConfig.orig_argv` list is empty and :c:member:`~PyConfig." -"argv` is not a list only containing an empty string, :c:func:`PyConfig_Read` " -"copies :c:member:`~PyConfig.argv` into :c:member:`~PyConfig.orig_argv` " -"before modifying :c:member:`~PyConfig.argv` (if :c:member:`~PyConfig." -"parse_argv` is non-zero)." +"If :c:member:`~PyConfig.orig_argv` list is empty " +"and :c:member:`~PyConfig.argv` is not a list only containing an empty " +"string, :c:func:`PyConfig_Read` copies :c:member:`~PyConfig.argv` " +"into :c:member:`~PyConfig.orig_argv` before " +"modifying :c:member:`~PyConfig.argv` (if :c:member:`~PyConfig.parse_argv` is " +"non-zero)." msgstr "" msgid "" -"See also the :c:member:`~PyConfig.argv` member and the :c:func:" -"`Py_GetArgcArgv` function." +"See also the :c:member:`~PyConfig.argv` member and " +"the :c:func:`Py_GetArgcArgv` function." msgstr "" msgid "Default: empty list." @@ -1149,8 +1160,8 @@ msgid "" msgstr "" msgid "" -"The :c:member:`PyConfig.argv` arguments are now only parsed if :c:member:" -"`PyConfig.parse_argv` equals to ``1``." +"The :c:member:`PyConfig.argv` arguments are now only parsed " +"if :c:member:`PyConfig.parse_argv` equals to ``1``." msgstr "" msgid "" @@ -1159,8 +1170,8 @@ msgid "" msgstr "" msgid "" -"Incremented by the :option:`-d` command line option. Set to the :envvar:" -"`PYTHONDEBUG` environment variable value." +"Incremented by the :option:`-d` command line option. Set to " +"the :envvar:`PYTHONDEBUG` environment variable value." msgstr "" msgid "" @@ -1193,8 +1204,8 @@ msgid "On macOS, use :envvar:`PYTHONEXECUTABLE` environment variable if set." msgstr "" msgid "" -"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use :envvar:" -"`__PYVENV_LAUNCHER__` environment variable if set." +"If the ``WITH_NEXT_FRAMEWORK`` macro is defined, use ``__PYVENV_LAUNCHER__`` " +"environment variable if set." msgstr "" msgid "" @@ -1207,8 +1218,8 @@ msgid "" msgstr "" msgid "" -"Directory where cached ``.pyc`` files are written: :data:`sys." -"pycache_prefix`." +"Directory where cached ``.pyc`` files are " +"written: :data:`sys.pycache_prefix`." msgstr "" msgid "" @@ -1235,8 +1246,9 @@ msgid "Used by :c:func:`Py_RunMain`." msgstr "" msgid "" -"Filename passed on the command line: trailing command line argument without :" -"option:`-c` or :option:`-m`. It is used by the :c:func:`Py_RunMain` function." +"Filename passed on the command line: trailing command line argument " +"without :option:`-c` or :option:`-m`. It is used by the :c:func:`Py_RunMain` " +"function." msgstr "" msgid "" @@ -1290,8 +1302,8 @@ msgid "Set to ``0`` by the :option:`-S` command line option." msgstr "" msgid "" -":data:`sys.flags.no_site ` is set to the inverted value of :c:" -"member:`~PyConfig.site_import`." +":data:`sys.flags.no_site ` is set to the inverted value " +"of :c:member:`~PyConfig.site_import`." msgstr "" msgid "" @@ -1308,8 +1320,8 @@ msgid "Set to ``1`` by the :option:`-x` command line option." msgstr "" msgid "" -"Encoding and encoding errors of :data:`sys.stdin`, :data:`sys.stdout` and :" -"data:`sys.stderr` (but :data:`sys.stderr` always uses " +"Encoding and encoding errors of :data:`sys.stdin`, :data:`sys.stdout` " +"and :data:`sys.stderr` (but :data:`sys.stderr` always uses " "``\"backslashreplace\"`` error handler)." msgstr "" @@ -1350,8 +1362,8 @@ msgid "If non-zero, call :func:`tracemalloc.start` at startup." msgstr "" msgid "" -"Set by :option:`-X tracemalloc=N <-X>` command line option and by the :" -"envvar:`PYTHONTRACEMALLOC` environment variable." +"Set by :option:`-X tracemalloc=N <-X>` command line option and by " +"the :envvar:`PYTHONTRACEMALLOC` environment variable." msgstr "" msgid "Enable compatibility mode with the perf profiler?" @@ -1363,11 +1375,11 @@ msgid "" msgstr "" msgid "" -"Set by :option:`-X perf <-X>` command-line option and by the :envvar:" -"`PYTHON_PERF_JIT_SUPPORT` environment variable for perf support with stack " -"pointers and :option:`-X perf_jit <-X>` command-line option and by the :" -"envvar:`PYTHON_PERF_JIT_SUPPORT` environment variable for perf support with " -"DWARF JIT information." +"Set by :option:`-X perf <-X>` command-line option and by " +"the :envvar:`PYTHON_PERF_JIT_SUPPORT` environment variable for perf support " +"with stack pointers and :option:`-X perf_jit <-X>` command-line option and " +"by the :envvar:`PYTHON_PERF_JIT_SUPPORT` environment variable for perf " +"support with DWARF JIT information." msgstr "" msgid "Use :ref:`environment variables `?" @@ -1416,18 +1428,18 @@ msgstr "" msgid "" "The :mod:`warnings` module adds :data:`sys.warnoptions` in the reverse " "order: the last :c:member:`PyConfig.warnoptions` item becomes the first item " -"of :data:`warnings.filters` which is checked first (highest priority)." +"of ``warnings.filters`` which is checked first (highest priority)." msgstr "" msgid "" -"The :option:`-W` command line options adds its value to :c:member:`~PyConfig." -"warnoptions`, it can be used multiple times." +"The :option:`-W` command line options adds its value " +"to :c:member:`~PyConfig.warnoptions`, it can be used multiple times." msgstr "" msgid "" "The :envvar:`PYTHONWARNINGS` environment variable can also be used to add " -"warning options. Multiple options can be specified, separated by commas (``," -"``)." +"warning options. Multiple options can be specified, separated by commas " +"(``,``)." msgstr "" msgid "" @@ -1436,13 +1448,13 @@ msgid "" msgstr "" msgid "" -"Set to ``0`` by the :option:`-B` command line option and the :envvar:" -"`PYTHONDONTWRITEBYTECODE` environment variable." +"Set to ``0`` by the :option:`-B` command line option and " +"the :envvar:`PYTHONDONTWRITEBYTECODE` environment variable." msgstr "" msgid "" -":data:`sys.dont_write_bytecode` is initialized to the inverted value of :c:" -"member:`~PyConfig.write_bytecode`." +":data:`sys.dont_write_bytecode` is initialized to the inverted value " +"of :c:member:`~PyConfig.write_bytecode`." msgstr "" msgid "Values of the :option:`-X` command line options: :data:`sys._xoptions`." @@ -1451,8 +1463,8 @@ msgstr "" msgid "" "If :c:member:`~PyConfig.parse_argv` is non-zero, :c:member:`~PyConfig.argv` " "arguments are parsed the same way the regular Python parses :ref:`command " -"line arguments `, and Python arguments are stripped from :" -"c:member:`~PyConfig.argv`." +"line arguments `, and Python arguments are stripped " +"from :c:member:`~PyConfig.argv`." msgstr "" msgid "" @@ -1472,11 +1484,12 @@ msgid "" msgstr "" msgid "" -"If :c:func:`PyImport_FrozenModules`, :c:func:`PyImport_AppendInittab` or :c:" -"func:`PyImport_ExtendInittab` are used, they must be set or called after " -"Python preinitialization and before the Python initialization. If Python is " -"initialized multiple times, :c:func:`PyImport_AppendInittab` or :c:func:" -"`PyImport_ExtendInittab` must be called before each Python initialization." +"If :c:func:`PyImport_FrozenModules`, :c:func:`PyImport_AppendInittab` " +"or :c:func:`PyImport_ExtendInittab` are used, they must be set or called " +"after Python preinitialization and before the Python initialization. If " +"Python is initialized multiple times, :c:func:`PyImport_AppendInittab` " +"or :c:func:`PyImport_ExtendInittab` must be called before each Python " +"initialization." msgstr "" msgid "" @@ -1581,9 +1594,10 @@ msgid "Isolated Configuration" msgstr "" msgid "" -":c:func:`PyPreConfig_InitIsolatedConfig` and :c:func:" -"`PyConfig_InitIsolatedConfig` functions create a configuration to isolate " -"Python from the system. For example, to embed Python into an application." +":c:func:`PyPreConfig_InitIsolatedConfig` " +"and :c:func:`PyConfig_InitIsolatedConfig` functions create a configuration " +"to isolate Python from the system. For example, to embed Python into an " +"application." msgstr "" msgid "" @@ -1603,9 +1617,9 @@ msgid "Python Configuration" msgstr "" msgid "" -":c:func:`PyPreConfig_InitPythonConfig` and :c:func:" -"`PyConfig_InitPythonConfig` functions create a configuration to build a " -"customized Python which behaves as the regular Python." +":c:func:`PyPreConfig_InitPythonConfig` " +"and :c:func:`PyConfig_InitPythonConfig` functions create a configuration to " +"build a customized Python which behaves as the regular Python." msgstr "" msgid "" @@ -1615,8 +1629,9 @@ msgstr "" msgid "" "This function enables C locale coercion (:pep:`538`) and :ref:`Python UTF-8 " -"Mode ` (:pep:`540`) depending on the LC_CTYPE locale, :envvar:" -"`PYTHONUTF8` and :envvar:`PYTHONCOERCECLOCALE` environment variables." +"Mode ` (:pep:`540`) depending on the LC_CTYPE " +"locale, :envvar:`PYTHONUTF8` and :envvar:`PYTHONCOERCECLOCALE` environment " +"variables." msgstr "" msgid "Python Path Configuration" @@ -1647,8 +1662,8 @@ msgid "current working directory: to get absolute paths" msgstr "" msgid "" -"``PATH`` environment variable to get the program full path (from :c:member:" -"`PyConfig.program_name`)" +"``PATH`` environment variable to get the program full path " +"(from :c:member:`PyConfig.program_name`)" msgstr "" msgid "``__PYVENV_LAUNCHER__`` environment variable" @@ -1678,22 +1693,18 @@ msgstr ":c:member:`PyConfig.exec_prefix`" msgid ":c:member:`PyConfig.executable`" msgstr ":c:member:`PyConfig.executable`" -msgid "" -":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig." -"module_search_paths`" -msgstr "" -":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig." -"module_search_paths`" +msgid ":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig.module_search_paths`" +msgstr ":c:member:`PyConfig.module_search_paths_set`, :c:member:`PyConfig.module_search_paths`" msgid ":c:member:`PyConfig.prefix`" msgstr ":c:member:`PyConfig.prefix`" msgid "" "If at least one \"output field\" is not set, Python calculates the path " -"configuration to fill unset fields. If :c:member:`~PyConfig." -"module_search_paths_set` is equal to ``0``, :c:member:`~PyConfig." -"module_search_paths` is overridden and :c:member:`~PyConfig." -"module_search_paths_set` is set to ``1``." +"configuration to fill unset fields. " +"If :c:member:`~PyConfig.module_search_paths_set` is equal to " +"``0``, :c:member:`~PyConfig.module_search_paths` is overridden " +"and :c:member:`~PyConfig.module_search_paths_set` is set to ``1``." msgstr "" msgid "" @@ -1712,9 +1723,10 @@ msgid "" msgstr "" msgid "" -"If :c:member:`~PyConfig.base_prefix` or :c:member:`~PyConfig." -"base_exec_prefix` fields are not set, they inherit their value from :c:" -"member:`~PyConfig.prefix` and :c:member:`~PyConfig.exec_prefix` respectively." +"If :c:member:`~PyConfig.base_prefix` " +"or :c:member:`~PyConfig.base_exec_prefix` fields are not set, they inherit " +"their value from :c:member:`~PyConfig.prefix` " +"and :c:member:`~PyConfig.exec_prefix` respectively." msgstr "" msgid ":c:func:`Py_RunMain` and :c:func:`Py_Main` modify :data:`sys.path`:" @@ -1722,8 +1734,8 @@ msgstr "" msgid "" "If :c:member:`~PyConfig.run_filename` is set and is a directory which " -"contains a ``__main__.py`` script, prepend :c:member:`~PyConfig." -"run_filename` to :data:`sys.path`." +"contains a ``__main__.py`` script, " +"prepend :c:member:`~PyConfig.run_filename` to :data:`sys.path`." msgstr "" msgid "If :c:member:`~PyConfig.isolated` is zero:" @@ -1744,10 +1756,10 @@ msgstr "" msgid "" "If :c:member:`~PyConfig.site_import` is non-zero, :data:`sys.path` can be " -"modified by the :mod:`site` module. If :c:member:`~PyConfig." -"user_site_directory` is non-zero and the user's site-package directory " -"exists, the :mod:`site` module appends the user's site-package directory to :" -"data:`sys.path`." +"modified by the :mod:`site` module. " +"If :c:member:`~PyConfig.user_site_directory` is non-zero and the user's site-" +"package directory exists, the :mod:`site` module appends the user's site-" +"package directory to :data:`sys.path`." msgstr "" msgid "The following configuration files are used by the path configuration:" @@ -1778,8 +1790,8 @@ msgid "Set :c:member:`~PyConfig.safe_path` to ``1``." msgstr "" msgid "" -"The ``__PYVENV_LAUNCHER__`` environment variable is used to set :c:member:" -"`PyConfig.base_executable`." +"The ``__PYVENV_LAUNCHER__`` environment variable is used to " +"set :c:member:`PyConfig.base_executable`." msgstr "" msgid "Py_GetArgcArgv()" @@ -1829,8 +1841,8 @@ msgid "Install signal handlers;" msgstr "" msgid "" -"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` and :" -"data:`sys.path`);" +"Finish :mod:`sys` module initialization (ex: create :data:`sys.stdout` " +"and :data:`sys.path`);" msgstr "" msgid "" @@ -1847,8 +1859,8 @@ msgid "Private provisional API:" msgstr "" msgid "" -":c:member:`PyConfig._init_main`: if set to ``0``, :c:func:" -"`Py_InitializeFromConfig` stops at the \"Core\" initialization phase." +"``PyConfig._init_main``: if set to ``0``, :c:func:`Py_InitializeFromConfig` " +"stops at the \"Core\" initialization phase." msgstr "" msgid "" diff --git a/c-api/intro.po b/c-api/intro.po index bd0e671f35..59ffdd012a 100644 --- a/c-api/intro.po +++ b/c-api/intro.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +34,8 @@ msgid "" "API. The first reason is to write *extension modules* for specific purposes; " "these are C modules that extend the Python interpreter. This is probably " "the most common use. The second reason is to use Python as a component in a " -"larger application; this technique is generally referred to as :dfn:" -"`embedding` Python in an application." +"larger application; this technique is generally referred to " +"as :dfn:`embedding` Python in an application." msgstr "" "Interfejs programowania aplikacji w Pythonie daje programistom języków C i C+" "+ dostęp do programu interpretującego polecenia języka pytonowskiego na " @@ -50,8 +46,8 @@ msgstr "" "pisanie *modułów rozszerzających* dla szczególnych powodów; są to moduły " "języka C, które rozszerzają interpreter Pythona. To jest zwykle najczęstsze " "użycie. Drugą przyczyną jest użycie Pythona jako komponentu większego " -"programu; ta technika jest zwykle określana mianem załączania - z ang. - :" -"dfn:`embedding` w aplikacji." +"programu; ta technika jest zwykle określana mianem załączania - z ang. " +"- :dfn:`embedding` w aplikacji." msgid "" "Writing an extension module is a relatively well-understood process, where a " @@ -117,12 +113,12 @@ msgstr "" msgid "" "This implies inclusion of the following standard headers: ````, " -"````, ````, ````, ```` and ```` (if available)." +"````, ````, ````, ```` and " +"```` (if available)." msgstr "" "Oznacza to włączenie następujących standardowych nagłówek: ````, " -"````, ````, ````, ```` i ```` (jeśli są dostępne)." +"````, ````, ````, ```` i " +"```` (jeśli są dostępne)." msgid "" "Since Python may define some pre-processor definitions which affect the " @@ -130,8 +126,8 @@ msgid "" "any standard headers are included." msgstr "" "Jako że Python może definiować pewne definicje preprocesora, które wpływają " -"na pliki nagłówkowe na niektórych systemach, *musisz* załączyć plik :file:" -"`Python.h` przed jakimikolwiek standardowymi nagłówkami." +"na pliki nagłówkowe na niektórych systemach, *musisz* załączyć " +"plik :file:`Python.h` przed jakimikolwiek standardowymi nagłówkami." msgid "" "It is recommended to always define ``PY_SSIZE_T_CLEAN`` before including " @@ -163,22 +159,22 @@ msgstr "" msgid "" "The header files are typically installed with Python. On Unix, these are " -"located in the directories :file:`{prefix}/include/pythonversion/` and :file:" -"`{exec_prefix}/include/pythonversion/`, where :option:`prefix <--prefix>` " -"and :option:`exec_prefix <--exec-prefix>` are defined by the corresponding " -"parameters to Python's :program:`configure` script and *version* is ``'%d." -"%d' % sys.version_info[:2]``. On Windows, the headers are installed in :" -"file:`{prefix}/include`, where ``prefix`` is the installation directory " -"specified to the installer." +"located in the directories :file:`{prefix}/include/pythonversion/` " +"and :file:`{exec_prefix}/include/pythonversion/`, where :option:`prefix <--" +"prefix>` and :option:`exec_prefix <--exec-prefix>` are defined by the " +"corresponding parameters to Python's :program:`configure` script and " +"*version* is ``'%d.%d' % sys.version_info[:2]``. On Windows, the headers " +"are installed in :file:`{prefix}/include`, where ``prefix`` is the " +"installation directory specified to the installer." msgstr "" msgid "" "To include the headers, place both directories (if different) on your " "compiler's search path for includes. Do *not* place the parent directories " "on the search path and then use ``#include ``; this will " -"break on multi-platform builds since the platform independent headers under :" -"option:`prefix <--prefix>` include the platform specific headers from :" -"option:`exec_prefix <--exec-prefix>`." +"break on multi-platform builds since the platform independent headers " +"under :option:`prefix <--prefix>` include the platform specific headers " +"from :option:`exec_prefix <--exec-prefix>`." msgstr "" msgid "" @@ -212,7 +208,7 @@ msgstr "" msgid "" "static struct PyModuleDef spam_module = {\n" -" PyModuleDef_HEAD_INIT,\n" +" .m_base = PyModuleDef_HEAD_INIT,\n" " .m_name = \"spam\",\n" " ...\n" "};\n" @@ -220,13 +216,52 @@ msgid "" "PyMODINIT_FUNC\n" "PyInit_spam(void)\n" "{\n" -" return PyModule_Create(&spam_module);\n" +" return PyModuleDef_Init(&spam_module);\n" "}" msgstr "" msgid "Return the absolute value of ``x``." msgstr "" +msgid "" +"If the result cannot be represented (for example, if ``x`` has :c:macro:`!" +"INT_MIN` value for :c:expr:`int` type), the behavior is undefined." +msgstr "" + +msgid "Specify alignment to *num* bytes on compilers that support it." +msgstr "" + +msgid "Consider using the C11 standard ``_Alignas`` specifier over this macro." +msgstr "" + +msgid "" +"Similar to ``integer >> positions``, but forces sign extension, as the C " +"standard does not define whether a right-shift of a signed integer will " +"perform sign extension or a zero-fill." +msgstr "" + +msgid "" +"*integer* should be any signed integer type. *positions* is the number of " +"positions to shift to the right." +msgstr "" + +msgid "" +"Both *integer* and *positions* can be evaluated more than once; " +"consequently, avoid directly passing a function call or some other operation " +"with side-effects to this macro. Instead, store the result as a variable and " +"then pass it." +msgstr "" + +msgid "" +"*type* is unused and only kept for backwards compatibility. Historically, " +"*type* was used to cast *integer*." +msgstr "" + +msgid "" +"This macro is now valid for all signed integer types, not just those for " +"which ``unsigned type`` is legal. As a result, *type* is no longer used." +msgstr "" + msgid "" "Ask the compiler to always inline a static inline function. The compiler can " "ignore it and decide to not inline the function." @@ -245,9 +280,9 @@ msgid "" msgstr "" msgid "" -"If Python is :ref:`built in debug mode ` (if the :c:macro:" -"`Py_DEBUG` macro is defined), the :c:macro:`Py_ALWAYS_INLINE` macro does " -"nothing." +"If Python is :ref:`built in debug mode ` (if " +"the :c:macro:`Py_DEBUG` macro is defined), the :c:macro:`Py_ALWAYS_INLINE` " +"macro does nothing." msgstr "" msgid "It must be specified before the function return type. Usage::" @@ -256,6 +291,15 @@ msgstr "" msgid "static inline Py_ALWAYS_INLINE int random(void) { return 4; }" msgstr "" +msgid "" +"If this macro is defined, then the current system is able to start threads." +msgstr "" + +msgid "" +"Currently, all systems supported by CPython (per :pep:`11`), with the " +"exception of some WebAssembly platforms, support starting threads." +msgstr "" + msgid "" "Argument must be a character or an integer in the range [-128, 127] or [0, " "255]. This macro returns ``c`` cast to an ``unsigned char``." @@ -275,11 +319,60 @@ msgstr "" msgid "MSVC support was added." msgstr "" +msgid "" +"This is equivalent to ``X``, which is useful for token-pasting in macros, as " +"macro expansions in *X* are forcefully evaluated by the preprocessor." +msgstr "" + +msgid "" +"Use a GCC attribute *name*, hiding it from compilers that don't support GCC " +"attributes (such as MSVC)." +msgstr "" + +msgid "" +"This expands to ``__attribute__((name))`` on a GCC compiler, and expands to " +"nothing on compilers that don't support GCC attributes." +msgstr "" + msgid "" "Like ``getenv(s)``, but returns ``NULL`` if :option:`-E` was passed on the " "command line (see :c:member:`PyConfig.use_environment`)." msgstr "" +msgid "Use *number* as a ``long long`` integer literal." +msgstr "" + +msgid "" +"This usally expands to *number* followed by ``LL``, but will expand to some " +"compiler-specific suffixes (such as ``I64``) on older compilers." +msgstr "" + +msgid "" +"In modern versions of Python, this macro is not very useful, as C99 and " +"later require the ``LL`` suffix to be valid for an integer." +msgstr "" + +msgid "" +"Declare a function returning the specified *type* using a fast-calling " +"qualifier for functions that are local to the current file. Semantically, " +"this is equivalent to ``static type``." +msgstr "" + +msgid "" +"Equivalent to :c:macro:`Py_LOCAL` but additionally requests the function be " +"inlined." +msgstr "" + +msgid "" +"Macro used to declare a symbol as local to the shared library (hidden). On " +"supported platforms, it ensures the symbol is not exported." +msgstr "" + +msgid "" +"On compatible versions of GCC/Clang, it expands to " +"``__attribute__((visibility(\"hidden\")))``." +msgstr "" + msgid "Return the maximum value between ``x`` and ``y``." msgstr "" @@ -291,8 +384,8 @@ msgstr "" msgid "" "Disable inlining on a function. For example, it reduces the C stack " -"consumption: useful on LTO+PGO builds which heavily inline code (see :issue:" -"`33720`)." +"consumption: useful on LTO+PGO builds which heavily inline code " +"(see :issue:`33720`)." msgstr "" msgid "Usage::" @@ -301,10 +394,41 @@ msgstr "" msgid "Py_NO_INLINE static int random(void) { return 4; }" msgstr "" +msgid "" +"Cast *value* to type *smaller* from type *larger*, validating that no " +"information was lost." +msgstr "" + +msgid "" +"On release builds of Python, this is roughly equivalent to ``(smaller) " +"value`` (in C++, ``static_cast(value)`` will be used instead)." +msgstr "" + +msgid "" +"On debug builds (implying that :c:macro:`Py_DEBUG` is defined), this asserts " +"that no information was lost with the cast from *larger* to *smaller*." +msgstr "" + +msgid "" +"*value*, *larger*, and *smaller* may all be evaluated more than once in the " +"expression; consequently, do not pass an expression with side-effects " +"directly to this macro." +msgstr "" + msgid "" "Convert ``x`` to a C string. E.g. ``Py_STRINGIFY(123)`` returns ``\"123\"``." msgstr "" +msgid "" +"Similar to :c:macro:`Py_LL`, but *number* will be an ``unsigned long long`` " +"literal instead. This is done by appending ``U`` to the result of ``Py_LL``." +msgstr "" + +msgid "" +"In modern versions of Python, this macro is not very useful, as C99 and " +"later require the ``ULL``/``LLU`` suffixes to be valid for an integer." +msgstr "" + msgid "" "Use this when you have a code path that cannot be reached by design. For " "example, in the ``default:`` clause in a ``switch`` statement for which all " @@ -319,8 +443,8 @@ msgid "" msgstr "" msgid "" -"A use for ``Py_UNREACHABLE()`` is following a call a function that never " -"returns but that is not declared :c:macro:`_Py_NO_RETURN`." +"A use for ``Py_UNREACHABLE()`` is following a call to a function that never " +"returns but that is not declared ``_Py_NO_RETURN``." msgstr "" msgid "" @@ -337,7 +461,29 @@ msgid "" msgstr "" msgid "" -"Creates a variable with name ``name`` that can be used in docstrings. If " +"Asserts a compile-time condition *cond*, as a statement. The build will fail " +"if the condition is false or cannot be evaluated at compile time." +msgstr "" + +msgid "For example::" +msgstr "Dla przykładu::" + +msgid "Py_BUILD_ASSERT(sizeof(PyTime_t) == sizeof(int64_t));" +msgstr "" + +msgid "" +"Asserts a compile-time condition *cond*, as an expression that evaluates to " +"``0``. The build will fail if the condition is false or cannot be evaluated " +"at compile time." +msgstr "" + +msgid "" +"#define foo_to_char(foo) \\\n" +" ((char *)(foo) + Py_BUILD_ASSERT_EXPR(offsetof(struct foo, string) == 0))" +msgstr "" + +msgid "" +"Creates a variable with name *name* that can be used in docstrings. If " "Python is built without docstrings, the value will be empty." msgstr "" @@ -374,6 +520,72 @@ msgid "" "};" msgstr "" +msgid "Declares a static character array variable with the given name *name*." +msgstr "" + +msgid "" +"PyDoc_VAR(python_doc) = PyDoc_STR(\"A genus of constricting snakes in the " +"Pythonidae family native \"\n" +" \"to the tropics and subtropics of the " +"Eastern Hemisphere.\");" +msgstr "" + +msgid "Compute the length of a statically allocated C array at compile time." +msgstr "" + +msgid "" +"The *array* argument must be a C array with a size known at compile time. " +"Passing an array with an unknown size, such as a heap-allocated array, will " +"result in a compilation error on some compilers, or otherwise produce " +"incorrect results." +msgstr "" + +msgid "This is roughly equivalent to::" +msgstr "" + +msgid "sizeof(array) / sizeof((array)[0])" +msgstr "" + +msgid "" +"Macro used to declare a symbol (function or data) as exported. On Windows, " +"this expands to ``__declspec(dllexport)``. On compatible versions of GCC/" +"Clang, it expands to ``__attribute__((visibility(\"default\")))``. This " +"macro is for defining the C API itself; extension modules should not use it." +msgstr "" + +msgid "" +"Macro used to declare a symbol as imported. On Windows, this expands to " +"``__declspec(dllimport)``. This macro is for defining the C API itself; " +"extension modules should not use it." +msgstr "" + +msgid "" +"Macro used by CPython to declare a function as part of the C API. Its " +"expansion depends on the platform and build configuration. This macro is " +"intended for defining CPython's C API itself; extension modules should not " +"use it for their own symbols." +msgstr "" + +msgid "" +"Macro used by CPython to declare a public global variable as part of the C " +"API. Its expansion depends on the platform and build configuration. This " +"macro is intended for defining CPython's C API itself; extension modules " +"should not use it for their own symbols." +msgstr "" + +msgid "" +"This is a :term:`soft deprecated` alias to the C99-standard ``va_copy`` " +"function." +msgstr "" + +msgid "" +"Historically, this would use a compiler-specific method to copy a " +"``va_list``." +msgstr "" + +msgid "This is now an alias to ``va_copy``." +msgstr "" + msgid "Objects, Types and Reference Counts" msgstr "Przedmioty, ich Rodzaje i Liczby Odwołań" @@ -384,28 +596,28 @@ msgid "" "are treated the same way by the Python language in most situations (e.g., " "assignments, scope rules, and argument passing), it is only fitting that " "they should be represented by a single C type. Almost all Python objects " -"live on the heap: you never declare an automatic or static variable of type :" -"c:type:`PyObject`, only pointer variables of type :c:expr:`PyObject*` can " -"be declared. The sole exception are the type objects; since these must " +"live on the heap: you never declare an automatic or static variable of " +"type :c:type:`PyObject`, only pointer variables of type :c:expr:`PyObject*` " +"can be declared. The sole exception are the type objects; since these must " "never be deallocated, they are typically static :c:type:`PyTypeObject` " "objects." msgstr "" msgid "" -"All Python objects (even Python integers) have a :dfn:`type` and a :dfn:" -"`reference count`. An object's type determines what kind of object it is (e." -"g., an integer, a list, or a user-defined function; there are many more as " -"explained in :ref:`types`). For each of the well-known types there is a " -"macro to check whether an object is of that type; for instance, " +"All Python objects (even Python integers) have a :dfn:`type` and " +"a :dfn:`reference count`. An object's type determines what kind of object " +"it is (e.g., an integer, a list, or a user-defined function; there are many " +"more as explained in :ref:`types`). For each of the well-known types there " +"is a macro to check whether an object is of that type; for instance, " "``PyList_Check(a)`` is true if (and only if) the object pointed to by *a* is " "a Python list." msgstr "" "Wszystkie przedmioty języka pytonowskiego (nawet liczby całkowite języka " "pytonowskiego) mają :dfn:`rodzaj` i :dfn:`liczbę odniesień`. Typ przedmiotu " "określa jakiego rodzaju przedmiot to jest (np. liczba całkowita, lista, lub " -"zadanie zdefiniowane przez użytkownika; jest wiele więcej jak wyjaśniono w :" -"ref:`types`). Dla każdego z dobrze-znanych rodzajów istnieje makropolecenie " -"sprawdzające czy przedmiot jest tego rodzaju; na przykład, " +"zadanie zdefiniowane przez użytkownika; jest wiele więcej jak wyjaśniono " +"w :ref:`types`). Dla każdego z dobrze-znanych rodzajów istnieje " +"makropolecenie sprawdzające czy przedmiot jest tego rodzaju; na przykład, " "``PyList_Check(a)`` jest prawdziwe wtedy (i tylko wtedy) gdy przedmiot na " "który wskazuje *a* jest lista z języka pytonowskiego." @@ -430,18 +642,18 @@ msgid "" "Reference counts are always manipulated explicitly. The normal way is to " "use the macro :c:func:`Py_INCREF` to take a new reference to an object (i.e. " "increment its reference count by one), and :c:func:`Py_DECREF` to release " -"that reference (i.e. decrement the reference count by one). The :c:func:" -"`Py_DECREF` macro is considerably more complex than the incref one, since it " -"must check whether the reference count becomes zero and then cause the " -"object's deallocator to be called. The deallocator is a function pointer " -"contained in the object's type structure. The type-specific deallocator " -"takes care of releasing references for other objects contained in the object " -"if this is a compound object type, such as a list, as well as performing any " -"additional finalization that's needed. There's no chance that the reference " -"count can overflow; at least as many bits are used to hold the reference " -"count as there are distinct memory locations in virtual memory (assuming " -"``sizeof(Py_ssize_t) >= sizeof(void*)``). Thus, the reference count " -"increment is a simple operation." +"that reference (i.e. decrement the reference count by one). " +"The :c:func:`Py_DECREF` macro is considerably more complex than the incref " +"one, since it must check whether the reference count becomes zero and then " +"cause the object's deallocator to be called. The deallocator is a function " +"pointer contained in the object's type structure. The type-specific " +"deallocator takes care of releasing references for other objects contained " +"in the object if this is a compound object type, such as a list, as well as " +"performing any additional finalization that's needed. There's no chance " +"that the reference count can overflow; at least as many bits are used to " +"hold the reference count as there are distinct memory locations in virtual " +"memory (assuming ``sizeof(Py_ssize_t) >= sizeof(void*)``). Thus, the " +"reference count increment is a simple operation." msgstr "" msgid "" @@ -467,8 +679,8 @@ msgid "" "conceivably remove the object from the list, releasing that reference, and " "possibly deallocating it. The real danger is that innocent-looking " "operations may invoke arbitrary Python code which could do this; there is a " -"code path which allows control to flow back to the user from a :c:func:" -"`Py_DECREF`, so almost any operation is potentially dangerous." +"code path which allows control to flow back to the user from " +"a :c:func:`Py_DECREF`, so almost any operation is potentially dangerous." msgstr "" msgid "" @@ -490,37 +702,37 @@ msgid "" "shared). \"Owning a reference\" means being responsible for calling " "Py_DECREF on it when the reference is no longer needed. Ownership can also " "be transferred, meaning that the code that receives ownership of the " -"reference then becomes responsible for eventually releasing it by calling :c:" -"func:`Py_DECREF` or :c:func:`Py_XDECREF` when it's no longer needed---or " -"passing on this responsibility (usually to its caller). When a function " -"passes ownership of a reference on to its caller, the caller is said to " -"receive a *new* reference. When no ownership is transferred, the caller is " -"said to *borrow* the reference. Nothing needs to be done for a :term:" -"`borrowed reference`." +"reference then becomes responsible for eventually releasing it by " +"calling :c:func:`Py_DECREF` or :c:func:`Py_XDECREF` when it's no longer " +"needed---or passing on this responsibility (usually to its caller). When a " +"function passes ownership of a reference on to its caller, the caller is " +"said to receive a *new* reference. When no ownership is transferred, the " +"caller is said to *borrow* the reference. Nothing needs to be done for " +"a :term:`borrowed reference`." msgstr "" msgid "" "Conversely, when a calling function passes in a reference to an object, " "there are two possibilities: the function *steals* a reference to the " -"object, or it does not. *Stealing a reference* means that when you pass a " -"reference to a function, that function assumes that it now owns that " -"reference, and you are not responsible for it any longer." +"object, or it does not." +msgstr "" + +msgid "" +"*Stealing a reference* means that when you pass a reference to a function, " +"that function assumes that it now owns that reference. Since the new owner " +"can use :c:func:`!Py_DECREF` at its discretion, you (the caller) must not " +"use that reference after the call." msgstr "" -"Idąc dalej, gdy wywołujące zadanie przekazuje odniesienie do przedmiotu, " -"istnieją dwie możliwości: zadanie *kradnie* odniesienie do przedmiotu, lub " -"nie kradnie go. *Kradnięcie odniesienia* oznacza, że gdy przekazujesz " -"odniesienie do zadania, to zadanie przyjmuje, że teraz ono posiada " -"odniesienie i nie jesteś za nie odpowiedzialny ani chwili dłużej." msgid "" -"Few functions steal references; the two notable exceptions are :c:func:" -"`PyList_SetItem` and :c:func:`PyTuple_SetItem`, which steal a reference to " -"the item (but not to the tuple or list into which the item is put!). These " -"functions were designed to steal a reference because of a common idiom for " -"populating a tuple or list with newly created objects; for example, the code " -"to create the tuple ``(1, 2, \"three\")`` could look like this (forgetting " -"about error handling for the moment; a better way to code this is shown " -"below)::" +"Few functions steal references; the two notable exceptions " +"are :c:func:`PyList_SetItem` and :c:func:`PyTuple_SetItem`, which steal a " +"reference to the item (but not to the tuple or list into which the item is " +"put!). These functions were designed to steal a reference because of a " +"common idiom for populating a tuple or list with newly created objects; for " +"example, the code to create the tuple ``(1, 2, \"three\")`` could look like " +"this (forgetting about error handling for the moment; a better way to code " +"this is shown below)::" msgstr "" msgid "" @@ -542,21 +754,22 @@ msgstr "" msgid "" "Incidentally, :c:func:`PyTuple_SetItem` is the *only* way to set tuple " "items; :c:func:`PySequence_SetItem` and :c:func:`PyObject_SetItem` refuse to " -"do this since tuples are an immutable data type. You should only use :c:" -"func:`PyTuple_SetItem` for tuples that you are creating yourself." +"do this since tuples are an immutable data type. You should only " +"use :c:func:`PyTuple_SetItem` for tuples that you are creating yourself." msgstr "" msgid "" -"Equivalent code for populating a list can be written using :c:func:" -"`PyList_New` and :c:func:`PyList_SetItem`." +"Equivalent code for populating a list can be written " +"using :c:func:`PyList_New` and :c:func:`PyList_SetItem`." msgstr "" msgid "" "However, in practice, you will rarely use these ways of creating and " -"populating a tuple or list. There's a generic function, :c:func:" -"`Py_BuildValue`, that can create most common objects from C values, directed " -"by a :dfn:`format string`. For example, the above two blocks of code could " -"be replaced by the following (which also takes care of the error checking)::" +"populating a tuple or list. There's a generic " +"function, :c:func:`Py_BuildValue`, that can create most common objects from " +"C values, directed by a :dfn:`format string`. For example, the above two " +"blocks of code could be replaced by the following (which also takes care of " +"the error checking)::" msgstr "" msgid "" @@ -686,12 +899,12 @@ msgstr "Typy" msgid "" "There are few other data types that play a significant role in the Python/C " -"API; most are simple C types such as :c:expr:`int`, :c:expr:`long`, :c:expr:" -"`double` and :c:expr:`char*`. A few structure types are used to describe " -"static tables used to list the functions exported by a module or the data " -"attributes of a new object type, and another is used to describe the value " -"of a complex number. These will be discussed together with the functions " -"that use them." +"API; most are simple C types such " +"as :c:expr:`int`, :c:expr:`long`, :c:expr:`double` and :c:expr:`char*`. A " +"few structure types are used to describe static tables used to list the " +"functions exported by a module or the data attributes of a new object type, " +"and another is used to describe the value of a complex number. These will " +"be discussed together with the functions that use them." msgstr "" msgid "" @@ -735,38 +948,38 @@ msgstr "" msgid "" "Exception state is maintained in per-thread storage (this is equivalent to " "using global storage in an unthreaded application). A thread can be in one " -"of two states: an exception has occurred, or not. The function :c:func:" -"`PyErr_Occurred` can be used to check for this: it returns a borrowed " -"reference to the exception type object when an exception has occurred, and " -"``NULL`` otherwise. There are a number of functions to set the exception " -"state: :c:func:`PyErr_SetString` is the most common (though not the most " -"general) function to set the exception state, and :c:func:`PyErr_Clear` " -"clears the exception state." +"of two states: an exception has occurred, or not. The " +"function :c:func:`PyErr_Occurred` can be used to check for this: it returns " +"a borrowed reference to the exception type object when an exception has " +"occurred, and ``NULL`` otherwise. There are a number of functions to set " +"the exception state: :c:func:`PyErr_SetString` is the most common (though " +"not the most general) function to set the exception state, " +"and :c:func:`PyErr_Clear` clears the exception state." msgstr "" msgid "" "The full exception state consists of three objects (all of which can be " "``NULL``): the exception type, the corresponding exception value, and the " -"traceback. These have the same meanings as the Python result of ``sys." -"exc_info()``; however, they are not the same: the Python objects represent " -"the last exception being handled by a Python :keyword:`try` ... :keyword:" -"`except` statement, while the C level exception state only exists while an " -"exception is being passed on between C functions until it reaches the Python " -"bytecode interpreter's main loop, which takes care of transferring it to " -"``sys.exc_info()`` and friends." +"traceback. These have the same meanings as the Python result of " +"``sys.exc_info()``; however, they are not the same: the Python objects " +"represent the last exception being handled by a " +"Python :keyword:`try` ... :keyword:`except` statement, while the C level " +"exception state only exists while an exception is being passed on between C " +"functions until it reaches the Python bytecode interpreter's main loop, " +"which takes care of transferring it to ``sys.exc_info()`` and friends." msgstr "" msgid "" "Note that starting with Python 1.5, the preferred, thread-safe way to access " -"the exception state from Python code is to call the function :func:`sys." -"exc_info`, which returns the per-thread exception state for Python code. " -"Also, the semantics of both ways to access the exception state have changed " -"so that a function which catches an exception will save and restore its " -"thread's exception state so as to preserve the exception state of its " -"caller. This prevents common bugs in exception handling code caused by an " -"innocent-looking function overwriting the exception being handled; it also " -"reduces the often unwanted lifetime extension for objects that are " -"referenced by the stack frames in the traceback." +"the exception state from Python code is to call the " +"function :func:`sys.exc_info`, which returns the per-thread exception state " +"for Python code. Also, the semantics of both ways to access the exception " +"state have changed so that a function which catches an exception will save " +"and restore its thread's exception state so as to preserve the exception " +"state of its caller. This prevents common bugs in exception handling code " +"caused by an innocent-looking function overwriting the exception being " +"handled; it also reduces the often unwanted lifetime extension for objects " +"that are referenced by the stack frames in the traceback." msgstr "" "Zauważ że poczynając od języka pytonowskiego w wersji 1.5 preferowaną, " "bezpiecznym dla wątków sposobem na dostęp do stanu wyjątku z poziomu kodu " @@ -865,14 +1078,14 @@ msgstr "" msgid "" "This example represents an endorsed use of the ``goto`` statement in C! It " -"illustrates the use of :c:func:`PyErr_ExceptionMatches` and :c:func:" -"`PyErr_Clear` to handle specific exceptions, and the use of :c:func:" -"`Py_XDECREF` to dispose of owned references that may be ``NULL`` (note the " -"``'X'`` in the name; :c:func:`Py_DECREF` would crash when confronted with a " -"``NULL`` reference). It is important that the variables used to hold owned " -"references are initialized to ``NULL`` for this to work; likewise, the " -"proposed return value is initialized to ``-1`` (failure) and only set to " -"success after the final call made is successful." +"illustrates the use of :c:func:`PyErr_ExceptionMatches` " +"and :c:func:`PyErr_Clear` to handle specific exceptions, and the use " +"of :c:func:`Py_XDECREF` to dispose of owned references that may be ``NULL`` " +"(note the ``'X'`` in the name; :c:func:`Py_DECREF` would crash when " +"confronted with a ``NULL`` reference). It is important that the variables " +"used to hold owned references are initialized to ``NULL`` for this to work; " +"likewise, the proposed return value is initialized to ``-1`` (failure) and " +"only set to success after the final call made is successful." msgstr "" msgid "Embedding Python" @@ -899,10 +1112,11 @@ msgid "" msgstr "" msgid "" -":c:func:`Py_Initialize` does not set the \"script argument list\" (``sys." -"argv``). If this variable is needed by Python code that will be executed " -"later, setting :c:member:`PyConfig.argv` and :c:member:`PyConfig.parse_argv` " -"must be set: see :ref:`Python Initialization Configuration `." +":c:func:`Py_Initialize` does not set the \"script argument list\" " +"(``sys.argv``). If this variable is needed by Python code that will be " +"executed later, setting :c:member:`PyConfig.argv` " +"and :c:member:`PyConfig.parse_argv` must be set: see :ref:`Python " +"Initialization Configuration `." msgstr "" msgid "" @@ -920,43 +1134,45 @@ msgid "" "For instance, if the Python executable is found in :file:`/usr/local/bin/" "python`, it will assume that the libraries are in :file:`/usr/local/lib/" "python{X.Y}`. (In fact, this particular path is also the \"fallback\" " -"location, used when no executable file named :file:`python` is found along :" -"envvar:`PATH`.) The user can override this behavior by setting the " +"location, used when no executable file named :file:`python` is found " +"along :envvar:`PATH`.) The user can override this behavior by setting the " "environment variable :envvar:`PYTHONHOME`, or insert additional directories " "in front of the standard path by setting :envvar:`PYTHONPATH`." msgstr "" "Na przykład, jeśli plik wykonywalny programu interpretującego polecenia " "języka pytonowskiego znajduje się w katalogu :file:`/usr/local/bin/python`, " -"będzie zakładał, że biblioteki są w katalogu :file:`/usr/local/lib/python{X." -"Y}` (Faktycznie, ta szczególna ścieżka jest także \"ratunkowym\" położeniem, " -"używanym gdy żaden plik wykonywalny nazwany :file:`python` nie znajdzie się " -"w katalogach znajdujących się w zmiennej środowiskowej :envvar:`PATH`.) " -"Użytkownik może podmienić to zachowanie przez ustawienie zmiennej " -"środowiskowej :envvar:`PYTHONHOME`, lub wstawić dodatkowe katalogi przed " -"sztandarową ścieżką przez ustawienie zmiennej środowiskowej :envvar:" -"`PYTHONPATH`." +"będzie zakładał, że biblioteki są w katalogu :file:`/usr/local/lib/" +"python{X.Y}` (Faktycznie, ta szczególna ścieżka jest także \"ratunkowym\" " +"położeniem, używanym gdy żaden plik wykonywalny nazwany :file:`python` nie " +"znajdzie się w katalogach znajdujących się w zmiennej " +"środowiskowej :envvar:`PATH`.) Użytkownik może podmienić to zachowanie przez " +"ustawienie zmiennej środowiskowej :envvar:`PYTHONHOME`, lub wstawić " +"dodatkowe katalogi przed sztandarową ścieżką przez ustawienie zmiennej " +"środowiskowej :envvar:`PYTHONPATH`." msgid "" -"The embedding application can steer the search by setting :c:member:" -"`PyConfig.program_name` *before* calling :c:func:`Py_InitializeFromConfig`. " -"Note that :envvar:`PYTHONHOME` still overrides this and :envvar:`PYTHONPATH` " -"is still inserted in front of the standard path. An application that " -"requires total control has to provide its own implementation of :c:func:" -"`Py_GetPath`, :c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, and :c:" -"func:`Py_GetProgramFullPath` (all defined in :file:`Modules/getpath.c`)." +"The embedding application can steer the search by " +"setting :c:member:`PyConfig.program_name` *before* " +"calling :c:func:`Py_InitializeFromConfig`. Note that :envvar:`PYTHONHOME` " +"still overrides this and :envvar:`PYTHONPATH` is still inserted in front of " +"the standard path. An application that requires total control has to " +"provide its own implementation " +"of :c:func:`Py_GetPath`, :c:func:`Py_GetPrefix`, :c:func:`Py_GetExecPrefix`, " +"and :c:func:`Py_GetProgramFullPath` (all defined in :file:`Modules/" +"getpath.c`)." msgstr "" msgid "" "Sometimes, it is desirable to \"uninitialize\" Python. For instance, the " -"application may want to start over (make another call to :c:func:" -"`Py_Initialize`) or the application is simply done with its use of Python " -"and wants to free memory allocated by Python. This can be accomplished by " -"calling :c:func:`Py_FinalizeEx`. The function :c:func:`Py_IsInitialized` " -"returns true if Python is currently in the initialized state. More " -"information about these functions is given in a later chapter. Notice that :" -"c:func:`Py_FinalizeEx` does *not* free all memory allocated by the Python " -"interpreter, e.g. memory allocated by extension modules currently cannot be " -"released." +"application may want to start over (make another call " +"to :c:func:`Py_Initialize`) or the application is simply done with its use " +"of Python and wants to free memory allocated by Python. This can be " +"accomplished by calling :c:func:`Py_FinalizeEx`. The " +"function :c:func:`Py_IsInitialized` returns true if Python is currently in " +"the initialized state. More information about these functions is given in a " +"later chapter. Notice that :c:func:`Py_FinalizeEx` does *not* free all " +"memory allocated by the Python interpreter, e.g. memory allocated by " +"extension modules currently cannot be released." msgstr "" msgid "Debugging Builds" @@ -974,22 +1190,22 @@ msgstr "" "programu więc nie są załączane domyślnie." msgid "" -"A full list of the various types of debugging builds is in the file :file:" -"`Misc/SpecialBuilds.txt` in the Python source distribution. Builds are " -"available that support tracing of reference counts, debugging the memory " -"allocator, or low-level profiling of the main interpreter loop. Only the " -"most frequently used builds will be described in the remainder of this " +"A full list of the various types of debugging builds is in the " +"file :file:`Misc/SpecialBuilds.txt` in the Python source distribution. " +"Builds are available that support tracing of reference counts, debugging the " +"memory allocator, or low-level profiling of the main interpreter loop. Only " +"the most frequently used builds will be described in the remainder of this " "section." msgstr "" msgid "" "Compiling the interpreter with the :c:macro:`!Py_DEBUG` macro defined " "produces what is generally meant by :ref:`a debug build of Python `. :c:macro:`!Py_DEBUG` is enabled in the Unix build by adding :option:" -"`--with-pydebug` to the :file:`./configure` command. It is also implied by " -"the presence of the not-Python-specific :c:macro:`!_DEBUG` macro. When :c:" -"macro:`!Py_DEBUG` is enabled in the Unix build, compiler optimization is " -"disabled." +"build>`. :c:macro:`!Py_DEBUG` is enabled in the Unix build by " +"adding :option:`--with-pydebug` to the :file:`./configure` command. It is " +"also implied by the presence of the not-Python-specific :c:macro:`!_DEBUG` " +"macro. When :c:macro:`!Py_DEBUG` is enabled in the Unix build, compiler " +"optimization is disabled." msgstr "" msgid "" @@ -998,12 +1214,12 @@ msgid "" msgstr "" msgid "" -"Defining :c:macro:`Py_TRACE_REFS` enables reference tracing (see the :option:" -"`configure --with-trace-refs option <--with-trace-refs>`). When defined, a " -"circular doubly linked list of active objects is maintained by adding two " -"extra fields to every :c:type:`PyObject`. Total allocations are tracked as " -"well. Upon exit, all existing references are printed. (In interactive mode " -"this happens after every statement run by the interpreter.)" +"Defining ``Py_TRACE_REFS`` enables reference tracing (see " +"the :option:`configure --with-trace-refs option <--with-trace-refs>`). When " +"defined, a circular doubly linked list of active objects is maintained by " +"adding two extra fields to every :c:type:`PyObject`. Total allocations are " +"tracked as well. Upon exit, all existing references are printed. (In " +"interactive mode this happens after every statement run by the interpreter.)" msgstr "" msgid "" @@ -1013,6 +1229,72 @@ msgstr "" "Odwołaj się do :file:`Misc/SpecialBuilds.txt` w źródłowym pakiecie języka " "pytonowskiego po więcej szczegółów." +msgid "Recommended third party tools" +msgstr "Rekomendowane zewnętrzne narzędzia." + +msgid "" +"The following third party tools offer both simpler and more sophisticated " +"approaches to creating C, C++ and Rust extensions for Python:" +msgstr "" + +msgid "`Cython `_" +msgstr "" + +msgid "`cffi `_" +msgstr "" + +msgid "`HPy `_" +msgstr "" + +msgid "`nanobind `_ (C++)" +msgstr "" + +msgid "`Numba `_" +msgstr "" + +msgid "`pybind11 `_ (C++)" +msgstr "" + +msgid "`PyO3 `_ (Rust)" +msgstr "" + +msgid "`SWIG `_" +msgstr "" + +msgid "" +"Using tools such as these can help avoid writing code that is tightly bound " +"to a particular version of CPython, avoid reference counting errors, and " +"focus more on your own code than on using the CPython API. In general, new " +"versions of Python can be supported by updating the tool, and your code will " +"often use newer and more efficient APIs automatically. Some tools also " +"support compiling for other implementations of Python from a single set of " +"sources." +msgstr "" + +msgid "" +"These projects are not supported by the same people who maintain Python, and " +"issues need to be raised with the projects directly. Remember to check that " +"the project is still maintained and supported, as the list above may become " +"outdated." +msgstr "" + +msgid "" +"`Python Packaging User Guide: Binary Extensions `_" +msgstr "" +"Pakiety Pythona Podręcznik Użytkownika: Rozszerzenia Binarne\n" +", YEAR. # # Translators: -# haaritsubaki, 2023 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -51,12 +49,12 @@ msgstr "" msgid "" "If *len* is greater than zero, the returned list object's items are set to " -"``NULL``. Thus you cannot use abstract API functions such as :c:func:" -"`PySequence_SetItem` or expose the object to Python code before setting all " -"items to a real object with :c:func:`PyList_SetItem` or :c:func:" -"`PyList_SET_ITEM()`. The following APIs are safe APIs before the list is " -"fully initialized: :c:func:`PyList_SetItem()` and :c:func:" -"`PyList_SET_ITEM()`." +"``NULL``. Thus you cannot use abstract API functions such " +"as :c:func:`PySequence_SetItem` or expose the object to Python code before " +"setting all items to a real object with :c:func:`PyList_SetItem` " +"or :c:func:`PyList_SET_ITEM()`. The following APIs are safe APIs before the " +"list is fully initialized: :c:func:`PyList_SetItem()` " +"and :c:func:`PyList_SET_ITEM()`." msgstr "" msgid "" @@ -89,8 +87,9 @@ msgid "" msgstr "" msgid "" -"This function \"steals\" a reference to *item* and discards a reference to " -"an item already in the list at the affected position." +"This function \":term:`steals `\" a reference to *item*, even on " +"error. On success, it discards a reference to an item already in the list at " +"the affected position (unless it was ``NULL``)." msgstr "" msgid "" @@ -99,14 +98,16 @@ msgid "" msgstr "" msgid "" -"Bounds checking is performed as an assertion if Python is built in :ref:" -"`debug mode ` or :option:`with assertions <--with-assertions>`." +"Bounds checking is performed as an assertion if Python is built " +"in :ref:`debug mode ` or :option:`with assertions <--with-" +"assertions>`." msgstr "" msgid "" -"This macro \"steals\" a reference to *item*, and, unlike :c:func:" -"`PyList_SetItem`, does *not* discard a reference to any item that is being " -"replaced; any reference in *list* at position *i* will be leaked." +"This macro \":term:`steals `\" a reference to *item*, and, " +"unlike :c:func:`PyList_SetItem`, does *not* discard a reference to any item " +"that is being replaced; any reference in *list* at position *i* will be " +"leaked." msgstr "" msgid "" diff --git a/c-api/long.po b/c-api/long.po index 1821fd43a7..22820811af 100644 --- a/c-api/long.po +++ b/c-api/long.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-13 21:57+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -47,8 +45,8 @@ msgid "" msgstr "" msgid "" -"Return true if its argument is a :c:type:`PyLongObject` or a subtype of :c:" -"type:`PyLongObject`. This function always succeeds." +"Return true if its argument is a :c:type:`PyLongObject` or a subtype " +"of :c:type:`PyLongObject`. This function always succeeds." msgstr "" msgid "" @@ -61,9 +59,9 @@ msgid "" 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." +"CPython 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 "" @@ -111,8 +109,8 @@ msgid "" 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 " +"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 "" @@ -150,6 +148,15 @@ msgid "" "most-significant bit is not a sign bit. Flags other than endian are ignored." msgstr "" +msgid "Macro for creating a Python integer from a process identifier." +msgstr "" + +msgid "" +"This can be defined as an alias to :c:func:`PyLong_FromLong` " +"or :c:func:`PyLong_FromLongLong`, depending on the size of the system's PID " +"type." +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__` " @@ -157,8 +164,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:" -"expr:`long`." +"Raise :exc:`OverflowError` if the value of *obj* is out of range for " +"a :c:expr:`long`." msgstr "" msgid "Returns ``-1`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." @@ -171,24 +178,21 @@ msgid "This function will no longer use :meth:`~object.__int__`." msgstr "" msgid "" -"A :term:`soft deprecated` alias. Exactly equivalent to the preferred " -"``PyLong_AsLong``. In particular, it can fail with :exc:`OverflowError` or " -"another exception." -msgstr "" - -msgid "The function is soft deprecated." +"Exactly equivalent to the preferred ``PyLong_AsLong``. In particular, it can " +"fail with :exc:`OverflowError` or another exception." msgstr "" msgid "" -"Similar to :c:func:`PyLong_AsLong`, but store the result in a C :c:expr:" -"`int` instead of a C :c:expr:`long`." +"Similar to :c:func:`PyLong_AsLong`, but store the result in a " +"C :c:expr:`int` instead of a C :c:expr:`long`." msgstr "" msgid "" -"If the value of *obj* is greater than :c:macro:`LONG_MAX` or less than :c:" -"macro:`LONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and " -"return ``-1``; otherwise, set *\\*overflow* to ``0``. If any other " -"exception occurs set *\\*overflow* to ``0`` and return ``-1`` as usual." +"If the value of *obj* is greater than :c:macro:`LONG_MAX` or less " +"than :c:macro:`LONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, " +"respectively, and return ``-1``; otherwise, set *\\*overflow* to ``0``. If " +"any other exception occurs set *\\*overflow* to ``0`` and return ``-1`` as " +"usual." msgstr "" msgid "" @@ -198,15 +202,16 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:" -"expr:`long long`." +"Raise :exc:`OverflowError` if the value of *obj* is out of range for " +"a :c:expr:`long long`." msgstr "" msgid "" -"If the value of *obj* is greater than :c:macro:`LLONG_MAX` or less than :c:" -"macro:`LLONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and " -"return ``-1``; otherwise, set *\\*overflow* to ``0``. If any other " -"exception occurs set *\\*overflow* to ``0`` and return ``-1`` as usual." +"If the value of *obj* is greater than :c:macro:`LLONG_MAX` or less " +"than :c:macro:`LLONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, " +"respectively, and return ``-1``; otherwise, set *\\*overflow* to ``0``. If " +"any other exception occurs set *\\*overflow* to ``0`` and return ``-1`` as " +"usual." msgstr "" msgid "" @@ -215,8 +220,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" -"type:`Py_ssize_t`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"a :c:type:`Py_ssize_t`." msgstr "" msgid "" @@ -225,8 +230,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" -"expr:`unsigned long`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"a :c:expr:`unsigned long`." msgstr "" msgid "" @@ -240,8 +245,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" -"type:`size_t`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"a :c:type:`size_t`." msgstr "" msgid "" @@ -255,8 +260,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for an :" -"c:expr:`unsigned long long`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"an :c:expr:`unsigned long long`." msgstr "" msgid "" @@ -270,8 +275,9 @@ msgstr "" msgid "" "Return a C :c:expr:`unsigned long` representation of *obj*. If *obj* is not " -"an instance of :c:type:`PyLongObject`, first call its :meth:`~object." -"__index__` method (if present) to convert it to a :c:type:`PyLongObject`." +"an instance of :c:type:`PyLongObject`, first call " +"its :meth:`~object.__index__` method (if present) to convert it to " +"a :c:type:`PyLongObject`." msgstr "" msgid "" @@ -286,8 +292,9 @@ msgstr "" msgid "" "Return a C :c:expr:`unsigned long long` representation of *obj*. If *obj* " -"is not an instance of :c:type:`PyLongObject`, first call its :meth:`~object." -"__index__` method (if present) to convert it to a :c:type:`PyLongObject`." +"is not an instance of :c:type:`PyLongObject`, first call " +"its :meth:`~object.__index__` method (if present) to convert it to " +"a :c:type:`PyLongObject`." msgstr "" msgid "" @@ -306,8 +313,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" -"expr:`double`." +"Raise :exc:`OverflowError` if the value of *pylong* is out of range for " +"a :c:expr:`double`." msgstr "" msgid "" @@ -317,14 +324,23 @@ msgstr "" msgid "" "Convert a Python integer *pylong* to a C :c:expr:`void` pointer. If *pylong* " "cannot be converted, an :exc:`OverflowError` will be raised. This is only " -"assured to produce a usable :c:expr:`void` pointer for values created with :" -"c:func:`PyLong_FromVoidPtr`." +"assured to produce a usable :c:expr:`void` pointer for values created " +"with :c:func:`PyLong_FromVoidPtr`." msgstr "" msgid "" "Returns ``NULL`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." msgstr "" +msgid "Macro for converting a Python integer into a process identifier." +msgstr "" + +msgid "" +"This can be defined as an alias " +"to :c:func:`PyLong_AsLong`, :c:func:`PyLong_FromLongLong`, " +"or :c:func:`PyLong_AsInt`, depending on the size of the system's PID type." +msgstr "" + msgid "" "Copy the Python integer value *pylong* to a native *buffer* of size " "*n_bytes*. The *flags* can be set to ``-1`` to behave similarly to a C cast, " @@ -340,14 +356,15 @@ msgstr "" msgid "" "Otherwise, returns the number of bytes required to store the value. If this " "is equal to or less than *n_bytes*, the entire value was copied. All " -"*n_bytes* of the buffer are written: large buffers are padded with zeroes." +"*n_bytes* of the buffer are written: remaining bytes filled by copies of the " +"sign bit." msgstr "" msgid "" -"If the returned value is greater than than *n_bytes*, the value was " -"truncated: as many of the lowest bits of the value as could fit are written, " -"and the higher bits are ignored. This matches the typical behavior of a C-" -"style downcast." +"If the returned value is greater than *n_bytes*, the value was truncated: as " +"many of the lowest bits of the value as could fit are written, and the " +"higher bits are ignored. This matches the typical behavior of a C-style " +"downcast." msgstr "" msgid "" @@ -496,8 +513,8 @@ msgid "" "passed, its :meth:`~object.__index__` method will be called first. This may " "result in Python code executing and other threads being allowed to run, " "which could cause changes to other objects or values in use. When *flags* is " -"``-1``, this option is not set, and non-integer values will raise :exc:" -"`TypeError`." +"``-1``, this option is not set, and non-integer values will " +"raise :exc:`TypeError`." msgstr "" msgid "" @@ -521,9 +538,10 @@ msgstr "" msgid "" "This function makes it possible for performance-critical code to implement a " -"“fast path” for small integers. For compact values use :c:func:" -"`PyUnstable_Long_CompactValue`; for others fall back to a :c:func:" -"`PyLong_As* ` function or :c:func:`PyLong_AsNativeBytes`." +"“fast path” for small integers. For compact values " +"use :c:func:`PyUnstable_Long_CompactValue`; for others fall back to " +"a :c:func:`PyLong_As* ` function " +"or :c:func:`PyLong_AsNativeBytes`." msgstr "" msgid "The speedup is expected to be negligible for most users." diff --git a/c-api/mapping.po b/c-api/mapping.po index d8dd6474e5..0bfd1d1ac1 100644 --- a/c-api/mapping.po +++ b/c-api/mapping.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +27,8 @@ msgid "Mapping Protocol" msgstr "" msgid "" -"See also :c:func:`PyObject_GetItem`, :c:func:`PyObject_SetItem` and :c:func:" -"`PyObject_DelItem`." +"See also :c:func:`PyObject_GetItem`, :c:func:`PyObject_SetItem` " +"and :c:func:`PyObject_DelItem`." msgstr "" msgid "" @@ -46,9 +45,9 @@ msgid "" msgstr "" msgid "" -"This is the same as :c:func:`PyObject_GetItem`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyObject_GetItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -71,18 +70,18 @@ msgid "" msgstr "" msgid "" -"This is the same as :c:func:`PyObject_SetItem`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyObject_SetItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "This is an alias of :c:func:`PyObject_DelItem`." msgstr "" msgid "" -"This is the same as :c:func:`PyObject_DelItem`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyObject_DelItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -104,24 +103,24 @@ msgid "" msgstr "" msgid "" -"Exceptions which occur when this calls :meth:`~object.__getitem__` method " -"are silently ignored. For proper error handling, use :c:func:" -"`PyMapping_HasKeyWithError`, :c:func:`PyMapping_GetOptionalItem` or :c:func:" -"`PyObject_GetItem()` instead." +"Exceptions which occur when this calls the :meth:`~object.__getitem__` " +"method are silently ignored. For proper error handling, " +"use :c:func:`PyMapping_HasKeyWithError`, :c:func:`PyMapping_GetOptionalItem` " +"or :c:func:`PyObject_GetItem()` instead." msgstr "" msgid "" -"This is the same as :c:func:`PyMapping_HasKey`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyMapping_HasKey`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" -"Exceptions that occur when this calls :meth:`~object.__getitem__` method or " -"while creating the temporary :class:`str` object are silently ignored. For " -"proper error handling, use :c:func:`PyMapping_HasKeyStringWithError`, :c:" -"func:`PyMapping_GetOptionalItemString` or :c:func:`PyMapping_GetItemString` " -"instead." +"Exceptions that occur when this calls the :meth:`~object.__getitem__` method " +"or while creating the temporary :class:`str` object are silently ignored. " +"For proper error handling, " +"use :c:func:`PyMapping_HasKeyStringWithError`, :c:func:`PyMapping_GetOptionalItemString` " +"or :c:func:`PyMapping_GetItemString` instead." msgstr "" msgid "" diff --git a/c-api/memory.po b/c-api/memory.po index 1d823a8221..4e353683a8 100644 --- a/c-api/memory.po +++ b/c-api/memory.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,13 +80,14 @@ msgstr "" msgid "" "To avoid memory corruption, extension writers should never try to operate on " -"Python objects with the functions exported by the C library: :c:func:" -"`malloc`, :c:func:`calloc`, :c:func:`realloc` and :c:func:`free`. This will " -"result in mixed calls between the C allocator and the Python memory manager " -"with fatal consequences, because they implement different algorithms and " -"operate on different heaps. However, one may safely allocate and release " -"memory blocks with the C library allocator for individual purposes, as shown " -"in the following example::" +"Python objects with the functions exported by the C " +"library: :c:func:`malloc`, :c:func:`calloc`, :c:func:`realloc` " +"and :c:func:`free`. This will result in mixed calls between the C " +"allocator and the Python memory manager with fatal consequences, because " +"they implement different algorithms and operate on different heaps. " +"However, one may safely allocate and release memory blocks with the C " +"library allocator for individual purposes, as shown in the following " +"example::" msgstr "" msgid "" @@ -122,8 +121,8 @@ msgid "" "certain circumstances, the Python memory manager may or may not trigger " "appropriate actions, like garbage collection, memory compaction or other " "preventive procedures. Note that by using the C library allocator as shown " -"in the previous example, the allocated memory for the I/O buffer escapes " -"completely the Python memory manager." +"in the previous example, the allocated memory for the I/O buffer completely " +"escapes the Python memory manager." msgstr "" msgid "" @@ -146,8 +145,8 @@ msgid "" "allocation strategies and are optimized for different purposes. The specific " "details on how every domain allocates memory or what internal functions each " "domain calls is considered an implementation detail, but for debugging " -"purposes a simplified table can be found at :ref:`here `. The APIs used to allocate and free a block of memory must be " +"purposes a simplified table can be found at :ref:`default-memory-" +"allocators`. The APIs used to allocate and free a block of memory must be " "from the same domain. For example, :c:func:`PyMem_Free` must be used to free " "memory allocated using :c:func:`PyMem_Malloc`." msgstr "" @@ -166,8 +165,8 @@ msgstr "" msgid "" "\"Mem\" domain: intended for allocating memory for Python buffers and " "general-purpose memory buffers where the allocation must be performed with " -"the :term:`GIL` held. The memory is taken from the Python private heap. See :" -"ref:`Memory Interface `." +"the :term:`GIL` held. The memory is taken from the Python private heap. " +"See :ref:`Memory Interface `." msgstr "" msgid "" @@ -184,9 +183,9 @@ msgid "" msgstr "" msgid "" -"For example, buffers (non-Python objects) should be allocated using :c:func:" -"`PyMem_Malloc`, :c:func:`PyMem_RawMalloc`, or :c:func:`malloc`, but not :c:" -"func:`PyObject_Malloc`." +"For example, buffers (non-Python objects) should be allocated " +"using :c:func:`PyMem_Malloc`, :c:func:`PyMem_RawMalloc`, " +"or :c:func:`malloc`, but not :c:func:`PyObject_Malloc`." msgstr "" msgid "See :ref:`Memory Allocation APIs `." @@ -220,9 +219,9 @@ msgid "" msgstr "" msgid "" -"Allocates *nelem* elements each whose size in bytes is *elsize* and returns " -"a pointer of type :c:expr:`void*` to the allocated memory, or ``NULL`` if " -"the request fails. The memory is initialized to zeros." +"Allocates *nelem* elements each of size *elsize* bytes and returns a pointer " +"of type :c:expr:`void*` to the allocated memory, or ``NULL`` if the request " +"fails. The memory is initialized to zeros." msgstr "" msgid "" @@ -243,9 +242,9 @@ msgid "" msgstr "" msgid "" -"Unless *p* is ``NULL``, it must have been returned by a previous call to :c:" -"func:`PyMem_RawMalloc`, :c:func:`PyMem_RawRealloc` or :c:func:" -"`PyMem_RawCalloc`." +"Unless *p* is ``NULL``, it must have been returned by a previous call " +"to :c:func:`PyMem_RawMalloc`, :c:func:`PyMem_RawRealloc` " +"or :c:func:`PyMem_RawCalloc`." msgstr "" msgid "" @@ -255,9 +254,9 @@ msgstr "" msgid "" "Frees the memory block pointed to by *p*, which must have been returned by a " -"previous call to :c:func:`PyMem_RawMalloc`, :c:func:`PyMem_RawRealloc` or :c:" -"func:`PyMem_RawCalloc`. Otherwise, or if ``PyMem_RawFree(p)`` has been " -"called before, undefined behavior occurs." +"previous call to :c:func:`PyMem_RawMalloc`, :c:func:`PyMem_RawRealloc` " +"or :c:func:`PyMem_RawCalloc`. Otherwise, or if ``PyMem_RawFree(p)`` has " +"been called before, undefined behavior occurs." msgstr "" msgid "If *p* is ``NULL``, no operation is performed." @@ -273,8 +272,8 @@ msgid "" msgstr "" msgid "" -"The :ref:`default memory allocator ` uses the :" -"ref:`pymalloc memory allocator `." +"The :ref:`default memory allocator ` uses " +"the :ref:`pymalloc memory allocator `." msgstr "" msgid "" @@ -305,8 +304,8 @@ msgid "" msgstr "" msgid "" -"Unless *p* is ``NULL``, it must have been returned by a previous call to :c:" -"func:`PyMem_Malloc`, :c:func:`PyMem_Realloc` or :c:func:`PyMem_Calloc`." +"Unless *p* is ``NULL``, it must have been returned by a previous call " +"to :c:func:`PyMem_Malloc`, :c:func:`PyMem_Realloc` or :c:func:`PyMem_Calloc`." msgstr "" msgid "" @@ -316,9 +315,9 @@ msgstr "" msgid "" "Frees the memory block pointed to by *p*, which must have been returned by a " -"previous call to :c:func:`PyMem_Malloc`, :c:func:`PyMem_Realloc` or :c:func:" -"`PyMem_Calloc`. Otherwise, or if ``PyMem_Free(p)`` has been called before, " -"undefined behavior occurs." +"previous call to :c:func:`PyMem_Malloc`, :c:func:`PyMem_Realloc` " +"or :c:func:`PyMem_Calloc`. Otherwise, or if ``PyMem_Free(p)`` has been " +"called before, undefined behavior occurs." msgstr "" msgid "" @@ -349,36 +348,40 @@ msgstr "" msgid "Same as :c:func:`PyMem_Free`." msgstr "" +msgid "Deprecated aliases" +msgstr "" + msgid "" -"In addition, the following macro sets are provided for calling the Python " -"memory allocator directly, without involving the C API functions listed " -"above. However, note that their use does not preserve binary compatibility " -"across Python versions and is therefore deprecated in extension modules." +"These are :term:`soft deprecated` aliases to existing functions and macros. " +"They exist solely for backwards compatibility." msgstr "" -"Dodać należy, że następujący zbiór makropoleceń dostarczony jest aby " -"odwoływać się do programu przydzielającego pamięć w języku pytonowskim " -"bezpośrednio, bez udziału zadań sprzęgu C wymienionych powyżej. Jednakże, " -"zauważ, że ich użycie nie zachowuje wzajemnej zgodności binarnej pomiędzy " -"wersjami Pythona i z tego też powodu ich użycie jest niewskazane w modułach " -"rozszerzających." -msgid "``PyMem_MALLOC(size)``" -msgstr "``PyMem_MALLOC(size)``" +msgid "Deprecated alias" +msgstr "" -msgid "``PyMem_NEW(type, size)``" -msgstr "``PyMem_NEW(type, size)``" +msgid "Corresponding function or macro" +msgstr "" -msgid "``PyMem_REALLOC(ptr, size)``" -msgstr "``PyMem_REALLOC(ptr, size)``" +msgid ":c:func:`PyMem_Malloc`" +msgstr "" -msgid "``PyMem_RESIZE(ptr, type, size)``" +msgid ":c:macro:`PyMem_New`" msgstr "" -msgid "``PyMem_FREE(ptr)``" -msgstr "``PyMem_FREE(ptr)``" +msgid ":c:func:`PyMem_Realloc`" +msgstr ":c:func:`PyMem_Realloc`" -msgid "``PyMem_DEL(ptr)``" -msgstr "``PyMem_DEL(ptr)``" +msgid ":c:macro:`PyMem_Resize`" +msgstr "" + +msgid ":c:func:`PyMem_Free`" +msgstr ":c:func:`PyMem_Free`" + +msgid "" +"The macros are now aliases of the corresponding functions and macros. " +"Previously, their behavior was the same, but their use did not necessarily " +"preserve binary compatibility across Python versions." +msgstr "" msgid "Object allocators" msgstr "" @@ -391,8 +394,8 @@ msgid "" msgstr "" msgid "" -"The :ref:`default object allocator ` uses the :" -"ref:`pymalloc memory allocator `." +"The :ref:`default object allocator ` uses " +"the :ref:`pymalloc memory allocator `." msgstr "" msgid "" @@ -414,9 +417,9 @@ msgid "" msgstr "" msgid "" -"Unless *p* is ``NULL``, it must have been returned by a previous call to :c:" -"func:`PyObject_Malloc`, :c:func:`PyObject_Realloc` or :c:func:" -"`PyObject_Calloc`." +"Unless *p* is ``NULL``, it must have been returned by a previous call " +"to :c:func:`PyObject_Malloc`, :c:func:`PyObject_Realloc` " +"or :c:func:`PyObject_Calloc`." msgstr "" msgid "" @@ -426,9 +429,9 @@ msgstr "" msgid "" "Frees the memory block pointed to by *p*, which must have been returned by a " -"previous call to :c:func:`PyObject_Malloc`, :c:func:`PyObject_Realloc` or :c:" -"func:`PyObject_Calloc`. Otherwise, or if ``PyObject_Free(p)`` has been " -"called before, undefined behavior occurs." +"previous call to :c:func:`PyObject_Malloc`, :c:func:`PyObject_Realloc` " +"or :c:func:`PyObject_Calloc`. Otherwise, or if ``PyObject_Free(p)`` has " +"been called before, undefined behavior occurs." msgstr "" msgid "Default Memory Allocators" @@ -495,8 +498,9 @@ msgid "Name: value for :envvar:`PYTHONMALLOC` environment variable." msgstr "" msgid "" -"``malloc``: system allocators from the standard C library, C functions: :c:" -"func:`malloc`, :c:func:`calloc`, :c:func:`realloc` and :c:func:`free`." +"``malloc``: system allocators from the standard C library, C " +"functions: :c:func:`malloc`, :c:func:`calloc`, :c:func:`realloc` " +"and :c:func:`free`." msgstr "" msgid "``pymalloc``: :ref:`pymalloc memory allocator `." @@ -560,8 +564,8 @@ msgid "free a memory block" msgstr "" msgid "" -"The :c:type:`!PyMemAllocator` structure was renamed to :c:type:" -"`PyMemAllocatorEx` and a new ``calloc`` field was added." +"The :c:type:`!PyMemAllocator` structure was renamed " +"to :c:type:`PyMemAllocatorEx` and a new ``calloc`` field was added." msgstr "" msgid "Enum used to identify an allocator domain. Domains:" @@ -585,15 +589,9 @@ msgstr ":c:func:`PyMem_RawFree`" msgid ":c:func:`PyMem_Malloc`," msgstr ":c:func:`PyMem_Malloc`," -msgid ":c:func:`PyMem_Realloc`" -msgstr ":c:func:`PyMem_Realloc`" - msgid ":c:func:`PyMem_Calloc`" msgstr ":c:func:`PyMem_Calloc`" -msgid ":c:func:`PyMem_Free`" -msgstr ":c:func:`PyMem_Free`" - msgid ":c:func:`PyObject_Malloc`" msgstr ":c:func:`PyObject_Malloc`" @@ -644,19 +642,19 @@ msgid ":c:func:`PyMem_SetAllocator` does have the following contract:" msgstr "" msgid "" -"It can be called after :c:func:`Py_PreInitialize` and before :c:func:" -"`Py_InitializeFromConfig` to install a custom memory allocator. There are no " -"restrictions over the installed allocator other than the ones imposed by the " -"domain (for instance, the Raw Domain allows the allocator to be called " -"without the GIL held). See :ref:`the section on allocator domains ` for more information." +"It can be called after :c:func:`Py_PreInitialize` and " +"before :c:func:`Py_InitializeFromConfig` to install a custom memory " +"allocator. There are no restrictions over the installed allocator other than " +"the ones imposed by the domain (for instance, the Raw Domain allows the " +"allocator to be called without the GIL held). See :ref:`the section on " +"allocator domains ` for more information." msgstr "" msgid "" -"If called after Python has finish initializing (after :c:func:" -"`Py_InitializeFromConfig` has been called) the allocator **must** wrap the " -"existing allocator. Substituting the current allocator for some other " -"arbitrary one is **not supported**." +"If called after Python has finish initializing " +"(after :c:func:`Py_InitializeFromConfig` has been called) the allocator " +"**must** wrap the existing allocator. Substituting the current allocator for " +"some other arbitrary one is **not supported**." msgstr "" msgid "All allocators must be thread-safe." @@ -671,8 +669,8 @@ msgid "Debug hooks on the Python memory allocators" msgstr "" msgid "" -"When :ref:`Python is built in debug mode `, the :c:func:" -"`PyMem_SetupDebugHooks` function is called at the :ref:`Python " +"When :ref:`Python is built in debug mode `, " +"the :c:func:`PyMem_SetupDebugHooks` function is called at the :ref:`Python " "preinitialization ` to setup debug hooks on Python memory " "allocators to detect memory errors." msgstr "" @@ -812,10 +810,11 @@ msgstr "" msgid "" "The :c:func:`PyMem_SetupDebugHooks` function now also works on Python " -"compiled in release mode. On error, the debug hooks now use :mod:" -"`tracemalloc` to get the traceback where a memory block was allocated. The " -"debug hooks now also check if the GIL is held when functions of :c:macro:" -"`PYMEM_DOMAIN_OBJ` and :c:macro:`PYMEM_DOMAIN_MEM` domains are called." +"compiled in release mode. On error, the debug hooks now " +"use :mod:`tracemalloc` to get the traceback where a memory block was " +"allocated. The debug hooks now also check if the GIL is held when functions " +"of :c:macro:`PYMEM_DOMAIN_OBJ` and :c:macro:`PYMEM_DOMAIN_MEM` domains are " +"called." msgstr "" msgid "" @@ -832,14 +831,14 @@ msgid "" "Python has a *pymalloc* allocator optimized for small objects (smaller or " "equal to 512 bytes) with a short lifetime. It uses memory mappings called " "\"arenas\" with a fixed size of either 256 KiB on 32-bit platforms or 1 MiB " -"on 64-bit platforms. It falls back to :c:func:`PyMem_RawMalloc` and :c:func:" -"`PyMem_RawRealloc` for allocations larger than 512 bytes." +"on 64-bit platforms. It falls back to :c:func:`PyMem_RawMalloc` " +"and :c:func:`PyMem_RawRealloc` for allocations larger than 512 bytes." msgstr "" msgid "" "*pymalloc* is the :ref:`default allocator ` of " -"the :c:macro:`PYMEM_DOMAIN_MEM` (ex: :c:func:`PyMem_Malloc`) and :c:macro:" -"`PYMEM_DOMAIN_OBJ` (ex: :c:func:`PyObject_Malloc`) domains." +"the :c:macro:`PYMEM_DOMAIN_MEM` (ex: :c:func:`PyMem_Malloc`) " +"and :c:macro:`PYMEM_DOMAIN_OBJ` (ex: :c:func:`PyObject_Malloc`) domains." msgstr "" msgid "The arena allocator uses the following functions:" @@ -856,8 +855,15 @@ msgstr "" msgid "" "This allocator is disabled if Python is configured with the :option:`--" -"without-pymalloc` option. It can also be disabled at runtime using the :" -"envvar:`PYTHONMALLOC` environment variable (ex: ``PYTHONMALLOC=malloc``)." +"without-pymalloc` option. It can also be disabled at runtime using " +"the :envvar:`PYTHONMALLOC` environment variable (ex: " +"``PYTHONMALLOC=malloc``)." +msgstr "" + +msgid "" +"Typically, it makes sense to disable the pymalloc allocator when building " +"Python with AddressSanitizer (:option:`--with-address-sanitizer`) which " +"helps uncover low level bugs within the C code." msgstr "" msgid "Customize pymalloc Arena Allocator" @@ -926,8 +932,8 @@ msgid "" "the I/O buffer is allocated from the Python heap by using the first function " "set::" msgstr "" -"Tutaj jest przykład z sekcji \"przeglądu pamięci\" - z ang. - :ref:" -"`memoryoverview`, przepisane, tak aby przestrzeń wejścia/wyjścia była " +"Tutaj jest przykład z sekcji \"przeglądu pamięci\" - z ang. " +"- :ref:`memoryoverview`, przepisane, tak aby przestrzeń wejścia/wyjścia była " "przydzielona ze sterty Pythona używając pierwszego zestawu zadań::" msgid "" @@ -985,8 +991,9 @@ msgstr "" msgid "" "In addition to the functions aimed at handling raw memory blocks from the " -"Python heap, objects in Python are allocated and released with :c:macro:" -"`PyObject_New`, :c:macro:`PyObject_NewVar` and :c:func:`PyObject_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 "" diff --git a/c-api/memoryview.po b/c-api/memoryview.po index ac83d71139..74f89b08e7 100644 --- a/c-api/memoryview.po +++ b/c-api/memoryview.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,6 +32,11 @@ msgid "" "other object." msgstr "" +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python memoryview " +"type. This is the same object as :class:`memoryview` in the Python layer." +msgstr "" + msgid "" "Create a memoryview object from an object that provides the buffer " "interface. If *obj* supports writable buffer exports, the memoryview object " @@ -82,9 +87,10 @@ msgstr "" msgid "" "Return either a pointer to the exporting object that the memoryview is based " -"on or ``NULL`` if the memoryview has been created by one of the functions :c:" -"func:`PyMemoryView_FromMemory` or :c:func:`PyMemoryView_FromBuffer`. *mview* " -"**must** be a memoryview instance." +"on or ``NULL`` if the memoryview has been created by one of the " +"functions :c:func:`PyMemoryView_FromMemory` " +"or :c:func:`PyMemoryView_FromBuffer`. *mview* **must** be a memoryview " +"instance." msgstr "" msgid "object" diff --git a/c-api/method.po b/c-api/method.po index 895c628633..5551b2bcbe 100644 --- a/c-api/method.po +++ b/c-api/method.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Maciej Olko , 2024 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,9 +38,9 @@ msgid "" msgstr "" msgid "" -"Return true if *o* is an instance method object (has type :c:data:" -"`PyInstanceMethod_Type`). The parameter must not be ``NULL``. This function " -"always succeeds." +"Return true if *o* is an instance method object (has " +"type :c:data:`PyInstanceMethod_Type`). The parameter must not be ``NULL``. " +"This function always succeeds." msgstr "" msgid "" diff --git a/c-api/module.po b/c-api/module.po index 688da7eb9d..2504f9af80 100644 --- a/c-api/module.po +++ b/c-api/module.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# haaritsubaki, 2023 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +29,7 @@ msgstr "" msgid "" "This instance of :c:type:`PyTypeObject` represents the Python module type. " -"This is exposed to Python programs as ``types.ModuleType``." +"This is exposed to Python programs as :py:class:`types.ModuleType`." msgstr "" msgid "" @@ -38,16 +38,17 @@ msgid "" msgstr "" msgid "" -"Return true if *p* is a module object, but not a subtype of :c:data:" -"`PyModule_Type`. This function always succeeds." +"Return true if *p* is a module object, but not a subtype " +"of :c:data:`PyModule_Type`. This function always succeeds." msgstr "" msgid "" "Return a new module object with :attr:`module.__name__` set to *name*. The " -"module's :attr:`!__name__`, :attr:`~module.__doc__`, :attr:`~module." -"__package__` and :attr:`~module.__loader__` attributes are filled in (all " -"but :attr:`!__name__` are set to ``None``). The caller is responsible for " -"setting a :attr:`~module.__file__` attribute." +"module's :attr:`!" +"__name__`, :attr:`~module.__doc__`, :attr:`~module.__package__` " +"and :attr:`~module.__loader__` attributes are filled in (all but :attr:`!" +"__name__` are set to ``None``). The caller is responsible for setting " +"a :attr:`~module.__file__` attribute." msgstr "" msgid "Return ``NULL`` with an exception set on error." @@ -72,8 +73,13 @@ msgstr "" msgid "" "It is recommended extensions use other ``PyModule_*`` and ``PyObject_*`` " -"functions rather than directly manipulate a module's :attr:`~object." -"__dict__`." +"functions rather than directly manipulate a " +"module's :attr:`~object.__dict__`." +msgstr "" + +msgid "" +"The returned reference is borrowed from the module; it is valid until the " +"module is destroyed." msgstr "" msgid "" @@ -87,10 +93,16 @@ msgid "" "``'utf-8'``." msgstr "" +msgid "" +"The returned buffer is only valid until the module is renamed or destroyed. " +"Note that Python code may rename a module by setting " +"its :py:attr:`~module.__name__` attribute." +msgstr "" + msgid "" "Return the \"state\" of the module, that is, a pointer to the block of " -"memory allocated at module creation time, or ``NULL``. See :c:member:" -"`PyModuleDef.m_size`." +"memory allocated at module creation time, or ``NULL``. " +"See :c:member:`PyModuleDef.m_size`." msgstr "" msgid "" @@ -99,10 +111,16 @@ msgid "" msgstr "" msgid "" -"Return the name of the file from which *module* was loaded using *module*'s :" -"attr:`~module.__file__` attribute. If this is not defined, or if it is not " -"a string, raise :exc:`SystemError` and return ``NULL``; otherwise return a " -"reference to a Unicode object." +"On error, return ``NULL`` with an exception set. " +"Use :c:func:`PyErr_Occurred` to tell this case apart from a " +"missing :c:type:`!PyModuleDef`." +msgstr "" + +msgid "" +"Return the name of the file from which *module* was loaded using " +"*module*'s :attr:`~module.__file__` attribute. If this is not defined, or " +"if it is not a string, raise :exc:`SystemError` and return ``NULL``; " +"otherwise return a reference to a Unicode object." msgstr "" msgid "" @@ -110,6 +128,12 @@ msgid "" "encoded to 'utf-8'." msgstr "" +msgid "" +"The returned buffer is only valid until the " +"module's :py:attr:`~module.__file__` attribute is reassigned or the module " +"is destroyed." +msgstr "" + msgid "" ":c:func:`PyModule_GetFilename` raises :exc:`UnicodeEncodeError` on " "unencodable filenames, use :c:func:`PyModule_GetFilenameObject` instead." @@ -126,9 +150,10 @@ msgid "" 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." +"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 "" @@ -144,8 +169,8 @@ msgid "Name for the new module." msgstr "" msgid "" -"Docstring for the module; usually a docstring variable created with :c:macro:" -"`PyDoc_STRVAR` is used." +"Docstring for the module; usually a docstring variable created " +"with :c:macro:`PyDoc_STRVAR` is used." msgstr "" msgid "" @@ -156,8 +181,8 @@ msgstr "" msgid "" "This memory area is allocated based on *m_size* on module creation, and " -"freed when the module object is deallocated, after the :c:member:" -"`~PyModuleDef.m_free` function has been called, if present." +"freed when the module object is deallocated, after " +"the :c:member:`~PyModuleDef.m_free` function has been called, if present." msgstr "" msgid "" @@ -176,8 +201,9 @@ msgid "See :PEP:`3121` for more details." msgstr "" msgid "" -"A pointer to a table of module-level functions, described by :c:type:" -"`PyMethodDef` values. Can be ``NULL`` if no functions are present." +"A pointer to a table of module-level functions, described " +"by :c:type:`PyMethodDef` values. Can be ``NULL`` if no functions are " +"present." msgstr "" msgid "" @@ -201,8 +227,8 @@ msgid "" "allocated yet. This is the case immediately after the module is created and " "before the module is executed (:c:data:`Py_mod_exec` function). More " "precisely, this function is not called if :c:member:`~PyModuleDef.m_size` is " -"greater than 0 and the module state (as returned by :c:func:" -"`PyModule_GetState`) is ``NULL``." +"greater than 0 and the module state (as returned " +"by :c:func:`PyModule_GetState`) is ``NULL``." msgstr "" msgid "No longer called before the module state is allocated." @@ -226,6 +252,9 @@ msgid "" "not needed." msgstr "" +msgid "The type of ``PyModuleDef`` objects." +msgstr "" + msgid "Single-phase initialization" msgstr "" @@ -237,8 +266,8 @@ 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`." +"like :c:func:`PyModule_Create2` with *module_api_version* set " +"to :c:macro:`PYTHON_API_VERSION`." msgstr "" msgid "" @@ -254,45 +283,65 @@ 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`." +"module object is typically populated using functions " +"like :c:func:`PyModule_AddObjectRef`." msgstr "" msgid "Multi-phase initialization" -msgstr "" +msgstr "Inicjalizacja wielofazowa" 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." +"The distinction is similar to the :py:meth:`~object.__new__` " +"and :py:meth:`~object.__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`)." +"not singletons. For example, if the :py:attr:`sys.modules` entry is removed " +"and the module is re-imported, a new module object is created, and typically " +"populated with fresh method and type objects. The old module is subject to " +"normal garbage collection. This mirrors the behavior of pure-Python modules." +msgstr "" + +msgid "" +"Additional module instances may be created in :ref:`sub-interpreters ` or after after Python runtime reinitialization " +"(:c:func:`Py_Finalize` and :c:func:`Py_Initialize`). In these cases, sharing " +"Python objects between module instances would likely cause crashes or " +"undefined behavior." +msgstr "" + +msgid "" +"To avoid such issues, each instance of an extension module should be " +"*isolated*: changes to one instance should not implicitly affect the others, " +"and all state, including references to Python objects, should be specific to " +"a particular module instance. See :ref:`isolating-extensions-howto` for more " +"details and a practical guide." +msgstr "" + +msgid "" +"A simpler way to avoid these issues is :ref:`raising an error on repeated " +"initialization `." msgstr "" msgid "" "All modules created using multi-phase initialization are expected to " -"support :ref:`sub-interpreters `. Making sure " -"multiple modules are independent is typically enough to achieve this." +"support :ref:`sub-interpreters `, or otherwise " +"explicitly signal a lack of support. This is usually achieved by isolation " +"or blocking repeated initialization, as above. A module may also be limited " +"to the main interpreter using the :c:data:`Py_mod_multiple_interpreters` " +"slot." msgstr "" msgid "" "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:" +"(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 "" @@ -351,12 +400,12 @@ msgid "" msgstr "" msgid "" -"There is no requirement for the returned object to be an instance of :c:type:" -"`PyModule_Type`. Any type can be used, as long as it supports setting and " -"getting import-related attributes. However, only ``PyModule_Type`` instances " -"may be returned if the ``PyModuleDef`` has non-``NULL`` ``m_traverse``, " -"``m_clear``, ``m_free``; non-zero ``m_size``; or slots other than " -"``Py_mod_create``." +"There is no requirement for the returned object to be an instance " +"of :c:type:`PyModule_Type`. Any type can be used, as long as it supports " +"setting and getting import-related attributes. However, only " +"``PyModule_Type`` instances may be returned if the ``PyModuleDef`` has non-" +"``NULL`` ``m_traverse``, ``m_clear``, ``m_free``; non-zero ``m_size``; or " +"slots other than ``Py_mod_create``." msgstr "" msgid "" @@ -466,6 +515,9 @@ msgid "" "``PyModule_Create`` or ``PyModule_FromDefAndSpec``." msgstr "" +msgid "Return ``0`` on success. Return ``-1`` with an exception set on error." +msgstr "" + msgid "" "Add the functions from the ``NULL`` terminated *functions* array to " "*module*. Refer to the :c:type:`PyMethodDef` documentation for details on " @@ -477,6 +529,11 @@ msgid "" "``PyModule_FromDefAndSpec``." msgstr "" +msgid "" +"The *functions* array must be statically allocated (or otherwise guaranteed " +"to outlive the module object)." +msgstr "" + msgid "Support functions" msgstr "" @@ -543,17 +600,17 @@ msgstr "" msgid "" "The number of different *name* strings passed to this function should be " "kept small, usually by only using statically allocated strings as *name*. " -"For names that aren't known at compile time, prefer calling :c:func:" -"`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` directly. For more " -"details, see :c:func:`PyUnicode_InternFromString`, which may be used " -"internally to create a key object." +"For names that aren't known at compile time, prefer " +"calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` " +"directly. For more details, see :c:func:`PyUnicode_InternFromString`, which " +"may be used internally to create a key object." msgstr "" msgid "" -"Similar to :c:func:`PyModule_AddObjectRef`, but \"steals\" a reference to " -"*value*. It can be called with a result of function that returns a new " -"reference without bothering to check its result or even saving it to a " -"variable." +"Similar to :c:func:`PyModule_AddObjectRef`, but \":term:`steals `\" a " +"reference to *value* (even on error). It can be called with a result of " +"function that returns a new reference without bothering to check its result " +"or even saving it to a variable." msgstr "" msgid "" @@ -563,8 +620,8 @@ msgid "" msgstr "" msgid "" -"Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to " -"*value* on success (if it returns ``0``)." +"Similar to :c:func:`PyModule_AddObjectRef`, but :term:`steals ` a " +"reference to *value* on success (if it returns ``0``)." msgstr "" msgid "" @@ -579,8 +636,8 @@ msgid "" msgstr "" msgid "" -"This means that its return value must be checked, and calling code must :c:" -"func:`Py_XDECREF` *value* manually on error." +"This means that its return value must be checked, and calling code " +"must :c:func:`Py_XDECREF` *value* manually on error." msgstr "" msgid "" @@ -596,9 +653,6 @@ msgid "" "// Py_XDECREF(obj) is not needed here." msgstr "" -msgid ":c:func:`PyModule_AddObject` is :term:`soft deprecated`." -msgstr "" - msgid "" "Add an integer constant to *module* as *name*. This convenience function " "can be used from the module's initialization function. Return ``-1`` with an " @@ -606,8 +660,8 @@ msgid "" msgstr "" msgid "" -"This is a convenience function that calls :c:func:`PyLong_FromLong` and :c:" -"func:`PyModule_AddObjectRef`; see their documentation for details." +"This is a convenience function that calls :c:func:`PyLong_FromLong` " +"and :c:func:`PyModule_AddObjectRef`; see their documentation for details." msgstr "" msgid "" @@ -618,9 +672,9 @@ msgid "" msgstr "" msgid "" -"This is a convenience function that calls :c:func:" -"`PyUnicode_InternFromString` and :c:func:`PyModule_AddObjectRef`; see their " -"documentation for details." +"This is a convenience function that " +"calls :c:func:`PyUnicode_InternFromString` " +"and :c:func:`PyModule_AddObjectRef`; see their documentation for details." msgstr "" msgid "" @@ -675,8 +729,8 @@ msgstr "" msgid "" "Attaches the module object passed to the function to the interpreter state. " -"This allows the module object to be accessible via :c:func:" -"`PyState_FindModule`." +"This allows the module object to be accessible " +"via :c:func:`PyState_FindModule`." msgstr "" msgid "Only effective on modules created using single-phase initialization." diff --git a/c-api/monitoring.po b/c-api/monitoring.po index b82aaae41d..f5988dfc18 100644 --- a/c-api/monitoring.po +++ b/c-api/monitoring.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 +# Marcin Bardź, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-05-11 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Marcin Bardź, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,7 +28,7 @@ msgid "Monitoring C API" msgstr "" msgid "Added in version 3.13." -msgstr "" +msgstr "Dodane w wersji 3.13." msgid "" "An extension may need to interact with the event monitoring system. " @@ -45,10 +45,10 @@ msgid "" "accepts a ``PyMonitoringState`` struct which contains concise information " "about the activation state of events, as well as the event arguments, which " "include a ``PyObject*`` representing the code object, the instruction offset " -"and sometimes additional, event-specific arguments (see :mod:`sys." -"monitoring` for details about the signatures of the different event " -"callbacks). The ``codelike`` argument should be an instance of :class:`types." -"CodeType` or of a type that emulates it." +"and sometimes additional, event-specific arguments " +"(see :mod:`sys.monitoring` for details about the signatures of the different " +"event callbacks). The ``codelike`` argument should be an instance " +"of :class:`types.CodeType` or of a type that emulates it." msgstr "" msgid "" @@ -103,23 +103,23 @@ msgid "Fire a ``C_RETURN`` event." msgstr "" msgid "" -"Fire a ``PY_THROW`` event with the current exception (as returned by :c:func:" -"`PyErr_GetRaisedException`)." +"Fire a ``PY_THROW`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" -"Fire a ``RAISE`` event with the current exception (as returned by :c:func:" -"`PyErr_GetRaisedException`)." +"Fire a ``RAISE`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" -"Fire a ``C_RAISE`` event with the current exception (as returned by :c:func:" -"`PyErr_GetRaisedException`)." +"Fire a ``C_RAISE`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" -"Fire a ``RERAISE`` event with the current exception (as returned by :c:func:" -"`PyErr_GetRaisedException`)." +"Fire a ``RERAISE`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" @@ -128,14 +128,14 @@ msgid "" msgstr "" msgid "" -"Fire a ``PY_UNWIND`` event with the current exception (as returned by :c:" -"func:`PyErr_GetRaisedException`)." +"Fire a ``PY_UNWIND`` event with the current exception (as returned " +"by :c:func:`PyErr_GetRaisedException`)." msgstr "" msgid "" -"Fire a ``STOP_ITERATION`` event. If ``value`` is an instance of :exc:" -"`StopIteration`, it is used. Otherwise, a new :exc:`StopIteration` instance " -"is created with ``value`` as its argument." +"Fire a ``STOP_ITERATION`` event. If ``value`` is an instance " +"of :exc:`StopIteration`, it is used. Otherwise, a new :exc:`StopIteration` " +"instance is created with ``value`` as its argument." msgstr "" msgid "Managing the Monitoring State" @@ -143,19 +143,19 @@ msgstr "" msgid "" "Monitoring states can be managed with the help of monitoring scopes. A scope " -"would typically correspond to a python function." +"would typically correspond to a Python function." msgstr "" msgid "" "Enter a monitored scope. ``event_types`` is an array of the event IDs for " "events that may be fired from the scope. For example, the ID of a " "``PY_START`` event is the value ``PY_MONITORING_EVENT_PY_START``, which is " -"numerically equal to the base-2 logarithm of ``sys.monitoring.events." -"PY_START``. ``state_array`` is an array with a monitoring state entry for " -"each event in ``event_types``, it is allocated by the user but populated by :" -"c:func:`!PyMonitoring_EnterScope` with information about the activation " -"state of the event. The size of ``event_types`` (and hence also of " -"``state_array``) is given in ``length``." +"numerically equal to the base-2 logarithm of " +"``sys.monitoring.events.PY_START``. ``state_array`` is an array with a " +"monitoring state entry for each event in ``event_types``, it is allocated by " +"the user but populated by :c:func:`!PyMonitoring_EnterScope` with " +"information about the activation state of the event. The size of " +"``event_types`` (and hence also of ``state_array``) is given in ``length``." msgstr "" msgid "" @@ -243,6 +243,3 @@ msgid "" "Return true if the event corresponding to the event ID *ev* is a :ref:`local " "event `." msgstr "" - -msgid "This function is :term:`soft deprecated`." -msgstr "" diff --git a/c-api/none.po b/c-api/none.po index db3ede2a11..d03aab2789 100644 --- a/c-api/none.po +++ b/c-api/none.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/c-api/number.po b/c-api/number.po index 5ea2a42b26..768706da94 100644 --- a/c-api/number.po +++ b/c-api/number.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# haaritsubaki, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: haaritsubaki, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -227,8 +226,8 @@ msgid "" msgstr "" msgid "" -"Returns the *o* converted to a Python int on success or ``NULL`` with a :exc:" -"`TypeError` exception raised on failure." +"Returns the *o* converted to a Python int on success or ``NULL`` with " +"a :exc:`TypeError` exception raised on failure." msgstr "" msgid "" @@ -240,8 +239,8 @@ msgid "" "Returns the integer *n* converted to base *base* as a string. The *base* " "argument must be one of 2, 8, 10, or 16. For base 2, 8, or 16, the returned " "string is prefixed with a base marker of ``'0b'``, ``'0o'``, or ``'0x'``, " -"respectively. If *n* is not a Python int, it is converted with :c:func:" -"`PyNumber_Index` first." +"respectively. If *n* is not a Python int, it is converted " +"with :c:func:`PyNumber_Index` first." msgstr "" msgid "" @@ -251,12 +250,12 @@ msgid "" msgstr "" msgid "" -"If *o* can be converted to a Python int but the attempt to convert to a :c:" -"type:`Py_ssize_t` value would raise an :exc:`OverflowError`, then the *exc* " -"argument is the type of exception that will be raised (usually :exc:" -"`IndexError` or :exc:`OverflowError`). If *exc* is ``NULL``, then the " -"exception is cleared and the value is clipped to ``PY_SSIZE_T_MIN`` for a " -"negative integer or ``PY_SSIZE_T_MAX`` for a positive integer." +"If *o* can be converted to a Python int but the attempt to convert to " +"a :c:type:`Py_ssize_t` value would raise an :exc:`OverflowError`, then the " +"*exc* argument is the type of exception that will be raised " +"(usually :exc:`IndexError` or :exc:`OverflowError`). If *exc* is ``NULL``, " +"then the exception is cleared and the value is clipped to ``PY_SSIZE_T_MIN`` " +"for a negative integer or ``PY_SSIZE_T_MAX`` for a positive integer." msgstr "" msgid "" diff --git a/c-api/object.po b/c-api/object.po index 90a823269f..36a99f26a9 100644 --- a/c-api/object.po +++ b/c-api/object.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2024 -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:49+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -113,8 +111,8 @@ msgid "" msgstr "" msgid "" -"This function is primarily intended for backwards compatibility: using :c:" -"func:`Py_GetConstant` is recommended for new code." +"This function is primarily intended for backwards compatibility: " +"using :c:func:`Py_GetConstant` is recommended for new code." msgstr "" msgid "" @@ -129,14 +127,15 @@ msgstr "" msgid "" "Properly handle returning :c:data:`Py_NotImplemented` from within a C " -"function (that is, create a new :term:`strong reference` to :const:" -"`NotImplemented` and return it)." +"function (that is, create a new :term:`strong reference` " +"to :const:`NotImplemented` and return it)." msgstr "" msgid "" -"Flag to be used with multiple functions that print the object (like :c:func:" -"`PyObject_Print` and :c:func:`PyFile_WriteObject`). If passed, these " -"function would use the :func:`str` of the object instead of the :func:`repr`." +"Flag to be used with multiple functions that print the object " +"(like :c:func:`PyObject_Print` and :c:func:`PyFile_WriteObject`). If passed, " +"these functions use the :func:`str` of the object instead of " +"the :func:`repr`." msgstr "" msgid "" @@ -164,24 +163,25 @@ msgid "" msgstr "" msgid "" -"Exceptions that occur when this calls :meth:`~object.__getattr__` and :meth:" -"`~object.__getattribute__` methods aren't propagated, but instead given to :" -"func:`sys.unraisablehook`. For proper error handling, use :c:func:" -"`PyObject_HasAttrWithError`, :c:func:`PyObject_GetOptionalAttr` or :c:func:" -"`PyObject_GetAttr` instead." +"Exceptions that occur when this calls :meth:`~object.__getattr__` " +"and :meth:`~object.__getattribute__` methods aren't propagated, but instead " +"given to :func:`sys.unraisablehook`. For proper error handling, " +"use :c:func:`PyObject_HasAttrWithError`, :c:func:`PyObject_GetOptionalAttr` " +"or :c:func:`PyObject_GetAttr` instead." msgstr "" msgid "" "This is the same as :c:func:`PyObject_HasAttr`, but *attr_name* is specified " -"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" -"Exceptions that occur when this calls :meth:`~object.__getattr__` and :meth:" -"`~object.__getattribute__` methods or while creating the temporary :class:" -"`str` object are silently ignored. For proper error handling, use :c:func:" -"`PyObject_HasAttrStringWithError`, :c:func:`PyObject_GetOptionalAttrString` " +"Exceptions that occur when this calls :meth:`~object.__getattr__` " +"and :meth:`~object.__getattribute__` methods or while creating the " +"temporary :class:`str` object are silently ignored. For proper error " +"handling, " +"use :c:func:`PyObject_HasAttrStringWithError`, :c:func:`PyObject_GetOptionalAttrString` " "or :c:func:`PyObject_GetAttrString` instead." msgstr "" @@ -192,32 +192,33 @@ msgid "" msgstr "" msgid "" -"If the missing attribute should not be treated as a failure, you can use :c:" -"func:`PyObject_GetOptionalAttr` instead." +"If the missing attribute should not be treated as a failure, you can " +"use :c:func:`PyObject_GetOptionalAttr` instead." msgstr "" msgid "" "This is the same as :c:func:`PyObject_GetAttr`, but *attr_name* is specified " -"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" -"If the missing attribute should not be treated as a failure, you can use :c:" -"func:`PyObject_GetOptionalAttrString` instead." +"If the missing attribute should not be treated as a failure, you can " +"use :c:func:`PyObject_GetOptionalAttrString` instead." msgstr "" msgid "" -"Variant of :c:func:`PyObject_GetAttr` which doesn't raise :exc:" -"`AttributeError` if the attribute is not found." +"Variant of :c:func:`PyObject_GetAttr` which doesn't " +"raise :exc:`AttributeError` if the attribute is not found." msgstr "" msgid "" -"If the attribute is found, return ``1`` and set *\\*result* to a new :term:" -"`strong reference` to the attribute. If the attribute is not found, return " -"``0`` and set *\\*result* to ``NULL``; the :exc:`AttributeError` is " -"silenced. If an error other than :exc:`AttributeError` is raised, return " -"``-1`` and set *\\*result* to ``NULL``." +"If the attribute is found, return ``1`` and set *\\*result* to a " +"new :term:`strong reference` to the attribute. If the attribute is not " +"found, return ``0`` and set *\\*result* to ``NULL``; " +"the :exc:`AttributeError` is silenced. If an error other " +"than :exc:`AttributeError` is raised, return ``-1`` and set *\\*result* to " +"``NULL``." msgstr "" msgid "" @@ -229,10 +230,11 @@ msgstr "" msgid "" "Generic attribute getter function that is meant to be put into a type " "object's ``tp_getattro`` slot. It looks for a descriptor in the dictionary " -"of classes in the object's MRO as well as an attribute in the object's :attr:" -"`~object.__dict__` (if present). As outlined in :ref:`descriptors`, data " -"descriptors take preference over instance attributes, while non-data " -"descriptors don't. Otherwise, an :exc:`AttributeError` is raised." +"of classes in the object's MRO as well as an attribute in the " +"object's :attr:`~object.__dict__` (if present). As outlined " +"in :ref:`descriptors`, data descriptors take preference over instance " +"attributes, while non-data descriptors don't. Otherwise, " +"an :exc:`AttributeError` is raised." msgstr "" msgid "" @@ -249,8 +251,8 @@ msgstr "" msgid "" "This is the same as :c:func:`PyObject_SetAttr`, but *attr_name* is specified " -"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -261,10 +263,10 @@ msgstr "" msgid "" "The number of different attribute names passed to this function should be " "kept small, usually by using a statically allocated string as *attr_name*. " -"For attribute names that aren't known at compile time, prefer calling :c:" -"func:`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` directly. For " -"more details, see :c:func:`PyUnicode_InternFromString`, which may be used " -"internally to create a key object." +"For attribute names that aren't known at compile time, prefer " +"calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_SetAttr` " +"directly. For more details, see :c:func:`PyUnicode_InternFromString`, which " +"may be used internally to create a key object." msgstr "" msgid "" @@ -285,17 +287,17 @@ msgstr "" msgid "" "This is the same as :c:func:`PyObject_DelAttr`, but *attr_name* is specified " -"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"as a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" "The number of different attribute names passed to this function should be " "kept small, usually by using a statically allocated string as *attr_name*. " -"For attribute names that aren't known at compile time, prefer calling :c:" -"func:`PyUnicode_FromString` and :c:func:`PyObject_DelAttr` directly. For " -"more details, see :c:func:`PyUnicode_InternFromString`, which may be used " -"internally to create a key object for lookup." +"For attribute names that aren't known at compile time, prefer " +"calling :c:func:`PyUnicode_FromString` and :c:func:`PyObject_DelAttr` " +"directly. For more details, see :c:func:`PyUnicode_InternFromString`, which " +"may be used internally to create a key object for lookup." msgstr "" msgid "" @@ -332,12 +334,12 @@ msgstr "" msgid "" "Compare the values of *o1* and *o2* using the operation specified by *opid*, " -"which must be one of :c:macro:`Py_LT`, :c:macro:`Py_LE`, :c:macro:`Py_EQ`, :" -"c:macro:`Py_NE`, :c:macro:`Py_GT`, or :c:macro:`Py_GE`, corresponding to " -"``<``, ``<=``, ``==``, ``!=``, ``>``, or ``>=`` respectively. This is the " -"equivalent of the Python expression ``o1 op o2``, where ``op`` is the " -"operator corresponding to *opid*. Returns the value of the comparison on " -"success, or ``NULL`` on failure." +"which must be one " +"of :c:macro:`Py_LT`, :c:macro:`Py_LE`, :c:macro:`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_GT`, " +"or :c:macro:`Py_GE`, corresponding to ``<``, ``<=``, ``==``, ``!=``, ``>``, " +"or ``>=`` respectively. This is the equivalent of the Python expression ``o1 " +"op o2``, where ``op`` is the operator corresponding to *opid*. Returns the " +"value of the comparison on success, or ``NULL`` on failure." msgstr "" msgid "" @@ -369,6 +371,9 @@ msgid "" "function." msgstr "" +msgid "If argument is ``NULL``, return the string ``''``." +msgstr "" + msgid "" "This function now includes a debug assertion to help ensure that it does not " "silently discard an active exception." @@ -376,10 +381,10 @@ msgstr "" msgid "" "As :c:func:`PyObject_Repr`, compute a string representation of object *o*, " -"but escape the non-ASCII characters in the string returned by :c:func:" -"`PyObject_Repr` with ``\\x``, ``\\u`` or ``\\U`` escapes. This generates a " -"string similar to that returned by :c:func:`PyObject_Repr` in Python 2. " -"Called by the :func:`ascii` built-in function." +"but escape the non-ASCII characters in the string returned " +"by :c:func:`PyObject_Repr` with ``\\x``, ``\\u`` or ``\\U`` escapes. This " +"generates a string similar to that returned by :c:func:`PyObject_Repr` in " +"Python 2. Called by the :func:`ascii` built-in function." msgstr "" msgid "" @@ -397,6 +402,10 @@ msgid "" "bytes object." msgstr "" +msgid "" +"If argument is ``NULL``, return the :class:`bytes` object ``b''``." +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``." @@ -411,8 +420,8 @@ msgstr "" msgid "" "If *cls* has a :meth:`~type.__subclasscheck__` method, it will be called to " "determine the subclass status as described in :pep:`3119`. Otherwise, " -"*derived* is a subclass of *cls* if it is a direct or indirect subclass, i." -"e. contained in :attr:`cls.__mro__ `." +"*derived* is a subclass of *cls* if it is a direct or indirect subclass, " +"i.e. contained in :attr:`cls.__mro__ `." msgstr "" msgid "" @@ -433,8 +442,8 @@ msgid "" msgstr "" msgid "" -"An instance *inst* can override what is considered its class by having a :" -"attr:`~object.__class__` attribute." +"An instance *inst* can override what is considered its class by having " +"a :attr:`~object.__class__` attribute." msgstr "" msgid "" @@ -519,9 +528,9 @@ msgid "" msgstr "" msgid "" -"This is the same as :c:func:`PyObject_DelItem`, but *key* is specified as a :" -"c:expr:`const char*` UTF-8 encoded bytes string, rather than a :c:expr:" -"`PyObject*`." +"This is the same as :c:func:`PyObject_DelItem`, but *key* is specified as " +"a :c:expr:`const char*` UTF-8 encoded bytes string, rather than " +"a :c:expr:`PyObject*`." msgstr "" msgid "" @@ -529,8 +538,8 @@ msgid "" "(possibly empty) list of strings appropriate for the object argument, or " "``NULL`` if there was an error. If the argument is ``NULL``, this is like " "the Python ``dir()``, returning the names of the current locals; in this " -"case, if no execution frame is active then ``NULL`` is returned but :c:func:" -"`PyErr_Occurred` will return false." +"case, if no execution frame is active then ``NULL`` is returned " +"but :c:func:`PyErr_Occurred` will return false." msgstr "" msgid "" @@ -542,16 +551,16 @@ msgstr "" msgid "" "This is equivalent to the Python ``__iter__(self): return self`` method. It " -"is intended for :term:`iterator` types, to be used in the :c:member:" -"`PyTypeObject.tp_iter` slot." +"is intended for :term:`iterator` types, to be used in " +"the :c:member:`PyTypeObject.tp_iter` slot." msgstr "" msgid "" -"This is the equivalent to the Python expression ``aiter(o)``. Takes an :" -"class:`AsyncIterable` object and returns an :class:`AsyncIterator` for it. " -"This is typically a new iterator but if the argument is an :class:" -"`AsyncIterator`, this returns itself. Raises :exc:`TypeError` and returns " -"``NULL`` if the object cannot be iterated." +"This is the equivalent to the Python expression ``aiter(o)``. Takes " +"an :class:`AsyncIterable` object and returns an :class:`AsyncIterator` for " +"it. This is typically a new iterator but if the argument is " +"an :class:`AsyncIterator`, this returns itself. Raises :exc:`TypeError` and " +"returns ``NULL`` if the object cannot be iterated." msgstr "" msgid "Get a pointer to subclass-specific data reserved for *cls*." @@ -573,21 +582,21 @@ msgstr "" msgid "" "This may be larger than requested using :c:member:`-PyType_Spec.basicsize " -"`; it is safe to use this larger size (e.g. with :c:" -"func:`!memset`)." +"`; it is safe to use this larger size (e.g. " +"with :c:func:`!memset`)." msgstr "" msgid "" -"The type *cls* **must** have been created using negative :c:member:" -"`PyType_Spec.basicsize`. Python does not check this." +"The type *cls* **must** have been created using " +"negative :c:member:`PyType_Spec.basicsize`. Python does not check this." msgstr "" msgid "On error, set an exception and return a negative value." msgstr "" msgid "" -"Get a pointer to per-item data for a class with :c:macro:" -"`Py_TPFLAGS_ITEMS_AT_END`." +"Get a pointer to per-item data for a class " +"with :c:macro:`Py_TPFLAGS_ITEMS_AT_END`." msgstr "" msgid "" @@ -606,6 +615,11 @@ msgstr "" msgid "Clear the managed dictionary of *obj*." msgstr "" +msgid "" +"This function must only be called in a clear function of the type which has " +"the :c:macro:`Py_TPFLAGS_MANAGED_DICT` flag set." +msgstr "" + msgid "built-in function" msgstr "funkcja wbudowana" @@ -613,7 +627,7 @@ msgid "repr" msgstr "" msgid "ascii" -msgstr "" +msgstr "ascii" msgid "string" msgstr "ciąg znaków" diff --git a/c-api/perfmaps.po b/c-api/perfmaps.po new file mode 100644 index 0000000000..62a1b0e387 --- /dev/null +++ b/c-api/perfmaps.po @@ -0,0 +1,141 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Support for Perf Maps" +msgstr "" + +msgid "" +"On supported platforms (as of this writing, only Linux), the runtime can " +"take advantage of *perf map files* to make Python functions visible to an " +"external profiling tool (such as `perf `_). A running process may create a file in the ``/tmp`` " +"directory, which contains entries that can map a section of executable code " +"to a name. This interface is described in the `documentation of the Linux " +"Perf tool `_." +msgstr "" + +msgid "" +"In Python, these helper APIs can be used by libraries and features that rely " +"on generating machine code on the fly." +msgstr "" + +msgid "" +"Note that holding the Global Interpreter Lock (GIL) is not required for " +"these APIs." +msgstr "" + +msgid "" +"Open the ``/tmp/perf-$pid.map`` file, unless it's already opened, and create " +"a lock to ensure thread-safe writes to the file (provided the writes are " +"done through :c:func:`PyUnstable_WritePerfMapEntry`). Normally, there's no " +"need to call this explicitly; just " +"use :c:func:`PyUnstable_WritePerfMapEntry` and it will initialize the state " +"on first call." +msgstr "" + +msgid "" +"Returns ``0`` on success, ``-1`` on failure to create/open the perf map " +"file, or ``-2`` on failure to create a lock. Check ``errno`` for more " +"information about the cause of a failure." +msgstr "" + +msgid "" +"Write one single entry to the ``/tmp/perf-$pid.map`` file. This function is " +"thread safe. Here is what an example entry looks like::" +msgstr "" + +msgid "" +"# address size name\n" +"7f3529fcf759 b py::bar:/run/t.py" +msgstr "" + +msgid "" +"Will call :c:func:`PyUnstable_PerfMapState_Init` before writing the entry, " +"if the perf map file is not already opened. Returns ``0`` on success, or the " +"same error codes as :c:func:`PyUnstable_PerfMapState_Init` on failure." +msgstr "" + +msgid "" +"Close the perf map file opened by :c:func:`PyUnstable_PerfMapState_Init`. " +"This is called by the runtime itself during interpreter shut-down. In " +"general, there shouldn't be a reason to explicitly call this, except to " +"handle specific scenarios such as forking." +msgstr "" + +msgid "" +"Open the ``/tmp/perf-$pid.map`` file and append the content of " +"*parent_filename* to it." +msgstr "" + +msgid "" +"This function is available on all platforms but only generates output on " +"platforms that support perf maps (currently only Linux). On other platforms, " +"it does nothing." +msgstr "" + +msgid "Compile the given code object using the current perf trampoline." +msgstr "" + +msgid "" +"The \"current\" trampoline is the one set by the runtime or the most " +"recent :c:func:`PyUnstable_PerfTrampoline_SetPersistAfterFork` call." +msgstr "" + +msgid "" +"If no trampoline is set, falls back to normal compilation (no perf map " +"entry)." +msgstr "" + +msgid "Parameters" +msgstr "parametry" + +msgid "The code object to compile." +msgstr "" + +msgid "Returns" +msgstr "Zwraca" + +msgid "0 on success, -1 on failure." +msgstr "" + +msgid "Set whether the perf trampoline should persist after a fork." +msgstr "" + +msgid "" +"If ``enable`` is true (non-zero): perf map file remains open/valid post-" +"fork. Child process inherits all existing perf map entries." +msgstr "" + +msgid "" +"If ``enable`` is false (zero): perf map closes post-fork. Child process gets " +"empty perf map." +msgstr "" + +msgid "Default: false (clears on fork)." +msgstr "" + +msgid "1 to enable, 0 to disable." +msgstr "" diff --git a/c-api/picklebuffer.po b/c-api/picklebuffer.po new file mode 100644 index 0000000000..8a2588f629 --- /dev/null +++ b/c-api/picklebuffer.po @@ -0,0 +1,92 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-11-17 15:05+0000\n" +"Last-Translator: python-doc bot, 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 "Pickle buffer objects" +msgstr "" + +msgid "" +"A :class:`pickle.PickleBuffer` object wraps a :ref:`buffer-providing object " +"` for out-of-band data transfer with the :mod:`pickle` module." +msgstr "" + +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python pickle buffer " +"type. This is the same object as :class:`pickle.PickleBuffer` in the Python " +"layer." +msgstr "" + +msgid "" +"Return true if *op* is a pickle buffer instance. This function always " +"succeeds." +msgstr "" + +msgid "Create a pickle buffer from the object *obj*." +msgstr "" + +msgid "" +"This function will fail if *obj* doesn't support the :ref:`buffer protocol " +"`." +msgstr "" + +msgid "" +"On success, return a new pickle buffer instance. On failure, set an " +"exception and return ``NULL``." +msgstr "" + +msgid "Analogous to calling :class:`pickle.PickleBuffer` with *obj* in Python." +msgstr "" + +msgid "" +"Get a pointer to the underlying :c:type:`Py_buffer` that the pickle buffer " +"wraps." +msgstr "" + +msgid "" +"The returned pointer is valid as long as *picklebuf* is alive and has not " +"been released. The caller must not modify or free the " +"returned :c:type:`Py_buffer`. If the pickle buffer has been released, " +"raise :exc:`ValueError`." +msgstr "" + +msgid "" +"On success, return a pointer to the buffer view. On failure, set an " +"exception and return ``NULL``." +msgstr "" + +msgid "Release the underlying buffer held by the pickle buffer." +msgstr "" + +msgid "" +"Return ``0`` on success. On failure, set an exception and return ``-1``." +msgstr "" + +msgid "Analogous to calling :meth:`pickle.PickleBuffer.release` in Python." +msgstr "" + +msgid "object" +msgstr "obiekt" + +msgid "PickleBuffer" +msgstr "" diff --git a/c-api/refcounting.po b/c-api/refcounting.po index 4320256793..0155e1a9a4 100644 --- a/c-api/refcounting.po +++ b/c-api/refcounting.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,10 +36,10 @@ msgstr "" msgid "" "Note that the returned value may not actually reflect how many references to " -"the object are actually held. For example, some objects are :term:" -"`immortal` and have a very high refcount that does not reflect the actual " -"number of references. Consequently, do not rely on the returned value to be " -"accurate, other than a value of 0 or 1." +"the object are actually held. For example, some objects " +"are :term:`immortal` and have a very high refcount that does not reflect the " +"actual number of references. Consequently, do not rely on the returned " +"value to be accurate, other than a value of 0 or 1." msgstr "" msgid "" @@ -72,8 +72,8 @@ msgid "" msgstr "" msgid "" -"This function is usually used to convert a :term:`borrowed reference` to a :" -"term:`strong reference` in-place. The :c:func:`Py_NewRef` function can be " +"This function is usually used to convert a :term:`borrowed reference` to " +"a :term:`strong reference` in-place. The :c:func:`Py_NewRef` function can be " "used to create a new :term:`strong reference`." msgstr "" @@ -86,8 +86,8 @@ msgid "" msgstr "" msgid "" -"Do not expect this function to actually modify *o* in any way. For at least :" -"pep:`some objects <0683>`, this function has no effect." +"Do not expect this function to actually modify *o* in any way. For at " +"least :pep:`some objects <0683>`, this function has no effect." msgstr "" msgid "" @@ -158,13 +158,13 @@ msgid "" msgstr "" msgid "" -"Do not expect this function to actually modify *o* in any way. For at least :" -"pep:`some objects <683>`, this function has no effect." +"Do not expect this function to actually modify *o* in any way. For at " +"least :pep:`some objects <683>`, this function has no effect." msgstr "" msgid "" -"The deallocation function can cause arbitrary Python code to be invoked (e." -"g. when a class instance with a :meth:`~object.__del__` method is " +"The deallocation function can cause arbitrary Python code to be invoked " +"(e.g. when a class instance with a :meth:`~object.__del__` method is " "deallocated). While exceptions in such code are not propagated, the " "executed code has free access to all Python global variables. This means " "that any object that is reachable from a global variable should be in a " @@ -206,8 +206,9 @@ msgid "" msgstr "" msgid "" -"Release a :term:`strong reference` to object *o*. A function version of :c:" -"func:`Py_XDECREF`. It can be used for runtime dynamic embedding of Python." +"Release a :term:`strong reference` to object *o*. A function version " +"of :c:func:`Py_XDECREF`. It can be used for runtime dynamic embedding of " +"Python." msgstr "" msgid "" @@ -230,7 +231,7 @@ msgid "Py_SETREF(dst, src);" msgstr "" msgid "" -"That arranges to set *dst* to *src* _before_ releasing the reference to the " +"That arranges to set *dst* to *src* *before* releasing the reference to the " "old value of *dst*, so that any code triggered as a side-effect of *dst* " "getting torn down no longer believes *dst* points to a valid object." msgstr "" diff --git a/c-api/reflection.po b/c-api/reflection.po index 688f5fdd04..92f7b975e3 100644 --- a/c-api/reflection.po +++ b/c-api/reflection.po @@ -57,6 +57,6 @@ msgstr "" msgid "" "Return a description string, depending on the type of *func*. Return values " "include \"()\" for functions and methods, \" constructor\", \" instance\", " -"and \" object\". Concatenated with the result of :c:func:" -"`PyEval_GetFuncName`, the result will be a description of *func*." +"and \" object\". Concatenated with the result " +"of :c:func:`PyEval_GetFuncName`, the result will be a description of *func*." msgstr "" diff --git a/c-api/sequence.po b/c-api/sequence.po index 151ab007d8..2216613dec 100644 --- a/c-api/sequence.po +++ b/c-api/sequence.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,10 +28,10 @@ msgstr "" msgid "" "Return ``1`` if the object provides the sequence protocol, and ``0`` " -"otherwise. Note that it returns ``1`` for Python classes with a :meth:" -"`~object.__getitem__` method, unless they are :class:`dict` subclasses, " -"since in general it is impossible to determine what type of keys the class " -"supports. This function always succeeds." +"otherwise. Note that it returns ``1`` for Python classes with " +"a :meth:`~object.__getitem__` method, unless they are :class:`dict` " +"subclasses, since in general it is impossible to determine what type of keys " +"the class supports. This function always succeeds." msgstr "" msgid "" @@ -77,8 +75,8 @@ msgstr "" msgid "" "Assign object *v* to the *i*\\ th element of *o*. Raise an exception and " "return ``-1`` on failure; return ``0`` on success. This is the equivalent " -"of the Python statement ``o[i] = v``. This function *does not* steal a " -"reference to *v*." +"of the Python statement ``o[i] = v``. This function *does not* " +"\":term:`steal`\" a reference to *v*." msgstr "" msgid "" @@ -150,16 +148,17 @@ msgid "" msgstr "" msgid "" -"Returns the length of *o*, assuming that *o* was returned by :c:func:" -"`PySequence_Fast` and that *o* is not ``NULL``. The size can also be " -"retrieved by calling :c:func:`PySequence_Size` on *o*, but :c:func:" -"`PySequence_Fast_GET_SIZE` is faster because it can assume *o* is a list or " -"tuple." +"Returns the length of *o*, assuming that *o* was returned " +"by :c:func:`PySequence_Fast` and that *o* is not ``NULL``. The size can " +"also be retrieved by calling :c:func:`PySequence_Size` on *o*, " +"but :c:func:`PySequence_Fast_GET_SIZE` is faster because it can assume *o* " +"is a list or tuple." msgstr "" msgid "" -"Return the *i*\\ th element of *o*, assuming that *o* was returned by :c:" -"func:`PySequence_Fast`, *o* is not ``NULL``, and that *i* is within bounds." +"Return the *i*\\ th element of *o*, assuming that *o* was returned " +"by :c:func:`PySequence_Fast`, *o* is not ``NULL``, and that *i* is within " +"bounds." msgstr "" msgid "" @@ -174,10 +173,10 @@ msgid "" msgstr "" msgid "" -"Return the *i*\\ th element of *o* or ``NULL`` on failure. Faster form of :c:" -"func:`PySequence_GetItem` but without checking that :c:func:" -"`PySequence_Check` on *o* is true and without adjustment for negative " -"indices." +"Return the *i*\\ th element of *o* or ``NULL`` on failure. Faster form " +"of :c:func:`PySequence_GetItem` but without checking " +"that :c:func:`PySequence_Check` on *o* is true and without adjustment for " +"negative indices." msgstr "" msgid "built-in function" diff --git a/c-api/set.po b/c-api/set.po index 783192cc12..87f90f4eca 100644 --- a/c-api/set.po +++ b/c-api/set.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,35 +29,32 @@ msgstr "" msgid "" "This section details the public API for :class:`set` and :class:`frozenset` " "objects. Any functionality not listed below is best accessed using either " -"the abstract object protocol (including :c:func:`PyObject_CallMethod`, :c:" -"func:`PyObject_RichCompareBool`, :c:func:`PyObject_Hash`, :c:func:" -"`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:`PyObject_Print`, and :c:" -"func:`PyObject_GetIter`) or the abstract number protocol (including :c:func:" -"`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:func:`PyNumber_Or`, :c:func:" -"`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :c:func:" -"`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, and :c:func:" -"`PyNumber_InPlaceXor`)." +"the abstract object protocol " +"(including :c:func:`PyObject_CallMethod`, :c:func:`PyObject_RichCompareBool`, :c:func:`PyObject_Hash`, :c:func:`PyObject_Repr`, :c:func:`PyObject_IsTrue`, :c:func:`PyObject_Print`, " +"and :c:func:`PyObject_GetIter`) or the abstract number protocol " +"(including :c:func:`PyNumber_And`, :c:func:`PyNumber_Subtract`, :c:func:`PyNumber_Or`, :c:func:`PyNumber_Xor`, :c:func:`PyNumber_InPlaceAnd`, :c:func:`PyNumber_InPlaceSubtract`, :c:func:`PyNumber_InPlaceOr`, " +"and :c:func:`PyNumber_InPlaceXor`)." msgstr "" msgid "" "This subtype of :c:type:`PyObject` is used to hold the internal data for " -"both :class:`set` and :class:`frozenset` objects. It is like a :c:type:" -"`PyDictObject` in that it is a fixed size for small sets (much like tuple " -"storage) and will point to a separate, variable sized block of memory for " -"medium and large sized sets (much like list storage). None of the fields of " -"this structure should be considered public and all are subject to change. " -"All access should be done through the documented API rather than by " +"both :class:`set` and :class:`frozenset` objects. It is like " +"a :c:type:`PyDictObject` in that it is a fixed size for small sets (much " +"like tuple storage) and will point to a separate, variable sized block of " +"memory for medium and large sized sets (much like list storage). None of the " +"fields of this structure should be considered public and all are subject to " +"change. All access should be done through the documented API rather than by " "manipulating the values in the structure." msgstr "" msgid "" -"This is an instance of :c:type:`PyTypeObject` representing the Python :class:" -"`set` type." +"This is an instance of :c:type:`PyTypeObject` representing the " +"Python :class:`set` type." msgstr "" msgid "" -"This is an instance of :c:type:`PyTypeObject` representing the Python :class:" -"`frozenset` type." +"This is an instance of :c:type:`PyTypeObject` representing the " +"Python :class:`frozenset` type." msgstr "" msgid "" @@ -107,19 +103,19 @@ msgstr "" msgid "" "Return a new :class:`frozenset` containing objects returned by the " "*iterable*. The *iterable* may be ``NULL`` to create a new empty frozenset. " -"Return the new set on success or ``NULL`` on failure. Raise :exc:" -"`TypeError` if *iterable* is not actually iterable." +"Return the new set on success or ``NULL`` on failure. " +"Raise :exc:`TypeError` if *iterable* is not actually iterable." msgstr "" msgid "" -"The following functions and macros are available for instances of :class:" -"`set` or :class:`frozenset` or instances of their subtypes." +"The following functions and macros are available for instances " +"of :class:`set` or :class:`frozenset` or instances of their subtypes." msgstr "" msgid "" "Return the length of a :class:`set` or :class:`frozenset` object. Equivalent " -"to ``len(anyset)``. Raises a :exc:`SystemError` if *anyset* is not a :class:" -"`set`, :class:`frozenset`, or an instance of a subtype." +"to ``len(anyset)``. Raises a :exc:`SystemError` if *anyset* is not " +"a :class:`set`, :class:`frozenset`, or an instance of a subtype." msgstr "" msgid "Macro form of :c:func:`PySet_Size` without error checking." @@ -129,9 +125,9 @@ msgid "" "Return ``1`` if found, ``0`` if not found, and ``-1`` if an error is " "encountered. Unlike the Python :meth:`~object.__contains__` method, this " "function does not automatically convert unhashable sets into temporary " -"frozensets. Raise a :exc:`TypeError` if the *key* is unhashable. Raise :exc:" -"`SystemError` if *anyset* is not a :class:`set`, :class:`frozenset`, or an " -"instance of a subtype." +"frozensets. Raise a :exc:`TypeError` if the *key* is unhashable. " +"Raise :exc:`SystemError` if *anyset* is not " +"a :class:`set`, :class:`frozenset`, or an instance of a subtype." msgstr "" msgid "" @@ -140,8 +136,8 @@ msgid "" "values of brand new frozensets before they are exposed to other code). " "Return ``0`` on success or ``-1`` on failure. Raise a :exc:`TypeError` if " "the *key* is unhashable. Raise a :exc:`MemoryError` if there is no room to " -"grow. Raise a :exc:`SystemError` if *set* is not an instance of :class:" -"`set` or its subtype." +"grow. Raise a :exc:`SystemError` if *set* is not an instance " +"of :class:`set` or its subtype." msgstr "" msgid "" @@ -153,9 +149,9 @@ 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." +"the Python :meth:`~set.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 "" @@ -167,8 +163,8 @@ msgstr "" msgid "" "Empty an existing set of all elements. Return ``0`` on success. Return " -"``-1`` and raise :exc:`SystemError` if *set* is not an instance of :class:" -"`set` or its subtype." +"``-1`` and raise :exc:`SystemError` if *set* is not an instance " +"of :class:`set` or its subtype." msgstr "" msgid "object" diff --git a/c-api/slice.po b/c-api/slice.po index 2fe40cb5ef..26dc7cd8fe 100644 --- a/c-api/slice.po +++ b/c-api/slice.po @@ -76,8 +76,8 @@ msgstr "" msgid "" "This function is considered not safe for resizable sequences. Its invocation " -"should be replaced by a combination of :c:func:`PySlice_Unpack` and :c:func:" -"`PySlice_AdjustIndices` where ::" +"should be replaced by a combination of :c:func:`PySlice_Unpack` " +"and :c:func:`PySlice_AdjustIndices` where ::" msgstr "" msgid "is replaced by ::" @@ -124,6 +124,6 @@ msgstr "" msgid "" "The Python ``Ellipsis`` object. This object has no methods. It needs to be " -"treated just like any other object with respect to reference counts. Like :" -"c:data:`Py_None` it is a singleton object." +"treated just like any other object with respect to reference counts. " +"Like :c:data:`Py_None` it is a singleton object." msgstr "" diff --git a/c-api/stable.po b/c-api/stable.po index de1348b3ed..6827d03eee 100644 --- a/c-api/stable.po +++ b/c-api/stable.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 +# Rafael Fontenelle , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Rafael Fontenelle , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -35,10 +35,10 @@ msgstr "" msgid "" "CPython's Application Binary Interface (ABI) is forward- and backwards-" -"compatible across a minor release (if these are compiled the same way; see :" -"ref:`stable-abi-platform` below). So, code compiled for Python 3.10.0 will " -"work on 3.10.8 and vice versa, but will need to be compiled separately for " -"3.9.x and 3.11.x." +"compatible across a minor release (if these are compiled the same way; " +"see :ref:`stable-abi-platform` below). So, code compiled for Python 3.10.0 " +"will work on 3.10.8 and vice versa, but will need to be compiled separately " +"for 3.9.x and 3.11.x." msgstr "" msgid "There are two tiers of C API with different stability expectations:" @@ -61,9 +61,9 @@ msgstr "" msgid "" "Names prefixed by an underscore, such as ``_Py_InternalState``, are private " "API that can change without notice even in patch releases. If you need to " -"use this API, consider reaching out to `CPython developers `_ to discuss adding public API for your use " -"case." +"use this API, consider reaching out to `CPython developers `_ to discuss adding public API for " +"your use case." msgstr "" msgid "Unstable C API" @@ -151,8 +151,8 @@ msgstr "" msgid "" "On Windows, extensions that use the Stable ABI should be linked against " -"``python3.dll`` rather than a version-specific library such as ``python39." -"dll``." +"``python3.dll`` rather than a version-specific library such as " +"``python39.dll``." msgstr "" msgid "" @@ -204,9 +204,10 @@ msgstr "" msgid "" "Note that compiling with ``Py_LIMITED_API`` is *not* a complete guarantee " -"that code conforms to the :ref:`Limited API ` or the :ref:" -"`Stable ABI `. ``Py_LIMITED_API`` only covers definitions, but " -"an API also includes other issues, such as expected semantics." +"that code conforms to the :ref:`Limited API ` or " +"the :ref:`Stable ABI `. ``Py_LIMITED_API`` only covers " +"definitions, but an API also includes other issues, such as expected " +"semantics." msgstr "" msgid "" @@ -248,9 +249,9 @@ msgstr "" msgid "" "ABI stability depends not only on Python, but also on the compiler used, " -"lower-level libraries and compiler options. For the purposes of the :ref:" -"`Stable ABI `, these details define a “platform”. They usually " -"depend on the OS type and processor architecture" +"lower-level libraries and compiler options. For the purposes of " +"the :ref:`Stable ABI `, these details define a “platform”. They " +"usually depend on the OS type and processor architecture" msgstr "" msgid "" diff --git a/c-api/structures.po b/c-api/structures.po index 9e804ee9ff..58eeaf6753 100644 --- a/c-api/structures.po +++ b/c-api/structures.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 -# haaritsubaki, 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,11 +58,11 @@ msgid "" msgstr "" msgid "" -"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`." +"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 "" @@ -150,8 +148,8 @@ msgid "Set the object *o* size to *size*." msgstr "" msgid "" -"This is a macro which expands to initialization values for a new :c:type:" -"`PyObject` type. This macro expands to::" +"This is a macro which expands to initialization values for a " +"new :c:type:`PyObject` type. This macro expands to::" msgstr "" msgid "" @@ -160,9 +158,9 @@ msgid "" msgstr "" msgid "" -"This is a macro which expands to initialization values for a new :c:type:" -"`PyVarObject` type, including the :c:member:`~PyVarObject.ob_size` field. " -"This macro expands to::" +"This is a macro which expands to initialization values for a " +"new :c:type:`PyVarObject` type, including " +"the :c:member:`~PyVarObject.ob_size` field. This macro expands to::" msgstr "" msgid "" @@ -276,20 +274,21 @@ msgid "There are these calling conventions:" msgstr "" msgid "" -"This is the typical calling convention, where the methods have the type :c:" -"type:`PyCFunction`. The function expects two :c:expr:`PyObject*` values. The " -"first one is the *self* object for methods; for module functions, it is the " -"module object. The second parameter (often called *args*) is a tuple object " -"representing all arguments. This parameter is typically processed using :c:" -"func:`PyArg_ParseTuple` or :c:func:`PyArg_UnpackTuple`." +"This is the typical calling convention, where the methods have the " +"type :c:type:`PyCFunction`. The function expects two :c:expr:`PyObject*` " +"values. The first one is the *self* object for methods; for module " +"functions, it is the module object. The second parameter (often called " +"*args*) is a tuple object representing all arguments. This parameter is " +"typically processed using :c:func:`PyArg_ParseTuple` " +"or :c:func:`PyArg_UnpackTuple`." msgstr "" msgid "" -"Can only be used in certain combinations with other flags: :ref:" -"`METH_VARARGS | METH_KEYWORDS `, :ref:" -"`METH_FASTCALL | METH_KEYWORDS ` and :ref:" -"`METH_METHOD | METH_FASTCALL | METH_KEYWORDS `." +"Can only be used in certain combinations with other " +"flags: :ref:`METH_VARARGS | METH_KEYWORDS `, :ref:`METH_FASTCALL | METH_KEYWORDS ` and :ref:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS " +"`." msgstr "" msgid ":c:expr:`METH_VARARGS | METH_KEYWORDS`" @@ -358,42 +357,35 @@ msgid "" msgstr "" msgid "" -"The function must have 2 parameters. Since the second parameter is unused, :" -"c:macro:`Py_UNUSED` can be used to prevent a compiler warning." +"The function must have 2 parameters. Since the second parameter is " +"unused, :c:macro:`Py_UNUSED` can be used to prevent a compiler warning." msgstr "" msgid "" -"Methods with a single object argument can be listed with the :c:macro:" -"`METH_O` flag, instead of invoking :c:func:`PyArg_ParseTuple` with a " -"``\"O\"`` argument. They have the type :c:type:`PyCFunction`, with the " -"*self* parameter, and a :c:expr:`PyObject*` parameter representing the " +"Methods with a single object argument can be listed with " +"the :c:macro:`METH_O` flag, instead of invoking :c:func:`PyArg_ParseTuple` " +"with a ``\"O\"`` argument. They have the type :c:type:`PyCFunction`, with " +"the *self* parameter, and a :c:expr:`PyObject*` parameter representing the " "single argument." msgstr "" msgid "" "These two constants are not used to indicate the calling convention but the " -"binding when use with methods of classes. These may not be used for " +"binding when used with methods of classes. These may not be used for " "functions defined for modules. At most one of these flags may be set for " "any given method." msgstr "" -"Te dwie stałe nie są używane do zaznaczania konwencji wywoływania, ale wiążą " -"gdy są używane z metodami klas. Nie mogą być one używane dla funkcji " -"określonych dla modułów. Co najwyżej jedna z tych flag może być ustawiona " -"dla dowolnej danej metody." msgid "" "The method will be passed the type object as the first parameter rather than " "an instance of the type. This is used to create *class methods*, similar to " -"what is created when using the :func:`classmethod` built-in function." +"what is created when using the :deco:`classmethod` built-in decorator." msgstr "" -"Metodzie zostanie przekazany typ obiektu jako pierwszy parametr zamiast " -"instancji tego typu. Jest to używane aby tworzyć *metody klasowe*, podobnie " -"do tego, co jest tworzone przy użyciu wbudowanej funkcji :func:`classmethod`." msgid "" "The method will be passed ``NULL`` as the first parameter rather than an " "instance of the type. This is used to create *static methods*, similar to " -"what is created when using the :func:`staticmethod` built-in function." +"what is created when using the :deco:`staticmethod` built-in decorator." msgstr "" msgid "" @@ -407,12 +399,27 @@ msgid "" "The method will be loaded in place of existing definitions. Without " "*METH_COEXIST*, the default is to skip repeated definitions. Since slot " "wrappers are loaded before the method table, the existence of a " -"*sq_contains* slot, for example, would generate a wrapped method named :meth:" -"`~object.__contains__` and preclude the loading of a corresponding " -"PyCFunction with the same name. With the flag defined, the PyCFunction will " -"be loaded in place of the wrapper object and will co-exist with the slot. " -"This is helpful because calls to PyCFunctions are optimized more than " -"wrapper object calls." +"*sq_contains* slot, for example, would generate a wrapped method " +"named :meth:`~object.__contains__` and preclude the loading of a " +"corresponding PyCFunction with the same name. With the flag defined, the " +"PyCFunction will be loaded in place of the wrapper object and will co-exist " +"with the slot. This is helpful because calls to PyCFunctions are optimized " +"more than wrapper object calls." +msgstr "" + +msgid "" +"The type object corresponding to Python C method objects. This is available " +"as :class:`types.BuiltinMethodType` in the Python layer." +msgstr "" + +msgid "" +"Return true if *op* is an instance of the :c:type:`PyCMethod_Type` type or a " +"subtype of it. This function always succeeds." +msgstr "" + +msgid "" +"This is the same as :c:func:`PyCMethod_Check`, but does not account for " +"subtypes." msgstr "" msgid "" @@ -441,12 +448,79 @@ msgid "" "function. Must be set if :c:macro:`METH_METHOD` is set on ``ml->ml_flags``." msgstr "" +msgid "" +"The type object corresponding to Python C function objects. This is " +"available as :class:`types.BuiltinFunctionType` in the Python layer." +msgstr "" + +msgid "" +"Return true if *op* is an instance of the :c:type:`PyCFunction_Type` type or " +"a subtype of it. This function always succeeds." +msgstr "" + +msgid "" +"This is the same as :c:func:`PyCFunction_Check`, but does not account for " +"subtypes." +msgstr "" + msgid "Equivalent to ``PyCMethod_New(ml, self, module, NULL)``." msgstr "" msgid "Equivalent to ``PyCMethod_New(ml, self, NULL, NULL)``." msgstr "" +msgid "" +"Get the function's flags on *func* as they were passed " +"to :c:member:`~PyMethodDef.ml_flags`." +msgstr "" + +msgid "" +"If *func* is not a C function object, this fails with an exception. *func* " +"must not be ``NULL``." +msgstr "" + +msgid "" +"This function returns the function's flags on success, and ``-1`` with an " +"exception set on failure." +msgstr "" + +msgid "" +"This is the same as :c:func:`PyCFunction_GetFlags`, but without error or " +"type checking." +msgstr "" + +msgid "" +"Get the function pointer on *func* as it was passed " +"to :c:member:`~PyMethodDef.ml_meth`." +msgstr "" + +msgid "" +"This function returns the function pointer on success, and ``NULL`` with an " +"exception set on failure." +msgstr "" + +msgid "" +"This is the same as :c:func:`PyCFunction_GetFunction`, but without error or " +"type checking." +msgstr "" + +msgid "" +"Get the \"self\" object on *func*. This is the object that would be passed " +"to the first argument of a :c:type:`PyCFunction`. For C function objects " +"created through a :c:type:`PyMethodDef` on a :c:type:`PyModuleDef`, this is " +"the resulting module object." +msgstr "" + +msgid "" +"This function returns a :term:`borrowed reference` to the \"self\" object on " +"success, and ``NULL`` with an exception set on failure." +msgstr "" + +msgid "" +"This is the same as :c:func:`PyCFunction_GetSelf`, but without error or type " +"checking." +msgstr "" + msgid "Accessing attributes of extension types" msgstr "" @@ -487,17 +561,17 @@ msgstr "" msgid "" "By default (when :c:member:`~PyMemberDef.flags` is ``0``), members allow " "both read and write access. Use the :c:macro:`Py_READONLY` flag for read-" -"only access. Certain types, like :c:macro:`Py_T_STRING`, imply :c:macro:" -"`Py_READONLY`. Only :c:macro:`Py_T_OBJECT_EX` (and legacy :c:macro:" -"`T_OBJECT`) members can be deleted." +"only access. Certain types, like :c:macro:`Py_T_STRING`, " +"imply :c:macro:`Py_READONLY`. Only :c:macro:`Py_T_OBJECT_EX` (and " +"legacy :c:macro:`T_OBJECT`) members can be deleted." msgstr "" msgid "" "For heap-allocated types (created using :c:func:`PyType_FromSpec` or " "similar), ``PyMemberDef`` may contain a definition for the special member " -"``\"__vectorcalloffset__\"``, corresponding to :c:member:`~PyTypeObject." -"tp_vectorcall_offset` in type objects. These must be defined with " -"``Py_T_PYSSIZET`` and ``Py_READONLY``, for example::" +"``\"__vectorcalloffset__\"``, corresponding " +"to :c:member:`~PyTypeObject.tp_vectorcall_offset` in type objects. These " +"must be defined with ``Py_T_PYSSIZET`` and ``Py_READONLY``, for example::" msgstr "" msgid "" @@ -512,9 +586,9 @@ msgid "(You may need to ``#include `` for :c:func:`!offsetof`.)" msgstr "" msgid "" -"The legacy offsets :c:member:`~PyTypeObject.tp_dictoffset` and :c:member:" -"`~PyTypeObject.tp_weaklistoffset` can be defined similarly using " -"``\"__dictoffset__\"`` and ``\"__weaklistoffset__\"`` members, but " +"The legacy offsets :c:member:`~PyTypeObject.tp_dictoffset` " +"and :c:member:`~PyTypeObject.tp_weaklistoffset` can be defined similarly " +"using ``\"__dictoffset__\"`` and ``\"__weaklistoffset__\"`` members, but " "extensions are strongly encouraged to use :c:macro:`Py_TPFLAGS_MANAGED_DICT` " "and :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` instead." msgstr "" @@ -566,15 +640,17 @@ msgid "" msgstr "" msgid "" -"Can only be used as part of :c:member:`Py_tp_members ` :c:type:`slot ` when creating a class using " -"negative :c:member:`~PyType_Spec.basicsize`. It is mandatory in that case." +"Can only be used as part of :c:member:`Py_tp_members " +"` :c:type:`slot ` when creating a " +"class using negative :c:member:`~PyType_Spec.basicsize`. It is mandatory in " +"that case." msgstr "" msgid "" -"This flag is only used in :c:type:`PyType_Slot`. When setting :c:member:" -"`~PyTypeObject.tp_members` during class creation, Python clears it and sets :" -"c:member:`PyMemberDef.offset` to the offset from the ``PyObject`` struct." +"This flag is only used in :c:type:`PyType_Slot`. When " +"setting :c:member:`~PyTypeObject.tp_members` during class creation, Python " +"clears it and sets :c:member:`PyMemberDef.offset` to the offset from the " +"``PyObject`` struct." msgstr "" msgid "" @@ -586,9 +662,9 @@ msgid "" msgstr "" msgid "" -"The :c:macro:`!READONLY` macro was renamed to :c:macro:`Py_READONLY`. The :c:" -"macro:`!PY_AUDIT_READ` macro was renamed with the ``Py_`` prefix. The new " -"names are now always available. Previously, these required ``#include " +"The :c:macro:`!READONLY` macro was renamed to :c:macro:`Py_READONLY`. " +"The :c:macro:`!PY_AUDIT_READ` macro was renamed with the ``Py_`` prefix. The " +"new names are now always available. Previously, these required ``#include " "\"structmember.h\"``. The header is still available and it provides the old " "names." msgstr "" @@ -605,8 +681,8 @@ msgid "" msgstr "" msgid "" -"Unless marked (D), attributes defined this way cannot be deleted using e.g. :" -"keyword:`del` or :py:func:`delattr`." +"Unless marked (D), attributes defined this way cannot be deleted using " +"e.g. :keyword:`del` or :py:func:`delattr`." msgstr "" msgid "Macro name" @@ -634,19 +710,19 @@ msgid ":c:expr:`long`" msgstr ":c:expr:`long`" msgid ":c:expr:`long long`" -msgstr "" +msgstr ":c:expr:`long long`" msgid ":c:expr:`unsigned char`" -msgstr "" +msgstr ":c:expr:`unsigned char`" msgid ":c:expr:`unsigned int`" -msgstr "" +msgstr ":c:expr:`unsigned int`" msgid ":c:expr:`unsigned short`" -msgstr "" +msgstr ":c:expr:`unsigned short`" msgid ":c:expr:`unsigned long`" -msgstr "" +msgstr ":c:expr:`unsigned long`" msgid ":c:expr:`unsigned long long`" msgstr "" @@ -673,22 +749,22 @@ msgid ":c:expr:`const char *` (*)" msgstr "" msgid ":py:class:`str` (RO)" -msgstr "" +msgstr ":py:class:`str` (RO)" msgid ":c:expr:`const char[]` (*)" msgstr "" msgid ":c:expr:`char` (0-127)" -msgstr "" +msgstr ":c:expr:`char` (0-127)" msgid ":py:class:`str` (**)" -msgstr "" +msgstr ":py:class:`str` (**)" msgid ":c:expr:`PyObject *`" -msgstr "" +msgstr ":c:expr:`PyObject *`" msgid ":py:class:`object` (D)" -msgstr "" +msgstr ":py:class:`object` (D)" msgid "" "(*): Zero-terminated, UTF8-encoded C string. With :c:macro:`!Py_T_STRING` " diff --git a/c-api/sys.po b/c-api/sys.po index 77d7826c8f..80c535a818 100644 --- a/c-api/sys.po +++ b/c-api/sys.po @@ -27,21 +27,21 @@ msgid "Operating System Utilities" msgstr "" msgid "" -"Return the file system representation for *path*. If the object is a :class:" -"`str` or :class:`bytes` object, then its reference count is incremented. If " -"the object implements the :class:`os.PathLike` interface, then :meth:`~os." -"PathLike.__fspath__` is returned as long as it is a :class:`str` or :class:" -"`bytes` object. Otherwise :exc:`TypeError` is raised and ``NULL`` is " -"returned." +"Return the file system representation for *path*. If the object is " +"a :class:`str` or :class:`bytes` object, then its reference count is " +"incremented. If the object implements the :class:`os.PathLike` interface, " +"then :meth:`~os.PathLike.__fspath__` is returned as long as it is " +"a :class:`str` or :class:`bytes` object. Otherwise :exc:`TypeError` is " +"raised and ``NULL`` is returned." msgstr "" msgid "" "Return true (nonzero) if the standard I/O file *fp* with name *filename* is " "deemed interactive. This is the case for files for which " -"``isatty(fileno(fp))`` is true. If the global flag :c:data:" -"`Py_InteractiveFlag` is true, this function also returns true if the " -"*filename* pointer is ``NULL`` or if the name is equal to one of the strings " -"``''`` or ``'???'``." +"``isatty(fileno(fp))`` is true. If the global " +"flag :c:data:`Py_InteractiveFlag` is true, this function also returns true " +"if the *filename* pointer is ``NULL`` or if the name is equal to one of the " +"strings ``''`` or ``'???'``." msgstr "" msgid "" @@ -87,8 +87,8 @@ msgstr "" msgid "" ":func:`os.register_at_fork` allows registering custom Python functions to be " -"called by :c:func:`PyOS_BeforeFork()`, :c:func:`PyOS_AfterFork_Parent` and :" -"c:func:`PyOS_AfterFork_Child`." +"called by :c:func:`PyOS_BeforeFork()`, :c:func:`PyOS_AfterFork_Parent` " +"and :c:func:`PyOS_AfterFork_Child`." msgstr "" msgid "" @@ -112,27 +112,28 @@ msgstr "" msgid "" "Return the current signal handler for signal *i*. This is a thin wrapper " "around either :c:func:`sigaction` or :c:func:`signal`. Do not call those " -"functions directly! :c:type:`PyOS_sighandler_t` is a typedef alias for :c:" -"expr:`void (\\*)(int)`." +"functions directly! :c:type:`PyOS_sighandler_t` is a typedef alias " +"for :c:expr:`void (\\*)(int)`." msgstr "" msgid "" "Set the signal handler for signal *i* to be *h*; return the old signal " -"handler. This is a thin wrapper around either :c:func:`sigaction` or :c:func:" -"`signal`. Do not call those functions directly! :c:type:" -"`PyOS_sighandler_t` is a typedef alias for :c:expr:`void (\\*)(int)`." +"handler. This is a thin wrapper around either :c:func:`sigaction` " +"or :c:func:`signal`. Do not call those functions " +"directly! :c:type:`PyOS_sighandler_t` is a typedef alias for :c:expr:`void " +"(\\*)(int)`." msgstr "" msgid "" "This function should not be called directly: use the :c:type:`PyConfig` API " -"with the :c:func:`PyConfig_SetBytesString` function which ensures that :ref:" -"`Python is preinitialized `." +"with the :c:func:`PyConfig_SetBytesString` function which ensures " +"that :ref:`Python is preinitialized `." msgstr "" msgid "" "This function must not be called before :ref:`Python is preinitialized ` and so that the LC_CTYPE locale is properly configured: see the :c:" -"func:`Py_PreInitialize` function." +"preinit>` and so that the LC_CTYPE locale is properly configured: see " +"the :c:func:`Py_PreInitialize` function." msgstr "" msgid "" @@ -145,9 +146,10 @@ msgid "" msgstr "" msgid "" -"Return a pointer to a newly allocated wide character string, use :c:func:" -"`PyMem_RawFree` to free the memory. If size is not ``NULL``, write the " -"number of wide characters excluding the null character into ``*size``" +"Return a pointer to a newly allocated wide character string, " +"use :c:func:`PyMem_RawFree` to free the memory. If size is not ``NULL``, " +"write the number of wide characters excluding the null character into " +"``*size``" msgstr "" msgid "" @@ -157,9 +159,9 @@ msgid "" msgstr "" msgid "" -"The :term:`filesystem encoding and error handler` are selected by :c:func:" -"`PyConfig_Read`: see :c:member:`~PyConfig.filesystem_encoding` and :c:member:" -"`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." +"The :term:`filesystem encoding and error handler` are selected " +"by :c:func:`PyConfig_Read`: see :c:member:`~PyConfig.filesystem_encoding` " +"and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" msgid "" @@ -172,8 +174,8 @@ msgid "" msgstr "" msgid "" -"The :c:func:`PyUnicode_DecodeFSDefaultAndSize` and :c:func:" -"`PyUnicode_DecodeLocaleAndSize` functions." +"The :c:func:`PyUnicode_DecodeFSDefaultAndSize` " +"and :c:func:`PyUnicode_DecodeLocaleAndSize` functions." msgstr "" msgid "" @@ -182,8 +184,8 @@ msgid "" msgstr "" msgid "" -"The function now uses the UTF-8 encoding on Windows if :c:data:" -"`Py_LegacyWindowsFSEncodingFlag` is zero;" +"The function now uses the UTF-8 encoding on Windows " +"if :c:data:`Py_LegacyWindowsFSEncodingFlag` is zero;" msgstr "" msgid "" @@ -215,8 +217,8 @@ msgid "" msgstr "" msgid "" -"The function now uses the UTF-8 encoding on Windows if :c:data:" -"`Py_LegacyWindowsFSEncodingFlag` is zero." +"The function now uses the UTF-8 encoding on Windows " +"if :c:data:`Py_LegacyWindowsFSEncodingFlag` is zero." msgstr "" msgid "System Functions" @@ -246,9 +248,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"warnoptions` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.warnoptions` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -261,23 +263,23 @@ msgstr "" msgid "" "Note: this function is not currently usable from outside the CPython " -"implementation, as it must be called prior to the implicit import of :mod:" -"`warnings` in :c:func:`Py_Initialize` to be effective, but can't be called " -"until enough of the runtime has been initialized to permit the creation of " -"Unicode objects." +"implementation, as it must be called prior to the implicit import " +"of :mod:`warnings` in :c:func:`Py_Initialize` to be effective, but can't be " +"called until enough of the runtime has been initialized to permit the " +"creation of Unicode objects." msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"module_search_paths` and :c:member:`PyConfig.module_search_paths_set` should " -"be used instead, see :ref:`Python Initialization Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.module_search_paths` " +"and :c:member:`PyConfig.module_search_paths_set` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" "Set :data:`sys.path` to a list object of paths found in *path* which should " -"be a list of paths separated with the platform's search path delimiter (``:" -"`` on Unix, ``;`` on Windows)." +"be a list of paths separated with the platform's search path delimiter " +"(``:`` on Unix, ``;`` on Windows)." msgstr "" msgid "" @@ -306,9 +308,9 @@ msgid "" msgstr "" msgid "" -"Function similar to PySys_WriteStdout() but format the message using :c:func:" -"`PyUnicode_FromFormatV` and don't truncate the message to an arbitrary " -"length." +"Function similar to PySys_WriteStdout() but format the message " +"using :c:func:`PyUnicode_FromFormatV` and don't truncate the message to an " +"arbitrary length." msgstr "" msgid "" @@ -317,9 +319,9 @@ msgid "" msgstr "" msgid "" -"This API is kept for backward compatibility: setting :c:member:`PyConfig." -"xoptions` should be used instead, see :ref:`Python Initialization " -"Configuration `." +"This API is kept for backward compatibility: " +"setting :c:member:`PyConfig.xoptions` should be used instead, " +"see :ref:`Python Initialization Configuration `." msgstr "" msgid "" @@ -329,8 +331,9 @@ msgid "" msgstr "" msgid "" -"Return the current dictionary of :option:`-X` options, similarly to :data:" -"`sys._xoptions`. On error, ``NULL`` is returned and an exception is set." +"Return the current dictionary of :option:`-X` options, similarly " +"to :data:`sys._xoptions`. On error, ``NULL`` is returned and an exception " +"is set." msgstr "" msgid "" @@ -349,8 +352,9 @@ msgid "" msgstr "" msgid "" -"Note that ``#`` format characters should always be treated as :c:type:" -"`Py_ssize_t`, regardless of whether ``PY_SSIZE_T_CLEAN`` was defined." +"Note that ``#`` format characters should always be treated " +"as :c:type:`Py_ssize_t`, regardless of whether ``PY_SSIZE_T_CLEAN`` was " +"defined." msgstr "" msgid ":func:`sys.audit` performs the same function from Python code." @@ -377,15 +381,15 @@ msgstr "" msgid "" "This function is safe to call before :c:func:`Py_Initialize`. When called " "after runtime initialization, existing audit hooks are notified and may " -"silently abort the operation by raising an error subclassed from :class:" -"`Exception` (other errors will not be silenced)." +"silently abort the operation by raising an error subclassed " +"from :class:`Exception` (other errors will not be silenced)." msgstr "" msgid "" "The hook function is of type :c:expr:`int (*)(const char *event, PyObject " -"*args, void *userData)`, where *args* is guaranteed to be a :c:type:" -"`PyTupleObject`. The hook function is always called with the GIL held by the " -"Python interpreter that raised the event." +"*args, void *userData)`, where *args* is guaranteed to be " +"a :c:type:`PyTupleObject`. The hook function is always called with the GIL " +"held by the Python interpreter that raised the event." msgstr "" msgid "" @@ -415,8 +419,8 @@ msgid "" "This function should only be invoked when a condition is detected that would " "make it dangerous to continue using the Python interpreter; e.g., when the " "object administration appears to be corrupted. On Unix, the standard C " -"library function :c:func:`abort` is called which will attempt to produce a :" -"file:`core` file." +"library function :c:func:`abort` is called which will attempt to produce " +"a :file:`core` file." msgstr "" msgid "" @@ -430,8 +434,8 @@ msgstr "" msgid "" "Exit the current process. This calls :c:func:`Py_FinalizeEx` and then calls " -"the standard C library function ``exit(status)``. If :c:func:" -"`Py_FinalizeEx` indicates an error, the exit status is set to 120." +"the standard C library function ``exit(status)``. " +"If :c:func:`Py_FinalizeEx` indicates an error, the exit status is set to 120." msgstr "" msgid "Errors from finalization no longer ignored." diff --git a/c-api/time.po b/c-api/time.po index ea90c067ff..567236c365 100644 --- a/c-api/time.po +++ b/c-api/time.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2024-05-11 01:07+0000\n" -"Last-Translator: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -44,8 +44,8 @@ msgid "" msgstr "" msgid "" -"The reference point for timestamps depends on the clock used. For example, :" -"c:func:`PyTime_Time` returns timestamps relative to the UNIX epoch." +"The reference point for timestamps depends on the clock used. For " +"example, :c:func:`PyTime_Time` returns timestamps relative to the UNIX epoch." msgstr "" msgid "" diff --git a/c-api/tuple.po b/c-api/tuple.po index aab1fce529..8fb0b36a6d 100644 --- a/c-api/tuple.po +++ b/c-api/tuple.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Rafael Fontenelle , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Rafael Fontenelle , 2024\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -59,7 +58,7 @@ msgstr "" msgid "" "Take a pointer to a tuple object, and return the size of that tuple. On " -"error, return ``-1`` and with an exception set." +"error, return ``-1`` with an exception set." msgstr "" msgid "Like :c:func:`PyTuple_Size`, but without error checking." @@ -67,15 +66,15 @@ msgstr "" msgid "" "Return the object at position *pos* in the tuple pointed to by *p*. If " -"*pos* is negative or out of bounds, return ``NULL`` and set an :exc:" -"`IndexError` exception." +"*pos* is negative or out of bounds, return ``NULL`` and set " +"an :exc:`IndexError` exception." msgstr "" msgid "" "The returned reference is borrowed from the tuple *p* (that is: it is only " "valid as long as you hold a reference to *p*). To get a :term:`strong " -"reference`, use :c:func:`Py_NewRef(PyTuple_GetItem(...)) ` or :c:" -"func:`PySequence_GetItem`." +"reference`, use :c:func:`Py_NewRef(PyTuple_GetItem(...)) ` " +"or :c:func:`PySequence_GetItem`." msgstr "" msgid "Like :c:func:`PyTuple_GetItem`, but does no checking of its arguments." @@ -98,8 +97,9 @@ msgid "" msgstr "" msgid "" -"This function \"steals\" a reference to *o* and discards a reference to an " -"item already in the tuple at the affected position." +"This function \":term:`steals `\" a reference to *o* and discards a " +"reference to an item already in the tuple at the affected position (unless " +"it was NULL)." msgstr "" msgid "" @@ -108,14 +108,16 @@ msgid "" msgstr "" msgid "" -"Bounds checking is performed as an assertion if Python is built in :ref:" -"`debug mode ` or :option:`with assertions <--with-assertions>`." +"Bounds checking is performed as an assertion if Python is built " +"in :ref:`debug mode ` or :option:`with assertions <--with-" +"assertions>`." msgstr "" msgid "" -"This function \"steals\" a reference to *o*, and, unlike :c:func:" -"`PyTuple_SetItem`, does *not* discard a reference to any item that is being " -"replaced; any reference in the tuple at position *pos* will be leaked." +"This function \":term:`steals `\" a reference to *o*, and, " +"unlike :c:func:`PyTuple_SetItem`, does *not* discard a reference to any item " +"that is being replaced; any reference in the tuple at position *pos* will be " +"leaked." msgstr "" msgid "" @@ -128,24 +130,24 @@ msgid "" "Client code should never assume that the resulting value of ``*p`` will be " "the same as before calling this function. If the object referenced by ``*p`` " "is replaced, the original ``*p`` is destroyed. On failure, returns ``-1`` " -"and sets ``*p`` to ``NULL``, and raises :exc:`MemoryError` or :exc:" -"`SystemError`." +"and sets ``*p`` to ``NULL``, and raises :exc:`MemoryError` " +"or :exc:`SystemError`." msgstr "" msgid "Struct Sequence Objects" msgstr "" msgid "" -"Struct sequence objects are the C equivalent of :func:`~collections." -"namedtuple` objects, i.e. a sequence whose items can also be accessed " -"through attributes. To create a struct sequence, you first have to create a " -"specific struct sequence type." +"Struct sequence objects are the C equivalent " +"of :func:`~collections.namedtuple` objects, i.e. a sequence whose items can " +"also be accessed through attributes. To create a struct sequence, you first " +"have to create a specific struct sequence type." msgstr "" msgid "" "Create a new struct sequence type from the data in *desc*, described below. " -"Instances of the resulting type can be created with :c:func:" -"`PyStructSequence_New`." +"Instances of the resulting type can be created " +"with :c:func:`PyStructSequence_New`." msgstr "" msgid "Return ``NULL`` with an exception set on failure." @@ -178,15 +180,15 @@ msgstr "" msgid "" "Describes a field of a struct sequence. As a struct sequence is modeled as a " -"tuple, all fields are typed as :c:expr:`PyObject*`. The index in the :c:" -"member:`~PyStructSequence_Desc.fields` array of the :c:type:" -"`PyStructSequence_Desc` determines which field of the struct sequence is " -"described." +"tuple, all fields are typed as :c:expr:`PyObject*`. The index in " +"the :c:member:`~PyStructSequence_Desc.fields` array of " +"the :c:type:`PyStructSequence_Desc` determines which field of the struct " +"sequence is described." msgstr "" msgid "" -"Name for the field or ``NULL`` to end the list of named fields, set to :c:" -"data:`PyStructSequence_UnnamedField` to leave unnamed." +"Name for the field or ``NULL`` to end the list of named fields, set " +"to :c:data:`PyStructSequence_UnnamedField` to leave unnamed." msgstr "" msgid "Field docstring or ``NULL`` to omit." @@ -199,8 +201,8 @@ msgid "The type was changed from ``char *``." msgstr "" msgid "" -"Creates an instance of *type*, which must have been created with :c:func:" -"`PyStructSequence_NewType`." +"Creates an instance of *type*, which must have been created " +"with :c:func:`PyStructSequence_NewType`." msgstr "" msgid "" @@ -219,7 +221,7 @@ msgid "" "new instances." msgstr "" -msgid "This function \"steals\" a reference to *o*." +msgid "This function \":term:`steals `\" a reference to *o*." msgstr "" msgid "Alias to :c:func:`PyStructSequence_SetItem`." diff --git a/c-api/type.po b/c-api/type.po index e62ea9255d..076f06f43c 100644 --- a/c-api/type.po +++ b/c-api/type.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +30,8 @@ msgid "The C structure of the objects used to describe built-in types." msgstr "" msgid "" -"This is the type object for type objects; it is the same object as :class:" -"`type` in the Python layer." +"This is the type object for type objects; it is the same object " +"as :class:`type` in the Python layer." msgstr "" msgid "" @@ -53,9 +52,9 @@ msgstr "" msgid "" "Return the :c:member:`~PyTypeObject.tp_flags` member of *type*. This " "function is primarily meant for use with ``Py_LIMITED_API``; the individual " -"flag bits are guaranteed to be stable across Python releases, but access to :" -"c:member:`~PyTypeObject.tp_flags` itself is not part of the :ref:`limited " -"API `." +"flag bits are guaranteed to be stable across Python releases, but access " +"to :c:member:`~PyTypeObject.tp_flags` itself is not part of " +"the :ref:`limited API `." msgstr "" msgid "The return type is now ``unsigned long`` rather than ``long``." @@ -98,24 +97,24 @@ msgid "" msgstr "" msgid "" -"Clear watcher identified by *watcher_id* (previously returned from :c:func:" -"`PyType_AddWatcher`). Return ``0`` on success, ``-1`` on error (e.g. if " -"*watcher_id* was never registered.)" +"Clear watcher identified by *watcher_id* (previously returned " +"from :c:func:`PyType_AddWatcher`). Return ``0`` on success, ``-1`` on error " +"(e.g. if *watcher_id* was never registered.)" msgstr "" msgid "" "An extension should never call ``PyType_ClearWatcher`` with a *watcher_id* " -"that was not returned to it by a previous call to :c:func:" -"`PyType_AddWatcher`." +"that was not returned to it by a previous call " +"to :c:func:`PyType_AddWatcher`." msgstr "" msgid "" -"Mark *type* as watched. The callback granted *watcher_id* by :c:func:" -"`PyType_AddWatcher` will be called whenever :c:func:`PyType_Modified` " -"reports a change to *type*. (The callback may be called only once for a " -"series of consecutive modifications to *type*, if :c:func:`!_PyType_Lookup` " -"is not called on *type* between the modifications; this is an implementation " -"detail and subject to change.)" +"Mark *type* as watched. The callback granted *watcher_id* " +"by :c:func:`PyType_AddWatcher` will be called " +"whenever :c:func:`PyType_Modified` reports a change to *type*. (The callback " +"may be called only once for a series of consecutive modifications to *type*, " +"if :c:func:`!_PyType_Lookup` is not called on *type* between the " +"modifications; this is an implementation detail and subject to change.)" msgstr "" msgid "" @@ -123,6 +122,21 @@ msgid "" "not returned to it by a previous call to :c:func:`PyType_AddWatcher`." msgstr "" +msgid "" +"Mark *type* as not watched. This undoes a previous call " +"to :c:func:`PyType_Watch`. *type* must not be ``NULL``." +msgstr "" + +msgid "" +"An extension should never call this function with a *watcher_id* that was " +"not returned to it by a previous call to :c:func:`PyType_AddWatcher`." +msgstr "" + +msgid "" +"On success, this function returns ``0``. On failure, this function returns " +"``-1`` with an exception set." +msgstr "" + msgid "Type of a type-watcher callback function." msgstr "" @@ -137,6 +151,18 @@ msgid "" "features are denoted by single bit flags." msgstr "" +msgid "" +"Return non-zero if the type object *type* sets the subclass flag *flag*. " +"Subclass flags are denoted by :c:macro:`Py_TPFLAGS_*_SUBCLASS " +"`. This function is used by many ``_Check`` " +"functions for common types." +msgstr "" + +msgid "" +":c:func:`PyObject_TypeCheck`, which is used as a slower alternative in " +"``_Check`` functions for types that don't come with subclass 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`." @@ -146,9 +172,10 @@ msgid "Return true if *a* is a subtype of *b*." msgstr "" msgid "" -"This function only checks for actual subtypes, which means that :meth:`~type." -"__subclasscheck__` is not called on *b*. Call :c:func:`PyObject_IsSubclass` " -"to do the same check that :func:`issubclass` would do." +"This function only checks for actual subtypes, which means " +"that :meth:`~type.__subclasscheck__` is not called on *b*. " +"Call :c:func:`PyObject_IsSubclass` to do the same check " +"that :func:`issubclass` would do." msgstr "" msgid "" @@ -159,8 +186,8 @@ 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." +"object. Create a new instance using the " +"type's :c:member:`~PyTypeObject.tp_alloc` slot." msgstr "" msgid "" @@ -174,31 +201,31 @@ msgid "" "If some of the base classes implements the GC protocol and the provided type " "does not include the :c:macro:`Py_TPFLAGS_HAVE_GC` in its flags, then the GC " "protocol will be automatically implemented from its parents. On the " -"contrary, if the type being created does include :c:macro:" -"`Py_TPFLAGS_HAVE_GC` in its flags then it **must** implement the GC protocol " -"itself by at least implementing the :c:member:`~PyTypeObject.tp_traverse` " -"handle." +"contrary, if the type being created does " +"include :c:macro:`Py_TPFLAGS_HAVE_GC` in its flags then it **must** " +"implement the GC protocol itself by at least implementing " +"the :c:member:`~PyTypeObject.tp_traverse` handle." msgstr "" msgid "" -"Return the type's name. Equivalent to getting the type's :attr:`~type." -"__name__` attribute." +"Return the type's name. Equivalent to getting the " +"type's :attr:`~type.__name__` attribute." msgstr "" msgid "" -"Return the type's qualified name. Equivalent to getting the type's :attr:" -"`~type.__qualname__` attribute." +"Return the type's qualified name. Equivalent to getting the " +"type's :attr:`~type.__qualname__` attribute." msgstr "" msgid "" "Return the type's fully qualified name. Equivalent to ``f\"{type.__module__}." -"{type.__qualname__}\"``, or :attr:`type.__qualname__` if :attr:`type." -"__module__` is not a string or is equal to ``\"builtins\"``." +"{type.__qualname__}\"``, or :attr:`type.__qualname__` " +"if :attr:`type.__module__` is not a string or is equal to ``\"builtins\"``." msgstr "" msgid "" -"Return the type's module name. Equivalent to getting the :attr:`type." -"__module__` attribute." +"Return the type's module name. Equivalent to getting " +"the :attr:`type.__module__` attribute." msgstr "" msgid "" @@ -222,6 +249,12 @@ msgid "" "created using :c:func:`PyType_FromModuleAndSpec`." msgstr "" +msgid "" +"The returned reference is :term:`borrowed ` from *type*, " +"and will be valid as long as you hold a reference to *type*. Do not release " +"it with :c:func:`Py_DECREF` or similar." +msgstr "" + msgid "" "If no module is associated with the given type, sets :py:class:`TypeError` " "and returns ``NULL``." @@ -233,14 +266,14 @@ msgid "" "not return the intended result. ``Py_TYPE(self)`` may be a *subclass* of the " "intended class, and subclasses are not necessarily defined in the same " "module as their superclass. See :c:type:`PyCMethod` to get the class that " -"defines the method. See :c:func:`PyType_GetModuleByDef` for cases when :c:" -"type:`!PyCMethod` cannot be used." +"defines the method. See :c:func:`PyType_GetModuleByDef` for cases " +"when :c:type:`!PyCMethod` cannot be used." msgstr "" msgid "" "Return the state of the module object associated with the given type. This " -"is a shortcut for calling :c:func:`PyModule_GetState()` on the result of :c:" -"func:`PyType_GetModule`." +"is a shortcut for calling :c:func:`PyModule_GetState()` on the result " +"of :c:func:`PyType_GetModule`." msgstr "" msgid "" @@ -249,8 +282,8 @@ msgid "" msgstr "" msgid "" -"Find the first superclass whose module was created from the given :c:type:" -"`PyModuleDef` *def*, and return that module." +"Find the first superclass whose module was created from the " +"given :c:type:`PyModuleDef` *def*, and return that module." msgstr "" msgid "" @@ -258,11 +291,12 @@ msgid "" msgstr "" msgid "" -"This function is intended to be used together with :c:func:" -"`PyModule_GetState()` to get module state from slot methods (such as :c:" -"member:`~PyTypeObject.tp_init` or :c:member:`~PyNumberMethods.nb_add`) and " -"other places where a method's defining class cannot be passed using the :c:" -"type:`PyCMethod` calling convention." +"This function is intended to be used together " +"with :c:func:`PyModule_GetState()` to get module state from slot methods " +"(such as :c:member:`~PyTypeObject.tp_init` " +"or :c:member:`~PyNumberMethods.nb_add`) and other places where a method's " +"defining class cannot be passed using the :c:type:`PyCMethod` calling " +"convention." msgstr "" msgid "Attempt to assign a version tag to the given type." @@ -273,6 +307,17 @@ msgid "" "assigned, or 0 if a new tag could not be assigned." msgstr "" +msgid "" +"Return true if instances of *type* support creating weak references, false " +"otherwise. This function always succeeds. *type* must not be ``NULL``." +msgstr "" + +msgid ":ref:`weakrefobjects`" +msgstr "" + +msgid ":py:mod:`weakref`" +msgstr "" + msgid "Creating Heap-Allocated Types" msgstr "" @@ -282,8 +327,8 @@ msgid "" msgstr "" msgid "" -"Create and return a :ref:`heap type ` from the *spec* (see :c:" -"macro:`Py_TPFLAGS_HEAPTYPE`)." +"Create and return a :ref:`heap type ` from the *spec* " +"(see :c:macro:`Py_TPFLAGS_HEAPTYPE`)." msgstr "" msgid "" @@ -311,8 +356,8 @@ msgstr "" msgid "" "The *module* argument can be used to record the module in which the new " "class is defined. It must be a module object or ``NULL``. If not ``NULL``, " -"the module is associated with the new type and can later be retrieved with :" -"c:func:`PyType_GetModule`. The associated module is not inherited by " +"the module is associated with the new type and can later be retrieved " +"with :c:func:`PyType_GetModule`. The associated module is not inherited by " "subclasses; it must be specified for each class individually." msgstr "" @@ -320,10 +365,10 @@ msgid "This function calls :c:func:`PyType_Ready` on the new type." msgstr "" msgid "" -"Note that this function does *not* fully match the behavior of calling :py:" -"class:`type() ` or using the :keyword:`class` statement. With user-" -"provided base types or metaclasses, prefer :ref:`calling ` :py:" -"class:`type` (or the metaclass) over ``PyType_From*`` functions. " +"Note that this function does *not* fully match the behavior of " +"calling :py:class:`type() ` or using the :keyword:`class` statement. " +"With user-provided base types or metaclasses, prefer :ref:`calling ` :py:class:`type` (or the metaclass) over ``PyType_From*`` functions. " "Specifically:" msgstr "" @@ -380,8 +425,8 @@ msgid "Name of the type, used to set :c:member:`PyTypeObject.tp_name`." msgstr "" msgid "" -"If positive, specifies the size of the instance in bytes. It is used to set :" -"c:member:`PyTypeObject.tp_basicsize`." +"If positive, specifies the size of the instance in bytes. It is used to " +"set :c:member:`PyTypeObject.tp_basicsize`." msgstr "" msgid "" @@ -391,19 +436,20 @@ msgstr "" msgid "" "If negative, the absolute value specifies how much space instances of the " -"class need *in addition* to the superclass. Use :c:func:" -"`PyObject_GetTypeData` to get a pointer to subclass-specific memory reserved " -"this way. For negative :c:member:`!basicsize`, Python will insert padding " -"when needed to meet :c:member:`~PyTypeObject.tp_basicsize`'s alignment " -"requirements." +"class need *in addition* to the superclass. " +"Use :c:func:`PyObject_GetTypeData` to get a pointer to subclass-specific " +"memory reserved this way. For negative :c:member:`!basicsize`, Python will " +"insert padding when needed to meet :c:member:`~PyTypeObject.tp_basicsize`'s " +"alignment requirements." msgstr "" msgid "Previously, this field could not be negative." msgstr "" msgid "" -"Size of one element of a variable-size type, in bytes. Used to set :c:member:" -"`PyTypeObject.tp_itemsize`. See ``tp_itemsize`` documentation for caveats." +"Size of one element of a variable-size type, in bytes. Used to " +"set :c:member:`PyTypeObject.tp_itemsize`. See ``tp_itemsize`` documentation " +"for caveats." msgstr "" msgid "" @@ -415,7 +461,8 @@ msgid "" msgstr "" msgid "" -"The base is not variable-sized (its :c:member:`~PyTypeObject.tp_itemsize`)." +"The base is not variable-sized (its :c:member:`~PyTypeObject.tp_itemsize` is " +"zero)." msgstr "" msgid "" @@ -435,8 +482,8 @@ msgid "Type flags, used to set :c:member:`PyTypeObject.tp_flags`." msgstr "" msgid "" -"If the ``Py_TPFLAGS_HEAPTYPE`` flag is not set, :c:func:" -"`PyType_FromSpecWithBases` sets it automatically." +"If the ``Py_TPFLAGS_HEAPTYPE`` flag is not " +"set, :c:func:`PyType_FromSpecWithBases` sets it automatically." msgstr "" msgid "" @@ -456,10 +503,9 @@ msgid "A slot ID." msgstr "" msgid "" -"Slot IDs are named like the field names of the structures :c:type:" -"`PyTypeObject`, :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, :c:" -"type:`PyMappingMethods` and :c:type:`PyAsyncMethods` with an added ``Py_`` " -"prefix. For example, use:" +"Slot IDs are named like the field names of the " +"structures :c:type:`PyTypeObject`, :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, :c:type:`PyMappingMethods` " +"and :c:type:`PyAsyncMethods` with an added ``Py_`` prefix. For example, use:" msgstr "" msgid "``Py_tp_dealloc`` to set :c:member:`PyTypeObject.tp_dealloc`" @@ -476,13 +522,13 @@ msgid "" msgstr "" msgid "" -":c:member:`~PyTypeObject.tp_weaklistoffset` (use :c:macro:" -"`Py_TPFLAGS_MANAGED_WEAKREF` instead if possible)" +":c:member:`~PyTypeObject.tp_weaklistoffset` " +"(use :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` instead if possible)" msgstr "" msgid "" -":c:member:`~PyTypeObject.tp_dictoffset` (use :c:macro:" -"`Py_TPFLAGS_MANAGED_DICT` instead if possible)" +":c:member:`~PyTypeObject.tp_dictoffset` " +"(use :c:macro:`Py_TPFLAGS_MANAGED_DICT` instead if possible)" msgstr "" msgid "" @@ -492,38 +538,39 @@ msgstr "" msgid "" "If it is not possible to switch to a ``MANAGED`` flag (for example, for " -"vectorcall or to support Python older than 3.12), specify the offset in :c:" -"member:`Py_tp_members `. See :ref:`PyMemberDef " -"documentation ` for details." +"vectorcall or to support Python older than 3.12), specify the offset " +"in :c:member:`Py_tp_members `. " +"See :ref:`PyMemberDef documentation ` for details." msgstr "" msgid "The following fields cannot be set at all when creating a heap type:" msgstr "" msgid "" -":c:member:`~PyTypeObject.tp_vectorcall` (use :c:member:`~PyTypeObject." -"tp_new` and/or :c:member:`~PyTypeObject.tp_init`)" +":c:member:`~PyTypeObject.tp_vectorcall` " +"(use :c:member:`~PyTypeObject.tp_new` and/" +"or :c:member:`~PyTypeObject.tp_init`)" msgstr "" msgid "" -"Internal fields: :c:member:`~PyTypeObject.tp_dict`, :c:member:`~PyTypeObject." -"tp_mro`, :c:member:`~PyTypeObject.tp_cache`, :c:member:`~PyTypeObject." -"tp_subclasses`, and :c:member:`~PyTypeObject.tp_weaklist`." +"Internal " +"fields: :c:member:`~PyTypeObject.tp_dict`, :c:member:`~PyTypeObject.tp_mro`, :c:member:`~PyTypeObject.tp_cache`, :c:member:`~PyTypeObject.tp_subclasses`, " +"and :c:member:`~PyTypeObject.tp_weaklist`." msgstr "" msgid "" "Setting :c:data:`Py_tp_bases` or :c:data:`Py_tp_base` may be problematic on " -"some platforms. To avoid issues, use the *bases* argument of :c:func:" -"`PyType_FromSpecWithBases` instead." +"some platforms. To avoid issues, use the *bases* argument " +"of :c:func:`PyType_FromSpecWithBases` instead." msgstr "" msgid "Slots in :c:type:`PyBufferProcs` may be set in the unlimited API." msgstr "" msgid "" -":c:member:`~PyBufferProcs.bf_getbuffer` and :c:member:`~PyBufferProcs." -"bf_releasebuffer` are now available under the :ref:`limited API `." +":c:member:`~PyBufferProcs.bf_getbuffer` " +"and :c:member:`~PyBufferProcs.bf_releasebuffer` are now available under " +"the :ref:`limited API `." msgstr "" msgid "" diff --git a/c-api/typehints.po b/c-api/typehints.po index fbcdc3778e..d4273d8a9b 100644 --- a/c-api/typehints.po +++ b/c-api/typehints.po @@ -36,14 +36,14 @@ msgid "" "Create a :ref:`GenericAlias ` object. Equivalent to " "calling the Python class :class:`types.GenericAlias`. The *origin* and " "*args* arguments set the ``GenericAlias``\\ 's ``__origin__`` and " -"``__args__`` attributes respectively. *origin* should be a :c:expr:" -"`PyTypeObject*`, and *args* can be a :c:expr:`PyTupleObject*` or any " -"``PyObject*``. If *args* passed is not a tuple, a 1-tuple is automatically " -"constructed and ``__args__`` is set to ``(args,)``. Minimal checking is done " -"for the arguments, so the function will succeed even if *origin* is not a " -"type. The ``GenericAlias``\\ 's ``__parameters__`` attribute is constructed " -"lazily from ``__args__``. On failure, an exception is raised and ``NULL`` " -"is returned." +"``__args__`` attributes respectively. *origin* should be " +"a :c:expr:`PyTypeObject*`, and *args* can be a :c:expr:`PyTupleObject*` or " +"any ``PyObject*``. If *args* passed is not a tuple, a 1-tuple is " +"automatically constructed and ``__args__`` is set to ``(args,)``. Minimal " +"checking is done for the arguments, so the function will succeed even if " +"*origin* is not a type. The ``GenericAlias``\\ 's ``__parameters__`` " +"attribute is constructed lazily from ``__args__``. On failure, an exception " +"is raised and ``NULL`` is returned." msgstr "" msgid "Here's an example of how to make an extension type generic::" diff --git a/c-api/typeobj.po b/c-api/typeobj.po index 771b9cc10f..0856aa643d 100644 --- a/c-api/typeobj.po +++ b/c-api/typeobj.po @@ -1,22 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# haaritsubaki, 2023 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,7 +25,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Type Object Structures" -msgstr "" +msgstr "Struktury obiektów typu" msgid "" "Perhaps one of the most important structures of the Python object system is " @@ -38,6 +36,13 @@ msgid "" "they are very important to the interpreter itself and to any extension " "module that implements new types." msgstr "" +"Prawdopodobnie jedną z najważniejszych struktur systemu obiektów Pythona " +"jest struktura definiująca nowy typ: struktura :c:type:`PyTypeObject`. " +"Obiekty typów można obsługiwać za pomocą dowolnej z funkcji ``PyObject_*`` " +"lub ``PyType_*``, ale nie oferują one wiele interesującego dla większości " +"aplikacji Pythona. Obiekty te są fundamentalne dla zachowania obiektów, " +"dlatego są bardzo ważne dla samego interpretera i każdego modułu rozszerzeń " +"implementującego nowe typy." msgid "" "Type objects are fairly large compared to most of the standard types. The " @@ -47,30 +52,38 @@ msgid "" "detail in this section. The fields will be described in the order in which " "they occur in the structure." msgstr "" +"Obiekty typu są dość duże w porównaniu z większością typów standardowych. " +"Wynika to z faktu, że każdy obiekt typu przechowuje dużą liczbę wartości, " +"głównie wskaźników do funkcji języka C, z których każdy implementuje " +"niewielką część funkcjonalności typu. Pola obiektu typu zostaną szczegółowo " +"omówione w tej sekcji. Zostaną one opisane w kolejności, w jakiej występują " +"w strukturze." msgid "" "In addition to the following quick reference, the :ref:`typedef-examples` " -"section provides at-a-glance insight into the meaning and use of :c:type:" -"`PyTypeObject`." +"section provides at-a-glance insight into the meaning and use " +"of :c:type:`PyTypeObject`." msgstr "" +"Oprócz poniższego krótkiego odniesienia, sekcja ta zapewnia szybki wgląd w " +"znaczenie i użycie ." msgid "Quick Reference" -msgstr "" +msgstr "Szybkie odniesienie" msgid "\"tp slots\"" -msgstr "" +msgstr "„gniazda tp”" msgid "PyTypeObject Slot [#slots]_" -msgstr "" +msgstr "Gniazdo obiektu PyType [#slotów]_" msgid ":ref:`Type `" msgstr ":ref:`Type `" msgid "special methods/attrs" -msgstr "" +msgstr "metody/atrybuty specjalne" msgid "Info [#cols]_" -msgstr "" +msgstr "Informacje [#cols]_" msgid "O" msgstr "O" @@ -88,7 +101,7 @@ msgid " :c:member:`~PyTypeObject.tp_name`" msgstr " :c:member:`~PyTypeObject.tp_name`" msgid "const char *" -msgstr "" +msgstr "znak stały *" msgid "__name__" msgstr "__name__" @@ -250,7 +263,7 @@ msgid ":c:type:`richcmpfunc`" msgstr ":c:type:`richcmpfunc`" msgid "__lt__, __le__, __eq__, __ne__, __gt__, __ge__" -msgstr "" +msgstr "__lt__, __le__, __eq__, __ne__, __gt__, __ge__" msgid "(:c:member:`~PyTypeObject.tp_weaklistoffset`)" msgstr "(:c:member:`~PyTypeObject.tp_weaklistoffset`)" @@ -385,7 +398,7 @@ msgid "[:c:member:`~PyTypeObject.tp_subclasses`]" msgstr "[:c:member:`~PyTypeObject.tp_subclasses`]" msgid "void *" -msgstr "" +msgstr "próżnia *" msgid "__subclasses__" msgstr "__subclasses__" @@ -423,30 +436,38 @@ msgstr "nieoznaczony typ znakowy" msgid "" "**()**: A slot name in parentheses indicates it is (effectively) deprecated." msgstr "" +"**()**: Nazwa slotu w nawiasach oznacza, że ​​jest on (faktycznie) " +"przestarzały." msgid "" "**<>**: Names in angle brackets should be initially set to ``NULL`` and " "treated as read-only." msgstr "" +"**<>**: Nazwy w nawiasach kątowych powinny być początkowo ustawione na " +"``NULL`` i traktowane jako tylko do odczytu." msgid "**[]**: Names in square brackets are for internal use only." msgstr "" +"**[]**: Nazwy w nawiasach kwadratowych są przeznaczone wyłącznie do użytku " +"wewnętrznego." msgid "" "**** (as a prefix) means the field is required (must be non-``NULL``)." msgstr "" +"**** (jako prefiks) oznacza, że ​​pole jest wymagane (nie może być wartością " +"``NULL``)." msgid "Columns:" -msgstr "" +msgstr "Kolumny:" msgid "**\"O\"**: set on :c:data:`PyBaseObject_Type`" -msgstr "" +msgstr "**\"O\"**: ustawiono na :c:data:`PyBaseObject_Type`" msgid "**\"T\"**: set on :c:data:`PyType_Type`" -msgstr "" +msgstr "**\"T\"**: ustawione na :c:data:`PyType_Type`" msgid "**\"D\"**: default (if slot is set to ``NULL``)" -msgstr "" +msgstr "**\"D\"**: domyślne (jeśli slot jest ustawiony na ``NULL``)" msgid "" "X - PyType_Ready sets this value if it is NULL\n" @@ -455,9 +476,13 @@ msgid "" "\n" "Also see the inheritance column (\"I\")." msgstr "" +"X - PyType_Ready ustawia tę wartość, jeśli jest ona NULL~ - PyType_Ready " +"zawsze ustawia tę wartość (powinna być NULL)? - PyType_Ready może ustawić tę " +"wartość w zależności od innych slotówZobacz także kolumnę dziedziczenia " +"(\"I\")." msgid "**\"I\"**: inheritance" -msgstr "" +msgstr "**\"I\"**: dziedziczenie" msgid "" "X - type slot is inherited via *PyType_Ready* if defined with a *NULL* " @@ -467,20 +492,26 @@ msgid "" "description\n" "? - it's complicated; see the slot's description" msgstr "" +"X - typ slotu dziedziczony jest przez *PyType_Ready*, jeśli zdefiniowany " +"jest z wartością *NULL*% - sloty podstruktury są dziedziczone indywidualnieG " +"- dziedziczone, ale tylko w połączeniu z innymi slotami; zobacz opis slotu? " +"- to skomplikowane; zobacz opis slotu" msgid "" "Note that some slots are effectively inherited through the normal attribute " "lookup chain." msgstr "" +"Należy pamiętać, że niektóre sloty są skutecznie dziedziczone poprzez " +"normalny łańcuch wyszukiwania atrybutów." msgid "sub-slots" msgstr "sub-slots" msgid "Slot" -msgstr "" +msgstr "Szczelina" msgid "special methods" -msgstr "" +msgstr "metody specjalne" msgid ":c:member:`~PyAsyncMethods.am_await`" msgstr ":c:member:`~PyAsyncMethods.am_await`" @@ -800,26 +831,32 @@ msgstr ":c:member:`~PyBufferProcs.bf_getbuffer`" msgid ":c:func:`getbufferproc`" msgstr ":c:func:`getbufferproc`" +msgid "__buffer__" +msgstr "__bufor__" + msgid ":c:member:`~PyBufferProcs.bf_releasebuffer`" msgstr ":c:member:`~PyBufferProcs.bf_releasebuffer`" msgid ":c:func:`releasebufferproc`" msgstr ":c:func:`releasebufferproc`" +msgid "__release_\\ buffer\\__" +msgstr "__release_\\ bufor\\__" + msgid "slot typedefs" -msgstr "" +msgstr "definicje typów gniazd" msgid "typedef" msgstr "typedef" msgid "Parameter Types" -msgstr "" +msgstr "Typy parametrów" msgid "Return Type" -msgstr "" +msgstr "Typ zwracany" msgid "void" -msgstr "" +msgstr "próżnia" msgid ":c:type:`visitproc`" msgstr ":c:type:`visitproc`" @@ -840,16 +877,18 @@ msgid ":c:type:`releasebufferproc`" msgstr ":c:type:`releasebufferproc`" msgid "See :ref:`slot-typedefs` below for more detail." -msgstr "" +msgstr "Więcej szczegółów znajdziesz poniżej w :ref:`slot-typedefs`." msgid "PyTypeObject Definition" -msgstr "" +msgstr "Definicja obiektu PyTypeObject" msgid "" -"The structure definition for :c:type:`PyTypeObject` can be found in :file:" -"`Include/cpython/object.h`. For convenience of reference, this repeats the " -"definition found there:" +"The structure definition for :c:type:`PyTypeObject` can be found " +"in :file:`Include/cpython/object.h`. For convenience of reference, this " +"repeats the definition found there:" msgstr "" +"Definicję struktury dla :c:type:`PyTypeObject` można znaleźć w " +"pliku :file:`Include/cpython/object.h`. Dla wygody powtórzono tam definicję:" msgid "" "typedef struct _typeobject {\n" @@ -941,31 +980,39 @@ msgid "" msgstr "" msgid "PyObject Slots" -msgstr "" +msgstr "Sloty PyObject" msgid "" -"The type object structure extends the :c:type:`PyVarObject` structure. The :" -"c:member:`~PyVarObject.ob_size` field is used for dynamic types (created by :" -"c:func:`!type_new`, usually called from a class statement). Note that :c:" -"data:`PyType_Type` (the metatype) initializes :c:member:`~PyTypeObject." -"tp_itemsize`, which means that its instances (i.e. type objects) *must* have " +"The type object structure extends the :c:type:`PyVarObject` structure. " +"The :c:member:`~PyVarObject.ob_size` field is used for dynamic types " +"(created by :c:func:`!type_new`, usually called from a class statement). " +"Note that :c:data:`PyType_Type` (the metatype) " +"initializes :c:member:`~PyTypeObject.tp_itemsize`, which means that its " +"instances (i.e. type objects) *must* have " "the :c:member:`~PyVarObject.ob_size` field." msgstr "" +"Struktura obiektu typu rozszerza strukturę :c:type:`PyVarObject`. " +"Pole :c:member:`~PyVarObject.ob_size` jest używane dla typów dynamicznych " +"(tworzonych przez :c:func:`!type_new`, zazwyczaj wywoływanych z instrukcji " +"klasy). Należy pamiętać, że :c:data:`PyType_Type` (metatyp) " +"inicjuje :c:member:`~PyTypeObject.tp_itemsize`, co oznacza, że ​​jego " +"instancje (tj. obiekty typu) *muszą* mieć " +"pole :c:member:`~PyVarObject.ob_size`." msgid "" "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." +"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 "" +msgstr "**Dziedzictwo:**" msgid "This field is not inherited by subtypes." -msgstr "" +msgstr "To pole nie jest dziedziczone przez podtypy." msgid "" "This is the type's type, in other words its metatype. It is initialized by " @@ -977,43 +1024,67 @@ msgid "" "explicitly at the start of the module's initialization function, before " "doing anything else. This is typically done like this::" msgstr "" +"To jest typ typu, innymi słowy jego metatyp. Jest on inicjowany przez " +"argument makra ``PyObject_HEAD_INIT``, a jego wartość powinna normalnie " +"wynosić ``&PyType_Type``. Jednak w przypadku dynamicznie ładowalnych modułów " +"rozszerzeń, które muszą działać w systemie Windows (przynajmniej), " +"kompilator zgłasza, że ​​nie jest to prawidłowy inicjator. Dlatego przyjętą " +"konwencją jest przekazywanie ``NULL`` do makra ``PyObject_HEAD_INIT`` i " +"jawne inicjowanie tego pola na początku funkcji inicjującej modułu, przed " +"wykonaniem jakichkolwiek innych czynności. Zazwyczaj robi się to w " +"następujący sposób:" msgid "Foo_Type.ob_type = &PyType_Type;" -msgstr "" +msgstr "Foo_Type.ob_type = &PyType_Type;" msgid "" -"This should be done before any instances of the type are created. :c:func:" -"`PyType_Ready` checks if :c:member:`~PyObject.ob_type` is ``NULL``, and if " -"so, initializes it to the :c:member:`~PyObject.ob_type` field of the base " -"class. :c:func:`PyType_Ready` will not change this field if it is non-zero." +"This should be done before any instances of the type are " +"created. :c:func:`PyType_Ready` checks if :c:member:`~PyObject.ob_type` is " +"``NULL``, and if so, initializes it to the :c:member:`~PyObject.ob_type` " +"field of the base class. :c:func:`PyType_Ready` will not change this field " +"if it is non-zero." msgstr "" +"Należy to zrobić przed utworzeniem jakichkolwiek wystąpień " +"typu. :c:func:`PyType_Ready` sprawdza, czy :c:member:`~PyObject.ob_type` ma " +"wartość ``NULL``, i jeśli tak, to inicjuje go w " +"polu :c:member:`~PyObject.ob_type` klasy bazowej. :c:func:`PyType_Ready` nie " +"zmieni tego pola, jeśli ma ono wartość różną od zera." msgid "This field is inherited by subtypes." -msgstr "" +msgstr "To pole jest dziedziczone przez podtypy." msgid "PyVarObject Slots" -msgstr "" +msgstr "Sloty PyVarObject" msgid "" "For :ref:`statically allocated type objects `, this should be " "initialized to zero. For :ref:`dynamically allocated type objects `, this field has a special internal meaning." msgstr "" +"W przypadku obiektów typu :ref:`statycznie przydzielanych`, pole to powinno " +"zostać zainicjowane zerem. W przypadku obiektów typu :ref:`dynamicznie " +"przydzielanych`, pole to ma specjalne znaczenie wewnętrzne." msgid "" -"This field should be accessed using the :c:func:`Py_SIZE()` and :c:func:" -"`Py_SET_SIZE()` macros." +"This field should be accessed using the :c:func:`Py_SIZE()` " +"and :c:func:`Py_SET_SIZE()` macros." msgstr "" msgid "PyTypeObject Slots" -msgstr "" +msgstr "Sloty PyTypeObject" msgid "" "Each slot has a section describing inheritance. If :c:func:`PyType_Ready` " "may set a value when the field is set to ``NULL`` then there will also be a " -"\"Default\" section. (Note that many fields set on :c:data:" -"`PyBaseObject_Type` and :c:data:`PyType_Type` effectively act as defaults.)" +"\"Default\" section. (Note that many fields set " +"on :c:data:`PyBaseObject_Type` and :c:data:`PyType_Type` effectively act as " +"defaults.)" msgstr "" +"Każdy slot ma sekcję opisującą dziedziczenie. Jeśli :c:func:`PyType_Ready` " +"może ustawić wartość, gdy pole jest ustawione na ``NULL``, pojawi się " +"również sekcja „Domyślne”. (Należy pamiętać, że wiele pól ustawionych " +"w :c:data:`PyBaseObject_Type` i :c:data:`PyType_Type` działa jako wartości " +"domyślne)." msgid "" "Pointer to a NUL-terminated string containing the name of the type. For " @@ -1021,16 +1092,27 @@ msgid "" "module name, followed by a dot, followed by the type name; for built-in " "types, it should be just the type name. If the module is a submodule of a " "package, the full package name is part of the full module name. For " -"example, a type named :class:`!T` defined in module :mod:`!M` in subpackage :" -"mod:`!Q` in package :mod:`!P` should have the :c:member:`~PyTypeObject." -"tp_name` initializer ``\"P.Q.M.T\"``." +"example, a type named :class:`!T` defined in module :mod:`!M` in " +"subpackage :mod:`!Q` in package :mod:`!P` should have " +"the :c:member:`~PyTypeObject.tp_name` initializer ``\"P.Q.M.T\"``." msgstr "" +"Wskaźnik do ciągu zakończonego znakiem NUL, zawierającego nazwę typu. W " +"przypadku typów dostępnych jako zmienne globalne modułu ciąg powinien " +"składać się z pełnej nazwy modułu, po której następuje kropka i nazwa typu; " +"w przypadku typów wbudowanych powinna to być po prostu nazwa typu. Jeśli " +"moduł jest podmodułem pakietu, pełna nazwa pakietu jest częścią pełnej nazwy " +"modułu. Na przykład typ o nazwie :class:`!T` zdefiniowany w module :mod:`!M` " +"w subpackage :mod:`!Q` w package :mod:`!P` powinien mieć " +"inicjator :c:member:`~PyTypeObject.tp_name` ``\"P.Q.M.T\"``." msgid "" "For :ref:`dynamically allocated type objects `, this should just " "be the type name, and the module name explicitly stored in the type dict as " "the value for key ``'__module__'``." msgstr "" +"W przypadku :ref:`obiektów typu przydzielanych dynamicznie` powinna to być " +"po prostu nazwa typu i nazwa modułu jawnie zapisane w słowniku typów jako " +"wartość klucza ``'__module__'``." msgid "" "For :ref:`statically allocated type objects `, the *tp_name* " @@ -1038,86 +1120,128 @@ msgid "" "accessible as the :attr:`~type.__module__` attribute, and everything after " "the last dot is made accessible as the :attr:`~type.__name__` attribute." msgstr "" +"W przypadku obiektów typu :ref:`statycznie alokowanych` pole *tp_name* " +"powinno zawierać kropkę. Wszystko przed ostatnią kropką jest udostępniane " +"jako atrybut :attr:`~type.__module__`, a wszystko po ostatniej kropce jest " +"udostępniane jako atrybut :attr:`~type.__name__`." msgid "" "If no dot is present, the entire :c:member:`~PyTypeObject.tp_name` field is " -"made accessible as the :attr:`~type.__name__` attribute, and the :attr:" -"`~type.__module__` attribute is undefined (unless explicitly set in the " -"dictionary, as explained above). This means your type will be impossible to " -"pickle. Additionally, it will not be listed in module documentations " -"created with pydoc." +"made accessible as the :attr:`~type.__name__` attribute, and " +"the :attr:`~type.__module__` attribute is undefined (unless explicitly set " +"in the dictionary, as explained above). This means your type will be " +"impossible to pickle. Additionally, it will not be listed in module " +"documentations created with pydoc." msgstr "" +"Jeśli kropka nie jest obecna, całe pole :c:member:`~PyTypeObject.tp_name` " +"jest dostępne jako atrybut :attr:`~type.__name__`, a " +"atrybut :attr:`~type.__module__` jest niezdefiniowany (chyba że zostanie " +"jawnie ustawiony w słowniku, jak wyjaśniono powyżej). Oznacza to, że Twój " +"typ nie będzie mógł zostać zamarynowany. Dodatkowo nie będzie on wymieniony " +"w dokumentacji modułów utworzonej za pomocą pydoc." msgid "" -"This field must not be ``NULL``. It is the only required field in :c:func:" -"`PyTypeObject` (other than potentially :c:member:`~PyTypeObject." -"tp_itemsize`)." +"This field must not be ``NULL``. It is the only required field " +"in :c:func:`PyTypeObject` (other than " +"potentially :c:member:`~PyTypeObject.tp_itemsize`)." msgstr "" +"To pole nie może mieć wartości ``NULL``. Jest to jedyne wymagane pole " +"w :c:func:`PyTypeObject` (oprócz " +"potencjalnie :c:member:`~PyTypeObject.tp_itemsize`)." msgid "" "These fields allow calculating the size in bytes of instances of the type." msgstr "" +"Pola te umożliwiają obliczenie rozmiaru instancji danego typu w bajtach." msgid "" -"There are two kinds of types: types with fixed-length instances have a zero :" -"c:member:`!tp_itemsize` field, types with variable-length instances have a " -"non-zero :c:member:`!tp_itemsize` field. For a type with fixed-length " -"instances, all instances have the same size, given in :c:member:`!" -"tp_basicsize`. (Exceptions to this rule can be made using :c:func:" -"`PyUnstable_Object_GC_NewWithExtraData`.)" +"There are two kinds of types: types with fixed-length instances have a " +"zero :c:member:`!tp_itemsize` field, types with variable-length instances " +"have a non-zero :c:member:`!tp_itemsize` field. For a type with fixed-" +"length instances, all instances have the same size, given in :c:member:`!" +"tp_basicsize`. (Exceptions to this rule can be made " +"using :c:func:`PyUnstable_Object_GC_NewWithExtraData`.)" msgstr "" +"Zobacz :c:macro:`Py_tp_basicsize`, :c:macro:`Py_tp_extra_basicsize` " +"i :c:macro:`Py_tp_itemsize`, aby zastosować " +"urządzenie :c:member:`identyfikatory slotów `." msgid "" -"For a type with variable-length instances, the instances must have an :c:" -"member:`~PyVarObject.ob_size` field, and the instance size is :c:member:`!" -"tp_basicsize` plus N times :c:member:`!tp_itemsize`, where N is the " -"\"length\" of the object." +"For a type with variable-length instances, the instances must have " +"an :c:member:`~PyVarObject.ob_size` field, and the instance size " +"is :c:member:`!tp_basicsize` plus N times :c:member:`!tp_itemsize`, where N " +"is the \"length\" of the object." msgstr "" +"W przypadku typu z instancjami o zmiennej długości, instancje muszą mieć " +"pole :c:member:`~PyVarObject.ob_size`, a rozmiar instancji " +"wynosi :c:member:`!tp_basicsize` plus N razy :c:member:`!tp_itemsize`, gdzie " +"N to „długość” obiektu." msgid "" "Functions like :c:func:`PyObject_NewVar` will take the value of N as an " "argument, and store in the instance's :c:member:`~PyVarObject.ob_size` " "field. Note that the :c:member:`~PyVarObject.ob_size` field may later be " "used for other purposes. For example, :py:type:`int` instances use the bits " -"of :c:member:`~PyVarObject.ob_size` in an implementation-defined way; the " -"underlying storage and its size should be accessed using :c:func:" -"`PyLong_Export`." +"of :c:member:`~PyVarObject.ob_size` in an implementation-defined way." msgstr "" msgid "" -"The :c:member:`~PyVarObject.ob_size` field should be accessed using the :c:" -"func:`Py_SIZE()` and :c:func:`Py_SET_SIZE()` macros." +"The :c:member:`~PyVarObject.ob_size` field should be accessed using " +"the :c:func:`Py_SIZE()` and :c:func:`Py_SET_SIZE()` macros." msgstr "" +"Do pola :c:member:`~PyVarObject.ob_size` należy uzyskać dostęp za pomocą " +"makr :c:func:`Py_SIZE()` i :c:func:`Py_SET_SIZE()`." msgid "" "Also, the presence of an :c:member:`~PyVarObject.ob_size` field in the " "instance layout doesn't mean that the instance structure is variable-length. " "For example, the :py:type:`list` type has fixed-length instances, yet those " -"instances have a :c:member:`~PyVarObject.ob_size` field. (As with :py:type:" -"`int`, avoid reading lists' :c:member:`!ob_size` directly. Call :c:func:" -"`PyList_Size` instead.)" +"instances have a :c:member:`~PyVarObject.ob_size` field. (As " +"with :py:type:`int`, avoid reading lists' :c:member:`!ob_size` directly. " +"Call :c:func:`PyList_Size` instead.)" msgstr "" +"Ponadto obecność pola :c:member:`~PyVarObject.ob_size` w układzie instancji " +"nie oznacza, że ​​struktura instancji ma zmienną długość. Na przykład " +"typ :py:type:`list` ma instancje o stałej długości, a mimo to instancje te " +"mają pole :c:member:`~PyVarObject.ob_size`. (Podobnie jak w " +"przypadku :py:type:`int`, należy unikać bezpośredniego odczytywania " +"pola :c:member:`!ob_size` list. Zamiast tego należy " +"wywołać :c:func:`PyList_Size`)." msgid "" -"The :c:member:`!tp_basicsize` includes size needed for data of the type's :c:" -"member:`~PyTypeObject.tp_base`, plus any extra data needed by each instance." +"The :c:member:`!tp_basicsize` includes size needed for data of the " +"type's :c:member:`~PyTypeObject.tp_base`, plus any extra data needed by each " +"instance." msgstr "" +":c:member:`!tp_basicsize` obejmuje rozmiar potrzebny dla danych " +"typu :c:member:`~PyTypeObject.tp_base`, plus wszelkie dodatkowe dane " +"potrzebne każdej instancja." msgid "" "The correct way to set :c:member:`!tp_basicsize` is to use the ``sizeof`` " "operator on the struct used to declare the instance layout. This struct must " -"include the struct used to declare the base type. In other words, :c:member:" -"`!tp_basicsize` must be greater than or equal to the base's :c:member:`!" -"tp_basicsize`." +"include the struct used to declare the base type. In other " +"words, :c:member:`!tp_basicsize` must be greater than or equal to the " +"base's :c:member:`!tp_basicsize`." msgstr "" +"Prawidłowym sposobem ustawienia :c:member:`!tp_basicsize` jest użycie " +"operatora ``sizeof`` w strukturze użytej do zadeklarowania układu instancji. " +"Struktura ta musi zawierać strukturę użytą do zadeklarowania typu bazowego. " +"Innymi słowy, :c:member:`!tp_basicsize` musi być większe lub " +"równe :c:member:`!tp_basicsize` elementu bazowego." msgid "" "Since every type is a subtype of :py:type:`object`, this struct must " -"include :c:type:`PyObject` or :c:type:`PyVarObject` (depending on whether :c:" -"member:`~PyVarObject.ob_size` should be included). These are usually defined " -"by the macro :c:macro:`PyObject_HEAD` or :c:macro:`PyObject_VAR_HEAD`, " -"respectively." +"include :c:type:`PyObject` or :c:type:`PyVarObject` (depending on " +"whether :c:member:`~PyVarObject.ob_size` should be included). These are " +"usually defined by the macro :c:macro:`PyObject_HEAD` " +"or :c:macro:`PyObject_VAR_HEAD`, respectively." msgstr "" +"Ponieważ każdy typ jest podtypem :py:type:`object`, ta struktura musi " +"zawierać :c:type:`PyObject` lub :c:type:`PyVarObject` (w zależności od tego, " +"czy :c:member:`~PyVarObject.ob_size` ma być uwzględniony). Są one zazwyczaj " +"definiowane odpowiednio przez makro :c:macro:`PyObject_HEAD` " +"lub :c:macro:`PyObject_VAR_HEAD`." msgid "" "The basic size does not include the GC header size, as that header is not " @@ -1125,8 +1249,8 @@ msgid "" msgstr "" msgid "" -"For cases where struct used to declare the base type is unknown, see :c:" -"member:`PyType_Spec.basicsize` and :c:func:`PyType_FromMetaclass`." +"For cases where struct used to declare the base type is unknown, " +"see :c:member:`PyType_Spec.basicsize` and :c:func:`PyType_FromMetaclass`." msgstr "" msgid "Notes about alignment:" @@ -1171,26 +1295,28 @@ msgid "void tp_dealloc(PyObject *self);" 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 " +"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`." +"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." +"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 "" @@ -1203,9 +1329,9 @@ 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:" +"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 "" @@ -1225,8 +1351,9 @@ msgid "" "calls, since the thread on which :c:member:`!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 :c:" -"member:`!tp_dealloc` will not violate any assumptions of the library." +"taken to ensure that destroying those objects on the thread which " +"called :c:member:`!tp_dealloc` will not violate any assumptions of the " +"library." msgstr "" msgid "" @@ -1248,10 +1375,10 @@ msgid "" msgstr "" msgid "" -"Any class that sets ``Py_TPFLAGS_HAVE_VECTORCALL`` must also set :c:member:" -"`~PyTypeObject.tp_call` and make sure its behaviour is consistent with the " -"*vectorcallfunc* function. This can be done by setting *tp_call* to :c:func:" -"`PyVectorcall_Call`." +"Any class that sets ``Py_TPFLAGS_HAVE_VECTORCALL`` must also " +"set :c:member:`~PyTypeObject.tp_call` and make sure its behaviour is " +"consistent with the *vectorcallfunc* function. This can be done by setting " +"*tp_call* to :c:func:`PyVectorcall_Call`." msgstr "" msgid "" @@ -1261,18 +1388,18 @@ msgstr "" msgid "" "Before version 3.12, it was not recommended for :ref:`mutable heap types " -"` to implement the vectorcall protocol. When a user sets :attr:" -"`~object.__call__` in Python code, only *tp_call* is updated, likely making " -"it inconsistent with the vectorcall function. Since 3.12, setting " -"``__call__`` will disable vectorcall optimization by clearing the :c:macro:" -"`Py_TPFLAGS_HAVE_VECTORCALL` flag." +"` to implement the vectorcall protocol. When a user " +"sets :attr:`~object.__call__` in Python code, only *tp_call* is updated, " +"likely making it inconsistent with the vectorcall function. Since 3.12, " +"setting ``__call__`` will disable vectorcall optimization by clearing " +"the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag." msgstr "" msgid "" -"This field is always inherited. However, the :c:macro:" -"`Py_TPFLAGS_HAVE_VECTORCALL` flag is not always inherited. If it's not set, " -"then the subclass won't use :ref:`vectorcall `, except when :c:" -"func:`PyVectorcall_Call` is explicitly called." +"This field is always inherited. However, " +"the :c:macro:`Py_TPFLAGS_HAVE_VECTORCALL` flag is not always inherited. If " +"it's not set, then the subclass won't use :ref:`vectorcall `, " +"except when :c:func:`PyVectorcall_Call` is explicitly called." msgstr "" msgid "An optional pointer to the get-attribute-string function." @@ -1285,17 +1412,16 @@ msgid "" "attribute name." msgstr "" -msgid "" -"Group: :c:member:`~PyTypeObject.tp_getattr`, :c:member:`~PyTypeObject." -"tp_getattro`" +msgid "Group: :c:member:`~PyTypeObject.tp_getattr`, :c:member:`~PyTypeObject.tp_getattro`" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_getattro`: a subtype inherits both :c:member:`~PyTypeObject.tp_getattr` " +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_getattro`: a subtype inherits " +"both :c:member:`~PyTypeObject.tp_getattr` " "and :c:member:`~PyTypeObject.tp_getattro` from its base type when the " -"subtype's :c:member:`~PyTypeObject.tp_getattr` and :c:member:`~PyTypeObject." -"tp_getattro` are both ``NULL``." +"subtype's :c:member:`~PyTypeObject.tp_getattr` " +"and :c:member:`~PyTypeObject.tp_getattro` are both ``NULL``." msgstr "" msgid "" @@ -1309,17 +1435,16 @@ msgid "" "attribute name." msgstr "" -msgid "" -"Group: :c:member:`~PyTypeObject.tp_setattr`, :c:member:`~PyTypeObject." -"tp_setattro`" +msgid "Group: :c:member:`~PyTypeObject.tp_setattr`, :c:member:`~PyTypeObject.tp_setattro`" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_setattro`: a subtype inherits both :c:member:`~PyTypeObject.tp_setattr` " +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_setattro`: a subtype inherits " +"both :c:member:`~PyTypeObject.tp_setattr` " "and :c:member:`~PyTypeObject.tp_setattro` from its base type when the " -"subtype's :c:member:`~PyTypeObject.tp_setattr` and :c:member:`~PyTypeObject." -"tp_setattro` are both ``NULL``." +"subtype's :c:member:`~PyTypeObject.tp_setattr` " +"and :c:member:`~PyTypeObject.tp_setattro` are both ``NULL``." msgstr "" msgid "" @@ -1337,8 +1462,8 @@ msgid "" msgstr "" msgid "" -"An optional pointer to a function that implements the built-in function :" -"func:`repr`." +"An optional pointer to a function that implements the built-in " +"function :func:`repr`." msgstr "" msgid "The signature is the same as for :c:func:`PyObject_Repr`::" @@ -1398,8 +1523,8 @@ msgid "" msgstr "" msgid "" -"An optional pointer to a function that implements the built-in function :" -"func:`hash`." +"An optional pointer to a function that implements the built-in " +"function :func:`hash`." msgstr "" msgid "The signature is the same as for :c:func:`PyObject_Hash`::" @@ -1416,9 +1541,9 @@ msgstr "" msgid "" "When this field is not set (*and* :c:member:`~PyTypeObject.tp_richcompare` " -"is not set), an attempt to take the hash of the object raises :exc:" -"`TypeError`. This is the same as setting it to :c:func:" -"`PyObject_HashNotImplemented`." +"is not set), an attempt to take the hash of the object " +"raises :exc:`TypeError`. This is the same as setting it " +"to :c:func:`PyObject_HashNotImplemented`." msgstr "" msgid "" @@ -1427,21 +1552,20 @@ msgid "" "as the equivalent of ``__hash__ = None`` at the Python level, causing " "``isinstance(o, collections.Hashable)`` to correctly return ``False``. Note " "that the converse is also true - setting ``__hash__ = None`` on a class at " -"the Python level will result in the ``tp_hash`` slot being set to :c:func:" -"`PyObject_HashNotImplemented`." +"the Python level will result in the ``tp_hash`` slot being set " +"to :c:func:`PyObject_HashNotImplemented`." msgstr "" -msgid "" -"Group: :c:member:`~PyTypeObject.tp_hash`, :c:member:`~PyTypeObject." -"tp_richcompare`" +msgid "Group: :c:member:`~PyTypeObject.tp_hash`, :c:member:`~PyTypeObject.tp_richcompare`" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_richcompare`: a subtype inherits both of :c:member:`~PyTypeObject." -"tp_richcompare` and :c:member:`~PyTypeObject.tp_hash`, when the subtype's :c:" -"member:`~PyTypeObject.tp_richcompare` and :c:member:`~PyTypeObject.tp_hash` " -"are both ``NULL``." +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_richcompare`: a subtype inherits both " +"of :c:member:`~PyTypeObject.tp_richcompare` " +"and :c:member:`~PyTypeObject.tp_hash`, when the " +"subtype's :c:member:`~PyTypeObject.tp_richcompare` " +"and :c:member:`~PyTypeObject.tp_hash` are both ``NULL``." msgstr "" msgid ":c:data:`PyBaseObject_Type` uses :c:func:`PyObject_GenericHash`." @@ -1457,11 +1581,11 @@ msgid "PyObject *tp_call(PyObject *self, PyObject *args, PyObject *kwargs);" msgstr "" msgid "" -"An optional pointer to a function that implements the built-in operation :" -"func:`str`. (Note that :class:`str` is a type now, and :func:`str` calls " -"the constructor for that type. This constructor calls :c:func:" -"`PyObject_Str` to do the actual work, and :c:func:`PyObject_Str` will call " -"this handler.)" +"An optional pointer to a function that implements the built-in " +"operation :func:`str`. (Note that :class:`str` is a type now, " +"and :func:`str` calls the constructor for that type. This constructor " +"calls :c:func:`PyObject_Str` to do the actual work, " +"and :c:func:`PyObject_Str` will call this handler.)" msgstr "" msgid "The signature is the same as for :c:func:`PyObject_Str`::" @@ -1492,17 +1616,18 @@ msgid "PyObject *tp_getattro(PyObject *self, PyObject *attr);" msgstr "" msgid "" -"It is usually convenient to set this field to :c:func:" -"`PyObject_GenericGetAttr`, which implements the normal way of looking for " -"object attributes." +"It is usually convenient to set this field " +"to :c:func:`PyObject_GenericGetAttr`, which implements the normal way of " +"looking for object attributes." msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_getattr`: a subtype inherits both :c:member:`~PyTypeObject.tp_getattr` " +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_getattr`: a subtype inherits " +"both :c:member:`~PyTypeObject.tp_getattr` " "and :c:member:`~PyTypeObject.tp_getattro` from its base type when the " -"subtype's :c:member:`~PyTypeObject.tp_getattr` and :c:member:`~PyTypeObject." -"tp_getattro` are both ``NULL``." +"subtype's :c:member:`~PyTypeObject.tp_getattr` " +"and :c:member:`~PyTypeObject.tp_getattro` are both ``NULL``." msgstr "" msgid ":c:data:`PyBaseObject_Type` uses :c:func:`PyObject_GenericGetAttr`." @@ -1516,17 +1641,18 @@ msgstr "" msgid "" "In addition, setting *value* to ``NULL`` to delete an attribute must be " -"supported. It is usually convenient to set this field to :c:func:" -"`PyObject_GenericSetAttr`, which implements the normal way of setting object " -"attributes." +"supported. It is usually convenient to set this field " +"to :c:func:`PyObject_GenericSetAttr`, which implements the normal way of " +"setting object attributes." msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_setattr`: a subtype inherits both :c:member:`~PyTypeObject.tp_setattr` " +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_setattr`: a subtype inherits " +"both :c:member:`~PyTypeObject.tp_setattr` " "and :c:member:`~PyTypeObject.tp_setattro` from its base type when the " -"subtype's :c:member:`~PyTypeObject.tp_setattr` and :c:member:`~PyTypeObject." -"tp_setattro` are both ``NULL``." +"subtype's :c:member:`~PyTypeObject.tp_setattr` " +"and :c:member:`~PyTypeObject.tp_setattro` are both ``NULL``." msgstr "" msgid ":c:data:`PyBaseObject_Type` uses :c:func:`PyObject_GenericSetAttr`." @@ -1546,12 +1672,12 @@ msgstr "" msgid "" "This field is a bit mask of various flags. Some flags indicate variant " "semantics for certain situations; others are used to indicate that certain " -"fields in the type object (or in the extension structures referenced via :c:" -"member:`~PyTypeObject.tp_as_number`, :c:member:`~PyTypeObject." -"tp_as_sequence`, :c:member:`~PyTypeObject.tp_as_mapping`, and :c:member:" -"`~PyTypeObject.tp_as_buffer`) that were historically not always present are " -"valid; if such a flag bit is clear, the type fields it guards must not be " -"accessed and must be considered to have a zero or ``NULL`` value instead." +"fields in the type object (or in the extension structures referenced " +"via :c:member:`~PyTypeObject.tp_as_number`, :c:member:`~PyTypeObject.tp_as_sequence`, :c:member:`~PyTypeObject.tp_as_mapping`, " +"and :c:member:`~PyTypeObject.tp_as_buffer`) that were historically not " +"always present are valid; if such a flag bit is clear, the type fields it " +"guards must not be accessed and must be considered to have a zero or " +"``NULL`` value instead." msgstr "" msgid "" @@ -1562,11 +1688,11 @@ msgid "" "type's value of the flag bit is copied into the subtype together with a " "pointer to the extension structure. The :c:macro:`Py_TPFLAGS_HAVE_GC` flag " "bit is inherited together with the :c:member:`~PyTypeObject.tp_traverse` " -"and :c:member:`~PyTypeObject.tp_clear` fields, i.e. if the :c:macro:" -"`Py_TPFLAGS_HAVE_GC` flag bit is clear in the subtype and the :c:member:" -"`~PyTypeObject.tp_traverse` and :c:member:`~PyTypeObject.tp_clear` fields in " -"the subtype exist and have ``NULL`` values. .. XXX are most flag bits " -"*really* inherited individually?" +"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. .. XXX are most flag bits *really* inherited individually?" msgstr "" msgid "" @@ -1579,10 +1705,10 @@ msgstr "" msgid "" "The following bit masks are currently defined; these can be ORed together " -"using the ``|`` operator to form the value of the :c:member:`~PyTypeObject." -"tp_flags` field. The macro :c:func:`PyType_HasFeature` takes a type and a " -"flags value, *tp* and *f*, and checks whether ``tp->tp_flags & f`` is non-" -"zero." +"using the ``|`` operator to form the value of " +"the :c:member:`~PyTypeObject.tp_flags` field. The " +"macro :c:func:`PyType_HasFeature` takes a type and a flags value, *tp* and " +"*f*, and checks whether ``tp->tp_flags & f`` is non-zero." msgstr "" msgid "" @@ -1592,9 +1718,9 @@ msgid "" "a reference to the type, and the type object is INCREF'ed when a new " "instance is created, and DECREF'ed when an instance is destroyed (this does " "not apply to instances of subtypes; only the type referenced by the " -"instance's ob_type gets INCREF'ed or DECREF'ed). Heap types should also :ref:" -"`support garbage collection ` as they can form a " -"reference cycle with their own module object." +"instance's ob_type gets INCREF'ed or DECREF'ed). Heap types should " +"also :ref:`support garbage collection ` as they " +"can form a reference cycle with their own module object." msgstr "" msgid "???" @@ -1607,8 +1733,8 @@ msgid "" msgstr "" msgid "" -"This bit is set when the type object has been fully initialized by :c:func:" -"`PyType_Ready`." +"This bit is set when the type object has been fully initialized " +"by :c:func:`PyType_Ready`." msgstr "" msgid "" @@ -1619,24 +1745,23 @@ 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." +"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`" +msgid "Group: :c:macro:`Py_TPFLAGS_HAVE_GC`, :c:member:`~PyTypeObject.tp_traverse`, :c:member:`~PyTypeObject.tp_clear`" msgstr "" msgid "" -"The :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is inherited together with the :c:" -"member:`~PyTypeObject.tp_traverse` and :c:member:`~PyTypeObject.tp_clear` " -"fields, i.e. if the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is clear in the " -"subtype and the :c:member:`~PyTypeObject.tp_traverse` and :c:member:" -"`~PyTypeObject.tp_clear` fields in the subtype exist and have ``NULL`` " -"values." +"The :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is inherited together with " +"the :c:member:`~PyTypeObject.tp_traverse` " +"and :c:member:`~PyTypeObject.tp_clear` fields, i.e. if " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit is clear in the subtype and " +"the :c:member:`~PyTypeObject.tp_traverse` " +"and :c:member:`~PyTypeObject.tp_clear` fields in the subtype exist and have " +"``NULL`` values." msgstr "" msgid "" @@ -1662,20 +1787,21 @@ msgid "" msgstr "" msgid "" -"This flag enables an optimization for typical method calls like ``obj." -"meth()``: it avoids creating a temporary \"bound method\" object for ``obj." -"meth``." +"This flag enables an optimization for typical method calls like " +"``obj.meth()``: it avoids creating a temporary \"bound method\" object for " +"``obj.meth``." msgstr "" msgid "" -"This flag is never inherited by types without the :c:macro:" -"`Py_TPFLAGS_IMMUTABLETYPE` flag set. For extension types, it is inherited " -"whenever :c:member:`~PyTypeObject.tp_descr_get` is inherited." +"This flag is never inherited by types without " +"the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` flag set. For extension types, it " +"is inherited whenever :c:member:`~PyTypeObject.tp_descr_get` is inherited." msgstr "" msgid "" -"This bit indicates that instances of the class have a `~object.__dict__` " -"attribute, and that the space for the dictionary is managed by the VM." +"This bit indicates that instances of the class have " +"a :attr:`~object.__dict__` attribute, and that the space for the dictionary " +"is managed by the VM." msgstr "" msgid "If this flag is set, :c:macro:`Py_TPFLAGS_HAVE_GC` should also be set." @@ -1697,13 +1823,13 @@ msgid "" msgstr "" msgid "" -"This flag is inherited unless the :c:member:`~PyTypeObject." -"tp_weaklistoffset` field is set in a superclass." +"This flag is inherited unless " +"the :c:member:`~PyTypeObject.tp_weaklistoffset` field is set in a superclass." msgstr "" msgid "" -"Only usable with variable-size types, i.e. ones with non-zero :c:member:" -"`~PyTypeObject.tp_itemsize`." +"Only usable with variable-size types, i.e. ones with non-" +"zero :c:member:`~PyTypeObject.tp_itemsize`." msgstr "" msgid "" @@ -1721,12 +1847,14 @@ msgid "This flag is inherited." msgstr "" msgid "" -"These flags are used by functions such as :c:func:`PyLong_Check` to quickly " +"Functions such as :c:func:`PyLong_Check` will " +"call :c:func:`PyType_FastSubclass` with one of these flags to quickly " "determine if a type is a subclass of a built-in type; such specific checks " "are faster than a generic check, like :c:func:`PyObject_IsInstance`. Custom " -"types that inherit from built-ins should have their :c:member:`~PyTypeObject." -"tp_flags` set appropriately, or the code that interacts with such types will " -"behave differently depending on what kind of check is used." +"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 "" @@ -1735,8 +1863,9 @@ msgid "" msgstr "" msgid "" -"This flag isn't necessary anymore, as the interpreter assumes the :c:member:" -"`~PyTypeObject.tp_finalize` slot is always present in the type structure." +"This flag isn't necessary anymore, as the interpreter assumes " +"the :c:member:`~PyTypeObject.tp_finalize` slot is always present in the type " +"structure." msgstr "" msgid "" @@ -1749,9 +1878,17 @@ msgid "" "This bit is inherited if :c:member:`~PyTypeObject.tp_call` is also inherited." msgstr "" +msgid "as ``_Py_TPFLAGS_HAVE_VECTORCALL``" +msgstr "" + msgid "" -"This flag is now removed from a class when the class's :py:meth:`~object." -"__call__` method is reassigned." +"Renamed to the current name, without the leading underscore. The old " +"provisional name is :term:`soft deprecated`." +msgstr "" + +msgid "" +"This flag is now removed from a class when the " +"class's :py:meth:`~object.__call__` method is reassigned." msgstr "" msgid "This flag can now be inherited by mutable classes." @@ -1771,8 +1908,9 @@ msgid "This flag is not inherited." msgstr "" msgid "" -"Disallow creating instances of the type: set :c:member:`~PyTypeObject." -"tp_new` to NULL and don't create the ``__new__`` key in the type dictionary." +"Disallow creating instances of the type: " +"set :c:member:`~PyTypeObject.tp_new` to NULL and don't create the " +"``__new__`` key in the type dictionary." msgstr "" msgid "" @@ -1781,9 +1919,9 @@ msgid "" msgstr "" msgid "" -"The flag is set automatically on :ref:`static types ` if :c:" -"member:`~PyTypeObject.tp_base` is NULL or ``&PyBaseObject_Type`` and :c:" -"member:`~PyTypeObject.tp_new` is NULL." +"The flag is set automatically on :ref:`static types ` " +"if :c:member:`~PyTypeObject.tp_base` is NULL or ``&PyBaseObject_Type`` " +"and :c:member:`~PyTypeObject.tp_new` is NULL." msgstr "" msgid "" @@ -1811,8 +1949,8 @@ msgid "" msgstr "" msgid "" -"This flag is inherited by types that do not already set :c:macro:" -"`Py_TPFLAGS_SEQUENCE`." +"This flag is inherited by types that do not already " +"set :c:macro:`Py_TPFLAGS_SEQUENCE`." msgstr "" msgid ":pep:`634` -- Structural Pattern Matching: Specification" @@ -1826,8 +1964,8 @@ msgid "" msgstr "" msgid "" -"This flag is inherited by types that do not already set :c:macro:" -"`Py_TPFLAGS_MAPPING`." +"This flag is inherited by types that do not already " +"set :c:macro:`Py_TPFLAGS_MAPPING`." msgstr "" msgid "" @@ -1840,6 +1978,39 @@ msgid "" "in a future version of CPython" msgstr "" +msgid "" +"This is a :term:`soft deprecated` macro that does nothing. Historically, " +"this would indicate that the :c:member:`~PyTypeObject.tp_version_tag` field " +"was available and initialized." +msgstr "" + +msgid "" +"This bit indicates that instances of this type will have an \"inline " +"values\" array (containing the object's attributes) placed directly after " +"the end of the object." +msgstr "" + +msgid "This requires that :c:macro:`Py_TPFLAGS_HAVE_GC` is set." +msgstr "" + +msgid "" +"This bit indicates that this is an abstract type and therefore cannot be " +"instantiated." +msgstr "" + +msgid ":mod:`abc`" +msgstr "" + +msgid "" +"Internal. Do not set or unset this flag. Historically, this was a reserved " +"flag for use in Stackless Python." +msgstr "" + +msgid "" +"This flag is present in header files, but is not be used. This may be " +"removed in a future version of CPython." +msgstr "" + msgid "" "An optional pointer to a NUL-terminated C string giving the docstring for " "this type object. This is exposed as the :attr:`~type.__doc__` attribute on " @@ -1865,11 +2036,11 @@ msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_traverse` pointer is used by the garbage " -"collector to detect reference cycles. A typical implementation of a :c:" -"member:`~PyTypeObject.tp_traverse` function simply calls :c:func:`Py_VISIT` " -"on each of the instance's members that are Python objects that the instance " -"owns. For example, this is function :c:func:`!local_traverse` from the :mod:" -"`!_thread` extension module::" +"collector to detect reference cycles. A typical implementation of " +"a :c:member:`~PyTypeObject.tp_traverse` function simply " +"calls :c:func:`Py_VISIT` on each of the instance's members that are Python " +"objects that the instance owns. For example, this is function :c:func:`!" +"local_traverse` from the :mod:`!_thread` extension module::" msgstr "" msgid "" @@ -1915,9 +2086,9 @@ msgid "" msgstr "" msgid "" -"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in the :c:member:" -"`~PyTypeObject.tp_flags` field, the traverse function must call :c:func:" -"`PyObject_VisitManagedDict` like this::" +"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in " +"the :c:member:`~PyTypeObject.tp_flags` field, the traverse function must " +"call :c:func:`PyObject_VisitManagedDict` like this::" msgstr "" msgid "PyObject_VisitManagedDict((PyObject*)self, visit, arg);" @@ -1936,17 +2107,24 @@ msgid "" msgstr "" msgid "" -"Note that :c:func:`Py_VISIT` requires the *visit* and *arg* parameters to :c:" -"func:`!local_traverse` to have these specific names; don't name them just " -"anything." +"The traversal function must not have any side effects. It must not modify " +"the reference counts of any Python objects nor create or destroy any Python " +"objects." +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." +"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 "" @@ -1956,10 +2134,12 @@ msgid "" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_clear` and the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit: the flag bit, :c:" -"member:`~PyTypeObject.tp_traverse`, and :c:member:`~PyTypeObject.tp_clear` " -"are all inherited from the base type if they are all zero in the subtype." +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_clear` and " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit: the flag " +"bit, :c:member:`~PyTypeObject.tp_traverse`, " +"and :c:member:`~PyTypeObject.tp_clear` are all inherited from the base type " +"if they are all zero in the subtype." msgstr "" msgid "" @@ -1979,10 +2159,11 @@ msgid "" "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`." +"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 "" @@ -2006,9 +2187,9 @@ msgstr "" msgid "" "The :c:func:`Py_CLEAR` macro should be used, because clearing references is " -"delicate: the reference to the contained object must not be released (via :" -"c:func:`Py_DECREF`) until after the pointer to the contained object is set " -"to ``NULL``. This is because releasing the reference may cause the " +"delicate: the reference to the contained object must not be released " +"(via :c:func:`Py_DECREF`) until after the pointer to the contained object is " +"set to ``NULL``. This is because releasing the reference may cause the " "contained object to become trash, triggering a chain of reclamation activity " "that may include invoking arbitrary Python code (due to finalizers, or " "weakref callbacks, associated with the contained object). If it's possible " @@ -2019,9 +2200,9 @@ msgid "" msgstr "" msgid "" -"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in the :c:member:" -"`~PyTypeObject.tp_flags` field, the traverse function must call :c:func:" -"`PyObject_ClearManagedDict` like this::" +"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in " +"the :c:member:`~PyTypeObject.tp_flags` field, the clear function must " +"call :c:func:`PyObject_ClearManagedDict` like this::" msgstr "" msgid "PyObject_ClearManagedDict((PyObject*)self);" @@ -2044,10 +2225,12 @@ msgid "" msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_traverse` and the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit: the flag bit, :" -"c:member:`~PyTypeObject.tp_traverse`, and :c:member:`~PyTypeObject.tp_clear` " -"are all inherited from the base type if they are all zero in the subtype." +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_traverse` and " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit: the flag " +"bit, :c:member:`~PyTypeObject.tp_traverse`, " +"and :c:member:`~PyTypeObject.tp_clear` are all inherited from the base type " +"if they are all zero in the subtype." msgstr "" msgid "" @@ -2070,8 +2253,9 @@ msgid "" msgstr "" msgid "" -"The following constants are defined to be used as the third argument for :c:" -"member:`~PyTypeObject.tp_richcompare` and for :c:func:`PyObject_RichCompare`:" +"The following constants are defined to be used as the third argument " +"for :c:member:`~PyTypeObject.tp_richcompare` and " +"for :c:func:`PyObject_RichCompare`:" msgstr "" msgid "Constant" @@ -2116,18 +2300,20 @@ msgid "On error, sets an exception and returns ``NULL`` from the function." msgstr "" msgid "" -"This field is inherited by subtypes together with :c:member:`~PyTypeObject." -"tp_hash`: a subtype inherits :c:member:`~PyTypeObject.tp_richcompare` and :c:" -"member:`~PyTypeObject.tp_hash` when the subtype's :c:member:`~PyTypeObject." -"tp_richcompare` and :c:member:`~PyTypeObject.tp_hash` are both ``NULL``." +"This field is inherited by subtypes together " +"with :c:member:`~PyTypeObject.tp_hash`: a subtype " +"inherits :c:member:`~PyTypeObject.tp_richcompare` " +"and :c:member:`~PyTypeObject.tp_hash` when the " +"subtype's :c:member:`~PyTypeObject.tp_richcompare` " +"and :c:member:`~PyTypeObject.tp_hash` are both ``NULL``." msgstr "" msgid "" -":c:data:`PyBaseObject_Type` provides a :c:member:`~PyTypeObject." -"tp_richcompare` implementation, which may be inherited. However, if only :c:" -"member:`~PyTypeObject.tp_hash` is defined, not even the inherited function " -"is used and instances of the type will not be able to participate in any " -"comparisons." +":c:data:`PyBaseObject_Type` provides " +"a :c:member:`~PyTypeObject.tp_richcompare` implementation, which may be " +"inherited. However, if only :c:member:`~PyTypeObject.tp_hash` is defined, " +"not even the inherited function is used and instances of the type will not " +"be able to participate in any comparisons." msgstr "" msgid "" @@ -2140,8 +2326,8 @@ msgid "" "greater than zero and contains the offset in the instance structure of the " "weak reference list head (ignoring the GC header, if present); this offset " "is used by :c:func:`PyObject_ClearWeakRefs` and the ``PyWeakref_*`` " -"functions. The instance structure needs to include a field of type :c:expr:" -"`PyObject*` which is initialized to ``NULL``." +"functions. The instance structure needs to include a field of " +"type :c:expr:`PyObject*` which is initialized to ``NULL``." msgstr "" msgid "" @@ -2163,16 +2349,17 @@ msgid "" msgstr "" msgid "" -"If the :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` bit is set in the :c:member:" -"`~PyTypeObject.tp_flags` field, then :c:member:`~PyTypeObject." -"tp_weaklistoffset` will be set to a negative value, to indicate that it is " -"unsafe to use this field." +"If the :c:macro:`Py_TPFLAGS_MANAGED_WEAKREF` bit is set in " +"the :c:member:`~PyTypeObject.tp_flags` field, " +"then :c:member:`~PyTypeObject.tp_weaklistoffset` will be set to a negative " +"value, to indicate that it is unsafe to use this field." msgstr "" msgid "" "An optional pointer to a function that returns an :term:`iterator` for the " -"object. Its presence normally signals that the instances of this type are :" -"term:`iterable` (although sequences may be iterable without this function)." +"object. Its presence normally signals that the instances of this type " +"are :term:`iterable` (although sequences may be iterable without this " +"function)." msgstr "" msgid "This function has the same signature as :c:func:`PyObject_GetIter`::" @@ -2182,18 +2369,18 @@ msgid "PyObject *tp_iter(PyObject *self);" msgstr "" msgid "" -"An optional pointer to a function that returns the next item in an :term:" -"`iterator`. The signature is::" +"An optional pointer to a function that returns the next item in " +"an :term:`iterator`. The signature is::" msgstr "" msgid "PyObject *tp_iternext(PyObject *self);" msgstr "" msgid "" -"When the iterator is exhausted, it must return ``NULL``; a :exc:" -"`StopIteration` exception may or may not be set. When another error occurs, " -"it must return ``NULL`` too. Its presence signals that the instances of " -"this type are iterators." +"When the iterator is 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 "" @@ -2206,8 +2393,8 @@ msgid "This function has the same signature as :c:func:`PyIter_Next`." msgstr "" msgid "" -"An optional pointer to a static ``NULL``-terminated array of :c:type:" -"`PyMethodDef` structures, declaring regular methods of this type." +"An optional pointer to a static ``NULL``-terminated array " +"of :c:type:`PyMethodDef` structures, declaring regular methods of this type." msgstr "" msgid "" @@ -2221,9 +2408,9 @@ msgid "" msgstr "" msgid "" -"An optional pointer to a static ``NULL``-terminated array of :c:type:" -"`PyMemberDef` structures, declaring regular data members (fields or slots) " -"of instances of this type." +"An optional pointer to a static ``NULL``-terminated array " +"of :c:type:`PyMemberDef` structures, declaring regular data members (fields " +"or slots) of instances of this type." msgstr "" msgid "" @@ -2237,9 +2424,9 @@ msgid "" msgstr "" msgid "" -"An optional pointer to a static ``NULL``-terminated array of :c:type:" -"`PyGetSetDef` structures, declaring computed attributes of instances of this " -"type." +"An optional pointer to a static ``NULL``-terminated array " +"of :c:type:`PyGetSetDef` structures, declaring computed attributes of " +"instances of this type." msgstr "" msgid "" @@ -2267,10 +2454,10 @@ msgid "" msgstr "" msgid "" -"However, the unary '&' operator applied to a non-static variable like :c:" -"data:`PyBaseObject_Type` is not required to produce an address constant. " -"Compilers may support this (gcc does), MSVC does not. Both compilers are " -"strictly standard conforming in this particular behavior." +"However, the unary '&' operator applied to a non-static variable " +"like :c:data:`PyBaseObject_Type` is not required to produce an address " +"constant. Compilers may support this (gcc does), MSVC does not. Both " +"compilers are strictly standard conforming in this particular behavior." msgstr "" msgid "" @@ -2294,20 +2481,21 @@ msgid "" "called; it may also be initialized to a dictionary containing initial " "attributes for the type. Once :c:func:`PyType_Ready` has initialized the " "type, extra attributes for the type may be added to this dictionary only if " -"they don't correspond to overloaded operations (like :meth:`~object." -"__add__`). Once initialization for the type has finished, this field should " -"be treated as read-only." +"they don't correspond to overloaded operations " +"(like :meth:`~object.__add__`). Once initialization for the type has " +"finished, this field should be treated as read-only." msgstr "" msgid "" -"Some types may not store their dictionary in this slot. Use :c:func:" -"`PyType_GetDict` to retrieve the dictionary for an arbitrary type." +"Some types may not store their dictionary in this slot. " +"Use :c:func:`PyType_GetDict` to retrieve the dictionary for an arbitrary " +"type." msgstr "" msgid "" "Internals detail: For static builtin types, this is always ``NULL``. " -"Instead, the dict for such types is stored on ``PyInterpreterState``. Use :c:" -"func:`PyType_GetDict` to get the dict for an arbitrary type." +"Instead, the dict for such types is stored on ``PyInterpreterState``. " +"Use :c:func:`PyType_GetDict` to get the dict for an arbitrary type." msgstr "" msgid "" @@ -2321,8 +2509,8 @@ msgid "" msgstr "" msgid "" -"It is not safe to use :c:func:`PyDict_SetItem` on or otherwise modify :c:" -"member:`~PyTypeObject.tp_dict` with the dictionary C-API." +"It is not safe to use :c:func:`PyDict_SetItem` on or otherwise " +"modify :c:member:`~PyTypeObject.tp_dict` with the dictionary C-API." msgstr "" msgid "An optional pointer to a \"descriptor get\" function." @@ -2353,8 +2541,8 @@ msgstr "" msgid "" "If the instances of this type have a dictionary containing instance " "variables, this field is non-zero and contains the offset in the instances " -"of the type of the instance variable dictionary; this offset is used by :c:" -"func:`PyObject_GenericGetAttr`." +"of the type of the instance variable dictionary; this offset is used " +"by :c:func:`PyObject_GenericGetAttr`." msgstr "" msgid "" @@ -2369,22 +2557,23 @@ msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_dictoffset` should be regarded as write-" -"only. To get the pointer to the dictionary call :c:func:" -"`PyObject_GenericGetDict`. Calling :c:func:`PyObject_GenericGetDict` may " -"need to allocate memory for the dictionary, so it is may be more efficient " -"to call :c:func:`PyObject_GetAttr` when accessing an attribute on the object." +"only. To get the pointer to the dictionary " +"call :c:func:`PyObject_GenericGetDict`. " +"Calling :c:func:`PyObject_GenericGetDict` may need to allocate memory for " +"the dictionary, so it is may be more efficient to " +"call :c:func:`PyObject_GetAttr` when accessing an attribute on the object." msgstr "" msgid "" -"It is an error to set both the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit and :c:" -"member:`~PyTypeObject.tp_dictoffset`." +"It is an error to set both the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit " +"and :c:member:`~PyTypeObject.tp_dictoffset`." msgstr "" msgid "" "This field is inherited by subtypes. A subtype should not override this " "offset; doing so could be unsafe, if C code tries to access the dictionary " -"at the previous offset. To properly support inheritance, use :c:macro:" -"`Py_TPFLAGS_MANAGED_DICT`." +"at the previous offset. To properly support inheritance, " +"use :c:macro:`Py_TPFLAGS_MANAGED_DICT`." msgstr "" msgid "" @@ -2394,9 +2583,10 @@ msgid "" msgstr "" msgid "" -"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in the :c:member:" -"`~PyTypeObject.tp_flags` field, then :c:member:`~PyTypeObject.tp_dictoffset` " -"will be set to ``-1``, to indicate that it is unsafe to use this field." +"If the :c:macro:`Py_TPFLAGS_MANAGED_DICT` bit is set in " +"the :c:member:`~PyTypeObject.tp_flags` field, " +"then :c:member:`~PyTypeObject.tp_dictoffset` will be set to ``-1``, to " +"indicate that it is unsafe to use this field." msgstr "" msgid "An optional pointer to an instance initialization function." @@ -2414,19 +2604,19 @@ msgstr "" msgid "" "The self argument is the instance to be initialized; the *args* and *kwds* " -"arguments represent positional and keyword arguments of the call to :meth:" -"`~object.__init__`." +"arguments represent positional and keyword arguments of the call " +"to :meth:`~object.__init__`." msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_init` function, if not ``NULL``, is called " -"when an instance is created normally by calling its type, after the type's :" -"c:member:`~PyTypeObject.tp_new` function has returned an instance of the " -"type. If the :c:member:`~PyTypeObject.tp_new` function returns an instance " -"of some other type that is not a subtype of the original type, no :c:member:" -"`~PyTypeObject.tp_init` function is called; if :c:member:`~PyTypeObject." -"tp_new` returns an instance of a subtype of the original type, the " -"subtype's :c:member:`~PyTypeObject.tp_init` is called." +"when an instance is created normally by calling its type, after the " +"type's :c:member:`~PyTypeObject.tp_new` function has returned an instance of " +"the type. If the :c:member:`~PyTypeObject.tp_new` function returns an " +"instance of some other type that is not a subtype of the original type, " +"no :c:member:`~PyTypeObject.tp_init` function is called; " +"if :c:member:`~PyTypeObject.tp_new` returns an instance of a subtype of the " +"original type, the subtype's :c:member:`~PyTypeObject.tp_init` is called." msgstr "" msgid "Returns ``0`` on success, ``-1`` and sets an exception on error." @@ -2448,14 +2638,15 @@ msgid "" msgstr "" msgid "" -"For dynamic subtypes, this field is always set to :c:func:" -"`PyType_GenericAlloc`, to force a standard heap allocation strategy." +"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." +"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." @@ -2468,9 +2659,9 @@ msgstr "" msgid "" "The *subtype* argument is the type of the object being created; the *args* " "and *kwds* arguments represent positional and keyword arguments of the call " -"to the type. Note that *subtype* doesn't have to equal the type whose :c:" -"member:`~PyTypeObject.tp_new` function is called; it may be a subtype of " -"that type (but not an unrelated type)." +"to the type. Note that *subtype* doesn't have to equal the type " +"whose :c:member:`~PyTypeObject.tp_new` function is called; it may be a " +"subtype of that type (but not an unrelated type)." msgstr "" msgid "" @@ -2479,9 +2670,9 @@ msgid "" "only as much further initialization as is absolutely necessary. " "Initialization that can safely be ignored or repeated should be placed in " "the :c:member:`~PyTypeObject.tp_init` handler. A good rule of thumb is that " -"for immutable types, all initialization should take place in :c:member:" -"`~PyTypeObject.tp_new`, while for mutable types, most initialization should " -"be deferred to :c:member:`~PyTypeObject.tp_init`." +"for immutable types, all initialization should take place " +"in :c:member:`~PyTypeObject.tp_new`, while for mutable types, most " +"initialization should be deferred to :c:member:`~PyTypeObject.tp_init`." msgstr "" msgid "" @@ -2490,9 +2681,10 @@ msgid "" msgstr "" msgid "" -"This field is inherited by subtypes, except it is not inherited by :ref:" -"`static types ` whose :c:member:`~PyTypeObject.tp_base` is " -"``NULL`` or ``&PyBaseObject_Type``." +"This field is inherited by subtypes, except it is not inherited " +"by :ref:`static types ` " +"whose :c:member:`~PyTypeObject.tp_base` is ``NULL`` or " +"``&PyBaseObject_Type``." msgstr "" msgid "" @@ -2510,8 +2702,8 @@ msgid "void tp_free(void *self);" msgstr "" msgid "" -"An initializer that is compatible with this signature is :c:func:" -"`PyObject_Free`." +"An initializer that is compatible with this signature " +"is :c:func:`PyObject_Free`." msgstr "" msgid "" @@ -2520,9 +2712,9 @@ msgid "" 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." +"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 "" @@ -2535,26 +2727,26 @@ msgstr "" msgid "" "The garbage collector needs to know whether a particular object is " "collectible or not. Normally, it is sufficient to look at the object's " -"type's :c:member:`~PyTypeObject.tp_flags` field, and check the :c:macro:" -"`Py_TPFLAGS_HAVE_GC` flag bit. But some types have a mixture of statically " -"and dynamically allocated instances, and the statically allocated instances " -"are not collectible. Such types should define this function; it should " -"return ``1`` for a collectible instance, and ``0`` for a non-collectible " -"instance. The signature is::" +"type's :c:member:`~PyTypeObject.tp_flags` field, and check " +"the :c:macro:`Py_TPFLAGS_HAVE_GC` flag bit. But some types have a mixture " +"of statically and dynamically allocated instances, and the statically " +"allocated instances are not collectible. Such types should define this " +"function; it should return ``1`` for a collectible instance, and ``0`` for a " +"non-collectible instance. The signature is::" msgstr "" msgid "int tp_is_gc(PyObject *self);" msgstr "" msgid "" -"(The only example of this are types themselves. The metatype, :c:data:" -"`PyType_Type`, defines this function to distinguish between statically and :" -"ref:`dynamically allocated types `.)" +"(The only example of this are types themselves. The " +"metatype, :c:data:`PyType_Type`, defines this function to distinguish " +"between statically and :ref:`dynamically allocated types `.)" msgstr "" msgid "" -"This slot has no default. If this field is ``NULL``, :c:macro:" -"`Py_TPFLAGS_HAVE_GC` is used as the functional equivalent." +"This slot has no default. If this field is " +"``NULL``, :c:macro:`Py_TPFLAGS_HAVE_GC` is used as the functional equivalent." msgstr "" msgid "Tuple of base types." @@ -2567,8 +2759,8 @@ 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." +"` can be used instead of the *bases* argument " +"of :c:func:`PyType_FromSpecWithBases`. The argument form is preferred." msgstr "" msgid "" @@ -2586,8 +2778,8 @@ msgid "" msgstr "" msgid "" -"This field is not inherited; it is calculated fresh by :c:func:" -"`PyType_Ready`." +"This field is not inherited; it is calculated fresh " +"by :c:func:`PyType_Ready`." msgstr "" msgid "Unused. Internal use only." @@ -2598,8 +2790,8 @@ msgid "" msgstr "" msgid "" -"To get a list of subclasses, call the Python method :py:meth:`~type." -"__subclasses__`." +"To get a list of subclasses, call the Python " +"method :py:meth:`~type.__subclasses__`." msgstr "" msgid "" @@ -2627,7 +2819,9 @@ msgid "Used to index into the method cache. Internal use only." msgstr "" msgid "" -"An optional pointer to an instance finalization function. Its signature is::" +"An optional pointer to an instance finalization function. This is the C " +"implementation of the :meth:`~object.__del__` special method. Its signature " +"is::" msgstr "" msgid "void tp_finalize(PyObject *self);" @@ -2663,9 +2857,9 @@ msgid "" msgstr "" msgid "" -"Before version 3.8 it was necessary to set the :c:macro:" -"`Py_TPFLAGS_HAVE_FINALIZE` flags bit in order for this field to be used. " -"This is no longer required." +"Before version 3.8 it was necessary to set " +"the :c:macro:`Py_TPFLAGS_HAVE_FINALIZE` flags bit in order for this field to " +"be used. This is no longer required." msgstr "" msgid "\"Safe object finalization\" (:pep:`442`)" @@ -2674,8 +2868,8 @@ 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." +"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." @@ -2691,9 +2885,9 @@ msgid "Static Types" msgstr "" msgid "" -"Traditionally, types defined in C code are *static*, that is, a static :c:" -"type:`PyTypeObject` structure is defined directly in code and initialized " -"using :c:func:`PyType_Ready`." +"Traditionally, types defined in C code are *static*, that is, a " +"static :c:type:`PyTypeObject` structure is defined directly in code and " +"initialized using :c:func:`PyType_Ready`." msgstr "" msgid "" @@ -2728,14 +2922,14 @@ msgstr "" msgid "" "An alternative to :ref:`static types ` is *heap-allocated " "types*, or *heap types* for short, which correspond closely to classes " -"created by Python's ``class`` statement. Heap types have the :c:macro:" -"`Py_TPFLAGS_HEAPTYPE` flag set." +"created by Python's ``class`` statement. Heap types have " +"the :c:macro:`Py_TPFLAGS_HEAPTYPE` flag set." msgstr "" msgid "" -"This is done by filling a :c:type:`PyType_Spec` structure and calling :c:" -"func:`PyType_FromSpec`, :c:func:`PyType_FromSpecWithBases`, :c:func:" -"`PyType_FromModuleAndSpec`, or :c:func:`PyType_FromMetaclass`." +"This is done by filling a :c:type:`PyType_Spec` structure and " +"calling :c:func:`PyType_FromSpec`, :c:func:`PyType_FromSpecWithBases`, :c:func:`PyType_FromModuleAndSpec`, " +"or :c:func:`PyType_FromMetaclass`." msgstr "" msgid "Number Object Structures" @@ -2819,22 +3013,23 @@ msgid "" msgstr "" msgid "" -"This function is used by :c:func:`PyMapping_Size` and :c:func:" -"`PyObject_Size`, and has the same signature. This slot may be set to " -"``NULL`` if the object has no defined length." +"This function is used by :c:func:`PyMapping_Size` " +"and :c:func:`PyObject_Size`, and has the same signature. This slot may be " +"set to ``NULL`` if the object has no defined length." msgstr "" msgid "" -"This function is used by :c:func:`PyObject_GetItem` and :c:func:" -"`PySequence_GetSlice`, and has the same signature as :c:func:`!" -"PyObject_GetItem`. This slot must be filled for the :c:func:" -"`PyMapping_Check` function to return ``1``, it can be ``NULL`` otherwise." +"This function is used by :c:func:`PyObject_GetItem` " +"and :c:func:`PySequence_GetSlice`, and has the same signature as :c:func:`!" +"PyObject_GetItem`. This slot must be filled for " +"the :c:func:`PyMapping_Check` function to return ``1``, it can be ``NULL`` " +"otherwise." msgstr "" msgid "" -"This function is used by :c:func:`PyObject_SetItem`, :c:func:" -"`PyObject_DelItem`, :c:func:`PySequence_SetSlice` and :c:func:" -"`PySequence_DelSlice`. It has the same signature as :c:func:`!" +"This function is used " +"by :c:func:`PyObject_SetItem`, :c:func:`PyObject_DelItem`, :c:func:`PySequence_SetSlice` " +"and :c:func:`PySequence_DelSlice`. It has the same signature as :c:func:`!" "PyObject_SetItem`, but *v* can also be set to ``NULL`` to delete an item. " "If this slot is ``NULL``, the object does not support item assignment and " "deletion." @@ -2849,10 +3044,10 @@ msgid "" msgstr "" msgid "" -"This function is used by :c:func:`PySequence_Size` and :c:func:" -"`PyObject_Size`, and has the same signature. It is also used for handling " -"negative indices via the :c:member:`~PySequenceMethods.sq_item` and the :c:" -"member:`~PySequenceMethods.sq_ass_item` slots." +"This function is used by :c:func:`PySequence_Size` " +"and :c:func:`PyObject_Size`, and has the same signature. It is also used " +"for handling negative indices via the :c:member:`~PySequenceMethods.sq_item` " +"and the :c:member:`~PySequenceMethods.sq_ass_item` slots." msgstr "" msgid "" @@ -2876,19 +3071,20 @@ msgid "" msgstr "" msgid "" -"Negative indexes are handled as follows: if the :c:member:" -"`~PySequenceMethods.sq_length` slot is filled, it is called and the sequence " -"length is used to compute a positive index which is passed to :c:member:" -"`~PySequenceMethods.sq_item`. If :c:member:`!sq_length` is ``NULL``, the " -"index is passed as is to the function." +"Negative indexes are handled as follows: if " +"the :c:member:`~PySequenceMethods.sq_length` slot is filled, it is called " +"and the sequence length is used to compute a positive index which is passed " +"to :c:member:`~PySequenceMethods.sq_item`. If :c:member:`!sq_length` is " +"``NULL``, the index is passed as is to the function." msgstr "" msgid "" "This function is used by :c:func:`PySequence_SetItem` and has the same " -"signature. It is also used by :c:func:`PyObject_SetItem` and :c:func:" -"`PyObject_DelItem`, after trying the item assignment and deletion via the :c:" -"member:`~PyMappingMethods.mp_ass_subscript` slot. This slot may be left to " -"``NULL`` if the object does not support item assignment and deletion." +"signature. It is also used by :c:func:`PyObject_SetItem` " +"and :c:func:`PyObject_DelItem`, after trying the item assignment and " +"deletion via the :c:member:`~PyMappingMethods.mp_ass_subscript` slot. This " +"slot may be left to ``NULL`` if the object does not support item assignment " +"and deletion." msgstr "" msgid "" @@ -2902,8 +3098,8 @@ msgid "" "signature. It should modify its first operand, and return it. This slot " "may be left to ``NULL``, in this case :c:func:`!PySequence_InPlaceConcat` " "will fall back to :c:func:`PySequence_Concat`. It is also used by the " -"augmented assignment ``+=``, after trying numeric in-place addition via the :" -"c:member:`~PyNumberMethods.nb_inplace_add` slot." +"augmented assignment ``+=``, after trying numeric in-place addition via " +"the :c:member:`~PyNumberMethods.nb_inplace_add` slot." msgstr "" msgid "" @@ -2937,8 +3133,8 @@ msgid "" msgstr "" msgid "" -"Check if the request can be met. If not, raise :exc:`BufferError`, set :c:" -"expr:`view->obj` to ``NULL`` and return ``-1``." +"Check if the request can be met. If not, raise :exc:`BufferError`, set " +"``view->obj`` to ``NULL`` and return ``-1``." msgstr "" msgid "Fill in the requested fields." @@ -2947,8 +3143,7 @@ msgstr "" msgid "Increment an internal counter for the number of exports." msgstr "" -msgid "" -"Set :c:expr:`view->obj` to *exporter* and increment :c:expr:`view->obj`." +msgid "Set ``view->obj`` to *exporter* and increment ``view->obj``." msgstr "" msgid "Return ``0``." @@ -2960,13 +3155,13 @@ msgid "" msgstr "" msgid "" -"Re-export: Each member of the tree acts as the exporting object and sets :c:" -"expr:`view->obj` to a new reference to itself." +"Re-export: Each member of the tree acts as the exporting object and sets " +"``view->obj`` to a new reference to itself." msgstr "" msgid "" "Redirect: The buffer request is redirected to the root object of the tree. " -"Here, :c:expr:`view->obj` will be a new reference to the root object." +"Here, ``view->obj`` will be a new reference to the root object." msgstr "" msgid "" @@ -2978,10 +3173,9 @@ msgstr "" msgid "" "All memory pointed to in the :c:type:`Py_buffer` structure belongs to the " -"exporter and must remain valid until there are no consumers left. :c:member:" -"`~Py_buffer.format`, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer." -"strides`, :c:member:`~Py_buffer.suboffsets` and :c:member:`~Py_buffer." -"internal` are read-only for the consumer." +"exporter and must remain valid until there are no consumers " +"left. :c:member:`~Py_buffer.format`, :c:member:`~Py_buffer.shape`, :c:member:`~Py_buffer.strides`, :c:member:`~Py_buffer.suboffsets` " +"and :c:member:`~Py_buffer.internal` are read-only for the consumer." msgstr "" msgid "" @@ -3018,7 +3212,7 @@ msgid "" msgstr "" msgid "" -"This function MUST NOT decrement :c:expr:`view->obj`, since that is done " +"This function MUST NOT decrement ``view->obj``, since that is done " "automatically in :c:func:`PyBuffer_Release` (this scheme is useful for " "breaking reference cycles)." msgstr "" @@ -3032,8 +3226,8 @@ msgid "Async Object Structures" msgstr "" msgid "" -"This structure holds pointers to the functions required to implement :term:" -"`awaitable` and :term:`asynchronous iterator` objects." +"This structure holds pointers to the functions required to " +"implement :term:`awaitable` and :term:`asynchronous iterator` objects." msgstr "" msgid "" @@ -3061,8 +3255,8 @@ msgid "PyObject *am_aiter(PyObject *self);" msgstr "" msgid "" -"Must return an :term:`asynchronous iterator` object. See :meth:`~object." -"__anext__` for details." +"Must return an :term:`asynchronous iterator` object. " +"See :meth:`~object.__anext__` for details." msgstr "" msgid "" @@ -3092,19 +3286,20 @@ msgid "" "The purpose of this function is to separate memory allocation from memory " "initialization. It should return a pointer to a block of memory of adequate " "length for the instance, suitably aligned, and initialized to zeros, but " -"with :c:member:`~PyObject.ob_refcnt` set to ``1`` and :c:member:`~PyObject." -"ob_type` set to the type argument. If the type's :c:member:`~PyTypeObject." -"tp_itemsize` is non-zero, the object's :c:member:`~PyVarObject.ob_size` " -"field should be initialized to *nitems* and the length of the allocated " -"memory block should be ``tp_basicsize + nitems*tp_itemsize``, rounded up to " -"a multiple of ``sizeof(void*)``; otherwise, *nitems* is not used and the " -"length of the block should be :c:member:`~PyTypeObject.tp_basicsize`." +"with :c:member:`~PyObject.ob_refcnt` set to ``1`` " +"and :c:member:`~PyObject.ob_type` set to the type argument. If the " +"type's :c:member:`~PyTypeObject.tp_itemsize` is non-zero, the " +"object's :c:member:`~PyVarObject.ob_size` field should be initialized to " +"*nitems* and the length of the allocated memory block should be " +"``tp_basicsize + nitems*tp_itemsize``, rounded up to a multiple of " +"``sizeof(void*)``; otherwise, *nitems* is not used and the length of the " +"block should be :c:member:`~PyTypeObject.tp_basicsize`." msgstr "" msgid "" "This function should not do any other instance initialization, not even to " -"allocate additional memory; that should be done by :c:member:`~PyTypeObject." -"tp_new`." +"allocate additional memory; that should be done " +"by :c:member:`~PyTypeObject.tp_new`." msgstr "" msgid "See :c:member:`~PyTypeObject.tp_free`." @@ -3262,8 +3457,8 @@ msgstr "" msgid "" "A str subclass that cannot be subclassed and cannot be called to create " -"instances (e.g. uses a separate factory func) using :c:macro:" -"`Py_TPFLAGS_DISALLOW_INSTANTIATION` flag::" +"instances (e.g. uses a separate factory func) " +"using :c:macro:`Py_TPFLAGS_DISALLOW_INSTANTIATION` flag::" msgstr "" msgid "" diff --git a/c-api/unicode.po b/c-api/unicode.po index 581caa8af8..6927a240bd 100644 --- a/c-api/unicode.po +++ b/c-api/unicode.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -80,10 +79,15 @@ msgid "" msgstr "" msgid "" -"This instance of :c:type:`PyTypeObject` represents the Python Unicode type. " +"This instance of :c:type:`PyTypeObject` represents the Python Unicode type. " "It is exposed to Python code as ``str``." msgstr "" +msgid "" +"This instance of :c:type:`PyTypeObject` represents the Python Unicode " +"iterator type. It is used to iterate over Unicode string objects." +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:" @@ -113,8 +117,8 @@ msgstr "" msgid "" "Return a pointer to the canonical representation cast to UCS1, UCS2 or UCS4 " "integer types for direct character access. No checks are performed if the " -"canonical representation has the correct character size; use :c:func:" -"`PyUnicode_KIND` to select the right function." +"canonical representation has the correct character size; " +"use :c:func:`PyUnicode_KIND` to select the right function." msgstr "" msgid "Return values of the :c:func:`PyUnicode_KIND` macro." @@ -136,23 +140,23 @@ msgid "" 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." +"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." +"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." +"\"canonical\" representation. This is less efficient " +"than :c:func:`PyUnicode_READ` if you do multiple consecutive reads." msgstr "" msgid "" @@ -261,11 +265,21 @@ msgstr "" msgid "Check if *ch* is a low surrogate (``0xDC00 <= ch <= 0xDFFF``)." msgstr "" +msgid "" +"Return the high UTF-16 surrogate (``0xD800`` to ``0xDBFF``) for a Unicode " +"code point in the range ``[0x10000; 0x10FFFF]``." +msgstr "" + +msgid "" +"Return the low UTF-16 surrogate (``0xDC00`` to ``0xDFFF``) for a Unicode " +"code point in the range ``[0x10000; 0x10FFFF]``." +msgstr "" + msgid "" "Join two surrogate code points and return a single :c:type:`Py_UCS4` value. " "*high* and *low* are respectively the leading and trailing surrogates in a " -"surrogate pair. *high* must be in the range [0xD800; 0xDBFF] and *low* must " -"be in the range [0xDC00; 0xDFFF]." +"surrogate pair. *high* must be in the range ``[0xD800; 0xDBFF]`` and *low* " +"must be in the range ``[0xDC00; 0xDFFF]``." msgstr "" msgid "Creating and accessing Unicode strings" @@ -291,17 +305,18 @@ msgid "On error, set an exception and return ``NULL``." msgstr "" msgid "" -"Create a new Unicode object with the given *kind* (possible values are :c:" -"macro:`PyUnicode_1BYTE_KIND` etc., as returned by :c:func:" -"`PyUnicode_KIND`). The *buffer* must point to an array of *size* units of " -"1, 2 or 4 bytes per character, as given by the kind." +"Create a new Unicode object with the given *kind* (possible values " +"are :c:macro:`PyUnicode_1BYTE_KIND` etc., as returned " +"by :c:func:`PyUnicode_KIND`). The *buffer* must point to an array of *size* " +"units of 1, 2 or 4 bytes per character, as given by the kind." msgstr "" msgid "" "If necessary, the input *buffer* is copied and transformed into the " -"canonical representation. For example, if the *buffer* is a UCS4 string (:c:" -"macro:`PyUnicode_4BYTE_KIND`) and it consists only of codepoints in the UCS1 " -"range, it will be transformed into UCS1 (:c:macro:`PyUnicode_1BYTE_KIND`)." +"canonical representation. For example, if the *buffer* is a UCS4 string " +"(:c:macro:`PyUnicode_4BYTE_KIND`) and it consists only of codepoints in the " +"UCS1 range, it will be transformed into UCS1 " +"(:c:macro:`PyUnicode_1BYTE_KIND`)." msgstr "" msgid "" @@ -351,9 +366,9 @@ msgstr "" msgid "" "Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " -"actual width is given in the next argument, which must be of type :c:expr:" -"`int`, and the object to convert comes after the minimum field width and " -"optional precision." +"actual width is given in the next argument, which must be of " +"type :c:expr:`int`, and the object to convert comes after the minimum field " +"width and optional precision." msgstr "" msgid "" @@ -515,7 +530,7 @@ msgid "``p``" msgstr "``p``" msgid ":c:expr:`const void*`" -msgstr "" +msgstr ":c:expr:`const void*`" msgid "" "The hex representation of a C pointer. Mostly equivalent to " @@ -566,8 +581,8 @@ msgid "``T``" msgstr "``T``" msgid "" -"Get the fully qualified name of an object type; call :c:func:" -"`PyType_GetFullyQualifiedName`." +"Get the fully qualified name of an object type; " +"call :c:func:`PyType_GetFullyQualifiedName`." msgstr "" msgid "``#T``" @@ -585,8 +600,8 @@ msgid ":c:expr:`PyTypeObject*`" msgstr ":c:expr:`PyTypeObject*`" msgid "" -"Get the fully qualified name of a type; call :c:func:" -"`PyType_GetFullyQualifiedName`." +"Get the fully qualified name of a type; " +"call :c:func:`PyType_GetFullyQualifiedName`." msgstr "" msgid "``#N``" @@ -684,8 +699,16 @@ msgid "" msgstr "" msgid "" -"Return the name of the default string encoding, ``\"utf-8\"``. See :func:" -"`sys.getdefaultencoding`." +"Return a mapping suitable for decoding a custom single-byte encoding. Given " +"a Unicode string *string* of up to 256 characters representing an encoding " +"table, returns either a compact internal mapping object or a dictionary " +"mapping character ordinals to byte values. Raises a :exc:`TypeError` and " +"return ``NULL`` on invalid input. .. versionadded:: 3.2" +msgstr "" + +msgid "" +"Return the name of the default string encoding, ``\"utf-8\"``. " +"See :func:`sys.getdefaultencoding`." msgstr "" msgid "" @@ -707,8 +730,8 @@ msgid "" msgstr "" msgid "" -"Fill a string with a character: write *fill_char* into ``unicode[start:" -"start+length]``." +"Fill a string with a character: write *fill_char* into " +"``unicode[start:start+length]``." msgstr "" msgid "" @@ -717,14 +740,14 @@ msgid "" msgstr "" msgid "" -"Return the number of written character, or return ``-1`` and raise an " +"Return the number of written characters, or return ``-1`` and raise an " "exception on error." msgstr "" 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." +"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 "" @@ -738,8 +761,8 @@ msgstr "" msgid "" "Read a character from a string. This function checks that *unicode* is a " -"Unicode object and the index is not out of bounds, in contrast to :c:func:" -"`PyUnicode_READ_CHAR`, which performs no error checking." +"Unicode object and the index is not out of bounds, in contrast " +"to :c:func:`PyUnicode_READ_CHAR`, which performs no error checking." msgstr "" msgid "Return character on success, ``-1`` on error with an exception set." @@ -759,10 +782,10 @@ msgid "" msgstr "" msgid "" -"Copy the string *unicode* into a new UCS4 buffer that is allocated using :c:" -"func:`PyMem_Malloc`. If this fails, ``NULL`` is returned with a :exc:" -"`MemoryError` set. The returned buffer always has an extra null code point " -"appended." +"Copy the string *unicode* into a new UCS4 buffer that is allocated " +"using :c:func:`PyMem_Malloc`. If this fails, ``NULL`` is returned with " +"a :exc:`MemoryError` set. The returned buffer always has an extra null code " +"point appended." msgstr "" msgid "Locale Encoding" @@ -782,8 +805,8 @@ msgid "" msgstr "" msgid "" -"Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` to decode a string from the :" -"term:`filesystem encoding and error handler`." +"Use :c:func:`PyUnicode_DecodeFSDefaultAndSize` to decode a string from " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "This function ignores the :ref:`Python UTF-8 Mode `." @@ -794,9 +817,9 @@ msgstr "" msgid "" "The function now also uses the current locale encoding for the " -"``surrogateescape`` error handler, except on Android. Previously, :c:func:" -"`Py_DecodeLocale` was used for the ``surrogateescape``, and the current " -"locale encoding was used for ``strict``." +"``surrogateescape`` error handler, except on Android. " +"Previously, :c:func:`Py_DecodeLocale` was used for the ``surrogateescape``, " +"and the current locale encoding was used for ``strict``." msgstr "" msgid "" @@ -808,13 +831,13 @@ msgid "" "Encode a Unicode object to UTF-8 on Android and VxWorks, or to the current " "locale encoding on other platforms. The supported error handlers are " "``\"strict\"`` and ``\"surrogateescape\"`` (:pep:`383`). The encoder uses " -"``\"strict\"`` error handler if *errors* is ``NULL``. Return a :class:" -"`bytes` object. *unicode* cannot contain embedded null characters." +"``\"strict\"`` error handler if *errors* is ``NULL``. Return " +"a :class:`bytes` object. *unicode* cannot contain embedded null characters." msgstr "" msgid "" -"Use :c:func:`PyUnicode_EncodeFSDefault` to encode a string to the :term:" -"`filesystem encoding and error handler`." +"Use :c:func:`PyUnicode_EncodeFSDefault` to encode a string to " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "The :c:func:`Py_EncodeLocale` function." @@ -822,9 +845,9 @@ msgstr "" msgid "" "The function now also uses the current locale encoding for the " -"``surrogateescape`` error handler, except on Android. Previously, :c:func:" -"`Py_EncodeLocale` was used for the ``surrogateescape``, and the current " -"locale encoding was used for ``strict``." +"``surrogateescape`` error handler, except on Android. " +"Previously, :c:func:`Py_EncodeLocale` was used for the ``surrogateescape``, " +"and the current locale encoding was used for ``strict``." msgstr "" msgid "File System Encoding" @@ -843,8 +866,8 @@ msgstr "" msgid "" ":ref:`PyArg_Parse\\* converter `: encode :class:`str` objects " -"-- obtained directly or through the :class:`os.PathLike` interface -- to :" -"class:`bytes` using :c:func:`PyUnicode_EncodeFSDefault`; :class:`bytes` " +"-- obtained directly or through the :class:`os.PathLike` interface -- " +"to :class:`bytes` using :c:func:`PyUnicode_EncodeFSDefault`; :class:`bytes` " "objects are output as-is. *result* must be an address of a C variable of " "type :c:expr:`PyObject*` (or :c:expr:`PyBytesObject*`). On success, set the " "variable to a new :term:`strong reference` to a :ref:`bytes object " @@ -870,14 +893,15 @@ msgstr "" msgid "" ":ref:`PyArg_Parse\\* converter `: decode :class:`bytes` objects " "-- obtained either directly or indirectly through the :class:`os.PathLike` " -"interface -- to :class:`str` using :c:func:" -"`PyUnicode_DecodeFSDefaultAndSize`; :class:`str` objects are output as-is. " -"*result* must be an address of a C variable of type :c:expr:`PyObject*` (or :" -"c:expr:`PyUnicodeObject*`). On success, set the variable to a new :term:" -"`strong reference` to a :ref:`Unicode object ` which must be " -"released when it is no longer used and return a non-zero value (:c:macro:" -"`Py_CLEANUP_SUPPORTED`). Embedded null characters are not allowed in the " -"result. On failure, return ``0`` with an exception set." +"interface -- to :class:`str` " +"using :c:func:`PyUnicode_DecodeFSDefaultAndSize`; :class:`str` objects are " +"output as-is. *result* must be an address of a C variable of " +"type :c:expr:`PyObject*` (or :c:expr:`PyUnicodeObject*`). On success, set " +"the variable to a new :term:`strong reference` to a :ref:`Unicode object " +"` which must be released when it is no longer used and " +"return a non-zero value (:c:macro:`Py_CLEANUP_SUPPORTED`). Embedded null " +"characters are not allowed in the result. On failure, return ``0`` with an " +"exception set." msgstr "" msgid "" @@ -889,8 +913,8 @@ msgid "Decode a string from the :term:`filesystem encoding and error handler`." msgstr "" msgid "" -"If you need to decode a string from the current locale encoding, use :c:func:" -"`PyUnicode_DecodeLocaleAndSize`." +"If you need to decode a string from the current locale encoding, " +"use :c:func:`PyUnicode_DecodeLocaleAndSize`." msgstr "" msgid "" @@ -904,8 +928,8 @@ msgid "" msgstr "" msgid "" -"If the string length is known, use :c:func:" -"`PyUnicode_DecodeFSDefaultAndSize`." +"If the string length is known, " +"use :c:func:`PyUnicode_DecodeFSDefaultAndSize`." msgstr "" msgid "" @@ -915,8 +939,8 @@ msgid "" msgstr "" msgid "" -"If you need to encode a string to the current locale encoding, use :c:func:" -"`PyUnicode_EncodeLocale`." +"If you need to encode a string to the current locale encoding, " +"use :c:func:`PyUnicode_EncodeLocale`." msgstr "" msgid "wchar_t Support" @@ -935,8 +959,8 @@ msgstr "" msgid "" "Copy the Unicode object contents into the :c:type:`wchar_t` buffer *wstr*. " "At most *size* :c:type:`wchar_t` characters are copied (excluding a possibly " -"trailing null termination character). Return the number of :c:type:" -"`wchar_t` characters copied or ``-1`` in case of an error." +"trailing null termination character). Return the number " +"of :c:type:`wchar_t` characters copied or ``-1`` in case of an error." msgstr "" msgid "" @@ -946,9 +970,9 @@ msgstr "" msgid "" "Note that the resulting :c:expr:`wchar_t*` string may or may not be null-" -"terminated. It is the responsibility of the caller to make sure that the :c:" -"expr:`wchar_t*` string is null-terminated in case this is required by the " -"application. Also, note that the :c:expr:`wchar_t*` string might contain " +"terminated. It is the responsibility of the caller to make sure that " +"the :c:expr:`wchar_t*` string is null-terminated in case this is required by " +"the application. Also, note that the :c:expr:`wchar_t*` string might contain " "null characters, which would cause the string to be truncated when used with " "most C functions." msgstr "" @@ -959,8 +983,9 @@ msgid "" "number of wide characters (excluding the trailing null termination " "character) into *\\*size*. Note that the resulting :c:type:`wchar_t` string " "might contain null characters, which would cause the string to be truncated " -"when used with most C functions. If *size* is ``NULL`` and the :c:expr:" -"`wchar_t*` string contains null characters a :exc:`ValueError` is raised." +"when used with most C functions. If *size* is ``NULL`` and " +"the :c:expr:`wchar_t*` string contains null characters a :exc:`ValueError` " +"is raised." msgstr "" msgid "" @@ -1078,7 +1103,7 @@ msgid "" "collected." msgstr "" -msgid "The return type is now ``const char *`` rather of ``char *``." +msgid "The return type is now ``const char *`` rather than ``char *``." msgstr "" msgid "This function is a part of the :ref:`limited API `." @@ -1092,8 +1117,8 @@ msgid "" "`_ embedded within *unicode*. " "As a result, strings containing null characters will remain in the returned " "string, which some C functions might interpret as the end of the string, " -"leading to truncation. If truncation is an issue, it is recommended to use :" -"c:func:`PyUnicode_AsUTF8AndSize` instead." +"leading to truncation. If truncation is an issue, it is recommended to " +"use :c:func:`PyUnicode_AsUTF8AndSize` instead." msgstr "" msgid "UTF-32 Codecs" @@ -1386,11 +1411,8 @@ msgstr "" msgid "" "Encode the Unicode object using the specified code page and return a Python " -"bytes object. Return ``NULL`` if an exception was raised by the codec. Use :" -"c:macro:`!CP_ACP` code page to get the MBCS encoder." -msgstr "" - -msgid "Methods & Slots" +"bytes object. Return ``NULL`` if an exception was raised by the codec. " +"Use :c:macro:`!CP_ACP` code page to get the MBCS encoder." msgstr "" msgid "Methods and Slot Functions" @@ -1507,8 +1529,8 @@ msgid "" msgstr "" msgid "" -"This function returns ``-1`` upon failure, so one should call :c:func:" -"`PyErr_Occurred` to check for errors." +"This function returns ``-1`` upon failure, so one should " +"call :c:func:`PyErr_Occurred` to check for errors." msgstr "" msgid "" @@ -1548,8 +1570,9 @@ msgid ":c:data:`Py_NotImplemented` in case the type combination is unknown" msgstr "" msgid "" -"Possible values for *op* are :c:macro:`Py_GT`, :c:macro:`Py_GE`, :c:macro:" -"`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_LT`, and :c:macro:`Py_LE`." +"Possible values for *op* " +"are :c:macro:`Py_GT`, :c:macro:`Py_GE`, :c:macro:`Py_EQ`, :c:macro:`Py_NE`, :c:macro:`Py_LT`, " +"and :c:macro:`Py_LE`." msgstr "" msgid "" @@ -1570,11 +1593,11 @@ msgstr "" msgid "" "Intern the argument :c:expr:`*p_unicode` in place. The argument must be the " "address of a pointer variable pointing to a Python Unicode string object. " -"If there is an existing interned string that is the same as :c:expr:" -"`*p_unicode`, it sets :c:expr:`*p_unicode` to it (releasing the reference to " -"the old string object and creating a new :term:`strong reference` to the " -"interned string object), otherwise it leaves :c:expr:`*p_unicode` alone and " -"interns it." +"If there is an existing interned string that is the same " +"as :c:expr:`*p_unicode`, it sets :c:expr:`*p_unicode` to it (releasing the " +"reference to the old string object and creating a new :term:`strong " +"reference` to the interned string object), otherwise it " +"leaves :c:expr:`*p_unicode` alone and interns it." msgstr "" msgid "" @@ -1590,9 +1613,9 @@ msgid "" msgstr "" msgid "" -"Instances of subclasses of :py:class:`str` may not be interned, that is, :c:" -"expr:`PyUnicode_CheckExact(*p_unicode)` must be true. If it is not, then -- " -"as with any other error -- the argument is left unchanged." +"Instances of subclasses of :py:class:`str` may not be interned, that " +"is, :c:expr:`PyUnicode_CheckExact(*p_unicode)` must be true. If it is not, " +"then -- as with any other error -- the argument is left unchanged." msgstr "" msgid "" @@ -1601,8 +1624,9 @@ msgid "" msgstr "" msgid "" -"A combination of :c:func:`PyUnicode_FromString` and :c:func:" -"`PyUnicode_InternInPlace`, meant for statically allocated strings." +"A combination of :c:func:`PyUnicode_FromString` " +"and :c:func:`PyUnicode_InternInPlace`, meant for statically allocated " +"strings." msgstr "" msgid "" @@ -1615,9 +1639,6 @@ msgid "" "Python may keep a reference to the result, or make it :term:`immortal`, " "preventing it from being garbage-collected promptly. For interning an " "unbounded number of different strings, such as ones coming from user input, " -"prefer calling :c:func:`PyUnicode_FromString` and :c:func:" -"`PyUnicode_InternInPlace` directly." -msgstr "" - -msgid "Strings interned this way are made :term:`immortal`." +"prefer calling :c:func:`PyUnicode_FromString` " +"and :c:func:`PyUnicode_InternInPlace` directly." msgstr "" diff --git a/c-api/utilities.po b/c-api/utilities.po index 8c5a4a6556..147bbbf0c2 100644 --- a/c-api/utilities.po +++ b/c-api/utilities.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: -# Transifex Bot <>, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2025-07-11 15:02+0000\n" +"PO-Revision-Date: 2025-05-08 05: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,7 +24,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Utilities" -msgstr "" +msgstr "Utilitas" msgid "" "The functions in this chapter perform various utility tasks, ranging from " diff --git a/c-api/veryhigh.po b/c-api/veryhigh.po index 26fa6cbadd..249c3054a2 100644 --- a/c-api/veryhigh.po +++ b/c-api/veryhigh.po @@ -34,15 +34,16 @@ msgstr "" msgid "" "Several of these functions accept a start symbol from the grammar as a " -"parameter. The available start symbols are :const:`Py_eval_input`, :const:" -"`Py_file_input`, and :const:`Py_single_input`. These are described " -"following the functions which accept them as parameters." +"parameter. The available start symbols " +"are :const:`Py_eval_input`, :const:`Py_file_input`, " +"and :const:`Py_single_input`. These are described following the functions " +"which accept them as parameters." msgstr "" msgid "" "Note also that several of these functions take :c:expr:`FILE*` parameters. " -"One particular issue which needs to be handled carefully is that the :c:expr:" -"`FILE` structure for different C libraries can be different and " +"One particular issue which needs to be handled carefully is that " +"the :c:expr:`FILE` structure for different C libraries can be different and " "incompatible. Under Windows (at least), it is possible for dynamically " "linked extensions to actually use different libraries, so care should be " "taken that :c:expr:`FILE*` parameters are only passed to these functions if " @@ -88,12 +89,12 @@ msgstr "" msgid "" "If *fp* refers to a file associated with an interactive device (console or " -"terminal input or Unix pseudo-terminal), return the value of :c:func:" -"`PyRun_InteractiveLoop`, otherwise return the result of :c:func:" -"`PyRun_SimpleFile`. *filename* is decoded from the filesystem encoding (:" -"func:`sys.getfilesystemencoding`). If *filename* is ``NULL``, this function " -"uses ``\"???\"`` as the filename. If *closeit* is true, the file is closed " -"before ``PyRun_SimpleFileExFlags()`` returns." +"terminal input or Unix pseudo-terminal), return the value " +"of :c:func:`PyRun_InteractiveLoop`, otherwise return the result " +"of :c:func:`PyRun_SimpleFile`. *filename* is decoded from the filesystem " +"encoding (:func:`sys.getfilesystemencoding`). If *filename* is ``NULL``, " +"this function uses ``\"???\"`` as the filename. If *closeit* is true, the " +"file is closed before ``PyRun_SimpleFileExFlags()`` returns." msgstr "" msgid "" @@ -147,16 +148,16 @@ msgstr "" msgid "" "Read and execute a single statement from a file associated with an " "interactive device according to the *flags* argument. The user will be " -"prompted using ``sys.ps1`` and ``sys.ps2``. *filename* is decoded from the :" -"term:`filesystem encoding and error handler`." +"prompted using ``sys.ps1`` and ``sys.ps2``. *filename* is decoded from " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "" "Returns ``0`` when the input was executed successfully, ``-1`` if there was " "an exception, or an error code from the :file:`errcode.h` include file " -"distributed as part of Python if there was a parse error. (Note that :file:" -"`errcode.h` is not included by :file:`Python.h`, so must be included " -"specifically if needed.)" +"distributed as part of Python if there was a parse error. (Note " +"that :file:`errcode.h` is not included by :file:`Python.h`, so must be " +"included specifically if needed.)" msgstr "" msgid "" @@ -191,14 +192,14 @@ msgid "" msgstr "" msgid "" -"The result must be a string allocated by :c:func:`PyMem_RawMalloc` or :c:" -"func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred." +"The result must be a string allocated by :c:func:`PyMem_RawMalloc` " +"or :c:func:`PyMem_RawRealloc`, or ``NULL`` if an error occurred." msgstr "" msgid "" -"The result must be allocated by :c:func:`PyMem_RawMalloc` or :c:func:" -"`PyMem_RawRealloc`, instead of being allocated by :c:func:`PyMem_Malloc` or :" -"c:func:`PyMem_Realloc`." +"The result must be allocated by :c:func:`PyMem_RawMalloc` " +"or :c:func:`PyMem_RawRealloc`, instead of being allocated " +"by :c:func:`PyMem_Malloc` or :c:func:`PyMem_Realloc`." msgstr "" msgid "" @@ -238,8 +239,8 @@ msgid "" "Similar to :c:func:`PyRun_StringFlags`, but the Python source code is read " "from *fp* instead of an in-memory string. *filename* should be the name of " "the file, it is decoded from the :term:`filesystem encoding and error " -"handler`. If *closeit* is true, the file is closed before :c:func:" -"`PyRun_FileExFlags` returns." +"handler`. If *closeit* is true, the file is closed " +"before :c:func:`PyRun_FileExFlags` returns." msgstr "" msgid "" @@ -255,11 +256,12 @@ msgstr "" msgid "" "Parse and compile the Python source code in *str*, returning the resulting " "code object. The start token is given by *start*; this can be used to " -"constrain the code which can be compiled and should be :const:" -"`Py_eval_input`, :const:`Py_file_input`, or :const:`Py_single_input`. The " -"filename specified by *filename* is used to construct the code object and " -"may appear in tracebacks or :exc:`SyntaxError` exception messages. This " -"returns ``NULL`` if the code cannot be parsed or compiled." +"constrain the code which can be compiled and should " +"be :const:`Py_eval_input`, :const:`Py_file_input`, " +"or :const:`Py_single_input`. The filename specified by *filename* is used " +"to construct the code object and may appear in tracebacks " +"or :exc:`SyntaxError` exception messages. This returns ``NULL`` if the code " +"cannot be parsed or compiled." msgstr "" msgid "" @@ -290,8 +292,8 @@ msgid "" msgstr "" msgid "" -"Evaluate an execution frame. This is a simplified interface to :c:func:" -"`PyEval_EvalFrameEx`, for backward compatibility." +"Evaluate an execution frame. This is a simplified interface " +"to :c:func:`PyEval_EvalFrameEx`, for backward compatibility." msgstr "" msgid "" diff --git a/c-api/weakref.po b/c-api/weakref.po index eff2688aa7..2cbf6555a4 100644 --- a/c-api/weakref.po +++ b/c-api/weakref.po @@ -11,9 +11,9 @@ 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:50+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2025-08-07 21:40+0000\n" +"PO-Revision-Date: 2025-07-18 19: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" diff --git a/contents.po b/contents.po index 8e3f680c62..2b4ff8df26 100644 --- a/contents.po +++ b/contents.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/copyright.po b/copyright.po index 8a85606f22..9c1fd3d4fb 100644 --- a/copyright.po +++ b/copyright.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/deprecations/c-api-pending-removal-in-3.14.po b/deprecations/c-api-pending-removal-in-3.14.po new file mode 100644 index 0000000000..9eeded78f1 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-3.14.po @@ -0,0 +1,161 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Blessing Oluronbi, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Pending Removal in Python 3.14" +msgstr "" + +msgid "" +"The ``ma_version_tag`` field in :c:type:`PyDictObject` for extension modules " +"(:pep:`699`; :gh:`101193`)." +msgstr "" + +msgid "" +"Creating :c:data:`immutable types ` with mutable " +"bases (:gh:`95388`)." +msgstr "" + +msgid "" +"Functions to configure Python's initialization, deprecated in Python 3.11:" +msgstr "" +"Funkcje do konfiguracji inicjalizacji Pythona, przestarzałe w Pythonie 3.11:" + +msgid ":c:func:`!PySys_SetArgvEx()`: Set :c:member:`PyConfig.argv` instead." +msgstr "" +":c:func:`!PySys_SetArgvEx()` : Ustawić :c:member:`PyConfig.argv` Zamiast." + +msgid ":c:func:`!PySys_SetArgv()`: Set :c:member:`PyConfig.argv` instead." +msgstr "" +":c:func:`!PySys_SetArgv()` : Ustawić :c:member:`PyConfig.argv` Zamiast." + +msgid "" +":c:func:`!Py_SetProgramName()`: Set :c:member:`PyConfig.program_name` " +"instead." +msgstr "" +":c:func:`!Py_SetProgramName()` : Ustawić :c:member:`PyConfig.program_name` " +"Zamiast." + +msgid ":c:func:`!Py_SetPythonHome()`: Set :c:member:`PyConfig.home` instead." +msgstr "" +" :c:func:`!Py_SetPythonHome()`: Ustawić :c:member:`PyConfig.home` Zamiast." + +msgid "" +"The :c:func:`Py_InitializeFromConfig` API should be used " +"with :c:type:`PyConfig` instead." +msgstr "" +"The :c:func:`Py_InitializeFromConfig`API należy używać z :c:type:`PyConfig` " +"Zamiast." + +msgid "Global configuration variables:" +msgstr "Globalne zmienne konfiguracyjne:" + +msgid ":c:var:`Py_DebugFlag`: Use :c:member:`PyConfig.parser_debug` instead." +msgstr "" + +msgid ":c:var:`Py_VerboseFlag`: Use :c:member:`PyConfig.verbose` instead." +msgstr "" + +msgid ":c:var:`Py_QuietFlag`: Use :c:member:`PyConfig.quiet` instead." +msgstr "" + +msgid "" +":c:var:`Py_InteractiveFlag`: Use :c:member:`PyConfig.interactive` instead." +msgstr "" + +msgid ":c:var:`Py_InspectFlag`: Use :c:member:`PyConfig.inspect` instead." +msgstr "" + +msgid "" +":c:var:`Py_OptimizeFlag`: Use :c:member:`PyConfig.optimization_level` " +"instead." +msgstr "" + +msgid ":c:var:`Py_NoSiteFlag`: Use :c:member:`PyConfig.site_import` instead." +msgstr "" + +msgid "" +":c:var:`Py_BytesWarningFlag`: Use :c:member:`PyConfig.bytes_warning` instead." +msgstr "" + +msgid "" +":c:var:`Py_FrozenFlag`: Use :c:member:`PyConfig.pathconfig_warnings` instead." +msgstr "" + +msgid "" +":c:var:`Py_IgnoreEnvironmentFlag`: Use :c:member:`PyConfig.use_environment` " +"instead." +msgstr "" + +msgid "" +":c:var:`Py_DontWriteBytecodeFlag`: Use :c:member:`PyConfig.write_bytecode` " +"instead." +msgstr "" + +msgid "" +":c:var:`Py_NoUserSiteDirectory`: " +"Use :c:member:`PyConfig.user_site_directory` instead." +msgstr "" + +msgid "" +":c:var:`Py_UnbufferedStdioFlag`: Use :c:member:`PyConfig.buffered_stdio` " +"instead." +msgstr "" + +msgid "" +":c:var:`Py_HashRandomizationFlag`: Use :c:member:`PyConfig.use_hash_seed` " +"and :c:member:`PyConfig.hash_seed` instead." +msgstr "" + +msgid ":c:var:`Py_IsolatedFlag`: Use :c:member:`PyConfig.isolated` instead." +msgstr "" + +msgid "" +":c:var:`Py_LegacyWindowsFSEncodingFlag`: " +"Use :c:member:`PyPreConfig.legacy_windows_fs_encoding` instead." +msgstr "" + +msgid "" +":c:var:`Py_LegacyWindowsStdioFlag`: " +"Use :c:member:`PyConfig.legacy_windows_stdio` instead." +msgstr "" + +msgid "" +":c:var:`!Py_FileSystemDefaultEncoding`: " +"Use :c:member:`PyConfig.filesystem_encoding` instead." +msgstr "" + +msgid "" +":c:var:`!Py_HasFileSystemDefaultEncoding`: " +"Use :c:member:`PyConfig.filesystem_encoding` instead." +msgstr "" + +msgid "" +":c:var:`!Py_FileSystemDefaultEncodeErrors`: " +"Use :c:member:`PyConfig.filesystem_errors` instead." +msgstr "" + +msgid "" +":c:var:`!Py_UTF8Mode`: Use :c:member:`PyPreConfig.utf8_mode` instead. " +"(see :c:func:`Py_PreInitialize`)" +msgstr "" diff --git a/deprecations/c-api-pending-removal-in-future.po b/deprecations/c-api-pending-removal-in-future.po new file mode 100644 index 0000000000..4b4b77d2e3 --- /dev/null +++ b/deprecations/c-api-pending-removal-in-future.po @@ -0,0 +1,125 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Blessing Oluronbi, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Pending Removal in Future Versions" +msgstr "" + +msgid "" +"The following APIs are deprecated and will be removed, although there is " +"currently no date scheduled for their removal." +msgstr "" + +msgid ":c:macro:`Py_TPFLAGS_HAVE_FINALIZE`: Unneeded since Python 3.8." +msgstr "" + +msgid ":c:func:`PyErr_Fetch`: Use :c:func:`PyErr_GetRaisedException` instead." +msgstr "" + +msgid "" +":c:func:`PyErr_NormalizeException`: Use :c:func:`PyErr_GetRaisedException` " +"instead." +msgstr "" + +msgid "" +":c:func:`PyErr_Restore`: Use :c:func:`PyErr_SetRaisedException` instead." +msgstr "" + +msgid "" +":c:func:`PyModule_GetFilename`: Use :c:func:`PyModule_GetFilenameObject` " +"instead." +msgstr "" + +msgid ":c:func:`PyOS_AfterFork`: Use :c:func:`PyOS_AfterFork_Child` instead." +msgstr "" + +msgid "" +":c:func:`PySlice_GetIndicesEx`: Use :c:func:`PySlice_Unpack` " +"and :c:func:`PySlice_AdjustIndices` instead." +msgstr "" + +msgid "" +":c:func:`!PyUnicode_AsDecodedObject`: Use :c:func:`PyCodec_Decode` instead." +msgstr "" +":c:func:`!PyUnicode_AsDecodedObject` : Używać :c:func:`PyCodec_Decode` " +"Zamiast." + +msgid "" +":c:func:`!PyUnicode_AsDecodedUnicode`: Use :c:func:`PyCodec_Decode` instead." +msgstr "" + +msgid "" +":c:func:`!PyUnicode_AsEncodedObject`: Use :c:func:`PyCodec_Encode` instead." +msgstr "" +":c:func:`!PyUnicode_AsEncodedObject` : Używać :c:func:`PyCodec_Encode` " +"Zamiast." + +msgid "" +":c:func:`!PyUnicode_AsEncodedUnicode`: Use :c:func:`PyCodec_Encode` instead." +msgstr "" + +msgid ":c:func:`PyUnicode_READY`: Unneeded since Python 3.12" +msgstr "" + +msgid ":c:func:`!PyErr_Display`: Use :c:func:`PyErr_DisplayException` instead." +msgstr "" + +msgid "" +":c:func:`!_PyErr_ChainExceptions`: Use :c:func:`!_PyErr_ChainExceptions1` " +"instead." +msgstr "" + +msgid "" +":c:member:`!PyBytesObject.ob_shash` member: call :c:func:`PyObject_Hash` " +"instead." +msgstr "" + +msgid ":c:member:`!PyDictObject.ma_version_tag` member." +msgstr "" + +msgid "Thread Local Storage (TLS) API:" +msgstr "" + +msgid "" +":c:func:`PyThread_create_key`: Use :c:func:`PyThread_tss_alloc` instead." +msgstr "" + +msgid ":c:func:`PyThread_delete_key`: Use :c:func:`PyThread_tss_free` instead." +msgstr "" + +msgid "" +":c:func:`PyThread_set_key_value`: Use :c:func:`PyThread_tss_set` instead." +msgstr "" + +msgid "" +":c:func:`PyThread_get_key_value`: Use :c:func:`PyThread_tss_get` instead." +msgstr "" + +msgid "" +":c:func:`PyThread_delete_key_value`: Use :c:func:`PyThread_tss_delete` " +"instead." +msgstr "" + +msgid ":c:func:`PyThread_ReInitTLS`: Unneeded since Python 3.7." +msgstr "" diff --git a/deprecations/index.po b/deprecations/index.po index eabd016d53..c7e50288ae 100644 --- a/deprecations/index.po +++ b/deprecations/index.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2026 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-07-29 04:07+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -58,25 +58,25 @@ msgid ":class:`!ast.Ellipsis`" msgstr ":class:`!ast.Ellipsis`" msgid "" -"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" -"`90953`.)" +"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka " +"in :gh:`90953`.)" msgstr "" msgid ":mod:`asyncio`:" msgstr ":mod:`asyncio`:" msgid "" -"The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" -"`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" -"class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " +"The child watcher " +"classes :class:`~asyncio.MultiLoopChildWatcher`, :class:`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` " +"and :class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " "Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" msgid "" -":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" -"`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." -"AbstractEventLoopPolicy.get_child_watcher` are deprecated and will be " -"removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:`asyncio.AbstractEventLoopPolicy.set_child_watcher` " +"and :meth:`asyncio.AbstractEventLoopPolicy.get_child_watcher` are deprecated " +"and will be removed in Python 3.14. (Contributed by Kumar Aditya " +"in :gh:`94597`.)" msgstr "" msgid "" @@ -87,15 +87,15 @@ msgid "" msgstr "" msgid "" -":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " -"Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " -"typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." -"abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" +":mod:`builtins`: ``bool(NotImplemented)`` now emits " +"a :exc:`DeprecationWarning` and will raise a :exc:`TypeError` in Python " +"3.14. (Contributed by Jelle Zijlstra in :gh:`118767`.)" msgstr "" msgid "" -":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." -"localtime`. (Contributed by Alan Williams in :gh:`72346`.)" +":mod:`email`: Deprecated the *isdst* parameter " +"in :func:`email.utils.localtime`. (Contributed by Alan Williams " +"in :gh:`72346`.)" msgstr "" msgid ":mod:`importlib.abc` deprecated classes:" @@ -134,14 +134,15 @@ msgid "" "on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " "currently the default (:gh:`84559`). Adding a runtime warning about this was " "deemed too disruptive as the majority of code is not expected to care. Use " -"the :func:`~multiprocessing.get_context` or :func:`~multiprocessing." -"set_start_method` APIs to explicitly specify when your code *requires* " -"``'fork'``. See :ref:`multiprocessing-start-methods`." +"the :func:`~multiprocessing.get_context` " +"or :func:`~multiprocessing.set_start_method` APIs to explicitly specify when " +"your code *requires* ``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" -":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." -"PurePath.relative_to`: passing additional arguments is deprecated." +":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` " +"and :meth:`~pathlib.PurePath.relative_to`: passing additional arguments is " +"deprecated." msgstr "" msgid "" @@ -166,20 +167,15 @@ msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." msgstr "" msgid "" -":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" -"ref:`named placeholders ` are used and *parameters* is " -"a sequence instead of a :class:`dict`." -msgstr "" - -msgid "" -":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " -"causes a :exc:`DeprecationWarning` to be emitted when it is used." +":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` " +"if :ref:`named placeholders ` are used and " +"*parameters* is a sequence instead of a :class:`dict`." msgstr "" msgid "" ":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " -"intended to be a public API. (Contributed by Gregory P. Smith in :gh:" -"`88168`.)" +"intended to be a public API. (Contributed by Gregory P. Smith " +"in :gh:`88168`.)" msgstr "" msgid "Pending Removal in Python 3.15" @@ -189,17 +185,18 @@ msgid "The import system:" msgstr "" msgid "" -"Setting :attr:`~module.__cached__` on a module while failing to set :attr:" -"`__spec__.cached ` is deprecated. In " -"Python 3.15, :attr:`!__cached__` will cease to be set or take into " -"consideration by the import system or standard library. (:gh:`97879`)" +"Setting :attr:`~module.__cached__` on a module while failing to " +"set :attr:`__spec__.cached ` is " +"deprecated. In Python 3.15, :attr:`!__cached__` will cease to be set or take " +"into consideration by the import system or standard library. (:gh:`97879`)" msgstr "" msgid "" -"Setting :attr:`~module.__package__` on a module while failing to set :attr:" -"`__spec__.parent ` is deprecated. In " -"Python 3.15, :attr:`!__package__` will cease to be set or take into " -"consideration by the import system or standard library. (:gh:`97879`)" +"Setting :attr:`~module.__package__` on a module while failing to " +"set :attr:`__spec__.parent ` is " +"deprecated. In Python 3.15, :attr:`!__package__` will cease to be set or " +"take into consideration by the import system or standard library. " +"(:gh:`97879`)" msgstr "" msgid ":mod:`ctypes`:" @@ -230,23 +227,12 @@ msgstr ":mod:`importlib`:" msgid "``load_module()`` method: use ``exec_module()`` instead." msgstr "" -msgid ":class:`locale`:" -msgstr ":class:`locale`:" - -msgid "" -"The :func:`~locale.getdefaultlocale` function has been deprecated since " -"Python 3.11. Its removal was originally planned for Python 3.13 (:gh:" -"`90817`), but has been postponed to Python 3.15. Use :func:`~locale." -"getlocale`, :func:`~locale.setlocale`, and :func:`~locale.getencoding` " -"instead. (Contributed by Hugo van Kemenade in :gh:`111187`.)" -msgstr "" - msgid ":mod:`pathlib`:" msgstr ":mod:`pathlib`:" msgid "" -":meth:`.PurePath.is_reserved` has been deprecated since Python 3.13. Use :" -"func:`os.path.isreserved` to detect reserved paths on Windows." +":meth:`.PurePath.is_reserved` has been deprecated since Python 3.13. " +"Use :func:`os.path.isreserved` to detect reserved paths on Windows." msgstr "" msgid ":mod:`platform`:" @@ -259,7 +245,7 @@ msgid "" msgstr "" msgid ":mod:`sysconfig`:" -msgstr "" +msgstr ":mod:`sysconfig`:" msgid "" "The *check_home* argument of :func:`sysconfig.is_python_build` has been " @@ -271,7 +257,7 @@ msgstr ":mod:`threading`:" msgid "" ":func:`~threading.RLock` will take no arguments in Python 3.15. Passing any " -"arguments has been deprecated since Python 3.14, as the Python version does " +"arguments has been deprecated since Python 3.14, as the Python version does " "not permit any arguments, but the C version allows any number of positional " "or keyword arguments, ignoring every argument." msgstr "" @@ -290,14 +276,22 @@ msgid ":mod:`typing`:" msgstr ":mod:`typing`:" msgid "" -"The undocumented keyword argument syntax for creating :class:`~typing." -"NamedTuple` classes (e.g. ``Point = NamedTuple(\"Point\", x=int, y=int)``) " -"has been deprecated since Python 3.13. Use the class-based syntax or the " -"functional syntax instead." +"The undocumented keyword argument syntax for " +"creating :class:`~typing.NamedTuple` classes (e.g. ``Point = " +"NamedTuple(\"Point\", x=int, y=int)``) has been deprecated since Python " +"3.13. Use the class-based syntax or the functional syntax instead." +msgstr "" + +msgid "" +"When using the functional syntax of :class:`~typing.TypedDict`\\s, failing " +"to pass a value to the *fields* parameter (``TD = TypedDict(\"TD\")``) or " +"passing ``None`` (``TD = TypedDict(\"TD\", None)``) has been deprecated " +"since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = " +"TypedDict(\"TD\", {})`` to create a TypedDict with zero field." msgstr "" msgid "" -"The :func:`typing.no_type_check_decorator` decorator function has been " +"The :deco:`typing.no_type_check_decorator` decorator function has been " "deprecated since Python 3.13. After eight years in the :mod:`typing` module, " "it has yet to be supported by any major type checker." msgstr "" @@ -306,19 +300,20 @@ msgid ":mod:`wave`:" msgstr ":mod:`wave`:" msgid "" -"The :meth:`~wave.Wave_read.getmark`, :meth:`!setmark`, and :meth:`~wave." -"Wave_read.getmarkers` methods of the :class:`~wave.Wave_read` and :class:" -"`~wave.Wave_write` classes have been deprecated since Python 3.13." +"The :meth:`~wave.Wave_read.getmark`, :meth:`!setmark`, " +"and :meth:`~wave.Wave_read.getmarkers` methods of " +"the :class:`~wave.Wave_read` and :class:`~wave.Wave_write` classes have been " +"deprecated since Python 3.13." msgstr "" msgid "Pending removal in Python 3.16" msgstr "" msgid "" -"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" -"`__spec__.loader ` is deprecated. In " -"Python 3.16, :attr:`!__loader__` will cease to be set or taken into " -"consideration by the import system or the standard library." +"Setting :attr:`~module.__loader__` on a module while failing to " +"set :attr:`__spec__.loader ` is " +"deprecated. In Python 3.16, :attr:`!__loader__` will cease to be set or " +"taken into consideration by the import system or the standard library." msgstr "" msgid ":mod:`array`:" @@ -381,6 +376,66 @@ msgid "" "deprecated since Python 3.13." msgstr "" +msgid "Pending removal in Python 3.17" +msgstr "" + +msgid ":mod:`collections.abc`:" +msgstr "" + +msgid "" +":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17." +msgstr "" + +msgid "" +"Use ``isinstance(obj, collections.abc.Buffer)`` to test if ``obj`` " +"implements the :ref:`buffer protocol ` at runtime. For use in " +"type annotations, either use :class:`~collections.abc.Buffer` or a union " +"that explicitly specifies the types your code supports (e.g., ``bytes | " +"bytearray | memoryview``)." +msgstr "" + +msgid "" +":class:`!ByteString` was originally intended to be an abstract class that " +"would serve as a supertype of both :class:`bytes` and :class:`bytearray`. " +"However, since the ABC never had any methods, knowing that an object was an " +"instance of :class:`!ByteString` never actually told you anything useful " +"about the object. Other common buffer types such as :class:`memoryview` were " +"also never understood as subtypes of :class:`!ByteString` (either at runtime " +"or by static type checkers)." +msgstr "" + +msgid "" +"See :pep:`PEP 688 <688#current-options>` for more details. (Contributed by " +"Shantanu Jain in :gh:`91896`.)" +msgstr "" + +msgid "" +"Before Python 3.14, old-style unions were implemented using the private " +"class ``typing._UnionGenericAlias``. This class is no longer needed for the " +"implementation, but it has been retained for backward compatibility, with " +"removal scheduled for Python 3.17. Users should use documented introspection " +"helpers like :func:`typing.get_origin` and :func:`typing.get_args` instead " +"of relying on private implementation details." +msgstr "" + +msgid "" +":class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for " +"removal in Python 3.17." +msgstr "" + +msgid "Pending removal in Python 3.18" +msgstr "" + +msgid ":mod:`decimal`:" +msgstr ":mod:`decimal`:" + +msgid "" +"The non-standard and undocumented :class:`~decimal.Decimal` format specifier " +"``'N'``, which is only supported in the :mod:`!decimal` module's C " +"implementation, has been deprecated since Python 3.13. (Contributed by " +"Serhiy Storchaka in :gh:`89902`.)" +msgstr "" + msgid "Pending Removal in Future Versions" msgstr "" @@ -394,12 +449,6 @@ msgid "" "groups are deprecated." msgstr "" -msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" -msgstr "" - -msgid "``bool(NotImplemented)``." -msgstr "``bool(NotImplemented)``." - msgid "" "Generators: ``throw(type, exc, tb)`` and ``athrow(type, exc, tb)`` signature " "is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " @@ -411,10 +460,10 @@ msgid "" "for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " "ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " "``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " -"if the numeric literal is immediately followed by one of keywords :keyword:" -"`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" -"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " -"syntax error. (:gh:`87999`)" +"if the numeric literal is immediately followed by one of " +"keywords :keyword:`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :keyword:`is` " +"and :keyword:`or`. In a future release it will be changed to a syntax " +"error. (:gh:`87999`)" msgstr "" msgid "" @@ -424,31 +473,32 @@ msgid "" msgstr "" msgid "" -"Support for ``__float__()`` method returning a strict subclass of :class:" -"`float`: these methods will be required to return an instance of :class:" -"`float`." +"Support for ``__float__()`` method returning a strict subclass " +"of :class:`float`: these methods will be required to return an instance " +"of :class:`float`." msgstr "" msgid "" -"Support for ``__complex__()`` method returning a strict subclass of :class:" -"`complex`: these methods will be required to return an instance of :class:" -"`complex`." +"Support for ``__complex__()`` method returning a strict subclass " +"of :class:`complex`: these methods will be required to return an instance " +"of :class:`complex`." msgstr "" msgid "Delegation of ``int()`` to ``__trunc__()`` method." msgstr "" msgid "" -"Passing a complex number as the *real* or *imag* argument in the :func:" -"`complex` constructor is now deprecated; it should only be passed as a " -"single positional argument. (Contributed by Serhiy Storchaka in :gh:" -"`109218`.)" +"Passing a complex number as the *real* or *imag* argument in " +"the :func:`complex` constructor is now deprecated; it should only be passed " +"as a single positional argument. (Contributed by Serhiy Storchaka " +"in :gh:`109218`.)" msgstr "" msgid "" ":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " -"are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." -"FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" +"are deprecated and replaced by :data:`calendar.JANUARY` " +"and :data:`calendar.FEBRUARY`. (Contributed by Prince Roshan " +"in :gh:`103636`.)" msgstr "" msgid "" @@ -460,13 +510,13 @@ msgid ":mod:`datetime`:" msgstr ":mod:`datetime`:" msgid "" -":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." -"UTC)``." +":meth:`~datetime.datetime.utcnow`: use " +"``datetime.datetime.now(tz=datetime.UTC)``." msgstr "" msgid "" -":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." -"fromtimestamp(timestamp, tz=datetime.UTC)``." +":meth:`~datetime.datetime.utcfromtimestamp`: use " +"``datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC)``." msgstr "" msgid ":mod:`gettext`: Plural value must be an integer." @@ -529,8 +579,8 @@ msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." msgstr "" msgid "" -":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" -"`!selected_npn_protocol` are deprecated: use ALPN instead." +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` " +"and :meth:`!selected_npn_protocol` are deprecated: use ALPN instead." msgstr "" msgid "``ssl.OP_NO_SSL*`` options" @@ -567,21 +617,21 @@ msgid ":mod:`threading` methods:" msgstr "" msgid "" -":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." -"notify_all`." +":meth:`!threading.Condition.notifyAll`: " +"use :meth:`~threading.Condition.notify_all`." msgstr "" msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." msgstr "" msgid "" -":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" -"attr:`threading.Thread.daemon` attribute." +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: " +"use :attr:`threading.Thread.daemon` attribute." msgstr "" msgid "" -":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" -"attr:`threading.Thread.name` attribute." +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: " +"use :attr:`threading.Thread.name` attribute." msgstr "" msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." @@ -591,7 +641,7 @@ msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." msgstr "" msgid ":class:`typing.Text` (:gh:`92332`)." -msgstr "" +msgstr ":class:`typing.Text` (:gh:`92332`)." msgid "" ":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " @@ -637,9 +687,9 @@ msgid "``to_bytes()``" msgstr "``to_bytes()``" msgid "" -":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" -"`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " -"Use newer :func:`~urllib.request.urlopen` functions and methods." +":mod:`urllib.request`: :class:`~urllib.request.URLopener` " +"and :class:`~urllib.request.FancyURLopener` style of invoking requests is " +"deprecated. Use newer :func:`~urllib.request.urlopen` functions and methods." msgstr "" msgid "" @@ -648,15 +698,15 @@ msgid "" msgstr "" msgid "" -":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." -"etree.ElementTree.Element` is deprecated. In a future release it will always " -"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " -"instead." +":mod:`xml.etree.ElementTree`: Testing the truth value of " +"an :class:`~xml.etree.ElementTree.Element` is deprecated. In a future " +"release it will always return ``True``. Prefer explicit ``len(elem)`` or " +"``elem is not None`` tests instead." msgstr "" msgid "" -":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" -"`~zipimport.zipimporter.exec_module` instead." +":meth:`zipimport.zipimporter.load_module` is deprecated: " +"use :meth:`~zipimport.zipimporter.exec_module` instead." msgstr "" msgid "C API Deprecations" @@ -675,28 +725,36 @@ msgstr "" msgid "" "Functions to configure Python's initialization, deprecated in Python 3.11:" msgstr "" +"Funkcje do konfiguracji inicjalizacji Pythona, przestarzałe w Pythonie 3.11:" msgid ":c:func:`!PySys_SetArgvEx()`: Set :c:member:`PyConfig.argv` instead." msgstr "" +":c:func:`!PySys_SetArgvEx()` : Ustawić :c:member:`PyConfig.argv` Zamiast." msgid ":c:func:`!PySys_SetArgv()`: Set :c:member:`PyConfig.argv` instead." msgstr "" +":c:func:`!PySys_SetArgv()` : Ustawić :c:member:`PyConfig.argv` Zamiast." msgid "" ":c:func:`!Py_SetProgramName()`: Set :c:member:`PyConfig.program_name` " "instead." msgstr "" +":c:func:`!Py_SetProgramName()` : Ustawić :c:member:`PyConfig.program_name` " +"Zamiast." msgid ":c:func:`!Py_SetPythonHome()`: Set :c:member:`PyConfig.home` instead." msgstr "" +" :c:func:`!Py_SetPythonHome()`: Ustawić :c:member:`PyConfig.home` Zamiast." msgid "" -"The :c:func:`Py_InitializeFromConfig` API should be used with :c:type:" -"`PyConfig` instead." +"The :c:func:`Py_InitializeFromConfig` API should be used " +"with :c:type:`PyConfig` instead." msgstr "" +"The :c:func:`Py_InitializeFromConfig`API należy używać z :c:type:`PyConfig` " +"Zamiast." msgid "Global configuration variables:" -msgstr "" +msgstr "Globalne zmienne konfiguracyjne:" msgid ":c:var:`Py_DebugFlag`: Use :c:member:`PyConfig.parser_debug` instead." msgstr "" @@ -741,8 +799,8 @@ msgid "" msgstr "" msgid "" -":c:var:`Py_NoUserSiteDirectory`: Use :c:member:`PyConfig." -"user_site_directory` instead." +":c:var:`Py_NoUserSiteDirectory`: " +"Use :c:member:`PyConfig.user_site_directory` instead." msgstr "" msgid "" @@ -759,51 +817,48 @@ msgid ":c:var:`Py_IsolatedFlag`: Use :c:member:`PyConfig.isolated` instead." msgstr "" msgid "" -":c:var:`Py_LegacyWindowsFSEncodingFlag`: Use :c:member:`PyPreConfig." -"legacy_windows_fs_encoding` instead." +":c:var:`Py_LegacyWindowsFSEncodingFlag`: " +"Use :c:member:`PyPreConfig.legacy_windows_fs_encoding` instead." msgstr "" msgid "" -":c:var:`Py_LegacyWindowsStdioFlag`: Use :c:member:`PyConfig." -"legacy_windows_stdio` instead." +":c:var:`Py_LegacyWindowsStdioFlag`: " +"Use :c:member:`PyConfig.legacy_windows_stdio` instead." msgstr "" msgid "" -":c:var:`!Py_FileSystemDefaultEncoding`: Use :c:member:`PyConfig." -"filesystem_encoding` instead." +":c:var:`!Py_FileSystemDefaultEncoding`: " +"Use :c:member:`PyConfig.filesystem_encoding` instead." msgstr "" msgid "" -":c:var:`!Py_HasFileSystemDefaultEncoding`: Use :c:member:`PyConfig." -"filesystem_encoding` instead." +":c:var:`!Py_HasFileSystemDefaultEncoding`: " +"Use :c:member:`PyConfig.filesystem_encoding` instead." msgstr "" msgid "" -":c:var:`!Py_FileSystemDefaultEncodeErrors`: Use :c:member:`PyConfig." -"filesystem_errors` instead." +":c:var:`!Py_FileSystemDefaultEncodeErrors`: " +"Use :c:member:`PyConfig.filesystem_errors` instead." msgstr "" msgid "" -":c:var:`!Py_UTF8Mode`: Use :c:member:`PyPreConfig.utf8_mode` instead. (see :" -"c:func:`Py_PreInitialize`)" -msgstr "" - -msgid "The bundled copy of ``libmpdecimal``." +":c:var:`!Py_UTF8Mode`: Use :c:member:`PyPreConfig.utf8_mode` instead. " +"(see :c:func:`Py_PreInitialize`)" msgstr "" msgid "" -"The :c:func:`PyImport_ImportModuleNoBlock`: Use :c:func:" -"`PyImport_ImportModule` instead." +"The :c:func:`PyImport_ImportModuleNoBlock`: " +"Use :c:func:`PyImport_ImportModule` instead." msgstr "" msgid "" -":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: Use :c:" -"func:`PyWeakref_GetRef` instead." +":c:func:`PyWeakref_GetObject` and :c:func:`PyWeakref_GET_OBJECT`: " +"Use :c:func:`PyWeakref_GetRef` instead." msgstr "" msgid "" -":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: Use :c:" -"type:`wchar_t` instead." +":c:type:`Py_UNICODE` type and the :c:macro:`!Py_UNICODE_WIDE` macro: " +"Use :c:type:`wchar_t` instead." msgstr "" msgid "Python initialization functions:" @@ -815,8 +870,8 @@ msgid "" msgstr "" msgid "" -":c:func:`Py_GetExecPrefix`: Get :data:`sys.base_exec_prefix` and :data:`sys." -"exec_prefix` instead." +":c:func:`Py_GetExecPrefix`: Get :data:`sys.base_exec_prefix` " +"and :data:`sys.exec_prefix` instead." msgstr "" msgid ":c:func:`Py_GetPath`: Get :data:`sys.path` instead." @@ -834,8 +889,8 @@ msgid ":c:func:`Py_GetProgramName`: Get :data:`sys.executable` instead." msgstr "" msgid "" -":c:func:`Py_GetPythonHome`: Get :c:member:`PyConfig.home` or the :envvar:" -"`PYTHONHOME` environment variable instead." +":c:func:`Py_GetPythonHome`: Get :c:member:`PyConfig.home` or " +"the :envvar:`PYTHONHOME` environment variable instead." msgstr "" msgid "" @@ -867,13 +922,15 @@ msgid ":c:func:`PyOS_AfterFork`: Use :c:func:`PyOS_AfterFork_Child` instead." msgstr "" msgid "" -":c:func:`PySlice_GetIndicesEx`: Use :c:func:`PySlice_Unpack` and :c:func:" -"`PySlice_AdjustIndices` instead." +":c:func:`PySlice_GetIndicesEx`: Use :c:func:`PySlice_Unpack` " +"and :c:func:`PySlice_AdjustIndices` instead." msgstr "" msgid "" ":c:func:`!PyUnicode_AsDecodedObject`: Use :c:func:`PyCodec_Decode` instead." msgstr "" +":c:func:`!PyUnicode_AsDecodedObject` : Używać :c:func:`PyCodec_Decode` " +"Zamiast." msgid "" ":c:func:`!PyUnicode_AsDecodedUnicode`: Use :c:func:`PyCodec_Decode` instead." @@ -882,6 +939,8 @@ msgstr "" msgid "" ":c:func:`!PyUnicode_AsEncodedObject`: Use :c:func:`PyCodec_Encode` instead." msgstr "" +":c:func:`!PyUnicode_AsEncodedObject` : Używać :c:func:`PyCodec_Encode` " +"Zamiast." msgid "" ":c:func:`!PyUnicode_AsEncodedUnicode`: Use :c:func:`PyCodec_Encode` instead." diff --git a/deprecations/pending-removal-in-3.13.po b/deprecations/pending-removal-in-3.13.po index 813fe6e337..08bbf3e403 100644 --- a/deprecations/pending-removal-in-3.13.po +++ b/deprecations/pending-removal-in-3.13.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-07-26 14:16+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -96,58 +96,28 @@ msgid "APIs:" msgstr "APIs:" msgid ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" -msgstr "" +msgstr ":class:`!configparser.LegacyInterpolation` (:gh:`90765`)" msgid "``locale.resetlocale()`` (:gh:`90817`)" -msgstr "" +msgstr "``locale.resetlocale()`` (:gh:`90817`)" msgid ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" -msgstr "" +msgstr ":meth:`!turtle.RawTurtle.settiltangle` (:gh:`50096`)" msgid ":func:`!unittest.findTestCases` (:gh:`50096`)" -msgstr "" +msgstr ":func:`!unittest.findTestCases` (:gh:`50096`)" msgid ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" -msgstr "" +msgstr ":func:`!unittest.getTestCaseNames` (:gh:`50096`)" msgid ":func:`!unittest.makeSuite` (:gh:`50096`)" -msgstr "" +msgstr ":func:`!unittest.makeSuite` (:gh:`50096`)" msgid ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" -msgstr "" +msgstr ":meth:`!unittest.TestProgram.usageExit` (:gh:`67048`)" msgid ":class:`!webbrowser.MacOSX` (:gh:`86421`)" -msgstr "" +msgstr ":class:`!webbrowser.MacOSX` (:gh:`86421`)" msgid ":class:`classmethod` descriptor chaining (:gh:`89519`)" msgstr "" - -msgid ":mod:`importlib.resources` deprecated methods:" -msgstr "" - -msgid "``contents()``" -msgstr "``contents()``" - -msgid "``is_resource()``" -msgstr "``is_resource()``" - -msgid "``open_binary()``" -msgstr "``open_binary()``" - -msgid "``open_text()``" -msgstr "``open_text()``" - -msgid "``path()``" -msgstr "``path()``" - -msgid "``read_binary()``" -msgstr "``read_binary()``" - -msgid "``read_text()``" -msgstr "``read_text()``" - -msgid "" -"Use :func:`importlib.resources.files` instead. Refer to `importlib-" -"resources: Migrating from Legacy `_ (:gh:`106531`)" -msgstr "" diff --git a/deprecations/pending-removal-in-3.14.po b/deprecations/pending-removal-in-3.14.po index 19b7a503b0..3c43000567 100644 --- a/deprecations/pending-removal-in-3.14.po +++ b/deprecations/pending-removal-in-3.14.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2024-07-20 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,25 +54,25 @@ msgid ":class:`!ast.Ellipsis`" msgstr ":class:`!ast.Ellipsis`" msgid "" -"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka in :gh:" -"`90953`.)" +"Use :class:`ast.Constant` instead. (Contributed by Serhiy Storchaka " +"in :gh:`90953`.)" msgstr "" msgid ":mod:`asyncio`:" msgstr ":mod:`asyncio`:" msgid "" -"The child watcher classes :class:`~asyncio.MultiLoopChildWatcher`, :class:" -"`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` and :" -"class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " +"The child watcher " +"classes :class:`~asyncio.MultiLoopChildWatcher`, :class:`~asyncio.FastChildWatcher`, :class:`~asyncio.AbstractChildWatcher` " +"and :class:`~asyncio.SafeChildWatcher` are deprecated and will be removed in " "Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" msgstr "" msgid "" -":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:" -"`asyncio.AbstractEventLoopPolicy.set_child_watcher` and :meth:`asyncio." -"AbstractEventLoopPolicy.get_child_watcher` are deprecated and will be " -"removed in Python 3.14. (Contributed by Kumar Aditya in :gh:`94597`.)" +":func:`asyncio.set_child_watcher`, :func:`asyncio.get_child_watcher`, :meth:`asyncio.AbstractEventLoopPolicy.set_child_watcher` " +"and :meth:`asyncio.AbstractEventLoopPolicy.get_child_watcher` are deprecated " +"and will be removed in Python 3.14. (Contributed by Kumar Aditya " +"in :gh:`94597`.)" msgstr "" msgid "" @@ -83,15 +83,15 @@ msgid "" msgstr "" msgid "" -":mod:`collections.abc`: Deprecated :class:`~collections.abc.ByteString`. " -"Prefer :class:`!Sequence` or :class:`~collections.abc.Buffer`. For use in " -"typing, prefer a union, like ``bytes | bytearray``, or :class:`collections." -"abc.Buffer`. (Contributed by Shantanu Jain in :gh:`91896`.)" +":mod:`builtins`: ``bool(NotImplemented)`` now emits " +"a :exc:`DeprecationWarning` and will raise a :exc:`TypeError` in Python " +"3.14. (Contributed by Jelle Zijlstra in :gh:`118767`.)" msgstr "" msgid "" -":mod:`email`: Deprecated the *isdst* parameter in :func:`email.utils." -"localtime`. (Contributed by Alan Williams in :gh:`72346`.)" +":mod:`email`: Deprecated the *isdst* parameter " +"in :func:`email.utils.localtime`. (Contributed by Alan Williams " +"in :gh:`72346`.)" msgstr "" msgid ":mod:`importlib.abc` deprecated classes:" @@ -130,14 +130,15 @@ msgid "" "on Linux, BSDs, and other non-macOS POSIX platforms where ``'fork'`` is " "currently the default (:gh:`84559`). Adding a runtime warning about this was " "deemed too disruptive as the majority of code is not expected to care. Use " -"the :func:`~multiprocessing.get_context` or :func:`~multiprocessing." -"set_start_method` APIs to explicitly specify when your code *requires* " -"``'fork'``. See :ref:`multiprocessing-start-methods`." +"the :func:`~multiprocessing.get_context` " +"or :func:`~multiprocessing.set_start_method` APIs to explicitly specify when " +"your code *requires* ``'fork'``. See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" -":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` and :meth:`~pathlib." -"PurePath.relative_to`: passing additional arguments is deprecated." +":mod:`pathlib`: :meth:`~pathlib.PurePath.is_relative_to` " +"and :meth:`~pathlib.PurePath.relative_to`: passing additional arguments is " +"deprecated." msgstr "" msgid "" @@ -162,18 +163,13 @@ msgid ":data:`~sqlite3.version` and :data:`~sqlite3.version_info`." msgstr "" msgid "" -":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` if :" -"ref:`named placeholders ` are used and *parameters* is " -"a sequence instead of a :class:`dict`." -msgstr "" - -msgid "" -":mod:`typing`: :class:`~typing.ByteString`, deprecated since Python 3.9, now " -"causes a :exc:`DeprecationWarning` to be emitted when it is used." +":meth:`~sqlite3.Cursor.execute` and :meth:`~sqlite3.Cursor.executemany` " +"if :ref:`named placeholders ` are used and " +"*parameters* is a sequence instead of a :class:`dict`." msgstr "" msgid "" ":mod:`urllib`: :class:`!urllib.parse.Quoter` is deprecated: it was not " -"intended to be a public API. (Contributed by Gregory P. Smith in :gh:" -"`88168`.)" +"intended to be a public API. (Contributed by Gregory P. Smith " +"in :gh:`88168`.)" msgstr "" diff --git a/deprecations/pending-removal-in-3.15.po b/deprecations/pending-removal-in-3.15.po index 18f94a2a4e..b6c5391023 100644 --- a/deprecations/pending-removal-in-3.15.po +++ b/deprecations/pending-removal-in-3.15.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-07-20 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,17 +30,18 @@ msgid "The import system:" msgstr "" msgid "" -"Setting :attr:`~module.__cached__` on a module while failing to set :attr:" -"`__spec__.cached ` is deprecated. In " -"Python 3.15, :attr:`!__cached__` will cease to be set or take into " -"consideration by the import system or standard library. (:gh:`97879`)" +"Setting :attr:`~module.__cached__` on a module while failing to " +"set :attr:`__spec__.cached ` is " +"deprecated. In Python 3.15, :attr:`!__cached__` will cease to be set or take " +"into consideration by the import system or standard library. (:gh:`97879`)" msgstr "" msgid "" -"Setting :attr:`~module.__package__` on a module while failing to set :attr:" -"`__spec__.parent ` is deprecated. In " -"Python 3.15, :attr:`!__package__` will cease to be set or take into " -"consideration by the import system or standard library. (:gh:`97879`)" +"Setting :attr:`~module.__package__` on a module while failing to " +"set :attr:`__spec__.parent ` is " +"deprecated. In Python 3.15, :attr:`!__package__` will cease to be set or " +"take into consideration by the import system or standard library. " +"(:gh:`97879`)" msgstr "" msgid ":mod:`ctypes`:" @@ -71,23 +72,12 @@ msgstr ":mod:`importlib`:" msgid "``load_module()`` method: use ``exec_module()`` instead." msgstr "" -msgid ":class:`locale`:" -msgstr ":class:`locale`:" - -msgid "" -"The :func:`~locale.getdefaultlocale` function has been deprecated since " -"Python 3.11. Its removal was originally planned for Python 3.13 (:gh:" -"`90817`), but has been postponed to Python 3.15. Use :func:`~locale." -"getlocale`, :func:`~locale.setlocale`, and :func:`~locale.getencoding` " -"instead. (Contributed by Hugo van Kemenade in :gh:`111187`.)" -msgstr "" - msgid ":mod:`pathlib`:" msgstr ":mod:`pathlib`:" msgid "" -":meth:`.PurePath.is_reserved` has been deprecated since Python 3.13. Use :" -"func:`os.path.isreserved` to detect reserved paths on Windows." +":meth:`.PurePath.is_reserved` has been deprecated since Python 3.13. " +"Use :func:`os.path.isreserved` to detect reserved paths on Windows." msgstr "" msgid ":mod:`platform`:" @@ -100,7 +90,7 @@ msgid "" msgstr "" msgid ":mod:`sysconfig`:" -msgstr "" +msgstr ":mod:`sysconfig`:" msgid "" "The *check_home* argument of :func:`sysconfig.is_python_build` has been " @@ -112,7 +102,7 @@ msgstr ":mod:`threading`:" msgid "" ":func:`~threading.RLock` will take no arguments in Python 3.15. Passing any " -"arguments has been deprecated since Python 3.14, as the Python version does " +"arguments has been deprecated since Python 3.14, as the Python version does " "not permit any arguments, but the C version allows any number of positional " "or keyword arguments, ignoring every argument." msgstr "" @@ -131,14 +121,22 @@ msgid ":mod:`typing`:" msgstr ":mod:`typing`:" msgid "" -"The undocumented keyword argument syntax for creating :class:`~typing." -"NamedTuple` classes (e.g. ``Point = NamedTuple(\"Point\", x=int, y=int)``) " -"has been deprecated since Python 3.13. Use the class-based syntax or the " -"functional syntax instead." +"The undocumented keyword argument syntax for " +"creating :class:`~typing.NamedTuple` classes (e.g. ``Point = " +"NamedTuple(\"Point\", x=int, y=int)``) has been deprecated since Python " +"3.13. Use the class-based syntax or the functional syntax instead." +msgstr "" + +msgid "" +"When using the functional syntax of :class:`~typing.TypedDict`\\s, failing " +"to pass a value to the *fields* parameter (``TD = TypedDict(\"TD\")``) or " +"passing ``None`` (``TD = TypedDict(\"TD\", None)``) has been deprecated " +"since Python 3.13. Use ``class TD(TypedDict): pass`` or ``TD = " +"TypedDict(\"TD\", {})`` to create a TypedDict with zero field." msgstr "" msgid "" -"The :func:`typing.no_type_check_decorator` decorator function has been " +"The :deco:`typing.no_type_check_decorator` decorator function has been " "deprecated since Python 3.13. After eight years in the :mod:`typing` module, " "it has yet to be supported by any major type checker." msgstr "" @@ -147,7 +145,8 @@ msgid ":mod:`wave`:" msgstr ":mod:`wave`:" msgid "" -"The :meth:`~wave.Wave_read.getmark`, :meth:`!setmark`, and :meth:`~wave." -"Wave_read.getmarkers` methods of the :class:`~wave.Wave_read` and :class:" -"`~wave.Wave_write` classes have been deprecated since Python 3.13." +"The :meth:`~wave.Wave_read.getmark`, :meth:`!setmark`, " +"and :meth:`~wave.Wave_read.getmarkers` methods of " +"the :class:`~wave.Wave_read` and :class:`~wave.Wave_write` classes have been " +"deprecated since Python 3.13." msgstr "" diff --git a/deprecations/pending-removal-in-3.16.po b/deprecations/pending-removal-in-3.16.po index d37609fe2c..04fc071364 100644 --- a/deprecations/pending-removal-in-3.16.po +++ b/deprecations/pending-removal-in-3.16.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2024-07-20 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,10 +30,10 @@ msgid "The import system:" msgstr "" msgid "" -"Setting :attr:`~module.__loader__` on a module while failing to set :attr:" -"`__spec__.loader ` is deprecated. In " -"Python 3.16, :attr:`!__loader__` will cease to be set or taken into " -"consideration by the import system or the standard library." +"Setting :attr:`~module.__loader__` on a module while failing to " +"set :attr:`__spec__.loader ` is " +"deprecated. In Python 3.16, :attr:`!__loader__` will cease to be set or " +"taken into consideration by the import system or the standard library." msgstr "" msgid ":mod:`array`:" diff --git a/deprecations/pending-removal-in-3.17.po b/deprecations/pending-removal-in-3.17.po new file mode 100644 index 0000000000..15b494fed2 --- /dev/null +++ b/deprecations/pending-removal-in-3.17.po @@ -0,0 +1,74 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2025 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-19 15:03+0000\n" +"Last-Translator: python-doc bot, 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 "Pending removal in Python 3.17" +msgstr "" + +msgid ":mod:`collections.abc`:" +msgstr "" + +msgid "" +":class:`collections.abc.ByteString` is scheduled for removal in Python 3.17." +msgstr "" + +msgid "" +"Use ``isinstance(obj, collections.abc.Buffer)`` to test if ``obj`` " +"implements the :ref:`buffer protocol ` at runtime. For use in " +"type annotations, either use :class:`~collections.abc.Buffer` or a union " +"that explicitly specifies the types your code supports (e.g., ``bytes | " +"bytearray | memoryview``)." +msgstr "" + +msgid "" +":class:`!ByteString` was originally intended to be an abstract class that " +"would serve as a supertype of both :class:`bytes` and :class:`bytearray`. " +"However, since the ABC never had any methods, knowing that an object was an " +"instance of :class:`!ByteString` never actually told you anything useful " +"about the object. Other common buffer types such as :class:`memoryview` were " +"also never understood as subtypes of :class:`!ByteString` (either at runtime " +"or by static type checkers)." +msgstr "" + +msgid "" +"See :pep:`PEP 688 <688#current-options>` for more details. (Contributed by " +"Shantanu Jain in :gh:`91896`.)" +msgstr "" + +msgid ":mod:`typing`:" +msgstr ":mod:`typing`:" + +msgid "" +"Before Python 3.14, old-style unions were implemented using the private " +"class ``typing._UnionGenericAlias``. This class is no longer needed for the " +"implementation, but it has been retained for backward compatibility, with " +"removal scheduled for Python 3.17. Users should use documented introspection " +"helpers like :func:`typing.get_origin` and :func:`typing.get_args` instead " +"of relying on private implementation details." +msgstr "" + +msgid "" +":class:`typing.ByteString`, deprecated since Python 3.9, is scheduled for " +"removal in Python 3.17." +msgstr "" diff --git a/deprecations/pending-removal-in-3.18.po b/deprecations/pending-removal-in-3.18.po new file mode 100644 index 0000000000..5a505bb54d --- /dev/null +++ b/deprecations/pending-removal-in-3.18.po @@ -0,0 +1,37 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# python-doc bot, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2026-01-07 14:30+0000\n" +"Last-Translator: python-doc bot, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "Pending removal in Python 3.18" +msgstr "" + +msgid ":mod:`decimal`:" +msgstr ":mod:`decimal`:" + +msgid "" +"The non-standard and undocumented :class:`~decimal.Decimal` format specifier " +"``'N'``, which is only supported in the :mod:`!decimal` module's C " +"implementation, has been deprecated since Python 3.13. (Contributed by " +"Serhiy Storchaka in :gh:`89902`.)" +msgstr "" diff --git a/deprecations/pending-removal-in-future.po b/deprecations/pending-removal-in-future.po index e210dce9ac..ed5de6b1af 100644 --- a/deprecations/pending-removal-in-future.po +++ b/deprecations/pending-removal-in-future.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-07-20 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,15 +36,9 @@ msgid "" "groups are deprecated." msgstr "" -msgid ":mod:`array`'s ``'u'`` format code (:gh:`57281`)" -msgstr "" - msgid ":mod:`builtins`:" msgstr ":mod:`builtins`:" -msgid "``bool(NotImplemented)``." -msgstr "``bool(NotImplemented)``." - msgid "" "Generators: ``throw(type, exc, tb)`` and ``athrow(type, exc, tb)`` signature " "is deprecated: use ``throw(exc)`` and ``athrow(exc)`` instead, the single " @@ -56,10 +50,10 @@ msgid "" "for example ``0in x``, ``1or x``, ``0if 1else 2``. It allows confusing and " "ambiguous expressions like ``[0x1for x in y]`` (which can be interpreted as " "``[0x1 for x in y]`` or ``[0x1f or x in y]``). A syntax warning is raised " -"if the numeric literal is immediately followed by one of keywords :keyword:" -"`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :" -"keyword:`is` and :keyword:`or`. In a future release it will be changed to a " -"syntax error. (:gh:`87999`)" +"if the numeric literal is immediately followed by one of " +"keywords :keyword:`and`, :keyword:`else`, :keyword:`for`, :keyword:`if`, :keyword:`in`, :keyword:`is` " +"and :keyword:`or`. In a future release it will be changed to a syntax " +"error. (:gh:`87999`)" msgstr "" msgid "" @@ -69,31 +63,32 @@ msgid "" msgstr "" msgid "" -"Support for ``__float__()`` method returning a strict subclass of :class:" -"`float`: these methods will be required to return an instance of :class:" -"`float`." +"Support for ``__float__()`` method returning a strict subclass " +"of :class:`float`: these methods will be required to return an instance " +"of :class:`float`." msgstr "" msgid "" -"Support for ``__complex__()`` method returning a strict subclass of :class:" -"`complex`: these methods will be required to return an instance of :class:" -"`complex`." +"Support for ``__complex__()`` method returning a strict subclass " +"of :class:`complex`: these methods will be required to return an instance " +"of :class:`complex`." msgstr "" msgid "Delegation of ``int()`` to ``__trunc__()`` method." msgstr "" msgid "" -"Passing a complex number as the *real* or *imag* argument in the :func:" -"`complex` constructor is now deprecated; it should only be passed as a " -"single positional argument. (Contributed by Serhiy Storchaka in :gh:" -"`109218`.)" +"Passing a complex number as the *real* or *imag* argument in " +"the :func:`complex` constructor is now deprecated; it should only be passed " +"as a single positional argument. (Contributed by Serhiy Storchaka " +"in :gh:`109218`.)" msgstr "" msgid "" ":mod:`calendar`: ``calendar.January`` and ``calendar.February`` constants " -"are deprecated and replaced by :data:`calendar.JANUARY` and :data:`calendar." -"FEBRUARY`. (Contributed by Prince Roshan in :gh:`103636`.)" +"are deprecated and replaced by :data:`calendar.JANUARY` " +"and :data:`calendar.FEBRUARY`. (Contributed by Prince Roshan " +"in :gh:`103636`.)" msgstr "" msgid "" @@ -105,13 +100,13 @@ msgid ":mod:`datetime`:" msgstr ":mod:`datetime`:" msgid "" -":meth:`~datetime.datetime.utcnow`: use ``datetime.datetime.now(tz=datetime." -"UTC)``." +":meth:`~datetime.datetime.utcnow`: use " +"``datetime.datetime.now(tz=datetime.UTC)``." msgstr "" msgid "" -":meth:`~datetime.datetime.utcfromtimestamp`: use ``datetime.datetime." -"fromtimestamp(timestamp, tz=datetime.UTC)``." +":meth:`~datetime.datetime.utcfromtimestamp`: use " +"``datetime.datetime.fromtimestamp(timestamp, tz=datetime.UTC)``." msgstr "" msgid ":mod:`gettext`: Plural value must be an integer." @@ -177,8 +172,8 @@ msgid ":class:`ssl.SSLContext` without protocol argument is deprecated." msgstr "" msgid "" -":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` and :meth:" -"`!selected_npn_protocol` are deprecated: use ALPN instead." +":class:`ssl.SSLContext`: :meth:`~ssl.SSLContext.set_npn_protocols` " +"and :meth:`!selected_npn_protocol` are deprecated: use ALPN instead." msgstr "" msgid "``ssl.OP_NO_SSL*`` options" @@ -215,21 +210,21 @@ msgid ":mod:`threading` methods:" msgstr "" msgid "" -":meth:`!threading.Condition.notifyAll`: use :meth:`~threading.Condition." -"notify_all`." +":meth:`!threading.Condition.notifyAll`: " +"use :meth:`~threading.Condition.notify_all`." msgstr "" msgid ":meth:`!threading.Event.isSet`: use :meth:`~threading.Event.is_set`." msgstr "" msgid "" -":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: use :" -"attr:`threading.Thread.daemon` attribute." +":meth:`!threading.Thread.isDaemon`, :meth:`threading.Thread.setDaemon`: " +"use :attr:`threading.Thread.daemon` attribute." msgstr "" msgid "" -":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: use :" -"attr:`threading.Thread.name` attribute." +":meth:`!threading.Thread.getName`, :meth:`threading.Thread.setName`: " +"use :attr:`threading.Thread.name` attribute." msgstr "" msgid ":meth:`!threading.currentThread`: use :meth:`threading.current_thread`." @@ -239,7 +234,7 @@ msgid ":meth:`!threading.activeCount`: use :meth:`threading.active_count`." msgstr "" msgid ":class:`typing.Text` (:gh:`92332`)." -msgstr "" +msgstr ":class:`typing.Text` (:gh:`92332`)." msgid "" ":class:`unittest.IsolatedAsyncioTestCase`: it is deprecated to return a " @@ -285,9 +280,9 @@ msgid "``to_bytes()``" msgstr "``to_bytes()``" msgid "" -":mod:`urllib.request`: :class:`~urllib.request.URLopener` and :class:" -"`~urllib.request.FancyURLopener` style of invoking requests is deprecated. " -"Use newer :func:`~urllib.request.urlopen` functions and methods." +":mod:`urllib.request`: :class:`~urllib.request.URLopener` " +"and :class:`~urllib.request.FancyURLopener` style of invoking requests is " +"deprecated. Use newer :func:`~urllib.request.urlopen` functions and methods." msgstr "" msgid "" @@ -296,13 +291,13 @@ msgid "" msgstr "" msgid "" -":mod:`xml.etree.ElementTree`: Testing the truth value of an :class:`~xml." -"etree.ElementTree.Element` is deprecated. In a future release it will always " -"return ``True``. Prefer explicit ``len(elem)`` or ``elem is not None`` tests " -"instead." +":mod:`xml.etree.ElementTree`: Testing the truth value of " +"an :class:`~xml.etree.ElementTree.Element` is deprecated. In a future " +"release it will always return ``True``. Prefer explicit ``len(elem)`` or " +"``elem is not None`` tests instead." msgstr "" msgid "" -":meth:`zipimport.zipimporter.load_module` is deprecated: use :meth:" -"`~zipimport.zipimporter.exec_module` instead." +":meth:`zipimport.zipimporter.load_module` is deprecated: " +"use :meth:`~zipimport.zipimporter.exec_module` instead." msgstr "" diff --git a/distributing/index.po b/distributing/index.po index d9f9de665b..281e7f53e4 100644 --- a/distributing/index.po +++ b/distributing/index.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:50+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/extending/building.po b/extending/building.po index 648d937094..0a6d98264d 100644 --- a/extending/building.po +++ b/extending/building.po @@ -32,10 +32,10 @@ msgid "" msgstr "" msgid "" -"To be importable, the shared library must be available on :envvar:" -"`PYTHONPATH`, and must be named after the module name, with an appropriate " -"extension. When using distutils, the correct filename is generated " -"automatically." +"To be importable, the shared library must be available " +"on :envvar:`PYTHONPATH`, and must be named after the module name, with an " +"appropriate extension. When using distutils, the correct filename is " +"generated automatically." msgstr "" msgid "The initialization function has the signature:" @@ -100,9 +100,9 @@ msgstr "" msgid "" "It is common to pre-compute arguments to :func:`setup`, to better structure " -"the driver script. In the example above, the ``ext_modules`` argument to :" -"func:`~distutils.core.setup` is a list of extension modules, each of which " -"is an instance of the :class:`~distutils.extension.Extension`. In the " +"the driver script. In the example above, the ``ext_modules`` argument " +"to :func:`~distutils.core.setup` is a list of extension modules, each of " +"which is an instance of the :class:`~distutils.extension.Extension`. In the " "example, the instance defines an extension named ``demo`` which is build by " "compiling a single source file, :file:`demo.c`." msgstr "" @@ -145,8 +145,8 @@ msgstr "" msgid "" "In some cases, additional files need to be included in a source " -"distribution; this is done through a :file:`MANIFEST.in` file; see :ref:" -"`manifest` for details." +"distribution; this is done through a :file:`MANIFEST.in` file; " +"see :ref:`manifest` for details." msgstr "" msgid "" diff --git a/extending/embedding.po b/extending/embedding.po index dccffb8f54..bedd3a821c 100644 --- a/extending/embedding.po +++ b/extending/embedding.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -49,10 +49,10 @@ msgstr "" msgid "" "So if you are embedding Python, you are providing your own main program. " "One of the things this main program has to do is initialize the Python " -"interpreter. At the very least, you have to call the function :c:func:" -"`Py_Initialize`. There are optional calls to pass command line arguments to " -"Python. Then later you can call the interpreter from any part of the " -"application." +"interpreter. At the very least, you have to call the " +"function :c:func:`Py_Initialize`. There are optional calls to pass command " +"line arguments to Python. Then later you can call the interpreter from any " +"part of the application." msgstr "" msgid "" @@ -127,17 +127,17 @@ msgid "" msgstr "" msgid "" -"Setting :c:member:`PyConfig.program_name` should be called before :c:func:" -"`Py_InitializeFromConfig` to inform the interpreter about paths to Python " -"run-time libraries. Next, the Python interpreter is initialized with :c:" -"func:`Py_Initialize`, followed by the execution of a hard-coded Python " -"script that prints the date and time. Afterwards, the :c:func:" -"`Py_FinalizeEx` call shuts the interpreter down, followed by the end of the " -"program. In a real program, you may want to get the Python script from " -"another source, perhaps a text-editor routine, a file, or a database. " -"Getting the Python code from a file can better be done by using the :c:func:" -"`PyRun_SimpleFile` function, which saves you the trouble of allocating " -"memory space and loading the file contents." +"Setting :c:member:`PyConfig.program_name` should be called " +"before :c:func:`Py_InitializeFromConfig` to inform the interpreter about " +"paths to Python run-time libraries. Next, the Python interpreter is " +"initialized with :c:func:`Py_Initialize`, followed by the execution of a " +"hard-coded Python script that prints the date and time. Afterwards, " +"the :c:func:`Py_FinalizeEx` call shuts the interpreter down, followed by the " +"end of the program. In a real program, you may want to get the Python " +"script from another source, perhaps a text-editor routine, a file, or a " +"database. Getting the Python code from a file can better be done by using " +"the :c:func:`PyRun_SimpleFile` function, which saves you the trouble of " +"allocating memory space and loading the file contents." msgstr "" msgid "Beyond Very High Level Embedding: An overview" @@ -323,10 +323,10 @@ msgid "" msgstr "" msgid "" -"After initializing the interpreter, the script is loaded using :c:func:" -"`PyImport_Import`. This routine needs a Python string as its argument, " -"which is constructed using the :c:func:`PyUnicode_DecodeFSDefault` data " -"conversion routine. ::" +"After initializing the interpreter, the script is loaded " +"using :c:func:`PyImport_Import`. This routine needs a Python string as its " +"argument, which is constructed using the :c:func:`PyUnicode_DecodeFSDefault` " +"data conversion routine. ::" msgstr "" msgid "" @@ -340,11 +340,11 @@ msgid "" msgstr "" msgid "" -"Once the script is loaded, the name we're looking for is retrieved using :c:" -"func:`PyObject_GetAttrString`. If the name exists, and the object returned " -"is callable, you can safely assume that it is a function. The program then " -"proceeds by constructing a tuple of arguments as normal. The call to the " -"Python function is then made with::" +"Once the script is loaded, the name we're looking for is retrieved " +"using :c:func:`PyObject_GetAttrString`. If the name exists, and the object " +"returned is callable, you can safely assume that it is a function. The " +"program then proceeds by constructing a tuple of arguments as normal. The " +"call to the Python function is then made with::" msgstr "" msgid "pValue = PyObject_CallObject(pFunc, pArgs);" @@ -382,21 +382,23 @@ msgid "" " return PyLong_FromLong(numargs);\n" "}\n" "\n" -"static PyMethodDef EmbMethods[] = {\n" +"static PyMethodDef emb_module_methods[] = {\n" " {\"numargs\", emb_numargs, METH_VARARGS,\n" " \"Return the number of arguments received by the process.\"},\n" " {NULL, NULL, 0, NULL}\n" "};\n" "\n" -"static PyModuleDef EmbModule = {\n" -" PyModuleDef_HEAD_INIT, \"emb\", NULL, -1, EmbMethods,\n" -" NULL, NULL, NULL, NULL\n" +"static struct PyModuleDef emb_module = {\n" +" .m_base = PyModuleDef_HEAD_INIT,\n" +" .m_name = \"emb\",\n" +" .m_size = 0,\n" +" .m_methods = emb_module_methods,\n" "};\n" "\n" "static PyObject*\n" "PyInit_emb(void)\n" "{\n" -" return PyModule_Create(&EmbModule);\n" +" return PyModuleDef_Init(&emb_module);\n" "}" msgstr "" @@ -448,8 +450,8 @@ msgid "" msgstr "" msgid "" -"To find out the required compiler and linker flags, you can execute the :" -"file:`python{X.Y}-config` script which is generated as part of the " +"To find out the required compiler and linker flags, you can execute " +"the :file:`python{X.Y}-config` script which is generated as part of the " "installation process (a :file:`python3-config` script may also be " "available). This script has several options, of which the following will be " "directly useful to you:" @@ -476,12 +478,12 @@ msgstr "" msgid "" "$ /opt/bin/python3.11-config --ldflags --embed\n" -"-L/opt/lib/python3.11/config-3.11-x86_64-linux-gnu -L/opt/lib -lpython3.11 -" -"lpthread -ldl -lutil -lm" +"-L/opt/lib/python3.11/config-3.11-x86_64-linux-gnu -L/opt/lib -lpython3.11 " +"-lpthread -ldl -lutil -lm" msgstr "" "$ /opt/bin/python3.11-config --ldflags --embed\n" -"-L/opt/lib/python3.11/config-3.11-x86_64-linux-gnu -L/opt/lib -lpython3.11 -" -"lpthread -ldl -lutil -lm" +"-L/opt/lib/python3.11/config-3.11-x86_64-linux-gnu -L/opt/lib -lpython3.11 " +"-lpthread -ldl -lutil -lm" msgid "" "To avoid confusion between several Python installations (and especially " @@ -494,11 +496,11 @@ msgid "" "If this procedure doesn't work for you (it is not guaranteed to work for all " "Unix-like platforms; however, we welcome :ref:`bug reports `) you will have to read your system's documentation about dynamic " -"linking and/or examine Python's :file:`Makefile` (use :func:`sysconfig." -"get_makefile_filename` to find its location) and compilation options. In " -"this case, the :mod:`sysconfig` module is a useful tool to programmatically " -"extract the configuration values that you will want to combine together. " -"For example:" +"linking and/or examine Python's :file:`Makefile` " +"(use :func:`sysconfig.get_makefile_filename` to find its location) and " +"compilation options. In this case, the :mod:`sysconfig` module is a useful " +"tool to programmatically extract the configuration values that you will want " +"to combine together. For example:" msgstr "" msgid "" diff --git a/extending/extending.po b/extending/extending.po index b49d15b468..a620ff2107 100644 --- a/extending/extending.po +++ b/extending/extending.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:51+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-15 19:50+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -48,8 +47,8 @@ msgstr "" "Aby wspierać rozszerzenia, API Pythona (Application Programmers Interface) " "określa zbiór funkcji, makropoleceń i zmiennych, które dostarczają dostęp do " "większości aspektów systemu czasu-wykonania Pythona. API Pythona jest " -"załączane w źródłowym pliku C przez załączenie pliku nagłówkowego ``\"Python." -"h\"``." +"załączane w źródłowym pliku C przez załączenie pliku nagłówkowego " +"``\"Python.h\"``." msgid "" "The compilation of an extension module depends on its intended use as well " @@ -91,9 +90,9 @@ msgstr "" msgid "" "Begin by creating a file :file:`spammodule.c`. (Historically, if a module " -"is called ``spam``, the C file containing its implementation is called :file:" -"`spammodule.c`; if the module name is very long, like ``spammify``, the " -"module name can be just :file:`spammify.c`.)" +"is called ``spam``, the C file containing its implementation is " +"called :file:`spammodule.c`; if the module name is very long, like " +"``spammify``, the module name can be just :file:`spammify.c`.)" msgstr "" "Zaczynając od stworzenia pliku :file:`spammodule.c` (Historycznie, jeśli " "moduł był nazwany ``spam``, plik C zawierający jego wypełnienie jest " @@ -123,8 +122,8 @@ msgid "" "any standard headers are included." msgstr "" "Jako że Python może definiować pewne definicje preprocesora, które wpływają " -"na pliki nagłówkowe na niektórych systemach, *musisz* załączyć plik :file:" -"`Python.h` przed jakimikolwiek standardowymi nagłówkami." +"na pliki nagłówkowe na niektórych systemach, *musisz* załączyć " +"plik :file:`Python.h` przed jakimikolwiek standardowymi nagłówkami." msgid "" "``#define PY_SSIZE_T_CLEAN`` was used to indicate that ``Py_ssize_t`` should " @@ -135,12 +134,66 @@ msgstr "" msgid "" "All user-visible symbols defined by :file:`Python.h` have a prefix of ``Py`` " -"or ``PY``, except those defined in standard header files. For convenience, " -"and since they are used extensively by the Python interpreter, ``\"Python." -"h\"`` includes a few standard header files: ````, ````, " -"````, and ````. If the latter header file does not exist " -"on your system, it declares the functions :c:func:`malloc`, :c:func:`free` " -"and :c:func:`realloc` directly." +"or ``PY``, except those defined in standard header files." +msgstr "" + +msgid "" +"For backward compatibility, :file:`Python.h` includes several standard " +"header files. C extensions should include the standard headers that they " +"use, and should not rely on these implicit includes. If using the limited C " +"API version 3.13 or newer, the implicit includes are:" +msgstr "" + +msgid "````" +msgstr "" + +msgid "```` (on Windows)" +msgstr "" + +msgid "````" +msgstr "" + +msgid "````" +msgstr "" + +msgid "````" +msgstr "" + +msgid "````" +msgstr "" + +msgid "````" +msgstr "" + +msgid "```` (if present)" +msgstr "" + +msgid "" +"If :c:macro:`Py_LIMITED_API` is not defined, or is set to version 3.12 or " +"older, the headers below are also included:" +msgstr "" + +msgid "````" +msgstr "" + +msgid "```` (on POSIX)" +msgstr "" + +msgid "" +"If :c:macro:`Py_LIMITED_API` is not defined, or is set to version 3.10 or " +"older, the headers below are also included:" +msgstr "" + +msgid "````" +msgstr "" + +msgid "````" +msgstr "" + +msgid "````" +msgstr "" + +msgid "````" msgstr "" msgid "" @@ -236,18 +289,18 @@ msgstr "" msgid "" "Another useful function is :c:func:`PyErr_SetFromErrno`, which only takes an " "exception argument and constructs the associated value by inspection of the " -"global variable :c:data:`errno`. The most general function is :c:func:" -"`PyErr_SetObject`, which takes two object arguments, the exception and its " -"associated value. You don't need to :c:func:`Py_INCREF` the objects passed " -"to any of these functions." +"global variable :c:data:`errno`. The most general function " +"is :c:func:`PyErr_SetObject`, which takes two object arguments, the " +"exception and its associated value. You don't need to :c:func:`Py_INCREF` " +"the objects passed to any of these functions." msgstr "" msgid "" -"You can test non-destructively whether an exception has been set with :c:" -"func:`PyErr_Occurred`. This returns the current exception object, or " -"``NULL`` if no exception has occurred. You normally don't need to call :c:" -"func:`PyErr_Occurred` to see whether an error occurred in a function call, " -"since you should be able to tell from the return value." +"You can test non-destructively whether an exception has been set " +"with :c:func:`PyErr_Occurred`. This returns the current exception object, " +"or ``NULL`` if no exception has occurred. You normally don't need to " +"call :c:func:`PyErr_Occurred` to see whether an error occurred in a function " +"call, since you should be able to tell from the return value." msgstr "" msgid "" @@ -280,10 +333,11 @@ msgstr "" msgid "" "Every failing :c:func:`malloc` call must be turned into an exception --- the " -"direct caller of :c:func:`malloc` (or :c:func:`realloc`) must call :c:func:" -"`PyErr_NoMemory` and return a failure indicator itself. All the object-" -"creating functions (for example, :c:func:`PyLong_FromLong`) already do this, " -"so this note is only relevant to those who call :c:func:`malloc` directly." +"direct caller of :c:func:`malloc` (or :c:func:`realloc`) must " +"call :c:func:`PyErr_NoMemory` and return a failure indicator itself. All " +"the object-creating functions (for example, :c:func:`PyLong_FromLong`) " +"already do this, so this note is only relevant to those who " +"call :c:func:`malloc` directly." msgstr "" msgid "" @@ -294,8 +348,8 @@ msgid "" msgstr "" msgid "" -"Finally, be careful to clean up garbage (by making :c:func:`Py_XDECREF` or :" -"c:func:`Py_DECREF` calls for objects you have already created) when you " +"Finally, be careful to clean up garbage (by making :c:func:`Py_XDECREF` " +"or :c:func:`Py_DECREF` calls for objects you have already created) when you " "return an error indicator!" msgstr "" @@ -304,47 +358,77 @@ msgid "" "predeclared C objects corresponding to all built-in Python exceptions, such " "as :c:data:`PyExc_ZeroDivisionError`, which you can use directly. Of course, " "you should choose exceptions wisely --- don't use :c:data:`PyExc_TypeError` " -"to mean that a file couldn't be opened (that should probably be :c:data:" -"`PyExc_OSError`). If something's wrong with the argument list, the :c:func:" -"`PyArg_ParseTuple` function usually raises :c:data:`PyExc_TypeError`. If " -"you have an argument whose value must be in a particular range or must " -"satisfy other conditions, :c:data:`PyExc_ValueError` is appropriate." +"to mean that a file couldn't be opened (that should probably " +"be :c:data:`PyExc_OSError`). If something's wrong with the argument list, " +"the :c:func:`PyArg_ParseTuple` function usually " +"raises :c:data:`PyExc_TypeError`. If you have an argument whose value must " +"be in a particular range or must satisfy other " +"conditions, :c:data:`PyExc_ValueError` is appropriate." msgstr "" msgid "" -"You can also define a new exception that is unique to your module. For this, " -"you usually declare a static object variable at the beginning of your file::" +"You can also define a new exception that is unique to your module. The " +"simplest way to do this is to declare a static global object variable at the " +"beginning of the file::" msgstr "" -"Możesz też określić nowy wyjątek który jest niepowtarzalny dla twojego " -"modułu. Dla tego, zwykle deklarujesz przedmiot statycznej zmiennej na " -"początku pliku::" -msgid "static PyObject *SpamError;" +msgid "static PyObject *SpamError = NULL;" msgstr "" msgid "" -"and initialize it in your module's initialization function (:c:func:`!" -"PyInit_spam`) with an exception object::" +"and initialize it by calling :c:func:`PyErr_NewException` in the " +"module's :c:data:`Py_mod_exec` function (:c:func:`!spam_module_exec`)::" +msgstr "" + +msgid "SpamError = PyErr_NewException(\"spam.error\", NULL, NULL);" msgstr "" msgid "" -"PyMODINIT_FUNC\n" -"PyInit_spam(void)\n" -"{\n" -" PyObject *m;\n" -"\n" -" m = PyModule_Create(&spammodule);\n" -" if (m == NULL)\n" -" return NULL;\n" +"Since :c:data:`!SpamError` is a global variable, it will be overwritten " +"every time the module is reinitialized, when the :c:data:`Py_mod_exec` " +"function is called." +msgstr "" + +msgid "" +"For now, let's avoid the issue: we will block repeated initialization by " +"raising an :py:exc:`ImportError`::" +msgstr "" + +msgid "" +"static PyObject *SpamError = NULL;\n" "\n" +"static int\n" +"spam_module_exec(PyObject *m)\n" +"{\n" +" if (SpamError != NULL) {\n" +" PyErr_SetString(PyExc_ImportError,\n" +" \"cannot initialize spam module more than once\");\n" +" return -1;\n" +" }\n" " SpamError = PyErr_NewException(\"spam.error\", NULL, NULL);\n" -" if (PyModule_AddObjectRef(m, \"error\", SpamError) < 0) {\n" -" Py_CLEAR(SpamError);\n" -" Py_DECREF(m);\n" -" return NULL;\n" +" if (PyModule_AddObjectRef(m, \"SpamError\", SpamError) < 0) {\n" +" return -1;\n" " }\n" "\n" -" return m;\n" +" return 0;\n" +"}\n" +"\n" +"static PyModuleDef_Slot spam_module_slots[] = {\n" +" {Py_mod_exec, spam_module_exec},\n" +" {0, NULL}\n" +"};\n" +"\n" +"static struct PyModuleDef spam_module = {\n" +" .m_base = PyModuleDef_HEAD_INIT,\n" +" .m_name = \"spam\",\n" +" .m_size = 0, // non-negative\n" +" .m_slots = spam_module_slots,\n" +"};\n" +"\n" +"PyMODINIT_FUNC\n" +"PyInit_spam(void)\n" +"{\n" +" return PyModuleDef_Init(&spam_module);\n" "}" msgstr "" @@ -365,6 +449,13 @@ msgid "" "unintended side effects." msgstr "" +msgid "" +"For now, the :c:func:`Py_DECREF` call to remove this reference is missing. " +"Even when the Python interpreter shuts down, the global :c:data:`!SpamError` " +"variable will not be garbage-collected. It will \"leak\". We did, however, " +"ensure that this will happen at most once per process." +msgstr "" + msgid "" "We discuss the use of :c:macro:`PyMODINIT_FUNC` as a function return type " "later in this sample." @@ -428,8 +519,8 @@ msgstr "" msgid "" "Our :func:`!spam.system` function must return the value of :c:data:`!sts` as " -"a Python object. This is done using the function :c:func:" -"`PyLong_FromLong`. ::" +"a Python object. This is done using the " +"function :c:func:`PyLong_FromLong`. ::" msgstr "" msgid "return PyLong_FromLong(sts);" @@ -445,8 +536,8 @@ msgstr "" msgid "" "If you have a C function that returns no useful argument (a function " "returning :c:expr:`void`), the corresponding Python function must return " -"``None``. You need this idiom to do so (which is implemented by the :c:" -"macro:`Py_RETURN_NONE` macro)::" +"``None``. You need this idiom to do so (which is implemented by " +"the :c:macro:`Py_RETURN_NONE` macro)::" msgstr "" msgid "" @@ -469,7 +560,7 @@ msgid "" msgstr "" msgid "" -"static PyMethodDef SpamMethods[] = {\n" +"static PyMethodDef spam_methods[] = {\n" " ...\n" " {\"system\", spam_system, METH_VARARGS,\n" " \"Execute a shell command.\"},\n" @@ -488,8 +579,9 @@ msgstr "" msgid "" "When using only ``METH_VARARGS``, the function should expect the Python-" -"level parameters to be passed in as a tuple acceptable for parsing via :c:" -"func:`PyArg_ParseTuple`; more information on this function is provided below." +"level parameters to be passed in as a tuple acceptable for parsing " +"via :c:func:`PyArg_ParseTuple`; more information on this function is " +"provided below." msgstr "" msgid "" @@ -507,28 +599,25 @@ msgstr "" "modułu::" msgid "" -"static struct PyModuleDef spammodule = {\n" -" PyModuleDef_HEAD_INIT,\n" -" \"spam\", /* name of module */\n" -" spam_doc, /* module documentation, may be NULL */\n" -" -1, /* size of per-interpreter state of the module,\n" -" or -1 if the module keeps state in global variables. */\n" -" SpamMethods\n" +"static struct PyModuleDef spam_module = {\n" +" ...\n" +" .m_methods = spam_methods,\n" +" ...\n" "};" msgstr "" msgid "" "This structure, in turn, must be passed to the interpreter in the module's " -"initialization function. The initialization function must be named :c:func:" -"`!PyInit_name`, where *name* is the name of the module, and should be the " -"only non-\\ ``static`` item defined in the module file::" +"initialization function. The initialization function must be " +"named :c:func:`!PyInit_name`, where *name* is the name of the module, and " +"should be the only non-\\ ``static`` item defined in the module file::" msgstr "" msgid "" "PyMODINIT_FUNC\n" "PyInit_spam(void)\n" "{\n" -" return PyModule_Create(&spammodule);\n" +" return PyModuleDef_Init(&spam_module);\n" "}" msgstr "" @@ -539,23 +628,19 @@ msgid "" msgstr "" 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 " -"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 " -"module definition. :c:func:`PyModule_Create` returns a pointer to the module " -"object that it creates. It may abort with a fatal error for certain errors, " -"or return ``NULL`` if the module could not be initialized satisfactorily. " -"The init function must return the module object to its caller, so that it " -"then gets inserted into ``sys.modules``." +":c:func:`!PyInit_spam` is called when each interpreter imports its " +"module :mod:`!spam` for the first time. (See below for comments about " +"embedding Python.) A pointer to the module definition must be returned " +"via :c:func:`PyModuleDef_Init`, so that the import machinery can create the " +"module and store it in ``sys.modules``." msgstr "" msgid "" "When embedding Python, the :c:func:`!PyInit_spam` function is not called " "automatically unless there's an entry in the :c:data:`PyImport_Inittab` " -"table. To add the module to the initialization table, use :c:func:" -"`PyImport_AppendInittab`, optionally followed by an import of the module::" +"table. To add the module to the initialization table, " +"use :c:func:`PyImport_AppendInittab`, optionally followed by an import of " +"the module::" msgstr "" msgid "" @@ -611,28 +696,21 @@ msgid "" msgstr "" msgid "" -"Removing entries from ``sys.modules`` or importing compiled modules into " +"If you declare a global variable or a local static one, the module may " +"experience unintended side-effects on re-initialisation, for example when " +"removing entries from ``sys.modules`` or importing compiled modules into " "multiple interpreters within a process (or following a :c:func:`fork` " -"without an intervening :c:func:`exec`) can create problems for some " -"extension modules. Extension module authors should exercise caution when " -"initializing internal data structures." +"without an intervening :c:func:`exec`). If module state is not yet " +"fully :ref:`isolated `, authors should consider " +"marking the module as having no support for subinterpreters " +"(via :c:macro:`Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED`)." msgstr "" msgid "" "A more substantial example module is included in the Python source " -"distribution as :file:`Modules/xxmodule.c`. This file may be used as a " +"distribution as :file:`Modules/xxlimited.c`. This file may be used as a " "template or simply read as an example." msgstr "" -"Bardziej konkretny przykład modułu jest załączony w dystrybucji źródeł " -"języka pytonowskiego jako plik :file:`Modules/xxmodule.c`. Ten plik może być " -"użyty jako wzór lub po prostu czytany jako przykład." - -msgid "" -"Unlike our ``spam`` example, ``xxmodule`` uses *multi-phase initialization* " -"(new in Python 3.5), where a PyModuleDef structure is returned from " -"``PyInit_spam``, and creation of the module is left to the import machinery. " -"For details on multi-phase initialization, see :PEP:`489`." -msgstr "" msgid "Compilation and Linkage" msgstr "Kompilacja i łączenie" @@ -641,9 +719,10 @@ msgid "" "There are two more things to do before you can use your new extension: " "compiling and linking it with the Python system. If you use dynamic " "loading, the details may depend on the style of dynamic loading your system " -"uses; see the chapters about building extension modules (chapter :ref:" -"`building`) and additional information that pertains only to building on " -"Windows (chapter :ref:`building-on-windows`) for more information about this." +"uses; see the chapters about building extension modules " +"(chapter :ref:`building`) and additional information that pertains only to " +"building on Windows (chapter :ref:`building-on-windows`) for more " +"information about this." msgstr "" "Są jeszcze dwie rzeczy które trzeba zrobić zanim będzie można użyć nowego " "rozszerzenia: skompilowanie go i podłączenie z systemem Pythona. Jeśli " @@ -672,12 +751,12 @@ msgid "" "running ':program:`make` Makefile'. (This is necessary each time you change " "the :file:`Setup` file.)" msgstr "" -"i przebuduj program interpretujący przez uruchomienie programu :program:" -"`make` w katalogu głównym instalacji. Możesz także uruchomić program :" -"program:`make` w podkatalogu :file:`Modules/`, ale wtedy musisz najpierw " -"przebudować plik :file:`Makefile` tam przez uruchomienie programu :program:" -"`make` Makefile'. To jest konieczne za każdym razem gdy zmieniasz plik :file:" -"`Setup`.)" +"i przebuduj program interpretujący przez uruchomienie " +"programu :program:`make` w katalogu głównym instalacji. Możesz także " +"uruchomić program :program:`make` w podkatalogu :file:`Modules/`, ale wtedy " +"musisz najpierw przebudować plik :file:`Makefile` tam przez uruchomienie " +"programu :program:`make` Makefile'. To jest konieczne za każdym razem gdy " +"zmieniasz plik :file:`Setup`.)" msgid "" "If your module requires additional libraries to link with, these can be " @@ -711,18 +790,10 @@ msgstr "" msgid "" "Fortunately, the Python interpreter is easily called recursively, and there " -"is a standard interface to call a Python function. (I won't dwell on how to " -"call the Python parser with a particular string as input --- if you're " -"interested, have a look at the implementation of the :option:`-c` command " -"line option in :file:`Modules/main.c` from the Python source code.)" +"is a standard interface to call a Python function. (If you're interested in " +"how to call the Python parser with a particular string as input, " +"see :ref:`veryhigh`.)" msgstr "" -"Szczęśliwie, program interpretujący polecenia języka pytonowskiego jest " -"łatwo wywoływany rekursywnie i istnieje standardowy sprzęg aby wywołać " -"zadanie języka pytonowskiego. (Nie będę rozpisywał się o tym jak wywołać " -"czytnik języka pytonowskiego z konkretnym ciągiem znaków na wejściu --- " -"jeśli jesteś zainteresowany, spójrz na wypełnienie opcji :option:`-c` " -"wiersza polecenia w :file:`Modules/main.c` z kodu źródłowego języka " -"pytonowskiego.)" msgid "" "Calling a Python function is easy. First, the Python program must somehow " @@ -760,10 +831,10 @@ msgid "" msgstr "" msgid "" -"This function must be registered with the interpreter using the :c:macro:" -"`METH_VARARGS` flag; this is described in section :ref:`methodtable`. The :" -"c:func:`PyArg_ParseTuple` function and its arguments are documented in " -"section :ref:`parsetuple`." +"This function must be registered with the interpreter using " +"the :c:macro:`METH_VARARGS` flag; this is described in " +"section :ref:`methodtable`. The :c:func:`PyArg_ParseTuple` function and its " +"arguments are documented in section :ref:`parsetuple`." msgstr "" msgid "" @@ -774,14 +845,15 @@ msgid "" msgstr "" msgid "" -"Later, when it is time to call the function, you call the C function :c:func:" -"`PyObject_CallObject`. This function has two arguments, both pointers to " -"arbitrary Python objects: the Python function, and the argument list. The " -"argument list must always be a tuple object, whose length is the number of " -"arguments. To call the Python function with no arguments, pass in ``NULL``, " -"or an empty tuple; to call it with one argument, pass a singleton tuple. :c:" -"func:`Py_BuildValue` returns a tuple when its format string consists of zero " -"or more format codes between parentheses. For example::" +"Later, when it is time to call the function, you call the C " +"function :c:func:`PyObject_CallObject`. This function has two arguments, " +"both pointers to arbitrary Python objects: the Python function, and the " +"argument list. The argument list must always be a tuple object, whose " +"length is the number of arguments. To call the Python function with no " +"arguments, pass in ``NULL``, or an empty tuple; to call it with one " +"argument, pass a singleton tuple. :c:func:`Py_BuildValue` returns a tuple " +"when its format string consists of zero or more format codes between " +"parentheses. For example::" msgstr "" msgid "" @@ -801,8 +873,9 @@ msgid "" ":c:func:`PyObject_CallObject` returns a Python object pointer: this is the " "return value of the Python function. :c:func:`PyObject_CallObject` is " "\"reference-count-neutral\" with respect to its arguments. In the example a " -"new tuple was created to serve as the argument list, which is :c:func:" -"`Py_DECREF`\\ -ed immediately after the :c:func:`PyObject_CallObject` call." +"new tuple was created to serve as the argument list, which " +"is :c:func:`Py_DECREF`\\ -ed immediately after " +"the :c:func:`PyObject_CallObject` call." msgstr "" msgid "" @@ -861,9 +934,10 @@ msgid "" msgstr "" msgid "" -"You may also call a function with keyword arguments by using :c:func:" -"`PyObject_Call`, which supports arguments and keyword arguments. As in the " -"above example, we use :c:func:`Py_BuildValue` to construct the dictionary. ::" +"You may also call a function with keyword arguments by " +"using :c:func:`PyObject_Call`, which supports arguments and keyword " +"arguments. As in the above example, we use :c:func:`Py_BuildValue` to " +"construct the dictionary. ::" msgstr "" msgid "" @@ -994,20 +1068,20 @@ msgid "" msgstr "" msgid "" -"The *arg* and *format* parameters are identical to those of the :c:func:" -"`PyArg_ParseTuple` function. The *kwdict* parameter is the dictionary of " -"keywords received as the third parameter from the Python runtime. The " -"*kwlist* parameter is a ``NULL``-terminated list of strings which identify " -"the parameters; the names are matched with the type information from " -"*format* from left to right. On success, :c:func:" -"`PyArg_ParseTupleAndKeywords` returns true, otherwise it returns false and " -"raises an appropriate exception." +"The *arg* and *format* parameters are identical to those of " +"the :c:func:`PyArg_ParseTuple` function. The *kwdict* parameter is the " +"dictionary of keywords received as the third parameter from the Python " +"runtime. The *kwlist* parameter is a ``NULL``-terminated list of strings " +"which identify the parameters; the names are matched with the type " +"information from *format* from left to right. On " +"success, :c:func:`PyArg_ParseTupleAndKeywords` returns true, otherwise it " +"returns false and raises an appropriate exception." msgstr "" msgid "" "Nested tuples cannot be parsed when using keyword arguments! Keyword " -"parameters passed in which are not present in the *kwlist* will cause :exc:" -"`TypeError` to be raised." +"parameters passed in which are not present in the *kwlist* will " +"cause :exc:`TypeError` to be raised." msgstr "" "Zagnieżdźone krotki nie mogą być wczytane gdy używane są parametry słów " "kluczowych! Parametry słów kluczowych przekazane do zadania które nie są " @@ -1059,18 +1133,17 @@ msgid "" " {NULL, NULL, 0, NULL} /* sentinel */\n" "};\n" "\n" -"static struct PyModuleDef keywdargmodule = {\n" -" PyModuleDef_HEAD_INIT,\n" -" \"keywdarg\",\n" -" NULL,\n" -" -1,\n" -" keywdarg_methods\n" +"static struct PyModuleDef keywdarg_module = {\n" +" .m_base = PyModuleDef_HEAD_INIT,\n" +" .m_name = \"keywdarg\",\n" +" .m_size = 0,\n" +" .m_methods = keywdarg_methods,\n" "};\n" "\n" "PyMODINIT_FUNC\n" "PyInit_keywdarg(void)\n" "{\n" -" return PyModule_Create(&keywdargmodule);\n" +" return PyModuleDef_Init(&keywdarg_module);\n" "}" msgstr "" @@ -1086,10 +1159,10 @@ msgid "PyObject *Py_BuildValue(const char *format, ...);" msgstr "" msgid "" -"It recognizes a set of format units similar to the ones recognized by :c:" -"func:`PyArg_ParseTuple`, but the arguments (which are input to the function, " -"not output) must not be pointers, just values. It returns a new Python " -"object, suitable for returning from a C function called from Python." +"It recognizes a set of format units similar to the ones recognized " +"by :c:func:`PyArg_ParseTuple`, but the arguments (which are input to the " +"function, not output) must not be pointers, just values. It returns a new " +"Python object, suitable for returning from a C function called from Python." msgstr "" msgid "" @@ -1140,16 +1213,16 @@ msgstr "" msgid "" "Every block of memory allocated with :c:func:`malloc` should eventually be " -"returned to the pool of available memory by exactly one call to :c:func:" -"`free`. It is important to call :c:func:`free` at the right time. If a " -"block's address is forgotten but :c:func:`free` is not called for it, the " -"memory it occupies cannot be reused until the program terminates. This is " -"called a :dfn:`memory leak`. On the other hand, if a program calls :c:func:" -"`free` for a block and then continues to use the block, it creates a " -"conflict with reuse of the block through another :c:func:`malloc` call. " -"This is called :dfn:`using freed memory`. It has the same bad consequences " -"as referencing uninitialized data --- core dumps, wrong results, mysterious " -"crashes." +"returned to the pool of available memory by exactly one call " +"to :c:func:`free`. It is important to call :c:func:`free` at the right " +"time. If a block's address is forgotten but :c:func:`free` is not called " +"for it, the memory it occupies cannot be reused until the program " +"terminates. This is called a :dfn:`memory leak`. On the other hand, if a " +"program calls :c:func:`free` for a block and then continues to use the " +"block, it creates a conflict with reuse of the block through " +"another :c:func:`malloc` call. This is called :dfn:`using freed memory`. It " +"has the same bad consequences as referencing uninitialized data --- core " +"dumps, wrong results, mysterious crashes." msgstr "" msgid "" @@ -1195,7 +1268,7 @@ msgstr "" msgid "" "An alternative strategy is called :dfn:`automatic garbage collection`. " "(Sometimes, reference counting is also referred to as a garbage collection " -"strategy, hence my use of \"automatic\" to distinguish the two.) The big " +"strategy, hence the use of \"automatic\" to distinguish the two.) The big " "advantage of automatic garbage collection is that the user doesn't need to " "call :c:func:`free` explicitly. (Another claimed advantage is an " "improvement in speed or memory usage --- this is no hard fact however.) The " @@ -1233,9 +1306,9 @@ msgstr "" msgid "" "The cycle detector is able to detect garbage cycles and can reclaim them. " -"The :mod:`gc` module exposes a way to run the detector (the :func:`~gc." -"collect` function), as well as configuration interfaces and the ability to " -"disable the detector at runtime." +"The :mod:`gc` module exposes a way to run the detector " +"(the :func:`~gc.collect` function), as well as configuration interfaces and " +"the ability to disable the detector at runtime." msgstr "" msgid "Reference Counting in Python" @@ -1243,12 +1316,12 @@ msgstr "Zliczanie odniesień w języku pytonowskim" msgid "" "There are two macros, ``Py_INCREF(x)`` and ``Py_DECREF(x)``, which handle " -"the incrementing and decrementing of the reference count. :c:func:" -"`Py_DECREF` also frees the object when the count reaches zero. For " -"flexibility, it doesn't call :c:func:`free` directly --- rather, it makes a " -"call through a function pointer in the object's :dfn:`type object`. For " -"this purpose (and others), every object also contains a pointer to its type " -"object." +"the incrementing and decrementing of the reference " +"count. :c:func:`Py_DECREF` also frees the object when the count reaches " +"zero. For flexibility, it doesn't call :c:func:`free` directly --- rather, " +"it makes a call through a function pointer in the object's :dfn:`type " +"object`. For this purpose (and others), every object also contains a " +"pointer to its type object." msgstr "" msgid "" @@ -1290,11 +1363,11 @@ msgstr "" "pozbył się go." msgid "" -"A borrowed reference can be changed into an owned reference by calling :c:" -"func:`Py_INCREF`. This does not affect the status of the owner from which " -"the reference was borrowed --- it creates a new owned reference, and gives " -"full owner responsibilities (the new owner must dispose of the reference " -"properly, as well as the previous owner)." +"A borrowed reference can be changed into an owned reference by " +"calling :c:func:`Py_INCREF`. This does not affect the status of the owner " +"from which the reference was borrowed --- it creates a new owned reference, " +"and gives full owner responsibilities (the new owner must dispose of the " +"reference properly, as well as the previous owner)." msgstr "" msgid "Ownership Rules" @@ -1314,19 +1387,19 @@ msgid "" "the reference. In particular, all functions whose function it is to create " "a new object, such as :c:func:`PyLong_FromLong` and :c:func:`Py_BuildValue`, " "pass ownership to the receiver. Even if the object is not actually new, you " -"still receive ownership of a new reference to that object. For instance, :c:" -"func:`PyLong_FromLong` maintains a cache of popular values and can return a " -"reference to a cached item." +"still receive ownership of a new reference to that object. For " +"instance, :c:func:`PyLong_FromLong` maintains a cache of popular values and " +"can return a reference to a cached item." msgstr "" msgid "" "Many functions that extract objects from other objects also transfer " -"ownership with the reference, for instance :c:func:" -"`PyObject_GetAttrString`. The picture is less clear, here, however, since a " -"few common routines are exceptions: :c:func:`PyTuple_GetItem`, :c:func:" -"`PyList_GetItem`, :c:func:`PyDict_GetItem`, and :c:func:" -"`PyDict_GetItemString` all return references that you borrow from the tuple, " -"list or dictionary." +"ownership with the reference, for " +"instance :c:func:`PyObject_GetAttrString`. The picture is less clear, here, " +"however, since a few common routines are " +"exceptions: :c:func:`PyTuple_GetItem`, :c:func:`PyList_GetItem`, :c:func:`PyDict_GetItem`, " +"and :c:func:`PyDict_GetItemString` all return references that you borrow " +"from the tuple, list or dictionary." msgstr "" msgid "" @@ -1339,10 +1412,11 @@ msgid "" "When you pass an object reference into another function, in general, the " "function borrows the reference from you --- if it needs to store it, it will " "use :c:func:`Py_INCREF` to become an independent owner. There are exactly " -"two important exceptions to this rule: :c:func:`PyTuple_SetItem` and :c:func:" -"`PyList_SetItem`. These functions take over ownership of the item passed to " -"them --- even if they fail! (Note that :c:func:`PyDict_SetItem` and friends " -"don't take over ownership --- they are \"normal.\")" +"two important exceptions to this rule: :c:func:`PyTuple_SetItem` " +"and :c:func:`PyList_SetItem`. These functions take over ownership of the " +"item passed to them --- even if they fail! (Note " +"that :c:func:`PyDict_SetItem` and friends don't take over ownership --- they " +"are \"normal.\")" msgstr "" msgid "" @@ -1409,7 +1483,14 @@ msgid "" "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." +"count of 1, disposing of it will call its :meth:`!__del__` method. " +"Internally, :c:func:`PyList_SetItem` calls :c:func:`Py_DECREF` on the " +"replaced item, which invokes replaced item's " +"corresponding :c:member:`~PyTypeObject.tp_dealloc` function. During " +"deallocation, :c:member:`~PyTypeObject.tp_dealloc` " +"calls :c:member:`~PyTypeObject.tp_finalize`, which is mapped to the :meth:`!" +"__del__` method for class instances (see :pep:`442`). This entire sequence " +"happens synchronously within the :c:func:`PyList_SetItem` call." msgstr "" msgid "" @@ -1451,9 +1532,10 @@ msgstr "" msgid "" "The second case of problems with a borrowed reference is a variant involving " "threads. Normally, multiple threads in the Python interpreter can't get in " -"each other's way, because there is a global lock protecting Python's entire " -"object space. However, it is possible to temporarily release this lock " -"using the macro :c:macro:`Py_BEGIN_ALLOW_THREADS`, and to re-acquire it " +"each other's way, because there is a :term:`global lock ` protecting Python's entire object space. However, it is possible to " +"temporarily release this lock using the " +"macro :c:macro:`Py_BEGIN_ALLOW_THREADS`, and to re-acquire it " "using :c:macro:`Py_END_ALLOW_THREADS`. This is common around blocking I/O " "calls, to let other threads use the processor while waiting for the I/O to " "complete. Obviously, the following function has the same problem as the " @@ -1494,8 +1576,8 @@ msgstr "" msgid "" "The macros :c:func:`Py_INCREF` and :c:func:`Py_DECREF` do not check for " -"``NULL`` pointers --- however, their variants :c:func:`Py_XINCREF` and :c:" -"func:`Py_XDECREF` do." +"``NULL`` pointers --- however, their variants :c:func:`Py_XINCREF` " +"and :c:func:`Py_XDECREF` do." msgstr "" msgid "" @@ -1732,27 +1814,18 @@ msgstr "" msgid "" "The ``#define`` is used to tell the header file that it is being included in " -"the exporting module, not a client module. Finally, the module's " -"initialization function must take care of initializing the C API pointer " -"array::" +"the exporting module, not a client module. Finally, the " +"module's :c:data:`mod_exec ` function must take care of " +"initializing the C API pointer array::" msgstr "" -"``#define`` jest używane aby przekazać plikowi nagłówkowemu że jest " -"załączany w module wystawianym na zewnątrz, nie w module któremu wszystko " -"służy. Ostatecznie zadanie inicjowania musi zadbać o zainicjowanie tabeli " -"wskaźników sprzęgu programowania aplikacji języka C." msgid "" -"PyMODINIT_FUNC\n" -"PyInit_spam(void)\n" +"static int\n" +"spam_module_exec(PyObject *m)\n" "{\n" -" PyObject *m;\n" " static void *PySpam_API[PySpam_API_pointers];\n" " PyObject *c_api_object;\n" "\n" -" m = PyModule_Create(&spammodule);\n" -" if (m == NULL)\n" -" return NULL;\n" -"\n" " /* Initialize the C API pointer array */\n" " PySpam_API[PySpam_System_NUM] = (void *)PySpam_System;\n" "\n" @@ -1761,11 +1834,10 @@ msgid "" "NULL);\n" "\n" " if (PyModule_Add(m, \"_C_API\", c_api_object) < 0) {\n" -" Py_DECREF(m);\n" -" return NULL;\n" +" return -1;\n" " }\n" "\n" -" return m;\n" +" return 0;\n" "}" msgstr "" @@ -1778,8 +1850,8 @@ msgid "" "The bulk of the work is in the header file :file:`spammodule.h`, which looks " "like this::" msgstr "" -"Większa część pracy jest wykonywana w pliku nagłówkowym :file:`spammodule." -"h`, który wygląda następująco::" +"Większa część pracy jest wykonywana w pliku " +"nagłówkowym :file:`spammodule.h`, który wygląda następująco::" msgid "" "#ifndef Py_SPAMMODULE_H\n" @@ -1833,24 +1905,21 @@ msgid "" msgstr "" msgid "" -"All that a client module must do in order to have access to the function :c:" -"func:`!PySpam_System` is to call the function (or rather macro) :c:func:`!" -"import_spam` in its initialization function::" +"All that a client module must do in order to have access to the " +"function :c:func:`!PySpam_System` is to call the function (or rather " +"macro) :c:func:`!import_spam` in its :c:data:`mod_exec ` " +"function::" msgstr "" msgid "" -"PyMODINIT_FUNC\n" -"PyInit_client(void)\n" +"static int\n" +"client_module_exec(PyObject *m)\n" "{\n" -" PyObject *m;\n" -"\n" -" m = PyModule_Create(&clientmodule);\n" -" if (m == NULL)\n" -" return NULL;\n" -" if (import_spam() < 0)\n" -" return NULL;\n" +" if (import_spam() < 0) {\n" +" return -1;\n" +" }\n" " /* additional initialization can happen here */\n" -" return m;\n" +" return 0;\n" "}" msgstr "" @@ -1869,22 +1938,16 @@ msgid "" "which is especially useful for memory allocation and deallocation of the " "pointer stored in a Capsule. The details are described in the Python/C API " "Reference Manual in the section :ref:`capsules` and in the implementation of " -"Capsules (files :file:`Include/pycapsule.h` and :file:`Objects/pycapsule.c` " -"in the Python source code distribution)." +"Capsules (files :file:`Include/pycapsule.h` and :file:`Objects/capsule.c` in " +"the Python source code distribution)." msgstr "" -"Ostatecznie warto wspomnieć, że kapsuły dają dodatkowe możliwości działania, " -"które są szczególnie użyteczne dla umieszczania i zabierania miejsca w " -"pamięci wskaźników zachowywanych w kapsule. Szczegóły są opisane w " -"podręczniku użytkownika API Python/C w rozdziale :ref:`capsules` i w " -"wypełnieniu programowym kapsuł (plików :file:`Include/pycapsule.h` i :file:" -"`Objects/pycapsule.c` w dystrybucji źródłowej kodu Pythona)." msgid "Footnotes" msgstr "Przypisy" msgid "" -"An interface for this function already exists in the standard module :mod:" -"`os` --- it was chosen as a simple and straightforward example." +"An interface for this function already exists in the standard " +"module :mod:`os` --- it was chosen as a simple and straightforward example." msgstr "" "sprzęg dla tego zadania już istnieje w standardowym module :mod:`os` --- " "został on wybrany jako prosty i przejrzysty przykład." diff --git a/extending/index.po b/extending/index.po index c67d77576a..49d7636a16 100644 --- a/extending/index.po +++ b/extending/index.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,21 +44,17 @@ msgstr "" "dany system operacyjny wspiera tą funkcję." msgid "" -"This document assumes basic knowledge about Python. For an informal " -"introduction to the language, see :ref:`tutorial-index`. :ref:`reference-" -"index` gives a more formal definition of the language. :ref:`library-index` " -"documents the existing object types, functions and modules (both built-in " -"and written in Python) that give the language its wide application range." +"This document assumes basic knowledge about C and Python. For an informal " +"introduction to Python, see :ref:`tutorial-index`. :ref:`reference-index` " +"gives a more formal definition of the language. :ref:`builtins-index` " +"documents the built-in functions and object types, and :ref:`library-index` " +"documents the modules (both built-in and written in Python) that give the " +"language its wide application range." msgstr "" -"Ten dokument zawiera podstawową wiedzę o Pythonie. Z nieformalnym wstępem do " -"języka zapoznaj się z :ref:`tutorial-index`. :ref:`reference-index` zawiera " -"bardziej formalny opis języka. Dokumenty :ref:`library-index` zawierają " -"istniejące typy obiektów, funkcje i moduły (zarówno wbudowane jak i napisane " -"w Pythonie) dające językowi duże pole zastosowań." msgid "" -"For a detailed description of the whole Python/C API, see the separate :ref:" -"`c-api-index`." +"For a detailed description of the whole Python/C API, see the " +"separate :ref:`c-api-index`." msgstr "" "Aby zapoznać się z dokładną instrukcją dla Python/C API, spójrz na :ref:`c-" "api-index`." @@ -70,34 +64,10 @@ msgstr "Rekomendowane zewnętrzne narzędzia." msgid "" "This guide only covers the basic tools for creating extensions provided as " -"part of this version of CPython. Third party tools like `Cython `_, `cffi `_, `SWIG `_ and `Numba `_ offer both simpler and " -"more sophisticated approaches to creating C and C++ extensions for Python." +"part of this version of CPython. Some :ref:`third party tools ` " +"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 `_" -msgstr "" -"Pakiety Pythona Podręcznik Użytkownika: Rozszerzenia Binarne\n" -", YEAR. # # Translators: -# haaritsubaki, 2023 -# Maciej Olko , 2024 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -159,9 +157,9 @@ msgstr "" msgid "" "These fields tell the runtime how much memory to allocate when new objects " "of this type are created. Python has some built-in support for variable " -"length structures (think: strings, tuples) which is where the :c:member:" -"`~PyTypeObject.tp_itemsize` field comes in. This will be dealt with " -"later. ::" +"length structures (think: strings, tuples) which is where " +"the :c:member:`~PyTypeObject.tp_itemsize` field comes in. This will be " +"dealt with later. ::" msgstr "" msgid "const char *tp_doc;" @@ -204,8 +202,8 @@ msgid "" msgstr "" msgid "" -"If your type supports garbage collection, the destructor should call :c:func:" -"`PyObject_GC_UnTrack` before clearing any member fields::" +"If your type supports garbage collection, the destructor should " +"call :c:func:`PyObject_GC_UnTrack` before clearing any member fields::" msgstr "" msgid "" @@ -229,8 +227,8 @@ msgid "" "additional Python code to be executed may detect that an exception has been " "set. This can lead to misleading errors from the interpreter. The proper " "way to protect against this is to save a pending exception before performing " -"the unsafe action, and restoring it when done. This can be done using the :" -"c:func:`PyErr_Fetch` and :c:func:`PyErr_Restore` functions::" +"the unsafe action, and restoring it when done. This can be done using " +"the :c:func:`PyErr_Fetch` and :c:func:`PyErr_Restore` functions::" msgstr "" msgid "" @@ -263,14 +261,16 @@ msgstr "" msgid "" "There are limitations to what you can safely do in a deallocator function. " -"First, if your type supports garbage collection (using :c:member:" -"`~PyTypeObject.tp_traverse` and/or :c:member:`~PyTypeObject.tp_clear`), some " -"of the object's members can have been cleared or finalized by the time :c:" -"member:`~PyTypeObject.tp_dealloc` is called. Second, in :c:member:" -"`~PyTypeObject.tp_dealloc`, your object is in an unstable state: its " -"reference count is equal to zero. Any call to a non-trivial object or API " -"(as in the example above) might end up calling :c:member:`~PyTypeObject." -"tp_dealloc` again, causing a double free and a crash." +"First, if your type supports garbage collection " +"(using :c:member:`~PyTypeObject.tp_traverse` and/" +"or :c:member:`~PyTypeObject.tp_clear`), some of the object's members can " +"have been cleared or finalized by the " +"time :c:member:`~PyTypeObject.tp_dealloc` is called. Second, " +"in :c:member:`~PyTypeObject.tp_dealloc`, your object is in an unstable " +"state: its reference count is equal to zero. Any call to a non-trivial " +"object or API (as in the example above) might end up " +"calling :c:member:`~PyTypeObject.tp_dealloc` again, causing a double free " +"and a crash." msgstr "" msgid "" @@ -287,13 +287,14 @@ msgstr "Prezentacja Przedmiotów" msgid "" "In Python, there are two ways to generate a textual representation of an " -"object: the :func:`repr` function, and the :func:`str` function. (The :func:" -"`print` function just calls :func:`str`.) These handlers are both optional." +"object: the :func:`repr` function, and the :func:`str` function. " +"(The :func:`print` function just calls :func:`str`.) These handlers are " +"both optional." msgstr "" "W Pythonie istnieją dwa sposoby aby wygenerować tekstową reprezentację " -"przedmiotu: funkcja :func:`repr`, i funkcja :func:`str`. (Zadanie :func:" -"`print` po prostu wywołuje zadanie :func:`str`.) Ta zadania obsługi są oba " -"opcjonalne." +"przedmiotu: funkcja :func:`repr`, i funkcja :func:`str`. " +"(Zadanie :func:`print` po prostu wywołuje zadanie :func:`str`.) Ta zadania " +"obsługi są oba opcjonalne." msgid "" "reprfunc tp_repr;\n" @@ -317,18 +318,19 @@ msgstr "" msgid "" "If no :c:member:`~PyTypeObject.tp_repr` handler is specified, the " -"interpreter will supply a representation that uses the type's :c:member:" -"`~PyTypeObject.tp_name` and a uniquely identifying value for the object." +"interpreter will supply a representation that uses the " +"type's :c:member:`~PyTypeObject.tp_name` and a uniquely identifying value " +"for the object." msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_str` handler is to :func:`str` what the :c:" -"member:`~PyTypeObject.tp_repr` handler described above is to :func:`repr`; " -"that is, it is called when Python code calls :func:`str` on an instance of " -"your object. Its implementation is very similar to the :c:member:" -"`~PyTypeObject.tp_repr` function, but the resulting string is intended for " -"human consumption. If :c:member:`~PyTypeObject.tp_str` is not specified, " -"the :c:member:`~PyTypeObject.tp_repr` handler is used instead." +"The :c:member:`~PyTypeObject.tp_str` handler is to :func:`str` what " +"the :c:member:`~PyTypeObject.tp_repr` handler described above is " +"to :func:`repr`; that is, it is called when Python code calls :func:`str` on " +"an instance of your object. Its implementation is very similar to " +"the :c:member:`~PyTypeObject.tp_repr` function, but the resulting string is " +"intended for human consumption. If :c:member:`~PyTypeObject.tp_str` is not " +"specified, the :c:member:`~PyTypeObject.tp_repr` handler is used instead." msgstr "" msgid "Here is a simple example::" @@ -358,9 +360,10 @@ msgstr "" msgid "" "Python supports two pairs of attribute handlers; a type that supports " "attributes only needs to implement the functions for one pair. The " -"difference is that one pair takes the name of the attribute as a :c:expr:" -"`char\\*`, while the other accepts a :c:expr:`PyObject*`. Each type can use " -"whichever pair makes more sense for the implementation's convenience. ::" +"difference is that one pair takes the name of the attribute as " +"a :c:expr:`char\\*`, while the other accepts a :c:expr:`PyObject*`. Each " +"type can use whichever pair makes more sense for the implementation's " +"convenience. ::" msgstr "" msgid "" @@ -419,9 +422,10 @@ msgid "" "dictionary of the type object. Each descriptor controls access to one " "attribute of the instance object. Each of the tables is optional; if all " "three are ``NULL``, instances of the type will only have attributes that are " -"inherited from their base type, and should leave the :c:member:" -"`~PyTypeObject.tp_getattro` and :c:member:`~PyTypeObject.tp_setattro` fields " -"``NULL`` as well, allowing the base type to handle attributes." +"inherited from their base type, and should leave " +"the :c:member:`~PyTypeObject.tp_getattro` " +"and :c:member:`~PyTypeObject.tp_setattro` fields ``NULL`` as well, allowing " +"the base type to handle attributes." msgstr "" msgid "The tables are declared as three fields of the type object::" @@ -451,8 +455,8 @@ msgstr "" msgid "" "One entry should be defined for each method provided by the type; no entries " "are needed for methods inherited from a base type. One additional entry is " -"needed at the end; it is a sentinel that marks the end of the array. The :c:" -"member:`~PyMethodDef.ml_name` field of the sentinel must be ``NULL``." +"needed at the end; it is a sentinel that marks the end of the array. " +"The :c:member:`~PyMethodDef.ml_name` field of the sentinel must be ``NULL``." msgstr "" msgid "" @@ -481,10 +485,10 @@ msgid "" "added to the type which will be able to extract a value from the instance " "structure. The :c:member:`~PyMemberDef.type` field should contain a type " "code like :c:macro:`Py_T_INT` or :c:macro:`Py_T_DOUBLE`; the value will be " -"used to determine how to convert Python values to and from C values. The :c:" -"member:`~PyMemberDef.flags` field is used to store flags which control how " -"the attribute can be accessed: you can set it to :c:macro:`Py_READONLY` to " -"prevent Python code from setting it." +"used to determine how to convert Python values to and from C values. " +"The :c:member:`~PyMemberDef.flags` field is used to store flags which " +"control how the attribute can be accessed: you can set it " +"to :c:macro:`Py_READONLY` to prevent Python code from setting it." msgstr "" msgid "" @@ -492,8 +496,8 @@ msgid "" "table to build descriptors that are used at runtime is that any attribute " "defined this way can have an associated doc string simply by providing the " "text in the table. An application can use the introspection API to retrieve " -"the descriptor from the class object, and get the doc string using its :attr:" -"`~type.__doc__` attribute." +"the descriptor from the class object, and get the doc string using " +"its :attr:`~type.__doc__` attribute." msgstr "" msgid "" @@ -506,8 +510,8 @@ msgstr "Szczególne-dla-typu-przedmiotu zarządzanie właściwościami" msgid "" "For simplicity, only the :c:expr:`char\\*` version will be demonstrated " -"here; the type of the name parameter is the only difference between the :c:" -"expr:`char\\*` and :c:expr:`PyObject*` flavors of the interface. This " +"here; the type of the name parameter is the only difference between " +"the :c:expr:`char\\*` and :c:expr:`PyObject*` flavors of the interface. This " "example effectively does the same thing as the generic example above, but " "does not use the generic support added in Python 2.2. It explains how the " "handler functions are called, so that if you do need to extend their " @@ -540,12 +544,13 @@ msgid "" msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_setattr` handler is called when the :meth:" -"`~object.__setattr__` or :meth:`~object.__delattr__` method of a class " -"instance would be called. When an attribute should be deleted, the third " -"parameter will be ``NULL``. Here is an example that simply raises an " -"exception; if this were really all you wanted, the :c:member:`~PyTypeObject." -"tp_setattr` handler should be set to ``NULL``. ::" +"The :c:member:`~PyTypeObject.tp_setattr` handler is called when " +"the :meth:`~object.__setattr__` or :meth:`~object.__delattr__` method of a " +"class instance would be called. When an attribute should be deleted, the " +"third parameter will be ``NULL``. Here is an example that simply raises an " +"exception; if this were really all you wanted, " +"the :c:member:`~PyTypeObject.tp_setattr` handler should be set to " +"``NULL``. ::" msgstr "" msgid "" @@ -566,8 +571,8 @@ msgstr "" msgid "" "The :c:member:`~PyTypeObject.tp_richcompare` handler is called when " "comparisons are needed. It is analogous to the :ref:`rich comparison " -"methods `, like :meth:`!__lt__`, and also called by :c:func:" -"`PyObject_RichCompare` and :c:func:`PyObject_RichCompareBool`." +"methods `, like :meth:`!__lt__`, and also called " +"by :c:func:`PyObject_RichCompare` and :c:func:`PyObject_RichCompareBool`." msgstr "" msgid "" @@ -648,8 +653,8 @@ msgstr "" msgid "" "If you wish your object to be able to act like a number, a sequence, or a " "mapping object, then you place the address of a structure that implements " -"the C type :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, or :c:" -"type:`PyMappingMethods`, respectively. It is up to you to fill in this " +"the C type :c:type:`PyNumberMethods`, :c:type:`PySequenceMethods`, " +"or :c:type:`PyMappingMethods`, respectively. It is up to you to fill in this " "structure with appropriate values. You can find examples of the use of each " "of these in the :file:`Objects` directory of the Python source " "distribution. ::" @@ -701,16 +706,17 @@ msgid "" msgstr "" msgid "" -"*args* is a tuple containing the arguments to the call. You can use :c:func:" -"`PyArg_ParseTuple` to extract the arguments." +"*args* is a tuple containing the arguments to the call. You can " +"use :c:func:`PyArg_ParseTuple` to extract the arguments." msgstr "" msgid "" "*kwds* is a dictionary of keyword arguments that were passed. If this is non-" -"``NULL`` and you support keyword arguments, use :c:func:" -"`PyArg_ParseTupleAndKeywords` to extract the arguments. If you do not want " -"to support keyword arguments and this is non-``NULL``, raise a :exc:" -"`TypeError` with a message saying that keyword arguments are not supported." +"``NULL`` and you support keyword arguments, " +"use :c:func:`PyArg_ParseTupleAndKeywords` to extract the arguments. If you " +"do not want to support keyword arguments and this is non-``NULL``, raise " +"a :exc:`TypeError` with a message saying that keyword arguments are not " +"supported." msgstr "" msgid "Here is a toy ``tp_call`` implementation::" @@ -747,15 +753,16 @@ msgid "" "take exactly one parameter, the instance for which they are being called, " "and return a new reference. In the case of an error, they should set an " "exception and return ``NULL``. :c:member:`~PyTypeObject.tp_iter` " -"corresponds to the Python :meth:`~object.__iter__` method, while :c:member:" -"`~PyTypeObject.tp_iternext` corresponds to the Python :meth:`~iterator." -"__next__` method." +"corresponds to the Python :meth:`~object.__iter__` method, " +"while :c:member:`~PyTypeObject.tp_iternext` corresponds to the " +"Python :meth:`~iterator.__next__` method." msgstr "" msgid "" -"Any :term:`iterable` object must implement the :c:member:`~PyTypeObject." -"tp_iter` handler, which must return an :term:`iterator` object. Here the " -"same guidelines apply as for Python classes:" +"Any :term:`iterable` object must implement " +"the :c:member:`~PyTypeObject.tp_iter` handler, which must return " +"an :term:`iterator` object. Here the same guidelines apply as for Python " +"classes:" msgstr "" msgid "" @@ -766,23 +773,26 @@ msgstr "" msgid "" "Objects which can only be iterated over once (usually due to side effects of " -"iteration, such as file objects) can implement :c:member:`~PyTypeObject." -"tp_iter` by returning a new reference to themselves -- and should also " -"therefore implement the :c:member:`~PyTypeObject.tp_iternext` handler." -msgstr "" - -msgid "" -"Any :term:`iterator` object should implement both :c:member:`~PyTypeObject." -"tp_iter` and :c:member:`~PyTypeObject.tp_iternext`. An iterator's :c:member:" -"`~PyTypeObject.tp_iter` handler should return a new reference to the " -"iterator. Its :c:member:`~PyTypeObject.tp_iternext` handler should return a " -"new reference to the next object in the iteration, if there is one. If the " -"iteration has reached the end, :c:member:`~PyTypeObject.tp_iternext` may " -"return ``NULL`` without setting an exception, or it may set :exc:" -"`StopIteration` *in addition* to returning ``NULL``; avoiding the exception " -"can yield slightly better performance. If an actual error occurs, :c:member:" -"`~PyTypeObject.tp_iternext` should always set an exception and return " -"``NULL``." +"iteration, such as file objects) can " +"implement :c:member:`~PyTypeObject.tp_iter` by returning a new reference to " +"themselves -- and should also therefore implement " +"the :c:member:`~PyTypeObject.tp_iternext` handler." +msgstr "" + +msgid "" +"Any :term:`iterator` object should implement " +"both :c:member:`~PyTypeObject.tp_iter` " +"and :c:member:`~PyTypeObject.tp_iternext`. An " +"iterator's :c:member:`~PyTypeObject.tp_iter` handler should return a new " +"reference to the iterator. Its :c:member:`~PyTypeObject.tp_iternext` " +"handler should return a new reference to the next object in the iteration, " +"if there is one. If the iteration has reached the " +"end, :c:member:`~PyTypeObject.tp_iternext` may return ``NULL`` without " +"setting an exception, or it may set :exc:`StopIteration` *in addition* to " +"returning ``NULL``; avoiding the exception can yield slightly better " +"performance. If an actual error " +"occurs, :c:member:`~PyTypeObject.tp_iternext` should always set an exception " +"and return ``NULL``." msgstr "" msgid "Weak Reference Support" diff --git a/extending/newtypes_tutorial.po b/extending/newtypes_tutorial.po index 39a20724fc..b1c3d14911 100644 --- a/extending/newtypes_tutorial.po +++ b/extending/newtypes_tutorial.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -39,14 +38,14 @@ msgid "The Basics" msgstr "" msgid "" -"The :term:`CPython` runtime sees all Python objects as variables of type :c:" -"expr:`PyObject*`, which serves as a \"base type\" for all Python objects. " -"The :c:type:`PyObject` structure itself only contains the object's :term:" -"`reference count` and a pointer to the object's \"type object\". This is " -"where the action is; the type object determines which (C) functions get " -"called by the interpreter when, for instance, an attribute gets looked up on " -"an object, a method called, or it is multiplied by another object. These C " -"functions are called \"type methods\"." +"The :term:`CPython` runtime sees all Python objects as variables of " +"type :c:expr:`PyObject*`, which serves as a \"base type\" for all Python " +"objects. The :c:type:`PyObject` structure itself only contains the " +"object's :term:`reference count` and a pointer to the object's \"type " +"object\". This is where the action is; the type object determines which (C) " +"functions get called by the interpreter when, for instance, an attribute " +"gets looked up on an object, a method called, or it is multiplied by another " +"object. These C functions are called \"type methods\"." msgstr "" msgid "" @@ -63,8 +62,8 @@ msgstr "" msgid "" "What we're showing here is the traditional way of defining *static* " "extension types. It should be adequate for most uses. The C API also " -"allows defining heap-allocated extension types using the :c:func:" -"`PyType_FromSpec` function, which isn't covered in this tutorial." +"allows defining heap-allocated extension types using " +"the :c:func:`PyType_FromSpec` function, which isn't covered in this tutorial." msgstr "" msgid "" @@ -86,31 +85,41 @@ msgid "" " .tp_new = PyType_GenericNew,\n" "};\n" "\n" -"static PyModuleDef custommodule = {\n" +"static int\n" +"custom_module_exec(PyObject *m)\n" +"{\n" +" if (PyType_Ready(&CustomType) < 0) {\n" +" return -1;\n" +" }\n" +"\n" +" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) " +"{\n" +" return -1;\n" +" }\n" +"\n" +" return 0;\n" +"}\n" +"\n" +"static PyModuleDef_Slot custom_module_slots[] = {\n" +" {Py_mod_exec, custom_module_exec},\n" +" // Just use this while using static types\n" +" {Py_mod_multiple_interpreters, " +"Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED},\n" +" {0, NULL}\n" +"};\n" +"\n" +"static PyModuleDef custom_module = {\n" " .m_base = PyModuleDef_HEAD_INIT,\n" " .m_name = \"custom\",\n" " .m_doc = \"Example module that creates an extension type.\",\n" -" .m_size = -1,\n" +" .m_size = 0,\n" +" .m_slots = custom_module_slots,\n" "};\n" "\n" "PyMODINIT_FUNC\n" "PyInit_custom(void)\n" "{\n" -" PyObject *m;\n" -" if (PyType_Ready(&CustomType) < 0)\n" -" return NULL;\n" -"\n" -" m = PyModule_Create(&custommodule);\n" -" if (m == NULL)\n" -" return NULL;\n" -"\n" -" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) " -"{\n" -" Py_DECREF(m);\n" -" return NULL;\n" -" }\n" -"\n" -" return m;\n" +" return PyModuleDef_Init(&custom_module);\n" "}\n" msgstr "" @@ -131,8 +140,10 @@ msgid "" msgstr "" msgid "" -"How to initialize the :mod:`!custom` module: this is the ``PyInit_custom`` " -"function and the associated ``custommodule`` struct." +"How to define and execute the :mod:`!custom` module: this is the " +"``PyInit_custom`` function and the associated ``custom_module`` struct for " +"defining the module, and the ``custom_module_exec`` function to set up a " +"fresh module object." msgstr "" msgid "The first bit is::" @@ -233,9 +244,10 @@ msgstr "" msgid "" "Note that the name is a dotted name that includes both the module name and " "the name of the type within the module. The module in this case is :mod:`!" -"custom` and the type is :class:`!Custom`, so we set the type name to :class:" -"`!custom.Custom`. Using the real dotted import path is important to make " -"your type compatible with the :mod:`pydoc` and :mod:`pickle` modules. ::" +"custom` and the type is :class:`!Custom`, so we set the type name " +"to :class:`!custom.Custom`. Using the real dotted import path is important " +"to make your type compatible with the :mod:`pydoc` and :mod:`pickle` " +"modules. ::" msgstr "" msgid "" @@ -244,9 +256,9 @@ msgid "" msgstr "" msgid "" -"This is so that Python knows how much memory to allocate when creating new :" -"class:`!Custom` instances. :c:member:`~PyTypeObject.tp_itemsize` is only " -"used for variable-sized objects and should otherwise be zero." +"This is so that Python knows how much memory to allocate when creating " +"new :class:`!Custom` instances. :c:member:`~PyTypeObject.tp_itemsize` is " +"only used for variable-sized objects and should otherwise be zero." msgstr "" msgid "" @@ -282,24 +294,25 @@ msgid ".tp_doc = PyDoc_STR(\"Custom objects\")," msgstr "" msgid "" -"To enable object creation, we have to provide a :c:member:`~PyTypeObject." -"tp_new` handler. This is the equivalent of the Python method :meth:`~object." -"__new__`, but has to be specified explicitly. In this case, we can just use " -"the default implementation provided by the API function :c:func:" -"`PyType_GenericNew`. ::" +"To enable object creation, we have to provide " +"a :c:member:`~PyTypeObject.tp_new` handler. This is the equivalent of the " +"Python method :meth:`~object.__new__`, but has to be specified explicitly. " +"In this case, we can just use the default implementation provided by the API " +"function :c:func:`PyType_GenericNew`. ::" msgstr "" msgid ".tp_new = PyType_GenericNew," msgstr "" msgid "" -"Everything else in the file should be familiar, except for some code in :c:" -"func:`!PyInit_custom`::" +"Everything else in the file should be familiar, except for some code " +"in :c:func:`!custom_module_exec`::" msgstr "" msgid "" -"if (PyType_Ready(&CustomType) < 0)\n" -" return;" +"if (PyType_Ready(&CustomType) < 0) {\n" +" return -1;\n" +"}" msgstr "" msgid "" @@ -310,14 +323,13 @@ msgstr "" msgid "" "if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) {\n" -" Py_DECREF(m);\n" -" return NULL;\n" +" return -1;\n" "}" msgstr "" msgid "" -"This adds the type to the module dictionary. This allows us to create :" -"class:`!Custom` instances by calling the :class:`!Custom` class:" +"This adds the type to the module dictionary. This allows us to " +"create :class:`!Custom` instances by calling the :class:`!Custom` class:" msgstr "" msgid "" @@ -485,31 +497,40 @@ msgid "" " .tp_methods = Custom_methods,\n" "};\n" "\n" -"static PyModuleDef custommodule = {\n" -" .m_base =PyModuleDef_HEAD_INIT,\n" +"static int\n" +"custom_module_exec(PyObject *m)\n" +"{\n" +" if (PyType_Ready(&CustomType) < 0) {\n" +" return -1;\n" +" }\n" +"\n" +" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) " +"{\n" +" return -1;\n" +" }\n" +"\n" +" return 0;\n" +"}\n" +"\n" +"static PyModuleDef_Slot custom_module_slots[] = {\n" +" {Py_mod_exec, custom_module_exec},\n" +" {Py_mod_multiple_interpreters, " +"Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED},\n" +" {0, NULL}\n" +"};\n" +"\n" +"static PyModuleDef custom_module = {\n" +" .m_base = PyModuleDef_HEAD_INIT,\n" " .m_name = \"custom2\",\n" " .m_doc = \"Example module that creates an extension type.\",\n" -" .m_size = -1,\n" +" .m_size = 0,\n" +" .m_slots = custom_module_slots,\n" "};\n" "\n" "PyMODINIT_FUNC\n" "PyInit_custom2(void)\n" "{\n" -" PyObject *m;\n" -" if (PyType_Ready(&CustomType) < 0)\n" -" return NULL;\n" -"\n" -" m = PyModule_Create(&custommodule);\n" -" if (m == NULL)\n" -" return NULL;\n" -"\n" -" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) " -"{\n" -" Py_DECREF(m);\n" -" return NULL;\n" -" }\n" -"\n" -" return m;\n" +" return PyModuleDef_Init(&custom_module);\n" "}\n" msgstr "" @@ -557,13 +578,13 @@ msgid ".tp_dealloc = (destructor) Custom_dealloc," msgstr "" msgid "" -"This method first clears the reference counts of the two Python attributes. :" -"c:func:`Py_XDECREF` correctly handles the case where its argument is " -"``NULL`` (which might happen here if ``tp_new`` failed midway). It then " -"calls the :c:member:`~PyTypeObject.tp_free` member of the object's type " -"(computed by ``Py_TYPE(self)``) to free the object's memory. Note that the " -"object's type might not be :class:`!CustomType`, because the object may be " -"an instance of a subclass." +"This method first clears the reference counts of the two Python " +"attributes. :c:func:`Py_XDECREF` correctly handles the case where its " +"argument is ``NULL`` (which might happen here if ``tp_new`` failed midway). " +"It then calls the :c:member:`~PyTypeObject.tp_free` member of the object's " +"type (computed by ``Py_TYPE(self)``) to free the object's memory. Note that " +"the object's type might not be :class:`!CustomType`, because the object may " +"be an instance of a subclass." msgstr "" msgid "" @@ -610,12 +631,13 @@ msgstr "" msgid "" "The ``tp_new`` handler is responsible for creating (as opposed to " -"initializing) objects of the type. It is exposed in Python as the :meth:" -"`~object.__new__` method. It is not required to define a ``tp_new`` member, " -"and indeed many extension types will simply reuse :c:func:" -"`PyType_GenericNew` as done in the first version of the :class:`!Custom` " -"type above. In this case, we use the ``tp_new`` handler to initialize the " -"``first`` and ``last`` attributes to non-``NULL`` default values." +"initializing) objects of the type. It is exposed in Python as " +"the :meth:`~object.__new__` method. It is not required to define a " +"``tp_new`` member, and indeed many extension types will simply " +"reuse :c:func:`PyType_GenericNew` as done in the first version of " +"the :class:`!Custom` type above. In this case, we use the ``tp_new`` " +"handler to initialize the ``first`` and ``last`` attributes to non-``NULL`` " +"default values." msgstr "" msgid "" @@ -623,8 +645,8 @@ msgid "" "``CustomType``, if a subclass is instantiated) and any arguments passed when " "the type was called, and is expected to return the instance created. " "``tp_new`` handlers always accept positional and keyword arguments, but they " -"often ignore the arguments, leaving the argument handling to initializer (a." -"k.a. ``tp_init`` in C or ``__init__`` in Python) methods." +"often ignore the arguments, leaving the argument handling to initializer " +"(a.k.a. ``tp_init`` in C or ``__init__`` in Python) methods." msgstr "" msgid "" @@ -641,8 +663,9 @@ msgid "self = (CustomObject *) type->tp_alloc(type, 0);" msgstr "" msgid "" -"Since memory allocation may fail, we must check the :c:member:`~PyTypeObject." -"tp_alloc` result against ``NULL`` before proceeding." +"Since memory allocation may fail, we must check " +"the :c:member:`~PyTypeObject.tp_alloc` result against ``NULL`` before " +"proceeding." msgstr "" msgid "" @@ -654,14 +677,15 @@ msgstr "" msgid "" "If you are creating a co-operative :c:member:`~PyTypeObject.tp_new` (one " -"that calls a base type's :c:member:`~PyTypeObject.tp_new` or :meth:`~object." -"__new__`), you must *not* try to determine what method to call using method " -"resolution order at runtime. Always statically determine what type you are " -"going to call, and call its :c:member:`~PyTypeObject.tp_new` directly, or " -"via ``type->tp_base->tp_new``. If you do not do this, Python subclasses of " -"your type that also inherit from other Python-defined classes may not work " -"correctly. (Specifically, you may not be able to create instances of such " -"subclasses without getting a :exc:`TypeError`.)" +"that calls a base type's :c:member:`~PyTypeObject.tp_new` " +"or :meth:`~object.__new__`), you must *not* try to determine what method to " +"call using method resolution order at runtime. Always statically determine " +"what type you are going to call, and call " +"its :c:member:`~PyTypeObject.tp_new` directly, or via ``type->tp_base-" +">tp_new``. If you do not do this, Python subclasses of your type that also " +"inherit from other Python-defined classes may not work correctly. " +"(Specifically, you may not be able to create instances of such subclasses " +"without getting a :exc:`TypeError`.)" msgstr "" msgid "" @@ -704,10 +728,10 @@ msgid ".tp_init = (initproc) Custom_init," msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_init` slot is exposed in Python as the :meth:" -"`~object.__init__` method. It is used to initialize an object after it's " -"created. Initializers always accept positional and keyword arguments, and " -"they should return either ``0`` on success or ``-1`` on error." +"The :c:member:`~PyTypeObject.tp_init` slot is exposed in Python as " +"the :meth:`~object.__init__` method. It is used to initialize an object " +"after it's created. Initializers always accept positional and keyword " +"arguments, and they should return either ``0`` on success or ``-1`` on error." msgstr "" msgid "" @@ -747,14 +771,14 @@ msgid "when we absolutely know that the reference count is greater than 1;" msgstr "" msgid "" -"when we know that deallocation of the object [#]_ will neither release the :" -"term:`GIL` nor cause any calls back into our type's code;" +"when we know that deallocation of the object [#]_ will neither release " +"the :term:`GIL` nor cause any calls back into our type's code;" msgstr "" msgid "" -"when decrementing a reference count in a :c:member:`~PyTypeObject." -"tp_dealloc` handler on a type which doesn't support cyclic garbage " -"collection [#]_." +"when decrementing a reference count in " +"a :c:member:`~PyTypeObject.tp_dealloc` handler on a type which doesn't " +"support cyclic garbage collection [#]_." msgstr "" msgid "" @@ -819,12 +843,12 @@ msgid "" msgstr "" msgid "" -"The method is implemented as a C function that takes a :class:`!Custom` (or :" -"class:`!Custom` subclass) instance as the first argument. Methods always " -"take an instance as the first argument. Methods often take positional and " -"keyword arguments as well, but in this case we don't take any and don't need " -"to accept a positional argument tuple or keyword argument dictionary. This " -"method is equivalent to the Python method:" +"The method is implemented as a C function that takes a :class:`!Custom` " +"(or :class:`!Custom` subclass) instance as the first argument. Methods " +"always take an instance as the first argument. Methods often take positional " +"and keyword arguments as well, but in this case we don't take any and don't " +"need to accept a positional argument tuple or keyword argument dictionary. " +"This method is equivalent to the Python method:" msgstr "" msgid "" @@ -835,11 +859,11 @@ msgstr "" " return \"%s %s\" % (self.first, self.last)" msgid "" -"Note that we have to check for the possibility that our :attr:`!first` and :" -"attr:`!last` members are ``NULL``. This is because they can be deleted, in " -"which case they are set to ``NULL``. It would be better to prevent deletion " -"of these attributes and to restrict the attribute values to be strings. " -"We'll see how to do that in the next section." +"Note that we have to check for the possibility that our :attr:`!first` " +"and :attr:`!last` members are ``NULL``. This is because they can be " +"deleted, in which case they are set to ``NULL``. It would be better to " +"prevent deletion of these attributes and to restrict the attribute values to " +"be strings. We'll see how to do that in the next section." msgstr "" msgid "" @@ -903,9 +927,9 @@ msgstr "" msgid "" "In this section, we'll provide finer control over how the :attr:`!first` " "and :attr:`!last` attributes are set in the :class:`!Custom` example. In the " -"previous version of our module, the instance variables :attr:`!first` and :" -"attr:`!last` could be set to non-string values or even deleted. We want to " -"make sure that these attributes always contain strings." +"previous version of our module, the instance variables :attr:`!first` " +"and :attr:`!last` could be set to non-string values or even deleted. We want " +"to make sure that these attributes always contain strings." msgstr "" msgid "" @@ -1057,31 +1081,40 @@ msgid "" " .tp_getset = Custom_getsetters,\n" "};\n" "\n" -"static PyModuleDef custommodule = {\n" +"static int\n" +"custom_module_exec(PyObject *m)\n" +"{\n" +" if (PyType_Ready(&CustomType) < 0) {\n" +" return -1;\n" +" }\n" +"\n" +" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) " +"{\n" +" return -1;\n" +" }\n" +"\n" +" return 0;\n" +"}\n" +"\n" +"static PyModuleDef_Slot custom_module_slots[] = {\n" +" {Py_mod_exec, custom_module_exec},\n" +" {Py_mod_multiple_interpreters, " +"Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED},\n" +" {0, NULL}\n" +"};\n" +"\n" +"static PyModuleDef custom_module = {\n" " .m_base = PyModuleDef_HEAD_INIT,\n" " .m_name = \"custom3\",\n" " .m_doc = \"Example module that creates an extension type.\",\n" -" .m_size = -1,\n" +" .m_size = 0,\n" +" .m_slots = custom_module_slots,\n" "};\n" "\n" "PyMODINIT_FUNC\n" "PyInit_custom3(void)\n" "{\n" -" PyObject *m;\n" -" if (PyType_Ready(&CustomType) < 0)\n" -" return NULL;\n" -"\n" -" m = PyModule_Create(&custommodule);\n" -" if (m == NULL)\n" -" return NULL;\n" -"\n" -" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) " -"{\n" -" Py_DECREF(m);\n" -" return NULL;\n" -" }\n" -"\n" -" return m;\n" +" return PyModuleDef_Init(&custom_module);\n" "}\n" msgstr "" @@ -1249,9 +1282,10 @@ msgstr "" msgid "" "In the second version of the :class:`!Custom` example, we allowed any kind " "of object to be stored in the :attr:`!first` or :attr:`!last` attributes " -"[#]_. Besides, in the second and third versions, we allowed subclassing :" -"class:`!Custom`, and subclasses may add arbitrary attributes. For any of " -"those two reasons, :class:`!Custom` objects can participate in cycles:" +"[#]_. Besides, in the second and third versions, we allowed " +"subclassing :class:`!Custom`, and subclasses may add arbitrary attributes. " +"For any of those two reasons, :class:`!Custom` objects can participate in " +"cycles:" msgstr "" msgid "" @@ -1442,31 +1476,40 @@ msgid "" " .tp_getset = Custom_getsetters,\n" "};\n" "\n" -"static PyModuleDef custommodule = {\n" +"static int\n" +"custom_module_exec(PyObject *m)\n" +"{\n" +" if (PyType_Ready(&CustomType) < 0) {\n" +" return -1;\n" +" }\n" +"\n" +" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) " +"{\n" +" return -1;\n" +" }\n" +"\n" +" return 0;\n" +"}\n" +"\n" +"static PyModuleDef_Slot custom_module_slots[] = {\n" +" {Py_mod_exec, custom_module_exec},\n" +" {Py_mod_multiple_interpreters, " +"Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED},\n" +" {0, NULL}\n" +"};\n" +"\n" +"static PyModuleDef custom_module = {\n" " .m_base = PyModuleDef_HEAD_INIT,\n" " .m_name = \"custom4\",\n" " .m_doc = \"Example module that creates an extension type.\",\n" -" .m_size = -1,\n" +" .m_size = 0,\n" +" .m_slots = custom_module_slots,\n" "};\n" "\n" "PyMODINIT_FUNC\n" "PyInit_custom4(void)\n" "{\n" -" PyObject *m;\n" -" if (PyType_Ready(&CustomType) < 0)\n" -" return NULL;\n" -"\n" -" m = PyModule_Create(&custommodule);\n" -" if (m == NULL)\n" -" return NULL;\n" -"\n" -" if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) " -"{\n" -" Py_DECREF(m);\n" -" return NULL;\n" -" }\n" -"\n" -" return m;\n" +" return PyModuleDef_Init(&custom_module);\n" "}\n" msgstr "" @@ -1495,11 +1538,11 @@ msgid "" msgstr "" msgid "" -"For each subobject that can participate in cycles, we need to call the :c:" -"func:`!visit` function, which is passed to the traversal method. The :c:func:" -"`!visit` function takes as arguments the subobject and the extra argument " -"*arg* passed to the traversal method. It returns an integer value that must " -"be returned if it is non-zero." +"For each subobject that can participate in cycles, we need to call " +"the :c:func:`!visit` function, which is passed to the traversal method. " +"The :c:func:`!visit` function takes as arguments the subobject and the extra " +"argument *arg* passed to the traversal method. It returns an integer value " +"that must be returned if it is non-zero." msgstr "" msgid "" @@ -1558,9 +1601,9 @@ msgid "" msgstr "" msgid "" -"Nevertheless, it is much easier and less error-prone to always use :c:func:" -"`Py_CLEAR` when deleting an attribute. Don't try to micro-optimize at the " -"expense of robustness!" +"Nevertheless, it is much easier and less error-prone to always " +"use :c:func:`Py_CLEAR` when deleting an attribute. Don't try to micro-" +"optimize at the expense of robustness!" msgstr "" msgid "" @@ -1568,8 +1611,8 @@ msgid "" "attributes. It means the circular GC can be triggered inside the function. " "Since the GC assumes reference count is not zero, we need to untrack the " "object from the GC by calling :c:func:`PyObject_GC_UnTrack` before clearing " -"members. Here is our reimplemented deallocator using :c:func:" -"`PyObject_GC_UnTrack` and ``Custom_clear``::" +"members. Here is our reimplemented deallocator " +"using :c:func:`PyObject_GC_UnTrack` and ``Custom_clear``::" msgstr "" msgid "" @@ -1591,9 +1634,10 @@ msgid "" msgstr "" msgid "" -"That's pretty much it. If we had written custom :c:member:`~PyTypeObject." -"tp_alloc` or :c:member:`~PyTypeObject.tp_free` handlers, we'd need to modify " -"them for cyclic garbage collection. Most extensions will use the versions " +"That's pretty much it. If we had written " +"custom :c:member:`~PyTypeObject.tp_alloc` " +"or :c:member:`~PyTypeObject.tp_free` handlers, we'd need to modify them for " +"cyclic garbage collection. Most extensions will use the versions " "automatically provided." msgstr "" @@ -1667,7 +1711,7 @@ msgid "" "}\n" "\n" "static PyTypeObject SubListType = {\n" -" PyVarObject_HEAD_INIT(NULL, 0)\n" +" .ob_base = PyVarObject_HEAD_INIT(NULL, 0)\n" " .tp_name = \"sublist.SubList\",\n" " .tp_doc = PyDoc_STR(\"SubList objects\"),\n" " .tp_basicsize = sizeof(SubListObject),\n" @@ -1677,32 +1721,41 @@ msgid "" " .tp_methods = SubList_methods,\n" "};\n" "\n" -"static PyModuleDef sublistmodule = {\n" -" PyModuleDef_HEAD_INIT,\n" -" .m_name = \"sublist\",\n" -" .m_doc = \"Example module that creates an extension type.\",\n" -" .m_size = -1,\n" -"};\n" -"\n" -"PyMODINIT_FUNC\n" -"PyInit_sublist(void)\n" +"static int\n" +"sublist_module_exec(PyObject *m)\n" "{\n" -" PyObject *m;\n" " SubListType.tp_base = &PyList_Type;\n" -" if (PyType_Ready(&SubListType) < 0)\n" -" return NULL;\n" -"\n" -" m = PyModule_Create(&sublistmodule);\n" -" if (m == NULL)\n" -" return NULL;\n" +" if (PyType_Ready(&SubListType) < 0) {\n" +" return -1;\n" +" }\n" "\n" " if (PyModule_AddObjectRef(m, \"SubList\", (PyObject *) &SubListType) < " "0) {\n" -" Py_DECREF(m);\n" -" return NULL;\n" +" return -1;\n" " }\n" "\n" -" return m;\n" +" return 0;\n" +"}\n" +"\n" +"static PyModuleDef_Slot sublist_module_slots[] = {\n" +" {Py_mod_exec, sublist_module_exec},\n" +" {Py_mod_multiple_interpreters, " +"Py_MOD_MULTIPLE_INTERPRETERS_NOT_SUPPORTED},\n" +" {0, NULL}\n" +"};\n" +"\n" +"static PyModuleDef sublist_module = {\n" +" .m_base = PyModuleDef_HEAD_INIT,\n" +" .m_name = \"sublist\",\n" +" .m_doc = \"Example module that creates an extension type.\",\n" +" .m_size = 0,\n" +" .m_slots = sublist_module_slots,\n" +"};\n" +"\n" +"PyMODINIT_FUNC\n" +"PyInit_sublist(void)\n" +"{\n" +" return PyModuleDef_Init(&sublist_module);\n" "}\n" msgstr "" @@ -1748,50 +1801,46 @@ msgid "" msgstr "" msgid "" -"This pattern is important when writing a type with custom :c:member:" -"`~PyTypeObject.tp_new` and :c:member:`~PyTypeObject.tp_dealloc` members. " +"This pattern is important when writing a type with " +"custom :c:member:`~PyTypeObject.tp_new` " +"and :c:member:`~PyTypeObject.tp_dealloc` members. " "The :c:member:`~PyTypeObject.tp_new` handler should not actually create the " "memory for the object with its :c:member:`~PyTypeObject.tp_alloc`, but let " "the base class handle it by calling its own :c:member:`~PyTypeObject.tp_new`." msgstr "" msgid "" -"The :c:type:`PyTypeObject` struct supports a :c:member:`~PyTypeObject." -"tp_base` specifying the type's concrete base class. Due to cross-platform " -"compiler issues, you can't fill that field directly with a reference to :c:" -"type:`PyList_Type`; it should be done later in the module initialization " -"function::" +"The :c:type:`PyTypeObject` struct supports " +"a :c:member:`~PyTypeObject.tp_base` specifying the type's concrete base " +"class. Due to cross-platform compiler issues, you can't fill that field " +"directly with a reference to :c:type:`PyList_Type`; it should be done in " +"the :c:data:`Py_mod_exec` function::" msgstr "" msgid "" -"PyMODINIT_FUNC\n" -"PyInit_sublist(void)\n" +"static int\n" +"sublist_module_exec(PyObject *m)\n" "{\n" -" PyObject* m;\n" " SubListType.tp_base = &PyList_Type;\n" -" if (PyType_Ready(&SubListType) < 0)\n" -" return NULL;\n" -"\n" -" m = PyModule_Create(&sublistmodule);\n" -" if (m == NULL)\n" -" return NULL;\n" +" if (PyType_Ready(&SubListType) < 0) {\n" +" return -1;\n" +" }\n" "\n" " if (PyModule_AddObjectRef(m, \"SubList\", (PyObject *) &SubListType) < " "0) {\n" -" Py_DECREF(m);\n" -" return NULL;\n" +" return -1;\n" " }\n" "\n" -" return m;\n" +" return 0;\n" "}" msgstr "" msgid "" -"Before calling :c:func:`PyType_Ready`, the type structure must have the :c:" -"member:`~PyTypeObject.tp_base` slot filled in. When we are deriving an " -"existing type, it is not necessary to fill out the :c:member:`~PyTypeObject." -"tp_alloc` slot with :c:func:`PyType_GenericNew` -- the allocation function " -"from the base type will be inherited." +"Before calling :c:func:`PyType_Ready`, the type structure must have " +"the :c:member:`~PyTypeObject.tp_base` slot filled in. When we are deriving " +"an existing type, it is not necessary to fill out " +"the :c:member:`~PyTypeObject.tp_alloc` slot with :c:func:`PyType_GenericNew` " +"-- the allocation function from the base type will be inherited." msgstr "" msgid "" diff --git a/extending/windows.po b/extending/windows.po index ed79cc8ca0..08621712be 100644 --- a/extending/windows.po +++ b/extending/windows.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -103,15 +103,15 @@ msgstr "" msgid "" "In Windows, there are two types of library, a static library and an import " -"library (both called :file:`.lib`). A static library is like a Unix :file:`." -"a` file; it contains code to be included as necessary. An import library is " -"basically used only to reassure the linker that a certain identifier is " -"legal, and will be present in the program when the DLL is loaded. So the " -"linker uses the information from the import library to build the lookup " -"table for using identifiers that are not included in the DLL. When an " -"application or a DLL is linked, an import library may be generated, which " -"will need to be used for all future DLLs that depend on the symbols in the " -"application or DLL." +"library (both called :file:`.lib`). A static library is like a " +"Unix :file:`.a` file; it contains code to be included as necessary. An " +"import library is basically used only to reassure the linker that a certain " +"identifier is legal, and will be present in the program when the DLL is " +"loaded. So the linker uses the information from the import library to build " +"the lookup table for using identifiers that are not included in the DLL. " +"When an application or a DLL is linked, an import library may be generated, " +"which will need to be used for all future DLLs that depend on the symbols in " +"the application or DLL." msgstr "" msgid "" @@ -119,9 +119,10 @@ msgid "" "share another block of code A. On Unix, you would *not* pass :file:`A.a` to " "the linker for :file:`B.so` and :file:`C.so`; that would cause it to be " "included twice, so that B and C would each have their own copy. In Windows, " -"building :file:`A.dll` will also build :file:`A.lib`. You *do* pass :file:" -"`A.lib` to the linker for B and C. :file:`A.lib` does not contain code; it " -"just contains information which will be used at runtime to access A's code." +"building :file:`A.dll` will also build :file:`A.lib`. You *do* " +"pass :file:`A.lib` to the linker for B and C. :file:`A.lib` does not " +"contain code; it just contains information which will be used at runtime to " +"access A's code." msgstr "" msgid "" @@ -158,9 +159,9 @@ msgid "" msgstr "" msgid "" -"The second command created :file:`ni.dll` (and :file:`.obj` and :file:`." -"lib`), which knows how to find the necessary functions from spam, and also " -"from the Python executable." +"The second command created :file:`ni.dll` (and :file:`.obj` " +"and :file:`.lib`), which knows how to find the necessary functions from " +"spam, and also from the Python executable." msgstr "" msgid "" diff --git a/faq/design.po b/faq/design.po index 2ec36af26d..9193ec83e1 100644 --- a/faq/design.po +++ b/faq/design.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 -# 2369f3689d74df2245bf6a7a078d3c27_4b122ab, 2022 -# Maciej Olko , 2022 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -136,12 +132,13 @@ msgstr "" "liczbami zmiennoprzecinkowymi." msgid "" -"The :class:`float` type in CPython uses a C ``double`` for storage. A :" -"class:`float` object's value is stored in binary floating-point with a fixed " -"precision (typically 53 bits) and Python uses C operations, which in turn " -"rely on the hardware implementation in the processor, to perform floating-" -"point operations. This means that as far as floating-point operations are " -"concerned, Python behaves like many popular languages including C and Java." +"The :class:`float` type in CPython uses a C ``double`` for storage. " +"A :class:`float` object's value is stored in binary floating-point with a " +"fixed precision (typically 53 bits) and Python uses C operations, which in " +"turn rely on the hardware implementation in the processor, to perform " +"floating-point operations. This means that as far as floating-point " +"operations are concerned, Python behaves like many popular languages " +"including C and Java." msgstr "" "Typ :class:`float` w CPython używa ``double`` z C do przechowywania. Wartość " "obiektu :class:`float` jest przechowywana w binarnej liczbie " @@ -276,6 +273,8 @@ 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 "" "while chunk := fp.read(200):\n" @@ -304,12 +303,12 @@ msgstr "" msgid "" "(b) When I read code that says len(x) I *know* that it is asking for the " "length of something. This tells me two things: the result is an integer, and " -"the argument is some kind of container. To the contrary, when I read x." -"len(), I have to already know that x is some kind of container implementing " -"an interface or inheriting from a class that has a standard len(). Witness " -"the confusion we occasionally have when a class that is not implementing a " -"mapping has a get() or keys() method, or something that isn't a file has a " -"write() method." +"the argument is some kind of container. To the contrary, when I read " +"x.len(), I have to already know that x is some kind of container " +"implementing an interface or inheriting from a class that has a standard " +"len(). Witness the confusion we occasionally have when a class that is not " +"implementing a mapping has a get() or keys() method, or something that isn't " +"a file has a write() method." msgstr "" msgid "https://mail.python.org/pipermail/python-3000/2006-November/004643.html" @@ -350,8 +349,9 @@ msgstr "" msgid "" "The second objection is typically cast as: \"I am really telling a sequence " "to join its members together with a string constant\". Sadly, you aren't. " -"For some reason there seems to be much less difficulty with having :meth:" -"`~str.split` as a string method, since in that case it is easy to see that ::" +"For some reason there seems to be much less difficulty with " +"having :meth:`~str.split` as a string method, since in that case it is easy " +"to see that ::" msgstr "" msgid "\"1, 2, 4, 8, 16\".split(\", \")" @@ -412,8 +412,10 @@ msgid "" "In general, structured switch statements execute one block of code when an " "expression has a particular value or set of values. Since Python 3.10 one " "can easily match literal values, or constants within a namespace, with a " -"``match ... case`` statement. An older alternative is a sequence of ``if... " -"elif... elif... else``." +"``match ... case`` statement. See :ref:`the specification ` " +"and :ref:`the tutorial ` for more information " +"about :keyword:`match` statements. An older alternative is a sequence of " +"``if... elif... elif... else``." msgstr "" msgid "" @@ -432,8 +434,8 @@ msgid "" msgstr "" msgid "" -"For calling methods on objects, you can simplify yet further by using the :" -"func:`getattr` built-in to retrieve methods with a particular name::" +"For calling methods on objects, you can simplify yet further by using " +"the :func:`getattr` built-in to retrieve methods with a particular name::" msgstr "" msgid "" @@ -611,10 +613,10 @@ msgstr "" msgid "" "Lists, on the other hand, are more like arrays in other languages. They " "tend to hold a varying number of objects all of which have the same type and " -"which are operated on one-by-one. For example, :func:`os.listdir('.') ` returns a list of strings representing the files in the current " -"directory. Functions which operate on this output would generally not break " -"if you added another file or two to the directory." +"which are operated on one-by-one. For example, :func:`os.listdir('.') " +"` returns a list of strings representing the files in the " +"current directory. Functions which operate on this output would generally " +"not break if you added another file or two to the directory." msgstr "" msgid "" @@ -707,8 +709,8 @@ msgstr "" msgid "" "would raise a :exc:`KeyError` exception because the id of the ``[1, 2]`` " "used in the second line differs from that in the first line. In other " -"words, dictionary keys should be compared using ``==``, not using :keyword:" -"`is`." +"words, dictionary keys should be compared using ``==``, not " +"using :keyword:`is`." msgstr "" msgid "" @@ -768,11 +770,11 @@ msgid "" msgstr "" msgid "" -"Furthermore it must always be the case that if ``o1 == o2`` (ie ``o1." -"__eq__(o2) is True``) then ``hash(o1) == hash(o2)`` (ie, ``o1.__hash__() == " -"o2.__hash__()``), regardless of whether the object is in a dictionary or " -"not. If you fail to meet these restrictions dictionaries and other hash " -"based structures will misbehave." +"Furthermore it must always be the case that if ``o1 == o2`` (ie " +"``o1.__eq__(o2) is True``) then ``hash(o1) == hash(o2)`` (ie, " +"``o1.__hash__() == o2.__hash__()``), regardless of whether the object is in " +"a dictionary or not. If you fail to meet these restrictions dictionaries " +"and other hash based structures will misbehave." msgstr "" msgid "" @@ -819,10 +821,10 @@ msgstr "" msgid "" "Python 2.6 adds an :mod:`abc` module that lets you define Abstract Base " "Classes (ABCs). You can then use :func:`isinstance` and :func:`issubclass` " -"to check whether an instance or a class implements a particular ABC. The :" -"mod:`collections.abc` module defines a set of useful ABCs such as :class:" -"`~collections.abc.Iterable`, :class:`~collections.abc.Container`, and :class:" -"`~collections.abc.MutableMapping`." +"to check whether an instance or a class implements a particular ABC. " +"The :mod:`collections.abc` module defines a set of useful ABCs such " +"as :class:`~collections.abc.Iterable`, :class:`~collections.abc.Container`, " +"and :class:`~collections.abc.MutableMapping`." msgstr "" msgid "" @@ -835,19 +837,19 @@ msgid "" "as a module interface specification and a set of examples. Many Python " "modules can be run as a script to provide a simple \"self test.\" Even " "modules which use complex external interfaces can often be tested in " -"isolation using trivial \"stub\" emulations of the external interface. The :" -"mod:`doctest` and :mod:`unittest` modules or third-party test frameworks can " -"be used to construct exhaustive test suites that exercise every line of code " -"in a module." +"isolation using trivial \"stub\" emulations of the external interface. " +"The :mod:`doctest` and :mod:`unittest` modules or third-party test " +"frameworks can be used to construct exhaustive test suites that exercise " +"every line of code in a module." msgstr "" msgid "" "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:`!list.append` method is expected to " +"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 " +"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 "" @@ -868,9 +870,9 @@ msgid "" "\"spaghetti\" code that was hard to understand and revise. In a high-level " "language, it is also unneeded as long as there are ways to branch (in " "Python, with :keyword:`if` statements and :keyword:`or`, :keyword:`and`, " -"and :keyword:`if`/:keyword:`else` expressions) and loop (with :keyword:" -"`while` and :keyword:`for` statements, possibly containing :keyword:" -"`continue` and :keyword:`break`)." +"and :keyword:`if`/:keyword:`else` expressions) and loop " +"(with :keyword:`while` and :keyword:`for` statements, possibly " +"containing :keyword:`continue` and :keyword:`break`)." msgstr "" msgid "" @@ -1023,9 +1025,9 @@ msgstr "" msgid "" "For technical reasons, a generator used directly as a context manager would " "not work correctly. When, as is most common, a generator is used as an " -"iterator run to completion, no closing is needed. When it is, wrap it as :" -"func:`contextlib.closing(generator) ` in the :keyword:" -"`with` statement." +"iterator run to completion, no closing is needed. When it is, wrap it " +"as :func:`contextlib.closing(generator) ` in " +"the :keyword:`with` statement." msgstr "" msgid "Why are colons required for the if/while/def/class statements?" diff --git a/faq/extending.po b/faq/extending.po index ad0a363f7b..d67690add3 100644 --- a/faq/extending.po +++ b/faq/extending.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +34,8 @@ msgstr "" msgid "" "Yes, you can create built-in modules containing functions, variables, " -"exceptions and even new types in C. This is explained in the document :ref:" -"`extending-index`." +"exceptions and even new types in C. This is explained in the " +"document :ref:`extending-index`." msgstr "" msgid "Most intermediate or advanced Python books will also cover this topic." @@ -45,10 +45,10 @@ msgid "Can I create my own functions in C++?" msgstr "" msgid "" -"Yes, using the C compatibility features found in C++. Place ``extern " -"\"C\" { ... }`` around the Python include files and put ``extern \"C\"`` " -"before each function that is going to be called by the Python interpreter. " -"Global or static C++ objects with constructors are probably not a good idea." +"Yes, using the C compatibility features found in C++. Place ``extern \"C\" " +"{ ... }`` around the Python include files and put ``extern \"C\"`` before " +"each function that is going to be called by the Python interpreter. Global " +"or static C++ objects with constructors are probably not a good idea." msgstr "" msgid "Writing C is hard; are there any alternatives?" @@ -56,25 +56,9 @@ msgstr "" msgid "" "There are a number of alternatives to writing your own C extensions, " -"depending on what you're trying to do." -msgstr "" - -msgid "" -"`Cython `_ and its relative `Pyrex `_ are compilers that accept a " -"slightly modified form of Python and generate the corresponding C code. " -"Cython and Pyrex make it possible to write an extension without having to " -"learn Python's C API." -msgstr "" - -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." +"depending on what you're trying to do. :ref:`Recommended third party tools " +"` offer both simpler and more sophisticated approaches to " +"creating C and C++ extensions for Python." msgstr "" msgid "How can I execute arbitrary Python statements from C?" @@ -84,9 +68,9 @@ msgid "" "The highest-level function to do this is :c:func:`PyRun_SimpleString` which " "takes a single string argument to be executed in the context of the module " "``__main__`` and returns ``0`` for success and ``-1`` when an exception " -"occurred (including :exc:`SyntaxError`). If you want more control, use :c:" -"func:`PyRun_String`; see the source for :c:func:`PyRun_SimpleString` in " -"``Python/pythonrun.c``." +"occurred (including :exc:`SyntaxError`). If you want more control, " +"use :c:func:`PyRun_String`; see the source for :c:func:`PyRun_SimpleString` " +"in ``Python/pythonrun.c``." msgstr "" msgid "How can I evaluate an arbitrary Python expression from C?" @@ -104,21 +88,21 @@ msgstr "" msgid "" "That depends on the object's type. If it's a tuple, :c:func:`PyTuple_Size` " "returns its length and :c:func:`PyTuple_GetItem` returns the item at a " -"specified index. Lists have similar functions, :c:func:`PyList_Size` and :c:" -"func:`PyList_GetItem`." +"specified index. Lists have similar functions, :c:func:`PyList_Size` " +"and :c:func:`PyList_GetItem`." msgstr "" msgid "" -"For bytes, :c:func:`PyBytes_Size` returns its length and :c:func:" -"`PyBytes_AsStringAndSize` provides a pointer to its value and its length. " -"Note that Python bytes objects may contain null bytes so C's :c:func:`!" -"strlen` should not be used." +"For bytes, :c:func:`PyBytes_Size` returns its length " +"and :c:func:`PyBytes_AsStringAndSize` provides a pointer to its value and " +"its length. Note that Python bytes objects may contain null bytes so " +"C's :c:func:`!strlen` should not be used." msgstr "" msgid "" "To test the type of an object, first make sure it isn't ``NULL``, and then " -"use :c:func:`PyBytes_Check`, :c:func:`PyTuple_Check`, :c:func:" -"`PyList_Check`, etc." +"use :c:func:`PyBytes_Check`, :c:func:`PyTuple_Check`, :c:func:`PyList_Check`, " +"etc." msgstr "" msgid "" @@ -235,11 +219,11 @@ msgid "module = PyImport_ImportModule(\"\");" msgstr "" msgid "" -"If the module hasn't been imported yet (i.e. it is not yet present in :data:" -"`sys.modules`), this initializes the module; otherwise it simply returns the " -"value of ``sys.modules[\"\"]``. Note that it doesn't enter the " -"module into any namespace -- it only ensures it has been initialized and is " -"stored in :data:`sys.modules`." +"If the module hasn't been imported yet (i.e. it is not yet present " +"in :data:`sys.modules`), this initializes the module; otherwise it simply " +"returns the value of ``sys.modules[\"\"]``. Note that it " +"doesn't enter the module into any namespace -- it only ensures it has been " +"initialized and is stored in :data:`sys.modules`." msgstr "" msgid "" @@ -360,12 +344,12 @@ msgid "" msgstr "" msgid "" -"Yes, you can inherit from built-in classes such as :class:`int`, :class:" -"`list`, :class:`dict`, etc." +"Yes, you can inherit from built-in classes such " +"as :class:`int`, :class:`list`, :class:`dict`, etc." msgstr "" msgid "" -"The Boost Python Library (BPL, https://www.boost.org/libs/python/doc/index." -"html) provides a way of doing this from C++ (i.e. you can inherit from an " -"extension class written in C++ using the BPL)." +"The Boost Python Library (BPL, https://www.boost.org/libs/python/doc/" +"index.html) provides a way of doing this from C++ (i.e. you can inherit from " +"an extension class written in C++ using the BPL)." msgstr "" diff --git a/faq/general.po b/faq/general.po index 4ae84c0ea2..beeb990d5b 100644 --- a/faq/general.po +++ b/faq/general.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -69,8 +67,8 @@ msgstr "" msgid "" "Donations to the PSF are tax-exempt in the US. If you use Python and find " -"it helpful, please contribute via `the PSF donation page `_." +"it helpful, please contribute via `the PSF donation page `_." msgstr "" msgid "Are there copyright restrictions on the use of Python?" @@ -264,7 +262,7 @@ msgstr "" msgid "" "The standard documentation for the current stable version of Python is " -"available at https://docs.python.org/3/. PDF, plain text, and downloadable " +"available at https://docs.python.org/3/. EPUB, plain text, and downloadable " "HTML versions are also available at https://docs.python.org/3/download.html." msgstr "" @@ -296,15 +294,16 @@ msgid "" "There is a newsgroup, :newsgroup:`comp.lang.python`, and a mailing list, " "`python-list `_. The " "newsgroup and mailing list are gatewayed into each other -- if you can read " -"news it's unnecessary to subscribe to the mailing list. :newsgroup:`comp." -"lang.python` is high-traffic, receiving hundreds of postings every day, and " -"Usenet readers are often more able to cope with this volume." +"news it's unnecessary to subscribe to the mailing " +"list. :newsgroup:`comp.lang.python` is high-traffic, receiving hundreds of " +"postings every day, and Usenet readers are often more able to cope with this " +"volume." msgstr "" msgid "" -"Announcements of new software releases and events can be found in comp.lang." -"python.announce, a low-traffic moderated list that receives about five " -"postings per day. It's available as `the python-announce mailing list " +"Announcements of new software releases and events can be found in " +"comp.lang.python.announce, a low-traffic moderated list that receives about " +"five postings per day. It's available as `the python-announce mailing list " "`_." msgstr "" @@ -318,9 +317,9 @@ msgstr "" msgid "" "Alpha and beta releases are available from https://www.python.org/" -"downloads/. All releases are announced on the comp.lang.python and comp." -"lang.python.announce newsgroups and on the Python home page at https://www." -"python.org/; an RSS feed of news is available." +"downloads/. All releases are announced on the comp.lang.python and " +"comp.lang.python.announce newsgroups and on the Python home page at https://" +"www.python.org/; an RSS feed of news is available." msgstr "" msgid "" @@ -332,8 +331,8 @@ msgid "How do I submit bug reports and patches for Python?" msgstr "" msgid "" -"To report a bug or submit a patch, use the issue tracker at https://github." -"com/python/cpython/issues." +"To report a bug or submit a patch, use the issue tracker at https://" +"github.com/python/cpython/issues." msgstr "" msgid "" @@ -376,8 +375,8 @@ msgstr "" msgid "" "The Python project's infrastructure is located all over the world and is " -"managed by the Python Infrastructure Team. Details `here `__." +"managed by the Python Infrastructure Team. Details `here `__." msgstr "" msgid "Why is it called Python?" @@ -385,8 +384,8 @@ msgstr "" msgid "" "When he began implementing Python, Guido van Rossum was also reading the " -"published scripts from `\"Monty Python's Flying Circus\" `__, a BBC comedy series from the 1970s. " +"published scripts from `\"Monty Python's Flying Circus\" `__, a BBC comedy series from the 1970s. " "Van Rossum thought he needed a name that was short, unique, and slightly " "mysterious, so he decided to call the language Python." msgstr "" @@ -449,18 +448,18 @@ msgstr "" msgid "" "See https://www.python.org/about/success for a list of projects that use " -"Python. Consulting the proceedings for `past Python conferences `_ will reveal contributions from many " +"Python. Consulting the proceedings for `past Python conferences `_ will reveal contributions from many " "different companies and organizations." msgstr "" msgid "" "High-profile Python projects include `the Mailman mailing list manager " -"`_ and `the Zope application server `_. Several Linux distributions, most notably `Red Hat `_, have written part or all of their installer and system " -"administration software in Python. Companies that use Python internally " -"include Google, Yahoo, and Lucasfilm Ltd." +"`_ and `the Zope application server `_. Several Linux distributions, most notably `Red Hat " +"`_, have written part or all of their installer and " +"system administration software in Python. Companies that use Python " +"internally include Google, Yahoo, and Lucasfilm Ltd." msgstr "" msgid "What new developments are expected for Python in the future?" @@ -475,8 +474,8 @@ msgid "" msgstr "" msgid "" -"New development is discussed on `the python-dev mailing list `_." +"New development is discussed on `the python-dev mailing list `_." msgstr "" msgid "Is it reasonable to propose incompatible changes to Python?" diff --git a/faq/gui.po b/faq/gui.po index 9ae850813f..321942c6de 100644 --- a/faq/gui.po +++ b/faq/gui.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Rafael Fontenelle , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +40,9 @@ msgid "" "widget set, called :ref:`tkinter `. This is probably the easiest " "to install (since it comes included with most `binary distributions `_ of Python) and use. For more info about Tk, " -"including pointers to the source, see the `Tcl/Tk home page `_. Tcl/Tk is fully portable to the macOS, Windows, and Unix platforms." +"including pointers to the source, see the `Tcl/Tk home page `_. Tcl/Tk is fully portable to the macOS, Windows, and Unix " +"platforms." msgstr "" "Standardowe kompilacje Pythona zawierają obiektowy interfejs do zestawu " "widżetów Tcl/Tk, zwany :ref:`tkinter `. Jest to prawdopodobnie " diff --git a/faq/index.po b/faq/index.po index 978bbe1739..6a72d68007 100644 --- a/faq/index.po +++ b/faq/index.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/faq/installed.po b/faq/installed.po index ab2411d106..cfa1339d5d 100644 --- a/faq/installed.po +++ b/faq/installed.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/faq/library.po b/faq/library.po index f9fcb8c841..5b1c477e9b 100644 --- a/faq/library.po +++ b/faq/library.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -45,8 +42,8 @@ msgid "" msgstr "" msgid "" -"For third-party packages, search the `Python Package Index `_ or try `Google `_ or another web search " +"For third-party packages, search the `Python Package Index `_ or try `Google `_ or another web search " "engine. Searching for \"Python\" plus a keyword or two for your topic of " "interest will usually find something helpful." msgstr "" @@ -57,9 +54,9 @@ msgstr "" msgid "" "If you can't find a source file for a module it may be a built-in or " "dynamically loaded module implemented in C, C++ or other compiled language. " -"In this case you may not have the source file or it may be something like :" -"file:`mathmodule.c`, somewhere in a C source directory (not on the Python " -"Path)." +"In this case you may not have the source file or it may be something " +"like :file:`mathmodule.c`, somewhere in a C source directory (not on the " +"Python Path)." msgstr "" msgid "There are (at least) three kinds of modules in Python:" @@ -346,10 +343,10 @@ msgstr "" msgid "" "Instead of trying to guess a good delay value for :func:`time.sleep`, it's " -"better to use some kind of semaphore mechanism. One idea is to use the :mod:" -"`queue` module to create a queue object, let each thread append a token to " -"the queue when it finishes, and let the main thread read as many tokens from " -"the queue as there are threads." +"better to use some kind of semaphore mechanism. One idea is to use " +"the :mod:`queue` module to create a queue object, let each thread append a " +"token to the queue when it finishes, and let the main thread read as many " +"tokens from the queue as there are threads." msgstr "" msgid "How do I parcel out work among a bunch of worker threads?" @@ -430,8 +427,8 @@ msgid "" msgstr "" msgid "" -"Consult the module's documentation for more details; the :class:`~queue." -"Queue` class provides a featureful interface." +"Consult the module's documentation for more details; " +"the :class:`~queue.Queue` class provides a featureful interface." msgstr "" msgid "What kinds of global value mutation are thread-safe?" @@ -483,10 +480,10 @@ msgid "" msgstr "" msgid "" -"Operations that replace other objects may invoke those other objects' :meth:" -"`~object.__del__` method when their reference count reaches zero, and that " -"can affect things. This is especially true for the mass updates to " -"dictionaries and lists. When in doubt, use a mutex!" +"Operations that replace other objects may invoke those other " +"objects' :meth:`~object.__del__` method when their reference count reaches " +"zero, and that can affect things. This is especially true for the mass " +"updates to dictionaries and lists. When in doubt, use a mutex!" msgstr "" msgid "Can't we get rid of the Global Interpreter Lock?" @@ -538,8 +535,8 @@ msgid "" "Judicious use of C extensions will also help; if you use a C extension to " "perform a time-consuming task, the extension can release the GIL while the " "thread of execution is in the C code and allow other threads to get some " -"work done. Some standard library modules such as :mod:`zlib` and :mod:" -"`hashlib` already do this." +"work done. Some standard library modules such as :mod:`zlib` " +"and :mod:`hashlib` already do this." msgstr "" msgid "" @@ -560,8 +557,9 @@ msgstr "Jak usunąć plik? (i inne plikowe pytania…)" msgid "" "Use ``os.remove(filename)`` or ``os.unlink(filename)``; for documentation, " -"see the :mod:`os` module. The two functions are identical; :func:`~os." -"unlink` is simply the name of the Unix system call for this function." +"see the :mod:`os` module. The two functions are " +"identical; :func:`~os.unlink` is simply the name of the Unix system call for " +"this function." msgstr "" msgid "" @@ -578,14 +576,14 @@ msgstr "" msgid "" "To truncate a file, open it using ``f = open(filename, \"rb+\")``, and use " "``f.truncate(offset)``; offset defaults to the current seek position. " -"There's also ``os.ftruncate(fd, offset)`` for files opened with :func:`os." -"open`, where *fd* is the file descriptor (a small integer)." +"There's also ``os.ftruncate(fd, offset)`` for files opened " +"with :func:`os.open`, where *fd* is the file descriptor (a small integer)." msgstr "" msgid "" "The :mod:`shutil` module also contains a number of functions to work on " -"files including :func:`~shutil.copyfile`, :func:`~shutil.copytree`, and :" -"func:`~shutil.rmtree`." +"files including :func:`~shutil.copyfile`, :func:`~shutil.copytree`, " +"and :func:`~shutil.rmtree`." msgstr "" msgid "How do I copy a file?" @@ -605,9 +603,9 @@ msgid "How do I read (or write) binary data?" msgstr "" msgid "" -"To read or write complex binary data formats, it's best to use the :mod:" -"`struct` module. It allows you to take a string containing binary data " -"(usually numbers) and convert it to Python objects; and vice versa." +"To read or write complex binary data formats, it's best to use " +"the :mod:`struct` module. It allows you to take a string containing binary " +"data (usually numbers) and convert it to Python objects; and vice versa." msgstr "" msgid "" @@ -648,8 +646,8 @@ msgid "" ":func:`os.read` is a low-level function which takes a file descriptor, a " "small integer representing the opened file. :func:`os.popen` creates a high-" "level file object, the same type returned by the built-in :func:`open` " -"function. Thus, to read *n* bytes from a pipe *p* created with :func:`os." -"popen`, you need to use ``p.read(n)``." +"function. Thus, to read *n* bytes from a pipe *p* created " +"with :func:`os.popen`, you need to use ``p.read(n)``." msgstr "" msgid "How do I access the serial (RS232) port?" @@ -802,10 +800,10 @@ msgstr "" msgid "" "You can use the :meth:`~socket.socket.connect_ex` method to avoid creating " -"an exception. It will just return the errno value. To poll, you can call :" -"meth:`~socket.socket.connect_ex` again later -- ``0`` or ``errno.EISCONN`` " -"indicate that you're connected -- or you can pass this socket to :meth:" -"`select.select` to check if it's writable." +"an exception. It will just return the errno value. To poll, you can " +"call :meth:`~socket.socket.connect_ex` again later -- ``0`` or " +"``errno.EISCONN`` indicate that you're connected -- or you can pass this " +"socket to :meth:`select.select` to check if it's writable." msgstr "" msgid "" @@ -826,9 +824,9 @@ msgstr "Tak" msgid "" "Interfaces to disk-based hashes such as :mod:`DBM ` and :mod:`GDBM " -"` are also included with standard Python. There is also the :mod:" -"`sqlite3` module, which provides a lightweight disk-based relational " -"database." +"` are also included with standard Python. There is also " +"the :mod:`sqlite3` module, which provides a lightweight disk-based " +"relational database." msgstr "" msgid "" @@ -842,8 +840,8 @@ msgstr "" msgid "" "The :mod:`pickle` library module solves this in a very general way (though " -"you still can't store things like open files, sockets or windows), and the :" -"mod:`shelve` library module uses pickle and (g)dbm to create persistent " +"you still can't store things like open files, sockets or windows), and " +"the :mod:`shelve` library module uses pickle and (g)dbm to create persistent " "mappings containing arbitrary Python objects." msgstr "" diff --git a/faq/programming.po b/faq/programming.po index cd94cf447b..bacfd0c477 100644 --- a/faq/programming.po +++ b/faq/programming.po @@ -1,23 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,23 +30,24 @@ msgstr "FAQ - programowanie" msgid "Contents" msgstr "Zawartość" -msgid "General Questions" +msgid "General questions" msgstr "Pytania ogólne" msgid "" -"Is there a source code level debugger with breakpoints, single-stepping, " -"etc.?" +"Is there a source code-level debugger with breakpoints and single-stepping?" msgstr "" -"Czy istnieje debugger kodu źródłowego z obsługą punktów przerwania, krokowym " -"wykonywaniem akcji itp.?" +"Czy istnieje debugger na poziomie kodu źródłowego z punktami przerwania i " +"wykonywaniem krok po kroku?" msgid "Yes." msgstr "Tak" msgid "" -"Several debuggers for Python are described below, and the built-in function :" -"func:`breakpoint` allows you to drop into any of them." +"Several debuggers for Python are described below, and the built-in " +"function :func:`breakpoint` allows you to drop into any of them." msgstr "" +"Poniżej opisano kilka debuggerów dla języka Python, a wbudowana " +"funkcja :func:`breakpoint` umożliwia przejście do dowolnego z nich." msgid "" "The pdb module is a simple but adequate console-mode debugger for Python. It " @@ -57,13 +55,19 @@ msgid "" "Library Reference Manual `. You can also write your own debugger by " "using the code for pdb as an example." msgstr "" +"Moduł pdb jest prostym, ale wystarczającym debugerem działającym w trybie " +"konsolowym dla Pythona. Jest częścią standardowej biblioteki Pythona i " +"jest :mod:dokumentowany w podręczniku Library Reference Manual . Możesz też " +"napisać własny debuger, używając kodu modułu pdb jako przykładu." msgid "" "The IDLE interactive development environment, which is part of the standard " -"Python distribution (normally available as `Tools/scripts/idle3 `_), includes a " +"Python distribution (normally available as :mod:`idlelib`), includes a " "graphical debugger." msgstr "" +"Interaktywne środowisko programistyczne IDLE, które jest częścią " +"standardowej dystrybucji Pythona (zwykle dostępnej jako ), zawiera graficzny " +"debugger." msgid "" "PythonWin is a Python IDE that includes a GUI debugger based on pdb. The " @@ -73,53 +77,75 @@ msgid "" "the `ActivePython `_ " "distribution." msgstr "" +"PythonWin to środowisko programistyczne Pythona, które zawiera graficzny " +"debuger oparty na pdb. Debuger PythonWin koloruje punkty przerwania i " +"oferuje kilka ciekawych funkcji, takich jak debugowanie programów innych niż " +"PythonWin. PythonWin jest dostępny jako część projektu `pywin32` oraz jako " +"część dystrybucji `ActivePython`." msgid "" "`Eric `_ is an IDE built on PyQt and " "the Scintilla editing component." msgstr "" +"`Eric `_ jest środowiskiem IDE " +"zbudowanym na bazie PyQt i komponentu edycyjnego Scintilla." msgid "" "`trepan3k `_ is a gdb-like " "debugger." msgstr "" +"`trepan3k `_ jest debuggerem typu " +"gdb." msgid "" "`Visual Studio Code `_ is an IDE with " "debugging tools that integrates with version-control software." msgstr "" +"`Visual Studio Code`_ to środowisko IDE z " +"narzędziami do debugowania, które integruje się z oprogramowaniem do " +"kontroli wersji." msgid "" "There are a number of commercial Python IDEs that include graphical " "debuggers. They include:" msgstr "" +"Istnieje wiele komercyjnych środowisk IDE dla Pythona, które zawierają " +"graficzne debugery. Należą do nich:" msgid "`Wing IDE `_" msgstr "" - -msgid "`Komodo IDE `_" -msgstr "`Komodo IDE `_" +"Skrzydło zintegrowane środowisko programistyczne`_" msgid "`PyCharm `_" msgstr "`PyCharm `_" msgid "Are there tools to help find bugs or perform static analysis?" msgstr "" +"Czy istnieją narzędzia pomocne w znajdowaniu błędów lub wykonywaniu analizy " +"statycznej?" msgid "" -"`Pylint `_ and `Pyflakes " -"`_ do basic checking that will help you " -"catch bugs sooner." +"`Ruff `__, `Pylint `__ and `Pyflakes `__ do basic checking that will help you catch bugs sooner." msgstr "" +"`Ruff `__, `Pylint `__i `Pyflakes `__ " +"wykonują podstawowe sprawdzanie, które pomoże Ci szybciej wychwycić błędy" msgid "" -"Static type checkers such as `Mypy `_, `Pyre " -"`_, and `Pytype `_ can check type hints in Python source code." +"Static type checkers such as `mypy `__, `ty `__, `Pyrefly `__, and `pytype " +"`__ can check type hints in Python source " +"code." msgstr "" +"Statyczne narzędzia do sprawdzania typów `__, takie " +"jak `mypy`__, `ty`__, " +"`Pyrefly i `pytype`__, mogą sprawdzać " +"wskazówki dotyczące typów w kodzie źródłowym Pythona." msgid "How can I create a stand-alone binary from a Python script?" -msgstr "" +msgstr "Jak mogę utworzyć samodzielny plik binarny ze skryptu Pythona?" msgid "" "You don't need the ability to compile Python to C code if all you want is a " @@ -128,14 +154,23 @@ msgid "" "determine the set of modules required by a program and bind these modules " "together with a Python binary to produce a single executable." msgstr "" +"Nie potrzebujesz umiejętności kompilowania Pythona do kodu C, jeśli " +"potrzebujesz jedynie samodzielnego programu, który użytkownicy mogą pobrać i " +"uruchomić bez konieczności wcześniejszej instalacji dystrybucji Pythona. " +"Istnieje wiele narzędzi, które określają zestaw modułów wymaganych przez " +"program i łączą te moduły za pomocą pliku binarnego Pythona w celu " +"utworzenia pojedynczego pliku wykonywalnego." msgid "" "One is to use the freeze tool, which is included in the Python source tree " -"as `Tools/freeze `_. It converts Python byte code to C arrays; with a C compiler you " -"can embed all your modules into a new program, which is then linked with the " -"standard Python modules." +"as :source:`Tools/freeze`. It converts Python byte code to C arrays; with a " +"C compiler you can embed all your modules into a new program, which is then " +"linked with the standard Python modules." msgstr "" +"Jednym z nich jest użycie narzędzia freeze, które jest zawarte w drzewie " +"źródłowym Pythona jako . Konwertuje ono kod bajtowy Pythona na tablice C; za " +"pomocą kompilatora C można osadzić wszystkie moduły w nowym programie, który " +"następnie jest łączony ze standardowymi modułami Pythona." msgid "" "It works by scanning your source recursively for import statements (in both " @@ -148,51 +183,72 @@ msgid "" "rest of the Python interpreter to form a self-contained binary which acts " "exactly like your script." msgstr "" +"It works by scanning your source recursively for import statements (in both " +"forms) and looking for the modules in the standard Python path as well as in " +"the source directory (for built-in modules). It then turns the bytecode for " +"modules written in Python into C code (array initializers that can be turned " +"into code objects using the marshal module) and creates a custom-made config " +"file that only contains those built-in modules which are actually used in " +"the program. It then compiles the generated C code and links it with the " +"rest of the Python interpreter to form a self-contained binary which acts " +"exactly like your script." msgid "" "The following packages can help with the creation of console and GUI " "executables:" msgstr "" +"Poniższe pakiety mogą pomóc w tworzeniu plików wykonywalnych konsoli i " +"interfejsu graficznego" msgid "`Nuitka `_ (Cross-platform)" -msgstr "" +msgstr "Nuitka `_ (Cross-platform)" msgid "`PyInstaller `_ (Cross-platform)" -msgstr "" +msgstr "`PyInstaller `_ (wieloplatformowy)" msgid "" "`PyOxidizer `_ (Cross-platform)" msgstr "" +"PyOxidizer `_ " +"(wieloplatformowy)" msgid "" "`cx_Freeze `_ (Cross-platform)" msgstr "" +"`cx_Freeze `_ (wieloplatformowy)" msgid "`py2app `_ (macOS only)" -msgstr "" +msgstr "py2app `_ (tylko macOS)" msgid "`py2exe `_ (Windows only)" -msgstr "" +msgstr "`py2exe `_ (tylko Windows)" msgid "Are there coding standards or a style guide for Python programs?" msgstr "" +"Czy istnieją standardy kodowania lub przewodnik stylistyczny dla programów w " +"Pythona?" msgid "" "Yes. The coding style required for standard library modules is documented " "as :pep:`8`." msgstr "" +"Tak. Styl kodowania wymagany dla standardowych modułów bibliotecznych jest " +"udokumentowany jako :pep:`8`" -msgid "Core Language" -msgstr "Rdzeń języka" +msgid "Core language" +msgstr "Język podstawowy" msgid "Why am I getting an UnboundLocalError when the variable has a value?" -msgstr "" +msgstr "Dlaczego otrzymuję błąd UnboundLocalError, skoro zmienna ma wartość?" msgid "" "It can be a surprise to get the :exc:`UnboundLocalError` in previously " "working code when it is modified by adding an assignment statement somewhere " "in the body of a function." msgstr "" +"Można się zdziwić, gdy okaże się, :exc:`UnboundLocalError` że kod, który " +"wcześniej działał, został zmodyfikowany przez dodanie instrukcji przypisania " +"w dowolnym miejscu ciała funkcji." msgid "This code:" msgstr "Ten kod:" @@ -201,7 +257,7 @@ msgid "works, but this code:" msgstr "działa, ale ten kod:" msgid "results in an :exc:`!UnboundLocalError`:" -msgstr "" +msgstr "skutkuje :exc:`!UnboundLocalError`" msgid "" "This is because when you make an assignment to a variable in a scope, that " @@ -211,25 +267,38 @@ msgid "" "Consequently when the earlier ``print(x)`` attempts to print the " "uninitialized local variable and an error results." msgstr "" +"Dzieje się tak, ponieważ po przypisaniu zmiennej w zakresie, zmienna ta " +"staje się lokalna w tym zakresie i przesłania każdą zmienną o podobnej " +"nazwie w zakresie zewnętrznym. Ponieważ ostatnie polecenie w foo przypisuje " +"nową wartość zmiennej ``x``, kompilator rozpoznaje ją jako zmienną lokalną. " +"W rezultacie ``print(x)``, gdy poprzednia instrukcja próbuje wydrukować " +"niezainicjowaną zmienną lokalną, pojawia się błąd." msgid "" "In the example above you can access the outer scope variable by declaring it " "global:" msgstr "" +"W powyższym przykładzie możesz uzyskać dostęp do zmiennej zakresu " +"zewnętrznego, deklarując ją jako globalną:" msgid "" "This explicit declaration is required in order to remind you that (unlike " "the superficially analogous situation with class and instance variables) you " "are actually modifying the value of the variable in the outer scope:" msgstr "" +"Ta wyraźna deklaracja jest wymagana, aby przypomnieć, że (w przeciwieństwie " +"do pozornie analogicznej sytuacji ze zmiennymi klasowymi i instancyjnymi) w " +"rzeczywistości modyfikujesz wartość zmiennej w zakresie zewnętrznym:" msgid "" "You can do a similar thing in a nested scope using the :keyword:`nonlocal` " "keyword:" msgstr "" +"Można wykonać podobną czynność w zakresie zagnieżdżonym, używając " +"słowa :keyword:`nonlocal` kluczowego:" msgid "What are the rules for local and global variables in Python?" -msgstr "" +msgstr "Jakie są zasady dotyczące zmiennych lokalnych i globalnych w Pythonie?" msgid "" "In Python, variables that are only referenced inside a function are " @@ -237,6 +306,10 @@ msgid "" "function's body, it's assumed to be a local unless explicitly declared as " "global." msgstr "" +"W Pythonie zmienne, do których odwołuje się tylko funkcja, są domyślnie " +"globalne. Jeśli zmiennej zostanie przypisana wartość w dowolnym miejscu w " +"ciele funkcji, przyjmuje się, że jest lokalna, chyba że zostanie jawnie " +"zadeklarowana jako globalna." msgid "" "Though a bit surprising at first, a moment's consideration explains this. " @@ -247,16 +320,28 @@ msgid "" "a component of an imported module. This clutter would defeat the usefulness " "of the ``global`` declaration for identifying side-effects." msgstr "" +"Choć na początku może to być nieco zaskakujące, chwila namysłu wyjaśnia " +"sprawę. Z jednej strony, wymaganie :keyword:`global` dla przypisanych " +"zmiennych chroni przed niezamierzonymi efektami ubocznymi. Z drugiej strony, " +"gdyby ``global`` było wymagane dla wszystkich odwołań globalnych, " +"używalibyśmy ``global`` go cały czas. Trzeba by deklarować jako globalne " +"każde odwołanie do funkcja wbudowanej lub do komponentu importowanego " +"modułu. Ten bałagan zniweczyłby użyteczność deklaracji w ``global`` " +"identyfikowaniu efektów ubocznych." msgid "" "Why do lambdas defined in a loop with different values all return the same " "result?" msgstr "" +"Dlaczego wyrażenia lambda zdefiniowane w pętli z różnymi wartościami " +"zwracają ten sam wynik?" msgid "" "Assume you use a for loop to define a few different lambdas (or even plain " -"functions), e.g.::" +"functions), for example::" msgstr "" +"Załóżmy, że używasz pętli for do zdefiniowania kilku różnych lambd (lub " +"nawet zwykłych funkcji), na przykład:" msgid "" ">>> squares = []\n" @@ -273,6 +358,9 @@ msgid "" "``1``, ``4``, ``9``, and ``16``. However, when you actually try you will " "see that they all return ``16``::" msgstr "" +"Daje to listę zawierającą 5 lambda obliczających . Można by się spodziewać, " +"że po wywołaniu zwracać odpowiednio``0``,``1`` ,``4`` ,``9`` , i ``16`` . " +"Jednak po próbie zobaczysz, że wszystkie zwracać ``16`` ::" msgid "" ">>> squares[2]()\n" @@ -289,9 +377,16 @@ msgid "" "This happens because ``x`` is not local to the lambdas, but is defined in " "the outer scope, and it is accessed when the lambda is called --- not when " "it is defined. At the end of the loop, the value of ``x`` is ``4``, so all " -"the functions now return ``4**2``, i.e. ``16``. You can also verify this by " -"changing the value of ``x`` and see how the results of the lambdas change::" +"the functions now return ``4**2``, that is ``16``. You can also verify this " +"by changing the value of ``x`` and see how the results of the lambdas " +"change::" msgstr "" +"Dzieje się tak ``x`` ponieważ zmienna nie jest lokalna dla wyrażeń lambda, " +"lecz zdefiniowana w zakresie zewnętrznym i jest dostępna podczas wywołania " +"funkcja lambda, a nie podczas jej definiowania. Na końcu pętli wartość " +"zmiennej wynosi ``x``, więc wszystkie funkcje zwracać ``4**2`` teraz ``16`` " +"czyli . Możesz to również sprawdzić, zmieniając wartość zmiennej i zobaczyć " +"``x`` jak zmieniają się wyniki wyrażeń lambda:" msgid "" ">>> x = 8\n" @@ -306,6 +401,8 @@ msgid "" "In order to avoid this, you need to save the values in variables local to " "the lambdas, so that they don't rely on the value of the global ``x``::" msgstr "" +"Aby tego uniknąć, należy zapisać wartości w zmiennych lokalnych dla lambd, " +"aby nie były one zależne od wartości zmiennej globalnej ``x``::" msgid "" ">>> squares = []\n" @@ -323,6 +420,11 @@ msgid "" "the first lambda, ``1`` in the second, ``2`` in the third, and so on. " "Therefore each lambda will now return the correct result::" msgstr "" +"Tutaj, ``n=x`` tworzy nową zmienną ``n`` lokalną dla lambda i oblicza ją " +"podczas definiowania lambda, tak aby miała tę samą wartość ``x`` co w danym " +"punkcie pętli. Oznacza to, że wartość ``n``będzie``0`` w pierwszej " +"lambda,``1`` w drugiej, ``2``w trzeciej itd. W związku z tym każda lambda " +"zwróci teraz poprawny wynik:" msgid "" ">>> squares[2]()\n" @@ -339,9 +441,11 @@ msgid "" "Note that this behaviour is not peculiar to lambdas, but applies to regular " "functions too." msgstr "" +"Należy pamiętać, że takie zachowanie nie jest specyficzne dla wyrażeń " +"lambda, ale ma zastosowanie także do zwykłych funkcje." msgid "How do I share global variables across modules?" -msgstr "" +msgstr "Jak udostępniać zmienne globalne pomiędzy moduły?" msgid "" "The canonical way to share information across modules within a single " @@ -351,12 +455,18 @@ msgid "" "each module, any changes made to the module object get reflected " "everywhere. For example:" msgstr "" +"Kanonicznym sposobem udostępniania informacji między modułami w ramach " +"jednego programu jest utworzenie specjalnego modułu (często nazywanego " +"config lub cfg). Wystarczy zaimportować moduł config do wszystkich modułów " +"aplikacji; moduł staje się wówczas dostępny jako nazwa globalna. Ponieważ " +"istnieje tylko jedna instancja każdego modułu, wszelkie zmiany wprowadzone w " +"obiekcie modułu są odzwierciedlane wszędzie. Na przykład:" msgid "config.py::" msgstr "config.py::" msgid "x = 0 # Default value of the 'x' configuration setting" -msgstr "" +msgstr "x = 0 # Wartość domyślna ustawienia konfiguracji „x”" msgid "mod.py::" msgstr "mod.py::" @@ -379,15 +489,20 @@ msgid "" "Note that using a module is also the basis for implementing the singleton " "design pattern, for the same reason." msgstr "" +"Należy pamiętać, że używanie modułu jest również podstawą implementacji " +"wzorca projektowego singleton, z tego samego powodu." msgid "What are the \"best practices\" for using import in a module?" -msgstr "" +msgstr "Jakie są „najlepsze praktyki” dotyczące używania import w module?" msgid "" "In general, don't use ``from modulename import *``. Doing so clutters the " "importer's namespace, and makes it much harder for linters to detect " "undefined names." msgstr "" +"Ogólnie rzecz biorąc, nie należy używać from modulename import *. Powoduje " +"to zaśmiecanie przestrzeni nazw importującego modułu i znacznie utrudnia " +"narzędziom lintującym wykrywanie niezdefiniowanych nazw." msgid "" "Import modules at the top of a file. Doing so makes it clear what other " @@ -395,18 +510,25 @@ msgid "" "is in scope. Using one import per line makes it easy to add and delete " "module imports, but using multiple imports per line uses less screen space." msgstr "" +"Importuj moduły na początku pliku. Dzięki temu jasno widać, jakich innych " +"modułów wymaga Twój kod, i unika się wątpliwości, czy nazwa modułu znajduje " +"się w zakresie. Używanie jednego importu w wierszu ułatwia dodawanie i " +"usuwanie importów modułów, natomiast używanie wielu importów w jednym " +"wierszu zajmuje mniej miejsca na ekranie." msgid "It's good practice if you import modules in the following order:" -msgstr "" +msgstr "Dobrą praktyką jest importowanie modułów w następującej kolejności:" msgid "" -"standard library modules -- e.g. :mod:`sys`, :mod:`os`, :mod:`argparse`, :" -"mod:`re`" +"standard library modules -- such " +"as :mod:`sys`, :mod:`os`, :mod:`argparse`, :mod:`re`" msgstr "" +"moduły biblioteki standardowej — takie jak 1:mod:sys, 2:mod:os, " +"3:mod:argparse, 4:mod:re" msgid "" "third-party library modules (anything installed in Python's site-packages " -"directory) -- e.g. :mod:`!dateutil`, :mod:`!requests`, :mod:`!PIL.Image`" +"directory) -- such as :pypi:`dateutil`, :pypi:`requests`, :pypi:`tzdata`" msgstr "" msgid "locally developed modules" @@ -516,6 +638,11 @@ msgid "" "value is requested again. This is called \"memoizing\", and can be " "implemented like this::" msgstr "" +"Ta funkcjonalność może być przydatna. Gdy masz funkcję, której obliczenia są " +"czasochłonne, często stosowaną techniką jest buforowanie (cache’owanie) " +"parametrów oraz wyników każdego wywołania funkcji i zwracanie zapisanego " +"wyniku, jeśli ta sama wartość zostanie ponownie zażądana. Nazywa się to " +"„memoizacją” i można to zaimplementować w następujący sposób::" msgid "" "# Callers can only provide two parameters and optionally pass _cache by " @@ -529,15 +656,24 @@ msgid "" " _cache[(arg1, arg2)] = result # Store result in the cache\n" " return result" msgstr "" +" # Callers can only provide two parameters and optionally pass _cache by " +"keyword def expensive(arg1, arg2, *, _cache={}): if (arg1, arg2) in _cache: " +"return _cache[(arg1, arg2)]# Calculate the value result = ... # expensive " +"computation _cache[(arg1, arg2)] = result # Store result in the cache return " +"result" msgid "" "You could use a global variable containing a dictionary instead of the " "default value; it's a matter of taste." msgstr "" +"Można użyć zmiennej globalnej zawierającej słownik zamiast wartości " +"domyślnej; jest to kwestia gustu." msgid "" "How can I pass optional or keyword parameters from one function to another?" msgstr "" +"Jak można przekazać opcjonalne parametry lub argumenty nazwane z jednej " +"funkcji do innej funkcji?" msgid "" "Collect the arguments using the ``*`` and ``**`` specifiers in the " @@ -553,6 +689,8 @@ msgid "" " ...\n" " g(x, *args, **kwargs)" msgstr "" +"def f(x, *args, **kwargs):...kwargs['width'] = '14.3c'...g(x, *args, " +"**kwargs)" msgid "What is the difference between arguments and parameters?" msgstr "Jaka jest różnica pomiędzy argumentami a parametrami?" @@ -560,15 +698,15 @@ msgstr "Jaka jest różnica pomiędzy argumentami a parametrami?" msgid "" ":term:`Parameters ` are defined by the names that appear in a " "function definition, whereas :term:`arguments ` are the values " -"actually passed to a function when calling it. Parameters define what :term:" -"`kind of arguments ` a function can accept. For example, given " -"the function definition::" +"actually passed to a function when calling it. Parameters define " +"what :term:`kind of arguments ` a function can accept. For " +"example, given the function definition::" msgstr "" msgid "" "def func(foo, bar=None, **kwargs):\n" " pass" -msgstr "" +msgstr "def func(foo, bar=None, **kwargs):pass" msgid "" "*foo*, *bar* and *kwargs* are parameters of ``func``. However, when calling " @@ -576,16 +714,16 @@ msgid "" msgstr "" msgid "func(42, bar=314, extra=somevar)" -msgstr "" +msgstr "func(42, bar=314, extra=somevar)" msgid "the values ``42``, ``314``, and ``somevar`` are arguments." msgstr "" msgid "Why did changing list 'y' also change list 'x'?" -msgstr "" +msgstr "Dlaczego zmiana listy „y” spowodowała również zmianę listy „x”?" msgid "If you wrote code like::" -msgstr "" +msgstr "Jeśli napisałeś kod taki jak::" msgid "" ">>> x = []\n" @@ -609,7 +747,7 @@ msgid "" msgstr "" msgid "There are two factors that produce this result:" -msgstr "" +msgstr "Na ten wynik składają się dwa czynniki:" msgid "" "Variables are simply names that refer to objects. Doing ``y = x`` doesn't " @@ -620,12 +758,12 @@ msgstr "" msgid "" "Lists are :term:`mutable`, which means that you can change their content." -msgstr "" +msgstr "Listy są :term:mutable, co oznacza, że można zmieniać ich zawartość." msgid "" -"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]``." +"After the call to :meth:`~sequence.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``::" @@ -640,6 +778,8 @@ msgid "" ">>> y\n" "5" msgstr "" +">>> x = 5 # inty są niezmienne>>> y = x>>> x = x + 1 # 5 nie może być " +"zmienione, tworzymy nowy obiekt>>> x6>>> y5" msgid "" "we can see that in this case ``x`` and ``y`` are not equal anymore. This is " @@ -670,21 +810,32 @@ msgid "" "mutates ``a_list``, whereas ``some_tuple += (1, 2, 3)`` and ``some_int += " "1`` create new objects)." msgstr "" +"Jednak istnieje jedna klasa operacji, w której ta sama operacja może " +"zachowywać się różnie w zależności od typu: operatory przypisania " +"rozszerzonego. Na przykład 1``+=`` modyfikuje listy, ale nie krotki ani " +"liczby całkowite (2``a_list`` += [1, 2, 3]`` jest równoważne " +"3``a_list``.extend([1, 2, 3`)``i modyfikuje 4``a_list``, natomiast " +"5``some_tuple += (1, 2, 3)`` oraz 6``some_int += 1`` tworzą nowe obiekty)." msgid "In other words:" msgstr "Innymi słowami:" msgid "" -"If we have a mutable object (:class:`list`, :class:`dict`, :class:`set`, " -"etc.), we can use some specific operations to mutate it and all the " -"variables that refer to it will see the change." +"If we have a mutable object (such " +"as :class:`list`, :class:`dict`, :class:`set`), we can use some specific " +"operations to mutate it and all the variables that refer to it will see the " +"change." msgstr "" +"Jeśli mamy obiekt mutowalny (taki jak 1:class:`list`, " +"2:class:`dict`,3 :class:`set`), możemy wykonać na nim określone operacje " +"modyfikujące, a wszystkie zmienne, które się do niego odnoszą, zobaczą tę " +"zmianę." msgid "" -"If we have an immutable object (:class:`str`, :class:`int`, :class:`tuple`, " -"etc.), all the variables that refer to it will always see the same value, " -"but operations that transform that value into a new value always return a " -"new object." +"If we have an immutable object (such " +"as :class:`str`, :class:`int`, :class:`tuple`), all the variables that refer " +"to it will always see the same value, but operations that transform that " +"value into a new value always return a new object." msgstr "" msgid "" @@ -698,8 +849,8 @@ msgstr "" msgid "" "Remember that arguments are passed by assignment in Python. Since " "assignment just creates references to objects, there's no alias between an " -"argument name in the caller and callee, and so no call-by-reference per se. " -"You can achieve the desired effect in a number of ways." +"argument name in the caller and callee, and consequently no call-by-" +"reference. You can achieve the desired effect in a number of ways." msgstr "" msgid "By returning a tuple of the results::" @@ -863,8 +1014,8 @@ msgid "" msgstr "" msgid "" -"Some objects can be copied more easily. Dictionaries have a :meth:`~dict." -"copy` method::" +"Some objects can be copied more easily. Dictionaries have " +"a :meth:`~dict.copy` method::" msgstr "" msgid "newdict = olddict.copy()" @@ -978,8 +1129,8 @@ msgid "\"a\" in (\"b\", \"a\")" msgstr "" msgid "" -"The same is true of the various assignment operators (``=``, ``+=`` etc). " -"They are not truly operators but syntactic delimiters in assignment " +"The same is true of the various assignment operators (``=``, ``+=``, and so " +"on). They are not truly operators but syntactic delimiters in assignment " "statements." msgstr "" @@ -1153,8 +1304,8 @@ msgid "How do I get int literal attribute instead of SyntaxError?" msgstr "" msgid "" -"Trying to lookup an ``int`` literal attribute in the normal manner gives a :" -"exc:`SyntaxError` because the period is seen as a decimal point::" +"Trying to lookup an ``int`` literal attribute in the normal manner gives " +"a :exc:`SyntaxError` because the period is seen as a decimal point::" msgstr "" msgid "" @@ -1179,9 +1330,9 @@ msgid "How do I convert a string to a number?" msgstr "Jak skonwertować ciąg znaków na liczbę?" msgid "" -"For integers, use the built-in :func:`int` type constructor, e.g. " +"For integers, use the built-in :func:`int` type constructor, for example, " "``int('144') == 144``. Similarly, :func:`float` converts to a floating-" -"point number, e.g. ``float('144') == 144.0``." +"point number, for example, ``float('144') == 144.0``." msgstr "" msgid "" @@ -1204,20 +1355,20 @@ msgstr "" msgid "" ":func:`eval` also has the effect of interpreting numbers as Python " -"expressions, so that e.g. ``eval('09')`` gives a syntax error because Python " -"does not allow leading '0' in a decimal number (except '0')." +"expressions, so that, for example, ``eval('09')`` gives a syntax error " +"because Python does not allow leading '0' in a decimal number (except '0')." msgstr "" msgid "How do I convert a number to a string?" msgstr "Jak skonwertować liczbę na ciąg znaków?" msgid "" -"To convert, e.g., the number ``144`` to the string ``'144'``, use the built-" -"in type constructor :func:`str`. If you want a hexadecimal or octal " +"For example, to convert the number ``144`` to the string ``'144'``, use the " +"built-in type constructor :func:`str`. If you want a hexadecimal or octal " "representation, use the built-in functions :func:`hex` or :func:`oct`. For " "fancy formatting, see the :ref:`f-strings` and :ref:`formatstrings` " -"sections, e.g. ``\"{:04d}\".format(144)`` yields ``'0144'`` and ``\"{:.3f}\"." -"format(1.0/3.0)`` yields ``'0.333'``." +"sections. For example, ``\"{:04d}\".format(144)`` yields ``'0144'`` and " +"``\"{:.3f}\".format(1.0/3.0)`` yields ``'0.333'``." msgstr "" msgid "How do I modify a string in place?" @@ -1227,7 +1378,7 @@ msgid "" "You can't, because strings are immutable. In most situations, you should " "simply construct a new string from the various parts you want to assemble it " "from. However, if you need an object with the ability to modify in-place " -"unicode data, try using an :class:`io.StringIO` object or the :mod:`array` " +"Unicode data, try using an :class:`io.StringIO` object or the :mod:`array` " "module::" msgstr "" @@ -1361,10 +1512,10 @@ msgstr "" msgid "" "For simple input parsing, the easiest approach is usually to split the line " "into whitespace-delimited words using the :meth:`~str.split` method of " -"string objects and then convert decimal strings to numeric values using :" -"func:`int` or :func:`float`. :meth:`!split` supports an optional \"sep\" " -"parameter which is useful if the line uses something other than whitespace " -"as a separator." +"string objects and then convert decimal strings to numeric values " +"using :func:`int` or :func:`float`. :meth:`!split` supports an optional " +"\"sep\" parameter which is useful if the line uses something other than " +"whitespace as a separator." msgstr "" msgid "" @@ -1450,8 +1601,8 @@ msgid "My program is too slow. How do I speed it up?" msgstr "Mój program jest za wolny. Jak mogę go przyspieszyć?" msgid "" -"That's a tough one, in general. First, here are a list of things to " -"remember before diving further:" +"That's a tough one, in general. First, here is a list of things to remember " +"before diving further:" msgstr "" msgid "" @@ -1501,9 +1652,9 @@ msgid "" "When the standard library provides a primitive for doing something, it is " "likely (although not guaranteed) to be faster than any alternative you may " "come up with. This is doubly true for primitives written in C, such as " -"builtins and some extension types. For example, be sure to use either the :" -"meth:`list.sort` built-in method or the related :func:`sorted` function to " -"do sorting (and see the :ref:`sortinghowto` for examples of moderately " +"builtins and some extension types. For example, be sure to use either " +"the :meth:`list.sort` built-in method or the related :func:`sorted` function " +"to do sorting (and see the :ref:`sortinghowto` for examples of moderately " "advanced usage)." msgstr "" @@ -1553,7 +1704,7 @@ msgid "" "result = ''.join(chunks)" msgstr "" -msgid "(another reasonably efficient idiom is to use :class:`io.StringIO`)" +msgid "(Another reasonably efficient idiom is to use :class:`io.StringIO`.)" msgstr "" msgid "" @@ -1568,7 +1719,7 @@ msgid "" " result += b" msgstr "" -msgid "Sequences (Tuples/Lists)" +msgid "Sequences (tuples/lists)" msgstr "" msgid "How do I convert between tuples and lists?" @@ -1652,8 +1803,8 @@ msgid "" msgstr "" msgid "" -"If all elements of the list may be used as set keys (i.e. they are all :term:" -"`hashable`) this is often faster ::" +"If all elements of the list may be used as set keys (that is, they are " +"all :term:`hashable`) this is often faster::" msgstr "" msgid "mylist = list(set(mylist))" @@ -1664,14 +1815,14 @@ msgid "" "back into a list." msgstr "" -msgid "How do you remove multiple items from a list" +msgid "How do you remove multiple items from a list?" msgstr "" msgid "" "As with removing duplicates, explicitly iterating in reverse with a delete " "condition is one possibility. However, it is easier and faster to use slice " "replacement with an implicit or explicit forward iteration. Here are three " -"variations.::" +"variations::" msgstr "" msgid "" @@ -1701,7 +1852,7 @@ msgstr "" msgid "" "The ``array`` module also provides methods for creating arrays of fixed " "types with compact representations, but they are slower to index than " -"lists. Also note that `NumPy `_ and other third party " +"lists. Also note that `NumPy `_ and other third-party " "packages define array-like structures with various characteristics as well." msgstr "" @@ -1787,8 +1938,8 @@ msgid "How do I apply a method or function to a sequence of objects?" msgstr "" msgid "" -"To call a method or function and accumulate the return values is a list, a :" -"term:`list comprehension` is an elegant solution::" +"To call a method or function and accumulate the return values in a list, " +"a :term:`list comprehension` is an elegant solution::" msgstr "" msgid "" @@ -1906,8 +2057,9 @@ 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:`!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:`~sequence.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 "" @@ -1983,31 +2135,8 @@ msgstr "" msgid "" "Merge them into an iterator of tuples, sort the resulting list, and then " -"pick out the element you want. ::" -msgstr "" - -msgid "" -">>> list1 = [\"what\", \"I'm\", \"sorting\", \"by\"]\n" -">>> list2 = [\"something\", \"else\", \"to\", \"sort\"]\n" -">>> pairs = zip(list1, list2)\n" -">>> pairs = sorted(pairs)\n" -">>> pairs\n" -"[(\"I'm\", 'else'), ('by', 'sort'), ('sorting', 'to'), ('what', " -"'something')]\n" -">>> result = [x[1] for x in pairs]\n" -">>> result\n" -"['else', 'sort', 'to', 'something']" -msgstr "" -">>> list1 = [\"what\", \"I'm\", \"sorting\", \"by\"]\n" -">>> list2 = [\"something\", \"else\", \"to\", \"sort\"]\n" -">>> pairs = zip(list1, list2)\n" -">>> pairs = sorted(pairs)\n" -">>> pairs\n" -"[(\"I'm\", 'else'), ('by', 'sort'), ('sorting', 'to'), ('what', " -"'something')]\n" -">>> result = [x[1] for x in pairs]\n" -">>> result\n" -"['else', 'sort', 'to', 'something']" +"pick out the element you want." +msgstr "" msgid "Objects" msgstr "Obiekty" @@ -2035,8 +2164,8 @@ msgid "What is a method?" msgstr "Co to jest metoda?" msgid "" -"A method is a function on some object ``x`` that you normally call as ``x." -"name(arguments...)``. Methods are defined as functions inside the class " +"A method is a function on some object ``x`` that you normally call as " +"``x.name(arguments...)``. Methods are defined as functions inside the class " "definition::" msgstr "" @@ -2067,17 +2196,18 @@ msgstr "" msgid "" "Use the built-in function :func:`isinstance(obj, cls) `. You " "can check if an object is an instance of any of a number of classes by " -"providing a tuple instead of a single class, e.g. ``isinstance(obj, (class1, " -"class2, ...))``, and can also check whether an object is one of Python's " -"built-in types, e.g. ``isinstance(obj, str)`` or ``isinstance(obj, (int, " -"float, complex))``." +"providing a tuple instead of a single class, for example, ``isinstance(obj, " +"(class1, class2, ...))``, and can also check whether an object is one of " +"Python's built-in types, for example, ``isinstance(obj, str)`` or " +"``isinstance(obj, (int, float, complex))``." msgstr "" msgid "" -"Note that :func:`isinstance` also checks for virtual inheritance from an :" -"term:`abstract base class`. So, the test will return ``True`` for a " +"Note that :func:`isinstance` also checks for virtual inheritance from " +"an :term:`abstract base class`. So, the test will return ``True`` for a " "registered class even if hasn't directly or indirectly inherited from it. " -"To test for \"true inheritance\", scan the :term:`MRO` of the class:" +"To test for \"true inheritance\", scan the :term:`method resolution order` " +"(MRO) of the class:" msgstr "" msgid "" @@ -2149,7 +2279,7 @@ msgid "What is delegation?" msgstr "" msgid "" -"Delegation is an object oriented technique (also called a design pattern). " +"Delegation is an object-oriented technique (also called a design pattern). " "Let's say you have an object ``x`` and want to change the behaviour of just " "one of its methods. You can create a new class that provides a new " "implementation of the method you're interested in changing and delegates all " @@ -2177,18 +2307,18 @@ msgstr "" msgid "" "Here the ``UpperOut`` class redefines the ``write()`` method to convert the " -"argument string to uppercase before calling the underlying ``self._outfile." -"write()`` method. All other methods are delegated to the underlying ``self." -"_outfile`` object. The delegation is accomplished via the :meth:`~object." -"__getattr__` method; consult :ref:`the language reference ` for more information about controlling attribute access." +"argument string to uppercase before calling the underlying " +"``self._outfile.write()`` method. All other methods are delegated to the " +"underlying ``self._outfile`` object. The delegation is accomplished via " +"the :meth:`~object.__getattr__` method; consult :ref:`the language reference " +"` for more information about controlling attribute access." msgstr "" msgid "" "Note that for more general cases delegation can get trickier. When " -"attributes must be set as well as retrieved, the class must define a :meth:" -"`~object.__setattr__` method too, and it must do so carefully. The basic " -"implementation of :meth:`!__setattr__` is roughly equivalent to the " +"attributes must be set as well as retrieved, the class must define " +"a :meth:`~object.__setattr__` method too, and it must do so carefully. The " +"basic implementation of :meth:`!__setattr__` is roughly equivalent to the " "following::" msgstr "" @@ -2201,8 +2331,9 @@ msgid "" msgstr "" msgid "" -"Many :meth:`~object.__setattr__` implementations call :meth:`!object." -"__setattr__` to set an attribute on self without causing infinite recursion::" +"Many :meth:`~object.__setattr__` implementations call :meth:`!" +"object.__setattr__` to set an attribute on self without causing infinite " +"recursion::" msgstr "" msgid "" @@ -2213,8 +2344,8 @@ msgid "" msgstr "" msgid "" -"Alternatively, it is possible to set attributes by inserting entries into :" -"attr:`self.__dict__ ` directly." +"Alternatively, it is possible to set attributes by inserting entries " +"into :attr:`self.__dict__ ` directly." msgstr "" msgid "" @@ -2244,8 +2375,8 @@ msgstr "" msgid "" "You could assign the base class to an alias and derive from the alias. Then " "all you have to change is the value assigned to the alias. Incidentally, " -"this trick is also handy if you want to decide dynamically (e.g. depending " -"on availability of resources) which base class to use. Example::" +"this trick is also handy if you want to decide dynamically (such as " +"depending on availability of resources) which base class to use. Example::" msgstr "" msgid "" @@ -2332,7 +2463,7 @@ msgid "" "up first in the context of constructors." msgstr "" -msgid "In C++ you'd write" +msgid "In C++ you'd write:" msgstr "" msgid "" @@ -2359,7 +2490,7 @@ msgstr "" msgid "This is not entirely equivalent, but close enough in practice." msgstr "" -msgid "You could also try a variable-length argument list, e.g. ::" +msgid "You could also try a variable-length argument list, for example::" msgstr "" msgid "" @@ -2411,8 +2542,8 @@ msgid "" "The :ref:`private name mangling specifications ` for " "details and special cases." msgstr "" -"Szczegółowe informacje i przypadki specjalne znajdują się w specyfikacji :" -"ref:`private name mangling `." +"Szczegółowe informacje i przypadki specjalne znajdują się w " +"specyfikacji :ref:`private name mangling `." msgid "My class defines __del__ but it is not called when I delete the object." msgstr "" @@ -2421,22 +2552,22 @@ msgid "There are several possible reasons for this." msgstr "" msgid "" -"The :keyword:`del` statement does not necessarily call :meth:`~object." -"__del__` -- it simply decrements the object's reference count, and if this " -"reaches zero :meth:`!__del__` is called." +"The :keyword:`del` statement does not necessarily " +"call :meth:`~object.__del__` -- it simply decrements the object's reference " +"count, and if this reaches zero :meth:`!__del__` is called." msgstr "" msgid "" -"If your data structures contain circular links (e.g. a tree where each child " -"has a parent reference and each parent has a list of children) the reference " -"counts will never go back to zero. Once in a while Python runs an algorithm " -"to detect such cycles, but the garbage collector might run some time after " -"the last reference to your data structure vanishes, so your :meth:`!__del__` " -"method may be called at an inconvenient and random time. This is " -"inconvenient if you're trying to reproduce a problem. Worse, the order in " -"which object's :meth:`!__del__` methods are executed is arbitrary. You can " -"run :func:`gc.collect` to force a collection, but there *are* pathological " -"cases where objects will never be collected." +"If your data structures contain circular links (for example, a tree where " +"each child has a parent reference and each parent has a list of children) " +"the reference counts will never go back to zero. Once in a while Python " +"runs an algorithm to detect such cycles, but the garbage collector might run " +"some time after the last reference to your data structure vanishes, so " +"your :meth:`!__del__` method may be called at an inconvenient and random " +"time. This is inconvenient if you're trying to reproduce a problem. Worse, " +"the order in which object's :meth:`!__del__` methods are executed is " +"arbitrary. You can run :func:`gc.collect` to force a collection, but there " +"*are* pathological cases where objects will never be collected." msgstr "" msgid "" @@ -2533,9 +2664,9 @@ msgid "" msgstr "" msgid "" -">>> a = 1000\n" -">>> b = 500\n" -">>> c = b + 500\n" +">>> a = 10_000_000\n" +">>> b = 5_000_000\n" +">>> c = b + 5_000_000\n" ">>> a is c\n" "False\n" "\n" @@ -2545,17 +2676,6 @@ msgid "" ">>> a is c\n" "False" msgstr "" -">>> a = 1000\n" -">>> b = 500\n" -">>> c = b + 500\n" -">>> a is c\n" -"False\n" -"\n" -">>> a = 'Python'\n" -">>> b = 'Py'\n" -">>> c = b + 'thon'\n" -">>> a is c\n" -"False" msgid "Likewise, new instances of mutable containers are never identical::" msgstr "" @@ -2609,8 +2729,8 @@ msgid "" msgstr "" msgid "" -"For example, here is the implementation of :meth:`!collections.abc.Sequence." -"__contains__`::" +"For example, here is the implementation of :meth:`!" +"collections.abc.Sequence.__contains__`::" msgstr "" msgid "" @@ -2638,9 +2758,9 @@ msgid "" msgstr "" msgid "" -"from datetime import date\n" +"import datetime as dt\n" "\n" -"class FirstOfMonthDate(date):\n" +"class FirstOfMonthDate(dt.date):\n" " \"Always choose the first day of the month\"\n" " def __new__(cls, year, month, day):\n" " return super().__new__(cls, year, month, 1)\n" @@ -2678,14 +2798,15 @@ msgid "How do I cache method calls?" msgstr "" msgid "" -"The two principal tools for caching methods are :func:`functools." -"cached_property` and :func:`functools.lru_cache`. The former stores results " -"at the instance level and the latter at the class level." +"The two principal tools for caching methods " +"are :deco:`functools.cached_property` and :deco:`functools.lru_cache`. The " +"former stores results at the instance level and the latter at the class " +"level." msgstr "" msgid "" -"The *cached_property* approach only works with methods that do not take any " -"arguments. It does not create a reference to the instance. The cached " +"The ``cached_property`` approach only works with methods that do not take " +"any arguments. It does not create a reference to the instance. The cached " "method result will be kept only as long as the instance is alive." msgstr "" @@ -2697,7 +2818,7 @@ msgid "" msgstr "" msgid "" -"The *lru_cache* approach works with methods that have :term:`hashable` " +"The ``lru_cache`` approach works with methods that have :term:`hashable` " "arguments. It creates a reference to the instance unless special efforts " "are made to pass in weak references." msgstr "" @@ -2737,14 +2858,15 @@ msgstr "" msgid "" "The above example assumes that the *station_id* never changes. If the " -"relevant instance attributes are mutable, the *cached_property* approach " +"relevant instance attributes are mutable, the ``cached_property`` approach " "can't be made to work because it cannot detect changes to the attributes." msgstr "" msgid "" -"To make the *lru_cache* approach work when the *station_id* is mutable, the " -"class needs to define the :meth:`~object.__eq__` and :meth:`~object." -"__hash__` methods so that the cache can detect relevant attribute updates::" +"To make the ``lru_cache`` approach work when the *station_id* is mutable, " +"the class needs to define the :meth:`~object.__eq__` " +"and :meth:`~object.__hash__` methods so that the cache can detect relevant " +"attribute updates::" msgstr "" msgid "" @@ -2796,24 +2918,24 @@ msgstr "" msgid "" "Unless the :envvar:`PYTHONDONTWRITEBYTECODE` environment variable is set, " "creation of a .pyc file is automatic if you're importing a module and Python " -"has the ability (permissions, free space, etc...) to create a " +"has the ability (permissions, free space, and so on) to create a " "``__pycache__`` subdirectory and write the compiled module to that " "subdirectory." msgstr "" msgid "" -"Running Python on a top level script is not considered an import and no ``." -"pyc`` will be created. For example, if you have a top-level module ``foo." -"py`` that imports another module ``xyz.py``, when you run ``foo`` (by typing " -"``python foo.py`` as a shell command), a ``.pyc`` will be created for " +"Running Python on a top-level script is not considered an import and no " +"``.pyc`` will be created. For example, if you have a top-level module " +"``foo.py`` that imports another module ``xyz.py``, when you run ``foo`` (by " +"typing ``python foo.py`` as a shell command), a ``.pyc`` will be created for " "``xyz`` because ``xyz`` is imported, but no ``.pyc`` file will be created " "for ``foo`` since ``foo.py`` isn't being imported." msgstr "" msgid "" -"If you need to create a ``.pyc`` file for ``foo`` -- that is, to create a ``." -"pyc`` file for a module that is not imported -- you can, using the :mod:" -"`py_compile` and :mod:`compileall` modules." +"If you need to create a ``.pyc`` file for ``foo`` -- that is, to create a " +"``.pyc`` file for a module that is not imported -- you can, using " +"the :mod:`py_compile` and :mod:`compileall` modules." msgstr "" msgid "" @@ -2831,7 +2953,7 @@ msgstr "" msgid "" "This will write the ``.pyc`` to a ``__pycache__`` subdirectory in the same " "location as ``foo.py`` (or you can override that with the optional parameter " -"``cfile``)." +"*cfile*)." msgstr "" msgid "" @@ -2931,11 +3053,11 @@ msgid "There are (at least) three possible workarounds for this problem." msgstr "" msgid "" -"Guido van Rossum recommends avoiding all uses of ``from import ..." -"``, and placing all code inside functions. Initializations of global " -"variables and class variables should use constants or built-in functions " -"only. This means everything from an imported module is referenced as " -"``.``." +"Guido van Rossum recommends avoiding all uses of ``from " +"import ...``, and placing all code inside functions. Initializations of " +"global variables and class variables should use constants or built-in " +"functions only. This means everything from an imported module is referenced " +"as ``.``." msgstr "" msgid "" @@ -2999,7 +3121,7 @@ msgstr "" msgid "" "Warning: this technique is not 100% fool-proof. In particular, modules " -"containing statements like ::" +"containing statements like::" msgstr "" msgid "from modname import some_objects" diff --git a/faq/windows.po b/faq/windows.po index 453fcd0290..99b48a9406 100644 --- a/faq/windows.po +++ b/faq/windows.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -121,19 +118,19 @@ msgstr "" msgid "" "Many people use the interactive mode as a convenient yet highly programmable " -"calculator. When you want to end your interactive Python session, call the :" -"func:`exit` function or hold the :kbd:`Ctrl` key down while you enter a :kbd:" -"`Z`, then hit the \":kbd:`Enter`\" key to get back to your Windows command " -"prompt." +"calculator. When you want to end your interactive Python session, call " +"the :func:`exit` function or hold the :kbd:`Ctrl` key down while you enter " +"a :kbd:`Z`, then hit the \":kbd:`Enter`\" key to get back to your Windows " +"command prompt." msgstr "" msgid "" -"You may also find that you have a Start-menu entry such as :menuselection:" -"`Start --> Programs --> Python 3.x --> Python (command line)` that results " -"in you seeing the ``>>>`` prompt in a new window. If so, the window will " -"disappear after you call the :func:`exit` function or enter the :kbd:`Ctrl-" -"Z` character; Windows is running a single \"python\" command in the window, " -"and closes it when you terminate the interpreter." +"You may also find that you have a Start-menu entry such " +"as :menuselection:`Start --> Programs --> Python 3.x --> Python (command " +"line)` that results in you seeing the ``>>>`` prompt in a new window. If " +"so, the window will disappear after you call the :func:`exit` function or " +"enter the :kbd:`Ctrl-Z` character; Windows is running a single \"python\" " +"command in the window, and closes it when you terminate the interpreter." msgstr "" msgid "" @@ -237,9 +234,10 @@ msgstr "" msgid "" "Do **not** build Python into your .exe file directly. On Windows, Python " "must be a DLL to handle importing modules that are themselves DLL's. (This " -"is the first key undocumented fact.) Instead, link to :file:`python{NN}." -"dll`; it is typically installed in ``C:\\Windows\\System``. *NN* is the " -"Python version, a number such as \"33\" for Python 3.3." +"is the first key undocumented fact.) Instead, link " +"to :file:`python{NN}.dll`; it is typically installed in ``C:" +"\\Windows\\System``. *NN* is the Python version, a number such as \"33\" " +"for Python 3.3." msgstr "" msgid "" @@ -362,16 +360,16 @@ msgstr "" msgid "" "Under any editor, mixing tabs and spaces is a bad idea. MSVC is no " -"different in this respect, and is easily configured to use spaces: Take :" -"menuselection:`Tools --> Options --> Tabs`, and for file type \"Default\" " -"set \"Tab size\" and \"Indent size\" to 4, and select the \"Insert spaces\" " -"radio button." +"different in this respect, and is easily configured to use spaces: " +"Take :menuselection:`Tools --> Options --> Tabs`, and for file type " +"\"Default\" set \"Tab size\" and \"Indent size\" to 4, and select the " +"\"Insert spaces\" radio button." msgstr "" msgid "" "Python raises :exc:`IndentationError` or :exc:`TabError` if mixed tabs and " -"spaces are causing problems in leading whitespace. You may also run the :mod:" -"`tabnanny` module to check a directory tree in batch mode." +"spaces are causing problems in leading whitespace. You may also run " +"the :mod:`tabnanny` module to check a directory tree in batch mode." msgstr "" msgid "How do I check for a keypress without blocking?" diff --git a/glossary.po b/glossary.po index b9ac9390a8..b33cc1bab6 100644 --- a/glossary.po +++ b/glossary.po @@ -1,25 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Tadeusz Karpiński , 2023 -# haaritsubaki, 2023 -# gresm, 2024 -# Rafael Fontenelle , 2024 -# Maciej Olko , 2025 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:47+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -39,6 +34,9 @@ msgid "" "The default Python prompt of the :term:`interactive` shell. Often seen for " "code examples which can be executed interactively in the interpreter." msgstr "" +"Domyślny znak zachęty powłoki :term:`interaktywnej ` w języku " +"Python. Często spotykane w przypadku przykładów kodu, które mogą być " +"wykonywane w interpreterze." msgid "``...``" msgstr "``...``" @@ -52,9 +50,14 @@ msgid "" "right delimiters (parentheses, square brackets, curly braces or triple " "quotes), or after specifying a decorator." msgstr "" +"Domyślnego znaku zachęty powłoki :term:`interaktywnej ` Pythona " +"przy wpisywaniu kodu wciętego bloku, wewnątrz pary odpowiadających sobie " +"ograniczników (nawiasów, nawiasów kwadratowych, nawiasów klamrowych lub " +"potrójnych cudzysłowów) lub po użyciu dekoratora." -msgid "The :const:`Ellipsis` built-in constant." -msgstr "Wbudowanej stałej :const:`Ellipsis`." +msgid "" +"The three dots form of the :ref:`Ellipsis ` object." +msgstr "Formy obiektu :ref:`Ellipsis `." msgid "abstract base class" msgstr "abstrakcyjna klasa bazowa" @@ -64,13 +67,26 @@ msgid "" "define interfaces when other techniques like :func:`hasattr` would be clumsy " "or subtly wrong (for example with :ref:`magic methods `). " "ABCs introduce virtual subclasses, which are classes that don't inherit from " -"a class but are still recognized by :func:`isinstance` and :func:" -"`issubclass`; see the :mod:`abc` module documentation. Python comes with " -"many built-in ABCs for data structures (in the :mod:`collections.abc` " -"module), numbers (in the :mod:`numbers` module), streams (in the :mod:`io` " -"module), import finders and loaders (in the :mod:`importlib.abc` module). " -"You can create your own ABCs with the :mod:`abc` module." -msgstr "" +"a class but are still recognized by :func:`isinstance` " +"and :func:`issubclass`; see the :mod:`abc` module documentation. Python " +"comes with many built-in ABCs for data structures (in " +"the :mod:`collections.abc` module), numbers (in the :mod:`numbers` module), " +"streams (in the :mod:`io` module), import finders and loaders (in " +"the :mod:`importlib.abc` module). You can create your own ABCs with " +"the :mod:`abc` module." +msgstr "" +"Abstrakcyjne klasy bazowe uzupełniają :term:`duck-typing`, oferując sposób " +"definiowania interfejsów w sytuacjach, gdy inne techniki, takie " +"jak :func:`hasattr`, byłyby nieporęczne lub nieco błędne (na przykład w " +"przypadku :ref:`magicznych metod ` ). Abstrakcyjne klasy " +"bazowe wprowadzają wirtualne podklasy, czyli klasy, które nie dziedziczą po " +"żadnej klasie, ale są nadal rozpoznawane przez :func:`isinstance` " +"i :func:`issubclass`; zobacz dokumentację modułu :mod:`abc`. Python zawiera " +"wiele wbudowanych abstrakcyjnych klas bazowych dla struktur danych (w " +"module :mod:`collections.abc`), liczb (w module :mod:`numbers`), strumieni " +"(w module :mod:`io`), wyszukiwarek i loaderów importów (w " +"module :mod:`importlib.abc`). Możesz stworzyć własną abstrakcyjną klasę " +"bazową za pomocą modułu :mod:`abc`." msgid "annotation" msgstr "adnotacja" @@ -91,8 +107,8 @@ msgstr "" msgid "" "See :term:`variable annotation`, :term:`function annotation`, :pep:`484` " -"and :pep:`526`, which describe this functionality. Also see :ref:" -"`annotations-howto` for best practices on working with annotations." +"and :pep:`526`, which describe this functionality. Also " +"see :ref:`annotations-howto` for best practices on working with annotations." msgstr "" msgid "argument" @@ -145,24 +161,29 @@ msgstr "" msgid "" "An object which controls the environment seen in an :keyword:`async with` " -"statement by defining :meth:`~object.__aenter__` and :meth:`~object." -"__aexit__` methods. Introduced by :pep:`492`." +"statement by defining :meth:`~object.__aenter__` " +"and :meth:`~object.__aexit__` methods. Introduced by :pep:`492`." msgstr "" msgid "asynchronous generator" msgstr "" msgid "" -"A function which returns an :term:`asynchronous generator iterator`. It " -"looks like a coroutine function defined with :keyword:`async def` except " -"that it contains :keyword:`yield` expressions for producing a series of " -"values usable in an :keyword:`async for` loop." +"Informally used to mean either an :term:`asynchronous generator function` or " +"an :term:`asynchronous generator iterator`, depending on context. The " +"formal terms :term:`asynchronous generator function` and :term:`asynchronous " +"generator iterator` are uncommon in practice; \"asynchronous generator\" " +"alone is almost always sufficient." +msgstr "" + +msgid "asynchronous generator function" msgstr "" msgid "" -"Usually refers to an asynchronous generator function, but may refer to an " -"*asynchronous generator iterator* in some contexts. In cases where the " -"intended meaning isn't clear, using the full terms avoids ambiguity." +"A function which returns an :term:`asynchronous generator iterator`. It " +"looks like a coroutine function defined with :keyword:`async def` except " +"that it contains :keyword:`yield` expressions for producing a series of " +"values usable in an :keyword:`async for` loop. See :pep:`525`." msgstr "" msgid "" @@ -173,14 +194,14 @@ msgstr "" msgid "asynchronous generator iterator" msgstr "" -msgid "An object created by a :term:`asynchronous generator` function." +msgid "An object created by an :term:`asynchronous generator function`." msgstr "" msgid "" -"This is an :term:`asynchronous iterator` which when called using the :meth:" -"`~object.__anext__` method returns an awaitable object which will execute " -"the body of the asynchronous generator function until the next :keyword:" -"`yield` expression." +"This is an :term:`asynchronous iterator` which when called using " +"the :meth:`~object.__anext__` method returns an awaitable object which will " +"execute the body of the asynchronous generator function until the " +"next :keyword:`yield` expression." msgstr "" msgid "" @@ -204,11 +225,24 @@ msgid "asynchronous iterator" msgstr "" msgid "" -"An object that implements the :meth:`~object.__aiter__` and :meth:`~object." -"__anext__` methods. :meth:`~object.__anext__` must return an :term:" -"`awaitable` object. :keyword:`async for` resolves the awaitables returned by " -"an asynchronous iterator's :meth:`~object.__anext__` method until it raises " -"a :exc:`StopAsyncIteration` exception. Introduced by :pep:`492`." +"An object that implements the :meth:`~object.__aiter__` " +"and :meth:`~object.__anext__` methods. :meth:`~object.__anext__` must " +"return an :term:`awaitable` object. :keyword:`async for` resolves the " +"awaitables returned by an asynchronous iterator's :meth:`~object.__anext__` " +"method until it raises a :exc:`StopAsyncIteration` exception. Introduced " +"by :pep:`492`." +msgstr "" + +msgid "atomic operation" +msgstr "" + +msgid "" +"An operation that appears to execute as a single, indivisible step: no other " +"thread can observe it half-done, and its effects become visible all at " +"once. Python does not guarantee that high-level statements are atomic (for " +"example, ``x += 1`` performs multiple bytecode operations and is not " +"atomic). Atomicity is only guaranteed where explicitly documented. See " +"also :term:`race condition` and :term:`data race`." msgstr "" msgid "attribute" @@ -222,27 +256,27 @@ msgstr "" msgid "" "It is possible to give an object an attribute whose name is not an " -"identifier as defined by :ref:`identifiers`, for example using :func:" -"`setattr`, if the object allows it. Such an attribute will not be accessible " -"using a dotted expression, and would instead need to be retrieved with :func:" -"`getattr`." +"identifier as defined by :ref:`identifiers`, for example " +"using :func:`setattr`, if the object allows it. Such an attribute will not " +"be accessible using a dotted expression, and would instead need to be " +"retrieved with :func:`getattr`." msgstr "" msgid "awaitable" msgstr "" msgid "" -"An object that can be used in an :keyword:`await` expression. Can be a :" -"term:`coroutine` or an object with an :meth:`~object.__await__` method. See " -"also :pep:`492`." +"An object that can be used in an :keyword:`await` expression. Can be " +"a :term:`coroutine` or an object with an :meth:`~object.__await__` method. " +"See also :pep:`492`." msgstr "" msgid "BDFL" msgstr "BDFL" msgid "" -"Benevolent Dictator For Life, a.k.a. `Guido van Rossum `_, Python's creator." +"Benevolent Dictator For Life, a.k.a. `Guido van Rossum `_, Python's creator." msgstr "" msgid "binary file" @@ -251,14 +285,14 @@ msgstr "plik binarny" msgid "" "A :term:`file object` able to read and write :term:`bytes-like objects " "`. Examples of binary files are files opened in binary " -"mode (``'rb'``, ``'wb'`` or ``'rb+'``), :data:`sys.stdin.buffer `, :data:`sys.stdout.buffer `, and instances of :class:`io." -"BytesIO` and :class:`gzip.GzipFile`." +"mode (``'rb'``, ``'wb'`` or ``'rb+'``), :data:`sys.stdin.buffer " +"`, :data:`sys.stdout.buffer `, and instances " +"of :class:`io.BytesIO` and :class:`gzip.GzipFile`." msgstr "" msgid "" -"See also :term:`text file` for a file object able to read and write :class:" -"`str` objects." +"See also :term:`text file` for a file object able to read and " +"write :class:`str` objects." msgstr "" msgid "borrowed reference" @@ -274,8 +308,8 @@ msgstr "" msgid "" "Calling :c:func:`Py_INCREF` on the :term:`borrowed reference` is recommended " "to convert it to a :term:`strong reference` in-place, except when the object " -"cannot be destroyed before the last usage of the borrowed reference. The :c:" -"func:`Py_NewRef` function can be used to create a new :term:`strong " +"cannot be destroyed before the last usage of the borrowed reference. " +"The :c:func:`Py_NewRef` function can be used to create a new :term:`strong " "reference`." msgstr "" @@ -283,20 +317,20 @@ msgid "bytes-like object" msgstr "" msgid "" -"An object that supports the :ref:`bufferobjects` and can export a C-:term:" -"`contiguous` buffer. This includes all :class:`bytes`, :class:`bytearray`, " -"and :class:`array.array` objects, as well as many common :class:`memoryview` " -"objects. Bytes-like objects can be used for various operations that work " -"with binary data; these include compression, saving to a binary file, and " -"sending over a socket." +"An object that supports the :ref:`bufferobjects` and can export a " +"C-:term:`contiguous` buffer. This includes " +"all :class:`bytes`, :class:`bytearray`, and :class:`array.array` objects, as " +"well as many common :class:`memoryview` objects. Bytes-like objects can be " +"used for various operations that work with binary data; these include " +"compression, saving to a binary file, and sending over a socket." msgstr "" msgid "" "Some operations need the binary data to be mutable. The documentation often " "refers to these as \"read-write bytes-like objects\". Example mutable " -"buffer objects include :class:`bytearray` and a :class:`memoryview` of a :" -"class:`bytearray`. Other operations require the binary data to be stored in " -"immutable objects (\"read-only bytes-like objects\"); examples of these " +"buffer objects include :class:`bytearray` and a :class:`memoryview` of " +"a :class:`bytearray`. Other operations require the binary data to be stored " +"in immutable objects (\"read-only bytes-like objects\"); examples of these " "include :class:`bytes` and a :class:`memoryview` of a :class:`bytes` object." msgstr "" @@ -315,8 +349,8 @@ msgid "" msgstr "" msgid "" -"A list of bytecode instructions can be found in the documentation for :ref:" -"`the dis module `." +"A list of bytecode instructions can be found in the documentation " +"for :ref:`the dis module `." msgstr "" msgid "callable" @@ -366,9 +400,9 @@ msgstr "" msgid "" "A :term:`free variable` referenced from a :term:`nested scope` that is " "defined in an outer scope rather than being resolved at runtime from the " -"globals or builtin namespaces. May be explicitly defined with the :keyword:" -"`nonlocal` keyword to allow write access, or implicitly defined if the " -"variable is only being read." +"globals or builtin namespaces. May be explicitly defined with " +"the :keyword:`nonlocal` keyword to allow write access, or implicitly defined " +"if the variable is only being read." msgstr "" msgid "" @@ -417,6 +451,29 @@ msgid "" "not aware of a need for them, it's almost certain you can safely ignore them." msgstr "" +msgid "concurrency" +msgstr "" + +msgid "" +"The ability of a computer program to perform multiple tasks at the same " +"time. Python provides libraries for writing programs that make use of " +"different forms of concurrency. :mod:`asyncio` is a library for dealing " +"with asynchronous tasks and coroutines. :mod:`threading` provides access to " +"operating system threads and :mod:`multiprocessing` to operating system " +"processes. Multi-core processors can execute threads and processes on " +"different CPU cores at the same time (see :term:`parallelism`)." +msgstr "" + +msgid "concurrent modification" +msgstr "" + +msgid "" +"When multiple threads modify shared data at the same time. Concurrent " +"modification without proper synchronization can cause :term:`race conditions " +"`, and might also trigger a :term:`data race `, " +"data corruption, or both." +msgstr "" + msgid "context" msgstr "kontekst" @@ -431,9 +488,10 @@ msgid "" msgstr "" msgid "" -"The collection of key­value bindings associated with a particular :class:" -"`contextvars.Context` object and accessed via :class:`~contextvars." -"ContextVar` objects. Also see :term:`context variable`." +"The collection of key­value bindings associated with a " +"particular :class:`contextvars.Context` object and accessed " +"via :class:`~contextvars.ContextVar` objects. Also see :term:`context " +"variable`." msgstr "" msgid "" @@ -453,8 +511,8 @@ msgstr "" msgid "" "An object which implements the :term:`context management protocol` and " -"controls the environment seen in a :keyword:`with` statement. See :pep:" -"`343`." +"controls the environment seen in a :keyword:`with` statement. " +"See :pep:`343`." msgstr "" msgid "context variable" @@ -495,9 +553,9 @@ msgstr "" msgid "" "A function which returns a :term:`coroutine` object. A coroutine function " -"may be defined with the :keyword:`async def` statement, and may contain :" -"keyword:`await`, :keyword:`async for`, and :keyword:`async with` keywords. " -"These were introduced by :pep:`492`." +"may be defined with the :keyword:`async def` statement, and may " +"contain :keyword:`await`, :keyword:`async for`, and :keyword:`async with` " +"keywords. These were introduced by :pep:`492`." msgstr "" msgid "CPython" @@ -517,9 +575,38 @@ msgid "" "The :term:`context` (:class:`contextvars.Context` object) that is currently " "used by :class:`~contextvars.ContextVar` objects to access (get or set) the " "values of :term:`context variables `. Each thread has its " -"own current context. Frameworks for executing asynchronous tasks (see :mod:" -"`asyncio`) associate each task with a context which becomes the current " -"context whenever the task starts or resumes execution." +"own current context. Frameworks for executing asynchronous tasks " +"(see :mod:`asyncio`) associate each task with a context which becomes the " +"current context whenever the task starts or resumes execution." +msgstr "" + +msgid "data race" +msgstr "" + +msgid "" +"A situation where multiple threads access the same memory location " +"concurrently, at least one of the accesses is a write, and the threads do " +"not use any synchronization to control their access. Data races lead " +"to :term:`non-deterministic` behavior and can cause data corruption. Proper " +"use of :term:`locks ` and other :term:`synchronization primitives " +"` prevents data races. Note that data races can " +"only happen in native code, but that :term:`native code` might be exposed in " +"a Python API. See also :term:`race condition` and :term:`thread-safe`." +msgstr "" + +msgid "deadlock" +msgstr "" + +msgid "" +"A situation in which two or more tasks (threads, processes, or coroutines) " +"wait indefinitely for each other to release resources or complete actions, " +"preventing any from making progress. For example, if thread A holds lock 1 " +"and waits for lock 2, while thread B holds lock 2 and waits for lock 1, both " +"threads will wait indefinitely. In Python this often arises from acquiring " +"multiple locks in conflicting orders or from circular join/await " +"dependencies. Deadlocks can be avoided by always acquiring " +"multiple :term:`locks ` in a consistent order. See also :term:`lock` " +"and :term:`reentrant`." msgstr "" msgid "decorator" @@ -528,7 +615,7 @@ msgstr "dekorator" msgid "" "A function returning another function, usually applied as a function " "transformation using the ``@wrapper`` syntax. Common examples for " -"decorators are :func:`classmethod` and :func:`staticmethod`." +"decorators are :deco:`classmethod` and :deco:`staticmethod`." msgstr "" msgid "" @@ -556,15 +643,16 @@ msgid "descriptor" msgstr "deskryptor" msgid "" -"Any object which defines the methods :meth:`~object.__get__`, :meth:`~object." -"__set__`, or :meth:`~object.__delete__`. When a class attribute is a " -"descriptor, its special binding behavior is triggered upon attribute " -"lookup. Normally, using *a.b* to get, set or delete an attribute looks up " -"the object named *b* in the class dictionary for *a*, but if *b* is a " -"descriptor, the respective descriptor method gets called. Understanding " -"descriptors is a key to a deep understanding of Python because they are the " -"basis for many features including functions, methods, properties, class " -"methods, static methods, and reference to super classes." +"Any object which defines the " +"methods :meth:`~object.__get__`, :meth:`~object.__set__`, " +"or :meth:`~object.__delete__`. When a class attribute is a descriptor, its " +"special binding behavior is triggered upon attribute lookup. Normally, " +"using *a.b* to get, set or delete an attribute looks up the object named *b* " +"in the class dictionary for *a*, but if *b* is a descriptor, the respective " +"descriptor method gets called. Understanding descriptors is a key to a deep " +"understanding of Python because they are the basis for many features " +"including functions, methods, properties, class methods, static methods, and " +"reference to super classes." msgstr "" msgid "" @@ -595,11 +683,11 @@ msgid "dictionary view" msgstr "" msgid "" -"The objects returned from :meth:`dict.keys`, :meth:`dict.values`, and :meth:" -"`dict.items` are called dictionary views. They provide a dynamic view on the " -"dictionary’s entries, which means that when the dictionary changes, the view " -"reflects these changes. To force the dictionary view to become a full list " -"use ``list(dictview)``. See :ref:`dict-views`." +"The objects returned from :meth:`dict.keys`, :meth:`dict.values`, " +"and :meth:`dict.items` are called dictionary views. They provide a dynamic " +"view on the dictionary’s entries, which means that when the dictionary " +"changes, the view reflects these changes. To force the dictionary view to " +"become a full list use ``list(dictview)``. See :ref:`dict-views`." msgstr "" msgid "docstring" @@ -622,10 +710,19 @@ msgid "" "called or used (\"If it looks like a duck and quacks like a duck, it must be " "a duck.\") By emphasizing interfaces rather than specific types, well-" "designed code improves its flexibility by allowing polymorphic " -"substitution. Duck-typing avoids tests using :func:`type` or :func:" -"`isinstance`. (Note, however, that duck-typing can be complemented with :" -"term:`abstract base classes `.) Instead, it typically " -"employs :func:`hasattr` tests or :term:`EAFP` programming." +"substitution. Duck-typing avoids tests using :func:`type` " +"or :func:`isinstance`. (Note, however, that duck-typing can be complemented " +"with :term:`abstract base classes `.) Instead, it " +"typically employs :func:`hasattr` tests or :term:`EAFP` programming." +msgstr "" + +msgid "dunder" +msgstr "" + +msgid "" +"An informal short-hand for \"double underscore\", used when talking about " +"a :term:`special method`. For example, ``__init__`` is often pronounced " +"\"dunder init\"." msgstr "" msgid "EAFP" @@ -646,11 +743,10 @@ msgstr "wyrażenie" msgid "" "A piece of syntax which can be evaluated to some value. In other words, an " "expression is an accumulation of expression elements like literals, names, " -"attribute access, operators or function calls which all return a value. In " -"contrast to many other languages, not all language constructs are " -"expressions. There are also :term:`statement`\\s which cannot be used as " -"expressions, such as :keyword:`while`. Assignments are also statements, not " -"expressions." +"attribute access, operators or function calls which all return a value. Not " +"all language constructs are expressions. There are " +"also :term:`statement`\\s which cannot be used as expressions, such " +"as :keyword:`while`. Assignments are also statements, not expressions." msgstr "" msgid "extension module" @@ -711,16 +807,16 @@ msgid "" msgstr "" msgid "" -"The :func:`sys.getfilesystemencoding` and :func:`sys." -"getfilesystemencodeerrors` functions can be used to get the filesystem " -"encoding and error handler." +"The :func:`sys.getfilesystemencoding` " +"and :func:`sys.getfilesystemencodeerrors` functions can be used to get the " +"filesystem encoding and error handler." msgstr "" msgid "" "The :term:`filesystem encoding and error handler` are configured at Python " -"startup by the :c:func:`PyConfig_Read` function: see :c:member:`~PyConfig." -"filesystem_encoding` and :c:member:`~PyConfig.filesystem_errors` members of :" -"c:type:`PyConfig`." +"startup by the :c:func:`PyConfig_Read` function: " +"see :c:member:`~PyConfig.filesystem_encoding` " +"and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" msgid "See also the :term:`locale encoding`." @@ -760,8 +856,8 @@ msgstr "" msgid "" "A threading model where multiple threads can run Python bytecode " -"simultaneously within the same interpreter. This is in contrast to the :" -"term:`global interpreter lock` which allows only one thread to execute " +"simultaneously within the same interpreter. This is in contrast to " +"the :term:`global interpreter lock` which allows only one thread to execute " "Python bytecode at a time. See :pep:`703`." msgstr "" @@ -783,8 +879,8 @@ msgstr "funkcja" msgid "" "A series of statements which returns some value to a caller. It can also be " "passed zero or more :term:`arguments ` which may be used in the " -"execution of the body. See also :term:`parameter`, :term:`method`, and the :" -"ref:`function` section." +"execution of the body. See also :term:`parameter`, :term:`method`, and " +"the :ref:`function` section." msgstr "" msgid "function annotation" @@ -819,8 +915,8 @@ msgstr "__future__" msgid "" "A :ref:`future statement `, ``from __future__ import ``, " "directs the compiler to compile the current module using syntax or semantics " -"that will become standard in a future release of Python. The :mod:" -"`__future__` module documents the possible values of *feature*. By " +"that will become standard in a future release of Python. " +"The :mod:`__future__` module documents the possible values of *feature*. By " "importing this module and evaluating its variables, you can see when a new " "feature was first added to the language and when it will (or did) become the " "default::" @@ -849,29 +945,42 @@ msgid "generator" msgstr "generator" msgid "" -"A function which returns a :term:`generator iterator`. It looks like a " -"normal function except that it contains :keyword:`yield` expressions for " -"producing a series of values usable in a for-loop or that can be retrieved " -"one at a time with the :func:`next` function." +"Informally used to mean either a :term:`generator function` or " +"a :term:`generator iterator`, depending on context. The formal " +"terms :term:`generator function` and :term:`generator iterator` are uncommon " +"in practice; \"generator\" alone is almost always sufficient." +msgstr "" + +msgid "generator function" msgstr "" msgid "" -"Usually refers to a generator function, but may refer to a *generator " -"iterator* in some contexts. In cases where the intended meaning isn't " -"clear, using the full terms avoids ambiguity." +"A function which returns a :term:`generator` object. It looks like a normal " +"function except that it contains :keyword:`yield` expressions for producing " +"a series of values usable in a :keyword:`for`\\-loop or that can be " +"retrieved one at a time with the :func:`next` function. See :ref:`yieldexpr`." msgstr "" msgid "generator iterator" msgstr "" -msgid "An object created by a :term:`generator` function." +msgid "" +"An object created by a :term:`generator function` or a :term:`generator " +"expression`." msgstr "" msgid "" "Each :keyword:`yield` temporarily suspends processing, remembering the " -"execution state (including local variables and pending try-statements). " -"When the *generator iterator* resumes, it picks up where it left off (in " -"contrast to functions which start fresh on every invocation)." +"execution state (including local variables and pending try-statements). When " +"the *generator iterator* resumes, it picks up where it left off (in contrast " +"to functions which start fresh on every invocation)." +msgstr "" + +msgid "" +"Generator iterators also implement the :meth:`~generator.send` method to " +"send a value into the suspended generator, and the :meth:`~generator.throw` " +"method to raise an exception at the point where the generator was paused. " +"See :ref:`generator-methods`." msgstr "" msgid "generator expression" @@ -899,8 +1008,8 @@ msgid "" msgstr "" msgid "" -"See also the :term:`single dispatch` glossary entry, the :func:`functools." -"singledispatch` decorator, and :pep:`443`." +"See also the :term:`single dispatch` glossary entry, " +"the :deco:`functools.singledispatch` decorator, and :pep:`443`." msgstr "" msgid "generic type" @@ -908,13 +1017,14 @@ msgstr "" msgid "" "A :term:`type` that can be parameterized; typically a :ref:`container " -"class` such as :class:`list` or :class:`dict`. Used for :" -"term:`type hints ` and :term:`annotations `." +"class` such as :class:`list` or :class:`dict`. Used " +"for :term:`type hints ` and :term:`annotations `." msgstr "" msgid "" -"For more details, see :ref:`generic alias types`, :pep:" -"`483`, :pep:`484`, :pep:`585`, and the :mod:`typing` module." +"For more details, see :ref:`generic alias types`, :pep:`483`, :pep:`484`, :pep:`585`, and the :mod:`typing` " +"module." msgstr "" msgid "GIL" @@ -952,6 +1062,18 @@ msgid "" "core CPUs efficiently. For more details, see :pep:`703`." msgstr "" +msgid "global state" +msgstr "" + +msgid "" +"Data that is accessible throughout a program, such as module-level " +"variables, class variables, or C static variables in :term:`extension " +"modules `. In multi-threaded programs, global state " +"shared between threads typically requires synchronization to " +"avoid :term:`race conditions ` and :term:`data races `." +msgstr "" + msgid "hash-based pyc" msgstr "" @@ -998,8 +1120,8 @@ msgid "immortal" msgstr "nieśmiertelne" msgid "" -"*Immortal objects* are a CPython implementation detail introduced in :pep:" -"`683`." +"*Immortal objects* are a CPython implementation detail introduced " +"in :pep:`683`." msgstr "" msgid "" @@ -1016,7 +1138,9 @@ msgid "" "and tuples. Such an object cannot be altered. A new object has to be " "created if a different value has to be stored. They play an important role " "in places where a constant hash value is needed, for example as a key in a " -"dictionary." +"dictionary. Immutable objects are inherently :term:`thread-safe` because " +"their state cannot be modified after creation, eliminating concerns about " +"improperly synchronized :term:`concurrent modification`." msgstr "" msgid "import path" @@ -1041,8 +1165,8 @@ msgid "importer" msgstr "importer" msgid "" -"An object that both finds and loads a module; both a :term:`finder` and :" -"term:`loader` object." +"An object that both finds and loads a module; both a :term:`finder` " +"and :term:`loader` object." msgstr "" msgid "interactive" @@ -1075,12 +1199,12 @@ msgstr "" msgid "" "When asked to shut down, the Python interpreter enters a special phase where " "it gradually releases all allocated resources, such as modules and various " -"critical internal structures. It also makes several calls to the :term:" -"`garbage collector `. This can trigger the execution of " -"code in user-defined destructors or weakref callbacks. Code executed during " -"the shutdown phase can encounter various exceptions as the resources it " -"relies on may not function anymore (common examples are library modules or " -"the warnings machinery)." +"critical internal structures. It also makes several calls to " +"the :term:`garbage collector `. This can trigger the " +"execution of code in user-defined destructors or weakref callbacks. Code " +"executed during the shutdown phase can encounter various exceptions as the " +"resources it relies on may not function anymore (common examples are library " +"modules or the warnings machinery)." msgstr "" msgid "" @@ -1094,51 +1218,55 @@ msgstr "" msgid "" "An object capable of returning its members one at a time. Examples of " "iterables include all sequence types (such as :class:`list`, :class:`str`, " -"and :class:`tuple`) and some non-sequence types like :class:`dict`, :term:" -"`file objects `, and objects of any classes you define with an :" -"meth:`~object.__iter__` method or with a :meth:`~object.__getitem__` method " -"that implements :term:`sequence` semantics." +"and :class:`tuple`) and some non-sequence types " +"like :class:`dict`, :term:`file objects `, and objects of any " +"classes you define with an :meth:`~object.__iter__` method or with " +"a :meth:`~object.__getitem__` method that implements :term:`sequence` " +"semantics." msgstr "" msgid "" "Iterables can be used in a :keyword:`for` loop and in many other places " "where a sequence is needed (:func:`zip`, :func:`map`, ...). When an " -"iterable object is passed as an argument to the built-in function :func:" -"`iter`, it returns an iterator for the object. This iterator is good for " -"one pass over the set of values. When using iterables, it is usually not " -"necessary to call :func:`iter` or deal with iterator objects yourself. The :" -"keyword:`for` statement does that automatically for you, creating a " -"temporary unnamed variable to hold the iterator for the duration of the " -"loop. See also :term:`iterator`, :term:`sequence`, and :term:`generator`." +"iterable object is passed as an argument to the built-in " +"function :func:`iter`, it returns an iterator for the object. This iterator " +"is good for one pass over the set of values. When using iterables, it is " +"usually not necessary to call :func:`iter` or deal with iterator objects " +"yourself. The :keyword:`for` statement does that automatically for you, " +"creating a temporary unnamed variable to hold the iterator for the duration " +"of the loop. See also :term:`iterator`, :term:`sequence`, " +"and :term:`generator`." msgstr "" msgid "iterator" msgstr "iterator" msgid "" -"An object representing a stream of data. Repeated calls to the iterator's :" -"meth:`~iterator.__next__` method (or passing it to the built-in function :" -"func:`next`) return successive items in the stream. When no more data are " -"available a :exc:`StopIteration` exception is raised instead. At this " -"point, the iterator object is exhausted and any further calls to its :meth:`!" -"__next__` method just raise :exc:`StopIteration` again. Iterators are " -"required to have an :meth:`~iterator.__iter__` method that returns the " -"iterator object itself so every iterator is also iterable and may be used in " -"most places where other iterables are accepted. One notable exception is " -"code which attempts multiple iteration passes. A container object (such as " -"a :class:`list`) produces a fresh new iterator each time you pass it to the :" -"func:`iter` function or use it in a :keyword:`for` loop. Attempting this " -"with an iterator will just return the same exhausted iterator object used in " -"the previous iteration pass, making it appear like an empty container." +"An object representing a stream of data. Repeated calls to the " +"iterator's :meth:`~iterator.__next__` method (or passing it to the built-in " +"function :func:`next`) return successive items in the stream. When no more " +"data are available a :exc:`StopIteration` exception is raised instead. At " +"this point, the iterator object is exhausted and any further calls to " +"its :meth:`!__next__` method just raise :exc:`StopIteration` again. " +"Iterators are required to have an :meth:`~iterator.__iter__` method that " +"returns the iterator object itself so every iterator is also iterable and " +"may be used in most places where other iterables are accepted. One notable " +"exception is code which attempts multiple iteration passes. A container " +"object (such as a :class:`list`) produces a fresh new iterator each time you " +"pass it to the :func:`iter` function or use it in a :keyword:`for` loop. " +"Attempting this with an iterator will just return the same exhausted " +"iterator object used in the previous iteration pass, making it appear like " +"an empty container." msgstr "" msgid "More information can be found in :ref:`typeiter`." msgstr "" msgid "" -"CPython does not consistently apply the requirement that an iterator define :" -"meth:`~iterator.__iter__`. And also please note that the free-threading " -"CPython does not guarantee the thread-safety of iterator operations." +"CPython does not consistently apply the requirement that an iterator " +"define :meth:`~iterator.__iter__`. And also please note that :term:`free-" +"threaded ` CPython does not guarantee :term:`thread-safe` " +"behavior of iterator operations." msgstr "" msgid "key function" @@ -1152,19 +1280,20 @@ msgstr "" msgid "" "A number of tools in Python accept key functions to control how elements are " -"ordered or grouped. They include :func:`min`, :func:`max`, :func:`sorted`, :" -"meth:`list.sort`, :func:`heapq.merge`, :func:`heapq.nsmallest`, :func:`heapq." -"nlargest`, and :func:`itertools.groupby`." +"ordered or grouped. They " +"include :func:`min`, :func:`max`, :func:`sorted`, :meth:`list.sort`, :func:`heapq.merge`, :func:`heapq.nsmallest`, :func:`heapq.nlargest`, " +"and :func:`itertools.groupby`." msgstr "" msgid "" -"There are several ways to create a key function. For example. the :meth:" -"`str.lower` method can serve as a key function for case insensitive sorts. " -"Alternatively, a key function can be built from a :keyword:`lambda` " -"expression such as ``lambda r: (r[0], r[2])``. Also, :func:`operator." -"attrgetter`, :func:`operator.itemgetter`, and :func:`operator.methodcaller` " -"are three key function constructors. See the :ref:`Sorting HOW TO " -"` for examples of how to create and use key functions." +"There are several ways to create a key function. For example. " +"the :meth:`str.casefold` method can serve as a key function for case " +"insensitive sorts. Alternatively, a key function can be built from " +"a :keyword:`lambda` expression such as ``lambda r: (r[0], r[2])``. " +"Also, :func:`operator.attrgetter`, :func:`operator.itemgetter`, " +"and :func:`operator.methodcaller` are three key function constructors. See " +"the :ref:`Sorting HOW TO ` for examples of how to create and " +"use key functions." msgstr "" msgid "keyword argument" @@ -1193,11 +1322,12 @@ msgid "" msgstr "" msgid "" -"In a multi-threaded environment, the LBYL approach can risk introducing a " -"race condition between \"the looking\" and \"the leaping\". For example, " -"the code, ``if key in mapping: return mapping[key]`` can fail if another " -"thread removes *key* from *mapping* after the test, but before the lookup. " -"This issue can be solved with locks or by using the EAFP approach." +"In a multi-threaded environment, the LBYL approach can risk introducing " +"a :term:`race condition` between \"the looking\" and \"the leaping\". For " +"example, the code, ``if key in mapping: return mapping[key]`` can fail if " +"another thread removes *key* from *mapping* after the test, but before the " +"lookup. This issue can be solved with :term:`locks ` or by using " +"the :term:`EAFP` approach. See also :term:`thread-safe`." msgstr "" msgid "lexical analyzer" @@ -1226,14 +1356,45 @@ msgid "" "optional. If omitted, all elements in ``range(256)`` are processed." msgstr "" +msgid "lock" +msgstr "" + +msgid "" +"A :term:`synchronization primitive` that allows only one thread at a time to " +"access a shared resource. A thread must acquire a lock before accessing the " +"protected resource and release it afterward. If a thread attempts to " +"acquire a lock that is already held by another thread, it will block until " +"the lock becomes available. Python's :mod:`threading` module " +"provides :class:`~threading.Lock` (a basic lock) " +"and :class:`~threading.RLock` (a :term:`reentrant` lock). Locks are used to " +"prevent :term:`race conditions ` and ensure :term:`thread-" +"safe` access to shared data. Alternative design patterns to locks exist " +"such as queues, producer/consumer patterns, and thread-local state. See " +"also :term:`deadlock`, and :term:`reentrant`." +msgstr "" + +msgid "lock-free" +msgstr "" + +msgid "" +"An operation that does not acquire any :term:`lock` and uses atomic CPU " +"instructions to ensure correctness. Lock-free operations can execute " +"concurrently without blocking each other and cannot be blocked by operations " +"that hold locks. In :term:`free-threaded ` Python, built-in " +"types like :class:`dict` and :class:`list` provide lock-free read " +"operations, which means other threads may observe intermediate states during " +"multi-step modifications even when those modifications hold the :term:`per-" +"object lock`." +msgstr "" + msgid "loader" msgstr "ładowarka" msgid "" -"An object that loads a module. It must define the :meth:`!exec_module` and :" -"meth:`!create_module` methods to implement the :class:`~importlib.abc." -"Loader` interface. A loader is typically returned by a :term:`finder`. See " -"also:" +"An object that loads a module. It must define the :meth:`!exec_module` " +"and :meth:`!create_module` methods to implement " +"the :class:`~importlib.abc.Loader` interface. A loader is typically returned " +"by a :term:`finder`. See also:" msgstr "" msgid ":ref:`finders-and-loaders`" @@ -1249,8 +1410,9 @@ msgid "locale encoding" msgstr "" msgid "" -"On Unix, it is the encoding of the LC_CTYPE locale. It can be set with :func:" -"`locale.setlocale(locale.LC_CTYPE, new_locale) `." +"On Unix, it is the encoding of the LC_CTYPE locale. It can be set " +"with :func:`locale.setlocale(locale.LC_CTYPE, new_locale) " +"`." msgstr "" msgid "On Windows, it is the ANSI code page (ex: ``\"cp1252\"``)." @@ -1277,11 +1439,11 @@ msgstr "" msgid "" "A container object that supports arbitrary key lookups and implements the " -"methods specified in the :class:`collections.abc.Mapping` or :class:" -"`collections.abc.MutableMapping` :ref:`abstract base classes `. Examples include :class:`dict`, :class:" -"`collections.defaultdict`, :class:`collections.OrderedDict` and :class:" -"`collections.Counter`." +"methods specified in the :class:`collections.abc.Mapping` " +"or :class:`collections.abc.MutableMapping` :ref:`abstract base classes " +"`. Examples " +"include :class:`dict`, :class:`collections.defaultdict`, :class:`collections.OrderedDict` " +"and :class:`collections.Counter`." msgstr "" msgid "meta path finder" @@ -1322,8 +1484,8 @@ msgstr "metoda" msgid "" "A function which is defined inside a class body. If called as an attribute " "of an instance of that class, the method will get the instance object as its " -"first :term:`argument` (which is usually called ``self``). See :term:" -"`function` and :term:`nested scope`." +"first :term:`argument` (which is usually called ``self``). " +"See :term:`function` and :term:`nested scope`." msgstr "" msgid "method resolution order" @@ -1368,8 +1530,11 @@ msgid "mutable" msgstr "" msgid "" -"Mutable objects can change their value but keep their :func:`id`. See also :" -"term:`immutable`." +"An :term:`object` with state that is allowed to change during the course of " +"the program. In multi-threaded programs, mutable objects that are shared " +"between threads require careful synchronization to avoid :term:`race " +"conditions `. See also :term:`immutable`, :term:`thread-" +"safe`, and :term:`concurrent modification`." msgstr "" msgid "named tuple" @@ -1382,9 +1547,9 @@ msgid "" msgstr "" msgid "" -"Several built-in types are named tuples, including the values returned by :" -"func:`time.localtime` and :func:`os.stat`. Another example is :data:`sys." -"float_info`::" +"Several built-in types are named tuples, including the values returned " +"by :func:`time.localtime` and :func:`os.stat`. Another example " +"is :data:`sys.float_info`::" msgstr "" msgid "" @@ -1400,10 +1565,11 @@ msgid "" "Some named tuples are built-in types (such as the above examples). " "Alternatively, a named tuple can be created from a regular class definition " "that inherits from :class:`tuple` and that defines named fields. Such a " -"class can be written by hand, or it can be created by inheriting :class:" -"`typing.NamedTuple`, or with the factory function :func:`collections." -"namedtuple`. The latter techniques also add some extra methods that may not " -"be found in hand-written or built-in named tuples." +"class can be written by hand, or it can be created by " +"inheriting :class:`typing.NamedTuple`, or with the factory " +"function :func:`collections.namedtuple`. The latter techniques also add " +"some extra methods that may not be found in hand-written or built-in named " +"tuples." msgstr "" msgid "namespace" @@ -1413,12 +1579,13 @@ msgid "" "The place where a variable is stored. Namespaces are implemented as " "dictionaries. There are the local, global and built-in namespaces as well " "as nested namespaces in objects (in methods). Namespaces support modularity " -"by preventing naming conflicts. For instance, the functions :func:`builtins." -"open <.open>` and :func:`os.open` are distinguished by their namespaces. " -"Namespaces also aid readability and maintainability by making it clear which " -"module implements a function. For instance, writing :func:`random.seed` or :" -"func:`itertools.islice` makes it clear that those functions are implemented " -"by the :mod:`random` and :mod:`itertools` modules, respectively." +"by preventing naming conflicts. For instance, the " +"functions :func:`builtins.open <.open>` and :func:`os.open` are " +"distinguished by their namespaces. Namespaces also aid readability and " +"maintainability by making it clear which module implements a function. For " +"instance, writing :func:`random.seed` or :func:`itertools.islice` makes it " +"clear that those functions are implemented by the :mod:`random` " +"and :mod:`itertools` modules, respectively." msgstr "" msgid "namespace package" @@ -1443,6 +1610,17 @@ msgstr "" msgid "See also :term:`module`." msgstr "" +msgid "native code" +msgstr "" + +msgid "" +"Code that is compiled to machine instructions and runs directly on the " +"processor, as opposed to code that is interpreted or runs in a virtual " +"machine. In the context of Python, native code typically refers to C, C++, " +"Rust or Fortran code in :term:`extension modules ` that " +"can be called from Python. See also :term:`extension module`." +msgstr "" + msgid "nested scope" msgstr "" @@ -1461,8 +1639,21 @@ msgstr "" msgid "" "Old name for the flavor of classes now used for all class objects. In " "earlier Python versions, only new-style classes could use Python's newer, " -"versatile features like :attr:`~object.__slots__`, descriptors, properties, :" -"meth:`~object.__getattribute__`, class methods, and static methods." +"versatile features like :attr:`~object.__slots__`, descriptors, " +"properties, :meth:`~object.__getattribute__`, class methods, and static " +"methods." +msgstr "" + +msgid "non-deterministic" +msgstr "" + +msgid "" +"Behavior where the outcome of a program can vary between executions with the " +"same inputs. In multi-threaded programs, non-deterministic behavior often " +"results from :term:`race conditions ` where the relative " +"timing or interleaving of threads affects the result. Proper synchronization " +"using :term:`locks ` and other :term:`synchronization primitives " +"` helps ensure deterministic behavior." msgstr "" msgid "object" @@ -1498,6 +1689,19 @@ msgstr "" msgid "See also :term:`regular package` and :term:`namespace package`." msgstr "" +msgid "parallelism" +msgstr "" + +msgid "" +"Executing multiple operations at the same time (e.g. on multiple CPU " +"cores). In Python builds with the :term:`global interpreter lock (GIL) " +"`, only one thread runs Python bytecode at a time, " +"so taking advantage of multiple CPU cores typically involves multiple " +"processes (e.g. :mod:`multiprocessing`) or native extensions that release " +"the GIL. In :term:`free-threaded ` Python, multiple Python " +"threads can run Python code simultaneously on different cores." +msgstr "" + msgid "parameter" msgstr "" @@ -1564,8 +1768,21 @@ msgstr "" msgid "" "See also the :term:`argument` glossary entry, the FAQ question on :ref:`the " "difference between arguments and parameters `, " -"the :class:`inspect.Parameter` class, the :ref:`function` section, and :pep:" -"`362`." +"the :class:`inspect.Parameter` class, the :ref:`function` section, " +"and :pep:`362`." +msgstr "" + +msgid "per-object lock" +msgstr "" + +msgid "" +"A :term:`lock` associated with an individual object instance rather than a " +"global lock shared across all objects. In :term:`free-threaded ` Python, built-in types like :class:`dict` and :class:`list` use " +"per-object locks to allow concurrent operations on different objects while " +"serializing operations on the same object. Operations that hold the per-" +"object lock prevent other locking operations on the same object from " +"proceeding, but do not block :term:`lock-free` operations." msgstr "" msgid "path entry" @@ -1580,9 +1797,9 @@ msgid "path entry finder" msgstr "" msgid "" -"A :term:`finder` returned by a callable on :data:`sys.path_hooks` (i.e. a :" -"term:`path entry hook`) which knows how to locate modules given a :term:" -"`path entry`." +"A :term:`finder` returned by a callable on :data:`sys.path_hooks` (i.e. " +"a :term:`path entry hook`) which knows how to locate modules given " +"a :term:`path entry`." msgstr "" msgid "" @@ -1611,14 +1828,14 @@ msgid "path-like object" msgstr "" msgid "" -"An object representing a file system path. A path-like object is either a :" -"class:`str` or :class:`bytes` object representing a path, or an object " -"implementing the :class:`os.PathLike` protocol. An object that supports the :" -"class:`os.PathLike` protocol can be converted to a :class:`str` or :class:" -"`bytes` file system path by calling the :func:`os.fspath` function; :func:" -"`os.fsdecode` and :func:`os.fsencode` can be used to guarantee a :class:" -"`str` or :class:`bytes` result instead, respectively. Introduced by :pep:" -"`519`." +"An object representing a file system path. A path-like object is either " +"a :class:`str` or :class:`bytes` object representing a path, or an object " +"implementing the :class:`os.PathLike` protocol. An object that supports " +"the :class:`os.PathLike` protocol can be converted to a :class:`str` " +"or :class:`bytes` file system path by calling the :func:`os.fspath` " +"function; :func:`os.fsdecode` and :func:`os.fsencode` can be used to " +"guarantee a :class:`str` or :class:`bytes` result instead, respectively. " +"Introduced by :pep:`519`." msgstr "" msgid "PEP" @@ -1755,8 +1972,8 @@ msgstr "" msgid "" "When used to refer to modules, the *fully qualified name* means the entire " -"dotted path to the module, including any parent packages, e.g. ``email.mime." -"text``::" +"dotted path to the module, including any parent packages, e.g. " +"``email.mime.text``::" msgstr "" msgid "" @@ -1768,6 +1985,21 @@ msgstr "" ">>> email.mime.text.__name__\n" "'email.mime.text'" +msgid "race condition" +msgstr "" + +msgid "" +"A condition of a program where the behavior depends on the relative timing " +"or ordering of events, particularly in multi-threaded programs. Race " +"conditions can lead to :term:`non-deterministic` behavior and bugs that are " +"difficult to reproduce. A :term:`data race` is a specific type of race " +"condition involving unsynchronized access to shared memory. " +"The :term:`LBYL` coding style is particularly susceptible to race conditions " +"in multi-threaded code. Using :term:`locks ` and " +"other :term:`synchronization primitives ` helps " +"prevent race conditions." +msgstr "" + msgid "reference count" msgstr "" @@ -1781,23 +2013,56 @@ msgid "" "reference count for a particular object." msgstr "" +msgid "" +"In :term:`CPython`, reference counts are not considered to be stable or well-" +"defined values; the number of references to an object, and how that number " +"is affected by Python code, may be different between versions." +msgstr "" + msgid "regular package" msgstr "" msgid "" -"A traditional :term:`package`, such as a directory containing an ``__init__." -"py`` file." +"A traditional :term:`package`, such as a directory containing an " +"``__init__.py`` file." msgstr "" msgid "See also :term:`namespace package`." msgstr "" +msgid "reentrant" +msgstr "" + +msgid "" +"A property of a function or :term:`lock` that allows it to be called or " +"acquired multiple times by the same thread without causing errors or " +"a :term:`deadlock`." +msgstr "" + +msgid "" +"For functions, reentrancy means the function can be safely called again " +"before a previous invocation has completed, which is important when " +"functions may be called recursively or from signal handlers. Thread-unsafe " +"functions may be :term:`non-deterministic` if they're called reentrantly in " +"a multithreaded program." +msgstr "" + +msgid "" +"For locks, Python's :class:`threading.RLock` (reentrant lock) is reentrant, " +"meaning a thread that already holds the lock can acquire it again without " +"blocking. In contrast, :class:`threading.Lock` is not reentrant - " +"attempting to acquire it twice from the same thread will cause a deadlock." +msgstr "" + +msgid "See also :term:`lock` and :term:`deadlock`." +msgstr "" + msgid "REPL" msgstr "REPL" msgid "" -"An acronym for the \"read–eval–print loop\", another name for the :term:" -"`interactive` interpreter shell." +"An acronym for the \"read–eval–print loop\", another name for " +"the :term:`interactive` interpreter shell." msgstr "" msgid "__slots__" @@ -1816,23 +2081,24 @@ msgstr "sekwencja" msgid "" "An :term:`iterable` which supports efficient element access using integer " -"indices via the :meth:`~object.__getitem__` special method and defines a :" -"meth:`~object.__len__` method that returns the length of the sequence. Some " -"built-in sequence types are :class:`list`, :class:`str`, :class:`tuple`, " -"and :class:`bytes`. Note that :class:`dict` also supports :meth:`~object." -"__getitem__` and :meth:`!__len__`, but is considered a mapping rather than a " -"sequence because the lookups use arbitrary :term:`hashable` keys rather than " -"integers." +"indices via the :meth:`~object.__getitem__` special method and defines " +"a :meth:`~object.__len__` method that returns the length of the sequence. " +"Some built-in sequence types " +"are :class:`list`, :class:`str`, :class:`tuple`, and :class:`bytes`. Note " +"that :class:`dict` also supports :meth:`~object.__getitem__` and :meth:`!" +"__len__`, but is considered a mapping rather than a sequence because the " +"lookups use arbitrary :term:`hashable` keys rather than integers." msgstr "" msgid "" "The :class:`collections.abc.Sequence` abstract base class defines a much " -"richer interface that goes beyond just :meth:`~object.__getitem__` and :meth:" -"`~object.__len__`, adding :meth:`!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 `." +"richer interface that goes beyond just :meth:`~object.__getitem__` " +"and :meth:`~object.__len__`, " +"adding :meth:`~sequence.count`, :meth:`~sequence.index`, :meth:`~object.__contains__`, " +"and :meth:`~object.__reversed__`. Types that implement this expanded " +"interface can be registered explicitly using :func:`~abc.ABCMeta.register`. " +"For more documentation on sequence methods generally, see :ref:`Common " +"Sequence Operations `." msgstr "" msgid "set comprehension" @@ -1841,8 +2107,8 @@ msgstr "" msgid "" "A compact way to process all or part of the elements in an iterable and " "return a set with the results. ``results = {c for c in 'abracadabra' if c " -"not in 'abc'}`` generates the set of strings ``{'r', 'd'}``. See :ref:" -"`comprehensions`." +"not in 'abc'}`` generates the set of strings ``{'r', 'd'}``. " +"See :ref:`comprehensions`." msgstr "" msgid "single dispatch" @@ -1888,8 +2154,24 @@ msgstr "" msgid "" "A method that is called implicitly by Python to execute a certain operation " "on a type, such as addition. Such methods have names starting and ending " -"with double underscores. Special methods are documented in :ref:" -"`specialnames`." +"with double underscores. Special methods are documented " +"in :ref:`specialnames`." +msgstr "" + +msgid "standard library" +msgstr "" + +msgid "" +"The collection of :term:`packages `, :term:`modules ` " +"and :term:`extension modules ` distributed as a part of " +"the official Python interpreter package. The exact membership of the " +"collection may vary based on platform, available system libraries, or other " +"criteria. Documentation can be found at :ref:`library-index`." +msgstr "" + +msgid "" +"See also :data:`sys.stdlib_module_names` for a list of all possible standard " +"library module names." msgstr "" msgid "statement" @@ -1897,8 +2179,8 @@ msgstr "instrukcja" msgid "" "A statement is part of a suite (a \"block\" of code). A statement is either " -"an :term:`expression` or one of several constructs with a keyword, such as :" -"keyword:`if`, :keyword:`while` or :keyword:`for`." +"an :term:`expression` or one of several constructs with a keyword, such " +"as :keyword:`if`, :keyword:`while` or :keyword:`for`." msgstr "" msgid "static type checker" @@ -1906,8 +2188,27 @@ msgstr "" msgid "" "An external tool that reads Python code and analyzes it, looking for issues " -"such as incorrect types. See also :term:`type hints ` and the :" -"mod:`typing` module." +"such as incorrect types. See also :term:`type hints ` and " +"the :mod:`typing` module." +msgstr "" + +msgid "stdlib" +msgstr "" + +msgid "An abbreviation of :term:`standard library`." +msgstr "" + +msgid "steal" +msgstr "" + +msgid "" +"In Python's C API, \"*stealing*\" an argument means that ownership of the " +"argument is transferred to the called function. The caller must not use that " +"reference after the call. Generally, functions that \"steal\" an argument do " +"so even if they fail." +msgstr "" + +msgid "See :ref:`api-refcountdetails` for a full explanation." msgstr "" msgid "strong reference" @@ -1916,8 +2217,8 @@ msgstr "" msgid "" "In Python's C API, a strong reference is a reference to an object which is " "owned by the code holding the reference. The strong reference is taken by " -"calling :c:func:`Py_INCREF` when the reference is created and released with :" -"c:func:`Py_DECREF` when the reference is deleted." +"calling :c:func:`Py_INCREF` when the reference is created and released " +"with :c:func:`Py_DECREF` when the reference is deleted." msgstr "" msgid "" @@ -1930,6 +2231,20 @@ msgstr "" msgid "See also :term:`borrowed reference`." msgstr "" +msgid "synchronization primitive" +msgstr "" + +msgid "" +"A basic building block for coordinating (synchronizing) the execution of " +"multiple threads to ensure :term:`thread-safe` access to shared resources. " +"Python's :mod:`threading` module provides several synchronization primitives " +"including :class:`~threading.Lock`, :class:`~threading.RLock`, :class:`~threading.Semaphore`, :class:`~threading.Condition`, :class:`~threading.Event`, " +"and :class:`~threading.Barrier`. Additionally, the :mod:`queue` module " +"provides multi-producer, multi-consumer queues that are especially useful in " +"multithreaded programs. These primitives help prevent :term:`race conditions " +"` and coordinate thread execution. See also :term:`lock`." +msgstr "" + msgid "text encoding" msgstr "kodowanie tekstu" @@ -1956,21 +2271,39 @@ msgstr "plik tekstowy" msgid "" "A :term:`file object` able to read and write :class:`str` objects. Often, a " -"text file actually accesses a byte-oriented datastream and handles the :term:" -"`text encoding` automatically. Examples of text files are files opened in " -"text mode (``'r'`` or ``'w'``), :data:`sys.stdin`, :data:`sys.stdout`, and " -"instances of :class:`io.StringIO`." +"text file actually accesses a byte-oriented datastream and handles " +"the :term:`text encoding` automatically. Examples of text files are files " +"opened in text mode (``'r'`` or " +"``'w'``), :data:`sys.stdin`, :data:`sys.stdout`, and instances " +"of :class:`io.StringIO`." msgstr "" -":term:`Obiekt pliku ` może odczytywać i zapisywać obiekty :" -"class:`str`. Często plik tekstowy faktycznie uzyskuje dostęp do strumienia " -"danych zorientowanego na bajty i automatycznie obsługuje :term:`kodowanie " -"tekstu `. Przykładami plików tekstowych są pliki otwierane w " -"trybie tekstowym (``'r'`` lub ``'w'``), :data:`sys.stdin`, :data:`sys." -"stdout` i instancje :class:`io.StringIO`." +":term:`Obiekt pliku ` może odczytywać i zapisywać " +"obiekty :class:`str`. Często plik tekstowy faktycznie uzyskuje dostęp do " +"strumienia danych zorientowanego na bajty i automatycznie " +"obsługuje :term:`kodowanie tekstu `. Przykładami plików " +"tekstowych są pliki otwierane w trybie tekstowym (``'r'`` lub " +"``'w'``), :data:`sys.stdin`, :data:`sys.stdout` i " +"instancje :class:`io.StringIO`." msgid "" -"See also :term:`binary file` for a file object able to read and write :term:" -"`bytes-like objects `." +"See also :term:`binary file` for a file object able to read and " +"write :term:`bytes-like objects `." +msgstr "" + +msgid "thread-safe" +msgstr "" + +msgid "" +"A module, function, or class that behaves correctly when used by multiple " +"threads concurrently. Thread-safe code uses " +"appropriate :term:`synchronization primitives ` " +"like :term:`locks ` to protect shared mutable state, or is designed to " +"avoid shared mutable state entirely. In the :term:`free-threaded ` build, built-in types like :class:`dict`, :class:`list`, " +"and :class:`set` use internal locking to make many operations thread-safe, " +"although thread safety is not necessarily guaranteed. Code that is not " +"thread-safe may experience :term:`race conditions ` " +"and :term:`data races ` when used in multi-threaded programs." msgstr "" msgid "token" @@ -1983,8 +2316,8 @@ msgid "" msgstr "" msgid "" -"The :mod:`tokenize` module exposes Python's lexical analyzer. The :mod:" -"`token` module contains information on the various types of tokens." +"The :mod:`tokenize` module exposes Python's lexical analyzer. " +"The :mod:`token` module contains information on the various types of tokens." msgstr "" msgid "triple-quoted string" @@ -2005,8 +2338,9 @@ msgstr "typ" msgid "" "The type of a Python object determines what kind of object it is; every " -"object has a type. An object's type is accessible as its :attr:`~object." -"__class__` attribute or can be retrieved with ``type(obj)``." +"object has a type. An object's type is accessible as " +"its :attr:`~object.__class__` attribute or can be retrieved with " +"``type(obj)``." msgstr "" msgid "type alias" @@ -2065,8 +2399,8 @@ msgid "" "A manner of interpreting text streams in which all of the following are " "recognized as ending a line: the Unix end-of-line convention ``'\\n'``, the " "Windows convention ``'\\r\\n'``, and the old Macintosh convention " -"``'\\r'``. See :pep:`278` and :pep:`3116`, as well as :func:`bytes." -"splitlines` for an additional use." +"``'\\r'``. See :pep:`278` and :pep:`3116`, as well " +"as :func:`bytes.splitlines` for an additional use." msgstr "" msgid "variable annotation" @@ -2122,6 +2456,15 @@ msgid "" "the :term:`bytecode` emitted by the bytecode compiler." msgstr "" +msgid "walrus operator" +msgstr "" + +msgid "" +"A light-hearted way to refer to the :ref:`assignment expression ` operator ``:=`` because it looks a bit like a walrus if you " +"turn your head." +msgstr "" + msgid "Zen of Python" msgstr "" @@ -2131,6 +2474,12 @@ msgid "" "\"``import this``\" at the interactive prompt." msgstr "" +msgid "..." +msgstr "..." + +msgid "ellipsis literal" +msgstr "Literalny zapis wielokropka" + msgid "C-contiguous" msgstr "" diff --git a/howto/a-conceptual-overview-of-asyncio.po b/howto/a-conceptual-overview-of-asyncio.po new file mode 100644 index 0000000000..3b2e65acfc --- /dev/null +++ b/howto/a-conceptual-overview-of-asyncio.po @@ -0,0 +1,731 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 2001-2026, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +# Translators: +# Blessing Oluronbi, 2026 +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 3.13\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" +"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" +"Language: pl\n" +"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && " +"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " +"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" + +msgid "A Conceptual Overview of :mod:`!asyncio`" +msgstr "" + +msgid "" +"This :ref:`HOWTO ` article seeks to help you build a sturdy mental " +"model of how :mod:`asyncio` fundamentally works, helping you understand the " +"how and why behind the recommended patterns." +msgstr "" +"Ten artykuł :ref:`HOWTO` ma na celu pomóc Ci zbudować solidny model mentalny " +"tego, jak działa podstawa, pomagając Ci zrozumieć, jak i dlaczego zalecane " +"wzorce działają.:mod:`asyncio`" + +msgid "" +"You might be curious about some key :mod:`!asyncio` concepts. By the end of " +"this article, you'll be able to comfortably answer these questions:" +msgstr "" +"Być może ciekawią Cię pewne kluczowe:mod:`!asyncio` koncepcje. Pod koniec " +"tego artykułu będziesz w stanie bez problemu odpowiedzieć na te pytania:" + +msgid "What's happening behind the scenes when an object is awaited?" +msgstr "" + +msgid "" +"How does :mod:`!asyncio` differentiate between a task which doesn't need CPU " +"time (such as a network request or file read) as opposed to a task that does " +"(such as computing n-factorial)?" +msgstr "" + +msgid "" +"How to write an asynchronous variant of an operation, such as an async sleep " +"or database request." +msgstr "" + +msgid "" +"The `guide `_ that inspired this HOWTO article, by Alexander Nordin." +msgstr "" + +msgid "" +"This in-depth `YouTube tutorial series `_ on ``asyncio`` " +"created by Python core team member, Łukasz Langa." +msgstr "" + +msgid "" +"`500 Lines or Less: A Web Crawler With asyncio Coroutines `_ by A. " +"Jesse Jiryu Davis and Guido van Rossum." +msgstr "" + +msgid "A conceptual overview part 1: the high-level" +msgstr "" + +msgid "" +"In part 1, we'll cover the main, high-level building blocks of :mod:`!" +"asyncio`: the event loop, coroutine functions, coroutine objects, tasks, and " +"``await``." +msgstr "" + +msgid "Event Loop" +msgstr "" + +msgid "" +"Everything in :mod:`!asyncio` happens relative to the event loop. It's the " +"star of the show. It's like an orchestra conductor. It's behind the scenes " +"managing resources. Some power is explicitly granted to it, but a lot of its " +"ability to get things done comes from the respect and cooperation of its " +"worker bees." +msgstr "" + +msgid "" +"In more technical terms, the event loop contains a collection of jobs to be " +"run. Some jobs are added directly by you, and some indirectly by :mod:`!" +"asyncio`. The event loop takes a job from its backlog of work and invokes it " +"(or \"gives it control\"), similar to calling a function, and then that job " +"runs. Once it pauses or completes, it returns control to the event loop. The " +"event loop will then select another job from its pool and invoke it. You can " +"*roughly* think of the collection of jobs as a queue: jobs are added and " +"then processed one at a time, generally (but not always) in order. This " +"process repeats indefinitely, with the event loop cycling endlessly onwards. " +"If there are no more jobs pending execution, the event loop is smart enough " +"to rest and avoid needlessly wasting CPU cycles, and will come back when " +"there's more work to be done." +msgstr "" + +msgid "" +"Effective execution relies on jobs sharing well and cooperating; a greedy " +"job could hog control and leave the other jobs to starve, rendering the " +"overall event loop approach rather useless." +msgstr "" + +msgid "" +"import asyncio\n" +"\n" +"# This creates an event loop and indefinitely cycles through\n" +"# its collection of jobs.\n" +"event_loop = asyncio.new_event_loop()\n" +"event_loop.run_forever()" +msgstr "" + +msgid "Asynchronous functions and coroutines" +msgstr "" + +msgid "This is a basic, boring Python function::" +msgstr "" + +msgid "" +"def hello_printer():\n" +" print(\n" +" \"Hi, I am a lowly, simple printer, though I have all I \"\n" +" \"need in life -- \\nfresh paper and my dearly beloved octopus \"\n" +" \"partner in crime.\"\n" +" )" +msgstr "" + +msgid "Calling a regular function invokes its logic or body::" +msgstr "" + +msgid "" +">>> hello_printer()\n" +"Hi, I am a lowly, simple printer, though I have all I need in life --\n" +"fresh paper and my dearly beloved octopus partner in crime." +msgstr "" + +msgid "" +"The :ref:`async def `, as opposed to just a plain ``def``, makes " +"this an asynchronous function (or \"coroutine function\"). Calling it " +"creates and returns a :ref:`coroutine ` object." +msgstr "" + +msgid "" +"async def loudmouth_penguin(magic_number: int):\n" +" print(\n" +" \"I am a super special talking penguin. Far cooler than that printer. " +"\"\n" +" f\"By the way, my lucky number is: {magic_number}.\"\n" +" )" +msgstr "" + +msgid "" +"Calling the async function, ``loudmouth_penguin``, does not execute the " +"print statement; instead, it creates a coroutine object::" +msgstr "" + +msgid "" +">>> loudmouth_penguin(magic_number=3)\n" +"" +msgstr "" + +msgid "" +"The terms \"coroutine function\" and \"coroutine object\" are often " +"conflated as coroutine. That can be confusing! In this article, coroutine " +"specifically refers to a coroutine object, or more precisely, an instance " +"of :class:`types.CoroutineType` (native coroutine). Note that coroutines can " +"also exist as instances of :class:`collections.abc.Coroutine` -- a " +"distinction that matters for type checking." +msgstr "" + +msgid "" +"A coroutine represents the function's body or logic. A coroutine has to be " +"explicitly started; again, merely creating the coroutine does not start it. " +"Notably, the coroutine can be paused and resumed at various points within " +"the function's body. That pausing and resuming ability is what allows for " +"asynchronous behavior!" +msgstr "" + +msgid "" +"Coroutines and coroutine functions were built by leveraging the " +"functionality of :term:`generators ` " +"and :term:`generator functions `. Recall, a generator function is " +"a function that :keyword:`yield`\\s, like this one::" +msgstr "" + +msgid "" +"def get_random_number():\n" +" # This would be a bad random number generator!\n" +" print(\"Hi\")\n" +" yield 1\n" +" print(\"Hello\")\n" +" yield 7\n" +" print(\"Howdy\")\n" +" yield 4\n" +" ..." +msgstr "" + +msgid "" +"Similar to a coroutine function, calling a generator function does not run " +"it. Instead, it creates a generator object::" +msgstr "" + +msgid "" +">>> get_random_number()\n" +"" +msgstr "" + +msgid "" +"You can proceed to the next ``yield`` of a generator by using the built-in " +"function :func:`next`. In other words, the generator runs, then pauses. For " +"example::" +msgstr "" + +msgid "" +">>> generator = get_random_number()\n" +">>> next(generator)\n" +"Hi\n" +"1\n" +">>> next(generator)\n" +"Hello\n" +"7" +msgstr "" + +msgid "Tasks" +msgstr "" + +msgid "" +"Roughly speaking, :ref:`tasks ` are coroutines (not " +"coroutine functions) tied to an event loop. A task also maintains a list of " +"callback functions whose importance will become clear in a moment when we " +"discuss :keyword:`await`. The recommended way to create tasks is " +"via :func:`asyncio.create_task`." +msgstr "" + +msgid "" +"Creating a task automatically schedules it for execution (by adding a " +"callback to run it in the event loop's to-do list, that is, collection of " +"jobs)." +msgstr "" + +msgid "" +":mod:`!asyncio` automatically associates tasks with the event loop for you. " +"This automatic association was purposely designed into :mod:`!asyncio` for " +"the sake of simplicity. Without it, you'd have to keep track of the event " +"loop object and pass it to any coroutine function that wants to create " +"tasks, adding redundant clutter to your code." +msgstr "" + +msgid "" +"coroutine = loudmouth_penguin(magic_number=5)\n" +"# This creates a Task object and schedules its execution via the event " +"loop.\n" +"task = asyncio.create_task(coroutine)" +msgstr "" + +msgid "" +"Earlier, we manually created the event loop and set it to run forever. In " +"practice, it's recommended to use (and common to see) :func:`asyncio.run`, " +"which takes care of managing the event loop and ensuring the provided " +"coroutine finishes before advancing. For example, many async programs follow " +"this setup::" +msgstr "" + +msgid "" +"import asyncio\n" +"\n" +"async def main():\n" +" # Perform all sorts of wacky, wild asynchronous things...\n" +" ...\n" +"\n" +"if __name__ == \"__main__\":\n" +" asyncio.run(main())\n" +" # The program will not reach the following print statement until the\n" +" # coroutine main() finishes.\n" +" print(\"coroutine main() is done!\")" +msgstr "" + +msgid "" +"It's important to be aware that the task itself is not added to the event " +"loop, only a callback to the task is. This matters if the task object you " +"created is garbage collected before it's called by the event loop. For " +"example, consider this program:" +msgstr "" + +msgid "" +"async def hello():\n" +" print(\"hello!\")\n" +"\n" +"async def main():\n" +" asyncio.create_task(hello())\n" +" # Other asynchronous instructions which run for a while\n" +" # and cede control to the event loop...\n" +" ...\n" +"\n" +"asyncio.run(main())" +msgstr "" + +msgid "" +"Because there's no reference to the task object created on line 5, it " +"*might* be garbage collected before the event loop invokes it. Later " +"instructions in the coroutine ``main()`` hand control back to the event loop " +"so it can invoke other jobs. When the event loop eventually tries to run the " +"task, it might fail and discover the task object does not exist! This can " +"also happen even if a coroutine keeps a reference to a task but completes " +"before that task finishes. When the coroutine exits, local variables go out " +"of scope and may be subject to garbage collection. In practice, ``asyncio`` " +"and Python's garbage collector work pretty hard to ensure this sort of thing " +"doesn't happen. But that's no reason to be reckless!" +msgstr "" + +msgid "await" +msgstr "" + +msgid "" +":keyword:`await` is a Python keyword that's commonly used in one of two " +"different ways::" +msgstr "" + +msgid "" +"await task\n" +"await coroutine" +msgstr "" + +msgid "" +"In a crucial way, the behavior of ``await`` depends on the type of object " +"being awaited." +msgstr "" + +msgid "" +"Awaiting a task will cede control from the current task or coroutine to the " +"event loop. In the process of relinquishing control, a few important things " +"happen. We'll use the following code example to illustrate::" +msgstr "" + +msgid "" +"async def plant_a_tree():\n" +" dig_the_hole_task = asyncio.create_task(dig_the_hole())\n" +" await dig_the_hole_task\n" +"\n" +" # Other instructions associated with planting a tree.\n" +" ..." +msgstr "" + +msgid "" +"In this example, imagine the event loop has passed control to the start of " +"the coroutine ``plant_a_tree()``. As seen above, the coroutine creates a " +"task and then awaits it. The ``await dig_the_hole_task`` instruction adds a " +"callback (which will resume ``plant_a_tree()``) to the ``dig_the_hole_task`` " +"object's list of callbacks. And then, the instruction cedes control to the " +"event loop. Some time later, the event loop will pass control to " +"``dig_the_hole_task`` and the task will finish whatever it needs to do. Once " +"the task finishes, it will add its various callbacks to the event loop, in " +"this case, a call to resume ``plant_a_tree()``." +msgstr "" + +msgid "" +"Generally speaking, when the awaited task finishes (``dig_the_hole_task``), " +"the original task or coroutine (``plant_a_tree()``) is added back to the " +"event loop's to-do list to be resumed." +msgstr "" + +msgid "" +"This is a basic, yet reliable mental model. In practice, the control " +"handoffs are slightly more complex, but not by much. In part 2, we'll walk " +"through the details that make this possible." +msgstr "" + +msgid "" +"**Unlike tasks, awaiting a coroutine does not hand control back to the event " +"loop!** Wrapping a coroutine in a task first, then awaiting that would cede " +"control. The behavior of ``await coroutine`` is effectively the same as " +"invoking a regular, synchronous Python function. Consider this program::" +msgstr "" + +msgid "" +"import asyncio\n" +"\n" +"async def coro_a():\n" +" print(\"I am coro_a(). Hi!\")\n" +"\n" +"async def coro_b():\n" +" print(\"I am coro_b(). I sure hope no one hogs the event loop...\")\n" +"\n" +"async def main():\n" +" task_b = asyncio.create_task(coro_b())\n" +" num_repeats = 3\n" +" for _ in range(num_repeats):\n" +" await coro_a()\n" +" await task_b\n" +"\n" +"asyncio.run(main())" +msgstr "" + +msgid "" +"The first statement in the coroutine ``main()`` creates ``task_b`` and " +"schedules it for execution via the event loop. Then, ``coro_a()`` is " +"repeatedly awaited. Control never cedes to the event loop, which is why we " +"see the output of all three ``coro_a()`` invocations before ``coro_b()``'s " +"output:" +msgstr "" + +msgid "" +"I am coro_a(). Hi!\n" +"I am coro_a(). Hi!\n" +"I am coro_a(). Hi!\n" +"I am coro_b(). I sure hope no one hogs the event loop..." +msgstr "" + +msgid "" +"If we change ``await coro_a()`` to ``await asyncio.create_task(coro_a())``, " +"the behavior changes. The coroutine ``main()`` cedes control to the event " +"loop with that statement. The event loop then proceeds through its backlog " +"of work, calling ``task_b`` and then the task which wraps ``coro_a()`` " +"before resuming the coroutine ``main()``." +msgstr "" + +msgid "" +"I am coro_b(). I sure hope no one hogs the event loop...\n" +"I am coro_a(). Hi!\n" +"I am coro_a(). Hi!\n" +"I am coro_a(). Hi!" +msgstr "" + +msgid "" +"This behavior of ``await coroutine`` can trip a lot of people up! That " +"example highlights how using only ``await coroutine`` could unintentionally " +"hog control from other tasks and effectively stall the event " +"loop. :func:`asyncio.run` can help you detect such occurrences via the " +"``debug=True`` flag, which enables :ref:`debug mode `. " +"Among other things, it will log any coroutines that monopolize execution for " +"100ms or longer." +msgstr "" + +msgid "" +"The design intentionally trades off some conceptual clarity around usage of " +"``await`` for improved performance. Each time a task is awaited, control " +"needs to be passed all the way up the call stack to the event loop. That " +"might sound minor, but in a large program with many ``await`` statements and " +"a deep call stack, that overhead can add up to a meaningful performance drag." +msgstr "" + +msgid "A conceptual overview part 2: the nuts and bolts" +msgstr "" + +msgid "" +"Part 2 goes into detail on the mechanisms :mod:`!asyncio` uses to manage " +"control flow. This is where the magic happens. You'll come away from this " +"section knowing what ``await`` does behind the scenes and how to make your " +"own asynchronous operators." +msgstr "" + +msgid "The inner workings of coroutines" +msgstr "" + +msgid ":mod:`!asyncio` leverages four components to pass around control." +msgstr "" + +msgid "" +":meth:`coroutine.send(arg) ` is the method used to start or " +"resume a coroutine. If the coroutine was paused and is now being resumed, " +"the argument ``arg`` will be sent in as the return value of the ``yield`` " +"statement which originally paused it. If the coroutine is being used for the " +"first time (as opposed to being resumed), ``arg`` must be ``None``." +msgstr "" + +msgid "" +"class Rock:\n" +" def __await__(self):\n" +" value_sent_in = yield 7\n" +" print(f\"Rock.__await__ resuming with value: {value_sent_in}.\")\n" +" return value_sent_in\n" +"\n" +"async def main():\n" +" print(\"Beginning coroutine main().\")\n" +" rock = Rock()\n" +" print(\"Awaiting rock...\")\n" +" value_from_rock = await rock\n" +" print(f\"Coroutine received value: {value_from_rock} from rock.\")\n" +" return 23\n" +"\n" +"coroutine = main()\n" +"intermediate_result = coroutine.send(None)\n" +"print(f\"Coroutine paused and returned intermediate value: " +"{intermediate_result}.\")\n" +"\n" +"print(f\"Resuming coroutine and sending in value: 42.\")\n" +"try:\n" +" coroutine.send(42)\n" +"except StopIteration as e:\n" +" returned_value = e.value\n" +"print(f\"Coroutine main() finished and provided value: {returned_value}.\")" +msgstr "" + +msgid "" +":ref:`yield `, as usual, pauses execution and returns control to " +"the caller. In the example above, the ``yield``, on line 3, is called by " +"``... = await rock`` on line 11. More broadly speaking, ``await`` calls " +"the :meth:`~object.__await__` method of the given object. ``await`` also " +"does one more very special thing: it propagates (or \"passes along\") any " +"``yield``\\ s it receives up the call chain. In this case, that's back to " +"``... = coroutine.send(None)`` on line 16." +msgstr "" + +msgid "" +"The coroutine is resumed via the ``coroutine.send(42)`` call on line 21. The " +"coroutine picks back up from where it ``yield``\\ ed (or paused) on line 3 " +"and executes the remaining statements in its body. When a coroutine " +"finishes, it raises a :exc:`StopIteration` exception with the return value " +"attached in the :attr:`~StopIteration.value` attribute." +msgstr "" + +msgid "That snippet produces this output:" +msgstr "" + +msgid "" +"Beginning coroutine main().\n" +"Awaiting rock...\n" +"Coroutine paused and returned intermediate value: 7.\n" +"Resuming coroutine and sending in value: 42.\n" +"Rock.__await__ resuming with value: 42.\n" +"Coroutine received value: 42 from rock.\n" +"Coroutine main() finished and provided value: 23." +msgstr "" + +msgid "" +"It's worth pausing for a moment here and making sure you followed the " +"various ways that control flow and values were passed. A lot of important " +"ideas were covered and it's worth ensuring your understanding is firm." +msgstr "" + +msgid "" +"The only way to yield (or effectively cede control) from a coroutine is to " +"``await`` an object that ``yield``\\ s in its ``__await__`` method. That " +"might sound odd to you. You might be thinking:" +msgstr "" + +msgid "" +"1. What about a ``yield`` directly within the coroutine function? The " +"coroutine function becomes an :ref:`async generator function `, a different beast entirely." +msgstr "" + +msgid "" +"2. What about a :ref:`yield from ` within the coroutine function " +"to a (plain) generator? That causes the error: ``SyntaxError: yield from not " +"allowed in a coroutine.`` This was intentionally designed for the sake of " +"simplicity -- mandating only one way of using coroutines. Initially " +"``yield`` was barred as well, but was re-accepted to allow for async " +"generators. Despite that, ``yield from`` and ``await`` effectively do the " +"same thing." +msgstr "" + +msgid "Futures" +msgstr "" + +msgid "" +"A :ref:`future ` is an object meant to represent a " +"computation's status and result. The term is a nod to the idea of something " +"still to come or not yet happened, and the object is a way to keep an eye on " +"that something." +msgstr "" + +msgid "" +"A future has a few important attributes. One is its state, which can be " +"either \"pending\", \"cancelled\", or \"done\". Another is its result, which " +"is set when the state transitions to done. Unlike a coroutine, a future does " +"not represent the actual computation to be done; instead, it represents the " +"status and result of that computation, kind of like a status light (red, " +"yellow, or green) or indicator." +msgstr "" + +msgid "" +":class:`asyncio.Task` subclasses :class:`asyncio.Future` in order to gain " +"these various capabilities. The prior section said tasks store a list of " +"callbacks, which wasn't entirely accurate. It's actually the ``Future`` " +"class that implements this logic, which ``Task`` inherits." +msgstr "" + +msgid "" +"Futures may also be used directly (not via tasks). Tasks mark themselves as " +"done when their coroutine is complete. Futures are much more versatile and " +"will be marked as done when you say so. In this way, they're the flexible " +"interface for you to make your own conditions for waiting and resuming." +msgstr "" + +msgid "A homemade asyncio.sleep" +msgstr "" + +msgid "" +"We'll go through an example of how you could leverage a future to create " +"your own variant of asynchronous sleep (``async_sleep``) which " +"mimics :func:`asyncio.sleep`." +msgstr "" + +msgid "" +"This snippet registers a few tasks with the event loop and then awaits the " +"task created by ``asyncio.create_task``, which wraps the ``async_sleep(3)`` " +"coroutine. We want that task to finish only after three seconds have " +"elapsed, but without preventing other tasks from running." +msgstr "" + +msgid "" +"async def other_work():\n" +" print(\"I like work. Work work.\")\n" +"\n" +"async def main():\n" +" # Add a few other tasks to the event loop, so there's something\n" +" # to do while asynchronously sleeping.\n" +" work_tasks = [\n" +" asyncio.create_task(other_work()),\n" +" asyncio.create_task(other_work()),\n" +" asyncio.create_task(other_work())\n" +" ]\n" +" print(\n" +" \"Beginning asynchronous sleep at time: \"\n" +" f\"{datetime.datetime.now().strftime(\"%H:%M:%S\")}.\"\n" +" )\n" +" await asyncio.create_task(async_sleep(3))\n" +" print(\n" +" \"Done asynchronous sleep at time: \"\n" +" f\"{datetime.datetime.now().strftime(\"%H:%M:%S\")}.\"\n" +" )\n" +" # asyncio.gather effectively awaits each task in the collection.\n" +" await asyncio.gather(*work_tasks)" +msgstr "" + +msgid "" +"Below, we use a future to enable custom control over when that task will be " +"marked as done. If :meth:`future.set_result() ` " +"(the method responsible for marking that future as done) is never called, " +"then this task will never finish. We've also enlisted the help of another " +"task, which we'll see in a moment, that will monitor how much time has " +"elapsed and, accordingly, call ``future.set_result()``." +msgstr "" + +msgid "" +"async def async_sleep(seconds: float):\n" +" future = asyncio.Future()\n" +" time_to_wake = time.time() + seconds\n" +" # Add the watcher-task to the event loop.\n" +" watcher_task = asyncio.create_task(_sleep_watcher(future, " +"time_to_wake))\n" +" # Block until the future is marked as done.\n" +" await future" +msgstr "" + +msgid "" +"Below, we use a rather bare ``YieldToEventLoop()`` object to ``yield`` from " +"its ``__await__`` method, ceding control to the event loop. This is " +"effectively the same as calling ``asyncio.sleep(0)``, but this approach " +"offers more clarity, not to mention it's somewhat cheating to use " +"``asyncio.sleep`` when showcasing how to implement it!" +msgstr "" + +msgid "" +"As usual, the event loop cycles through its tasks, giving them control and " +"receiving control back when they pause or finish. The ``watcher_task``, " +"which runs the coroutine ``_sleep_watcher(...)``, will be invoked once per " +"full cycle of the event loop. On each resumption, it'll check the time and " +"if not enough has elapsed, then it'll pause once again and hand control back " +"to the event loop. Once enough time has elapsed, ``_sleep_watcher(...)`` " +"marks the future as done and completes by exiting its infinite ``while`` " +"loop. Given this helper task is only invoked once per cycle of the event " +"loop, you'd be correct to note that this asynchronous sleep will sleep *at " +"least* three seconds, rather than exactly three seconds. Note this is also " +"true of ``asyncio.sleep``." +msgstr "" + +msgid "" +"class YieldToEventLoop:\n" +" def __await__(self):\n" +" yield\n" +"\n" +"async def _sleep_watcher(future, time_to_wake):\n" +" while True:\n" +" if time.time() >= time_to_wake:\n" +" # This marks the future as done.\n" +" future.set_result(None)\n" +" break\n" +" else:\n" +" await YieldToEventLoop()" +msgstr "" + +msgid "Here is the full program's output:" +msgstr "" + +msgid "" +"$ python custom-async-sleep.py\n" +"Beginning asynchronous sleep at time: 14:52:22.\n" +"I like work. Work work.\n" +"I like work. Work work.\n" +"I like work. Work work.\n" +"Done asynchronous sleep at time: 14:52:25." +msgstr "" + +msgid "" +"You might feel this implementation of asynchronous sleep was unnecessarily " +"convoluted. And, well, it was. The example was meant to showcase the " +"versatility of futures with a simple example that could be mimicked for more " +"complex needs. For reference, you could implement it without futures, like " +"so::" +msgstr "" + +msgid "" +"async def simpler_async_sleep(seconds):\n" +" time_to_wake = time.time() + seconds\n" +" while True:\n" +" if time.time() >= time_to_wake:\n" +" return\n" +" else:\n" +" await YieldToEventLoop()" +msgstr "" + +msgid "" +"But that's all for now. Hopefully you're ready to more confidently dive into " +"some async programming or check out advanced topics in the :mod:`rest of the " +"documentation `." +msgstr "" diff --git a/howto/annotations.po b/howto/annotations.po index 36c8a5950d..27b1aa001a 100644 --- a/howto/annotations.po +++ b/howto/annotations.po @@ -1,22 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 +# Ciarbin , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Ciarbin , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,7 +25,7 @@ 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" @@ -44,6 +42,10 @@ msgid "" "``__annotations__`` on Python objects, we encourage you to follow the " "guidelines described below." msgstr "" +"Ten dokument ma na celu przedstawienie najlepszych praktyk dotyczących pracy " +"ze słownikami adnotacji. Jeśli piszesz kod w języku Python, który analizuje " +"``__annotations__`` na obiektach tego języka, zachęcamy do stosowania się do " +"wytycznych opisanych poniżej." msgid "" "The document is organized into four sections: best practices for accessing " @@ -56,37 +58,38 @@ msgstr "" msgid "" "Note that this document is specifically about working with " "``__annotations__``, not uses *for* annotations. If you're looking for " -"information on how to use \"type hints\" in your code, please see the :mod:" -"`typing` module." +"information on how to use \"type hints\" in your code, please see " +"the :mod:`typing` module." msgstr "" msgid "Accessing The Annotations Dict Of An Object In Python 3.10 And Newer" msgstr "" msgid "" -"Python 3.10 adds a new function to the standard library: :func:`inspect." -"get_annotations`. In Python versions 3.10 and newer, calling this function " -"is the best practice for accessing the annotations dict of any object that " -"supports annotations. This function can also \"un-stringize\" stringized " -"annotations for you." +"Python 3.10 adds a new function to the standard " +"library: :func:`inspect.get_annotations`. In Python versions 3.10 and " +"newer, calling this function is the best practice for accessing the " +"annotations dict of any object that supports annotations. This function can " +"also \"un-stringize\" stringized annotations for you." msgstr "" msgid "" "If for some reason :func:`inspect.get_annotations` isn't viable for your use " "case, you may access the ``__annotations__`` data member manually. Best " -"practice for this changed in Python 3.10 as well: as of Python 3.10, ``o." -"__annotations__`` is guaranteed to *always* work on Python functions, " +"practice for this changed in Python 3.10 as well: as of Python 3.10, " +"``o.__annotations__`` is guaranteed to *always* work on Python functions, " "classes, and modules. If you're certain the object you're examining is one " "of these three *specific* objects, you may simply use ``o.__annotations__`` " "to get at the object's annotations dict." msgstr "" msgid "" -"However, other types of callables--for example, callables created by :func:" -"`functools.partial`--may not have an ``__annotations__`` attribute defined. " -"When accessing the ``__annotations__`` of a possibly unknown object, best " -"practice in Python versions 3.10 and newer is to call :func:`getattr` with " -"three arguments, for example ``getattr(o, '__annotations__', None)``." +"However, other types of callables--for example, callables created " +"by :func:`functools.partial`--may not have an ``__annotations__`` attribute " +"defined. When accessing the ``__annotations__`` of a possibly unknown " +"object, best practice in Python versions 3.10 and newer is to " +"call :func:`getattr` with three arguments, for example ``getattr(o, " +"'__annotations__', None)``." msgstr "" msgid "" @@ -159,14 +162,14 @@ msgstr "" msgid "" "After running this code, ``ann`` should be either a dictionary or ``None``. " -"You're encouraged to double-check the type of ``ann`` using :func:" -"`isinstance` before further examination." +"You're encouraged to double-check the type of ``ann`` " +"using :func:`isinstance` before further examination." msgstr "" msgid "" -"Note that some exotic or malformed type objects may not have a :attr:`~type." -"__dict__` attribute, so for extra safety you may also wish to use :func:" -"`getattr` to access :attr:`!__dict__`." +"Note that some exotic or malformed type objects may not have " +"a :attr:`~type.__dict__` attribute, so for extra safety you may also wish to " +"use :func:`getattr` to access :attr:`!__dict__`." msgstr "" msgid "Manually Un-Stringizing Stringized Annotations" @@ -180,10 +183,11 @@ msgid "" msgstr "" msgid "" -"If you're using Python 3.9 or older, or if for some reason you can't use :" -"func:`inspect.get_annotations`, you'll need to duplicate its logic. You're " -"encouraged to examine the implementation of :func:`inspect.get_annotations` " -"in the current Python version and follow a similar approach." +"If you're using Python 3.9 or older, or if for some reason you can't " +"use :func:`inspect.get_annotations`, you'll need to duplicate its logic. " +"You're encouraged to examine the implementation " +"of :func:`inspect.get_annotations` in the current Python version and follow " +"a similar approach." msgstr "" msgid "" @@ -192,26 +196,27 @@ msgid "" msgstr "" msgid "" -"If ``o`` is a module, use ``o.__dict__`` as the ``globals`` when calling :" -"func:`eval`." +"If ``o`` is a module, use ``o.__dict__`` as the ``globals`` when " +"calling :func:`eval`." msgstr "" msgid "" "If ``o`` is a class, use ``sys.modules[o.__module__].__dict__`` as the " -"``globals``, and ``dict(vars(o))`` as the ``locals``, when calling :func:" -"`eval`." +"``globals``, and ``dict(vars(o))`` as the ``locals``, when " +"calling :func:`eval`." msgstr "" msgid "" -"If ``o`` is a wrapped callable using :func:`functools.update_wrapper`, :func:" -"`functools.wraps`, or :func:`functools.partial`, iteratively unwrap it by " -"accessing either ``o.__wrapped__`` or ``o.func`` as appropriate, until you " -"have found the root unwrapped function." +"If ``o`` is a wrapped callable " +"using :func:`functools.update_wrapper`, :deco:`functools.wraps`, " +"or :func:`functools.partial`, iteratively unwrap it by accessing either " +"``o.__wrapped__`` or ``o.func`` as appropriate, until you have found the " +"root unwrapped function." msgstr "" msgid "" -"If ``o`` is a callable (but not a class), use :attr:`o.__globals__ ` as the globals when calling :func:`eval`." +"If ``o`` is a callable (but not a class), use :attr:`o.__globals__ " +"` as the globals when calling :func:`eval`." msgstr "" msgid "" @@ -228,8 +233,8 @@ msgid "" msgstr "" msgid "" -"Definitions that aren't needed at runtime, only imported when :const:`typing." -"TYPE_CHECKING` is true." +"Definitions that aren't needed at runtime, only imported " +"when :const:`typing.TYPE_CHECKING` is true." msgstr "" msgid "" diff --git a/howto/argparse.po b/howto/argparse.po index 8315f0595c..4345c75564 100644 --- a/howto/argparse.po +++ b/howto/argparse.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -323,8 +322,8 @@ msgstr "" msgid "" "That didn't go so well. That's because :mod:`argparse` treats the options we " -"give it as strings, unless we tell it otherwise. So, let's tell :mod:" -"`argparse` to treat that input as an integer::" +"give it as strings, unless we tell it otherwise. So, let's " +"tell :mod:`argparse` to treat that input as an integer::" msgstr "" msgid "" @@ -400,8 +399,8 @@ msgid "" "To show that the option is actually optional, there is no error when running " "the program without it. Note that by default, if an optional argument isn't " "used, the relevant variable, in this case ``args.verbosity``, is given " -"``None`` as a value, which is the reason it fails the truth test of the :" -"keyword:`if` statement." +"``None`` as a value, which is the reason it fails the truth test of " +"the :keyword:`if` statement." msgstr "" msgid "The help message is a bit different." @@ -772,8 +771,8 @@ msgid "" "We've just introduced yet another keyword, ``default``. We've set it to " "``0`` in order to make it comparable to the other int values. Remember that " "by default, if an optional argument isn't specified, it gets the ``None`` " -"value, and that cannot be compared to an int value (hence the :exc:" -"`TypeError` exception)." +"value, and that cannot be compared to an int value (hence " +"the :exc:`TypeError` exception)." msgstr "" msgid "And:" @@ -902,12 +901,13 @@ msgid "Conflicting options" msgstr "" msgid "" -"So far, we have been working with two methods of an :class:`argparse." -"ArgumentParser` instance. Let's introduce a third one, :meth:" -"`~ArgumentParser.add_mutually_exclusive_group`. It allows for us to specify " -"options that conflict with each other. Let's also change the rest of the " -"program so that the new functionality makes more sense: we'll introduce the " -"``--quiet`` option, which will be the opposite of the ``--verbose`` one::" +"So far, we have been working with two methods of " +"an :class:`argparse.ArgumentParser` instance. Let's introduce a third " +"one, :meth:`~ArgumentParser.add_mutually_exclusive_group`. It allows for us " +"to specify options that conflict with each other. Let's also change the rest " +"of the program so that the new functionality makes more sense: we'll " +"introduce the ``--quiet`` option, which will be the opposite of the ``--" +"verbose`` one::" msgstr "" msgid "" @@ -1023,9 +1023,9 @@ msgid "" msgstr "" msgid "" -"In order to translate these strings, they must first be extracted into a ``." -"po`` file. For example, using `Babel `__, run this " -"command:" +"In order to translate these strings, they must first be extracted into a " +"``.po`` file. For example, using `Babel `__, run " +"this command:" msgstr "" msgid "$ pybabel extract -o messages.po /usr/lib/python3.12/argparse.py" @@ -1054,8 +1054,8 @@ msgid "" msgstr "" msgid "" -"To translate your own strings in the :mod:`argparse` output, use :mod:" -"`gettext`." +"To translate your own strings in the :mod:`argparse` output, " +"use :mod:`gettext`." msgstr "" msgid "Custom type converters" diff --git a/howto/clinic.po b/howto/clinic.po index f978490fa8..a9cfa45b7d 100644 --- a/howto/clinic.po +++ b/howto/clinic.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Rafael Fontenelle , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:52+0000\n" -"Last-Translator: Rafael Fontenelle , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/howto/curses.po b/howto/curses.po index 91cb980b61..771b23a0ec 100644 --- a/howto/curses.po +++ b/howto/curses.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -94,8 +92,9 @@ msgid "" msgstr "" msgid "" -"The Windows version of Python doesn't include the :mod:`curses` module. A " -"ported version called :pypi:`UniCurses` is available." +"The Windows version of Python doesn't include the :mod:`curses` module. The " +"third-party :pypi:`windows-curses` package provides the same interface on " +"Windows." msgstr "" msgid "The Python curses module" @@ -157,9 +156,9 @@ msgid "" "Terminals usually return special keys, such as the cursor keys or navigation " "keys such as Page Up and Home, as a multibyte escape sequence. While you " "could write your application to expect such sequences and process them " -"accordingly, curses can do it for you, returning a special value such as :" -"const:`curses.KEY_LEFT`. To get curses to do the job, you'll have to enable " -"keypad mode. ::" +"accordingly, curses can do it for you, returning a special value such " +"as :const:`curses.KEY_LEFT`. To get curses to do the job, you'll have to " +"enable keypad mode. ::" msgstr "" msgid "stdscr.keypad(True)" @@ -177,9 +176,9 @@ msgid "" msgstr "" msgid "" -"to reverse the curses-friendly terminal settings. Then call the :func:" -"`~curses.endwin` function to restore the terminal to its original operating " -"mode. ::" +"to reverse the curses-friendly terminal settings. Then call " +"the :func:`~curses.endwin` function to restore the terminal to its original " +"operating mode. ::" msgstr "" msgid "curses.endwin()" @@ -221,11 +220,11 @@ msgid "" "initializations described above, also initializing colors if color support " "is present. :func:`!wrapper` then runs your provided callable. Once the " "callable returns, :func:`!wrapper` will restore the original state of the " -"terminal. The callable is called inside a :keyword:`try`...\\ :keyword:" -"`except` that catches exceptions, restores the state of the terminal, and " -"then re-raises the exception. Therefore your terminal won't be left in a " -"funny state on exception and you'll be able to read the exception's message " -"and traceback." +"terminal. The callable is called inside a :keyword:`try`..." +"\\ :keyword:`except` that catches exceptions, restores the state of the " +"terminal, and then re-raises the exception. Therefore your terminal won't " +"be left in a funny state on exception and you'll be able to read the " +"exception's message and traceback." msgstr "" msgid "Windows and Pads" @@ -241,9 +240,9 @@ msgid "" "The ``stdscr`` object returned by the :func:`~curses.initscr` function is a " "window object that covers the entire screen. Many programs may need only " "this single window, but you might wish to divide the screen into smaller " -"windows, in order to redraw or clear them separately. The :func:`~curses." -"newwin` function creates a new window of a given size, returning the new " -"window object. ::" +"windows, in order to redraw or clear them separately. " +"The :func:`~curses.newwin` function creates a new window of a given size, " +"returning the new window object. ::" msgstr "" msgid "" @@ -262,24 +261,25 @@ msgid "" msgstr "" msgid "" -"Your application can determine the size of the screen by using the :data:" -"`curses.LINES` and :data:`curses.COLS` variables to obtain the *y* and *x* " -"sizes. Legal coordinates will then extend from ``(0,0)`` to ``(curses.LINES " -"- 1, curses.COLS - 1)``." +"Your application can determine the size of the screen by using " +"the :data:`curses.LINES` and :data:`curses.COLS` variables to obtain the *y* " +"and *x* sizes. Legal coordinates will then extend from ``(0,0)`` to " +"``(curses.LINES - 1, curses.COLS - 1)``." msgstr "" msgid "" "When you call a method to display or erase text, the effect doesn't " -"immediately show up on the display. Instead you must call the :meth:" -"`~curses.window.refresh` method of window objects to update the screen." +"immediately show up on the display. Instead you must call " +"the :meth:`~curses.window.refresh` method of window objects to update the " +"screen." msgstr "" msgid "" "This is because curses was originally written with slow 300-baud terminal " "connections in mind; with these terminals, minimizing the time required to " "redraw the screen was very important. Instead curses accumulates changes to " -"the screen and displays them in the most efficient manner when you call :" -"meth:`!refresh`. For example, if your program displays some text in a " +"the screen and displays them in the most efficient manner when you " +"call :meth:`!refresh`. For example, if your program displays some text in a " "window and then clears the window, there's no need to send the original text " "because they're never visible." msgstr "" @@ -363,9 +363,9 @@ msgstr "" msgid "" "Fortunately the Python interface hides all these details. ``stdscr`` is a " -"window object like any other, and methods such as :meth:`~curses.window." -"addstr` accept multiple argument forms. Usually there are four different " -"forms." +"window object like any other, and methods such " +"as :meth:`~curses.window.addstr` accept multiple argument forms. Usually " +"there are four different forms." msgstr "" msgid "Form" @@ -411,9 +411,10 @@ msgstr "" msgid "" "The :meth:`~curses.window.addstr` method takes a Python string or bytestring " "as the value to be displayed. The contents of bytestrings are sent to the " -"terminal as-is. Strings are encoded to bytes using the value of the " -"window's :attr:`~window.encoding` attribute; this defaults to the default " -"system encoding as returned by :func:`locale.getencoding`." +"terminal as-is. On a build without wide-character support strings are " +"encoded using the value of the window's :attr:`~window.encoding` attribute; " +"this defaults to the default system encoding as returned " +"by :func:`locale.getencoding`." msgstr "" msgid "" @@ -422,10 +423,10 @@ msgid "" msgstr "" msgid "" -"Constants are provided for extension characters; these constants are " -"integers greater than 255. For example, :const:`ACS_PLMINUS` is a +/- " -"symbol, and :const:`ACS_ULCORNER` is the upper left corner of a box (handy " -"for drawing borders). You can also use the appropriate Unicode character." +"Constants are provided for the characters of the terminal's alternate " +"character set. For example, :const:`ACS_PLMINUS` is a +/- symbol, " +"and :const:`ACS_ULCORNER` is the upper left corner of a box (handy for " +"drawing borders). You can also use the appropriate Unicode character." msgstr "" msgid "" @@ -440,11 +441,10 @@ msgstr "" msgid "" "If your application doesn't need a blinking cursor at all, you can call " -"``curs_set(False)`` to make it invisible. For compatibility with older " -"curses versions, there's a ``leaveok(bool)`` function that's a synonym for :" -"func:`~curses.curs_set`. When *bool* is true, the curses library will " -"attempt to suppress the flashing cursor, and you won't need to worry about " -"leaving it in odd locations." +"``curs_set(False)`` to make it invisible. The window " +"method :meth:`~curses.window.leaveok` does something different: when its " +"argument is true, curses leaves the cursor wherever the last update put it, " +"instead of moving it back to the window's cursor position." msgstr "" msgid "Attributes and Color" @@ -536,10 +536,10 @@ msgstr "" msgid "" "The curses library maintains a finite number of color pairs, containing a " "foreground (or text) color and a background color. You can get the " -"attribute value corresponding to a color pair with the :func:`~curses." -"color_pair` function; this can be bitwise-OR'ed with other attributes such " -"as :const:`A_REVERSE`, but again, such combinations are not guaranteed to " -"work on all terminals." +"attribute value corresponding to a color pair with " +"the :func:`~curses.color_pair` function; this can be bitwise-OR'ed with " +"other attributes such as :const:`A_REVERSE`, but again, such combinations " +"are not guaranteed to work on all terminals." msgstr "" msgid "An example, which displays a line of text using color pair 1::" @@ -559,10 +559,10 @@ msgstr "" msgid "" "Colors are numbered, and :func:`start_color` initializes 8 basic colors when " -"it activates color mode. They are: 0:black, 1:red, 2:green, 3:yellow, 4:" -"blue, 5:magenta, 6:cyan, and 7:white. The :mod:`curses` module defines " -"named constants for each of these colors: :const:`curses.COLOR_BLACK`, :" -"const:`curses.COLOR_RED`, and so forth." +"it activates color mode. They are: 0:black, 1:red, 2:green, 3:yellow, " +"4:blue, 5:magenta, 6:cyan, and 7:white. The :mod:`curses` module defines " +"named constants for each of these " +"colors: :const:`curses.COLOR_BLACK`, :const:`curses.COLOR_RED`, and so forth." msgstr "" msgid "" @@ -587,64 +587,70 @@ msgid "" "given RGB value. This lets you change color 1, which is usually red, to " "purple or blue or any other color you like. Unfortunately, the Linux " "console doesn't support this, so I'm unable to try it out, and can't provide " -"any examples. You can check if your terminal can do this by calling :func:" -"`~curses.can_change_color`, which returns ``True`` if the capability is " -"there. If you're lucky enough to have such a talented terminal, consult " -"your system's man pages for more information." +"any examples. You can check if your terminal can do this by " +"calling :func:`~curses.can_change_color`, which returns ``True`` if the " +"capability is there. If you're lucky enough to have such a talented " +"terminal, consult your system's man pages for more information." msgstr "" msgid "User Input" msgstr "" msgid "" -"The C curses library offers only very simple input mechanisms. Python's :mod:" -"`curses` module adds a basic text-input widget. (Other libraries such as :" -"pypi:`Urwid` have more extensive collections of widgets.)" +"The C curses library offers only very simple input mechanisms. " +"Python's :mod:`curses` module adds a basic text-input widget. (Other " +"libraries such as :pypi:`Urwid` have more extensive collections of widgets.)" msgstr "" -msgid "There are two methods for getting input from a window:" +msgid "There are three methods for getting input from a window:" msgstr "" msgid "" -":meth:`~curses.window.getch` refreshes the screen and then waits for the " +":meth:`~curses.window.get_wch` refreshes the screen and then waits for the " "user to hit a key, displaying the key if :func:`~curses.echo` has been " "called earlier. You can optionally specify a coordinate to which the cursor " "should be moved before pausing." msgstr "" msgid "" -":meth:`~curses.window.getkey` does the same thing but converts the integer " -"to a string. Individual characters are returned as 1-character strings, and " -"special keys such as function keys return longer strings containing a key " -"name such as ``KEY_UP`` or ``^G``." +":meth:`~curses.window.getch` does the same thing but returns the code of the " +"key instead of a character. With ncurses this is a single byte of the key's " +"encoding in the current locale, so a character encoded with several bytes " +"takes several calls, one byte per call." msgstr "" msgid "" -"It's possible to not wait for the user using the :meth:`~curses.window." -"nodelay` window method. After ``nodelay(True)``, :meth:`!getch` and :meth:`!" -"getkey` for the window become non-blocking. To signal that no input is " -"ready, :meth:`!getch` returns ``curses.ERR`` (a value of -1) and :meth:`!" -"getkey` raises an exception. There's also a :func:`~curses.halfdelay` " -"function, which can be used to (in effect) set a timer on each :meth:`!" -"getch`; if no input becomes available within a specified delay (measured in " -"tenths of a second), curses raises an exception." +":meth:`~curses.window.getkey` does the same as :meth:`!getch` but returns a " +"string: an ordinary key as a 1-character string, and a special key as its " +"name, such as ``KEY_UP``." msgstr "" msgid "" -"The :meth:`!getch` method returns an integer; if it's between 0 and 255, it " -"represents the ASCII code of the key pressed. Values greater than 255 are " -"special keys such as Page Up, Home, or the cursor keys. You can compare the " -"value returned to constants such as :const:`curses.KEY_PPAGE`, :const:" -"`curses.KEY_HOME`, or :const:`curses.KEY_LEFT`. The main loop of your " -"program may look something like this::" +"It's possible to not wait for the user using " +"the :meth:`~curses.window.nodelay` window method. After ``nodelay(True)``, " +"the reads for the window become non-blocking. To signal that no input is " +"ready, :meth:`!get_wch` and :meth:`!getkey` raise an exception, and :meth:`!" +"getch` returns ``-1``. There's also a :func:`~curses.halfdelay` function, " +"which can be used to (in effect) set a timer on each read; if no input " +"becomes available within a specified delay (measured in tenths of a second), " +"the read fails the same way." +msgstr "" + +msgid "" +"Special keys such as Page Up, Home, or the cursor keys are returned by all " +"three as one of the :ref:`KEY_* constants `, all " +"larger than 255. You can compare the value returned to constants such " +"as :const:`curses.KEY_PPAGE`, :const:`curses.KEY_HOME`, " +"or :const:`curses.KEY_LEFT`. The main loop of your program may look " +"something like this::" msgstr "" msgid "" "while True:\n" -" c = stdscr.getch()\n" -" if c == ord('p'):\n" +" c = stdscr.get_wch()\n" +" if c == 'p':\n" " PrintDocument()\n" -" elif c == ord('q'):\n" +" elif c == 'q':\n" " break # Exit the while loop\n" " elif c == curses.KEY_HOME:\n" " x = y = 0" @@ -660,25 +666,27 @@ msgid "" msgstr "" msgid "" -"There's also a method to retrieve an entire string, :meth:`~curses.window." -"getstr`. It isn't used very often, because its functionality is quite " -"limited; the only editing keys available are the backspace key and the Enter " -"key, which terminates the string. It can optionally be limited to a fixed " -"number of characters. ::" +"There's also a method to retrieve an entire " +"line, :meth:`~curses.window.getstr`. It isn't used very often, because its " +"functionality is quite limited; the only editing keys available are the " +"erase and kill characters, and the Enter key, which terminates the line. It " +"returns a bytes object, and can optionally be limited to a fixed number of " +"bytes. ::" msgstr "" msgid "" "curses.echo() # Enable echoing of characters\n" "\n" -"# Get a 15-character string, with the cursor on the top line\n" +"# Get a line of at most 15 bytes, with the cursor on the top line\n" "s = stdscr.getstr(0,0, 15)" msgstr "" msgid "" "The :mod:`curses.textpad` module supplies a text box that supports an Emacs-" -"like set of keybindings. Various methods of the :class:`~curses.textpad." -"Textbox` class support editing with input validation and gathering the edit " -"results either with or without trailing spaces. Here's an example::" +"like set of keybindings. Various methods of " +"the :class:`~curses.textpad.Textbox` class support editing with input " +"validation and gathering the edit results either with or without trailing " +"spaces. Here's an example::" msgstr "" msgid "" @@ -719,8 +727,8 @@ msgid "" "If you're in doubt about the detailed behavior of the curses functions, " "consult the manual pages for your curses implementation, whether it's " "ncurses or a proprietary Unix vendor's. The manual pages will document any " -"quirks, and provide complete lists of all the functions, attributes, and :" -"ref:`ACS_\\* ` characters available to you." +"quirks, and provide complete lists of all the functions, attributes, " +"and :ref:`ACS_\\* ` characters available to you." msgstr "" msgid "" @@ -728,8 +736,8 @@ msgid "" "Python interface. Often this isn't because they're difficult to implement, " "but because no one has needed them yet. Also, Python doesn't yet support " "the menu library associated with ncurses. Patches adding support for these " -"would be welcome; see `the Python Developer's Guide `_ to learn more about submitting patches to Python." +"would be welcome; see `the Python Developer's Guide `_ to learn more about submitting patches to Python." msgstr "" msgid "" diff --git a/howto/descriptor.po b/howto/descriptor.po index 84a7366af4..62d9293b2a 100644 --- a/howto/descriptor.po +++ b/howto/descriptor.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +68,9 @@ msgstr "" msgid "" "The last section has pure Python equivalents for built-in descriptors that " "are written in C. Read this if you're curious about how functions turn into " -"bound methods or about the implementation of common tools like :func:" -"`classmethod`, :func:`staticmethod`, :func:`property`, and :term:`__slots__`." +"bound methods or about the implementation of common tools " +"like :deco:`classmethod`, :deco:`staticmethod`, :deco:`property`, " +"and :term:`__slots__`." msgstr "" msgid "Primer" @@ -202,8 +200,9 @@ msgid "" "A popular use for descriptors is managing access to instance data. The " "descriptor is assigned to a public attribute in the class dictionary while " "the actual data is stored as a private attribute in the instance " -"dictionary. The descriptor's :meth:`~object.__get__` and :meth:`~object." -"__set__` methods are triggered when the public attribute is accessed." +"dictionary. The descriptor's :meth:`~object.__get__` " +"and :meth:`~object.__set__` methods are triggered when the public attribute " +"is accessed." msgstr "" msgid "" @@ -331,9 +330,10 @@ msgid "" msgstr "" msgid "" -"An interactive session shows that the :class:`!Person` class has called :" -"meth:`~object.__set_name__` so that the field names would be recorded. Here " -"we call :func:`vars` to look up the descriptor without triggering it:" +"An interactive session shows that the :class:`!Person` class has " +"called :meth:`~object.__set_name__` so that the field names would be " +"recorded. Here we call :func:`vars` to look up the descriptor without " +"triggering it:" msgstr "" msgid "" @@ -373,8 +373,9 @@ msgid "Closing thoughts" msgstr "" msgid "" -"A :term:`descriptor` is what we call any object that defines :meth:`~object." -"__get__`, :meth:`~object.__set__`, or :meth:`~object.__delete__`." +"A :term:`descriptor` is what we call any object that " +"defines :meth:`~object.__get__`, :meth:`~object.__set__`, " +"or :meth:`~object.__delete__`." msgstr "" msgid "" @@ -408,9 +409,9 @@ msgstr "" msgid "" "Descriptors are used throughout the language. It is how functions turn into " -"bound methods. Common tools like :func:`classmethod`, :func:" -"`staticmethod`, :func:`property`, and :func:`functools.cached_property` are " -"all implemented as descriptors." +"bound methods. Common tools " +"like :deco:`classmethod`, :deco:`staticmethod`, :deco:`property`, " +"and :deco:`functools.cached_property` are all implemented as descriptors." msgstr "" msgid "Complete Practical Example" @@ -472,9 +473,9 @@ msgid "" msgstr "" msgid "" -":class:`!Number` verifies that a value is either an :class:`int` or :class:" -"`float`. Optionally, it verifies that a value is between a given minimum or " -"maximum." +":class:`!Number` verifies that a value is either an :class:`int` " +"or :class:`float`. Optionally, it verifies that a value is between a given " +"minimum or maximum." msgstr "" msgid "" @@ -523,7 +524,7 @@ msgid "" "\n" " def validate(self, value):\n" " if not isinstance(value, str):\n" -" raise TypeError(f'Expected {value!r} to be an str')\n" +" raise TypeError(f'Expected {value!r} to be a str')\n" " if self.minsize is not None and len(value) < self.minsize:\n" " raise ValueError(\n" " f'Expected {value!r} to be no smaller than {self.minsize!" @@ -613,9 +614,10 @@ msgstr "" msgid "" "In general, a descriptor is an attribute value that has one of the methods " -"in the descriptor protocol. Those methods are :meth:`~object.__get__`, :" -"meth:`~object.__set__`, and :meth:`~object.__delete__`. If any of those " -"methods are defined for an attribute, it is said to be a :term:`descriptor`." +"in the descriptor protocol. Those methods " +"are :meth:`~object.__get__`, :meth:`~object.__set__`, " +"and :meth:`~object.__delete__`. If any of those methods are defined for an " +"attribute, it is said to be a :term:`descriptor`." msgstr "" msgid "" @@ -631,10 +633,10 @@ msgstr "" msgid "" "Descriptors are a powerful, general purpose protocol. They are the " -"mechanism behind properties, methods, static methods, class methods, and :" -"func:`super`. They are used throughout Python itself. Descriptors simplify " -"the underlying C code and offer a flexible set of new tools for everyday " -"Python programs." +"mechanism behind properties, methods, static methods, class methods, " +"and :func:`super`. They are used throughout Python itself. Descriptors " +"simplify the underlying C code and offer a flexible set of new tools for " +"everyday Python programs." msgstr "" msgid "Descriptor protocol" @@ -657,9 +659,9 @@ msgstr "" msgid "" "If an object defines :meth:`~object.__set__` or :meth:`~object.__delete__`, " -"it is considered a data descriptor. Descriptors that only define :meth:" -"`~object.__get__` are called non-data descriptors (they are often used for " -"methods but other uses are possible)." +"it is considered a data descriptor. Descriptors that only " +"define :meth:`~object.__get__` are called non-data descriptors (they are " +"often used for methods but other uses are possible)." msgstr "" msgid "" @@ -672,17 +674,18 @@ msgstr "" msgid "" "To make a read-only data descriptor, define both :meth:`~object.__get__` " -"and :meth:`~object.__set__` with the :meth:`~object.__set__` raising an :exc:" -"`AttributeError` when called. Defining the :meth:`~object.__set__` method " -"with an exception raising placeholder is enough to make it a data descriptor." +"and :meth:`~object.__set__` with the :meth:`~object.__set__` raising " +"an :exc:`AttributeError` when called. Defining the :meth:`~object.__set__` " +"method with an exception raising placeholder is enough to make it a data " +"descriptor." msgstr "" msgid "Overview of descriptor invocation" msgstr "" msgid "" -"A descriptor can be called directly with ``desc.__get__(obj)`` or ``desc." -"__get__(None, cls)``." +"A descriptor can be called directly with ``desc.__get__(obj)`` or " +"``desc.__get__(None, cls)``." msgstr "" msgid "" @@ -713,8 +716,8 @@ msgid "" msgstr "" msgid "" -"If a descriptor is found for ``a.x``, then it is invoked with: ``desc." -"__get__(a, type(a))``." +"If a descriptor is found for ``a.x``, then it is invoked with: " +"``desc.__get__(a, type(a))``." msgstr "" msgid "" @@ -751,17 +754,18 @@ msgid "" msgstr "" msgid "" -"Note, there is no :meth:`~object.__getattr__` hook in the :meth:`~object." -"__getattribute__` code. That is why calling :meth:`~object." -"__getattribute__` directly or with ``super().__getattribute__`` will bypass :" -"meth:`~object.__getattr__` entirely." +"Note, there is no :meth:`~object.__getattr__` hook in " +"the :meth:`~object.__getattribute__` code. That is why " +"calling :meth:`~object.__getattribute__` directly or with " +"``super().__getattribute__`` will bypass :meth:`~object.__getattr__` " +"entirely." msgstr "" msgid "" "Instead, it is the dot operator and the :func:`getattr` function that are " -"responsible for invoking :meth:`~object.__getattr__` whenever :meth:`~object." -"__getattribute__` raises an :exc:`AttributeError`. Their logic is " -"encapsulated in a helper function:" +"responsible for invoking :meth:`~object.__getattr__` " +"whenever :meth:`~object.__getattribute__` raises an :exc:`AttributeError`. " +"Their logic is encapsulated in a helper function:" msgstr "" msgid "" @@ -779,38 +783,39 @@ msgid "Invocation from a class" msgstr "" msgid "" -"The logic for a dotted lookup such as ``A.x`` is in :meth:`!type." -"__getattribute__`. The steps are similar to those for :meth:`!object." -"__getattribute__` but the instance dictionary lookup is replaced by a search " -"through the class's :term:`method resolution order`." +"The logic for a dotted lookup such as ``A.x`` is in :meth:`!" +"type.__getattribute__`. The steps are similar to those for :meth:`!" +"object.__getattribute__` but the instance dictionary lookup is replaced by a " +"search through the class's :term:`method resolution order`." msgstr "" msgid "If a descriptor is found, it is invoked with ``desc.__get__(None, A)``." msgstr "" msgid "" -"The full C implementation can be found in :c:func:`!type_getattro` and :c:" -"func:`!_PyType_Lookup` in :source:`Objects/typeobject.c`." +"The full C implementation can be found in :c:func:`!type_getattro` " +"and :c:func:`!_PyType_Lookup` in :source:`Objects/typeobject.c`." msgstr "" msgid "Invocation from super" msgstr "" msgid "" -"The logic for super's dotted lookup is in the :meth:`~object." -"__getattribute__` method for object returned by :func:`super`." +"The logic for super's dotted lookup is in " +"the :meth:`~object.__getattribute__` method for object returned " +"by :func:`super`." msgstr "" msgid "" -"A dotted lookup such as ``super(A, obj).m`` searches ``obj.__class__." -"__mro__`` for the base class ``B`` immediately following ``A`` and then " -"returns ``B.__dict__['m'].__get__(obj, A)``. If not a descriptor, ``m`` is " -"returned unchanged." +"A dotted lookup such as ``super(A, obj).m`` searches " +"``obj.__class__.__mro__`` for the base class ``B`` immediately following " +"``A`` and then returns ``B.__dict__['m'].__get__(obj, A)``. If not a " +"descriptor, ``m`` is returned unchanged." msgstr "" msgid "" -"The full C implementation can be found in :c:func:`!super_getattro` in :" -"source:`Objects/typeobject.c`. A pure Python equivalent can be found in " +"The full C implementation can be found in :c:func:`!super_getattro` " +"in :source:`Objects/typeobject.c`. A pure Python equivalent can be found in " "`Guido's Tutorial `_." msgstr "" @@ -819,9 +824,9 @@ msgid "Summary of invocation logic" msgstr "" msgid "" -"The mechanism for descriptors is embedded in the :meth:`~object." -"__getattribute__` methods for :class:`object`, :class:`type`, and :func:" -"`super`." +"The mechanism for descriptors is embedded in " +"the :meth:`~object.__getattribute__` methods " +"for :class:`object`, :class:`type`, and :func:`super`." msgstr "" msgid "The important points to remember are:" @@ -831,8 +836,8 @@ msgid "Descriptors are invoked by the :meth:`~object.__getattribute__` method." msgstr "" msgid "" -"Classes inherit this machinery from :class:`object`, :class:`type`, or :func:" -"`super`." +"Classes inherit this machinery from :class:`object`, :class:`type`, " +"or :func:`super`." msgstr "" msgid "" @@ -881,8 +886,8 @@ msgstr "" msgid "" "The following code is a simplified skeleton showing how data descriptors " -"could be used to implement an `object relational mapping `_." +"could be used to implement an `object relational mapping `_." msgstr "" msgid "" @@ -909,9 +914,9 @@ msgid "" msgstr "" msgid "" -"We can use the :class:`!Field` class to define `models `_ that describe the schema for each table in a " -"database:" +"We can use the :class:`!Field` class to define `models `_ that describe the schema for each " +"table in a database:" msgstr "" msgid "" @@ -1127,10 +1132,10 @@ msgid "" msgstr "" msgid "" -"To support automatic creation of methods, functions include the :meth:" -"`~object.__get__` method for binding methods during attribute access. This " -"means that functions are non-data descriptors that return bound methods " -"during dotted lookup from an instance. Here's how it works:" +"To support automatic creation of methods, functions include " +"the :meth:`~object.__get__` method for binding methods during attribute " +"access. This means that functions are non-data descriptors that return " +"bound methods during dotted lookup from an instance. Here's how it works:" msgstr "" msgid "" @@ -1170,8 +1175,9 @@ msgstr "" "'D.f'" msgid "" -"Accessing the function through the class dictionary does not invoke :meth:" -"`~object.__get__`. Instead, it just returns the underlying function object::" +"Accessing the function through the class dictionary does not " +"invoke :meth:`~object.__get__`. Instead, it just returns the underlying " +"function object::" msgstr "" msgid "" @@ -1281,10 +1287,10 @@ msgstr "" msgid "" "Static methods return the underlying function without changes. Calling " -"either ``c.f`` or ``C.f`` is the equivalent of a direct lookup into ``object." -"__getattribute__(c, \"f\")`` or ``object.__getattribute__(C, \"f\")``. As a " -"result, the function becomes identically accessible from either an object or " -"a class." +"either ``c.f`` or ``C.f`` is the equivalent of a direct lookup into " +"``object.__getattribute__(c, \"f\")`` or ``object.__getattribute__(C, " +"\"f\")``. As a result, the function becomes identically accessible from " +"either an object or a class." msgstr "" msgid "" @@ -1327,8 +1333,8 @@ msgstr "" "30" msgid "" -"Using the non-data descriptor protocol, a pure Python version of :func:" -"`staticmethod` would look like this:" +"Using the non-data descriptor protocol, a pure Python version " +"of :deco:`staticmethod` would look like this:" msgstr "" msgid "" @@ -1351,9 +1357,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: :" -"attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function." -"__doc__`, and :attr:`~function.__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" @@ -1414,8 +1420,8 @@ msgid "" msgstr "" msgid "" -"Using the non-data descriptor protocol, a pure Python version of :func:" -"`classmethod` would look like this:" +"Using the non-data descriptor protocol, a pure Python version " +"of :deco:`classmethod` would look like this:" msgstr "" msgid "" @@ -1438,9 +1444,9 @@ msgid "" "The :func:`functools.update_wrapper` call in ``ClassMethod`` adds a " "``__wrapped__`` attribute that refers to the underlying function. Also it " "carries forward the attributes necessary to make the wrapper look like the " -"wrapped function: :attr:`~function.__name__`, :attr:`~function." -"__qualname__`, :attr:`~function.__doc__`, and :attr:`~function." -"__annotations__`." +"wrapped " +"function: :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__`, " +"and :attr:`~function.__annotations__`." msgstr "" msgid "Member objects and __slots__" @@ -1521,7 +1527,7 @@ msgid "" msgstr "" msgid "" -"5. Blocks tools like :func:`functools.cached_property` which require an " +"5. Blocks tools like :deco:`functools.cached_property` which require an " "instance dictionary to function correctly:" msgstr "" @@ -1559,7 +1565,7 @@ msgid "" "class Member:\n" "\n" " def __init__(self, name, clsname, offset):\n" -" 'Emulate PyMemberDef in Include/structmember.h'\n" +" 'Emulate PyMemberDef in Include/descrobject.h'\n" " # Also see descr_new() in Objects/descrobject.c\n" " self.name = name\n" " self.clsname = clsname\n" diff --git a/howto/enum.po b/howto/enum.po index 2eccda4a75..baee80a8b3 100644 --- a/howto/enum.po +++ b/howto/enum.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -175,8 +174,8 @@ msgid "Now we can find out what today is! Observe::" msgstr "" msgid "" -">>> from datetime import date\n" -">>> Weekday.from_date(date.today())\n" +">>> import datetime as dt\n" +">>> Weekday.from_date(dt.date.today())\n" "" msgstr "" @@ -256,8 +255,8 @@ msgstr "" msgid "" ">>> chores_for_ethan = {\n" -"... 'feed the cat': Weekday.MONDAY | Weekday.WEDNESDAY | Weekday." -"FRIDAY,\n" +"... 'feed the cat': Weekday.MONDAY | Weekday.WEDNESDAY | " +"Weekday.FRIDAY,\n" "... 'do the dishes': Weekday.TUESDAY | Weekday.THURSDAY,\n" "... 'answer SO questions': Weekday.SATURDAY,\n" "... }" @@ -298,8 +297,8 @@ msgid "Programmatic access to enumeration members and their attributes" msgstr "" msgid "" -"Sometimes it's useful to access members in enumerations programmatically (i." -"e. situations where ``Color.RED`` won't do because the exact color is not " +"Sometimes it's useful to access members in enumerations programmatically " +"(i.e. situations where ``Color.RED`` won't do because the exact color is not " "known at program-writing time). ``Enum`` allows such access::" msgstr "" @@ -395,7 +394,7 @@ msgstr "" msgid "" "By default, enumerations allow multiple names as aliases for the same value. " -"When this behavior isn't desired, you can use the :func:`unique` decorator::" +"When this behavior isn't desired, you can use the :deco:`unique` decorator::" msgstr "" msgid "" @@ -465,9 +464,9 @@ msgid "" ">>> list(Shape)\n" "[, , ]\n" ">>> list(Weekday)\n" -"[, , , , , , ]" +"[, , , " +", , , " +"]" msgstr "" msgid "" @@ -619,22 +618,23 @@ msgid "" "The rules for what is allowed are as follows: names that start and end with " "a single underscore are reserved by enum and cannot be used; all other " "attributes defined within an enumeration will become members of this " -"enumeration, with the exception of special methods (:meth:`~object." -"__str__`, :meth:`~object.__add__`, etc.), descriptors (methods are also " -"descriptors), and variable names listed in :attr:`~Enum._ignore_`." +"enumeration, with the exception of special methods " +"(:meth:`~object.__str__`, :meth:`~object.__add__`, etc.), descriptors " +"(methods are also descriptors), and variable names listed " +"in :attr:`~Enum._ignore_`." msgstr "" msgid "" -"Note: if your enumeration defines :meth:`~object.__new__` and/or :meth:" -"`~object.__init__`, any value(s) given to the enum member will be passed " -"into those methods. See `Planet`_ for an example." +"Note: if your enumeration defines :meth:`~object.__new__` and/" +"or :meth:`~object.__init__`, any value(s) given to the enum member will be " +"passed into those methods. See `Planet`_ for an example." msgstr "" msgid "" "The :meth:`~object.__new__` method, if defined, is used during creation of " "the Enum members; it is then replaced by Enum's :meth:`~object.__new__` " -"which is used after class creation for lookup of existing members. See :ref:" -"`new-vs-init` for more details." +"which is used after class creation for lookup of existing members. " +"See :ref:`new-vs-init` for more details." msgstr "" msgid "Restricted Enum subclassing" @@ -690,8 +690,8 @@ msgid "Dataclass support" msgstr "" msgid "" -"When inheriting from a :class:`~dataclasses.dataclass`, the :meth:`~Enum." -"__repr__` omits the inherited class' name. For example::" +"When inheriting from a :class:`~dataclasses.dataclass`, " +"the :meth:`~Enum.__repr__` omits the inherited class' name. For example::" msgstr "" msgid "" @@ -721,7 +721,7 @@ msgid "" msgstr "" msgid "" -"Adding :func:`~dataclasses.dataclass` decorator to :class:`Enum` and its " +"Adding :deco:`~dataclasses.dataclass` decorator to :class:`Enum` and its " "subclasses is not supported. It will not raise any errors, but it will " "produce very strange results at runtime, such as members being equal to each " "other::" @@ -764,9 +764,10 @@ msgid "" msgstr "" msgid "" -"It is possible to modify how enum members are pickled/unpickled by defining :" -"meth:`~object.__reduce_ex__` in the enumeration class. The default method " -"is by-value, but enums with complicated values may want to use by-name::" +"It is possible to modify how enum members are pickled/unpickled by " +"defining :meth:`~object.__reduce_ex__` in the enumeration class. The " +"default method is by-value, but enums with complicated values may want to " +"use by-name::" msgstr "" msgid "" @@ -849,10 +850,10 @@ msgid "" msgstr "" msgid "" -"The new pickle protocol 4 also, in some circumstances, relies on :attr:" -"`~type.__qualname__` being set to the location where pickle will be able to " -"find the class. For example, if the class was made available in class " -"SomeData in the global scope::" +"The new pickle protocol 4 also, in some circumstances, relies " +"on :attr:`~type.__qualname__` being set to the location where pickle will be " +"able to find the class. For example, if the class was made available in " +"class SomeData in the global scope::" msgstr "" msgid "" @@ -926,10 +927,10 @@ msgid "IntEnum" msgstr "" msgid "" -"The first variation of :class:`Enum` that is provided is also a subclass of :" -"class:`int`. Members of an :class:`IntEnum` can be compared to integers; by " -"extension, integer enumerations of different types can also be compared to " -"each other::" +"The first variation of :class:`Enum` that is provided is also a subclass " +"of :class:`int`. Members of an :class:`IntEnum` can be compared to " +"integers; by extension, integer enumerations of different types can also be " +"compared to each other::" msgstr "" msgid "" @@ -998,9 +999,9 @@ msgid "" "The next variation of :class:`Enum` provided, :class:`IntFlag`, is also " "based on :class:`int`. The difference being :class:`IntFlag` members can be " "combined using the bitwise operators (&, \\|, ^, ~) and the result is still " -"an :class:`IntFlag` member, if possible. Like :class:`IntEnum`, :class:" -"`IntFlag` members are also integers and can be used wherever an :class:`int` " -"is used." +"an :class:`IntFlag` member, if possible. " +"Like :class:`IntEnum`, :class:`IntFlag` members are also integers and can be " +"used wherever an :class:`int` is used." msgstr "" msgid "" @@ -1057,8 +1058,8 @@ msgstr "" msgid "" "Another important difference between :class:`IntFlag` and :class:`Enum` is " -"that if no flags are set (the value is 0), its boolean evaluation is :data:" -"`False`::" +"that if no flags are set (the value is 0), its boolean evaluation " +"is :data:`False`::" msgstr "" msgid "" @@ -1117,10 +1118,10 @@ msgstr "" msgid "" "The last variation is :class:`Flag`. Like :class:`IntFlag`, :class:`Flag` " -"members can be combined using the bitwise operators (&, \\|, ^, ~). Unlike :" -"class:`IntFlag`, they cannot be combined with, nor compared against, any " -"other :class:`Flag` enumeration, nor :class:`int`. While it is possible to " -"specify the values directly it is recommended to use :class:`auto` as the " +"members can be combined using the bitwise operators (&, \\|, ^, ~). " +"Unlike :class:`IntFlag`, they cannot be combined with, nor compared against, " +"any other :class:`Flag` enumeration, nor :class:`int`. While it is possible " +"to specify the values directly it is recommended to use :class:`auto` as the " "value and let :class:`Flag` select an appropriate value." msgstr "" @@ -1192,10 +1193,10 @@ msgid "" "For the majority of new code, :class:`Enum` and :class:`Flag` are strongly " "recommended, since :class:`IntEnum` and :class:`IntFlag` break some semantic " "promises of an enumeration (by being comparable to integers, and thus by " -"transitivity to other unrelated enumerations). :class:`IntEnum` and :class:" -"`IntFlag` should be used only in cases where :class:`Enum` and :class:`Flag` " -"will not do; for example, when integer constants are replaced with " -"enumerations, or for interoperability with other systems." +"transitivity to other unrelated enumerations). :class:`IntEnum` " +"and :class:`IntFlag` should be used only in cases where :class:`Enum` " +"and :class:`Flag` will not do; for example, when integer constants are " +"replaced with enumerations, or for interoperability with other systems." msgstr "" msgid "Others" @@ -1213,30 +1214,30 @@ msgstr "" msgid "" "This demonstrates how similar derived enumerations can be defined; for " -"example a :class:`!FloatEnum` that mixes in :class:`float` instead of :class:" -"`int`." +"example a :class:`!FloatEnum` that mixes in :class:`float` instead " +"of :class:`int`." msgstr "" msgid "Some rules:" msgstr "" msgid "" -"When subclassing :class:`Enum`, mix-in types must appear before the :class:" -"`Enum` class itself in the sequence of bases, as in the :class:`IntEnum` " -"example above." +"When subclassing :class:`Enum`, mix-in types must appear before " +"the :class:`Enum` class itself in the sequence of bases, as in " +"the :class:`IntEnum` example above." msgstr "" msgid "" -"Mix-in types must be subclassable. For example, :class:`bool` and :class:" -"`range` are not subclassable and will throw an error during Enum creation if " -"used as the mix-in type." +"Mix-in types must be subclassable. For example, :class:`bool` " +"and :class:`range` are not subclassable and will throw an error during Enum " +"creation if used as the mix-in type." msgstr "" msgid "" "While :class:`Enum` can have members of any type, once you mix in an " -"additional type, all the members must have values of that type, e.g. :class:" -"`int` above. This restriction does not apply to mix-ins which only add " -"methods and don't specify another type." +"additional type, all the members must have values of that type, " +"e.g. :class:`int` above. This restriction does not apply to mix-ins which " +"only add methods and don't specify another type." msgstr "" msgid "" @@ -1246,27 +1247,27 @@ msgid "" msgstr "" msgid "" -"A ``data type`` is a mixin that defines :meth:`~object.__new__`, or a :class:" -"`~dataclasses.dataclass`" +"A ``data type`` is a mixin that defines :meth:`~object.__new__`, or " +"a :class:`~dataclasses.dataclass`" msgstr "" msgid "" -"%-style formatting: ``%s`` and ``%r`` call the :class:`Enum` class's :meth:" -"`~object.__str__` and :meth:`~object.__repr__` respectively; other codes " -"(such as ``%i`` or ``%h`` for IntEnum) treat the enum member as its mixed-in " -"type." +"%-style formatting: ``%s`` and ``%r`` call the :class:`Enum` " +"class's :meth:`~object.__str__` and :meth:`~object.__repr__` respectively; " +"other codes (such as ``%i`` or ``%h`` for IntEnum) treat the enum member as " +"its mixed-in type." msgstr "" msgid "" -":ref:`Formatted string literals `, :meth:`str.format`, and :func:" -"`format` will use the enum's :meth:`~object.__str__` method." +":ref:`Formatted string literals `, :meth:`str.format`, " +"and :func:`format` will use the enum's :meth:`~object.__str__` method." msgstr "" msgid "" "Because :class:`IntEnum`, :class:`IntFlag`, and :class:`StrEnum` are " -"designed to be drop-in replacements for existing constants, their :meth:" -"`~object.__str__` method has been reset to their data types' :meth:`~object." -"__str__` method." +"designed to be drop-in replacements for existing constants, " +"their :meth:`~object.__str__` method has been reset to their data " +"types' :meth:`~object.__str__` method." msgstr "" msgid "When to use :meth:`~object.__new__` vs. :meth:`~object.__init__`" @@ -1275,8 +1276,8 @@ msgstr "" msgid "" ":meth:`~object.__new__` must be used whenever you want to customize the " "actual value of the :class:`Enum` member. Any other modifications may go in " -"either :meth:`~object.__new__` or :meth:`~object.__init__`, with :meth:" -"`~object.__init__` being preferred." +"either :meth:`~object.__new__` or :meth:`~object.__init__`, " +"with :meth:`~object.__init__` being preferred." msgstr "" msgid "" @@ -1316,102 +1317,12 @@ msgstr "" msgid "Finer Points" msgstr "" -msgid "Supported ``__dunder__`` names" +msgid "Supported ``__dunder__`` and ``_sunder_`` names" msgstr "" msgid "" -":attr:`~enum.EnumType.__members__` is a read-only ordered mapping of " -"``member_name``:``member`` items. It is only available on the class." -msgstr "" - -msgid "" -":meth:`~object.__new__`, if specified, must create and return the enum " -"members; it is also a very good idea to set the member's :attr:`~Enum." -"_value_` appropriately. Once all the members are created it is no longer " -"used." -msgstr "" - -msgid "Supported ``_sunder_`` names" -msgstr "" - -msgid ":attr:`~Enum._name_` -- name of the member" -msgstr "" - -msgid ":attr:`~Enum._value_` -- value of the member; can be set in ``__new__``" -msgstr "" - -msgid "" -":meth:`~Enum._missing_` -- a lookup function used when a value is not found; " -"may be overridden" -msgstr "" - -msgid "" -":attr:`~Enum._ignore_` -- a list of names, either as a :class:`list` or a :" -"class:`str`, that will not be transformed into members, and will be removed " -"from the final class" -msgstr "" - -msgid "" -":meth:`~Enum._generate_next_value_` -- used to get an appropriate value for " -"an enum member; may be overridden" -msgstr "" - -msgid "" -":meth:`~EnumType._add_alias_` -- adds a new name as an alias to an existing " -"member." -msgstr "" - -msgid "" -":meth:`~EnumType._add_value_alias_` -- adds a new value as an alias to an " -"existing member. See `MultiValueEnum`_ for an example." -msgstr "" - -msgid "" -"For standard :class:`Enum` classes the next value chosen is the highest " -"value seen incremented by one." -msgstr "" - -msgid "" -"For :class:`Flag` classes the next value chosen will be the next highest " -"power-of-two." -msgstr "" - -msgid "" -"Prior versions would use the last seen value instead of the highest value." -msgstr "" - -msgid "``_missing_``, ``_order_``, ``_generate_next_value_``" -msgstr "``_missing_``, ``_order_``, ``_generate_next_value_``" - -msgid "``_ignore_``" -msgstr "``_ignore_``" - -msgid "``_add_alias_``, ``_add_value_alias_``" -msgstr "" - -msgid "" -"To help keep Python 2 / Python 3 code in sync an :attr:`~Enum._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 "" -">>> class Color(Enum):\n" -"... _order_ = 'RED GREEN BLUE'\n" -"... RED = 1\n" -"... BLUE = 3\n" -"... GREEN = 2\n" -"...\n" -"Traceback (most recent call last):\n" -"...\n" -"TypeError: member order does not match _order_:\n" -" ['RED', 'BLUE', 'GREEN']\n" -" ['RED', 'GREEN', 'BLUE']" -msgstr "" - -msgid "" -"In Python 2 code the :attr:`~Enum._order_` attribute is necessary as " -"definition order is lost before it can be recorded." +"The supported ``__dunder__`` and ``_sunder_`` names can be found in " +"the :ref:`Enum API documentation `." msgstr "" msgid "_Private__names" @@ -1455,11 +1366,11 @@ msgid "Boolean value of ``Enum`` classes and members" msgstr "" msgid "" -"Enum classes that are mixed with non-:class:`Enum` types (such as :class:" -"`int`, :class:`str`, etc.) are evaluated according to the mixed-in type's " -"rules; otherwise, all members evaluate as :data:`True`. To make your own " -"enum's boolean evaluation depend on the member's value add the following to " -"your class::" +"Enum classes that are mixed with non-:class:`Enum` types (such " +"as :class:`int`, :class:`str`, etc.) are evaluated according to the mixed-in " +"type's rules; otherwise, all members evaluate as :data:`True`. To make your " +"own enum's boolean evaluation depend on the member's value add the following " +"to your class::" msgstr "" msgid "" @@ -1653,30 +1564,30 @@ msgstr "" msgid "" "The default for Flag is ``STRICT``, the default for ``IntFlag`` is " -"``EJECT``, and the default for ``_convert_`` is ``KEEP`` (see ``ssl." -"Options`` for an example of when ``KEEP`` is needed)." +"``EJECT``, and the default for ``_convert_`` is ``KEEP`` (see " +"``ssl.Options`` for an example of when ``KEEP`` is needed)." msgstr "" msgid "How are Enums and Flags different?" msgstr "" msgid "" -"Enums have a custom metaclass that affects many aspects of both derived :" -"class:`Enum` classes and their instances (members)." +"Enums have a custom metaclass that affects many aspects of both " +"derived :class:`Enum` classes and their instances (members)." msgstr "" msgid "Enum Classes" msgstr "" msgid "" -"The :class:`EnumType` metaclass is responsible for providing the :meth:" -"`~object.__contains__`, :meth:`~object.__dir__`, :meth:`~object.__iter__` " +"The :class:`EnumType` metaclass is responsible for providing " +"the :meth:`~object.__contains__`, :meth:`~object.__dir__`, :meth:`~object.__iter__` " "and other methods that allow one to do things with an :class:`Enum` class " "that fail on a typical class, such as ``list(Color)`` or ``some_enum_var in " "Color``. :class:`EnumType` is responsible for ensuring that various other " -"methods on the final :class:`Enum` class are correct (such as :meth:`~object." -"__new__`, :meth:`~object.__getnewargs__`, :meth:`~object.__str__` and :meth:" -"`~object.__repr__`)." +"methods on the final :class:`Enum` class are correct (such " +"as :meth:`~object.__new__`, :meth:`~object.__getnewargs__`, :meth:`~object.__str__` " +"and :meth:`~object.__repr__`)." msgstr "" msgid "Flag Classes" @@ -1685,8 +1596,8 @@ msgstr "" msgid "" "Flags have an expanded view of aliasing: to be canonical, the value of a " "flag needs to be a power-of-two value, and not a duplicate name. So, in " -"addition to the :class:`Enum` definition of alias, a flag with no value (a.k." -"a. ``0``) or with more than one power-of-two value (e.g. ``3``) is " +"addition to the :class:`Enum` definition of alias, a flag with no value " +"(a.k.a. ``0``) or with more than one power-of-two value (e.g. ``3``) is " "considered an alias." msgstr "" @@ -1694,11 +1605,11 @@ msgid "Enum Members (aka instances)" msgstr "" msgid "" -"The most interesting thing about enum members is that they are singletons. :" -"class:`EnumType` creates them all while it is creating the enum class " -"itself, and then puts a custom :meth:`~object.__new__` in place to ensure " -"that no new ones are ever instantiated by returning only the existing member " -"instances." +"The most interesting thing about enum members is that they are " +"singletons. :class:`EnumType` creates them all while it is creating the enum " +"class itself, and then puts a custom :meth:`~object.__new__` in place to " +"ensure that no new ones are ever instantiated by returning only the existing " +"member instances." msgstr "" msgid "Flag Members" @@ -1747,10 +1658,11 @@ msgid "Enum Cookbook" msgstr "" msgid "" -"While :class:`Enum`, :class:`IntEnum`, :class:`StrEnum`, :class:`Flag`, and :" -"class:`IntFlag` are expected to cover the majority of use-cases, they cannot " -"cover them all. Here are recipes for some different types of enumerations " -"that can be used directly, or as examples for creating one's own." +"While :class:`Enum`, :class:`IntEnum`, :class:`StrEnum`, :class:`Flag`, " +"and :class:`IntFlag` are expected to cover the majority of use-cases, they " +"cannot cover them all. Here are recipes for some different types of " +"enumerations that can be used directly, or as examples for creating one's " +"own." msgstr "" msgid "Omitting values" @@ -1814,8 +1726,8 @@ msgid "" msgstr "" msgid "" -"This is also a good example of why you might want to write your own :meth:" -"`~object.__repr__`::" +"This is also a good example of why you might want to write your " +"own :meth:`~object.__repr__`::" msgstr "" msgid "" @@ -2060,8 +1972,8 @@ msgid "An example to show the :attr:`~Enum._ignore_` attribute in use::" msgstr "" msgid "" -">>> from datetime import timedelta\n" -">>> class Period(timedelta, Enum):\n" +">>> import datetime as dt\n" +">>> class Period(dt.timedelta, Enum):\n" "... \"different lengths of time\"\n" "... _ignore_ = 'Period i'\n" "... Period = vars()\n" @@ -2069,11 +1981,11 @@ msgid "" "... Period['day_%d' % i] = i\n" "...\n" ">>> list(Period)[:2]\n" -"[, ]\n" +"[, ]\n" ">>> list(Period)[-2:]\n" -"[, ]" +"[, ]" msgstr "" msgid "Subclassing EnumType" diff --git a/howto/free-threading-extensions.po b/howto/free-threading-extensions.po index 5cc72e4664..a2e2bdc248 100644 --- a/howto/free-threading-extensions.po +++ b/howto/free-threading-extensions.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-06-20 06:42+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -49,6 +49,13 @@ msgid "" "#endif" msgstr "" +msgid "" +"On Windows, this macro is not defined automatically, but must be specified " +"to the compiler when building. The :func:`sysconfig.get_config_var` function " +"can be used to determine whether the current running interpreter had the " +"macro defined." +msgstr "" + msgid "Module Initialization" msgstr "" @@ -68,10 +75,10 @@ msgid "Multi-Phase Initialization" msgstr "" msgid "" -"Extensions that use multi-phase initialization (i.e., :c:func:" -"`PyModuleDef_Init`) should add a :c:data:`Py_mod_gil` slot in the module " -"definition. If your extension supports older versions of CPython, you " -"should guard the slot with a :c:data:`PY_VERSION_HEX` check." +"Extensions that use multi-phase initialization " +"(i.e., :c:func:`PyModuleDef_Init`) should add a :c:data:`Py_mod_gil` slot in " +"the module definition. If your extension supports older versions of " +"CPython, you should guard the slot with a :c:data:`PY_VERSION_HEX` check." msgstr "" msgid "" @@ -94,11 +101,12 @@ msgid "Single-Phase Initialization" msgstr "" msgid "" -"Extensions that use single-phase initialization (i.e., :c:func:" -"`PyModule_Create`) should call :c:func:`PyUnstable_Module_SetGIL` to " -"indicate that they support running with the GIL disabled. The function is " -"only defined in the free-threaded build, so you should guard the call with " -"``#ifdef Py_GIL_DISABLED`` to avoid compilation errors in the regular build." +"Extensions that use single-phase initialization " +"(i.e., :c:func:`PyModule_Create`) should " +"call :c:func:`PyUnstable_Module_SetGIL` to indicate that they support " +"running with the GIL disabled. The function is only defined in the free-" +"threaded build, so you should guard the call with ``#ifdef Py_GIL_DISABLED`` " +"to avoid compilation errors in the regular build." msgstr "" msgid "" @@ -133,9 +141,10 @@ msgid "" msgstr "" msgid "" -"**Macros**: Accessor macros like :c:macro:`PyList_GET_ITEM` and :c:macro:" -"`PyList_SET_ITEM` do not perform any error checking or locking. These macros " -"are not thread-safe if the container object may be modified concurrently." +"**Macros**: Accessor macros like :c:macro:`PyList_GET_ITEM` " +"and :c:macro:`PyList_SET_ITEM` do not perform any error checking or locking. " +"These macros are not thread-safe if the container object may be modified " +"concurrently." msgstr "" msgid "" @@ -149,10 +158,10 @@ msgid "Container Thread Safety" msgstr "" msgid "" -"Containers like :c:struct:`PyListObject`, :c:struct:`PyDictObject`, and :c:" -"struct:`PySetObject` perform internal locking in the free-threaded build. " -"For example, the :c:func:`PyList_Append` will lock the list before appending " -"an item." +"Containers like :c:struct:`PyListObject`, :c:struct:`PyDictObject`, " +"and :c:struct:`PySetObject` perform internal locking in the free-threaded " +"build. For example, the :c:func:`PyList_Append` will lock the list before " +"appending an item." msgstr "" msgid "``PyDict_Next``" @@ -181,8 +190,8 @@ msgstr "" msgid "" "Some C API functions return :term:`borrowed references `. These APIs are not thread-safe if the containing object is " -"modified concurrently. For example, it's not safe to use :c:func:" -"`PyList_GetItem` if the list may be modified concurrently." +"modified concurrently. For example, it's not safe to " +"use :c:func:`PyList_GetItem` if the list may be modified concurrently." msgstr "" msgid "" @@ -202,6 +211,9 @@ msgstr ":c:func:`PyList_GetItem`" msgid ":c:func:`PyList_GetItemRef`" msgstr ":c:func:`PyList_GetItemRef`" +msgid ":c:func:`PyList_GET_ITEM`" +msgstr "" + msgid ":c:func:`PyDict_GetItem`" msgstr ":c:func:`PyDict_GetItem`" @@ -245,13 +257,13 @@ msgid ":c:func:`PyImport_AddModuleRef`" msgstr ":c:func:`PyImport_AddModuleRef`" msgid "" -"Not all APIs that return borrowed references are problematic. For example, :" -"c:func:`PyTuple_GetItem` is safe because tuples are immutable. Similarly, " -"not all uses of the above APIs are problematic. For example, :c:func:" -"`PyDict_GetItem` is often used for parsing keyword argument dictionaries in " -"function calls; those keyword argument dictionaries are effectively private " -"(not accessible by other threads), so using borrowed references in that " -"context is safe." +"Not all APIs that return borrowed references are problematic. For " +"example, :c:func:`PyTuple_GetItem` is safe because tuples are immutable. " +"Similarly, not all uses of the above APIs are problematic. For " +"example, :c:func:`PyDict_GetItem` is often used for parsing keyword argument " +"dictionaries in function calls; those keyword argument dictionaries are " +"effectively private (not accessible by other threads), so using borrowed " +"references in that context is safe." msgstr "" msgid "" @@ -264,18 +276,20 @@ msgid "Memory Allocation APIs" msgstr "" msgid "" -"Python's memory management C API provides functions in three different :ref:" -"`allocation domains `: \"raw\", \"mem\", and \"object\". " -"For thread-safety, the free-threaded build requires that only Python objects " -"are allocated using the object domain, and that all Python object are " -"allocated using that domain. This differs from the prior Python versions, " -"where this was only a best practice and not a hard requirement." +"Python's memory management C API provides functions in three " +"different :ref:`allocation domains `: \"raw\", \"mem\", " +"and \"object\". For thread-safety, the free-threaded build requires that " +"only Python objects are allocated using the object domain, and that all " +"Python object are allocated using that domain. This differs from the prior " +"Python versions, where this was only a best practice and not a hard " +"requirement." msgstr "" msgid "" "Search for uses of :c:func:`PyObject_Malloc` in your extension and check " -"that the allocated memory is used for Python objects. Use :c:func:" -"`PyMem_Malloc` to allocate buffers instead of :c:func:`PyObject_Malloc`." +"that the allocated memory is used for Python objects. " +"Use :c:func:`PyMem_Malloc` to allocate buffers instead " +"of :c:func:`PyObject_Malloc`." msgstr "" msgid "Thread State and GIL APIs" @@ -304,10 +318,10 @@ msgid "" msgstr "" msgid "" -"You should continue to call :c:func:`PyEval_SaveThread` or :c:macro:" -"`Py_BEGIN_ALLOW_THREADS` around blocking operations, such as I/O or lock " -"acquisitions, to allow other threads to run the :term:`cyclic garbage " -"collector `." +"You should continue to call :c:func:`PyEval_SaveThread` " +"or :c:macro:`Py_BEGIN_ALLOW_THREADS` around blocking operations, such as I/O " +"or lock acquisitions, to allow other threads to run the :term:`cyclic " +"garbage collector `." msgstr "" msgid "Protecting Internal Extension State" @@ -347,8 +361,8 @@ msgstr "" msgid "" "`pypa/cibuildwheel `_ supports the " -"free-threaded build if you set `CIBW_FREE_THREADED_SUPPORT `_." +"free-threaded build if you set `CIBW_ENABLE to cpython-freethreading " +"`_." msgstr "" msgid "Limited C API and Stable ABI" diff --git a/howto/free-threading-python.po b/howto/free-threading-python.po index 3a936363ea..327d2c822a 100644 --- a/howto/free-threading-python.po +++ b/howto/free-threading-python.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-10-04 14:19+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -63,7 +63,7 @@ msgstr "" msgid "" "For information on other platforms, see the `Installing a Free-Threaded " -"Python `_, a " +"Python `_, a " "community-maintained installation guide for installing free-threaded Python." msgstr "" @@ -146,10 +146,10 @@ msgid "Immortalization" msgstr "" msgid "" -"The free-threaded build of the 3.13 release makes some objects :term:" -"`immortal`. Immortal objects are not deallocated and have reference counts " -"that are never modified. This is done to avoid reference count contention " -"that would prevent efficient multi-threaded scaling." +"The free-threaded build of the 3.13 release makes some " +"objects :term:`immortal`. Immortal objects are not deallocated and have " +"reference counts that are never modified. This is done to avoid reference " +"count contention that would prevent efficient multi-threaded scaling." msgstr "" msgid "" @@ -191,11 +191,11 @@ msgstr "" msgid "" "It is not safe to access :ref:`frame ` objects from other " -"threads and doing so may cause your program to crash . This means that :" -"func:`sys._current_frames` is generally not safe to use in a free-threaded " -"build. Functions like :func:`inspect.currentframe` and :func:`sys." -"_getframe` are generally safe as long as the resulting frame object is not " -"passed to another thread." +"threads and doing so may cause your program to crash . This means " +"that :func:`sys._current_frames` is generally not safe to use in a free-" +"threaded build. Functions like :func:`inspect.currentframe` " +"and :func:`sys._getframe` are generally safe as long as the resulting frame " +"object is not passed to another thread." msgstr "" msgid "Iterators" diff --git a/howto/functional.po b/howto/functional.po index 28b3ad5f31..1e087db7e6 100644 --- a/howto/functional.po +++ b/howto/functional.po @@ -1,21 +1,21 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Ciarbin , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -26,12 +26,12 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Functional Programming HOWTO" -msgstr "" +msgstr "Poradnik programowania funkcjonalnego" msgid "Author" msgstr "Autor" -msgid "A. M. Kuchling" +msgid "\\A. M. Kuchling" msgstr "" msgid "Release" @@ -43,10 +43,15 @@ msgstr "0.32" msgid "" "In this document, we'll take a tour of Python's features suitable for " "implementing programs in a functional style. After an introduction to the " -"concepts of functional programming, we'll look at language features such as :" -"term:`iterator`\\s and :term:`generator`\\s and relevant library modules " +"concepts of functional programming, we'll look at language features such " +"as :term:`iterator`\\s and :term:`generator`\\s and relevant library modules " "such as :mod:`itertools` and :mod:`functools`." msgstr "" +"W niniejszym dokumencie omówimy elementy języka Python, które nadają się do " +"tworzenia programów w stylu funkcyjnym. Po wprowadzeniu do koncepcji " +"programowania funkcyjnego przyjrzymy się takim elementom języka, " +"jak :term:`iterator`\\s i :term:`generator`\\s, a także odpowiednim modułom " +"bibliotecznym, takim jak :mod:`itertools` i :mod:`functools`." msgid "Introduction" msgstr "Wprowadzenie" @@ -56,16 +61,25 @@ msgid "" "just interested in learning about Python language features, skip to the next " "section on :ref:`functional-howto-iterators`." msgstr "" +"W tej sekcji wyjaśniono podstawowe pojęcia programowania funkcyjnego; jeśli " +"chcesz po prostu zapoznać się z elementami języka Python, przejdź do " +"następnej sekcji poświęconej :ref:`functional-howto-iterators`." msgid "" "Programming languages support decomposing problems in several different ways:" msgstr "" +"Języki programowania umożliwiają rozkładanie problemów na czynniki pierwsze " +"na kilka różnych sposobów:" msgid "" "Most programming languages are **procedural**: programs are lists of " "instructions that tell the computer what to do with the program's input. C, " "Pascal, and even Unix shells are procedural languages." msgstr "" +"Większość języków programowania ma charakter **proceduralny**: programy są " +"listami instrukcji, które wskazują komputerowi, co ma zrobić z danymi " +"wejściowymi programu. Języki C, Pascal, a nawet powłoki systemu Unix są " +"językami proceduralnymi." msgid "" "In **declarative** languages, you write a specification that describes the " @@ -75,6 +89,13 @@ msgid "" "to retrieve, and the SQL engine decides whether to scan tables or use " "indexes, which subclauses should be performed first, etc." msgstr "" +"W językach **deklaratywnych** pisze się specyfikację opisującą problem, " +"który ma zostać rozwiązany, a implementacja języka sama ustala, jak " +"efektywnie przeprowadzić obliczenia. SQL jest językiem deklaratywnym, który " +"najprawdopodobniej znasz najlepiej; zapytanie SQL opisuje zbiór danych, " +"który chcesz pobrać, a silnik SQL decyduje, czy przeszukiwać tabele, czy " +"korzystać z indeksów, które podklauzule należy wykonać w pierwszej " +"kolejności itp." msgid "" "**Object-oriented** programs manipulate collections of objects. Objects " @@ -83,6 +104,11 @@ msgid "" "and Python are languages that support object-oriented programming, but don't " "force the use of object-oriented features." msgstr "" +"Programy **obiektowe** operują na zbiorach obiektów. Obiekty posiadają stan " +"wewnętrzny oraz metody, które w jakiś sposób sprawdzają lub modyfikują ten " +"stan. Smalltalk i Java to języki obiektowe. C++ i Python to języki, które " +"obsługują programowanie obiektowe, ale nie wymuszają stosowania funkcji " +"obiektowych." msgid "" "**Functional** programming decomposes a problem into a set of functions. " @@ -91,6 +117,11 @@ msgid "" "known functional languages include the ML family (Standard ML, OCaml, and " "other variants) and Haskell." msgstr "" +"Programowanie **funkcyjne** polega na rozłożeniu problemu na zbiór funkcji. " +"W idealnym przypadku funkcje przyjmują jedynie dane wejściowe i generują " +"wyniki, nie posiadając żadnego stanu wewnętrznego, który wpływałby na wynik " +"generowany dla danego wejścia. Do dobrze znanych języków funkcyjnych należą " +"języki z rodziny ML (Standard ML, OCaml i inne warianty) oraz Haskell." msgid "" "The designers of some computer languages choose to emphasize one particular " @@ -103,6 +134,15 @@ msgid "" "GUI might be object-oriented while the processing logic is procedural or " "functional, for example." msgstr "" +"Twórcy niektórych języków programowania decydują się na podkreślenie jednego " +"konkretnego podejścia do programowania. Często utrudnia to pisanie programów " +"wykorzystujących inne podejście. Inne języki są językami " +"wieloparadygmatycznymi, które obsługują kilka różnych podejść. Lisp, C++ i " +"Python są językami wieloparadygmatycznymi; we wszystkich tych językach można " +"pisać programy lub biblioteki, które są w dużej mierze proceduralne, " +"obiektowe lub funkcyjne. W dużym programie różne sekcje mogą być napisane z " +"wykorzystaniem różnych podejść; na przykład interfejs graficzny może być " +"obiektowy, podczas gdy logika przetwarzania jest proceduralna lub funkcyjna." msgid "" "In a functional program, input flows through a set of functions. Each " @@ -318,9 +358,10 @@ msgid "" "iterator argument and will return the largest or smallest element. The " "``\"in\"`` and ``\"not in\"`` operators also support iterators: ``X in " "iterator`` is true if X is found in the stream returned by the iterator. " -"You'll run into obvious problems if the iterator is infinite; :func:`max`, :" -"func:`min` will never return, and if the element X never appears in the " -"stream, the ``\"in\"`` and ``\"not in\"`` operators won't return either." +"You'll run into obvious problems if the iterator is " +"infinite; :func:`max`, :func:`min` will never return, and if the element X " +"never appears in the stream, the ``\"in\"`` and ``\"not in\"`` operators " +"won't return either." msgstr "" msgid "" @@ -375,8 +416,9 @@ msgstr "" msgid "" "Applying :func:`iter` to a dictionary always loops over the keys, but " "dictionaries have methods that return other iterators. If you want to " -"iterate over values or key/value pairs, you can explicitly call the :meth:" -"`~dict.values` or :meth:`~dict.items` methods to get an appropriate iterator." +"iterate over values or key/value pairs, you can explicitly call " +"the :meth:`~dict.values` or :meth:`~dict.items` methods to get an " +"appropriate iterator." msgstr "" msgid "" @@ -657,9 +699,9 @@ msgid "" msgstr "" msgid "" -"In Python 2.5 there's a simple way to pass values into a generator. :keyword:" -"`yield` became an expression, returning a value that can be assigned to a " -"variable or otherwise operated on::" +"In Python 2.5 there's a simple way to pass values into a " +"generator. :keyword:`yield` became an expression, returning a value that can " +"be assigned to a variable or otherwise operated on::" msgstr "" msgid "val = (yield i)" @@ -683,8 +725,9 @@ msgstr "" msgid "" "Values are sent into a generator by calling its :meth:`send(value) " "` method. This method resumes the generator's code and the " -"``yield`` expression returns the specified value. If the regular :meth:" -"`~generator.__next__` method is called, the ``yield`` returns ``None``." +"``yield`` expression returns the specified value. If the " +"regular :meth:`~generator.__next__` method is called, the ``yield`` returns " +"``None``." msgstr "" msgid "" @@ -726,19 +769,19 @@ msgid "" msgstr "" msgid "" -":meth:`~generator.close` raises a :exc:`GeneratorExit` exception inside the " +":meth:`~generator.close` sends a :exc:`GeneratorExit` exception to the " "generator to terminate the iteration. On receiving this exception, the " -"generator's code must either raise :exc:`GeneratorExit` or :exc:" -"`StopIteration`; catching the exception and doing anything else is illegal " -"and will trigger a :exc:`RuntimeError`. :meth:`~generator.close` will also " -"be called by Python's garbage collector when the generator is garbage-" -"collected." +"generator's code must either raise :exc:`GeneratorExit` " +"or :exc:`StopIteration`; catching the exception and doing anything else is " +"illegal and will trigger a :exc:`RuntimeError`. :meth:`~generator.close` " +"will also be called by Python's garbage collector when the generator is " +"garbage-collected." msgstr "" msgid "" "If you need to run cleanup code when a :exc:`GeneratorExit` occurs, I " -"suggest using a ``try: ... finally:`` suite instead of catching :exc:" -"`GeneratorExit`." +"suggest using a ``try: ... finally:`` suite instead of " +"catching :exc:`GeneratorExit`." msgstr "" msgid "" @@ -755,7 +798,7 @@ msgid "" msgstr "" msgid "Built-in functions" -msgstr "" +msgstr "Wbudowane funkcje" msgid "" "Let's look in more detail at built-in functions often used with iterators." @@ -1002,10 +1045,11 @@ msgstr "" msgid "" "The :mod:`operator` module contains a set of functions corresponding to " -"Python's operators. Some examples are :func:`operator.add(a, b) ` (adds two values), :func:`operator.ne(a, b) ` (same as " -"``a != b``), and :func:`operator.attrgetter('id') ` " -"(returns a callable that fetches the ``.id`` attribute)." +"Python's operators. Some examples are :func:`operator.add(a, b) " +"` (adds two values), :func:`operator.ne(a, b) ` " +"(same as ``a != b``), and :func:`operator.attrgetter('id') " +"` (returns a callable that fetches the ``.id`` " +"attribute)." msgstr "" msgid "" @@ -1109,9 +1153,10 @@ msgstr "" msgid "" "The elements within each tuple remain in the same order as *iterable* " "returned them. For example, the number 1 is always before 2, 3, 4, or 5 in " -"the examples above. A similar function, :func:`itertools." -"permutations(iterable, r=None) `, removes this " -"constraint on the order, returning all possible arrangements of length *r*::" +"the examples above. A similar " +"function, :func:`itertools.permutations(iterable, r=None) " +"`, removes this constraint on the order, returning " +"all possible arrangements of length *r*::" msgstr "" msgid "" @@ -1150,11 +1195,11 @@ msgid "" msgstr "" msgid "" -"The :func:`itertools.combinations_with_replacement(iterable, r) ` function relaxes a different constraint: " -"elements can be repeated within a single tuple. Conceptually an element is " -"selected for the first position of each tuple and then is replaced before " -"the second element is selected. ::" +"The :func:`itertools.combinations_with_replacement(iterable, r) " +"` function relaxes a different " +"constraint: elements can be repeated within a single tuple. Conceptually an " +"element is selected for the first position of each tuple and then is " +"replaced before the second element is selected. ::" msgstr "" msgid "" @@ -1220,8 +1265,8 @@ msgstr "" msgid "" "The :mod:`functools` module contains some higher-order functions. A **higher-" "order function** takes one or more functions as input and returns a new " -"function. The most useful tool in this module is the :func:`functools." -"partial` function." +"function. The most useful tool in this module is " +"the :func:`functools.partial` function." msgstr "" msgid "" @@ -1259,14 +1304,14 @@ msgid "" ":func:`functools.reduce(func, iter, [initial_value]) ` " "cumulatively performs an operation on all the iterable's elements and, " "therefore, can't be applied to infinite iterables. *func* must be a function " -"that takes two elements and returns a single value. :func:`functools." -"reduce` takes the first two elements A and B returned by the iterator and " -"calculates ``func(A, B)``. It then requests the third element, C, " -"calculates ``func(func(A, B), C)``, combines this result with the fourth " -"element returned, and continues until the iterable is exhausted. If the " -"iterable returns no values at all, a :exc:`TypeError` exception is raised. " -"If the initial value is supplied, it's used as a starting point and " -"``func(initial_value, A)`` is the first calculation. ::" +"that takes two elements and returns a single " +"value. :func:`functools.reduce` takes the first two elements A and B " +"returned by the iterator and calculates ``func(A, B)``. It then requests " +"the third element, C, calculates ``func(func(A, B), C)``, combines this " +"result with the fourth element returned, and continues until the iterable is " +"exhausted. If the iterable returns no values at all, a :exc:`TypeError` " +"exception is raised. If the initial value is supplied, it's used as a " +"starting point and ``func(initial_value, A)`` is the first calculation. ::" msgstr "" msgid "" @@ -1276,7 +1321,7 @@ msgid "" ">>> functools.reduce(operator.concat, [])\n" "Traceback (most recent call last):\n" " ...\n" -"TypeError: reduce() of empty sequence with no initial value\n" +"TypeError: reduce() of empty iterable with no initial value\n" ">>> functools.reduce(operator.mul, [1, 2, 3], 1)\n" "6\n" ">>> functools.reduce(operator.mul, [], 1)\n" @@ -1306,10 +1351,11 @@ msgid "" msgstr "" msgid "" -"A related function is :func:`itertools.accumulate(iterable, func=operator." -"add) `. It performs the same calculation, but instead " -"of returning only the final result, :func:`~itertools.accumulate` returns an " -"iterator that also yields each partial result::" +"A related function is :func:`itertools.accumulate(iterable, " +"func=operator.add) `. It performs the same " +"calculation, but instead of returning only the final " +"result, :func:`~itertools.accumulate` returns an iterator that also yields " +"each partial result::" msgstr "" msgid "" @@ -1526,7 +1572,7 @@ msgid "" msgstr "" msgid "" -"https://www.defmacro.org/ramblings/fp.html: A general introduction to " +"https://defmacro.org/2006/06/19/fp.html: A general introduction to " "functional programming that uses Java examples and has a lengthy historical " "introduction." msgstr "" diff --git a/howto/gdb_helpers.po b/howto/gdb_helpers.po index 7e3f4491e5..b3f463a1e6 100644 --- a/howto/gdb_helpers.po +++ b/howto/gdb_helpers.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-02-25 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +54,8 @@ msgstr "" msgid "" "This document assumes that you are familiar with the basics of GDB and the " -"CPython C API. It consolidates guidance from the `devguide `_ and the `Python wiki `_ and the `Python wiki `_." msgstr "" @@ -297,8 +296,8 @@ msgid "" msgstr "" msgid "" -"Again, the implementation details can be revealed with a cast to :c:expr:" -"`PyUnicodeObject *`::" +"Again, the implementation details can be revealed with a cast " +"to :c:expr:`PyUnicodeObject *`::" msgstr "" msgid "" @@ -409,9 +408,9 @@ msgid "" "9 0 1 0 0 0 3 9 7 6 0 0 0 1 8 0 6 0 0 0 0 2 8 0 0 0 5 0 4 0 6 0 0 2 1 0 0 0 " "0 0 4 5', 'gsd.impossible_hints': 0, 'timer.__absolute_start_time__': , 'gsd.hints': 0, 'timer.active_time': , 'timer.total_time': }], dialog=, saved_game_model=, sudoku_maker=, 'timer.total_time': }], " +"dialog=, saved_game_model=, sudoku_maker=, puzzle=None, saved_games=[{'gsd.auto_fills': 0, 'tracking': {}, " +"'trackers': {}, 'notes': [], 'saved_at': 1270084485, 'game': '7 8 0 0 0 0 0 " +"5 6 0 0 9 0 8 0 1 0 0 0 4 6 0 0 0 0 7 0 6 5 0 0 0 4 7 9 2 0 0 0 9 0 1 0 0 0 " +"3 9 7 6 0 0 0 1 8 0 6 0 0 0 0 2 8 0 0 0 5 0 4 0 6 0 0 2 1 0 0 0 0 0 4 5\\n7 " +"8 0 0 0 0 0 5 6 0 0 9 0 8 0 1 0 0 0 4 6 0 0 0 0 7 0 6 5 1 8 3 4 7 9 2 0 0 0 " +"9 0 1 0 0 0 3 9 7 6 0 0 0 1 8 0 6 0 0 0 0 2 8 0 0 0 5 0 4 0 6 0 0 2 1 0 0 0 " +"0 0 4 5', 'gsd.impossible_hints': 0, 'timer.__absolute_start_time__': , 'gsd.hints': 0, 'timer.active_time': , 'timer.total_time': }], " +"dialog=, saved_game_model=, sudoku_maker=, main_page=0) " +"at remote 0x98fa6e4>, d=)\n" +" gtk.main()\n" +"(gdb) py-down\n" +"#8 (unable to read python frame information)\n" +"(gdb) py-down\n" +"Unable to find a newer python frame" msgid "and we're at the bottom of the Python stack." msgstr "" @@ -488,9 +524,9 @@ msgid "" "9 0 1 0 0 0 3 9 7 6 0 0 0 1 8 0 6 0 0 0 0 2 8 0 0 0 5 0 4 0 6 0 0 2 1 0 0 0 " "0 0 4 5', 'gsd.impossible_hints': 0, 'timer.__absolute_start_time__': , 'gsd.hints': 0, 'timer.active_time': , 'timer.total_time': }], dialog=, saved_game_model=, sudoku_maker=, 'timer.total_time': }], " +"dialog=, saved_game_model=, sudoku_maker=)\n" " main.start_game()" msgstr "" +"(gdb) py-bt\n" +"#8 (unable to read python frame information)\n" +"#11 Frame 0x9aead74, for file /usr/lib/python2.6/site-packages/gnome_sudoku/" +"dialog_swallower.py, line 48, in run_dialog " +"(self=, main_page=0) " +"at remote 0x98fa6e4>, d=)\n" +" gtk.main()\n" +"#14 Frame 0x99262ac, for file /usr/lib/python2.6/site-packages/gnome_sudoku/" +"game_selector.py, line 201, in run_swallowed_dialog " +"(self=, puzzle=None, saved_games=[{'gsd.auto_fills': 0, 'tracking': {}, " +"'trackers': {}, 'notes': [], 'saved_at': 1270084485, 'game': '7 8 0 0 0 0 0 " +"5 6 0 0 9 0 8 0 1 0 0 0 4 6 0 0 0 0 7 0 6 5 0 0 0 4 7 9 2 0 0 0 9 0 1 0 0 0 " +"3 9 7 6 0 0 0 1 8 0 6 0 0 0 0 2 8 0 0 0 5 0 4 0 6 0 0 2 1 0 0 0 0 0 4 5\\n7 " +"8 0 0 0 0 0 5 6 0 0 9 0 8 0 1 0 0 0 4 6 0 0 0 0 7 0 6 5 1 8 3 4 7 9 2 0 0 0 " +"9 0 1 0 0 0 3 9 7 6 0 0 0 1 8 0 6 0 0 0 0 2 8 0 0 0 5 0 4 0 6 0 0 2 1 0 0 0 " +"0 0 4 5', 'gsd.impossible_hints': 0, 'timer.__absolute_start_time__': , 'gsd.hints': 0, 'timer.active_time': , 'timer.total_time': }], " +"dialog=, saved_game_model=, sudoku_maker=)\n" +" main.start_game()" msgid "" "The frame numbers correspond to those displayed by GDB's standard " @@ -590,8 +659,8 @@ msgid "" " main()\n" "(gdb) frame 68\n" "#68 0x00000000004cd1e6 in PyEval_EvalFrameEx (f=Frame 0xaa4560, for file Lib/" -"test/regrtest.py, line 1548, in (), throwflag=0) at Python/ceval." -"c:2665\n" +"test/regrtest.py, line 1548, in (), throwflag=0) at Python/" +"ceval.c:2665\n" "2665 x = call_function(&sp, oparg);\n" "(gdb) py-list\n" "1543 # Run the tests in a context manager that temporary changes the " @@ -705,3 +774,80 @@ msgid "" ", , _RLock__count=1) at remote " +"0xd7ff40>, count_owner=(1, 140737213728528), count=1, " +"owner=140737213728528)\n" +" self.__block.acquire()\n" +"#8 Frame 0x7fffac001640, for file /home/david/coding/python-svn/Lib/" +"threading.py, line 269, in wait " +"(self=<_Condition(_Condition__lock=<_RLock(_Verbose__verbose=False, " +"_RLock__owner=140737354016512, _RLock__block=, _RLock__count=1) at remote 0xd7ff40>, acquire=, _is_owned=, " +"_release_save=, release=, _acquire_restore=, " +"_Verbose__verbose=False, _Condition__waiters=[]) at remote 0xd7fd10>, " +"timeout=None, waiter=, saved_state=(1, " +"140737213728528))\n" +" self._acquire_restore(saved_state)\n" +"#12 Frame 0x7fffb8001a10, for file /home/david/coding/python-svn/Lib/test/" +"lock_tests.py, line 348, in f ()\n" +" cond.wait()\n" +"#16 Frame 0x7fffb8001c40, for file /home/david/coding/python-svn/Lib/test/" +"lock_tests.py, line 37, in task (tid=140737213728528)\n" +" f()\n" +"\n" +"Thread 104 (Thread 0x7fffdf5fe710 (LWP 10259)):\n" +"#5 Frame 0x7fffe4001580, for file /home/david/coding/python-svn/Lib/" +"threading.py, line 155, in _acquire_restore " +"(self=<_RLock(_Verbose__verbose=False, _RLock__owner=140737354016512, " +"_RLock__block=, _RLock__count=1) at remote " +"0xd7ff40>, count_owner=(1, 140736940992272), count=1, " +"owner=140736940992272)\n" +" self.__block.acquire()\n" +"#8 Frame 0x7fffc8002090, for file /home/david/coding/python-svn/Lib/" +"threading.py, line 269, in wait " +"(self=<_Condition(_Condition__lock=<_RLock(_Verbose__verbose=False, " +"_RLock__owner=140737354016512, _RLock__block=, _RLock__count=1) at remote 0xd7ff40>, acquire=, _is_owned=, " +"_release_save=, release=, _acquire_restore=, " +"_Verbose__verbose=False, _Condition__waiters=[]) at remote 0xd7fd10>, " +"timeout=None, waiter=, saved_state=(1, " +"140736940992272))\n" +" self._acquire_restore(saved_state)\n" +"#12 Frame 0x7fffac001c90, for file /home/david/coding/python-svn/Lib/test/" +"lock_tests.py, line 348, in f ()\n" +" cond.wait()\n" +"#16 Frame 0x7fffac0011c0, for file /home/david/coding/python-svn/Lib/test/" +"lock_tests.py, line 37, in task (tid=140736940992272)\n" +" f()\n" +"\n" +"Thread 1 (Thread 0x7ffff7fe2700 (LWP 10145)):\n" +"#5 Frame 0xcb5380, for file /home/david/coding/python-svn/Lib/test/" +"lock_tests.py, line 16, in _wait ()\n" +" time.sleep(0.01)\n" +"#8 Frame 0x7fffd00024a0, for file /home/david/coding/python-svn/Lib/test/" +"lock_tests.py, line 378, in _check_notify " +"(self=, skipped=[], _mirrorOutput=False, testsRun=39, " +"buffer=False, _original_stderr=, " +"_stdout_buffer=, " +"_stderr_buffer=, " +"_moduleSetUpFailed=False, expectedFailures=[], errors=[], " +"_previousTestClass=, unexpectedSuccesses=[], " +"failures=[], shouldStop=False, failfast=False) at remote 0xc185a0>, " +"_threads=(0,), _cleanups=[], _type_equality_funcs={: , : " +", : " +", : " +", , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 +# Ciarbin , 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Ciarbin , 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -33,9 +33,16 @@ msgid "" "effort to foster documentation that's more detailed than the Python Library " "Reference." msgstr "" +"Poradniki dotyczące języka Python to dokumenty, które dogłębnie omawiają " +"konkretny temat. Zbiór ten, wzorowany na kolekcji poradników HOWTO w ramach " +"projektu Linux Documentation Project, stanowi próbę stworzenia dokumentacji " +"bardziej szczegółowej niż dokumentacja biblioteki standardowej Pythona." msgid "General:" -msgstr "" +msgstr "Ogólne:" + +msgid ":ref:`a-conceptual-overview-of-asyncio`" +msgstr ":ref:`a-conceptual-overview-of-asyncio`" msgid ":ref:`annotations-howto`" msgstr ":ref:`annotations-howto`" @@ -74,7 +81,7 @@ msgid ":ref:`urllib-howto`" msgstr ":ref:`urllib-howto`" msgid "Advanced development:" -msgstr "" +msgstr "Tematy bardziej zaawansowane:" msgid ":ref:`curses-howto`" msgstr ":ref:`curses-howto`" @@ -101,7 +108,7 @@ msgid ":ref:`cporting-howto`" msgstr ":ref:`cporting-howto`" msgid "Debugging and profiling:" -msgstr "" +msgstr "Debugowanie i profilowanie:" msgid ":ref:`gdb`" msgstr ":ref:`gdb`" diff --git a/howto/instrumentation.po b/howto/instrumentation.po index 5cad64c008..905a4e4cc6 100644 --- a/howto/instrumentation.po +++ b/howto/instrumentation.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -352,8 +350,9 @@ msgid "should instead read:" msgstr "" msgid "" -"probe process(\"python\").library(\"libpython3.6dm.so.1.0\")." -"mark(\"function__entry\") {" +"probe " +"process(\"python\").library(\"libpython3.6dm.so.1.0\").mark(\"function__entry\") " +"{" msgstr "" msgid "(assuming a :ref:`debug build ` of CPython 3.6)" @@ -430,6 +429,82 @@ msgid "" "tuple object." msgstr "" +msgid "C Entry Points" +msgstr "" + +msgid "" +"To simplify triggering of DTrace markers, Python's C API comes with a number " +"of helper functions that mirror each static marker. On builds of Python " +"without DTrace enabled, these do nothing." +msgstr "" + +msgid "" +"In general, it is not necessary to call these yourself, as Python will do it " +"for you." +msgstr "" + +msgid "C API Function" +msgstr "" + +msgid "Static Marker" +msgstr "" + +msgid "Notes" +msgstr "Notatki" + +msgid ":c:func:`!line`" +msgstr "" + +msgid ":c:func:`!function__entry`" +msgstr "" + +msgid ":c:func:`!function__return`" +msgstr "" + +msgid ":c:func:`!gc__start`" +msgstr "" + +msgid ":c:func:`!gc__done`" +msgstr "" + +msgid ":c:func:`!instance__new__start`" +msgstr "" + +msgid "Not used by Python" +msgstr "" + +msgid ":c:func:`!instance__new__done`" +msgstr "" + +msgid ":c:func:`!instance__delete__start`" +msgstr "" + +msgid ":c:func:`!instance__delete__done`" +msgstr "" + +msgid ":c:func:`!import__find__load__start`" +msgstr "" + +msgid ":c:func:`!import__find__load__done`" +msgstr "" + +msgid ":c:func:`!audit`" +msgstr "" + +msgid "C Probing Checks" +msgstr "" + +msgid "" +"All calls to ``PyDTrace`` functions must be guarded by a call to one of " +"these functions. This allows Python to minimize performance impact when " +"probing is disabled." +msgstr "" + +msgid "" +"On builds without DTrace enabled, these functions do nothing and return " +"``0``." +msgstr "" + msgid "SystemTap Tapsets" msgstr "" @@ -454,8 +529,8 @@ msgid "" " lineno = $arg3;\n" " frameptr = $arg4\n" "}\n" -"probe python.function.return = process(\"python\")." -"mark(\"function__return\")\n" +"probe python.function.return = " +"process(\"python\").mark(\"function__return\")\n" "{\n" " filename = user_string($arg1);\n" " funcname = user_string($arg2);\n" diff --git a/howto/ipaddress.po b/howto/ipaddress.po index d8d1230ce8..3c0ece6ad0 100644 --- a/howto/ipaddress.po +++ b/howto/ipaddress.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -129,8 +127,8 @@ msgid "Defining Networks" msgstr "" msgid "" -"Host addresses are usually grouped together into IP networks, so :mod:" -"`ipaddress` provides a way to create, inspect and manipulate network " +"Host addresses are usually grouped together into IP networks, " +"so :mod:`ipaddress` provides a way to create, inspect and manipulate network " "definitions. IP network objects are constructed from strings that define the " "range of host addresses that are part of that network. The simplest form for " "that information is a \"network address/network prefix\" pair, where the " @@ -210,11 +208,11 @@ msgid "" "network, neither the address nor the network classes are sufficient. " "Notation like ``192.0.2.1/24`` is commonly used by network engineers and the " "people who write tools for firewalls and routers as shorthand for \"the host " -"``192.0.2.1`` on the network ``192.0.2.0/24``\", Accordingly, :mod:" -"`ipaddress` provides a set of hybrid classes that associate an address with " -"a particular network. The interface for creation is identical to that for " -"defining network objects, except that the address portion isn't constrained " -"to being a network address." +"``192.0.2.1`` on the network ``192.0.2.0/24``\", " +"Accordingly, :mod:`ipaddress` provides a set of hybrid classes that " +"associate an address with a particular network. The interface for creation " +"is identical to that for defining network objects, except that the address " +"portion isn't constrained to being a network address." msgstr "" msgid "" @@ -227,8 +225,8 @@ msgstr "" msgid "" "You've gone to the trouble of creating an IPv(4|6)(Address|Network|" -"Interface) object, so you probably want to get information about it. :mod:" -"`ipaddress` tries to make doing this easy and intuitive." +"Interface) object, so you probably want to get information about " +"it. :mod:`ipaddress` tries to make doing this easy and intuitive." msgstr "" msgid "Extracting the IP version::" @@ -422,9 +420,9 @@ msgstr "" msgid "" "To support use cases where it is useful to have access to this additional " -"detail, the individual class constructors actually raise the :exc:" -"`ValueError` subclasses :exc:`ipaddress.AddressValueError` and :exc:" -"`ipaddress.NetmaskValueError` to indicate exactly which part of the " +"detail, the individual class constructors actually raise " +"the :exc:`ValueError` subclasses :exc:`ipaddress.AddressValueError` " +"and :exc:`ipaddress.NetmaskValueError` to indicate exactly which part of the " "definition failed to parse correctly." msgstr "" diff --git a/howto/isolating-extensions.po b/howto/isolating-extensions.po index 959270e836..3e7b880d0a 100644 --- a/howto/isolating-extensions.po +++ b/howto/isolating-extensions.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2022-11-05 19:48+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +71,8 @@ msgid "" msgstr "" msgid "" -"in parallel, managing \"sub-interpreters\" using :c:func:" -"`Py_NewInterpreter`/:c:func:`Py_EndInterpreter`." +"in parallel, managing \"sub-interpreters\" " +"using :c:func:`Py_NewInterpreter`/:c:func:`Py_EndInterpreter`." msgstr "" msgid "" @@ -225,8 +225,8 @@ msgstr "" msgid "" "If it is necessary to use process-global state, the simplest way to avoid " "issues with multiple interpreters is to explicitly prevent a module from " -"being loaded more than once per process—see `Opt-Out: Limiting to One Module " -"Object per Process`_." +"being loaded more than once per process—see :ref:`isolating-extensions-" +"optout`." msgstr "" msgid "Managing Per-Module State" @@ -271,8 +271,9 @@ msgstr "" msgid "" "An example of a module with per-module state is currently available as " -"`xxlimited `__; example module initialization shown at the bottom of the file." +"`xxlimited `__; example module initialization shown at the bottom of the " +"file." msgstr "" msgid "Opt-Out: Limiting to One Module Object per Process" @@ -286,21 +287,36 @@ msgid "" msgstr "" msgid "" +"// A process-wide flag\n" "static int loaded = 0;\n" "\n" +"// Mutex to provide thread safety (only needed for free-threaded Python)\n" +"static PyMutex modinit_mutex = {0};\n" +"\n" "static int\n" "exec_module(PyObject* module)\n" "{\n" +" PyMutex_Lock(&modinit_mutex);\n" " if (loaded) {\n" +" PyMutex_Unlock(&modinit_mutex);\n" " PyErr_SetString(PyExc_ImportError,\n" " \"cannot load module more than once per process\");\n" " return -1;\n" " }\n" " loaded = 1;\n" +" PyMutex_Unlock(&modinit_mutex);\n" " // ... rest of initialization\n" "}" msgstr "" +msgid "" +"If your module's :c:member:`PyModuleDef.m_clear` function is able to prepare " +"for future re-initialization, it should clear the ``loaded`` flag. In this " +"case, your module won't support multiple instances existing *concurrently*, " +"but it will, for example, support being loaded after Python runtime shutdown " +"(:c:func:`Py_FinalizeEx`) and re-initialization (:c:func:`Py_Initialize`)." +msgstr "" + msgid "Module State Access from Functions" msgstr "" @@ -382,8 +398,8 @@ msgid "" msgstr "" msgid "" -"Unlike static types, heap type objects are mutable by default. Use the :c:" -"macro:`Py_TPFLAGS_IMMUTABLETYPE` flag to prevent mutability." +"Unlike static types, heap type objects are mutable by default. Use " +"the :c:macro:`Py_TPFLAGS_IMMUTABLETYPE` flag to prevent mutability." msgstr "" msgid "" @@ -397,8 +413,8 @@ msgstr "" msgid "" "Heap types can be created by filling a :c:struct:`PyType_Spec` structure, a " -"description or \"blueprint\" of a class, and calling :c:func:" -"`PyType_FromModuleAndSpec` to construct a new class object." +"description or \"blueprint\" of a class, and " +"calling :c:func:`PyType_FromModuleAndSpec` to construct a new class object." msgstr "" msgid "" @@ -435,8 +451,8 @@ msgid "" msgstr "" msgid "" -"Please refer to the documentation of :c:macro:`Py_TPFLAGS_HAVE_GC` and :c:" -"member:`~PyTypeObject.tp_traverse` for additional considerations." +"Please refer to the documentation of :c:macro:`Py_TPFLAGS_HAVE_GC` " +"and :c:member:`~PyTypeObject.tp_traverse` for additional considerations." msgstr "" msgid "" @@ -473,18 +489,18 @@ msgid ":c:macro:`PY_VERSION_HEX`, if not using the stable ABI, or" msgstr "" msgid "" -":py:data:`sys.version_info` (via :c:func:`PySys_GetObject` and :c:func:" -"`PyArg_ParseTuple`)." +":py:data:`sys.version_info` (via :c:func:`PySys_GetObject` " +"and :c:func:`PyArg_ParseTuple`)." msgstr "" msgid "Delegating ``tp_traverse``" msgstr "" msgid "" -"If your traverse function delegates to the :c:member:`~PyTypeObject." -"tp_traverse` of its base class (or another type), ensure that " -"``Py_TYPE(self)`` is visited only once. Note that only heap type are " -"expected to visit the type in ``tp_traverse``." +"If your traverse function delegates to " +"the :c:member:`~PyTypeObject.tp_traverse` of its base class (or another " +"type), ensure that ``Py_TYPE(self)`` is visited only once. Note that only " +"heap type are expected to visit the type in ``tp_traverse``." msgstr "" msgid "For example, if your traverse function includes::" @@ -507,8 +523,8 @@ msgid "" msgstr "" msgid "" -"It is not necessary to handle the type's reference count in :c:member:" -"`~PyTypeObject.tp_new` and :c:member:`~PyTypeObject.tp_clear`." +"It is not necessary to handle the type's reference count " +"in :c:member:`~PyTypeObject.tp_new` and :c:member:`~PyTypeObject.tp_clear`." msgstr "" msgid "Defining ``tp_dealloc``" @@ -551,8 +567,8 @@ msgid "Not overriding ``tp_free``" msgstr "" msgid "" -"The :c:member:`~PyTypeObject.tp_free` slot of a heap type must be set to :c:" -"func:`PyObject_GC_Del`. This is the default; do not override it." +"The :c:member:`~PyTypeObject.tp_free` slot of a heap type must be set " +"to :c:func:`PyObject_GC_Del`. This is the default; do not override it." msgstr "" msgid "Avoiding ``PyObject_New``" @@ -561,7 +577,7 @@ 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`:" +msgid "If you use :c:func:`PyObject_New` or :c:func:`PyObject_NewVar`:" msgstr "" msgid "" @@ -578,8 +594,8 @@ msgid "" msgstr "" msgid "" -"If the above is not possible (e.g. inside a custom ``tp_alloc``), call :c:" -"func:`PyObject_GC_New` or :c:func:`PyObject_GC_NewVar`::" +"If the above is not possible (e.g. inside a custom ``tp_alloc``), " +"call :c:func:`PyObject_GC_New` or :c:func:`PyObject_GC_NewVar`::" msgstr "" msgid "" @@ -632,8 +648,8 @@ msgid "" msgstr "" msgid "" -"The following Python code can illustrate the concept. ``Base." -"get_defining_class`` returns ``Base`` even if ``type(self) == Sub``:" +"The following Python code can illustrate the concept. " +"``Base.get_defining_class`` returns ``Base`` even if ``type(self) == Sub``:" msgstr "" msgid "" @@ -649,10 +665,10 @@ msgid "" msgstr "" msgid "" -"For a method to get its \"defining class\", it must use the :ref:" -"`METH_METHOD | METH_FASTCALL | METH_KEYWORDS ` :c:type:`calling convention ` and the " -"corresponding :c:type:`PyCMethod` signature::" +"For a method to get its \"defining class\", it must use " +"the :ref:`METH_METHOD | METH_FASTCALL | METH_KEYWORDS ` :c:type:`calling convention ` and " +"the corresponding :c:type:`PyCMethod` signature::" msgstr "" msgid "" @@ -705,18 +721,19 @@ msgid "This is new in Python 3.11." msgstr "" msgid "" -"Slot methods—the fast C equivalents for special methods, such as :c:member:" -"`~PyNumberMethods.nb_add` for :py:attr:`~object.__add__` or :c:member:" -"`~PyTypeObject.tp_new` for initialization—have a very simple API that " -"doesn't allow passing in the defining class, unlike with :c:type:" -"`PyCMethod`. The same goes for getters and setters defined with :c:type:" -"`PyGetSetDef`." +"Slot methods—the fast C equivalents for special methods, such " +"as :c:member:`~PyNumberMethods.nb_add` for :py:attr:`~object.__add__` " +"or :c:member:`~PyTypeObject.tp_new` for initialization—have a very simple " +"API that doesn't allow passing in the defining class, unlike " +"with :c:type:`PyCMethod`. The same goes for getters and setters defined " +"with :c:type:`PyGetSetDef`." msgstr "" msgid "" -"To access the module state in these cases, use the :c:func:" -"`PyType_GetModuleByDef` function, and pass in the module definition. Once " -"you have the module, call :c:func:`PyModule_GetState` to get the state::" +"To access the module state in these cases, use " +"the :c:func:`PyType_GetModuleByDef` function, and pass in the module " +"definition. Once you have the module, call :c:func:`PyModule_GetState` to " +"get the state::" msgstr "" msgid "" @@ -750,11 +767,11 @@ msgid "" msgstr "" msgid "" -"Usually this is not an issue, because types created with :c:func:" -"`PyType_FromModuleAndSpec`, and their instances, hold a reference to the " -"module. However, you must be careful in reference counting when you " -"reference module state from other places, such as callbacks for external " -"libraries." +"Usually this is not an issue, because types created " +"with :c:func:`PyType_FromModuleAndSpec`, and their instances, hold a " +"reference to the module. However, you must be careful in reference counting " +"when you reference module state from other places, such as callbacks for " +"external libraries." msgstr "" msgid "Open Issues" @@ -764,9 +781,8 @@ msgid "Several issues around per-module state and heap types are still open." msgstr "" msgid "" -"Discussions about improving the situation are best held on the `capi-sig " -"mailing list `__." +"Discussions about improving the situation are best held on the `discuss " +"forum under c-api tag `__." msgstr "" msgid "Per-Class Scope" diff --git a/howto/logging-cookbook.po b/howto/logging-cookbook.po index 3f67d94a80..411a0c9f37 100644 --- a/howto/logging-cookbook.po +++ b/howto/logging-cookbook.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +66,8 @@ msgid "" "ch = logging.StreamHandler()\n" "ch.setLevel(logging.ERROR)\n" "# create formatter and add it to the handlers\n" -"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - " -"%(message)s')\n" +"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %" +"(message)s')\n" "fh.setFormatter(formatter)\n" "ch.setFormatter(formatter)\n" "# add the handlers to the logger\n" @@ -98,8 +96,8 @@ msgid "" "\n" "class Auxiliary:\n" " def __init__(self):\n" -" self.logger = logging.getLogger('spam_application.auxiliary." -"Auxiliary')\n" +" self.logger = " +"logging.getLogger('spam_application.auxiliary.Auxiliary')\n" " self.logger.info('creating an instance of Auxiliary')\n" "\n" " def do_something(self):\n" @@ -156,8 +154,8 @@ msgid "" " time.sleep(0.5)\n" "\n" "def main():\n" -" logging.basicConfig(level=logging.DEBUG, format='%(relativeCreated)6d " -"%(threadName)s %(message)s')\n" +" logging.basicConfig(level=logging.DEBUG, format='%(relativeCreated)6d %" +"(threadName)s %(message)s')\n" " info = {'stop': False}\n" " thread = threading.Thread(target=worker, args=(info,))\n" " thread.start()\n" @@ -228,8 +226,8 @@ msgid "" "ch = logging.StreamHandler()\n" "ch.setLevel(logging.ERROR)\n" "# create formatter and add it to the handlers\n" -"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - " -"%(message)s')\n" +"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %" +"(message)s')\n" "ch.setFormatter(formatter)\n" "fh.setFormatter(formatter)\n" "# add the handlers to logger\n" @@ -277,8 +275,8 @@ msgid "" "\n" "# set up logging to file - see previous section for more details\n" "logging.basicConfig(level=logging.DEBUG,\n" -" format='%(asctime)s %(name)-12s %(levelname)-8s " -"%(message)s',\n" +" format='%(asctime)s %(name)-12s %(levelname)-8s %" +"(message)s',\n" " datefmt='%m-%d %H:%M',\n" " filename='/tmp/myapp.log',\n" " filemode='w')\n" @@ -290,7 +288,7 @@ msgid "" "# tell the handler to use this format\n" "console.setFormatter(formatter)\n" "# add the handler to the root logger\n" -"logging.getLogger('').addHandler(console)\n" +"logging.getLogger().addHandler(console)\n" "\n" "# Now, we can log to the root logger, or any other logger. First the " "root...\n" @@ -465,9 +463,9 @@ msgid "" "a function which only returns ``True`` if the level of the passed in record " "is at or below the specified level. Note that in this example I have defined " "the ``filter_maker`` in a test script ``main.py`` that I run from the " -"command line, so its module will be ``__main__`` - hence the ``__main__." -"filter_maker`` in the filter configuration. You will need to change that if " -"you define it in a different module." +"command line, so its module will be ``__main__`` - hence the " +"``__main__.filter_maker`` in the filter configuration. You will need to " +"change that if you define it in a different module." msgstr "" msgid "With the filter added, we can run ``main.py``, which in full is:" @@ -644,13 +642,13 @@ msgid "" msgstr "" msgid "" -"A common culprit which demonstrates sluggish behaviour is the :class:" -"`SMTPHandler`: sending emails can take a long time, for a number of reasons " -"outside the developer's control (for example, a poorly performing mail or " -"network infrastructure). But almost any network-based handler can block: " -"Even a :class:`SocketHandler` operation may do a DNS query under the hood " -"which is too slow (and this query can be deep in the socket library code, " -"below the Python layer, and outside your control)." +"A common culprit which demonstrates sluggish behaviour is " +"the :class:`SMTPHandler`: sending emails can take a long time, for a number " +"of reasons outside the developer's control (for example, a poorly performing " +"mail or network infrastructure). But almost any network-based handler can " +"block: Even a :class:`SocketHandler` operation may do a DNS query under the " +"hood which is too slow (and this query can be deep in the socket library " +"code, below the Python layer, and outside your control)." msgstr "" msgid "" @@ -668,12 +666,12 @@ msgstr "" msgid "" "The second part of the solution is :class:`QueueListener`, which has been " -"designed as the counterpart to :class:`QueueHandler`. A :class:" -"`QueueListener` is very simple: it's passed a queue and some handlers, and " -"it fires up an internal thread which listens to its queue for LogRecords " -"sent from ``QueueHandlers`` (or any other source of ``LogRecords``, for that " -"matter). The ``LogRecords`` are removed from the queue and passed to the " -"handlers for processing." +"designed as the counterpart to :class:`QueueHandler`. " +"A :class:`QueueListener` is very simple: it's passed a queue and some " +"handlers, and it fires up an internal thread which listens to its queue for " +"LogRecords sent from ``QueueHandlers`` (or any other source of " +"``LogRecords``, for that matter). The ``LogRecords`` are removed from the " +"queue and passed to the handlers for processing." msgstr "" msgid "" @@ -715,10 +713,10 @@ msgid "" "Although the earlier discussion wasn't specifically talking about async " "code, but rather about slow logging handlers, it should be noted that when " "logging from async code, network and even file handlers could lead to " -"problems (blocking the event loop) because some logging is done from :mod:" -"`asyncio` internals. It might be best, if any async code is used in an " -"application, to use the above approach for logging, so that any blocking " -"code runs only in the ``QueueListener`` thread." +"problems (blocking the event loop) because some logging is done " +"from :mod:`asyncio` internals. It might be best, if any async code is used " +"in an application, to use the above approach for logging, so that any " +"blocking code runs only in the ``QueueListener`` thread." msgstr "" msgid "" @@ -737,14 +735,14 @@ msgstr "" msgid "" "Let's say you want to send logging events across a network, and handle them " -"at the receiving end. A simple way of doing this is attaching a :class:" -"`SocketHandler` instance to the root logger at the sending end::" +"at the receiving end. A simple way of doing this is attaching " +"a :class:`SocketHandler` instance to the root logger at the sending end::" msgstr "" msgid "" "import logging, logging.handlers\n" "\n" -"rootLogger = logging.getLogger('')\n" +"rootLogger = logging.getLogger()\n" "rootLogger.setLevel(logging.DEBUG)\n" "socketHandler = logging.handlers.SocketHandler('localhost',\n" " logging.handlers.DEFAULT_TCP_LOGGING_PORT)\n" @@ -769,8 +767,8 @@ msgid "" msgstr "" msgid "" -"At the receiving end, you can set up a receiver using the :mod:" -"`socketserver` module. Here is a basic working example::" +"At the receiving end, you can set up a receiver using " +"the :mod:`socketserver` module. Here is a basic working example::" msgstr "" msgid "" @@ -853,8 +851,8 @@ msgid "" "\n" "def main():\n" " logging.basicConfig(\n" -" format='%(relativeCreated)5d %(name)-15s %(levelname)-8s " -"%(message)s')\n" +" format='%(relativeCreated)5d %(name)-15s %(levelname)-8s %" +"(message)s')\n" " tcpserver = LogRecordSocketReceiver()\n" " print('About to start TCP server...')\n" " tcpserver.serve_until_stopped()\n" @@ -963,8 +961,8 @@ msgid "To test these files, do the following in a POSIX environment:" msgstr "" msgid "" -"Download `the Gist `__ as a ZIP archive using the :" -"guilabel:`Download ZIP` button." +"Download `the Gist `__ as a ZIP archive using " +"the :guilabel:`Download ZIP` button." msgstr "" msgid "Unzip the above files from the archive into a scratch directory." @@ -1036,8 +1034,8 @@ msgid "" "is not a good idea because these instances are not garbage collected. While " "this is not a problem in practice, when the number of :class:`Logger` " "instances is dependent on the level of granularity you want to use in " -"logging an application, it could be hard to manage if the number of :class:" -"`Logger` instances becomes effectively unbounded." +"logging an application, it could be hard to manage if the number " +"of :class:`Logger` instances becomes effectively unbounded." msgstr "" msgid "Using LoggerAdapters to impart contextual information" @@ -1046,21 +1044,21 @@ msgstr "" msgid "" "An easy way in which you can pass contextual information to be output along " "with logging event information is to use the :class:`LoggerAdapter` class. " -"This class is designed to look like a :class:`Logger`, so that you can call :" -"meth:`debug`, :meth:`info`, :meth:`warning`, :meth:`error`, :meth:" -"`exception`, :meth:`critical` and :meth:`log`. These methods have the same " -"signatures as their counterparts in :class:`Logger`, so you can use the two " -"types of instances interchangeably." +"This class is designed to look like a :class:`Logger`, so that you can " +"call :meth:`debug`, :meth:`info`, :meth:`warning`, :meth:`error`, :meth:`exception`, :meth:`critical` " +"and :meth:`log`. These methods have the same signatures as their " +"counterparts in :class:`Logger`, so you can use the two types of instances " +"interchangeably." msgstr "" msgid "" -"When you create an instance of :class:`LoggerAdapter`, you pass it a :class:" -"`Logger` instance and a dict-like object which contains your contextual " -"information. When you call one of the logging methods on an instance of :" -"class:`LoggerAdapter`, it delegates the call to the underlying instance of :" -"class:`Logger` passed to its constructor, and arranges to pass the " -"contextual information in the delegated call. Here's a snippet from the code " -"of :class:`LoggerAdapter`::" +"When you create an instance of :class:`LoggerAdapter`, you pass it " +"a :class:`Logger` instance and a dict-like object which contains your " +"contextual information. When you call one of the logging methods on an " +"instance of :class:`LoggerAdapter`, it delegates the call to the underlying " +"instance of :class:`Logger` passed to its constructor, and arranges to pass " +"the contextual information in the delegated call. Here's a snippet from the " +"code of :class:`LoggerAdapter`::" msgstr "" msgid "" @@ -1091,8 +1089,9 @@ msgid "" "use customized strings with your :class:`Formatter` instances which know " "about the keys of the dict-like object. If you need a different method, e.g. " "if you want to prepend or append the contextual information to the message " -"string, you just need to subclass :class:`LoggerAdapter` and override :meth:" -"`~LoggerAdapter.process` to do what you need. Here is a simple example::" +"string, you just need to subclass :class:`LoggerAdapter` and " +"override :meth:`~LoggerAdapter.process` to do what you need. Here is a " +"simple example::" msgstr "" msgid "" @@ -1133,22 +1132,22 @@ msgid "Using Filters to impart contextual information" msgstr "" msgid "" -"You can also add contextual information to log output using a user-defined :" -"class:`Filter`. ``Filter`` instances are allowed to modify the " +"You can also add contextual information to log output using a user-" +"defined :class:`Filter`. ``Filter`` instances are allowed to modify the " "``LogRecords`` passed to them, including adding additional attributes which " -"can then be output using a suitable format string, or if needed a custom :" -"class:`Formatter`." +"can then be output using a suitable format string, or if needed a " +"custom :class:`Formatter`." msgstr "" msgid "" "For example in a web application, the request being processed (or at least, " -"the interesting parts of it) can be stored in a threadlocal (:class:" -"`threading.local`) variable, and then accessed from a ``Filter`` to add, " -"say, information from the request - say, the remote IP address and remote " -"user's username - to the ``LogRecord``, using the attribute names 'ip' and " -"'user' as in the ``LoggerAdapter`` example above. In that case, the same " -"format string can be used to get similar output to that shown above. Here's " -"an example script::" +"the interesting parts of it) can be stored in a threadlocal " +"(:class:`threading.local`) variable, and then accessed from a ``Filter`` to " +"add, say, information from the request - say, the remote IP address and " +"remote user's username - to the ``LogRecord``, using the attribute names " +"'ip' and 'user' as in the ``LoggerAdapter`` example above. In that case, the " +"same format string can be used to get similar output to that shown above. " +"Here's an example script::" msgstr "" msgid "" @@ -1295,8 +1294,8 @@ msgid "" "\n" "# A dummy set of requests which will be used in the simulation - we'll just " "pick\n" -"# from this list randomly. Note that all GET requests are from 192.168.2." -"XXX\n" +"# from this list randomly. Note that all GET requests are from " +"192.168.2.XXX\n" "# addresses, whereas POST requests are from 192.16.3.XXX addresses. Three " "users\n" "# are represented in the sample requests.\n" @@ -1314,8 +1313,8 @@ msgid "" "information\n" "# such as HTTP method, client IP and username\n" "\n" -"formatter = logging.Formatter('%(threadName)-11s %(appName)s %(name)-9s " -"%(user)-6s %(ip)s %(method)-4s %(message)s')\n" +"formatter = logging.Formatter('%(threadName)-11s %(appName)s %(name)-9s %" +"(user)-6s %(ip)s %(method)-4s %(message)s')\n" "\n" "# Create our context variables. These will be filled at the start of " "request\n" @@ -1529,17 +1528,18 @@ msgid "" "this is to have all the processes log to a :class:`~handlers.SocketHandler`, " "and have a separate process which implements a socket server which reads " "from the socket and logs to file. (If you prefer, you can dedicate one " -"thread in one of the existing processes to perform this function.) :ref:" -"`This section ` documents this approach in more detail and " -"includes a working socket receiver which can be used as a starting point for " -"you to adapt in your own applications." +"thread in one of the existing processes to perform this " +"function.) :ref:`This section ` documents this approach in " +"more detail and includes a working socket receiver which can be used as a " +"starting point for you to adapt in your own applications." msgstr "" msgid "" -"You could also write your own handler which uses the :class:" -"`~multiprocessing.Lock` class from the :mod:`multiprocessing` module to " -"serialize access to the file from your processes. The stdlib :class:" -"`FileHandler` and subclasses do not make use of :mod:`multiprocessing`." +"You could also write your own handler which uses " +"the :class:`~multiprocessing.Lock` class from the :mod:`multiprocessing` " +"module to serialize access to the file from your processes. The " +"stdlib :class:`FileHandler` and subclasses do not make use " +"of :mod:`multiprocessing`." msgstr "" msgid "" @@ -1588,8 +1588,8 @@ msgid "" "def listener_configurer():\n" " root = logging.getLogger()\n" " h = logging.handlers.RotatingFileHandler('mptest.log', 'a', 300, 10)\n" -" f = logging.Formatter('%(asctime)s %(processName)-10s %(name)s " -"%(levelname)-8s %(message)s')\n" +" f = logging.Formatter('%(asctime)s %(processName)-10s %(name)s %" +"(levelname)-8s %(message)s')\n" " h.setFormatter(f)\n" " root.addHandler(h)\n" "\n" @@ -1719,8 +1719,8 @@ msgid "" " 'formatters': {\n" " 'detailed': {\n" " 'class': 'logging.Formatter',\n" -" 'format': '%(asctime)s %(name)-15s %(levelname)-8s " -"%(processName)-10s %(message)s'\n" +" 'format': '%(asctime)s %(name)-15s %(levelname)-8s %" +"(processName)-10s %(message)s'\n" " }\n" " },\n" " 'handlers': {\n" @@ -1775,6 +1775,100 @@ msgid "" " q.put(None)\n" " lp.join()" msgstr "" +"import logging\n" +"import logging.config\n" +"import logging.handlers\n" +"from multiprocessing import Process, Queue\n" +"import random\n" +"import threading\n" +"import time\n" +"\n" +"def logger_thread(q):\n" +" while True:\n" +" record = q.get()\n" +" if record is None:\n" +" break\n" +" logger = logging.getLogger(record.name)\n" +" logger.handle(record)\n" +"\n" +"\n" +"def worker_process(q):\n" +" qh = logging.handlers.QueueHandler(q)\n" +" root = logging.getLogger()\n" +" root.setLevel(logging.DEBUG)\n" +" root.addHandler(qh)\n" +" levels = [logging.DEBUG, logging.INFO, logging.WARNING, logging.ERROR,\n" +" logging.CRITICAL]\n" +" loggers = ['foo', 'foo.bar', 'foo.bar.baz',\n" +" 'spam', 'spam.ham', 'spam.ham.eggs']\n" +" for i in range(100):\n" +" lvl = random.choice(levels)\n" +" logger = logging.getLogger(random.choice(loggers))\n" +" logger.log(lvl, 'Message no. %d', i)\n" +"\n" +"if __name__ == '__main__':\n" +" q = Queue()\n" +" d = {\n" +" 'version': 1,\n" +" 'formatters': {\n" +" 'detailed': {\n" +" 'class': 'logging.Formatter',\n" +" 'format': '%(asctime)s %(name)-15s %(levelname)-8s %" +"(processName)-10s %(message)s'\n" +" }\n" +" },\n" +" 'handlers': {\n" +" 'console': {\n" +" 'class': 'logging.StreamHandler',\n" +" 'level': 'INFO',\n" +" },\n" +" 'file': {\n" +" 'class': 'logging.FileHandler',\n" +" 'filename': 'mplog.log',\n" +" 'mode': 'w',\n" +" 'formatter': 'detailed',\n" +" },\n" +" 'foofile': {\n" +" 'class': 'logging.FileHandler',\n" +" 'filename': 'mplog-foo.log',\n" +" 'mode': 'w',\n" +" 'formatter': 'detailed',\n" +" },\n" +" 'errors': {\n" +" 'class': 'logging.FileHandler',\n" +" 'filename': 'mplog-errors.log',\n" +" 'mode': 'w',\n" +" 'level': 'ERROR',\n" +" 'formatter': 'detailed',\n" +" },\n" +" },\n" +" 'loggers': {\n" +" 'foo': {\n" +" 'handlers': ['foofile']\n" +" }\n" +" },\n" +" 'root': {\n" +" 'level': 'DEBUG',\n" +" 'handlers': ['console', 'file', 'errors']\n" +" },\n" +" }\n" +" workers = []\n" +" for i in range(5):\n" +" wp = Process(target=worker_process, name='worker %d' % (i + 1), " +"args=(q,))\n" +" workers.append(wp)\n" +" wp.start()\n" +" logging.config.dictConfig(d)\n" +" lp = threading.Thread(target=logger_thread, args=(q,))\n" +" lp.start()\n" +" # W tym momencie główny proces mógłby wykonać jakąś pożyteczną pracę " +"samodzielnie\n" +" # Gdy już to zrobi, może poczekać, aż pracownicy zakończą pracę...\n" +" for wp in workers:\n" +" wp.join()\n" +" # A teraz powiedz wątkowi rejestrującemu, żeby zakończył działanie\n" +" q.put(None)\n" +" lp.join()" msgid "" "This variant shows how you can e.g. apply configuration for particular " @@ -1828,11 +1922,11 @@ msgid "" " executor.submit(worker_process, queue, worker_configurer)" msgstr "" -msgid "Deploying Web applications using Gunicorn and uWSGI" +msgid "Deploying web applications using Gunicorn and uWSGI" msgstr "" msgid "" -"When deploying Web applications using `Gunicorn `_ or " +"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 " @@ -1913,9 +2007,9 @@ msgstr "" msgid "" "When logging was added to the Python standard library, the only way of " "formatting messages with variable content was to use the %-formatting " -"method. Since then, Python has gained two new formatting approaches: :class:" -"`string.Template` (added in Python 2.4) and :meth:`str.format` (added in " -"Python 2.6)." +"method. Since then, Python has gained two new formatting " +"approaches: :class:`string.Template` (added in Python 2.4) " +"and :meth:`str.format` (added in Python 2.6)." msgstr "" msgid "" @@ -1925,9 +2019,9 @@ msgid "" "``'%'``, but other possible values are ``'{'`` and ``'$'``, which correspond " "to the other two formatting styles. Backwards compatibility is maintained by " "default (as you would expect), but by explicitly specifying a style " -"parameter, you get the ability to specify format strings which work with :" -"meth:`str.format` or :class:`string.Template`. Here's an example console " -"session to show the possibilities:" +"parameter, you get the ability to specify format strings which work " +"with :meth:`str.format` or :class:`string.Template`. Here's an example " +"console session to show the possibilities:" msgstr "" msgid "" @@ -1973,12 +2067,12 @@ msgid "" "logging call (e.g. the ``exc_info`` keyword parameter to indicate that " "traceback information should be logged, or the ``extra`` keyword parameter " "to indicate additional contextual information to be added to the log). So " -"you cannot directly make logging calls using :meth:`str.format` or :class:" -"`string.Template` syntax, because internally the logging package uses %-" -"formatting to merge the format string and the variable arguments. There " -"would be no changing this while preserving backward compatibility, since all " -"logging calls which are out there in existing code will be using %-format " -"strings." +"you cannot directly make logging calls using :meth:`str.format` " +"or :class:`string.Template` syntax, because internally the logging package " +"uses %-formatting to merge the format string and the variable arguments. " +"There would be no changing this while preserving backward compatibility, " +"since all logging calls which are out there in existing code will be using %-" +"format strings." msgstr "" msgid "" @@ -2102,10 +2196,10 @@ msgstr "" msgid "" "Every logging event is represented by a :class:`LogRecord` instance. When an " -"event is logged and not filtered out by a logger's level, a :class:" -"`LogRecord` is created, populated with information about the event and then " -"passed to the handlers for that logger (and its ancestors, up to and " -"including the logger where further propagation up the hierarchy is " +"event is logged and not filtered out by a logger's level, " +"a :class:`LogRecord` is created, populated with information about the event " +"and then passed to the handlers for that logger (and its ancestors, up to " +"and including the logger where further propagation up the hierarchy is " "disabled). Before Python 3.2, there were only two places where this creation " "was done:" msgstr "" @@ -2119,19 +2213,20 @@ msgid "" ":func:`makeLogRecord`, which is called with a dictionary containing " "attributes to be added to the LogRecord. This is typically invoked when a " "suitable dictionary has been received over the network (e.g. in pickle form " -"via a :class:`~handlers.SocketHandler`, or in JSON form via an :class:" -"`~handlers.HTTPHandler`)." +"via a :class:`~handlers.SocketHandler`, or in JSON form via " +"an :class:`~handlers.HTTPHandler`)." msgstr "" msgid "" -"This has usually meant that if you need to do anything special with a :class:" -"`LogRecord`, you've had to do one of the following." +"This has usually meant that if you need to do anything special with " +"a :class:`LogRecord`, you've had to do one of the following." msgstr "" msgid "" -"Create your own :class:`Logger` subclass, which overrides :meth:`Logger." -"makeRecord`, and set it using :func:`~logging.setLoggerClass` before any " -"loggers that you care about are instantiated." +"Create your own :class:`Logger` subclass, which " +"overrides :meth:`Logger.makeRecord`, and set it " +"using :func:`~logging.setLoggerClass` before any loggers that you care about " +"are instantiated." msgstr "" msgid "" @@ -2170,10 +2265,10 @@ msgstr "" msgid "" "In Python 3.2 and later, :class:`~logging.LogRecord` creation is done " "through a factory, which you can specify. The factory is just a callable you " -"can set with :func:`~logging.setLogRecordFactory`, and interrogate with :" -"func:`~logging.getLogRecordFactory`. The factory is invoked with the same " -"signature as the :class:`~logging.LogRecord` constructor, as :class:" -"`LogRecord` is the default setting for the factory." +"can set with :func:`~logging.setLogRecordFactory`, and interrogate " +"with :func:`~logging.getLogRecordFactory`. The factory is invoked with the " +"same signature as the :class:`~logging.LogRecord` constructor, " +"as :class:`LogRecord` is the default setting for the factory." msgstr "" msgid "" @@ -2279,10 +2374,10 @@ msgstr "" msgid "" "In a similar way to the above section, we can implement a listener and " -"handler using :pypi:`pynng`, which is a Python binding to `NNG `_, billed as a spiritual successor to ZeroMQ. The following " -"snippets illustrate -- you can test them in an environment which has " -"``pynng`` installed. Just for variety, we present the listener first." +"handler using :pypi:`pynng`, which is a Python binding to `NNG `_, billed as a spiritual successor to ZeroMQ. The " +"following snippets illustrate -- you can test them in an environment which " +"has ``pynng`` installed. Just for variety, we present the listener first." msgstr "" msgid "" @@ -2300,7 +2395,7 @@ msgid "" "class NNGSocketListener(logging.handlers.QueueListener):\n" "\n" " def __init__(self, uri, /, *handlers, **kwargs):\n" -" # Have a timeout for interruptability, and open a\n" +" # Have a timeout for interruptibility, and open a\n" " # subscriber socket\n" " socket = pynng.Sub0(listen=uri, recv_timeout=500)\n" " # The b'' subscription matches all topics\n" @@ -2378,8 +2473,8 @@ msgid "" "# Make sure the process ID is in the output\n" "logging.basicConfig(level=logging.DEBUG,\n" " handlers=[logging.StreamHandler(), handler],\n" -" format='%(levelname)-8s %(name)10s %(process)6s " -"%(message)s')\n" +" format='%(levelname)-8s %(name)10s %(process)6s %" +"(message)s')\n" "levels = (logging.DEBUG, logging.INFO, logging.WARNING, logging.ERROR,\n" " logging.CRITICAL)\n" "logger_names = ('myapp', 'myapp.lib1', 'myapp.lib2')\n" @@ -2465,8 +2560,8 @@ msgstr "" msgid "" "Below is an example of a logging configuration dictionary - it's taken from " "the `documentation on the Django project `_. This dictionary is passed to :" -"func:`~config.dictConfig` to put the configuration into effect::" +"stable/topics/logging/#configuring-logging>`_. This dictionary is passed " +"to :func:`~config.dictConfig` to put the configuration into effect::" msgstr "" msgid "" @@ -2751,13 +2846,13 @@ msgid "" " 'formatters': {\n" " 'detailed': {\n" " 'class': 'logging.Formatter',\n" -" 'format': '%(asctime)s %(name)-15s %(levelname)-8s " -"%(processName)-10s %(message)s'\n" +" 'format': '%(asctime)s %(name)-15s %(levelname)-8s %" +"(processName)-10s %(message)s'\n" " },\n" " 'simple': {\n" " 'class': 'logging.Formatter',\n" -" 'format': '%(name)-15s %(levelname)-8s %(processName)-10s " -"%(message)s'\n" +" 'format': '%(name)-15s %(levelname)-8s %(processName)-10s %" +"(message)s'\n" " }\n" " },\n" " 'handlers': {\n" @@ -2856,8 +2951,9 @@ msgid "" msgstr "" msgid "" -"Attach a :class:`~logging.Formatter` instance to your :class:`~logging." -"handlers.SysLogHandler` instance, with a format string such as::" +"Attach a :class:`~logging.Formatter` instance to " +"your :class:`~logging.handlers.SysLogHandler` instance, with a format string " +"such as::" msgstr "" msgid "'ASCII section\\ufeffUnicode section'" @@ -3000,8 +3096,9 @@ msgid "" msgstr "" msgid "" -"You can then specify, in a logging configuration passed to :func:" -"`dictConfig`, that a logging handler be created by calling this function::" +"You can then specify, in a logging configuration passed " +"to :func:`dictConfig`, that a logging handler be created by calling this " +"function::" msgstr "" msgid "" @@ -3099,11 +3196,11 @@ msgid "" msgstr "" msgid "" -"Note that this example uses Python 3.3 because that's where :func:`shutil." -"chown` makes an appearance. This approach should work with any Python " -"version that supports :func:`dictConfig` - namely, Python 2.7, 3.2 or later. " -"With pre-3.3 versions, you would need to implement the actual ownership " -"change using e.g. :func:`os.chown`." +"Note that this example uses Python 3.3 because that's " +"where :func:`shutil.chown` makes an appearance. This approach should work " +"with any Python version that supports :func:`dictConfig` - namely, Python " +"2.7, 3.2 or later. With pre-3.3 versions, you would need to implement the " +"actual ownership change using e.g. :func:`os.chown`." msgstr "" msgid "" @@ -3159,11 +3256,12 @@ msgid "" "call (e.g. the ``exc_info`` keyword parameter to indicate that traceback " "information should be logged, or the ``extra`` keyword parameter to indicate " "additional contextual information to be added to the log). So you cannot " -"directly make logging calls using :meth:`str.format` or :class:`string." -"Template` syntax, because internally the logging package uses %-formatting " -"to merge the format string and the variable arguments. There would be no " -"changing this while preserving backward compatibility, since all logging " -"calls which are out there in existing code will be using %-format strings." +"directly make logging calls using :meth:`str.format` " +"or :class:`string.Template` syntax, because internally the logging package " +"uses %-formatting to merge the format string and the variable arguments. " +"There would be no changing this while preserving backward compatibility, " +"since all logging calls which are out there in existing code will be using %-" +"format strings." msgstr "" msgid "" @@ -3198,8 +3296,8 @@ msgid "" msgstr "" msgid "" -"Refer to the reference documentation on :func:`setLogRecordFactory` and :" -"class:`LogRecord` for more information." +"Refer to the reference documentation on :func:`setLogRecordFactory` " +"and :class:`LogRecord` for more information." msgstr "" msgid "Using custom message objects" @@ -3207,11 +3305,11 @@ msgstr "" msgid "" "There is another, perhaps simpler way that you can use {}- and $- formatting " -"to construct your individual log messages. You may recall (from :ref:" -"`arbitrary-object-messages`) that when logging you can use an arbitrary " -"object as a message format string, and that the logging package will call :" -"func:`str` on that object to get the actual format string. Consider the " -"following two classes::" +"to construct your individual log messages. You may recall " +"(from :ref:`arbitrary-object-messages`) that when logging you can use an " +"arbitrary object as a message format string, and that the logging package " +"will call :func:`str` on that object to get the actual format string. " +"Consider the following two classes::" msgstr "" msgid "" @@ -3225,8 +3323,8 @@ msgid "" msgstr "" msgid "" -"Examples of this approach are given below. Firstly, formatting with :meth:" -"`str.format`::" +"Examples of this approach are given below. Firstly, formatting " +"with :meth:`str.format`::" msgstr "" msgid "" @@ -3272,13 +3370,13 @@ msgid "" "it might not be obvious at first glance how to do it (hence this recipe). " "Since :class:`~logging.Filter` is the only filter class included in the " "standard library, and it is unlikely to cater to many requirements (it's " -"only there as a base class), you will typically need to define your own :" -"class:`~logging.Filter` subclass with an overridden :meth:`~logging.Filter." -"filter` method. To do this, specify the ``()`` key in the configuration " -"dictionary for the filter, specifying a callable which will be used to " -"create the filter (a class is the most obvious, but you can provide any " -"callable which returns a :class:`~logging.Filter` instance). Here is a " -"complete example::" +"only there as a base class), you will typically need to define your " +"own :class:`~logging.Filter` subclass with an " +"overridden :meth:`~logging.Filter.filter` method. To do this, specify the " +"``()`` key in the configuration dictionary for the filter, specifying a " +"callable which will be used to create the filter (a class is the most " +"obvious, but you can provide any callable which returns " +"a :class:`~logging.Filter` instance). Here is a complete example::" msgstr "" msgid "" @@ -3430,14 +3528,14 @@ msgid "" "rendered in an audible rather than a visible format. This is easy to do if " "you have text-to-speech (TTS) functionality available in your system, even " "if it doesn't have a Python binding. Most TTS systems have a command line " -"program you can run, and this can be invoked from a handler using :mod:" -"`subprocess`. It's assumed here that TTS command line programs won't expect " -"to interact with users or take a long time to complete, and that the " -"frequency of logged messages will be not so high as to swamp the user with " -"messages, and that it's acceptable to have the messages spoken one at a time " -"rather than concurrently, The example implementation below waits for one " -"message to be spoken before the next is processed, and this might cause " -"other handlers to be kept waiting. Here is a short example showing the " +"program you can run, and this can be invoked from a handler " +"using :mod:`subprocess`. It's assumed here that TTS command line programs " +"won't expect to interact with users or take a long time to complete, and " +"that the frequency of logged messages will be not so high as to swamp the " +"user with messages, and that it's acceptable to have the messages spoken one " +"at a time rather than concurrently, The example implementation below waits " +"for one message to be spoken before the next is processed, and this might " +"cause other handlers to be kept waiting. Here is a short example showing the " "approach, which assumes that the ``espeak`` TTS package is available::" msgstr "" @@ -3521,9 +3619,9 @@ msgid "" "parameter and attaches a memory handler for the duration of the call to the " "decorated function. The decorator can be additionally parameterised using a " "target handler, a level at which flushing should occur, and a capacity for " -"the buffer (number of records buffered). These default to a :class:`~logging." -"StreamHandler` which writes to ``sys.stderr``, ``logging.ERROR`` and ``100`` " -"respectively." +"the buffer (number of records buffered). These default to " +"a :class:`~logging.StreamHandler` which writes to ``sys.stderr``, " +"``logging.ERROR`` and ``100`` respectively." msgstr "" msgid "Here's the script::" @@ -3645,12 +3743,13 @@ msgstr "" msgid "" "To illustrate how you can send log messages via email, so that a set number " -"of messages are sent per email, you can subclass :class:`~logging.handlers." -"BufferingHandler`. In the following example, which you can adapt to suit " -"your specific needs, a simple test harness is provided which allows you to " -"run the script with command line arguments specifying what you typically " -"need to send things via SMTP. (Run the downloaded script with the ``-h`` " -"argument to see the required and optional arguments.)" +"of messages are sent per email, you can " +"subclass :class:`~logging.handlers.BufferingHandler`. In the following " +"example, which you can adapt to suit your specific needs, a simple test " +"harness is provided which allows you to run the script with command line " +"arguments specifying what you typically need to send things via SMTP. (Run " +"the downloaded script with the ``-h`` argument to see the required and " +"optional arguments.)" msgstr "" msgid "" @@ -3672,8 +3771,8 @@ msgid "" " toaddrs = [toaddrs]\n" " self.toaddrs = toaddrs\n" " self.subject = subject\n" -" self.setFormatter(logging.Formatter(\"%(asctime)s %(levelname)-5s " -"%(message)s\"))\n" +" self.setFormatter(logging.Formatter(\"%(asctime)s %(levelname)-5s %" +"(message)s\"))\n" "\n" " def flush(self):\n" " if len(self.buffer) > 0:\n" @@ -3744,10 +3843,10 @@ msgid "" msgstr "" msgid "" -"and you can then use the ``UTCFormatter`` in your code instead of :class:" -"`~logging.Formatter`. If you want to do that via configuration, you can use " -"the :func:`~logging.config.dictConfig` API with an approach illustrated by " -"the following complete example::" +"and you can then use the ``UTCFormatter`` in your code instead " +"of :class:`~logging.Formatter`. If you want to do that via configuration, " +"you can use the :func:`~logging.config.dictConfig` API with an approach " +"illustrated by the following complete example::" msgstr "" msgid "" @@ -3952,8 +4051,8 @@ msgid "" "Suppose we have a command-line application whose job is to stop, start or " "restart some services. This could be organised for the purposes of " "illustration as a file ``app.py`` that is the main script for the " -"application, with individual commands implemented in ``start.py``, ``stop." -"py`` and ``restart.py``. Suppose further that we want to control the " +"application, with individual commands implemented in ``start.py``, " +"``stop.py`` and ``restart.py``. Suppose further that we want to control the " "verbosity of the application via a command-line argument, defaulting to " "``logging.INFO``. Here's one way that ``app.py`` could be written::" msgstr "" @@ -3992,8 +4091,8 @@ msgid "" " mod = importlib.import_module(options.command)\n" " cmd = getattr(mod, 'command')\n" " except (ImportError, AttributeError):\n" -" print('Unable to find the code for command \\'%s\\'' % options." -"command)\n" +" print('Unable to find the code for command \\'%s\\'' % " +"options.command)\n" " return 1\n" " # Could get fancy here and load configuration from file or dictionary\n" " logging.basicConfig(level=options.log_level,\n" @@ -4129,8 +4228,8 @@ msgstr "" msgid "" "A question that comes up from time to time is about how to log to a GUI " "application. The `Qt `_ framework is a popular cross-" -"platform UI framework with Python bindings using :pypi:`PySide2` or :pypi:" -"`PyQt5` libraries." +"platform UI framework with Python bindings using :pypi:`PySide2` " +"or :pypi:`PyQt5` libraries." msgstr "" msgid "" @@ -4156,7 +4255,6 @@ msgid "" msgstr "" msgid "" -"import datetime\n" "import logging\n" "import random\n" "import sys\n" @@ -4337,8 +4435,8 @@ msgid "" " self.start_thread()\n" " self.work_button.clicked.connect(self.worker.start)\n" " # Once started, the button should be disabled\n" -" self.work_button.clicked.connect(lambda : self.work_button." -"setEnabled(False))\n" +" self.work_button.clicked.connect(lambda : " +"self.work_button.setEnabled(False))\n" "\n" " def start_thread(self):\n" " self.worker = Worker()\n" @@ -4412,9 +4510,10 @@ msgid "" "Although :rfc:`5424` dates from 2009, most syslog servers are configured by " "default to use the older :rfc:`3164`, which hails from 2001. When " "``logging`` was added to Python in 2003, it supported the earlier (and only " -"existing) protocol at the time. Since 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." +"existing) protocol at the time. Since RFC 5424 came out, as there has not " +"been widespread deployment of it in syslog servers, " +"the :class:`~logging.handlers.SysLogHandler` functionality has not been " +"updated." msgstr "" msgid "" @@ -4424,7 +4523,7 @@ msgid "" msgstr "" msgid "" -"import datetime\n" +"import datetime as dt\n" "import logging.handlers\n" "import re\n" "import socket\n" @@ -4442,8 +4541,7 @@ msgid "" "\n" " def format(self, record):\n" " version = 1\n" -" asctime = datetime.datetime.fromtimestamp(record.created)." -"isoformat()\n" +" asctime = dt.datetime.fromtimestamp(record.created).isoformat()\n" " m = self.tz_offset.match(time.strftime('%z'))\n" " has_offset = False\n" " if m and time.timezone:\n" @@ -4496,7 +4594,7 @@ msgid "" "You'll need to be familiar with RFC 5424 to fully understand the above code, " "and it may be that you have slightly different needs (e.g. for how you pass " "structural data to the log). Nevertheless, the above should be adaptable to " -"your speciric needs. With the above handler, you'd pass structured data " +"your specific needs. With the above handler, you'd pass structured data " "using something like this::" msgstr "" @@ -4566,8 +4664,8 @@ msgid "" msgstr "" msgid "" -"You could also use ``LoggerWriter`` to redirect ``sys.stdout`` and ``sys." -"stderr`` by doing something like this:" +"You could also use ``LoggerWriter`` to redirect ``sys.stdout`` and " +"``sys.stderr`` by doing something like this:" msgstr "" msgid "" @@ -4579,9 +4677,9 @@ msgstr "" msgid "" "You should do this *after* configuring logging for your needs. In the above " -"example, the :func:`~logging.basicConfig` call does this (using the ``sys." -"stderr`` value *before* it is overwritten by a ``LoggerWriter`` instance). " -"Then, you'd get this kind of result:" +"example, the :func:`~logging.basicConfig` call does this (using the " +"``sys.stderr`` value *before* it is overwritten by a ``LoggerWriter`` " +"instance). Then, you'd get this kind of result:" msgstr "" msgid "" @@ -4598,9 +4696,9 @@ msgstr "" ">>>" msgid "" -"Of course, the examples above show output according to the format used by :" -"func:`~logging.basicConfig`, but you can use a different formatter when you " -"configure logging." +"Of course, the examples above show output according to the format used " +"by :func:`~logging.basicConfig`, but you can use a different formatter when " +"you configure logging." msgstr "" msgid "" @@ -4679,6 +4777,120 @@ msgid "" "WARNING:demo:ZeroDivisionError: division by zero" msgstr "" +msgid "How to uniformly handle newlines in logging output" +msgstr "" + +msgid "" +"Usually, messages that are logged (say to console or file) consist of a " +"single line of text. However, sometimes there is a need to handle messages " +"with multiple lines - whether because a logging format string contains " +"newlines, or logged data contains newlines. If you want to handle such " +"messages uniformly, so that each line in the logged message appears " +"uniformly formatted as if it was logged separately, you can do this using a " +"handler mixin, as in the following snippet:" +msgstr "" + +msgid "" +"# Assume this is in a module mymixins.py\n" +"import copy\n" +"\n" +"class MultilineMixin:\n" +" def emit(self, record):\n" +" s = record.getMessage()\n" +" if '\\n' not in s:\n" +" super().emit(record)\n" +" else:\n" +" lines = s.splitlines()\n" +" rec = copy.copy(record)\n" +" rec.args = None\n" +" for line in lines:\n" +" rec.msg = line\n" +" super().emit(rec)" +msgstr "" + +msgid "You can use the mixin as in the following script:" +msgstr "" + +msgid "" +"import logging\n" +"\n" +"from mymixins import MultilineMixin\n" +"\n" +"logger = logging.getLogger(__name__)\n" +"\n" +"class StreamHandler(MultilineMixin, logging.StreamHandler):\n" +" pass\n" +"\n" +"if __name__ == '__main__':\n" +" logging.basicConfig(level=logging.DEBUG, format='%(asctime)s %" +"(levelname)-9s %(message)s',\n" +" handlers = [StreamHandler()])\n" +" logger.debug('Single line')\n" +" logger.debug('Multiple lines:\\nfool me once ...')\n" +" logger.debug('Another single line')\n" +" logger.debug('Multiple lines:\\n%s', 'fool me ...\\ncan\\'t get fooled " +"again')" +msgstr "" + +msgid "The script, when run, prints something like:" +msgstr "" + +msgid "" +"2025-07-02 13:54:47,234 DEBUG Single line\n" +"2025-07-02 13:54:47,234 DEBUG Multiple lines:\n" +"2025-07-02 13:54:47,234 DEBUG fool me once ...\n" +"2025-07-02 13:54:47,234 DEBUG Another single line\n" +"2025-07-02 13:54:47,234 DEBUG Multiple lines:\n" +"2025-07-02 13:54:47,234 DEBUG fool me ...\n" +"2025-07-02 13:54:47,234 DEBUG can't get fooled again" +msgstr "" + +msgid "" +"If, on the other hand, you are concerned about `log injection `_, you can use a formatter " +"which escapes newlines, as per the following example:" +msgstr "" + +msgid "" +"import logging\n" +"\n" +"logger = logging.getLogger(__name__)\n" +"\n" +"class EscapingFormatter(logging.Formatter):\n" +" def format(self, record):\n" +" s = super().format(record)\n" +" return s.replace('\\n', r'\\n')\n" +"\n" +"if __name__ == '__main__':\n" +" h = logging.StreamHandler()\n" +" h.setFormatter(EscapingFormatter('%(asctime)s %(levelname)-9s %" +"(message)s'))\n" +" logging.basicConfig(level=logging.DEBUG, handlers = [h])\n" +" logger.debug('Single line')\n" +" logger.debug('Multiple lines:\\nfool me once ...')\n" +" logger.debug('Another single line')\n" +" logger.debug('Multiple lines:\\n%s', 'fool me ...\\ncan\\'t get fooled " +"again')" +msgstr "" + +msgid "" +"You can, of course, use whatever escaping scheme makes the most sense for " +"you. The script, when run, should produce output like this:" +msgstr "" + +msgid "" +"2025-07-09 06:47:33,783 DEBUG Single line\n" +"2025-07-09 06:47:33,783 DEBUG Multiple lines:\\nfool me once ...\n" +"2025-07-09 06:47:33,783 DEBUG Another single line\n" +"2025-07-09 06:47:33,783 DEBUG Multiple lines:\\nfool me ...\\ncan't get " +"fooled again" +msgstr "" + +msgid "" +"Escaping behaviour can't be the stdlib default , as it would break backwards " +"compatibility." +msgstr "" + msgid "Patterns to avoid" msgstr "" diff --git a/howto/logging.po b/howto/logging.po index 15466b69b1..cfa6993ea0 100644 --- a/howto/logging.po +++ b/howto/logging.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -57,10 +55,10 @@ msgstr "" msgid "" "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 " +"logging.getLogger(__name__)``, and then calling the " +"logger's :meth:`~Logger.debug`, :meth:`~Logger.info`, :meth:`~Logger.warning`, :meth:`~Logger.error` " +"and :meth:`~Logger.critical` methods. To determine when to use logging, and " +"to see which logger methods to use when, see the table below. It states, for " "each of a set of common tasks, the best tool to use for that task." msgstr "" @@ -112,8 +110,8 @@ msgid "" msgstr "" msgid "" -"A logger's :meth:`~Logger.error`, :meth:`~Logger.exception` or :meth:" -"`~Logger.critical` method as appropriate for the specific error and " +"A logger's :meth:`~Logger.error`, :meth:`~Logger.exception` " +"or :meth:`~Logger.critical` method as appropriate for the specific error and " "application domain" msgstr "" @@ -200,8 +198,8 @@ msgstr "" msgid "" "printed out on the console. The ``INFO`` message doesn't appear because the " "default level is ``WARNING``. The printed message includes the indication of " -"the level and the description of the event provided in the logging call, i." -"e. 'Watch out!'. The actual output can be formatted quite flexibly if you " +"the level and the description of the event provided in the logging call, " +"i.e. 'Watch out!'. The actual output can be formatted quite flexibly if you " "need that; formatting options will also be explained later." msgstr "" @@ -229,8 +227,8 @@ msgstr "" msgid "" "import logging\n" "logger = logging.getLogger(__name__)\n" -"logging.basicConfig(filename='example.log', encoding='utf-8', level=logging." -"DEBUG)\n" +"logging.basicConfig(filename='example.log', encoding='utf-8', " +"level=logging.DEBUG)\n" "logger.debug('This message should go to the log file')\n" "logger.info('So should this')\n" "logger.warning('And this, too')\n" @@ -308,8 +306,8 @@ msgid "" msgstr "" msgid "" -"logging.basicConfig(filename='example.log', filemode='w', level=logging." -"DEBUG)" +"logging.basicConfig(filename='example.log', filemode='w', " +"level=logging.DEBUG)" msgstr "" msgid "" @@ -355,8 +353,8 @@ msgstr "" msgid "" "import logging\n" -"logging.basicConfig(format='%(levelname)s:%(message)s', level=logging." -"DEBUG)\n" +"logging.basicConfig(format='%(levelname)s:%(message)s', " +"level=logging.DEBUG)\n" "logging.debug('This message should appear on the console')\n" "logging.info('So should this')\n" "logging.warning('And this, too')" @@ -401,9 +399,9 @@ msgid "2010-12-12 11:41:42,612 is when this event was logged." msgstr "" msgid "" -"The default format for date/time display (shown above) is like ISO8601 or :" -"rfc:`3339`. If you need more control over the formatting of the date/time, " -"provide a *datefmt* argument to ``basicConfig``, as in this example::" +"The default format for date/time display (shown above) is like ISO8601 " +"or :rfc:`3339`. If you need more control over the formatting of the date/" +"time, provide a *datefmt* argument to ``basicConfig``, as in this example::" msgstr "" msgid "" @@ -420,8 +418,8 @@ msgid "12/12/2010 11:46:36 AM is when this event was logged." msgstr "" msgid "" -"The format of the *datefmt* argument is the same as supported by :func:`time." -"strftime`." +"The format of the *datefmt* argument is the same as supported " +"by :func:`time.strftime`." msgstr "" msgid "Next Steps" @@ -438,8 +436,8 @@ msgstr "" msgid "" "If your logging needs are simple, then use the above examples to incorporate " "logging into your own scripts, and if you run into problems or don't " -"understand something, please post a question on the comp.lang.python Usenet " -"group (available at https://groups.google.com/g/comp.lang.python) and you " +"understand something, please post a question in the Help category of the " +"`Python discussion forum `_ and you " "should receive help before too long." msgstr "" @@ -503,10 +501,11 @@ msgstr "" msgid "" "The root of the hierarchy of loggers is called the root logger. That's the " -"logger used by the functions :func:`debug`, :func:`info`, :func:`warning`, :" -"func:`error` and :func:`critical`, which just call the same-named method of " -"the root logger. The functions and the methods have the same signatures. The " -"root logger's name is printed as 'root' in the logged output." +"logger used by the " +"functions :func:`debug`, :func:`info`, :func:`warning`, :func:`error` " +"and :func:`critical`, which just call the same-named method of the root " +"logger. The functions and the methods have the same signatures. The root " +"logger's name is printed as 'root' in the logged output." msgstr "" msgid "" @@ -522,12 +521,12 @@ msgstr "" msgid "" "By default, no destination is set for any logging messages. You can specify " "a destination (such as console or file) by using :func:`basicConfig` as in " -"the tutorial examples. If you call the functions :func:`debug`, :func:" -"`info`, :func:`warning`, :func:`error` and :func:`critical`, they will check " -"to see if no destination is set; and if one is not set, they will set a " -"destination of the console (``sys.stderr``) and a default format for the " -"displayed message before delegating to the root logger to do the actual " -"message output." +"the tutorial examples. If you call the " +"functions :func:`debug`, :func:`info`, :func:`warning`, :func:`error` " +"and :func:`critical`, they will check to see if no destination is set; and " +"if one is not set, they will set a destination of the console " +"(``sys.stderr``) and a default format for the displayed message before " +"delegating to the root logger to do the actual message output." msgstr "" msgid "The default format set by :func:`basicConfig` for messages is:" @@ -600,21 +599,22 @@ msgid "" msgstr "" msgid "" -":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:" -"`Logger.error`, and :meth:`Logger.critical` all create log records with a " -"message and a level that corresponds to their respective method names. The " -"message is actually a format string, which may contain the standard string " -"substitution syntax of ``%s``, ``%d``, ``%f``, and so on. The rest of their " -"arguments is a list of objects that correspond with the substitution fields " -"in the message. With regard to ``**kwargs``, the logging methods care only " -"about a keyword of ``exc_info`` and use it to determine whether to log " -"exception information." +":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:`Logger.error`, " +"and :meth:`Logger.critical` all create log records with a message and a " +"level that corresponds to their respective method names. The message is " +"actually a format string, which may contain the standard string substitution " +"syntax of ``%s``, ``%d``, ``%f``, and so on. The rest of their arguments is " +"a list of objects that correspond with the substitution fields in the " +"message. With regard to ``**kwargs``, the logging methods care only about a " +"keyword of ``exc_info`` and use it to determine whether to log exception " +"information." msgstr "" msgid "" -":meth:`Logger.exception` creates a log message similar to :meth:`Logger." -"error`. The difference is that :meth:`Logger.exception` dumps a stack trace " -"along with it. Call this method only from an exception handler." +":meth:`Logger.exception` creates a log message similar " +"to :meth:`Logger.error`. The difference is that :meth:`Logger.exception` " +"dumps a stack trace along with it. Call this method only from an exception " +"handler." msgstr "" msgid "" @@ -672,8 +672,8 @@ msgstr "" msgid "" "The standard library includes quite a few handler types (see :ref:`useful-" -"handlers`); the tutorials use mainly :class:`StreamHandler` and :class:" -"`FileHandler` in its examples." +"handlers`); the tutorials use mainly :class:`StreamHandler` " +"and :class:`FileHandler` in its examples." msgstr "" msgid "" @@ -703,10 +703,10 @@ msgid "" msgstr "" msgid "" -"Application code should not directly instantiate and use instances of :class:" -"`Handler`. Instead, the :class:`Handler` class is a base class that defines " -"the interface that all handlers should have and establishes some default " -"behavior that child classes can use (or override)." +"Application code should not directly instantiate and use instances " +"of :class:`Handler`. Instead, the :class:`Handler` class is a base class " +"that defines the interface that all handlers should have and establishes " +"some default behavior that child classes can use (or override)." msgstr "" msgid "Formatters" @@ -737,8 +737,8 @@ msgstr "" msgid "" "If the ``style`` is ``'%'``, the message format string uses ``%()s`` styled string substitution; the possible keys are documented in :" -"ref:`logrecord-attributes`. If the style is ``'{'``, the message format " +"key>)s`` styled string substitution; the possible keys are documented " +"in :ref:`logrecord-attributes`. If the style is ``'{'``, the message format " "string is assumed to be compatible with :meth:`str.format` (using keyword " "arguments), while if the style is ``'$'`` then the message format string " "should conform to what is expected by :meth:`string.Template.substitute`." @@ -783,8 +783,8 @@ msgid "" msgstr "" msgid "" -"Creating a dictionary of configuration information and passing it to the :" -"func:`dictConfig` function." +"Creating a dictionary of configuration information and passing it to " +"the :func:`dictConfig` function." msgstr "" msgid "" @@ -805,8 +805,8 @@ msgid "" "ch.setLevel(logging.DEBUG)\n" "\n" "# create formatter\n" -"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - " -"%(message)s')\n" +"formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %" +"(message)s')\n" "\n" "# add formatter to ch\n" "ch.setFormatter(formatter)\n" @@ -931,11 +931,11 @@ msgstr "" msgid "" "Note that the class names referenced in config files need to be either " "relative to the logging module, or absolute values which can be resolved " -"using normal import mechanisms. Thus, you could use either :class:`~logging." -"handlers.WatchedFileHandler` (relative to the logging module) or ``mypackage." -"mymodule.MyHandler`` (for a class defined in package ``mypackage`` and " -"module ``mymodule``, where ``mypackage`` is available on the Python import " -"path)." +"using normal import mechanisms. Thus, you could use " +"either :class:`~logging.handlers.WatchedFileHandler` (relative to the " +"logging module) or ``mypackage.mymodule.MyHandler`` (for a class defined in " +"package ``mypackage`` and module ``mymodule``, where ``mypackage`` is " +"available on the Python import path)." msgstr "" msgid "" @@ -993,10 +993,10 @@ msgid "" msgstr "" msgid "" -"The event is output using a 'handler of last resort', stored in :data:" -"`lastResort`. This internal handler is not associated with any logger, and " -"acts like a :class:`~logging.StreamHandler` which writes the event " -"description message to the current value of ``sys.stderr`` (therefore " +"The event is output using a 'handler of last resort', stored " +"in :data:`lastResort`. This internal handler is not associated with any " +"logger, and acts like a :class:`~logging.StreamHandler` which writes the " +"event description message to the current value of ``sys.stderr`` (therefore " "respecting any redirections which may be in effect). No formatting is done " "on the message - just the bare event description message is printed. The " "handler's level is set to ``WARNING``, so all events at this and greater " @@ -1045,13 +1045,13 @@ msgid "" msgstr "" msgid "" -"A do-nothing handler is included in the logging package: :class:`~logging." -"NullHandler` (since Python 3.1). An instance of this handler could be added " -"to the top-level logger of the logging namespace used by the library (*if* " -"you want to prevent your library's logged events being output to ``sys." -"stderr`` in the absence of logging configuration). If all logging by a " -"library *foo* is done using loggers with names matching 'foo.x', 'foo.x.y', " -"etc. then the code::" +"A do-nothing handler is included in the logging " +"package: :class:`~logging.NullHandler` (since Python 3.1). An instance of " +"this handler could be added to the top-level logger of the logging namespace " +"used by the library (*if* you want to prevent your library's logged events " +"being output to ``sys.stderr`` in the absence of logging configuration). If " +"all logging by a library *foo* is done using loggers with names matching " +"'foo.x', 'foo.x.y', etc. then the code::" msgstr "" msgid "" @@ -1075,13 +1075,14 @@ msgid "" msgstr "" msgid "" -"It is strongly advised that you *do not add any handlers other than* :class:" -"`~logging.NullHandler` *to your library's loggers*. This is because the " -"configuration of handlers is the prerogative of the application developer " -"who uses your library. The application developer knows their target audience " -"and what handlers are most appropriate for their application: if you add " -"handlers 'under the hood', you might well interfere with their ability to " -"carry out unit tests and deliver logs which suit their requirements." +"It is strongly advised that you *do not add any handlers other " +"than* :class:`~logging.NullHandler` *to your library's loggers*. This is " +"because the configuration of handlers is the prerogative of the application " +"developer who uses your library. The application developer knows their " +"target audience and what handlers are most appropriate for their " +"application: if you add handlers 'under the hood', you might well interfere " +"with their ability to carry out unit tests and deliver logs which suit their " +"requirements." msgstr "" msgid "Logging Levels" @@ -1130,33 +1131,33 @@ msgstr "" msgid "" "Logging messages are encoded as instances of the :class:`~logging.LogRecord` " -"class. When a logger decides to actually log an event, a :class:`~logging." -"LogRecord` instance is created from the logging message." +"class. When a logger decides to actually log an event, " +"a :class:`~logging.LogRecord` instance is created from the logging message." msgstr "" msgid "" -"Logging messages are subjected to a dispatch mechanism through the use of :" -"dfn:`handlers`, which are instances of subclasses of the :class:`Handler` " -"class. Handlers are responsible for ensuring that a logged message (in the " -"form of a :class:`LogRecord`) ends up in a particular location (or set of " -"locations) which is useful for the target audience for that message (such as " -"end users, support desk staff, system administrators, developers). Handlers " -"are passed :class:`LogRecord` instances intended for particular " -"destinations. Each logger can have zero, one or more handlers associated " -"with it (via the :meth:`~Logger.addHandler` method of :class:`Logger`). In " -"addition to any handlers directly associated with a logger, *all handlers " -"associated with all ancestors of the logger* are called to dispatch the " -"message (unless the *propagate* flag for a logger is set to a false value, " -"at which point the passing to ancestor handlers stops)." +"Logging messages are subjected to a dispatch mechanism through the use " +"of :dfn:`handlers`, which are instances of subclasses of " +"the :class:`Handler` class. Handlers are responsible for ensuring that a " +"logged message (in the form of a :class:`LogRecord`) ends up in a particular " +"location (or set of locations) which is useful for the target audience for " +"that message (such as end users, support desk staff, system administrators, " +"developers). Handlers are passed :class:`LogRecord` instances intended for " +"particular destinations. Each logger can have zero, one or more handlers " +"associated with it (via the :meth:`~Logger.addHandler` method " +"of :class:`Logger`). In addition to any handlers directly associated with a " +"logger, *all handlers associated with all ancestors of the logger* are " +"called to dispatch the message (unless the *propagate* flag for a logger is " +"set to a false value, at which point the passing to ancestor handlers stops)." msgstr "" msgid "" "Just as for loggers, handlers can have levels associated with them. A " "handler's level acts as a filter in the same way as a logger's level does. " -"If a handler decides to actually dispatch an event, the :meth:`~Handler." -"emit` method is used to send the message to its destination. Most user-" -"defined subclasses of :class:`Handler` will need to override this :meth:" -"`~Handler.emit`." +"If a handler decides to actually dispatch an event, " +"the :meth:`~Handler.emit` method is used to send the message to its " +"destination. Most user-defined subclasses of :class:`Handler` will need to " +"override this :meth:`~Handler.emit`." msgstr "" msgid "Custom Levels" @@ -1193,8 +1194,8 @@ msgstr "" msgid "" ":class:`~handlers.BaseRotatingHandler` is the base class for handlers that " "rotate log files at a certain point. It is not meant to be instantiated " -"directly. Instead, use :class:`~handlers.RotatingFileHandler` or :class:" -"`~handlers.TimedRotatingFileHandler`." +"directly. Instead, use :class:`~handlers.RotatingFileHandler` " +"or :class:`~handlers.TimedRotatingFileHandler`." msgstr "" msgid "" @@ -1228,8 +1229,8 @@ msgid "" msgstr "" msgid "" -":class:`~handlers.NTEventLogHandler` instances send messages to a Windows " -"NT/2000/XP event log." +":class:`~handlers.NTEventLogHandler` instances send messages to a Windows NT/" +"2000/XP event log." msgstr "" msgid "" @@ -1276,25 +1277,25 @@ msgid "" msgstr "" msgid "" -"Logged messages are formatted for presentation through instances of the :" -"class:`Formatter` class. They are initialized with a format string suitable " -"for use with the % operator and a dictionary." +"Logged messages are formatted for presentation through instances of " +"the :class:`Formatter` class. They are initialized with a format string " +"suitable for use with the % operator and a dictionary." msgstr "" msgid "" -"For formatting multiple messages in a batch, instances of :class:" -"`BufferingFormatter` can be used. In addition to the format string (which is " -"applied to each message in the batch), there is provision for header and " -"trailer format strings." +"For formatting multiple messages in a batch, instances " +"of :class:`BufferingFormatter` can be used. In addition to the format string " +"(which is applied to each message in the batch), there is provision for " +"header and trailer format strings." msgstr "" msgid "" "When filtering based on logger level and/or handler level is not enough, " -"instances of :class:`Filter` can be added to both :class:`Logger` and :class:" -"`Handler` instances (through their :meth:`~Handler.addFilter` method). " -"Before deciding to process a message further, both loggers and handlers " -"consult all their filters for permission. If any filter returns a false " -"value, the message is not processed further." +"instances of :class:`Filter` can be added to both :class:`Logger` " +"and :class:`Handler` instances (through their :meth:`~Handler.addFilter` " +"method). Before deciding to process a message further, both loggers and " +"handlers consult all their filters for permission. If any filter returns a " +"false value, the message is not processed further." msgstr "" msgid "" @@ -1316,15 +1317,15 @@ msgstr "" msgid "" ":class:`SystemExit` and :class:`KeyboardInterrupt` exceptions are never " "swallowed. Other exceptions which occur during the :meth:`~Handler.emit` " -"method of a :class:`Handler` subclass are passed to its :meth:`~Handler." -"handleError` method." +"method of a :class:`Handler` subclass are passed to " +"its :meth:`~Handler.handleError` method." msgstr "" msgid "" -"The default implementation of :meth:`~Handler.handleError` in :class:" -"`Handler` checks to see if a module-level variable, :data:`raiseExceptions`, " -"is set. If set, a traceback is printed to :data:`sys.stderr`. If not set, " -"the exception is swallowed." +"The default implementation of :meth:`~Handler.handleError` " +"in :class:`Handler` checks to see if a module-level " +"variable, :data:`raiseExceptions`, is set. If set, a traceback is printed " +"to :data:`sys.stderr`. If not set, the exception is swallowed." msgstr "" msgid "" @@ -1340,12 +1341,12 @@ msgstr "" msgid "" "In the preceding sections and examples, it has been assumed that the message " "passed when logging the event is a string. However, this is not the only " -"possibility. You can pass an arbitrary object as a message, and its :meth:" -"`~object.__str__` method will be called when the logging system needs to " -"convert it to a string representation. In fact, if you want to, you can " -"avoid computing a string representation altogether - for example, the :class:" -"`~handlers.SocketHandler` emits an event by pickling it and sending it over " -"the wire." +"possibility. You can pass an arbitrary object as a message, and " +"its :meth:`~object.__str__` method will be called when the logging system " +"needs to convert it to a string representation. In fact, if you want to, you " +"can avoid computing a string representation altogether - for example, " +"the :class:`~handlers.SocketHandler` emits an event by pickling it and " +"sending it over the wire." msgstr "" msgid "Optimization" @@ -1355,10 +1356,10 @@ msgid "" "Formatting of message arguments is deferred until it cannot be avoided. " "However, computing the arguments passed to the logging method can also be " "expensive, and you may want to avoid doing it if the logger will just throw " -"away your event. To decide what to do, you can call the :meth:`~Logger." -"isEnabledFor` method which takes a level argument and returns true if the " -"event would be created by the Logger for that level of call. You can write " -"code like this::" +"away your event. To decide what to do, you can call " +"the :meth:`~Logger.isEnabledFor` method which takes a level argument and " +"returns true if the event would be created by the Logger for that level of " +"call. You can write code like this::" msgstr "" msgid "" @@ -1400,9 +1401,10 @@ msgid "Information about where calls were made from." msgstr "" msgid "" -"Set ``logging._srcfile`` to ``None``. This avoids calling :func:`sys." -"_getframe`, which may help to speed up your code in environments like PyPy " -"(which can't speed up code that uses :func:`sys._getframe`)." +"Set ``logging._srcfile`` to ``None``. This avoids " +"calling :func:`sys._getframe`, which may help to speed up your code in " +"environments like PyPy (which can't speed up code that " +"uses :func:`sys._getframe`)." msgstr "" msgid "Threading information." diff --git a/howto/mro.po b/howto/mro.po index 45e22a4fa6..b39a55826d 100644 --- a/howto/mro.po +++ b/howto/mro.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2024-04-19 14:15+0000\n" -"Last-Translator: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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 +32,7 @@ msgid "" "in Python 2.3, but it is still used in later versions -- including Python 3." msgstr "" -msgid "By `Michele Simionato `__." +msgid "By `Michele Simionato `__." msgstr "" msgid "Abstract" @@ -262,9 +262,9 @@ msgid "" "tail of any of the other lists, then add it to the linearization of C and " "remove it from the lists in the merge, otherwise look at the head of the " "next list and take it, if it is a good head. Then repeat the operation " -"until all the class are removed or it is impossible to find good heads. In " -"this case, it is impossible to construct the merge, Python 2.3 will refuse " -"to create the class C and will raise an exception.*" +"until all the classes are removed or it is impossible to find good heads. " +"In this case, it is impossible to construct the merge, Python 2.3 will " +"refuse to create the class C and will raise an exception.*" msgstr "" msgid "" @@ -383,9 +383,9 @@ msgid "" msgstr "" msgid "" -"The only difference with the previous example is the change B(D,E) --> B(E," -"D); however even such a little modification completely changes the ordering " -"of the hierarchy:" +"The only difference with the previous example is the change B(D,E) --> " +"B(E,D); however even such a little modification completely changes the " +"ordering of the hierarchy:" msgstr "" msgid "" @@ -488,8 +488,8 @@ msgstr "" msgid "" "We see that class G inherits from F and E, with F *before* E: therefore we " -"would expect the attribute *G.remember2buy* to be inherited by *F." -"remember2buy* and not by *E.remember2buy*: nevertheless Python 2.2 gives" +"would expect the attribute *G.remember2buy* to be inherited by " +"*F.remember2buy* and not by *E.remember2buy*: nevertheless Python 2.2 gives" msgstr "" msgid "" @@ -780,8 +780,8 @@ msgid "" msgstr "" msgid "" -"The paper *A Monotonic Superclass Linearization for Dylan*: https://doi." -"org/10.1145/236337.236343" +"The paper *A Monotonic Superclass Linearization for Dylan*: https://doi.org/" +"10.1145/236337.236343" msgstr "" msgid "" diff --git a/howto/perf_profiling.po b/howto/perf_profiling.po index 563f3c397b..f5a6b9adbd 100644 --- a/howto/perf_profiling.po +++ b/howto/perf_profiling.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2023-05-24 13:07+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -228,8 +227,8 @@ msgstr "" msgid "" "``perf`` profiling support can be enabled either from the start using the " "environment variable :envvar:`PYTHONPERFSUPPORT` or the :option:`-X perf <-" -"X>` option, or dynamically using :func:`sys.activate_stack_trampoline` and :" -"func:`sys.deactivate_stack_trampoline`." +"X>` option, or dynamically using :func:`sys.activate_stack_trampoline` " +"and :func:`sys.deactivate_stack_trampoline`." msgstr "" msgid "" @@ -241,8 +240,8 @@ msgid "Example, using the environment variable::" msgstr "" msgid "" -"$ PYTHONPERFSUPPORT=1 perf record -F 9999 -g -o perf.data python my_script." -"py\n" +"$ PYTHONPERFSUPPORT=1 perf record -F 9999 -g -o perf.data python " +"my_script.py\n" "$ perf report -g -i perf.data" msgstr "" @@ -313,9 +312,9 @@ msgid "" msgstr "" msgid "" -"To enable this mode, you can use the environment variable :envvar:" -"`PYTHON_PERF_JIT_SUPPORT` or the :option:`-X perf_jit <-X>` option, which " -"will enable the JIT mode for the ``perf`` profiler." +"To enable this mode, you can use the environment " +"variable :envvar:`PYTHON_PERF_JIT_SUPPORT` or the :option:`-X perf_jit <-X>` " +"option, which will enable the JIT mode for the ``perf`` profiler." msgstr "" msgid "" @@ -338,8 +337,8 @@ msgid "" msgstr "" msgid "" -"$ perf record -F 9999 -g -k 1 --call-graph dwarf -o perf.data python -" -"Xperf_jit my_script.py\n" +"$ perf record -F 9999 -g -k 1 --call-graph dwarf -o perf.data python " +"-Xperf_jit my_script.py\n" "$ perf inject -i perf.data --jit --output perf.jit.data\n" "$ perf report -g -i perf.jit.data" msgstr "" @@ -388,8 +387,8 @@ msgid "" msgstr "" msgid "" -"$ perf record -F 9999 -g -k 1 --call-graph dwarf,65528 -o perf.data python -" -"Xperf_jit my_script.py" +"$ perf record -F 9999 -g -k 1 --call-graph dwarf,65528 -o perf.data python " +"-Xperf_jit my_script.py" msgstr "" msgid "Different compilation flags can significantly impact stack sizes:" diff --git a/howto/pyporting.po b/howto/pyporting.po index 7ade12272f..c59ece3386 100644 --- a/howto/pyporting.po +++ b/howto/pyporting.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +50,8 @@ msgstr "" msgid "" "Since Python 3.11 the original porting guide was discontinued. You can find " -"the old guide in the `archive `_." +"the old guide in the `archive `_." msgstr "" msgid "Third-party guides" diff --git a/howto/regex.po b/howto/regex.po index e2b98e2025..0b181e92c8 100644 --- a/howto/regex.po +++ b/howto/regex.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -27,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 "Regular Expression HOWTO" -msgstr "Wyrażenia regularne PORADNIK" +msgid "Regular expression HOWTO" +msgstr "" msgid "Author" msgstr "Autor" @@ -80,7 +76,7 @@ msgid "" "more understandable." msgstr "" -msgid "Simple Patterns" +msgid "Simple patterns" msgstr "" msgid "" @@ -95,7 +91,7 @@ msgid "" "refer to almost any textbook on writing compilers." msgstr "" -msgid "Matching Characters" +msgid "Matching characters" msgstr "" msgid "" @@ -106,12 +102,12 @@ msgid "" msgstr "" msgid "" -"There are exceptions to this rule; some characters are special :dfn:" -"`metacharacters`, and don't match themselves. Instead, they signal that " -"some out-of-the-ordinary thing should be matched, or they affect other " -"portions of the RE by repeating them or changing their meaning. Much of " -"this document is devoted to discussing various metacharacters and what they " -"do." +"There are exceptions to this rule; some characters are " +"special :dfn:`metacharacters`, and don't match themselves. Instead, they " +"signal that some out-of-the-ordinary thing should be matched, or they affect " +"other portions of the RE by repeating them or changing their meaning. Much " +"of this document is devoted to discussing various metacharacters and what " +"they do." msgstr "" msgid "" @@ -141,12 +137,12 @@ msgid "" msgstr "" msgid "" -"You can match the characters not listed within the class by :dfn:" -"`complementing` the set. This is indicated by including a ``'^'`` as the " -"first character of the class. For example, ``[^5]`` will match any character " -"except ``'5'``. If the caret appears elsewhere in a character class, it " -"does not have special meaning. For example: ``[5^]`` will match either a " -"``'5'`` or a ``'^'``." +"You can match the characters not listed within the class " +"by :dfn:`complementing` the set. This is indicated by including a ``'^'`` " +"as the first character of the class. For example, ``[^5]`` will match any " +"character except ``'5'``. If the caret appears elsewhere in a character " +"class, it does not have special meaning. For example: ``[5^]`` will match " +"either a ``'5'`` or a ``'^'``." msgstr "" msgid "" @@ -168,10 +164,10 @@ msgid "" "Let's take an example: ``\\w`` matches any alphanumeric character. If the " "regex pattern is expressed in bytes, this is equivalent to the class ``[a-zA-" "Z0-9_]``. If the regex pattern is a string, ``\\w`` will match all the " -"characters marked as letters in the Unicode database provided by the :mod:" -"`unicodedata` module. You can use the more restricted definition of ``\\w`` " -"in a string pattern by supplying the :const:`re.ASCII` flag when compiling " -"the regular expression." +"characters marked as letters in the Unicode database provided by " +"the :mod:`unicodedata` module. You can use the more restricted definition " +"of ``\\w`` in a string pattern by supplying the :const:`re.ASCII` flag when " +"compiling the regular expression." msgstr "" msgid "" @@ -236,12 +232,12 @@ msgstr "" msgid "" "The final metacharacter in this section is ``.``. It matches anything " -"except a newline character, and there's an alternate mode (:const:`re." -"DOTALL`) where it will match even a newline. ``.`` is often used where you " -"want to match \"any character\"." +"except a newline character, and there's an alternate mode " +"(:const:`re.DOTALL`) where it will match even a newline. ``.`` is often " +"used where you want to match \"any character\"." msgstr "" -msgid "Repeating Things" +msgid "Repeating things" msgstr "" msgid "" @@ -344,6 +340,9 @@ msgstr "``abc``" msgid "Back up again, so that ``[bcd]*`` is only matching ``bc``." msgstr "" +msgid "7" +msgstr "7" + msgid "" "Try ``b`` again. This time the character at the current position is " "``'b'``, so it succeeds." @@ -401,7 +400,7 @@ msgid "" "shorter and easier to read." msgstr "" -msgid "Using Regular Expressions" +msgid "Using regular expressions" msgstr "" msgid "" @@ -411,7 +410,7 @@ msgid "" "perform matches with them." msgstr "" -msgid "Compiling Regular Expressions" +msgid "Compiling regular expressions" msgstr "" msgid "" @@ -446,8 +445,8 @@ msgid "" "and no special syntax was created for expressing them. (There are " "applications that don't need REs at all, so there's no need to bloat the " "language specification by including them.) Instead, the :mod:`re` module is " -"simply a C extension module included with Python, just like the :mod:" -"`socket` or :mod:`zlib` modules." +"simply a C extension module included with Python, just like " +"the :mod:`socket` or :mod:`zlib` modules." msgstr "" msgid "" @@ -455,7 +454,7 @@ msgid "" "disadvantage which is the topic of the next section." msgstr "" -msgid "The Backslash Plague" +msgid "The backslash plague" msgstr "" msgid "" @@ -519,10 +518,10 @@ msgstr "" msgid "" "In addition, special escape sequences that are valid in regular expressions, " -"but not valid as Python string literals, now result in a :exc:" -"`DeprecationWarning` and will eventually become a :exc:`SyntaxError`, which " -"means the sequences will be invalid if raw string notation or escaping the " -"backslashes isn't used." +"but not valid as Python string literals, now result in " +"a :exc:`SyntaxWarning` and will eventually become a :exc:`SyntaxError`, " +"which means the sequences will be invalid if raw string notation or escaping " +"the backslashes isn't used." msgstr "" msgid "Regular String" @@ -546,7 +545,7 @@ msgstr "``\"\\\\w+\\\\s+\\\\1\"``" msgid "``r\"\\w+\\s+\\1\"``" msgstr "``r\"\\w+\\s+\\1\"``" -msgid "Performing Matches" +msgid "Performing matches" msgstr "" msgid "" @@ -577,15 +576,15 @@ msgstr "" msgid "``findall()``" msgstr "``findall()``" -msgid "Find all substrings where the RE matches, and returns them as a list." +msgid "Find all substrings where the RE matches, and return them as a list." msgstr "" msgid "``finditer()``" msgstr "``finditer()``" msgid "" -"Find all substrings where the RE matches, and returns them as an :term:" -"`iterator`." +"Find all substrings where the RE matches, and return them as " +"an :term:`iterator`." msgstr "" msgid "" @@ -697,11 +696,11 @@ msgstr "" "(0, 5)" msgid "" -":meth:`~re.Match.group` returns the substring that was matched by the RE. :" -"meth:`~re.Match.start` and :meth:`~re.Match.end` return the starting and " -"ending index of the match. :meth:`~re.Match.span` returns both start and end " -"indexes in a single tuple. Since the :meth:`~re.Pattern.match` method only " -"checks if the RE matches at the start of a string, :meth:`!start` will " +":meth:`~re.Match.group` returns the substring that was matched by the " +"RE. :meth:`~re.Match.start` and :meth:`~re.Match.end` return the starting " +"and ending index of the match. :meth:`~re.Match.span` returns both start and " +"end indexes in a single tuple. Since the :meth:`~re.Pattern.match` method " +"only checks if the RE matches at the start of a string, :meth:`!start` will " "always be zero. However, the :meth:`~re.Pattern.search` method of patterns " "scans through the string, so the match may not start at zero in that " "case. ::" @@ -734,8 +733,8 @@ msgid "" msgstr "" msgid "" -"Two pattern methods return all of the matches for a pattern. :meth:`~re." -"Pattern.findall` returns a list of matching strings::" +"Two pattern methods return all of the matches for a " +"pattern. :meth:`~re.Pattern.findall` returns a list of matching strings::" msgstr "" msgid "" @@ -748,15 +747,15 @@ msgid "" "The ``r`` prefix, making the literal a raw string literal, is needed in this " "example because escape sequences in a normal \"cooked\" string literal that " "are not recognized by Python, as opposed to regular expressions, now result " -"in a :exc:`DeprecationWarning` and will eventually become a :exc:" -"`SyntaxError`. See :ref:`the-backslash-plague`." +"in a :exc:`SyntaxWarning` and will eventually become a :exc:`SyntaxError`. " +"See :ref:`the-backslash-plague`." msgstr "" msgid "" ":meth:`~re.Pattern.findall` has to create the entire list before it can be " "returned as the result. The :meth:`~re.Pattern.finditer` method returns a " -"sequence of :ref:`match object ` instances as an :term:" -"`iterator`::" +"sequence of :ref:`match object ` instances as " +"an :term:`iterator`::" msgstr "" msgid "" @@ -771,16 +770,16 @@ msgid "" "(29, 31)" msgstr "" -msgid "Module-Level Functions" +msgid "Module-level functions" msgstr "" msgid "" -"You don't have to create a pattern object and call its methods; the :mod:" -"`re` module also provides top-level functions called :func:`~re.match`, :" -"func:`~re.search`, :func:`~re.findall`, :func:`~re.sub`, and so forth. " -"These functions take the same arguments as the corresponding pattern method " -"with the RE string added as the first argument, and still return either " -"``None`` or a :ref:`match object ` instance. ::" +"You don't have to create a pattern object and call its methods; " +"the :mod:`re` module also provides top-level functions " +"called :func:`~re.match`, :func:`~re.search`, :func:`~re.findall`, :func:`~re.sub`, " +"and so forth. These functions take the same arguments as the corresponding " +"pattern method with the RE string added as the first argument, and still " +"return either ``None`` or a :ref:`match object ` instance. ::" msgstr "" msgid "" @@ -804,18 +803,18 @@ msgid "" "not much difference thanks to the internal cache." msgstr "" -msgid "Compilation Flags" +msgid "Compilation flags" msgstr "" msgid "" "Compilation flags let you modify some aspects of how regular expressions " "work. Flags are available in the :mod:`re` module under two names, a long " -"name such as :const:`IGNORECASE` and a short, one-letter form such as :const:" -"`I`. (If you're familiar with Perl's pattern modifiers, the one-letter " -"forms use the same letters; the short form of :const:`re.VERBOSE` is :const:" -"`re.X`, for example.) Multiple flags can be specified by bitwise OR-ing " -"them; ``re.I | re.M`` sets both the :const:`I` and :const:`M` flags, for " -"example." +"name such as :const:`IGNORECASE` and a short, one-letter form such " +"as :const:`I`. (If you're familiar with Perl's pattern modifiers, the one-" +"letter forms use the same letters; the short form of :const:`re.VERBOSE` " +"is :const:`re.X`, for example.) Multiple flags can be specified by bitwise " +"OR-ing them; ``re.I | re.M`` sets both the :const:`I` and :const:`M` flags, " +"for example." msgstr "" msgid "" @@ -874,13 +873,13 @@ msgid "" "letters, too. Full Unicode matching also works unless the :const:`ASCII` " "flag is used to disable non-ASCII matches. When the Unicode patterns ``[a-" "z]`` or ``[A-Z]`` are used in combination with the :const:`IGNORECASE` flag, " -"they will match the 52 ASCII letters and 4 additional non-ASCII letters: " -"'İ' (U+0130, Latin capital letter I with dot above), 'ı' (U+0131, Latin " -"small letter dotless i), 'ſ' (U+017F, Latin small letter long s) and " -"'K' (U+212A, Kelvin sign). ``Spam`` will match ``'Spam'``, ``'spam'``, " -"``'spAM'``, or ``'ſpam'`` (the latter is matched only in Unicode mode). This " -"lowercasing doesn't take the current locale into account; it will if you " -"also set the :const:`LOCALE` flag." +"they will match the 52 ASCII letters and 4 additional non-ASCII letters: 'İ' " +"(U+0130, Latin capital letter I with dot above), 'ı' (U+0131, Latin small " +"letter dotless i), 'ſ' (U+017F, Latin small letter long s) and 'K' (U+212A, " +"Kelvin sign). ``Spam`` will match ``'Spam'``, ``'spam'``, ``'spAM'``, or " +"``'ſpam'`` (the latter is matched only in Unicode mode). This lowercasing " +"doesn't take the current locale into account; it will if you also set " +"the :const:`LOCALE` flag." msgstr "" msgid "" @@ -939,7 +938,7 @@ msgid "" "the whitespace is in a character class or preceded by an unescaped " "backslash; this lets you organize and indent the RE more clearly. This flag " "also lets you put comments within a RE that will be ignored by the engine; " -"comments are marked by a ``'#'`` that's neither in a character class or " +"comments are marked by a ``'#'`` that's neither in a character class nor " "preceded by an unescaped backslash." msgstr "" @@ -968,6 +967,9 @@ msgid "" " \"|[0-9]+\"\n" " \"|x[0-9a-fA-F]+);\")" msgstr "" +"charref = re.compile(\"&#(0[0-7]+\"\n" +" \"|[0-9]+\"\n" +" \"|x[0-9a-fA-F]+);\")" msgid "" "In the above example, Python's automatic concatenation of string literals " @@ -975,7 +977,7 @@ msgid "" "difficult to understand than the version using :const:`re.VERBOSE`." msgstr "" -msgid "More Pattern Power" +msgid "More pattern power" msgstr "" msgid "" @@ -984,7 +986,7 @@ msgid "" "retrieve portions of the text that was matched." msgstr "" -msgid "More Metacharacters" +msgid "More metacharacters" msgstr "" msgid "" @@ -1025,9 +1027,9 @@ msgstr "``^``" msgid "" "Matches at the beginning of lines. Unless the :const:`MULTILINE` flag has " -"been set, this will only match at the beginning of the string. In :const:" -"`MULTILINE` mode, this also matches immediately after each newline within " -"the string." +"been set, this will only match at the beginning of the string. " +"In :const:`MULTILINE` mode, this also matches immediately after each newline " +"within the string." msgstr "" msgid "" @@ -1061,6 +1063,12 @@ msgid "" ">>> print(re.search('}$', '{block}\\n'))\n" "" msgstr "" +">>> print(re.search('}$', '{block}'))\n" +"\n" +">>> print(re.search('}$', '{block} '))\n" +"None\n" +">>> print(re.search('}$', '{block}\\n'))\n" +"" msgid "" "To match a literal ``'$'``, use ``\\$`` or enclose it inside a character " @@ -1126,6 +1134,11 @@ msgid "" ">>> print(p.search('\\b' + 'class' + '\\b'))\n" "" msgstr "" +">>> p = re.compile('\\bclass\\b')\n" +">>> print(p.search('no class at all'))\n" +"None\n" +">>> print(p.search('\\b' + 'class' + '\\b'))\n" +"" msgid "" "Second, inside a character class, where there's no use for this assertion, " @@ -1158,6 +1171,10 @@ msgid "" "MIME-Version: 1.0\n" "To: editor@example.com" msgstr "" +"From: author@example.com\n" +"User-Agent: Thunderbird 1.5.0.9 (X11/20061227)\n" +"MIME-Version: 1.0\n" +"To: editor@example.com" msgid "" "This can be handled by writing a regular expression which matches an entire " @@ -1186,12 +1203,12 @@ msgstr "" msgid "" "Groups indicated with ``'('``, ``')'`` also capture the starting and ending " "index of the text that they match; this can be retrieved by passing an " -"argument to :meth:`~re.Match.group`, :meth:`~re.Match.start`, :meth:`~re." -"Match.end`, and :meth:`~re.Match.span`. Groups are numbered starting with " -"0. Group 0 is always present; it's the whole RE, so :ref:`match object " -"` methods all have group 0 as their default argument. Later " -"we'll see how to express groups that don't capture the span of text that " -"they match. ::" +"argument " +"to :meth:`~re.Match.group`, :meth:`~re.Match.start`, :meth:`~re.Match.end`, " +"and :meth:`~re.Match.span`. Groups are numbered starting with 0. Group 0 " +"is always present; it's the whole RE, so :ref:`match object ` " +"methods all have group 0 as their default argument. Later we'll see how to " +"express groups that don't capture the span of text that they match. ::" msgstr "" msgid "" @@ -1202,6 +1219,12 @@ msgid "" ">>> m.group(0)\n" "'ab'" msgstr "" +">>> p = re.compile('(a)b')\n" +">>> m = p.match('ab')\n" +">>> m.group()\n" +"'ab'\n" +">>> m.group(0)\n" +"'ab'" msgid "" "Subgroups are numbered from left to right, from 1 upward. Groups can be " @@ -1219,6 +1242,14 @@ msgid "" ">>> m.group(2)\n" "'b'" msgstr "" +">>> p = re.compile('(a(b)c)d')\n" +">>> m = p.match('abcd')\n" +">>> m.group(0)\n" +"'abcd'\n" +">>> m.group(1)\n" +"'abc'\n" +">>> m.group(2)\n" +"'b'" msgid "" ":meth:`~re.Match.group` can be passed multiple group numbers at a time, in " @@ -1274,7 +1305,7 @@ msgid "" "substitutions." msgstr "" -msgid "Non-capturing and Named Groups" +msgid "Non-capturing and named groups" msgstr "" msgid "" @@ -1331,6 +1362,12 @@ msgid "" ">>> m.groups()\n" "()" msgstr "" +">>> m = re.match(\"([abc])+\", \"abc\")\n" +">>> m.groups()\n" +"('c',)\n" +">>> m = re.match(\"(?:[abc])+\", \"abc\")\n" +">>> m.groups()\n" +"()" msgid "" "Except for the fact that you can't retrieve the contents of what the group " @@ -1370,8 +1407,8 @@ msgid "" msgstr "" msgid "" -"Additionally, you can retrieve named groups as a dictionary with :meth:`~re." -"Match.groupdict`::" +"Additionally, you can retrieve named groups as a dictionary " +"with :meth:`~re.Match.groupdict`::" msgstr "" msgid "" @@ -1385,8 +1422,8 @@ msgstr "" msgid "" "Named groups are handy because they let you use easily remembered names, " -"instead of having to remember numbers. Here's an example RE from the :mod:" -"`imaplib` module::" +"instead of having to remember numbers. Here's an example RE from " +"the :mod:`imaplib` module::" msgstr "" msgid "" @@ -1397,6 +1434,12 @@ msgid "" " r' (?P[-+])(?P[0-9][0-9])(?P[0-9][0-9])'\n" " r'\"')" msgstr "" +"InternalDate = re.compile(r'INTERNALDATE \"'\n" +" r'(?P[ 123][0-9])-(?P[A-Z][a-z][a-z])-'\n" +" r'(?P[0-9][0-9][0-9][0-9])'\n" +" r' (?P[0-9][0-9]):(?P[0-9][0-9]):(?P[0-9][0-9])'\n" +" r' (?P[-+])(?P[0-9][0-9])(?P[0-9][0-9])'\n" +" r'\"')" msgid "" "It's obviously much easier to retrieve ``m.group('zonem')``, instead of " @@ -1409,8 +1452,8 @@ msgid "" "name instead of the number. This is another Python extension: ``(?P=name)`` " "indicates that the contents of the group called *name* should again be " "matched at the current point. The regular expression for finding doubled " -"words, ``\\b(\\w+)\\s+\\1\\b`` can also be written as ``\\b(?" -"P\\w+)\\s+(?P=word)\\b``::" +"words, ``\\b(\\w+)\\s+\\1\\b`` can also be written as ``\\b(?P\\w+)\\s+" +"(?P=word)\\b``::" msgstr "" msgid "" @@ -1422,7 +1465,7 @@ msgstr "" ">>> p.search('Paris in the the spring').group()\n" "'the the'" -msgid "Lookahead Assertions" +msgid "Lookahead assertions" msgstr "" msgid "" @@ -1478,10 +1521,13 @@ msgid "" "filenames where the extension is not ``bat``? Some incorrect attempts:" msgstr "" +msgid "``.*[.][^b].*$``" +msgstr "``.*[.][^b].*$``" + msgid "" -"``.*[.][^b].*$`` The first attempt above tries to exclude ``bat`` by " -"requiring that the first character of the extension is not a ``b``. This is " -"wrong, because the pattern also doesn't match ``foo.bar``." +"The first attempt above tries to exclude ``bat`` by requiring that the first " +"character of the extension is not a ``b``. This is wrong, because the " +"pattern also doesn't match ``foo.bar``." msgstr "" msgid "``.*[.]([^b]..|.[^a].|..[^t])$``" @@ -1491,10 +1537,10 @@ msgid "" "The expression gets messier when you try to patch up the first solution by " "requiring one of the following cases to match: the first character of the " "extension isn't ``b``; the second character isn't ``a``; or the third " -"character isn't ``t``. This accepts ``foo.bar`` and rejects ``autoexec." -"bat``, but it requires a three-letter extension and won't accept a filename " -"with a two-letter extension such as ``sendmail.cf``. We'll complicate the " -"pattern again in an effort to fix it." +"character isn't ``t``. This accepts ``foo.bar`` and rejects " +"``autoexec.bat``, but it requires a three-letter extension and won't accept " +"a filename with a two-letter extension such as ``sendmail.cf``. We'll " +"complicate the pattern again in an effort to fix it." msgstr "" msgid "``.*[.]([^b].?.?|.[^a]?.?|..?[^t]?)$``" @@ -1516,13 +1562,16 @@ msgstr "" msgid "A negative lookahead cuts through all this confusion:" msgstr "" +msgid "``.*[.](?!bat$)[^.]*$``" +msgstr "``.*[.](?!bat$)[^.]*$``" + msgid "" -"``.*[.](?!bat$)[^.]*$`` The negative lookahead means: if the expression " -"``bat`` doesn't match at this point, try the rest of the pattern; if " -"``bat$`` does match, the whole pattern will fail. The trailing ``$`` is " -"required to ensure that something like ``sample.batch``, where the extension " -"only starts with ``bat``, will be allowed. The ``[^.]*`` makes sure that " -"the pattern works when there are multiple dots in the filename." +"The negative lookahead means: if the expression ``bat`` doesn't match at " +"this point, try the rest of the pattern; if ``bat$`` does match, the whole " +"pattern will fail. The trailing ``$`` is required to ensure that something " +"like ``sample.batch``, where the extension only starts with ``bat``, will be " +"allowed. The ``[^.]*`` makes sure that the pattern works when there are " +"multiple dots in the filename." msgstr "" msgid "" @@ -1534,7 +1583,7 @@ msgstr "" msgid "``.*[.](?!bat$|exe$)[^.]*$``" msgstr "``.*[.](?!bat$|exe$)[^.]*$``" -msgid "Modifying Strings" +msgid "Modifying strings" msgstr "" msgid "" @@ -1565,7 +1614,7 @@ msgid "" "number of replacements" msgstr "" -msgid "Splitting Strings" +msgid "Splitting strings" msgstr "" msgid "" @@ -1630,8 +1679,8 @@ msgid "" "['Words', 'words, words.']" msgstr "" -msgid "Search and Replace" -msgstr "Znajdz i zamień" +msgid "Search and replace" +msgstr "" msgid "" "Another common task is to find all the matches for a pattern, and replace " @@ -1713,6 +1762,9 @@ msgid "" ">>> p.sub(r'subsection{\\1}','section{First} section{second}')\n" "'subsection{First} subsection{second}'" msgstr "" +">>> p = re.compile('section{ ( [^}]* ) }', re.VERBOSE)\n" +">>> p.sub(r'subsection{\\1}','section{First} section{second}')\n" +"'subsection{First} subsection{second}'" msgid "" "There's also a syntax for referring to named groups as defined by the ``(?" @@ -1768,8 +1820,8 @@ msgid "" "x'``." msgstr "" -msgid "Common Problems" -msgstr "Najczęstsze problemy" +msgid "Common problems" +msgstr "" msgid "" "Regular expressions are a powerful tool for some applications, but in some " @@ -1778,18 +1830,18 @@ msgid "" "pitfalls." msgstr "" -msgid "Use String Methods" -msgstr "Użyj metod string" +msgid "Use string methods" +msgstr "" msgid "" "Sometimes using the :mod:`re` module is a mistake. If you're matching a " -"fixed string, or a single character class, and you're not using any :mod:" -"`re` features such as the :const:`~re.IGNORECASE` flag, then the full power " -"of regular expressions may not be required. Strings have several methods for " -"performing operations with fixed strings and they're usually much faster, " -"because the implementation is a single small C loop that's been optimized " -"for the purpose, instead of the large, more generalized regular expression " -"engine." +"fixed string, or a single character class, and you're not using " +"any :mod:`re` features such as the :const:`~re.IGNORECASE` flag, then the " +"full power of regular expressions may not be required. Strings have several " +"methods for performing operations with fixed strings and they're usually " +"much faster, because the implementation is a single small C loop that's been " +"optimized for the purpose, instead of the large, more generalized regular " +"expression engine." msgstr "" msgid "" @@ -1800,8 +1852,8 @@ msgid "" "turning ``swordfish`` into ``sdeedfish``, but the naive RE ``word`` would " "have done that, too. (To avoid performing the substitution on parts of " "words, the pattern would have to be ``\\bword\\b``, in order to require that " -"``word`` have a word boundary on either side. This takes the job beyond :" -"meth:`!replace`'s abilities.)" +"``word`` have a word boundary on either side. This takes the job " +"beyond :meth:`!replace`'s abilities.)" msgstr "" msgid "" @@ -1857,14 +1909,15 @@ msgstr "" "(2, 7)" msgid "" -"Sometimes you'll be tempted to keep using :func:`re.match`, and just add ``." -"*`` to the front of your RE. Resist this temptation and use :func:`re." -"search` instead. The regular expression compiler does some analysis of REs " -"in order to speed up the process of looking for a match. One such analysis " -"figures out what the first character of a match must be; for example, a " -"pattern starting with ``Crow`` must match starting with a ``'C'``. The " -"analysis lets the engine quickly scan through the string looking for the " -"starting character, only trying the full match if a ``'C'`` is found." +"Sometimes you'll be tempted to keep using :func:`re.match`, and just add " +"``.*`` to the front of your RE. Resist this temptation and " +"use :func:`re.search` instead. The regular expression compiler does some " +"analysis of REs in order to speed up the process of looking for a match. " +"One such analysis figures out what the first character of a match must be; " +"for example, a pattern starting with ``Crow`` must match starting with a " +"``'C'``. The analysis lets the engine quickly scan through the string " +"looking for the starting character, only trying the full match if a ``'C'`` " +"is found." msgstr "" msgid "" @@ -1873,7 +1926,7 @@ msgid "" "Use :func:`re.search` instead." msgstr "" -msgid "Greedy versus Non-Greedy" +msgid "Greedy versus non-greedy" msgstr "" msgid "" @@ -1893,6 +1946,13 @@ msgid "" ">>> print(re.match('<.*>', s).group())\n" "Title" msgstr "" +">>> s = 'Title'\n" +">>> len(s)\n" +"32\n" +">>> print(re.match('<.*>', s).span())\n" +"(0, 32)\n" +">>> print(re.match('<.*>', s).group())\n" +"Title" msgid "" "The RE matches the ``'<'`` in ``''``, and the ``.*`` consumes the rest " @@ -1968,16 +2028,16 @@ msgid "This is far more readable than::" msgstr "Jest to o wiele bardziej czytelne niż::" msgid "pat = re.compile(r\"\\s*(?P
[^:]+)\\s*:(?P.*?)\\s*$\")" -msgstr "" +msgstr "pat = re.compile(r\"\\s*(?P
[^:]+)\\s*:(?P.*?)\\s*$\")" msgid "Feedback" msgstr "Feedback" msgid "" "Regular expressions are a complicated topic. Did this document help you " -"understand them? Were there parts that were unclear, or Problems you " +"understand them? Were there parts that were unclear, or problems you " "encountered that weren't covered here? If so, please send suggestions for " -"improvements to the author." +"improvements to the :ref:`issue tracker `." msgstr "" msgid "" diff --git a/howto/sockets.po b/howto/sockets.po index 0de8f73755..0dbbf59c26 100644 --- a/howto/sockets.po +++ b/howto/sockets.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -47,7 +46,7 @@ msgid "" msgstr "" msgid "Sockets" -msgstr "" +msgstr "Sockets" msgid "" "I'm only going to talk about INET (i.e. IPv4) sockets, but they account for " @@ -125,11 +124,11 @@ msgstr "" msgid "" "A couple things to notice: we used ``socket.gethostname()`` so that the " -"socket would be visible to the outside world. If we had used ``s." -"bind(('localhost', 80))`` or ``s.bind(('127.0.0.1', 80))`` we would still " -"have a \"server\" socket, but one that was only visible within the same " -"machine. ``s.bind(('', 80))`` specifies that the socket is reachable by any " -"address the machine happens to have." +"socket would be visible to the outside world. If we had used " +"``s.bind(('localhost', 80))`` or ``s.bind(('127.0.0.1', 80))`` we would " +"still have a \"server\" socket, but one that was only visible within the " +"same machine. ``s.bind(('', 80))`` specifies that the socket is reachable " +"by any address the machine happens to have." msgstr "" msgid "" diff --git a/howto/sorting.po b/howto/sorting.po index 218e41345d..e1fbb4d768 100644 --- a/howto/sorting.po +++ b/howto/sorting.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -148,8 +146,8 @@ msgstr "" msgid "" "Objects with named attributes can be made by a regular class as shown above, " -"or they can be instances of :class:`~dataclasses.dataclass` or a :term:" -"`named tuple`." +"or they can be instances of :class:`~dataclasses.dataclass` or " +"a :term:`named tuple`." msgstr "" msgid "Operator Module Functions and Partial Function Evaluation" @@ -158,8 +156,9 @@ msgstr "" msgid "" "The :term:`key function` patterns shown above are very common, so Python " "provides convenience functions to make accessor functions easier and faster. " -"The :mod:`operator` module has :func:`~operator.itemgetter`, :func:" -"`~operator.attrgetter`, and a :func:`~operator.methodcaller` function." +"The :mod:`operator` module " +"has :func:`~operator.itemgetter`, :func:`~operator.attrgetter`, and " +"a :func:`~operator.methodcaller` function." msgstr "" msgid "Using those functions, the above examples become simpler and faster:" @@ -337,9 +336,9 @@ msgid "" msgstr "" msgid "" -"Another name for this idiom is `Schwartzian transform `_\\, after Randal L. Schwartz, who " -"popularized it among Perl programmers." +"Another name for this idiom is `Schwartzian transform `_\\, after Randal L. Schwartz, " +"who popularized it among Perl programmers." msgstr "" msgid "" @@ -371,9 +370,9 @@ msgid "" msgstr "" msgid "" -"To accommodate those situations, Python provides :class:`functools." -"cmp_to_key` to wrap the comparison function to make it usable as a key " -"function::" +"To accommodate those situations, Python " +"provides :class:`functools.cmp_to_key` to wrap the comparison function to " +"make it usable as a key function::" msgstr "" msgid "sorted(words, key=cmp_to_key(strcoll)) # locale-aware sort order" @@ -383,9 +382,9 @@ msgid "Odds and Ends" msgstr "Przypadki losowe" msgid "" -"For locale aware sorting, use :func:`locale.strxfrm` for a key function or :" -"func:`locale.strcoll` for a comparison function. This is necessary because " -"\"alphabetical\" sort orderings can vary across cultures even if the " +"For locale aware sorting, use :func:`locale.strxfrm` for a key function " +"or :func:`locale.strcoll` for a comparison function. This is necessary " +"because \"alphabetical\" sort orderings can vary across cultures even if the " "underlying alphabet is the same." msgstr "" @@ -408,8 +407,8 @@ msgstr "" msgid "" "The sort routines use ``<`` when making comparisons between two objects. So, " -"it is easy to add a standard sort order to a class by defining an :meth:" -"`~object.__lt__` method:" +"it is easy to add a standard sort order to a class by defining " +"an :meth:`~object.__lt__` method:" msgstr "" msgid "" @@ -419,10 +418,10 @@ msgid "" msgstr "" msgid "" -"However, note that ``<`` can fall back to using :meth:`~object.__gt__` if :" -"meth:`~object.__lt__` is not implemented (see :func:`object.__lt__` for " +"However, note that ``<`` can fall back to using :meth:`~object.__gt__` " +"if :meth:`~object.__lt__` is not implemented (see :func:`object.__lt__` for " "details on the mechanics). To avoid surprises, :pep:`8` recommends that all " -"six comparison methods be implemented. The :func:`~functools.total_ordering` " +"six comparison methods be implemented. The :deco:`~functools.total_ordering` " "decorator is provided to make that task easier." msgstr "" diff --git a/howto/timerfd.po b/howto/timerfd.po index 7fb1ca0ca1..95139caee5 100644 --- a/howto/timerfd.po +++ b/howto/timerfd.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Rafael Fontenelle , 2024 -# Maciej Olko , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-05-11 01:08+0000\n" -"Last-Translator: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -182,8 +181,8 @@ msgid "" " conn = None\n" " elif fd in fds:\n" " print(f\"Reading timer {fd}\")\n" -" count = int.from_bytes(os.read(fd, 8), byteorder=sys." -"byteorder)\n" +" count = int.from_bytes(os.read(fd, 8), " +"byteorder=sys.byteorder)\n" " print(f\"Timer {fds.index(fd) + 1} expired {count} " "times\")\n" " else:\n" @@ -267,8 +266,8 @@ msgid "" " conn = None\n" " elif fd in fds:\n" " print(f\"Reading timer {fd}\")\n" -" count = int.from_bytes(os.read(fd, 8), byteorder=sys." -"byteorder)\n" +" count = int.from_bytes(os.read(fd, 8), " +"byteorder=sys.byteorder)\n" " print(f\"Timer {fds.index(fd) + 1} expired {count} times\")\n" " else:\n" " print(f\"Unknown file descriptor {fd}\")\n" diff --git a/howto/unicode.po b/howto/unicode.po index 40e70b9970..be17df2cd6 100644 --- a/howto/unicode.po +++ b/howto/unicode.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -75,10 +74,10 @@ msgstr "" msgid "" "The Unicode standard describes how characters are represented by **code " "points**. A code point value is an integer in the range 0 to 0x10FFFF " -"(about 1.1 million values, the `actual number assigned `_ is less than that). In the standard and in " -"this document, a code point is written using the notation ``U+265E`` to mean " -"the character with value ``0x265e`` (9,822 in decimal)." +"(about 1.1 million values, the `actual number assigned `_ is less than that). In the " +"standard and in this document, a code point is written using the notation " +"``U+265E`` to mean the character with value ``0x265e`` (9,822 in decimal)." msgstr "" msgid "" @@ -250,8 +249,8 @@ msgid "" msgstr "" msgid "" -"Another `good introductory article `_ was " "written by Joel Spolsky. If this introduction didn't make things clear to " "you, you should try reading this alternate article before continuing." @@ -388,10 +387,10 @@ msgid "" msgstr "" msgid "" -"The *errors* parameter is the same as the parameter of the :meth:`~bytes." -"decode` method but supports a few more possible handlers. As well as " -"``'strict'``, ``'ignore'``, and ``'replace'`` (which in this case inserts a " -"question mark instead of the unencodable character), there is also " +"The *errors* parameter is the same as the parameter of " +"the :meth:`~bytes.decode` method but supports a few more possible handlers. " +"As well as ``'strict'``, ``'ignore'``, and ``'replace'`` (which in this case " +"inserts a question mark instead of the unencodable character), there is also " "``'xmlcharrefreplace'`` (inserts an XML character reference), " "``backslashreplace`` (inserts a ``\\uNNNN`` escape sequence) and " "``namereplace`` (inserts a ``\\N{...}`` escape sequence)." @@ -541,9 +540,9 @@ msgid "" "subcategories. To take the codes from the above output, ``'Ll'`` means " "'Letter, lowercase', ``'No'`` means \"Number, other\", ``'Mn'`` is \"Mark, " "nonspacing\", and ``'So'`` is \"Symbol, other\". See `the General Category " -"Values section of the Unicode Character Database documentation `_ for a list of category " -"codes." +"Values section of the Unicode Character Database documentation `_ for a list of " +"category codes." msgstr "" msgid "Comparing Strings" @@ -576,12 +575,12 @@ msgstr "" "'gürzenichstrasse'" msgid "" -"A second tool is the :mod:`unicodedata` module's :func:`~unicodedata." -"normalize` function that converts strings to one of several normal forms, " -"where letters followed by a combining character are replaced with single " -"characters. :func:`~unicodedata.normalize` can be used to perform string " -"comparisons that won't falsely report inequality if two strings use " -"combining characters differently:" +"A second tool is the :mod:`unicodedata` " +"module's :func:`~unicodedata.normalize` function that converts strings to " +"one of several normal forms, where letters followed by a combining character " +"are replaced with single characters. :func:`~unicodedata.normalize` can be " +"used to perform string comparisons that won't falsely report inequality if " +"two strings use combining characters differently:" msgstr "" msgid "" @@ -686,8 +685,9 @@ msgid "Some good alternative discussions of Python's Unicode support are:" msgstr "" msgid "" -"`Processing Text Files in Python 3 `_, by Nick Coghlan." +"`Processing Text Files in Python 3 `_, " +"by Nick Coghlan." msgstr "" msgid "" @@ -696,8 +696,8 @@ msgid "" msgstr "" msgid "" -"The :class:`str` type is described in the Python library reference at :ref:" -"`textseq`." +"The :class:`str` type is described in the Python library reference " +"at :ref:`textseq`." msgstr "" msgid "The documentation for the :mod:`unicodedata` module." @@ -759,8 +759,8 @@ msgid "" "object that assumes the file's contents are in a specified encoding and " "accepts Unicode parameters for methods such as :meth:`~io.TextIOBase.read` " "and :meth:`~io.TextIOBase.write`. This works through :func:`open`\\'s " -"*encoding* and *errors* parameters which are interpreted just like those in :" -"meth:`str.encode` and :meth:`bytes.decode`." +"*encoding* and *errors* parameters which are interpreted just like those " +"in :meth:`str.encode` and :meth:`bytes.decode`." msgstr "" msgid "Reading Unicode from a file is therefore simple::" @@ -972,8 +972,8 @@ msgid "" msgstr "" msgid "" -"One section of `Mastering Python 3 Input/Output `_, a PyCon 2010 talk by David " +"One section of `Mastering Python 3 Input/Output `_, a PyCon 2010 talk by David " "Beazley, discusses text processing and binary data handling." msgstr "" diff --git a/howto/urllib2.po b/howto/urllib2.po index 6b568ce5b3..686603a15f 100644 --- a/howto/urllib2.po +++ b/howto/urllib2.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:53+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -44,8 +41,8 @@ msgid "" msgstr "" msgid "" -"`Basic Authentication `_" +"`Basic Authentication `__" msgstr "" msgid "A tutorial on *Basic Authentication*, with examples in Python." @@ -93,8 +90,8 @@ msgstr "" msgid "" "If you wish to retrieve a resource via URL and store it in a temporary " -"location, you can do so via the :func:`shutil.copyfileobj` and :func:" -"`tempfile.NamedTemporaryFile` functions::" +"location, you can do so via the :func:`shutil.copyfileobj` " +"and :func:`tempfile.NamedTemporaryFile` functions::" msgstr "" msgid "" @@ -272,13 +269,13 @@ msgstr "Obsługa wyjątków" msgid "" "*urlopen* raises :exc:`~urllib.error.URLError` when it cannot handle a " -"response (though as usual with Python APIs, built-in exceptions such as :exc:" -"`ValueError`, :exc:`TypeError` etc. may also be raised)." +"response (though as usual with Python APIs, built-in exceptions such " +"as :exc:`ValueError`, :exc:`TypeError` etc. may also be raised)." msgstr "" msgid "" -":exc:`~urllib.error.HTTPError` is the subclass of :exc:`~urllib.error." -"URLError` raised in the specific case of HTTP URLs." +":exc:`~urllib.error.HTTPError` is the subclass " +"of :exc:`~urllib.error.URLError` raised in the specific case of HTTP URLs." msgstr "" msgid "The exception classes are exported from the :mod:`urllib.error` module." @@ -315,9 +312,9 @@ msgid "" "request. The default handlers will handle some of these responses for you " "(for example, if the response is a \"redirection\" that requests the client " "fetch the document from a different URL, urllib will handle that for you). " -"For those it can't handle, urlopen will raise an :exc:`~urllib.error." -"HTTPError`. Typical errors include '404' (page not found), '403' (request " -"forbidden), and '401' (authentication required)." +"For those it can't handle, urlopen will raise " +"an :exc:`~urllib.error.HTTPError`. Typical errors include '404' (page not " +"found), '403' (request forbidden), and '401' (authentication required)." msgstr "" msgid "" @@ -340,77 +337,32 @@ msgstr "" msgid "" ":attr:`http.server.BaseHTTPRequestHandler.responses` is a useful dictionary " -"of response codes in that shows all the response codes used by :rfc:`2616`. " -"The dictionary is reproduced here for convenience ::" +"of response codes that shows all the response codes used by :rfc:`2616`. An " +"excerpt from the dictionary is shown below ::" msgstr "" msgid "" -"# Table mapping response codes to messages; entries have the\n" -"# form {code: (shortmessage, longmessage)}.\n" "responses = {\n" -" 100: ('Continue', 'Request received, please continue'),\n" -" 101: ('Switching Protocols',\n" -" 'Switching to new protocol; obey Upgrade header'),\n" -"\n" -" 200: ('OK', 'Request fulfilled, document follows'),\n" -" 201: ('Created', 'Document created, URL follows'),\n" -" 202: ('Accepted',\n" -" 'Request accepted, processing continues off-line'),\n" -" 203: ('Non-Authoritative Information', 'Request fulfilled from cache'),\n" -" 204: ('No Content', 'Request fulfilled, nothing follows'),\n" -" 205: ('Reset Content', 'Clear input form for further input.'),\n" -" 206: ('Partial Content', 'Partial content follows.'),\n" -"\n" -" 300: ('Multiple Choices',\n" -" 'Object has several resources -- see URI list'),\n" -" 301: ('Moved Permanently', 'Object moved permanently -- see URI list'),\n" -" 302: ('Found', 'Object moved temporarily -- see URI list'),\n" -" 303: ('See Other', 'Object moved -- see Method and URL list'),\n" -" 304: ('Not Modified',\n" -" 'Document has not changed since given time'),\n" -" 305: ('Use Proxy',\n" -" 'You must use proxy specified in Location to access this '\n" -" 'resource.'),\n" -" 307: ('Temporary Redirect',\n" -" 'Object moved temporarily -- see URI list'),\n" -"\n" -" 400: ('Bad Request',\n" -" 'Bad request syntax or unsupported method'),\n" -" 401: ('Unauthorized',\n" -" 'No permission -- see authorization schemes'),\n" -" 402: ('Payment Required',\n" -" 'No payment -- see charging schemes'),\n" -" 403: ('Forbidden',\n" -" 'Request forbidden -- authorization will not help'),\n" -" 404: ('Not Found', 'Nothing matches the given URI'),\n" -" 405: ('Method Not Allowed',\n" -" 'Specified method is invalid for this server.'),\n" -" 406: ('Not Acceptable', 'URI not available in preferred format.'),\n" -" 407: ('Proxy Authentication Required', 'You must authenticate with '\n" -" 'this proxy before proceeding.'),\n" -" 408: ('Request Timeout', 'Request timed out; try again later.'),\n" -" 409: ('Conflict', 'Request conflict.'),\n" -" 410: ('Gone',\n" -" 'URI no longer exists and has been permanently removed.'),\n" -" 411: ('Length Required', 'Client must specify Content-Length.'),\n" -" 412: ('Precondition Failed', 'Precondition in headers is false.'),\n" -" 413: ('Request Entity Too Large', 'Entity is too large.'),\n" -" 414: ('Request-URI Too Long', 'URI is too long.'),\n" -" 415: ('Unsupported Media Type', 'Entity body in unsupported format.'),\n" -" 416: ('Requested Range Not Satisfiable',\n" -" 'Cannot satisfy request range.'),\n" -" 417: ('Expectation Failed',\n" -" 'Expect condition could not be satisfied.'),\n" -"\n" -" 500: ('Internal Server Error', 'Server got itself in trouble'),\n" -" 501: ('Not Implemented',\n" -" 'Server does not support this operation'),\n" -" 502: ('Bad Gateway', 'Invalid responses from another server/proxy.'),\n" -" 503: ('Service Unavailable',\n" -" 'The server cannot process the request due to a high load'),\n" -" 504: ('Gateway Timeout',\n" -" 'The gateway server did not receive a timely response'),\n" -" 505: ('HTTP Version Not Supported', 'Cannot fulfill request.'),\n" +" ...\n" +" : ('OK', 'Request fulfilled, document follows'),\n" +" ...\n" +" : ('Forbidden',\n" +" 'Request forbidden -- authorization will " +"'\n" +" 'not help'),\n" +" : ('Not Found',\n" +" 'Nothing matches the given URI'),\n" +" ...\n" +" : (\"I'm a Teapot\",\n" +" 'Server refuses to brew coffee because " +"'\n" +" 'it is a teapot'),\n" +" ...\n" +" : ('Service Unavailable',\n" +" 'The server cannot process the " +"'\n" +" 'request due to a high load'),\n" +" ...\n" " }" msgstr "" @@ -432,8 +384,8 @@ msgid "" "...\n" "404\n" "b'\\n\\n\\n\\n\\n\\nPage Not Found\\n\n" " ..." @@ -443,9 +395,9 @@ msgid "Wrapping it Up" msgstr "" msgid "" -"So if you want to be prepared for :exc:`~urllib.error.HTTPError` *or* :exc:" -"`~urllib.error.URLError` there are two basic approaches. I prefer the second " -"approach." +"So if you want to be prepared for :exc:`~urllib.error.HTTPError` " +"*or* :exc:`~urllib.error.URLError` there are two basic approaches. I prefer " +"the second approach." msgstr "" msgid "Number 1" @@ -510,8 +462,8 @@ msgstr "" msgid "" "**info** - this returns a dictionary-like object that describes the page " -"fetched, particularly the headers sent by the server. It is currently an :" -"class:`http.client.HTTPMessage` instance." +"fetched, particularly the headers sent by the server. It is currently " +"an :class:`http.client.HTTPMessage` instance." msgstr "" msgid "" @@ -541,8 +493,8 @@ msgid "" msgstr "" msgid "" -"To create an opener, instantiate an ``OpenerDirector``, and then call ``." -"add_handler(some_handler_instance)`` repeatedly." +"To create an opener, instantiate an ``OpenerDirector``, and then call " +"``.add_handler(some_handler_instance)`` repeatedly." msgstr "" msgid "" @@ -681,8 +633,8 @@ msgstr "" msgid "" "Currently ``urllib.request`` *does not* support fetching of ``https`` " -"locations through a proxy. However, this can be enabled by extending urllib." -"request as shown in the recipe [#]_." +"locations through a proxy. However, this can be enabled by extending " +"urllib.request as shown in the recipe [#]_." msgstr "" msgid "" @@ -702,9 +654,9 @@ msgid "" "As of Python 2.3 you can specify how long a socket should wait for a " "response before timing out. This can be useful in applications which have to " "fetch web pages. By default the socket module has *no timeout* and can hang. " -"Currently, the socket timeout is not exposed at the http.client or urllib." -"request levels. However, you can set the default timeout globally for all " -"sockets using ::" +"Currently, the socket timeout is not exposed at the http.client or " +"urllib.request levels. However, you can set the default timeout globally for " +"all sockets using ::" msgstr "" msgid "" diff --git a/installing/index.po b/installing/index.po index b3eda29991..5b4074346c 100644 --- a/installing/index.po +++ b/installing/index.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Wierzbicki , 2021 -# Stan Ulbrych, 2025 -# Maciej Olko , 2025 +# python-doc bot, 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -25,19 +24,13 @@ 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 "Installing Python Modules" +msgid "Installing Python modules" msgstr "Instalacja 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." +"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 " @@ -79,11 +72,11 @@ msgid "Key terms" msgstr "Główne pojęcia" msgid "" -"``pip`` is the preferred installer program. Starting with Python 3.4, it is " -"included by default with the Python binary installers." +":program:`pip` is the preferred installer program. It is included by default " +"with the Python binary installers." msgstr "" -"``pip`` jest preferowanym instalatorem. Od wersji Pythona 3.4 jest domyślnie " -"dołączony do instalatorów binarnych." +":program:`pip` jest preferowanym instalatorem. Jest domyślnie dołączony do " +"instalatorów binarnych." msgid "" "A *virtual environment* is a semi-isolated Python environment that allows " @@ -94,35 +87,28 @@ msgstr "" "instalowanym na potrzeby poszczególnych aplikacji a nie całego sytemu." msgid "" -"``venv`` is the standard tool for creating virtual environments, and has " -"been part of Python since Python 3.3. Starting with Python 3.4, it defaults " -"to installing ``pip`` into all created virtual environments." +"``venv`` is the standard tool for creating virtual environments. It defaults " +"to installing :program:`pip` into all created virtual environments." msgstr "" "``venv`` jest strandardowym narzędziem do tworzenia środowisk wirtualnych. " -"Jest częścią Pythona od wersji 3.3, a od 3.4 domyślnie instaluje ``pip`` we " -"wszystkich tworzonych środowiskach wirtualnych." +"Domyślnie instaluje :program:`pip` we wszystkich tworzonych środowiskach " +"wirtualnych." msgid "" -"``virtualenv`` is a third party alternative (and predecessor) to ``venv``. " -"It allows virtual environments to be used on versions of Python prior to " -"3.4, which either don't provide ``venv`` at all, or aren't able to " -"automatically install ``pip`` into created environments." -msgstr "" -"``virtualenv`` to zewnętrzne (i starsze) rozwiązania alternatywne wobec " -"``venv``. Pozwala korzystać ze środowisk wirtualnych w wesjach Pythona " -"wcześniejszych niż 3.4, które albo nie zapewniają ``venv``, albo nie są w " -"stanie automatycznie zainstalować ``pip`` w tworzonych środowiskach." +"``virtualenv`` is a third-party alternative (and predecessor) to ``venv``." +msgstr "``virtualenv`` jest zewnętrzną alternatywą (i poprzednikiem) ``venv``." msgid "" -"The `Python Package Index `__ is a public repository of " -"open source licensed packages made available for use by other Python users." +"The `Python Package Index (PyPI) `__ is a public " +"repository of open source licensed packages made available for use by other " +"Python users." msgstr "" -"`Python Package Index `__ jest publicznym repozytorium " -"paczek z licencją open-source, udostępnionych do wykorzystania przez innych " -"użytkowników Pythona." +"`Python Package Index (PyPI) `__ jest publicznym " +"repozytorium paczek z licencją open-source, udostępnionych do wykorzystania " +"przez innych użytkowników Pythona." msgid "" -"the `Python Packaging Authority `__ is the group of " +"The `Python Packaging Authority `__ is 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 " @@ -134,22 +120,6 @@ msgstr "" "formatu plików. Utrzymują oni różne narzędzia, dokumentację i repozytoria " "zgłoszeń na `GitHub `__." -msgid "" -"``distutils`` is the original build and distribution system first added to " -"the Python standard library in 1998. While direct use of ``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 "" -"``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 "" @@ -164,17 +134,21 @@ msgstr "" "`__" msgid "Basic usage" -msgstr "" +msgstr "Podstawowe użycie" msgid "" "The standard packaging tools are all designed to be used from the command " "line." msgstr "" +"Wszystkie standardowe narzędzia do pakowania są przeznaczone do użycia z " +"wiersza poleceń." msgid "" "The following command will install the latest version of a module and its " -"dependencies from the Python Package Index::" +"dependencies from PyPI::" msgstr "" +"Poniższa komenda pozwoli zainstalować najnowszą wersję modułu wraz z jej " +"zależnościami z PyPI::" msgid "python -m pip install SomePackage" msgstr "python -m pip install JakisPakiet" @@ -183,12 +157,18 @@ msgid "" "For POSIX users (including macOS and Linux users), the examples in this " "guide assume the use of a :term:`virtual environment`." msgstr "" +"W przypadku użytkowników systemu POSIX (w tym użytkowników systemów macOS i " +"Linux) przykłady zawarte w niniejszym przewodniku zakładają korzystanie " +"z :term:`środowisko wirtualne`." msgid "" "For Windows users, the examples in this guide assume that the option to " "adjust the system PATH environment variable was selected when installing " "Python." msgstr "" +"W przypadku użytkowników systemu Windows przykłady zawarte w niniejszym " +"przewodniku zakładają, że podczas instalacji Pythona wybrano opcję " +"dostosowania systemowej zmiennej środowiskowej PATH." msgid "" "It's also possible to specify an exact or minimum version directly on the " @@ -196,6 +176,10 @@ msgid "" "other special character which get interpreted by shell, the package name and " "the version should be enclosed within double quotes::" msgstr "" +"Można również podać dokładną lub minimalną wersję bezpośrednio w wierszu " +"poleceń. W przypadku stosowania operatorów porównania, takich jak ``>``, " +"``<`` lub innych znaków specjalnych, które są interpretowane przez powłokę, " +"nazwa pakietu oraz wersja powinny być ujęte w podwójne cudzysłowy::" msgid "" "python -m pip install SomePackage==1.0.4 # specific version\n" @@ -209,14 +193,21 @@ msgid "" "it again will have no effect. Upgrading existing modules must be requested " "explicitly::" msgstr "" +"Zazwyczaj, jeśli odpowiedni moduł jest już zainstalowany, próba ponownej " +"instalacji nie przyniesie żadnego efektu. Aby zaktualizować istniejący " +"moduł, należy wyraźnie zgłosić taką prośbę::" msgid "python -m pip install --upgrade SomePackage" msgstr "Python -m pip install --upgrade JakisPakiet" msgid "" -"More information and resources regarding ``pip`` and its capabilities can be " -"found in the `Python Packaging User Guide `__." +"More information and resources regarding :program:`pip` and its capabilities " +"can be found in the `Python Packaging User Guide `__." msgstr "" +"Więcej informacji i materiałów dotyczących pakietu :program:`pip` oraz jego " +"możliwości można znaleźć w `Podręczniku użytkownika packagingu Pythona " +"`__." msgid "" "Creation of virtual environments is done through the :mod:`venv` module. " @@ -228,6 +219,8 @@ msgid "" "`Python Packaging User Guide: Installing Python Distribution Packages " "`__" msgstr "" +"`Python Packaging User Guide: Installing Python Distribution Packages " +"`__" msgid "How do I ...?" msgstr "Jak ...?" @@ -235,21 +228,6 @@ msgstr "Jak ...?" msgid "These are quick answers or links for some common tasks." 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, " -"``pip`` needs to be \"bootstrapped\" as described in the Python Packaging " -"User Guide." -msgstr "" - -msgid "" -"`Python Packaging User Guide: Requirements for Installing Packages `__" -msgstr "" - msgid "... install packages just for the current user?" msgstr "... zainstalować pakiety tylko dla bieżącego użytkownika?" @@ -257,115 +235,154 @@ msgid "" "Passing the ``--user`` option to ``python -m pip install`` will install a " "package just for the current user, rather than for all users of the system." msgstr "" +"Przekazanie opcji ``--user`` do polecenia ``python -m pip install`` " +"zainstaluje pakiet wyłącznie dla bieżącego użytkownika, a nie dla wszystkich " +"użytkowników systemu." msgid "... install scientific Python packages?" -msgstr "" +msgstr "... zainstalować naukowe pakiety Pythona?" msgid "" "A number of scientific Python packages have complex binary dependencies, and " -"aren't currently easy to install using ``pip`` directly. At this point in " -"time, it will often be easier for users to install these packages by `other " -"means `__ rather than attempting to " -"install them with ``pip``." +"aren't currently easy to install using :program:`pip` directly. It will " +"often be easier for users to install these packages by `other means `__ rather than attempting to install them " +"with :program:`pip`." msgstr "" +"Wiele pakietów naukowych Pythona charakteryzuje się złożonymi zależnościami " +"między plikami binarnymi i obecnie nie da się ich łatwo zainstalować " +"bezpośrednio za pomocą :program:`pip`. Użytkownikom często łatwiej będzie " +"zainstalować te pakiety pakiet `innymi metodami `__, zamiast próbować zainstalować je za " +"pomocą :program:`pip`." msgid "" "`Python Packaging User Guide: Installing Scientific Packages `__" msgstr "" +"`Python Packaging User Guide: Installing Scientific Packages `__" msgid "... work with multiple versions of Python installed in parallel?" -msgstr "" +msgstr "... pracować z wieloma wersjami Pythona zainstalowanymi równolegle?" msgid "" "On Linux, macOS, and other POSIX systems, use the versioned Python commands " -"in combination with the ``-m`` switch to run the appropriate copy of " -"``pip``::" +"in combination with the ``-m`` switch to run the appropriate copy " +"of :program:`pip`::" msgstr "" +"W systemach Linux, macOS i innych systemach zgodnych z POSIX należy używać " +"wersjonowanych komend Pythona w połączeniu z opcją ``-m``, aby uruchomić " +"odpowiednią kopię :program:`pip`::" msgid "" -"python2 -m pip install SomePackage # default Python 2\n" -"python2.7 -m pip install SomePackage # specifically Python 2.7\n" -"python3 -m pip install SomePackage # default Python 3\n" -"python3.4 -m pip install SomePackage # specifically Python 3.4" +"python3 -m pip install SomePackage # default Python 3\n" +"python3.14 -m pip install SomePackage # specifically Python 3.14" msgstr "" +"python3 -m pip install JakisPakiet # domyślny Python 3\n" +"python3.14 -m pip install JakisPakiet # konkretnie Python 3.14" -msgid "Appropriately versioned ``pip`` commands may also be available." +msgid "Appropriately versioned :program:`pip` commands may also be available." msgstr "" +"Dostępne mogą być również odpowiednio wersjonowane komendy :program:`pip`." msgid "" -"On Windows, use the ``py`` Python launcher in combination with the ``-m`` " -"switch::" +"On Windows, use the :program:`py` Python launcher in combination with the ``-" +"m`` switch::" msgstr "" +"W systemie Windows należy użyć programu uruchamiającego :program:`py` w " +"połączeniu z opcją ``-m``::" msgid "" -"py -2 -m pip install SomePackage # default Python 2\n" -"py -2.7 -m pip install SomePackage # specifically Python 2.7\n" -"py -3 -m pip install SomePackage # default Python 3\n" -"py -3.4 -m pip install SomePackage # specifically Python 3.4" +"py -3 -m pip install SomePackage # default Python 3\n" +"py -3.14 -m pip install SomePackage # specifically Python 3.14" msgstr "" +"py -3 -m pip install JakisPakiet # domyślny Python 3\n" +"py -3.14 -m pip install JakisPakiet # konkretnie Python 3.14" msgid "Common installation issues" msgstr "" msgid "Installing into the system Python on Linux" -msgstr "" +msgstr "Instalacja w Pythonie systemowym w systemie Linux" msgid "" "On Linux systems, a Python installation will typically be included as part " "of the distribution. Installing into this Python installation requires root " "access to the system, and may interfere with the operation of the system " "package manager and other components of the system if a component is " -"unexpectedly upgraded using ``pip``." +"unexpectedly upgraded using :program:`pip`." msgstr "" +"W systemach Linux instalacja Pythona jest zazwyczaj zawarta w dystrybucji. " +"Instalacja w ramach tej instalacji Python wymaga uprawnień administratora " +"(root) do systemu i może zakłócić działanie systemowego menedżera pakietów " +"oraz innych komponentów systemu, jeśli któryś z nich zostanie nieoczekiwanie " +"zaktualizowany za pomocą :program:`pip`." msgid "" "On such systems, it is often better to use a virtual environment or a per-" -"user installation when installing packages with ``pip``." +"user installation when installing packages with :program:`pip`." msgstr "" +"W takich systemach często lepiej jest skorzystać z instalacji do środowiska " +"wirtualnego lub instalacji dla użytkownika podczas instalowania pakietów za " +"pomocą :program:`pip`." msgid "Pip not installed" msgstr "" msgid "" -"It is possible that ``pip`` does not get installed by default. One potential " -"fix is::" +"It is possible that :program:`pip` does not get installed by default. One " +"potential fix is::" msgstr "" +"Możliwe, że :program:`pip` nie zostanie zainstalowany domyślnie. Jednym z " +"możliwych rozwiązań jest::" msgid "python -m ensurepip --default-pip" -msgstr "" +msgstr "python -m ensurepip --default-pip" msgid "" -"There are also additional resources for `installing pip. `__" +"There are also additional resources for `installing pip `__." msgstr "" msgid "Installing binary extensions" msgstr "" msgid "" -"Python has typically relied heavily on source based distribution, with end " -"users being expected to compile extension modules from source as part of the " +"Python once relied heavily on source-based distribution, with end users " +"being expected to compile extension modules from source as part of the " "installation process." msgstr "" +"Python kiedyś opierał się w dużej mierze na dystrybucji opartej na kodzie " +"źródłowym, a od użytkowników końcowych oczekiwano, że w ramach instalacji " +"skompilują moduł rozszerzenia z kodu źródłowego." msgid "" -"With the introduction of support for the binary ``wheel`` format, and the " -"ability to publish wheels for at least Windows and macOS through the Python " -"Package Index, this problem is expected to diminish over time, as users are " -"more regularly able to install pre-built extensions rather than needing to " -"build them themselves." +"With the introduction of the binary wheel format, and the ability to publish " +"wheels through PyPI, this problem is diminishing, as users are more " +"regularly able to install pre-built extensions rather than needing to build " +"them themselves." msgstr "" +"Wraz z wprowadzeniem binarnego formatu wheel oraz możliwością publikowania " +"wheeli za pośrednictwem PyPI problem ten staje się coraz mniej dotkliwy, " +"ponieważ użytkownicy coraz częściej mogą instalować gotowe rozszerzenia, " +"zamiast kompilować je samodzielnie." msgid "" -"Some of the solutions for installing `scientific software `__ that are not yet available as pre-built ``wheel`` " -"files may also help with obtaining other binary extensions without needing " -"to build them locally." +"Some of the solutions for installing `scientific software `__ that are not yet available as pre-built " +"wheel files may also help with obtaining other binary extensions without " +"needing to build them locally." msgstr "" +"Niektóre rozwiązania dotyczące instalacji `oprogramowania naukowego `__, które nie są jeszcze dostępne w postaci " +"gotowych plików wheel, mogą również pomóc w uzyskaniu innych rozszerzeń " +"binarnych bez konieczności kompilowania ich lokalnie." msgid "" -"`Python Packaging User Guide: Binary Extensions `__" +"`Python Packaging User Guide: Binary Extensions `__" msgstr "" +"` Python Packaging User Guide: Rozszerzenia binarne `__" diff --git a/library/__future__.po b/library/__future__.po index b08c68e955..60ce1f0cef 100644 --- a/library/__future__.po +++ b/library/__future__.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,10 +30,11 @@ msgid "**Source code:** :source:`Lib/__future__.py`" msgstr "**Kod źródłowy:** :source:`Lib/__future__.py`" msgid "" -"Imports of the form ``from __future__ import feature`` are called :ref:" -"`future statements `. These are special-cased by the Python compiler " -"to allow the use of new Python features in modules containing the future " -"statement before the release in which the feature becomes standard." +"Imports of the form ``from __future__ import feature`` are " +"called :ref:`future statements `. These are special-cased by the " +"Python compiler to allow the use of new Python features in modules " +"containing the future statement before the release in which the feature " +"becomes standard." msgstr "" msgid "" @@ -61,9 +60,9 @@ msgstr "" msgid "" "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)." +"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 "Module Contents" @@ -87,9 +86,6 @@ msgstr "obowiązkowe w" msgid "effect" msgstr "" -msgid "nested_scopes" -msgstr "nested_scopes" - msgid "2.1.0b1" msgstr "2.1.0b1" @@ -99,9 +95,6 @@ msgstr "2.2" msgid ":pep:`227`: *Statically Nested Scopes*" msgstr "" -msgid "generators" -msgstr "generatory" - msgid "2.2.0a1" msgstr "2.2.0a1" @@ -111,9 +104,6 @@ msgstr "2.3" msgid ":pep:`255`: *Simple Generators*" msgstr "" -msgid "division" -msgstr "podział" - msgid "2.2.0a2" msgstr "2.2.0a2" @@ -123,42 +113,27 @@ msgstr "3.0" msgid ":pep:`238`: *Changing the Division Operator*" msgstr ":pep:`238`: *Zmiana operatora podziału*" -msgid "absolute_import" -msgstr "absolute_import" - msgid "2.5.0a1" msgstr "2.5.0a1" msgid ":pep:`328`: *Imports: Multi-Line and Absolute/Relative*" msgstr "" -msgid "with_statement" -msgstr "with_statement" - msgid "2.6" msgstr "2.6" -msgid ":pep:`343`: *The \"with\" Statement*" +msgid ":pep:`343`: *The “with” Statement*" msgstr "" -msgid "print_function" -msgstr "print_function" - msgid "2.6.0a2" msgstr "2.6.0a2" msgid ":pep:`3105`: *Make print a function*" msgstr "" -msgid "unicode_literals" -msgstr "unicode_literals" - msgid ":pep:`3112`: *Bytes literals in Python 3000*" msgstr "" -msgid "generator_stop" -msgstr "generator_stop" - msgid "3.5.0b1" msgstr "3.5.0b1" @@ -168,14 +143,11 @@ msgstr "3.7" msgid ":pep:`479`: *StopIteration handling inside generators*" msgstr "" -msgid "annotations" -msgstr "anotacje" - msgid "3.7.0b1" msgstr "3.7.0b1" -msgid "TBD [1]_" -msgstr "TBD [1]_" +msgid "Never [1]_" +msgstr "" msgid ":pep:`563`: *Postponed evaluation of annotations*" msgstr "" @@ -229,8 +201,8 @@ msgstr "" msgid "" "*CompilerFlag* is the (bitfield) flag that should be passed in the fourth " "argument to the built-in function :func:`compile` to enable the feature in " -"dynamically compiled code. This flag is stored in the :attr:`_Feature." -"compiler_flag` attribute on :class:`_Feature` instances." +"dynamically compiled code. This flag is stored in " +"the :attr:`_Feature.compiler_flag` attribute on :class:`_Feature` instances." msgstr "" msgid "" diff --git a/library/__main__.po b/library/__main__.po index f984453a5f..51983aa4df 100644 --- a/library/__main__.po +++ b/library/__main__.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +42,8 @@ msgstr "" msgid "" "Both of these mechanisms are related to Python modules; how users interact " "with them and how they interact with each other. They are explained in " -"detail below. If you're new to Python modules, see the tutorial section :" -"ref:`tut-modules` for an introduction." +"detail below. If you're new to Python modules, see the tutorial " +"section :ref:`tut-modules` for an introduction." msgstr "" msgid "``__name__ == '__main__'``" @@ -118,8 +118,8 @@ msgstr "" "Hello, world!" msgid "" -"the Python module or package passed to the Python interpreter with the :" -"option:`-m` argument:" +"the Python module or package passed to the Python interpreter with " +"the :option:`-m` argument:" msgstr "" msgid "" @@ -252,9 +252,9 @@ msgstr "" msgid "" "Since the call to ``main`` is wrapped in :func:`sys.exit`, the expectation " -"is that your function will return some value acceptable as an input to :func:" -"`sys.exit`; typically, an integer or ``None`` (which is implicitly returned " -"if your function does not have a return statement)." +"is that your function will return some value acceptable as an input " +"to :func:`sys.exit`; typically, an integer or ``None`` (which is implicitly " +"returned if your function does not have a return statement)." msgstr "" msgid "" @@ -268,8 +268,8 @@ msgid "" "In particular, be careful about returning strings from your ``main`` " "function. :func:`sys.exit` will interpret a string argument as a failure " "message, so your program will have an exit code of ``1``, indicating " -"failure, and the string will be written to :data:`sys.stderr`. The ``echo." -"py`` example from earlier exemplifies using the ``sys.exit(main())`` " +"failure, and the string will be written to :data:`sys.stderr`. The " +"``echo.py`` example from earlier exemplifies using the ``sys.exit(main())`` " "convention." msgstr "" @@ -351,8 +351,8 @@ msgstr "" "'asyncio.__main__'" msgid "" -"This won't work for ``__main__.py`` files in the root directory of a ``." -"zip`` file though. Hence, for consistency, a minimal ``__main__.py`` " +"This won't work for ``__main__.py`` files in the root directory of a " +"``.zip`` file though. Hence, for consistency, a minimal ``__main__.py`` " "without a ``__name__`` check is preferred." msgstr "" @@ -491,6 +491,6 @@ msgid "" msgstr "" msgid "" -"The ``__main__`` scope is used in the implementation of :mod:`pdb` and :mod:" -"`rlcompleter`." +"The ``__main__`` scope is used in the implementation of :mod:`pdb` " +"and :mod:`rlcompleter`." msgstr "" diff --git a/library/_thread.po b/library/_thread.po index 4436a20e5a..e8706c73d6 100644 --- a/library/_thread.po +++ b/library/_thread.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -48,9 +47,6 @@ msgstr "" msgid "This is now a synonym of the built-in :exc:`RuntimeError`." msgstr "" -msgid "This is the type of lock objects." -msgstr "" - msgid "" "Start a new thread and return its identifier. The thread executes the " "function *function* with the argument list *args* (which must be a tuple). " @@ -61,10 +57,11 @@ msgid "When the function returns, the thread silently exits." msgstr "" msgid "" -"When the function terminates with an unhandled exception, :func:`sys." -"unraisablehook` is called to handle the exception. The *object* attribute of " -"the hook argument is *function*. By default, a stack trace is printed and " -"then the thread exits (but other threads continue to run)." +"When the function terminates with an unhandled " +"exception, :func:`sys.unraisablehook` is called to handle the exception. The " +"*object* attribute of the hook argument is *function*. By default, a stack " +"trace is printed and then the thread exits (but other threads continue to " +"run)." msgstr "" msgid "" @@ -92,8 +89,9 @@ msgid "" msgstr "" msgid "" -"If the given signal isn't handled by Python (it was set to :const:`signal." -"SIG_DFL` or :const:`signal.SIG_IGN`), this function does nothing." +"If the given signal isn't handled by Python (it was set " +"to :const:`signal.SIG_DFL` or :const:`signal.SIG_IGN`), this function does " +"nothing." msgstr "" msgid "The *signum* argument is added to customize the signal number." @@ -141,9 +139,9 @@ msgid "" "*size* argument specifies the stack size to be used for subsequently created " "threads, and must be 0 (use platform or configured default) or a positive " "integer value of at least 32,768 (32 KiB). If *size* is not specified, 0 is " -"used. If changing the thread stack size is unsupported, a :exc:" -"`RuntimeError` is raised. If the specified stack size is invalid, a :exc:" -"`ValueError` is raised and the stack size is unmodified. 32 KiB is " +"used. If changing the thread stack size is unsupported, " +"a :exc:`RuntimeError` is raised. If the specified stack size is invalid, " +"a :exc:`ValueError` is raised and the stack size is unmodified. 32 KiB is " "currently the minimum supported stack size value to guarantee sufficient " "stack space for the interpreter itself. Note that some platforms may have " "particular restrictions on values for the stack size, such as requiring a " @@ -163,6 +161,9 @@ msgid "" "raise an :exc:`OverflowError`." msgstr "" +msgid "This is the type of lock objects." +msgstr "" + msgid "Lock objects have the following methods:" msgstr "" @@ -209,8 +210,8 @@ msgid "" msgstr "" msgid "" -"In addition to these methods, lock objects can also be used via the :keyword:" -"`with` statement, e.g.::" +"In addition to these methods, lock objects can also be used via " +"the :keyword:`with` statement, e.g.::" msgstr "" msgid "" @@ -245,8 +246,9 @@ msgstr "" msgid "" "When the main thread exits, it is system defined whether the other threads " -"survive. On most systems, they are killed without executing :keyword:" -"`try` ... :keyword:`finally` clauses or executing object destructors." +"survive. On most systems, they are killed without " +"executing :keyword:`try` ... :keyword:`finally` clauses or executing object " +"destructors." msgstr "" msgid "light-weight processes" diff --git a/library/abc.po b/library/abc.po index 031ceb05c6..8ab9e39758 100644 --- a/library/abc.po +++ b/library/abc.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,16 +32,17 @@ msgstr "**Kod źródłowy:**. :source:`Lib/abc.py`" msgid "" "This module provides the infrastructure for defining :term:`abstract base " "classes ` (ABCs) in Python, as outlined in :pep:`3119`; " -"see the PEP for why this was added to Python. (See also :pep:`3141` and the :" -"mod:`numbers` module regarding a type hierarchy for numbers based on ABCs.)" +"see the PEP for why this was added to Python. (See also :pep:`3141` and " +"the :mod:`numbers` module regarding a type hierarchy for numbers based on " +"ABCs.)" msgstr "" msgid "" "The :mod:`collections` module has some concrete classes that derive from " -"ABCs; these can, of course, be further derived. In addition, the :mod:" -"`collections.abc` submodule has some ABCs that can be used to test whether a " -"class or instance provides a particular interface, for example, if it is :" -"term:`hashable` or if it is a :term:`mapping`." +"ABCs; these can, of course, be further derived. In addition, " +"the :mod:`collections.abc` submodule has some ABCs that can be used to test " +"whether a class or instance provides a particular interface, for example, if " +"it is :term:`hashable` or if it is a :term:`mapping`." msgstr "" msgid "" @@ -100,12 +100,12 @@ msgstr "" "(nawet wbudowane uogólnienia) i niezwiązane abstrakcyjne uogólnienia " "podstawowe jako \"sztuczne podrzędne uogólnienia\" -- te uogólnienia i " "pochodne po nich będą uznawane za podrzędne uogólnienia rejestrowanego " -"uogólnienia podstawowego abstrakcyjnego przez wbudowane zadanie :func:" -"`issubclass`, ale rejestrowanie abstrakcyjnego uogólnienia bazowego nie " -"pokaże się w ich sposobie rozwiązywania sposobów postępowania (w skr. MRO - " -"z ang. - Method Resolution Order) ani też wypełnienia sposobów postępowania " -"określone przez rejestrowanie abstrakcyjnych bazowych uogólnień nie będą " -"wywoływalne (nawet nie przez użycie :func:`super`). [#]_" +"uogólnienia podstawowego abstrakcyjnego przez wbudowane " +"zadanie :func:`issubclass`, ale rejestrowanie abstrakcyjnego uogólnienia " +"bazowego nie pokaże się w ich sposobie rozwiązywania sposobów postępowania " +"(w skr. MRO - z ang. - Method Resolution Order) ani też wypełnienia sposobów " +"postępowania określone przez rejestrowanie abstrakcyjnych bazowych uogólnień " +"nie będą wywoływalne (nawet nie przez użycie :func:`super`). [#]_" msgid "" "Classes created with a metaclass of :class:`!ABCMeta` have the following " @@ -134,8 +134,8 @@ msgid "Returns the registered subclass, to allow usage as a class decorator." msgstr "" msgid "" -"To detect calls to :meth:`!register`, you can use the :func:" -"`get_cache_token` function." +"To detect calls to :meth:`!register`, you can use " +"the :func:`get_cache_token` function." msgstr "" msgid "You can also override this method in an abstract base class:" @@ -150,8 +150,8 @@ msgid "" "Check whether *subclass* is considered a subclass of this ABC. This means " "that you can customize the behavior of :func:`issubclass` further without " "the need to call :meth:`register` on every class you want to consider a " -"subclass of the ABC. (This class method is called from the :meth:`~type." -"__subclasscheck__` method of the ABC.)" +"subclass of the ABC. (This class method is called from " +"the :meth:`~type.__subclasscheck__` method of the ABC.)" msgstr "" msgid "" @@ -198,18 +198,18 @@ msgid "" msgstr "" msgid "" -"The ABC ``MyIterable`` defines the standard iterable method, :meth:`~object." -"__iter__`, as an abstract method. The implementation given here can still " -"be called from subclasses. The :meth:`!get_iterator` method is also part of " -"the ``MyIterable`` abstract base class, but it does not have to be " -"overridden in non-abstract derived classes." +"The ABC ``MyIterable`` defines the standard iterable " +"method, :meth:`~object.__iter__`, as an abstract method. The implementation " +"given here can still be called from subclasses. The :meth:`!get_iterator` " +"method is also part of the ``MyIterable`` abstract base class, but it does " +"not have to be overridden in non-abstract derived classes." msgstr "" msgid "" "The :meth:`__subclasshook__` class method defined here says that any class " "that has an :meth:`~object.__iter__` method in its :attr:`~object.__dict__` " -"(or in that of one of its base classes, accessed via the :attr:`~type." -"__mro__` list) is considered a ``MyIterable`` too." +"(or in that of one of its base classes, accessed via " +"the :attr:`~type.__mro__` list) is considered a ``MyIterable`` too." msgstr "" msgid "" @@ -232,21 +232,21 @@ msgid "" "or is derived from it. A class that has a metaclass derived from :class:`!" "ABCMeta` cannot be instantiated unless all of its abstract methods and " "properties are overridden. The abstract methods can be called using any of " -"the normal 'super' call mechanisms. :func:`!abstractmethod` may be used to " +"the normal 'super' call mechanisms. :deco:`!abstractmethod` may be used to " "declare abstract methods for properties and descriptors." msgstr "" msgid "" "Dynamically adding abstract methods to a class, or attempting to modify the " "abstraction status of a method or class once it is created, are only " -"supported using the :func:`update_abstractmethods` function. The :func:`!" +"supported using the :func:`update_abstractmethods` function. The :deco:`!" "abstractmethod` only affects subclasses derived using regular inheritance; " "\"virtual subclasses\" registered with the ABC's :meth:`~ABCMeta.register` " "method are not affected." msgstr "" msgid "" -"When :func:`!abstractmethod` is applied in combination with other method " +"When :deco:`!abstractmethod` is applied in combination with other method " "descriptors, it should be applied as the innermost decorator, as shown in " "the following usage examples::" msgstr "" @@ -288,7 +288,7 @@ msgid "" "the descriptor must identify itself as abstract using :attr:`!" "__isabstractmethod__`. In general, this attribute should be ``True`` if any " "of the methods used to compose the descriptor are abstract. For example, " -"Python's built-in :class:`property` does the equivalent of::" +"Python's built-in :deco:`property` does the equivalent of::" msgstr "" msgid "" @@ -309,26 +309,26 @@ msgid "" msgstr "" "W przeciwieństwie do abstrakcyjnych sposobów postępowania Javy, te " "abstrakcyjne sposoby postępowania mogą mieć swoje wypełnienie. To " -"wypełnienie może być wzywane przez mechanizm odwołań do zadania :func:" -"`super`, z uogólnienia które przesłania taki sposób postępowania. To może " -"być użyteczne jako punkt końcowy super-wywołania w ramach udogodnienia które " -"używa współpracującego wielokrotnego-dziedziczenia." +"wypełnienie może być wzywane przez mechanizm odwołań do " +"zadania :func:`super`, z uogólnienia które przesłania taki sposób " +"postępowania. To może być użyteczne jako punkt końcowy super-wywołania w " +"ramach udogodnienia które używa współpracującego wielokrotnego-dziedziczenia." msgid "The :mod:`!abc` module also supports the following legacy decorators:" msgstr "" msgid "" -"It is now possible to use :class:`classmethod` with :func:`abstractmethod`, " +"It is now possible to use :deco:`classmethod` with :deco:`abstractmethod`, " "making this decorator redundant." msgstr "" msgid "" -"A subclass of the built-in :func:`classmethod`, indicating an abstract " -"classmethod. Otherwise it is similar to :func:`abstractmethod`." +"A subclass of the built-in :class:`classmethod`, indicating an abstract " +"classmethod. Otherwise it is similar to :deco:`abstractmethod`." msgstr "" msgid "" -"This special case is deprecated, as the :func:`classmethod` decorator is now " +"This special case is deprecated, as the :deco:`classmethod` decorator is now " "correctly identified as abstract when applied to an abstract method::" msgstr "" @@ -341,17 +341,17 @@ msgid "" msgstr "" msgid "" -"It is now possible to use :class:`staticmethod` with :func:`abstractmethod`, " +"It is now possible to use :deco:`staticmethod` with :deco:`abstractmethod`, " "making this decorator redundant." msgstr "" msgid "" -"A subclass of the built-in :func:`staticmethod`, indicating an abstract " -"staticmethod. Otherwise it is similar to :func:`abstractmethod`." +"A subclass of the built-in :class:`staticmethod`, indicating an abstract " +"staticmethod. Otherwise it is similar to :deco:`abstractmethod`." msgstr "" msgid "" -"This special case is deprecated, as the :func:`staticmethod` decorator is " +"This special case is deprecated, as the :deco:`staticmethod` decorator is " "now correctly identified as abstract when applied to an abstract method::" msgstr "" @@ -364,19 +364,19 @@ msgid "" msgstr "" msgid "" -"It is now possible to use :class:`property`, :meth:`property.getter`, :meth:" -"`property.setter` and :meth:`property.deleter` with :func:`abstractmethod`, " -"making this decorator redundant." +"It is now possible to " +"use :deco:`property`, :deco:`property.getter`, :deco:`property.setter` " +"and :deco:`property.deleter` with :deco:`abstractmethod`, making this " +"decorator redundant." msgstr "" msgid "" -"A subclass of the built-in :func:`property`, indicating an abstract property." +"A subclass of the built-in :class:`property`, indicating an abstract " +"property." msgstr "" -"Podrzędne uogólnienie wbudowanego zadania :func:`property` wskazujące " -"abstrakcyjną właściwość." msgid "" -"This special case is deprecated, as the :func:`property` decorator is now " +"This special case is deprecated, as the :deco:`property` decorator is now " "correctly identified as abstract when applied to an abstract method::" msgstr "" diff --git a/library/archiving.po b/library/archiving.po index 88e663b454..6cf9c4557a 100644 --- a/library/archiving.po +++ b/library/archiving.po @@ -29,6 +29,6 @@ msgstr "" msgid "" "The modules described in this chapter support data compression with the " "zlib, gzip, bzip2 and lzma algorithms, and the creation of ZIP- and tar-" -"format archives. See also :ref:`archiving-operations` provided by the :mod:" -"`shutil` module." +"format archives. See also :ref:`archiving-operations` provided by " +"the :mod:`shutil` module." msgstr "" diff --git a/library/argparse.po b/library/argparse.po index 101d9463e7..d24b031b38 100644 --- a/library/argparse.po +++ b/library/argparse.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-13 21:57+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+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,15 +49,15 @@ msgstr "Tutorial" msgid "" "This page contains the API reference information. For a more gentle " -"introduction to Python command-line parsing, have a look at the :ref:" -"`argparse tutorial `." +"introduction to Python command-line parsing, have a look at " +"the :ref:`argparse tutorial `." msgstr "" msgid "" "The :mod:`!argparse` module makes it easy to write user-friendly command-" "line interfaces. The program defines what arguments it requires, and :mod:`!" -"argparse` will figure out how to parse those out of :data:`sys.argv`. The :" -"mod:`!argparse` module also automatically generates help and usage " +"argparse` will figure out how to parse those out of :data:`sys.argv`. " +"The :mod:`!argparse` module also automatically generates help and usage " "messages. The module will also issue errors when users give the program " "invalid arguments." msgstr "" @@ -101,8 +100,8 @@ msgid "" msgstr "" msgid "" -"If you're looking for a guide about how to upgrade :mod:`optparse` code to :" -"mod:`!argparse`, see :ref:`Upgrading Optparse Code `." msgstr "" @@ -325,11 +324,11 @@ msgstr "" msgid "" "Sometimes, several parsers share a common set of arguments. Rather than " "repeating the definitions of these arguments, a single parser with all the " -"shared arguments and passed to ``parents=`` argument to :class:" -"`ArgumentParser` can be used. The ``parents=`` argument takes a list of :" -"class:`ArgumentParser` objects, collects all the positional and optional " -"actions from them, and adds these actions to the :class:`ArgumentParser` " -"object being constructed::" +"shared arguments and passed to ``parents=`` argument " +"to :class:`ArgumentParser` can be used. The ``parents=`` argument takes a " +"list of :class:`ArgumentParser` objects, collects all the positional and " +"optional actions from them, and adds these actions to " +"the :class:`ArgumentParser` object being constructed::" msgstr "" msgid "" @@ -370,9 +369,9 @@ msgstr "" msgid "" ":class:`RawDescriptionHelpFormatter` and :class:`RawTextHelpFormatter` give " -"more control over how textual descriptions are displayed. By default, :class:" -"`ArgumentParser` objects line-wrap the description_ and epilog_ texts in " -"command-line help messages::" +"more control over how textual descriptions are displayed. By " +"default, :class:`ArgumentParser` objects line-wrap the description_ and " +"epilog_ texts in command-line help messages::" msgstr "" msgid "" @@ -527,14 +526,19 @@ msgid "" msgstr "" msgid "" -"Arguments read from a file must by default be one per line (but see also :" -"meth:`~ArgumentParser.convert_arg_line_to_args`) and are treated as if they " -"were in the same place as the original file referencing argument on the " +"Arguments read from a file must be one per line by default (but see " +"also :meth:`~ArgumentParser.convert_arg_line_to_args`) and are treated as if " +"they were in the same place as the original file referencing argument on the " "command line. So in the example above, the expression ``['-f', 'foo', " "'@args.txt']`` is considered equivalent to the expression ``['-f', 'foo', '-" "f', 'bar']``." msgstr "" +msgid "" +"Each line is treated as a single argument, so an empty line is read as an " +"empty string (``''``)." +msgstr "" + msgid "" ":class:`ArgumentParser` uses :term:`filesystem encoding and error handler` " "to read the file containing arguments." @@ -547,24 +551,25 @@ msgstr "" msgid "" ":class:`ArgumentParser` changed encoding and errors to read arguments files " -"from default (e.g. :func:`locale.getpreferredencoding(False) ` and ``\"strict\"``) to the :term:`filesystem encoding " -"and error handler`. Arguments file should be encoded in UTF-8 instead of " -"ANSI Codepage on Windows." +"from default (e.g. :func:`locale.getpreferredencoding(False) " +"` and ``\"strict\"``) to the :term:`filesystem " +"encoding and error handler`. Arguments file should be encoded in UTF-8 " +"instead of ANSI Codepage on Windows." msgstr "" msgid "argument_default" msgstr "argument_default" msgid "" -"Generally, argument defaults are specified either by passing a default to :" -"meth:`~ArgumentParser.add_argument` or by calling the :meth:`~ArgumentParser." -"set_defaults` methods with a specific set of name-value pairs. Sometimes " -"however, it may be useful to specify a single parser-wide default for " -"arguments. This can be accomplished by passing the ``argument_default=`` " -"keyword argument to :class:`ArgumentParser`. For example, to globally " -"suppress attribute creation on :meth:`~ArgumentParser.parse_args` calls, we " -"supply ``argument_default=SUPPRESS``::" +"Generally, argument defaults are specified either by passing a default " +"to :meth:`~ArgumentParser.add_argument` or by calling " +"the :meth:`~ArgumentParser.set_defaults` methods with a specific set of name-" +"value pairs. Sometimes however, it may be useful to specify a single parser-" +"wide default for arguments. This can be accomplished by passing the " +"``argument_default=`` keyword argument to :class:`ArgumentParser`. For " +"example, to globally suppress attribute creation " +"on :meth:`~ArgumentParser.parse_args` calls, we supply " +"``argument_default=SUPPRESS``::" msgstr "" msgid "" @@ -581,9 +586,9 @@ msgid "allow_abbrev" msgstr "" msgid "" -"Normally, when you pass an argument list to the :meth:`~ArgumentParser." -"parse_args` method of an :class:`ArgumentParser`, it :ref:`recognizes " -"abbreviations ` of long options." +"Normally, when you pass an argument list to " +"the :meth:`~ArgumentParser.parse_args` method of an :class:`ArgumentParser`, " +"it :ref:`recognizes abbreviations ` of long options." msgstr "" msgid "This feature can be disabled by setting ``allow_abbrev`` to ``False``::" @@ -656,8 +661,8 @@ msgstr "" msgid "" "Occasionally, it may be useful to disable the addition of this help option. " -"This can be achieved by passing ``False`` as the ``add_help=`` argument to :" -"class:`ArgumentParser`::" +"This can be achieved by passing ``False`` as the ``add_help=`` argument " +"to :class:`ArgumentParser`::" msgstr "" msgid "" @@ -690,9 +695,10 @@ msgid "exit_on_error" msgstr "" msgid "" -"Normally, when you pass an invalid argument list to the :meth:" -"`~ArgumentParser.parse_args` method of an :class:`ArgumentParser`, it will " -"print a *message* to :data:`sys.stderr` and exit with a status code of 2." +"Normally, when you pass an invalid argument list to " +"the :meth:`~ArgumentParser.parse_args` method of an :class:`ArgumentParser`, " +"it will print a *message* to :data:`sys.stderr` and exit with a status code " +"of 2." msgstr "" msgid "" @@ -763,22 +769,25 @@ msgid "metavar_ - A name for the argument in usage messages." msgstr "" msgid "" -"dest_ - The name of the attribute to be added to the object returned by :" -"meth:`parse_args`." +"dest_ - The name of the attribute to be added to the object returned " +"by :meth:`parse_args`." msgstr "" msgid "deprecated_ - Whether or not use of the argument is deprecated." msgstr "" +msgid "The method returns an :class:`Action` object representing the argument." +msgstr "" + msgid "name or flags" msgstr "" msgid "" "The :meth:`~ArgumentParser.add_argument` method must know whether an " "optional argument, like ``-f`` or ``--foo``, or a positional argument, like " -"a list of filenames, is expected. The first arguments passed to :meth:" -"`~ArgumentParser.add_argument` must therefore be either a series of flags, " -"or a simple argument name." +"a list of filenames, is expected. The first arguments passed " +"to :meth:`~ArgumentParser.add_argument` must therefore be either a series of " +"flags, or a simple argument name." msgstr "" msgid "For example, an optional argument could be created like::" @@ -849,9 +858,8 @@ msgstr "" msgid "" "``'store_true'`` and ``'store_false'`` - These are special cases of " -"``'store_const'`` used for storing the values ``True`` and ``False`` " -"respectively. In addition, they create default values of ``False`` and " -"``True`` respectively::" +"``'store_const'`` that respectively store the values ``True`` and ``False`` " +"with default values of ``False`` and ``True``::" msgstr "" msgid "" @@ -864,26 +872,25 @@ msgid "" msgstr "" msgid "" -"``'append'`` - This stores a list, and appends each argument value to the " -"list. It is useful to allow an option to be specified multiple times. 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. Example usage::" +"``'append'`` - This appends each argument value to a list. It is useful for " +"allowing an option to be specified multiple times. If the default value is a " +"non-empty list, the parsed value will start with the default list's elements " +"and any values from the command line will be appended after those default " +"values. Example usage::" msgstr "" msgid "" ">>> parser = argparse.ArgumentParser()\n" -">>> parser.add_argument('--foo', action='append')\n" +">>> parser.add_argument('--foo', action='append', default=['0'])\n" ">>> parser.parse_args('--foo 1 --foo 2'.split())\n" -"Namespace(foo=['1', '2'])" +"Namespace(foo=['0', '1', '2'])" msgstr "" msgid "" -"``'append_const'`` - This stores a list, and appends the value specified by " -"the const_ keyword argument to the list; note that the const_ keyword " -"argument defaults to ``None``. The ``'append_const'`` action is typically " -"useful when multiple arguments need to store constants to the same list. For " -"example::" +"``'append_const'`` - This appends the value specified by the const_ keyword " +"argument to a list; note that the const_ keyword argument defaults to " +"``None``. The ``'append_const'`` action is typically useful when multiple " +"arguments need to store constants to the same list. For example::" msgstr "" msgid "" @@ -897,11 +904,11 @@ msgid "" msgstr "" msgid "" -"``'extend'`` - This stores a list and appends each item from the multi-value " -"argument list to it. The ``'extend'`` action is typically used with the " -"nargs_ keyword argument value ``'+'`` or ``'*'``. Note that when nargs_ is " -"``None`` (the default) or ``'?'``, each character of the argument string " -"will be appended to the list. Example usage::" +"``'extend'`` - This appends each item from a multi-value argument to a list. " +"The ``'extend'`` action is typically used with the nargs_ keyword argument " +"value ``'+'`` or ``'*'``. Note that when nargs_ is ``None`` (the default) or " +"``'?'``, each character of the argument string will be appended to the list. " +"Example usage::" msgstr "" msgid "" @@ -914,7 +921,7 @@ msgid "" msgstr "" msgid "" -"``'count'`` - This counts the number of times a keyword argument occurs. For " +"``'count'`` - This counts the number of times an argument occurs. For " "example, this is useful for increasing verbosity levels::" msgstr "" @@ -929,7 +936,10 @@ msgstr "" ">>> parser.parse_args(['-vvv'])\n" "Namespace(verbose=3)" -msgid "Note, the *default* will be ``None`` unless explicitly set to *0*." +msgid "" +"Unless explicitly set, the *default* will be ``None``. If the default value " +"is a non-zero number, the count starts from that number rather than from " +"zero." msgstr "" msgid "" @@ -940,9 +950,9 @@ msgid "" msgstr "" msgid "" -"``'version'`` - This expects a ``version=`` keyword argument in the :meth:" -"`~ArgumentParser.add_argument` call, and prints version information and " -"exits when invoked::" +"``'version'`` - This expects a ``version=`` keyword argument in " +"the :meth:`~ArgumentParser.add_argument` call, and prints version " +"information and exits when invoked::" msgstr "" msgid "" @@ -954,31 +964,14 @@ msgid "" "PROG 2.0" msgstr "" -msgid "" -"Only actions that consume command-line arguments (e.g. ``'store'``, " -"``'append'`` or ``'extend'``) can be used with positional arguments." -msgstr "" - msgid "" "You may also specify an arbitrary action by passing an :class:`Action` " -"subclass or other object that implements the same interface. The :class:`!" -"BooleanOptionalAction` is available in :mod:`!argparse` and adds support for " -"boolean actions such as ``--foo`` and ``--no-foo``::" +"subclass (e.g. :class:`BooleanOptionalAction`) or other object that " +"implements the same interface. Only actions that consume command-line " +"arguments (e.g. ``'store'``, ``'append'``, ``'extend'``, or custom actions " +"with non-zero ``nargs``) can be used with positional arguments." msgstr "" -msgid "" -">>> import argparse\n" -">>> parser = argparse.ArgumentParser()\n" -">>> parser.add_argument('--foo', action=argparse.BooleanOptionalAction)\n" -">>> parser.parse_args(['--no-foo'])\n" -"Namespace(foo=False)" -msgstr "" -">>> import argparse\n" -">>> parser = argparse.ArgumentParser()\n" -">>> parser.add_argument('--foo', action=argparse.BooleanOptionalAction)\n" -">>> parser.parse_args(['--no-foo'])\n" -"Namespace(foo=False)" - msgid "" "The recommended way to create a custom action is to extend :class:`Action`, " "overriding the :meth:`!__call__` method and optionally the :meth:`!__init__` " @@ -1099,9 +1092,9 @@ msgid "" msgstr "" msgid "" -"``'+'``. Just like ``'*'``, all command-line args present are gathered into " -"a list. Additionally, an error message will be generated if there wasn't at " -"least one command-line argument present. For example::" +"``'+'``. Just like ``'*'``, all command-line arguments present are gathered " +"into a list. Additionally, an error message will be generated if there " +"wasn't at least one command-line argument present. For example::" msgstr "" msgid "" @@ -1135,10 +1128,11 @@ msgstr "" msgid "" "When :meth:`~ArgumentParser.add_argument` is called with " "``action='store_const'`` or ``action='append_const'``. These actions add " -"the ``const`` value to one of the attributes of the object returned by :meth:" -"`~ArgumentParser.parse_args`. See the action_ description for examples. If " -"``const`` is not provided to :meth:`~ArgumentParser.add_argument`, it will " -"receive a default value of ``None``." +"the ``const`` value to one of the attributes of the object returned " +"by :meth:`~ArgumentParser.parse_args`. See the action_ description for " +"examples. If ``const`` is not provided " +"to :meth:`~ArgumentParser.add_argument`, it will receive a default value of " +"``None``." msgstr "" msgid "" @@ -1146,8 +1140,8 @@ msgid "" "(like ``-f`` or ``--foo``) and ``nargs='?'``. This creates an optional " "argument that can be followed by zero or one command-line arguments. When " "parsing the command line, if the option string is encountered with no " -"command-line argument following it, the value of ``const`` will be assumed " -"to be ``None`` instead. See the nargs_ description for examples." +"command-line argument following it, the value from ``const`` will be used. " +"See the nargs_ description for examples." msgstr "" msgid "" @@ -1160,11 +1154,11 @@ msgstr "" msgid "" "All optional arguments and some positional arguments may be omitted at the " -"command line. The ``default`` keyword argument of :meth:`~ArgumentParser." -"add_argument`, whose value defaults to ``None``, specifies what value should " -"be used if the command-line argument is not present. For optional arguments, " -"the ``default`` value is used when the option string was not present at the " -"command line::" +"command line. The ``default`` keyword argument " +"of :meth:`~ArgumentParser.add_argument`, whose value defaults to ``None``, " +"specifies what value should be used if the command-line argument is not " +"present. For optional arguments, the ``default`` value is used when the " +"option string was not present at the command line::" msgstr "" msgid "" @@ -1195,8 +1189,9 @@ msgstr "" msgid "" "If the ``default`` value is a string, the parser parses the value as if it " "were a command-line argument. In particular, the parser applies any type_ " -"conversion argument, if provided, before setting the attribute on the :class:" -"`Namespace` return value. Otherwise, the parser uses the value as is::" +"conversion argument, if provided, before setting the attribute on " +"the :class:`Namespace` return value. Otherwise, the parser uses the value " +"as is::" msgstr "" msgid "" @@ -1221,6 +1216,12 @@ msgid "" "Namespace(foo=42)" msgstr "" +msgid "" +"Because ``nargs='*'`` gathers any supplied values into a list, an absent " +"positional argument yields an empty list (``[]``). Only a non-``None`` " +"*default* overrides this (so ``default=None`` still gives ``[]``)." +msgstr "" + msgid "" "For required_ arguments, the ``default`` value is ignored. For example, this " "applies to positional arguments with nargs_ values other than ``?`` or " @@ -1260,9 +1261,9 @@ msgstr "" msgid "" "The argument to ``type`` can be a callable that accepts a single string or " "the name of a registered type (see :meth:`~ArgumentParser.register`) If the " -"function raises :exc:`ArgumentTypeError`, :exc:`TypeError`, or :exc:" -"`ValueError`, the exception is caught and a nicely formatted error message " -"is displayed. Other exception types are not handled." +"function raises :exc:`ArgumentTypeError`, :exc:`TypeError`, " +"or :exc:`ValueError`, the exception is caught and a nicely formatted error " +"message is displayed. Other exception types are not handled." msgstr "" msgid "Common built-in types and functions can be used as type converters:" @@ -1298,7 +1299,19 @@ msgstr "" msgid "" "The :func:`bool` function is not recommended as a type converter. All it " "does is convert empty strings to ``False`` and non-empty strings to " -"``True``. This is usually not what is desired." +"``True``. This is usually not what is desired::" +msgstr "" + +msgid "" +">>> parser = argparse.ArgumentParser()\n" +">>> _ = parser.add_argument('--verbose', type=bool)\n" +">>> parser.parse_args(['--verbose', 'False'])\n" +"Namespace(verbose=True)" +msgstr "" + +msgid "" +"See :class:`BooleanOptionalAction` or ``action='store_true'`` for common " +"alternatives." msgstr "" msgid "" @@ -1310,9 +1323,9 @@ msgstr "" msgid "" "For example, JSON or YAML conversions have complex error cases that require " -"better reporting than can be given by the ``type`` keyword. A :exc:`~json." -"JSONDecodeError` would not be well formatted and a :exc:`FileNotFoundError` " -"exception would not be handled at all." +"better reporting than can be given by the ``type`` keyword. " +"A :exc:`~json.JSONDecodeError` would not be well formatted and " +"a :exc:`FileNotFoundError` exception would not be handled at all." msgstr "" msgid "" @@ -1351,12 +1364,6 @@ msgid "" "'paper', 'scissors')" msgstr "" -msgid "" -"Note that inclusion in the *choices* sequence is checked after any type_ " -"conversions have been performed, so the type of the objects in the *choices* " -"sequence should match the type_ specified." -msgstr "" - msgid "" "Any sequence can be passed as the *choices* value, so :class:`list` " "objects, :class:`tuple` objects, and custom sequences are all supported." @@ -1367,6 +1374,18 @@ msgid "" "control its appearance in usage, help, and error messages." msgstr "" +msgid "" +"Note that *choices* are checked after any type_ conversions have been " +"performed, so objects in *choices* should match the type_ specified. This " +"can make *choices* appear unfamiliar in usage, help, or error messages." +msgstr "" + +msgid "" +"To keep *choices* user-friendly, consider a custom type wrapper that " +"converts and formats values, or omit type_ and handle conversion in your " +"application code." +msgstr "" + msgid "" "Formatted choices override the default *metavar* which is normally derived " "from *dest*. This is usually what you want because the user never sees the " @@ -1395,9 +1414,9 @@ msgid "" msgstr "" msgid "" -"As the example shows, if an option is marked as ``required``, :meth:" -"`~ArgumentParser.parse_args` will report an error if that option is not " -"present at the command line." +"As the example shows, if an option is marked as " +"``required``, :meth:`~ArgumentParser.parse_args` will report an error if " +"that option is not present at the command line." msgstr "" msgid "" @@ -1419,8 +1438,8 @@ msgid "" "The ``help`` strings can include various format specifiers to avoid " "repetition of things like the program name or the argument default_. The " "available specifiers include the program name, ``%(prog)s`` and most keyword " -"arguments to :meth:`~ArgumentParser.add_argument`, e.g. ``%(default)s``, " -"``%(type)s``, etc.::" +"arguments to :meth:`~ArgumentParser.add_argument`, e.g. ``%(default)s``, ``%" +"(type)s``, etc.::" msgstr "" msgid "" @@ -1539,10 +1558,10 @@ msgstr "" msgid "" "Most :class:`ArgumentParser` actions add some value as an attribute of the " "object returned by :meth:`~ArgumentParser.parse_args`. The name of this " -"attribute is determined by the ``dest`` keyword argument of :meth:" -"`~ArgumentParser.add_argument`. For positional argument actions, ``dest`` " -"is normally supplied as the first argument to :meth:`~ArgumentParser." -"add_argument`::" +"attribute is determined by the ``dest`` keyword argument " +"of :meth:`~ArgumentParser.add_argument`. For positional argument actions, " +"``dest`` is normally supplied as the first argument " +"to :meth:`~ArgumentParser.add_argument`::" msgstr "" msgid "" @@ -1591,6 +1610,14 @@ msgstr "" ">>> parser.parse_args('--foo XXX'.split())\n" "Namespace(bar='XXX')" +msgid "" +"Multiple arguments may share the same ``dest``. By default, the value from " +"the last such argument given on the command line wins. Use " +"``action='append'`` to collect values from all of them into a list instead. " +"For conflicting *option strings* rather than ``dest`` names, see " +"conflict_handler_." +msgstr "" + msgid "deprecated" msgstr "" @@ -1621,16 +1648,16 @@ msgstr "" msgid "" ":class:`!Action` classes implement the Action API, a callable which returns " "a callable which processes arguments from the command-line. Any object which " -"follows this API may be passed as the ``action`` parameter to :meth:" -"`~ArgumentParser.add_argument`." +"follows this API may be passed as the ``action`` parameter " +"to :meth:`~ArgumentParser.add_argument`." msgstr "" msgid "" ":class:`!Action` objects are used by an :class:`ArgumentParser` to represent " "the information needed to parse a single argument from one or more strings " "from the command line. The :class:`!Action` class must accept the two " -"positional arguments plus any keyword arguments passed to :meth:" -"`ArgumentParser.add_argument` except for the ``action`` itself." +"positional arguments plus any keyword arguments passed " +"to :meth:`ArgumentParser.add_argument` except for the ``action`` itself." msgstr "" msgid "" @@ -1651,15 +1678,15 @@ msgid "" msgstr "" msgid "" -"*namespace* - The :class:`Namespace` object that will be returned by :meth:" -"`~ArgumentParser.parse_args`. Most actions add an attribute to this object " -"using :func:`setattr`." +"*namespace* - The :class:`Namespace` object that will be returned " +"by :meth:`~ArgumentParser.parse_args`. Most actions add an attribute to " +"this object using :func:`setattr`." msgstr "" msgid "" "*values* - The associated command-line arguments, with any type conversions " -"applied. Type conversions are specified with the type_ keyword argument to :" -"meth:`~ArgumentParser.add_argument`." +"applied. Type conversions are specified with the type_ keyword argument " +"to :meth:`~ArgumentParser.add_argument`." msgstr "" msgid "" @@ -1681,6 +1708,26 @@ msgid "" "will be used." msgstr "" +msgid "" +"A subclass of :class:`Action` for handling boolean flags with positive and " +"negative options. Adding a single argument such as ``--foo`` automatically " +"creates both ``--foo`` and ``--no-foo`` options, storing ``True`` and " +"``False`` respectively::" +msgstr "" + +msgid "" +">>> import argparse\n" +">>> parser = argparse.ArgumentParser()\n" +">>> parser.add_argument('--foo', action=argparse.BooleanOptionalAction)\n" +">>> parser.parse_args(['--no-foo'])\n" +"Namespace(foo=False)" +msgstr "" +">>> import argparse\n" +">>> parser = argparse.ArgumentParser()\n" +">>> parser.add_argument('--foo', action=argparse.BooleanOptionalAction)\n" +">>> parser.parse_args(['--no-foo'])\n" +"Namespace(foo=False)" + msgid "The parse_args() method" msgstr "" @@ -1696,13 +1743,13 @@ msgid "" msgstr "" msgid "" -"args_ - List of strings to parse. The default is taken from :data:`sys." -"argv`." +"args_ - List of strings to parse. The default is taken " +"from :data:`sys.argv`." msgstr "" msgid "" -"namespace_ - An object to take the attributes. The default is a new empty :" -"class:`Namespace` object." +"namespace_ - An object to take the attributes. The default is a new " +"empty :class:`Namespace` object." msgstr "" msgid "Option value syntax" @@ -1786,12 +1833,12 @@ msgid "" ">>> # invalid option\n" ">>> parser.parse_args(['--bar'])\n" "usage: PROG [-h] [--foo FOO] [bar]\n" -"PROG: error: no such option: --bar\n" +"PROG: error: unrecognized arguments: --bar\n" "\n" ">>> # wrong number of arguments\n" ">>> parser.parse_args(['spam', 'badger'])\n" "usage: PROG [-h] [--foo FOO] [bar]\n" -"PROG: error: extra arguments found: badger" +"PROG: error: unrecognized arguments: badger" msgstr "" msgid "Arguments containing ``-``" @@ -1832,7 +1879,7 @@ msgid "" ">>> # negative number options present, so -2 is an option\n" ">>> parser.parse_args(['-2'])\n" "usage: PROG [-h] [-1 ONE] [foo]\n" -"PROG: error: no such option: -2\n" +"PROG: error: unrecognized arguments: -2\n" "\n" ">>> # negative number options present, so both -1s are options\n" ">>> parser.parse_args(['-1', '-1'])\n" @@ -1953,7 +2000,7 @@ msgstr "" msgid "Other utilities" msgstr "" -msgid "Sub-commands" +msgid "Subcommands" msgstr "" msgid "" @@ -1961,13 +2008,14 @@ msgid "" "example, the ``svn`` program can invoke subcommands like ``svn checkout``, " "``svn update``, and ``svn commit``. Splitting up functionality this way can " "be a particularly good idea when a program performs several different " -"functions which require different kinds of command-line arguments. :class:" -"`ArgumentParser` supports the creation of such subcommands with the :meth:`!" -"add_subparsers` method. The :meth:`!add_subparsers` method is normally " -"called with no arguments and returns a special action object. This object " -"has a single method, :meth:`~_SubParsersAction.add_parser`, which takes a " -"command name and any :class:`!ArgumentParser` constructor arguments, and " -"returns an :class:`!ArgumentParser` object that can be modified as usual." +"functions which require different kinds of command-line " +"arguments. :class:`ArgumentParser` supports the creation of such subcommands " +"with the :meth:`!add_subparsers` method. The :meth:`!add_subparsers` method " +"is normally called with no arguments and returns a special action object. " +"This object has a single method, :meth:`~_SubParsersAction.add_parser`, " +"which takes a command name and any :class:`!ArgumentParser` constructor " +"arguments, and returns an :class:`!ArgumentParser` object that can be " +"modified as usual." msgstr "" msgid "Description of parameters:" @@ -1985,7 +2033,7 @@ msgid "" msgstr "" msgid "" -"*prog* - usage information that will be displayed with sub-command help, by " +"*prog* - usage information that will be displayed with subcommand help, by " "default the name of the program and any positional arguments before the " "subparser argument" msgstr "" @@ -2001,8 +2049,8 @@ msgid "" msgstr "" msgid "" -"dest_ - name of the attribute under which sub-command name will be stored; " -"by default ``None`` and no value is stored" +"dest_ - name of the attribute under which subcommand name will be stored; by " +"default ``None`` and no value is stored" msgstr "" msgid "" @@ -2052,6 +2100,13 @@ msgid "" "``baz`` attributes are present." msgstr "" +msgid "" +"If a subparser defines an argument with the same ``dest`` as the parent " +"parser, the two share a single namespace attribute, so the parent's value " +"won't be retained. Users should give them distinct ``dest`` values to keep " +"both." +msgstr "" + msgid "" "Similarly, when a help message is requested from a subparser, only the help " "for that particular parser will be printed. The help message will not " @@ -2205,10 +2260,10 @@ msgstr "" msgid "" "The :class:`FileType` factory creates objects that can be passed to the type " -"argument of :meth:`ArgumentParser.add_argument`. Arguments that have :class:" -"`FileType` objects as their type will open command-line arguments as files " -"with the requested modes, buffer sizes, encodings and error handling (see " -"the :func:`open` function for more details)::" +"argument of :meth:`ArgumentParser.add_argument`. Arguments that " +"have :class:`FileType` objects as their type will open command-line " +"arguments as files with the requested modes, buffer sizes, encodings and " +"error handling (see the :func:`open` function for more details)::" msgstr "" msgid "" @@ -2238,7 +2293,7 @@ msgstr "" ">>> parser.parse_args(['-'])\n" "Namespace(infile=<_io.TextIOWrapper name='' encoding='UTF-8'>)" -msgid "Added the *encodings* and *errors* parameters." +msgid "Added the *encoding* and *errors* parameters." msgstr "" msgid "Argument groups" @@ -2267,12 +2322,12 @@ msgstr "" msgid "" "The :meth:`add_argument_group` method returns an argument group object which " -"has an :meth:`~ArgumentParser.add_argument` method just like a regular :" -"class:`ArgumentParser`. When an argument is added to the group, the parser " -"treats it just like a normal argument, but displays the argument in a " -"separate group for help messages. The :meth:`!add_argument_group` method " -"accepts *title* and *description* arguments which can be used to customize " -"this display::" +"has an :meth:`~ArgumentParser.add_argument` method just like a " +"regular :class:`ArgumentParser`. When an argument is added to the group, " +"the parser treats it just like a normal argument, but displays the argument " +"in a separate group for help messages. The :meth:`!add_argument_group` " +"method accepts *title* and *description* arguments which can be used to " +"customize this display::" msgstr "" msgid "" @@ -2298,9 +2353,9 @@ msgstr "" msgid "" "The optional, keyword-only parameters argument_default_ and " "conflict_handler_ allow for finer-grained control of the behavior of the " -"argument group. These parameters have the same meaning as in the :class:" -"`ArgumentParser` constructor, but apply specifically to the argument group " -"rather than the entire parser." +"argument group. These parameters have the same meaning as in " +"the :class:`ArgumentParser` constructor, but apply specifically to the " +"argument group rather than the entire parser." msgstr "" msgid "" @@ -2308,6 +2363,11 @@ msgid "" "the usual \"positional arguments\" and \"optional arguments\" sections." msgstr "" +msgid "" +"Within each argument group, arguments are displayed in help output in the " +"order in which they are added." +msgstr "" + msgid "" "Calling :meth:`add_argument_group` on an argument group is deprecated. This " "feature was never supported and does not always work correctly. The function " @@ -2356,9 +2416,10 @@ msgstr "" msgid "" "Note that currently mutually exclusive argument groups do not support the " -"*title* and *description* arguments of :meth:`~ArgumentParser." -"add_argument_group`. However, a mutually exclusive group can be added to an " -"argument group that has a title and description. For example::" +"*title* and *description* arguments " +"of :meth:`~ArgumentParser.add_argument_group`. However, a mutually exclusive " +"group can be added to an argument group that has a title and description. " +"For example::" msgstr "" msgid "" @@ -2391,9 +2452,9 @@ msgid "Parser defaults" msgstr "" msgid "" -"Most of the time, the attributes of the object returned by :meth:" -"`parse_args` will be fully determined by inspecting the command-line " -"arguments and the argument actions. :meth:`set_defaults` allows some " +"Most of the time, the attributes of the object returned " +"by :meth:`parse_args` will be fully determined by inspecting the command-" +"line arguments and the argument actions. :meth:`set_defaults` allows some " "additional attributes that are determined without any inspection of the " "command line to be added::" msgstr "" @@ -2407,7 +2468,10 @@ msgid "" msgstr "" msgid "" -"Note that parser-level defaults always override argument-level defaults::" +"Note that defaults can be set at both the parser level " +"using :meth:`set_defaults` and at the argument level " +"using :meth:`add_argument`. If both are called for the same argument, the " +"last default set for an argument is used::" msgstr "" msgid "" @@ -2430,8 +2494,9 @@ msgid "" msgstr "" msgid "" -"Get the default value for a namespace attribute, as set by either :meth:" -"`~ArgumentParser.add_argument` or by :meth:`~ArgumentParser.set_defaults`::" +"Get the default value for a namespace attribute, as set by " +"either :meth:`~ArgumentParser.add_argument` or " +"by :meth:`~ArgumentParser.set_defaults`::" msgstr "" msgid "" @@ -2472,8 +2537,8 @@ msgid "" msgstr "" msgid "" -"Return a string containing a brief description of how the :class:" -"`ArgumentParser` should be invoked on the command line." +"Return a string containing a brief description of how " +"the :class:`ArgumentParser` should be invoked on the command line." msgstr "" msgid "" @@ -2485,13 +2550,17 @@ msgid "Partial parsing" msgstr "" msgid "" -"Sometimes a script may only parse a few of the command-line arguments, " -"passing the remaining arguments on to another script or program. In these " -"cases, the :meth:`~ArgumentParser.parse_known_args` method can be useful. " -"It works much like :meth:`~ArgumentParser.parse_args` except that it does " -"not produce an error when extra arguments are present. Instead, it returns " -"a two item tuple containing the populated namespace and the list of " -"remaining argument strings." +"Sometimes a script only needs to handle a specific set of command-line " +"arguments, leaving any unrecognized arguments for another script or program. " +"In these cases, the :meth:`~ArgumentParser.parse_known_args` method can be " +"useful." +msgstr "" + +msgid "" +"This method works similarly to :meth:`~ArgumentParser.parse_args`, but it " +"does not raise an error for extra, unrecognized arguments. Instead, it " +"parses the known arguments and returns a two item tuple that contains the " +"populated namespace and the list of any unrecognized arguments." msgstr "" msgid "" @@ -2503,10 +2572,10 @@ msgid "" msgstr "" msgid "" -":ref:`Prefix matching ` rules apply to :meth:" -"`~ArgumentParser.parse_known_args`. The parser may consume an option even if " -"it's just a prefix of one of its known options, instead of leaving it in the " -"remaining arguments list." +":ref:`Prefix matching ` rules apply " +"to :meth:`~ArgumentParser.parse_known_args`. The parser may consume an " +"option even if it's just a prefix of one of its known options, instead of " +"leaving it in the remaining arguments list." msgstr "" msgid "Customizing file parsing" @@ -2536,6 +2605,11 @@ msgid "" " return arg_line.split()" msgstr "" +msgid "" +"Note that with this override an argument can no longer contain spaces, since " +"each space-separated word becomes a separate argument." +msgstr "" + msgid "Exiting methods" msgstr "" @@ -2554,8 +2628,8 @@ msgid "" msgstr "" msgid "" -"This method prints a usage message, including the *message*, to :data:`sys." -"stderr` and terminates the program with a status code of 2." +"This method prints a usage message, including the *message*, " +"to :data:`sys.stderr` and terminates the program with a status code of 2." msgstr "" msgid "Intermixed parsing" @@ -2576,10 +2650,11 @@ msgid "" msgstr "" msgid "" -"The following example shows the difference between :meth:`~ArgumentParser." -"parse_known_args` and :meth:`~ArgumentParser.parse_intermixed_args`: the " -"former returns ``['2', '3']`` as unparsed arguments, while the latter " -"collects all the positionals into ``rest``. ::" +"The following example shows the difference " +"between :meth:`~ArgumentParser.parse_known_args` " +"and :meth:`~ArgumentParser.parse_intermixed_args`: the former returns " +"``['2', '3']`` as unparsed arguments, while the latter collects all the " +"positionals into ``rest``. ::" msgstr "" msgid "" @@ -2652,7 +2727,7 @@ msgid "" msgstr "" msgid "Guides and Tutorials" -msgstr "" +msgstr "Przewodniki i samouczki" msgid "? (question mark)" msgstr "" diff --git a/library/array.po b/library/array.po index 243814d7c9..c11893e260 100644 --- a/library/array.po +++ b/library/array.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,10 +29,10 @@ msgstr "" msgid "" "This module defines an object type which can compactly represent an array of " "basic values: characters, integers, floating-point numbers. Arrays are " -"sequence types and behave very much like lists, except that the type of " -"objects stored in them is constrained. The type is specified at object " -"creation time by using a :dfn:`type code`, which is a single character. The " -"following type codes are defined:" +"mutable :term:`sequence` types and behave very much like lists, except that " +"the type of objects stored in them is constrained. The type is specified at " +"object creation time by using a :dfn:`type code`, which is a single " +"character. The following type codes are defined:" msgstr "" msgid "Type code" @@ -93,6 +92,9 @@ msgstr "" msgid "4" msgstr "4" +msgid "\\(2)" +msgstr "\\(2)" + msgid "``'h'``" msgstr "``'h'``" @@ -188,9 +190,9 @@ msgstr "Moduł definiuje następujący typ:" msgid "" "A new array whose items are restricted by *typecode*, and initialized from " -"the optional *initializer* value, which must be a :class:`bytes` or :class:" -"`bytearray` object, a Unicode string, or iterable over elements of the " -"appropriate type." +"the optional *initializer* value, which must be a :class:`bytes` " +"or :class:`bytearray` object, a Unicode string, or iterable over elements of " +"the appropriate type." msgstr "" msgid "" @@ -202,14 +204,18 @@ msgid "" msgstr "" msgid "" -"Array objects support the ordinary sequence operations of indexing, slicing, " -"concatenation, and multiplication. When using slice assignment, the " -"assigned value must be an array object with the same type code; in all other " +"Array objects support the ordinary :ref:`mutable ` :term:`sequence` operations of indexing, slicing, concatenation, " +"and multiplication. When using slice assignment, the assigned value must be " +"an array object with the same type code; in all other " "cases, :exc:`TypeError` is raised. Array objects also implement the buffer " "interface, and may be used wherever :term:`bytes-like objects ` are supported." msgstr "" +msgid "Arrays are :ref:`generic ` over the type of their contents." +msgstr "" + msgid "" "Raises an :ref:`auditing event ` ``array.__new__`` with arguments " "``typecode``, ``initializer``." @@ -223,8 +229,8 @@ msgstr "" "długość w bajtach (kęsach) jednego elementu tabeli w wewnętrznym " "przedstawieniu." -msgid "Append a new item with value *x* to the end of the array." -msgstr "Dodaj nowy element o wartości *x* na koniec tabeli." +msgid "Append a new item with the specified value to the end of the array." +msgstr "" msgid "" "Return a tuple ``(address, length)`` giving the current memory address and " @@ -253,23 +259,24 @@ msgstr "" msgid "" "\"Byteswap\" all items of the array. This is only supported for values " -"which are 1, 2, 4, or 8 bytes in size; for other types of values, :exc:" -"`RuntimeError` is raised. It is useful when reading data from a file " -"written on a machine with a different byte order." +"which are 1, 2, 4, or 8 bytes in size; for other types of " +"values, :exc:`RuntimeError` is raised. It is useful when reading data from " +"a file written on a machine with a different byte order." msgstr "" "Zmienia kolejność bajtów wszystkich elementów tablicy. Wspierane tylko dla " "wartości których rozmiar to 1, 2, 4, lub 8 bajtów; dla innych typów wartości " "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." +msgid "Return the number of occurrences of *value* in the array." +msgstr "" msgid "" "Append items from *iterable* to the end of the array. If *iterable* is " -"another array, it must have *exactly* the same type code; if not, :exc:" -"`TypeError` will be raised. If *iterable* is not an array, it must be " -"iterable and its elements must be the right type to be appended to the array." +"another array, it must have *exactly* the same type code; if " +"not, :exc:`TypeError` will be raised. If *iterable* is not an array, it " +"must be iterable and its elements must be the right type to be appended to " +"the array." msgstr "" "Przyklej elementy z przedmiotu *iterowalnego* na koniec tablicy. Jeśli " "*iterowalny* jest kolejną tablicą, musi mieć *dokładnie* ten sam typ kodu; " @@ -279,8 +286,8 @@ msgstr "" msgid "" "Appends items from the :term:`bytes-like object`, interpreting its content " -"as an array of machine values (as if it had been read from a file using the :" -"meth:`fromfile` method)." +"as an array of machine values (as if it had been read from a file using " +"the :meth:`fromfile` method)." msgstr "" msgid ":meth:`!fromstring` is renamed to :meth:`frombytes` for clarity." @@ -288,14 +295,14 @@ msgstr "" msgid "" "Read *n* items (as machine values) from the :term:`file object` *f* and " -"append them to the end of the array. If less than *n* items are available, :" -"exc:`EOFError` is raised, but the items that were available are still " -"inserted into the array." +"append them to the end of the array. If less than *n* items are " +"available, :exc:`EOFError` is raised, but the items that were available are " +"still inserted into the array." msgstr "" msgid "" -"Append items from the list. This is equivalent to ``for x in list: a." -"append(x)`` except that if there is a type error, the array is unchanged." +"Append items from the list. This is equivalent to ``for x in list: " +"a.append(x)`` except that if there is a type error, the array is unchanged." msgstr "" "Doklej elementy z listy. To jest równoważne z ``for x in list: a.append(x)`` " "z wyjątkiem tego, że jeśli wystąpi błąd typu, tablica pozostanie " @@ -310,20 +317,18 @@ msgstr "" msgid "" "Return the smallest *i* such that *i* is the index of the first occurrence " -"of *x* in the array. The optional arguments *start* and *stop* can be " -"specified to search for *x* within a subsection of the array. Raise :exc:" -"`ValueError` if *x* is not found." +"of *value* in the array. The optional arguments *start* and *stop* can be " +"specified to search for *value* within a subsection of the array. " +"Raise :exc:`ValueError` if *value* is not found." msgstr "" msgid "Added optional *start* and *stop* parameters." msgstr "" msgid "" -"Insert a new item with value *x* in the array before position *i*. Negative " +"Insert a new item *value* in the array before position *index*. Negative " "values are treated as being relative to the end of the array." msgstr "" -"Wstaw nowy element o wartości *x* w tabeli przed pozycją *i*. Ujemne " -"wartości są traktowane jako będące odniesieniem do pozycji od końca tabeli." msgid "" "Removes the item with the index *i* from the array and returns it. The " @@ -334,8 +339,8 @@ msgstr "" "domyślnie jest ``-1``, tak aby domyślnie ostatni element był usuwany i " "zwracany." -msgid "Remove the first occurrence of *x* from the array." -msgstr "Usuń pierwsze wystąpienie *x* w tabeli." +msgid "Remove the first occurrence of *value* from the array." +msgstr "" msgid "Remove all elements from the array." msgstr "" @@ -360,8 +365,9 @@ msgstr "Zamień tabelę na zwykłą listę o tych samych elementach." msgid "" "Convert the array to a Unicode string. The array must have a type ``'u'`` " -"or ``'w'``; otherwise a :exc:`ValueError` is raised. Use ``array.tobytes()." -"decode(enc)`` to obtain a Unicode string from an array of some other type." +"or ``'w'``; otherwise a :exc:`ValueError` is raised. Use " +"``array.tobytes().decode(enc)`` to obtain a Unicode string from an array of " +"some other type." msgstr "" msgid "" diff --git a/library/ast.po b/library/ast.po index e8ad2216f5..9779f9b4f2 100644 --- a/library/ast.po +++ b/library/ast.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,12 +37,12 @@ msgid "" msgstr "" msgid "" -"An abstract syntax tree can be generated by passing :data:`ast." -"PyCF_ONLY_AST` as a flag to the :func:`compile` built-in function, or using " -"the :func:`parse` helper provided in this module. The result will be a tree " -"of objects whose classes all inherit from :class:`ast.AST`. An abstract " -"syntax tree can be compiled into a Python code object using the built-in :" -"func:`compile` function." +"An abstract syntax tree can be generated by " +"passing :data:`ast.PyCF_ONLY_AST` as a flag to the :func:`compile` built-in " +"function, or using the :func:`parse` helper provided in this module. The " +"result will be a tree of objects whose classes all inherit " +"from :class:`ast.AST`. An abstract syntax tree can be compiled into a " +"Python code object using the built-in :func:`compile` function." msgstr "" msgid "Abstract Grammar" @@ -230,9 +229,9 @@ msgstr "" msgid "" "This is the base of all AST node classes. The actual node classes are " -"derived from the :file:`Parser/Python.asdl` file, which is reproduced :ref:" -"`above `. They are defined in the :mod:`!_ast` C module " -"and re-exported in :mod:`ast`." +"derived from the :file:`Parser/Python.asdl` file, which is " +"reproduced :ref:`above `. They are defined in the :mod:`!" +"_ast` C module and re-exported in :mod:`ast`." msgstr "" msgid "" @@ -279,14 +278,14 @@ msgstr "" "| None}" msgid "" -"Instances of :class:`ast.expr` and :class:`ast.stmt` subclasses have :attr:" -"`lineno`, :attr:`col_offset`, :attr:`end_lineno`, and :attr:`end_col_offset` " -"attributes. The :attr:`lineno` and :attr:`end_lineno` are the first and " -"last line numbers of source text span (1-indexed so the first line is line " -"1) and the :attr:`col_offset` and :attr:`end_col_offset` are the " -"corresponding UTF-8 byte offsets of the first and last tokens that generated " -"the node. The UTF-8 offset is recorded because the parser uses UTF-8 " -"internally." +"Instances of :class:`ast.expr` and :class:`ast.stmt` subclasses " +"have :attr:`lineno`, :attr:`col_offset`, :attr:`end_lineno`, " +"and :attr:`end_col_offset` attributes. The :attr:`lineno` " +"and :attr:`end_lineno` are the first and last line numbers of source text " +"span (1-indexed so the first line is line 1) and the :attr:`col_offset` " +"and :attr:`end_col_offset` are the corresponding UTF-8 byte offsets of the " +"first and last tokens that generated the node. The UTF-8 offset is recorded " +"because the parser uses UTF-8 internally." msgstr "" msgid "" @@ -324,8 +323,8 @@ msgid "" "If a field that is optional in the grammar is omitted from the constructor, " "it defaults to ``None``. If a list field is omitted, it defaults to the " "empty list. If a field of type :class:`!ast.expr_context` is omitted, it " -"defaults to :class:`Load() `. If any other field is omitted, a :" -"exc:`DeprecationWarning` is raised and the AST node will not have this " +"defaults to :class:`Load() `. If any other field is omitted, " +"a :exc:`DeprecationWarning` is raised and the AST node will not have this " "field. In Python 3.15, this condition will raise an error." msgstr "" @@ -338,10 +337,18 @@ msgid "" msgstr "" msgid "" -"Old classes :class:`!ast.Num`, :class:`!ast.Str`, :class:`!ast.Bytes`, :" -"class:`!ast.NameConstant` and :class:`!ast.Ellipsis` are still available, " -"but they will be removed in future Python releases. In the meantime, " -"instantiating them will return an instance of a different class." +"AST node constructors were changed to provide sensible defaults for omitted " +"fields: optional fields now default to ``None``, list fields default to an " +"empty list, and fields of type :class:`!ast.expr_context` default " +"to :class:`Load() `. Previously, omitted attributes would not " +"exist on constructed nodes (accessing them raised :exc:`AttributeError`)." +msgstr "" + +msgid "" +"Old classes :class:`!ast.Num`, :class:`!ast.Str`, :class:`!" +"ast.Bytes`, :class:`!ast.NameConstant` and :class:`!ast.Ellipsis` are still " +"available, but they will be removed in future Python releases. In the " +"meantime, instantiating them will return an instance of a different class." msgstr "" msgid "" @@ -360,8 +367,9 @@ msgstr "" msgid "" "The descriptions of the specific node classes displayed here were initially " -"adapted from the fantastic `Green Tree Snakes `__ project and all its contributors." +"adapted from the fantastic `Green Tree Snakes `__ project and all its " +"contributors." msgstr "" msgid "Root nodes" @@ -479,9 +487,24 @@ msgstr "" msgid "" "A constant value. The ``value`` attribute of the ``Constant`` literal " "contains the Python object it represents. The values represented can be " -"simple types such as a number, string or ``None``, but also immutable " -"container types (tuples and frozensets) if all of their elements are " -"constant." +"instances " +"of :class:`str`, :class:`bytes`, :class:`int`, :class:`float`, :class:`complex`, " +"and :class:`bool`, and the constants :data:`None` and :data:`Ellipsis`." +msgstr "" + +msgid "" +"The ``kind`` attribute is an optional string. For string literals with a " +"``u`` prefix, ``kind`` is set to ``'u'``. For all other constants, ``kind`` " +"is ``None``." +msgstr "" + +msgid "" +">>> print(ast.dump(ast.parse('123', mode='eval'), indent=4))\n" +"Expression(\n" +" body=Constant(value=123))\n" +">>> print(ast.dump(ast.parse(\"u'hello'\", mode='eval'), indent=4))\n" +"Expression(\n" +" body=Constant(value='hello', kind='u'))" msgstr "" msgid "" @@ -517,8 +540,8 @@ msgid "" msgstr "" msgid "" -"An f-string, comprising a series of :class:`FormattedValue` and :class:" -"`Constant` nodes." +"An f-string, comprising a series of :class:`FormattedValue` " +"and :class:`Constant` nodes." msgstr "" msgid "" @@ -650,9 +673,9 @@ msgid "" msgstr "" msgid "" -"A ``*var`` variable reference. ``value`` holds the variable, typically a :" -"class:`Name` node. This type must be used when building a :class:`Call` node " -"with ``*args``." +"A ``*var`` variable reference. ``value`` holds the variable, typically " +"a :class:`Name` node. This type must be used when building a :class:`Call` " +"node with ``*args``." msgstr "" msgid "" @@ -677,9 +700,9 @@ msgstr "" msgid "" "When an expression, such as a function call, appears as a statement by " "itself with its return value not used or stored, it is wrapped in this " -"container. ``value`` holds one of the other nodes in this section, a :class:" -"`Constant`, a :class:`Name`, a :class:`Lambda`, a :class:`Yield` or :class:" -"`YieldFrom` node." +"container. ``value`` holds one of the other nodes in this section, " +"a :class:`Constant`, a :class:`Name`, a :class:`Lambda`, a :class:`Yield` " +"or :class:`YieldFrom` node." msgstr "" msgid "" @@ -791,8 +814,8 @@ msgid "Comparison operator tokens." msgstr "" msgid "" -"A function call. ``func`` is the function, which will often be a :class:" -"`Name` or :class:`Attribute` object. Of the arguments:" +"A function call. ``func`` is the function, which will often be " +"a :class:`Name` or :class:`Attribute` object. Of the arguments:" msgstr "" msgid "``args`` holds a list of the arguments passed by position." @@ -847,10 +870,10 @@ msgid "" msgstr "" msgid "" -"Attribute access, e.g. ``d.keys``. ``value`` is a node, typically a :class:" -"`Name`. ``attr`` is a bare string giving the name of the attribute, and " -"``ctx`` is :class:`Load`, :class:`Store` or :class:`Del` according to how " -"the attribute is acted on." +"Attribute access, e.g. ``d.keys``. ``value`` is a node, typically " +"a :class:`Name`. ``attr`` is a bare string giving the name of the attribute, " +"and ``ctx`` is :class:`Load`, :class:`Store` or :class:`Del` according to " +"how the attribute is acted on." msgstr "" msgid "" @@ -870,9 +893,9 @@ msgstr "" msgid "" "A named expression. This AST node is produced by the assignment expressions " -"operator (also known as the walrus operator). As opposed to the :class:" -"`Assign` node in which the first argument can be multiple nodes, in this " -"case both ``target`` and ``value`` must be single nodes." +"operator (also known as the walrus operator). As opposed to " +"the :class:`Assign` node in which the first argument can be multiple nodes, " +"in this case both ``target`` and ``value`` must be single nodes." msgstr "" msgid "" @@ -893,9 +916,10 @@ msgstr "" msgid "" "A subscript, such as ``l[1]``. ``value`` is the subscripted object (usually " -"sequence or mapping). ``slice`` is an index, slice or key. It can be a :" -"class:`Tuple` and contain a :class:`Slice`. ``ctx`` is :class:`Load`, :class:" -"`Store` or :class:`Del` according to the action performed with the subscript." +"sequence or mapping). ``slice`` is an index, slice or key. It can be " +"a :class:`Tuple` and contain a :class:`Slice`. ``ctx`` " +"is :class:`Load`, :class:`Store` or :class:`Del` according to the action " +"performed with the subscript." msgstr "" msgid "" @@ -1109,16 +1133,16 @@ msgstr "" msgid "" "An assignment with a type annotation. ``target`` is a single node and can be " "a :class:`Name`, an :class:`Attribute` or a :class:`Subscript`. " -"``annotation`` is the annotation, such as a :class:`Constant` or :class:" -"`Name` node. ``value`` is a single optional node." +"``annotation`` is the annotation, such as a :class:`Constant` " +"or :class:`Name` node. ``value`` is a single optional node." msgstr "" msgid "" "``simple`` is always either 0 (indicating a \"complex\" target) or 1 " -"(indicating a \"simple\" target). A \"simple\" target consists solely of a :" -"class:`Name` node that does not appear between parentheses; all other " -"targets are considered complex. Only simple targets appear in the :attr:" -"`~object.__annotations__` dictionary of modules and classes." +"(indicating a \"simple\" target). A \"simple\" target consists solely of " +"a :class:`Name` node that does not appear between parentheses; all other " +"targets are considered complex. Only simple targets appear in " +"the :attr:`~object.__annotations__` dictionary of modules and classes." msgstr "" msgid "" @@ -1235,8 +1259,8 @@ msgstr "" " msg=Name(id='y', ctx=Load()))])" msgid "" -"Represents a ``del`` statement. ``targets`` is a list of nodes, such as :" -"class:`Name`, :class:`Attribute` or :class:`Subscript` nodes." +"Represents a ``del`` statement. ``targets`` is a list of nodes, such " +"as :class:`Name`, :class:`Attribute` or :class:`Subscript` nodes." msgstr "" msgid "" @@ -1266,9 +1290,9 @@ msgstr "" msgid "" "A :ref:`type alias ` created through the :keyword:`type` " -"statement. ``name`` is the name of the alias, ``type_params`` is a list of :" -"ref:`type parameters `, and ``value`` is the value of the " -"type alias." +"statement. ``name`` is the name of the alias, ``type_params`` is a list " +"of :ref:`type parameters `, and ``value`` is the value of " +"the type alias." msgstr "" msgid "" @@ -1362,8 +1386,8 @@ msgid "" msgstr "" msgid "" -"An ``if`` statement. ``test`` holds a single node, such as a :class:" -"`Compare` node. ``body`` and ``orelse`` each hold a list of nodes." +"An ``if`` statement. ``test`` holds a single node, such as " +"a :class:`Compare` node. ``body`` and ``orelse`` each hold a list of nodes." msgstr "" msgid "" @@ -1401,9 +1425,9 @@ msgstr "" msgid "" "A ``for`` loop. ``target`` holds the variable(s) the loop assigns to, as a " -"single :class:`Name`, :class:`Tuple`, :class:`List`, :class:`Attribute` or :" -"class:`Subscript` node. ``iter`` holds the item to be looped over, again as " -"a single node. ``body`` and ``orelse`` contain lists of nodes to execute. " +"single :class:`Name`, :class:`Tuple`, :class:`List`, :class:`Attribute` " +"or :class:`Subscript` node. ``iter`` holds the item to be looped over, again " +"as a single node. ``body`` and ``orelse`` contain lists of nodes to execute. " "Those in ``orelse`` are executed if the loop finishes normally, rather than " "via a ``break`` statement." msgstr "" @@ -1530,7 +1554,7 @@ msgstr "" msgid "" "``try`` blocks which are followed by ``except*`` clauses. The attributes are " "the same as for :class:`Try` but the :class:`ExceptHandler` nodes in " -"``handlers`` are interpreted as ``except*`` blocks rather then ``except``." +"``handlers`` are interpreted as ``except*`` blocks rather than ``except``." msgstr "" msgid "" @@ -1592,9 +1616,9 @@ msgstr "" msgid "" "A single context manager in a ``with`` block. ``context_expr`` is the " -"context manager, often a :class:`Call` node. ``optional_vars`` is a :class:" -"`Name`, :class:`Tuple` or :class:`List` for the ``as foo`` part, or ``None`` " -"if that isn't used." +"context manager, often a :class:`Call` node. ``optional_vars`` is " +"a :class:`Name`, :class:`Tuple` or :class:`List` for the ``as foo`` part, or " +"``None`` if that isn't used." msgstr "" msgid "" @@ -1632,8 +1656,8 @@ msgstr "" msgid "" "A single case pattern in a ``match`` statement. ``pattern`` contains the " -"match pattern that the subject will be matched against. Note that the :class:" -"`AST` nodes produced for patterns differ from those produced for " +"match pattern that the subject will be matched against. Note that " +"the :class:`AST` nodes produced for patterns differ from those produced for " "expressions, even when they share the same syntax." msgstr "" @@ -1986,6 +2010,44 @@ msgid "" " value=Constant(value=Ellipsis))])])])" msgstr "" +msgid "Type annotations" +msgstr "" + +msgid "" +"A ``# type: ignore`` comment located at *lineno*. *tag* is the optional tag " +"specified by the form ``# type: ignore ``." +msgstr "" + +msgid "" +">>> print(ast.dump(ast.parse('x = 1 # type: ignore', type_comments=True), " +"indent=4))\n" +"Module(\n" +" body=[\n" +" Assign(\n" +" targets=[\n" +" Name(id='x', ctx=Store())],\n" +" value=Constant(value=1))],\n" +" type_ignores=[\n" +" TypeIgnore(lineno=1, tag='')])\n" +">>> print(ast.dump(ast.parse('x: bool = 1 # type: ignore[assignment]', " +"type_comments=True), indent=4))\n" +"Module(\n" +" body=[\n" +" AnnAssign(\n" +" target=Name(id='x', ctx=Store()),\n" +" annotation=Name(id='bool', ctx=Load()),\n" +" value=Constant(value=1),\n" +" simple=1)],\n" +" type_ignores=[\n" +" TypeIgnore(lineno=1, tag='[assignment]')])" +msgstr "" + +msgid "" +":class:`!TypeIgnore` nodes are not generated when the *type_comments* " +"parameter is set to ``False`` (default). See :func:`ast.parse` for more " +"details." +msgstr "" + msgid "Type parameters" msgstr "" @@ -1996,10 +2058,10 @@ msgstr "" msgid "" "A :class:`typing.TypeVar`. ``name`` is the name of the type variable. " -"``bound`` is the bound or constraints, if any. If ``bound`` is a :class:" -"`Tuple`, it represents constraints; otherwise it represents the bound. " -"``default_value`` is the default value; if the :class:`!TypeVar` has no " -"default, this attribute will be set to ``None``." +"``bound`` is the bound or constraints, if any. If ``bound`` is " +"a :class:`Tuple`, it represents constraints; otherwise it represents the " +"bound. ``default_value`` is the default value; if the :class:`!TypeVar` has " +"no default, this attribute will be set to ``None``." msgstr "" msgid "" @@ -2272,8 +2334,8 @@ msgstr "" msgid "" "``keywords`` is a list of :class:`.keyword` nodes, principally for " -"'metaclass'. Other keywords will be passed to the metaclass, as per :pep:" -"`3115`." +"'metaclass'. Other keywords will be passed to the metaclass, as " +"per :pep:`3115`." msgstr "" msgid "" @@ -2313,8 +2375,8 @@ msgid "Async and await" msgstr "" msgid "" -"An ``async def`` function definition. Has the same fields as :class:" -"`FunctionDef`." +"An ``async def`` function definition. Has the same fields " +"as :class:`FunctionDef`." msgstr "" msgid "" @@ -2346,11 +2408,11 @@ msgid "" msgstr "" msgid "" -"When a string is parsed by :func:`ast.parse`, operator nodes (subclasses of :" -"class:`ast.operator`, :class:`ast.unaryop`, :class:`ast.cmpop`, :class:`ast." -"boolop` and :class:`ast.expr_context`) on the returned tree will be " -"singletons. Changes to one will be reflected in all other occurrences of the " -"same value (e.g. :class:`ast.Add`)." +"When a string is parsed by :func:`ast.parse`, operator nodes (subclasses " +"of :class:`ast.operator`, :class:`ast.unaryop`, :class:`ast.cmpop`, :class:`ast.boolop` " +"and :class:`ast.expr_context`) on the returned tree will be singletons. " +"Changes to one will be reflected in all other occurrences of the same value " +"(e.g. :class:`ast.Add`)." msgstr "" msgid ":mod:`ast` Helpers" @@ -2364,15 +2426,15 @@ msgstr "" msgid "" "Parse the source into an AST node. Equivalent to ``compile(source, " "filename, mode, flags=FLAGS_VALUE, optimize=optimize)``, where " -"``FLAGS_VALUE`` is ``ast.PyCF_ONLY_AST`` if ``optimize <= 0`` and ``ast." -"PyCF_OPTIMIZED_AST`` otherwise." +"``FLAGS_VALUE`` is ``ast.PyCF_ONLY_AST`` if ``optimize <= 0`` and " +"``ast.PyCF_OPTIMIZED_AST`` otherwise." msgstr "" msgid "" "If ``type_comments=True`` is given, the parser is modified to check and " "return type comments as specified by :pep:`484` and :pep:`526`. This is " -"equivalent to adding :data:`ast.PyCF_TYPE_COMMENTS` to the flags passed to :" -"func:`compile`. This will report syntax errors for misplaced type " +"equivalent to adding :data:`ast.PyCF_TYPE_COMMENTS` to the flags passed " +"to :func:`compile`. This will report syntax errors for misplaced type " "comments. Without this flag, type comments will be ignored, and the " "``type_comment`` field on selected AST nodes will always be ``None``. In " "addition, the locations of ``# type: ignore`` comments will be returned as " @@ -2431,8 +2493,8 @@ msgstr "" msgid "" "Unparse an :class:`ast.AST` object and generate a string with code that " -"would produce an equivalent :class:`ast.AST` object if parsed back with :" -"func:`ast.parse`." +"would produce an equivalent :class:`ast.AST` object if parsed back " +"with :func:`ast.parse`." msgstr "" msgid "" @@ -2442,8 +2504,8 @@ msgid "" msgstr "" msgid "" -"Trying to unparse a highly complex expression would result with :exc:" -"`RecursionError`." +"Trying to unparse a highly complex expression would result " +"with :exc:`RecursionError`." msgstr "" msgid "" @@ -2476,8 +2538,9 @@ msgid "" msgstr "" msgid "" -"It can raise :exc:`ValueError`, :exc:`TypeError`, :exc:`SyntaxError`, :exc:" -"`MemoryError` and :exc:`RecursionError` depending on the malformed input." +"It can " +"raise :exc:`ValueError`, :exc:`TypeError`, :exc:`SyntaxError`, :exc:`MemoryError` " +"and :exc:`RecursionError` depending on the malformed input." msgstr "" msgid "Now allows bytes and set literals." @@ -2490,10 +2553,10 @@ msgid "For string inputs, leading spaces and tabs are now stripped." msgstr "" msgid "" -"Return the docstring of the given *node* (which must be a :class:" -"`FunctionDef`, :class:`AsyncFunctionDef`, :class:`ClassDef`, or :class:" -"`Module` node), or ``None`` if it has no docstring. If *clean* is true, " -"clean up the docstring's indentation with :func:`inspect.cleandoc`." +"Return the docstring of the given *node* (which must be " +"a :class:`FunctionDef`, :class:`AsyncFunctionDef`, :class:`ClassDef`, " +"or :class:`Module` node), or ``None`` if it has no docstring. If *clean* is " +"true, clean up the docstring's indentation with :func:`inspect.cleandoc`." msgstr "" msgid ":class:`AsyncFunctionDef` is now supported." @@ -2501,9 +2564,9 @@ msgstr "" msgid "" "Get source code segment of the *source* that generated *node*. If some " -"location information (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.end_lineno`, :" -"attr:`~ast.AST.col_offset`, or :attr:`~ast.AST.end_col_offset`) is missing, " -"return ``None``." +"location information " +"(:attr:`~ast.AST.lineno`, :attr:`~ast.AST.end_lineno`, :attr:`~ast.AST.col_offset`, " +"or :attr:`~ast.AST.end_col_offset`) is missing, return ``None``." msgstr "" msgid "" @@ -2512,12 +2575,12 @@ msgid "" msgstr "" msgid "" -"When you compile a node tree with :func:`compile`, the compiler expects :" -"attr:`~ast.AST.lineno` and :attr:`~ast.AST.col_offset` attributes for every " -"node that supports them. This is rather tedious to fill in for generated " -"nodes, so this helper adds these attributes recursively where not already " -"set, by setting them to the values of the parent node. It works recursively " -"starting at *node*." +"When you compile a node tree with :func:`compile`, the compiler " +"expects :attr:`~ast.AST.lineno` and :attr:`~ast.AST.col_offset` attributes " +"for every node that supports them. This is rather tedious to fill in for " +"generated nodes, so this helper adds these attributes recursively where not " +"already set, by setting them to the values of the parent node. It works " +"recursively starting at *node*." msgstr "" msgid "" @@ -2527,9 +2590,10 @@ msgid "" msgstr "" msgid "" -"Copy source location (:attr:`~ast.AST.lineno`, :attr:`~ast.AST.col_offset`, :" -"attr:`~ast.AST.end_lineno`, and :attr:`~ast.AST.end_col_offset`) from " -"*old_node* to *new_node* if possible, and return *new_node*." +"Copy source location " +"(:attr:`~ast.AST.lineno`, :attr:`~ast.AST.col_offset`, :attr:`~ast.AST.end_lineno`, " +"and :attr:`~ast.AST.end_col_offset`) from *old_node* to *new_node* if " +"possible, and return *new_node*." msgstr "" msgid "" @@ -2560,9 +2624,9 @@ msgid "" msgstr "" msgid "" -"Visit a node. The default implementation calls the method called :samp:" -"`self.visit_{classname}` where *classname* is the name of the node class, " -"or :meth:`generic_visit` if that method doesn't exist." +"Visit a node. The default implementation calls the method " +"called :samp:`self.visit_{classname}` where *classname* is the name of the " +"node class, or :meth:`generic_visit` if that method doesn't exist." msgstr "" msgid "This visitor calls :meth:`visit` on all children of the node." @@ -2578,15 +2642,15 @@ msgstr "" msgid "" "Don't use the :class:`NodeVisitor` if you want to apply changes to nodes " -"during traversal. For this a special visitor exists (:class:" -"`NodeTransformer`) that allows modifications." +"during traversal. For this a special visitor exists " +"(:class:`NodeTransformer`) that allows modifications." msgstr "" msgid "" -"Methods :meth:`!visit_Num`, :meth:`!visit_Str`, :meth:`!visit_Bytes`, :meth:" -"`!visit_NameConstant` and :meth:`!visit_Ellipsis` are deprecated now and " -"will not be called in future Python versions. Add the :meth:" -"`visit_Constant` method to handle all constant nodes." +"Methods :meth:`!visit_Num`, :meth:`!visit_Str`, :meth:`!" +"visit_Bytes`, :meth:`!visit_NameConstant` and :meth:`!visit_Ellipsis` are " +"deprecated now and will not be called in future Python versions. Add " +"the :meth:`visit_Constant` method to handle all constant nodes." msgstr "" msgid "" @@ -2620,8 +2684,8 @@ msgstr "" msgid "" "Keep in mind that if the node you're operating on has child nodes you must " -"either transform the child nodes yourself or call the :meth:`~ast." -"NodeVisitor.generic_visit` method for the node first." +"either transform the child nodes yourself or call " +"the :meth:`~ast.NodeVisitor.generic_visit` method for the node first." msgstr "" msgid "" @@ -2632,9 +2696,9 @@ msgstr "" msgid "" "If :class:`NodeTransformer` introduces new nodes (that weren't part of " -"original tree) without giving them location information (such as :attr:`~ast." -"AST.lineno`), :func:`fix_missing_locations` should be called with the new " -"sub-tree to recalculate the location information::" +"original tree) without giving them location information (such " +"as :attr:`~ast.AST.lineno`), :func:`fix_missing_locations` should be called " +"with the new sub-tree to recalculate the location information::" msgstr "" msgid "" @@ -2668,8 +2732,8 @@ msgid "" msgstr "" msgid "" -"If *show_empty* is ``False`` (the default), empty lists and fields that are " -"``None`` will be omitted from the output." +"If *show_empty* is false (the default), optional empty lists will be omitted " +"from the output. Optional ``None`` values are always omitted." msgstr "" msgid "Added the *indent* option." @@ -2724,8 +2788,8 @@ msgid "" msgstr "" msgid "" -"The returned AST is optimized according to the *optimize* argument in :func:" -"`compile` or :func:`ast.parse`." +"The returned AST is optimized according to the *optimize* argument " +"in :func:`compile` or :func:`ast.parse`." msgstr "" msgid "" @@ -2751,8 +2815,8 @@ msgid "Show the help message and exit." msgstr "" msgid "" -"Specify what kind of code must be compiled, like the *mode* argument in :" -"func:`parse`." +"Specify what kind of code must be compiled, like the *mode* argument " +"in :func:`parse`." msgstr "" msgid "Don't parse type comments." diff --git a/library/asyncio-api-index.po b/library/asyncio-api-index.po index 3a74be50bf..43fccb6a4b 100644 --- a/library/asyncio-api-index.po +++ b/library/asyncio-api-index.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/library/asyncio-dev.po b/library/asyncio-dev.po index 62619f1133..f56f8800b0 100644 --- a/library/asyncio-dev.po +++ b/library/asyncio-dev.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -62,9 +62,9 @@ msgid "In addition to enabling the debug mode, consider also:" msgstr "" msgid "" -"setting the log level of the :ref:`asyncio logger ` to :py:" -"const:`logging.DEBUG`, for example the following snippet of code can be run " -"at startup of the application::" +"setting the log level of the :ref:`asyncio logger ` " +"to :py:const:`logging.DEBUG`, for example the following snippet of code can " +"be run at startup of the application::" msgstr "" msgid "logging.basicConfig(level=logging.DEBUG)" @@ -80,15 +80,9 @@ 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." +"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 "" @@ -97,9 +91,9 @@ msgid "" msgstr "" msgid "" -"Callbacks taking longer than 100 milliseconds are logged. The :attr:`loop." -"slow_callback_duration` attribute can be used to set the minimum execution " -"duration in seconds that is considered \"slow\"." +"Callbacks taking longer than 100 milliseconds are logged. " +"The :attr:`loop.slow_callback_duration` attribute can be used to set the " +"minimum execution duration in seconds that is considered \"slow\"." msgstr "" msgid "Concurrency and Multithreading" @@ -114,8 +108,8 @@ msgid "" msgstr "" msgid "" -"To schedule a :term:`callback` from another OS thread, the :meth:`loop." -"call_soon_threadsafe` method should be used. Example::" +"To schedule a :term:`callback` from another OS thread, " +"the :meth:`loop.call_soon_threadsafe` method should be used. Example::" msgstr "" msgid "loop.call_soon_threadsafe(callback, *args)" @@ -132,9 +126,9 @@ msgid "loop.call_soon_threadsafe(fut.cancel)" msgstr "" msgid "" -"To schedule a coroutine object from a different OS thread, the :func:" -"`run_coroutine_threadsafe` function should be used. It returns a :class:" -"`concurrent.futures.Future` to access the result::" +"To schedule a coroutine object from a different OS thread, " +"the :func:`run_coroutine_threadsafe` function should be used. It returns " +"a :class:`concurrent.futures.Future` to access the result::" msgstr "" msgid "" @@ -152,21 +146,21 @@ 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." +"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 " +"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 "" @@ -203,8 +197,8 @@ msgstr "" msgid "" "Network logging can block the event loop. It is recommended to use a " -"separate thread for handling logs or use non-blocking IO. For example, see :" -"ref:`blocking-handlers`." +"separate thread for handling logs or use non-blocking IO. For example, " +"see :ref:`blocking-handlers`." msgstr "" msgid "Detect never-awaited coroutines" @@ -212,8 +206,8 @@ msgstr "" msgid "" "When a coroutine function is called, but not awaited (e.g. ``coro()`` " -"instead of ``await coro()``) or the coroutine is not scheduled with :meth:" -"`asyncio.create_task`, asyncio will emit a :exc:`RuntimeWarning`::" +"instead of ``await coro()``) or the coroutine is not scheduled " +"with :meth:`asyncio.create_task`, asyncio will emit a :exc:`RuntimeWarning`::" msgstr "" msgid "" @@ -253,8 +247,8 @@ msgid "" msgstr "" msgid "" -"The usual fix is to either await the coroutine or call the :meth:`asyncio." -"create_task` function::" +"The usual fix is to either await the coroutine or call " +"the :meth:`asyncio.create_task` function::" msgstr "" msgid "" @@ -322,3 +316,265 @@ msgid "" " raise Exception(\"not consumed\")\n" "Exception: not consumed" msgstr "" + +msgid "Asynchronous generators best practices" +msgstr "" + +msgid "" +"Writing correct and efficient asyncio code requires awareness of certain " +"pitfalls. This section outlines essential best practices that can save you " +"hours of debugging." +msgstr "" + +msgid "Close asynchronous generators explicitly" +msgstr "" + +msgid "" +"It is recommended to manually close the :term:`asynchronous generator " +"`. If a generator exits early - for " +"example, due to an exception raised in the body of an ``async for`` loop - " +"its asynchronous cleanup code may run in an unexpected context. This can " +"occur after the tasks it depends on have completed, or during the event loop " +"shutdown when the async-generator's garbage collection hook is called." +msgstr "" + +msgid "" +"To avoid this, explicitly close the generator by calling " +"its :meth:`~agen.aclose` method, or use the :func:`contextlib.aclosing` " +"context manager::" +msgstr "" + +msgid "" +"import asyncio\n" +"import contextlib\n" +"\n" +"async def gen():\n" +" yield 1\n" +" yield 2\n" +"\n" +"async def func():\n" +" async with contextlib.aclosing(gen()) as g:\n" +" async for x in g:\n" +" break # Don't iterate until the end\n" +"\n" +"asyncio.run(func())" +msgstr "" + +msgid "" +"As noted above, the cleanup code for these asynchronous generators is " +"deferred. The following example demonstrates that the finalization of an " +"asynchronous generator can occur in an unexpected order::" +msgstr "" + +msgid "" +"import asyncio\n" +"work_done = False\n" +"\n" +"async def cursor():\n" +" try:\n" +" yield 1\n" +" finally:\n" +" assert work_done\n" +"\n" +"async def rows():\n" +" global work_done\n" +" try:\n" +" yield 2\n" +" finally:\n" +" await asyncio.sleep(0.1) # imitate some async work\n" +" work_done = True\n" +"\n" +"\n" +"async def main():\n" +" async for c in cursor():\n" +" async for r in rows():\n" +" break\n" +" break\n" +"\n" +"asyncio.run(main())" +msgstr "" + +msgid "For this example, we get the following output::" +msgstr "" + +msgid "" +"unhandled exception during asyncio.run() shutdown\n" +"task: ()> exception=AssertionError()>\n" +"Traceback (most recent call last):\n" +" File \"example.py\", line 6, in cursor\n" +" yield 1\n" +"asyncio.exceptions.CancelledError\n" +"\n" +"During handling of the above exception, another exception occurred:\n" +"\n" +"Traceback (most recent call last):\n" +" File \"example.py\", line 8, in cursor\n" +" assert work_done\n" +" ^^^^^^^^^\n" +"AssertionError" +msgstr "" + +msgid "" +"The ``cursor()`` asynchronous generator was finalized before the ``rows`` " +"generator - an unexpected behavior." +msgstr "" + +msgid "" +"The example can be fixed by explicitly closing the ``cursor`` and ``rows`` " +"async-generators::" +msgstr "" + +msgid "" +"async def main():\n" +" async with contextlib.aclosing(cursor()) as cursor_gen:\n" +" async for c in cursor_gen:\n" +" async with contextlib.aclosing(rows()) as rows_gen:\n" +" async for r in rows_gen:\n" +" break\n" +" break" +msgstr "" + +msgid "Create asynchronous generators only when the event loop is running" +msgstr "" + +msgid "" +"It is recommended to create :term:`asynchronous generators ` only after the event loop has been created." +msgstr "" + +msgid "" +"To ensure that asynchronous generators close reliably, the event loop uses " +"the :func:`sys.set_asyncgen_hooks` function to register callback functions. " +"These callbacks update the list of running asynchronous generators to keep " +"it in a consistent state." +msgstr "" + +msgid "" +"When the :meth:`loop.shutdown_asyncgens() ` " +"function is called, the running generators are stopped gracefully and the " +"list is cleared." +msgstr "" + +msgid "" +"The asynchronous generator invokes the corresponding system hook during its " +"first iteration. At the same time, the generator records that the hook has " +"been called and does not call it again." +msgstr "" + +msgid "" +"Therefore, if iteration begins before the event loop is created, the event " +"loop will not be able to add the generator to its list of active generators " +"because the hooks are set after the generator attempts to call them. " +"Consequently, the event loop will not be able to terminate the generator if " +"necessary." +msgstr "" + +msgid "Consider the following example::" +msgstr "" + +msgid "" +"import asyncio\n" +"\n" +"async def agenfn():\n" +" try:\n" +" yield 10\n" +" finally:\n" +" await asyncio.sleep(0)\n" +"\n" +"\n" +"with asyncio.Runner() as runner:\n" +" agen = agenfn()\n" +" print(runner.run(anext(agen)))\n" +" del agen" +msgstr "" + +msgid "" +"10\n" +"Exception ignored while closing generator :\n" +"Traceback (most recent call last):\n" +" File \"example.py\", line 13, in \n" +" del agen\n" +" ^^^^\n" +"RuntimeError: async generator ignored GeneratorExit" +msgstr "" + +msgid "This example can be fixed as follows::" +msgstr "" + +msgid "" +"import asyncio\n" +"\n" +"async def agenfn():\n" +" try:\n" +" yield 10\n" +" finally:\n" +" await asyncio.sleep(0)\n" +"\n" +"async def main():\n" +" agen = agenfn()\n" +" print(await anext(agen))\n" +" del agen\n" +"\n" +"asyncio.run(main())" +msgstr "" + +msgid "Avoid concurrent iteration and closure of the same generator" +msgstr "" + +msgid "" +"Async generators may be reentered while " +"another :meth:`~agen.__anext__` / :meth:`~agen.athrow` / :meth:`~agen.aclose` " +"call is in progress. This may lead to an inconsistent state of the async " +"generator and can cause errors." +msgstr "" + +msgid "Let's consider the following example::" +msgstr "" + +msgid "" +"import asyncio\n" +"\n" +"async def consumer():\n" +" for idx in range(100):\n" +" await asyncio.sleep(0)\n" +" message = yield idx\n" +" print('received', message)\n" +"\n" +"async def amain():\n" +" agenerator = consumer()\n" +" await agenerator.asend(None)\n" +"\n" +" fa = asyncio.create_task(agenerator.asend('A'))\n" +" fb = asyncio.create_task(agenerator.asend('B'))\n" +" await fa\n" +" await fb\n" +"\n" +"asyncio.run(amain())" +msgstr "" + +msgid "" +"received A\n" +"Traceback (most recent call last):\n" +" File \"test.py\", line 38, in \n" +" asyncio.run(amain())\n" +" ~~~~~~~~~~~^^^^^^^^^\n" +" File \"Lib/asyncio/runners.py\", line 204, in run\n" +" return runner.run(main)\n" +" ~~~~~~~~~~^^^^^^\n" +" File \"Lib/asyncio/runners.py\", line 127, in run\n" +" return self._loop.run_until_complete(task)\n" +" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^\n" +" File \"Lib/asyncio/base_events.py\", line 719, in run_until_complete\n" +" return future.result()\n" +" ~~~~~~~~~~~~~^^\n" +" File \"test.py\", line 36, in amain\n" +" await fb\n" +"RuntimeError: anext(): asynchronous generator is already running" +msgstr "" + +msgid "" +"Therefore, it is recommended to avoid using asynchronous generators in " +"parallel tasks or across multiple event loops." +msgstr "" diff --git a/library/asyncio-eventloop.po b/library/asyncio-eventloop.po index 1f900d2589..497db49ef4 100644 --- a/library/asyncio-eventloop.po +++ b/library/asyncio-eventloop.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Krzysztof Abramowicz, 2022 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -26,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 "Event Loop" +msgid "Event loop" msgstr "" msgid "" @@ -124,9 +121,9 @@ msgid "" msgstr "" msgid "" -"The `Callback Handles`_ section documents the :class:`Handle` and :class:" -"`TimerHandle` instances which are returned from scheduling methods such as :" -"meth:`loop.call_soon` and :meth:`loop.call_later`;" +"The `Callback Handles`_ section documents the :class:`Handle` " +"and :class:`TimerHandle` instances which are returned from scheduling " +"methods such as :meth:`loop.call_soon` and :meth:`loop.call_later`;" msgstr "" msgid "" @@ -135,15 +132,15 @@ msgid "" msgstr "" msgid "" -"The `Event Loop Implementations`_ section documents the :class:" -"`SelectorEventLoop` and :class:`ProactorEventLoop` classes;" +"The `Event Loop Implementations`_ section documents " +"the :class:`SelectorEventLoop` and :class:`ProactorEventLoop` classes;" msgstr "" msgid "" "The `Examples`_ section showcases how to work with some event loop APIs." msgstr "" -msgid "Event Loop Methods" +msgid "Event loop methods" msgstr "" msgid "Event loops have **low-level** APIs for the following:" @@ -234,8 +231,8 @@ msgstr "" msgid "" "Schedule the closure of the default executor and wait for it to join all of " "the threads in the :class:`~concurrent.futures.ThreadPoolExecutor`. Once " -"this method has been called, using the default executor with :meth:`loop." -"run_in_executor` will raise a :exc:`RuntimeError`." +"this method has been called, using the default executor " +"with :meth:`loop.run_in_executor` will raise a :exc:`RuntimeError`." msgstr "" msgid "" @@ -277,9 +274,9 @@ msgid "" msgstr "" msgid "" -"The optional keyword-only *context* argument specifies a custom :class:" -"`contextvars.Context` for the *callback* to run in. Callbacks use the " -"current context when no *context* is provided." +"The optional keyword-only *context* argument specifies a " +"custom :class:`contextvars.Context` for the *callback* to run in. Callbacks " +"use the current context when no *context* is provided." msgstr "" msgid "Unlike :meth:`call_soon_threadsafe`, this method is not thread-safe." @@ -353,14 +350,20 @@ 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`." +"called. Use :func:`functools.partial` :ref:`to pass keyword arguments " +"` to *callback*." msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the *callback* to run in. The current " -"context is used when no *context* is provided." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the *callback* to run in. The " +"current context is used when no *context* is provided." +msgstr "" + +msgid "" +"For performance, callbacks scheduled with :meth:`loop.call_later` may run up " +"to one clock-resolution early (see " +"``time.get_clock_info('monotonic').resolution``)." msgstr "" msgid "" @@ -376,6 +379,12 @@ msgstr "" msgid "This method's behavior is the same as :meth:`call_later`." msgstr "" +msgid "" +"For performance, callbacks scheduled with :meth:`loop.call_at` may run up to " +"one clock-resolution early (see " +"``time.get_clock_info('monotonic').resolution``)." +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. " @@ -395,7 +404,7 @@ msgstr "" msgid "The :func:`asyncio.sleep` function." msgstr "" -msgid "Creating Futures and Tasks" +msgid "Creating futures and tasks" msgstr "" msgid "Create an :class:`asyncio.Future` object attached to the event loop." @@ -408,14 +417,21 @@ msgid "" msgstr "" msgid "" -"Schedule the execution of :ref:`coroutine ` *coro*. Return a :" -"class:`Task` object." +"Schedule the execution of :ref:`coroutine ` *coro*. Return " +"a :class:`Task` object." msgstr "" msgid "" "Third-party event loops can use their own subclass of :class:`Task` for " -"interoperability. In this case, the result type is a subclass of :class:" -"`Task`." +"interoperability. In this case, the result type is a subclass " +"of :class:`Task`." +msgstr "" + +msgid "" +"The full function signature is largely the same as that of the :class:`Task` " +"constructor (or factory) - all of the keyword arguments to this function are " +"passed through to that interface, except *name*, or *context* if it is " +"``None``." msgstr "" msgid "" @@ -424,9 +440,9 @@ msgid "" msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the *coro* to run in. The current context " -"copy is created when no *context* is provided." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the *coro* to run in. The current " +"context copy is created when no *context* is provided." msgstr "" msgid "Added the *name* parameter." @@ -435,6 +451,17 @@ msgstr "" msgid "Added the *context* parameter." msgstr "" +msgid "" +"Added ``kwargs`` which passes on arbitrary extra parameters, including " +"``name`` and ``context``." +msgstr "" + +msgid "" +"Rolled back the change that passes on *name* and *context* (if it is None), " +"while still passing on other arbitrary keyword arguments (to avoid breaking " +"backwards compatibility with 3.13.3)." +msgstr "" + msgid "Set a task factory that will be used by :meth:`loop.create_task`." msgstr "" @@ -446,6 +473,14 @@ msgid "" "return a :class:`asyncio.Task`-compatible object." msgstr "" +msgid "Required that all *kwargs* are passed on to :class:`asyncio.Task`." +msgstr "" + +msgid "" +"*name* is no longer passed to task factories. *context* is no longer passed " +"to task factories if it is ``None``." +msgstr "" + msgid "Return a task factory or ``None`` if the default one is in use." msgstr "" @@ -458,9 +493,9 @@ msgid "" msgstr "" msgid "" -"The socket family can be either :py:const:`~socket.AF_INET` or :py:const:" -"`~socket.AF_INET6` depending on *host* (or the *family* argument, if " -"provided)." +"The socket family can be either :py:const:`~socket.AF_INET` " +"or :py:const:`~socket.AF_INET6` depending on *host* (or the *family* " +"argument, if provided)." msgstr "" msgid "The socket type will be :py:const:`~socket.SOCK_STREAM`." @@ -485,13 +520,13 @@ msgid "" msgstr "" msgid "" -"*protocol_factory* is called without arguments and is expected to return a :" -"ref:`protocol ` instance." +"*protocol_factory* is called without arguments and is expected to return " +"a :ref:`protocol ` instance." msgstr "" msgid "" -"The protocol instance is coupled with the transport by calling its :meth:" -"`~BaseProtocol.connection_made` method." +"The protocol instance is coupled with the transport by calling " +"its :meth:`~BaseProtocol.connection_made` method." msgstr "" msgid "A ``(transport, protocol)`` tuple is returned on success." @@ -507,9 +542,9 @@ msgstr "" msgid "" "*ssl*: if given and not false, a SSL/TLS transport is created (by default a " "plain TCP transport is created). If *ssl* is a :class:`ssl.SSLContext` " -"object, this context is used to create the transport; if *ssl* is :const:" -"`True`, a default context returned from :func:`ssl.create_default_context` " -"is used." +"object, this context is used to create the transport; if *ssl* " +"is :const:`True`, a default context returned " +"from :func:`ssl.create_default_context` is used." msgstr "" msgid ":ref:`SSL/TLS security considerations `" @@ -552,16 +587,16 @@ msgid "" msgstr "" msgid "" -"*sock*, if given, should be an existing, already connected :class:`socket." -"socket` object to be used by the transport. If *sock* is given, none of " -"*host*, *port*, *family*, *proto*, *flags*, *happy_eyeballs_delay*, " -"*interleave* and *local_addr* should be specified." +"*sock*, if given, should be an existing, already " +"connected :class:`socket.socket` object to be used by the transport. If " +"*sock* is given, none of *host*, *port*, *family*, *proto*, *flags*, " +"*happy_eyeballs_delay*, *interleave* and *local_addr* should be specified." msgstr "" msgid "" "The *sock* argument transfers ownership of the socket to the transport " -"created. To close the socket, call the transport's :meth:`~asyncio." -"BaseTransport.close` method." +"created. To close the socket, call the " +"transport's :meth:`~asyncio.BaseTransport.close` method." msgstr "" msgid "" @@ -624,6 +659,11 @@ msgstr "" msgid "*all_errors* was added." msgstr "" +msgid "" +"Raises a ``ValueError`` if ``ssl.check_hostname`` is ``True`` and " +"``server_hostname`` is not supplied." +msgstr "" + msgid "" "The :func:`open_connection` function is a high-level alternative API. It " "returns a pair of (:class:`StreamReader`, :class:`StreamWriter`) that can be " @@ -634,9 +674,10 @@ msgid "Create a datagram connection." msgstr "" msgid "" -"The socket family can be either :py:const:`~socket.AF_INET`, :py:const:" -"`~socket.AF_INET6`, or :py:const:`~socket.AF_UNIX`, depending on *host* (or " -"the *family* argument, if provided)." +"The socket family can be " +"either :py:const:`~socket.AF_INET`, :py:const:`~socket.AF_INET6`, " +"or :py:const:`~socket.AF_UNIX`, depending on *host* (or the *family* " +"argument, if provided)." msgstr "" msgid "The socket type will be :py:const:`~socket.SOCK_DGRAM`." @@ -652,8 +693,14 @@ msgstr "" msgid "" "*local_addr*, if given, is a ``(local_host, local_port)`` tuple used to bind " -"the socket locally. The *local_host* and *local_port* are looked up using :" -"meth:`getaddrinfo`." +"the socket locally. The *local_host* and *local_port* are looked up " +"using :meth:`getaddrinfo`." +msgstr "" + +msgid "" +"On Windows, when using the proactor event loop with ``local_addr=None``, " +"an :exc:`OSError` with :attr:`!errno.WSAEINVAL` will be raised when running " +"it." msgstr "" msgid "" @@ -685,13 +732,14 @@ msgstr "" msgid "" "*sock* can optionally be specified in order to use a preexisting, already " "connected, :class:`socket.socket` object to be used by the transport. If " -"specified, *local_addr* and *remote_addr* should be omitted (must be :const:" -"`None`)." +"specified, *local_addr* and *remote_addr* should be omitted (must " +"be :const:`None`)." msgstr "" msgid "" -"See :ref:`UDP echo client protocol ` and :" -"ref:`UDP echo server protocol ` examples." +"See :ref:`UDP echo client protocol ` " +"and :ref:`UDP echo server protocol ` " +"examples." msgstr "" msgid "" @@ -703,9 +751,10 @@ msgid "Added support for Windows." msgstr "Dodane wsparcie dla Windowsa." msgid "" -"The *reuse_address* parameter is no longer supported, as using :ref:`socket." -"SO_REUSEADDR ` poses a significant security concern " -"for UDP. Explicitly passing ``reuse_address=True`` will raise an exception." +"The *reuse_address* parameter is no longer supported, as " +"using :ref:`socket.SO_REUSEADDR ` poses a significant " +"security concern for UDP. Explicitly passing ``reuse_address=True`` will " +"raise an exception." msgstr "" msgid "" @@ -730,14 +779,15 @@ msgid "Create a Unix connection." msgstr "" msgid "" -"The socket family will be :py:const:`~socket.AF_UNIX`; socket type will be :" -"py:const:`~socket.SOCK_STREAM`." +"The socket family will be :py:const:`~socket.AF_UNIX`; socket type will " +"be :py:const:`~socket.SOCK_STREAM`." msgstr "" msgid "" "*path* is the name of a Unix domain socket and is required, unless a *sock* " -"parameter is specified. Abstract Unix sockets, :class:`str`, :class:" -"`bytes`, and :class:`~pathlib.Path` paths are supported." +"parameter is specified. Abstract Unix " +"sockets, :class:`str`, :class:`bytes`, and :class:`~pathlib.Path` paths are " +"supported." msgstr "" msgid "" @@ -796,9 +846,10 @@ msgid "" msgstr "" msgid "" -"*family* can be set to either :const:`socket.AF_INET` or :const:`~socket." -"AF_INET6` to force the socket to use IPv4 or IPv6. If not set, the *family* " -"will be determined from host name (defaults to :const:`~socket.AF_UNSPEC`)." +"*family* can be set to either :const:`socket.AF_INET` " +"or :const:`~socket.AF_INET6` to force the socket to use IPv4 or IPv6. If not " +"set, the *family* will be determined from host name (defaults " +"to :const:`~socket.AF_UNSPEC`)." msgstr "" msgid "*flags* is a bitmask for :meth:`getaddrinfo`." @@ -815,8 +866,8 @@ msgid "" msgstr "" msgid "" -"*backlog* is the maximum number of queued connections passed to :meth:" -"`~socket.socket.listen` (defaults to 100)." +"*backlog* is the maximum number of queued connections passed " +"to :meth:`~socket.socket.listen` (defaults to 100)." msgstr "" msgid "" @@ -873,8 +924,8 @@ msgid "" msgstr "" msgid "" -"Similar to :meth:`loop.create_server` but works with the :py:const:`~socket." -"AF_UNIX` socket family." +"Similar to :meth:`loop.create_server` but works with " +"the :py:const:`~socket.AF_UNIX` socket family." msgstr "" msgid "" @@ -964,7 +1015,7 @@ msgid "" "*sendfile* syscall and *fallback* is ``False``." msgstr "" -msgid "TLS Upgrade" +msgid "TLS upgrade" msgstr "" msgid "Upgrade an existing transport-based connection to TLS." @@ -989,8 +1040,8 @@ msgid "" msgstr "" msgid "" -"*transport* and *protocol* instances that methods like :meth:`~loop." -"create_server` and :meth:`~loop.create_connection` return." +"*transport* and *protocol* instances that methods " +"like :meth:`~loop.create_server` and :meth:`~loop.create_connection` return." msgstr "" msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`." @@ -1026,7 +1077,8 @@ msgstr "" msgid "" "Start monitoring the *fd* file descriptor for write availability and invoke " -"*callback* with the specified arguments once *fd* is available for writing." +"*callback* with the specified arguments *args* once *fd* is available for " +"writing." msgstr "" msgid "" @@ -1048,16 +1100,16 @@ msgid "Working with socket objects directly" msgstr "" msgid "" -"In general, protocol implementations that use transport-based APIs such as :" -"meth:`loop.create_connection` and :meth:`loop.create_server` are faster than " -"implementations that work with sockets directly. However, there are some use " -"cases when performance is not critical, and working with :class:`~socket." -"socket` objects directly is more convenient." +"In general, protocol implementations that use transport-based APIs such " +"as :meth:`loop.create_connection` and :meth:`loop.create_server` are faster " +"than implementations that work with sockets directly. However, there are " +"some use cases when performance is not critical, and working " +"with :class:`~socket.socket` objects directly is more convenient." msgstr "" msgid "" -"Receive up to *nbytes* from *sock*. Asynchronous version of :meth:`socket." -"recv() `." +"Receive up to *nbytes* from *sock*. Asynchronous version " +"of :meth:`socket.recv() `." msgstr "" msgid "Return the received data as a bytes object." @@ -1073,16 +1125,16 @@ msgid "" msgstr "" msgid "" -"Receive data from *sock* into the *buf* buffer. Modeled after the blocking :" -"meth:`socket.recv_into() ` method." +"Receive data from *sock* into the *buf* buffer. Modeled after the " +"blocking :meth:`socket.recv_into() ` method." msgstr "" msgid "Return the number of bytes written to the buffer." msgstr "" msgid "" -"Receive a datagram of up to *bufsize* from *sock*. Asynchronous version of :" -"meth:`socket.recvfrom() `." +"Receive a datagram of up to *bufsize* from *sock*. Asynchronous version " +"of :meth:`socket.recvfrom() `." msgstr "" msgid "Return a tuple of (received data, remote address)." @@ -1097,8 +1149,8 @@ msgid "Return a tuple of (number of bytes received, remote address)." msgstr "" msgid "" -"Send *data* to the *sock* socket. Asynchronous version of :meth:`socket." -"sendall() `." +"Send *data* to the *sock* socket. Asynchronous version " +"of :meth:`socket.sendall() `." msgstr "" msgid "" @@ -1116,8 +1168,8 @@ msgid "" msgstr "" msgid "" -"Send a datagram from *sock* to *address*. Asynchronous version of :meth:" -"`socket.sendto() `." +"Send a datagram from *sock* to *address*. Asynchronous version " +"of :meth:`socket.sendto() `." msgstr "" msgid "Return the number of bytes sent." @@ -1131,10 +1183,23 @@ msgid "" msgstr "" msgid "" -"``address`` no longer needs to be resolved. ``sock_connect`` will try to " -"check if the *address* is already resolved by calling :func:`socket." -"inet_pton`. If not, :meth:`loop.getaddrinfo` will be used to resolve the " -"*address*." +"With :class:`SelectorEventLoop`, *address* does not need to be resolved: " +"for :const:`~socket.AF_INET` and :const:`~socket.AF_INET6` sockets, " +"``sock_connect`` first checks whether *address* is already resolved by " +"calling :func:`socket.inet_pton`, and uses :meth:`loop.getaddrinfo` to " +"resolve it if it is not." +msgstr "" + +msgid "" +":class:`ProactorEventLoop`, the default event loop on Windows, does not " +"resolve *address*. The host must already be a numeric IP address; passing a " +"host name raises :exc:`OSError`. Resolve the address " +"with :meth:`loop.getaddrinfo` first, or use :meth:`loop.create_connection`, " +"which resolves the address on every platform." +msgstr "" + +msgid "" +"With :class:`SelectorEventLoop`, ``address`` no longer needs to be resolved." msgstr "" msgid "" @@ -1167,8 +1232,8 @@ msgid "" msgstr "" msgid "" -"*sock* must be a non-blocking :const:`socket.SOCK_STREAM` :class:`~socket." -"socket`." +"*sock* must be a non-" +"blocking :const:`socket.SOCK_STREAM` :class:`~socket.socket`." msgstr "" msgid "*file* must be a regular file object open in binary mode." @@ -1205,9 +1270,9 @@ msgstr "" msgid "" "Both *getaddrinfo* and *getnameinfo* methods were always documented to " -"return a coroutine, but prior to Python 3.7 they were, in fact, returning :" -"class:`asyncio.Future` objects. Starting with Python 3.7 both methods are " -"coroutines." +"return a coroutine, but prior to Python 3.7 they were, in fact, " +"returning :class:`asyncio.Future` objects. Starting with Python 3.7 both " +"methods are coroutines." msgstr "" msgid "Working with pipes" @@ -1216,13 +1281,15 @@ msgstr "" msgid "Register the read end of *pipe* in the event loop." msgstr "" -msgid "*pipe* is a :term:`file-like object `." +msgid "" +"*pipe* is a :term:`file-like object `. See :ref:`Supported " +"pipe objects ` for the objects supported as *pipe*." msgstr "" msgid "" -"Return pair ``(transport, protocol)``, where *transport* supports the :class:" -"`ReadTransport` interface and *protocol* is an object instantiated by the " -"*protocol_factory*." +"Return pair ``(transport, protocol)``, where *transport* supports " +"the :class:`ReadTransport` interface and *protocol* is an object " +"instantiated by the *protocol_factory*." msgstr "" msgid "" @@ -1233,13 +1300,48 @@ msgstr "" msgid "Register the write end of *pipe* in the event loop." msgstr "" -msgid "*pipe* is :term:`file-like object `." +msgid "" +"Return pair ``(transport, protocol)``, where *transport* " +"supports :class:`WriteTransport` interface and *protocol* is an object " +"instantiated by the *protocol_factory*." +msgstr "" + +msgid "Supported pipe objects" +msgstr "" + +msgid "" +"These methods only work with objects the operating system can poll for " +"readiness or perform overlapped I/O on. Regular files on disk are **not** " +"supported on any platform. There is no asynchronous file I/O in asyncio; " +"use :meth:`loop.run_in_executor` to read and write regular files without " +"blocking the event loop." +msgstr "" + +msgid "" +"On Unix, with :class:`SelectorEventLoop`, *pipe* must wrap one of the " +"following:" +msgstr "" + +msgid "" +"a pipe, such as an end of an :func:`os.pipe` pair or a FIFO created " +"with :func:`os.mkfifo`;" +msgstr "" + +msgid "a socket;" +msgstr "" + +msgid "a character device, such as a terminal." msgstr "" msgid "" -"Return pair ``(transport, protocol)``, where *transport* supports :class:" -"`WriteTransport` interface and *protocol* is an object instantiated by the " -"*protocol_factory*." +"On Windows, where only :class:`ProactorEventLoop` implements these methods, " +"*pipe* must wrap a handle opened for overlapped I/O (that is, created with " +"the ``FILE_FLAG_OVERLAPPED`` flag), since the handle has to be associated " +"with an I/O completion port. Handles that were not opened for overlapped I/" +"O are rejected. In particular, the standard streams " +"(:data:`sys.stdin`, :data:`sys.stdout` and :data:`sys.stderr`), console " +"handles, and the pipes created by :func:`os.pipe` are **not** opened for " +"overlapped I/O and therefore cannot be used with these methods." msgstr "" msgid "" @@ -1254,7 +1356,9 @@ msgstr "" msgid "Unix signals" msgstr "" -msgid "Set *callback* as the handler for the *signum* signal." +msgid "" +"Set *callback* as the handler for the *signum* signal, passing *args* as " +"positional arguments." msgstr "" msgid "" @@ -1287,7 +1391,9 @@ msgstr "" msgid "Executing code in thread or process pools" msgstr "" -msgid "Arrange for *func* to be called in the specified executor." +msgid "" +"Arrange for *func* to be called in the specified executor passing *args* as " +"positional arguments." msgstr "" msgid "" @@ -1364,16 +1470,16 @@ msgstr "" msgid "" "Set *executor* as the default executor used by :meth:`run_in_executor`. " -"*executor* must be an instance of :class:`~concurrent.futures." -"ThreadPoolExecutor`." +"*executor* must be an instance " +"of :class:`~concurrent.futures.ThreadPoolExecutor`." msgstr "" msgid "" -"*executor* must be an instance of :class:`~concurrent.futures." -"ThreadPoolExecutor`." +"*executor* must be an instance " +"of :class:`~concurrent.futures.ThreadPoolExecutor`." msgstr "" -msgid "Error Handling API" +msgid "Error handling API" msgstr "" msgid "Allows customizing how exceptions are handled in the event loop." @@ -1391,9 +1497,9 @@ msgid "" msgstr "" msgid "" -"If the handler is called on behalf of a :class:`~asyncio.Task` or :class:" -"`~asyncio.Handle`, it is run in the :class:`contextvars.Context` of that " -"task or callback handle." +"If the handler is called on behalf of a :class:`~asyncio.Task` " +"or :class:`~asyncio.Handle`, it is run in the :class:`contextvars.Context` " +"of that task or callback handle." msgstr "" msgid "" @@ -1416,8 +1522,8 @@ msgid "" msgstr "" msgid "" -"*context* parameter has the same meaning as in :meth:" -"`call_exception_handler`." +"*context* parameter has the same meaning as " +"in :meth:`call_exception_handler`." msgstr "" msgid "Call the current event loop exception handler." @@ -1476,8 +1582,9 @@ msgid "Get the debug mode (:class:`bool`) of the event loop." msgstr "" msgid "" -"The default value is ``True`` if the environment variable :envvar:" -"`PYTHONASYNCIODEBUG` is set to a non-empty string, ``False`` otherwise." +"The default value is ``True`` if the environment " +"variable :envvar:`PYTHONASYNCIODEBUG` is set to a non-empty string, " +"``False`` otherwise." msgstr "" msgid "Set the debug mode of the event loop." @@ -1500,7 +1607,7 @@ msgstr "" msgid "The :ref:`debug mode of asyncio `." msgstr "" -msgid "Running Subprocesses" +msgid "Running subprocesses" msgstr "" msgid "" @@ -1511,8 +1618,9 @@ msgstr "" msgid "" "On Windows, the default event loop :class:`ProactorEventLoop` supports " -"subprocesses, whereas :class:`SelectorEventLoop` does not. See :ref:" -"`Subprocess Support on Windows ` for details." +"subprocesses, whereas :class:`SelectorEventLoop` does not. " +"See :ref:`Subprocess Support on Windows ` for " +"details." msgstr "" msgid "" @@ -1544,8 +1652,8 @@ msgid "" msgstr "" msgid "" -"The *protocol_factory* must be a callable returning a subclass of the :class:" -"`asyncio.SubprocessProtocol` class." +"The *protocol_factory* must be a callable returning a subclass of " +"the :class:`asyncio.SubprocessProtocol` class." msgstr "" msgid "Other parameters:" @@ -1573,8 +1681,8 @@ msgid "" msgstr "" msgid "" -"the :const:`subprocess.DEVNULL` constant which indicates that the special :" -"data:`os.devnull` file will be used" +"the :const:`subprocess.DEVNULL` constant which indicates that the " +"special :data:`os.devnull` file will be used" msgstr "" msgid "*stdout* can be any of these:" @@ -1602,9 +1710,9 @@ msgstr "" msgid "" "If a file-like object passed as *stdin*, *stdout* or *stderr* represents a " -"pipe, then the other side of this pipe should be registered with :meth:" -"`~loop.connect_write_pipe` or :meth:`~loop.connect_read_pipe` for use with " -"the event loop." +"pipe, then the other side of this pipe should be registered " +"with :meth:`~loop.connect_write_pipe` or :meth:`~loop.connect_read_pipe` for " +"use with the event loop." msgstr "" msgid "" @@ -1619,8 +1727,13 @@ msgid "" msgstr "" msgid "" -"Create a subprocess from *cmd*, which can be a :class:`str` or a :class:" -"`bytes` string encoded to the :ref:`filesystem encoding `, using the platform's \"shell\" syntax." msgstr "" @@ -1630,8 +1743,8 @@ msgid "" msgstr "" msgid "" -"The *protocol_factory* must be a callable returning a subclass of the :class:" -"`SubprocessProtocol` class." +"The *protocol_factory* must be a callable returning a subclass of " +"the :class:`SubprocessProtocol` class." msgstr "" msgid "" @@ -1654,12 +1767,12 @@ msgid "" "used to construct shell commands." msgstr "" -msgid "Callback Handles" +msgid "Callback handles" msgstr "" msgid "" -"A callback wrapper object returned by :meth:`loop.call_soon`, :meth:`loop." -"call_soon_threadsafe`." +"A callback wrapper object returned " +"by :meth:`loop.call_soon`, :meth:`loop.call_soon_threadsafe`." msgstr "" msgid "" @@ -1675,8 +1788,8 @@ msgid "Return ``True`` if the callback was cancelled." msgstr "" msgid "" -"A callback wrapper object returned by :meth:`loop.call_later`, and :meth:" -"`loop.call_at`." +"A callback wrapper object returned by :meth:`loop.call_later`, " +"and :meth:`loop.call_at`." msgstr "" msgid "This class is a subclass of :class:`Handle`." @@ -1686,17 +1799,17 @@ msgid "Return a scheduled callback time as :class:`float` seconds." msgstr "" msgid "" -"The time is an absolute timestamp, using the same time reference as :meth:" -"`loop.time`." +"The time is an absolute timestamp, using the same time reference " +"as :meth:`loop.time`." msgstr "" -msgid "Server Objects" +msgid "Server objects" msgstr "" msgid "" -"Server objects are created by :meth:`loop.create_server`, :meth:`loop." -"create_unix_server`, :func:`start_server`, and :func:`start_unix_server` " -"functions." +"Server objects are created " +"by :meth:`loop.create_server`, :meth:`loop.create_unix_server`, :func:`start_server`, " +"and :func:`start_unix_server` functions." msgstr "" msgid "Do not instantiate the :class:`Server` class directly." @@ -1817,6 +1930,12 @@ msgid "" "have finished." msgstr "" +msgid "" +"``wait_closed()`` now waits until the server is closed and all active " +"connections have finished. Previously, it returned immediately if the " +"server was already closed, even if connections were still active." +msgstr "" + msgid "" "List of socket-like objects, ``asyncio.trsock.TransportSocket``, which the " "server is listening on." @@ -1827,12 +1946,12 @@ msgid "" "server sockets directly. In 3.7 a copy of that list is returned." msgstr "" -msgid "Event Loop Implementations" +msgid "Event loop implementations" msgstr "" msgid "" -"asyncio ships with two different event loop implementations: :class:" -"`SelectorEventLoop` and :class:`ProactorEventLoop`." +"asyncio ships with two different event loop " +"implementations: :class:`SelectorEventLoop` and :class:`ProactorEventLoop`." msgstr "" msgid "By default asyncio is configured to use :class:`EventLoop`." @@ -1872,13 +1991,13 @@ msgid "" msgstr "" msgid "" -"An alias to the most efficient available subclass of :class:" -"`AbstractEventLoop` for the given platform." +"An alias to the most efficient available subclass " +"of :class:`AbstractEventLoop` for the given platform." msgstr "" msgid "" -"It is an alias to :class:`SelectorEventLoop` on Unix and :class:" -"`ProactorEventLoop` on Windows." +"It is an alias to :class:`SelectorEventLoop` on Unix " +"and :class:`ProactorEventLoop` on Windows." msgstr "" msgid "Abstract base class for asyncio-compliant event loops." @@ -1894,9 +2013,10 @@ msgstr "Przykłady" msgid "" "Note that all examples in this section **purposefully** show how to use the " -"low-level event loop APIs, such as :meth:`loop.run_forever` and :meth:`loop." -"call_soon`. Modern asyncio applications rarely need to be written this way; " -"consider using the high-level functions like :func:`asyncio.run`." +"low-level event loop APIs, such as :meth:`loop.run_forever` " +"and :meth:`loop.call_soon`. Modern asyncio applications rarely need to be " +"written this way; consider using the high-level functions " +"like :func:`asyncio.run`." msgstr "" msgid "Hello World with call_soon()" @@ -1943,10 +2063,10 @@ msgstr "" msgid "" "import asyncio\n" -"import datetime\n" +"import datetime as dt\n" "\n" "def display_date(end_time, loop):\n" -" print(datetime.datetime.now())\n" +" print(dt.datetime.now())\n" " if (loop.time() + 1.0) < end_time:\n" " loop.call_later(1, display_date, end_time, loop)\n" " else:\n" @@ -1974,8 +2094,8 @@ msgid "Watch a file descriptor for read events" msgstr "" msgid "" -"Wait until a file descriptor received some data using the :meth:`loop." -"add_reader` method and then close the event loop::" +"Wait until a file descriptor received some data using " +"the :meth:`loop.add_reader` method and then close the event loop::" msgstr "" msgid "" @@ -2026,12 +2146,13 @@ msgstr "" msgid "Set signal handlers for SIGINT and SIGTERM" msgstr "" -msgid "(This ``signals`` example only works on Unix.)" +msgid "(This ``signal`` example only works on Unix.)" msgstr "" msgid "" -"Register handlers for signals :const:`~signal.SIGINT` and :const:`~signal." -"SIGTERM` using the :meth:`loop.add_signal_handler` method::" +"Register handlers for signals :const:`~signal.SIGINT` " +"and :const:`~signal.SIGTERM` using the :meth:`loop.add_signal_handler` " +"method::" msgstr "" msgid "" diff --git a/library/asyncio-exceptions.po b/library/asyncio-exceptions.po index ead04480ec..e1dcd1ec33 100644 --- a/library/asyncio-exceptions.po +++ b/library/asyncio-exceptions.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:54+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/library/asyncio-extending.po b/library/asyncio-extending.po index 1876f7a005..39652502e0 100644 --- a/library/asyncio-extending.po +++ b/library/asyncio-extending.po @@ -66,8 +66,9 @@ msgstr "" msgid "" ":class:`asyncio.Future` and :class:`asyncio.Task` should be never created " -"directly, please use corresponding :meth:`loop.create_future` and :meth:" -"`loop.create_task`, or :func:`asyncio.create_task` factories instead." +"directly, please use corresponding :meth:`loop.create_future` " +"and :meth:`loop.create_task`, or :func:`asyncio.create_task` factories " +"instead." msgstr "" msgid "" @@ -101,8 +102,8 @@ msgstr "" msgid "" "A third party task implementation should call the following functions to " -"keep a task visible by :func:`asyncio.get_tasks` and :func:`asyncio." -"current_task`:" +"keep a task visible by :func:`asyncio.get_tasks` " +"and :func:`asyncio.current_task`:" msgstr "" msgid "Register a new *task* as managed by *asyncio*." @@ -121,14 +122,14 @@ msgid "Switch the current task to the *task* argument." msgstr "" msgid "" -"Call the function just before executing a portion of embedded *coroutine* (:" -"meth:`coroutine.send` or :meth:`coroutine.throw`)." +"Call the function just before executing a portion of embedded *coroutine* " +"(:meth:`coroutine.send` or :meth:`coroutine.throw`)." msgstr "" msgid "Switch the current task back from *task* to ``None``." msgstr "" msgid "" -"Call the function just after :meth:`coroutine.send` or :meth:`coroutine." -"throw` execution." +"Call the function just after :meth:`coroutine.send` " +"or :meth:`coroutine.throw` execution." msgstr "" diff --git a/library/asyncio-future.po b/library/asyncio-future.po index 262c087f7d..fb42d1ef4a 100644 --- a/library/asyncio-future.po +++ b/library/asyncio-future.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -62,14 +62,14 @@ msgid "" msgstr "" msgid "" -"a :class:`Task` object wrapping *obj*, if *obj* is a coroutine (:func:" -"`iscoroutine` is used for the test); in this case the coroutine will be " -"scheduled by ``ensure_future()``." +"a :class:`Task` object wrapping *obj*, if *obj* is a coroutine " +"(:func:`iscoroutine` is used for the test); in this case the coroutine will " +"be scheduled by ``ensure_future()``." msgstr "" msgid "" -"a :class:`Task` object that would await on *obj*, if *obj* is an awaitable (:" -"func:`inspect.isawaitable` is used for the test.)" +"a :class:`Task` object that would await on *obj*, if *obj* is an awaitable " +"(:func:`inspect.isawaitable` is used for the test.)" msgstr "" msgid "If *obj* is neither of the above a :exc:`TypeError` is raised." @@ -94,8 +94,8 @@ msgid "" msgstr "" msgid "" -"Wrap a :class:`concurrent.futures.Future` object in a :class:`asyncio." -"Future` object." +"Wrap a :class:`concurrent.futures.Future` object in " +"a :class:`asyncio.Future` object." msgstr "" msgid "" @@ -125,9 +125,13 @@ msgstr "" msgid "" "The rule of thumb is to never expose Future objects in user-facing APIs, and " -"the recommended way to create a Future object is to call :meth:`loop." -"create_future`. This way alternative event loop implementations can inject " -"their own optimized implementations of a Future object." +"the recommended way to create a Future object is to " +"call :meth:`loop.create_future`. This way alternative event loop " +"implementations can inject their own optimized implementations of a Future " +"object." +msgstr "" + +msgid "Futures are :ref:`generic ` over the type of their results." msgstr "" msgid "Added support for the :mod:`contextvars` module." @@ -147,18 +151,18 @@ msgid "" msgstr "" msgid "" -"If the Future is *done* and has an exception set by the :meth:" -"`set_exception` method, this method raises the exception." +"If the Future is *done* and has an exception set by " +"the :meth:`set_exception` method, this method raises the exception." msgstr "" msgid "" -"If the Future has been *cancelled*, this method raises a :exc:" -"`CancelledError` exception." +"If the Future has been *cancelled*, this method raises " +"a :exc:`CancelledError` exception." msgstr "" msgid "" -"If the Future's result isn't yet available, this method raises an :exc:" -"`InvalidStateError` exception." +"If the Future's result isn't yet available, this method raises " +"an :exc:`InvalidStateError` exception." msgstr "" msgid "Mark the Future as *done* and set its result." @@ -204,14 +208,14 @@ msgid "" msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the *callback* to run in. The current " -"context is used when no *context* is provided." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the *callback* to run in. The " +"current context is used when no *context* is provided." msgstr "" msgid "" -":func:`functools.partial` can be used to pass parameters to the callback, e." -"g.::" +":func:`functools.partial` can be used to pass parameters to the callback, " +"e.g.::" msgstr "" msgid "" @@ -242,6 +246,12 @@ msgid "" "``True``." msgstr "" +msgid "" +"The optional string argument *msg* is passed as the argument to " +"the :exc:`CancelledError` exception raised when a cancelled Future is " +"awaited." +msgstr "" + msgid "Added the *msg* parameter." msgstr "" @@ -254,8 +264,8 @@ msgid "" msgstr "" msgid "" -"If the Future isn't *done* yet, this method raises an :exc:" -"`InvalidStateError` exception." +"If the Future isn't *done* yet, this method raises " +"an :exc:`InvalidStateError` exception." msgstr "" msgid "Return the event loop the Future object is bound to." @@ -312,8 +322,8 @@ msgid "" msgstr "" msgid "" -":meth:`asyncio.Future.result` and :meth:`asyncio.Future.exception` raise an :" -"exc:`InvalidStateError` exception when the Future is not *done*." +":meth:`asyncio.Future.result` and :meth:`asyncio.Future.exception` raise " +"an :exc:`InvalidStateError` exception when the Future is not *done*." msgstr "" msgid "" @@ -327,6 +337,6 @@ msgid "" msgstr "" msgid "" -":meth:`asyncio.Future.cancel` accepts an optional ``msg`` argument, but :" -"meth:`concurrent.futures.Future.cancel` does not." +":meth:`asyncio.Future.cancel` accepts an optional ``msg`` argument, " +"but :meth:`concurrent.futures.Future.cancel` does not." msgstr "" diff --git a/library/asyncio-llapi-index.po b/library/asyncio-llapi-index.po index 3339834ce9..aac99855e5 100644 --- a/library/asyncio-llapi-index.po +++ b/library/asyncio-llapi-index.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -286,7 +285,7 @@ msgid "Wrap a write end of a pipe into a ``(transport, protocol)`` pair." msgstr "" msgid "Sockets" -msgstr "" +msgstr "Sockets" msgid "``await`` :meth:`loop.sock_recv`" msgstr "``await`` :meth:`loop.sock_recv`" @@ -301,13 +300,13 @@ msgid "Receive data from the :class:`~socket.socket` into a buffer." msgstr "" msgid "``await`` :meth:`loop.sock_recvfrom`" -msgstr "" +msgstr "``await`` :meth:`loop.sock_recvfrom`" msgid "Receive a datagram from the :class:`~socket.socket`." msgstr "" msgid "``await`` :meth:`loop.sock_recvfrom_into`" -msgstr "" +msgstr "``await`` :meth:`loop.sock_recvfrom_into`" msgid "Receive a datagram from the :class:`~socket.socket` into a buffer." msgstr "" @@ -319,7 +318,7 @@ msgid "Send data to the :class:`~socket.socket`." msgstr "" msgid "``await`` :meth:`loop.sock_sendto`" -msgstr "" +msgstr "``await`` :meth:`loop.sock_sendto`" msgid "Send a datagram via the :class:`~socket.socket` to the given address." msgstr "" @@ -490,8 +489,9 @@ msgstr "" msgid "" "Transports that can receive data (TCP and Unix connections, pipes, etc). " -"Returned from methods like :meth:`loop.create_connection`, :meth:`loop." -"create_unix_connection`, :meth:`loop.connect_read_pipe`, etc:" +"Returned from methods " +"like :meth:`loop.create_connection`, :meth:`loop.create_unix_connection`, :meth:`loop.connect_read_pipe`, " +"etc:" msgstr "" msgid "Read Transports" @@ -517,8 +517,9 @@ msgstr "" msgid "" "Transports that can Send data (TCP and Unix connections, pipes, etc). " -"Returned from methods like :meth:`loop.create_connection`, :meth:`loop." -"create_unix_connection`, :meth:`loop.connect_write_pipe`, etc:" +"Returned from methods " +"like :meth:`loop.create_connection`, :meth:`loop.create_unix_connection`, :meth:`loop.connect_write_pipe`, " +"etc:" msgstr "" msgid "Write Transports" @@ -555,29 +556,29 @@ msgid "Close the transport immediately." msgstr "" msgid "" -":meth:`transport.get_write_buffer_size() `" +":meth:`transport.get_write_buffer_size() " +"`" msgstr "" -":meth:`transport.get_write_buffer_size() `" +":meth:`transport.get_write_buffer_size() " +"`" msgid "Return the current size of the output buffer." msgstr "" msgid "" -":meth:`transport.get_write_buffer_limits() `" +":meth:`transport.get_write_buffer_limits() " +"`" msgstr "" msgid "Return high and low water marks for write flow control." msgstr "" msgid "" -":meth:`transport.set_write_buffer_limits() `" +":meth:`transport.set_write_buffer_limits() " +"`" msgstr "" -":meth:`transport.set_write_buffer_limits() `" +":meth:`transport.set_write_buffer_limits() " +"`" msgid "Set new high and low water marks for write flow control." msgstr "" @@ -598,8 +599,8 @@ msgid ":meth:`transport.abort() `" msgstr ":meth:`transport.abort() `" msgid "" -"Low-level transport abstraction over subprocesses. Returned by :meth:`loop." -"subprocess_exec` and :meth:`loop.subprocess_shell`:" +"Low-level transport abstraction over subprocesses. Returned " +"by :meth:`loop.subprocess_exec` and :meth:`loop.subprocess_shell`:" msgstr "" msgid "Subprocess Transports" @@ -612,11 +613,11 @@ msgid "Return the subprocess process id." msgstr "" msgid "" -":meth:`transport.get_pipe_transport() `" +":meth:`transport.get_pipe_transport() " +"`" msgstr "" -":meth:`transport.get_pipe_transport() `" +":meth:`transport.get_pipe_transport() " +"`" msgid "" "Return the transport for the requested communication pipe (*stdin*, " @@ -741,14 +742,14 @@ msgid "Subprocess Protocols" msgstr "" msgid "``callback`` :meth:`~SubprocessProtocol.pipe_data_received`" -msgstr "" +msgstr "``callback`` :meth:`~SubprocessProtocol.pipe_data_received`" msgid "" "Called when the child process writes data into its *stdout* or *stderr* pipe." msgstr "" msgid "``callback`` :meth:`~SubprocessProtocol.pipe_connection_lost`" -msgstr "" +msgstr "``callback`` :meth:`~SubprocessProtocol.pipe_connection_lost`" msgid "" "Called when one of the pipes communicating with the child process is closed." @@ -760,18 +761,18 @@ msgstr "" "``callback`` :meth:`process_exited() `" msgid "" -"Called when the child process has exited. It can be called before :meth:" -"`~SubprocessProtocol.pipe_data_received` and :meth:`~SubprocessProtocol." -"pipe_connection_lost` methods." +"Called when the child process has exited. It can be called " +"before :meth:`~SubprocessProtocol.pipe_data_received` " +"and :meth:`~SubprocessProtocol.pipe_connection_lost` methods." msgstr "" msgid "Event Loop Policies" msgstr "" msgid "" -"Policies is a low-level mechanism to alter the behavior of functions like :" -"func:`asyncio.get_event_loop`. See also the main :ref:`policies section " -"` for more details." +"Policies is a low-level mechanism to alter the behavior of functions " +"like :func:`asyncio.get_event_loop`. See also the main :ref:`policies " +"section ` for more details." msgstr "" msgid "Accessing Policies" diff --git a/library/asyncio-platforms.po b/library/asyncio-platforms.po index 6d0c9ab2c1..7215be82fb 100644 --- a/library/asyncio-platforms.po +++ b/library/asyncio-platforms.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,6 +40,12 @@ msgid "" "monitor file I/O." msgstr "" +msgid "" +":meth:`loop.connect_read_pipe` and :meth:`loop.connect_write_pipe` cannot be " +"used with regular files. See :ref:`Supported pipe objects ` for the objects that are accepted on each platform." +msgstr "" + msgid "Windows" msgstr "Windows" @@ -80,14 +86,14 @@ msgid "" msgstr "" msgid "" -"Pipes are not supported, so the :meth:`loop.connect_read_pipe` and :meth:" -"`loop.connect_write_pipe` methods are not implemented." +"Pipes are not supported, so the :meth:`loop.connect_read_pipe` " +"and :meth:`loop.connect_write_pipe` methods are not implemented." msgstr "" msgid "" -":ref:`Subprocesses ` are not supported, i.e. :meth:`loop." -"subprocess_exec` and :meth:`loop.subprocess_shell` methods are not " -"implemented." +":ref:`Subprocesses ` are not supported, " +"i.e. :meth:`loop.subprocess_exec` and :meth:`loop.subprocess_shell` methods " +"are not implemented." msgstr "" msgid ":class:`ProactorEventLoop` has the following limitations:" @@ -98,6 +104,12 @@ msgid "" "supported." msgstr "" +msgid "" +":meth:`loop.connect_read_pipe` and :meth:`loop.connect_write_pipe` only " +"accept a handle opened for overlapped I/O. See :ref:`Supported pipe objects " +"` for which objects are supported." +msgstr "" + msgid "" "The resolution of the monotonic clock on Windows is usually around 15.6 " "milliseconds. The best resolution is 0.5 milliseconds. The resolution " @@ -114,13 +126,14 @@ msgid "" msgstr "" msgid "" -"The :meth:`policy.set_child_watcher() ` function is also not supported, as :class:" -"`ProactorEventLoop` has a different mechanism to watch child processes." +"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 "" +msgstr "macOS" msgid "Modern macOS versions are fully supported." msgstr "" @@ -129,11 +142,12 @@ msgid "macOS <= 10.8" msgstr "" msgid "" -"On macOS 10.6, 10.7 and 10.8, the default event loop uses :class:`selectors." -"KqueueSelector`, which does not support character devices on these " -"versions. The :class:`SelectorEventLoop` can be manually configured to use :" -"class:`~selectors.SelectSelector` or :class:`~selectors.PollSelector` to " -"support character devices on these older versions of macOS. Example::" +"On macOS 10.6, 10.7 and 10.8, the default event loop " +"uses :class:`selectors.KqueueSelector`, which does not support character " +"devices on these versions. The :class:`SelectorEventLoop` can be manually " +"configured to use :class:`~selectors.SelectSelector` " +"or :class:`~selectors.PollSelector` to support character devices on these " +"older versions of macOS. Example::" msgstr "" msgid "" diff --git a/library/asyncio-policy.po b/library/asyncio-policy.po index f766280f9e..a17e56f830 100644 --- a/library/asyncio-policy.po +++ b/library/asyncio-policy.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,12 +27,12 @@ msgid "Policies" msgstr "" msgid "" -"An event loop policy is a global object used to get and set the current :ref:" -"`event loop `, as well as create new event loops. The " -"default policy can be :ref:`replaced ` with :ref:" -"`built-in alternatives ` to use different event loop " -"implementations, or substituted by a :ref:`custom policy ` that can override these behaviors." +"An event loop policy is a global object used to get and set the " +"current :ref:`event loop `, as well as create new event " +"loops. The default policy can be :ref:`replaced ` " +"with :ref:`built-in alternatives ` to use different " +"event loop implementations, or substituted by a :ref:`custom policy ` that can override these behaviors." msgstr "" msgid "" @@ -42,13 +42,14 @@ msgid "" msgstr "" msgid "" -"Custom event loop policies can control the behavior of :func:" -"`get_event_loop`, :func:`set_event_loop`, and :func:`new_event_loop`." +"Custom event loop policies can control the behavior " +"of :func:`get_event_loop`, :func:`set_event_loop`, " +"and :func:`new_event_loop`." msgstr "" msgid "" -"Policy objects should implement the APIs defined in the :class:" -"`AbstractEventLoopPolicy` abstract base class." +"Policy objects should implement the APIs defined in " +"the :class:`AbstractEventLoopPolicy` abstract base class." msgstr "" msgid "Getting and Setting the Policy" @@ -112,8 +113,8 @@ msgid "asyncio ships with the following built-in policies:" msgstr "" msgid "" -"The default asyncio policy. Uses :class:`SelectorEventLoop` on Unix and :" -"class:`ProactorEventLoop` on Windows." +"The default asyncio policy. Uses :class:`SelectorEventLoop` on Unix " +"and :class:`ProactorEventLoop` on Windows." msgstr "" msgid "" @@ -125,8 +126,8 @@ msgid "On Windows, :class:`ProactorEventLoop` is now used by default." msgstr "" msgid "" -"The :meth:`get_event_loop` method of the default asyncio policy now emits a :" -"exc:`DeprecationWarning` if there is no current event loop set and it " +"The :meth:`get_event_loop` method of the default asyncio policy now emits " +"a :exc:`DeprecationWarning` if there is no current event loop set and it " "decides to create one. In some future Python release this will become an " "error." msgstr "" @@ -160,10 +161,10 @@ msgstr "" msgid "" "asyncio defines the :class:`AbstractChildWatcher` abstract base class, which " -"child watchers should implement, and has four different implementations: :" -"class:`ThreadedChildWatcher` (configured to be used by default), :class:" -"`MultiLoopChildWatcher`, :class:`SafeChildWatcher`, and :class:" -"`FastChildWatcher`." +"child watchers should implement, and has four different " +"implementations: :class:`ThreadedChildWatcher` (configured to be used by " +"default), :class:`MultiLoopChildWatcher`, :class:`SafeChildWatcher`, " +"and :class:`FastChildWatcher`." msgstr "" msgid "" @@ -181,8 +182,8 @@ msgstr "" msgid "" "Set the current child watcher to *watcher* for the current policy. " -"*watcher* must implement methods defined in the :class:" -"`AbstractChildWatcher` base class." +"*watcher* must implement methods defined in " +"the :class:`AbstractChildWatcher` base class." msgstr "" msgid "" @@ -226,8 +227,8 @@ msgid "Return ``True`` if the watcher is ready to use." msgstr "" msgid "" -"Spawning a subprocess with *inactive* current child watcher raises :exc:" -"`RuntimeError`." +"Spawning a subprocess with *inactive* current child watcher " +"raises :exc:`RuntimeError`." msgstr "" msgid "Close the watcher." @@ -278,9 +279,10 @@ msgid "" msgstr "" msgid "" -"This implementation uses active event loop from the main thread to handle :" -"py:data:`SIGCHLD` signal. If the main thread has no running event loop " -"another thread cannot spawn a subprocess (:exc:`RuntimeError` is raised)." +"This implementation uses active event loop from the main thread to " +"handle :py:data:`SIGCHLD` signal. If the main thread has no running event " +"loop another thread cannot spawn a subprocess (:exc:`RuntimeError` is " +"raised)." msgstr "" msgid "" @@ -290,9 +292,9 @@ msgid "" msgstr "" msgid "" -"This implementation reaps every terminated processes by calling ``os." -"waitpid(-1)`` directly, possibly breaking other code spawning processes and " -"waiting for their termination." +"This implementation reaps every terminated processes by calling " +"``os.waitpid(-1)`` directly, possibly breaking other code spawning processes " +"and waiting for their termination." msgstr "" msgid "" @@ -301,8 +303,8 @@ msgid "" msgstr "" msgid "" -"This solution requires a running event loop in the main thread to work, as :" -"class:`SafeChildWatcher`." +"This solution requires a running event loop in the main thread to work, " +"as :class:`SafeChildWatcher`." msgstr "" msgid "" @@ -319,9 +321,9 @@ msgid "Custom Policies" msgstr "" msgid "" -"To implement a new event loop policy, it is recommended to subclass :class:" -"`DefaultEventLoopPolicy` and override the methods for which custom behavior " -"is wanted, e.g.::" +"To implement a new event loop policy, it is recommended to " +"subclass :class:`DefaultEventLoopPolicy` and override the methods for which " +"custom behavior is wanted, e.g.::" msgstr "" msgid "" diff --git a/library/asyncio-protocol.po b/library/asyncio-protocol.po index 8ce2a75a2a..3f01db2ddd 100644 --- a/library/asyncio-protocol.po +++ b/library/asyncio-protocol.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,11 +71,11 @@ msgid "" msgstr "" msgid "" -"Most of connection oriented event loop methods (such as :meth:`loop." -"create_connection`) usually accept a *protocol_factory* argument used to " -"create a *Protocol* object for an accepted connection, represented by a " -"*Transport* object. Such methods usually return a tuple of ``(transport, " -"protocol)``." +"Most of connection oriented event loop methods (such " +"as :meth:`loop.create_connection`) usually accept a *protocol_factory* " +"argument used to create a *Protocol* object for an accepted connection, " +"represented by a *Transport* object. Such methods usually return a tuple of " +"``(transport, protocol)``." msgstr "" msgid "Contents" @@ -88,15 +85,15 @@ msgid "This documentation page contains the following sections:" msgstr "" msgid "" -"The `Transports`_ section documents asyncio :class:`BaseTransport`, :class:" -"`ReadTransport`, :class:`WriteTransport`, :class:`Transport`, :class:" -"`DatagramTransport`, and :class:`SubprocessTransport` classes." +"The `Transports`_ section documents " +"asyncio :class:`BaseTransport`, :class:`ReadTransport`, :class:`WriteTransport`, :class:`Transport`, :class:`DatagramTransport`, " +"and :class:`SubprocessTransport` classes." msgstr "" msgid "" -"The `Protocols`_ section documents asyncio :class:`BaseProtocol`, :class:" -"`Protocol`, :class:`BufferedProtocol`, :class:`DatagramProtocol`, and :class:" -"`SubprocessProtocol` classes." +"The `Protocols`_ section documents " +"asyncio :class:`BaseProtocol`, :class:`Protocol`, :class:`BufferedProtocol`, :class:`DatagramProtocol`, " +"and :class:`SubprocessProtocol` classes." msgstr "" msgid "" @@ -141,18 +138,18 @@ msgid "A base transport for write-only connections." msgstr "" msgid "" -"Instances of the *WriteTransport* class are returned from the :meth:`loop." -"connect_write_pipe` event loop method and are also used by subprocess-" -"related methods like :meth:`loop.subprocess_exec`." +"Instances of the *WriteTransport* class are returned from " +"the :meth:`loop.connect_write_pipe` event loop method and are also used by " +"subprocess-related methods like :meth:`loop.subprocess_exec`." msgstr "" msgid "A base transport for read-only connections." msgstr "" msgid "" -"Instances of the *ReadTransport* class are returned from the :meth:`loop." -"connect_read_pipe` event loop method and are also used by subprocess-related " -"methods like :meth:`loop.subprocess_exec`." +"Instances of the *ReadTransport* class are returned from " +"the :meth:`loop.connect_read_pipe` event loop method and are also used by " +"subprocess-related methods like :meth:`loop.subprocess_exec`." msgstr "" msgid "" @@ -167,8 +164,8 @@ msgstr "" msgid "" "Instances of the *Transport* class are returned from or used by event loop " -"methods like :meth:`loop.create_connection`, :meth:`loop." -"create_unix_connection`, :meth:`loop.create_server`, :meth:`loop.sendfile`, " +"methods " +"like :meth:`loop.create_connection`, :meth:`loop.create_unix_connection`, :meth:`loop.create_server`, :meth:`loop.sendfile`, " "etc." msgstr "" @@ -176,8 +173,8 @@ msgid "A transport for datagram (UDP) connections." msgstr "" msgid "" -"Instances of the *DatagramTransport* class are returned from the :meth:`loop." -"create_datagram_endpoint` event loop method." +"Instances of the *DatagramTransport* class are returned from " +"the :meth:`loop.create_datagram_endpoint` event loop method." msgstr "" msgid "" @@ -247,8 +244,8 @@ msgid "``'socket'``: :class:`socket.socket` instance" msgstr "" msgid "" -"``'sockname'``: the socket's own address, result of :meth:`socket.socket." -"getsockname`" +"``'sockname'``: the socket's own address, result " +"of :meth:`socket.socket.getsockname`" msgstr "" msgid "SSL socket:" @@ -256,8 +253,8 @@ msgstr "" msgid "" "``'compression'``: the compression algorithm being used as a string, or " -"``None`` if the connection isn't compressed; result of :meth:`ssl.SSLSocket." -"compression`" +"``None`` if the connection isn't compressed; result " +"of :meth:`ssl.SSLSocket.compression`" msgstr "" msgid "" @@ -271,7 +268,7 @@ msgid "" msgstr "" msgid "``'sslcontext'``: :class:`ssl.SSLContext` instance" -msgstr "" +msgstr "``'sslcontext'``: :class:`ssl.SSLContext` instance" msgid "" "``'ssl_object'``: :class:`ssl.SSLObject` or :class:`ssl.SSLSocket` instance" @@ -339,8 +336,8 @@ msgid "" msgstr "" msgid "" -"Return :const:`True` if the transport supports :meth:`~WriteTransport." -"write_eof`, :const:`False` if not." +"Return :const:`True` if the transport " +"supports :meth:`~WriteTransport.write_eof`, :const:`False` if not." msgstr "" msgid "Return the current size of the output buffer used by the transport." @@ -358,18 +355,18 @@ msgid "Set the *high* and *low* watermarks for write flow control." msgstr "" msgid "" -"These two values (measured in number of bytes) control when the protocol's :" -"meth:`protocol.pause_writing() ` and :meth:" -"`protocol.resume_writing() ` methods are " -"called. If specified, the low watermark must be less than or equal to the " -"high watermark. Neither *high* nor *low* can be negative." +"These two values (measured in number of bytes) control when the " +"protocol's :meth:`protocol.pause_writing() ` " +"and :meth:`protocol.resume_writing() ` methods " +"are called. If specified, the low watermark must be less than or equal to " +"the high watermark. Neither *high* nor *low* can be negative." msgstr "" msgid "" ":meth:`~BaseProtocol.pause_writing` is called when the buffer size becomes " -"greater than or equal to the *high* value. If writing has been paused, :meth:" -"`~BaseProtocol.resume_writing` is called when the buffer size becomes less " -"than or equal to the *low* value." +"greater than or equal to the *high* value. If writing has been " +"paused, :meth:`~BaseProtocol.resume_writing` is called when the buffer size " +"becomes less than or equal to the *low* value." msgstr "" msgid "" @@ -377,10 +374,10 @@ msgid "" "given, the low watermark defaults to an implementation-specific value less " "than or equal to the high watermark. Setting *high* to zero forces *low* to " "zero as well, and causes :meth:`~BaseProtocol.pause_writing` to be called " -"whenever the buffer becomes non-empty. Setting *low* to zero causes :meth:" -"`~BaseProtocol.resume_writing` to be called only once the buffer is empty. " -"Use of zero for either limit is generally sub-optimal as it reduces " -"opportunities for doing I/O and computation concurrently." +"whenever the buffer becomes non-empty. Setting *low* to zero " +"causes :meth:`~BaseProtocol.resume_writing` to be called only once the " +"buffer is empty. Use of zero for either limit is generally sub-optimal as it " +"reduces opportunities for doing I/O and computation concurrently." msgstr "" msgid "Use :meth:`~WriteTransport.get_write_buffer_limits` to get the limits." @@ -444,18 +441,18 @@ msgid "" msgstr "" msgid "" -"``0``: readable streaming transport of the standard input (*stdin*), or :" -"const:`None` if the subprocess was not created with ``stdin=PIPE``" +"``0``: writable streaming transport of the standard input (*stdin*), " +"or :const:`None` if the subprocess was not created with ``stdin=PIPE``" msgstr "" msgid "" -"``1``: writable streaming transport of the standard output (*stdout*), or :" -"const:`None` if the subprocess was not created with ``stdout=PIPE``" +"``1``: readable streaming transport of the standard output (*stdout*), " +"or :const:`None` if the subprocess was not created with ``stdout=PIPE``" msgstr "" msgid "" -"``2``: writable streaming transport of the standard error (*stderr*), or :" -"const:`None` if the subprocess was not created with ``stderr=PIPE``" +"``2``: readable streaming transport of the standard error (*stderr*), " +"or :const:`None` if the subprocess was not created with ``stderr=PIPE``" msgstr "" msgid "other *fd*: :const:`None`" @@ -479,8 +476,8 @@ msgid "See also :meth:`subprocess.Popen.kill`." msgstr "" msgid "" -"Send the *signal* number to the subprocess, as in :meth:`subprocess.Popen." -"send_signal`." +"Send the *signal* number to the subprocess, as " +"in :meth:`subprocess.Popen.send_signal`." msgstr "" msgid "Stop the subprocess." @@ -597,8 +594,9 @@ msgid "Called when the transport's buffer drains below the low watermark." msgstr "" msgid "" -"If the buffer size equals the high watermark, :meth:`~BaseProtocol." -"pause_writing` is not called: the buffer size must go strictly over." +"If the buffer size equals the high " +"watermark, :meth:`~BaseProtocol.pause_writing` is not called: the buffer " +"size must go strictly over." msgstr "" msgid "" @@ -611,11 +609,10 @@ msgid "Streaming Protocols" msgstr "" msgid "" -"Event methods, such as :meth:`loop.create_server`, :meth:`loop." -"create_unix_server`, :meth:`loop.create_connection`, :meth:`loop." -"create_unix_connection`, :meth:`loop.connect_accepted_socket`, :meth:`loop." -"connect_read_pipe`, and :meth:`loop.connect_write_pipe` accept factories " -"that return streaming protocols." +"Event methods, such " +"as :meth:`loop.create_server`, :meth:`loop.create_unix_server`, :meth:`loop.create_connection`, :meth:`loop.create_unix_connection`, :meth:`loop.connect_accepted_socket`, :meth:`loop.connect_read_pipe`, " +"and :meth:`loop.connect_write_pipe` accept factories that return streaming " +"protocols." msgstr "" msgid "" @@ -714,16 +711,16 @@ msgid "*nbytes* is the total number of bytes that were written to the buffer." msgstr "" msgid "" -"See the documentation of the :meth:`protocol.eof_received() ` method." +"See the documentation of the :meth:`protocol.eof_received() " +"` method." msgstr "" msgid "" ":meth:`~BufferedProtocol.get_buffer` can be called an arbitrary number of " "times during a connection. However, :meth:`protocol.eof_received() " -"` is called at most once and, if called, :meth:" -"`~BufferedProtocol.get_buffer` and :meth:`~BufferedProtocol.buffer_updated` " -"won't be called after it." +"` is called at most once and, if " +"called, :meth:`~BufferedProtocol.get_buffer` " +"and :meth:`~BufferedProtocol.buffer_updated` won't be called after it." msgstr "" msgid "" @@ -750,8 +747,8 @@ msgid "" msgstr "" msgid "" -"Called when a previous send or receive operation raises an :class:" -"`OSError`. *exc* is the :class:`OSError` instance." +"Called when a previous send or receive operation raises " +"an :class:`OSError`. *exc* is the :class:`OSError` instance." msgstr "" msgid "" @@ -767,10 +764,10 @@ msgid "" msgstr "" msgid "" -"The socket always appears 'ready' and excess packets are dropped. An :class:" -"`OSError` with ``errno`` set to :const:`errno.ENOBUFS` may or may not be " -"raised; if it is raised, it will be reported to :meth:`DatagramProtocol." -"error_received` but otherwise ignored." +"The socket always appears 'ready' and excess packets are dropped. " +"An :class:`OSError` with ``errno`` set to :const:`errno.ENOBUFS` may or may " +"not be raised; if it is raised, it will be reported " +"to :meth:`DatagramProtocol.error_received` but otherwise ignored." msgstr "" msgid "Subprocess Protocols" @@ -803,8 +800,8 @@ msgid "Called when the child process has exited." msgstr "" msgid "" -"It can be called before :meth:`~SubprocessProtocol.pipe_data_received` and :" -"meth:`~SubprocessProtocol.pipe_connection_lost` methods." +"It can be called before :meth:`~SubprocessProtocol.pipe_data_received` " +"and :meth:`~SubprocessProtocol.pipe_connection_lost` methods." msgstr "" msgid "Examples" @@ -1081,8 +1078,8 @@ msgstr "" msgid "" "The :ref:`watch a file descriptor for read events " -"` example uses the low-level :meth:`loop." -"add_reader` method to register an FD." +"` example uses the low-" +"level :meth:`loop.add_reader` method to register an FD." msgstr "" msgid "" @@ -1136,7 +1133,7 @@ msgid "" " # low-level APIs.\n" " loop = asyncio.get_running_loop()\n" "\n" -" code = 'import datetime; print(datetime.datetime.now())'\n" +" code = 'import datetime as dt; print(dt.datetime.now())'\n" " exit_future = asyncio.Future(loop=loop)\n" "\n" " # Create the subprocess controlled by DateProtocol;\n" diff --git a/library/asyncio-queue.po b/library/asyncio-queue.po index 0f2af8412b..5f744c7be1 100644 --- a/library/asyncio-queue.po +++ b/library/asyncio-queue.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,8 +36,8 @@ msgid "" msgstr "" msgid "" -"Note that methods of asyncio queues don't have a *timeout* parameter; use :" -"func:`asyncio.wait_for` function to do queue operations with a timeout." +"Note that methods of asyncio queues don't have a *timeout* parameter; " +"use :func:`asyncio.wait_for` function to do queue operations with a timeout." msgstr "" msgid "See also the `Examples`_ section below." @@ -78,8 +76,8 @@ msgid "Return ``True`` if there are :attr:`maxsize` items in the queue." msgstr "" msgid "" -"If the queue was initialized with ``maxsize=0`` (the default), then :meth:" -"`full` never returns ``True``." +"If the queue was initialized with ``maxsize=0`` (the default), " +"then :meth:`full` never returns ``True``." msgstr "" msgid "" @@ -96,15 +94,19 @@ msgid "" "Return an item if one is immediately available, else raise :exc:`QueueEmpty`." msgstr "" +msgid "" +"Raises :exc:`QueueShutDown` if the queue has been shut down and is empty." +msgstr "" + msgid "Block until all items in the queue have been received and processed." msgstr "" msgid "" "The count of unfinished tasks goes up whenever an item is added to the " -"queue. The count goes down whenever a consumer coroutine calls :meth:" -"`task_done` to indicate that the item was retrieved and all work on it is " -"complete. When the count of unfinished tasks drops to zero, :meth:`join` " -"unblocks." +"queue. The count goes down whenever a consumer coroutine " +"calls :meth:`task_done` to indicate that the item was retrieved and all work " +"on it is complete. When the count of unfinished tasks drops to " +"zero, :meth:`join` unblocks." msgstr "" msgid "" @@ -124,22 +126,44 @@ msgstr "" msgid "Return the number of items in the queue." msgstr "" +msgid "Put a :class:`Queue` instance into a shutdown mode." +msgstr "" + +msgid "" +"The queue can no longer grow. Future calls to :meth:`~Queue.put` " +"raise :exc:`QueueShutDown`. Currently blocked callers of :meth:`~Queue.put` " +"will be unblocked and will raise :exc:`QueueShutDown` in the formerly " +"awaiting task." +msgstr "" + +msgid "" +"If *immediate* is false (the default), the queue can be wound down normally " +"with :meth:`~Queue.get` calls to extract tasks that have already been loaded." +msgstr "" + +msgid "" +"And if :meth:`~Queue.task_done` is called for each remaining task, a " +"pending :meth:`~Queue.join` will be unblocked normally." +msgstr "" + msgid "" -"Shut down the queue, making :meth:`~Queue.get` and :meth:`~Queue.put` raise :" -"exc:`QueueShutDown`." +"Once the queue is empty, future calls to :meth:`~Queue.get` will " +"raise :exc:`QueueShutDown`." msgstr "" msgid "" -"By default, :meth:`~Queue.get` on a shut down queue will only raise once the " -"queue is empty. Set *immediate* to true to make :meth:`~Queue.get` raise " -"immediately instead." +"If *immediate* is true, the queue is terminated immediately. The queue is " +"drained to be completely empty and the count of unfinished tasks is reduced " +"by the number of tasks drained. If unfinished tasks is zero, callers " +"of :meth:`~Queue.join` are unblocked. Also, blocked callers " +"of :meth:`~Queue.get` are unblocked and will raise :exc:`QueueShutDown` " +"because the queue is empty." msgstr "" msgid "" -"All blocked callers of :meth:`~Queue.put` and :meth:`~Queue.get` will be " -"unblocked. If *immediate* is true, a task will be marked as done for each " -"remaining item in the queue, which may unblock callers of :meth:`~Queue." -"join`." +"Use caution when using :meth:`~Queue.join` with *immediate* set to true. " +"This unblocks the join even when no work has been done on the tasks, " +"violating the usual invariant for joining a queue." msgstr "" msgid "Indicate that a formerly enqueued work item is complete." @@ -157,11 +181,6 @@ msgid "" "item that had been :meth:`~Queue.put` into the queue)." msgstr "" -msgid "" -"``shutdown(immediate=True)`` calls :meth:`task_done` for each remaining item " -"in the queue." -msgstr "" - msgid "" "Raises :exc:`ValueError` if called more times than there were items placed " "in the queue." @@ -200,8 +219,9 @@ msgid "" msgstr "" msgid "" -"Exception raised when :meth:`~Queue.put` or :meth:`~Queue.get` is called on " -"a queue which has been shut down." +"Exception raised " +"when :meth:`~Queue.put`, :meth:`~Queue.put_nowait`, :meth:`~Queue.get` " +"or :meth:`~Queue.get_nowait` is called on a queue which has been shut down." msgstr "" msgid "Examples" diff --git a/library/asyncio-runner.po b/library/asyncio-runner.po index dcc6f8b2eb..ff5a421e37 100644 --- a/library/asyncio-runner.po +++ b/library/asyncio-runner.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2022-11-05 19:48+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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 "Runners" msgstr "" msgid "**Source code:** :source:`Lib/asyncio/runners.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/asyncio/runners.py`" msgid "" "This section outlines high-level asyncio primitives to run asyncio code." @@ -56,8 +56,8 @@ msgstr "" msgid "" "If *debug* is ``True``, the event loop will be run in debug mode. ``False`` " -"disables debug mode explicitly. ``None`` is used to respect the global :ref:" -"`asyncio-debug-mode` settings." +"disables debug mode explicitly. ``None`` is used to respect the " +"global :ref:`asyncio-debug-mode` settings." msgstr "" msgid "" @@ -65,8 +65,9 @@ msgid "" "otherwise :func:`asyncio.new_event_loop` is used. The loop is closed at the " "end. This function should be used as a main entry point for asyncio " "programs, and should ideally only be called once. It is recommended to use " -"*loop_factory* to configure the event loop instead of policies. Passing :" -"class:`asyncio.EventLoop` allows running asyncio without the policy system." +"*loop_factory* to configure the event loop instead of policies. " +"Passing :class:`asyncio.EventLoop` allows running asyncio without the policy " +"system." msgstr "" msgid "" @@ -105,8 +106,8 @@ msgid "" msgstr "" msgid "" -"Sometimes several top-level async functions should be called in the same :" -"ref:`event loop ` and :class:`contextvars.Context`." +"Sometimes several top-level async functions should be called in the " +"same :ref:`event loop ` and :class:`contextvars.Context`." msgstr "" msgid "" @@ -137,9 +138,9 @@ 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``." +"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." @@ -167,10 +168,10 @@ msgid "Handling Keyboard Interruption" msgstr "" msgid "" -"When :const:`signal.SIGINT` is raised by :kbd:`Ctrl-C`, :exc:" -"`KeyboardInterrupt` exception is raised in the main thread by default. " -"However this doesn't work with :mod:`asyncio` because it can interrupt " -"asyncio internals and can hang the program from exiting." +"When :const:`signal.SIGINT` is raised by :kbd:`Ctrl-" +"C`, :exc:`KeyboardInterrupt` exception is raised in the main thread by " +"default. However this doesn't work with :mod:`asyncio` because it can " +"interrupt asyncio internals and can hang the program from exiting." msgstr "" msgid "" @@ -194,13 +195,13 @@ msgid "" "handler cancels the main task by calling :meth:`asyncio.Task.cancel` which " "raises :exc:`asyncio.CancelledError` inside the main task. This causes the " "Python stack to unwind, ``try/except`` and ``try/finally`` blocks can be " -"used for resource cleanup. After the main task is cancelled, :meth:`asyncio." -"Runner.run` raises :exc:`KeyboardInterrupt`." +"used for resource cleanup. After the main task is " +"cancelled, :meth:`asyncio.Runner.run` raises :exc:`KeyboardInterrupt`." msgstr "" msgid "" -"A user could write a tight loop which cannot be interrupted by :meth:" -"`asyncio.Task.cancel`, in which case the second following :kbd:`Ctrl-C` " -"immediately raises the :exc:`KeyboardInterrupt` without cancelling the main " -"task." +"A user could write a tight loop which cannot be interrupted " +"by :meth:`asyncio.Task.cancel`, in which case the second " +"following :kbd:`Ctrl-C` immediately raises the :exc:`KeyboardInterrupt` " +"without cancelling the main task." msgstr "" diff --git a/library/asyncio-stream.po b/library/asyncio-stream.po index 3511d19df7..7afe211098 100644 --- a/library/asyncio-stream.po +++ b/library/asyncio-stream.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,24 +76,25 @@ msgid "" msgstr "" msgid "" -"The returned *reader* and *writer* objects are instances of :class:" -"`StreamReader` and :class:`StreamWriter` classes." +"The returned *reader* and *writer* objects are instances " +"of :class:`StreamReader` and :class:`StreamWriter` classes." msgstr "" msgid "" -"*limit* determines the buffer size limit used by the returned :class:" -"`StreamReader` instance. By default the *limit* is set to 64 KiB." +"*limit* determines the buffer size limit used by the " +"returned :class:`StreamReader` instance. By default the *limit* is set to " +"64 KiB." msgstr "" msgid "" -"The rest of the arguments are passed directly to :meth:`loop." -"create_connection`." +"The rest of the arguments are passed directly " +"to :meth:`loop.create_connection`." msgstr "" msgid "" -"The *sock* argument transfers ownership of the socket to the :class:" -"`StreamWriter` created. To close the socket, call its :meth:`~asyncio." -"StreamWriter.close` method." +"The *sock* argument transfers ownership of the socket to " +"the :class:`StreamWriter` created. To close the socket, call " +"its :meth:`~asyncio.StreamWriter.close` method." msgstr "" msgid "Added the *ssl_handshake_timeout* parameter." @@ -167,6 +167,12 @@ msgstr "" msgid "Similar to :func:`start_server` but works with Unix sockets." msgstr "" +msgid "" +"If *cleanup_socket* is true then the Unix socket will automatically be " +"removed from the filesystem when the server is closed, unless the socket has " +"been replaced after the server has been created." +msgstr "" + msgid "See also the documentation of :meth:`loop.create_unix_server`." msgstr "" @@ -175,18 +181,21 @@ msgid "" "parameter can now be a :term:`path-like object`." msgstr "" +msgid "Added the *cleanup_socket* parameter." +msgstr "" + msgid "StreamReader" msgstr "" msgid "" "Represents a reader object that provides APIs to read data from the IO " -"stream. As an :term:`asynchronous iterable`, the object supports the :" -"keyword:`async for` statement." +"stream. As an :term:`asynchronous iterable`, the object supports " +"the :keyword:`async for` statement." msgstr "" msgid "" -"It is not recommended to instantiate *StreamReader* objects directly; use :" -"func:`open_connection` and :func:`start_server` instead." +"It is not recommended to instantiate *StreamReader* objects directly; " +"use :func:`open_connection` and :func:`start_server` instead." msgstr "" msgid "Acknowledge the EOF." @@ -242,15 +251,15 @@ msgid "" msgstr "" msgid "" -"If the amount of data read exceeds the configured stream limit, a :exc:" -"`LimitOverrunError` exception is raised, and the data is left in the " +"If the amount of data read exceeds the configured stream limit, " +"a :exc:`LimitOverrunError` exception is raised, and the data is left in the " "internal buffer and can be read again." msgstr "" msgid "" -"If EOF is reached before the complete separator is found, an :exc:" -"`IncompleteReadError` exception is raised, and the internal buffer is " -"reset. The :attr:`IncompleteReadError.partial` attribute may contain a " +"If EOF is reached before the complete separator is found, " +"an :exc:`IncompleteReadError` exception is raised, and the internal buffer " +"is reset. The :attr:`IncompleteReadError.partial` attribute may contain a " "portion of the separator." msgstr "" @@ -275,8 +284,8 @@ msgid "" msgstr "" msgid "" -"It is not recommended to instantiate *StreamWriter* objects directly; use :" -"func:`open_connection` and :func:`start_server` instead." +"It is not recommended to instantiate *StreamWriter* objects directly; " +"use :func:`open_connection` and :func:`start_server` instead." msgstr "" msgid "" @@ -285,6 +294,11 @@ msgid "" "until it can be sent." msgstr "" +msgid "" +"The *data* buffer should be a bytes, bytearray, or C-contiguous one-" +"dimensional memoryview object." +msgstr "" + msgid "The method should be used along with the ``drain()`` method::" msgstr "" @@ -330,8 +344,8 @@ msgid "Return the underlying asyncio transport." msgstr "" msgid "" -"Access optional transport information; see :meth:`BaseTransport." -"get_extra_info` for details." +"Access optional transport information; " +"see :meth:`BaseTransport.get_extra_info` for details." msgstr "" msgid "Wait until it is appropriate to resume writing to the stream. Example::" @@ -346,8 +360,16 @@ msgid "" "This is a flow control method that interacts with the underlying IO write " "buffer. When the size of the buffer reaches the high watermark, *drain()* " "blocks until the size of the buffer is drained down to the low watermark and " -"writing can be resumed. When there is nothing to wait for, the :meth:" -"`drain` returns immediately." +"writing can be resumed. When there is nothing to wait for, " +"the :meth:`drain` returns immediately." +msgstr "" + +msgid "" +"When the write buffer is below the high watermark, :meth:`drain` returns " +"immediately without yielding to the event loop. As a result, code which " +"repeatedly calls ``write()`` followed by ``await drain()`` may prevent other " +"tasks from running. To prevent blocking behavior, yield to the event loop " +"explicitly with ``await asyncio.sleep(0)`` (see :func:`asyncio.sleep`)." msgstr "" msgid "Upgrade an existing stream-based connection to TLS." @@ -376,6 +398,11 @@ msgid "" "(default)." msgstr "" +msgid "" +"Raises a ``ValueError`` if ``sslcontext.check_hostname`` is ``True`` and " +"``server_hostname`` is not supplied." +msgstr "" + msgid "" "Return ``True`` if the stream is closed or in the process of being closed." msgstr "" @@ -400,8 +427,8 @@ msgstr "" msgid "" "The :ref:`TCP echo client protocol " -"` example uses the low-level :meth:" -"`loop.create_connection` method." +"` example uses the low-" +"level :meth:`loop.create_connection` method." msgstr "" msgid "TCP echo server using streams" @@ -443,8 +470,8 @@ msgstr "" msgid "" "The :ref:`TCP echo server protocol " -"` example uses the :meth:`loop." -"create_server` method." +"` example uses " +"the :meth:`loop.create_server` method." msgstr "" msgid "Get HTTP headers" @@ -508,8 +535,8 @@ msgid "Register an open socket to wait for data using streams" msgstr "" msgid "" -"Coroutine waiting until a socket receives data using the :func:" -"`open_connection` function::" +"Coroutine waiting until a socket receives data using " +"the :func:`open_connection` function::" msgstr "" msgid "" @@ -552,6 +579,6 @@ msgstr "" msgid "" "The :ref:`watch a file descriptor for read events " -"` example uses the low-level :meth:`loop." -"add_reader` method to watch a file descriptor." +"` example uses the low-" +"level :meth:`loop.add_reader` method to watch a file descriptor." msgstr "" diff --git a/library/asyncio-subprocess.po b/library/asyncio-subprocess.po index 32502929e4..ff5a1a4e7d 100644 --- a/library/asyncio-subprocess.po +++ b/library/asyncio-subprocess.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -101,9 +99,9 @@ msgstr "" msgid "" "The *limit* argument sets the buffer limit for :class:`StreamReader` " -"wrappers for :attr:`~asyncio.subprocess.Process.stdout` and :attr:`~asyncio." -"subprocess.Process.stderr` (if :const:`subprocess.PIPE` is passed to " -"*stdout* and *stderr* arguments)." +"wrappers for :attr:`~asyncio.subprocess.Process.stdout` " +"and :attr:`~asyncio.subprocess.Process.stderr` (if :const:`subprocess.PIPE` " +"is passed to *stdout* and *stderr* arguments)." msgstr "" msgid "Return a :class:`~asyncio.subprocess.Process` instance." @@ -113,6 +111,11 @@ msgid "" "See the documentation of :meth:`loop.subprocess_exec` for other parameters." msgstr "" +msgid "" +"If the process object is garbage collected while the process is still " +"running, the child process will be killed." +msgstr "" + msgid "Removed the *loop* parameter." msgstr "" @@ -139,11 +142,10 @@ msgid "" msgstr "" msgid "" -"asyncio also has the following *low-level* APIs to work with subprocesses: :" -"meth:`loop.subprocess_exec`, :meth:`loop.subprocess_shell`, :meth:`loop." -"connect_read_pipe`, :meth:`loop.connect_write_pipe`, as well as the :ref:" -"`Subprocess Transports ` and :ref:`Subprocess " -"Protocols `." +"asyncio also has the following *low-level* APIs to work with " +"subprocesses: :meth:`loop.subprocess_exec`, :meth:`loop.subprocess_shell`, :meth:`loop.connect_read_pipe`, :meth:`loop.connect_write_pipe`, " +"as well as the :ref:`Subprocess Transports ` " +"and :ref:`Subprocess Protocols `." msgstr "" msgid "Constants" @@ -153,16 +155,16 @@ msgid "Can be passed to the *stdin*, *stdout* or *stderr* parameters." msgstr "" msgid "" -"If *PIPE* is passed to *stdin* argument, the :attr:`Process.stdin ` attribute will point to a :class:`~asyncio." -"StreamWriter` instance." +"If *PIPE* is passed to *stdin* argument, the :attr:`Process.stdin " +"` attribute will point to " +"a :class:`~asyncio.StreamWriter` instance." msgstr "" msgid "" -"If *PIPE* is passed to *stdout* or *stderr* arguments, the :attr:`Process." -"stdout ` and :attr:`Process.stderr " -"` attributes will point to :class:" -"`~asyncio.StreamReader` instances." +"If *PIPE* is passed to *stdout* or *stderr* arguments, " +"the :attr:`Process.stdout ` " +"and :attr:`Process.stderr ` attributes " +"will point to :class:`~asyncio.StreamReader` instances." msgstr "" msgid "" @@ -172,8 +174,8 @@ msgstr "" msgid "" "Special value that can be used as the *stdin*, *stdout* or *stderr* argument " -"to process creation functions. It indicates that the special file :data:`os." -"devnull` will be used for the corresponding subprocess stream." +"to process creation functions. It indicates that the special " +"file :data:`os.devnull` will be used for the corresponding subprocess stream." msgstr "" msgid "Interacting with Subprocesses" @@ -187,25 +189,25 @@ msgid "" msgstr "" msgid "" -"An object that wraps OS processes created by the :func:`~asyncio." -"create_subprocess_exec` and :func:`~asyncio.create_subprocess_shell` " -"functions." +"An object that wraps OS processes created by " +"the :func:`~asyncio.create_subprocess_exec` " +"and :func:`~asyncio.create_subprocess_shell` functions." msgstr "" msgid "" -"This class is designed to have a similar API to the :class:`subprocess." -"Popen` class, but there are some notable differences:" +"This class is designed to have a similar API to " +"the :class:`subprocess.Popen` class, but there are some notable differences:" msgstr "" msgid "" -"unlike Popen, Process instances do not have an equivalent to the :meth:" -"`~subprocess.Popen.poll` method;" +"unlike Popen, Process instances do not have an equivalent to " +"the :meth:`~subprocess.Popen.poll` method;" msgstr "" msgid "" -"the :meth:`~asyncio.subprocess.Process.communicate` and :meth:`~asyncio." -"subprocess.Process.wait` methods don't have a *timeout* parameter: use the :" -"func:`~asyncio.wait_for` function;" +"the :meth:`~asyncio.subprocess.Process.communicate` " +"and :meth:`~asyncio.subprocess.Process.wait` methods don't have a *timeout* " +"parameter: use the :func:`~asyncio.wait_for` function;" msgstr "" msgid "" @@ -342,9 +344,9 @@ msgid "Process identification number (PID)." msgstr "" msgid "" -"Note that for processes created by the :func:`~asyncio." -"create_subprocess_shell` function, this attribute is the PID of the spawned " -"shell." +"Note that for processes created by " +"the :func:`~asyncio.create_subprocess_shell` function, this attribute is the " +"PID of the spawned shell." msgstr "" msgid "Return code of the process when it exits." @@ -354,10 +356,18 @@ msgid "A ``None`` value indicates that the process has not terminated yet." msgstr "" msgid "" -"A negative value ``-N`` indicates that the child was terminated by signal " +"For processes created with :func:`~asyncio.create_subprocess_exec`, a " +"negative value ``-N`` indicates that the child was terminated by signal " "``N`` (POSIX only)." msgstr "" +msgid "" +"For processes created with :func:`~asyncio.create_subprocess_shell`, the " +"return code reflects the exit status of the shell itself (e.g. ``/bin/sh``), " +"which may map signals to codes such as ``128+N``. See the documentation of " +"the shell (for example, the Bash manual's Exit Status) for details." +msgstr "" + msgid "Subprocess and Threads" msgstr "" @@ -372,8 +382,8 @@ msgid "" msgstr "" msgid "" -"On UNIX *child watchers* are used for subprocess finish waiting, see :ref:" -"`asyncio-watchers` for more info." +"On UNIX *child watchers* are used for subprocess finish waiting, " +"see :ref:`asyncio-watchers` for more info." msgstr "" msgid "" @@ -382,8 +392,8 @@ msgid "" msgstr "" msgid "" -"Spawning a subprocess with *inactive* current child watcher raises :exc:" -"`RuntimeError`." +"Spawning a subprocess with *inactive* current child watcher " +"raises :exc:`RuntimeError`." msgstr "" msgid "" @@ -414,7 +424,7 @@ msgid "" "import sys\n" "\n" "async def get_date():\n" -" code = 'import datetime; print(datetime.datetime.now())'\n" +" code = 'import datetime as dt; print(dt.datetime.now())'\n" "\n" " # Create the subprocess; redirect the standard output\n" " # into a pipe.\n" diff --git a/library/asyncio-sync.po b/library/asyncio-sync.po index 0c47de161f..225a1c7713 100644 --- a/library/asyncio-sync.po +++ b/library/asyncio-sync.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -148,8 +147,8 @@ msgid "" msgstr "" msgid "" -"An Event object manages an internal flag that can be set to *true* with the :" -"meth:`~Event.set` method and reset to *false* with the :meth:`clear` " +"An Event object manages an internal flag that can be set to *true* with " +"the :meth:`~Event.set` method and reset to *false* with the :meth:`clear` " "method. The :meth:`~Event.wait` method blocks until the flag is set to " "*true*. The flag is set to *false* initially." msgstr "" @@ -198,8 +197,8 @@ msgid "Clear (unset) the event." msgstr "" msgid "" -"Tasks awaiting on :meth:`~Event.wait` will now block until the :meth:`~Event." -"set` method is called again." +"Subsequent tasks awaiting on :meth:`~Event.wait` will now block until " +"the :meth:`~Event.set` method is called again." msgstr "" msgid "Return ``True`` if the event is set." @@ -217,11 +216,11 @@ msgid "" msgstr "" msgid "" -"In essence, a Condition object combines the functionality of an :class:" -"`Event` and a :class:`Lock`. It is possible to have multiple Condition " -"objects share one Lock, which allows coordinating exclusive access to a " -"shared resource between different tasks interested in particular states of " -"that shared resource." +"In essence, a Condition object combines the functionality of " +"an :class:`Event` and a :class:`Lock`. It is possible to have multiple " +"Condition objects share one Lock, which allows coordinating exclusive access " +"to a shared resource between different tasks interested in particular states " +"of that shared resource." msgstr "" msgid "" @@ -290,8 +289,8 @@ msgid "Wait until notified." msgstr "" msgid "" -"If the calling task has not acquired the lock when this method is called, a :" -"exc:`RuntimeError` is raised." +"If the calling task has not acquired the lock when this method is called, " +"a :exc:`RuntimeError` is raised." msgstr "" msgid "" @@ -302,9 +301,9 @@ msgstr "" msgid "" "Note that a task *may* return from this call spuriously, which is why the " -"caller should always re-check the state and be prepared to :meth:`~Condition." -"wait` again. For this reason, you may prefer to use :meth:`~Condition." -"wait_for` instead." +"caller should always re-check the state and be prepared " +"to :meth:`~Condition.wait` again. For this reason, you may prefer to " +"use :meth:`~Condition.wait_for` instead." msgstr "" msgid "Wait until a predicate becomes *true*." @@ -323,16 +322,16 @@ msgid "A Semaphore object. Not thread-safe." msgstr "" msgid "" -"A semaphore manages an internal counter which is decremented by each :meth:" -"`acquire` call and incremented by each :meth:`release` call. The counter can " -"never go below zero; when :meth:`acquire` finds that it is zero, it blocks, " -"waiting until some task calls :meth:`release`." +"A semaphore manages an internal counter which is decremented by " +"each :meth:`acquire` call and incremented by each :meth:`release` call. The " +"counter can never go below zero; when :meth:`acquire` finds that it is zero, " +"it blocks, waiting until some task calls :meth:`release`." msgstr "" msgid "" "The optional *value* argument gives the initial value for the internal " -"counter (``1`` by default). If the given value is less than ``0`` a :exc:" -"`ValueError` is raised." +"counter (``1`` by default). If the given value is less than ``0`` " +"a :exc:`ValueError` is raised." msgstr "" msgid "" @@ -387,9 +386,9 @@ msgid "A bounded semaphore object. Not thread-safe." msgstr "" msgid "" -"Bounded Semaphore is a version of :class:`Semaphore` that raises a :exc:" -"`ValueError` in :meth:`~Semaphore.release` if it increases the internal " -"counter above the initial *value*." +"Bounded Semaphore is a version of :class:`Semaphore` that raises " +"a :exc:`ValueError` in :meth:`~Semaphore.release` if it increases the " +"internal counter above the initial *value*." msgstr "" msgid "Barrier" @@ -400,15 +399,15 @@ msgstr "" msgid "" "A barrier is a simple synchronization primitive that allows to block until " -"*parties* number of tasks are waiting on it. Tasks can wait on the :meth:" -"`~Barrier.wait` method and would be blocked until the specified number of " -"tasks end up waiting on :meth:`~Barrier.wait`. At that point all of the " -"waiting tasks would unblock simultaneously." +"*parties* number of tasks are waiting on it. Tasks can wait on " +"the :meth:`~Barrier.wait` method and would be blocked until the specified " +"number of tasks end up waiting on :meth:`~Barrier.wait`. At that point all " +"of the waiting tasks would unblock simultaneously." msgstr "" msgid "" -":keyword:`async with` can be used as an alternative to awaiting on :meth:" -"`~Barrier.wait`." +":keyword:`async with` can be used as an alternative to awaiting " +"on :meth:`~Barrier.wait`." msgstr "" msgid "The barrier can be reused any number of times." @@ -474,8 +473,8 @@ msgstr "" msgid "" "This method may raise a :class:`BrokenBarrierError` exception if the barrier " -"is broken or reset while a task is waiting. It could raise a :exc:" -"`CancelledError` if a task is cancelled." +"is broken or reset while a task is waiting. It could raise " +"a :exc:`CancelledError` if a task is cancelled." msgstr "" msgid "" @@ -505,12 +504,12 @@ msgid "A boolean that is ``True`` if the barrier is in the broken state." msgstr "" msgid "" -"This exception, a subclass of :exc:`RuntimeError`, is raised when the :class:" -"`Barrier` object is reset or broken." +"This exception, a subclass of :exc:`RuntimeError`, is raised when " +"the :class:`Barrier` object is reset or broken." msgstr "" msgid "" -"Acquiring a lock using ``await lock`` or ``yield from lock`` and/or :keyword:" -"`with` statement (``with await lock``, ``with (yield from lock)``) was " -"removed. Use ``async with lock`` instead." +"Acquiring a lock using ``await lock`` or ``yield from lock`` and/" +"or :keyword:`with` statement (``with await lock``, ``with (yield from " +"lock)``) was removed. Use ``async with lock`` instead." msgstr "" diff --git a/library/asyncio-task.po b/library/asyncio-task.po index e4881dc7b5..fd618777a1 100644 --- a/library/asyncio-task.po +++ b/library/asyncio-task.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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 +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 "Coroutines and Tasks" +msgid "Coroutines and tasks" msgstr "" msgid "" @@ -152,8 +151,8 @@ msgid "" msgstr "" msgid "" -"The :class:`asyncio.TaskGroup` class provides a more modern alternative to :" -"func:`create_task`. Using this API, the last example becomes::" +"The :class:`asyncio.TaskGroup` class provides a more modern alternative " +"to :func:`create_task`. Using this API, the last example becomes::" msgstr "" msgid "" @@ -182,8 +181,8 @@ msgid "Awaitables" msgstr "" msgid "" -"We say that an object is an **awaitable** object if it can be used in an :" -"keyword:`await` expression. Many asyncio APIs are designed to accept " +"We say that an object is an **awaitable** object if it can be used in " +"an :keyword:`await` expression. Many asyncio APIs are designed to accept " "awaitables." msgstr "" @@ -234,8 +233,9 @@ msgid "*Tasks* are used to schedule coroutines *concurrently*." msgstr "" msgid "" -"When a coroutine is wrapped into a *Task* with functions like :func:`asyncio." -"create_task` the coroutine is automatically scheduled to run soon::" +"When a coroutine is wrapped into a *Task* with functions " +"like :func:`asyncio.create_task` the coroutine is automatically scheduled to " +"run soon::" msgstr "" msgid "" @@ -296,11 +296,11 @@ msgid "" msgstr "" msgid "" -"A good example of a low-level function that returns a Future object is :meth:" -"`loop.run_in_executor`." +"A good example of a low-level function that returns a Future object " +"is :meth:`loop.run_in_executor`." msgstr "" -msgid "Creating Tasks" +msgid "Creating tasks" msgstr "" msgid "**Source code:** :source:`Lib/asyncio/tasks.py`" @@ -312,19 +312,20 @@ msgid "" msgstr "" msgid "" -"If *name* is not ``None``, it is set as the name of the task using :meth:" -"`Task.set_name`." +"If *name* is 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." +"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 "" -"The task is executed in the loop returned by :func:`get_running_loop`, :exc:" -"`RuntimeError` is raised if there is no running loop in current thread." +"The task is executed in the loop returned " +"by :func:`get_running_loop`, :exc:`RuntimeError` is raised if there is no " +"running loop in current thread." msgstr "" msgid "" @@ -356,39 +357,55 @@ msgid "" " task.add_done_callback(background_tasks.discard)" msgstr "" +msgid "" +"Note that this approach never awaits the tasks, so if a task fails, its " +"exception is never retrieved and asyncio logs a \"Task exception was never " +"retrieved\" message when the task is garbage collected. To avoid this, " +"use :class:`asyncio.TaskGroup` which keeps a strong reference to each task, " +"awaits them and propagates their exceptions::" +msgstr "" + +msgid "" +"async with asyncio.TaskGroup() as tg:\n" +" for i in range(10):\n" +" tg.create_task(some_coro(param=i))" +msgstr "" + msgid "Added the *name* parameter." msgstr "" msgid "Added the *context* parameter." msgstr "" -msgid "Task Cancellation" +msgid "Task cancellation" msgstr "" msgid "" -"Tasks can easily and safely be cancelled. When a task is cancelled, :exc:" -"`asyncio.CancelledError` will be raised in the task at the next opportunity." +"Tasks can easily and safely be cancelled. When a task is " +"cancelled, :exc:`asyncio.CancelledError` will be raised in the task at the " +"next opportunity." msgstr "" msgid "" "It is recommended that coroutines use ``try/finally`` blocks to robustly " "perform clean-up logic. In case :exc:`asyncio.CancelledError` is explicitly " -"caught, it should generally be propagated when clean-up is complete. :exc:" -"`asyncio.CancelledError` directly subclasses :exc:`BaseException` so most " -"code will not need to be aware of it." +"caught, it should generally be propagated when clean-up is " +"complete. :exc:`asyncio.CancelledError` directly " +"subclasses :exc:`BaseException` so most code will not need to be aware of it." msgstr "" msgid "" -"The asyncio components that enable structured concurrency, like :class:" -"`asyncio.TaskGroup` and :func:`asyncio.timeout`, are implemented using " -"cancellation internally and might misbehave if a coroutine swallows :exc:" -"`asyncio.CancelledError`. Similarly, user code should not generally call :" -"meth:`uncancel `. However, in cases when suppressing :" -"exc:`asyncio.CancelledError` is truly desired, it is necessary to also call " -"``uncancel()`` to completely remove the cancellation state." +"The asyncio components that enable structured concurrency, " +"like :class:`asyncio.TaskGroup` and :func:`asyncio.timeout`, are implemented " +"using cancellation internally and might misbehave if a coroutine " +"swallows :exc:`asyncio.CancelledError`. Similarly, user code should not " +"generally call :meth:`uncancel `. However, in cases " +"when suppressing :exc:`asyncio.CancelledError` is truly desired, it is " +"necessary to also call ``uncancel()`` to completely remove the cancellation " +"state." msgstr "" -msgid "Task Groups" +msgid "Task groups" msgstr "" msgid "" @@ -403,10 +420,10 @@ msgid "" msgstr "" msgid "" -"Create a task in this task group. The signature matches that of :func:" -"`asyncio.create_task`. If the task group is inactive (e.g. not yet entered, " -"already finished, or in the process of shutting down), we will close the " -"given ``coro``." +"Create a task in this task group. The signature matches that " +"of :func:`asyncio.create_task`. If the task group is inactive (e.g. not yet " +"entered, already finished, or in the process of shutting down), we will " +"close the given ``coro`` and raise :exc:`RuntimeError`." msgstr "" msgid "Close the given coroutine if the task group is not active." @@ -420,8 +437,8 @@ msgid "" " async with asyncio.TaskGroup() as tg:\n" " task1 = tg.create_task(some_coro(...))\n" " task2 = tg.create_task(another_coro(...))\n" -" print(f\"Both tasks have completed now: {task1.result()}, {task2." -"result()}\")" +" print(f\"Both tasks have completed now: {task1.result()}, " +"{task2.result()}\")" msgstr "" msgid "" @@ -436,11 +453,11 @@ msgid "" "The first time any of the tasks belonging to the group fails with an " "exception other than :exc:`asyncio.CancelledError`, the remaining tasks in " "the group are cancelled. No further tasks can then be added to the group. At " -"this point, if the body of the ``async with`` statement is still active (i." -"e., :meth:`~object.__aexit__` hasn't been called yet), the task directly " -"containing the ``async with`` statement is also cancelled. The resulting :" -"exc:`asyncio.CancelledError` will interrupt an ``await``, but it will not " -"bubble out of the containing ``async with`` statement." +"this point, if the body of the ``async with`` statement is still active " +"(i.e., :meth:`~object.__aexit__` hasn't been called yet), the task directly " +"containing the ``async with`` statement is also cancelled. The " +"resulting :exc:`asyncio.CancelledError` will interrupt an ``await``, but it " +"will not bubble out of the containing ``async with`` statement." msgstr "" msgid "" @@ -451,22 +468,23 @@ msgid "" msgstr "" msgid "" -"Two base exceptions are treated specially: If any task fails with :exc:" -"`KeyboardInterrupt` or :exc:`SystemExit`, the task group still cancels the " -"remaining tasks and waits for them, but then the initial :exc:" -"`KeyboardInterrupt` or :exc:`SystemExit` is re-raised instead of :exc:" -"`ExceptionGroup` or :exc:`BaseExceptionGroup`." +"Two base exceptions are treated specially: If any task fails " +"with :exc:`KeyboardInterrupt` or :exc:`SystemExit`, the task group still " +"cancels the remaining tasks and waits for them, but then the " +"initial :exc:`KeyboardInterrupt` or :exc:`SystemExit` is re-raised instead " +"of :exc:`ExceptionGroup` or :exc:`BaseExceptionGroup`." msgstr "" msgid "" -"If the body of the ``async with`` statement exits with an exception (so :" -"meth:`~object.__aexit__` is called with an exception set), this is treated " -"the same as if one of the tasks failed: the remaining tasks are cancelled " -"and then waited for, and non-cancellation exceptions are grouped into an " -"exception group and raised. The exception passed into :meth:`~object." -"__aexit__`, unless it is :exc:`asyncio.CancelledError`, is also included in " -"the exception group. The same special case is made for :exc:" -"`KeyboardInterrupt` and :exc:`SystemExit` as in the previous paragraph." +"If the body of the ``async with`` statement exits with an exception " +"(so :meth:`~object.__aexit__` is called with an exception set), this is " +"treated the same as if one of the tasks failed: the remaining tasks are " +"cancelled and then waited for, and non-cancellation exceptions are grouped " +"into an exception group and raised. The exception passed " +"into :meth:`~object.__aexit__`, unless it is :exc:`asyncio.CancelledError`, " +"is also included in the exception group. The same special case is made " +"for :exc:`KeyboardInterrupt` and :exc:`SystemExit` as in the previous " +"paragraph." msgstr "" msgid "" @@ -481,14 +499,15 @@ msgstr "" msgid "" "In the case where a task group is cancelled externally and also must raise " -"an :exc:`ExceptionGroup`, it will call the parent task's :meth:`~asyncio." -"Task.cancel` method. This ensures that a :exc:`asyncio.CancelledError` will " -"be raised at the next :keyword:`await`, so the cancellation is not lost." +"an :exc:`ExceptionGroup`, it will call the parent " +"task's :meth:`~asyncio.Task.cancel` method. This ensures that " +"a :exc:`asyncio.CancelledError` will be raised at the next :keyword:`await`, " +"so the cancellation is not lost." msgstr "" msgid "" -"Task groups preserve the cancellation count reported by :meth:`asyncio.Task." -"cancelling`." +"Task groups preserve the cancellation count reported " +"by :meth:`asyncio.Task.cancelling`." msgstr "" msgid "" @@ -496,7 +515,7 @@ msgid "" "correct preservation of cancellation counts." msgstr "" -msgid "Terminating a Task Group" +msgid "Terminating a task group" msgstr "" msgid "" @@ -573,13 +592,13 @@ msgstr "" msgid "" "import asyncio\n" -"import datetime\n" +"import datetime as dt\n" "\n" "async def display_date():\n" " loop = asyncio.get_running_loop()\n" " end_time = loop.time() + 5.0\n" " while True:\n" -" print(datetime.datetime.now())\n" +" print(dt.datetime.now())\n" " if (loop.time() + 1.0) >= end_time:\n" " break\n" " await asyncio.sleep(1)\n" @@ -593,7 +612,7 @@ msgstr "" msgid "Raises :exc:`ValueError` if *delay* is :data:`~math.nan`." msgstr "" -msgid "Running Tasks Concurrently" +msgid "Running tasks concurrently" msgstr "" msgid "" @@ -642,7 +661,7 @@ msgid "" "safety guarantees than *gather* for scheduling a nesting of subtasks: if a " "task (or a subtask, a task scheduled by a task) raises an exception, " "*TaskGroup* will, while *gather* will not, cancel the remaining scheduled " -"tasks)." +"tasks." msgstr "" msgid "" @@ -702,19 +721,19 @@ msgid "" "event loop." msgstr "" -msgid "Eager Task Factory" +msgid "Eager task factory" msgstr "" msgid "A task factory for eager task execution." msgstr "" msgid "" -"When using this factory (via :meth:`loop.set_task_factory(asyncio." -"eager_task_factory) `), coroutines begin execution " -"synchronously during :class:`Task` construction. Tasks are only scheduled on " -"the event loop if they block. This can be a performance improvement as the " -"overhead of loop scheduling is avoided for coroutines that complete " -"synchronously." +"When using this factory " +"(via :meth:`loop.set_task_factory(asyncio.eager_task_factory) " +"`), coroutines begin execution synchronously " +"during :class:`Task` construction. Tasks are only scheduled on the event " +"loop if they block. This can be a performance improvement as the overhead of " +"loop scheduling is avoided for coroutines that complete synchronously." msgstr "" msgid "" @@ -738,22 +757,22 @@ msgstr "" msgid "" "*custom_task_constructor* must be a *callable* with the signature matching " -"the signature of :class:`Task.__init__ `. The callable must return a :" -"class:`asyncio.Task`-compatible object." +"the signature of :class:`Task.__init__ `. The callable must return " +"a :class:`asyncio.Task`-compatible object." msgstr "" msgid "" "This function returns a *callable* intended to be used as a task factory of " -"an event loop via :meth:`loop.set_task_factory(factory) `)." +"an event loop via :meth:`loop.set_task_factory(factory) " +"`)." msgstr "" -msgid "Shielding From Cancellation" +msgid "Shielding from cancellation" msgstr "" msgid "" -"Protect an :ref:`awaitable object ` from being :meth:" -"`cancelled `." +"Protect an :ref:`awaitable object ` from " +"being :meth:`cancelled `." msgstr "" msgid "If *aw* is a coroutine it is automatically scheduled as a Task." @@ -777,8 +796,8 @@ msgid "" "*except* that if the coroutine containing it is cancelled, the Task running " "in ``something()`` is not cancelled. From the point of view of " "``something()``, the cancellation did not happen. Although its caller is " -"still cancelled, so the \"await\" expression still raises a :exc:" -"`CancelledError`." +"still cancelled, so the \"await\" expression still raises " +"a :exc:`CancelledError`." msgstr "" msgid "" @@ -827,8 +846,8 @@ msgid "" msgstr "" msgid "" -"In either case, the context manager can be rescheduled after creation using :" -"meth:`Timeout.reschedule`." +"In either case, the context manager can be rescheduled after creation " +"using :meth:`Timeout.reschedule`." msgstr "" msgid "" @@ -839,15 +858,15 @@ msgstr "" msgid "" "If ``long_running_task`` takes more than 10 seconds to complete, the context " -"manager will cancel the current task and handle the resulting :exc:`asyncio." -"CancelledError` internally, transforming it into a :exc:`TimeoutError` which " -"can be caught and handled." +"manager will cancel the current task and handle the " +"resulting :exc:`asyncio.CancelledError` internally, transforming it into " +"a :exc:`TimeoutError` which can be caught and handled." msgstr "" msgid "" -"The :func:`asyncio.timeout` context manager is what transforms the :exc:" -"`asyncio.CancelledError` into a :exc:`TimeoutError`, which means the :exc:" -"`TimeoutError` can only be caught *outside* of the context manager." +"The :func:`asyncio.timeout` context manager is what transforms " +"the :exc:`asyncio.CancelledError` into a :exc:`TimeoutError`, which means " +"the :exc:`TimeoutError` can only be caught *outside* of the context manager." msgstr "" msgid "Example of catching :exc:`TimeoutError`::" @@ -874,6 +893,11 @@ msgid "" "cancelling overdue coroutines." msgstr "" +msgid "" +"Prefer using :func:`asyncio.timeout` or :func:`asyncio.timeout_at` rather " +"than instantiating :class:`!Timeout` directly." +msgstr "" + msgid "" "``when`` should be an absolute time at which the context should time out, as " "measured by the event loop's clock:" @@ -945,13 +969,10 @@ msgid "" "for. If *timeout* is ``None``, block until the future completes." msgstr "" -msgid "" -"If a timeout occurs, it cancels the task and raises :exc:`TimeoutError`." +msgid "If a timeout occurs, it cancels *aw* and raises :exc:`TimeoutError`." msgstr "" -msgid "" -"To avoid the task :meth:`cancellation `, wrap it in :func:" -"`shield`." +msgid "To prevent *aw* from being cancelled, wrap it in :func:`shield`." msgstr "" msgid "" @@ -991,7 +1012,12 @@ msgstr "" msgid "Raises :exc:`TimeoutError` instead of :exc:`asyncio.TimeoutError`." msgstr "" -msgid "Waiting Primitives" +msgid "" +"Implemented using :func:`asyncio.timeout`, a coroutine passed as *aw* is no " +"longer wrapped in a :class:`Task` when *timeout* is positive." +msgstr "" + +msgid "Waiting primitives" msgstr "" msgid "" @@ -1039,8 +1065,8 @@ msgstr "" msgid "" "The function will return when any future finishes by raising an exception. " -"If no future raises an exception then it is equivalent to :const:" -"`ALL_COMPLETED`." +"If no future raises an exception then it is equivalent " +"to :const:`ALL_COMPLETED`." msgstr "" msgid "The function will return when all futures finish or are cancelled." @@ -1051,6 +1077,11 @@ msgid "" "when a timeout occurs." msgstr "" +msgid "" +"If ``wait()`` is cancelled, the futures in *aws* are not cancelled and " +"continue to run." +msgstr "" + msgid "Passing coroutine objects to ``wait()`` directly is forbidden." msgstr "" @@ -1064,11 +1095,11 @@ msgid "" msgstr "" msgid "" -"The object returned by ``as_completed()`` can be iterated as an :term:" -"`asynchronous iterator` or a plain :term:`iterator`. When asynchronous " -"iteration is used, the originally-supplied awaitables are yielded if they " -"are tasks or futures. This makes it easy to correlate previously-scheduled " -"tasks with their results. Example::" +"The object returned by ``as_completed()`` can be iterated as " +"an :term:`asynchronous iterator` or a plain :term:`iterator`. When " +"asynchronous iteration is used, the originally-supplied awaitables are " +"yielded if they are tasks or futures. This makes it easy to correlate " +"previously-scheduled tasks with their results. Example::" msgstr "" msgid "" @@ -1116,6 +1147,12 @@ msgid "" "iteration or by the coroutines yielded during plain iteration." msgstr "" +msgid "" +"``as_completed()`` does not cancel the tasks running the supplied " +"awaitables: if a timeout occurs or the iteration is cancelled, the remaining " +"tasks continue to run." +msgstr "" + msgid "" "Deprecation warning is emitted if not all awaitable objects in the *aws* " "iterable are Future-like objects and there is no running event loop." @@ -1126,7 +1163,7 @@ msgid "" "a plain :term:`iterator` (previously it was only a plain iterator)." msgstr "" -msgid "Running in Threads" +msgid "Running in threads" msgstr "" msgid "Asynchronously run function *func* in a separate thread." @@ -1191,7 +1228,7 @@ msgid "" "``asyncio.to_thread()`` can also be used for CPU-bound functions." msgstr "" -msgid "Scheduling From Other Threads" +msgid "Scheduling from other threads" msgstr "" msgid "Submit a coroutine to the given event loop. Thread-safe." @@ -1269,7 +1306,7 @@ msgstr "" msgid "Return ``True`` if *obj* is a coroutine object." msgstr "" -msgid "Task Object" +msgid "Task object" msgstr "" msgid "" @@ -1305,20 +1342,20 @@ msgstr "" msgid "" ":meth:`cancelled` can be used to check if the Task was cancelled. The method " -"returns ``True`` if the wrapped coroutine did not suppress the :exc:" -"`CancelledError` exception and was actually cancelled." +"returns ``True`` if the wrapped coroutine did not suppress " +"the :exc:`CancelledError` exception and was actually cancelled." msgstr "" msgid "" -":class:`asyncio.Task` inherits from :class:`Future` all of its APIs except :" -"meth:`Future.set_result` and :meth:`Future.set_exception`." +":class:`asyncio.Task` inherits from :class:`Future` all of its APIs " +"except :meth:`Future.set_result` and :meth:`Future.set_exception`." msgstr "" msgid "" -"An optional keyword-only *context* argument allows specifying a custom :" -"class:`contextvars.Context` for the *coro* to run in. If no *context* is " -"provided, the Task copies the current context and later runs its coroutine " -"in the copied context." +"An optional keyword-only *context* argument allows specifying a " +"custom :class:`contextvars.Context` for the *coro* to run in. If no " +"*context* is provided, the Task copies the current context and later runs " +"its coroutine in the copied context." msgstr "" msgid "" @@ -1330,6 +1367,11 @@ msgid "" "eagerly and will skip scheduling to the event loop." msgstr "" +msgid "" +"Tasks are :ref:`generic ` over the return type of their wrapped " +"coroutines." +msgstr "" + msgid "Added support for the :mod:`contextvars` module." msgstr "" @@ -1363,8 +1405,8 @@ msgid "" msgstr "" msgid "" -"If the Task's result isn't yet available, this method raises an :exc:" -"`InvalidStateError` exception." +"If the Task's result isn't yet available, this method raises " +"an :exc:`InvalidStateError` exception." msgstr "" msgid "Return the exception of the Task." @@ -1469,8 +1511,8 @@ msgid "" msgstr "" msgid "" -"In the default Task implementation, the name will be visible in the :func:" -"`repr` output of a task object." +"In the default Task implementation, the name will be visible in " +"the :func:`repr` output of a task object." msgstr "" msgid "Request the Task to be cancelled." @@ -1489,12 +1531,12 @@ msgstr "" msgid "" "The coroutine then has a chance to clean up or even deny the request by " "suppressing the exception with a :keyword:`try` ... ... ``except " -"CancelledError`` ... :keyword:`finally` block. Therefore, unlike :meth:" -"`Future.cancel`, :meth:`Task.cancel` does not guarantee that the Task will " -"be cancelled, although suppressing cancellation completely is not common and " -"is actively discouraged. Should the coroutine nevertheless decide to " -"suppress the cancellation, it needs to call :meth:`Task.uncancel` in " -"addition to catching the exception." +"CancelledError`` ... :keyword:`finally` block. Therefore, " +"unlike :meth:`Future.cancel`, :meth:`Task.cancel` does not guarantee that " +"the Task will be cancelled, although suppressing cancellation completely is " +"not common and is actively discouraged. Should the coroutine nevertheless " +"decide to suppress the cancellation, it needs to call :meth:`Task.uncancel` " +"in addition to catching the exception." msgstr "" msgid "Added the *msg* parameter." @@ -1548,9 +1590,9 @@ msgid "Return ``True`` if the Task is *cancelled*." msgstr "" msgid "" -"The Task is *cancelled* when the cancellation was requested with :meth:" -"`cancel` and the wrapped coroutine propagated the :exc:`CancelledError` " -"exception thrown into it." +"The Task is *cancelled* when the cancellation was requested " +"with :meth:`cancel` and the wrapped coroutine propagated " +"the :exc:`CancelledError` exception thrown into it." msgstr "" msgid "Decrement the count of cancellation requests to this Task." @@ -1560,16 +1602,16 @@ msgid "Returns the remaining number of cancellation requests." msgstr "" msgid "" -"Note that once execution of a cancelled task completed, further calls to :" -"meth:`uncancel` are ineffective." +"Note that once execution of a cancelled task completed, further calls " +"to :meth:`uncancel` are ineffective." msgstr "" msgid "" "This method is used by asyncio's internals and isn't expected to be used by " "end-user code. In particular, if a Task gets successfully uncancelled, this " -"allows for elements of structured concurrency like :ref:`taskgroups` and :" -"func:`asyncio.timeout` to continue running, isolating cancellation to the " -"respective structured block. For example::" +"allows for elements of structured concurrency like :ref:`taskgroups` " +"and :func:`asyncio.timeout` to continue running, isolating cancellation to " +"the respective structured block. For example::" msgstr "" msgid "" @@ -1588,22 +1630,22 @@ msgstr "" msgid "" "While the block with ``make_request()`` and ``make_another_request()`` might " "get cancelled due to the timeout, ``unrelated_code()`` should continue " -"running even in case of the timeout. This is implemented with :meth:" -"`uncancel`. :class:`TaskGroup` context managers use :func:`uncancel` in a " -"similar fashion." +"running even in case of the timeout. This is implemented " +"with :meth:`uncancel`. :class:`TaskGroup` context managers " +"use :func:`uncancel` in a similar fashion." msgstr "" msgid "" -"If end-user code is, for some reason, suppressing cancellation by catching :" -"exc:`CancelledError`, it needs to call this method to remove the " +"If end-user code is, for some reason, suppressing cancellation by " +"catching :exc:`CancelledError`, it needs to call this method to remove the " "cancellation state." msgstr "" msgid "" "When this method decrements the cancellation count to zero, the method " -"checks if a previous :meth:`cancel` call had arranged for :exc:" -"`CancelledError` to be thrown into the task. If it hasn't been thrown yet, " -"that arrangement will be rescinded (by resetting the internal " +"checks if a previous :meth:`cancel` call had arranged " +"for :exc:`CancelledError` to be thrown into the task. If it hasn't been " +"thrown yet, that arrangement will be rescinded (by resetting the internal " "``_must_cancel`` flag)." msgstr "" diff --git a/library/asyncio.po b/library/asyncio.po index f107010000..4a4cc545c6 100644 --- a/library/asyncio.po +++ b/library/asyncio.po @@ -1,19 +1,22 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Rafael Fontenelle , 2025 +# Ciarbin , 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,19 +27,19 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "High-level APIs" -msgstr "" +msgstr "Wysokopoziomowe interfejsy API" msgid "Low-level APIs" -msgstr "" +msgstr "niskopoziomowe interfejsy API" msgid "Guides and Tutorials" -msgstr "" +msgstr "Przewodniki i samouczki" msgid ":mod:`!asyncio` --- Asynchronous I/O" -msgstr "" +msgstr ":mod:`!asyncio` --- Asynchroniczne I/O" msgid "Hello World!" -msgstr "" +msgstr "Hello World!" msgid "" "import asyncio\n" @@ -48,30 +51,54 @@ msgid "" "\n" "asyncio.run(main())" msgstr "" +"import asyncio\n" +"\n" +"async def main():\n" +" print('Hello ...')\n" +" await asyncio.sleep(1)\n" +" print('... World!')\n" +"\n" +"asyncio.run(main())" msgid "" "asyncio is a library to write **concurrent** code using the **async/await** " "syntax." msgstr "" +"asyncio jest biblioteką do pisania **równoległego** kodu przy użyciu składni " +"**async/await**." msgid "" "asyncio is used as a foundation for multiple Python asynchronous frameworks " "that provide high-performance network and web-servers, database connection " "libraries, distributed task queues, etc." msgstr "" +"asyncio jest używane jako podstawa dla wielu asynchronicznych framework'ów " +"Pythona, które zapewniają wysoką wydajność sieci i serwerów internetowych, " +"bibliotek połączeń z bazami danych, rozproszonych kolejek zadań itp." msgid "" "asyncio is often a perfect fit for IO-bound and high-level **structured** " "network code." msgstr "" +" asyncio często idealnie nadaje się do kodu związanego z operacjami wejścia/" +"wyjścia, inaczej IO-bound. oraz do wysokopoziomowego, **strukturalnego** " +"kodu sieciowego." -msgid "asyncio provides a set of **high-level** APIs to:" +msgid ":ref:`a-conceptual-overview-of-asyncio`" +msgstr ":ref:`a-conceptual-overview-of-asyncio`" + +msgid "Explanation of the fundamentals of asyncio." msgstr "" +msgid "asyncio provides a set of **high-level** APIs to:" +msgstr "asyncio zapewnia zestaw **wysopoziomowych** interfejsów API do:" + msgid "" ":ref:`run Python coroutines ` concurrently and have full control " "over their execution;" msgstr "" +":ref:`uruchamiania równoległych korutyn Pythona` oraz pełnej " +"kontroli nad ich wykonywaniem;" msgid "perform :ref:`network IO and IPC `;" msgstr "" @@ -92,9 +119,9 @@ msgstr "" msgid "" "create and manage :ref:`event loops `, which provide " -"asynchronous APIs for :ref:`networking `, running :ref:" -"`subprocesses `, handling :ref:`OS signals " -"`, etc;" +"asynchronous APIs for :ref:`networking `, " +"running :ref:`subprocesses `, handling :ref:`OS " +"signals `, etc;" msgstr "" msgid "" @@ -119,8 +146,8 @@ msgid "asyncio REPL" msgstr "" msgid "" -"You can experiment with an ``asyncio`` concurrent context in the :term:" -"`REPL`:" +"You can experiment with an ``asyncio`` concurrent context in " +"the :term:`REPL`:" msgstr "" msgid "" @@ -134,6 +161,12 @@ msgid "" "'hello'" msgstr "" +msgid "" +"This REPL provides limited compatibility with :envvar:`PYTHON_BASIC_REPL`. " +"It is recommended that the default REPL is used for full functionality and " +"the latest features." +msgstr "" + msgid "" "Raises an :ref:`auditing event ` ``cpython.run_stdin`` with no " "arguments." @@ -148,7 +181,7 @@ msgid "" msgstr "" msgid "Reference" -msgstr "" +msgstr "Dokumentacja" msgid "The source code for asyncio can be found in :source:`Lib/asyncio/`." msgstr "" diff --git a/library/atexit.po b/library/atexit.po index 2d701d1de1..edb6491537 100644 --- a/library/atexit.po +++ b/library/atexit.po @@ -53,9 +53,9 @@ msgstr "" msgid "" "Register *func* as a function to be executed at termination. Any optional " -"arguments that are to be passed to *func* must be passed as arguments to :" -"func:`register`. It is possible to register the same function and arguments " -"more than once." +"arguments that are to be passed to *func* must be passed as arguments " +"to :func:`register`. It is possible to register the same function and " +"arguments more than once." msgstr "" msgid "" @@ -79,12 +79,13 @@ msgid "" msgstr "" msgid "" -"Remove *func* from the list of functions to be run at interpreter shutdown. :" -"func:`unregister` silently does nothing if *func* was not previously " -"registered. If *func* has been registered more than once, every occurrence " -"of that function in the :mod:`atexit` call stack will be removed. Equality " -"comparisons (``==``) are used internally during unregistration, so function " -"references do not need to have matching identities." +"Remove *func* from the list of functions to be run at interpreter " +"shutdown. :func:`unregister` silently does nothing if *func* was not " +"previously registered. If *func* has been registered more than once, every " +"occurrence of that function in the :mod:`atexit` call stack will be " +"removed. Equality comparisons (``==``) are used internally during " +"unregistration, so function references do not need to have matching " +"identities." msgstr "" msgid "Module :mod:`readline`" diff --git a/library/audit_events.po b/library/audit_events.po index 255e57f735..54d76af855 100644 --- a/library/audit_events.po +++ b/library/audit_events.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,9 +27,9 @@ msgid "Audit events table" msgstr "" msgid "" -"This table contains all events raised by :func:`sys.audit` or :c:func:" -"`PySys_Audit` calls throughout the CPython runtime and the standard " -"library. These calls were added in 3.8 or later (see :pep:`578`)." +"This table contains all events raised by :func:`sys.audit` " +"or :c:func:`PySys_Audit` calls throughout the CPython runtime and the " +"standard library. These calls were added in 3.8 or later (see :pep:`578`)." msgstr "" msgid "" @@ -55,7 +55,7 @@ msgid "Arguments" msgstr "" msgid "_winapi.CreateFile" -msgstr "" +msgstr "_winapi.CreateFile" msgid "" "``file_name``, ``desired_access``, ``share_mode``, ``creation_disposition``, " @@ -63,40 +63,40 @@ msgid "" msgstr "" msgid "_winapi.CreateJunction" -msgstr "" +msgstr "_winapi.CreateJunction" msgid "``src_path``, ``dst_path``" msgstr "" msgid "_winapi.CreateNamedPipe" -msgstr "" +msgstr "_winapi.CreateNamedPipe" msgid "``name``, ``open_mode``, ``pipe_mode``" msgstr "" msgid "_winapi.CreatePipe" -msgstr "" +msgstr "_winapi.CreatePipe" msgid "_winapi.CreateProcess" -msgstr "" +msgstr "_winapi.CreateProcess" msgid "``application_name``, ``command_line``, ``current_directory``" msgstr "" msgid "_winapi.OpenProcess" -msgstr "" +msgstr "_winapi.OpenProcess" msgid "``process_id``, ``desired_access``" msgstr "" msgid "_winapi.TerminateProcess" -msgstr "" +msgstr "_winapi.TerminateProcess" msgid "``handle``, ``exit_code``" msgstr "" msgid "ctypes.PyObj_FromPtr" -msgstr "" +msgstr "ctypes.PyObj_FromPtr" msgid "``obj``" msgstr "``obj``" diff --git a/library/base64.po b/library/base64.po index 54c920307f..b82defc644 100644 --- a/library/base64.po +++ b/library/base64.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:55+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,34 +31,29 @@ msgstr "**Kod źródłowy:** :source:`Lib/base64.py`" msgid "" "This module provides functions for encoding binary data to printable ASCII " -"characters and decoding such encodings back to binary data. It provides " -"encoding and decoding functions for the encodings specified in :rfc:`4648`, " -"which defines the Base16, Base32, and Base64 algorithms, and for the de-" -"facto standard Ascii85 and Base85 encodings." -msgstr "" - -msgid "" -"The :rfc:`4648` encodings are suitable for encoding binary data so that it " -"can be safely sent by email, used as parts of URLs, or included as part of " -"an HTTP POST request. The encoding algorithm is not the same as the :" -"program:`uuencode` program." +"characters and decoding such encodings back to binary data. This includes " +"the :ref:`encodings specified in ` :rfc:`4648` (Base64, " +"Base32 and Base16), the :ref:`Base85 encoding ` specified in " +"`PDF 2.0 `_, and non-standard " +"variants of Base85 used elsewhere." msgstr "" msgid "" "There are two interfaces provided by this module. The modern interface " -"supports encoding :term:`bytes-like objects ` to ASCII :" -"class:`bytes`, and decoding :term:`bytes-like objects ` " -"or strings containing ASCII to :class:`bytes`. Both base-64 alphabets " -"defined in :rfc:`4648` (normal, and URL- and filesystem-safe) are supported." +"supports encoding :term:`bytes-like objects ` to " +"ASCII :class:`bytes`, and decoding :term:`bytes-like objects ` or strings containing ASCII to :class:`bytes`. Both base-64 " +"alphabets defined in :rfc:`4648` (normal, and URL- and filesystem-safe) are " +"supported." msgstr "" msgid "" -"The legacy interface does not support decoding from strings, but it does " -"provide functions for encoding and decoding to and from :term:`file objects " -"`. It only supports the Base64 standard alphabet, and it adds " -"newlines every 76 characters as per :rfc:`2045`. Note that if you are " -"looking for :rfc:`2045` support you probably want to be looking at the :mod:" -"`email` package instead." +"The :ref:`legacy interface ` does not support decoding from " +"strings, but it does provide functions for encoding and decoding to and " +"from :term:`file objects `. It only supports the Base64 " +"standard alphabet, and it adds newlines every 76 characters as " +"per :rfc:`2045`. Note that if you are looking for :rfc:`2045` support you " +"probably want to be looking at the :mod:`email` package instead." msgstr "" msgid "" @@ -73,8 +67,14 @@ msgid "" "added." msgstr "" -msgid "The modern interface provides:" -msgstr "W nowym interfejsie znajdują się:" +msgid "RFC 4648 Encodings" +msgstr "" + +msgid "" +"The :rfc:`4648` encodings are suitable for encoding binary data so that it " +"can be safely sent by email, used as parts of URLs, or included as part of " +"an HTTP POST request." +msgstr "" msgid "" "Encode the :term:`bytes-like object` *s* using Base64 and return the " @@ -118,8 +118,8 @@ msgid "" msgstr "" msgid "" -"For more information about the strict base64 check, see :func:`binascii." -"a2b_base64`" +"For more information about the strict base64 check, " +"see :func:`binascii.a2b_base64`" msgstr "" msgid "" @@ -146,8 +146,8 @@ msgstr "" msgid "" "Decode :term:`bytes-like object` or ASCII string *s* using the URL- and " "filesystem-safe alphabet, which substitutes ``-`` instead of ``+`` and ``_`` " -"instead of ``/`` in the standard Base64 alphabet, and return the decoded :" -"class:`bytes`." +"instead of ``/`` in the standard Base64 alphabet, and return the " +"decoded :class:`bytes`." msgstr "" msgid "" @@ -207,6 +207,52 @@ msgid "" "return the decoded :class:`bytes`." msgstr "" +msgid "Base85 Encodings" +msgstr "" + +msgid "" +"Base85 encoding is a family of algorithms which represent four bytes using " +"five ASCII characters. Originally implemented in the Unix ``btoa(1)`` " +"utility, a version of it was later adopted by Adobe in the PostScript " +"language and is standardized in PDF 2.0 (ISO 32000-2). This version, in both " +"its ``btoa`` and PDF variants, is implemented by :func:`a85encode`." +msgstr "" + +msgid "" +"A separate version, using a different output character set, was defined as " +"an April Fool's joke in :rfc:`1924` but is now used by Git and other " +"software. This version is implemented by :func:`b85encode`." +msgstr "" + +msgid "" +"Finally, a third version, using yet another output character set designed " +"for safe inclusion in programming language strings, is defined by ZeroMQ and " +"implemented here by :func:`z85encode`." +msgstr "" + +msgid "" +"The functions present in this module differ in how they handle the following:" +msgstr "" + +msgid "Whether to include and expect enclosing ``<~`` and ``~>`` markers." +msgstr "" + +msgid "Whether to fold the input into multiple lines." +msgstr "" + +msgid "The set of ASCII characters used for encoding." +msgstr "" + +msgid "Compact encodings of sequences of spaces and null bytes." +msgstr "" + +msgid "The encoding of zero-padding bytes applied to the input." +msgstr "" + +msgid "" +"Refer to the documentation of the individual functions for more information." +msgstr "" + msgid "" "Encode the :term:`bytes-like object` *b* using Ascii85 and return the " "encoded :class:`bytes`." @@ -215,7 +261,7 @@ msgstr "" msgid "" "*foldspaces* is an optional flag that uses the special short sequence 'y' " "instead of 4 consecutive spaces (ASCII 0x20) as supported by 'btoa'. This " -"feature is not supported by the \"standard\" Ascii85 encoding." +"feature is not supported by the standard encoding used in PDF." msgstr "" msgid "" @@ -225,13 +271,17 @@ msgid "" msgstr "" msgid "" -"*pad* controls whether the input is padded to a multiple of 4 before " -"encoding. Note that the ``btoa`` implementation always pads." +"*pad* controls whether zero-padding applied to the end of the input is fully " +"retained in the output encoding, as done by ``btoa``, producing an exact " +"multiple of 5 bytes of output. This is not part of the standard encoding " +"used in PDF, as it does not preserve the length of the data." msgstr "" msgid "" "*adobe* controls whether the encoded byte sequence is framed with ``<~`` and " -"``~>``, which is used by the Adobe implementation." +"``~>``, as in a PostScript base-85 string literal. Note that while " +"ASCII85Decode streams in PDF documents *must* be terminated with ``~>``, " +"they *must not* use a leading ``<~``." msgstr "" msgid "" @@ -242,19 +292,19 @@ msgstr "" msgid "" "*foldspaces* is a flag that specifies whether the 'y' short sequence should " "be accepted as shorthand for 4 consecutive spaces (ASCII 0x20). This feature " -"is not supported by the \"standard\" Ascii85 encoding." +"is not supported by the standard Ascii85 encoding used in PDF and PostScript." msgstr "" msgid "" -"*adobe* controls whether the input sequence is in Adobe Ascii85 format (i.e. " -"is framed with <~ and ~>)." +"*adobe* controls whether the ``<~`` and ``~>`` markers are present. While " +"the leading ``<~`` is not required, the input must end with ``~>``, or " +"a :exc:`ValueError` is raised." msgstr "" msgid "" -"*ignorechars* should be a :term:`bytes-like object` or ASCII string " -"containing characters to ignore from the input. This should only contain " -"whitespace characters, and by default contains all whitespace characters in " -"ASCII." +"*ignorechars* should be a byte string containing characters to ignore from " +"the input. This should only contain whitespace characters, and by default " +"contains all whitespace characters in ASCII." msgstr "" msgid "" @@ -263,30 +313,36 @@ msgid "" msgstr "" msgid "" -"If *pad* is true, the input is padded with ``b'\\0'`` so its length is a " -"multiple of 4 bytes before encoding." +"The input is padded with ``b'\\0'`` so its length is a multiple of 4 bytes " +"before encoding. If *pad* is true, all the resulting characters are " +"retained in the output, which will always be a multiple of 5 bytes, and thus " +"the length of the data may not be preserved on decoding." msgstr "" msgid "" "Decode the base85-encoded :term:`bytes-like object` or ASCII string *b* and " -"return the decoded :class:`bytes`. Padding is implicitly removed, if " -"necessary." +"return the decoded :class:`bytes`." msgstr "" msgid "" "Encode the :term:`bytes-like object` *s* using Z85 (as used in ZeroMQ) and " -"return the encoded :class:`bytes`. See `Z85 specification `_ for more information." +"return the encoded :class:`bytes`." +msgstr "" + +msgid "" +"The `ZeroMQ specification `_ requires the " +"length of Z85-encoded data to be a multiple of 5 bytes. To produce compliant " +"data frames, you must pad the input data to this function to a multiple of 4 " +"bytes." msgstr "" msgid "" "Decode the Z85-encoded :term:`bytes-like object` or ASCII string *s* and " -"return the decoded :class:`bytes`. See `Z85 specification `_ for more information." +"return the decoded :class:`bytes`." msgstr "" -msgid "The legacy interface:" -msgstr "Przestarzały interfejs:" +msgid "Legacy Interface" +msgstr "" msgid "" "Decode the contents of the binary *input* file and write the resulting " @@ -302,11 +358,12 @@ msgstr "" msgid "" "Encode the contents of the binary *input* file and write the resulting " -"base64 encoded data to the *output* file. *input* and *output* must be :term:" -"`file objects `. *input* will be read until ``input.read()`` " -"returns an empty bytes object. :func:`encode` inserts a newline character " -"(``b'\\n'``) after every 76 bytes of the output, as well as ensuring that " -"the output always ends with a newline, as per :rfc:`2045` (MIME)." +"base64 encoded data to the *output* file. *input* and *output* must " +"be :term:`file objects `. *input* will be read until " +"``input.read()`` returns an empty bytes object. :func:`encode` inserts a " +"newline character (``b'\\n'``) after every 76 bytes of the output, as well " +"as ensuring that the output always ends with a newline, as per :rfc:`2045` " +"(MIME)." msgstr "" msgid "" @@ -350,6 +407,25 @@ msgstr "" "Sekcja 5.2, \"Base64 Treść-Transfer-Kodowanie,\" dostarcza definicji " "kodowania base64." +msgid "" +"`ISO 32000-2 Portable document format - Part 2: PDF 2.0 `_" +msgstr "" + +msgid "" +"Section 7.4.3, \"ASCII85Decode Filter,\" provides the definition of the " +"Ascii85 encoding used in PDF and PostScript, including the output character " +"set and the details of data length preservation using zero-padding and " +"partial output groups." +msgstr "" + +msgid "`ZeroMQ RFC 32/Z85 `_" +msgstr "" + +msgid "" +"The \"Formal Specification\" section provides the character set used in Z85." +msgstr "" + msgid "base64" msgstr "" diff --git a/library/bdb.po b/library/bdb.po index cdacd742b8..e846a9e4f5 100644 --- a/library/bdb.po +++ b/library/bdb.po @@ -11,9 +11,9 @@ 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:55+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2025-08-07 21:40+0000\n" +"PO-Revision-Date: 2025-07-18 19: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" @@ -57,10 +57,10 @@ msgstr "" msgid "" "When creating a breakpoint, its associated :attr:`file name ` should " -"be in canonical form. If a :attr:`funcname` is defined, a breakpoint :attr:" -"`hit ` will be counted when the first line of that function is " -"executed. A :attr:`conditional ` breakpoint always counts a :attr:" -"`hit `." +"be in canonical form. If a :attr:`funcname` is defined, a " +"breakpoint :attr:`hit ` will be counted when the first line of that " +"function is executed. A :attr:`conditional ` breakpoint always counts " +"a :attr:`hit `." msgstr "" msgid ":class:`Breakpoint` instances have the following methods:" @@ -133,8 +133,8 @@ msgid "Numeric index for a single instance of a :class:`Breakpoint`." msgstr "" msgid "" -"Dictionary of :class:`Breakpoint` instances indexed by (:attr:`file`, :attr:" -"`line`) tuples." +"Dictionary of :class:`Breakpoint` instances indexed by " +"(:attr:`file`, :attr:`line`) tuples." msgstr "" msgid "Number of times to ignore a :class:`Breakpoint`." @@ -148,8 +148,8 @@ msgstr "" msgid "" "This class takes care of the details of the trace facility; a derived class " -"should implement user interaction. The standard debugger class (:class:`pdb." -"Pdb`) is an example." +"should implement user interaction. The standard debugger class " +"(:class:`pdb.Pdb`) is an example." msgstr "" msgid "" @@ -171,15 +171,15 @@ msgid "Return canonical form of *filename*." msgstr "" msgid "" -"For real file names, the canonical form is an operating-system-dependent, :" -"func:`case-normalized ` :func:`absolute path `. A *filename* with angle brackets, such as ``\"\"`` " -"generated in interactive mode, is returned unchanged." +"For real file names, the canonical form is an operating-system-" +"dependent, :func:`case-normalized ` :func:`absolute path " +"`. A *filename* with angle brackets, such as " +"``\"\"`` generated in interactive mode, is returned unchanged." msgstr "" msgid "" -"Set the :attr:`botframe`, :attr:`stopframe`, :attr:`returnframe` and :attr:" -"`quitting` attributes with values ready to start debugging." +"Set the :attr:`botframe`, :attr:`stopframe`, :attr:`returnframe` " +"and :attr:`quitting` attributes with values ready to start debugging." msgstr "" msgid "" @@ -226,40 +226,41 @@ msgstr "" msgid "" "See the documentation for :func:`sys.settrace` for more information on the " -"trace function. For more information on code and frame objects, refer to :" -"ref:`types`." +"trace function. For more information on code and frame objects, refer " +"to :ref:`types`." msgstr "" msgid "" -"If the debugger should stop on the current line, invoke the :meth:" -"`user_line` method (which should be overridden in subclasses). Raise a :exc:" -"`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set (which can be " -"set from :meth:`user_line`). Return a reference to the :meth:" -"`trace_dispatch` method for further tracing in that scope." +"If the debugger should stop on the current line, invoke " +"the :meth:`user_line` method (which should be overridden in subclasses). " +"Raise a :exc:`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set " +"(which can be set from :meth:`user_line`). Return a reference to " +"the :meth:`trace_dispatch` method for further tracing in that scope." msgstr "" msgid "" -"If the debugger should stop on this function call, invoke the :meth:" -"`user_call` method (which should be overridden in subclasses). Raise a :exc:" -"`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set (which can be " -"set from :meth:`user_call`). Return a reference to the :meth:" -"`trace_dispatch` method for further tracing in that scope." +"If the debugger should stop on this function call, invoke " +"the :meth:`user_call` method (which should be overridden in subclasses). " +"Raise a :exc:`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set " +"(which can be set from :meth:`user_call`). Return a reference to " +"the :meth:`trace_dispatch` method for further tracing in that scope." msgstr "" msgid "" -"If the debugger should stop on this function return, invoke the :meth:" -"`user_return` method (which should be overridden in subclasses). Raise a :" -"exc:`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set (which can " -"be set from :meth:`user_return`). Return a reference to the :meth:" -"`trace_dispatch` method for further tracing in that scope." +"If the debugger should stop on this function return, invoke " +"the :meth:`user_return` method (which should be overridden in subclasses). " +"Raise a :exc:`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set " +"(which can be set from :meth:`user_return`). Return a reference to " +"the :meth:`trace_dispatch` method for further tracing in that scope." msgstr "" msgid "" -"If the debugger should stop at this exception, invokes the :meth:" -"`user_exception` method (which should be overridden in subclasses). Raise a :" -"exc:`BdbQuit` exception if the :attr:`Bdb.quitting` flag is set (which can " -"be set from :meth:`user_exception`). Return a reference to the :meth:" -"`trace_dispatch` method for further tracing in that scope." +"If the debugger should stop at this exception, invokes " +"the :meth:`user_exception` method (which should be overridden in " +"subclasses). Raise a :exc:`BdbQuit` exception if the :attr:`Bdb.quitting` " +"flag is set (which can be set from :meth:`user_exception`). Return a " +"reference to the :meth:`trace_dispatch` method for further tracing in that " +"scope." msgstr "" msgid "" @@ -295,8 +296,8 @@ msgid "" msgstr "" msgid "" -"Called from :meth:`dispatch_line` when either :meth:`stop_here` or :meth:" -"`break_here` returns ``True``." +"Called from :meth:`dispatch_line` when either :meth:`stop_here` " +"or :meth:`break_here` returns ``True``." msgstr "" msgid "" @@ -366,9 +367,9 @@ msgid "" msgstr "" msgid "" -"Delete the breakpoint which has the index *arg* in the :attr:`Breakpoint." -"bpbynumber`. If *arg* is not numeric or out of range, return an error " -"message." +"Delete the breakpoint which has the index *arg* in " +"the :attr:`Breakpoint.bpbynumber`. If *arg* is not numeric or out of range, " +"return an error message." msgstr "" msgid "" @@ -459,16 +460,16 @@ msgid "Finally, the module defines the following functions:" msgstr "" msgid "" -"Return True if we should break here, depending on the way the :class:" -"`Breakpoint` *b* was set." +"Return True if we should break here, depending on the way " +"the :class:`Breakpoint` *b* was set." msgstr "" msgid "" -"If it was set via line number, it checks if :attr:`b.line ` is the same as the one in *frame*. If the breakpoint was set via :" -"attr:`function name `, we have to check we are in " -"the right *frame* (the right function) and if we are on its first executable " -"line." +"If it was set via line number, it checks if :attr:`b.line " +"` is the same as the one in *frame*. If the breakpoint " +"was set via :attr:`function name `, we have to " +"check we are in the right *frame* (the right function) and if we are on its " +"first executable line." msgstr "" msgid "" @@ -477,15 +478,16 @@ msgid "" msgstr "" msgid "" -"The *active breakpoint* is the first entry in :attr:`bplist ` for the (:attr:`file `, :attr:`line `) (which must exist) that is :attr:`enabled `, for which :func:`checkfuncname` is True, and that has neither a " +"The *active breakpoint* is the first entry in :attr:`bplist " +"` for the (:attr:`file " +"`, :attr:`line `) (which must " +"exist) that is :attr:`enabled `, for " +"which :func:`checkfuncname` is True, and that has neither a " "False :attr:`condition ` nor positive :attr:`ignore " "` count. The *flag*, meaning that a temporary " -"breakpoint should be deleted, is False only when the :attr:`cond ` cannot be evaluated (in which case, :attr:`ignore ` count is ignored)." +"breakpoint should be deleted, is False only when the :attr:`cond " +"` cannot be evaluated (in which case, :attr:`ignore " +"` count is ignored)." msgstr "" msgid "If no such entry exists, then (None, None) is returned." diff --git a/library/binascii.po b/library/binascii.po index 1b6450d8d8..efb043a54b 100644 --- a/library/binascii.po +++ b/library/binascii.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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" @@ -176,8 +176,8 @@ msgstr "" msgid "" "Similar functionality (accepting only text string arguments, but more " -"liberal towards whitespace) is also accessible using the :meth:`bytes." -"fromhex` class method." +"liberal towards whitespace) is also accessible using " +"the :meth:`bytes.fromhex` class method." msgstr "" msgid "Exception raised on errors. These are usually programming errors." diff --git a/library/bisect.po b/library/bisect.po index beea4e7590..79ed462373 100644 --- a/library/bisect.po +++ b/library/bisect.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:03+0000\n" +"Last-Translator: python-doc bot, 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,10 +40,19 @@ msgid "" "The module is called :mod:`bisect` because it uses a basic bisection " "algorithm to do its work. Unlike other bisection tools that search for a " "specific value, the functions in this module are designed to locate an " -"insertion point. Accordingly, the functions never call an :meth:`~object." -"__eq__` method to determine whether a value has been found. Instead, the " -"functions only call the :meth:`~object.__lt__` method and will return an " -"insertion point between values in an array." +"insertion point. Accordingly, the functions never call " +"an :meth:`~object.__eq__` method to determine whether a value has been " +"found. Instead, the functions only call the :meth:`~object.__lt__` method " +"and will return an insertion point between values in an array." +msgstr "" + +msgid "" +"The functions in this module are not thread-safe. If multiple threads " +"concurrently use :mod:`bisect` functions on the same sequence, this may " +"result in undefined behaviour. Likewise, if the provided sequence is mutated " +"by a different thread while a :mod:`bisect` function is operating on it, the " +"result is undefined. For example, using :py:func:`~bisect.insort_left` on " +"the same list from multiple threads may result in the list becoming unsorted." msgstr "" msgid "The following functions are provided:" @@ -97,8 +105,8 @@ 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 " -"*x* at the appropriate position to maintain sort order." +"insertion point. Next, it runs the :meth:`~sequence.insert` method on *a* to " +"insert *x* at the appropriate position to maintain sort order." msgstr "" msgid "" @@ -118,8 +126,8 @@ 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 " -"*x* at the appropriate position to maintain sort order." +"insertion point. Next, it runs the :meth:`~sequence.insert` method on *a* to " +"insert *x* at the appropriate position to maintain sort order." msgstr "" msgid "Performance Notes" @@ -144,10 +152,10 @@ msgid "" "The search functions are stateless and discard key function results after " "they are used. Consequently, if the search functions are used in a loop, " "the key function may be called again and again on the same array elements. " -"If the key function isn't fast, consider wrapping it with :py:func:" -"`functools.cache` to avoid duplicate computations. Alternatively, consider " -"searching an array of precomputed keys to locate the insertion point (as " -"shown in the examples section below)." +"If the key function isn't fast, consider wrapping it " +"with :py:deco:`functools.cache` to avoid duplicate computations. " +"Alternatively, consider searching an array of precomputed keys to locate the " +"insertion point (as shown in the examples section below)." msgstr "" msgid "" @@ -222,9 +230,9 @@ msgid "" msgstr "" msgid "" -">>> def grade(score, breakpoints=[60, 70, 80, 90], grades='FDCBA'):\n" -"... i = bisect(breakpoints, score)\n" -"... return grades[i]\n" +">>> def grade(score):\n" +"... i = bisect([60, 70, 80, 90], score)\n" +"... return \"FDCBA\"[i]\n" "...\n" ">>> [grade(score) for score in [33, 99, 77, 70, 89, 90, 100]]\n" "['F', 'A', 'C', 'C', 'B', 'A', 'A']" diff --git a/library/builtins.po b/library/builtins.po index 337bd98a0d..634648a622 100644 --- a/library/builtins.po +++ b/library/builtins.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,8 +28,8 @@ msgstr "" msgid "" "This module provides direct access to all 'built-in' identifiers of Python; " -"for example, ``builtins.open`` is the full name for the built-in function :" -"func:`open`." +"for example, ``builtins.open`` is the full name for the built-in " +"function :func:`open`." msgstr "" msgid "" @@ -62,9 +62,9 @@ msgstr "" msgid "" "As an implementation detail, most modules have the name ``__builtins__`` " "made available as part of their globals. The value of ``__builtins__`` is " -"normally either this module or the value of this module's :attr:`~object." -"__dict__` attribute. Since this is an implementation detail, it may not be " -"used by alternate implementations of Python." +"normally either this module or the value of this " +"module's :attr:`~object.__dict__` attribute. Since this is an implementation " +"detail, it may not be used by alternate implementations of Python." msgstr "" msgid ":ref:`built-in-consts`" diff --git a/library/bz2.po b/library/bz2.po index c6510e7557..f20cfa88b3 100644 --- a/library/bz2.po +++ b/library/bz2.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,8 +73,8 @@ msgid "" msgstr "" msgid "" -"The *compresslevel* argument is an integer from 1 to 9, as for the :class:" -"`BZ2File` constructor." +"The *compresslevel* argument is an integer from 1 to 9, as for " +"the :class:`BZ2File` constructor." msgstr "" msgid "" @@ -86,8 +85,8 @@ msgid "" msgstr "" msgid "" -"For text mode, a :class:`BZ2File` object is created, and wrapped in an :" -"class:`io.TextIOWrapper` instance with the specified encoding, error " +"For text mode, a :class:`BZ2File` object is created, and wrapped in " +"an :class:`io.TextIOWrapper` instance with the specified encoding, error " "handling behavior, and line ending(s)." msgstr "" @@ -130,9 +129,10 @@ msgid "" msgstr "" msgid "" -":class:`BZ2File` provides all of the members specified by the :class:`io." -"BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` and :meth:`~io." -"IOBase.truncate`. Iteration and the :keyword:`with` statement are supported." +":class:`BZ2File` provides all of the members specified by " +"the :class:`io.BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` " +"and :meth:`~io.IOBase.truncate`. Iteration and the :keyword:`with` statement " +"are supported." msgstr "" msgid ":class:`BZ2File` also provides the following methods and attributes:" @@ -145,10 +145,10 @@ msgid "" msgstr "" msgid "" -"While calling :meth:`peek` does not change the file position of the :class:" -"`BZ2File`, it may change the position of the underlying file object (e.g. if " -"the :class:`BZ2File` was constructed by passing a file object for " -"*filename*)." +"While calling :meth:`peek` does not change the file position of " +"the :class:`BZ2File`, it may change the position of the underlying file " +"object (e.g. if the :class:`BZ2File` was constructed by passing a file " +"object for *filename*)." msgstr "" msgid "Return the file descriptor for the underlying file." @@ -238,8 +238,8 @@ msgid "" msgstr "" msgid "" -"When you have finished providing data to the compressor, call the :meth:" -"`flush` method to finish the compression process." +"When you have finished providing data to the compressor, call " +"the :meth:`flush` method to finish the compression process." msgstr "" msgid "" @@ -286,9 +286,9 @@ msgid "" msgstr "" msgid "" -"Attempting to decompress data after the end of stream is reached raises an :" -"exc:`EOFError`. Any data found after the end of the stream is ignored and " -"saved in the :attr:`~.unused_data` attribute." +"Attempting to decompress data after the end of stream is reached raises " +"an :exc:`EOFError`. Any data found after the end of the stream is ignored " +"and saved in the :attr:`~.unused_data` attribute." msgstr "" msgid "Added the *max_length* parameter." diff --git a/library/calendar.po b/library/calendar.po index 032fa65dd5..61b76c9e96 100644 --- a/library/calendar.po +++ b/library/calendar.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -23,11 +23,11 @@ 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 ":mod:`calendar` --- General calendar-related functions" +msgid ":mod:`!calendar` --- General calendar-related functions" msgstr "" msgid "**Source code:** :source:`Lib/calendar.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/calendar.py`" msgid "" "This module allows you to output calendars like the Unix :program:`cal` " @@ -51,8 +51,8 @@ msgstr "" msgid "" "Creates a :class:`Calendar` object. *firstweekday* is an integer specifying " -"the first day of the week. :const:`MONDAY` is ``0`` (the default), :const:" -"`SUNDAY` is ``6``." +"the first day of the week. :const:`MONDAY` is ``0`` (the " +"default), :const:`SUNDAY` is ``6``." msgstr "" msgid "" @@ -61,13 +61,35 @@ msgid "" "formatting itself. This is the job of subclasses." msgstr "" -msgid ":class:`Calendar` instances have the following methods:" +msgid ":class:`Calendar` instances have the following methods and attributes:" +msgstr "" + +msgid "The first weekday as an integer (0--6)." +msgstr "" + +msgid "" +"This property can also be set and read " +"using :meth:`~Calendar.setfirstweekday` " +"and :meth:`~Calendar.getfirstweekday` respectively." +msgstr "" + +msgid "Return an :class:`int` for the current first weekday (0--6)." +msgstr "" + +msgid "Identical to reading the :attr:`~Calendar.firstweekday` property." +msgstr "" + +msgid "" +"Set the first weekday to *firstweekday*, passed as an :class:`int` (0--6)." +msgstr "" + +msgid "Identical to setting the :attr:`~Calendar.firstweekday` property." msgstr "" msgid "" -"Return an iterator for the week day numbers that will be used for one week. " -"The first value from the iterator will be the same as the value of the :attr:" -"`firstweekday` property." +"Return an iterator for the weekday numbers that will be used for one week. " +"The first value from the iterator will be the same as the value of " +"the :attr:`~Calendar.firstweekday` property." msgstr "" msgid "" @@ -78,31 +100,31 @@ msgid "" msgstr "" msgid "" -"Return an iterator for the month *month* in the year *year* similar to :meth:" -"`itermonthdates`, but not restricted by the :class:`datetime.date` range. " -"Days returned will simply be day of the month numbers. For the days outside " -"of the specified month, the day number is ``0``." +"Return an iterator for the month *month* in the year *year* similar " +"to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` " +"range. Days returned will simply be day of the month numbers. For the days " +"outside of the specified month, the day number is ``0``." msgstr "" msgid "" -"Return an iterator for the month *month* in the year *year* similar to :meth:" -"`itermonthdates`, but not restricted by the :class:`datetime.date` range. " -"Days returned will be tuples consisting of a day of the month number and a " -"week day number." +"Return an iterator for the month *month* in the year *year* similar " +"to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` " +"range. Days returned will be tuples consisting of a day of the month number " +"and a weekday number." msgstr "" msgid "" -"Return an iterator for the month *month* in the year *year* similar to :meth:" -"`itermonthdates`, but not restricted by the :class:`datetime.date` range. " -"Days returned will be tuples consisting of a year, a month and a day of the " -"month numbers." +"Return an iterator for the month *month* in the year *year* similar " +"to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` " +"range. Days returned will be tuples consisting of a year, a month and a day " +"of the month numbers." msgstr "" msgid "" -"Return an iterator for the month *month* in the year *year* similar to :meth:" -"`itermonthdates`, but not restricted by the :class:`datetime.date` range. " -"Days returned will be tuples consisting of a year, a month, a day of the " -"month, and a day of the week numbers." +"Return an iterator for the month *month* in the year *year* similar " +"to :meth:`itermonthdates`, but not restricted by the :class:`datetime.date` " +"range. Days returned will be tuples consisting of a year, a month, a day of " +"the month, and a day of the week numbers." msgstr "" msgid "" @@ -128,15 +150,15 @@ msgid "" msgstr "" msgid "" -"Return the data for the specified year ready for formatting (similar to :" -"meth:`yeardatescalendar`). Entries in the week lists are tuples of day " +"Return the data for the specified year ready for formatting (similar " +"to :meth:`yeardatescalendar`). Entries in the week lists are tuples of day " "numbers and weekday numbers. Day numbers outside this month are zero." msgstr "" msgid "" -"Return the data for the specified year ready for formatting (similar to :" -"meth:`yeardatescalendar`). Entries in the week lists are day numbers. Day " -"numbers outside this month are zero." +"Return the data for the specified year ready for formatting (similar " +"to :meth:`yeardatescalendar`). Entries in the week lists are day numbers. " +"Day numbers outside this month are zero." msgstr "" msgid "This class can be used to generate plain text calendars." @@ -145,12 +167,44 @@ msgstr "" msgid ":class:`TextCalendar` instances have the following methods:" msgstr "" +msgid "" +"Return a string representing a single day formatted with the given *width*. " +"If *theday* is ``0``, return a string of spaces of the specified width, " +"representing an empty day. The *weekday* parameter is unused." +msgstr "" + +msgid "" +"Return a single week in a string with no newline. If *w* is provided, it " +"specifies the width of the date columns, which are centered. Depends on the " +"first weekday as specified in the constructor or set by " +"the :meth:`setfirstweekday` method." +msgstr "" + +msgid "" +"Return a string representing the name of a single weekday formatted to the " +"specified *width*. The *weekday* parameter is an integer representing the " +"day of the week, where ``0`` is Monday and ``6`` is Sunday." +msgstr "" + +msgid "" +"Return a string containing the header row of weekday names, formatted with " +"the given *width* for each column. The names depend on the locale settings " +"and are padded to the specified width." +msgstr "" + msgid "" "Return a month's calendar in a multi-line string. If *w* is provided, it " "specifies the width of the date columns, which are centered. If *l* is " "given, it specifies the number of lines that each week will use. Depends on " -"the first weekday as specified in the constructor or set by the :meth:" -"`setfirstweekday` method." +"the first weekday as specified in the constructor or set by " +"the :meth:`setfirstweekday` method." +msgstr "" + +msgid "" +"Return a string representing the month's name centered within the specified " +"*width*. If *withyear* is ``True``, include the year in the output. The " +"*theyear* and *themonth* parameters specify the year and month for the name " +"to be formatted respectively." msgstr "" msgid "Print a month's calendar as returned by :meth:`formatmonth`." @@ -160,9 +214,9 @@ msgid "" "Return a *m*-column calendar for an entire year as a multi-line string. " "Optional parameters *w*, *l*, and *c* are for date column width, lines per " "week, and number of spaces between month columns, respectively. Depends on " -"the first weekday as specified in the constructor or set by the :meth:" -"`setfirstweekday` method. The earliest year for which a calendar can be " -"generated is platform-dependent." +"the first weekday as specified in the constructor or set by " +"the :meth:`setfirstweekday` method. The earliest year for which a calendar " +"can be generated is platform-dependent." msgstr "" msgid "" @@ -193,6 +247,11 @@ msgid "" "(defaulting to the system default encoding)." msgstr "" +msgid "" +"Return a month name as an HTML table row. If *withyear* is true the year " +"will be included in the row, otherwise just the month name will be used." +msgstr "" + msgid "" ":class:`!HTMLCalendar` has the following attributes you can override to " "customize the CSS classes used by the calendar:" @@ -202,9 +261,18 @@ msgid "" "A list of CSS classes used for each weekday. The default class list is::" msgstr "" +msgid "" +"cssclasses = [\"mon\", \"tue\", \"wed\", \"thu\", \"fri\", \"sat\", \"sun\"]" +msgstr "" + msgid "more styles can be added for each day::" msgstr "" +msgid "" +"cssclasses = [\"mon text-bold\", \"tue\", \"wed\", \"thu\", \"fri\", " +"\"sat\", \"sun red\"]" +msgstr "" + msgid "Note that the length of this list must be seven items." msgstr "" @@ -227,13 +295,13 @@ msgid "" msgstr "" msgid "" -"The CSS class for the whole year's table of tables (used by :meth:" -"`formatyear`). The default value is ``\"year\"``." +"The CSS class for the whole year's table of tables (used " +"by :meth:`formatyear`). The default value is ``\"year\"``." msgstr "" msgid "" -"The CSS class for the table head for the whole year (used by :meth:" -"`formatyear`). The default value is ``\"year\"``." +"The CSS class for the table head for the whole year (used " +"by :meth:`formatyear`). The default value is ``\"year\"``." msgstr "" msgid "" @@ -242,9 +310,21 @@ msgid "" "single CSS class with a space separated list of CSS classes, for example::" msgstr "" +msgid "\"text-bold text-red\"" +msgstr "" + msgid "Here is an example how :class:`!HTMLCalendar` can be customized::" msgstr "" +msgid "" +"class CustomHTMLCal(calendar.HTMLCalendar):\n" +" cssclasses = [style + \" text-nowrap\" for style in\n" +" calendar.HTMLCalendar.cssclasses]\n" +" cssclass_month_head = \"text-center month-head\"\n" +" cssclass_month = \"text-center month\"\n" +" cssclass_year = \"text-italic lead\"" +msgstr "" + msgid "" "This subclass of :class:`TextCalendar` can be passed a locale name in the " "constructor and will return month and weekday names in the specified locale." @@ -256,7 +336,7 @@ msgid "" msgstr "" msgid "" -"The constructor, :meth:`formatweekday` and :meth:`formatmonthname` methods " +"The constructor, :meth:`!formatweekday` and :meth:`!formatmonthname` methods " "of these two classes temporarily change the ``LC_TIME`` locale to the given " "*locale*. Because the current locale is a process-wide setting, they are not " "thread-safe." @@ -267,9 +347,14 @@ msgstr "" msgid "" "Sets the weekday (``0`` is Monday, ``6`` is Sunday) to start each week. The " -"values :const:`MONDAY`, :const:`TUESDAY`, :const:`WEDNESDAY`, :const:" -"`THURSDAY`, :const:`FRIDAY`, :const:`SATURDAY`, and :const:`SUNDAY` are " -"provided for convenience. For example, to set the first weekday to Sunday::" +"values :const:`MONDAY`, :const:`TUESDAY`, :const:`WEDNESDAY`, :const:`THURSDAY`, :const:`FRIDAY`, :const:`SATURDAY`, " +"and :const:`SUNDAY` are provided for convenience. For example, to set the " +"first weekday to Sunday::" +msgstr "" + +msgid "" +"import calendar\n" +"calendar.setfirstweekday(calendar.SUNDAY)" msgstr "" msgid "Returns the current setting for the weekday to start each week." @@ -293,12 +378,12 @@ msgid "" msgstr "" msgid "" -"Return a header containing abbreviated weekday names. *n* specifies the " +"Return a header containing abbreviated weekday names. *width* specifies the " "width in characters for one weekday." msgstr "" msgid "" -"Returns weekday of first day of the month and number of days in month, for " +"Returns weekday of first day of the month and number of days in month, for " "the specified *year* and *month*." msgstr "" @@ -312,8 +397,8 @@ msgid "Prints a month's calendar as returned by :func:`month`." msgstr "" msgid "" -"Returns a month's calendar in a multi-line string using the :meth:" -"`formatmonth` of the :class:`TextCalendar` class." +"Returns a month's calendar in a multi-line string using " +"the :meth:`~TextCalendar.formatmonth` of the :class:`TextCalendar` class." msgstr "" msgid "" @@ -322,42 +407,86 @@ msgstr "" msgid "" "Returns a 3-column calendar for an entire year as a multi-line string using " -"the :meth:`formatyear` of the :class:`TextCalendar` class." +"the :meth:`~TextCalendar.formatyear` of the :class:`TextCalendar` class." msgstr "" msgid "" "An unrelated but handy function that takes a time tuple such as returned by " "the :func:`~time.gmtime` function in the :mod:`time` module, and returns the " "corresponding Unix timestamp value, assuming an epoch of 1970, and the POSIX " -"encoding. In fact, :func:`time.gmtime` and :func:`timegm` are each others' " +"encoding. In fact, :func:`time.gmtime` and :func:`timegm` are each other's " "inverse." msgstr "" msgid "The :mod:`calendar` module exports the following data attributes:" msgstr "" -msgid "An array that represents the days of the week in the current locale." +msgid "" +"A sequence that represents the days of the week in the current locale, where " +"Monday is day number 0." +msgstr "" + +msgid "" +"A sequence that represents the abbreviated days of the week in the current " +"locale, where Mon is day number 0." +msgstr "" + +msgid "" +"Aliases for the days of the week, where ``MONDAY`` is ``0`` and ``SUNDAY`` " +"is ``6``." msgstr "" msgid "" -"An array that represents the abbreviated days of the week in the current " -"locale." +"Enumeration defining days of the week as integer constants. The members of " +"this enumeration are exported to the module scope as :data:`MONDAY` " +"through :data:`SUNDAY`." msgstr "" msgid "" -"An array that represents the months of the year in the current locale. This " -"follows normal convention of January being month number 1, so it has a " -"length of 13 and ``month_name[0]`` is the empty string." +"A sequence that represents the months of the year in the current locale. " +"This follows normal convention of January being month number 1, so it has a " +"length of 13 and ``month_name[0]`` is the empty string." msgstr "" msgid "" -"An array that represents the abbreviated months of the year in the current " +"A sequence that represents the abbreviated months of the year in the current " "locale. This follows normal convention of January being month number 1, so " "it has a length of 13 and ``month_abbr[0]`` is the empty string." msgstr "" msgid "" -"Aliases for day numbers, where ``MONDAY`` is ``0`` and ``SUNDAY`` is ``6``." +"Aliases for the months of the year, where ``JANUARY`` is ``1`` and " +"``DECEMBER`` is ``12``." +msgstr "" + +msgid "" +"Enumeration defining months of the year as integer constants. The members of " +"this enumeration are exported to the module scope as :data:`JANUARY` " +"through :data:`DECEMBER`." +msgstr "" + +msgid "The :mod:`calendar` module defines the following exceptions:" +msgstr "" + +msgid "" +"A subclass of :exc:`ValueError` and :exc:`IndexError`, raised when the given " +"month number is outside of the range 1-12 (inclusive)." +msgstr "" + +msgid "" +":exc:`IllegalMonthError` is now also a subclass of :exc:`ValueError`. New " +"code should avoid catching :exc:`IndexError`." +msgstr "" + +msgid "The invalid month number." +msgstr "" + +msgid "" +"A subclass of :exc:`ValueError`, raised when the given weekday number is " +"outside of the range 0-6 (inclusive)." +msgstr "" + +msgid "The invalid weekday number." msgstr "" msgid "Module :mod:`datetime`" @@ -373,3 +502,157 @@ msgstr "" msgid "Low-level time related functions." msgstr "" + +msgid "Command-Line Usage" +msgstr "" + +msgid "" +"The :mod:`calendar` module can be executed as a script from the command line " +"to interactively print a calendar." +msgstr "" + +msgid "" +"python -m calendar [-h] [-L LOCALE] [-e ENCODING] [-t {text,html}]\n" +" [-w WIDTH] [-l LINES] [-s SPACING] [-m MONTHS] [-c CSS]\n" +" [-f FIRST_WEEKDAY] [year] [month]" +msgstr "" + +msgid "For example, to print a calendar for the year 2000:" +msgstr "" + +msgid "" +"$ python -m calendar 2000\n" +" 2000\n" +"\n" +" January February March\n" +"Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su\n" +" 1 2 1 2 3 4 5 6 1 2 3 4 5\n" +" 3 4 5 6 7 8 9 7 8 9 10 11 12 13 6 7 8 9 10 11 12\n" +"10 11 12 13 14 15 16 14 15 16 17 18 19 20 13 14 15 16 17 18 19\n" +"17 18 19 20 21 22 23 21 22 23 24 25 26 27 20 21 22 23 24 25 26\n" +"24 25 26 27 28 29 30 28 29 27 28 29 30 31\n" +"31\n" +"\n" +" April May June\n" +"Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su\n" +" 1 2 1 2 3 4 5 6 7 1 2 3 4\n" +" 3 4 5 6 7 8 9 8 9 10 11 12 13 14 5 6 7 8 9 10 11\n" +"10 11 12 13 14 15 16 15 16 17 18 19 20 21 12 13 14 15 16 17 18\n" +"17 18 19 20 21 22 23 22 23 24 25 26 27 28 19 20 21 22 23 24 25\n" +"24 25 26 27 28 29 30 29 30 31 26 27 28 29 30\n" +"\n" +" July August September\n" +"Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su\n" +" 1 2 1 2 3 4 5 6 1 2 3\n" +" 3 4 5 6 7 8 9 7 8 9 10 11 12 13 4 5 6 7 8 9 10\n" +"10 11 12 13 14 15 16 14 15 16 17 18 19 20 11 12 13 14 15 16 17\n" +"17 18 19 20 21 22 23 21 22 23 24 25 26 27 18 19 20 21 22 23 24\n" +"24 25 26 27 28 29 30 28 29 30 31 25 26 27 28 29 30\n" +"31\n" +"\n" +" October November December\n" +"Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su\n" +" 1 1 2 3 4 5 1 2 3\n" +" 2 3 4 5 6 7 8 6 7 8 9 10 11 12 4 5 6 7 8 9 10\n" +" 9 10 11 12 13 14 15 13 14 15 16 17 18 19 11 12 13 14 15 16 17\n" +"16 17 18 19 20 21 22 20 21 22 23 24 25 26 18 19 20 21 22 23 24\n" +"23 24 25 26 27 28 29 27 28 29 30 25 26 27 28 29 30 31\n" +"30 31" +msgstr "" +"$ python -m calendar 2000\n" +" 2000\n" +"\n" +" January February March\n" +"Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su\n" +" 1 2 1 2 3 4 5 6 1 2 3 4 5\n" +" 3 4 5 6 7 8 9 7 8 9 10 11 12 13 6 7 8 9 10 11 12\n" +"10 11 12 13 14 15 16 14 15 16 17 18 19 20 13 14 15 16 17 18 19\n" +"17 18 19 20 21 22 23 21 22 23 24 25 26 27 20 21 22 23 24 25 26\n" +"24 25 26 27 28 29 30 28 29 27 28 29 30 31\n" +"31\n" +"\n" +" April May June\n" +"Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su\n" +" 1 2 1 2 3 4 5 6 7 1 2 3 4\n" +" 3 4 5 6 7 8 9 8 9 10 11 12 13 14 5 6 7 8 9 10 11\n" +"10 11 12 13 14 15 16 15 16 17 18 19 20 21 12 13 14 15 16 17 18\n" +"17 18 19 20 21 22 23 22 23 24 25 26 27 28 19 20 21 22 23 24 25\n" +"24 25 26 27 28 29 30 29 30 31 26 27 28 29 30\n" +"\n" +" July August September\n" +"Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su\n" +" 1 2 1 2 3 4 5 6 1 2 3\n" +" 3 4 5 6 7 8 9 7 8 9 10 11 12 13 4 5 6 7 8 9 10\n" +"10 11 12 13 14 15 16 14 15 16 17 18 19 20 11 12 13 14 15 16 17\n" +"17 18 19 20 21 22 23 21 22 23 24 25 26 27 18 19 20 21 22 23 24\n" +"24 25 26 27 28 29 30 28 29 30 31 25 26 27 28 29 30\n" +"31\n" +"\n" +" October November December\n" +"Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su Mo Tu We Th Fr Sa Su\n" +" 1 1 2 3 4 5 1 2 3\n" +" 2 3 4 5 6 7 8 6 7 8 9 10 11 12 4 5 6 7 8 9 10\n" +" 9 10 11 12 13 14 15 13 14 15 16 17 18 19 11 12 13 14 15 16 17\n" +"16 17 18 19 20 21 22 20 21 22 23 24 25 26 18 19 20 21 22 23 24\n" +"23 24 25 26 27 28 29 27 28 29 30 25 26 27 28 29 30 31\n" +"30 31" + +msgid "The following options are accepted:" +msgstr "" + +msgid "Show the help message and exit." +msgstr "" + +msgid "The locale to use for month and weekday names. Defaults to English." +msgstr "" + +msgid "" +"The encoding to use for output. :option:`--encoding` is required " +"if :option:`--locale` is set." +msgstr "" + +msgid "Print the calendar to the terminal as text, or as an HTML document." +msgstr "" + +msgid "" +"The weekday to start each week. Must be a number between 0 (Monday) and 6 " +"(Sunday). Defaults to 0." +msgstr "" + +msgid "The year to print the calendar for. Defaults to the current year." +msgstr "" + +msgid "" +"The month of the specified :option:`year` to print the calendar for. Must be " +"a number between 1 and 12, and may only be used in text mode. Defaults to " +"printing a calendar for the full year." +msgstr "" + +msgid "*Text-mode options:*" +msgstr "" + +msgid "" +"The width of the date column in terminal columns. The date is printed " +"centred in the column. Any value lower than 2 is ignored. Defaults to 2." +msgstr "" + +msgid "" +"The number of lines for each week in terminal rows. The date is printed top-" +"aligned. Any value lower than 1 is ignored. Defaults to 1." +msgstr "" + +msgid "" +"The space between months in columns. Any value lower than 2 is ignored. " +"Defaults to 6." +msgstr "" + +msgid "The number of months printed per row. Defaults to 3." +msgstr "" + +msgid "*HTML-mode options:*" +msgstr "" + +msgid "" +"The path of a CSS stylesheet to use for the calendar. This must either be " +"relative to the generated HTML, or an absolute HTTP or ``file:///`` URL." +msgstr "" diff --git a/library/cmath.po b/library/cmath.po index 2dcc69e985..f66b083d23 100644 --- a/library/cmath.po +++ b/library/cmath.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -78,13 +76,13 @@ msgid "**Conversions to and from polar coordinates**" msgstr "" msgid ":func:`phase(z) `" -msgstr "" +msgstr ":func:`phase(z) `" msgid "Return the phase of *z*" msgstr "" msgid ":func:`polar(z) `" -msgstr "" +msgstr ":func:`polar(z) `" msgid "Return the representation of *z* in polar coordinates" msgstr "" @@ -99,7 +97,7 @@ msgid "**Power and logarithmic functions**" msgstr "" msgid ":func:`exp(z) `" -msgstr "" +msgstr ":func:`exp(z) `" msgid "Return *e* raised to the power *z*" msgstr "" @@ -111,13 +109,13 @@ msgid "Return the logarithm of *z* to the given *base* (*e* by default)" msgstr "" msgid ":func:`log10(z) `" -msgstr "" +msgstr ":func:`log10(z) `" msgid "Return the base-10 logarithm of *z*" msgstr "" msgid ":func:`sqrt(z) `" -msgstr "" +msgstr ":func:`sqrt(z) `" msgid "Return the square root of *z*" msgstr "" @@ -126,37 +124,37 @@ msgid "**Trigonometric functions**" msgstr "" msgid ":func:`acos(z) `" -msgstr "" +msgstr ":func:`acos(z) `" msgid "Return the arc cosine of *z*" msgstr "" msgid ":func:`asin(z) `" -msgstr "" +msgstr ":func:`asin(z) `" msgid "Return the arc sine of *z*" msgstr "" msgid ":func:`atan(z) `" -msgstr "" +msgstr ":func:`atan(z) `" msgid "Return the arc tangent of *z*" msgstr "" msgid ":func:`cos(z) `" -msgstr "" +msgstr ":func:`cos(z) `" msgid "Return the cosine of *z*" msgstr "" msgid ":func:`sin(z) `" -msgstr "" +msgstr ":func:`sin(z) `" msgid "Return the sine of *z*" msgstr "" msgid ":func:`tan(z) `" -msgstr "" +msgstr ":func:`tan(z) `" msgid "Return the tangent of *z*" msgstr "" @@ -165,37 +163,37 @@ msgid "**Hyperbolic functions**" msgstr "" msgid ":func:`acosh(z) `" -msgstr "" +msgstr ":func:`acosh(z) `" msgid "Return the inverse hyperbolic cosine of *z*" msgstr "" msgid ":func:`asinh(z) `" -msgstr "" +msgstr ":func:`asinh(z) `" msgid "Return the inverse hyperbolic sine of *z*" msgstr "" msgid ":func:`atanh(z) `" -msgstr "" +msgstr ":func:`atanh(z) `" msgid "Return the inverse hyperbolic tangent of *z*" msgstr "" msgid ":func:`cosh(z) `" -msgstr "" +msgstr ":func:`cosh(z) `" msgid "Return the hyperbolic cosine of *z*" msgstr "" msgid ":func:`sinh(z) `" -msgstr "" +msgstr ":func:`sinh(z) `" msgid "Return the hyperbolic sine of *z*" msgstr "" msgid ":func:`tanh(z) `" -msgstr "" +msgstr ":func:`tanh(z) `" msgid "Return the hyperbolic tangent of *z*" msgstr "" @@ -204,19 +202,19 @@ msgid "**Classification functions**" msgstr "" msgid ":func:`isfinite(z) `" -msgstr "" +msgstr ":func:`isfinite(z) `" msgid "Check if all components of *z* are finite" msgstr "" msgid ":func:`isinf(z) `" -msgstr "" +msgstr ":func:`isinf(z) `" msgid "Check if any component of *z* is infinite" msgstr "" msgid ":func:`isnan(z) `" -msgstr "" +msgstr ":func:`isnan(z) `" msgid "Check if any component of *z* is a NaN" msgstr "" @@ -255,7 +253,7 @@ msgid "Positive infinity" msgstr "" msgid ":data:`infj`" -msgstr "" +msgstr ":data:`infj`" msgid "Pure imaginary infinity" msgstr "" @@ -267,7 +265,7 @@ msgid "\"Not a number\" (NaN)" msgstr "" msgid ":data:`nanj`" -msgstr "" +msgstr ":data:`nanj`" msgid "Pure imaginary NaN" msgstr "" @@ -277,8 +275,8 @@ msgstr "" msgid "" "A Python complex number ``z`` is stored internally using *rectangular* or " -"*Cartesian* coordinates. It is completely determined by its *real part* ``z." -"real`` and its *imaginary part* ``z.imag``." +"*Cartesian* coordinates. It is completely determined by its *real part* " +"``z.real`` and its *imaginary part* ``z.imag``." msgstr "" msgid "" @@ -346,8 +344,8 @@ msgid "" msgstr "" msgid "" -"Return the base-10 logarithm of *z*. This has the same branch cut as :func:" -"`log`." +"Return the base-10 logarithm of *z*. This has the same branch cut " +"as :func:`log`." msgstr "" msgid "" @@ -491,7 +489,7 @@ msgstr "" msgid "" "A floating-point \"not a number\" (NaN) value. Equivalent to " -"``float('nan')``." +"``float('nan')``. See also :data:`math.nan`." msgstr "" msgid "" @@ -504,10 +502,10 @@ msgid "" "in module :mod:`math`. The reason for having two modules is that some users " "aren't interested in complex numbers, and perhaps don't even know what they " "are. They would rather have ``math.sqrt(-1)`` raise an exception than " -"return a complex number. Also note that the functions defined in :mod:" -"`cmath` always return a complex number, even if the answer can be expressed " -"as a real number (in which case the complex number has an imaginary part of " -"zero)." +"return a complex number. Also note that the functions defined " +"in :mod:`cmath` always return a complex number, even if the answer can be " +"expressed as a real number (in which case the complex number has an " +"imaginary part of zero)." msgstr "" msgid "" diff --git a/library/cmd.po b/library/cmd.po index d51d0d3a03..a85ae015c8 100644 --- a/library/cmd.po +++ b/library/cmd.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,30 +46,30 @@ msgstr "" msgid "" "The optional argument *completekey* is the :mod:`readline` name of a " -"completion key; it defaults to :kbd:`Tab`. If *completekey* is not :const:" -"`None` and :mod:`readline` is available, command completion is done " -"automatically." +"completion key; it defaults to :kbd:`Tab`. If *completekey* is " +"not :const:`None` and :mod:`readline` is available, command completion is " +"done automatically." msgstr "" msgid "" -"The default, ``'tab'``, is treated specially, so that it refers to the :kbd:" -"`Tab` key on every :data:`readline.backend`. Specifically, if :data:" -"`readline.backend` is ``editline``, ``Cmd`` will use ``'^I'`` instead of " -"``'tab'``. Note that other values are not treated this way, and might only " -"work with a specific backend." +"The default, ``'tab'``, is treated specially, so that it refers to " +"the :kbd:`Tab` key on every :data:`readline.backend`. Specifically, " +"if :data:`readline.backend` is ``editline``, ``Cmd`` will use ``'^I'`` " +"instead of ``'tab'``. Note that other values are not treated this way, and " +"might only work with a specific backend." msgstr "" msgid "" "The optional arguments *stdin* and *stdout* specify the input and output " "file objects that the Cmd instance or subclass instance will use for input " -"and output. If not specified, they will default to :data:`sys.stdin` and :" -"data:`sys.stdout`." +"and output. If not specified, they will default to :data:`sys.stdin` " +"and :data:`sys.stdout`." msgstr "" msgid "" -"If you want a given *stdin* to be used, make sure to set the instance's :" -"attr:`use_rawinput` attribute to ``False``, otherwise *stdin* will be " -"ignored." +"If you want a given *stdin* to be used, make sure to set the " +"instance's :attr:`use_rawinput` attribute to ``False``, otherwise *stdin* " +"will be ignored." msgstr "" msgid "``completekey='tab'`` is replaced by ``'^I'`` for ``editline``." @@ -93,11 +93,12 @@ msgid "" msgstr "" msgid "" -"If the :mod:`readline` module is loaded, input will automatically inherit :" -"program:`bash`\\ -like history-list editing (e.g. :kbd:`Control-P` scrolls " -"back to the last command, :kbd:`Control-N` forward to the next one, :kbd:" -"`Control-F` moves the cursor to the right non-destructively, :kbd:`Control-" -"B` moves the cursor to the left non-destructively, etc.)." +"If the :mod:`readline` module is loaded, input will automatically " +"inherit :program:`bash`\\ -like history-list editing (e.g. :kbd:`Control-P` " +"scrolls back to the last command, :kbd:`Control-N` forward to the next " +"one, :kbd:`Control-F` moves the cursor to the right non-" +"destructively, :kbd:`Control-B` moves the cursor to the left non-" +"destructively, etc.)." msgstr "" msgid "An end-of-file on input is passed back as the string ``'EOF'``." @@ -130,20 +131,20 @@ msgstr "" msgid "" "All subclasses of :class:`Cmd` inherit a predefined :meth:`!do_help`. This " -"method, called with an argument ``'bar'``, invokes the corresponding method :" -"meth:`!help_bar`, and if that is not present, prints the docstring of :meth:" -"`!do_bar`, if available. With no argument, :meth:`!do_help` lists all " -"available help topics (that is, all commands with corresponding :meth:`!" +"method, called with an argument ``'bar'``, invokes the corresponding " +"method :meth:`!help_bar`, and if that is not present, prints the docstring " +"of :meth:`!do_bar`, if available. With no argument, :meth:`!do_help` lists " +"all available help topics (that is, all commands with corresponding :meth:`!" "help_\\*` methods or commands that have docstrings), and also lists any " "undocumented commands." msgstr "" msgid "" "Interpret the argument as though it had been typed in response to the " -"prompt. This may be overridden, but should not normally need to be; see the :" -"meth:`precmd` and :meth:`postcmd` methods for useful execution hooks. The " -"return value is a flag indicating whether interpretation of commands by the " -"interpreter should stop. If there is a :meth:`!do_\\*` method for the " +"prompt. This may be overridden, but should not normally need to be; see " +"the :meth:`precmd` and :meth:`postcmd` methods for useful execution hooks. " +"The return value is a flag indicating whether interpretation of commands by " +"the interpreter should stop. If there is a :meth:`!do_\\*` method for the " "command *str*, the return value of that method is returned, otherwise the " "return value from the :meth:`default` method is returned." msgstr "" @@ -171,9 +172,9 @@ msgstr "" msgid "" "Hook method executed just before the command line *line* is interpreted, but " -"after the input prompt is generated and issued. This method is a stub in :" -"class:`Cmd`; it exists to be overridden by subclasses. The return value is " -"used as the command which will be executed by the :meth:`onecmd` method; " +"after the input prompt is generated and issued. This method is a stub " +"in :class:`Cmd`; it exists to be overridden by subclasses. The return value " +"is used as the command which will be executed by the :meth:`onecmd` method; " "the :meth:`precmd` implementation may re-write the command or simply return " "*line* unchanged." msgstr "" @@ -212,14 +213,14 @@ msgid "The last nonempty command prefix seen." msgstr "" msgid "" -"A list of queued input lines. The cmdqueue list is checked in :meth:" -"`cmdloop` when new input is needed; if it is nonempty, its elements will be " -"processed in order, as if entered at the prompt." +"A list of queued input lines. The cmdqueue list is checked " +"in :meth:`cmdloop` when new input is needed; if it is nonempty, its elements " +"will be processed in order, as if entered at the prompt." msgstr "" msgid "" -"A string to issue as an intro or banner. May be overridden by giving the :" -"meth:`cmdloop` method an argument." +"A string to issue as an intro or banner. May be overridden by giving " +"the :meth:`cmdloop` method an argument." msgstr "" msgid "" @@ -228,14 +229,14 @@ msgstr "" msgid "" "The header to issue if the help output has a section for miscellaneous help " -"topics (that is, there are :meth:`!help_\\*` methods without corresponding :" -"meth:`!do_\\*` methods)." +"topics (that is, there are :meth:`!help_\\*` methods without " +"corresponding :meth:`!do_\\*` methods)." msgstr "" msgid "" "The header to issue if the help output has a section for undocumented " -"commands (that is, there are :meth:`!do_\\*` methods without corresponding :" -"meth:`!help_\\*` methods)." +"commands (that is, there are :meth:`!do_\\*` methods without " +"corresponding :meth:`!help_\\*` methods)." msgstr "" msgid "" @@ -245,11 +246,12 @@ msgstr "" msgid "" "A flag, defaulting to true. If true, :meth:`cmdloop` uses :func:`input` to " -"display a prompt and read the next command; if false, :data:`sys.stdout." -"write() ` and :data:`sys.stdin.readline() ` are used. " -"(This means that by importing :mod:`readline`, on systems that support it, " -"the interpreter will automatically support :program:`Emacs`\\ -like line " -"editing and command-history keystrokes.)" +"display a prompt and read the next command; if " +"false, :data:`sys.stdout.write() ` " +"and :data:`sys.stdin.readline() ` are used. (This means that by " +"importing :mod:`readline`, on systems that support it, the interpreter will " +"automatically support :program:`Emacs`\\ -like line editing and command-" +"history keystrokes.)" msgstr "" msgid "Cmd Example" @@ -266,18 +268,18 @@ msgid "" msgstr "" msgid "" -"Basic turtle commands such as :meth:`~turtle.forward` are added to a :class:" -"`Cmd` subclass with method named :meth:`!do_forward`. The argument is " -"converted to a number and dispatched to the turtle module. The docstring is " -"used in the help utility provided by the shell." +"Basic turtle commands such as :meth:`~turtle.forward` are added to " +"a :class:`Cmd` subclass with method named :meth:`!do_forward`. The argument " +"is converted to a number and dispatched to the turtle module. The docstring " +"is used in the help utility provided by the shell." msgstr "" msgid "" "The example also includes a basic record and playback facility implemented " "with the :meth:`~Cmd.precmd` method which is responsible for converting the " "input to lowercase and writing the commands to a file. The :meth:`!" -"do_playback` method reads the file and adds the recorded commands to the :" -"attr:`~Cmd.cmdqueue` for immediate playback::" +"do_playback` method reads the file and adds the recorded commands to " +"the :attr:`~Cmd.cmdqueue` for immediate playback::" msgstr "" msgid "" diff --git a/library/cmdline.po b/library/cmdline.po index d173bf2f16..89d375409f 100644 --- a/library/cmdline.po +++ b/library/cmdline.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2023-10-13 14:16+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,22 +30,22 @@ msgid "The following modules have a command-line interface." msgstr "" msgid ":ref:`ast `" -msgstr "" +msgstr ":ref:`ast `" msgid ":ref:`asyncio `" -msgstr "" +msgstr ":ref:`asyncio `" msgid ":mod:`base64`" msgstr ":mod:`base64`" msgid ":ref:`calendar `" -msgstr "" +msgstr ":ref:`calendar `" msgid ":mod:`code`" msgstr ":mod:`code`" msgid ":ref:`compileall `" -msgstr "" +msgstr ":ref:`compileall `" msgid ":mod:`cProfile`: see :ref:`profile `" msgstr "" @@ -54,16 +54,16 @@ msgid ":ref:`difflib `" msgstr "" msgid ":ref:`dis `" -msgstr "" +msgstr ":ref:`dis `" msgid ":ref:`doctest `" -msgstr "" +msgstr ":ref:`doctest `" msgid ":mod:`!encodings.rot_13`" msgstr ":mod:`!encodings.rot_13`" -msgid ":mod:`ensurepip`" -msgstr ":mod:`ensurepip`" +msgid ":ref:`ensurepip `" +msgstr "" msgid ":mod:`filecmp`" msgstr ":mod:`filecmp`" @@ -75,16 +75,16 @@ msgid ":mod:`ftplib`" msgstr ":mod:`ftplib`" msgid ":ref:`gzip `" -msgstr "" +msgstr ":ref:`gzip `" msgid ":ref:`http.server `" -msgstr "" +msgstr ":ref:`http.server `" -msgid ":mod:`!idlelib`" -msgstr ":mod:`!idlelib`" +msgid ":ref:`idlelib `" +msgstr "" msgid ":ref:`inspect `" -msgstr "" +msgstr ":ref:`inspect `" msgid ":ref:`json.tool `" msgstr "" @@ -92,29 +92,29 @@ msgstr "" msgid ":mod:`mimetypes`" msgstr ":mod:`mimetypes`" -msgid ":mod:`pdb`" -msgstr ":mod:`pdb`" +msgid ":ref:`pdb `" +msgstr "" msgid ":mod:`pickle`" msgstr ":mod:`pickle`" msgid ":ref:`pickletools `" -msgstr "" +msgstr ":ref:`pickletools `" -msgid ":mod:`platform`" -msgstr ":mod:`platform`" +msgid ":ref:`platform `" +msgstr ":ref:`platform `" msgid ":mod:`poplib`" msgstr ":mod:`poplib`" msgid ":ref:`profile `" -msgstr "" +msgstr ":ref:`profile `" msgid ":mod:`pstats`" msgstr ":mod:`pstats`" msgid ":ref:`py_compile `" -msgstr "" +msgstr ":ref:`py_compile `" msgid ":mod:`pyclbr`" msgstr ":mod:`pyclbr`" @@ -126,61 +126,61 @@ msgid ":mod:`quopri`" msgstr ":mod:`quopri`" msgid ":ref:`random `" -msgstr "" +msgstr ":ref:`random `" msgid ":mod:`runpy`" msgstr ":mod:`runpy`" msgid ":ref:`site `" -msgstr "" +msgstr ":ref:`site `" msgid ":ref:`sqlite3 `" -msgstr "" +msgstr ":ref:`sqlite3 `" msgid ":ref:`symtable `" -msgstr "" +msgstr ":ref:`symtable `" msgid ":ref:`sysconfig `" -msgstr "" +msgstr ":ref:`sysconfig `" msgid ":mod:`tabnanny`" msgstr ":mod:`tabnanny`" msgid ":ref:`tarfile `" -msgstr "" +msgstr ":ref:`tarfile `" msgid ":mod:`!this`" msgstr ":mod:`!this`" msgid ":ref:`timeit `" -msgstr "" +msgstr ":ref:`timeit `" msgid ":ref:`tokenize `" -msgstr "" +msgstr ":ref:`tokenize `" msgid ":ref:`trace `" -msgstr "" +msgstr ":ref:`trace `" msgid ":mod:`turtledemo`" msgstr ":mod:`turtledemo`" msgid ":ref:`unittest `" -msgstr "" +msgstr ":ref:`unittest `" msgid ":ref:`uuid `" -msgstr "" +msgstr ":ref:`uuid `" -msgid ":mod:`venv`" -msgstr ":mod:`venv`" +msgid ":ref:`venv `" +msgstr "" -msgid ":mod:`webbrowser`" -msgstr ":mod:`webbrowser`" +msgid ":ref:`webbrowser `" +msgstr "" msgid ":ref:`zipapp `" -msgstr "" +msgstr ":ref:`zipapp `" msgid ":ref:`zipfile `" -msgstr "" +msgstr ":ref:`zipfile `" msgid "See also the :ref:`Python command-line interface `." msgstr "" diff --git a/library/cmdlinelibs.po b/library/cmdlinelibs.po index 7e1ea520a7..995c0b86fb 100644 --- a/library/cmdlinelibs.po +++ b/library/cmdlinelibs.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2024-12-27 14:18+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -23,7 +24,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 "Command Line Interface Libraries" +msgid "Command-line interface libraries" msgstr "Biblioteki interfejsu wiersza poleceń" msgid "" diff --git a/library/code.po b/library/code.po index 2f09124563..1072c98ec8 100644 --- a/library/code.po +++ b/library/code.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-15 19:50+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -44,12 +44,19 @@ msgid "" "``'__console__'`` and key ``'__doc__'`` set to ``None``." msgstr "" +msgid "" +"Note that functions and classes objects created under an :class:`!" +"InteractiveInterpreter` instance will belong to the namespace specified by " +"*locals*. They are only pickleable if *locals* is the namespace of an " +"existing module." +msgstr "" + msgid "" "Closely emulate the behavior of the interactive Python interpreter. This " "class builds on :class:`InteractiveInterpreter` and adds prompting using the " "familiar ``sys.ps1`` and ``sys.ps2``, and input buffering. If *local_exit* " -"is true, ``exit()`` and ``quit()`` in the console will not raise :exc:" -"`SystemExit`, but instead return to the calling code." +"is true, ``exit()`` and ``quit()`` in the console will not " +"raise :exc:`SystemExit`, but instead return to the calling code." msgstr "" msgid "Added *local_exit* parameter." @@ -61,9 +68,9 @@ msgid "" "the :meth:`InteractiveConsole.raw_input` method, if provided. If *local* is " "provided, it is passed to the :class:`InteractiveConsole` constructor for " "use as the default namespace for the interpreter loop. If *local_exit* is " -"provided, it is passed to the :class:`InteractiveConsole` constructor. The :" -"meth:`~InteractiveConsole.interact` method of the instance is then run with " -"*banner* and *exitmsg* passed as the banner and exit message to use, if " +"provided, it is passed to the :class:`InteractiveConsole` constructor. " +"The :meth:`~InteractiveConsole.interact` method of the instance is then run " +"with *banner* and *exitmsg* passed as the banner and exit message to use, if " "provided. The console object is discarded after use." msgstr "" @@ -104,10 +111,9 @@ msgid "" msgstr "" msgid "" -"The input is incorrect; :func:`compile_command` raised an exception (:exc:" -"`SyntaxError` or :exc:`OverflowError`). A syntax traceback will be printed " -"by calling the :meth:`showsyntaxerror` method. :meth:`runsource` returns " -"``False``." +"The input is incorrect; :func:`compile_command` raised an exception " +"(usually :exc:`SyntaxError`). A syntax traceback will be printed by calling " +"the :meth:`showsyntaxerror` method. :meth:`runsource` returns ``False``." msgstr "" msgid "" @@ -123,14 +129,14 @@ msgid "" msgstr "" msgid "" -"The return value can be used to decide whether to use ``sys.ps1`` or ``sys." -"ps2`` to prompt the next line." +"The return value can be used to decide whether to use ``sys.ps1`` or " +"``sys.ps2`` to prompt the next line." msgstr "" msgid "" "Execute a code object. When an exception occurs, :meth:`showtraceback` is " -"called to display a traceback. All exceptions are caught except :exc:" -"`SystemExit`, which is allowed to propagate." +"called to display a traceback. All exceptions are caught " +"except :exc:`SystemExit`, which is allowed to propagate." msgstr "" msgid "" @@ -168,9 +174,9 @@ msgid "Interactive Console Objects" msgstr "" msgid "" -"The :class:`InteractiveConsole` class is a subclass of :class:" -"`InteractiveInterpreter`, and so offers all the methods of the interpreter " -"objects as well as the following additions." +"The :class:`InteractiveConsole` class is a subclass " +"of :class:`InteractiveInterpreter`, and so offers all the methods of the " +"interpreter objects as well as the following additions." msgstr "" msgid "" @@ -211,7 +217,7 @@ msgstr "" msgid "" "Write a prompt and read a line. The returned line does not include the " -"trailing newline. When the user enters the EOF key sequence, :exc:" -"`EOFError` is raised. The base implementation reads from ``sys.stdin``; a " -"subclass may replace this with a different implementation." +"trailing newline. When the user enters the EOF key " +"sequence, :exc:`EOFError` is raised. The base implementation reads from " +"``sys.stdin``; a subclass may replace this with a different implementation." msgstr "" diff --git a/library/codecs.po b/library/codecs.po index dac1714641..823272af9d 100644 --- a/library/codecs.po +++ b/library/codecs.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,9 +51,9 @@ msgstr "" msgid "" "*Errors* may be given to set the desired error handling scheme. The default " -"error handler is ``'strict'`` meaning that encoding errors raise :exc:" -"`ValueError` (or a more codec specific subclass, such as :exc:" -"`UnicodeEncodeError`). Refer to :ref:`codec-base-classes` for more " +"error handler is ``'strict'`` meaning that encoding errors " +"raise :exc:`ValueError` (or a more codec specific subclass, such " +"as :exc:`UnicodeEncodeError`). Refer to :ref:`codec-base-classes` for more " "information on codec error handling." msgstr "" @@ -63,25 +62,34 @@ msgstr "" msgid "" "*Errors* may be given to set the desired error handling scheme. The default " -"error handler is ``'strict'`` meaning that decoding errors raise :exc:" -"`ValueError` (or a more codec specific subclass, such as :exc:" -"`UnicodeDecodeError`). Refer to :ref:`codec-base-classes` for more " +"error handler is ``'strict'`` meaning that decoding errors " +"raise :exc:`ValueError` (or a more codec specific subclass, such " +"as :exc:`UnicodeDecodeError`). Refer to :ref:`codec-base-classes` for more " "information on codec error handling." msgstr "" +msgid "" +"Return a mapping suitable for encoding with a custom single-byte encoding. " +"Given a :class:`str` *string* of up to 256 characters representing a " +"decoding table, returns either a compact internal mapping object " +"``EncodingMap`` or a :class:`dictionary ` mapping character ordinals " +"to byte values. Raises a :exc:`TypeError` on invalid input." +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." +"Looks up the codec info in the Python codec registry and returns " +"a :class:`CodecInfo` object as defined below." msgstr "" msgid "" "Encodings are first looked up in the registry's cache. If not found, the " "list of registered search functions is scanned. If no :class:`CodecInfo` " -"object is found, a :exc:`LookupError` is raised. Otherwise, the :class:" -"`CodecInfo` object is stored in the cache and returned to the caller." +"object is found, a :exc:`LookupError` is raised. Otherwise, " +"the :class:`CodecInfo` object is stored in the cache and returned to the " +"caller." msgstr "" msgid "" @@ -94,23 +102,23 @@ msgstr "" msgid "" "The stateless encoding and decoding functions. These must be functions or " -"methods which have the same interface as the :meth:`~Codec.encode` and :meth:" -"`~Codec.decode` methods of Codec instances (see :ref:`Codec Interface `). The functions or methods are expected to work in a stateless " -"mode." +"methods which have the same interface as the :meth:`~Codec.encode` " +"and :meth:`~Codec.decode` methods of Codec instances (see :ref:`Codec " +"Interface `). The functions or methods are expected to work " +"in a stateless mode." msgstr "" msgid "" "Incremental encoder and decoder classes or factory functions. These have to " -"provide the interface defined by the base classes :class:" -"`IncrementalEncoder` and :class:`IncrementalDecoder`, respectively. " -"Incremental codecs can maintain state." +"provide the interface defined by the base " +"classes :class:`IncrementalEncoder` and :class:`IncrementalDecoder`, " +"respectively. Incremental codecs can maintain state." msgstr "" msgid "" "Stream writer and reader classes or factory functions. These have to provide " -"the interface defined by the base classes :class:`StreamWriter` and :class:" -"`StreamReader`, respectively. Stream codecs can maintain state." +"the interface defined by the base classes :class:`StreamWriter` " +"and :class:`StreamReader`, respectively. Stream codecs can maintain state." msgstr "" msgid "" @@ -150,13 +158,13 @@ msgid "" msgstr "" msgid "" -"Look up the codec for the given encoding and return its :class:" -"`StreamReader` class or factory function." +"Look up the codec for the given encoding and return " +"its :class:`StreamReader` class or factory function." msgstr "" msgid "" -"Look up the codec for the given encoding and return its :class:" -"`StreamWriter` class or factory function." +"Look up the codec for the given encoding and return " +"its :class:`StreamWriter` class or factory function." msgstr "" msgid "" @@ -188,9 +196,9 @@ msgid "" msgstr "" msgid "" -"Open an encoded file using the given *mode* and return an instance of :class:" -"`StreamReaderWriter`, providing transparent encoding/decoding. The default " -"file mode is ``'r'``, meaning to open the file in read mode." +"Open an encoded file using the given *mode* and return an instance " +"of :class:`StreamReaderWriter`, providing transparent encoding/decoding. The " +"default file mode is ``'r'``, meaning to open the file in read mode." msgstr "" msgid "" @@ -244,9 +252,9 @@ 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." +"*iterator*. *iterator* must yield :class:`str` objects. This function is " +"a :term:`generator`. The *errors* argument (as well as any other keyword " +"argument) is passed through to the incremental encoder." msgstr "" msgid "" @@ -257,16 +265,30 @@ 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." +"*iterator*. *iterator* must yield :class:`bytes` objects. 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`." +"``rot_13``, although ``rot_13`` may be used equivalently " +"with :func:`iterencode`." +msgstr "" + +msgid "" +"Return a :class:`tuple` containing the raw bytes of *buffer*, a :ref:`buffer-" +"compatible object ` or :class:`str` (encoded to UTF-8 before " +"processing), and their length in bytes." +msgstr "" + +msgid "The *errors* argument is ignored." +msgstr "" + +msgid "" +">>> codecs.readbuffer_encode(b\"Zito\")\n" +"(b'Zito', 4)" msgstr "" msgid "" @@ -278,11 +300,11 @@ msgid "" "These constants define various byte sequences, being Unicode byte order " "marks (BOMs) for several encodings. They are used in UTF-16 and UTF-32 data " "streams to indicate the byte order used, and in UTF-8 as a Unicode " -"signature. :const:`BOM_UTF16` is either :const:`BOM_UTF16_BE` or :const:" -"`BOM_UTF16_LE` depending on the platform's native byte order, :const:`BOM` " -"is an alias for :const:`BOM_UTF16`, :const:`BOM_LE` for :const:" -"`BOM_UTF16_LE` and :const:`BOM_BE` for :const:`BOM_UTF16_BE`. The others " -"represent the BOM in UTF-8 and UTF-32 encodings." +"signature. :const:`BOM_UTF16` is either :const:`BOM_UTF16_BE` " +"or :const:`BOM_UTF16_LE` depending on the platform's native byte " +"order, :const:`BOM` is an alias for :const:`BOM_UTF16`, :const:`BOM_LE` " +"for :const:`BOM_UTF16_LE` and :const:`BOM_BE` for :const:`BOM_UTF16_BE`. The " +"others represent the BOM in UTF-8 and UTF-32 encodings." msgstr "" msgid "Codec Base Classes" @@ -351,9 +373,10 @@ msgstr "``'backslashreplace'``" msgid "" "Replace with backslashed escape sequences. On encoding, use hexadecimal form " -"of Unicode code point with formats :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}` :" -"samp:`\\\\U{xxxxxxxx}`. On decoding, use hexadecimal form of byte value with " -"format :samp:`\\\\x{hh}`. Implemented in :func:`backslashreplace_errors`." +"of Unicode code point with formats :samp:`\\\\x{hh}` :samp:`\\\\u{xxxx}" +"` :samp:`\\\\U{xxxxxxxx}`. On decoding, use hexadecimal form of byte value " +"with format :samp:`\\\\x{hh}`. Implemented " +"in :func:`backslashreplace_errors`." msgstr "" msgid "``'surrogateescape'``" @@ -367,8 +390,8 @@ msgid "" msgstr "" msgid "" -"The following error handlers are only applicable to encoding (within :term:" -"`text encodings `):" +"The following error handlers are only applicable to encoding " +"(within :term:`text encodings `):" msgstr "" msgid "``'xmlcharrefreplace'``" @@ -376,8 +399,8 @@ msgstr "``'xmlcharrefreplace'``" msgid "" "Replace with XML/HTML numeric character reference, which is a decimal form " -"of Unicode code point with format :samp:`&#{num};`. Implemented in :func:" -"`xmlcharrefreplace_errors`." +"of Unicode code point with format :samp:`&#{num};`. Implemented " +"in :func:`xmlcharrefreplace_errors`." msgstr "" msgid "``'namereplace'``" @@ -385,8 +408,8 @@ msgstr "``'namereplace'``" msgid "" "Replace with ``\\N{...}`` escape sequences, what appears in the braces is " -"the Name property from Unicode Character Database. Implemented in :func:" -"`namereplace_errors`." +"the Name property from Unicode Character Database. Implemented " +"in :func:`namereplace_errors`." msgstr "" msgid "" @@ -400,7 +423,7 @@ msgid "``'surrogatepass'``" msgstr "``'surrogatepass'``" msgid "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le" -msgstr "" +msgstr "utf-8, utf-16, utf-32, utf-16-be, utf-16-le, utf-32-be, utf-32-le" msgid "" "Allow encoding and decoding surrogate code point (``U+D800`` - ``U+DFFF``) " @@ -436,17 +459,18 @@ msgid "" msgstr "" msgid "" -"For encoding, *error_handler* will be called with a :exc:" -"`UnicodeEncodeError` instance, which contains information about the location " -"of the error. The error handler must either raise this or a different " -"exception, or return a tuple with a replacement for the unencodable part of " -"the input and a position where encoding should continue. The replacement may " -"be either :class:`str` or :class:`bytes`. If the replacement is bytes, the " -"encoder will simply copy them into the output buffer. If the replacement is " -"a string, the encoder will encode the replacement. Encoding continues on " -"original input at the specified position. Negative position values will be " -"treated as being relative to the end of the input string. If the resulting " -"position is out of bound an :exc:`IndexError` will be raised." +"For encoding, *error_handler* will be called with " +"a :exc:`UnicodeEncodeError` instance, which contains information about the " +"location of the error. The error handler must either raise this or a " +"different exception, or return a tuple with a replacement for the " +"unencodable part of the input and a position where encoding should continue. " +"The replacement may be either :class:`str` or :class:`bytes`. If the " +"replacement is bytes, the encoder will simply copy them into the output " +"buffer. If the replacement is a string, the encoder will encode the " +"replacement. Encoding continues on original input at the specified position. " +"Negative position values will be treated as being relative to the end of the " +"input string. If the resulting position is out of bound an :exc:`IndexError` " +"will be raised." msgstr "" msgid "" @@ -507,8 +531,8 @@ msgid "Works with decoding and translating." msgstr "" msgid "" -"Implements the ``'xmlcharrefreplace'`` error handling (for encoding within :" -"term:`text encoding` only)." +"Implements the ``'xmlcharrefreplace'`` error handling (for encoding " +"within :term:`text encoding` only)." msgstr "" msgid "" @@ -518,8 +542,8 @@ msgid "" msgstr "" msgid "" -"Implements the ``'namereplace'`` error handling (for encoding within :term:" -"`text encoding` only)." +"Implements the ``'namereplace'`` error handling (for encoding " +"within :term:`text encoding` only)." msgstr "" msgid "" @@ -550,9 +574,9 @@ msgid "" msgstr "" msgid "" -"The method may not store state in the :class:`Codec` instance. Use :class:" -"`StreamWriter` for codecs which have to keep state in order to make encoding " -"efficient." +"The method may not store state in the :class:`Codec` instance. " +"Use :class:`StreamWriter` for codecs which have to keep state in order to " +"make encoding efficient." msgstr "" msgid "" @@ -574,9 +598,9 @@ msgid "" msgstr "" msgid "" -"The method may not store state in the :class:`Codec` instance. Use :class:" -"`StreamReader` for codecs which have to keep state in order to make decoding " -"efficient." +"The method may not store state in the :class:`Codec` instance. " +"Use :class:`StreamReader` for codecs which have to keep state in order to " +"make decoding efficient." msgstr "" msgid "" @@ -591,17 +615,17 @@ msgid "" "The :class:`IncrementalEncoder` and :class:`IncrementalDecoder` classes " "provide the basic interface for incremental encoding and decoding. Encoding/" "decoding the input isn't done with one call to the stateless encoder/decoder " -"function, but with multiple calls to the :meth:`~IncrementalEncoder.encode`/:" -"meth:`~IncrementalDecoder.decode` method of the incremental encoder/decoder. " -"The incremental encoder/decoder keeps track of the encoding/decoding process " -"during method calls." +"function, but with multiple calls to " +"the :meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder.decode` " +"method of the incremental encoder/decoder. The incremental encoder/decoder " +"keeps track of the encoding/decoding process during method calls." msgstr "" msgid "" -"The joined output of calls to the :meth:`~IncrementalEncoder.encode`/:meth:" -"`~IncrementalDecoder.decode` method is the same as if all the single inputs " -"were joined into one, and this input was encoded/decoded with the stateless " -"encoder/decoder." +"The joined output of calls to " +"the :meth:`~IncrementalEncoder.encode`/:meth:`~IncrementalDecoder.decode` " +"method is the same as if all the single inputs were joined into one, and " +"this input was encoded/decoded with the stateless encoder/decoder." msgstr "" msgid "IncrementalEncoder Objects" @@ -631,19 +655,19 @@ msgstr "" msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " -"error handling strategies during the lifetime of the :class:" -"`IncrementalEncoder` object." +"error handling strategies during the lifetime of " +"the :class:`IncrementalEncoder` object." msgstr "" msgid "" "Encodes *object* (taking the current state of the encoder into account) and " -"returns the resulting encoded object. If this is the last call to :meth:" -"`encode` *final* must be true (the default is false)." +"returns the resulting encoded object. If this is the last call " +"to :meth:`encode` *final* must be true (the default is false)." msgstr "" msgid "" -"Reset the encoder to the initial state. The output is discarded: call ``." -"encode(object, final=True)``, passing an empty byte or text string if " +"Reset the encoder to the initial state. The output is discarded: call " +"``.encode(object, final=True)``, passing an empty byte or text string if " "necessary, to reset the encoder and to get the output." msgstr "" @@ -687,18 +711,18 @@ msgstr "" msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " -"error handling strategies during the lifetime of the :class:" -"`IncrementalDecoder` object." +"error handling strategies during the lifetime of " +"the :class:`IncrementalDecoder` object." msgstr "" msgid "" "Decodes *object* (taking the current state of the decoder into account) and " -"returns the resulting decoded object. If this is the last call to :meth:" -"`decode` *final* must be true (the default is false). If *final* is true the " -"decoder must decode the input completely and must flush all buffers. If this " -"isn't possible (e.g. because of incomplete byte sequences at the end of the " -"input) it must initiate error handling just like in the stateless case " -"(which might raise an exception)." +"returns the resulting decoded object. If this is the last call " +"to :meth:`decode` *final* must be true (the default is false). If *final* is " +"true the decoder must decode the input completely and must flush all " +"buffers. If this isn't possible (e.g. because of incomplete byte sequences " +"at the end of the input) it must initiate error handling just like in the " +"stateless case (which might raise an exception)." msgstr "" msgid "Reset the decoder to the initial state." @@ -828,8 +852,8 @@ msgid "" msgstr "" msgid "" -"The set of allowed values for the *errors* argument can be extended with :" -"func:`register_error`." +"The set of allowed values for the *errors* argument can be extended " +"with :func:`register_error`." msgstr "" msgid "Decodes data from the stream and returns the resulting object." @@ -884,8 +908,8 @@ msgid "" msgstr "" msgid "" -"*sizehint*, if given, is passed as the *size* argument to the stream's :meth:" -"`read` method." +"*sizehint*, if given, is passed as the *size* argument to the " +"stream's :meth:`read` method." msgstr "" msgid "" @@ -907,8 +931,8 @@ msgid "" msgstr "" msgid "" -"The design is such that one can use the factory functions returned by the :" -"func:`lookup` function to construct the instance." +"The design is such that one can use the factory functions returned by " +"the :func:`lookup` function to construct the instance." msgstr "" msgid "" @@ -920,8 +944,8 @@ msgid "" msgstr "" msgid "" -":class:`StreamReaderWriter` instances define the combined interfaces of :" -"class:`StreamReader` and :class:`StreamWriter` classes. They inherit all " +":class:`StreamReaderWriter` instances define the combined interfaces " +"of :class:`StreamReader` and :class:`StreamWriter` classes. They inherit all " "other methods and attributes from the underlying stream." msgstr "" @@ -961,9 +985,9 @@ msgid "" msgstr "" msgid "" -":class:`StreamRecoder` instances define the combined interfaces of :class:" -"`StreamReader` and :class:`StreamWriter` classes. They inherit all other " -"methods and attributes from the underlying stream." +":class:`StreamRecoder` instances define the combined interfaces " +"of :class:`StreamReader` and :class:`StreamWriter` classes. They inherit all " +"other methods and attributes from the underlying stream." msgstr "" msgid "Encodings and Unicode" @@ -1005,27 +1029,34 @@ msgid "" "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." +"respectively. Their disadvantage is that if, for example, you use ``UTF-32-" +"BE`` on a little endian machine you will always have to swap bytes on " +"encoding and decoding. Python's ``UTF-16`` and ``UTF-32`` codecs avoid this " +"problem by using the platform's native byte order when no BOM is present. " +"Python follows prevailing platform practice, so native-endian data round-" +"trips without redundant byte swapping, even though the Unicode Standard " +"defaults to big-endian when the byte order is unspecified. When these bytes " +"are read by a CPU with a different endianness, the bytes have to be swapped. " +"To be able to detect the endianness of a ``UTF-16`` or ``UTF-32`` byte " +"sequence, a BOM (\"Byte Order Mark\") is used. 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. " +"When the first character of a ``UTF-16`` or ``UTF-32`` byte sequence is " +"``U+FFFE``, the bytes have to be swapped on decoding." +msgstr "" + +msgid "" +"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 "" @@ -1048,25 +1079,25 @@ msgid "``U-00000000`` ... ``U-0000007F``" msgstr "``U-00000000`` ... ``U-0000007F``" msgid "0xxxxxxx" -msgstr "" +msgstr "0xxxxxxx" msgid "``U-00000080`` ... ``U-000007FF``" msgstr "``U-00000080`` ... ``U-000007FF``" msgid "110xxxxx 10xxxxxx" -msgstr "" +msgstr "110xxxxx 10xxxxxx" msgid "``U-00000800`` ... ``U-0000FFFF``" msgstr "``U-00000800`` ... ``U-0000FFFF``" msgid "1110xxxx 10xxxxxx 10xxxxxx" -msgstr "" +msgstr "1110xxxx 10xxxxxx 10xxxxxx" msgid "``U-00010000`` ... ``U-0010FFFF``" msgstr "``U-00010000`` ... ``U-0010FFFF``" msgid "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx" -msgstr "" +msgstr "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx" msgid "" "The least significant bit of the Unicode character is the rightmost x bit." @@ -1092,13 +1123,13 @@ msgid "" msgstr "" msgid "LATIN SMALL LETTER I WITH DIAERESIS" -msgstr "" +msgstr "LATIN SMALL LETTER I WITH DIAERESIS" msgid "RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK" -msgstr "" +msgstr "RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK" msgid "INVERTED QUESTION MARK" -msgstr "" +msgstr "INVERTED QUESTION MARK" msgid "" "in iso-8859-1), this increases the probability that a ``utf-8-sig`` encoding " @@ -1121,8 +1152,14 @@ msgid "" "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." +"underscore are also valid aliases because they are equivalent when " +"normalized by :func:`~encodings.normalize_encoding`. For example, " +"``'utf-8'`` is a valid alias for the ``'utf_8'`` codec." +msgstr "" + +msgid "" +"The below table lists the most common aliases, for a complete list refer to " +"the source :source:`aliases.py ` file." msgstr "" msgid "" @@ -1168,657 +1205,662 @@ msgid "Languages" msgstr "" msgid "ascii" -msgstr "" +msgstr "ascii" msgid "646, us-ascii" -msgstr "" +msgstr "646, us-ascii" msgid "English" msgstr "" msgid "big5" -msgstr "" +msgstr "big5" msgid "big5-tw, csbig5" -msgstr "" +msgstr "big5-tw, csbig5" msgid "Traditional Chinese" msgstr "" msgid "big5hkscs" -msgstr "" +msgstr "big5hkscs" msgid "big5-hkscs, hkscs" -msgstr "" +msgstr "big5-hkscs, hkscs" msgid "cp037" -msgstr "" +msgstr "cp037" msgid "IBM037, IBM039" -msgstr "" +msgstr "IBM037, IBM039" msgid "cp273" -msgstr "" +msgstr "cp273" msgid "273, IBM273, csIBM273" -msgstr "" +msgstr "273, IBM273, csIBM273" msgid "German" msgstr "" msgid "cp424" -msgstr "" +msgstr "cp424" msgid "EBCDIC-CP-HE, IBM424" -msgstr "" +msgstr "EBCDIC-CP-HE, IBM424" msgid "Hebrew" msgstr "" msgid "cp437" -msgstr "" +msgstr "cp437" msgid "437, IBM437" -msgstr "" +msgstr "437, IBM437" msgid "cp500" -msgstr "" +msgstr "cp500" msgid "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500" -msgstr "" +msgstr "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500" msgid "Western Europe" msgstr "" msgid "cp720" -msgstr "" +msgstr "cp720" msgid "Arabic" msgstr "" msgid "cp737" -msgstr "" +msgstr "cp737" msgid "Greek" msgstr "" msgid "cp775" -msgstr "" +msgstr "cp775" msgid "IBM775" -msgstr "" +msgstr "IBM775" msgid "Baltic languages" msgstr "" msgid "cp850" -msgstr "" +msgstr "cp850" msgid "850, IBM850" -msgstr "" +msgstr "850, IBM850" msgid "cp852" -msgstr "" +msgstr "cp852" msgid "852, IBM852" -msgstr "" +msgstr "852, IBM852" msgid "Central and Eastern Europe" msgstr "" msgid "cp855" -msgstr "" +msgstr "cp855" msgid "855, IBM855" -msgstr "" +msgstr "855, IBM855" msgid "Belarusian, Bulgarian, Macedonian, Russian, Serbian" msgstr "" msgid "cp856" -msgstr "" +msgstr "cp856" msgid "cp857" -msgstr "" +msgstr "cp857" msgid "857, IBM857" -msgstr "" +msgstr "857, IBM857" msgid "Turkish" msgstr "" msgid "cp858" -msgstr "" +msgstr "cp858" -msgid "858, IBM858" +msgid "858, IBM00858" msgstr "" msgid "cp860" -msgstr "" +msgstr "cp860" msgid "860, IBM860" -msgstr "" +msgstr "860, IBM860" msgid "Portuguese" msgstr "" msgid "cp861" -msgstr "" +msgstr "cp861" msgid "861, CP-IS, IBM861" -msgstr "" +msgstr "861, CP-IS, IBM861" msgid "Icelandic" msgstr "" msgid "cp862" -msgstr "" +msgstr "cp862" msgid "862, IBM862" -msgstr "" +msgstr "862, IBM862" msgid "cp863" -msgstr "" +msgstr "cp863" msgid "863, IBM863" -msgstr "" +msgstr "863, IBM863" msgid "Canadian" msgstr "" msgid "cp864" -msgstr "" +msgstr "cp864" msgid "IBM864" -msgstr "" +msgstr "IBM864" msgid "cp865" -msgstr "" +msgstr "cp865" msgid "865, IBM865" -msgstr "" +msgstr "865, IBM865" msgid "Danish, Norwegian" msgstr "" msgid "cp866" -msgstr "" +msgstr "cp866" msgid "866, IBM866" -msgstr "" +msgstr "866, IBM866" msgid "Russian" msgstr "" msgid "cp869" -msgstr "" +msgstr "cp869" msgid "869, CP-GR, IBM869" -msgstr "" +msgstr "869, CP-GR, IBM869" msgid "cp874" -msgstr "" +msgstr "cp874" msgid "Thai" msgstr "" msgid "cp875" -msgstr "" +msgstr "cp875" msgid "cp932" -msgstr "" +msgstr "cp932" msgid "932, ms932, mskanji, ms-kanji, windows-31j" -msgstr "" +msgstr "932, ms932, mskanji, ms-kanji, windows-31j" msgid "Japanese" msgstr "" msgid "cp949" -msgstr "" +msgstr "cp949" msgid "949, ms949, uhc" -msgstr "" +msgstr "949, ms949, uhc" msgid "Korean" msgstr "" msgid "cp950" -msgstr "" +msgstr "cp950" msgid "950, ms950" -msgstr "" +msgstr "950, ms950" msgid "cp1006" -msgstr "" +msgstr "cp1006" msgid "Urdu" msgstr "" msgid "cp1026" -msgstr "" +msgstr "cp1026" msgid "ibm1026" -msgstr "" +msgstr "ibm1026" msgid "cp1125" -msgstr "" +msgstr "cp1125" msgid "1125, ibm1125, cp866u, ruscii" -msgstr "" +msgstr "1125, ibm1125, cp866u, ruscii" msgid "Ukrainian" msgstr "" msgid "cp1140" -msgstr "" +msgstr "cp1140" -msgid "ibm1140" +msgid "IBM01140" msgstr "" msgid "cp1250" -msgstr "" +msgstr "cp1250" msgid "windows-1250" -msgstr "" +msgstr "windows-1250" msgid "cp1251" -msgstr "" +msgstr "cp1251" msgid "windows-1251" -msgstr "" +msgstr "windows-1251" msgid "cp1252" -msgstr "" +msgstr "cp1252" msgid "windows-1252" -msgstr "" +msgstr "windows-1252" msgid "cp1253" -msgstr "" +msgstr "cp1253" msgid "windows-1253" -msgstr "" +msgstr "windows-1253" msgid "cp1254" -msgstr "" +msgstr "cp1254" msgid "windows-1254" -msgstr "" +msgstr "windows-1254" msgid "cp1255" -msgstr "" +msgstr "cp1255" msgid "windows-1255" -msgstr "" +msgstr "windows-1255" msgid "cp1256" -msgstr "" +msgstr "cp1256" msgid "windows-1256" -msgstr "" +msgstr "windows-1256" msgid "cp1257" -msgstr "" +msgstr "cp1257" msgid "windows-1257" -msgstr "" +msgstr "windows-1257" msgid "cp1258" -msgstr "" +msgstr "cp1258" msgid "windows-1258" -msgstr "" +msgstr "windows-1258" msgid "Vietnamese" msgstr "" msgid "euc_jp" -msgstr "" +msgstr "euc_jp" msgid "eucjp, ujis, u-jis" -msgstr "" +msgstr "eucjp, ujis, u-jis" msgid "euc_jis_2004" -msgstr "" +msgstr "euc_jis_2004" msgid "jisx0213, eucjis2004" -msgstr "" +msgstr "jisx0213, eucjis2004" msgid "euc_jisx0213" -msgstr "" +msgstr "euc_jisx0213" msgid "eucjisx0213" -msgstr "" +msgstr "eucjisx0213" msgid "euc_kr" -msgstr "" +msgstr "euc_kr" msgid "euckr, korean, ksc5601, ks_c-5601, ks_c-5601-1987, ksx1001, ks_x-1001" -msgstr "" +msgstr "euckr, korean, ksc5601, ks_c-5601, ks_c-5601-1987, ksx1001, ks_x-1001" msgid "gb2312" -msgstr "" +msgstr "gb2312" msgid "" "chinese, csiso58gb231280, euc-cn, euccn, eucgb2312-cn, gb2312-1980, " "gb2312-80, iso-ir-58" msgstr "" +"chinese, csiso58gb231280, euc-cn, euccn, eucgb2312-cn, gb2312-1980, " +"gb2312-80, iso-ir-58" msgid "Simplified Chinese" msgstr "" msgid "gbk" -msgstr "" +msgstr "gbk" msgid "936, cp936, ms936" -msgstr "" +msgstr "936, cp936, ms936" msgid "Unified Chinese" msgstr "" msgid "gb18030" -msgstr "" +msgstr "gb18030" msgid "gb18030-2000" -msgstr "" +msgstr "gb18030-2000" msgid "hz" -msgstr "" +msgstr "hz" msgid "hzgb, hz-gb, hz-gb-2312" -msgstr "" +msgstr "hzgb, hz-gb, hz-gb-2312" msgid "iso2022_jp" -msgstr "" +msgstr "iso2022_jp" msgid "csiso2022jp, iso2022jp, iso-2022-jp" -msgstr "" +msgstr "csiso2022jp, iso2022jp, iso-2022-jp" msgid "iso2022_jp_1" -msgstr "" +msgstr "iso2022_jp_1" msgid "iso2022jp-1, iso-2022-jp-1" -msgstr "" +msgstr "iso2022jp-1, iso-2022-jp-1" msgid "iso2022_jp_2" -msgstr "" +msgstr "iso2022_jp_2" msgid "iso2022jp-2, iso-2022-jp-2" -msgstr "" +msgstr "iso2022jp-2, iso-2022-jp-2" msgid "Japanese, Korean, Simplified Chinese, Western Europe, Greek" msgstr "" msgid "iso2022_jp_2004" -msgstr "" +msgstr "iso2022_jp_2004" msgid "iso2022jp-2004, iso-2022-jp-2004" -msgstr "" +msgstr "iso2022jp-2004, iso-2022-jp-2004" msgid "iso2022_jp_3" -msgstr "" +msgstr "iso2022_jp_3" msgid "iso2022jp-3, iso-2022-jp-3" -msgstr "" +msgstr "iso2022jp-3, iso-2022-jp-3" msgid "iso2022_jp_ext" -msgstr "" +msgstr "iso2022_jp_ext" msgid "iso2022jp-ext, iso-2022-jp-ext" -msgstr "" +msgstr "iso2022jp-ext, iso-2022-jp-ext" msgid "iso2022_kr" -msgstr "" +msgstr "iso2022_kr" msgid "csiso2022kr, iso2022kr, iso-2022-kr" -msgstr "" +msgstr "csiso2022kr, iso2022kr, iso-2022-kr" msgid "latin_1" -msgstr "" +msgstr "latin_1" msgid "iso-8859-1, iso8859-1, 8859, cp819, latin, latin1, L1" -msgstr "" +msgstr "iso-8859-1, iso8859-1, 8859, cp819, latin, latin1, L1" msgid "iso8859_2" -msgstr "" +msgstr "iso8859_2" msgid "iso-8859-2, latin2, L2" -msgstr "" +msgstr "iso-8859-2, latin2, L2" msgid "iso8859_3" -msgstr "" +msgstr "iso8859_3" msgid "iso-8859-3, latin3, L3" -msgstr "" +msgstr "iso-8859-3, latin3, L3" msgid "Esperanto, Maltese" msgstr "" msgid "iso8859_4" -msgstr "" +msgstr "iso8859_4" msgid "iso-8859-4, latin4, L4" +msgstr "iso-8859-4, latin4, L4" + +msgid "Northern Europe" msgstr "" msgid "iso8859_5" -msgstr "" +msgstr "iso8859_5" msgid "iso-8859-5, cyrillic" -msgstr "" +msgstr "iso-8859-5, cyrillic" msgid "iso8859_6" -msgstr "" +msgstr "iso8859_6" msgid "iso-8859-6, arabic" -msgstr "" +msgstr "iso-8859-6, arabic" msgid "iso8859_7" -msgstr "" +msgstr "iso8859_7" msgid "iso-8859-7, greek, greek8" -msgstr "" +msgstr "iso-8859-7, greek, greek8" msgid "iso8859_8" -msgstr "" +msgstr "iso8859_8" msgid "iso-8859-8, hebrew" -msgstr "" +msgstr "iso-8859-8, hebrew" msgid "iso8859_9" -msgstr "" +msgstr "iso8859_9" msgid "iso-8859-9, latin5, L5" -msgstr "" +msgstr "iso-8859-9, latin5, L5" msgid "iso8859_10" -msgstr "" +msgstr "iso8859_10" msgid "iso-8859-10, latin6, L6" -msgstr "" +msgstr "iso-8859-10, latin6, L6" msgid "Nordic languages" msgstr "" msgid "iso8859_11" -msgstr "" +msgstr "iso8859_11" msgid "iso-8859-11, thai" -msgstr "" +msgstr "iso-8859-11, thai" msgid "Thai languages" msgstr "" msgid "iso8859_13" -msgstr "" +msgstr "iso8859_13" msgid "iso-8859-13, latin7, L7" -msgstr "" +msgstr "iso-8859-13, latin7, L7" msgid "iso8859_14" -msgstr "" +msgstr "iso8859_14" msgid "iso-8859-14, latin8, L8" -msgstr "" +msgstr "iso-8859-14, latin8, L8" msgid "Celtic languages" msgstr "" msgid "iso8859_15" -msgstr "" +msgstr "iso8859_15" msgid "iso-8859-15, latin9, L9" -msgstr "" +msgstr "iso-8859-15, latin9, L9" msgid "iso8859_16" -msgstr "" +msgstr "iso8859_16" msgid "iso-8859-16, latin10, L10" -msgstr "" +msgstr "iso-8859-16, latin10, L10" msgid "South-Eastern Europe" msgstr "" msgid "johab" -msgstr "" +msgstr "johab" msgid "cp1361, ms1361" -msgstr "" +msgstr "cp1361, ms1361" msgid "koi8_r" -msgstr "" +msgstr "koi8_r" msgid "koi8_t" -msgstr "" +msgstr "koi8_t" msgid "Tajik" msgstr "" msgid "koi8_u" -msgstr "" +msgstr "koi8_u" msgid "kz1048" -msgstr "" +msgstr "kz1048" msgid "kz_1048, strk1048_2002, rk1048" -msgstr "" +msgstr "kz_1048, strk1048_2002, rk1048" msgid "Kazakh" msgstr "" msgid "mac_cyrillic" -msgstr "" +msgstr "mac_cyrillic" msgid "maccyrillic" -msgstr "" +msgstr "maccyrillic" msgid "mac_greek" -msgstr "" +msgstr "mac_greek" msgid "macgreek" msgstr "" msgid "mac_iceland" -msgstr "" +msgstr "mac_iceland" msgid "maciceland" -msgstr "" +msgstr "maciceland" msgid "mac_latin2" -msgstr "" +msgstr "mac_latin2" msgid "maclatin2, maccentraleurope, mac_centeuro" -msgstr "" +msgstr "maclatin2, maccentraleurope, mac_centeuro" msgid "mac_roman" -msgstr "" +msgstr "mac_roman" msgid "macroman, macintosh" -msgstr "" +msgstr "macroman, macintosh" msgid "mac_turkish" -msgstr "" +msgstr "mac_turkish" msgid "macturkish" -msgstr "" +msgstr "macturkish" msgid "ptcp154" -msgstr "" +msgstr "ptcp154" msgid "csptcp154, pt154, cp154, cyrillic-asian" -msgstr "" +msgstr "csptcp154, pt154, cp154, cyrillic-asian" msgid "shift_jis" -msgstr "" +msgstr "shift_jis" msgid "csshiftjis, shiftjis, sjis, s_jis" -msgstr "" +msgstr "csshiftjis, shiftjis, sjis, s_jis" msgid "shift_jis_2004" -msgstr "" +msgstr "shift_jis_2004" msgid "shiftjis2004, sjis_2004, sjis2004" -msgstr "" +msgstr "shiftjis2004, sjis_2004, sjis2004" msgid "shift_jisx0213" -msgstr "" +msgstr "shift_jisx0213" msgid "shiftjisx0213, sjisx0213, s_jisx0213" -msgstr "" +msgstr "shiftjisx0213, sjisx0213, s_jisx0213" msgid "utf_32" -msgstr "" +msgstr "utf_32" msgid "U32, utf32" -msgstr "" +msgstr "U32, utf32" msgid "all languages" msgstr "" msgid "utf_32_be" -msgstr "" +msgstr "utf_32_be" msgid "UTF-32BE" -msgstr "" +msgstr "UTF-32BE" msgid "utf_32_le" -msgstr "" +msgstr "utf_32_le" msgid "UTF-32LE" -msgstr "" +msgstr "UTF-32LE" msgid "utf_16" -msgstr "" +msgstr "utf_16" msgid "U16, utf16" -msgstr "" +msgstr "U16, utf16" msgid "utf_16_be" -msgstr "" +msgstr "utf_16_be" msgid "UTF-16BE" -msgstr "" +msgstr "UTF-16BE" msgid "utf_16_le" -msgstr "" +msgstr "utf_16_le" msgid "UTF-16LE" -msgstr "" +msgstr "UTF-16LE" msgid "utf_7" -msgstr "" +msgstr "utf_7" msgid "U7, unicode-1-1-utf-7" -msgstr "" +msgstr "U7, unicode-1-1-utf-7" msgid "utf_8" -msgstr "" +msgstr "utf_8" msgid "U8, UTF, utf8, cp65001" -msgstr "" +msgstr "U8, UTF, utf8, cp65001" msgid "utf_8_sig" -msgstr "" +msgstr "utf_8_sig" msgid "" "The utf-16\\* and utf-32\\* encoders no longer allow surrogate code points " @@ -1845,51 +1887,61 @@ msgid "Text Encodings" msgstr "" msgid "" -"The following codecs provide :class:`str` to :class:`bytes` encoding and :" -"term:`bytes-like object` to :class:`str` decoding, similar to the Unicode " -"text encodings." +"The following codecs provide :class:`str` to :class:`bytes` encoding " +"and :term:`bytes-like object` to :class:`str` decoding, similar to the " +"Unicode text encodings." msgstr "" msgid "idna" -msgstr "" +msgstr "idna" msgid "" "Implement :rfc:`3490`, see also :mod:`encodings.idna`. Only " "``errors='strict'`` is supported." msgstr "" -msgid "mbcs" +msgid "" +"This codec builds on ``punycode``, whose algorithms scale poorly, so limit " +"the length of untrusted input." msgstr "" +msgid "mbcs" +msgstr "mbcs" + msgid "ansi, dbcs" -msgstr "" +msgstr "ansi, dbcs" msgid "" "Windows only: Encode the operand according to the ANSI codepage (CP_ACP)." msgstr "" msgid "oem" -msgstr "" +msgstr "oem" msgid "" "Windows only: Encode the operand according to the OEM codepage (CP_OEMCP)." msgstr "" msgid "palmos" -msgstr "" +msgstr "palmos" msgid "Encoding of PalmOS 3.5." msgstr "" msgid "punycode" -msgstr "" +msgstr "punycode" msgid "Implement :rfc:`3492`. Stateful codecs are not supported." msgstr "" -msgid "raw_unicode_escape" +msgid "" +"The decoding and encoding algorithms scale poorly, so limit the length of " +"untrusted input." msgstr "" +msgid "raw_unicode_escape" +msgstr "raw_unicode_escape" + 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 " @@ -1899,13 +1951,16 @@ msgstr "" msgid "undefined" msgstr "" +msgid "This Codec should only be used for testing purposes." +msgstr "" + msgid "" "Raise an exception for all conversions, even empty strings. The error " "handler is ignored." msgstr "" msgid "unicode_escape" -msgstr "" +msgstr "unicode_escape" msgid "" "Encoding suitable as the contents of a Unicode literal in ASCII-encoded " @@ -1929,10 +1984,10 @@ msgid "Encoder / decoder" msgstr "" msgid "base64_codec [#b64]_" -msgstr "" +msgstr "base64_codec [#b64]_" msgid "base64, base_64" -msgstr "" +msgstr "base64, base_64" msgid "" "Convert the operand to multiline MIME base64 (the result always includes a " @@ -1944,38 +1999,38 @@ msgid "" msgstr "" msgid ":meth:`base64.encodebytes` / :meth:`base64.decodebytes`" -msgstr "" +msgstr ":meth:`base64.encodebytes` / :meth:`base64.decodebytes`" msgid "bz2_codec" -msgstr "" +msgstr "bz2_codec" msgid "bz2" -msgstr "" +msgstr "bz2" msgid "Compress the operand using bz2." msgstr "" msgid ":meth:`bz2.compress` / :meth:`bz2.decompress`" -msgstr "" +msgstr ":meth:`bz2.compress` / :meth:`bz2.decompress`" msgid "hex_codec" -msgstr "" +msgstr "hex_codec" msgid "hex" -msgstr "" +msgstr "hex" msgid "" "Convert the operand to hexadecimal representation, with two digits per byte." msgstr "" msgid ":meth:`binascii.b2a_hex` / :meth:`binascii.a2b_hex`" -msgstr "" +msgstr ":meth:`binascii.b2a_hex` / :meth:`binascii.a2b_hex`" msgid "quopri_codec" -msgstr "" +msgstr "quopri_codec" msgid "quopri, quotedprintable, quoted_printable" -msgstr "" +msgstr "quopri, quotedprintable, quoted_printable" msgid "Convert the operand to MIME quoted printable." msgstr "" @@ -1984,25 +2039,25 @@ msgid ":meth:`quopri.encode` with ``quotetabs=True`` / :meth:`quopri.decode`" msgstr "" msgid "uu_codec" -msgstr "" +msgstr "uu_codec" msgid "uu" -msgstr "" +msgstr "uu" msgid "Convert the operand using uuencode." msgstr "" msgid "zlib_codec" -msgstr "" +msgstr "zlib_codec" msgid "zip, zlib" -msgstr "" +msgstr "zip, zlib" msgid "Compress the operand using gzip." msgstr "" msgid ":meth:`zlib.compress` / :meth:`zlib.decompress`" -msgstr "" +msgstr ":meth:`zlib.compress` / :meth:`zlib.decompress`" msgid "" "In addition to :term:`bytes-like objects `, " @@ -2016,20 +2071,50 @@ msgstr "" msgid "Restoration of the aliases for the binary transforms." msgstr "" +msgid "Standalone Codec Functions" +msgstr "" + +msgid "" +"The following functions provide encoding and decoding functionality similar " +"to codecs, but are not available as named codecs " +"through :func:`codecs.encode` or :func:`codecs.decode`. They are used " +"internally (for example, by :mod:`pickle`) and behave similarly to the " +"``string_escape`` codec that was removed in Python 3." +msgstr "" + +msgid "" +"Encode *input* using escape sequences. Similar to how :func:`repr` on bytes " +"produces escaped byte values." +msgstr "" + +msgid "*input* must be a :class:`bytes` object." +msgstr "" + +msgid "" +"Returns a tuple ``(output, length)`` where *output* is a :class:`bytes` " +"object and *length* is the number of bytes consumed." +msgstr "" + +msgid "Decode *input* from escape sequences back to the original bytes." +msgstr "" + +msgid "*input* must be a :term:`bytes-like object`." +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)." +"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 "" +msgstr "rot_13" msgid "rot13" -msgstr "" +msgstr "rot13" msgid "Return the Caesar-cypher encryption of the operand." msgstr "" @@ -2040,6 +2125,55 @@ msgstr "" msgid "Restoration of the ``rot13`` alias." msgstr "" +msgid ":mod:`encodings` --- Encodings package" +msgstr "" + +msgid "This module implements the following functions:" +msgstr "" + +msgid "Normalize encoding name *encoding*." +msgstr "" + +msgid "" +"Normalization works as follows: all non-alphanumeric characters except the " +"dot used for Python package names are collapsed and replaced with a single " +"underscore, leading and trailing underscores are removed. For example, ``' " +"-;#'`` becomes ``'_'``." +msgstr "" + +msgid "Note that *encoding* should be ASCII only." +msgstr "" + +msgid "" +"The following function should not be used directly, except for testing " +"purposes; :func:`codecs.lookup` should be used instead." +msgstr "" + +msgid "" +"Search for the codec module corresponding to the given encoding name " +"*encoding*." +msgstr "" + +msgid "" +"This function first normalizes the *encoding* " +"using :func:`normalize_encoding`, then looks for a corresponding alias. It " +"attempts to import a codec module from the encodings package using either " +"the alias or the normalized name. If the module is found and defines a valid " +"``getregentry()`` function that returns a :class:`codecs.CodecInfo` object, " +"the codec is cached and returned." +msgstr "" + +msgid "" +"If the codec module defines a ``getaliases()`` function any returned aliases " +"are registered for future use." +msgstr "" + +msgid "This module implements the following exception:" +msgstr "" + +msgid "Raised when a codec is invalid or incompatible." +msgstr "" + msgid "" ":mod:`encodings.idna` --- Internationalized Domain Names in Applications" msgstr "" @@ -2051,6 +2185,11 @@ msgid "" "encoding and :mod:`stringprep`." msgstr "" +msgid "" +"This module builds on ``punycode``, whose algorithms scale poorly, so limit " +"the length of untrusted input." +msgstr "" + msgid "" "If you need the IDNA 2008 standard from :rfc:`5891` and :rfc:`5895`, use the " "third-party :pypi:`idna` module." @@ -2058,15 +2197,15 @@ msgstr "" msgid "" "These RFCs together define a protocol to support non-ASCII characters in " -"domain names. A domain name containing non-ASCII characters (such as ``www." -"Alliancefrançaise.nu``) is converted into an ASCII-compatible encoding (ACE, " -"such as ``www.xn--alliancefranaise-npb.nu``). The ACE form of the domain " -"name is then used in all places where arbitrary characters are not allowed " -"by the protocol, such as DNS queries, HTTP :mailheader:`Host` fields, and so " -"on. This conversion is carried out in the application; if possible invisible " -"to the user: The application should transparently convert Unicode domain " -"labels to IDNA on the wire, and convert back ACE labels to Unicode before " -"presenting them to the user." +"domain names. A domain name containing non-ASCII characters (such as " +"``www.Alliancefrançaise.nu``) is converted into an ASCII-compatible encoding " +"(ACE, such as ``www.xn--alliancefranaise-npb.nu``). The ACE form of the " +"domain name is then used in all places where arbitrary characters are not " +"allowed by the protocol, such as DNS queries, HTTP :mailheader:`Host` " +"fields, and so on. This conversion is carried out in the application; if " +"possible invisible to the user: The application should transparently convert " +"Unicode domain labels to IDNA on the wire, and convert back ACE labels to " +"Unicode before presenting them to the user." msgstr "" msgid "" @@ -2079,8 +2218,8 @@ msgid "" "the :mod:`socket` module transparently converts Unicode host names to ACE, " "so that applications need not be concerned about converting host names " "themselves when they pass them to the socket module. On top of that, modules " -"that have host names as function parameters, such as :mod:`http.client` and :" -"mod:`ftplib`, accept Unicode host names (:mod:`http.client` then also " +"that have host names as function parameters, such as :mod:`http.client` " +"and :mod:`ftplib`, accept Unicode host names (:mod:`http.client` then also " "transparently sends an IDNA hostname in the :mailheader:`Host` field if it " "sends that field at all)." msgstr "" @@ -2185,13 +2324,13 @@ msgid "escape sequence" msgstr "" msgid "\\x" -msgstr "" +msgstr "\\x" msgid "\\u" -msgstr "" +msgstr "\\u" msgid "\\U" -msgstr "" +msgstr "\\U" msgid "xmlcharrefreplace" msgstr "" diff --git a/library/codeop.po b/library/codeop.po index e5ccd142f1..0ed4f3c8a5 100644 --- a/library/codeop.po +++ b/library/codeop.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,16 +67,16 @@ msgid "" msgstr "" msgid "" -"If there is a problem with *source*, an exception will be raised. :exc:" -"`SyntaxError` is raised if there is invalid Python syntax, and :exc:" -"`OverflowError` or :exc:`ValueError` if there is an invalid literal." +"If there is a problem with *source*, an exception will be " +"raised. :exc:`SyntaxError` is raised if there is invalid Python syntax, " +"and :exc:`OverflowError` or :exc:`ValueError` if there is an invalid literal." msgstr "" msgid "" "The *symbol* argument determines whether *source* is compiled as a statement " "(``'single'``, the default), as a sequence of :term:`statement` (``'exec'``) " -"or as an :term:`expression` (``'eval'``). Any other value will cause :exc:" -"`ValueError` to be raised." +"or as an :term:`expression` (``'eval'``). Any other value will " +"cause :exc:`ValueError` to be raised." msgstr "" msgid "" diff --git a/library/collections.abc.po b/library/collections.abc.po index 1abcb465b2..23a7f967bc 100644 --- a/library/collections.abc.po +++ b/library/collections.abc.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,8 +35,8 @@ msgstr "**Kod źródłowy:** :source:`Lib/_collections_abc.py`" msgid "" "This module provides :term:`abstract base classes ` " "that can be used to test whether a class provides a particular interface; " -"for example, whether it is :term:`hashable` or whether it is a :term:" -"`mapping`." +"for example, whether it is :term:`hashable` or whether it is " +"a :term:`mapping`." msgstr "" msgid "" @@ -107,9 +106,9 @@ msgstr "" msgid "" "In this example, class :class:`!D` does not need to define ``__contains__``, " "``__iter__``, and ``__reversed__`` because the :ref:`in-operator " -"`, the :term:`iteration ` logic, and the :func:" -"`reversed` function automatically fall back to using ``__getitem__`` and " -"``__len__``." +"`, the :term:`iteration ` logic, and " +"the :func:`reversed` function automatically fall back to using " +"``__getitem__`` and ``__len__``." msgstr "" msgid "" @@ -169,13 +168,13 @@ msgid "Mixin Methods" msgstr "" msgid ":class:`Container` [1]_" -msgstr "" +msgstr ":class:`Container` [1]_" msgid "``__contains__``" msgstr "``__contains__``" msgid ":class:`Hashable` [1]_" -msgstr "" +msgstr ":class:`Hashable` [1]_" msgid "``__hash__``" msgstr "``__hash__``" @@ -187,7 +186,7 @@ msgid "``__iter__``" msgstr "``__iter__``" msgid ":class:`Iterator` [1]_" -msgstr "" +msgstr ":class:`Iterator` [1]_" msgid ":class:`Iterable`" msgstr ":class:`Iterable`" @@ -196,13 +195,13 @@ msgid "``__next__``" msgstr "``__next__``" msgid ":class:`Reversible` [1]_" -msgstr "" +msgstr ":class:`Reversible` [1]_" msgid "``__reversed__``" msgstr "``__reversed__``" msgid ":class:`Generator` [1]_" -msgstr "" +msgstr ":class:`Generator` [1]_" msgid ":class:`Iterator`" msgstr ":class:`Iterator`" @@ -214,22 +213,22 @@ msgid "``close``, ``__iter__``, ``__next__``" msgstr "``close``, ``__iter__``, ``__next__``" msgid ":class:`Sized` [1]_" -msgstr "" +msgstr ":class:`Sized` [1]_" msgid "``__len__``" msgstr "``__len__``" msgid ":class:`Callable` [1]_" -msgstr "" +msgstr ":class:`Callable` [1]_" msgid "``__call__``" msgstr "``__call__``" msgid ":class:`Collection` [1]_" -msgstr "" +msgstr ":class:`Collection` [1]_" msgid ":class:`Sized`, :class:`Iterable`, :class:`Container`" -msgstr "" +msgstr ":class:`Sized`, :class:`Iterable`, :class:`Container`" msgid "``__contains__``, ``__iter__``, ``__len__``" msgstr "``__contains__``, ``__iter__``, ``__len__``" @@ -339,13 +338,13 @@ msgid ":class:`MappingView`, :class:`Collection`" msgstr ":class:`MappingView`, :class:`Collection`" msgid ":class:`Awaitable` [1]_" -msgstr "" +msgstr ":class:`Awaitable` [1]_" msgid "``__await__``" msgstr "``__await__``" msgid ":class:`Coroutine` [1]_" -msgstr "" +msgstr ":class:`Coroutine` [1]_" msgid ":class:`Awaitable`" msgstr ":class:`Awaitable`" @@ -354,13 +353,13 @@ msgid "``close``" msgstr "``close``" msgid ":class:`AsyncIterable` [1]_" -msgstr "" +msgstr ":class:`AsyncIterable` [1]_" msgid "``__aiter__``" msgstr "``__aiter__``" msgid ":class:`AsyncIterator` [1]_" -msgstr "" +msgstr ":class:`AsyncIterator` [1]_" msgid ":class:`AsyncIterable`" msgstr ":class:`AsyncIterable`" @@ -369,7 +368,7 @@ msgid "``__anext__``" msgstr "``__anext__``" msgid ":class:`AsyncGenerator` [1]_" -msgstr "" +msgstr ":class:`AsyncGenerator` [1]_" msgid ":class:`AsyncIterator`" msgstr ":class:`AsyncIterator`" @@ -381,7 +380,7 @@ msgid "``aclose``, ``__aiter__``, ``__anext__``" msgstr "``aclose``, ``__aiter__``, ``__anext__``" msgid ":class:`Buffer` [1]_" -msgstr "" +msgstr ":class:`Buffer` [1]_" msgid "``__buffer__``" msgstr "``__buffer__``" @@ -400,8 +399,8 @@ msgid "" "Checking ``isinstance(obj, Iterable)`` detects classes that are registered " "as :class:`Iterable` or that have an :meth:`~container.__iter__` method, but " "it does not detect classes that iterate with the :meth:`~object.__getitem__` " -"method. The only reliable way to determine whether an object is :term:" -"`iterable` is to call ``iter(obj)``." +"method. The only reliable way to determine whether an object " +"is :term:`iterable` is to call ``iter(obj)``." msgstr "" msgid "Collections Abstract Base Classes -- Detailed Descriptions" @@ -431,16 +430,17 @@ msgid "" "Checking ``isinstance(obj, Iterable)`` detects classes that are registered " "as :class:`Iterable` or that have an :meth:`~container.__iter__` method, but " "it does not detect classes that iterate with the :meth:`~object.__getitem__` " -"method. The only reliable way to determine whether an object is :term:" -"`iterable` is to call ``iter(obj)``." +"method. The only reliable way to determine whether an object " +"is :term:`iterable` is to call ``iter(obj)``." msgstr "" msgid "ABC for sized iterable container classes." msgstr "" msgid "" -"ABC for classes that provide the :meth:`~iterator.__iter__` and :meth:" -"`~iterator.__next__` methods. See also the definition of :term:`iterator`." +"ABC for classes that provide the :meth:`~iterator.__iter__` " +"and :meth:`~iterator.__next__` methods. See also the definition " +"of :term:`iterator`." msgstr "" msgid "" @@ -449,37 +449,68 @@ msgid "" msgstr "" msgid "" -"ABC for :term:`generator` classes that implement the protocol defined in :" -"pep:`342` that extends :term:`iterators ` with the :meth:" -"`~generator.send`, :meth:`~generator.throw` and :meth:`~generator.close` " -"methods." +"ABC for :term:`generator` classes that implement the protocol defined " +"in :pep:`342` that extends :term:`iterators ` with " +"the :meth:`~generator.send`, :meth:`~generator.throw` " +"and :meth:`~generator.close` methods." msgstr "" msgid "" -"See :ref:`annotating-generators-and-coroutines` for details on using :class:" -"`!Generator` in type annotations." +"See :ref:`annotating-generators-and-coroutines` for details on " +"using :class:`!Generator` in type annotations." msgstr "" msgid "ABCs for read-only and mutable :term:`sequences `." msgstr "" msgid "" -"Implementation note: Some of the mixin methods, such as :meth:`~container." -"__iter__`, :meth:`~object.__reversed__` and :meth:`index`, make repeated " -"calls to the underlying :meth:`~object.__getitem__` method. Consequently, " +"Implementation note: Some of the mixin methods, such " +"as :meth:`~container.__iter__`, :meth:`~object.__reversed__`, " +"and :meth:`~sequence.index` make repeated calls to the " +"underlying :meth:`~object.__getitem__` method. Consequently, " "if :meth:`~object.__getitem__` is implemented with constant access speed, " "the mixin methods will have linear performance; however, if the underlying " "method is linear (as it would be with a linked list), the mixins will have " "quadratic performance and will likely need to be overridden." msgstr "" -msgid "The index() method added support for *stop* and *start* arguments." +msgid "Return first index of *value*." +msgstr "" + +msgid "Raises :exc:`ValueError` if the value is not present." +msgstr "" + +msgid "" +"Supporting the *start* and *stop* arguments is optional, but recommended." msgstr "" msgid "" -"The :class:`ByteString` ABC has been deprecated. For use in typing, prefer a " -"union, like ``bytes | bytearray``, or :class:`collections.abc.Buffer`. For " -"use as an ABC, prefer :class:`Sequence` or :class:`collections.abc.Buffer`." +"The :meth:`~sequence.index` method gained support for the *stop* and *start* " +"arguments." +msgstr "" + +msgid "The :class:`ByteString` ABC has been deprecated." +msgstr "" + +msgid "" +"Use ``isinstance(obj, collections.abc.Buffer)`` to test if ``obj`` " +"implements the :ref:`buffer protocol ` at runtime. For use in " +"type annotations, either use :class:`Buffer` or a union that explicitly " +"specifies the types your code supports (e.g., ``bytes | bytearray | " +"memoryview``)." +msgstr "" + +msgid "" +":class:`!ByteString` was originally intended to be an abstract class that " +"would serve as a supertype of both :class:`bytes` and :class:`bytearray`. " +"However, since the ABC never had any methods, knowing that an object was an " +"instance of :class:`!ByteString` never actually told you anything useful " +"about the object. Other common buffer types such as :class:`memoryview` were " +"also never understood as subtypes of :class:`!ByteString` (either at runtime " +"or by static type checkers)." +msgstr "" + +msgid "See :pep:`PEP 688 <688#current-options>` for more details." msgstr "" msgid "ABCs for read-only and mutable :ref:`sets `." @@ -494,43 +525,44 @@ msgstr "" msgid "" "ABC for :term:`awaitable` objects, which can be used in :keyword:`await` " -"expressions. Custom implementations must provide the :meth:`~object." -"__await__` method." +"expressions. Custom implementations must provide " +"the :meth:`~object.__await__` method." msgstr "" msgid "" -":term:`Coroutine ` objects and instances of the :class:" -"`~collections.abc.Coroutine` ABC are all instances of this ABC." +":term:`Coroutine ` objects and instances of " +"the :class:`~collections.abc.Coroutine` ABC are all instances of this ABC." msgstr "" msgid "" "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." +"decorated with :deco:`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`." +"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." +"decorated with :deco:`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 "" -"See :ref:`annotating-generators-and-coroutines` for details on using :class:" -"`!Coroutine` in type annotations. The variance and order of type parameters " -"correspond to those of :class:`Generator`." +"See :ref:`annotating-generators-and-coroutines` for details on " +"using :class:`!Coroutine` in type annotations. The variance and order of " +"type parameters correspond to those of :class:`Generator`." msgstr "" msgid "" @@ -549,8 +581,8 @@ msgid "" msgstr "" msgid "" -"See :ref:`annotating-generators-and-coroutines` for details on using :class:" -"`!AsyncGenerator` in type annotations." +"See :ref:`annotating-generators-and-coroutines` for details on " +"using :class:`!AsyncGenerator` in type annotations." msgstr "" msgid "" @@ -576,9 +608,10 @@ msgid "" "Several of the ABCs are also useful as mixins that make it easier to develop " "classes supporting container APIs. For example, to write a class supporting " "the full :class:`Set` API, it is only necessary to supply the three " -"underlying abstract methods: :meth:`~object.__contains__`, :meth:`~container." -"__iter__`, and :meth:`~object.__len__`. The ABC supplies the remaining " -"methods such as :meth:`!__and__` and :meth:`~frozenset.isdisjoint`::" +"underlying abstract " +"methods: :meth:`~object.__contains__`, :meth:`~container.__iter__`, " +"and :meth:`~object.__len__`. The ABC supplies the remaining methods such " +"as :meth:`!__and__` and :meth:`~frozenset.isdisjoint`::" msgstr "" msgid "" @@ -613,12 +646,12 @@ msgid "" "Since some set operations create new sets, the default mixin methods need a " "way to create new instances from an :term:`iterable`. The class constructor " "is assumed to have a signature in the form ``ClassName(iterable)``. That " -"assumption is factored-out to an internal :class:`classmethod` called :meth:" -"`!_from_iterable` which calls ``cls(iterable)`` to produce a new set. If " -"the :class:`Set` mixin is being used in a class with a different constructor " -"signature, you will need to override :meth:`!_from_iterable` with a " -"classmethod or regular method that can construct new instances from an " -"iterable argument." +"assumption is factored-out to an internal :class:`classmethod` " +"called :meth:`!_from_iterable` which calls ``cls(iterable)`` to produce a " +"new set. If the :class:`Set` mixin is being used in a class with a different " +"constructor signature, you will need to override :meth:`!_from_iterable` " +"with a classmethod or regular method that can construct new instances from " +"an iterable argument." msgstr "" msgid "" @@ -631,7 +664,7 @@ msgid "" "The :class:`Set` mixin provides a :meth:`!_hash` method to compute a hash " "value for the set; however, :meth:`~object.__hash__` is not defined because " "not all sets are :term:`hashable` or immutable. To add set hashability " -"using mixins, inherit from both :meth:`Set` and :meth:`Hashable`, then " +"using mixins, inherit from both :class:`Set` and :class:`Hashable`, then " "define ``__hash__ = Set._hash``." msgstr "" diff --git a/library/collections.po b/library/collections.po index cdd5b9a77b..0aa838b792 100644 --- a/library/collections.po +++ b/library/collections.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:56+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,8 +32,8 @@ msgstr "**Kod źródłowy:** :source:`Lib/collections/__init__.py`" msgid "" "This module implements specialized container datatypes providing " -"alternatives to Python's general purpose built-in containers, :class:" -"`dict`, :class:`list`, :class:`set`, and :class:`tuple`." +"alternatives to Python's general purpose built-in " +"containers, :class:`dict`, :class:`list`, :class:`set`, and :class:`tuple`." msgstr "" msgid ":func:`namedtuple`" @@ -159,10 +160,11 @@ msgstr "" msgid "" "Property returning a new :class:`ChainMap` containing all of the maps in the " "current instance except the first one. This is useful for skipping the " -"first map in the search. Use cases are similar to those for the :keyword:" -"`nonlocal` keyword used in :term:`nested scopes `. The use " -"cases also parallel those for the built-in :func:`super` function. A " -"reference to ``d.parents`` is equivalent to: ``ChainMap(*d.maps[1:])``." +"first map in the search. Use cases are similar to those for " +"the :keyword:`nonlocal` keyword used in :term:`nested scopes `. The use cases also parallel those for the built-in :func:`super` " +"function. A reference to ``d.parents`` is equivalent to: " +"``ChainMap(*d.maps[1:])``." msgstr "" msgid "" @@ -206,9 +208,9 @@ msgstr "" msgid "" "Django's `Context class `_ for templating is a read-only chain of mappings. It " -"also features pushing and popping of contexts similar to the :meth:" -"`~collections.ChainMap.new_child` method and the :attr:`~collections." -"ChainMap.parents` property." +"also features pushing and popping of contexts similar to " +"the :meth:`~collections.ChainMap.new_child` method and " +"the :attr:`~collections.ChainMap.parents` property." msgstr "" msgid "" @@ -219,8 +221,8 @@ msgid "" msgstr "" msgid "" -"A `greatly simplified read-only version of Chainmap `_." +"A `greatly simplified read-only version of Chainmap `_." msgstr "" msgid ":class:`ChainMap` Examples and Recipes" @@ -504,9 +506,9 @@ msgstr "" msgid "" "For in-place operations such as ``c[key] += 1``, the value type need only " "support addition and subtraction. So fractions, floats, and decimals would " -"work and negative values are supported. The same is also true for :meth:" -"`~Counter.update` and :meth:`~Counter.subtract` which allow negative and " -"zero values for both inputs and outputs." +"work and negative values are supported. The same is also true " +"for :meth:`~Counter.update` and :meth:`~Counter.subtract` which allow " +"negative and zero values for both inputs and outputs." msgstr "" msgid "" @@ -522,8 +524,8 @@ msgid "" msgstr "" msgid "" -"`Bag class `_ in Smalltalk." +"`Bag class `_ in Smalltalk." msgstr "" msgid "" @@ -583,13 +585,16 @@ msgid "" "only the most recent activity is of interest." msgstr "" +msgid "Deques are :ref:`generic ` over the type of their contents." +msgstr "" + msgid "Deque objects support the following methods:" msgstr "" -msgid "Add *x* to the right side of the deque." +msgid "Add *item* to the right side of the deque." msgstr "" -msgid "Add *x* to the left side of the deque." +msgid "Add *item* to the left side of the deque." msgstr "" msgid "Remove all elements from the deque leaving it with length 0." @@ -598,7 +603,7 @@ msgstr "" msgid "Create a shallow copy of the deque." msgstr "" -msgid "Count the number of deque elements equal to *x*." +msgid "Count the number of deque elements equal to *value*." msgstr "" msgid "" @@ -613,17 +618,17 @@ msgid "" msgstr "" msgid "" -"Return the position of *x* in the deque (at or after index *start* and " +"Return the position of *value* in the deque (at or after index *start* and " "before index *stop*). Returns the first match or raises :exc:`ValueError` " "if not found." msgstr "" -msgid "Insert *x* into the deque at position *i*." +msgid "Insert *value* into the deque at position *index*." msgstr "" msgid "" -"If the insertion would cause a bounded deque to grow beyond *maxlen*, an :" -"exc:`IndexError` is raised." +"If the insertion would cause a bounded deque to grow beyond *maxlen*, " +"an :exc:`IndexError` is raised." msgstr "" msgid "" @@ -637,8 +642,8 @@ msgid "" msgstr "" msgid "" -"Remove the first occurrence of *value*. If not found, raises a :exc:" -"`ValueError`." +"Remove the first occurrence of *value*. If not found, raises " +"a :exc:`ValueError`." msgstr "" msgid "Reverse the elements of the deque in-place and then return ``None``." @@ -772,11 +777,11 @@ msgstr "" msgid "" "A `round-robin scheduler `_ can be implemented with input iterators stored in a :" -"class:`deque`. Values are yielded from the active iterator in position " -"zero. If that iterator is exhausted, it can be removed with :meth:`~deque." -"popleft`; otherwise, it can be cycled back to the end with the :meth:`~deque." -"rotate` method::" +"robin_scheduling>`_ can be implemented with input iterators stored in " +"a :class:`deque`. Values are yielded from the active iterator in position " +"zero. If that iterator is exhausted, it can be removed " +"with :meth:`~deque.popleft`; otherwise, it can be cycled back to the end " +"with the :meth:`~deque.rotate` method::" msgstr "" msgid "" @@ -807,12 +812,13 @@ msgid "" msgstr "" msgid "" -"To implement :class:`deque` slicing, use a similar approach applying :meth:" -"`~deque.rotate` to bring a target element to the left side of the deque. " -"Remove old entries with :meth:`~deque.popleft`, add new entries with :meth:" -"`~deque.extend`, and then reverse the rotation. With minor variations on " -"that approach, it is easy to implement Forth style stack manipulations such " -"as ``dup``, ``drop``, ``swap``, ``over``, ``pick``, ``rot``, and ``roll``." +"To implement :class:`deque` slicing, use a similar approach " +"applying :meth:`~deque.rotate` to bring a target element to the left side of " +"the deque. Remove old entries with :meth:`~deque.popleft`, add new entries " +"with :meth:`~deque.extend`, and then reverse the rotation. With minor " +"variations on that approach, it is easy to implement Forth style stack " +"manipulations such as ``dup``, ``drop``, ``swap``, ``over``, ``pick``, " +"``rot``, and ``roll``." msgstr "" msgid ":class:`defaultdict` objects" @@ -826,10 +832,15 @@ msgid "" msgstr "" msgid "" -"The first argument provides the initial value for the :attr:" -"`default_factory` attribute; it defaults to ``None``. All remaining " -"arguments are treated the same as if they were passed to the :class:`dict` " -"constructor, including keyword arguments." +"The first argument provides the initial value for " +"the :attr:`default_factory` attribute; it defaults to ``None``. All " +"remaining arguments are treated the same as if they were passed to " +"the :class:`dict` constructor, including keyword arguments." +msgstr "" + +msgid "" +":class:`!defaultdict`\\s are :ref:`generic ` over two types, " +"signifying (respectively) the types of the dictionary's keys and values." msgstr "" msgid "" @@ -838,8 +849,8 @@ msgid "" msgstr "" msgid "" -"If the :attr:`default_factory` attribute is ``None``, this raises a :exc:" -"`KeyError` exception with the *key* as argument." +"If the :attr:`default_factory` attribute is ``None``, this raises " +"a :exc:`KeyError` exception with the *key* as argument." msgstr "" msgid "" @@ -854,25 +865,25 @@ msgid "" msgstr "" msgid "" -"This method is called by the :meth:`~object.__getitem__` method of the :" -"class:`dict` class when the requested key is not found; whatever it returns " -"or raises is then returned or raised by :meth:`~object.__getitem__`." +"This method is called by the :meth:`~object.__getitem__` method of " +"the :class:`dict` class when the requested key is not found; whatever it " +"returns or raises is then returned or raised by :meth:`~object.__getitem__`." msgstr "" msgid "" -"Note that :meth:`__missing__` is *not* called for any operations besides :" -"meth:`~object.__getitem__`. This means that :meth:`~dict.get` will, like " -"normal dictionaries, return ``None`` as a default rather than using :attr:" -"`default_factory`." +"Note that :meth:`__missing__` is *not* called for any operations " +"besides :meth:`~object.__getitem__`. This means that :meth:`~dict.get` will, " +"like normal dictionaries, return ``None`` as a default rather than " +"using :attr:`default_factory`." msgstr "" msgid ":class:`defaultdict` objects support the following instance variable:" msgstr "" msgid "" -"This attribute is used by the :meth:`__missing__` method; it is initialized " -"from the first argument to the constructor, if present, or to ``None``, if " -"absent." +"This attribute is used by the :meth:`~defaultdict.__missing__` method; it is " +"initialized from the first argument to the constructor, if present, or to " +"``None``, if absent." msgstr "" msgid "" @@ -889,26 +900,27 @@ msgstr "" msgid "" "When each key is encountered for the first time, it is not already in the " -"mapping; so an entry is automatically created using the :attr:`~defaultdict." -"default_factory` function which returns an empty :class:`list`. The :meth:`!" -"list.append` operation then attaches the value to the new list. When keys " -"are encountered again, the look-up proceeds normally (returning the list for " -"that key) and the :meth:`!list.append` operation adds another value to the " -"list. This technique is simpler and faster than an equivalent technique " +"mapping; so an entry is automatically created using " +"the :attr:`~defaultdict.default_factory` function which returns an " +"empty :class:`list`. The :meth:`list.append` operation then attaches the " +"value to the new list. When keys are encountered again, the look-up " +"proceeds normally (returning the list for that key) and " +"the :meth:`list.append` operation adds another value to the list. This " +"technique is simpler and faster than an equivalent technique " "using :meth:`dict.setdefault`:" msgstr "" msgid "" -"Setting the :attr:`~defaultdict.default_factory` to :class:`int` makes the :" -"class:`defaultdict` useful for counting (like a bag or multiset in other " -"languages):" +"Setting the :attr:`~defaultdict.default_factory` to :class:`int` makes " +"the :class:`defaultdict` useful for counting (like a bag or multiset in " +"other languages):" msgstr "" msgid "" -"When a letter is first encountered, it is missing from the mapping, so the :" -"attr:`~defaultdict.default_factory` function calls :func:`int` to supply a " -"default count of zero. The increment operation then builds up the count for " -"each letter." +"When a letter is first encountered, it is missing from the mapping, so " +"the :attr:`~defaultdict.default_factory` function calls :func:`int` to " +"supply a default count of zero. The increment operation then builds up the " +"count for each letter." msgstr "" msgid "" @@ -919,8 +931,8 @@ msgid "" msgstr "" msgid "" -"Setting the :attr:`~defaultdict.default_factory` to :class:`set` makes the :" -"class:`defaultdict` useful for building a dictionary of sets:" +"Setting the :attr:`~defaultdict.default_factory` to :class:`set` makes " +"the :class:`defaultdict` useful for building a dictionary of sets:" msgstr "" msgid ":func:`namedtuple` Factory Function for Tuples with Named Fields" @@ -937,9 +949,9 @@ msgid "" "Returns a new tuple subclass named *typename*. The new subclass is used to " "create tuple-like objects that have fields accessible by attribute lookup as " "well as being indexable and iterable. Instances of the subclass also have a " -"helpful docstring (with *typename* and *field_names*) and a helpful :meth:" -"`~object.__repr__` method which lists the tuple contents in a ``name=value`` " -"format." +"helpful docstring (with *typename* and *field_names*) and a " +"helpful :meth:`~object.__repr__` method which lists the tuple contents in a " +"``name=value`` format." msgstr "" msgid "" @@ -951,8 +963,9 @@ msgstr "" msgid "" "Any valid Python identifier may be used for a fieldname except for names " "starting with an underscore. Valid identifiers consist of letters, digits, " -"and underscores but do not start with a digit or underscore and cannot be a :" -"mod:`keyword` such as *class*, *for*, *return*, *global*, *pass*, or *raise*." +"and underscores but do not start with a digit or underscore and cannot be " +"a :mod:`keyword` such as *class*, *for*, *return*, *global*, *pass*, or " +"*raise*." msgstr "" msgid "" @@ -995,14 +1008,14 @@ msgid "" msgstr "" msgid "Added the *module* parameter." -msgstr "" +msgstr "Dodany parametr *module*." msgid "Removed the *verbose* parameter and the :attr:`!_source` attribute." msgstr "" msgid "" -"Added the *defaults* parameter and the :attr:`~somenamedtuple." -"_field_defaults` attribute." +"Added the *defaults* parameter and " +"the :attr:`~somenamedtuple._field_defaults` attribute." msgstr "" msgid "" @@ -1138,8 +1151,8 @@ msgid "" msgstr "" msgid "" -"To retrieve a field whose name is stored in a string, use the :func:" -"`getattr` function:" +"To retrieve a field whose name is stored in a string, use " +"the :func:`getattr` function:" msgstr "" msgid "" @@ -1328,15 +1341,15 @@ msgid "" msgstr "" msgid "" -"Equality tests between :class:`OrderedDict` objects and other :class:" -"`~collections.abc.Mapping` objects are order-insensitive like regular " -"dictionaries. This allows :class:`OrderedDict` objects to be substituted " -"anywhere a regular dictionary is used." +"Equality tests between :class:`OrderedDict` objects and " +"other :class:`~collections.abc.Mapping` objects are order-insensitive like " +"regular dictionaries. This allows :class:`OrderedDict` objects to be " +"substituted anywhere a regular dictionary is used." msgstr "" msgid "" -"The items, keys, and values :term:`views ` of :class:" -"`OrderedDict` now support reverse iteration using :func:`reversed`." +"The items, keys, and values :term:`views ` " +"of :class:`OrderedDict` now support reverse iteration using :func:`reversed`." msgstr "" msgid "" @@ -1365,13 +1378,13 @@ msgid "" msgstr "" msgid "" -"An :class:`OrderedDict` would also be useful for implementing variants of :" -"func:`functools.lru_cache`:" +"An :class:`OrderedDict` would also be useful for implementing variants " +"of :deco:`functools.lru_cache`:" msgstr "" msgid "" "from collections import OrderedDict\n" -"from time import time\n" +"from time import monotonic\n" "\n" "class TimeBoundedLRU:\n" " \"LRU Cache that invalidates and refreshes old entries.\"\n" @@ -1386,10 +1399,10 @@ msgid "" " if args in self.cache:\n" " self.cache.move_to_end(args)\n" " timestamp, result = self.cache[args]\n" -" if time() - timestamp <= self.maxage:\n" +" if monotonic() - timestamp <= self.maxage:\n" " return result\n" " result = self.func(*args)\n" -" self.cache[args] = time(), result\n" +" self.cache[args] = monotonic(), result\n" " if len(self.cache) > self.maxsize:\n" " self.cache.popitem(last=False)\n" " return result" @@ -1444,15 +1457,14 @@ msgstr "" msgid "" "Class that simulates a dictionary. The instance's contents are kept in a " -"regular dictionary, which is accessible via the :attr:`data` attribute of :" -"class:`UserDict` instances. If *initialdata* is provided, :attr:`data` is " -"initialized with its contents; note that a reference to *initialdata* will " -"not be kept, allowing it to be used for other purposes." +"regular dictionary, which is accessible via the :attr:`data` attribute " +"of :class:`!UserDict` instances. If arguments are provided, they are used " +"to initialize :attr:`data`, like a regular dictionary." msgstr "" msgid "" -"In addition to supporting the methods and operations of mappings, :class:" -"`UserDict` instances provide the following attribute:" +"In addition to supporting the methods and operations of mappings, :class:`!" +"UserDict` instances provide the following attribute:" msgstr "" msgid "" @@ -1477,20 +1489,20 @@ msgstr "" msgid "" "Class that simulates a list. The instance's contents are kept in a regular " -"list, which is accessible via the :attr:`data` attribute of :class:" -"`UserList` instances. The instance's contents are initially set to a copy " -"of *list*, defaulting to the empty list ``[]``. *list* can be any iterable, " -"for example a real Python list or a :class:`UserList` object." +"list, which is accessible via the :attr:`data` attribute " +"of :class:`UserList` instances. The instance's contents are initially set " +"to a copy of *list*, defaulting to the empty list ``[]``. *list* can be any " +"iterable, for example a real Python list or a :class:`UserList` object." msgstr "" msgid "" -"In addition to supporting the methods and operations of mutable sequences, :" -"class:`UserList` instances provide the following attribute:" +"In addition to supporting the methods and operations of mutable " +"sequences, :class:`UserList` instances provide the following attribute:" msgstr "" msgid "" -"A real :class:`list` object used to store the contents of the :class:" -"`UserList` class." +"A real :class:`list` object used to store the contents of " +"the :class:`UserList` class." msgstr "" msgid "" @@ -1528,13 +1540,13 @@ msgid "" msgstr "" msgid "" -"In addition to supporting the methods and operations of strings, :class:" -"`UserString` instances provide the following attribute:" +"In addition to supporting the methods and operations of " +"strings, :class:`UserString` instances provide the following attribute:" msgstr "" msgid "" -"A real :class:`str` object used to store the contents of the :class:" -"`UserString` class." +"A real :class:`str` object used to store the contents of " +"the :class:`UserString` class." msgstr "" msgid "" diff --git a/library/colorsys.po b/library/colorsys.po index 51ac0013b0..cbca25d62f 100644 --- a/library/colorsys.po +++ b/library/colorsys.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,9 +40,9 @@ msgid "" msgstr "" msgid "" -"More information about color spaces can be found at https://poynton.ca/" -"ColorFAQ.html and https://www.cambridgeincolour.com/tutorials/color-spaces." -"htm." +"More information about color spaces can be found at https://www.poynton.ca/" +"pdf/ColourFAQ.pdf and https://www.cambridgeincolour.com/tutorials/color-" +"spaces.htm." msgstr "" msgid "The :mod:`colorsys` module defines the following functions:" diff --git a/library/compileall.po b/library/compileall.po index b6545358bc..d10421c59a 100644 --- a/library/compileall.po +++ b/library/compileall.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -81,8 +81,19 @@ msgid "" msgstr "" msgid "" -"Remove (``-s``) or append (``-p``) the given prefix of paths recorded in the " -"``.pyc`` files. Cannot be combined with ``-d``." +"Remove the given prefix from paths recorded in the ``.pyc`` files. Paths are " +"made relative to the prefix." +msgstr "" + +msgid "This option can be used with ``-p`` but not with ``-d``." +msgstr "" + +msgid "" +"Prepend the given prefix to paths recorded in the ``.pyc`` files. Use ``-p /" +"`` to make the paths absolute." +msgstr "" + +msgid "This option can be used with ``-s`` but not with ``-d``." msgstr "" msgid "" @@ -122,9 +133,9 @@ msgid "" "values cause hash-based pycs to be generated. Hash-based pycs embed a hash " "of the source file contents rather than a timestamp. See :ref:`pyc-" "invalidation` for more information on how Python validates bytecode cache " -"files at runtime. The default is ``timestamp`` if the :envvar:" -"`SOURCE_DATE_EPOCH` environment variable is not set, and ``checked-hash`` if " -"the ``SOURCE_DATE_EPOCH`` environment variable is set." +"files at runtime. The default is ``timestamp`` if " +"the :envvar:`SOURCE_DATE_EPOCH` environment variable is not set, and " +"``checked-hash`` if the ``SOURCE_DATE_EPOCH`` environment variable is set." msgstr "" msgid "" @@ -166,19 +177,19 @@ msgid "" msgstr "" msgid "" -"Similarly, the :func:`compile` function respects the :data:`sys." -"pycache_prefix` setting. The generated bytecode cache will only be useful " -"if :func:`compile` is run with the same :data:`sys.pycache_prefix` (if any) " -"that will be used at runtime." +"Similarly, the :func:`compile` function respects " +"the :data:`sys.pycache_prefix` setting. The generated bytecode cache will " +"only be useful if :func:`compile` is run with the " +"same :data:`sys.pycache_prefix` (if any) that will be used at runtime." msgstr "" msgid "Public functions" msgstr "" msgid "" -"Recursively descend the directory tree named by *dir*, compiling all :file:`." -"py` files along the way. Return a true value if all the files compiled " -"successfully, and a false value otherwise." +"Recursively descend the directory tree named by *dir*, compiling " +"all :file:`.py` files along the way. Return a true value if all the files " +"compiled successfully, and a false value otherwise." msgstr "" msgid "" @@ -232,14 +243,14 @@ msgid "" "in parallel. The default is to not use multiple workers. If the platform " "can't use multiple workers and *workers* argument is given, then sequential " "compilation will be used as a fallback. If *workers* is 0, the number of " -"cores in the system is used. If *workers* is lower than ``0``, a :exc:" -"`ValueError` will be raised." +"cores in the system is used. If *workers* is lower than ``0``, " +"a :exc:`ValueError` will be raised." msgstr "" msgid "" -"*invalidation_mode* should be a member of the :class:`py_compile." -"PycInvalidationMode` enum and controls how the generated pycs are " -"invalidated at runtime." +"*invalidation_mode* should be a member of " +"the :class:`py_compile.PycInvalidationMode` enum and controls how the " +"generated pycs are invalidated at runtime." msgstr "" msgid "" @@ -283,8 +294,8 @@ msgstr "" msgid "" "Added *stripdir*, *prependdir*, *limit_sl_dest* and *hardlink_dupes* " -"arguments. Default value of *maxlevels* was changed from ``10`` to ``sys." -"getrecursionlimit()``" +"arguments. Default value of *maxlevels* was changed from ``10`` to " +"``sys.getrecursionlimit()``" msgstr "" msgid "" @@ -321,9 +332,9 @@ msgstr "" msgid "" "If *skip_curdir* is true (the default), the current directory is not " -"included in the search. All other parameters are passed to the :func:" -"`compile_dir` function. Note that unlike the other compile functions, " -"``maxlevels`` defaults to ``0``." +"included in the search. All other parameters are passed to " +"the :func:`compile_dir` function. Note that unlike the other compile " +"functions, ``maxlevels`` defaults to ``0``." msgstr "" msgid "" diff --git a/library/concurrent.futures.po b/library/concurrent.futures.po index e071d2d87a..cbcfba354f 100644 --- a/library/concurrent.futures.po +++ b/library/concurrent.futures.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,10 +37,17 @@ msgid "" msgstr "" msgid "" -"The asynchronous execution can be performed with threads, using :class:" -"`ThreadPoolExecutor`, or separate processes, using :class:" -"`ProcessPoolExecutor`. Both implement the same interface, which is defined " -"by the abstract :class:`Executor` class." +"The asynchronous execution can be performed with threads, " +"using :class:`ThreadPoolExecutor`, or separate processes, " +"using :class:`ProcessPoolExecutor`. Both implement the same interface, " +"which is defined by the abstract :class:`Executor` class." +msgstr "" + +msgid "" +":class:`concurrent.futures.Future` must not be confused " +"with :class:`asyncio.Future`, which is designed for use with :mod:`asyncio` " +"tasks and coroutines. See the :doc:`asyncio's Future ` " +"documentation for a detailed comparison of the two." msgstr "" msgid "Availability" @@ -84,11 +90,11 @@ msgid "" msgstr "" msgid "" -"The returned iterator raises a :exc:`TimeoutError` if :meth:`~iterator." -"__next__` is called and the result isn't available after *timeout* seconds " -"from the original call to :meth:`Executor.map`. *timeout* can be an int or a " -"float. If *timeout* is not specified or ``None``, there is no limit to the " -"wait time." +"The returned iterator raises a :exc:`TimeoutError` " +"if :meth:`~iterator.__next__` is called and the result isn't available after " +"*timeout* seconds from the original call to :meth:`Executor.map`. *timeout* " +"can be an int or a float. If *timeout* is not specified or ``None``, there " +"is no limit to the wait time." msgstr "" msgid "" @@ -110,9 +116,9 @@ msgstr "" msgid "" "Signal the executor that it should free any resources that it is using when " -"the currently pending futures are done executing. Calls to :meth:`Executor." -"submit` and :meth:`Executor.map` made after shutdown will raise :exc:" -"`RuntimeError`." +"the currently pending futures are done executing. Calls " +"to :meth:`Executor.submit` and :meth:`Executor.map` made after shutdown will " +"raise :exc:`RuntimeError`." msgstr "" msgid "" @@ -138,9 +144,10 @@ msgid "" msgstr "" msgid "" -"You can avoid having to call this method explicitly if you use the :keyword:" -"`with` statement, which will shutdown the :class:`Executor` (waiting as if :" -"meth:`Executor.shutdown` were called with *wait* set to ``True``)::" +"You can avoid having to call this method explicitly if you use the executor " +"as a :term:`context manager` via the :keyword:`with` statement, which will " +"shutdown the :class:`Executor` (waiting as if :meth:`Executor.shutdown` were " +"called with *wait* set to ``True``)::" msgstr "" msgid "" @@ -197,7 +204,9 @@ msgid "" " print(f.result())\n" "\n" "executor = ThreadPoolExecutor(max_workers=1)\n" -"executor.submit(wait_on_future)" +"future = executor.submit(wait_on_future)\n" +"# Note: calling future.result() would also cause a deadlock because\n" +"# the single worker thread is already waiting for wait_on_future()." msgstr "" msgid "" @@ -224,16 +233,16 @@ msgstr "" msgid "" "If *max_workers* is ``None`` or not given, it will default to the number of " -"processors on the machine, multiplied by ``5``, assuming that :class:" -"`ThreadPoolExecutor` is often used to overlap I/O instead of CPU work and " -"the number of workers should be higher than the number of workers for :class:" -"`ProcessPoolExecutor`." +"processors on the machine, multiplied by ``5``, assuming " +"that :class:`ThreadPoolExecutor` is often used to overlap I/O instead of CPU " +"work and the number of workers should be higher than the number of workers " +"for :class:`ProcessPoolExecutor`." msgstr "" msgid "" -"Added the *thread_name_prefix* parameter to allow users to control the :" -"class:`threading.Thread` names for worker threads created by the pool for " -"easier debugging." +"Added the *thread_name_prefix* parameter to allow users to control " +"the :class:`threading.Thread` names for worker threads created by the pool " +"for easier debugging." msgstr "" msgid "Added the *initializer* and *initargs* arguments." @@ -252,8 +261,8 @@ msgid "" msgstr "" msgid "" -"Default value of *max_workers* is changed to ``min(32, (os." -"process_cpu_count() or 1) + 4)``." +"Default value of *max_workers* is changed to ``min(32, " +"(os.process_cpu_count() or 1) + 4)``." msgstr "" msgid "ThreadPoolExecutor Example" @@ -294,11 +303,11 @@ msgstr "" msgid "" "The :class:`ProcessPoolExecutor` class is an :class:`Executor` subclass that " -"uses a pool of processes to execute calls asynchronously. :class:" -"`ProcessPoolExecutor` uses the :mod:`multiprocessing` module, which allows " -"it to side-step the :term:`Global Interpreter Lock ` but also means that only picklable objects can be executed and " -"returned." +"uses a pool of processes to execute calls " +"asynchronously. :class:`ProcessPoolExecutor` uses the :mod:`multiprocessing` " +"module, which allows it to side-step the :term:`Global Interpreter Lock " +"` but also means that only picklable objects can be " +"executed and returned." msgstr "" msgid "" @@ -312,6 +321,14 @@ msgid "" "submitted to a :class:`ProcessPoolExecutor` will result in deadlock." msgstr "" +msgid "" +"Note that the restrictions on functions and arguments needing to picklable " +"as per :class:`multiprocessing.Process` apply when " +"using :meth:`~Executor.submit` and :meth:`~Executor.map` on " +"a :class:`ProcessPoolExecutor`. A function defined in a REPL or a lambda " +"should not be expected to work." +msgstr "" + msgid "" "An :class:`Executor` subclass that executes calls asynchronously using a " "pool of at most *max_workers* processes. If *max_workers* is ``None`` or " @@ -322,8 +339,8 @@ msgid "" "the default chosen will be at most ``61``, even if more processors are " "available. *mp_context* can be a :mod:`multiprocessing` context or ``None``. " "It will be used to launch the workers. If *mp_context* is ``None`` or not " -"given, the default :mod:`multiprocessing` context is used. See :ref:" -"`multiprocessing-start-methods`." +"given, the default :mod:`multiprocessing` context is used. " +"See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" @@ -345,10 +362,10 @@ msgid "" msgstr "" msgid "" -"When one of the worker processes terminates abruptly, a :exc:`~concurrent." -"futures.process.BrokenProcessPool` error is now raised. Previously, " -"behaviour was undefined but operations on the executor or its futures would " -"often freeze or deadlock." +"When one of the worker processes terminates abruptly, " +"a :exc:`~concurrent.futures.process.BrokenProcessPool` error is now raised. " +"Previously, behaviour was undefined but operations on the executor or its " +"futures would often freeze or deadlock." msgstr "" msgid "" @@ -360,8 +377,8 @@ msgid "" "The default :mod:`multiprocessing` start method (see :ref:`multiprocessing-" "start-methods`) will change away from *fork* in Python 3.14. Code that " "requires *fork* be used for their :class:`ProcessPoolExecutor` should " -"explicitly specify that by passing a ``mp_context=multiprocessing." -"get_context(\"fork\")`` parameter." +"explicitly specify that by passing a " +"``mp_context=multiprocessing.get_context(\"fork\")`` parameter." msgstr "" msgid "" @@ -370,16 +387,23 @@ msgid "" msgstr "" msgid "" -"On POSIX systems, if your application has multiple threads and the :mod:" -"`multiprocessing` context uses the ``\"fork\"`` start method: The :func:`os." -"fork` function called internally to spawn workers may raise a :exc:" -"`DeprecationWarning`. Pass a *mp_context* configured to use a different " -"start method. See the :func:`os.fork` documentation for further explanation." +"On POSIX systems, if your application has multiple threads and " +"the :mod:`multiprocessing` context uses the ``\"fork\"`` start method: " +"The :func:`os.fork` function called internally to spawn workers may raise " +"a :exc:`DeprecationWarning`. Pass a *mp_context* configured to use a " +"different start method. See the :func:`os.fork` documentation for further " +"explanation." +msgstr "" + +msgid "" +"*max_workers* uses :func:`os.process_cpu_count` by default, instead " +"of :func:`os.cpu_count`." msgstr "" msgid "" -"*max_workers* uses :func:`os.process_cpu_count` by default, instead of :func:" -"`os.cpu_count`." +"Fixed a deadlock (:gh:`115634`) where the executor could hang after a worker " +"process exited upon reaching its *max_tasks_per_child* limit while tasks " +"remained queued." msgstr "" msgid "ProcessPoolExecutor Example" @@ -501,8 +525,8 @@ msgid "" msgstr "" msgid "" -"The following :class:`Future` methods are meant for use in unit tests and :" -"class:`Executor` implementations." +"The following :class:`Future` methods are meant for use in unit tests " +"and :class:`Executor` implementations." msgstr "" msgid "" @@ -512,8 +536,8 @@ msgid "" msgstr "" msgid "" -"If the method returns ``False`` then the :class:`Future` was cancelled, i." -"e. :meth:`Future.cancel` was called and returned ``True``. Any threads " +"If the method returns ``False`` then the :class:`Future` was cancelled, " +"i.e. :meth:`Future.cancel` was called and returned ``True``. Any threads " "waiting on the :class:`Future` completing (i.e. through :func:`as_completed` " "or :func:`wait`) will be woken up." msgstr "" @@ -525,8 +549,9 @@ msgid "" msgstr "" msgid "" -"This method can only be called once and cannot be called after :meth:`Future." -"set_result` or :meth:`Future.set_exception` have been called." +"This method can only be called once and cannot be called " +"after :meth:`Future.set_result` or :meth:`Future.set_exception` have been " +"called." msgstr "" msgid "" @@ -539,26 +564,26 @@ msgid "" msgstr "" msgid "" -"This method raises :exc:`concurrent.futures.InvalidStateError` if the :class:" -"`Future` is already done." +"This method raises :exc:`concurrent.futures.InvalidStateError` if " +"the :class:`Future` is already done." msgstr "" msgid "" -"Sets the result of the work associated with the :class:`Future` to the :" -"class:`Exception` *exception*." +"Sets the result of the work associated with the :class:`Future` to " +"the :class:`Exception` *exception*." msgstr "" msgid "Module Functions" msgstr "" msgid "" -"Wait for the :class:`Future` instances (possibly created by different :class:" -"`Executor` instances) given by *fs* to complete. Duplicate futures given to " -"*fs* are removed and will be returned only once. Returns a named 2-tuple of " -"sets. The first set, named ``done``, contains the futures that completed " -"(finished or cancelled futures) before the wait completed. The second set, " -"named ``not_done``, contains the futures that did not complete (pending or " -"running futures)." +"Wait for the :class:`Future` instances (possibly created by " +"different :class:`Executor` instances) given by *fs* to complete. Duplicate " +"futures given to *fs* are removed and will be returned only once. Returns a " +"named 2-tuple of sets. The first set, named ``done``, contains the futures " +"that completed (finished or cancelled futures) before the wait completed. " +"The second set, named ``not_done``, contains the futures that did not " +"complete (pending or running futures)." msgstr "" msgid "" @@ -583,8 +608,8 @@ msgstr "" msgid "" "The function will return when any future finishes by raising an exception. " -"If no future raises an exception then it is equivalent to :const:" -"`ALL_COMPLETED`." +"If no future raises an exception then it is equivalent " +"to :const:`ALL_COMPLETED`." msgstr "" msgid "The function will return when all futures finish or are cancelled." @@ -637,13 +662,14 @@ msgstr "" msgid "" "Derived from :exc:`~concurrent.futures.BrokenExecutor`, this exception class " -"is raised when one of the workers of a :class:`~concurrent.futures." -"ThreadPoolExecutor` has failed initializing." +"is raised when one of the workers of " +"a :class:`~concurrent.futures.ThreadPoolExecutor` has failed initializing." msgstr "" msgid "" -"Derived from :exc:`~concurrent.futures.BrokenExecutor` (formerly :exc:" -"`RuntimeError`), this exception class is raised when one of the workers of " -"a :class:`~concurrent.futures.ProcessPoolExecutor` has terminated in a non-" -"clean fashion (for example, if it was killed from the outside)." +"Derived from :exc:`~concurrent.futures.BrokenExecutor` " +"(formerly :exc:`RuntimeError`), this exception class is raised when one of " +"the workers of a :class:`~concurrent.futures.ProcessPoolExecutor` has " +"terminated in a non-clean fashion (for example, if it was killed from the " +"outside)." msgstr "" diff --git a/library/configparser.po b/library/configparser.po index 96537a9a2f..8ef6f0f4d2 100644 --- a/library/configparser.po +++ b/library/configparser.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,7 +27,7 @@ msgid ":mod:`!configparser` --- Configuration file parser" msgstr "" msgid "**Source code:** :source:`Lib/configparser.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/configparser.py`" msgid "" "This module provides the :class:`ConfigParser` class which implements a " @@ -167,12 +163,12 @@ msgid "" msgstr "" msgid "" -"It is possible to read several configurations into a single :class:" -"`ConfigParser`, where the most recently added configuration has the highest " -"priority. Any conflicting keys are taken from the more recent configuration " -"while the previously existing keys are retained. The example below reads in " -"an ``override.ini`` file, which will override any conflicting keys from the " -"``example.ini`` file." +"It is possible to read several configurations into a " +"single :class:`ConfigParser`, where the most recently added configuration " +"has the highest priority. Any conflicting keys are taken from the more " +"recent configuration while the previously existing keys are retained. The " +"example below reads in an ``override.ini`` file, which will override any " +"conflicting keys from the ``example.ini`` file." msgstr "" msgid "" @@ -291,10 +287,10 @@ msgstr "" "'9'" msgid "" -"One more thing to be aware of is that the parser-level :meth:`~ConfigParser." -"get` method provides a custom, more complex interface, maintained for " -"backwards compatibility. When using this method, a fallback value can be " -"provided via the ``fallback`` keyword-only argument:" +"One more thing to be aware of is that the parser-" +"level :meth:`~ConfigParser.get` method provides a custom, more complex " +"interface, maintained for backwards compatibility. When using this method, " +"a fallback value can be provided via the ``fallback`` keyword-only argument:" msgstr "" msgid "" @@ -304,9 +300,9 @@ msgid "" msgstr "" msgid "" -"The same ``fallback`` argument can be used with the :meth:`~ConfigParser." -"getint`, :meth:`~ConfigParser.getfloat` and :meth:`~ConfigParser.getboolean` " -"methods, for example:" +"The same ``fallback`` argument can be used with " +"the :meth:`~ConfigParser.getint`, :meth:`~ConfigParser.getfloat` " +"and :meth:`~ConfigParser.getboolean` methods, for example:" msgstr "" msgid "" @@ -458,8 +454,8 @@ msgid "" msgstr "" msgid "" -"With ``interpolation`` set to ``None``, the parser would simply return " -"``%(my_dir)s/Pictures`` as the value of ``my_pictures`` and ``%(home_dir)s/" +"With ``interpolation`` set to ``None``, the parser would simply return ``%" +"(my_dir)s/Pictures`` as the value of ``my_pictures`` and ``%(home_dir)s/" "lumberjack`` as the value of ``my_dir``." msgstr "" @@ -467,9 +463,9 @@ msgid "" "An alternative handler for interpolation which implements a more advanced " "syntax, used for instance in ``zc.buildout``. Extended interpolation is " "using ``${section:option}`` to denote a value from a foreign section. " -"Interpolation can span multiple levels. For convenience, if the ``section:" -"`` part is omitted, interpolation defaults to the current section (and " -"possibly the default values from the special section)." +"Interpolation can span multiple levels. For convenience, if the " +"``section:`` part is omitted, interpolation defaults to the current section " +"(and possibly the default values from the special section)." msgstr "" msgid "" @@ -516,8 +512,8 @@ msgstr "" msgid "" "Mapping protocol access is a generic name for functionality that enables " -"using custom objects as if they were dictionaries. In case of :mod:" -"`configparser`, the mapping interface implementation is using the " +"using custom objects as if they were dictionaries. In case " +"of :mod:`configparser`, the mapping interface implementation is using the " "``parser['section']['option']`` notation." msgstr "" @@ -531,9 +527,9 @@ msgstr "" msgid "" ":mod:`configparser` objects behave as close to actual dictionaries as " -"possible. The mapping interface is complete and adheres to the :class:" -"`~collections.abc.MutableMapping` ABC. However, there are a few differences " -"that should be taken into account:" +"possible. The mapping interface is complete and adheres to " +"the :class:`~collections.abc.MutableMapping` ABC. However, there are a few " +"differences that should be taken into account:" msgstr "" msgid "" @@ -550,8 +546,8 @@ msgid "" msgstr "" msgid "" -"All sections include ``DEFAULTSECT`` values as well which means that ``." -"clear()`` on a section may not leave the section visibly empty. This is " +"All sections include ``DEFAULTSECT`` values as well which means that " +"``.clear()`` on a section may not leave the section visibly empty. This is " "because default values cannot be deleted from the section (because " "technically they are not there). If they are overridden in the section, " "deleting causes the default value to be visible again. Trying to delete a " @@ -579,10 +575,10 @@ msgstr "" msgid "" "``parser.items()`` is compatible with the mapping protocol (returns a list " "of *section_name*, *section_proxy* pairs including the DEFAULTSECT). " -"However, this method can also be invoked with arguments: ``parser." -"items(section, raw, vars)``. The latter call returns a list of *option*, " -"*value* pairs for a specified ``section``, with all interpolations expanded " -"(unless ``raw=True`` is provided)." +"However, this method can also be invoked with arguments: " +"``parser.items(section, raw, vars)``. The latter call returns a list of " +"*option*, *value* pairs for a specified ``section``, with all interpolations " +"expanded (unless ``raw=True`` is provided)." msgstr "" msgid "" @@ -618,8 +614,8 @@ msgid "" msgstr "" msgid "" -"Hint: if you want to specify default values for a specific section, use :" -"meth:`~ConfigParser.read_dict` before you read the actual file." +"Hint: if you want to specify default values for a specific section, " +"use :meth:`~ConfigParser.read_dict` before you read the actual file." msgstr "" msgid "*dict_type*, default value: :class:`dict`" @@ -711,8 +707,8 @@ msgid "" msgstr "" msgid "" -"See also the *space_around_delimiters* argument to :meth:`ConfigParser." -"write`." +"See also the *space_around_delimiters* argument " +"to :meth:`ConfigParser.write`." msgstr "" msgid "*comment_prefixes*, default value: ``('#', ';')``" @@ -790,9 +786,10 @@ msgstr "" msgid "" "When set to ``True``, the parser will not allow for any section or option " -"duplicates while reading from a single source (using :meth:`~ConfigParser." -"read_file`, :meth:`~ConfigParser.read_string` or :meth:`~ConfigParser." -"read_dict`). It is recommended to use strict parsers in new applications." +"duplicates while reading from a single source " +"(using :meth:`~ConfigParser.read_file`, :meth:`~ConfigParser.read_string` " +"or :meth:`~ConfigParser.read_dict`). It is recommended to use strict " +"parsers in new applications." msgstr "" msgid "" @@ -841,9 +838,9 @@ msgid "" "other valid section name. Some typical values include: ``\"general\"`` or " "``\"common\"``. The name provided is used for recognizing default sections " "when reading from any source and is used when writing configuration back to " -"a file. Its current value can be retrieved using the ``parser_instance." -"default_section`` attribute and may be modified at runtime (i.e. to convert " -"files from one format to another)." +"a file. Its current value can be retrieved using the " +"``parser_instance.default_section`` attribute and may be modified at runtime " +"(i.e. to convert files from one format to another)." msgstr "" msgid "*interpolation*, default value: ``configparser.BasicInterpolation``" @@ -854,8 +851,8 @@ msgid "" "through the *interpolation* argument. ``None`` can be used to turn off " "interpolation completely, ``ExtendedInterpolation()`` provides a more " "advanced variant inspired by ``zc.buildout``. More on the subject in the " -"`dedicated documentation section <#interpolation-of-values>`_. :class:" -"`RawConfigParser` has a default value of ``None``." +"`dedicated documentation section <#interpolation-of-" +"values>`_. :class:`RawConfigParser` has a default value of ``None``." msgstr "" msgid "*converters*, default value: not set" @@ -867,9 +864,9 @@ msgid "" "and :meth:`~ConfigParser.getboolean` are implemented. Should other getters " "be desirable, users may define them in a subclass or pass a dictionary where " "each key is a name of the converter and each value is a callable " -"implementing said conversion. For instance, passing ``{'decimal': decimal." -"Decimal}`` would add :meth:`!getdecimal` on both the parser object and all " -"section proxies. In other words, it will be possible to write both " +"implementing said conversion. For instance, passing ``{'decimal': " +"decimal.Decimal}`` would add :meth:`!getdecimal` on both the parser object " +"and all section proxies. In other words, it will be possible to write both " "``parser_instance.getdecimal('section', 'key', fallback=0)`` and " "``parser_instance['section'].getdecimal('key', 0)``." msgstr "" @@ -1116,13 +1113,13 @@ msgstr "" msgid "" "When *strict* is ``True`` (the default), the parser won't allow for any " "section or option duplicates while reading from a single source (file, " -"string or dictionary), raising :exc:`DuplicateSectionError` or :exc:" -"`DuplicateOptionError`. When *empty_lines_in_values* is ``False`` (default: " -"``True``), each empty line marks the end of an option. Otherwise, internal " -"empty lines of a multiline option are kept as part of the value. When " -"*allow_no_value* is ``True`` (default: ``False``), options without values " -"are accepted; the value held for these is ``None`` and they are serialized " -"without the trailing delimiter." +"string or dictionary), raising :exc:`DuplicateSectionError` " +"or :exc:`DuplicateOptionError`. When *empty_lines_in_values* is ``False`` " +"(default: ``True``), each empty line marks the end of an option. Otherwise, " +"internal empty lines of a multiline option are kept as part of the value. " +"When *allow_no_value* is ``True`` (default: ``False``), options without " +"values are accepted; the value held for these is ``None`` and they are " +"serialized without the trailing delimiter." msgstr "" msgid "" @@ -1143,11 +1140,11 @@ msgid "" msgstr "" msgid "" -"All option names used in interpolation will be passed through the :meth:" -"`optionxform` method just like any other option name reference. For " -"example, using the default implementation of :meth:`optionxform` (which " -"converts option names to lower case), the values ``foo %(bar)s`` and ``foo " -"%(BAR)s`` are equivalent." +"All option names used in interpolation will be passed through " +"the :meth:`optionxform` method just like any other option name reference. " +"For example, using the default implementation of :meth:`optionxform` (which " +"converts option names to lower case), the values ``foo %(bar)s`` and ``foo %" +"(BAR)s`` are equivalent." msgstr "" msgid "" @@ -1221,9 +1218,9 @@ msgid "Return a list of options available in the specified *section*." msgstr "" msgid "" -"If the given *section* exists, and contains the given *option*, return :" -"const:`True`; otherwise return :const:`False`. If the specified *section* " -"is :const:`None` or an empty string, DEFAULT is assumed." +"If the given *section* exists, and contains the given *option*, " +"return :const:`True`; otherwise return :const:`False`. If the specified " +"*section* is :const:`None` or an empty string, DEFAULT is assumed." msgstr "" msgid "" @@ -1244,8 +1241,8 @@ msgstr "" msgid "" "If none of the named files exist, the :class:`ConfigParser` instance will " "contain an empty dataset. An application which requires initial values to " -"be loaded from a file should load the required file or files using :meth:" -"`read_file` before calling :meth:`read` for any optional files::" +"be loaded from a file should load the required file or files " +"using :meth:`read_file` before calling :meth:`read` for any optional files::" msgstr "" msgid "" @@ -1345,9 +1342,9 @@ msgid "" "``'1'``, ``'yes'``, ``'true'``, and ``'on'``, which cause this method to " "return ``True``, and ``'0'``, ``'no'``, ``'false'``, and ``'off'``, which " "cause it to return ``False``. These string values are checked in a case-" -"insensitive manner. Any other value will cause it to raise :exc:" -"`ValueError`. See :meth:`get` for explanation of *raw*, *vars* and " -"*fallback*." +"insensitive manner. Any other value will cause it to " +"raise :exc:`ValueError`. See :meth:`get` for explanation of *raw*, *vars* " +"and *fallback*." msgstr "" msgid "" @@ -1357,8 +1354,8 @@ msgstr "" msgid "" "Otherwise, return a list of *name*, *value* pairs for the options in the " -"given *section*. Optional arguments have the same meaning as for the :meth:" -"`get` method." +"given *section*. Optional arguments have the same meaning as for " +"the :meth:`get` method." msgstr "" msgid "" @@ -1429,9 +1426,9 @@ msgid "" msgstr "" msgid "" -"The maximum depth for recursive interpolation for :meth:`~configparser." -"ConfigParser.get` when the *raw* parameter is false. This is relevant only " -"when the default *interpolation* is used." +"The maximum depth for recursive interpolation " +"for :meth:`~configparser.ConfigParser.get` when the *raw* parameter is " +"false. This is relevant only when the default *interpolation* is used." msgstr "" msgid "RawConfigParser Objects" @@ -1463,9 +1460,9 @@ msgstr "" msgid "" "If the given section exists, set the given option to the specified value; " -"otherwise raise :exc:`NoSectionError`. While it is possible to use :class:" -"`RawConfigParser` (or :class:`ConfigParser` with *raw* parameters set to " -"true) for *internal* storage of non-string values, full functionality " +"otherwise raise :exc:`NoSectionError`. While it is possible to " +"use :class:`RawConfigParser` (or :class:`ConfigParser` with *raw* parameters " +"set to true) for *internal* storage of non-string values, full functionality " "(including interpolation and output to files) can only be achieved using " "string values." msgstr "" @@ -1493,8 +1490,8 @@ msgid "" msgstr "" msgid "" -"Added the optional *source* and *lineno* attributes and parameters to :meth:" -"`!__init__`." +"Added the optional *source* and *lineno* attributes and parameters " +"to :meth:`!__init__`." msgstr "" msgid "" @@ -1516,8 +1513,8 @@ msgstr "" msgid "" "Exception raised when string interpolation cannot be completed because the " -"number of iterations exceeds :const:`MAX_INTERPOLATION_DEPTH`. Subclass of :" -"exc:`InterpolationError`." +"number of iterations exceeds :const:`MAX_INTERPOLATION_DEPTH`. Subclass " +"of :exc:`InterpolationError`." msgstr "" msgid "" diff --git a/library/constants.po b/library/constants.po index 6d07bd505f..6a9a53fda6 100644 --- a/library/constants.po +++ b/library/constants.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Wiktor Matuszewski , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Wiktor Matuszewski , 2024\n" +"POT-Creation-Date: 2026-08-21 16:18+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -47,31 +47,19 @@ msgid "" "An object frequently used to represent the absence of a value, as when " "default arguments are not passed to a function. Assignments to ``None`` are " "illegal and raise a :exc:`SyntaxError`. ``None`` is the sole instance of " -"the :data:`~types.NoneType` type." +"the :class:`~types.NoneType` type." msgstr "" -"Obiekt często używany do reprezentowania braku wartości, na przykład gdy " -"domyślne argumenty nie są przekazywane do funkcji. Przypisania do ``None`` " -"są niedozwolone i rzucają wyjątkiem :exc:`SyntaxError`. ``None`` jest jedyną " -"instancją typu :data:`~types.NoneType`." msgid "" -"A special value which should be returned by the binary special methods (e." -"g. :meth:`~object.__eq__`, :meth:`~object.__lt__`, :meth:`~object.__add__`, :" -"meth:`~object.__rsub__`, etc.) to indicate that the operation is not " -"implemented with respect to the other type; may be returned by the in-place " -"binary special methods (e.g. :meth:`~object.__imul__`, :meth:`~object." -"__iand__`, etc.) for the same purpose. It should not be evaluated in a " -"boolean context. :data:`!NotImplemented` is the sole instance of the :data:" -"`types.NotImplementedType` type." +"A special value which should be returned by the binary special methods " +"(e.g. :meth:`~object.__eq__`, :meth:`~object.__lt__`, :meth:`~object.__add__`, :meth:`~object.__rsub__`, " +"etc.) to indicate that the operation is not implemented with respect to the " +"other type; may be returned by the in-place binary special methods " +"(e.g. :meth:`~object.__imul__`, :meth:`~object.__iand__`, etc.) for the same " +"purpose. It should not be evaluated in a boolean context. :data:`!" +"NotImplemented` is the sole instance of " +"the :class:`types.NotImplementedType` type." msgstr "" -"Specjalna wartość, która powinna być zwracana przez specjalne metody binarne " -"(np. :meth:`~object.__eq__`, :meth:`~object.__lt__`, :meth:`~object." -"__add__`, :meth:`~object.__rsub__`, itp.) aby zasygnalizować, że dana " -"operacja nie jest zaimplementowana w odniesieniu do drugiego typu; może być " -"zwracana przez specjalne metody binarne operujące w miejscu (ang. in-place) " -"(np. :meth:`~object.__imul__`, :meth:`~object.__iand__`, itp.) w tym samym " -"celu. Nie powinna być ewaluowana w kontekście logicznym. :data:`!" -"NotImplemented` jest jedyną instancją typu :data:`types.NotImplementedType`." msgid "" "When a binary (or in-place) method returns :data:`!NotImplemented` the " @@ -95,8 +83,8 @@ msgstr "Zobacz przykłady w :ref:`implementing-the-arithmetic-operations`." msgid "" ":data:`!NotImplemented` and :exc:`!NotImplementedError` are not " -"interchangeable. This constant should only be used as described above; see :" -"exc:`NotImplementedError` for details on correct usage of the exception." +"interchangeable. This constant should only be used as described above; " +"see :exc:`NotImplementedError` for details on correct usage of the exception." msgstr "" msgid "" @@ -110,27 +98,23 @@ msgstr "" "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." +"The same as the ellipsis literal \"``...``\", an object frequently used to " +"indicate that something is omitted. Assignment to ``Ellipsis`` is possible, " +"but assignment to ``...`` raises a :exc:`SyntaxError`. ``Ellipsis`` is the " +"sole instance of the :class:`types.EllipsisType` type." msgstr "" -"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`." +"Ta stała ma wartość True jeśli Python nie został uruchomiony z " +"opcją :option:`-O`. Zobacz także deklarację :keyword:`assert`." msgid "" "The names :data:`None`, :data:`False`, :data:`True` and :data:`__debug__` " -"cannot be reassigned (assignments to them, even as an attribute name, raise :" -"exc:`SyntaxError`), so they can be considered \"true\" constants." +"cannot be reassigned (assignments to them, even as an attribute name, " +"raise :exc:`SyntaxError`), so they can be considered \"true\" constants." msgstr "" "Nazwy :data:`None`, :data:`False`, :data:`True` oraz :data:`__debug__` nie " "mogą być przypisane ponownie (przypisania do nich, nawet jako nazwa " @@ -147,23 +131,22 @@ msgid "" "interpreter shell and should not be used in programs." msgstr "" "Moduł :mod:`site` (który jest importowany automatycznie podczas " -"uruchamiania, z wyjątkiem sytuacji, gdy podano opcję wiersza poleceń :option:" -"`-S`) dodaje kilka stałych do wbudowanej przestrzeni nazw. Są one przydatne " -"w interaktywnej powłoce interpretera i nie powinny być używane w programach." +"uruchamiania, z wyjątkiem sytuacji, gdy podano opcję wiersza " +"poleceń :option:`-S`) dodaje kilka stałych do wbudowanej przestrzeni nazw. " +"Są one przydatne w interaktywnej powłoce interpretera i nie powinny być " +"używane w programach." msgid "" "Objects that when printed, print a message like \"Use quit() or Ctrl-D (i.e. " -"EOF) to exit\", and when called, raise :exc:`SystemExit` with the specified " -"exit code." +"EOF) to exit\", and when accessed directly in the interactive interpreter or " +"called as functions, raise :exc:`SystemExit` with the specified exit code." msgstr "" -"Obiekty, które, 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 "" "Object that when printed, prints the message \"Type help() for interactive " -"help, or help(object) for help about object.\", and when called, acts as " -"described :func:`elsewhere `." +"help, or help(object) for help about object.\", and when accessed directly " +"in the interactive interpreter, invokes the built-in help system " +"(see :func:`help`)." msgstr "" msgid "" diff --git a/library/contextlib.po b/library/contextlib.po index c6a4221601..2605ae4d21 100644 --- a/library/contextlib.po +++ b/library/contextlib.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2026, 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 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,12 +28,12 @@ msgid "" msgstr "" msgid "**Source code:** :source:`Lib/contextlib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/contextlib.py`" msgid "" -"This module provides utilities for common tasks involving the :keyword:" -"`with` statement. For more information see also :ref:`typecontextmanager` " -"and :ref:`context-managers`." +"This module provides utilities for common tasks involving " +"the :keyword:`with` statement. For more information see " +"also :ref:`typecontextmanager` and :ref:`context-managers`." msgstr "" msgid "Utilities" @@ -44,32 +43,35 @@ msgid "Functions and classes provided:" msgstr "" msgid "" -"An :term:`abstract base class` for classes that implement :meth:`object." -"__enter__` and :meth:`object.__exit__`. A default implementation for :meth:" -"`object.__enter__` is provided which returns ``self`` while :meth:`object." -"__exit__` is an abstract method which by default returns ``None``. See also " -"the definition of :ref:`typecontextmanager`." +"An :term:`abstract base class` for classes that " +"implement :meth:`~object.__enter__` and :meth:`~object.__exit__`. A default " +"implementation for :meth:`~object.__enter__` is provided which returns " +"``self`` while :meth:`~object.__exit__` is an abstract method which by " +"default returns ``None``. See also the definition " +"of :ref:`typecontextmanager`." msgstr "" msgid "" -"An :term:`abstract base class` for classes that implement :meth:`object." -"__aenter__` and :meth:`object.__aexit__`. A default implementation for :meth:" -"`object.__aenter__` is provided which returns ``self`` while :meth:`object." -"__aexit__` is an abstract method which by default returns ``None``. See also " -"the definition of :ref:`async-context-managers`." +"An :term:`abstract base class` for classes that " +"implement :meth:`~object.__aenter__` and :meth:`~object.__aexit__`. A " +"default implementation for :meth:`~object.__aenter__` is provided which " +"returns ``self`` while :meth:`~object.__aexit__` is an abstract method which " +"by default returns ``None``. See also the definition of :ref:`async-context-" +"managers`." msgstr "" msgid "" "This function is a :term:`decorator` that can be used to define a factory " "function for :keyword:`with` statement context managers, without needing to " -"create a class or separate :meth:`__enter__` and :meth:`__exit__` methods." +"create a class or separate :meth:`~object.__enter__` " +"and :meth:`~object.__exit__` methods." msgstr "" msgid "" "While many objects natively support use in with statements, sometimes a " "resource needs to be managed that isn't a context manager in its own right, " -"and doesn't implement a ``close()`` method for use with ``contextlib." -"closing``" +"and doesn't implement a ``close()`` method for use with " +"``contextlib.closing``." msgstr "" msgid "" @@ -77,9 +79,29 @@ msgid "" "management::" msgstr "" +msgid "" +"from contextlib import contextmanager\n" +"\n" +"@contextmanager\n" +"def managed_resource(*args, **kwds):\n" +" # Code to acquire resource, e.g.:\n" +" resource = acquire_resource(*args, **kwds)\n" +" try:\n" +" yield resource\n" +" finally:\n" +" # Code to release resource, e.g.:\n" +" release_resource(resource)" +msgstr "" + msgid "The function can then be used like this::" msgstr "" +msgid "" +">>> with managed_resource(timeout=3600) as resource:\n" +"... # Resource is released at the end of this block,\n" +"... # even if code in the block raises an exception" +msgstr "" + msgid "" "The function being decorated must return a :term:`generator`-iterator when " "called. This iterator must yield exactly one value, which will be bound to " @@ -87,26 +109,26 @@ msgid "" msgstr "" msgid "" -"At the point where the generator yields, the block nested in the :keyword:" -"`with` statement is executed. The generator is then resumed after the block " -"is exited. If an unhandled exception occurs in the block, it is reraised " -"inside the generator at the point where the yield occurred. Thus, you can " -"use a :keyword:`try`...\\ :keyword:`except`...\\ :keyword:`finally` " -"statement to trap the error (if any), or ensure that some cleanup takes " -"place. If an exception is trapped merely in order to log it or to perform " -"some action (rather than to suppress it entirely), the generator must " -"reraise that exception. Otherwise the generator context manager will " -"indicate to the :keyword:`!with` statement that the exception has been " -"handled, and execution will resume with the statement immediately following " -"the :keyword:`!with` statement." +"At the point where the generator yields, the block nested in " +"the :keyword:`with` statement is executed. The generator is then resumed " +"after the block is exited. If an unhandled exception occurs in the block, it " +"is reraised inside the generator at the point where the yield occurred. " +"Thus, you can use a :keyword:`try`...\\ :keyword:`except`..." +"\\ :keyword:`finally` statement to trap the error (if any), or ensure that " +"some cleanup takes place. If an exception is trapped merely in order to log " +"it or to perform some action (rather than to suppress it entirely), the " +"generator must reraise that exception. Otherwise the generator context " +"manager will indicate to the :keyword:`!with` statement that the exception " +"has been handled, and execution will resume with the statement immediately " +"following the :keyword:`!with` statement." msgstr "" msgid "" -":func:`contextmanager` uses :class:`ContextDecorator` so the context " +":deco:`contextmanager` uses :class:`ContextDecorator` so the context " "managers it creates can be used as decorators as well as in :keyword:`with` " "statements. When used as a decorator, a new generator instance is implicitly " "created on each function call (this allows the otherwise \"one-shot\" " -"context managers created by :func:`contextmanager` to meet the requirement " +"context managers created by :deco:`contextmanager` to meet the requirement " "that context managers support multiple invocations in order to be used as " "decorators)." msgstr "" @@ -115,35 +137,68 @@ msgid "Use of :class:`ContextDecorator`." msgstr "" msgid "" -"Similar to :func:`~contextlib.contextmanager`, but creates an :ref:" -"`asynchronous context manager `." +"Similar to :deco:`~contextlib.contextmanager`, but creates " +"an :ref:`asynchronous context manager `." msgstr "" msgid "" "This function is a :term:`decorator` that can be used to define a factory " "function for :keyword:`async with` statement asynchronous context managers, " -"without needing to create a class or separate :meth:`__aenter__` and :meth:" -"`__aexit__` methods. It must be applied to an :term:`asynchronous generator` " -"function." +"without needing to create a class or separate :meth:`~object.__aenter__` " +"and :meth:`~object.__aexit__` methods. It must be applied to " +"an :term:`asynchronous generator` function." msgstr "" msgid "A simple example::" msgstr "" msgid "" -"Context managers defined with :func:`asynccontextmanager` can be used either " +"from contextlib import asynccontextmanager\n" +"\n" +"@asynccontextmanager\n" +"async def get_connection():\n" +" conn = await acquire_db_connection()\n" +" try:\n" +" yield conn\n" +" finally:\n" +" await release_db_connection(conn)\n" +"\n" +"async def get_all_users():\n" +" async with get_connection() as conn:\n" +" return conn.query('SELECT ...')" +msgstr "" + +msgid "" +"Context managers defined with :deco:`asynccontextmanager` can be used either " "as decorators or with :keyword:`async with` statements::" msgstr "" +msgid "" +"import time\n" +"from contextlib import asynccontextmanager\n" +"\n" +"@asynccontextmanager\n" +"async def timeit():\n" +" now = time.monotonic()\n" +" try:\n" +" yield\n" +" finally:\n" +" print(f'it took {time.monotonic() - now}s to run')\n" +"\n" +"@timeit()\n" +"async def main():\n" +" # ... async code ..." +msgstr "" + msgid "" "When used as a decorator, a new generator instance is implicitly created on " "each function call. This allows the otherwise \"one-shot\" context managers " -"created by :func:`asynccontextmanager` to meet the requirement that context " +"created by :deco:`asynccontextmanager` to meet the requirement that context " "managers support multiple invocations in order to be used as decorators." msgstr "" msgid "" -"Async context managers created with :func:`asynccontextmanager` can be used " +"Async context managers created with :deco:`asynccontextmanager` can be used " "as decorators." msgstr "" @@ -152,25 +207,74 @@ msgid "" "This is basically equivalent to::" msgstr "" +msgid "" +"from contextlib import contextmanager\n" +"\n" +"@contextmanager\n" +"def closing(thing):\n" +" try:\n" +" yield thing\n" +" finally:\n" +" thing.close()" +msgstr "" + msgid "And lets you write code like this::" msgstr "" +msgid "" +"from contextlib import closing\n" +"from urllib.request import urlopen\n" +"\n" +"with closing(urlopen('https://www.python.org')) as page:\n" +" for line in page:\n" +" print(line)" +msgstr "" + msgid "" "without needing to explicitly close ``page``. Even if an error occurs, " "``page.close()`` will be called when the :keyword:`with` block is exited." msgstr "" +msgid "" +"Most types managing resources support the :term:`context manager` protocol, " +"which closes *thing* on leaving the :keyword:`with` statement. As " +"such, :func:`!closing` is most useful for third party types that don't " +"support context managers. This example is purely for illustration purposes, " +"as :func:`~urllib.request.urlopen` would normally be used in a context " +"manager." +msgstr "" + msgid "" "Return an async context manager that calls the ``aclose()`` method of " "*thing* upon completion of the block. This is basically equivalent to::" msgstr "" +msgid "" +"from contextlib import asynccontextmanager\n" +"\n" +"@asynccontextmanager\n" +"async def aclosing(thing):\n" +" try:\n" +" yield thing\n" +" finally:\n" +" await thing.aclose()" +msgstr "" + msgid "" "Significantly, ``aclosing()`` supports deterministic cleanup of async " "generators when they happen to exit early by :keyword:`break` or an " "exception. For example::" msgstr "" +msgid "" +"from contextlib import aclosing\n" +"\n" +"async with aclosing(my_generator()) as values:\n" +" async for value in values:\n" +" if value == 42:\n" +" break" +msgstr "" + msgid "" "This pattern ensures that the generator's async exit code is executed in the " "same context as its iterations (so that exceptions and context variables " @@ -179,19 +283,57 @@ msgid "" msgstr "" msgid "" -"Return a context manager that returns *enter_result* from ``__enter__``, but " -"otherwise does nothing. It is intended to be used as a stand-in for an " -"optional context manager, for example::" +"Return a context manager that returns *enter_result* " +"from :meth:`~object.__enter__`, but otherwise does nothing. It is intended " +"to be used as a stand-in for an optional context manager, for example::" +msgstr "" + +msgid "" +"def myfunction(arg, ignore_exceptions=False):\n" +" if ignore_exceptions:\n" +" # Use suppress to ignore all exceptions.\n" +" cm = contextlib.suppress(Exception)\n" +" else:\n" +" # Do not ignore any exceptions, cm has no effect.\n" +" cm = contextlib.nullcontext()\n" +" with cm:\n" +" # Do something" msgstr "" msgid "An example using *enter_result*::" msgstr "" +msgid "" +"def process_file(file_or_path):\n" +" if isinstance(file_or_path, str):\n" +" # If string, open file\n" +" cm = open(file_or_path)\n" +" else:\n" +" # Caller is responsible for closing file\n" +" cm = nullcontext(file_or_path)\n" +"\n" +" with cm as file:\n" +" # Perform processing on the file" +msgstr "" + msgid "" "It can also be used as a stand-in for :ref:`asynchronous context managers " "`::" msgstr "" +msgid "" +"async def send_http(session=None):\n" +" if not session:\n" +" # If no http session, create it with aiohttp\n" +" cm = aiohttp.ClientSession()\n" +" else:\n" +" # Caller is responsible for closing the session\n" +" cm = nullcontext(session)\n" +"\n" +" async with cm as session:\n" +" # Send http requests with session" +msgstr "" + msgid ":term:`asynchronous context manager` support was added." msgstr "" @@ -212,12 +354,47 @@ msgstr "" msgid "For example::" msgstr "Dla przykładu::" +msgid "" +"from contextlib import suppress\n" +"\n" +"with suppress(FileNotFoundError):\n" +" os.remove('somefile.tmp')\n" +"\n" +"with suppress(FileNotFoundError):\n" +" os.remove('someotherfile.tmp')" +msgstr "" + msgid "This code is equivalent to::" msgstr "" +msgid "" +"try:\n" +" os.remove('somefile.tmp')\n" +"except FileNotFoundError:\n" +" pass\n" +"\n" +"try:\n" +" os.remove('someotherfile.tmp')\n" +"except FileNotFoundError:\n" +" pass" +msgstr "" + msgid "This context manager is :ref:`reentrant `." msgstr "" +msgid "" +"If the code within the :keyword:`!with` block raises " +"a :exc:`BaseExceptionGroup`, suppressed exceptions are removed from the " +"group. Any exceptions of the group which are not suppressed are re-raised " +"in a new group which is created using the original " +"group's :meth:`~BaseExceptionGroup.derive` method." +msgstr "" + +msgid "" +"``suppress`` now supports suppressing exceptions raised as part of " +"a :exc:`BaseExceptionGroup`." +msgstr "" + msgid "" "Context manager for temporarily redirecting :data:`sys.stdout` to another " "file or file-like object." @@ -230,10 +407,16 @@ msgstr "" msgid "" "For example, the output of :func:`help` normally is sent to *sys.stdout*. " -"You can capture that output in a string by redirecting the output to an :" -"class:`io.StringIO` object. The replacement stream is returned from the " -"``__enter__`` method and so is available as the target of the :keyword:" -"`with` statement::" +"You can capture that output in a string by redirecting the output to " +"an :class:`io.StringIO` object. The replacement stream is returned from " +"the :meth:`~object.__enter__` method and so is available as the target of " +"the :keyword:`with` statement::" +msgstr "" + +msgid "" +"with redirect_stdout(io.StringIO()) as f:\n" +" help(pow)\n" +"s = f.getvalue()" msgstr "" msgid "" @@ -241,9 +424,20 @@ msgid "" "a regular file::" msgstr "" +msgid "" +"with open('help.txt', 'w') as f:\n" +" with redirect_stdout(f):\n" +" help(pow)" +msgstr "" + msgid "To send the output of :func:`help` to *sys.stderr*::" msgstr "" +msgid "" +"with redirect_stdout(sys.stderr):\n" +" help(pow)" +msgstr "" + msgid "" "Note that the global side effect on :data:`sys.stdout` means that this " "context manager is not suitable for use in library code and most threaded " @@ -252,8 +446,8 @@ msgid "" msgstr "" msgid "" -"Similar to :func:`~contextlib.redirect_stdout` but redirecting :data:`sys." -"stderr` to another file or file-like object." +"Similar to :func:`~contextlib.redirect_stdout` but " +"redirecting :data:`sys.stderr` to another file or file-like object." msgstr "" msgid "" @@ -275,29 +469,73 @@ msgid "" msgstr "" msgid "" -"Context managers inheriting from ``ContextDecorator`` have to implement " -"``__enter__`` and ``__exit__`` as normal. ``__exit__`` retains its optional " -"exception handling even when used as a decorator." +"Context managers inheriting from ``ContextDecorator`` have to " +"implement :meth:`~object.__enter__` and :meth:`~object.__exit__` as normal. " +"``__exit__`` retains its optional exception handling even when used as a " +"decorator." msgstr "" msgid "" -"``ContextDecorator`` is used by :func:`contextmanager`, so you get this " +"``ContextDecorator`` is used by :deco:`contextmanager`, so you get this " "functionality automatically." msgstr "" msgid "Example of ``ContextDecorator``::" msgstr "" +msgid "" +"from contextlib import ContextDecorator\n" +"\n" +"class mycontext(ContextDecorator):\n" +" def __enter__(self):\n" +" print('Starting')\n" +" return self\n" +"\n" +" def __exit__(self, *exc):\n" +" print('Finishing')\n" +" return False" +msgstr "" + msgid "The class can then be used like this::" msgstr "" +msgid "" +">>> @mycontext()\n" +"... def function():\n" +"... print('The bit in the middle')\n" +"...\n" +">>> function()\n" +"Starting\n" +"The bit in the middle\n" +"Finishing\n" +"\n" +">>> with mycontext():\n" +"... print('The bit in the middle')\n" +"...\n" +"Starting\n" +"The bit in the middle\n" +"Finishing" +msgstr "" + msgid "" "This change is just syntactic sugar for any construct of the following form::" msgstr "" +msgid "" +"def f():\n" +" with cm():\n" +" # Do stuff" +msgstr "" + msgid "``ContextDecorator`` lets you instead write::" msgstr "" +msgid "" +"@cm()\n" +"def f():\n" +" # Do stuff" +msgstr "" + msgid "" "It makes it clear that the ``cm`` applies to the whole function, rather than " "just a piece of it (and saving an indentation level is nice, too)." @@ -308,6 +546,17 @@ msgid "" "using ``ContextDecorator`` as a mixin class::" msgstr "" +msgid "" +"from contextlib import ContextDecorator\n" +"\n" +"class mycontext(ContextBaseClass, ContextDecorator):\n" +" def __enter__(self):\n" +" return self\n" +"\n" +" def __exit__(self, *exc):\n" +" return False" +msgstr "" + msgid "" "As the decorated function must be able to be called multiple times, the " "underlying context manager must support use in multiple :keyword:`with` " @@ -322,6 +571,40 @@ msgstr "" msgid "Example of ``AsyncContextDecorator``::" msgstr "" +msgid "" +"from asyncio import run\n" +"from contextlib import AsyncContextDecorator\n" +"\n" +"class mycontext(AsyncContextDecorator):\n" +" async def __aenter__(self):\n" +" print('Starting')\n" +" return self\n" +"\n" +" async def __aexit__(self, *exc):\n" +" print('Finishing')\n" +" return False" +msgstr "" + +msgid "" +">>> @mycontext()\n" +"... async def function():\n" +"... print('The bit in the middle')\n" +"...\n" +">>> run(function())\n" +"Starting\n" +"The bit in the middle\n" +"Finishing\n" +"\n" +">>> async def function():\n" +"... async with mycontext():\n" +"... print('The bit in the middle')\n" +"...\n" +">>> run(function())\n" +"Starting\n" +"The bit in the middle\n" +"Finishing" +msgstr "" + msgid "" "A context manager that is designed to make it easy to programmatically " "combine other context managers and cleanup functions, especially those that " @@ -334,8 +617,16 @@ msgid "" msgstr "" msgid "" -"The :meth:`__enter__` method returns the :class:`ExitStack` instance, and " -"performs no additional operations." +"with ExitStack() as stack:\n" +" files = [stack.enter_context(open(fname)) for fname in filenames]\n" +" # All opened files will automatically be closed at the end of\n" +" # the with statement, even if attempts to open files later\n" +" # in the list raise an exception" +msgstr "" + +msgid "" +"The :meth:`~object.__enter__` method returns the :class:`ExitStack` " +"instance, and performs no additional operations." msgstr "" msgid "" @@ -368,9 +659,9 @@ msgid "" msgstr "" msgid "" -"Enters a new context manager and adds its :meth:`__exit__` method to the " -"callback stack. The return value is the result of the context manager's own :" -"meth:`__enter__` method." +"Enters a new context manager and adds its :meth:`~object.__exit__` method to " +"the callback stack. The return value is the result of the context manager's " +"own :meth:`~object.__enter__` method." msgstr "" msgid "" @@ -383,24 +674,27 @@ msgid "" "context manager." msgstr "" -msgid "Adds a context manager's :meth:`__exit__` method to the callback stack." +msgid "" +"Adds a context manager's :meth:`~object.__exit__` method to the callback " +"stack." msgstr "" msgid "" "As ``__enter__`` is *not* invoked, this method can be used to cover part of " -"an :meth:`__enter__` implementation with a context manager's own :meth:" -"`__exit__` method." +"an :meth:`~object.__enter__` implementation with a context manager's " +"own :meth:`~object.__exit__` method." msgstr "" msgid "" "If passed an object that is not a context manager, this method assumes it is " -"a callback with the same signature as a context manager's :meth:`__exit__` " -"method and adds it directly to the callback stack." +"a callback with the same signature as a context " +"manager's :meth:`~object.__exit__` method and adds it directly to the " +"callback stack." msgstr "" msgid "" "By returning true values, these callbacks can suppress exceptions the same " -"way context manager :meth:`__exit__` methods can." +"way context manager :meth:`~object.__exit__` methods can." msgstr "" msgid "" @@ -435,6 +729,17 @@ msgid "" "operation as follows::" msgstr "" +msgid "" +"with ExitStack() as stack:\n" +" files = [stack.enter_context(open(fname)) for fname in filenames]\n" +" # Hold onto the close method, but don't call it yet.\n" +" close_files = stack.pop_all().close\n" +" # If opening any file fails, all previously opened files will be\n" +" # closed automatically. If all files are opened successfully,\n" +" # they will remain open even after the with statement ends.\n" +" # close_files() can then be invoked explicitly to close them all." +msgstr "" + msgid "" "Immediately unwinds the callback stack, invoking callbacks in the reverse " "order of registration. For any context managers and exit callbacks " @@ -442,18 +747,20 @@ msgid "" msgstr "" msgid "" -"An :ref:`asynchronous context manager `, similar to :" -"class:`ExitStack`, that supports combining both synchronous and asynchronous " -"context managers, as well as having coroutines for cleanup logic." +"An :ref:`asynchronous context manager `, similar " +"to :class:`ExitStack`, that supports combining both synchronous and " +"asynchronous context managers, as well as having coroutines for cleanup " +"logic." msgstr "" msgid "" -"The :meth:`close` method is not implemented, :meth:`aclose` must be used " -"instead." +"The :meth:`~ExitStack.close` method is not implemented; :meth:`aclose` must " +"be used instead." msgstr "" msgid "" -"Similar to :meth:`enter_context` but expects an asynchronous context manager." +"Similar to :meth:`ExitStack.enter_context` but expects an asynchronous " +"context manager." msgstr "" msgid "" @@ -462,17 +769,26 @@ msgid "" msgstr "" msgid "" -"Similar to :meth:`push` but expects either an asynchronous context manager " -"or a coroutine function." +"Similar to :meth:`ExitStack.push` but expects either an asynchronous context " +"manager or a coroutine function." msgstr "" -msgid "Similar to :meth:`callback` but expects a coroutine function." +msgid "Similar to :meth:`ExitStack.callback` but expects a coroutine function." msgstr "" -msgid "Similar to :meth:`close` but properly handles awaitables." +msgid "Similar to :meth:`ExitStack.close` but properly handles awaitables." msgstr "" -msgid "Continuing the example for :func:`asynccontextmanager`::" +msgid "Continuing the example for :deco:`asynccontextmanager`::" +msgstr "" + +msgid "" +"async with AsyncExitStack() as stack:\n" +" connections = [await stack.enter_async_context(get_connection())\n" +" for i in range(5)]\n" +" # All opened connections will automatically be released at the end of\n" +" # the async with statement, even if attempts to open a connection\n" +" # later in the list raise an exception." msgstr "" msgid "Examples and Recipes" @@ -495,6 +811,16 @@ msgid "" "of the context managers being optional::" msgstr "" +msgid "" +"with ExitStack() as stack:\n" +" for resource in resources:\n" +" stack.enter_context(resource)\n" +" if need_special_resource():\n" +" special = acquire_special_resource()\n" +" stack.callback(release_special_resource, special)\n" +" # Perform operations that use the acquired resources" +msgstr "" + msgid "" "As shown, :class:`ExitStack` also makes it quite easy to use :keyword:`with` " "statements to manage arbitrary resources that don't natively support the " @@ -505,21 +831,33 @@ msgid "Catching exceptions from ``__enter__`` methods" msgstr "" msgid "" -"It is occasionally desirable to catch exceptions from an ``__enter__`` " -"method implementation, *without* inadvertently catching exceptions from the :" -"keyword:`with` statement body or the context manager's ``__exit__`` method. " -"By using :class:`ExitStack` the steps in the context management protocol can " -"be separated slightly in order to allow this::" +"It is occasionally desirable to catch exceptions from " +"an :meth:`~object.__enter__` method implementation, *without* inadvertently " +"catching exceptions from the :keyword:`with` statement body or the context " +"manager's :meth:`~object.__exit__` method. By using :class:`ExitStack` the " +"steps in the context management protocol can be separated slightly in order " +"to allow this::" +msgstr "" + +msgid "" +"stack = ExitStack()\n" +"try:\n" +" x = stack.enter_context(cm)\n" +"except Exception:\n" +" # handle __enter__ exception\n" +"else:\n" +" with stack:\n" +" # Handle normal case" msgstr "" msgid "" "Actually needing to do this is likely to indicate that the underlying API " -"should be providing a direct resource management interface for use with :" -"keyword:`try`/:keyword:`except`/:keyword:`finally` statements, but not all " -"APIs are well designed in that regard. When a context manager is the only " -"resource management API provided, then :class:`ExitStack` can make it easier " -"to handle various situations that can't be handled directly in a :keyword:" -"`with` statement." +"should be providing a direct resource management interface for use " +"with :keyword:`try`/:keyword:`except`/:keyword:`finally` statements, but not " +"all APIs are well designed in that regard. When a context manager is the " +"only resource management API provided, then :class:`ExitStack` can make it " +"easier to handle various situations that can't be handled directly in " +"a :keyword:`with` statement." msgstr "" msgid "Cleaning up in an ``__enter__`` implementation" @@ -527,8 +865,8 @@ msgstr "" msgid "" "As noted in the documentation of :meth:`ExitStack.push`, this method can be " -"useful in cleaning up an already allocated resource if later steps in the :" -"meth:`__enter__` implementation fail." +"useful in cleaning up an already allocated resource if later steps in " +"the :meth:`~object.__enter__` implementation fail." msgstr "" msgid "" @@ -537,6 +875,43 @@ msgid "" "function, and maps them to the context management protocol::" msgstr "" +msgid "" +"from contextlib import contextmanager, AbstractContextManager, ExitStack\n" +"\n" +"class ResourceManager(AbstractContextManager):\n" +"\n" +" def __init__(self, acquire_resource, release_resource, " +"check_resource_ok=None):\n" +" self.acquire_resource = acquire_resource\n" +" self.release_resource = release_resource\n" +" if check_resource_ok is None:\n" +" def check_resource_ok(resource):\n" +" return True\n" +" self.check_resource_ok = check_resource_ok\n" +"\n" +" @contextmanager\n" +" def _cleanup_on_error(self):\n" +" with ExitStack() as stack:\n" +" stack.push(self)\n" +" yield\n" +" # The validation check passed and didn't raise an exception\n" +" # Accordingly, we want to keep the resource, and pass it\n" +" # back to our caller\n" +" stack.pop_all()\n" +"\n" +" def __enter__(self):\n" +" resource = self.acquire_resource()\n" +" with self._cleanup_on_error():\n" +" if not self.check_resource_ok(resource):\n" +" msg = \"Failed validation for {!r}\"\n" +" raise RuntimeError(msg.format(resource))\n" +" return resource\n" +"\n" +" def __exit__(self, *exc_details):\n" +" # We don't need to duplicate any of our resource release logic\n" +" self.release_resource()" +msgstr "" + msgid "Replacing any use of ``try-finally`` and flag variables" msgstr "" @@ -547,6 +922,17 @@ msgid "" "by using an ``except`` clause instead), it looks something like this::" msgstr "" +msgid "" +"cleanup_needed = True\n" +"try:\n" +" result = perform_operation()\n" +" if result:\n" +" cleanup_needed = False\n" +"finally:\n" +" if cleanup_needed:\n" +" cleanup_resources()" +msgstr "" + msgid "" "As with any ``try`` statement based code, this can cause problems for " "development and review, because the setup code and the cleanup code can end " @@ -560,7 +946,17 @@ msgid "" msgstr "" msgid "" -"This allows the intended cleanup up behaviour to be made explicit up front, " +"from contextlib import ExitStack\n" +"\n" +"with ExitStack() as stack:\n" +" stack.callback(cleanup_resources)\n" +" result = perform_operation()\n" +" if result:\n" +" stack.pop_all()" +msgstr "" + +msgid "" +"This allows the intended cleanup behaviour to be made explicit up front, " "rather than requiring a separate flag variable." msgstr "" @@ -569,10 +965,39 @@ msgid "" "even further by means of a small helper class::" msgstr "" +msgid "" +"from contextlib import ExitStack\n" +"\n" +"class Callback(ExitStack):\n" +" def __init__(self, callback, /, *args, **kwds):\n" +" super().__init__()\n" +" self.callback(callback, *args, **kwds)\n" +"\n" +" def cancel(self):\n" +" self.pop_all()\n" +"\n" +"with Callback(cleanup_resources) as cb:\n" +" result = perform_operation()\n" +" if result:\n" +" cb.cancel()" +msgstr "" + msgid "" "If the resource cleanup isn't already neatly bundled into a standalone " -"function, then it is still possible to use the decorator form of :meth:" -"`ExitStack.callback` to declare the resource cleanup in advance::" +"function, then it is still possible to use the decorator form " +"of :meth:`ExitStack.callback` to declare the resource cleanup in advance::" +msgstr "" + +msgid "" +"from contextlib import ExitStack\n" +"\n" +"with ExitStack() as stack:\n" +" @stack.callback\n" +" def cleanup_resources():\n" +" ...\n" +" result = perform_operation()\n" +" if result:\n" +" stack.pop_all()" msgstr "" msgid "" @@ -597,17 +1022,47 @@ msgid "" "in a single definition::" msgstr "" +msgid "" +"from contextlib import ContextDecorator\n" +"import logging\n" +"\n" +"logging.basicConfig(level=logging.INFO)\n" +"\n" +"class track_entry_and_exit(ContextDecorator):\n" +" def __init__(self, name):\n" +" self.name = name\n" +"\n" +" def __enter__(self):\n" +" logging.info('Entering: %s', self.name)\n" +"\n" +" def __exit__(self, exc_type, exc, exc_tb):\n" +" logging.info('Exiting: %s', self.name)" +msgstr "" + msgid "Instances of this class can be used as both a context manager::" msgstr "" +msgid "" +"with track_entry_and_exit('widget loader'):\n" +" print('Some time consuming activity goes here')\n" +" load_widget()" +msgstr "" + msgid "And also as a function decorator::" msgstr "" +msgid "" +"@track_entry_and_exit('widget loader')\n" +"def activity():\n" +" print('Some time consuming activity goes here')\n" +" load_widget()" +msgstr "" + msgid "" "Note that there is one additional limitation when using context managers as " -"function decorators: there's no way to access the return value of :meth:" -"`__enter__`. If that value is needed, then it is still necessary to use an " -"explicit ``with`` statement." +"function decorators: there's no way to access the return value " +"of :meth:`~object.__enter__`. If that value is needed, then it is still " +"necessary to use an explicit ``with`` statement." msgstr "" msgid ":pep:`343` - The \"with\" statement" @@ -641,11 +1096,33 @@ msgid "" msgstr "" msgid "" -"Context managers created using :func:`contextmanager` are also single use " +"Context managers created using :deco:`contextmanager` are also single use " "context managers, and will complain about the underlying generator failing " "to yield if an attempt is made to use them a second time::" msgstr "" +msgid "" +">>> from contextlib import contextmanager\n" +">>> @contextmanager\n" +"... def singleuse():\n" +"... print(\"Before\")\n" +"... yield\n" +"... print(\"After\")\n" +"...\n" +">>> cm = singleuse()\n" +">>> with cm:\n" +"... pass\n" +"...\n" +"Before\n" +"After\n" +">>> with cm:\n" +"... pass\n" +"...\n" +"Traceback (most recent call last):\n" +" ...\n" +"RuntimeError: generator didn't yield" +msgstr "" + msgid "Reentrant context managers" msgstr "" @@ -662,6 +1139,23 @@ msgid "" "very simple example of reentrant use::" msgstr "" +msgid "" +">>> from contextlib import redirect_stdout\n" +">>> from io import StringIO\n" +">>> stream = StringIO()\n" +">>> write_to_stream = redirect_stdout(stream)\n" +">>> with write_to_stream:\n" +"... print(\"This is written to the stream rather than stdout\")\n" +"... with write_to_stream:\n" +"... print(\"This is also written to the stream\")\n" +"...\n" +">>> print(\"This is written directly to stdout\")\n" +"This is written directly to stdout\n" +">>> print(stream.getvalue())\n" +"This is written to the stream rather than stdout\n" +"This is also written to the stream" +msgstr "" + msgid "" "Real world examples of reentrancy are more likely to involve multiple " "functions calling each other and hence be far more complicated than this " @@ -671,8 +1165,8 @@ msgstr "" msgid "" "Note also that being reentrant is *not* the same thing as being thread " "safe. :func:`redirect_stdout`, for example, is definitely not thread safe, " -"as it makes a global modification to the system state by binding :data:`sys." -"stdout` to a different stream." +"as it makes a global modification to the system state by " +"binding :data:`sys.stdout` to a different stream." msgstr "" msgid "Reusable context managers" @@ -689,14 +1183,43 @@ msgstr "" msgid "" ":class:`threading.Lock` is an example of a reusable, but not reentrant, " -"context manager (for a reentrant lock, it is necessary to use :class:" -"`threading.RLock` instead)." -msgstr "" - -msgid "" -"Another example of a reusable, but not reentrant, context manager is :class:" -"`ExitStack`, as it invokes *all* currently registered callbacks when leaving " -"any with statement, regardless of where those callbacks were added::" +"context manager (for a reentrant lock, it is necessary to " +"use :class:`threading.RLock` instead)." +msgstr "" + +msgid "" +"Another example of a reusable, but not reentrant, context manager " +"is :class:`ExitStack`, as it invokes *all* currently registered callbacks " +"when leaving any with statement, regardless of where those callbacks were " +"added::" +msgstr "" + +msgid "" +">>> from contextlib import ExitStack\n" +">>> stack = ExitStack()\n" +">>> with stack:\n" +"... stack.callback(print, \"Callback: from first context\")\n" +"... print(\"Leaving first context\")\n" +"...\n" +"Leaving first context\n" +"Callback: from first context\n" +">>> with stack:\n" +"... stack.callback(print, \"Callback: from second context\")\n" +"... print(\"Leaving second context\")\n" +"...\n" +"Leaving second context\n" +"Callback: from second context\n" +">>> with stack:\n" +"... stack.callback(print, \"Callback: from outer context\")\n" +"... with stack:\n" +"... stack.callback(print, \"Callback: from inner context\")\n" +"... print(\"Leaving inner context\")\n" +"... print(\"Leaving outer context\")\n" +"...\n" +"Leaving inner context\n" +"Callback: from inner context\n" +"Callback: from outer context\n" +"Leaving outer context" msgstr "" msgid "" @@ -710,3 +1233,18 @@ msgid "" "Using separate :class:`ExitStack` instances instead of reusing a single " "instance avoids that problem::" msgstr "" + +msgid "" +">>> from contextlib import ExitStack\n" +">>> with ExitStack() as outer_stack:\n" +"... outer_stack.callback(print, \"Callback: from outer context\")\n" +"... with ExitStack() as inner_stack:\n" +"... inner_stack.callback(print, \"Callback: from inner context\")\n" +"... print(\"Leaving inner context\")\n" +"... print(\"Leaving outer context\")\n" +"...\n" +"Leaving inner context\n" +"Callback: from inner context\n" +"Leaving outer context\n" +"Callback: from outer context" +msgstr "" diff --git a/library/contextvars.po b/library/contextvars.po index 4d002c7550..6348f12361 100644 --- a/library/contextvars.po +++ b/library/contextvars.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 00:57+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,9 +35,9 @@ msgid "" msgstr "" msgid "" -"Context managers that have state should use Context Variables instead of :" -"func:`threading.local` to prevent their state from bleeding to other code " -"unexpectedly, when used in concurrent code." +"Context managers that have state should use Context Variables instead " +"of :func:`threading.local` to prevent their state from bleeding to other " +"code unexpectedly, when used in concurrent code." msgstr "" msgid "See also :pep:`567` for additional details." @@ -58,9 +57,9 @@ msgid "" msgstr "" msgid "" -"The optional keyword-only *default* parameter is returned by :meth:" -"`ContextVar.get` when no value for the variable is found in the current " -"context." +"The optional keyword-only *default* parameter is returned " +"by :meth:`ContextVar.get` when no value for the variable is found in the " +"current context." msgstr "" msgid "" @@ -70,6 +69,11 @@ msgid "" "garbage collected." msgstr "" +msgid "" +":class:`!ContextVar`\\s are :ref:`generic ` over the type of their " +"contained value." +msgstr "" + msgid "The name of the variable. This is a read-only property." msgstr "" @@ -107,8 +111,8 @@ msgid "" msgstr "" msgid "" -"Reset the context variable to the value it had before the :meth:`ContextVar." -"set` that created the *token* was used." +"Reset the context variable to the value it had before " +"the :meth:`ContextVar.set` that created the *token* was used." msgstr "" msgid "For example::" @@ -125,10 +129,19 @@ msgid "" "# var.get() would raise a LookupError." msgstr "" +msgid "The same *token* cannot be used twice." +msgstr "" + msgid "" "*Token* objects are returned by the :meth:`ContextVar.set` method. They can " "be passed to the :meth:`ContextVar.reset` method to revert the value of the " -"variable to what it was before the corresponding *set*." +"variable to what it was before the corresponding *set*. A single token " +"cannot reset a context variable more than once." +msgstr "" + +msgid "" +"Tokens are :ref:`generic ` over the same type as " +"the :class:`ContextVar` which created them." msgstr "" msgid "" @@ -137,9 +150,9 @@ msgid "" msgstr "" msgid "" -"A read-only property. Set to the value the variable had before the :meth:" -"`ContextVar.set` method call that created the token. It points to :attr:" -"`Token.MISSING` if the variable was not set before the call." +"A read-only property. Set to the value the variable had before " +"the :meth:`ContextVar.set` method call that created the token. It points " +"to :attr:`Token.MISSING` if the variable was not set before the call." msgstr "" msgid "A marker object used by :attr:`Token.old_value`." @@ -176,9 +189,9 @@ msgid "" msgstr "" msgid "" -"Each thread has its own effective stack of :class:`!Context` objects. The :" -"term:`current context` is the :class:`!Context` object at the top of the " -"current thread's stack. All :class:`!Context` objects in the stacks are " +"Each thread has its own effective stack of :class:`!Context` objects. " +"The :term:`current context` is the :class:`!Context` object at the top of " +"the current thread's stack. All :class:`!Context` objects in the stacks are " "considered to be *entered*." msgstr "" diff --git a/library/copy.po b/library/copy.po index 29880dd437..17672e9c29 100644 --- a/library/copy.po +++ b/library/copy.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!copy` --- Shallow and deep copy operations" msgstr "" msgid "**Source code:** :source:`Lib/copy.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/copy.py`" msgid "" "Assignment statements in Python do not copy objects, they create bindings " @@ -103,14 +102,18 @@ msgid "" "This module does not copy types like module, method, stack trace, stack " "frame, file, socket, window, or any similar types. It does \"copy\" " "functions and classes (shallow and deeply), by returning the original object " -"unchanged; this is compatible with the way these are treated by the :mod:" -"`pickle` module." +"unchanged; this is compatible with the way these are treated by " +"the :mod:`pickle` module." msgstr "" msgid "" -"Shallow copies of dictionaries can be made using :meth:`dict.copy`, and of " -"lists by assigning a slice of the entire list, for example, ``copied_list = " -"original_list[:]``." +"Shallow copies of many collections can be made using the " +"corresponding :meth:`!copy` method (such " +"as :meth:`list.copy`, :meth:`dict.copy` or :meth:`set.copy`), and of " +"sequences (such as lists or bytearrays) by making a slice of the entire " +"sequence (``sequence[:]``). However, these methods and slicing can create an " +"instance of the base type when copying an instance of a subclass, " +"whereas :func:`copy.copy` normally returns an instance of the same type." msgstr "" msgid "" @@ -139,10 +142,10 @@ msgid "" msgstr "" msgid "" -"Function :func:`!copy.replace` is more limited than :func:`~copy.copy` and :" -"func:`~copy.deepcopy`, and only supports named tuples created by :func:" -"`~collections.namedtuple`, :mod:`dataclasses`, and other classes which " -"define method :meth:`~object.__replace__`." +"Function :func:`!copy.replace` is more limited than :func:`~copy.copy` " +"and :func:`~copy.deepcopy`, and only supports named tuples created " +"by :func:`~collections.namedtuple`, :mod:`dataclasses`, and other classes " +"which define method :meth:`~object.__replace__`." msgstr "" msgid "" diff --git a/library/copyreg.po b/library/copyreg.po index 727285372c..39b453106c 100644 --- a/library/copyreg.po +++ b/library/copyreg.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!copyreg` --- Register :mod:`!pickle` support functions" msgstr "" msgid "**Source code:** :source:`Lib/copyreg.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/copyreg.py`" msgid "" "The :mod:`copyreg` module offers a way to define functions used while " @@ -46,8 +45,9 @@ msgstr "" msgid "" "Declares that *function* should be used as a \"reduction\" function for " "objects of type *type*. *function* must return either a string or a tuple " -"containing between two and six elements. See the :attr:`~pickle.Pickler." -"dispatch_table` for more details on the interface of *function*." +"containing between two and six elements. See " +"the :attr:`~pickle.Pickler.dispatch_table` for more details on the interface " +"of *function*." msgstr "" msgid "" diff --git a/library/csv.po b/library/csv.po index fa41ffd9fe..e65252b41f 100644 --- a/library/csv.po +++ b/library/csv.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!csv` --- CSV File Reading and Writing" msgstr "" msgid "**Source code:** :source:`Lib/csv.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/csv.py`" msgid "" "The so-called CSV (Comma Separated Values) format is the most common import " @@ -86,9 +85,9 @@ msgstr "" msgid "" "Each row read from the csv file is returned as a list of strings. No " -"automatic data type conversion is performed unless the ``QUOTE_NONNUMERIC`` " -"format option is specified (in which case unquoted fields are transformed " -"into floats)." +"automatic data type conversion is performed unless " +"the :data:`QUOTE_NONNUMERIC` format option is specified (in which case " +"unquoted fields are transformed into floats)." msgstr "" msgid "A short usage example::" @@ -104,18 +103,26 @@ msgid "" "Spam, Lovely Spam, Wonderful Spam" msgstr "" +msgid "where :file:`eggs.csv` contains:" +msgstr "" + +msgid "" +"Spam Spam Spam Spam Spam |Baked Beans|\n" +"Spam |Lovely Spam| |Wonderful Spam|" +msgstr "" + msgid "" "Return a writer object responsible for converting the user's data into " "delimited strings on the given file-like object. *csvfile* can be any " "object with a :meth:`~io.TextIOBase.write` method. If *csvfile* is a file " "object, it should be opened with ``newline=''`` [1]_. An optional *dialect* " "parameter can be given which is used to define a set of parameters specific " -"to a particular CSV dialect. It may be an instance of a subclass of the :" -"class:`Dialect` class or one of the strings returned by the :func:" -"`list_dialects` function. The other optional *fmtparams* keyword arguments " -"can be given to override individual formatting parameters in the current " -"dialect. For full details about dialects and formatting parameters, see " -"the :ref:`csv-fmt-params` section. To make it as easy as possible to " +"to a particular CSV dialect. It may be an instance of a subclass of " +"the :class:`Dialect` class or one of the strings returned by " +"the :func:`list_dialects` function. The other optional *fmtparams* keyword " +"arguments can be given to override individual formatting parameters in the " +"current dialect. For full details about dialects and formatting parameters, " +"see the :ref:`csv-fmt-params` section. To make it as easy as possible to " "interface with modules which implement the DB API, the value :const:`None` " "is written as the empty string. While this isn't a reversible " "transformation, it makes it easier to dump SQL NULL data values to CSV files " @@ -132,6 +139,9 @@ msgid "" " spamwriter.writerow(['Spam', 'Lovely Spam', 'Wonderful Spam'])" msgstr "" +msgid "which writes :file:`eggs.csv` containing:" +msgstr "" + msgid "" "Associate *dialect* with *name*. *name* must be a string. The dialect can " "be specified either by passing a sub-class of :class:`Dialect`, or by " @@ -141,8 +151,8 @@ msgid "" msgstr "" msgid "" -"Delete the dialect associated with *name* from the dialect registry. An :" -"exc:`Error` is raised if *name* is not a registered dialect name." +"Delete the dialect associated with *name* from the dialect registry. " +"An :exc:`Error` is raised if *name* is not a registered dialect name." msgstr "" msgid "" @@ -186,8 +196,8 @@ msgid "" msgstr "" msgid "" -"All other optional or keyword arguments are passed to the underlying :class:" -"`reader` instance." +"All other optional or keyword arguments are passed to the " +"underlying :class:`reader` instance." msgstr "" msgid "" @@ -215,6 +225,15 @@ msgid "" "{'first_name': 'John', 'last_name': 'Cleese'}" msgstr "" +msgid "where :file:`names.csv` contains:" +msgstr "" + +msgid "" +"first_name,last_name\n" +"Eric,Idle\n" +"John,Cleese" +msgstr "" + msgid "" "Create an object which operates like a regular writer but maps dictionaries " "onto output rows. The *fieldnames* parameter is a :mod:`sequence " @@ -224,10 +243,10 @@ msgid "" "written if the dictionary is missing a key in *fieldnames*. If the " "dictionary passed to the :meth:`~csvwriter.writerow` method contains a key " "not found in *fieldnames*, the optional *extrasaction* parameter indicates " -"what action to take. If it is set to ``'raise'``, the default value, a :exc:" -"`ValueError` is raised. If it is set to ``'ignore'``, extra values in the " -"dictionary are ignored. Any other optional or keyword arguments are passed " -"to the underlying :class:`writer` instance." +"what action to take. If it is set to ``'raise'``, the default value, " +"a :exc:`ValueError` is raised. If it is set to ``'ignore'``, extra values in " +"the dictionary are ignored. Any other optional or keyword arguments are " +"passed to the underlying :class:`writer` instance." msgstr "" msgid "" @@ -248,12 +267,22 @@ msgid "" " writer.writerow({'first_name': 'Wonderful', 'last_name': 'Spam'})" msgstr "" +msgid "which writes :file:`names.csv` containing:" +msgstr "" + +msgid "" +"first_name,last_name\n" +"Baked,Beans\n" +"Lovely,Spam\n" +"Wonderful,Spam" +msgstr "" + msgid "" "The :class:`Dialect` class is a container class whose attributes contain " "information for how to handle doublequotes, whitespace, delimiters, etc. Due " "to the lack of a strict CSV specification, different applications produce " -"subtly different CSV data. :class:`Dialect` instances define how :class:" -"`reader` and :class:`writer` instances behave." +"subtly different CSV data. :class:`Dialect` instances define " +"how :class:`reader` and :class:`writer` instances behave." msgstr "" msgid "" @@ -299,10 +328,17 @@ msgid "" msgstr "" msgid "" -"Analyze the sample text (presumed to be in CSV format) and return :const:" -"`True` if the first row appears to be a series of column headers. Inspecting " -"each column, one of two key criteria will be considered to estimate if the " -"sample contains a header:" +"If several delimiters fit the sample equally well --- for example if both " +"``','`` and ``';'`` split every row consistently --- the delimiters listed " +"in the :attr:`~Sniffer.preferred` attribute are preferred, in that order, no " +"matter how many times each of them occurs." +msgstr "" + +msgid "" +"Analyze the sample text (presumed to be in CSV format) and " +"return :const:`True` if the first row appears to be a series of column " +"headers. Inspecting each column, one of two key criteria will be considered " +"to estimate if the sample contains a header:" msgstr "" msgid "the second through n-th rows contain numeric values" @@ -314,8 +350,8 @@ msgid "" msgstr "" msgid "" -"Twenty rows after the first row are sampled; if more than half of columns + " -"rows meet the criteria, :const:`True` is returned." +"Twenty-one rows after the header are sampled; if more than half of the " +"columns + rows meet the criteria, :const:`True` is returned." msgstr "" msgid "" @@ -323,6 +359,15 @@ msgid "" "negatives." msgstr "" +msgid "The :class:`Sniffer` class has the following attribute:" +msgstr "" + +msgid "" +"The list of the delimiters preferred for breaking ties, in the order of " +"preference. It can be modified. Its initial value is ``[',', '\\t', ';', ' " +"', ':']``." +msgstr "" + msgid "An example for :class:`Sniffer` use::" msgstr "" @@ -342,23 +387,34 @@ msgstr "" msgid "" "Instructs :class:`writer` objects to only quote those fields which contain " -"special characters such as *delimiter*, *quotechar* or any of the characters " -"in *lineterminator*." +"special characters such as *delimiter*, *quotechar*, ``'\\r'``, ``'\\n'`` or " +"any of the characters in *lineterminator*. If *doublequote* " +"is :const:`False` and *escapechar* is set, the *quotechar* is escaped " +"instead of causing the field to be quoted." msgstr "" msgid "Instructs :class:`writer` objects to quote all non-numeric fields." msgstr "" msgid "" -"Instructs :class:`reader` objects to convert all non-quoted fields to type " -"*float*." +"Instructs :class:`reader` objects to convert all non-quoted fields to " +"type :class:`float`." msgstr "" msgid "" -"Instructs :class:`writer` objects to never quote fields. When the current " -"*delimiter* occurs in output data it is preceded by the current *escapechar* " -"character. If *escapechar* is not set, the writer will raise :exc:`Error` " -"if any characters that require escaping are encountered." +"Some numeric types, such as :class:`bool`, :class:`~fractions.Fraction`, " +"or :class:`~enum.IntEnum`, have a string representation that cannot be " +"converted to :class:`float`. They cannot be read in " +"the :data:`QUOTE_NONNUMERIC` and :data:`QUOTE_STRINGS` modes." +msgstr "" + +msgid "" +"Instructs :class:`writer` objects to never quote fields. When the current " +"*delimiter*, *quotechar*, *escapechar*, ``'\\r'``, ``'\\n'`` or any of the " +"characters in *lineterminator* occurs in output data it is preceded by the " +"current *escapechar* character. If *escapechar* is not set, the writer will " +"raise :exc:`Error` if any characters that require escaping are encountered. " +"Set *quotechar* to ``None`` to prevent its escaping." msgstr "" msgid "" @@ -401,12 +457,12 @@ msgid "" "To make it easier to specify the format of input and output records, " "specific formatting parameters are grouped together into dialects. A " "dialect is a subclass of the :class:`Dialect` class containing various " -"attributes describing the format of the CSV file. When creating :class:" -"`reader` or :class:`writer` objects, the programmer can specify a string or " -"a subclass of the :class:`Dialect` class as the dialect parameter. In " -"addition to, or instead of, the *dialect* parameter, the programmer can also " -"specify individual formatting parameters, which have the same names as the " -"attributes defined below for the :class:`Dialect` class." +"attributes describing the format of the CSV file. When " +"creating :class:`reader` or :class:`writer` objects, the programmer can " +"specify a string or a subclass of the :class:`Dialect` class as the dialect " +"parameter. In addition to, or instead of, the *dialect* parameter, the " +"programmer can also specify individual formatting parameters, which have the " +"same names as the attributes defined below for the :class:`Dialect` class." msgstr "" msgid "Dialects support the following attributes:" @@ -418,22 +474,40 @@ msgstr "" msgid "" "Controls how instances of *quotechar* appearing inside a field should " -"themselves be quoted. When :const:`True`, the character is doubled. When :" -"const:`False`, the *escapechar* is used as a prefix to the *quotechar*. It " -"defaults to :const:`True`." +"themselves be quoted. When :const:`True`, the character is doubled. " +"When :const:`False`, the *escapechar* is used as a prefix to the " +"*quotechar*. It defaults to :const:`True`." +msgstr "" + +msgid "" +"On output, if *doublequote* is :const:`False` and no *escapechar* is " +"set, :exc:`Error` is raised if a *quotechar* is found in a field." +msgstr "" + +msgid "" +"A one-character string used by the writer to escape characters that require " +"escaping:" +msgstr "" + +msgid "" +"the *delimiter*, the *quotechar*, ``'\\r'``, ``'\\n'`` and any of the " +"characters in *lineterminator* are escaped if *quoting* is set " +"to :const:`QUOTE_NONE`;" +msgstr "" + +msgid "the *quotechar* is escaped if *doublequote* is :const:`False`;" +msgstr "" + +msgid "the *escapechar* itself." msgstr "" msgid "" -"On output, if *doublequote* is :const:`False` and no *escapechar* is set, :" -"exc:`Error` is raised if a *quotechar* is found in a field." +"On reading, the *escapechar* removes any special meaning from the following " +"character. It defaults to :const:`None`, which disables escaping." msgstr "" msgid "" -"A one-character string used by the writer to escape the *delimiter* if " -"*quoting* is set to :const:`QUOTE_NONE` and the *quotechar* if *doublequote* " -"is :const:`False`. On reading, the *escapechar* removes any special meaning " -"from the following character. It defaults to :const:`None`, which disables " -"escaping." +"Previously the *escapechar* itself was not escaped, which lost it on reading." msgstr "" msgid "An empty *escapechar* is not allowed." @@ -452,8 +526,10 @@ msgstr "" msgid "" "A one-character string used to quote fields containing special characters, " -"such as the *delimiter* or *quotechar*, or which contain new-line " -"characters. It defaults to ``'\"'``." +"such as the *delimiter* or the *quotechar*, or which contain new-line " +"characters (``'\\r'``, ``'\\n'`` or any of the characters in " +"*lineterminator*). It defaults to ``'\"'``. Can be set to ``None`` to " +"prevent escaping ``'\"'`` if *quoting* is set to :const:`QUOTE_NONE`." msgstr "" msgid "An empty *quotechar* is not allowed." @@ -462,12 +538,14 @@ msgstr "" msgid "" "Controls when quotes should be generated by the writer and recognised by the " "reader. It can take on any of the :ref:`QUOTE_\\* constants ` and defaults to :const:`QUOTE_MINIMAL`." +"constants>` and defaults to :const:`QUOTE_MINIMAL` if *quotechar* is not " +"``None``, and :const:`QUOTE_NONE` otherwise." msgstr "" msgid "" "When :const:`True`, spaces immediately following the *delimiter* are " -"ignored. The default is :const:`False`." +"ignored. The default is :const:`False`. When combining ``delimiter=' '`` " +"with ``skipinitialspace=True``, unquoted empty fields are not allowed." msgstr "" msgid "" @@ -479,8 +557,8 @@ msgid "Reader Objects" msgstr "" msgid "" -"Reader objects (:class:`DictReader` instances and objects returned by the :" -"func:`reader` function) have the following public methods:" +"Reader objects (:class:`DictReader` instances and objects returned by " +"the :func:`reader` function) have the following public methods:" msgstr "" msgid "" @@ -554,8 +632,8 @@ msgid "" msgstr "" msgid "" -":meth:`writeheader` now also returns the value returned by the :meth:" -"`csvwriter.writerow` method it uses internally." +":meth:`writeheader` now also returns the value returned by " +"the :meth:`csvwriter.writerow` method it uses internally." msgstr "" msgid "Examples" @@ -595,9 +673,9 @@ msgstr "" msgid "" "Since :func:`open` is used to open a CSV file for reading, the file will by " -"default be decoded into unicode using the system default encoding (see :func:" -"`locale.getencoding`). To decode a file using a different encoding, use the " -"``encoding`` argument of open::" +"default be decoded into unicode using the system default encoding " +"(see :func:`locale.getencoding`). To decode a file using a different " +"encoding, use the ``encoding`` argument of open::" msgstr "" msgid "" @@ -637,7 +715,7 @@ msgid "" " for row in reader:\n" " print(row)\n" " except csv.Error as e:\n" -" sys.exit('file {}, line {}: {}'.format(filename, reader.line_num, e))" +" sys.exit(f'file {filename}, line {reader.line_num}: {e}')" msgstr "" msgid "" @@ -656,10 +734,10 @@ msgstr "Przypisy" msgid "" "If ``newline=''`` is not specified, newlines embedded inside quoted fields " -"will not be interpreted correctly, and on platforms that use ``\\r\\n`` " -"linendings on write an extra ``\\r`` will be added. It should always be " -"safe to specify ``newline=''``, since the csv module does its own (:term:" -"`universal `) newline handling." +"will not be interpreted correctly, and on platforms that use ``\\r\\n`` line " +"endings on write an extra ``\\r`` will be added. It should always be safe " +"to specify ``newline=''``, since the csv module does its own " +"(:term:`universal `) newline handling." msgstr "" msgid "csv" diff --git a/library/ctypes.po b/library/ctypes.po index 94fb85af86..5e6cb7b29d 100644 --- a/library/ctypes.po +++ b/library/ctypes.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!ctypes` --- A foreign function library for Python" msgstr "" msgid "**Source code:** :source:`Lib/ctypes`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/ctypes`" msgid "" ":mod:`ctypes` is a foreign function library for Python. It provides C " @@ -36,6 +35,14 @@ msgid "" "libraries. It can be used to wrap these libraries in pure Python." msgstr "" +msgid "" +":mod:`!ctypes` provides low-level access to native libraries and the " +"process's memory, bypassing Python's safety mechanisms and allowing " +"execution of arbitrary native code. Incorrect use can corrupt data and " +"objects, reveal sensitive information, cause crashes, or otherwise " +"compromise the running process." +msgstr "" + msgid "ctypes tutorial" msgstr "" @@ -47,9 +54,10 @@ msgstr "" msgid "" "Note: Some code samples reference the ctypes :class:`c_int` type. On " -"platforms where ``sizeof(long) == sizeof(int)`` it is an alias to :class:" -"`c_long`. So, you should not be confused if :class:`c_long` is printed if " -"you would expect :class:`c_int` --- they are actually the same type." +"platforms where ``sizeof(long) == sizeof(int)`` it is an alias " +"to :class:`c_long`. So, you should not be confused if :class:`c_long` is " +"printed if you would expect :class:`c_int` --- they are actually the same " +"type." msgstr "" msgid "Loading dynamic link libraries" @@ -71,8 +79,8 @@ msgid "" msgstr "" msgid "" -"Windows errors used to raise :exc:`WindowsError`, which is now an alias of :" -"exc:`OSError`." +"Windows errors used to raise :exc:`WindowsError`, which is now an alias " +"of :exc:`OSError`." msgstr "" msgid "" @@ -163,8 +171,8 @@ msgstr "" msgid "" "Sometimes, dlls export functions with names which aren't valid Python " -"identifiers, like ``\"??2@YAPAXI@Z\"``. In this case you have to use :func:" -"`getattr` to retrieve the function::" +"identifiers, like ``\"??2@YAPAXI@Z\"``. In this case you have to " +"use :func:`getattr` to retrieve the function::" msgstr "" msgid "" @@ -258,20 +266,18 @@ msgid "" msgstr "" msgid "" -"There are, however, enough ways to crash Python with :mod:`ctypes`, so you " -"should be careful anyway. The :mod:`faulthandler` module can be helpful in " -"debugging crashes (e.g. from segmentation faults produced by erroneous C " -"library calls)." +"The :mod:`faulthandler` module can help debug crashes, such as segmentation " +"faults produced by erroneous C library calls." msgstr "" msgid "" "``None``, integers, bytes objects and (unicode) strings are the only native " "Python objects that can directly be used as parameters in these function " "calls. ``None`` is passed as a C ``NULL`` pointer, bytes objects and strings " -"are passed as pointer to the memory block that contains their data (:c:expr:" -"`char *` or :c:expr:`wchar_t *`). Python integers are passed as the " -"platform's default C :c:expr:`int` type, their value is masked to fit into " -"the C type." +"are passed as pointer to the memory block that contains their data " +"(:c:expr:`char *` or :c:expr:`wchar_t *`). Python integers are passed as " +"the platform's default C :c:expr:`int` type, their value is masked to fit " +"into the C type." msgstr "" msgid "" @@ -331,7 +337,7 @@ msgid ":class:`c_ubyte`" msgstr ":class:`c_ubyte`" msgid ":c:expr:`unsigned char`" -msgstr "" +msgstr ":c:expr:`unsigned char`" msgid ":class:`c_short`" msgstr ":class:`c_short`" @@ -343,7 +349,7 @@ msgid ":class:`c_ushort`" msgstr ":class:`c_ushort`" msgid ":c:expr:`unsigned short`" -msgstr "" +msgstr ":c:expr:`unsigned short`" msgid ":class:`c_int`" msgstr ":class:`c_int`" @@ -351,10 +357,58 @@ msgstr ":class:`c_int`" msgid ":c:expr:`int`" msgstr ":c:expr:`int`" +msgid ":class:`c_int8`" +msgstr "" + +msgid ":c:type:`int8_t`" +msgstr "" + +msgid ":class:`c_int16`" +msgstr "" + +msgid ":c:type:`int16_t`" +msgstr "" + +msgid ":class:`c_int32`" +msgstr "" + +msgid ":c:type:`int32_t`" +msgstr "" + +msgid ":class:`c_int64`" +msgstr "" + +msgid ":c:type:`int64_t`" +msgstr "" + msgid ":class:`c_uint`" msgstr ":class:`c_uint`" msgid ":c:expr:`unsigned int`" +msgstr ":c:expr:`unsigned int`" + +msgid ":class:`c_uint8`" +msgstr "" + +msgid ":c:type:`uint8_t`" +msgstr "" + +msgid ":class:`c_uint16`" +msgstr "" + +msgid ":c:type:`uint16_t`" +msgstr "" + +msgid ":class:`c_uint32`" +msgstr "" + +msgid ":c:type:`uint32_t`" +msgstr "" + +msgid ":class:`c_uint64`" +msgstr "" + +msgid ":c:type:`uint64_t`" msgstr "" msgid ":class:`c_long`" @@ -367,7 +421,7 @@ msgid ":class:`c_ulong`" msgstr ":class:`c_ulong`" msgid ":c:expr:`unsigned long`" -msgstr "" +msgstr ":c:expr:`unsigned long`" msgid ":class:`c_longlong`" msgstr ":class:`c_longlong`" @@ -418,7 +472,7 @@ msgid ":class:`c_longdouble`" msgstr ":class:`c_longdouble`" msgid ":c:expr:`long double`" -msgstr "" +msgstr ":c:expr:`long double`" msgid ":class:`c_char_p`" msgstr ":class:`c_char_p`" @@ -442,7 +496,7 @@ msgid ":class:`c_void_p`" msgstr ":class:`c_void_p`" msgid ":c:expr:`void *`" -msgstr "" +msgstr ":c:expr:`void *`" msgid "int or ``None``" msgstr "" @@ -489,10 +543,10 @@ msgid "" msgstr "" msgid "" -"Assigning a new value to instances of the pointer types :class:`c_char_p`, :" -"class:`c_wchar_p`, and :class:`c_void_p` changes the *memory location* they " -"point to, *not the contents* of the memory block (of course not, because " -"Python string objects are immutable)::" +"Assigning a new value to instances of the pointer " +"types :class:`c_char_p`, :class:`c_wchar_p`, and :class:`c_void_p` changes " +"the *memory location* they point to, *not the contents* of the memory block " +"(of course not, because Python string objects are immutable)::" msgstr "" msgid "" @@ -514,11 +568,11 @@ msgstr "" msgid "" "You should be careful, however, not to pass them to functions expecting " -"pointers to mutable memory. If you need mutable memory blocks, ctypes has a :" -"func:`create_string_buffer` function which creates these in various ways. " -"The current memory block contents can be accessed (or changed) with the " -"``raw`` property; if you want to access it as NUL terminated string, use the " -"``value`` property::" +"pointers to mutable memory. If you need mutable memory blocks, ctypes has " +"a :func:`create_string_buffer` function which creates these in various " +"ways. The current memory block contents can be accessed (or changed) with " +"the ``raw`` property; if you want to access it as NUL terminated string, use " +"the ``value`` property::" msgstr "" msgid "" @@ -553,9 +607,9 @@ msgid "Calling functions, continued" msgstr "" msgid "" -"Note that printf prints to the real standard output channel, *not* to :data:" -"`sys.stdout`, so these examples will only work at the console prompt, not " -"from within *IDLE* or *PythonWin*::" +"Note that printf prints to the real standard output channel, *not* " +"to :data:`sys.stdout`, so these examples will only work at the console " +"prompt, not from within *IDLE* or *PythonWin*::" msgstr "" msgid "" @@ -639,8 +693,8 @@ msgstr "" msgid "" "If you don't want to store the instance's data in the :attr:`!" -"_as_parameter_` instance variable, you could define a :class:`property` " -"which makes the attribute available on request." +"_as_parameter_` instance variable, you could define a :deco:`property` which " +"makes the attribute available on request." msgstr "" msgid "Specifying the required argument types (function prototypes)" @@ -688,13 +742,13 @@ msgstr "" msgid "" "If you have defined your own classes which you pass to function calls, you " "have to implement a :meth:`~_CData.from_param` class method for them to be " -"able to use them in the :attr:`~_CFuncPtr.argtypes` sequence. The :meth:" -"`~_CData.from_param` class method receives the Python object passed to the " -"function call, it should do a typecheck or whatever is needed to make sure " -"this object is acceptable, and then return the object itself, its :attr:`!" -"_as_parameter_` attribute, or whatever you want to pass as the C function " -"argument in this case. Again, the result should be an integer, string, " -"bytes, a :mod:`ctypes` instance, or an object with an :attr:`!" +"able to use them in the :attr:`~_CFuncPtr.argtypes` sequence. " +"The :meth:`~_CData.from_param` class method receives the Python object " +"passed to the function call, it should do a typecheck or whatever is needed " +"to make sure this object is acceptable, and then return the object itself, " +"its :attr:`!_as_parameter_` attribute, or whatever you want to pass as the C " +"function argument in this case. Again, the result should be an integer, " +"string, bytes, a :mod:`ctypes` instance, or an object with an :attr:`!" "_as_parameter_` attribute." msgstr "" @@ -708,9 +762,10 @@ msgid "" msgstr "" msgid "" -"The C prototype of :c:func:`time` is ``time_t time(time_t *)``. Because :c:" -"type:`time_t` might be of a different type than the default return type :c:" -"expr:`int`, you should specify the :attr:`!restype` attribute::" +"The C prototype of :c:func:`time` is ``time_t time(time_t *)``. " +"Because :c:type:`time_t` might be of a different type than the default " +"return type :c:expr:`int`, you should specify the :attr:`!restype` " +"attribute::" msgstr "" msgid ">>> libc.time.restype = c_time_t" @@ -824,10 +879,10 @@ msgstr "" msgid "" ":mod:`ctypes` exports the :func:`byref` function which is used to pass " -"parameters by reference. The same effect can be achieved with the :func:" -"`pointer` function, although :func:`pointer` does a lot more work since it " -"constructs a real pointer object, so it is faster to use :func:`byref` if " -"you don't need the pointer object in Python itself::" +"parameters by reference. The same effect can be achieved with " +"the :func:`pointer` function, although :func:`pointer` does a lot more work " +"since it constructs a real pointer object, so it is faster to " +"use :func:`byref` if you don't need the pointer object in Python itself::" msgstr "" msgid "" @@ -848,11 +903,11 @@ msgid "Structures and unions" msgstr "" msgid "" -"Structures and unions must derive from the :class:`Structure` and :class:" -"`Union` base classes which are defined in the :mod:`ctypes` module. Each " -"subclass must define a :attr:`~Structure._fields_` attribute. :attr:`!" -"_fields_` must be a list of *2-tuples*, containing a *field name* and a " -"*field type*." +"Structures and unions must derive from the :class:`Structure` " +"and :class:`Union` base classes which are defined in the :mod:`ctypes` " +"module. Each subclass must define a :attr:`~Structure._fields_` " +"attribute. :attr:`!_fields_` must be a list of *2-tuples*, containing a " +"*field name* and a *field type*." msgstr "" msgid "" @@ -948,8 +1003,8 @@ msgstr "" msgid "" "By default, Structure and Union fields are aligned in the same way the C " -"compiler does it. It is possible to override this behavior by specifying a :" -"attr:`~Structure._pack_` class attribute in the subclass definition. This " +"compiler does it. It is possible to override this behavior by specifying " +"a :attr:`~Structure._pack_` class attribute in the subclass definition. This " "must be set to a positive integer and specifies the maximum alignment for " "the fields. This is what ``#pragma pack(n)`` also does in MSVC. It is also " "possible to set a minimum alignment for how the subclass itself is packed in " @@ -960,10 +1015,10 @@ msgstr "" msgid "" ":mod:`ctypes` uses the native byte order for Structures and Unions. To " -"build structures with non-native byte order, you can use one of the :class:" -"`BigEndianStructure`, :class:`LittleEndianStructure`, :class:" -"`BigEndianUnion`, and :class:`LittleEndianUnion` base classes. These " -"classes cannot contain pointer fields." +"build structures with non-native byte order, you can use one of " +"the :class:`BigEndianStructure`, :class:`LittleEndianStructure`, :class:`BigEndianUnion`, " +"and :class:`LittleEndianUnion` base classes. These classes cannot contain " +"pointer fields." msgstr "" msgid "Bit fields in structures and unions" @@ -1056,8 +1111,8 @@ msgid "Pointers" msgstr "" msgid "" -"Pointer instances are created by calling the :func:`pointer` function on a :" -"mod:`ctypes` type::" +"Pointer instances are created by calling the :func:`pointer` function on " +"a :mod:`ctypes` type::" msgstr "" msgid "" @@ -1156,6 +1211,15 @@ msgid "" "instead of a single item." msgstr "" +msgid "" +"Because pointer objects support subscription, they implicitly " +"support :term:`iteration `. Unless doing this in a controlled " +"manner, such as by manually calling :func:`next` on a :func:`pointer` " +"iterator, this will typically lead to infinite loops or crashes, because " +"ctypes has no way of knowing when to stop iteration. In other words, a " +"``pointer`` iterator will infinitely yield arbitrary memory." +msgstr "" + msgid "" "Behind the scenes, the :func:`pointer` function does more than simply create " "pointer instances, it has to create pointer *types* first. This is done with " @@ -1343,8 +1407,8 @@ msgstr "" msgid "" "because the new ``class cell`` is not available in the class statement " -"itself. In :mod:`ctypes`, we can define the ``cell`` class and set the :attr:" -"`~Structure._fields_` attribute later, after the class statement::" +"itself. In :mod:`ctypes`, we can define the ``cell`` class and set " +"the :attr:`~Structure._fields_` attribute later, after the class statement::" msgstr "" msgid "" @@ -1806,6 +1870,11 @@ msgid "" "file. It returns the filename of the library file." msgstr "" +msgid "" +"Note that if the output of these programs does not correspond to the dynamic " +"linker used by Python, the result of this function may be misleading." +msgstr "" + msgid "" "On Linux, the value of the environment variable ``LD_LIBRARY_PATH`` is used " "when searching for libraries, if a library cannot be found by any other " @@ -1875,13 +1944,14 @@ msgstr "" msgid "" "On Windows creating a :class:`CDLL` instance may fail even if the DLL name " -"exists. When a dependent DLL of the loaded DLL is not found, a :exc:" -"`OSError` error is raised with the message *\"[WinError 126] The specified " -"module could not be found\".* This error message does not contain the name " -"of the missing DLL because the Windows API does not return this information " -"making this error hard to diagnose. To resolve this error and determine " -"which DLL is not found, you need to find the list of dependent DLLs and " -"determine which one is not found using Windows debugging and tracing tools." +"exists. When a dependent DLL of the loaded DLL is not found, " +"a :exc:`OSError` error is raised with the message *\"[WinError 126] The " +"specified module could not be found\".* This error message does not contain " +"the name of the missing DLL because the Windows API does not return this " +"information making this error hard to diagnose. To resolve this error and " +"determine which DLL is not found, you need to find the list of dependent " +"DLLs and determine which one is not found using Windows debugging and " +"tracing tools." msgstr "" msgid "The *name* parameter can now be a :term:`path-like object`." @@ -1905,8 +1975,8 @@ msgid "Availability" msgstr "Dostępność" msgid "" -":exc:`WindowsError` used to be raised, which is now an alias of :exc:" -"`OSError`." +":exc:`WindowsError` used to be raised, which is now an alias " +"of :exc:`OSError`." msgstr "" msgid "" @@ -1948,11 +2018,12 @@ msgstr "" msgid "" "The *use_errno* parameter, when set to true, enables a ctypes mechanism that " -"allows accessing the system :data:`errno` error number in a safe way. :mod:" -"`ctypes` maintains a thread-local copy of the system's :data:`errno` " -"variable; if you call foreign functions created with ``use_errno=True`` then " -"the :data:`errno` value before the function call is swapped with the ctypes " -"private copy, the same happens immediately after the function call." +"allows accessing the system :data:`errno` error number in a safe " +"way. :mod:`ctypes` maintains a thread-local copy of the " +"system's :data:`errno` variable; if you call foreign functions created with " +"``use_errno=True`` then the :data:`errno` value before the function call is " +"swapped with the ctypes private copy, the same happens immediately after the " +"function call." msgstr "" msgid "" @@ -1963,10 +2034,11 @@ msgstr "" msgid "" "The *use_last_error* parameter, when set to true, enables the same mechanism " -"for the Windows error code which is managed by the :func:`GetLastError` and :" -"func:`!SetLastError` Windows API functions; :func:`ctypes.get_last_error` " -"and :func:`ctypes.set_last_error` are used to request and change the ctypes " -"private copy of the windows error code." +"for the Windows error code which is managed by the :func:`GetLastError` " +"and :func:`!SetLastError` Windows API " +"functions; :func:`ctypes.get_last_error` and :func:`ctypes.set_last_error` " +"are used to request and change the ctypes private copy of the windows error " +"code." msgstr "" msgid "" @@ -2032,8 +2104,8 @@ msgid "" msgstr "" msgid "" -"Class which loads shared libraries. *dlltype* should be one of the :class:" -"`CDLL`, :class:`PyDLL`, :class:`WinDLL`, or :class:`OleDLL` types." +"Class which loads shared libraries. *dlltype* should be one of " +"the :class:`CDLL`, :class:`PyDLL`, :class:`WinDLL`, or :class:`OleDLL` types." msgstr "" msgid "" @@ -2070,9 +2142,14 @@ msgstr "" msgid "" "An instance of :class:`PyDLL` that exposes Python C API functions as " -"attributes. Note that all these functions are assumed to return C :c:expr:" -"`int`, which is of course not always the truth, so you have to assign the " -"correct :attr:`!restype` attribute to use these functions." +"attributes. Note that all these functions are assumed to return " +"C :c:expr:`int`, which is of course not always the truth, so you have to " +"assign the correct :attr:`!restype` attribute to use these functions." +msgstr "" + +msgid "" +"Note that if the Python interpreter is statically linked, this will be " +"``None``, as ``dlopen`` is not possible in this case." msgstr "" msgid "" @@ -2082,9 +2159,9 @@ msgid "" msgstr "" msgid "" -"Accessing a function on a loaded library raises an auditing event ``ctypes." -"dlsym`` with arguments ``library`` (the library object) and ``name`` (the " -"symbol's name as a string or integer)." +"Accessing a function on a loaded library raises an auditing event " +"``ctypes.dlsym`` with arguments ``library`` (the library object) and " +"``name`` (the symbol's name as a string or integer)." msgstr "" msgid "" @@ -2154,12 +2231,12 @@ msgid "" msgstr "" msgid "" -"When a foreign function is called, each actual argument is passed to the :" -"meth:`~_CData.from_param` class method of the items in the :attr:`argtypes` " -"tuple, this method allows adapting the actual argument to an object that the " -"foreign function accepts. For example, a :class:`c_char_p` item in the :" -"attr:`argtypes` tuple will convert a string passed as argument into a bytes " -"object using ctypes conversion rules." +"When a foreign function is called, each actual argument is passed to " +"the :meth:`~_CData.from_param` class method of the items in " +"the :attr:`argtypes` tuple, this method allows adapting the actual argument " +"to an object that the foreign function accepts. For example, " +"a :class:`c_char_p` item in the :attr:`argtypes` tuple will convert a string " +"passed as argument into a bytes object using ctypes conversion rules." msgstr "" msgid "" @@ -2203,9 +2280,9 @@ msgstr "" msgid "" "On Windows, when a foreign function call raises a system exception (for " "example, due to an access violation), it will be captured and replaced with " -"a suitable Python exception. Further, an auditing event ``ctypes." -"set_exception`` with argument ``code`` will be raised, allowing an audit " -"hook to replace the exception with its own." +"a suitable Python exception. Further, an auditing event " +"``ctypes.set_exception`` with argument ``code`` will be raised, allowing an " +"audit hook to replace the exception with its own." msgstr "" msgid "" @@ -2230,9 +2307,10 @@ msgstr "" msgid "" "The returned function prototype creates functions that use the standard C " "calling convention. The function will release the GIL during the call. If " -"*use_errno* is set to true, the ctypes private copy of the system :data:" -"`errno` variable is exchanged with the real :data:`errno` value before and " -"after the call; *use_last_error* does the same for the Windows error code." +"*use_errno* is set to true, the ctypes private copy of the " +"system :data:`errno` variable is exchanged with the real :data:`errno` value " +"before and after the call; *use_last_error* does the same for the Windows " +"error code." msgstr "" msgid "" @@ -2286,8 +2364,8 @@ msgid "" msgstr "" msgid "" -"*paramflags* must be a tuple of the same length as :attr:`~_CFuncPtr." -"argtypes`." +"*paramflags* must be a tuple of the same length " +"as :attr:`~_CFuncPtr.argtypes`." msgstr "" msgid "" @@ -2481,16 +2559,46 @@ msgid "" msgstr "" msgid "" -"*init_or_size* must be an integer which specifies the size of the array, or " -"a bytes object which will be used to initialize the array items." +"If *size* is given (and not ``None``), it must be an :class:`int`. It " +"specifies the size of the returned array." msgstr "" msgid "" -"If a bytes object is specified as first argument, the buffer is made one " -"item larger than its length so that the last element in the array is a NUL " -"termination character. An integer can be passed as second argument which " -"allows specifying the size of the array if the length of the bytes should " -"not be used." +"If the *init* argument is given, it must be :class:`bytes`. It is used to " +"initialize the array items. Bytes not initialized this way are set to zero " +"(NUL)." +msgstr "" + +msgid "" +"If *size* is not given (or if it is ``None``), the buffer is made one " +"element larger than *init*, effectively adding a NUL terminator." +msgstr "" + +msgid "" +"If both arguments are given, *size* must not be less than ``len(init)``." +msgstr "" + +msgid "" +"If *size* is equal to ``len(init)``, a NUL terminator is not added. Do not " +"treat such a buffer as a C string." +msgstr "" + +msgid "For example::" +msgstr "Na przykład::" + +msgid "" +">>> bytes(create_string_buffer(2))\n" +"b'\\x00\\x00'\n" +">>> bytes(create_string_buffer(b'ab'))\n" +"b'ab\\x00'\n" +">>> bytes(create_string_buffer(b'ab', 2))\n" +"b'ab'\n" +">>> bytes(create_string_buffer(b'ab', 4))\n" +"b'ab\\x00\\x00'\n" +">>> bytes(create_string_buffer(b'abcdef', 2))\n" +"Traceback (most recent call last):\n" +" ...\n" +"ValueError: byte string too long" msgstr "" msgid "" @@ -2504,16 +2612,8 @@ msgid "" msgstr "" msgid "" -"*init_or_size* must be an integer which specifies the size of the array, or " -"a string which will be used to initialize the array items." -msgstr "" - -msgid "" -"If a string is specified as first argument, the buffer is made one item " -"larger than the length of the string so that the last element in the array " -"is a NUL termination character. An integer can be passed as second argument " -"which allows specifying the size of the array if the length of the string " -"should not be used." +"The function takes the same arguments as :func:`~create_string_buffer` " +"except *init* must be a string and *size* counts :class:`c_wchar`." msgstr "" msgid "" @@ -2540,6 +2640,9 @@ msgid "" "If no library can be found, returns ``None``." msgstr "" +msgid "See :ref:`ctypes-finding-shared-libraries` for complete documentation." +msgstr "" + msgid "" "Returns the filename of the VC runtime library used by Python, and by the " "extension modules. If the name of the library cannot be determined, " @@ -2565,8 +2668,8 @@ msgid "" msgstr "" msgid "" -"Returns the current value of the ctypes-private copy of the system :data:" -"`errno` variable in the calling thread." +"Returns the current value of the ctypes-private copy of the " +"system :data:`errno` variable in the calling thread." msgstr "" msgid "" @@ -2658,8 +2761,9 @@ msgstr "" msgid "" "This function is probably the worst-named thing in ctypes. It 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." +"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 "" @@ -2684,9 +2788,9 @@ msgstr "" msgid "" "This non-public class is the common base class of all ctypes data types. " "Among other things, all ctypes type instances contain a memory block that " -"hold C compatible data; the address of the memory block is returned by the :" -"func:`addressof` helper function. Another instance variable is exposed as :" -"attr:`_objects`; this contains other Python objects that need to be kept " +"hold C compatible data; the address of the memory block is returned by " +"the :func:`addressof` helper function. Another instance variable is exposed " +"as :attr:`_objects`; this contains other Python objects that need to be kept " "alive in case the memory block contains pointers." msgstr "" @@ -2699,8 +2803,8 @@ msgid "" "This method returns a ctypes instance that shares the buffer of the *source* " "object. The *source* object must support the writeable buffer interface. " "The optional *offset* parameter specifies an offset into the source buffer " -"in bytes; the default is zero. If the source buffer is not large enough a :" -"exc:`ValueError` is raised." +"in bytes; the default is zero. If the source buffer is not large enough " +"a :exc:`ValueError` is raised." msgstr "" msgid "" @@ -2721,8 +2825,9 @@ msgid "" msgstr "" msgid "" -"This method, and others that indirectly call this method, raises an :ref:" -"`auditing event ` ``ctypes.cdata`` with argument ``address``." +"This method, and others that indirectly call this method, raises " +"an :ref:`auditing event ` ``ctypes.cdata`` with argument " +"``address``." msgstr "" msgid "" @@ -2749,9 +2854,9 @@ msgstr "" msgid "" "Sometimes ctypes data instances do not own the memory block they contain, " -"instead they share part of the memory block of a base object. The :attr:" -"`_b_base_` read-only member is the root ctypes object that owns the memory " -"block." +"instead they share part of the memory block of a base object. " +"The :attr:`_b_base_` read-only member is the root ctypes object that owns " +"the memory block." msgstr "" msgid "" @@ -2769,8 +2874,8 @@ msgstr "" msgid "" "This non-public class is the base class of all fundamental ctypes data " "types. It is mentioned here because it contains the common attributes of the " -"fundamental ctypes data types. :class:`_SimpleCData` is a subclass of :" -"class:`_CData`, so it inherits their methods and attributes. ctypes data " +"fundamental ctypes data types. :class:`_SimpleCData` is a subclass " +"of :class:`_CData`, so it inherits their methods and attributes. ctypes data " "types that are not and do not contain pointers can now be pickled." msgstr "" @@ -2852,8 +2957,8 @@ msgid "" msgstr "" msgid "" -"Represents the C 8-bit :c:expr:`signed int` datatype. Usually an alias for :" -"class:`c_byte`." +"Represents the C 8-bit :c:expr:`signed int` datatype. It is an alias " +"for :class:`c_byte`." msgstr "" msgid "" @@ -2908,7 +3013,7 @@ msgid "" msgstr "" msgid "" -"Represents the C 8-bit :c:expr:`unsigned int` datatype. Usually an alias " +"Represents the C 8-bit :c:expr:`unsigned int` datatype. It is an alias " "for :class:`c_ubyte`." msgstr "" @@ -2977,9 +3082,9 @@ msgstr "" msgid "" "The :mod:`!ctypes.wintypes` module provides quite some other Windows " -"specific data types, for example :c:type:`!HWND`, :c:type:`!WPARAM`, or :c:" -"type:`!DWORD`. Some useful structures like :c:type:`!MSG` or :c:type:`!RECT` " -"are also defined." +"specific data types, for example :c:type:`!HWND`, :c:type:`!WPARAM`, " +"or :c:type:`!DWORD`. Some useful structures like :c:type:`!MSG` or :c:type:`!" +"RECT` are also defined." msgstr "" msgid "Structured data types" @@ -3010,9 +3115,9 @@ msgstr "" msgid "" "Concrete structure and union types must be created by subclassing one of " -"these types, and at least define a :attr:`_fields_` class variable. :mod:" -"`ctypes` will create :term:`descriptor`\\s which allow reading and writing " -"the fields by direct attribute accesses. These are the" +"these types, and at least define a :attr:`_fields_` class " +"variable. :mod:`ctypes` will create :term:`descriptor`\\s which allow " +"reading and writing the fields by direct attribute accesses. These are the" msgstr "" msgid "" @@ -3061,9 +3166,9 @@ msgstr "" msgid "" "An optional small integer that allows overriding the alignment of structure " -"fields in the instance. :attr:`_pack_` must already be defined when :attr:" -"`_fields_` is assigned, otherwise it will have no effect. Setting this " -"attribute to 0 is the same as not setting it at all." +"fields in the instance. :attr:`_pack_` must already be defined " +"when :attr:`_fields_` is assigned, otherwise it will have no effect. Setting " +"this attribute to 0 is the same as not setting it at all." msgstr "" msgid "" @@ -3073,15 +3178,15 @@ msgid "" msgstr "" msgid "" -"An optional sequence that lists the names of unnamed (anonymous) fields. :" -"attr:`_anonymous_` must be already defined when :attr:`_fields_` is " +"An optional sequence that lists the names of unnamed (anonymous) " +"fields. :attr:`_anonymous_` must be already defined when :attr:`_fields_` is " "assigned, otherwise it will have no effect." msgstr "" msgid "" -"The fields listed in this variable must be structure or union type fields. :" -"mod:`ctypes` will create descriptors in the structure type that allows " -"accessing the nested fields directly, without the need to create the " +"The fields listed in this variable must be structure or union type " +"fields. :mod:`ctypes` will create descriptors in the structure type that " +"allows accessing the nested fields directly, without the need to create the " "structure or union field." msgstr "" @@ -3118,9 +3223,9 @@ msgstr "" msgid "" "It is possible to define sub-subclasses of structures, they inherit the " -"fields of the base class. If the subclass definition has a separate :attr:" -"`_fields_` variable, the fields specified in this are appended to the fields " -"of the base class." +"fields of the base class. If the subclass definition has a " +"separate :attr:`_fields_` variable, the fields specified in this are " +"appended to the fields of the base class." msgstr "" msgid "" @@ -3139,18 +3244,21 @@ msgid "Abstract base class for arrays." msgstr "" msgid "" -"The recommended way to create concrete array types is by multiplying any :" -"mod:`ctypes` data type with a non-negative integer. Alternatively, you can " -"subclass this type and define :attr:`_length_` and :attr:`_type_` class " +"The recommended way to create concrete array types is by multiplying " +"any :mod:`ctypes` data type with a non-negative integer. Alternatively, you " +"can subclass this type and define :attr:`_length_` and :attr:`_type_` class " "variables. Array elements can be read and written using standard subscript " "and slice accesses; for slice reads, the resulting object is *not* itself " "an :class:`Array`." msgstr "" +msgid "Arrays are :ref:`generic ` over the type of their elements." +msgstr "" + msgid "" "A positive integer specifying the number of elements in the array. Out-of-" -"range subscripts result in an :exc:`IndexError`. Will be returned by :func:" -"`len`." +"range subscripts result in an :exc:`IndexError`. Will be returned " +"by :func:`len`." msgstr "" msgid "Specifies the type of each element in the array." @@ -3162,8 +3270,8 @@ msgid "" msgstr "" msgid "" -"Create an array. Equivalent to ``type * length``, where *type* is a :mod:" -"`ctypes` data type and *length* an integer." +"Create an array. Equivalent to ``type * length``, where *type* is " +"a :mod:`ctypes` data type and *length* an integer." msgstr "" msgid "" @@ -3181,10 +3289,10 @@ msgstr "" msgid "" "If a pointer points to an array, its elements can be read and written using " -"standard subscript and slice accesses. Pointer objects have no size, so :" -"func:`len` will raise :exc:`TypeError`. Negative subscripts will read from " -"the memory *before* the pointer (as in C), and out-of-range subscripts will " -"probably crash with an access violation (if you're lucky)." +"standard subscript and slice accesses. Pointer objects have no size, " +"so :func:`len` will raise :exc:`TypeError`. Negative subscripts will read " +"from the memory *before* the pointer (as in C), and out-of-range subscripts " +"will probably crash with an access violation (if you're lucky)." msgstr "" msgid "Specifies the type pointed to." diff --git a/library/curses.ascii.po b/library/curses.ascii.po index 960f9cd433..215cbd4a73 100644 --- a/library/curses.ascii.po +++ b/library/curses.ascii.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!curses.ascii` --- Utilities for ASCII characters" msgstr "" msgid "**Source code:** :source:`Lib/curses/ascii.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/curses/ascii.py`" msgid "" "The :mod:`curses.ascii` module supplies name constants for ASCII characters " @@ -170,7 +170,7 @@ msgstr "" msgid "Checks for a character value that fits in the 7-bit ASCII set." msgstr "" -msgid "Checks for an ASCII whitespace character; space or horizontal tab." +msgid "Checks for an ASCII blank character; space or horizontal tab." msgstr "" msgid "" @@ -182,7 +182,7 @@ msgid "" "equivalent to ``c in string.digits``." msgstr "" -msgid "Checks for ASCII any printable character except space." +msgid "Checks for any ASCII printable character except space." msgstr "" msgid "Checks for an ASCII lower-case character." @@ -192,7 +192,7 @@ msgid "Checks for any ASCII printable character including space." msgstr "" msgid "" -"Checks for any printable ASCII character which is not a space or an " +"Checks for any ASCII printable character which is not a space or an " "alphanumeric character." msgstr "" @@ -205,11 +205,13 @@ msgid "Checks for an ASCII uppercase letter." msgstr "" msgid "" -"Checks for an ASCII hexadecimal digit. This is equivalent to ``c in string." -"hexdigits``." +"Checks for an ASCII hexadecimal digit. This is equivalent to ``c in " +"string.hexdigits``." msgstr "" -msgid "Checks for an ASCII control character (ordinal values 0 to 31)." +msgid "" +"Checks for an ASCII control character (ordinal values 0 to 31). " +"Unlike :func:`iscntrl`, this does not include the delete character (0x7f)." msgstr "" msgid "Checks for a non-ASCII character (ordinal values 0x80 and above)." @@ -217,8 +219,8 @@ msgstr "" msgid "" "These functions accept either integers or single-character strings; when the " -"argument is a string, it is first converted using the built-in function :" -"func:`ord`." +"argument is a string, it is first converted using the built-in " +"function :func:`ord`." msgstr "" msgid "" diff --git a/library/curses.panel.po b/library/curses.panel.po index 1f93878465..f3d684c6b6 100644 --- a/library/curses.panel.po +++ b/library/curses.panel.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,17 +35,23 @@ msgstr "" msgid "Functions" msgstr "Zadania" -msgid "The module :mod:`curses.panel` defines the following functions:" +msgid "The module :mod:`!curses.panel` defines the following exception:" +msgstr "" + +msgid "Exception raised when a curses panel library function returns an error." +msgstr "" + +msgid "The module :mod:`!curses.panel` defines the following functions:" msgstr "" msgid "Returns the bottom panel in the panel stack." msgstr "" msgid "" -"Returns a panel object, associating it with the given window *win*. Be aware " -"that you need to keep the returned panel object referenced explicitly. If " -"you don't, the panel object is garbage collected and removed from the panel " -"stack." +"Returns a panel object, associating it with the given window *win* and " +"placing the new panel on top of the panel stack. Be aware that you need to " +"keep the returned panel object referenced explicitly. If you don't, the " +"panel object is garbage collected and removed from the panel stack." msgstr "" msgid "Returns the top panel in the panel stack." @@ -56,12 +62,12 @@ msgid "" "call :func:`curses.doupdate`, so you'll have to do this yourself." msgstr "" -msgid "Panel Objects" +msgid "Panel objects" msgstr "" msgid "" "Panel objects, as returned by :func:`new_panel` above, are windows with a " -"stacking order. There's always a window associated with a panel which " +"stacking order. There's always a window associated with a panel which " "determines the content, while the panel methods are responsible for the " "window's depth in the panel stack." msgstr "" @@ -98,7 +104,9 @@ msgid "" "arbitrary piece of data with the panel, and can be any Python object." msgstr "" -msgid "Display the panel (which might have been hidden)." +msgid "" +"Display the panel (which might have been hidden), placing it on top of the " +"panel stack." msgstr "" msgid "Push panel to the top of the stack." diff --git a/library/curses.po b/library/curses.po index dd0833644a..d0c4c10e0e 100644 --- a/library/curses.po +++ b/library/curses.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Stan Ulbrych, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Stan Ulbrych, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +28,7 @@ msgid ":mod:`!curses` --- Terminal handling for character-cell displays" msgstr "" msgid "**Source code:** :source:`Lib/curses`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/curses`" msgid "" "The :mod:`curses` module provides an interface to the curses library, the de-" @@ -53,7 +52,9 @@ msgstr "" msgid "" "Whenever the documentation mentions a *character* it can be specified as an " -"integer, a one-character Unicode string or a one-byte byte string." +"integer, a one-character Unicode string or a one-byte byte string. An " +"integer is the code of a single encoded byte, optionally combined with " +"attributes and a color pair, as returned by :meth:`window.inch`." msgstr "" msgid "" @@ -61,6 +62,15 @@ msgid "" "as a Unicode string or a byte string." msgstr "" +msgid "" +"Whether curses may be used from several threads depends on the underlying " +"library and how it was built. In many implementations, including the default " +"build of ncurses, the screen state is shared and not thread-safe; since the " +"blocking and refresh methods (such as :meth:`~window.getch` " +"and :meth:`~window.refresh`) release the :term:`GIL`, unsynchronized use " +"from several threads can then crash the interpreter. Serialize the calls." +msgstr "" + msgid "Module :mod:`curses.ascii`" msgstr "moduł :mod:`curses.ascii`" @@ -138,15 +148,15 @@ msgid "" "color *color_number*, which must be between ``0`` and ``COLORS - 1``. " "Return a 3-tuple, containing the R,G,B values for the given color, which " "will be between ``0`` (no component) and ``1000`` (maximum amount of " -"component)." +"component). Raise an exception if the color is not supported." msgstr "" msgid "" "Return the attribute value for displaying text in the specified color pair. " "Only the first 256 color pairs are supported. This attribute value can be " -"combined with :const:`A_STANDOUT`, :const:`A_REVERSE`, and the other :const:" -"`!A_\\*` attributes. :func:`pair_number` is the counterpart to this " -"function." +"combined with :const:`A_STANDOUT`, :const:`A_REVERSE`, and the " +"other :const:`!A_\\*` attributes. :func:`pair_number` is the counterpart to " +"this function." msgstr "" msgid "" @@ -160,15 +170,15 @@ msgstr "" msgid "" "Save the current terminal mode as the \"program\" mode, the mode when the " "running program is using curses. (Its counterpart is the \"shell\" mode, " -"for when the program is not in curses.) Subsequent calls to :func:" -"`reset_prog_mode` will restore this mode." +"for when the program is not in curses.) Subsequent calls " +"to :func:`reset_prog_mode` will restore this mode." msgstr "" msgid "" "Save the current terminal mode as the \"shell\" mode, the mode when the " "running program is not using curses. (Its counterpart is the \"program\" " -"mode, when the program is using curses capabilities.) Subsequent calls to :" -"func:`reset_shell_mode` will restore this mode." +"mode, when the program is using curses capabilities.) Subsequent calls " +"to :func:`reset_shell_mode` will restore this mode." msgstr "" msgid "Insert an *ms* millisecond pause in output." @@ -177,7 +187,7 @@ msgstr "" msgid "" "Update the physical screen. The curses library keeps two data structures, " "one representing the current physical screen contents and a virtual screen " -"representing the desired next state. The :func:`doupdate` ground updates " +"representing the desired next state. The :func:`doupdate` function updates " "the physical screen to match the virtual screen." msgstr "" @@ -187,8 +197,8 @@ msgid "" "a window. The normal :meth:`~window.refresh` call is simply :meth:`!" "noutrefresh` followed by :func:`!doupdate`; if you have to update multiple " "windows, you can speed performance and perhaps reduce screen flicker by " -"issuing :meth:`!noutrefresh` calls on all windows, followed by a single :" -"func:`!doupdate`." +"issuing :meth:`!noutrefresh` calls on all windows, followed by a " +"single :func:`!doupdate`." msgstr "" msgid "" @@ -207,12 +217,12 @@ msgstr "" msgid "" "The :func:`.filter` routine, if used, must be called before :func:`initscr` " -"is called. The effect is that, during those calls, :envvar:`LINES` is set " -"to ``1``; the capabilities ``clear``, ``cup``, ``cud``, ``cud1``, ``cuu1``, " -"``cuu``, ``vpa`` are disabled; and the ``home`` string is set to the value " -"of ``cr``. The effect is that the cursor is confined to the current line, " -"and so are screen updates. This may be used for enabling character-at-a-" -"time line editing without touching the rest of the screen." +"is called. The effect is that, during the initialization, :envvar:`LINES` " +"is set to ``1``; the capabilities ``clear``, ``cup``, ``cud``, ``cud1``, " +"``cuu1``, ``cuu``, ``vpa`` are disabled; and the ``home`` string is set to " +"the value of ``cr``. The effect is that the cursor is confined to the " +"current line, and so are screen updates. This may be used for enabling " +"character-at-a-time line editing without touching the rest of the screen." msgstr "" msgid "" @@ -234,10 +244,8 @@ msgid "" "coordinates. (*z* is currently unused.) *bstate* is an integer value whose " "bits will be set to indicate the type of event, and will be the bitwise OR " "of one or more of the following constants, where *n* is the button number " -"from 1 to 5: :const:`BUTTONn_PRESSED`, :const:`BUTTONn_RELEASED`, :const:" -"`BUTTONn_CLICKED`, :const:`BUTTONn_DOUBLE_CLICKED`, :const:" -"`BUTTONn_TRIPLE_CLICKED`, :const:`BUTTON_SHIFT`, :const:`BUTTON_CTRL`, :" -"const:`BUTTON_ALT`." +"from 1 to " +"5: :const:`BUTTONn_PRESSED`, :const:`BUTTONn_RELEASED`, :const:`BUTTONn_CLICKED`, :const:`BUTTONn_DOUBLE_CLICKED`, :const:`BUTTONn_TRIPLE_CLICKED`, :const:`BUTTON_SHIFT`, :const:`BUTTON_CTRL`, :const:`BUTTON_ALT`." msgstr "" msgid "" @@ -252,9 +260,10 @@ msgid "" msgstr "" msgid "" -"Read window related data stored in the file by an earlier :func:`window." -"putwin` call. The routine then creates and initializes a new window using " -"that data, returning the new window object." +"Read window-related data stored in the file by an " +"earlier :meth:`window.putwin` call. The routine then creates and initializes " +"a new window using that data, returning the new window object. The *file* " +"argument must be a file object opened for reading in binary mode." msgstr "" msgid "" @@ -265,7 +274,7 @@ msgstr "" msgid "" "Return ``True`` if the module supports extended colors; otherwise, return " "``False``. Extended color support allows more than 256 color pairs for " -"terminals that support more than 16 colors (e.g. xterm-256color)." +"terminals that support more than 16 colors (for example, xterm-256color)." msgstr "" msgid "Extended color support requires ncurses version 6.1 or later." @@ -325,11 +334,21 @@ msgid "" "object which represents the whole screen." msgstr "" +msgid "" +"See :func:`setupterm` for a caveat about calling it before this function." +msgstr "" + msgid "" "If there is an error opening the terminal, the underlying curses library may " "cause the interpreter to exit." msgstr "" +msgid "" +"If *flag* is ``True``, pressing an interrupt key (interrupt, break, or quit) " +"will flush all output in the terminal driver queue. If *flag* is ``False``, " +"no flushing is done." +msgstr "" + msgid "" "Return ``True`` if :func:`resize_term` would modify the window structure, " "``False`` otherwise." @@ -350,6 +369,9 @@ msgid "" "character." msgstr "" +msgid "Raise a :exc:`ValueError` if *k* is negative." +msgstr "" + msgid "" "Return the user's current line kill character as a one-byte bytes object. " "Under Unix operating systems this is a property of the controlling tty of " @@ -370,16 +392,17 @@ msgstr "" msgid "" "Set the maximum time in milliseconds that can elapse between press and " "release events in order for them to be recognized as a click, and return the " -"previous interval value. The default value is 200 milliseconds, or one " -"fifth of a second." +"previous interval value. The default value is 166 milliseconds, or one " +"sixth of a second. Use a negative *interval* to obtain the interval value " +"without changing it." msgstr "" msgid "" "Set the mouse events to be reported, and return a tuple ``(availmask, " "oldmask)``. *availmask* indicates which of the specified mouse events can " "be reported; on complete failure it returns ``0``. *oldmask* is the " -"previous value of the given window's mouse event mask. If this function is " -"never called, no mouse events are ever reported." +"previous value of the mouse event mask. If this function is never called, " +"no mouse events are ever reported." msgstr "" msgid "Sleep for *ms* milliseconds." @@ -395,14 +418,14 @@ msgid "" "and is not necessarily associated with a particular part of the screen. " "Pads can be used when a large window is needed, and only a part of the " "window will be on the screen at one time. Automatic refreshes of pads (such " -"as from scrolling or echoing of input) do not occur. The :meth:`~window." -"refresh` and :meth:`~window.noutrefresh` methods of a pad require 6 " -"arguments to specify the part of the pad to be displayed and the location on " -"the screen to be used for the display. The arguments are *pminrow*, " -"*pmincol*, *sminrow*, *smincol*, *smaxrow*, *smaxcol*; the *p* arguments " -"refer to the upper left corner of the pad region to be displayed and the *s* " -"arguments define a clipping box on the screen within which the pad region is " -"to be displayed." +"as from scrolling or echoing of input) do not occur. " +"The :meth:`~window.refresh` and :meth:`~window.noutrefresh` methods of a pad " +"require 6 arguments to specify the part of the pad to be displayed and the " +"location on the screen to be used for the display. The arguments are " +"*pminrow*, *pmincol*, *sminrow*, *smincol*, *smaxrow*, *smaxcol*; the *p* " +"arguments refer to the upper-left corner of the pad region to be displayed " +"and the *s* arguments define a clipping box on the screen within which the " +"pad region is to be displayed." msgstr "" msgid "" @@ -421,6 +444,9 @@ msgid "" "mode is initially on." msgstr "" +msgid "If *flag* is ``False``, the effect is the same as calling :func:`nonl`." +msgstr "" + msgid "" "Leave cbreak mode. Return to normal \"cooked\" mode with line buffering." msgstr "" @@ -455,14 +481,17 @@ msgid "" msgstr "" msgid "" -"Return the number of the color-pair set by the attribute value *attr*. :func:" -"`color_pair` is the counterpart to this function." +"Return the number of the color-pair set by the attribute value " +"*attr*. :func:`color_pair` is the counterpart to this function." msgstr "" msgid "" "Equivalent to ``tputs(str, 1, putchar)``; emit the value of a specified " -"terminfo capability for the current terminal. Note that the output of :func:" -"`putp` always goes to standard output." +"terminfo capability, a bytes object, for the current terminal. Note that the " +"output of :func:`putp` always goes to standard output." +msgstr "" + +msgid ":func:`setupterm` (or :func:`initscr`) must be called first." msgstr "" msgid "" @@ -478,18 +507,18 @@ msgid "" msgstr "" msgid "" -"Restore the terminal to \"program\" mode, as previously saved by :func:" -"`def_prog_mode`." +"Restore the terminal to \"program\" mode, as previously saved " +"by :func:`def_prog_mode`." msgstr "" msgid "" -"Restore the terminal to \"shell\" mode, as previously saved by :func:" -"`def_shell_mode`." +"Restore the terminal to \"shell\" mode, as previously saved " +"by :func:`def_shell_mode`." msgstr "" msgid "" -"Restore the state of the terminal modes to what it was at the last call to :" -"func:`savetty`." +"Restore the state of the terminal modes to what it was at the last call " +"to :func:`savetty`." msgstr "" msgid "" @@ -508,8 +537,8 @@ msgid "" msgstr "" msgid "" -"Save the current state of the terminal modes in a buffer, usable by :func:" -"`resetty`." +"Save the current state of the terminal modes in a buffer, usable " +"by :func:`resetty`." msgstr "" msgid "Retrieves the value set by :func:`set_escdelay`." @@ -542,6 +571,18 @@ msgid "" "descriptor for ``sys.stdout`` will be used." msgstr "" +msgid "" +"Raise a :exc:`curses.error` if the terminal could not be found or its " +"terminfo database entry could not be read. If the terminal has already been " +"initialized, this function has no effect." +msgstr "" + +msgid "" +"Calling :func:`initscr` after :func:`setupterm` leaks the terminal " +"that :func:`setupterm` allocated: the curses library keeps only a single " +"current terminal and does not free the previously allocated one." +msgstr "" + msgid "" "Must be called if the programmer wants to use colors, and before any other " "color manipulation routine is called. It is good practice to call this " @@ -550,11 +591,11 @@ msgstr "" msgid "" ":func:`start_color` initializes eight basic colors (black, red, green, " -"yellow, blue, magenta, cyan, and white), and two global variables in the :" -"mod:`curses` module, :const:`COLORS` and :const:`COLOR_PAIRS`, containing " -"the maximum number of colors and color-pairs the terminal can support. It " -"also restores the colors on the terminal to the values they had when the " -"terminal was just turned on." +"yellow, blue, magenta, cyan, and white), and two global variables in " +"the :mod:`curses` module, :const:`COLORS` and :const:`COLOR_PAIRS`, " +"containing the maximum number of colors and color-pairs the terminal can " +"support. It also restores the colors on the terminal to the values they had " +"when the terminal was just turned on." msgstr "" msgid "" @@ -591,9 +632,10 @@ msgstr "" msgid "" "Instantiate the bytes object *str* with the supplied parameters, where *str* " -"should be a parameterized string obtained from the terminfo database. E.g. " -"``tparm(tigetstr(\"cup\"), 5, 3)`` could result in ``b'\\033[6;4H'``, the " -"exact result depending on terminal type." +"should be a parameterized byte string obtained from the terminfo database. " +"For example, ``tparm(tigetstr(\"cup\"), 5, 3)`` could result in " +"``b'\\033[6;4H'``, the exact result depending on terminal type. Up to nine " +"integer parameters may be supplied." msgstr "" msgid "" @@ -612,14 +654,19 @@ msgstr "" msgid "" "Return a bytes object which is a printable representation of the character " -"*ch*. Control characters are represented as a caret followed by the " -"character, for example as ``b'^C'``. Printing characters are left as they " -"are." +"*ch*; any attributes and color pair are ignored. Control characters are " +"represented as a caret followed by the character, for example as ``b'^C'``. " +"Printing characters are left as they are." msgstr "" msgid "Push *ch* so the next :meth:`~window.getch` will return it." msgstr "" +msgid "" +"*ch* may be an integer (a key code or the code of an encoded byte), a byte, " +"or a string of length 1 which encodes to a single byte." +msgstr "" + msgid "Only one *ch* can be pushed before :meth:`!getch` is called." msgstr "" @@ -631,6 +678,11 @@ msgstr "" msgid "Push *ch* so the next :meth:`~window.get_wch` will return it." msgstr "" +msgid "" +"*ch* may be an integer (a character code, not a key code) or a string of " +"length 1." +msgstr "" + msgid "Only one *ch* can be pushed before :meth:`!get_wch` is called." msgstr "" @@ -669,7 +721,7 @@ msgid "" "echo, and disables the terminal keypad." msgstr "" -msgid "Window Objects" +msgid "Window objects" msgstr "" msgid "" @@ -685,7 +737,7 @@ msgstr "" msgid "" "Writing outside the window, subwindow, or pad raises a :exc:`curses.error`. " -"Attempting to write to the lower right corner of a window, subwindow, or pad " +"Attempting to write to the lower-right corner of a window, subwindow, or pad " "will cause an exception to be raised after the character is printed." msgstr "" @@ -701,7 +753,7 @@ msgstr "" msgid "" "Writing outside the window, subwindow, or pad raises :exc:`curses.error`. " -"Attempting to write to the lower right corner of a window, subwindow, or pad " +"Attempting to write to the lower-right corner of a window, subwindow, or pad " "will cause an exception to be raised after the string is printed." msgstr "" @@ -720,8 +772,8 @@ msgid "" msgstr "" msgid "" -"Add attribute *attr* from the \"background\" set applied to all writes to " -"the current window." +"Add attribute *attr* to the \"background\" set applied to all writes to the " +"current window." msgstr "" msgid "" @@ -880,7 +932,9 @@ msgid "" "reflect the current cursor position of the window." msgstr "" -msgid "Delete any character at ``(y, x)``." +msgid "" +"Delete the character under the cursor, or at ``(y, x)`` if specified. All " +"characters to the right on the same line are shifted one position left." msgstr "" msgid "" @@ -896,8 +950,8 @@ msgid "" msgstr "" msgid "" -"Add character *ch* with attribute *attr*, and immediately call :meth:" -"`refresh` on the window." +"Add character *ch* with attribute *attr*, and immediately " +"call :meth:`refresh` on the window." msgstr "" msgid "" @@ -911,10 +965,11 @@ msgid "Previously it returned ``1`` or ``0`` instead of ``True`` or ``False``." msgstr "" msgid "" -"Encoding used to encode method arguments (Unicode strings and characters). " -"The encoding attribute is inherited from the parent window when a subwindow " -"is created, for example with :meth:`window.subwin`. By default, current " -"locale encoding is used (see :func:`locale.getencoding`)." +"Encoding used to encode the string arguments of the methods and to decode " +"their results on a build without wide-character support. The encoding " +"attribute is inherited from the parent window when a subwindow is created, " +"for example with :meth:`window.subwin`. By default, current locale encoding " +"is used (see :func:`locale.getencoding`)." msgstr "" msgid "Clear the window." @@ -923,27 +978,60 @@ msgstr "" msgid "Return a tuple ``(y, x)`` of coordinates of upper-left corner." msgstr "" -msgid "Return the given window's current background character/attribute pair." +msgid "" +"Return the given window's current background character/attribute pair. Its " +"components can be extracted like those of :meth:`inch`." +msgstr "" + +msgid "" +"Read a key press, after moving the cursor to *y*, *x* if specified, and " +"return it as an integer. The window is refreshed first if it is not a pad " +"and was modified since the last refresh. Wait until a key is pressed, or " +"return ``-1`` if the read is non-blocking or times out (see :meth:`nodelay` " +"and :meth:`timeout`)." +msgstr "" + +msgid "" +"An ordinary key is returned as the code of a single byte of its encoding in " +"the current locale, so a character encoded with several bytes takes several " +"calls. For example, in a UTF-8 locale ``'é'`` is read as ``195``, then " +"``169``. Use :meth:`get_wch` to read it as a single character." msgstr "" msgid "" -"Get a character. Note that the integer returned does *not* have to be in " -"ASCII range: function keys, keypad keys and so on are represented by numbers " -"higher than 255. In no-delay mode, return ``-1`` if there is no input, " -"otherwise wait until a key is pressed." +"In keypad mode (see :meth:`keypad`) function keys and other special keys are " +"returned as one of the :ref:`KEY_* constants `, which " +"cannot be mistaken for an ordinary key. Otherwise, or if their escape " +"sequence does not arrive in time (see :meth:`notimeout` " +"and :func:`set_escdelay`), their bytes are returned one at a time." msgstr "" msgid "" -"Get a wide character. Return a character for most keys, or an integer for " -"function keys, keypad keys, and other special keys. In no-delay mode, raise " -"an exception if there is no input." +"In echo mode (see :func:`echo`) the key is added to the window as " +"by :meth:`addch`; special keys are not echoed." msgstr "" msgid "" -"Get a character, returning a string instead of an integer, as :meth:`getch` " -"does. Function keys, keypad keys and other special keys return a multibyte " -"string containing the key name. In no-delay mode, raise an exception if " -"there is no input." +"Read a key press, after moving the cursor to *y*, *x* if specified, and " +"return it as a one-character :class:`str`. The window is refreshed first if " +"it is not a pad and was modified since the last refresh. Wait until a key is " +"pressed, or raise :exc:`error` if the read is non-blocking or times out " +"(see :meth:`nodelay` and :meth:`timeout`)." +msgstr "" + +msgid "" +"In keypad mode (see :meth:`keypad`) function keys and other special keys are " +"returned as one of the :ref:`KEY_* constants `, an " +"integer. Otherwise, or if their escape sequence does not arrive in time " +"(see :meth:`notimeout` and :func:`set_escdelay`), their characters are " +"returned one at a time." +msgstr "" + +msgid "" +"Read a key press as :meth:`getch` does, but return it as a :class:`str`: an " +"ordinary key as a one-character string, the byte decoded as Latin-1, and a " +"special key as its name, such as ``'KEY_UP'`` (see :func:`keyname`). " +"Raise :exc:`error` instead of returning ``-1`` if there is no input." msgstr "" msgid "Return a tuple ``(y, x)`` of the height and width of the window." @@ -956,7 +1044,10 @@ msgid "" msgstr "" msgid "" -"Read a bytes object from the user, with primitive line editing capacity." +"Read a line of input from the user, with primitive line editing capacity, " +"after moving the cursor to *y*, *x* if specified. Return it as a bytes " +"object, in the encoding of the current locale and without the terminating " +"newline. At most *n* bytes are read; *n* defaults to and cannot exceed 1023." msgstr "" msgid "" @@ -966,7 +1057,8 @@ msgstr "" msgid "" "Display a horizontal line starting at ``(y, x)`` with length *n* consisting " -"of the character *ch*." +"of the character *ch* with attributes *attr*. The line stops at the right " +"edge of the window if fewer than *n* cells are available." msgstr "" msgid "" @@ -990,12 +1082,20 @@ msgstr "" msgid "" "Return the character at the given position in the window. The bottom 8 bits " -"are the character proper, and upper bits are the attributes." +"are the character proper and the upper bits are the attributes; extract them " +"with the :data:`A_CHARTEXT` and :data:`A_ATTRIBUTES` bit-masks, and the " +"color pair with :func:`pair_number`. The character byte is the locale-" +"encoded byte of the cell's character, consistent with :meth:`instr`. On a " +"wide-character build, a character that does not fit in a single byte in the " +"current locale has a character byte of ``0``; use :meth:`instr` to read such " +"characters." msgstr "" msgid "" -"Paint character *ch* at ``(y, x)`` with attributes *attr*, moving the line " -"from position *x* right by one character." +"Insert character *ch* with attributes *attr* before the character under the " +"cursor, or at ``(y, x)`` if specified. All characters to the right of the " +"cursor are shifted one position right, with the rightmost character on the " +"line being lost. The cursor position does not change." msgstr "" msgid "" @@ -1029,33 +1129,33 @@ msgid "" msgstr "" msgid "" -"Return a bytes object of characters, extracted from the window starting at " -"the current cursor position, or at *y*, *x* if specified. Attributes are " -"stripped from the characters. If *n* is specified, :meth:`instr` returns a " -"string at most *n* characters long (exclusive of the trailing NUL)." +"Read the text of the window from the current cursor position, or from *y*, " +"*x* if specified, to the end of the line, and return it as a bytes object, " +"in the encoding of the current locale. Attributes and color pairs are " +"stripped. At most *n* bytes are read; *n* defaults to and cannot exceed 1023." msgstr "" msgid "" -"Return ``True`` if the specified line was modified since the last call to :" -"meth:`refresh`; otherwise return ``False``. Raise a :exc:`curses.error` " +"Return ``True`` if the specified line was modified since the last call " +"to :meth:`refresh`; otherwise return ``False``. Raise a :exc:`curses.error` " "exception if *line* is not valid for the given window." msgstr "" msgid "" -"Return ``True`` if the specified window was modified since the last call to :" -"meth:`refresh`; otherwise return ``False``." +"Return ``True`` if the specified window was modified since the last call " +"to :meth:`refresh`; otherwise return ``False``." msgstr "" msgid "" "If *flag* is ``True``, escape sequences generated by some keys (keypad, " "function keys) will be interpreted by :mod:`curses`. If *flag* is ``False``, " -"escape sequences will be left as is in the input stream." +"escape sequences will be left as is in the input stream. Keypad mode is " +"disabled by default, but :func:`wrapper` enables it for the main window." msgstr "" msgid "" "If *flag* is ``True``, cursor is left where it is on update, instead of " -"being at \"cursor position.\" This reduces cursor movement where possible. " -"If possible the cursor will be made invisible." +"being at \"cursor position.\" This reduces cursor movement where possible." msgstr "" msgid "" @@ -1075,6 +1175,11 @@ msgstr "" msgid "Move the window so its upper-left corner is at ``(new_y, new_x)``." msgstr "" +msgid "" +"Moving the window so that any part of it would be off the screen is an " +"error: the window is not moved and :exc:`curses.error` is raised." +msgstr "" + msgid "If *flag* is ``True``, :meth:`getch` will be non-blocking." msgstr "" @@ -1092,6 +1197,12 @@ msgid "" "of the physical screen. To accomplish that, call :func:`doupdate`." msgstr "" +msgid "" +"The 6 arguments can only be specified, and are then required, when the " +"window is a pad created with :func:`newpad`; they have the same meaning as " +"for :meth:`refresh`." +msgstr "" + msgid "" "Overlay the window on top of *destwin*. The windows need not be the same " "size, only the overlapping region is copied. This copy is non-destructive, " @@ -1100,8 +1211,8 @@ msgid "" msgstr "" msgid "" -"To get fine-grained control over the copied region, the second form of :meth:" -"`overlay` can be used. *sminrow* and *smincol* are the upper-left " +"To get fine-grained control over the copied region, the second form " +"of :meth:`overlay` can be used. *sminrow* and *smincol* are the upper-left " "coordinates of the source window, and the other variables mark a rectangle " "in the destination window." msgstr "" @@ -1114,8 +1225,8 @@ msgid "" msgstr "" msgid "" -"To get fine-grained control over the copied region, the second form of :meth:" -"`overwrite` can be used. *sminrow* and *smincol* are the upper-left " +"To get fine-grained control over the copied region, the second form " +"of :meth:`overwrite` can be used. *sminrow* and *smincol* are the upper-left " "coordinates of the source window, the other variables mark a rectangle in " "the destination window." msgstr "" @@ -1131,8 +1242,8 @@ msgid "" msgstr "" msgid "" -"Touch the entire window, causing it to be completely redrawn on the next :" -"meth:`refresh` call." +"Touch the entire window, causing it to be completely redrawn on the " +"next :meth:`refresh` call." msgstr "" msgid "" @@ -1141,17 +1252,17 @@ msgid "" msgstr "" msgid "" -"The 6 optional arguments can only be specified when the window is a pad " -"created with :func:`newpad`. The additional parameters are needed to " -"indicate what part of the pad and screen are involved. *pminrow* and " -"*pmincol* specify the upper left-hand corner of the rectangle to be " -"displayed in the pad. *sminrow*, *smincol*, *smaxrow*, and *smaxcol* " -"specify the edges of the rectangle to be displayed on the screen. The lower " -"right-hand corner of the rectangle to be displayed in the pad is calculated " -"from the screen coordinates, since the rectangles must be the same size. " -"Both rectangles must be entirely contained within their respective " -"structures. Negative values of *pminrow*, *pmincol*, *sminrow*, or " -"*smincol* are treated as if they were zero." +"The 6 arguments can only be specified, and are then required, when the " +"window is a pad created with :func:`newpad`. The additional parameters are " +"needed to indicate what part of the pad and screen are involved. *pminrow* " +"and *pmincol* specify the upper-left corner of the rectangle to be displayed " +"in the pad. *sminrow*, *smincol*, *smaxrow*, and *smaxcol* specify the " +"edges of the rectangle to be displayed on the screen. The lower-right " +"corner of the rectangle to be displayed in the pad is calculated from the " +"screen coordinates, since the rectangles must be the same size. Both " +"rectangles must be entirely contained within their respective structures. " +"Negative values of *pminrow*, *pmincol*, *sminrow*, or *smincol* are treated " +"as if they were zero." msgstr "" msgid "" @@ -1161,7 +1272,10 @@ msgid "" "rendition (as set by :meth:`bkgdset`) merged into them." msgstr "" -msgid "Scroll the screen or scrolling region upward by *lines* lines." +msgid "" +"Scroll the screen or scrolling region. Scroll upward by *lines* lines if " +"*lines* is positive, or downward if it is negative. Scrolling has no effect " +"unless it has been enabled for the window with :meth:`scrollok`." msgstr "" msgid "" @@ -1187,8 +1301,16 @@ msgid "Turn on attribute *A_STANDOUT*." msgstr "" msgid "" -"Return a sub-window, whose upper-left corner is at ``(begin_y, begin_x)``, " -"and whose width/height is *ncols*/*nlines*." +"Return a sub-pad, whose upper-left corner is at ``(begin_y, begin_x)``, and " +"whose width/height is *ncols*/*nlines*. The coordinates are relative to the " +"parent pad (unlike :meth:`subwin`, which uses screen coordinates). This " +"method is only available for pads created with :func:`newpad`." +msgstr "" + +msgid "" +"Return a sub-window, whose upper-left corner is at the screen-relative " +"coordinates ``(begin_y, begin_x)``, and whose width/height is *ncols*/" +"*nlines*." msgstr "" msgid "" @@ -1216,9 +1338,9 @@ msgid "" "Set blocking or non-blocking read behavior for the window. If *delay* is " "negative, blocking read is used (which will wait indefinitely for input). " "If *delay* is zero, then non-blocking read is used, and :meth:`getch` will " -"return ``-1`` if no input is waiting. If *delay* is positive, then :meth:" -"`getch` will block for *delay* milliseconds, and return ``-1`` if there is " -"still no input at the end of that time." +"return ``-1`` if no input is waiting. If *delay* is positive, " +"then :meth:`getch` will block for *delay* milliseconds, and return ``-1`` if " +"there is still no input at the end of that time." msgstr "" msgid "" @@ -1234,8 +1356,8 @@ msgid "" msgstr "" msgid "" -"Mark all lines in the window as unchanged since the last call to :meth:" -"`refresh`." +"Mark all lines in the window as unchanged since the last call " +"to :meth:`refresh`." msgstr "" msgid "" @@ -1250,8 +1372,8 @@ msgid "The :mod:`curses` module defines the following data members:" msgstr "" msgid "" -"Some curses routines that return an integer, such as :meth:`~window." -"getch`, return :const:`ERR` upon failure." +"Some curses routines that return an integer, such " +"as :meth:`~window.getch`, return :const:`ERR` upon failure." msgstr "" msgid "" @@ -1283,15 +1405,15 @@ msgid "" msgstr "" msgid "" -"The width of the screen, i.e., the number of columns. It is defined only " -"after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :" -"func:`resizeterm` and :func:`resize_term`." +"The width of the screen, that is, the number of columns. It is defined only " +"after the call to :func:`initscr`. Updated " +"by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`." msgstr "" msgid "" -"The height of the screen, i.e., the number of lines. It is defined only " -"after the call to :func:`initscr`. Updated by :func:`update_lines_cols`, :" -"func:`resizeterm` and :func:`resize_term`." +"The height of the screen, that is, the number of lines. It is defined only " +"after the call to :func:`initscr`. Updated " +"by :func:`update_lines_cols`, :func:`resizeterm` and :func:`resize_term`." msgstr "" msgid "" @@ -1508,7 +1630,7 @@ msgid "Cmd (command)" msgstr "" msgid "Copy" -msgstr "" +msgstr "Kopiuj" msgid "Create" msgstr "" @@ -1671,13 +1793,14 @@ msgstr "" msgid "" "On VT100s and their software emulations, such as X terminal emulators, there " -"are normally at least four function keys (:const:`KEY_F1 `, :const:" -"`KEY_F2 `, :const:`KEY_F3 `, :const:`KEY_F4 `) " -"available, and the arrow keys mapped to :const:`KEY_UP`, :const:`KEY_DOWN`, :" -"const:`KEY_LEFT` and :const:`KEY_RIGHT` in the obvious way. If your machine " -"has a PC keyboard, it is safe to expect arrow keys and twelve function keys " -"(older PC keyboards may have only ten function keys); also, the following " -"keypad mappings are standard:" +"are normally at least four function keys (:const:`KEY_F1 " +"`, :const:`KEY_F2 `, :const:`KEY_F3 " +"`, :const:`KEY_F4 `) available, and the arrow keys mapped " +"to :const:`KEY_UP`, :const:`KEY_DOWN`, :const:`KEY_LEFT` " +"and :const:`KEY_RIGHT` in the obvious way. If your machine has a PC " +"keyboard, it is safe to expect arrow keys and twelve function keys (older PC " +"keyboards may have only ten function keys); also, the following keypad " +"mappings are standard:" msgstr "" msgid "Keycap" @@ -1735,7 +1858,7 @@ msgstr "" msgid "ACS code" msgstr "" -msgid "alternate name for upper right corner" +msgid "alternate name for upper-right corner" msgstr "" msgid "solid square block" @@ -1747,7 +1870,7 @@ msgstr "" msgid "alternate name for horizontal line" msgstr "" -msgid "alternate name for upper left corner" +msgid "alternate name for upper-left corner" msgstr "" msgid "alternate name for top tee" @@ -1786,10 +1909,10 @@ msgstr "" msgid "less-than-or-equal-to" msgstr "" -msgid "lower left-hand corner" +msgid "lower-left corner" msgstr "" -msgid "lower right-hand corner" +msgid "lower-right corner" msgstr "" msgid "left tee" @@ -1825,7 +1948,7 @@ msgstr "" msgid "scan line 9" msgstr "" -msgid "alternate name for lower right corner" +msgid "alternate name for lower-right corner" msgstr "" msgid "alternate name for vertical line" @@ -1834,7 +1957,7 @@ msgstr "" msgid "alternate name for right tee" msgstr "" -msgid "alternate name for lower left corner" +msgid "alternate name for lower-left corner" msgstr "" msgid "alternate name for bottom tee" @@ -1855,10 +1978,10 @@ msgstr "" msgid "up arrow" msgstr "" -msgid "upper left corner" +msgid "upper-left corner" msgstr "" -msgid "upper right corner" +msgid "upper-right corner" msgstr "" msgid "vertical line" @@ -1892,6 +2015,9 @@ msgstr "" msgid "Control was down during button state change" msgstr "" +msgid "Alt was down during button state change" +msgstr "" + msgid "The following table lists the predefined colors:" msgstr "" @@ -1940,10 +2066,10 @@ msgstr "" msgid "" "Draw a rectangle. The first argument must be a window object; the remaining " "arguments are coordinates relative to that window. The second and third " -"arguments are the y and x coordinates of the upper left hand corner of the " +"arguments are the y and x coordinates of the upper-left corner of the " "rectangle to be drawn; the fourth and fifth arguments are the y and x " -"coordinates of the lower right hand corner. The rectangle will be drawn " -"using VT100/IBM PC forms characters on terminals that make this possible " +"coordinates of the lower-right corner. The rectangle will be drawn using " +"VT100/IBM PC forms characters on terminals that make this possible " "(including xterm and most other software terminal emulators). Otherwise it " "will be drawn with ASCII dashes, vertical bars, and plus signs." msgstr "" @@ -1955,10 +2081,12 @@ msgid "You can instantiate a :class:`Textbox` object as follows:" msgstr "" msgid "" -"Return a textbox widget object. The *win* argument should be a curses :ref:" -"`window ` object in which the textbox is to be " -"contained. The edit cursor of the textbox is initially located at the upper " -"left hand corner of the containing window, with coordinates ``(0, 0)``. The " +"Return a textbox widget object. The *win* argument should be a " +"curses :ref:`window ` object in which the textbox is " +"to be contained. If *insert_mode* is true, the textbox inserts typed " +"characters, shifting existing text to the right, rather than overwriting it. " +"The edit cursor of the textbox is initially located at the upper-left corner " +"of the containing window, with coordinates ``(0, 0)``. The " "instance's :attr:`stripspaces` flag is initially on." msgstr "" @@ -1968,16 +2096,17 @@ msgstr "" msgid "" "This is the entry point you will normally use. It accepts editing " "keystrokes until one of the termination keystrokes is entered. If " -"*validator* is supplied, it must be a function. It will be called for each " +"*validate* is supplied, it must be a function. It will be called for each " "keystroke entered with the keystroke as a parameter; command dispatch is " -"done on the result. This method returns the window contents as a string; " -"whether blanks in the window are included is affected by the :attr:" -"`stripspaces` attribute." +"done on the result. If it returns a false value, the keystroke is ignored. " +"This method returns the window contents as a string; whether blanks in the " +"window are included is affected by the :attr:`stripspaces` attribute." msgstr "" msgid "" -"Process a single command keystroke. Here are the supported special " -"keystrokes:" +"Process a single command keystroke. Returns ``1`` to continue editing, or " +"``0`` if a termination keystroke was processed. Here are the supported " +"special keystrokes:" msgstr "" msgid "Keystroke" @@ -2031,7 +2160,9 @@ msgstr "" msgid ":kbd:`Control-J`" msgstr ":kbd:`Control-J`" -msgid "Terminate if the window is 1 line, otherwise insert newline." +msgid "" +"Terminate if the window is 1 line, otherwise move to the start of the next " +"line." msgstr "" msgid ":kbd:`Control-K`" diff --git a/library/dataclasses.po b/library/dataclasses.po index f111b8c8bc..0bf01e1595 100644 --- a/library/dataclasses.po +++ b/library/dataclasses.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: -# Transifex Bot <>, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:03+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2025-08-07 21:40+0000\n" +"PO-Revision-Date: 2025-07-18 19: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" @@ -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 ":mod:`dataclasses` --- Data Classes" +msgid ":mod:`!dataclasses` --- Data Classes" msgstr "" msgid "**Source code:** :source:`Lib/dataclasses.py`" @@ -31,38 +31,60 @@ msgstr "" msgid "" "This module provides a decorator and functions for automatically adding " -"generated :term:`special method`\\s such as :meth:`~object.__init__` and :" -"meth:`~object.__repr__` to user-defined classes. It was originally " -"described in :pep:`557`." +"generated :term:`special methods ` such " +"as :meth:`~object.__init__` and :meth:`~object.__repr__` to user-defined " +"classes. It was originally described in :pep:`557`." msgstr "" msgid "" -"The member variables to use in these generated methods are defined using :" -"pep:`526` type annotations. For example, this code::" +"The member variables to use in these generated methods are defined " +"using :pep:`526` type annotations. For example, this code::" msgstr "" msgid "" -"will add, among other things, a :meth:`~object.__init__` that looks like::" +"from dataclasses import dataclass\n" +"\n" +"@dataclass\n" +"class InventoryItem:\n" +" \"\"\"Class for keeping track of an item in inventory.\"\"\"\n" +" name: str\n" +" unit_price: float\n" +" quantity_on_hand: int = 0\n" +"\n" +" def total_cost(self) -> float:\n" +" return self.unit_price * self.quantity_on_hand" +msgstr "" + +msgid "will add, among other things, a :meth:`!__init__` that looks like::" +msgstr "" + +msgid "" +"def __init__(self, name: str, unit_price: float, quantity_on_hand: int = " +"0):\n" +" self.name = name\n" +" self.unit_price = unit_price\n" +" self.quantity_on_hand = quantity_on_hand" msgstr "" msgid "" "Note that this method is automatically added to the class: it is not " -"directly specified in the ``InventoryItem`` definition shown above." +"directly specified in the :class:`!InventoryItem` definition shown above." msgstr "" msgid "Module contents" msgstr "" msgid "" -"This function is a :term:`decorator` that is used to add generated :term:" -"`special method`\\s to classes, as described below." +"This function is a :term:`decorator` that is used to add " +"generated :term:`special methods ` to classes, as described " +"below." msgstr "" msgid "" -"The :func:`dataclass` decorator examines the class to find ``field``\\s. A " +"The ``@dataclass`` decorator examines the class to find ``field``\\s. A " "``field`` is defined as a class variable that has a :term:`type annotation " -"`. With two exceptions described below, nothing in :" -"func:`dataclass` examines the type specified in the variable annotation." +"`. With two exceptions described below, nothing in " +"``@dataclass`` examines the type specified in the variable annotation." msgstr "" msgid "" @@ -71,7 +93,7 @@ msgid "" msgstr "" msgid "" -"The :func:`dataclass` decorator will add various \"dunder\" methods to the " +"The ``@dataclass`` decorator will add various \"dunder\" methods to the " "class, described below. If any of the added methods already exist in the " "class, the behavior depends on the parameter, as documented below. The " "decorator returns the same class that it is called on; no new class is " @@ -79,26 +101,41 @@ msgid "" msgstr "" msgid "" -"If :func:`dataclass` is used just as a simple decorator with no parameters, " -"it acts as if it has the default values documented in this signature. That " -"is, these three uses of :func:`dataclass` are equivalent::" +"If ``@dataclass`` is used just as a simple decorator with no parameters, it " +"acts as if it has the default values documented in this signature. That is, " +"these three uses of ``@dataclass`` are equivalent::" msgstr "" -msgid "The parameters to :func:`dataclass` are:" +msgid "" +"@dataclass\n" +"class C:\n" +" ...\n" +"\n" +"@dataclass()\n" +"class C:\n" +" ...\n" +"\n" +"@dataclass(init=True, repr=True, eq=True, order=False, unsafe_hash=False, " +"frozen=False,\n" +" match_args=True, kw_only=False, slots=False, weakref_slot=False)\n" +"class C:\n" +" ..." +msgstr "" + +msgid "The parameters to ``@dataclass`` are:" msgstr "" msgid "" -"``init``: If true (the default), a :meth:`~object.__init__` method will be " +"*init*: If true (the default), a :meth:`~object.__init__` method will be " "generated." msgstr "" msgid "" -"If the class already defines :meth:`~object.__init__`, this parameter is " -"ignored." +"If the class already defines :meth:`!__init__`, this parameter is ignored." msgstr "" msgid "" -"``repr``: If true (the default), a :meth:`~object.__repr__` method will be " +"*repr*: If true (the default), a :meth:`~object.__repr__` method will be " "generated. The generated repr string will have the class name and the name " "and repr of each field, in the order they are defined in the class. Fields " "that are marked as being excluded from the repr are not included. For " @@ -107,133 +144,148 @@ msgid "" msgstr "" msgid "" -"If the class already defines :meth:`~object.__repr__`, this parameter is " -"ignored." +"If the class already defines :meth:`!__repr__`, this parameter is ignored." msgstr "" msgid "" -"``eq``: If true (the default), an :meth:`~object.__eq__` method will be " +"*eq*: If true (the default), an :meth:`~object.__eq__` method will be " "generated. This method compares the class as if it were a tuple of its " "fields, in order. Both instances in the comparison must be of the identical " "type." msgstr "" msgid "" -"If the class already defines :meth:`~object.__eq__`, this parameter is " -"ignored." +"If the class already defines :meth:`!__eq__`, this parameter is ignored." msgstr "" msgid "" -"``order``: If true (the default is ``False``), :meth:`~object.__lt__`, :meth:" -"`~object.__le__`, :meth:`~object.__gt__`, and :meth:`~object.__ge__` methods " -"will be generated. These compare the class as if it were a tuple of its " -"fields, in order. Both instances in the comparison must be of the identical " -"type. If ``order`` is true and ``eq`` is false, a :exc:`ValueError` is " -"raised." +"*order*: If true (the default is " +"``False``), :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__`, " +"and :meth:`~object.__ge__` methods will be generated. These compare the " +"class as if it were a tuple of its fields, in order. Both instances in the " +"comparison must be of the identical type. If *order* is true and *eq* is " +"false, a :exc:`ValueError` is raised." msgstr "" msgid "" -"If the class already defines any of :meth:`~object.__lt__`, :meth:`~object." -"__le__`, :meth:`~object.__gt__`, or :meth:`~object.__ge__`, then :exc:" -"`TypeError` is raised." +"If the class already defines any of :meth:`!__lt__`, :meth:`!" +"__le__`, :meth:`!__gt__`, or :meth:`!__ge__`, then :exc:`TypeError` is " +"raised." msgstr "" msgid "" -"``unsafe_hash``: If ``False`` (the default), a :meth:`~object.__hash__` " -"method is generated according to how ``eq`` and ``frozen`` are set." +"*unsafe_hash*: If true, force ``dataclasses`` to create " +"a :meth:`~object.__hash__` method, even though it may not be safe to do so. " +"Otherwise, generate a :meth:`~object.__hash__` method according to how *eq* " +"and *frozen* are set. The default value is ``False``." msgstr "" msgid "" -":meth:`~object.__hash__` is used by built-in :meth:`hash()`, and when " -"objects are added to hashed collections such as dictionaries and sets. " -"Having a :meth:`~object.__hash__` implies that instances of the class are " -"immutable. Mutability is a complicated property that depends on the " -"programmer's intent, the existence and behavior of :meth:`~object.__eq__`, " -"and the values of the ``eq`` and ``frozen`` flags in the :func:`dataclass` " -"decorator." +":meth:`!__hash__` is used by built-in :meth:`hash`, and when objects are " +"added to hashed collections such as dictionaries and sets. Having a :meth:`!" +"__hash__` implies that instances of the class are immutable. Mutability is a " +"complicated property that depends on the programmer's intent, the existence " +"and behavior of :meth:`!__eq__`, and the values of the *eq* and *frozen* " +"flags in the ``@dataclass`` decorator." msgstr "" msgid "" -"By default, :func:`dataclass` will not implicitly add a :meth:`~object." -"__hash__` method unless it is safe to do so. Neither will it add or change " -"an existing explicitly defined :meth:`~object.__hash__` method. Setting the " -"class attribute ``__hash__ = None`` has a specific meaning to Python, as " -"described in the :meth:`~object.__hash__` documentation." +"By default, ``@dataclass`` will not implicitly add " +"a :meth:`~object.__hash__` method unless it is safe to do so. Neither will " +"it add or change an existing explicitly defined :meth:`!__hash__` method. " +"Setting the class attribute ``__hash__ = None`` has a specific meaning to " +"Python, as described in the :meth:`!__hash__` documentation." msgstr "" msgid "" -"If :meth:`~object.__hash__` is not explicitly defined, or if it is set to " -"``None``, then :func:`dataclass` *may* add an implicit :meth:`~object." -"__hash__` method. Although not recommended, you can force :func:`dataclass` " -"to create a :meth:`~object.__hash__` method with ``unsafe_hash=True``. This " -"might be the case if your class is logically immutable but can nonetheless " -"be mutated. This is a specialized use case and should be considered " -"carefully." +"If :meth:`!__hash__` is not explicitly defined, or if it is set to ``None``, " +"then ``@dataclass`` *may* add an implicit :meth:`!__hash__` method. Although " +"not recommended, you can force ``@dataclass`` to create a :meth:`!__hash__` " +"method with ``unsafe_hash=True``. This might be the case if your class is " +"logically immutable but can still be mutated. This is a specialized use case " +"and should be considered carefully." msgstr "" msgid "" -"Here are the rules governing implicit creation of a :meth:`~object.__hash__` " -"method. Note that you cannot both have an explicit :meth:`~object.__hash__` " -"method in your dataclass and set ``unsafe_hash=True``; this will result in " +"Here are the rules governing implicit creation of a :meth:`!__hash__` " +"method. Note that you cannot both have an explicit :meth:`!__hash__` method " +"in your dataclass and set ``unsafe_hash=True``; this will result in " "a :exc:`TypeError`." msgstr "" msgid "" -"If ``eq`` and ``frozen`` are both true, by default :func:`dataclass` will " -"generate a :meth:`~object.__hash__` method for you. If ``eq`` is true and " -"``frozen`` is false, :meth:`~object.__hash__` will be set to ``None``, " -"marking it unhashable (which it is, since it is mutable). If ``eq`` is " -"false, :meth:`~object.__hash__` will be left untouched meaning the :meth:" -"`~object.__hash__` method of the superclass will be used (if the superclass " -"is :class:`object`, this means it will fall back to id-based hashing)." +"If *eq* and *frozen* are both true, by default ``@dataclass`` will generate " +"a :meth:`!__hash__` method for you. If *eq* is true and *frozen* is " +"false, :meth:`!__hash__` will be set to ``None``, marking it unhashable " +"(which it is, since it is mutable). If *eq* is false, :meth:`!__hash__` " +"will be left untouched meaning the :meth:`!__hash__` method of the " +"superclass will be used (if the superclass is :class:`object`, this means it " +"will fall back to id-based hashing)." msgstr "" msgid "" -"``frozen``: If true (the default is ``False``), assigning to fields will " -"generate an exception. This emulates read-only frozen instances. If :meth:" -"`~object.__setattr__` or :meth:`~object.__delattr__` is defined in the " -"class, then :exc:`TypeError` is raised. See the discussion below." +"*frozen*: If true (the default is ``False``), assigning to fields will " +"generate an exception. This emulates read-only frozen instances. " +"If :meth:`~object.__setattr__` or :meth:`~object.__delattr__` is defined in " +"the class, then :exc:`TypeError` is raised. See the discussion below." msgstr "" msgid "" -"``match_args``: If true (the default is ``True``), the ``__match_args__`` " -"tuple will be created from the list of parameters to the generated :meth:" -"`~object.__init__` method (even if :meth:`~object.__init__` is not " -"generated, see above). If false, or if ``__match_args__`` is already " -"defined in the class, then ``__match_args__`` will not be generated." +"*match_args*: If true (the default is ``True``), " +"the :attr:`~object.__match_args__` tuple will be created from the list of " +"non keyword-only parameters to the generated :meth:`~object.__init__` method " +"(even if :meth:`!__init__` is not generated, see above). If false, or " +"if :attr:`!__match_args__` is already defined in the class, then :attr:`!" +"__match_args__` will not be generated." msgstr "" msgid "" -"``kw_only``: If true (the default value is ``False``), then all fields will " -"be marked as keyword-only. If a field is marked as keyword-only, then the " -"only effect is that the :meth:`~object.__init__` parameter generated from a " -"keyword-only field must be specified with a keyword when :meth:`~object." -"__init__` is called. There is no effect on any other aspect of " -"dataclasses. See the :term:`parameter` glossary entry for details. Also " -"see the :const:`KW_ONLY` section." +"*kw_only*: If true (the default value is ``False``), then all fields will be " +"marked as keyword-only. If a field is marked as keyword-only, then the only " +"effect is that the :meth:`~object.__init__` parameter generated from a " +"keyword-only field must be specified with a keyword when :meth:`!__init__` " +"is called. See the :term:`parameter` glossary entry for details. Also see " +"the :const:`KW_ONLY` section." +msgstr "" + +msgid "Keyword-only fields are not included in :attr:`!__match_args__`." msgstr "" msgid "" -"``slots``: If true (the default is ``False``), :attr:`~object.__slots__` " +"*slots*: If true (the default is ``False``), :attr:`~object.__slots__` " "attribute will be generated and new class will be returned instead of the " -"original one. If :attr:`~object.__slots__` is already defined in the class, " +"original one. If :attr:`!__slots__` is already defined in the class, " "then :exc:`TypeError` is raised." msgstr "" msgid "" -"If a field name is already included in the ``__slots__`` of a base class, it " -"will not be included in the generated ``__slots__`` to prevent :ref:" -"`overriding them `. Therefore, do not use " -"``__slots__`` to retrieve the field names of a dataclass. Use :func:`fields` " -"instead. To be able to determine inherited slots, base class ``__slots__`` " -"may be any iterable, but *not* an iterator." +"Calling no-arg :func:`super` in dataclasses using ``slots=True`` will result " +"in the following exception being raised: ``TypeError: super(type, obj): obj " +"must be an instance or subtype of type``. The two-arg :func:`super` is a " +"valid workaround. See :gh:`90562` for full details." msgstr "" msgid "" -"``weakref_slot``: If true (the default is ``False``), add a slot named " -"\"__weakref__\", which is required to make an instance weakref-able. It is " -"an error to specify ``weakref_slot=True`` without also specifying " -"``slots=True``." +"Passing parameters to a base class :meth:`~object.__init_subclass__` when " +"using ``slots=True`` will result in a :exc:`TypeError`. Either use " +"``__init_subclass__`` with no parameters or use default values as a " +"workaround. See :gh:`91126` for full details." +msgstr "" + +msgid "" +"If a field name is already included in the :attr:`!__slots__` of a base " +"class, it will not be included in the generated :attr:`!__slots__` to " +"prevent :ref:`overriding them `. Therefore, do not " +"use :attr:`!__slots__` to retrieve the field names of a dataclass. " +"Use :func:`fields` instead. To be able to determine inherited slots, base " +"class :attr:`!__slots__` may be any iterable, but *not* an iterator." +msgstr "" + +msgid "" +"*weakref_slot*: If true (the default is ``False``), add a slot named " +"\"__weakref__\", which is required to make an instance :func:`weakref-able " +"`. It is an error to specify ``weakref_slot=True`` without also " +"specifying ``slots=True``." msgstr "" msgid "" @@ -242,8 +294,18 @@ msgid "" msgstr "" msgid "" -"In this example, both ``a`` and ``b`` will be included in the added :meth:" -"`~object.__init__` method, which will be defined as::" +"@dataclass\n" +"class C:\n" +" a: int # 'a' has no default value\n" +" b: int = 0 # assign a default value for 'b'" +msgstr "" + +msgid "" +"In this example, both :attr:`!a` and :attr:`!b` will be included in the " +"added :meth:`~object.__init__` method, which will be defined as::" +msgstr "" + +msgid "def __init__(self, a: int, b: int = 0):" msgstr "" msgid "" @@ -256,10 +318,19 @@ msgid "" "For common and simple use cases, no other functionality is required. There " "are, however, some dataclass features that require additional per-field " "information. To satisfy this need for additional information, you can " -"replace the default field value with a call to the provided :func:`field` " +"replace the default field value with a call to the provided :func:`!field` " "function. For example::" msgstr "" +msgid "" +"@dataclass\n" +"class C:\n" +" mylist: list[int] = field(default_factory=list)\n" +"\n" +"c = C()\n" +"c.mylist += [1, 2, 3]" +msgstr "" + msgid "" "As shown above, the :const:`MISSING` value is a sentinel object used to " "detect if some parameters are provided by the user. This sentinel is used " @@ -267,38 +338,39 @@ msgid "" "meaning. No code should directly use the :const:`MISSING` value." msgstr "" -msgid "The parameters to :func:`field` are:" +msgid "The parameters to :func:`!field` are:" msgstr "" msgid "" -"``default``: If provided, this will be the default value for this field. " -"This is needed because the :meth:`field` call itself replaces the normal " +"*default*: If provided, this will be the default value for this field. This " +"is needed because the :func:`!field` call itself replaces the normal " "position of the default value." msgstr "" msgid "" -"``default_factory``: If provided, it must be a zero-argument callable that " +"*default_factory*: If provided, it must be a zero-argument callable that " "will be called when a default value is needed for this field. Among other " "purposes, this can be used to specify fields with mutable default values, as " -"discussed below. It is an error to specify both ``default`` and " -"``default_factory``." +"discussed below. It is an error to specify both *default* and " +"*default_factory*." msgstr "" msgid "" -"``init``: If true (the default), this field is included as a parameter to " -"the generated :meth:`~object.__init__` method." +"*init*: If true (the default), this field is included as a parameter to the " +"generated :meth:`~object.__init__` method." msgstr "" msgid "" -"``repr``: If true (the default), this field is included in the string " -"returned by the generated :meth:`~object.__repr__` method." +"*repr*: If true (the default), this field is included in the string returned " +"by the generated :meth:`~object.__repr__` method." msgstr "" msgid "" -"``hash``: This can be a bool or ``None``. If true, this field is included " -"in the generated :meth:`~object.__hash__` method. If ``None`` (the " -"default), use the value of ``compare``: this would normally be the expected " -"behavior. A field should be considered in the hash if it's used for " +"*hash*: This can be a bool or ``None``. If true, this field is included in " +"the generated :meth:`~object.__hash__` method. If false, this field is " +"excluded from the generated :meth:`~object.__hash__`. If ``None`` (the " +"default), use the value of *compare*: this would normally be the expected " +"behavior, since a field should be included in the hash if it's used for " "comparisons. Setting this value to anything other than ``None`` is " "discouraged." msgstr "" @@ -312,58 +384,71 @@ msgid "" msgstr "" msgid "" -"``compare``: If true (the default), this field is included in the generated " -"equality and comparison methods (:meth:`~object.__eq__`, :meth:`~object." -"__gt__`, et al.)." +"*compare*: If true (the default), this field is included in the generated " +"equality and comparison methods " +"(:meth:`~object.__eq__`, :meth:`~object.__gt__`, et al.)." msgstr "" msgid "" -"``metadata``: This can be a mapping or None. None is treated as an empty " -"dict. This value is wrapped in :func:`~types.MappingProxyType` to make it " -"read-only, and exposed on the :class:`Field` object. It is not used at all " -"by Data Classes, and is provided as a third-party extension mechanism. " -"Multiple third-parties can each have their own key, to use as a namespace in " -"the metadata." +"*metadata*: This can be a mapping or ``None``. ``None`` is treated as an " +"empty dict. This value is wrapped in :func:`~types.MappingProxyType` to " +"make it read-only, and exposed on the :class:`Field` object. It is not used " +"at all by Data Classes, and is provided as a third-party extension " +"mechanism. Multiple third-parties can each have their own key, to use as a " +"namespace in the metadata." msgstr "" msgid "" -"``kw_only``: If true, this field will be marked as keyword-only. This is " -"used when the generated :meth:`~object.__init__` method's parameters are " -"computed." +"*kw_only*: If true, this field will be marked as keyword-only. This is used " +"when the generated :meth:`~object.__init__` method's parameters are computed." +msgstr "" + +msgid "Keyword-only fields are also not included in :attr:`!__match_args__`." msgstr "" msgid "" -"If the default value of a field is specified by a call to :func:`field()`, " +"If the default value of a field is specified by a call to :func:`!field`, " "then the class attribute for this field will be replaced by the specified " -"``default`` value. If no ``default`` is provided, then the class attribute " -"will be deleted. The intent is that after the :func:`dataclass` decorator " -"runs, the class attributes will all contain the default values for the " -"fields, just as if the default value itself were specified. For example, " -"after::" +"*default* value. If *default* is not provided, then the class attribute " +"will be deleted. The intent is that after the :func:`@dataclass " +"` decorator runs, the class attributes will all contain the " +"default values for the fields, just as if the default value itself were " +"specified. For example, after::" +msgstr "" + +msgid "" +"@dataclass\n" +"class C:\n" +" x: int\n" +" y: int = field(repr=False)\n" +" z: int = field(repr=False, default=10)\n" +" t: int = 20" msgstr "" msgid "" -"The class attribute ``C.z`` will be ``10``, the class attribute ``C.t`` will " -"be ``20``, and the class attributes ``C.x`` and ``C.y`` will not be set." +"The class attribute :attr:`!C.z` will be ``10``, the class attribute :attr:`!" +"C.t` will be ``20``, and the class attributes :attr:`!C.x` and :attr:`!C.y` " +"will not be set." msgstr "" msgid "" -":class:`Field` objects describe each defined field. These objects are " +":class:`!Field` objects describe each defined field. These objects are " "created internally, and are returned by the :func:`fields` module-level " -"method (see below). Users should never instantiate a :class:`Field` object " +"method (see below). Users should never instantiate a :class:`!Field` object " "directly. Its documented attributes are:" msgstr "" -msgid "``name``: The name of the field." +msgid ":attr:`!name`: The name of the field." msgstr "" -msgid "``type``: The type of the field." +msgid ":attr:`!type`: The type of the field." msgstr "" msgid "" -"``default``, ``default_factory``, ``init``, ``repr``, ``hash``, ``compare``, " -"``metadata``, and ``kw_only`` have the identical meaning and values as they " -"do in the :func:`field` function." +":attr:`!default`, :attr:`!default_factory`, :attr:`!init`, :attr:`!" +"repr`, :attr:`!hash`, :attr:`!compare`, :attr:`!metadata`, and :attr:`!" +"kw_only` have the identical meaning and values as they do in " +"the :func:`field` function." msgstr "" msgid "" @@ -371,6 +456,14 @@ msgid "" "or relied on." msgstr "" +msgid "" +"``InitVar[T]`` type annotations describe variables that are :ref:`init-only " +"`. Fields annotated with :class:`!InitVar` " +"are considered pseudo-fields, and thus are neither returned by " +"the :func:`fields` function nor used in any way except adding them as " +"parameters to :meth:`~object.__init__` and an optional :meth:`__post_init__`." +msgstr "" + msgid "" "Returns a tuple of :class:`Field` objects that define the fields for this " "dataclass. Accepts either a dataclass, or an instance of a dataclass. " @@ -379,26 +472,45 @@ msgid "" msgstr "" msgid "" -"Converts the dataclass ``obj`` to a dict (by using the factory function " -"``dict_factory``). Each dataclass is converted to a dict of its fields, as " +"Converts the dataclass *obj* to a dict (by using the factory function " +"*dict_factory*). Each dataclass is converted to a dict of its fields, as " "``name: value`` pairs. dataclasses, dicts, lists, and tuples are recursed " "into. Other objects are copied with :func:`copy.deepcopy`." msgstr "" -msgid "Example of using :func:`asdict` on nested dataclasses::" +msgid "Example of using :func:`!asdict` on nested dataclasses::" +msgstr "" + +msgid "" +"@dataclass\n" +"class Point:\n" +" x: int\n" +" y: int\n" +"\n" +"@dataclass\n" +"class C:\n" +" mylist: list[Point]\n" +"\n" +"p = Point(10, 20)\n" +"assert asdict(p) == {'x': 10, 'y': 20}\n" +"\n" +"c = C([Point(0, 0), Point(10, 4)])\n" +"assert asdict(c) == {'mylist': [{'x': 0, 'y': 0}, {'x': 10, 'y': 4}]}" msgstr "" msgid "To create a shallow copy, the following workaround may be used::" msgstr "" +msgid "{field.name: getattr(obj, field.name) for field in fields(obj)}" +msgstr "" + msgid "" -":func:`asdict` raises :exc:`TypeError` if ``obj`` is not a dataclass " -"instance." +":func:`!asdict` raises :exc:`TypeError` if *obj* is not a dataclass instance." msgstr "" msgid "" -"Converts the dataclass ``obj`` to a tuple (by using the factory function " -"``tuple_factory``). Each dataclass is converted to a tuple of its field " +"Converts the dataclass *obj* to a tuple (by using the factory function " +"*tuple_factory*). Each dataclass is converted to a tuple of its field " "values. dataclasses, dicts, lists, and tuples are recursed into. Other " "objects are copied with :func:`copy.deepcopy`." msgstr "" @@ -407,68 +519,105 @@ msgid "Continuing from the previous example::" msgstr "" msgid "" -":func:`astuple` raises :exc:`TypeError` if ``obj`` is not a dataclass " +"assert astuple(p) == (10, 20)\n" +"assert astuple(c) == ([(0, 0), (10, 4)],)" +msgstr "" + +msgid "tuple(getattr(obj, field.name) for field in dataclasses.fields(obj))" +msgstr "" + +msgid "" +":func:`!astuple` raises :exc:`TypeError` if *obj* is not a dataclass " "instance." msgstr "" msgid "" -"Creates a new dataclass with name ``cls_name``, fields as defined in " -"``fields``, base classes as given in ``bases``, and initialized with a " -"namespace as given in ``namespace``. ``fields`` is an iterable whose " -"elements are each either ``name``, ``(name, type)``, or ``(name, type, " -"Field)``. If just ``name`` is supplied, ``typing.Any`` is used for " -"``type``. The values of ``init``, ``repr``, ``eq``, ``order``, " -"``unsafe_hash``, ``frozen``, ``match_args``, ``kw_only``, ``slots``, and " -"``weakref_slot`` have the same meaning as they do in :func:`dataclass`." +"Creates a new dataclass with name *cls_name*, fields as defined in *fields*, " +"base classes as given in *bases*, and initialized with a namespace as given " +"in *namespace*. *fields* is an iterable whose elements are each either " +"``name``, ``(name, type)``, or ``(name, type, Field)``. If just ``name`` is " +"supplied, :data:`typing.Any` is used for ``type``. The values of *init*, " +"*repr*, *eq*, *order*, *unsafe_hash*, *frozen*, *match_args*, *kw_only*, " +"*slots*, and *weakref_slot* have the same meaning as they do " +"in :func:`@dataclass `." +msgstr "" + +msgid "" +"If *module* is defined, the :attr:`!__module__` attribute of the dataclass " +"is set to that value. By default, it is set to the module name of the caller." msgstr "" msgid "" "This function is not strictly required, because any Python mechanism for " -"creating a new class with ``__annotations__`` can then apply the :func:" -"`dataclass` function to convert that class to a dataclass. This function is " -"provided as a convenience. For example::" +"creating a new class with :attr:`!__annotations__` can then apply " +"the :func:`@dataclass ` function to convert that class to a " +"dataclass. This function is provided as a convenience. For example::" +msgstr "" + +msgid "" +"C = make_dataclass('C',\n" +" [('x', int),\n" +" 'y',\n" +" ('z', int, field(default=5))],\n" +" namespace={'add_one': lambda self: self.x + 1})" msgstr "" msgid "Is equivalent to::" msgstr "" msgid "" -"Creates a new object of the same type as ``obj``, replacing fields with " -"values from ``changes``. If ``obj`` is not a Data Class, raises :exc:" -"`TypeError`. If values in ``changes`` do not specify fields, raises :exc:" -"`TypeError`." +"@dataclass\n" +"class C:\n" +" x: int\n" +" y: 'typing.Any'\n" +" z: int = 5\n" +"\n" +" def add_one(self):\n" +" return self.x + 1" +msgstr "" + +msgid "" +"Creates a new object of the same type as *obj*, replacing fields with values " +"from *changes*. If *obj* is not a Data Class, raises :exc:`TypeError`. If " +"keys in *changes* are not field names of the given dataclass, " +"raises :exc:`TypeError`." msgstr "" msgid "" "The newly returned object is created by calling the :meth:`~object.__init__` " -"method of the dataclass. This ensures that :ref:`__post_init__ `, if present, is also called." +"method of the dataclass. This ensures that :meth:`__post_init__`, if " +"present, is also called." msgstr "" msgid "" "Init-only variables without default values, if any exist, must be specified " -"on the call to :func:`replace` so that they can be passed to :meth:`~object." -"__init__` and :ref:`__post_init__ `." +"on the call to :func:`!replace` so that they can be passed to :meth:`!" +"__init__` and :meth:`__post_init__`." msgstr "" msgid "" -"It is an error for ``changes`` to contain any fields that are defined as " +"It is an error for *changes* to contain any fields that are defined as " "having ``init=False``. A :exc:`ValueError` will be raised in this case." msgstr "" msgid "" -"Be forewarned about how ``init=False`` fields work during a call to :func:" -"`replace`. They are not copied from the source object, but rather are " -"initialized in :ref:`__post_init__ `, if they're " -"initialized at all. It is expected that ``init=False`` fields will be " -"rarely and judiciously used. If they are used, it might be wise to have " -"alternate class constructors, or perhaps a custom ``replace()`` (or " -"similarly named) method which handles instance copying." +"Be forewarned about how ``init=False`` fields work during a call to :func:`!" +"replace`. They are not copied from the source object, but rather are " +"initialized in :meth:`__post_init__`, if they're initialized at all. It is " +"expected that ``init=False`` fields will be rarely and judiciously used. If " +"they are used, it might be wise to have alternate class constructors, or " +"perhaps a custom :func:`!replace` (or similarly named) method which handles " +"instance copying." msgstr "" msgid "" -"Return ``True`` if its parameter is a dataclass or an instance of one, " -"otherwise return ``False``." +"Dataclass instances are also supported by generic " +"function :func:`copy.replace`." +msgstr "" + +msgid "" +"Return ``True`` if its parameter is a dataclass (including subclasses of a " +"dataclass) or an instance of one, otherwise return ``False``." msgstr "" msgid "" @@ -477,17 +626,22 @@ msgid "" "type)``::" msgstr "" +msgid "" +"def is_dataclass_instance(obj):\n" +" return is_dataclass(obj) and not isinstance(obj, type)" +msgstr "" + msgid "A sentinel value signifying a missing default or default_factory." msgstr "" msgid "" "A sentinel value used as a type annotation. Any fields after a pseudo-field " -"with the type of :const:`KW_ONLY` are marked as keyword-only fields. Note " -"that a pseudo-field of type :const:`KW_ONLY` is otherwise completely " +"with the type of :const:`!KW_ONLY` are marked as keyword-only fields. Note " +"that a pseudo-field of type :const:`!KW_ONLY` is otherwise completely " "ignored. This includes the name of such a field. By convention, a name of " -"``_`` is used for a :const:`KW_ONLY` field. Keyword-only fields signify :" -"meth:`~object.__init__` parameters that must be specified as keywords when " -"the class is instantiated." +"``_`` is used for a :const:`!KW_ONLY` field. Keyword-only fields " +"signify :meth:`~object.__init__` parameters that must be specified as " +"keywords when the class is instantiated." msgstr "" msgid "" @@ -495,28 +649,38 @@ msgid "" "fields::" msgstr "" +msgid "" +"@dataclass\n" +"class Point:\n" +" x: float\n" +" _: KW_ONLY\n" +" y: float\n" +" z: float\n" +"\n" +"p = Point(0, y=1.5, z=2.0)" +msgstr "" + msgid "" "In a single dataclass, it is an error to specify more than one field whose " -"type is :const:`KW_ONLY`." +"type is :const:`!KW_ONLY`." msgstr "" msgid "" -"Raised when an implicitly defined :meth:`~object.__setattr__` or :meth:" -"`~object.__delattr__` is called on a dataclass which was defined with " -"``frozen=True``. It is a subclass of :exc:`AttributeError`." +"Raised when an implicitly defined :meth:`~object.__setattr__` " +"or :meth:`~object.__delattr__` is called on a dataclass which was defined " +"with ``frozen=True``. It is a subclass of :exc:`AttributeError`." msgstr "" msgid "Post-init processing" msgstr "" msgid "" -"The generated :meth:`~object.__init__` code will call a method named :meth:`!" -"__post_init__`, if :meth:`!__post_init__` is defined on the class. It will " -"normally be called as ``self.__post_init__()``. However, if any ``InitVar`` " -"fields are defined, they will also be passed to :meth:`!__post_init__` in " -"the order they were defined in the class. If no :meth:`~object.__init__` " -"method is generated, then :meth:`!__post_init__` will not automatically be " -"called." +"When defined on the class, it will be called by the " +"generated :meth:`~object.__init__`, normally as :meth:`!self.__post_init__`. " +"However, if any ``InitVar`` fields are defined, they will also be passed " +"to :meth:`!__post_init__` in the order they were defined in the class. If " +"no :meth:`!__init__` method is generated, then :meth:`!__post_init__` will " +"not automatically be called." msgstr "" msgid "" @@ -525,22 +689,46 @@ msgid "" msgstr "" msgid "" -"The :meth:`~object.__init__` method generated by :func:`dataclass` does not " -"call base class :meth:`~object.__init__` methods. If the base class has an :" -"meth:`~object.__init__` method that has to be called, it is common to call " -"this method in a :meth:`!__post_init__` method::" +"@dataclass\n" +"class C:\n" +" a: float\n" +" b: float\n" +" c: float = field(init=False)\n" +"\n" +" def __post_init__(self):\n" +" self.c = self.a + self.b" +msgstr "" + +msgid "" +"The :meth:`~object.__init__` method generated by :func:`@dataclass " +"` does not call base class :meth:`!__init__` methods. If the base " +"class has an :meth:`!__init__` method that has to be called, it is common to " +"call this method in a :meth:`__post_init__` method::" +msgstr "" + +msgid "" +"class Rectangle:\n" +" def __init__(self, height, width):\n" +" self.height = height\n" +" self.width = width\n" +"\n" +"@dataclass\n" +"class Square(Rectangle):\n" +" side: float\n" +"\n" +" def __post_init__(self):\n" +" super().__init__(self.side, self.side)" msgstr "" msgid "" -"Note, however, that in general the dataclass-generated :meth:`~object." -"__init__` methods don't need to be called, since the derived dataclass will " -"take care of initializing all fields of any base class that is a dataclass " -"itself." +"Note, however, that in general the dataclass-generated :meth:`!__init__` " +"methods don't need to be called, since the derived dataclass will take care " +"of initializing all fields of any base class that is a dataclass itself." msgstr "" msgid "" -"See the section below on init-only variables for ways to pass parameters to :" -"meth:`!__post_init__`. Also see the warning about how :func:`replace` " +"See the section below on init-only variables for ways to pass parameters " +"to :meth:`!__post_init__`. Also see the warning about how :func:`replace` " "handles ``init=False`` fields." msgstr "" @@ -548,27 +736,28 @@ msgid "Class variables" msgstr "" msgid "" -"One of the few places where :func:`dataclass` actually inspects the type of " -"a field is to determine if a field is a class variable as defined in :pep:" -"`526`. It does this by checking if the type of the field is ``typing." -"ClassVar``. If a field is a ``ClassVar``, it is excluded from consideration " -"as a field and is ignored by the dataclass mechanisms. Such ``ClassVar`` " -"pseudo-fields are not returned by the module-level :func:`fields` function." +"One of the few places where :func:`@dataclass ` actually inspects " +"the type of a field is to determine if a field is a class variable as " +"defined in :pep:`526`. It does this by checking if the type of the field " +"is :data:`typing.ClassVar`. If a field is a ``ClassVar``, it is excluded " +"from consideration as a field and is ignored by the dataclass mechanisms. " +"Such ``ClassVar`` pseudo-fields are not returned by the module-" +"level :func:`fields` function." msgstr "" msgid "Init-only variables" msgstr "" msgid "" -"Another place where :func:`dataclass` inspects a type annotation is to " -"determine if a field is an init-only variable. It does this by seeing if " -"the type of a field is of type ``dataclasses.InitVar``. If a field is an " -"``InitVar``, it is considered a pseudo-field called an init-only field. As " -"it is not a true field, it is not returned by the module-level :func:" -"`fields` function. Init-only fields are added as parameters to the " -"generated :meth:`~object.__init__` method, and are passed to the optional :" -"ref:`__post_init__ ` method. They are not otherwise " -"used by dataclasses." +"Another place where :func:`@dataclass ` inspects a type " +"annotation is to determine if a field is an init-only variable. It does " +"this by seeing if the type of a field is of type :class:`InitVar`. If a " +"field is an :class:`InitVar`, it is considered a pseudo-field called an init-" +"only field. As it is not a true field, it is not returned by the module-" +"level :func:`fields` function. Init-only fields are added as parameters to " +"the generated :meth:`~object.__init__` method, and are passed to the " +"optional :meth:`__post_init__` method. They are not otherwise used by " +"dataclasses." msgstr "" msgid "" @@ -577,8 +766,22 @@ msgid "" msgstr "" msgid "" -"In this case, :func:`fields` will return :class:`Field` objects for ``i`` " -"and ``j``, but not for ``database``." +"@dataclass\n" +"class C:\n" +" i: int\n" +" j: int | None = None\n" +" database: InitVar[DatabaseType | None] = None\n" +"\n" +" def __post_init__(self, database):\n" +" if self.j is None and database is not None:\n" +" self.j = database.lookup('j')\n" +"\n" +"c = C(10, database=my_database)" +msgstr "" + +msgid "" +"In this case, :func:`fields` will return :class:`Field` objects for :attr:`!" +"i` and :attr:`!j`, but not for :attr:`!database`." msgstr "" msgid "Frozen instances" @@ -586,42 +789,60 @@ msgstr "" msgid "" "It is not possible to create truly immutable Python objects. However, by " -"passing ``frozen=True`` to the :meth:`dataclass` decorator you can emulate " -"immutability. In that case, dataclasses will add :meth:`~object." -"__setattr__` and :meth:`~object.__delattr__` methods to the class. These " -"methods will raise a :exc:`FrozenInstanceError` when invoked." +"passing ``frozen=True`` to the :func:`@dataclass ` decorator you " +"can emulate immutability. In that case, dataclasses will " +"add :meth:`~object.__setattr__` and :meth:`~object.__delattr__` methods to " +"the class. These methods will raise a :exc:`FrozenInstanceError` when " +"invoked." msgstr "" msgid "" -"There is a tiny performance penalty when using ``frozen=True``: :meth:" -"`~object.__init__` cannot use simple assignment to initialize fields, and " -"must use :meth:`~object.__setattr__`." +"There is a tiny performance penalty when using " +"``frozen=True``: :meth:`~object.__init__` cannot use simple assignment to " +"initialize fields, and must use :meth:`!object.__setattr__`." msgstr "" msgid "Inheritance" +msgstr "Dziedziczenie" + +msgid "" +"When the dataclass is being created by the :func:`@dataclass ` " +"decorator, it looks through all of the class's base classes in reverse MRO " +"(that is, starting at :class:`object`) and, for each dataclass that it " +"finds, adds the fields from that base class to an ordered mapping of fields. " +"After all of the base class fields are added, it adds its own fields to the " +"ordered mapping. All of the generated methods will use this combined, " +"calculated ordered mapping of fields. Because the fields are in insertion " +"order, derived classes override base classes. An example::" msgstr "" msgid "" -"When the dataclass is being created by the :meth:`dataclass` decorator, it " -"looks through all of the class's base classes in reverse MRO (that is, " -"starting at :class:`object`) and, for each dataclass that it finds, adds the " -"fields from that base class to an ordered mapping of fields. After all of " -"the base class fields are added, it adds its own fields to the ordered " -"mapping. All of the generated methods will use this combined, calculated " -"ordered mapping of fields. Because the fields are in insertion order, " -"derived classes override base classes. An example::" +"@dataclass\n" +"class Base:\n" +" x: Any = 15.0\n" +" y: int = 0\n" +"\n" +"@dataclass\n" +"class C(Base):\n" +" z: int = 10\n" +" x: int = 15" msgstr "" msgid "" -"The final list of fields is, in order, ``x``, ``y``, ``z``. The final type " -"of ``x`` is ``int``, as specified in class ``C``." +"The final list of fields is, in order, :attr:`!x`, :attr:`!y`, :attr:`!z`. " +"The final type of :attr:`!x` is :class:`int`, as specified in class :class:`!" +"C`." msgstr "" msgid "" -"The generated :meth:`~object.__init__` method for ``C`` will look like::" +"The generated :meth:`~object.__init__` method for :class:`!C` will look " +"like::" msgstr "" -msgid "Re-ordering of keyword-only parameters in :meth:`~object.__init__`" +msgid "def __init__(self, x: int = 15, y: int = 0, z: int = 10):" +msgstr "" + +msgid "Re-ordering of keyword-only parameters in :meth:`!__init__`" msgstr "" msgid "" @@ -632,12 +853,31 @@ msgid "" msgstr "" msgid "" -"In this example, ``Base.y``, ``Base.w``, and ``D.t`` are keyword-only " -"fields, and ``Base.x`` and ``D.z`` are regular fields::" +"In this example, :attr:`!Base.y`, :attr:`!Base.w`, and :attr:`!D.t` are " +"keyword-only fields, and :attr:`!Base.x` and :attr:`!D.z` are regular " +"fields::" msgstr "" msgid "" -"The generated :meth:`~object.__init__` method for ``D`` will look like::" +"@dataclass\n" +"class Base:\n" +" x: Any = 15.0\n" +" _: KW_ONLY\n" +" y: int = 0\n" +" w: int = 1\n" +"\n" +"@dataclass\n" +"class D(Base):\n" +" z: int = 10\n" +" t: int = field(kw_only=True, default=0)" +msgstr "" + +msgid "The generated :meth:`!__init__` method for :class:`!D` will look like::" +msgstr "" + +msgid "" +"def __init__(self, x: Any = 15.0, z: int = 10, *, y: int = 0, w: int = 1, t: " +"int = 0):" msgstr "" msgid "" @@ -648,22 +888,25 @@ msgstr "" msgid "" "The relative ordering of keyword-only parameters is maintained in the re-" -"ordered :meth:`~object.__init__` parameter list." +"ordered :meth:`!__init__` parameter list." msgstr "" msgid "Default factory functions" msgstr "" msgid "" -"If a :func:`field` specifies a ``default_factory``, it is called with zero " +"If a :func:`field` specifies a *default_factory*, it is called with zero " "arguments when a default value for the field is needed. For example, to " "create a new instance of a list, use::" msgstr "" +msgid "mylist: list = field(default_factory=list)" +msgstr "" + msgid "" "If a field is excluded from :meth:`~object.__init__` (using ``init=False``) " -"and the field also specifies ``default_factory``, then the default factory " -"function will always be called from the generated :meth:`~object.__init__` " +"and the field also specifies *default_factory*, then the default factory " +"function will always be called from the generated :meth:`!__init__` " "function. This happens because there is no other way to give the field an " "initial value." msgstr "" @@ -677,26 +920,59 @@ msgid "" msgstr "" msgid "" -"Note that the two instances of class ``C`` share the same class variable " -"``x``, as expected." +"class C:\n" +" x = []\n" +" def add(self, element):\n" +" self.x.append(element)\n" +"\n" +"o1 = C()\n" +"o2 = C()\n" +"o1.add(1)\n" +"o2.add(2)\n" +"assert o1.x == [1, 2]\n" +"assert o1.x is o2.x" +msgstr "" + +msgid "" +"Note that the two instances of class :class:`!C` share the same class " +"variable :attr:`!x`, as expected." msgstr "" msgid "Using dataclasses, *if* this code was valid::" msgstr "" +msgid "" +"@dataclass\n" +"class D:\n" +" x: list = [] # This code raises ValueError\n" +" def add(self, element):\n" +" self.x.append(element)" +msgstr "" + msgid "it would generate code similar to::" msgstr "" msgid "" -"This has the same issue as the original example using class ``C``. That is, " -"two instances of class ``D`` that do not specify a value for ``x`` when " -"creating a class instance will share the same copy of ``x``. Because " -"dataclasses just use normal Python class creation they also share this " -"behavior. There is no general way for Data Classes to detect this " -"condition. Instead, the :func:`dataclass` decorator will raise a :exc:" -"`TypeError` if it detects an unhashable default parameter. The assumption " -"is that if a value is unhashable, it is mutable. This is a partial " -"solution, but it does protect against many common errors." +"class D:\n" +" x = []\n" +" def __init__(self, x=x):\n" +" self.x = x\n" +" def add(self, element):\n" +" self.x.append(element)\n" +"\n" +"assert D().x is D().x" +msgstr "" + +msgid "" +"This has the same issue as the original example using class :class:`!C`. " +"That is, two instances of class :class:`!D` that do not specify a value " +"for :attr:`!x` when creating a class instance will share the same copy " +"of :attr:`!x`. Because dataclasses just use normal Python class creation " +"they also share this behavior. There is no general way for Data Classes to " +"detect this condition. Instead, the :func:`@dataclass ` " +"decorator will raise a :exc:`ValueError` if it detects an unhashable default " +"parameter. The assumption is that if a value is unhashable, it is mutable. " +"This is a partial solution, but it does protect against many common errors." msgstr "" msgid "" @@ -705,9 +981,18 @@ msgid "" msgstr "" msgid "" -"Instead of looking for and disallowing objects of type ``list``, ``dict``, " -"or ``set``, unhashable objects are now not allowed as default values. " -"Unhashability is used to approximate mutability." +"@dataclass\n" +"class D:\n" +" x: list = field(default_factory=list)\n" +"\n" +"assert D().x is not D().x" +msgstr "" + +msgid "" +"Instead of looking for and disallowing objects of " +"type :class:`list`, :class:`dict`, or :class:`set`, unhashable objects are " +"now not allowed as default values. Unhashability is used to approximate " +"mutability." msgstr "" msgid "Descriptor-typed fields" @@ -719,24 +1004,52 @@ msgid "" msgstr "" msgid "" -"The value for the field passed to the dataclass's ``__init__`` method is " -"passed to the descriptor's ``__set__`` method rather than overwriting the " -"descriptor object." +"The value for the field passed to the dataclass's :meth:`~object.__init__` " +"method is passed to the descriptor's :meth:`~object.__set__` method rather " +"than overwriting the descriptor object." +msgstr "" + +msgid "" +"Similarly, when getting or setting the field, the " +"descriptor's :meth:`~object.__get__` or :meth:`!__set__` method is called " +"rather than returning or overwriting the descriptor object." msgstr "" msgid "" -"Similarly, when getting or setting the field, the descriptor's ``__get__`` " -"or ``__set__`` method is called rather than returning or overwriting the " -"descriptor object." +"To determine whether a field contains a default value, :func:`@dataclass " +"` will call the descriptor's :meth:`!__get__` method using its " +"class access form: ``descriptor.__get__(obj=None, type=cls)``. If the " +"descriptor returns a value in this case, it will be used as the field's " +"default. On the other hand, if the descriptor raises :exc:`AttributeError` " +"in this situation, no default value will be provided for the field." msgstr "" msgid "" -"To determine whether a field contains a default value, ``dataclasses`` will " -"call the descriptor's ``__get__`` method using its class access form (i.e. " -"``descriptor.__get__(obj=None, type=cls)``. If the descriptor returns a " -"value in this case, it will be used as the field's default. On the other " -"hand, if the descriptor raises :exc:`AttributeError` in this situation, no " -"default value will be provided for the field." +"class IntConversionDescriptor:\n" +" def __init__(self, *, default):\n" +" self._default = default\n" +"\n" +" def __set_name__(self, owner, name):\n" +" self._name = \"_\" + name\n" +"\n" +" def __get__(self, obj, type):\n" +" if obj is None:\n" +" return self._default\n" +"\n" +" return getattr(obj, self._name, self._default)\n" +"\n" +" def __set__(self, obj, value):\n" +" setattr(obj, self._name, int(value))\n" +"\n" +"@dataclass\n" +"class InventoryItem:\n" +" quantity_on_hand: IntConversionDescriptor = " +"IntConversionDescriptor(default=100)\n" +"\n" +"i = InventoryItem()\n" +"print(i.quantity_on_hand) # 100\n" +"i.quantity_on_hand = 2.5 # calls __set__ with 2.5\n" +"print(i.quantity_on_hand) # 2" msgstr "" msgid "" diff --git a/library/datatypes.po b/library/datatypes.po index ebd872eb35..66d4e694e5 100644 --- a/library/datatypes.po +++ b/library/datatypes.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Maciej Olko , 2022\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,16 +36,17 @@ msgstr "" "enumeratory." msgid "" -"Python also provides some built-in data types, in particular, :class:" -"`dict`, :class:`list`, :class:`set` and :class:`frozenset`, and :class:" -"`tuple`. The :class:`str` class is used to hold Unicode strings, and the :" -"class:`bytes` and :class:`bytearray` classes are used to hold binary data." +"Python also provides some built-in data types, in " +"particular, :class:`dict`, :class:`list`, :class:`set` " +"and :class:`frozenset`, and :class:`tuple`. The :class:`str` class is used " +"to hold Unicode strings, and the :class:`bytes` and :class:`bytearray` " +"classes are used to hold binary data." msgstr "" -"Python posiada również wbudowane typy danych, w szczególności :class:" -"`dict`, :class:`list`, :class:`set` i :class:`frozenset`, i :class:`tuple`. " -"Klasa :class:`str` jest używana do trzymania ciągu znaków unicode, zaś " -"klasy :class:`bytes` i :class:`bytearray` są używane do trzymania danych w " -"formacie binarnym." +"Python posiada również wbudowane typy danych, w " +"szczególności :class:`dict`, :class:`list`, :class:`set` " +"i :class:`frozenset`, i :class:`tuple`. Klasa :class:`str` jest używana do " +"trzymania ciągu znaków unicode, zaś klasy :class:`bytes` " +"i :class:`bytearray` są używane do trzymania danych w formacie binarnym." msgid "The following modules are documented in this chapter:" msgstr "Poszczególne moduły są opisane w rodziale:" diff --git a/library/datetime.po b/library/datetime.po index 9d3ed279c5..0f06526eb4 100644 --- a/library/datetime.po +++ b/library/datetime.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 -# Michał Biliński , 2021 -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 +27,7 @@ msgid ":mod:`!datetime` --- Basic date and time types" msgstr "" msgid "**Source code:** :source:`Lib/datetime.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/datetime.py`" msgid "" "The :mod:`!datetime` module supplies classes for manipulating dates and " @@ -73,9 +70,9 @@ msgid "Package :pypi:`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." +"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" @@ -105,12 +102,12 @@ msgid "" msgstr "" msgid "" -"For applications requiring aware objects, :class:`.datetime` and :class:`." -"time` objects have an optional time zone information attribute, :attr:`!" -"tzinfo`, that can be set to an instance of a subclass of the abstract :class:" -"`tzinfo` class. These :class:`tzinfo` objects capture information about the " -"offset from UTC time, the time zone name, and whether daylight saving time " -"is in effect." +"For applications requiring aware objects, :class:`.datetime` " +"and :class:`.time` objects have an optional time zone information " +"attribute, :attr:`!tzinfo`, that can be set to an instance of a subclass of " +"the abstract :class:`!tzinfo` class. These :class:`tzinfo` objects capture " +"information about the offset from UTC time, the time zone name, and whether " +"daylight saving time is in effect." msgstr "" msgid "" @@ -147,26 +144,27 @@ msgstr "" msgid "" "An idealized naive date, assuming the current Gregorian calendar always was, " -"and always will be, in effect. Attributes: :attr:`year`, :attr:`month`, and :" -"attr:`day`." +"and always will be, in effect. Attributes: :attr:`year`, :attr:`month`, " +"and :attr:`day`." msgstr "" msgid "" "An idealized time, independent of any particular day, assuming that every " "day has exactly 24\\*60\\*60 seconds. (There is no notion of \"leap " -"seconds\" here.) Attributes: :attr:`hour`, :attr:`minute`, :attr:`second`, :" -"attr:`microsecond`, and :attr:`.tzinfo`." +"seconds\" here.) " +"Attributes: :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:`microsecond`, " +"and :attr:`.tzinfo`." msgstr "" msgid "" -"A combination of a date and a time. Attributes: :attr:`year`, :attr:" -"`month`, :attr:`day`, :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:" -"`microsecond`, and :attr:`.tzinfo`." +"A combination of a date and a time. " +"Attributes: :attr:`year`, :attr:`month`, :attr:`day`, :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:`microsecond`, " +"and :attr:`.tzinfo`." msgstr "" msgid "" -"A duration expressing the difference between two :class:`.datetime` or :" -"class:`date` instances to microsecond resolution." +"A duration expressing the difference between two :class:`.datetime` " +"or :class:`date` instances to microsecond resolution." msgstr "" msgid "" @@ -306,8 +304,8 @@ msgid "" msgstr "" msgid "" -">>> from datetime import timedelta\n" -">>> delta = timedelta(\n" +">>> import datetime as dt\n" +">>> delta = dt.timedelta(\n" "... days=50,\n" "... seconds=27,\n" "... microseconds=10,\n" @@ -321,6 +319,13 @@ msgid "" "datetime.timedelta(days=64, seconds=29156, microseconds=10)" msgstr "" +msgid "" +"``import datetime as dt`` instead of ``import datetime`` or ``from datetime " +"import datetime`` to avoid confusion between the module and the class. See " +"`How I Import Python’s datetime Module `__." +msgstr "" + msgid "" "If any argument is a float and there are fractional microseconds, the " "fractional microseconds left over from all arguments are combined and their " @@ -330,8 +335,8 @@ msgid "" msgstr "" msgid "" -"If the normalized value of days lies outside the indicated range, :exc:" -"`OverflowError` is raised." +"If the normalized value of days lies outside the indicated " +"range, :exc:`OverflowError` is raised." msgstr "" msgid "" @@ -340,12 +345,30 @@ msgid "" msgstr "" msgid "" -">>> from datetime import timedelta\n" -">>> d = timedelta(microseconds=-1)\n" +">>> import datetime as dt\n" +">>> d = dt.timedelta(microseconds=-1)\n" ">>> (d.days, d.seconds, d.microseconds)\n" "(-1, 86399, 999999)" msgstr "" +msgid "" +"Since the string representation of :class:`!timedelta` objects can be " +"confusing, use the following recipe to produce a more readable format:" +msgstr "" + +msgid "" +">>> def pretty_timedelta(td):\n" +"... if td.days >= 0:\n" +"... return str(td)\n" +"... return f'-({-td!s})'\n" +"...\n" +">>> d = timedelta(hours=-1)\n" +">>> str(d) # not human-friendly\n" +"'-1 day, 23:00:00'\n" +">>> pretty_timedelta(d)\n" +"'-(1:00:00)'" +msgstr "" + msgid "Class attributes:" msgstr "" @@ -364,8 +387,8 @@ msgstr "" msgid "" "Note that, because of normalization, ``timedelta.max`` is greater than ``-" -"timedelta.min``. ``-timedelta.max`` is not representable as a :class:" -"`timedelta` object." +"timedelta.min``. ``-timedelta.max`` is not representable as " +"a :class:`timedelta` object." msgstr "" msgid "Instance attributes (read-only):" @@ -384,8 +407,8 @@ msgid "" msgstr "" msgid "" -">>> from datetime import timedelta\n" -">>> duration = timedelta(seconds=11235813)\n" +">>> import datetime as dt\n" +">>> duration = dt.timedelta(seconds=11235813)\n" ">>> duration.days, duration.seconds\n" "(130, 3813)\n" ">>> duration.total_seconds()\n" @@ -443,8 +466,8 @@ msgid "``f = t2 / t3``" msgstr "" msgid "" -"Division (3) of overall duration ``t2`` by interval unit ``t3``. Returns a :" -"class:`float` object." +"Division (3) of overall duration ``t2`` by interval unit ``t3``. Returns " +"a :class:`float` object." msgstr "" msgid "``t1 = t2 / f or t1 = t2 / i``" @@ -555,15 +578,15 @@ msgstr "" msgid "" "In addition to the operations listed above, :class:`timedelta` objects " -"support certain additions and subtractions with :class:`date` and :class:`." -"datetime` objects (see below)." +"support certain additions and subtractions with :class:`date` " +"and :class:`.datetime` objects (see below)." msgstr "" msgid "" -"Floor division and true division of a :class:`timedelta` object by another :" -"class:`timedelta` object are now supported, as are remainder operations and " -"the :func:`divmod` function. True division and multiplication of a :class:" -"`timedelta` object by a :class:`float` object are now supported." +"Floor division and true division of a :class:`timedelta` object by " +"another :class:`!timedelta` object are now supported, as are remainder " +"operations and the :func:`divmod` function. True division and multiplication " +"of a :class:`!timedelta` object by a :class:`float` object are now supported." msgstr "" msgid ":class:`timedelta` objects support equality and order comparisons." @@ -596,10 +619,10 @@ msgstr "" msgid "" ">>> # Components of another_year add up to exactly 365 days\n" -">>> from datetime import timedelta\n" -">>> year = timedelta(days=365)\n" -">>> another_year = timedelta(weeks=40, days=84, hours=23,\n" -"... minutes=50, seconds=600)\n" +">>> import datetime as dt\n" +">>> year = dt.timedelta(days=365)\n" +">>> another_year = dt.timedelta(weeks=40, days=84, hours=23,\n" +"... minutes=50, seconds=600)\n" ">>> year == another_year\n" "True\n" ">>> year.total_seconds()\n" @@ -610,8 +633,8 @@ msgid "Examples of :class:`timedelta` arithmetic::" msgstr "" msgid "" -">>> from datetime import timedelta\n" -">>> year = timedelta(days=365)\n" +">>> import datetime as dt\n" +">>> year = dt.timedelta(days=365)\n" ">>> ten_years = 10 * year\n" ">>> ten_years\n" "datetime.timedelta(days=3650)\n" @@ -673,18 +696,18 @@ msgstr "" msgid "" "This may raise :exc:`OverflowError`, if the timestamp is out of the range of " -"values supported by the platform C :c:func:`localtime` function, and :exc:" -"`OSError` on :c:func:`localtime` failure. It's common for this to be " -"restricted to years from 1970 through 2038. Note that on non-POSIX systems " -"that include leap seconds in their notion of a timestamp, leap seconds are " -"ignored by :meth:`fromtimestamp`." +"values supported by the platform C :c:func:`localtime` function, " +"and :exc:`OSError` on :c:func:`localtime` failure. It's common for this to " +"be restricted to years from 1970 through 2038. Note that on non-POSIX " +"systems that include leap seconds in their notion of a timestamp, leap " +"seconds are ignored by :meth:`fromtimestamp`." msgstr "" msgid "" "Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is " "out of the range of values supported by the platform C :c:func:`localtime` " -"function. Raise :exc:`OSError` instead of :exc:`ValueError` on :c:func:" -"`localtime` failure." +"function. Raise :exc:`OSError` instead of :exc:`ValueError` " +"on :c:func:`localtime` failure." msgstr "" msgid "" @@ -718,12 +741,12 @@ msgid "Examples::" msgstr "Przykłady::" msgid "" -">>> from datetime import date\n" -">>> date.fromisoformat('2019-12-04')\n" +">>> import datetime as dt\n" +">>> dt.date.fromisoformat('2019-12-04')\n" "datetime.date(2019, 12, 4)\n" -">>> date.fromisoformat('20191204')\n" +">>> dt.date.fromisoformat('20191204')\n" "datetime.date(2019, 12, 4)\n" -">>> date.fromisoformat('2021-W01-1')\n" +">>> dt.date.fromisoformat('2021-W01-1')\n" "datetime.date(2021, 1, 4)" msgstr "" @@ -732,8 +755,8 @@ msgstr "" msgid "" "Return a :class:`date` corresponding to the ISO calendar date specified by " -"year, week and day. This is the inverse of the function :meth:`date." -"isocalendar`." +"year, week and day. This is the inverse of the " +"function :meth:`date.isocalendar`." msgstr "" msgid "The earliest representable date, ``date(MINYEAR, 1, 1)``." @@ -801,17 +824,17 @@ msgstr "" msgid "" "*date2* is moved forward in time if ``timedelta.days > 0``, or backward if " "``timedelta.days < 0``. Afterward ``date2 - date1 == timedelta.days``. " -"``timedelta.seconds`` and ``timedelta.microseconds`` are ignored. :exc:" -"`OverflowError` is raised if ``date2.year`` would be smaller than :const:" -"`MINYEAR` or larger than :const:`MAXYEAR`." +"``timedelta.seconds`` and ``timedelta.microseconds`` are " +"ignored. :exc:`OverflowError` is raised if ``date2.year`` would be smaller " +"than :const:`MINYEAR` or larger than :const:`MAXYEAR`." msgstr "" msgid "``timedelta.seconds`` and ``timedelta.microseconds`` are ignored." msgstr "" msgid "" -"This is exact, and cannot overflow. ``timedelta.seconds`` and ``timedelta." -"microseconds`` are 0, and ``date2 + timedelta == date1`` after." +"This is exact, and cannot overflow. ``timedelta.seconds`` and " +"``timedelta.microseconds`` are 0, and ``date2 + timedelta == date1`` after." msgstr "" msgid ":class:`date` objects are equal if they represent the same date." @@ -830,16 +853,17 @@ msgid "" msgstr "" msgid "" -"Order comparison between a :class:`!date` object that is not also a :class:`." -"datetime` instance and a :class:`!datetime` object raises :exc:`TypeError`." +"Order comparison between a :class:`date` object that is not also " +"a :class:`.datetime` instance and a :class:`!datetime` object " +"raises :exc:`TypeError`." msgstr "" msgid "" -"Comparison between :class:`.datetime` object and an instance of the :class:" -"`date` subclass that is not a :class:`!datetime` subclass no longer converts " -"the latter to :class:`!date`, ignoring the time part and the time zone. The " -"default behavior can be changed by overriding the special comparison methods " -"in subclasses." +"Comparison between :class:`.datetime` object and an instance of " +"the :class:`date` subclass that is not a :class:`!datetime` subclass no " +"longer converts the latter to :class:`!date`, ignoring the time part and the " +"time zone. The default behavior can be changed by overriding the special " +"comparison methods in subclasses." msgstr "" msgid "" @@ -855,8 +879,8 @@ msgid "Example::" msgstr "Przykład::" msgid "" -">>> from datetime import date\n" -">>> d = date(2002, 12, 31)\n" +">>> import datetime as dt\n" +">>> d = dt.date(2002, 12, 31)\n" ">>> d.replace(day=26)\n" "datetime.date(2002, 12, 26)" msgstr "" @@ -867,8 +891,8 @@ msgid "" msgstr "" msgid "" -"Return a :class:`time.struct_time` such as returned by :func:`time." -"localtime`." +"Return a :class:`time.struct_time` such as returned " +"by :func:`time.localtime`." msgstr "" msgid "The hours, minutes and seconds are 0, and the DST flag is -1." @@ -888,20 +912,20 @@ msgstr "" msgid "" "Return the proleptic Gregorian ordinal of the date, where January 1 of year " -"1 has ordinal 1. For any :class:`date` object ``d``, ``date.fromordinal(d." -"toordinal()) == d``." +"1 has ordinal 1. For any :class:`date` object ``d``, " +"``date.fromordinal(d.toordinal()) == d``." msgstr "" msgid "" "Return the day of the week as an integer, where Monday is 0 and Sunday is 6. " -"For example, ``date(2002, 12, 4).weekday() == 2``, a Wednesday. See also :" -"meth:`isoweekday`." +"For example, ``date(2002, 12, 4).weekday() == 2``, a Wednesday. See " +"also :meth:`isoweekday`." msgstr "" msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " -"For example, ``date(2002, 12, 4).isoweekday() == 3``, a Wednesday. See also :" -"meth:`weekday`, :meth:`isocalendar`." +"For example, ``date(2002, 12, 4).isoweekday() == 3``, a Wednesday. See " +"also :meth:`weekday`, :meth:`isocalendar`." msgstr "" msgid "" @@ -927,10 +951,10 @@ msgid "" msgstr "" msgid "" -">>> from datetime import date\n" -">>> date(2003, 12, 29).isocalendar()\n" +">>> import datetime as dt\n" +">>> dt.date(2003, 12, 29).isocalendar()\n" "datetime.IsoCalendarDate(year=2004, week=1, weekday=1)\n" -">>> date(2004, 1, 4).isocalendar()\n" +">>> dt.date(2004, 1, 4).isocalendar()\n" "datetime.IsoCalendarDate(year=2004, week=1, weekday=7)" msgstr "" @@ -942,13 +966,10 @@ msgid "" msgstr "" msgid "" -">>> from datetime import date\n" -">>> date(2002, 12, 4).isoformat()\n" +">>> import datetime as dt\n" +">>> dt.date(2002, 12, 4).isoformat()\n" "'2002-12-04'" msgstr "" -">>> from datetime import date\n" -">>> date(2002, 12, 4).isoformat()\n" -"'2002-12-04'" msgid "For a date ``d``, ``str(d)`` is equivalent to ``d.isoformat()``." msgstr "" @@ -957,8 +978,8 @@ msgid "Return a string representing the date::" msgstr "" msgid "" -">>> from datetime import date\n" -">>> date(2002, 12, 4).ctime()\n" +">>> import datetime as dt\n" +">>> dt.date(2002, 12, 4).ctime()\n" "'Wed Dec 4 00:00:00 2002'" msgstr "" @@ -969,16 +990,16 @@ msgid "time.ctime(time.mktime(d.timetuple()))" msgstr "" msgid "" -"on platforms where the native C :c:func:`ctime` function (which :func:`time." -"ctime` invokes, but which :meth:`date.ctime` does not invoke) conforms to " -"the C standard." +"on platforms where the native C :c:func:`ctime` function " +"(which :func:`time.ctime` invokes, but which :meth:`date.ctime` does not " +"invoke) conforms to the C standard." msgstr "" msgid "" "Return a string representing the date, controlled by an explicit format " "string. Format codes referring to hours, minutes or seconds will see 0 " -"values. See also :ref:`strftime-strptime-behavior` and :meth:`date." -"isoformat`." +"values. See also :ref:`strftime-strptime-behavior` " +"and :meth:`date.isoformat`." msgstr "" msgid "" @@ -996,13 +1017,13 @@ msgstr "" msgid "" ">>> import time\n" -">>> from datetime import date\n" -">>> today = date.today()\n" +">>> import datetime as dt\n" +">>> today = dt.date.today()\n" ">>> today\n" "datetime.date(2007, 12, 5)\n" -">>> today == date.fromtimestamp(time.time())\n" +">>> today == dt.date.fromtimestamp(time.time())\n" "True\n" -">>> my_birthday = date(today.year, 6, 24)\n" +">>> my_birthday = dt.date(today.year, 6, 24)\n" ">>> if my_birthday < today:\n" "... my_birthday = my_birthday.replace(year=today.year + 1)\n" "...\n" @@ -1017,8 +1038,8 @@ msgid "More examples of working with :class:`date`:" msgstr "" msgid "" -">>> from datetime import date\n" -">>> d = date.fromordinal(730920) # 730920th day after 1. 1. 0001\n" +">>> import datetime as dt\n" +">>> d = dt.date.fromordinal(730920) # 730920th day after 1. 1. 0001\n" ">>> d\n" "datetime.date(2002, 3, 11)\n" "\n" @@ -1070,7 +1091,7 @@ msgstr "" msgid "" "Like a :class:`date` object, :class:`.datetime` assumes the current " "Gregorian calendar extended in both directions; like a :class:`.time` " -"object, :class:`.datetime` assumes there are exactly 3600\\*24 seconds in " +"object, :class:`!datetime` assumes there are exactly 3600\\*24 seconds in " "every day." msgstr "" @@ -1131,10 +1152,11 @@ msgid "Return the current local date and time." msgstr "" msgid "" -"If optional argument *tz* is ``None`` or not specified, this is like :meth:" -"`today`, but, if possible, supplies more precision than can be gotten from " -"going through a :func:`time.time` timestamp (for example, this may be " -"possible on platforms supplying the C :c:func:`gettimeofday` function)." +"If optional argument *tz* is ``None`` or not specified, this is " +"like :meth:`today`, but, if possible, supplies more precision than can be " +"gotten from going through a :func:`time.time` timestamp (for example, this " +"may be possible on platforms supplying the C :c:func:`gettimeofday` " +"function)." msgstr "" msgid "" @@ -1184,20 +1206,20 @@ msgstr "" msgid "" ":meth:`fromtimestamp` may raise :exc:`OverflowError`, if the timestamp is " "out of the range of values supported by the platform C :c:func:`localtime` " -"or :c:func:`gmtime` functions, and :exc:`OSError` on :c:func:`localtime` or :" -"c:func:`gmtime` failure. It's common for this to be restricted to years in " -"1970 through 2038. Note that on non-POSIX systems that include leap seconds " -"in their notion of a timestamp, leap seconds are ignored by :meth:" -"`fromtimestamp`, and then it's possible to have two timestamps differing by " -"a second that yield identical :class:`.datetime` objects. This method is " -"preferred over :meth:`utcfromtimestamp`." +"or :c:func:`gmtime` functions, and :exc:`OSError` on :c:func:`localtime` " +"or :c:func:`gmtime` failure. It's common for this to be restricted to years " +"in 1970 through 2038. Note that on non-POSIX systems that include leap " +"seconds in their notion of a timestamp, leap seconds are ignored " +"by :meth:`fromtimestamp`, and then it's possible to have two timestamps " +"differing by a second that yield identical :class:`.datetime` objects. This " +"method is preferred over :meth:`utcfromtimestamp`." msgstr "" msgid "" "Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is " "out of the range of values supported by the platform C :c:func:`localtime` " -"or :c:func:`gmtime` functions. Raise :exc:`OSError` instead of :exc:" -"`ValueError` on :c:func:`localtime` or :c:func:`gmtime` failure." +"or :c:func:`gmtime` functions. Raise :exc:`OSError` instead " +"of :exc:`ValueError` on :c:func:`localtime` or :c:func:`gmtime` failure." msgstr "" msgid ":meth:`fromtimestamp` may return instances with :attr:`.fold` set to 1." @@ -1210,9 +1232,9 @@ msgstr "" msgid "" "This may raise :exc:`OverflowError`, if the timestamp is out of the range of " -"values supported by the platform C :c:func:`gmtime` function, and :exc:" -"`OSError` on :c:func:`gmtime` failure. It's common for this to be restricted " -"to years in 1970 through 2038." +"values supported by the platform C :c:func:`gmtime` function, " +"and :exc:`OSError` on :c:func:`gmtime` failure. It's common for this to be " +"restricted to years in 1970 through 2038." msgstr "" msgid "To get an aware :class:`.datetime` object, call :meth:`fromtimestamp`::" @@ -1231,8 +1253,8 @@ msgid "" msgstr "" msgid "" -"except the latter formula always supports the full years range: between :" -"const:`MINYEAR` and :const:`MAXYEAR` inclusive." +"except the latter formula always supports the full years range: " +"between :const:`MINYEAR` and :const:`MAXYEAR` inclusive." msgstr "" msgid "" @@ -1246,8 +1268,8 @@ msgstr "" msgid "" "Raise :exc:`OverflowError` instead of :exc:`ValueError` if the timestamp is " "out of the range of values supported by the platform C :c:func:`gmtime` " -"function. Raise :exc:`OSError` instead of :exc:`ValueError` on :c:func:" -"`gmtime` failure." +"function. Raise :exc:`OSError` instead of :exc:`ValueError` " +"on :c:func:`gmtime` failure." msgstr "" msgid "Use :meth:`datetime.fromtimestamp` with :const:`UTC` instead." @@ -1267,13 +1289,13 @@ msgid "" "given :class:`.time` object's. If the *tzinfo* argument is provided, its " "value is used to set the :attr:`.tzinfo` attribute of the result, otherwise " "the :attr:`~.time.tzinfo` attribute of the *time* argument is used. If the " -"*date* argument is a :class:`.datetime` object, its time components and :" -"attr:`.tzinfo` attributes are ignored." +"*date* argument is a :class:`!datetime` object, its time components " +"and :attr:`.tzinfo` attributes are ignored." msgstr "" msgid "" -"For any :class:`.datetime` object ``d``, ``d == datetime.combine(d.date(), d." -"time(), d.tzinfo)``." +"For any :class:`.datetime` object ``d``, ``d == datetime.combine(d.date(), " +"d.time(), d.tzinfo)``." msgstr "" msgid "Added the *tzinfo* argument." @@ -1294,39 +1316,39 @@ msgid "Fractional hours and minutes are not supported." msgstr "" msgid "" -">>> from datetime import datetime\n" -">>> datetime.fromisoformat('2011-11-04')\n" +">>> import datetime as dt\n" +">>> dt.datetime.fromisoformat('2011-11-04')\n" "datetime.datetime(2011, 11, 4, 0, 0)\n" -">>> datetime.fromisoformat('20111104')\n" +">>> dt.datetime.fromisoformat('20111104')\n" "datetime.datetime(2011, 11, 4, 0, 0)\n" -">>> datetime.fromisoformat('2011-11-04T00:05:23')\n" +">>> dt.datetime.fromisoformat('2011-11-04T00:05:23')\n" "datetime.datetime(2011, 11, 4, 0, 5, 23)\n" -">>> datetime.fromisoformat('2011-11-04T00:05:23Z')\n" +">>> dt.datetime.fromisoformat('2011-11-04T00:05:23Z')\n" "datetime.datetime(2011, 11, 4, 0, 5, 23, tzinfo=datetime.timezone.utc)\n" -">>> datetime.fromisoformat('20111104T000523')\n" +">>> dt.datetime.fromisoformat('20111104T000523')\n" "datetime.datetime(2011, 11, 4, 0, 5, 23)\n" -">>> datetime.fromisoformat('2011-W01-2T00:05:23.283')\n" +">>> dt.datetime.fromisoformat('2011-W01-2T00:05:23.283')\n" "datetime.datetime(2011, 1, 4, 0, 5, 23, 283000)\n" -">>> datetime.fromisoformat('2011-11-04 00:05:23.283')\n" +">>> dt.datetime.fromisoformat('2011-11-04 00:05:23.283')\n" "datetime.datetime(2011, 11, 4, 0, 5, 23, 283000)\n" -">>> datetime.fromisoformat('2011-11-04 00:05:23.283+00:00')\n" -"datetime.datetime(2011, 11, 4, 0, 5, 23, 283000, tzinfo=datetime.timezone." -"utc)\n" -">>> datetime.fromisoformat('2011-11-04T00:05:23+04:00')\n" +">>> dt.datetime.fromisoformat('2011-11-04 00:05:23.283+00:00')\n" +"datetime.datetime(2011, 11, 4, 0, 5, 23, 283000, " +"tzinfo=datetime.timezone.utc)\n" +">>> dt.datetime.fromisoformat('2011-11-04T00:05:23+04:00')\n" "datetime.datetime(2011, 11, 4, 0, 5, 23,\n" " tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))" msgstr "" msgid "" -"Previously, this method only supported formats that could be emitted by :" -"meth:`date.isoformat` or :meth:`datetime.isoformat`." +"Previously, this method only supported formats that could be emitted " +"by :meth:`date.isoformat` or :meth:`datetime.isoformat`." msgstr "" msgid "" "Return a :class:`.datetime` corresponding to the ISO calendar date specified " "by year, week and day. The non-date components of the datetime are populated " -"with their normal default values. This is the inverse of the function :meth:" -"`datetime.isocalendar`." +"with their normal default values. This is the inverse of the " +"function :meth:`datetime.isocalendar`." msgstr "" msgid "" @@ -1345,24 +1367,24 @@ msgstr "" msgid "" ":exc:`ValueError` is raised if the date_string and format can't be parsed " "by :func:`time.strptime` or if it returns a value which isn't a time tuple. " -"See also :ref:`strftime-strptime-behavior` and :meth:`datetime." -"fromisoformat`." +"See also :ref:`strftime-strptime-behavior` " +"and :meth:`datetime.fromisoformat`." msgstr "" msgid "" -"If *format* specifies a day of month without a year a :exc:" -"`DeprecationWarning` is now emitted. This is to avoid a quadrennial leap " -"year bug in code seeking to parse only a month and day as the default year " -"used in absence of one in the format is not a leap year. Such *format* " +"If *format* specifies a day of month without a year " +"a :exc:`DeprecationWarning` is now emitted. This is to avoid a quadrennial " +"leap year bug in code seeking to parse only a month and day as the default " +"year used in absence of one in the format is not a leap year. Such *format* " "values may raise an error as of Python 3.15. The workaround is to always " "include a year in your *format*. If parsing *date_string* values that do " "not have a year, explicitly add a year that is a leap year before parsing:" msgstr "" msgid "" -">>> from datetime import datetime\n" +">>> import datetime as dt\n" ">>> date_string = \"02/29\"\n" -">>> when = datetime.strptime(f\"{date_string};1984\", \"%m/%d;%Y\") # " +">>> when = dt.datetime.strptime(f\"{date_string};1984\", \"%m/%d;%Y\") # " "Avoids leap year bug.\n" ">>> when.strftime(\"%B %d\")\n" "'February 29'" @@ -1441,12 +1463,12 @@ msgstr "``datetime1 >= datetime2``" msgid "" "``datetime2`` is a duration of ``timedelta`` removed from ``datetime1``, " -"moving forward in time if ``timedelta.days > 0``, or backward if ``timedelta." -"days < 0``. The result has the same :attr:`~.datetime.tzinfo` attribute as " -"the input datetime, and ``datetime2 - datetime1 == timedelta`` after. :exc:" -"`OverflowError` is raised if ``datetime2.year`` would be smaller than :const:" -"`MINYEAR` or larger than :const:`MAXYEAR`. Note that no time zone " -"adjustments are done even if the input is an aware object." +"moving forward in time if ``timedelta.days > 0``, or backward if " +"``timedelta.days < 0``. The result has the same :attr:`~.datetime.tzinfo` " +"attribute as the input datetime, and ``datetime2 - datetime1 == timedelta`` " +"after. :exc:`OverflowError` is raised if ``datetime2.year`` would be smaller " +"than :const:`MINYEAR` or larger than :const:`MAXYEAR`. Note that no time " +"zone adjustments are done even if the input is an aware object." msgstr "" msgid "" @@ -1457,24 +1479,25 @@ msgid "" msgstr "" msgid "" -"Subtraction of a :class:`.datetime` from a :class:`.datetime` is defined " +"Subtraction of a :class:`.datetime` from a :class:`!datetime` is defined " "only if both operands are naive, or if both are aware. If one is aware and " "the other is naive, :exc:`TypeError` is raised." msgstr "" msgid "" -"If both are naive, or both are aware and have the same :attr:`~.datetime." -"tzinfo` attribute, the :attr:`~.datetime.tzinfo` attributes are ignored, and " -"the result is a :class:`timedelta` object ``t`` such that ``datetime2 + t == " -"datetime1``. No time zone adjustments are done in this case." +"If both are naive, or both are aware and have the " +"same :attr:`~.datetime.tzinfo` attribute, the :attr:`~.datetime.tzinfo` " +"attributes are ignored, and the result is a :class:`timedelta` object ``t`` " +"such that ``datetime2 + t == datetime1``. No time zone adjustments are done " +"in this case." msgstr "" msgid "" "If both are aware and have different :attr:`~.datetime.tzinfo` attributes, " "``a-b`` acts as if ``a`` and ``b`` were first converted to naive UTC " -"datetimes. The result is ``(a.replace(tzinfo=None) - a.utcoffset()) - (b." -"replace(tzinfo=None) - b.utcoffset())`` except that the implementation never " -"overflows." +"datetimes. The result is ``(a.replace(tzinfo=None) - a.utcoffset()) - " +"(b.replace(tzinfo=None) - b.utcoffset())`` except that the implementation " +"never overflows." msgstr "" msgid "" @@ -1482,7 +1505,7 @@ msgid "" "time, taking into account the time zone." msgstr "" -msgid "Naive and aware :class:`!datetime` objects are never equal." +msgid "Naive and aware :class:`.datetime` objects are never equal." msgstr "" msgid "" @@ -1491,7 +1514,7 @@ msgid "" "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 " +"implementation never overflows. :class:`.datetime` instances in a repeated " "interval are never equal to :class:`!datetime` instances in other time zone." msgstr "" @@ -1501,8 +1524,8 @@ msgid "" msgstr "" msgid "" -"Order comparison between naive and aware :class:`.datetime` objects raises :" -"exc:`TypeError`." +"Order comparison between naive and aware :class:`.datetime` objects " +"raises :exc:`TypeError`." msgstr "" msgid "" @@ -1543,8 +1566,8 @@ msgid "" msgstr "" msgid "" -":class:`.datetime` objects are also supported by generic function :func:" -"`copy.replace`." +":class:`.datetime` objects are also supported by generic " +"function :func:`copy.replace`." msgstr "" msgid "" @@ -1576,16 +1599,16 @@ msgstr "" msgid "" "If you merely want to attach a :class:`timezone` object *tz* to a datetime " -"*dt* without adjustment of date and time data, use ``dt." -"replace(tzinfo=tz)``. If you merely want to remove the :class:`!timezone` " -"object from an aware datetime *dt* without conversion of date and time data, " -"use ``dt.replace(tzinfo=None)``." +"*dt* without adjustment of date and time data, use " +"``dt.replace(tzinfo=tz)``. If you merely want to remove the :class:`!" +"timezone` object from an aware datetime *dt* without conversion of date and " +"time data, use ``dt.replace(tzinfo=None)``." msgstr "" msgid "" -"Note that the default :meth:`tzinfo.fromutc` method can be overridden in a :" -"class:`tzinfo` subclass to affect the result returned by :meth:`astimezone`. " -"Ignoring error cases, :meth:`astimezone` acts like::" +"Note that the default :meth:`tzinfo.fromutc` method can be overridden in " +"a :class:`tzinfo` subclass to affect the result returned " +"by :meth:`astimezone`. Ignoring error cases, :meth:`astimezone` acts like::" msgstr "" msgid "" @@ -1607,27 +1630,29 @@ msgid "" msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"utcoffset(self)``, and raises an exception if the latter doesn't return " -"``None`` or a :class:`timedelta` object with magnitude less than one day." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.utcoffset(self)``, and raises an exception if the latter " +"doesn't return ``None`` or a :class:`timedelta` object with magnitude less " +"than one day." msgstr "" msgid "The UTC offset is not restricted to a whole number of minutes." msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"dst(self)``, and raises an exception if the latter doesn't return ``None`` " -"or a :class:`timedelta` object with magnitude less than one day." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.dst(self)``, and raises an exception if the latter doesn't " +"return ``None`` or a :class:`timedelta` object with magnitude less than one " +"day." msgstr "" msgid "The DST offset is not restricted to a whole number of minutes." msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"tzname(self)``, raises an exception if the latter doesn't return ``None`` or " -"a string object," +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.tzname(self)``, raises an exception if the latter doesn't " +"return ``None`` or a string object," msgstr "" msgid "" @@ -1638,56 +1663,55 @@ msgstr "" msgid "" "where ``yday = d.toordinal() - date(d.year, 1, 1).toordinal() + 1`` is the " -"day number within the current year starting with 1 for January 1st. The :" -"attr:`~time.struct_time.tm_isdst` flag of the result is set according to " -"the :meth:`dst` method: :attr:`.tzinfo` is ``None`` or :meth:`dst` returns " -"``None``, :attr:`!tm_isdst` is set to ``-1``; else if :meth:`dst` returns a " -"non-zero value, :attr:`!tm_isdst` is set to 1; else :attr:`!tm_isdst` is set " -"to 0." +"day number within the current year starting with 1 for January 1st. " +"The :attr:`~time.struct_time.tm_isdst` flag of the result is set according " +"to the :meth:`dst` method: :attr:`.tzinfo` is ``None`` or :meth:`dst` " +"returns ``None``, :attr:`!tm_isdst` is set to ``-1``; else if :meth:`dst` " +"returns a non-zero value, :attr:`!tm_isdst` is set to 1; else :attr:`!" +"tm_isdst` is set to 0." msgstr "" msgid "" -"If :class:`.datetime` instance ``d`` is naive, this is the same as ``d." -"timetuple()`` except that :attr:`~.time.struct_time.tm_isdst` is forced to 0 " -"regardless of what ``d.dst()`` returns. DST is never in effect for a UTC " -"time." +"If :class:`.datetime` instance ``d`` is naive, this is the same as " +"``d.timetuple()`` except that :attr:`~.time.struct_time.tm_isdst` is forced " +"to 0 regardless of what ``d.dst()`` returns. DST is never in effect for a " +"UTC time." msgstr "" msgid "" -"If ``d`` is aware, ``d`` is normalized to UTC time, by subtracting ``d." -"utcoffset()``, and a :class:`time.struct_time` for the normalized time is " -"returned. :attr:`!tm_isdst` is forced to 0. Note that an :exc:" -"`OverflowError` may be raised if ``d.year`` was ``MINYEAR`` or ``MAXYEAR`` " -"and UTC adjustment spills over a year boundary." +"If ``d`` is aware, ``d`` is normalized to UTC time, by subtracting " +"``d.utcoffset()``, and a :class:`time.struct_time` for the normalized time " +"is returned. :attr:`!tm_isdst` is forced to 0. Note that " +"an :exc:`OverflowError` may be raised if ``d.year`` was ``MINYEAR`` or " +"``MAXYEAR`` and UTC adjustment spills over a year boundary." msgstr "" msgid "" "Because naive ``datetime`` objects are treated by many ``datetime`` methods " "as local times, it is preferred to use aware datetimes to represent times in " "UTC; as a result, using :meth:`datetime.utctimetuple` may give misleading " -"results. If you have a naive ``datetime`` representing UTC, use ``datetime." -"replace(tzinfo=timezone.utc)`` to make it aware, at which point you can use :" -"meth:`.datetime.timetuple`." +"results. If you have a naive ``datetime`` representing UTC, use " +"``datetime.replace(tzinfo=timezone.utc)`` to make it aware, at which point " +"you can use :meth:`.datetime.timetuple`." msgstr "" msgid "" -"Return the proleptic Gregorian ordinal of the date. The same as ``self." -"date().toordinal()``." +"Return the proleptic Gregorian ordinal of the date. The same as " +"``self.date().toordinal()``." msgstr "" msgid "" "Return POSIX timestamp corresponding to the :class:`.datetime` instance. The " -"return value is a :class:`float` similar to that returned by :func:`time." -"time`." +"return value is a :class:`float` similar to that returned " +"by :func:`time.time`." msgstr "" msgid "" "Naive :class:`.datetime` instances are assumed to represent local time and " -"this method relies on the platform C :c:func:`mktime` function to perform " -"the conversion. Since :class:`.datetime` supports wider range of values " -"than :c:func:`mktime` on many platforms, this method may raise :exc:" -"`OverflowError` or :exc:`OSError` for times far in the past or far in the " -"future." +"this method relies on platform C functions to perform the conversion. " +"Since :class:`!datetime` supports a wider range of values than the platform " +"C functions on many platforms, this method may raise :exc:`OverflowError` " +"or :exc:`OSError` for times far in the past or far in the future." msgstr "" msgid "" @@ -1703,10 +1727,15 @@ msgid "" msgstr "" msgid "" -"There is no method to obtain the POSIX timestamp directly from a naive :" -"class:`.datetime` instance representing UTC time. If your application uses " -"this convention and your system time zone is not set to UTC, you can obtain " -"the POSIX timestamp by supplying ``tzinfo=timezone.utc``::" +"This method no longer relies on the platform C :c:func:`mktime` function to " +"perform conversions." +msgstr "" + +msgid "" +"There is no method to obtain the POSIX timestamp directly from a " +"naive :class:`.datetime` instance representing UTC time. If your application " +"uses this convention and your system time zone is not set to UTC, you can " +"obtain the POSIX timestamp by supplying ``tzinfo=timezone.utc``::" msgstr "" msgid "timestamp = dt.replace(tzinfo=timezone.utc).timestamp()" @@ -1725,8 +1754,8 @@ msgstr "" msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " -"The same as ``self.date().isoweekday()``. See also :meth:`weekday`, :meth:" -"`isocalendar`." +"The same as ``self.date().isoweekday()``. See " +"also :meth:`weekday`, :meth:`isocalendar`." msgstr "" msgid "" @@ -1758,10 +1787,10 @@ msgid "" msgstr "" msgid "" -">>> from datetime import datetime, timezone\n" -">>> datetime(2019, 5, 18, 15, 17, 8, 132263).isoformat()\n" +">>> import datetime as dt\n" +">>> dt.datetime(2019, 5, 18, 15, 17, 8, 132263).isoformat()\n" "'2019-05-18T15:17:08.132263'\n" -">>> datetime(2019, 5, 18, 15, 17, tzinfo=timezone.utc).isoformat()\n" +">>> dt.datetime(2019, 5, 18, 15, 17, tzinfo=dt.timezone.utc).isoformat()\n" "'2019-05-18T15:17:00+00:00'" msgstr "" @@ -1771,15 +1800,15 @@ msgid "" msgstr "" msgid "" -">>> from datetime import tzinfo, timedelta, datetime\n" -">>> class TZ(tzinfo):\n" +">>> import datetime as dt\n" +">>> class TZ(dt.tzinfo):\n" "... \"\"\"A time zone with an arbitrary, constant -06:39 offset.\"\"\"\n" -"... def utcoffset(self, dt):\n" -"... return timedelta(hours=-6, minutes=-39)\n" +"... def utcoffset(self, when):\n" +"... return dt.timedelta(hours=-6, minutes=-39)\n" "...\n" -">>> datetime(2002, 12, 25, tzinfo=TZ()).isoformat(' ')\n" +">>> dt.datetime(2002, 12, 25, tzinfo=TZ()).isoformat(' ')\n" "'2002-12-25 00:00:00-06:39'\n" -">>> datetime(2009, 11, 27, microsecond=100, tzinfo=TZ()).isoformat()\n" +">>> dt.datetime(2009, 11, 27, microsecond=100, tzinfo=TZ()).isoformat()\n" "'2009-11-27T00:00:00.000100-06:39'" msgstr "" @@ -1821,11 +1850,11 @@ msgid ":exc:`ValueError` will be raised on an invalid *timespec* argument::" msgstr "" msgid "" -">>> from datetime import datetime\n" -">>> datetime.now().isoformat(timespec='minutes')\n" +">>> import datetime as dt\n" +">>> dt.datetime.now().isoformat(timespec='minutes')\n" "'2002-12-25T00:00'\n" -">>> dt = datetime(2015, 1, 1, 12, 30, 59, 0)\n" -">>> dt.isoformat(timespec='microseconds')\n" +">>> my_datetime = dt.datetime(2015, 1, 1, 12, 30, 59, 0)\n" +">>> my_datetime.isoformat(timespec='microseconds')\n" "'2015-01-01T12:30:59.000000'" msgstr "" @@ -1833,16 +1862,16 @@ msgid "Added the *timespec* parameter." msgstr "" msgid "" -"For a :class:`.datetime` instance ``d``, ``str(d)`` is equivalent to ``d." -"isoformat(' ')``." +"For a :class:`.datetime` instance ``d``, ``str(d)`` is equivalent to " +"``d.isoformat(' ')``." msgstr "" msgid "Return a string representing the date and time::" msgstr "" msgid "" -">>> from datetime import datetime\n" -">>> datetime(2002, 12, 4, 20, 30, 40).ctime()\n" +">>> import datetime as dt\n" +">>> dt.datetime(2002, 12, 4, 20, 30, 40).ctime()\n" "'Wed Dec 4 20:30:40 2002'" msgstr "" @@ -1852,22 +1881,22 @@ msgid "" msgstr "" msgid "" -"on platforms where the native C :c:func:`ctime` function (which :func:`time." -"ctime` invokes, but which :meth:`datetime.ctime` does not invoke) conforms " -"to the C standard." +"on platforms where the native C :c:func:`ctime` function " +"(which :func:`time.ctime` invokes, but which :meth:`datetime.ctime` does not " +"invoke) conforms to the C standard." msgstr "" msgid "" "Return a string representing the date and time, controlled by an explicit " -"format string. See also :ref:`strftime-strptime-behavior` and :meth:" -"`datetime.isoformat`." +"format string. See also :ref:`strftime-strptime-behavior` " +"and :meth:`datetime.isoformat`." msgstr "" msgid "" "Same as :meth:`.datetime.strftime`. This makes it possible to specify a " "format string for a :class:`.datetime` object in :ref:`formatted string " -"literals ` and when using :meth:`str.format`. See also :ref:" -"`strftime-strptime-behavior` and :meth:`datetime.isoformat`." +"literals ` and when using :meth:`str.format`. See " +"also :ref:`strftime-strptime-behavior` and :meth:`datetime.isoformat`." msgstr "" msgid "Examples of Usage: :class:`.datetime`" @@ -1877,28 +1906,29 @@ msgid "Examples of working with :class:`.datetime` objects:" msgstr "" msgid "" -">>> from datetime import datetime, date, time, timezone\n" +">>> import datetime as dt\n" "\n" ">>> # Using datetime.combine()\n" -">>> d = date(2005, 7, 14)\n" -">>> t = time(12, 30)\n" -">>> datetime.combine(d, t)\n" +">>> d = dt.date(2005, 7, 14)\n" +">>> t = dt.time(12, 30)\n" +">>> dt.datetime.combine(d, t)\n" "datetime.datetime(2005, 7, 14, 12, 30)\n" "\n" ">>> # Using datetime.now()\n" -">>> datetime.now()\n" +">>> dt.datetime.now()\n" "datetime.datetime(2007, 12, 6, 16, 29, 43, 79043) # GMT +1\n" -">>> datetime.now(timezone.utc)\n" -"datetime.datetime(2007, 12, 6, 15, 29, 43, 79060, tzinfo=datetime.timezone." -"utc)\n" +">>> dt.datetime.now(dt.timezone.utc)\n" +"datetime.datetime(2007, 12, 6, 15, 29, 43, 79060, " +"tzinfo=datetime.timezone.utc)\n" "\n" ">>> # Using datetime.strptime()\n" -">>> dt = datetime.strptime(\"21/11/06 16:30\", \"%d/%m/%y %H:%M\")\n" -">>> dt\n" +">>> my_datetime = dt.datetime.strptime(\"21/11/06 16:30\", \"%d/%m/%y %H:" +"%M\")\n" +">>> my_datetime\n" "datetime.datetime(2006, 11, 21, 16, 30)\n" "\n" ">>> # Using datetime.timetuple() to get tuple of all attributes\n" -">>> tt = dt.timetuple()\n" +">>> tt = my_datetime.timetuple()\n" ">>> for it in tt:\n" "... print(it)\n" "...\n" @@ -1913,7 +1943,7 @@ msgid "" "-1 # dst - method tzinfo.dst() returned None\n" "\n" ">>> # Date in ISO format\n" -">>> ic = dt.isocalendar()\n" +">>> ic = my_datetime.isocalendar()\n" ">>> for it in ic:\n" "... print(it)\n" "...\n" @@ -1922,10 +1952,10 @@ msgid "" "2 # ISO weekday\n" "\n" ">>> # Formatting a datetime\n" -">>> dt.strftime(\"%A, %d. %B %Y %I:%M%p\")\n" +">>> my_datetime.strftime(\"%A, %d. %B %Y %I:%M%p\")\n" "'Tuesday, 21. November 2006 04:30PM'\n" -">>> 'The {1} is {0:%d}, the {2} is {0:%B}, the {3} is {0:%I:%M%p}.'." -"format(dt, \"day\", \"month\", \"time\")\n" +">>> 'The {1} is {0:%d}, the {2} is {0:%B}, the {3} is {0:%I:" +"%M%p}.'.format(my_datetime, \"day\", \"month\", \"time\")\n" "'The day is 21, the month is November, the time is 04:30PM.'" msgstr "" @@ -1936,47 +1966,47 @@ msgid "" msgstr "" msgid "" -"from datetime import timedelta, datetime, tzinfo, timezone\n" +"import datetime as dt\n" "\n" -"class KabulTz(tzinfo):\n" +"class KabulTz(dt.tzinfo):\n" " # Kabul used +4 until 1945, when they moved to +4:30\n" -" UTC_MOVE_DATE = datetime(1944, 12, 31, 20, tzinfo=timezone.utc)\n" +" UTC_MOVE_DATE = dt.datetime(1944, 12, 31, 20, tzinfo=dt.timezone.utc)\n" "\n" -" def utcoffset(self, dt):\n" -" if dt.year < 1945:\n" -" return timedelta(hours=4)\n" -" elif (1945, 1, 1, 0, 0) <= dt.timetuple()[:5] < (1945, 1, 1, 0, " +" def utcoffset(self, when):\n" +" if when.year < 1945:\n" +" return dt.timedelta(hours=4)\n" +" elif (1945, 1, 1, 0, 0) <= when.timetuple()[:5] < (1945, 1, 1, 0, " "30):\n" " # An ambiguous (\"imaginary\") half-hour range representing\n" " # a 'fold' in time due to the shift from +4 to +4:30.\n" -" # If dt falls in the imaginary range, use fold to decide how\n" -" # to resolve. See PEP495.\n" -" return timedelta(hours=4, minutes=(30 if dt.fold else 0))\n" +" # If when falls in the imaginary range, use fold to decide how\n" +" # to resolve. See PEP 495.\n" +" return dt.timedelta(hours=4, minutes=(30 if when.fold else 0))\n" " else:\n" -" return timedelta(hours=4, minutes=30)\n" +" return dt.timedelta(hours=4, minutes=30)\n" "\n" -" def fromutc(self, dt):\n" +" def fromutc(self, when):\n" " # Follow same validations as in datetime.tzinfo\n" -" if not isinstance(dt, datetime):\n" +" if not isinstance(when, dt.datetime):\n" " raise TypeError(\"fromutc() requires a datetime argument\")\n" -" if dt.tzinfo is not self:\n" -" raise ValueError(\"dt.tzinfo is not self\")\n" +" if when.tzinfo is not self:\n" +" raise ValueError(\"when.tzinfo is not self\")\n" "\n" " # A custom implementation is required for fromutc as\n" " # the input to this function is a datetime with utc values\n" " # but with a tzinfo set to self.\n" " # See datetime.astimezone or fromtimestamp.\n" -" if dt.replace(tzinfo=timezone.utc) >= self.UTC_MOVE_DATE:\n" -" return dt + timedelta(hours=4, minutes=30)\n" +" if when.replace(tzinfo=dt.timezone.utc) >= self.UTC_MOVE_DATE:\n" +" return when + dt.timedelta(hours=4, minutes=30)\n" " else:\n" -" return dt + timedelta(hours=4)\n" +" return when + dt.timedelta(hours=4)\n" "\n" -" def dst(self, dt):\n" +" def dst(self, when):\n" " # Kabul does not observe daylight saving time.\n" -" return timedelta(0)\n" +" return dt.timedelta(0)\n" "\n" -" def tzname(self, dt):\n" -" if dt >= self.UTC_MOVE_DATE:\n" +" def tzname(self, when):\n" +" if when >= self.UTC_MOVE_DATE:\n" " return \"+04:30\"\n" " return \"+04\"" msgstr "" @@ -1988,17 +2018,17 @@ msgid "" ">>> tz1 = KabulTz()\n" "\n" ">>> # Datetime before the change\n" -">>> dt1 = datetime(1900, 11, 21, 16, 30, tzinfo=tz1)\n" +">>> dt1 = dt.datetime(1900, 11, 21, 16, 30, tzinfo=tz1)\n" ">>> print(dt1.utcoffset())\n" "4:00:00\n" "\n" ">>> # Datetime after the change\n" -">>> dt2 = datetime(2006, 6, 14, 13, 0, tzinfo=tz1)\n" +">>> dt2 = dt.datetime(2006, 6, 14, 13, 0, tzinfo=tz1)\n" ">>> print(dt2.utcoffset())\n" "4:30:00\n" "\n" ">>> # Convert datetime to another time zone\n" -">>> dt3 = dt2.astimezone(timezone.utc)\n" +">>> dt3 = dt2.astimezone(dt.timezone.utc)\n" ">>> dt3\n" "datetime.datetime(2006, 6, 14, 8, 30, tzinfo=datetime.timezone.utc)\n" ">>> dt2\n" @@ -2016,8 +2046,8 @@ msgid "" msgstr "" msgid "" -"All arguments are optional. *tzinfo* may be ``None``, or an instance of a :" -"class:`tzinfo` subclass. The remaining arguments must be integers in the " +"All arguments are optional. *tzinfo* may be ``None``, or an instance of " +"a :class:`tzinfo` subclass. The remaining arguments must be integers in the " "following ranges:" msgstr "" @@ -2034,8 +2064,8 @@ msgstr "" msgid "" "The smallest possible difference between non-equal :class:`.time` objects, " -"``timedelta(microseconds=1)``, although note that arithmetic on :class:`." -"time` objects is not supported." +"``timedelta(microseconds=1)``, although note that arithmetic " +"on :class:`.time` objects is not supported." msgstr "" msgid "" @@ -2099,41 +2129,41 @@ msgid "Examples:" msgstr "Przykłady:" msgid "" -">>> from datetime import time\n" -">>> time.fromisoformat('04:23:01')\n" +">>> import datetime as dt\n" +">>> dt.time.fromisoformat('04:23:01')\n" "datetime.time(4, 23, 1)\n" -">>> time.fromisoformat('T04:23:01')\n" +">>> dt.time.fromisoformat('T04:23:01')\n" "datetime.time(4, 23, 1)\n" -">>> time.fromisoformat('T042301')\n" +">>> dt.time.fromisoformat('T042301')\n" "datetime.time(4, 23, 1)\n" -">>> time.fromisoformat('04:23:01.000384')\n" +">>> dt.time.fromisoformat('04:23:01.000384')\n" "datetime.time(4, 23, 1, 384)\n" -">>> time.fromisoformat('04:23:01,000384')\n" +">>> dt.time.fromisoformat('04:23:01,000384')\n" "datetime.time(4, 23, 1, 384)\n" -">>> time.fromisoformat('04:23:01+04:00')\n" -"datetime.time(4, 23, 1, tzinfo=datetime.timezone(datetime." -"timedelta(seconds=14400)))\n" -">>> time.fromisoformat('04:23:01Z')\n" +">>> dt.time.fromisoformat('04:23:01+04:00')\n" +"datetime.time(4, 23, 1, " +"tzinfo=datetime.timezone(datetime.timedelta(seconds=14400)))\n" +">>> dt.time.fromisoformat('04:23:01Z')\n" "datetime.time(4, 23, 1, tzinfo=datetime.timezone.utc)\n" -">>> time.fromisoformat('04:23:01+00:00')\n" +">>> dt.time.fromisoformat('04:23:01+00:00')\n" "datetime.time(4, 23, 1, tzinfo=datetime.timezone.utc)" msgstr "" msgid "" -"Previously, this method only supported formats that could be emitted by :" -"meth:`time.isoformat`." +"Previously, this method only supported formats that could be emitted " +"by :meth:`time.isoformat`." msgstr "" msgid "" "Return a new :class:`.time` with the same values, but with specified " "parameters updated. Note that ``tzinfo=None`` can be specified to create a " -"naive :class:`.time` from an aware :class:`.time`, without conversion of the " +"naive :class:`!time` from an aware :class:`!time`, without conversion of the " "time data." msgstr "" msgid "" -":class:`.time` objects are also supported by generic function :func:`copy." -"replace`." +":class:`.time` objects are also supported by generic " +"function :func:`copy.replace`." msgstr "" msgid "Return a string representing the time in ISO 8601 format, one of:" @@ -2151,22 +2181,22 @@ msgid "" msgstr "" msgid "" -"``HH:MM:SS+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` is 0 and :meth:" -"`utcoffset` does not return ``None``" +"``HH:MM:SS+HH:MM[:SS[.ffffff]]``, if :attr:`microsecond` is 0 " +"and :meth:`utcoffset` does not return ``None``" msgstr "" msgid ":exc:`ValueError` will be raised on an invalid *timespec* argument." msgstr "" msgid "" -">>> from datetime import time\n" -">>> time(hour=12, minute=34, second=56, microsecond=123456)." -"isoformat(timespec='minutes')\n" +">>> import datetime as dt\n" +">>> dt.time(hour=12, minute=34, second=56, " +"microsecond=123456).isoformat(timespec='minutes')\n" "'12:34'\n" -">>> dt = time(hour=12, minute=34, second=56, microsecond=0)\n" -">>> dt.isoformat(timespec='microseconds')\n" +">>> my_time = dt.time(hour=12, minute=34, second=56, microsecond=0)\n" +">>> my_time.isoformat(timespec='microseconds')\n" "'12:34:56.000000'\n" -">>> dt.isoformat(timespec='auto')\n" +">>> my_time.isoformat(timespec='auto')\n" "'12:34:56'" msgstr "" @@ -2175,8 +2205,8 @@ msgstr "" msgid "" "Return a string representing the time, controlled by an explicit format " -"string. See also :ref:`strftime-strptime-behavior` and :meth:`time." -"isoformat`." +"string. See also :ref:`strftime-strptime-behavior` " +"and :meth:`time.isoformat`." msgstr "" msgid "" @@ -2187,21 +2217,23 @@ msgid "" msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"utcoffset(None)``, and raises an exception if the latter doesn't return " -"``None`` or a :class:`timedelta` object with magnitude less than one day." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.utcoffset(None)``, and raises an exception if the latter " +"doesn't return ``None`` or a :class:`timedelta` object with magnitude less " +"than one day." msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"dst(None)``, and raises an exception if the latter doesn't return ``None``, " -"or a :class:`timedelta` object with magnitude less than one day." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.dst(None)``, and raises an exception if the latter doesn't " +"return ``None``, or a :class:`timedelta` object with magnitude less than one " +"day." msgstr "" msgid "" -"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." -"tzname(None)``, or raises an exception if the latter doesn't return ``None`` " -"or a string object." +"If :attr:`.tzinfo` is ``None``, returns ``None``, else returns " +"``self.tzinfo.tzname(None)``, or raises an exception if the latter doesn't " +"return ``None`` or a string object." msgstr "" msgid "Examples of Usage: :class:`.time`" @@ -2211,18 +2243,18 @@ msgid "Examples of working with a :class:`.time` object::" msgstr "" msgid "" -">>> from datetime import time, tzinfo, timedelta\n" -">>> class TZ1(tzinfo):\n" -"... def utcoffset(self, dt):\n" -"... return timedelta(hours=1)\n" -"... def dst(self, dt):\n" -"... return timedelta(0)\n" -"... def tzname(self,dt):\n" +">>> import datetime as dt\n" +">>> class TZ1(dt.tzinfo):\n" +"... def utcoffset(self, when):\n" +"... return dt.timedelta(hours=1)\n" +"... def dst(self, when):\n" +"... return dt.timedelta(0)\n" +"... def tzname(self, when):\n" "... return \"+01:00\"\n" "... def __repr__(self):\n" "... return f\"{self.__class__.__name__}()\"\n" "...\n" -">>> t = time(12, 10, 30, tzinfo=TZ1())\n" +">>> t = dt.time(12, 10, 30, tzinfo=TZ1())\n" ">>> t\n" "datetime.time(12, 10, 30, tzinfo=TZ1())\n" ">>> t.isoformat()\n" @@ -2249,32 +2281,32 @@ msgstr "" msgid "" "An instance of (a concrete subclass of) :class:`tzinfo` can be passed to the " "constructors for :class:`.datetime` and :class:`.time` objects. The latter " -"objects view their attributes as being in local time, and the :class:" -"`tzinfo` object supports methods revealing offset of local time from UTC, " -"the name of the time zone, and DST offset, all relative to a date or time " -"object passed to them." +"objects view their attributes as being in local time, and the :class:`!" +"tzinfo` object supports methods revealing offset of local time from UTC, the " +"name of the time zone, and DST offset, all relative to a date or time object " +"passed to them." msgstr "" msgid "" "You need to derive a concrete subclass, and (at least) supply " -"implementations of the standard :class:`tzinfo` methods needed by the :class:" -"`.datetime` methods you use. The :mod:`!datetime` module provides :class:" -"`timezone`, a simple concrete subclass of :class:`tzinfo` which can " -"represent time zones with fixed offset from UTC such as UTC itself or North " -"American EST and EDT." +"implementations of the standard :class:`tzinfo` methods needed by " +"the :class:`.datetime` methods you use. The :mod:`!datetime` module " +"provides :class:`timezone`, a simple concrete subclass of :class:`!tzinfo` " +"which can represent time zones with fixed offset from UTC such as UTC itself " +"or North American EST and EDT." msgstr "" msgid "" -"Special requirement for pickling: A :class:`tzinfo` subclass must have an :" -"meth:`~object.__init__` method that can be called with no arguments, " +"Special requirement for pickling: A :class:`tzinfo` subclass must have " +"an :meth:`~object.__init__` method that can be called with no arguments, " "otherwise it can be pickled but possibly not unpickled again. This is a " "technical requirement that may be relaxed in the future." msgstr "" msgid "" "A concrete subclass of :class:`tzinfo` may need to implement the following " -"methods. Exactly which methods are needed depends on the uses made of aware :" -"mod:`!datetime` objects. If in doubt, simply implement all of them." +"methods. Exactly which methods are needed depends on the uses made of " +"aware :mod:`!datetime` objects. If in doubt, simply implement all of them." msgstr "" msgid "" @@ -2283,13 +2315,14 @@ msgid "" msgstr "" msgid "" -"This represents the *total* offset from UTC; for example, if a :class:" -"`tzinfo` object represents both time zone and DST adjustments, :meth:" -"`utcoffset` should return their sum. If the UTC offset isn't known, return " -"``None``. Else the value returned must be a :class:`timedelta` object " -"strictly between ``-timedelta(hours=24)`` and ``timedelta(hours=24)`` (the " -"magnitude of the offset must be less than one day). Most implementations of :" -"meth:`utcoffset` will probably look like one of these two::" +"This represents the *total* offset from UTC; for example, if " +"a :class:`tzinfo` object represents both time zone and DST " +"adjustments, :meth:`utcoffset` should return their sum. If the UTC offset " +"isn't known, return ``None``. Else the value returned must be " +"a :class:`timedelta` object strictly between ``-timedelta(hours=24)`` and " +"``timedelta(hours=24)`` (the magnitude of the offset must be less than one " +"day). Most implementations of :meth:`utcoffset` will probably look like one " +"of these two::" msgstr "" msgid "" @@ -2303,8 +2336,8 @@ msgid "" msgstr "" msgid "" -"The default implementation of :meth:`utcoffset` raises :exc:" -"`NotImplementedError`." +"The default implementation of :meth:`utcoffset` " +"raises :exc:`NotImplementedError`." msgstr "" msgid "" @@ -2316,12 +2349,13 @@ msgid "" "Return ``timedelta(0)`` if DST is not in effect. If DST is in effect, return " "the offset as a :class:`timedelta` object (see :meth:`utcoffset` for " "details). Note that DST offset, if applicable, has already been added to the " -"UTC offset returned by :meth:`utcoffset`, so there's no need to consult :" -"meth:`dst` unless you're interested in obtaining DST info separately. For " -"example, :meth:`datetime.timetuple` calls its :attr:`~.datetime.tzinfo` " -"attribute's :meth:`dst` method to determine how the :attr:`~time.struct_time." -"tm_isdst` flag should be set, and :meth:`tzinfo.fromutc` calls :meth:`dst` " -"to account for DST changes when crossing time zones." +"UTC offset returned by :meth:`utcoffset`, so there's no need to " +"consult :meth:`dst` unless you're interested in obtaining DST info " +"separately. For example, :meth:`datetime.timetuple` calls " +"its :attr:`~.datetime.tzinfo` attribute's :meth:`dst` method to determine " +"how the :attr:`~time.struct_time.tm_isdst` flag should be set, " +"and :meth:`tzinfo.fromutc` calls :meth:`dst` to account for DST changes when " +"crossing time zones." msgstr "" msgid "" @@ -2333,15 +2367,15 @@ msgid "``tz.utcoffset(dt) - tz.dst(dt)``" msgstr "``tz.utcoffset(dt) - tz.dst(dt)``" msgid "" -"must return the same result for every :class:`.datetime` *dt* with ``dt." -"tzinfo == tz``. For sane :class:`tzinfo` subclasses, this expression yields " -"the time zone's \"standard offset\", which should not depend on the date or " -"the time, but only on geographic location. The implementation of :meth:" -"`datetime.astimezone` relies on this, but cannot detect violations; it's the " -"programmer's responsibility to ensure it. If a :class:`tzinfo` subclass " -"cannot guarantee this, it may be able to override the default implementation " -"of :meth:`tzinfo.fromutc` to work correctly with :meth:`~.datetime." -"astimezone` regardless." +"must return the same result for every :class:`.datetime` *dt* with " +"``dt.tzinfo == tz``. For sane :class:`!tzinfo` subclasses, this expression " +"yields the time zone's \"standard offset\", which should not depend on the " +"date or the time, but only on geographic location. The implementation " +"of :meth:`datetime.astimezone` relies on this, but cannot detect violations; " +"it's the programmer's responsibility to ensure it. If a :class:`!tzinfo` " +"subclass cannot guarantee this, it may be able to override the default " +"implementation of :meth:`tzinfo.fromutc` to work correctly " +"with :meth:`~.datetime.astimezone` regardless." msgstr "" msgid "" @@ -2350,24 +2384,28 @@ msgid "" msgstr "" msgid "" -"def dst(self, dt):\n" +"import datetime as dt\n" +"\n" +"def dst(self, when):\n" " # a fixed-offset class: doesn't account for DST\n" -" return timedelta(0)" +" return dt.timedelta(0)" msgstr "" msgid "or::" msgstr "lub::" msgid "" -"def dst(self, dt):\n" +"import datetime as dt\n" +"\n" +"def dst(self, when):\n" " # Code to set dston and dstoff to the time zone's DST\n" -" # transition times based on the input dt.year, and expressed\n" +" # transition times based on the input when.year, and expressed\n" " # in standard local time.\n" "\n" -" if dston <= dt.replace(tzinfo=None) < dstoff:\n" -" return timedelta(hours=1)\n" +" if dston <= when.replace(tzinfo=None) < dstoff:\n" +" return dt.timedelta(hours=1)\n" " else:\n" -" return timedelta(0)" +" return dt.timedelta(0)" msgstr "" msgid "" @@ -2381,23 +2419,23 @@ msgid "" "particular. For example, ``\"GMT\"``, ``\"UTC\"``, ``\"-500\"``, " "``\"-5:00\"``, ``\"EDT\"``, ``\"US/Eastern\"``, ``\"America/New York\"`` are " "all valid replies. Return ``None`` if a string name isn't known. Note that " -"this is a method rather than a fixed string primarily because some :class:" -"`tzinfo` subclasses will wish to return different names depending on the " -"specific value of *dt* passed, especially if the :class:`tzinfo` class is " -"accounting for daylight time." +"this is a method rather than a fixed string primarily because " +"some :class:`tzinfo` subclasses will wish to return different names " +"depending on the specific value of *dt* passed, especially if the :class:`!" +"tzinfo` class is accounting for daylight time." msgstr "" msgid "" -"The default implementation of :meth:`tzname` raises :exc:" -"`NotImplementedError`." +"The default implementation of :meth:`tzname` " +"raises :exc:`NotImplementedError`." msgstr "" msgid "" "These methods are called by a :class:`.datetime` or :class:`.time` object, " -"in response to their methods of the same names. A :class:`.datetime` object " -"passes itself as the argument, and a :class:`.time` object passes ``None`` " +"in response to their methods of the same names. A :class:`!datetime` object " +"passes itself as the argument, and a :class:`!time` object passes ``None`` " "as the argument. A :class:`tzinfo` subclass's methods should therefore be " -"prepared to accept a *dt* argument of ``None``, or of class :class:`." +"prepared to accept a *dt* argument of ``None``, or of class :class:`!" "datetime`." msgstr "" @@ -2410,12 +2448,12 @@ msgid "" msgstr "" msgid "" -"When a :class:`.datetime` object is passed in response to a :class:`." -"datetime` method, ``dt.tzinfo`` is the same object as *self*. :class:" -"`tzinfo` methods can rely on this, unless user code calls :class:`tzinfo` " -"methods directly. The intent is that the :class:`tzinfo` methods interpret " -"*dt* as being in local time, and not need worry about objects in other time " -"zones." +"When a :class:`.datetime` object is passed in response to a :class:`!" +"datetime` method, ``dt.tzinfo`` is the same object as " +"*self*. :class:`tzinfo` methods can rely on this, unless user code " +"calls :class:`!tzinfo` methods directly. The intent is that the :class:`!" +"tzinfo` methods interpret *dt* as being in local time, and not need worry " +"about objects in other time zones." msgstr "" msgid "" @@ -2426,23 +2464,23 @@ msgstr "" msgid "" "This is called from the default :meth:`datetime.astimezone` implementation. " "When called from that, ``dt.tzinfo`` is *self*, and *dt*'s date and time " -"data are to be viewed as expressing a UTC time. The purpose of :meth:" -"`fromutc` is to adjust the date and time data, returning an equivalent " -"datetime in *self*'s local time." +"data are to be viewed as expressing a UTC time. The purpose " +"of :meth:`fromutc` is to adjust the date and time data, returning an " +"equivalent datetime in *self*'s local time." msgstr "" msgid "" -"Most :class:`tzinfo` subclasses should be able to inherit the default :meth:" -"`fromutc` implementation without problems. It's strong enough to handle " -"fixed-offset time zones, and time zones accounting for both standard and " -"daylight time, and the latter even if the DST transition times differ in " -"different years. An example of a time zone the default :meth:`fromutc` " -"implementation may not handle correctly in all cases is one where the " -"standard offset (from UTC) depends on the specific date and time passed, " -"which can happen for political reasons. The default implementations of :meth:" -"`~.datetime.astimezone` and :meth:`fromutc` may not produce the result you " -"want if the result is one of the hours straddling the moment the standard " -"offset changes." +"Most :class:`tzinfo` subclasses should be able to inherit the " +"default :meth:`fromutc` implementation without problems. It's strong enough " +"to handle fixed-offset time zones, and time zones accounting for both " +"standard and daylight time, and the latter even if the DST transition times " +"differ in different years. An example of a time zone the " +"default :meth:`fromutc` implementation may not handle correctly in all cases " +"is one where the standard offset (from UTC) depends on the specific date and " +"time passed, which can happen for political reasons. The default " +"implementations of :meth:`~.datetime.astimezone` and :meth:`fromutc` may not " +"produce the result you want if the result is one of the hours straddling the " +"moment the standard offset changes." msgstr "" msgid "" @@ -2451,93 +2489,97 @@ msgid "" msgstr "" msgid "" -"def fromutc(self, dt):\n" -" # raise ValueError error if dt.tzinfo is not self\n" -" dtoff = dt.utcoffset()\n" -" dtdst = dt.dst()\n" +"import datetime as dt\n" +"\n" +"def fromutc(self, when):\n" +" # raise ValueError error if when.tzinfo is not self\n" +" dtoff = when.utcoffset()\n" +" dtdst = when.dst()\n" " # raise ValueError if dtoff is None or dtdst is None\n" " delta = dtoff - dtdst # this is self's standard offset\n" " if delta:\n" -" dt += delta # convert to standard local time\n" -" dtdst = dt.dst()\n" +" when += delta # convert to standard local time\n" +" dtdst = when.dst()\n" " # raise ValueError if dtdst is None\n" " if dtdst:\n" -" return dt + dtdst\n" +" return when + dtdst\n" " else:\n" -" return dt" +" return when" msgstr "" msgid "" -"In the following :download:`tzinfo_examples.py <../includes/tzinfo_examples." -"py>` file there are some examples of :class:`tzinfo` classes:" +"In the following :download:`tzinfo_examples.py <../includes/" +"tzinfo_examples.py>` file there are some examples of :class:`tzinfo` classes:" msgstr "" msgid "" -"from datetime import tzinfo, timedelta, datetime\n" -"\n" -"ZERO = timedelta(0)\n" -"HOUR = timedelta(hours=1)\n" -"SECOND = timedelta(seconds=1)\n" +"import datetime as dt\n" "\n" "# A class capturing the platform's idea of local time.\n" "# (May result in wrong values on historical times in\n" "# timezones where UTC offset and/or the DST rules had\n" "# changed in the past.)\n" -"import time as _time\n" +"import time\n" "\n" -"STDOFFSET = timedelta(seconds = -_time.timezone)\n" -"if _time.daylight:\n" -" DSTOFFSET = timedelta(seconds = -_time.altzone)\n" +"ZERO = dt.timedelta(0)\n" +"HOUR = dt.timedelta(hours=1)\n" +"SECOND = dt.timedelta(seconds=1)\n" +"\n" +"STDOFFSET = dt.timedelta(seconds=-time.timezone)\n" +"if time.daylight:\n" +" DSTOFFSET = dt.timedelta(seconds=-time.altzone)\n" "else:\n" " DSTOFFSET = STDOFFSET\n" "\n" "DSTDIFF = DSTOFFSET - STDOFFSET\n" "\n" -"class LocalTimezone(tzinfo):\n" "\n" -" def fromutc(self, dt):\n" -" assert dt.tzinfo is self\n" -" stamp = (dt - datetime(1970, 1, 1, tzinfo=self)) // SECOND\n" -" args = _time.localtime(stamp)[:6]\n" +"class LocalTimezone(dt.tzinfo):\n" +"\n" +" def fromutc(self, when):\n" +" assert when.tzinfo is self\n" +" stamp = (when - dt.datetime(1970, 1, 1, tzinfo=self)) // SECOND\n" +" args = time.localtime(stamp)[:6]\n" " dst_diff = DSTDIFF // SECOND\n" " # Detect fold\n" -" fold = (args == _time.localtime(stamp - dst_diff))\n" -" return datetime(*args, microsecond=dt.microsecond,\n" -" tzinfo=self, fold=fold)\n" +" fold = (args == time.localtime(stamp - dst_diff))\n" +" return dt.datetime(*args, microsecond=when.microsecond,\n" +" tzinfo=self, fold=fold)\n" "\n" -" def utcoffset(self, dt):\n" -" if self._isdst(dt):\n" +" def utcoffset(self, when):\n" +" if self._isdst(when):\n" " return DSTOFFSET\n" " else:\n" " return STDOFFSET\n" "\n" -" def dst(self, dt):\n" -" if self._isdst(dt):\n" +" def dst(self, when):\n" +" if self._isdst(when):\n" " return DSTDIFF\n" " else:\n" " return ZERO\n" "\n" -" def tzname(self, dt):\n" -" return _time.tzname[self._isdst(dt)]\n" +" def tzname(self, when):\n" +" return time.tzname[self._isdst(when)]\n" "\n" -" def _isdst(self, dt):\n" -" tt = (dt.year, dt.month, dt.day,\n" -" dt.hour, dt.minute, dt.second,\n" -" dt.weekday(), 0, 0)\n" -" stamp = _time.mktime(tt)\n" -" tt = _time.localtime(stamp)\n" +" def _isdst(self, when):\n" +" tt = (when.year, when.month, when.day,\n" +" when.hour, when.minute, when.second,\n" +" when.weekday(), 0, 0)\n" +" stamp = time.mktime(tt)\n" +" tt = time.localtime(stamp)\n" " return tt.tm_isdst > 0\n" "\n" +"\n" "Local = LocalTimezone()\n" "\n" "\n" "# A complete implementation of current DST rules for major US time zones.\n" "\n" -"def first_sunday_on_or_after(dt):\n" -" days_to_go = 6 - dt.weekday()\n" +"def first_sunday_on_or_after(when):\n" +" days_to_go = 6 - when.weekday()\n" " if days_to_go:\n" -" dt += timedelta(days_to_go)\n" -" return dt\n" +" when += dt.timedelta(days_to_go)\n" +" return when\n" "\n" "\n" "# US DST Rules\n" @@ -2550,22 +2592,23 @@ msgid "" "#\n" "# In the US, since 2007, DST starts at 2am (standard time) on the second\n" "# Sunday in March, which is the first Sunday on or after Mar 8.\n" -"DSTSTART_2007 = datetime(1, 3, 8, 2)\n" +"DSTSTART_2007 = dt.datetime(1, 3, 8, 2)\n" "# and ends at 2am (DST time) on the first Sunday of Nov.\n" -"DSTEND_2007 = datetime(1, 11, 1, 2)\n" +"DSTEND_2007 = dt.datetime(1, 11, 1, 2)\n" "# From 1987 to 2006, DST used to start at 2am (standard time) on the first\n" "# Sunday in April and to end at 2am (DST time) on the last\n" "# Sunday of October, which is the first Sunday on or after Oct 25.\n" -"DSTSTART_1987_2006 = datetime(1, 4, 1, 2)\n" -"DSTEND_1987_2006 = datetime(1, 10, 25, 2)\n" +"DSTSTART_1987_2006 = dt.datetime(1, 4, 1, 2)\n" +"DSTEND_1987_2006 = dt.datetime(1, 10, 25, 2)\n" "# From 1967 to 1986, DST used to start at 2am (standard time) on the last\n" "# Sunday in April (the one on or after April 24) and to end at 2am (DST " "time)\n" "# on the last Sunday of October, which is the first Sunday\n" "# on or after Oct 25.\n" -"DSTSTART_1967_1986 = datetime(1, 4, 24, 2)\n" +"DSTSTART_1967_1986 = dt.datetime(1, 4, 24, 2)\n" "DSTEND_1967_1986 = DSTEND_1987_2006\n" "\n" +"\n" "def us_dst_range(year):\n" " # Find start and end times for US DST. For years before 1967, return\n" " # start = end for no DST.\n" @@ -2576,17 +2619,17 @@ msgid "" " elif 1966 < year < 1987:\n" " dststart, dstend = DSTSTART_1967_1986, DSTEND_1967_1986\n" " else:\n" -" return (datetime(year, 1, 1), ) * 2\n" +" return (dt.datetime(year, 1, 1), ) * 2\n" "\n" " start = first_sunday_on_or_after(dststart.replace(year=year))\n" " end = first_sunday_on_or_after(dstend.replace(year=year))\n" " return start, end\n" "\n" "\n" -"class USTimeZone(tzinfo):\n" +"class USTimeZone(dt.tzinfo):\n" "\n" " def __init__(self, hours, reprname, stdname, dstname):\n" -" self.stdoffset = timedelta(hours=hours)\n" +" self.stdoffset = dt.timedelta(hours=hours)\n" " self.reprname = reprname\n" " self.stdname = stdname\n" " self.dstname = dstname\n" @@ -2594,45 +2637,45 @@ msgid "" " def __repr__(self):\n" " return self.reprname\n" "\n" -" def tzname(self, dt):\n" -" if self.dst(dt):\n" +" def tzname(self, when):\n" +" if self.dst(when):\n" " return self.dstname\n" " else:\n" " return self.stdname\n" "\n" -" def utcoffset(self, dt):\n" -" return self.stdoffset + self.dst(dt)\n" +" def utcoffset(self, when):\n" +" return self.stdoffset + self.dst(when)\n" "\n" -" def dst(self, dt):\n" -" if dt is None or dt.tzinfo is None:\n" +" def dst(self, when):\n" +" if when is None or when.tzinfo is None:\n" " # An exception may be sensible here, in one or both cases.\n" " # It depends on how you want to treat them. The default\n" " # fromutc() implementation (called by the default astimezone()\n" -" # implementation) passes a datetime with dt.tzinfo is self.\n" +" # implementation) passes a datetime with when.tzinfo is self.\n" " return ZERO\n" -" assert dt.tzinfo is self\n" -" start, end = us_dst_range(dt.year)\n" +" assert when.tzinfo is self\n" +" start, end = us_dst_range(when.year)\n" " # Can't compare naive to aware objects, so strip the timezone from\n" -" # dt first.\n" -" dt = dt.replace(tzinfo=None)\n" -" if start + HOUR <= dt < end - HOUR:\n" +" # when first.\n" +" when = when.replace(tzinfo=None)\n" +" if start + HOUR <= when < end - HOUR:\n" " # DST is in effect.\n" " return HOUR\n" -" if end - HOUR <= dt < end:\n" -" # Fold (an ambiguous hour): use dt.fold to disambiguate.\n" -" return ZERO if dt.fold else HOUR\n" -" if start <= dt < start + HOUR:\n" +" if end - HOUR <= when < end:\n" +" # Fold (an ambiguous hour): use when.fold to disambiguate.\n" +" return ZERO if when.fold else HOUR\n" +" if start <= when < start + HOUR:\n" " # Gap (a non-existent hour): reverse the fold rule.\n" -" return HOUR if dt.fold else ZERO\n" +" return HOUR if when.fold else ZERO\n" " # DST is off.\n" " return ZERO\n" "\n" -" def fromutc(self, dt):\n" -" assert dt.tzinfo is self\n" -" start, end = us_dst_range(dt.year)\n" +" def fromutc(self, when):\n" +" assert when.tzinfo is self\n" +" start, end = us_dst_range(when.year)\n" " start = start.replace(tzinfo=self)\n" " end = end.replace(tzinfo=self)\n" -" std_time = dt + self.stdoffset\n" +" std_time = when + self.stdoffset\n" " dst_time = std_time + HOUR\n" " if end <= dst_time < end + HOUR:\n" " # Repeated hour\n" @@ -2652,11 +2695,11 @@ msgid "" msgstr "" msgid "" -"Note that there are unavoidable subtleties twice per year in a :class:" -"`tzinfo` subclass accounting for both standard and daylight time, at the DST " -"transition points. For concreteness, consider US Eastern (UTC -0500), where " -"EDT begins the minute after 1:59 (EST) on the second Sunday in March, and " -"ends the minute after 1:59 (EDT) on the first Sunday in November::" +"Note that there are unavoidable subtleties twice per year in " +"a :class:`tzinfo` subclass accounting for both standard and daylight time, " +"at the DST transition points. For concreteness, consider US Eastern (UTC " +"-0500), where EDT begins the minute after 1:59 (EST) on the second Sunday in " +"March, and ends the minute after 1:59 (EDT) on the first Sunday in November::" msgstr "" msgid "" @@ -2678,9 +2721,9 @@ msgid "" msgstr "" msgid "" -">>> from datetime import datetime, timezone\n" +">>> import datetime as dt\n" ">>> from tzinfo_examples import HOUR, Eastern\n" -">>> u0 = datetime(2016, 3, 13, 5, tzinfo=timezone.utc)\n" +">>> u0 = dt.datetime(2016, 3, 13, 5, tzinfo=dt.timezone.utc)\n" ">>> for i in range(4):\n" "... u = u0 + i*HOUR\n" "... t = u.astimezone(Eastern)\n" @@ -2707,7 +2750,9 @@ msgid "" msgstr "" msgid "" -">>> u0 = datetime(2016, 11, 6, 4, tzinfo=timezone.utc)\n" +">>> import datetime as dt\n" +">>> from tzinfo_examples import HOUR, Eastern\n" +">>> u0 = dt.datetime(2016, 11, 6, 4, tzinfo=dt.timezone.utc)\n" ">>> for i in range(4):\n" "... u = u0 + i*HOUR\n" "... t = u.astimezone(Eastern)\n" @@ -2726,11 +2771,11 @@ msgstr "" msgid "" "Applications that can't bear wall-time ambiguities should explicitly check " -"the value of the :attr:`~.datetime.fold` attribute or avoid using hybrid :" -"class:`tzinfo` subclasses; there are no ambiguities when using :class:" -"`timezone`, or any other fixed-offset :class:`tzinfo` subclass (such as a " -"class representing only EST (fixed offset -5 hours), or only EDT (fixed " -"offset -4 hours))." +"the value of the :attr:`~.datetime.fold` attribute or avoid using " +"hybrid :class:`tzinfo` subclasses; there are no ambiguities when " +"using :class:`timezone`, or any other fixed-offset :class:`!tzinfo` subclass " +"(such as a class representing only EST (fixed offset -5 hours), or only EDT " +"(fixed offset -4 hours))." msgstr "" msgid ":mod:`zoneinfo`" @@ -2811,8 +2856,8 @@ msgid "Always returns ``None``." msgstr "" msgid "" -"Return ``dt + offset``. The *dt* argument must be an aware :class:`." -"datetime` instance, with ``tzinfo`` set to ``self``." +"Return ``dt + offset``. The *dt* argument must be an " +"aware :class:`.datetime` instance, with ``tzinfo`` set to ``self``." msgstr "" msgid "The UTC time zone, ``timezone(timedelta(0))``." @@ -2828,14 +2873,14 @@ msgid "" msgstr "" msgid "" -"Conversely, the :meth:`datetime.strptime` class method creates a :class:`." -"datetime` object from a string representing a date and time and a " +"Conversely, the :meth:`datetime.strptime` class method creates " +"a :class:`.datetime` object from a string representing a date and time and a " "corresponding format string." msgstr "" msgid "" -"The table below provides a high-level comparison of :meth:`~.datetime." -"strftime` versus :meth:`~.datetime.strptime`:" +"The table below provides a high-level comparison " +"of :meth:`~.datetime.strftime` versus :meth:`~.datetime.strptime`:" msgstr "" msgid "``strftime``" @@ -2845,7 +2890,7 @@ msgid "``strptime``" msgstr "``strptime``" msgid "Usage" -msgstr "" +msgstr "Użytek" msgid "Convert object to a string according to a given format" msgstr "" @@ -2891,8 +2936,9 @@ msgid "" msgstr "" msgid "" -">>> datetime.strptime('31/01/22 23:59:59.999999',\n" -"... '%d/%m/%y %H:%M:%S.%f')\n" +">>> import datetime as dt\n" +">>> dt.datetime.strptime('31/01/22 23:59:59.999999',\n" +"... '%d/%m/%y %H:%M:%S.%f')\n" "datetime.datetime(2022, 1, 31, 23, 59, 59, 999999)\n" ">>> _.strftime('%a %d %b %Y, %I:%M%p')\n" "'Mon 31 Jan 2022, 11:59PM'" @@ -2958,7 +3004,7 @@ msgid "01, 02, ..., 31" msgstr "" msgid "\\(9)" -msgstr "" +msgstr "\\(9)" msgid "``%b``" msgstr "``%b``" @@ -3083,7 +3129,7 @@ msgid "(empty), +0000, -0400, +1030, +063415, -030712.345216" msgstr "" msgid "\\(6)" -msgstr "" +msgstr "\\(6)" msgid "``%Z``" msgstr "``%Z``" @@ -3189,7 +3235,7 @@ msgid "" msgstr "" msgid "\\(8)" -msgstr "" +msgstr "\\(8)" msgid "``%u``" msgstr "``%u``" @@ -3226,11 +3272,11 @@ msgid "(empty), +00:00, -04:00, +10:30, +06:34:15, -03:07:12.345216" msgstr "" msgid "" -"These may not be available on all platforms when used with the :meth:`~." -"datetime.strftime` method. The ISO 8601 year and ISO 8601 week directives " -"are not interchangeable with the year and week number directives above. " -"Calling :meth:`~.datetime.strptime` with incomplete or ambiguous ISO 8601 " -"directives will raise a :exc:`ValueError`." +"These may not be available on all platforms when used with " +"the :meth:`~.datetime.strftime` method. The ISO 8601 year and ISO 8601 week " +"directives are not interchangeable with the year and week number directives " +"above. Calling :meth:`~.datetime.strptime` with incomplete or ambiguous ISO " +"8601 directives will raise a :exc:`ValueError`." msgstr "" msgid "" @@ -3253,14 +3299,39 @@ msgstr "" msgid "" "Broadly speaking, ``d.strftime(fmt)`` acts like the :mod:`time` module's " -"``time.strftime(fmt, d.timetuple())`` although not all objects support a :" -"meth:`~date.timetuple` method." +"``time.strftime(fmt, d.timetuple())`` although not all objects support " +"a :meth:`~date.timetuple` method." msgstr "" msgid "" "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. [#]_" +"string will be pulled from the default value." +msgstr "" + +msgid "" +"Format strings without separators can be ambiguous for parsing. For example, " +"with ``%Y%m%d``, the string ``2026111`` may be parsed either as " +"``2026-11-01`` or as ``2026-01-11``. Use separators to ensure the input is " +"parsed as intended." +msgstr "" + +msgid "" +"When used to parse partial dates lacking a year, :meth:`.datetime.strptime` " +"will raise when encountering February 29 because the default year of 1900 is " +"*not* a leap year. Always add a default leap year to partial date strings " +"before parsing." +msgstr "" + +msgid "" +">>> import datetime as dt\n" +">>> value = \"2/29\"\n" +">>> dt.datetime.strptime(value, \"%m/%d\")\n" +"Traceback (most recent call last):\n" +"...\n" +"ValueError: day 29 must be in range 1..28 for month 2 in year 1900\n" +">>> dt.datetime.strptime(f\"1904 {value}\", \"%Y %m/%d\")\n" +"datetime.datetime(1904, 2, 29, 0, 0)" msgstr "" msgid "Using ``datetime.strptime(date_string, format)`` is equivalent to::" @@ -3288,8 +3359,8 @@ msgid "" "For the same reason, handling of format strings containing Unicode code " "points that can't be represented in the charset of the current locale is " "also platform-dependent. On some platforms such code points are preserved " -"intact in the output, while on others ``strftime`` may raise :exc:" -"`UnicodeError` or return an empty string instead." +"intact in the output, while on others ``strftime`` may " +"raise :exc:`UnicodeError` or return an empty string instead." msgstr "" msgid "" @@ -3348,9 +3419,9 @@ msgid "" "seconds and ``ffffff`` is a 6-digit string giving the number of UTC offset " "microseconds. The ``ffffff`` part is omitted when the offset is a whole " "number of seconds and both the ``ffffff`` and the ``SS`` part is omitted " -"when the offset is a whole number of minutes. For example, if :meth:`~." -"datetime.utcoffset` returns ``timedelta(hours=-3, minutes=-30)``, ``%z`` is " -"replaced with the string ``'-0330'``." +"when the offset is a whole number of minutes. For example, " +"if :meth:`~.datetime.utcoffset` returns ``timedelta(hours=-3, " +"minutes=-30)``, ``%z`` is replaced with the string ``'-0330'``." msgstr "" msgid "" @@ -3367,9 +3438,9 @@ msgid "" msgstr "" msgid "" -"In :meth:`~.datetime.strftime`, ``%Z`` is replaced by an empty string if :" -"meth:`~.datetime.tzname` returns ``None``; otherwise ``%Z`` is replaced by " -"the returned value, which must be a string." +"In :meth:`~.datetime.strftime`, ``%Z`` is replaced by an empty string " +"if :meth:`~.datetime.tzname` returns ``None``; otherwise ``%Z`` is replaced " +"by the returned value, which must be a string." msgstr "" msgid ":meth:`~.datetime.strptime` only accepts certain values for ``%Z``:" @@ -3401,9 +3472,9 @@ msgstr "" msgid "" "Similar to ``%U`` and ``%W``, ``%V`` is only used in calculations when the " -"day of the week and the ISO year (``%G``) are specified in a :meth:`~." -"datetime.strptime` format string. Also note that ``%G`` and ``%Y`` are not " -"interchangeable." +"day of the week and the ISO year (``%G``) are specified in " +"a :meth:`~.datetime.strptime` format string. Also note that ``%G`` and " +"``%Y`` are not interchangeable." msgstr "" msgid "" @@ -3418,13 +3489,13 @@ msgid "" "include a year in the format. If the value you need to parse lacks a year, " "append an explicit dummy leap year. Otherwise your code will raise an " "exception when it encounters leap day because the default year used by the " -"parser is not a leap year. Users run into this bug every four years..." +"parser (1900) is not a leap year. Users run into that bug every leap year." msgstr "" msgid "" ">>> month_day = \"02/29\"\n" -">>> datetime.strptime(f\"{month_day};1984\", \"%m/%d;%Y\") # No leap year " -"bug.\n" +">>> dt.datetime.strptime(f\"{month_day};1984\", \"%m/%d;%Y\") # No leap " +"year bug.\n" "datetime.datetime(1984, 2, 29, 0, 0)" msgstr "" @@ -3438,7 +3509,7 @@ msgstr "" msgid "Footnotes" msgstr "Przypisy" -msgid "If, that is, we ignore the effects of Relativity" +msgid "If, that is, we ignore the effects of relativity." msgstr "" msgid "" @@ -3455,11 +3526,6 @@ msgid "" "~gent0113/calendar/isocalendar.htm>`_ for a good explanation." msgstr "" -msgid "" -"Passing ``datetime.strptime('Feb 29', '%b %d')`` will fail since 1900 is not " -"a leap year." -msgstr "" - msgid "% (percent)" msgstr "" diff --git a/library/dbm.po b/library/dbm.po index 44116fa1cb..52f4f5f2c4 100644 --- a/library/dbm.po +++ b/library/dbm.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!dbm` --- Interfaces to Unix \"databases\"" msgstr "" msgid "**Source code:** :source:`Lib/dbm/__init__.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/dbm/__init__.py`" msgid ":mod:`dbm` is a generic interface to variants of the DBM database:" msgstr "" @@ -56,8 +55,8 @@ msgstr "" msgid "" "This function attempts to guess which of the several simple database modules " -"available --- :mod:`dbm.sqlite3`, :mod:`dbm.gnu`, :mod:`dbm.ndbm`, or :mod:" -"`dbm.dumb` --- should be used to open a given file." +"available --- :mod:`dbm.sqlite3`, :mod:`dbm.gnu`, :mod:`dbm.ndbm`, " +"or :mod:`dbm.dumb` --- should be used to open a given file." msgstr "" msgid "Return one of the following values:" @@ -85,10 +84,10 @@ msgid "Parameters" msgstr "parametry" msgid "" -"The database file to open. If the database file already exists, the :func:" -"`whichdb` function is used to determine its type and the appropriate module " -"is used; if it does not exist, the first submodule listed above that can be " -"imported is used." +"The database file to open. If the database file already exists, " +"the :func:`whichdb` function is used to determine its type and the " +"appropriate module is used; if it does not exist, the first submodule listed " +"above that can be imported is used." msgstr "" msgid "The database file to open." @@ -109,13 +108,13 @@ msgid "``'r'`` (default): |flag_r|" msgstr "" msgid "``'w'``: |flag_w|" -msgstr "" +msgstr "``'w'``: |flag_w|" msgid "``'c'``: |flag_c|" -msgstr "" +msgstr "``'c'``: |flag_c|" msgid "``'n'``: |flag_n|" -msgstr "" +msgstr "``'n'``: |flag_n|" msgid "|mode_param_doc|" msgstr "" @@ -124,11 +123,12 @@ msgid "*file* accepts a :term:`path-like object`." msgstr "" msgid "" -"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." +"The object returned by :func:`~dbm.open` supports the basic functionality of " +"mutable :term:`mappings `; keys and their corresponding values can " +"be stored, retrieved, and deleted, and iteration, the :keyword:`in` operator " +"and methods :meth:`!keys`, :meth:`!get`, :meth:`!setdefault` and :meth:`!" +"clear` are available. The :meth:`!keys` method returns a list instead of a " +"view object. The :meth:`!setdefault` method requires two arguments." msgstr "" msgid "" @@ -143,8 +143,8 @@ msgid "" msgstr "" msgid "" -":meth:`!get` and :meth:`!setdefault` methods are now available for all :mod:" -"`dbm` backends." +":meth:`!get` and :meth:`!setdefault` methods are now available for " +"all :mod:`dbm` backends." msgstr "" msgid "" @@ -157,6 +157,9 @@ msgid "" "exception instead of :exc:`KeyError`." msgstr "" +msgid ":meth:`!clear` methods are now available for all :mod:`dbm` backends." +msgstr "" + msgid "" "The following example records some hostnames and a corresponding title, and " "then prints out the contents of the database::" @@ -201,13 +204,13 @@ msgid ":mod:`dbm.sqlite3` --- SQLite backend for dbm" msgstr "" msgid "**Source code:** :source:`Lib/dbm/sqlite3.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/dbm/sqlite3.py`" msgid "" "This module uses the standard library :mod:`sqlite3` module to provide an " -"SQLite backend for the :mod:`dbm` module. The files created by :mod:`dbm." -"sqlite3` can thus be opened by :mod:`sqlite3`, or any other SQLite browser, " -"including the SQLite CLI." +"SQLite backend for the :mod:`dbm` module. The files created " +"by :mod:`dbm.sqlite3` can thus be opened by :mod:`sqlite3`, or any other " +"SQLite browser, including the SQLite CLI." msgstr "" msgid "Availability" @@ -218,10 +221,7 @@ msgid "" "availability` for more information." msgstr "" -msgid "" -"Open an SQLite database. The returned object behaves like a :term:`mapping`, " -"implements a :meth:`!close` method, and supports a \"closing\" context " -"manager via the :keyword:`with` keyword." +msgid "Open an SQLite database." msgstr "" msgid "The path to the database to be opened." @@ -232,11 +232,24 @@ msgid "" "when the database has to be created." msgstr "" +msgid "" +"The returned database object behaves similar to a mutable :term:`mapping`, " +"but the :meth:`!keys` method returns a list, and the :meth:`!setdefault` " +"method requires two arguments. It also supports a \"closing\" context " +"manager via the :keyword:`with` keyword." +msgstr "" + +msgid "The following method is also provided:" +msgstr "" + +msgid "Close the SQLite database." +msgstr "" + msgid ":mod:`dbm.gnu` --- GNU database manager" msgstr "" msgid "**Source code:** :source:`Lib/dbm/gnu.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/dbm/gnu.py`" msgid "" "The :mod:`dbm.gnu` module provides an interface to the :abbr:`GDBM (GNU " @@ -255,9 +268,14 @@ msgid "" msgstr "" msgid "" -"Raised on :mod:`dbm.gnu`-specific errors, such as I/O errors. :exc:" -"`KeyError` is raised for general mapping errors like specifying an incorrect " -"key." +"Raised on :mod:`dbm.gnu`-specific errors, such as I/O " +"errors. :exc:`KeyError` is raised for general mapping errors like specifying " +"an incorrect key." +msgstr "" + +msgid "" +"A string of characters the *flag* parameter of :meth:`~dbm.gnu.open` " +"supports." msgstr "" msgid "Open a GDBM database and return a :class:`!gdbm` object." @@ -304,14 +322,23 @@ msgid "If an invalid *flag* argument is passed." msgstr "" msgid "" -"A string of characters the *flag* parameter of :meth:`~dbm.gnu.open` " -"supports." +":class:`!gdbm` objects behave similar to mutable :term:`mappings `, " +"but methods :meth:`!items`, :meth:`!values`, :meth:`!pop`, :meth:`!popitem`, " +"and :meth:`!update` are not supported, the :meth:`!keys` method returns a " +"list, and the :meth:`!setdefault` method requires two arguments. It also " +"supports a \"closing\" context manager via the :keyword:`with` keyword." msgstr "" -msgid "" -":class:`!gdbm` objects behave similar to :term:`mappings `, but :" -"meth:`!items` and :meth:`!values` methods are not supported. The following " -"methods are also provided:" +msgid "Added the :meth:`!get` and :meth:`!setdefault` methods." +msgstr "" + +msgid "Added the :meth:`!clear` method." +msgstr "" + +msgid "The following methods are also provided:" +msgstr "" + +msgid "Close the GDBM database." msgstr "" msgid "" @@ -336,10 +363,10 @@ msgstr "" msgid "" "If you have carried out a lot of deletions and would like to shrink the " -"space used by the GDBM file, this routine will reorganize the database. :" -"class:`!gdbm` objects will not shorten the length of a database file except " -"by using this reorganization; otherwise, deleted file space will be kept and " -"reused as new (key, value) pairs are added." +"space used by the GDBM file, this routine will reorganize the " +"database. :class:`!gdbm` objects will not shorten the length of a database " +"file except by using this reorganization; otherwise, deleted file space will " +"be kept and reused as new (key, value) pairs are added." msgstr "" msgid "" @@ -347,17 +374,11 @@ msgid "" "unwritten data to be written to the disk." msgstr "" -msgid "Close the GDBM database." -msgstr "" - -msgid "Remove all items from the GDBM database." -msgstr "" - msgid ":mod:`dbm.ndbm` --- New Database Manager" msgstr "" msgid "**Source code:** :source:`Lib/dbm/ndbm.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/dbm/ndbm.py`" msgid "" "The :mod:`dbm.ndbm` module provides an interface to the :abbr:`NDBM (New " @@ -373,9 +394,9 @@ msgid "" msgstr "" msgid "" -"Raised on :mod:`dbm.ndbm`-specific errors, such as I/O errors. :exc:" -"`KeyError` is raised for general mapping errors like specifying an incorrect " -"key." +"Raised on :mod:`dbm.ndbm`-specific errors, such as I/O " +"errors. :exc:`KeyError` is raised for general mapping errors like specifying " +"an incorrect key." msgstr "" msgid "Name of the NDBM implementation library used." @@ -389,32 +410,31 @@ msgid "" "extensions)." msgstr "" -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 "Accepts :term:`path-like object` for filename." msgstr "" -msgid "Close the NDBM database." +msgid "" +":class:`!ndbm` objects behave similar to mutable :term:`mappings `, " +"but methods :meth:`!items`, :meth:`!values`, :meth:`!pop`, :meth:`!popitem`, " +"and :meth:`!update` are not supported, the :meth:`!keys` method returns a " +"list, and the :meth:`!setdefault` method requires two arguments. It also " +"supports a \"closing\" context manager via the :keyword:`with` keyword." msgstr "" -msgid "Remove all items from the NDBM database." +msgid "Close the NDBM database." msgstr "" msgid ":mod:`dbm.dumb` --- Portable DBM implementation" msgstr "" msgid "**Source code:** :source:`Lib/dbm/dumb.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/dbm/dumb.py`" msgid "" -"The :mod:`dbm.dumb` module is intended as a last resort fallback for the :" -"mod:`dbm` module when a more robust module is not available. The :mod:`dbm." -"dumb` module is not written for speed and is not nearly as heavily used as " -"the other database modules." +"The :mod:`dbm.dumb` module is intended as a last resort fallback for " +"the :mod:`dbm` module when a more robust module is not available. " +"The :mod:`dbm.dumb` module is not written for speed and is not nearly as " +"heavily used as the other database modules." msgstr "" msgid "" @@ -427,21 +447,18 @@ msgid "The :mod:`!dbm.dumb` module defines the following:" msgstr "" msgid "" -"Raised on :mod:`dbm.dumb`-specific errors, such as I/O errors. :exc:" -"`KeyError` is raised for general mapping errors like specifying an incorrect " -"key." +"Raised on :mod:`dbm.dumb`-specific errors, such as I/O " +"errors. :exc:`KeyError` is raised for general mapping errors like " +"specifying an incorrect key." msgstr "" -msgid "" -"Open a :mod:`!dbm.dumb` database. The returned database object behaves " -"similar to a :term:`mapping`, in addition to providing :meth:`~dumbdbm.sync` " -"and :meth:`~dumbdbm.close` methods." +msgid "Open a :mod:`!dbm.dumb` database." msgstr "" msgid "" "The basename of the database file (without extensions). A new database " -"creates the following files: - :file:`{filename}.dat` - :file:`{filename}." -"dir`" +"creates the following files: - :file:`{filename}.dat` " +"- :file:`{filename}.dir`" msgstr "" msgid "" @@ -461,7 +478,7 @@ msgid "" msgstr "" msgid "``'r'``: |flag_r|" -msgstr "" +msgstr "``'r'``: |flag_r|" msgid "``'c'`` (default): |flag_c|" msgstr "" @@ -482,8 +499,13 @@ msgid "" msgstr "" msgid "" -"In addition to the methods provided by the :class:`collections.abc." -"MutableMapping` class, the following methods are provided:" +"The returned database object behaves similar to a mutable :term:`mapping`, " +"but the :meth:`!keys` and :meth:`!items` methods return lists, and " +"the :meth:`!setdefault` method requires two arguments. It also supports a " +"\"closing\" context manager via the :keyword:`with` keyword." +msgstr "" + +msgid "Close the database." msgstr "" msgid "" @@ -491,8 +513,5 @@ msgid "" "the :meth:`shelve.Shelf.sync` method." msgstr "" -msgid "Close the database." -msgstr "" - msgid "databases" msgstr "" diff --git a/library/debug.po b/library/debug.po index 4624775d9e..9e9aef1fb2 100644 --- a/library/debug.po +++ b/library/debug.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/library/decimal.po b/library/decimal.po index 83a97f8320..c30ac39b41 100644 --- a/library/decimal.po +++ b/library/decimal.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Michał Biliński , 2021 -# Stefan Ocetkiewicz , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,20 +27,20 @@ msgid ":mod:`!decimal` --- Decimal fixed-point and floating-point arithmetic" msgstr "" msgid "**Source code:** :source:`Lib/decimal.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/decimal.py`" msgid "" "The :mod:`decimal` module provides support for fast correctly rounded " -"decimal floating-point arithmetic. It offers several advantages over the :" -"class:`float` datatype:" +"decimal floating-point arithmetic. It offers several advantages over " +"the :class:`float` datatype:" msgstr "" msgid "" -"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." +"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 "" @@ -109,19 +107,18 @@ msgid "" "The context for arithmetic is an environment specifying precision, rounding " "rules, limits on exponents, flags indicating the results of operations, and " "trap enablers which determine whether signals are treated as exceptions. " -"Rounding options include :const:`ROUND_CEILING`, :const:`ROUND_DOWN`, :const:" -"`ROUND_FLOOR`, :const:`ROUND_HALF_DOWN`, :const:`ROUND_HALF_EVEN`, :const:" -"`ROUND_HALF_UP`, :const:`ROUND_UP`, and :const:`ROUND_05UP`." +"Rounding options " +"include :const:`ROUND_CEILING`, :const:`ROUND_DOWN`, :const:`ROUND_FLOOR`, :const:`ROUND_HALF_DOWN`, :const:`ROUND_HALF_EVEN`, :const:`ROUND_HALF_UP`, :const:`ROUND_UP`, " +"and :const:`ROUND_05UP`." msgstr "" msgid "" "Signals are groups of exceptional conditions arising during the course of " "computation. Depending on the needs of the application, signals may be " "ignored, considered as informational, or treated as exceptions. The signals " -"in the decimal module are: :const:`Clamped`, :const:`InvalidOperation`, :" -"const:`DivisionByZero`, :const:`Inexact`, :const:`Rounded`, :const:" -"`Subnormal`, :const:`Overflow`, :const:`Underflow` and :const:" -"`FloatOperation`." +"in the decimal module " +"are: :const:`Clamped`, :const:`InvalidOperation`, :const:`DivisionByZero`, :const:`Inexact`, :const:`Rounded`, :const:`Subnormal`, :const:`Overflow`, :const:`Underflow` " +"and :const:`FloatOperation`." msgstr "" msgid "" @@ -136,7 +133,7 @@ msgid "" "Arithmetic Specification `_." msgstr "" -msgid "Quick-start Tutorial" +msgid "Quick-start tutorial" msgstr "" msgid "" @@ -268,6 +265,28 @@ msgid "" "Decimal('0.77')" msgstr "" +msgid "" +"Decimals can be formatted (with :func:`format` built-in or :ref:`f-strings`) " +"in fixed-point or scientific notation, using the same formatting syntax " +"(see :ref:`formatspec`) as builtin :class:`float` type:" +msgstr "" + +msgid "" +">>> format(Decimal('2.675'), \"f\")\n" +"'2.675'\n" +">>> format(Decimal('2.675'), \".2f\")\n" +"'2.68'\n" +">>> f\"{Decimal('2.675'):.2f}\"\n" +"'2.68'\n" +">>> format(Decimal('2.675'), \".2e\")\n" +"'2.68e+0'\n" +">>> with localcontext() as ctx:\n" +"... ctx.rounding = ROUND_DOWN\n" +"... print(format(Decimal('2.675'), \".2f\"))\n" +"...\n" +"2.67" +msgstr "" + msgid "And some mathematical functions are also available to Decimal:" msgstr "" @@ -285,15 +304,15 @@ 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." +"the :meth:`Context` constructor. To make an alternate active, use " +"the :func:`setcontext` function." msgstr "" msgid "" "In accordance with the standard, the :mod:`decimal` module provides two " -"ready to use standard contexts, :const:`BasicContext` and :const:" -"`ExtendedContext`. The former is especially useful for debugging because " -"many of the traps are enabled:" +"ready to use standard contexts, :const:`BasicContext` " +"and :const:`ExtendedContext`. The former is especially useful for debugging " +"because many of the traps are enabled:" msgstr "" msgid "" @@ -374,11 +393,11 @@ msgid "Construct a new :class:`Decimal` object based from *value*." msgstr "" msgid "" -"*value* can be an integer, string, tuple, :class:`float`, or another :class:" -"`Decimal` object. If no *value* is given, returns ``Decimal('0')``. If " -"*value* is a string, it should conform to the decimal numeric string syntax " -"after leading and trailing whitespace characters, as well as underscores " -"throughout, are removed::" +"*value* can be an integer, string, tuple, :class:`float`, or " +"another :class:`Decimal` object. If no *value* is given, returns " +"``Decimal('0')``. If *value* is a string, it should conform to the decimal " +"numeric string syntax after leading and trailing whitespace characters, as " +"well as underscores throughout, are removed::" msgstr "" msgid "" @@ -456,8 +475,8 @@ msgid "" "numeric types such as :class:`float` and :class:`int`. All of the usual " "math operations and special methods apply. Likewise, decimal objects can be " "copied, pickled, printed, used as dictionary keys, used as set elements, " -"compared, sorted, and coerced to another type (such as :class:`float` or :" -"class:`int`)." +"compared, sorted, and coerced to another type (such as :class:`float` " +"or :class:`int`)." msgstr "" msgid "" @@ -501,13 +520,13 @@ msgid "" msgstr "" msgid "" -"Decimal objects cannot generally be combined with floats or instances of :" -"class:`fractions.Fraction` in arithmetic operations: an attempt to add a :" -"class:`Decimal` to a :class:`float`, for example, will raise a :exc:" -"`TypeError`. However, it is possible to use Python's comparison operators " -"to compare a :class:`Decimal` instance ``x`` with another number ``y``. " -"This avoids confusing results when doing equality comparisons between " -"numbers of different types." +"Decimal objects cannot generally be combined with floats or instances " +"of :class:`fractions.Fraction` in arithmetic operations: an attempt to add " +"a :class:`Decimal` to a :class:`float`, for example, will raise " +"a :exc:`TypeError`. However, it is possible to use Python's comparison " +"operators to compare a :class:`Decimal` instance ``x`` with another number " +"``y``. This avoids confusing results when doing equality comparisons " +"between numbers of different types." msgstr "" msgid "" @@ -528,9 +547,9 @@ msgid "" msgstr "" msgid "" -"Return a pair ``(n, d)`` of integers that represent the given :class:" -"`Decimal` instance as a fraction, in lowest terms and with a positive " -"denominator::" +"Return a pair ``(n, d)`` of integers that represent the " +"given :class:`Decimal` instance as a fraction, in lowest terms and with a " +"positive denominator::" msgstr "" msgid "" @@ -600,8 +619,8 @@ msgstr "" msgid "" "Compare two operands using their abstract representation rather than their " "value as in :meth:`compare_total`, but ignoring the sign of each operand. " -"``x.compare_total_mag(y)`` is equivalent to ``x.copy_abs().compare_total(y." -"copy_abs())``." +"``x.compare_total_mag(y)`` is equivalent to " +"``x.copy_abs().compare_total(y.copy_abs())``." msgstr "" msgid "" @@ -631,8 +650,8 @@ msgid "" msgstr "" msgid "" -"Alternative constructor that only accepts instances of :class:`float` or :" -"class:`int`." +"Alternative constructor that only accepts instances of :class:`float` " +"or :class:`int`." msgstr "" msgid "" @@ -689,13 +708,13 @@ msgid "" msgstr "" msgid "" -"Return :const:`True` if the argument is a (quiet or signaling) NaN and :" -"const:`False` otherwise." +"Return :const:`True` if the argument is a (quiet or signaling) NaN " +"and :const:`False` otherwise." msgstr "" msgid "" -"Return :const:`True` if the argument is a *normal* finite number. Return :" -"const:`False` if the argument is zero, subnormal, infinite or a NaN." +"Return :const:`True` if the argument is a *normal* finite number. " +"Return :const:`False` if the argument is zero, subnormal, infinite or a NaN." msgstr "" msgid "" @@ -719,8 +738,8 @@ msgid "" msgstr "" msgid "" -"Return :const:`True` if the argument is a (positive or negative) zero and :" -"const:`False` otherwise." +"Return :const:`True` if the argument is a (positive or negative) zero " +"and :const:`False` otherwise." msgstr "" msgid "" @@ -734,8 +753,8 @@ msgid "" msgstr "" msgid "" -"For a nonzero number, return the adjusted exponent of its operand as a :" -"class:`Decimal` instance. If the operand is a zero then ``Decimal('-" +"For a nonzero number, return the adjusted exponent of its operand as " +"a :class:`Decimal` instance. If the operand is a zero then ``Decimal('-" "Infinity')`` is returned and the :const:`DivisionByZero` flag is raised. If " "the operand is an infinity then ``Decimal('Infinity')`` is returned." msgstr "" @@ -896,8 +915,8 @@ msgid "" msgstr "" msgid "" -"An error is returned whenever the resulting exponent is greater than :attr:" -"`~Context.Emax` or less than :meth:`~Context.Etiny`." +"An error is returned whenever the resulting exponent is greater " +"than :attr:`~Context.Emax` or less than :meth:`~Context.Etiny`." msgstr "" msgid "" @@ -978,9 +997,9 @@ msgid "" msgstr "" msgid "" -"Round to the nearest integer without signaling :const:`Inexact` or :const:" -"`Rounded`. If given, applies *rounding*; otherwise, uses the rounding " -"method in either the supplied *context* or the current context." +"Round to the nearest integer without signaling :const:`Inexact` " +"or :const:`Rounded`. If given, applies *rounding*; otherwise, uses the " +"rounding method in either the supplied *context* or the current context." msgstr "" msgid "Decimal numbers can be rounded using the :func:`.round` function:" @@ -988,8 +1007,8 @@ msgstr "" msgid "" "If *ndigits* is not given or ``None``, returns the nearest :class:`int` to " -"*number*, rounding ties to even, and ignoring the rounding mode of the :" -"class:`Decimal` context. Raises :exc:`OverflowError` if *number* is an " +"*number*, rounding ties to even, and ignoring the rounding mode of " +"the :class:`Decimal` context. Raises :exc:`OverflowError` if *number* is an " "infinity or :exc:`ValueError` if it is a (quiet or signaling) NaN." msgstr "" @@ -998,10 +1017,11 @@ msgid "" "and a :class:`Decimal` representing *number* rounded to the nearest multiple " "of ``Decimal('1E-ndigits')`` is returned; in this case, ``round(number, " "ndigits)`` is equivalent to ``self.quantize(Decimal('1E-ndigits'))``. " -"Returns ``Decimal('NaN')`` if *number* is a quiet NaN. Raises :class:" -"`InvalidOperation` if *number* is an infinity, a signaling NaN, or if the " -"length of the coefficient after the quantize operation would be greater than " -"the current context's precision. In other words, for the non-corner cases:" +"Returns ``Decimal('NaN')`` if *number* is a quiet NaN. " +"Raises :class:`InvalidOperation` if *number* is an infinity, a signaling " +"NaN, or if the length of the coefficient after the quantize operation would " +"be greater than the current context's precision. In other words, for the " +"non-corner cases:" msgstr "" msgid "" @@ -1039,11 +1059,11 @@ msgid "Logical operands" msgstr "" msgid "" -"The :meth:`~Decimal.logical_and`, :meth:`~Decimal.logical_invert`, :meth:" -"`~Decimal.logical_or`, and :meth:`~Decimal.logical_xor` methods expect their " -"arguments to be *logical operands*. A *logical operand* is a :class:" -"`Decimal` instance whose exponent and sign are both zero, and whose digits " -"are all either ``0`` or ``1``." +"The :meth:`~Decimal.logical_and`, :meth:`~Decimal.logical_invert`, :meth:`~Decimal.logical_or`, " +"and :meth:`~Decimal.logical_xor` methods expect their arguments to be " +"*logical operands*. A *logical operand* is a :class:`Decimal` instance " +"whose exponent and sign are both zero, and whose digits are all either ``0`` " +"or ``1``." msgstr "" msgid "Context objects" @@ -1106,9 +1126,9 @@ msgid "" msgstr "" msgid "" -"Raises :exc:`TypeError` if *kwargs* supplies an attribute that :class:" -"`Context` doesn't support. Raises either :exc:`TypeError` or :exc:" -"`ValueError` if *kwargs* supplies an invalid value for an attribute." +"Raises :exc:`TypeError` if *kwargs* supplies an attribute " +"that :class:`Context` doesn't support. Raises either :exc:`TypeError` " +"or :exc:`ValueError` if *kwargs* supplies an invalid value for an attribute." msgstr "" msgid "" @@ -1123,10 +1143,10 @@ msgstr "" msgid "" "This is a standard context defined by the General Decimal Arithmetic " -"Specification. Precision is set to nine. Rounding is set to :const:" -"`ROUND_HALF_UP`. All flags are cleared. All traps are enabled (treated as " -"exceptions) except :const:`Inexact`, :const:`Rounded`, and :const:" -"`Subnormal`." +"Specification. Precision is set to nine. Rounding is set " +"to :const:`ROUND_HALF_UP`. All flags are cleared. All traps are enabled " +"(treated as exceptions) except :const:`Inexact`, :const:`Rounded`, " +"and :const:`Subnormal`." msgstr "" msgid "" @@ -1135,9 +1155,9 @@ msgstr "" msgid "" "This is a standard context defined by the General Decimal Arithmetic " -"Specification. Precision is set to nine. Rounding is set to :const:" -"`ROUND_HALF_EVEN`. All flags are cleared. No traps are enabled (so that " -"exceptions are not raised during computations)." +"Specification. Precision is set to nine. Rounding is set " +"to :const:`ROUND_HALF_EVEN`. All flags are cleared. No traps are enabled " +"(so that exceptions are not raised during computations)." msgstr "" msgid "" @@ -1167,9 +1187,10 @@ msgid "" msgstr "" msgid "" -"The default values are :attr:`Context.prec`\\ =\\ ``28``, :attr:`Context." -"rounding`\\ =\\ :const:`ROUND_HALF_EVEN`, and enabled traps for :class:" -"`Overflow`, :class:`InvalidOperation`, and :class:`DivisionByZero`." +"The default values are :attr:`Context.prec`\\ =\\ " +"``28``, :attr:`Context.rounding`\\ =\\ :const:`ROUND_HALF_EVEN`, and enabled " +"traps for :class:`Overflow`, :class:`InvalidOperation`, " +"and :class:`DivisionByZero`." msgstr "" msgid "" @@ -1184,39 +1205,37 @@ msgid "" msgstr "" msgid "" -"*prec* is an integer in the range [``1``, :const:`MAX_PREC`] that sets the " -"precision for arithmetic operations in the context." +"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`_." +msgid "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." +"Lists of 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`]." +"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')``." +"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 " +"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. " @@ -1239,12 +1258,13 @@ msgid "" "The :class:`Context` class defines several general purpose methods as well " "as a large number of methods for doing arithmetic directly in a given " "context. In addition, for each of the :class:`Decimal` methods described " -"above (with the exception of the :meth:`~Decimal.adjusted` and :meth:" -"`~Decimal.as_tuple` methods) there is a corresponding :class:`Context` " -"method. For example, for a :class:`Context` instance ``C`` and :class:" -"`Decimal` instance ``x``, ``C.exp(x)`` is equivalent to ``x." -"exp(context=C)``. Each :class:`Context` method accepts a Python integer (an " -"instance of :class:`int`) anywhere that a Decimal instance is accepted." +"above (with the exception of the :meth:`~Decimal.adjusted` " +"and :meth:`~Decimal.as_tuple` methods) there is a " +"corresponding :class:`Context` method. For example, for a :class:`Context` " +"instance ``C`` and :class:`Decimal` instance ``x``, ``C.exp(x)`` is " +"equivalent to ``x.exp(context=C)``. Each :class:`Context` method accepts a " +"Python integer (an instance of :class:`int`) anywhere that a Decimal " +"instance is accepted." msgstr "" msgid "Resets all of the flags to ``0``." @@ -1307,8 +1327,8 @@ msgstr "" msgid "" "Returns a value equal to ``Emin - prec + 1`` which is the minimum exponent " -"value for subnormal results. When underflow occurs, the exponent is set to :" -"const:`Etiny`." +"value for subnormal results. When underflow occurs, the exponent is set " +"to :const:`Etiny`." msgstr "" msgid "Returns a value equal to ``Emax - prec + 1``." @@ -1475,9 +1495,9 @@ msgid "" msgstr "" msgid "" -"The C module computes :meth:`power` in terms of the correctly rounded :meth:" -"`exp` and :meth:`ln` functions. The result is well-defined but only \"almost " -"always correctly rounded\"." +"The C module computes :meth:`power` in terms of the correctly " +"rounded :meth:`exp` and :meth:`ln` functions. The result is well-defined but " +"only \"almost always correctly rounded\"." msgstr "" msgid "" @@ -1557,10 +1577,10 @@ msgid "" msgstr "" msgid "32-bit" -msgstr "" +msgstr "32-bit" msgid "64-bit" -msgstr "" +msgstr "64-bit" msgid "``425000000``" msgstr "``425000000``" @@ -1638,18 +1658,18 @@ msgstr "" msgid "" "If the context's trap enabler is set for the signal, then the condition " -"causes a Python exception to be raised. For example, if the :class:" -"`DivisionByZero` trap is set, then a :exc:`DivisionByZero` exception is " -"raised upon encountering the condition." +"causes a Python exception to be raised. For example, if " +"the :class:`DivisionByZero` trap is set, then a :exc:`DivisionByZero` " +"exception is raised upon encountering the condition." msgstr "" msgid "Altered an exponent to fit representation constraints." msgstr "" msgid "" -"Typically, clamping occurs when an exponent falls outside the context's :" -"attr:`~Context.Emin` and :attr:`~Context.Emax` limits. If possible, the " -"exponent is reduced to fit by adding zeros to the coefficient." +"Typically, clamping occurs when an exponent falls outside the " +"context's :attr:`~Context.Emin` and :attr:`~Context.Emax` limits. If " +"possible, the exponent is reduced to fit by adding zeros to the coefficient." msgstr "" msgid "Base class for other signals and a subclass of :exc:`ArithmeticError`." @@ -1700,8 +1720,8 @@ msgid "" "Indicates the exponent is larger than :attr:`Context.Emax` after rounding " "has occurred. If not trapped, the result depends on the rounding mode, " "either pulling inward to the largest representable finite number or rounding " -"outward to ``Infinity``. In either case, :class:`Inexact` and :class:" -"`Rounded` are also signaled." +"outward to ``Infinity``. In either case, :class:`Inexact` " +"and :class:`Rounded` are also signaled." msgstr "" msgid "Rounding occurred though possibly no information was lost." @@ -1725,8 +1745,8 @@ msgid "Numerical underflow with result rounded to zero." msgstr "" msgid "" -"Occurs when a subnormal result is pushed to zero by rounding. :class:" -"`Inexact` and :class:`Subnormal` are also signaled." +"Occurs when a subnormal result is pushed to zero by " +"rounding. :class:`Inexact` and :class:`Subnormal` are also signaled." msgstr "" msgid "Enable stricter semantics for mixing floats and Decimals." @@ -1734,18 +1754,18 @@ msgstr "" msgid "" "If the signal is not trapped (default), mixing floats and Decimals is " -"permitted in the :class:`~decimal.Decimal` constructor, :meth:`~decimal." -"Context.create_decimal` and all comparison operators. Both conversion and " -"comparisons are exact. Any occurrence of a mixed operation is silently " -"recorded by setting :exc:`FloatOperation` in the context flags. Explicit " -"conversions with :meth:`~decimal.Decimal.from_float` or :meth:`~decimal." -"Context.create_decimal_from_float` do not set the flag." +"permitted in the :class:`~decimal.Decimal` " +"constructor, :meth:`~decimal.Context.create_decimal` and all comparison " +"operators. Both conversion and comparisons are exact. Any occurrence of a " +"mixed operation is silently recorded by setting :exc:`FloatOperation` in the " +"context flags. Explicit conversions with :meth:`~decimal.Decimal.from_float` " +"or :meth:`~decimal.Context.create_decimal_from_float` do not set the flag." msgstr "" msgid "" "Otherwise (the signal is trapped), only equality comparisons and explicit " -"conversions are silent. All other mixed operations raise :exc:" -"`FloatOperation`." +"conversions are silent. All other mixed operations " +"raise :exc:`FloatOperation`." msgstr "" msgid "The following table summarizes the hierarchy of signals::" @@ -1765,7 +1785,7 @@ msgid "" " FloatOperation(DecimalException, exceptions.TypeError)" msgstr "" -msgid "Floating-Point Notes" +msgid "Floating-point notes" msgstr "" msgid "Mitigating round-off error with increased precision" @@ -1848,10 +1868,10 @@ msgid "" msgstr "" msgid "" -"Some operations are indeterminate and return ``NaN``, or if the :exc:" -"`InvalidOperation` signal is trapped, raise an exception. For example, " -"``0/0`` returns ``NaN`` which means \"not a number\". This variety of " -"``NaN`` is quiet and, once created, will flow through other computations " +"Some operations are indeterminate and return ``NaN``, or if " +"the :exc:`InvalidOperation` signal is trapped, raise an exception. For " +"example, ``0/0`` returns ``NaN`` which means \"not a number\". This variety " +"of ``NaN`` is quiet and, once created, will flow through other computations " "always resulting in another ``NaN``. This behavior can be useful for a " "series of computations that occasionally have missing inputs --- it allows " "the calculation to proceed while flagging specific results as invalid." @@ -1869,14 +1889,14 @@ msgid "" "is a quiet or signaling ``NaN`` always returns :const:`False` (even when " "doing ``Decimal('NaN')==Decimal('NaN')``), while a test for inequality " "always returns :const:`True`. An attempt to compare two Decimals using any " -"of the ``<``, ``<=``, ``>`` or ``>=`` operators will raise the :exc:" -"`InvalidOperation` signal if either operand is a ``NaN``, and return :const:" -"`False` if this signal is not trapped. Note that the General Decimal " -"Arithmetic specification does not specify the behavior of direct " +"of the ``<``, ``<=``, ``>`` or ``>=`` operators will raise " +"the :exc:`InvalidOperation` signal if either operand is a ``NaN``, and " +"return :const:`False` if this signal is not trapped. Note that the General " +"Decimal Arithmetic specification does not specify the behavior of direct " "comparisons; these rules for comparisons involving a ``NaN`` were taken from " "the IEEE 854 standard (see Table 3 in section 5.7). To ensure strict " -"standards-compliance, use the :meth:`~Decimal.compare` and :meth:`~Decimal." -"compare_signal` methods instead." +"standards-compliance, use the :meth:`~Decimal.compare` " +"and :meth:`~Decimal.compare_signal` methods instead." msgstr "" msgid "" @@ -1910,9 +1930,9 @@ msgid "" msgstr "" msgid "" -"If :func:`setcontext` has not been called before :func:`getcontext`, then :" -"func:`getcontext` will automatically create a new context for use in the " -"current thread." +"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 "" @@ -2098,32 +2118,32 @@ msgid "Decimal FAQ" msgstr "" msgid "" -"Q. It is cumbersome to type ``decimal.Decimal('1234.5')``. Is there a way " +"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:" +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 " +"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 " +"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 " +"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 " +"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:" @@ -2135,22 +2155,22 @@ msgid "" msgstr "" msgid "" -"Q. There are many ways to express the same value. The numbers ``200``, " +"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 " +"A: The :meth:`~Decimal.normalize` method maps all equivalent values to a " "single representative:" msgstr "" -msgid "Q. When does rounding occur in a computation?" +msgid "Q: When does rounding occur in a computation?" msgstr "" msgid "" -"A. It occurs *after* the computation. The philosophy of the decimal " +"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 " @@ -2172,12 +2192,12 @@ msgid "" msgstr "" msgid "" -"Q. Some decimal values always print with exponential notation. Is there a " +"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 " +"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." @@ -2189,11 +2209,11 @@ msgid "" "the value unchanged:" msgstr "" -msgid "Q. Is there a way to convert a regular float to a :class:`Decimal`?" +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 " +"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 "" @@ -2206,25 +2226,25 @@ msgstr "" "Decimal('3.141592653589793115997963468544185161590576171875')" msgid "" -"Q. Within a complex calculation, how can I make sure that I haven't gotten a " +"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 " +"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 " +"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 " +"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 " @@ -2254,19 +2274,19 @@ msgstr "" "Decimal('1.23')" msgid "" -"Alternatively, inputs can be rounded upon creation using the :meth:`Context." -"create_decimal` method:" +"Alternatively, inputs can be rounded upon creation using " +"the :meth:`Context.create_decimal` method:" msgstr "" -msgid "Q. Is the CPython implementation fast for large numbers?" +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 `_ 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 " @@ -2274,10 +2294,10 @@ msgid "" msgstr "" msgid "" -"The context must be adapted for exact arbitrary precision arithmetic. :attr:" -"`~Context.Emin` and :attr:`~Context.Emax` should always be set to the " -"maximum values, :attr:`~Context.clamp` should always be 0 (the default). " -"Setting :attr:`~Context.prec` requires some care." +"The context must be adapted for exact arbitrary precision " +"arithmetic. :attr:`~Context.Emin` and :attr:`~Context.Emax` should always be " +"set to the maximum values, :attr:`~Context.clamp` should always be 0 (the " +"default). Setting :attr:`~Context.prec` requires some care." msgstr "" msgid "" diff --git a/library/devmode.po b/library/devmode.po index 682321da08..921ec9e414 100644 --- a/library/devmode.po +++ b/library/devmode.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -83,9 +83,9 @@ msgid "" msgstr "" msgid "" -"Use the :option:`-W error <-W>` command line option or set the :envvar:" -"`PYTHONWARNINGS` environment variable to ``error`` to treat warnings as " -"errors." +"Use the :option:`-W error <-W>` command line option or set " +"the :envvar:`PYTHONWARNINGS` environment variable to ``error`` to treat " +"warnings as errors." msgstr "" msgid "Install debug hooks on memory allocators to check for:" @@ -119,9 +119,8 @@ msgstr "" msgid "" "Call :func:`faulthandler.enable` at Python startup to install handlers for " -"the :const:`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal." -"SIGABRT`, :const:`~signal.SIGBUS` and :const:`~signal.SIGILL` signals to " -"dump the Python traceback on a crash." +"the :const:`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS` " +"and :const:`~signal.SIGILL` signals to dump the Python traceback on a crash." msgstr "" msgid "" @@ -131,8 +130,9 @@ msgid "" msgstr "" msgid "" -"Enable :ref:`asyncio debug mode `. For example, :mod:" -"`asyncio` checks for coroutines that were not awaited and logs them." +"Enable :ref:`asyncio debug mode `. For " +"example, :mod:`asyncio` checks for coroutines that were not awaited and logs " +"them." msgstr "" msgid "" @@ -142,8 +142,8 @@ msgstr "" msgid "" "Check the *encoding* and *errors* arguments for string encoding and decoding " -"operations. Examples: :func:`open`, :meth:`str.encode` and :meth:`bytes." -"decode`." +"operations. Examples: :func:`open`, :meth:`str.encode` " +"and :meth:`bytes.decode`." msgstr "" msgid "" @@ -164,16 +164,16 @@ msgid "" "The Python Development Mode does not enable the :mod:`tracemalloc` module by " "default, because the overhead cost (to performance and memory) would be too " "large. Enabling the :mod:`tracemalloc` module provides additional " -"information on the origin of some errors. For example, :exc:" -"`ResourceWarning` logs the traceback where the resource was allocated, and a " -"buffer overflow error logs the traceback where the memory block was " -"allocated." +"information on the origin of some errors. For " +"example, :exc:`ResourceWarning` logs the traceback where the resource was " +"allocated, and a buffer overflow error logs the traceback where the memory " +"block was allocated." msgstr "" msgid "" "The Python Development Mode does not prevent the :option:`-O` command line " -"option from removing :keyword:`assert` statements nor from setting :const:" -"`__debug__` to ``False``." +"option from removing :keyword:`assert` statements nor from " +"setting :const:`__debug__` to ``False``." msgstr "" msgid "" @@ -230,8 +230,8 @@ msgstr "" msgid "" "$ python -X dev script.py README.txt\n" "269\n" -"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper name='README." -"rst' mode='r' encoding='UTF-8'>\n" +"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper " +"name='README.rst' mode='r' encoding='UTF-8'>\n" " main()\n" "ResourceWarning: Enable tracemalloc to get the object allocation traceback" msgstr "" @@ -244,8 +244,8 @@ msgstr "" msgid "" "$ python -X dev -X tracemalloc=5 script.py README.rst\n" "269\n" -"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper name='README." -"rst' mode='r' encoding='UTF-8'>\n" +"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper " +"name='README.rst' mode='r' encoding='UTF-8'>\n" " main()\n" "Object allocated at (most recent call last):\n" " File \"script.py\", lineno 10\n" @@ -310,8 +310,8 @@ msgstr "" msgid "" "$ python -X dev script.py\n" "import os\n" -"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper name='script." -"py' mode='r' encoding='UTF-8'>\n" +"script.py:10: ResourceWarning: unclosed file <_io.TextIOWrapper " +"name='script.py' mode='r' encoding='UTF-8'>\n" " main()\n" "ResourceWarning: Enable tracemalloc to get the object allocation traceback\n" "Exception ignored in: <_io.TextIOWrapper name='script.py' mode='r' " @@ -326,8 +326,8 @@ msgid "" "``os.close(fp.fileno())`` closes the file descriptor. When the file object " "finalizer tries to close the file descriptor again, it fails with the ``Bad " "file descriptor`` error. A file descriptor must be closed only once. In the " -"worst case scenario, closing it twice can lead to a crash (see :issue:" -"`18748` for an example)." +"worst case scenario, closing it twice can lead to a crash " +"(see :issue:`18748` for an example)." msgstr "" msgid "" diff --git a/library/difflib.po b/library/difflib.po index 8dafb276b5..cbb2b96ae6 100644 --- a/library/difflib.po +++ b/library/difflib.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,51 +27,103 @@ msgid ":mod:`!difflib` --- Helpers for computing deltas" msgstr "" msgid "**Source code:** :source:`Lib/difflib.py`" +msgstr "**Kod źródłowy:** :source:`Lib/difflib.py`" + +msgid "" +"This module provides classes and functions for comparing sequences. Most of " +"them compare sequences of text lines (for example lists of strings, " +"or :term:`file objects `) and produce :dfn:`diffs` -- reports " +"on the differences. Diffs can be produced in various formats, including HTML " +"and context and unified diffs -- formats produced by tools " +"like :manpage:`diff ` and :manpage:`git diff `." msgstr "" msgid "" -"This module provides classes and functions for comparing sequences. It can " -"be used for example, for comparing files, and can produce information about " -"file differences in various formats, including HTML and context and unified " -"diffs. For comparing directories and files, see also, the :mod:`filecmp` " -"module." +"Comparisons are done using a matching algorithm implemented " +"in :class:`SequenceMatcher` -- a flexible class for comparing pairs of " +"sequences of any type, not just text, so long as the sequence elements " +"are :term:`hashable`." +msgstr "" + +msgid "Junk heuristic" msgstr "" msgid "" -"This is a flexible class for comparing pairs of sequences of any type, so " -"long as the sequence elements are :term:`hashable`. The basic algorithm " -"predates, and is a little fancier than, an algorithm published in the late " -"1980's by Ratcliff and Obershelp under the hyperbolic name \"gestalt pattern " -"matching.\" The idea is to find the longest contiguous matching subsequence " -"that contains no \"junk\" elements; these \"junk\" elements are ones that " -"are uninteresting in some sense, such as blank lines or whitespace. " -"(Handling junk is an extension to the Ratcliff and Obershelp algorithm.) The " -"same idea is then applied recursively to the pieces of the sequences to the " -"left and to the right of the matching subsequence. This does not yield " -"minimal edit sequences, but does tend to yield matches that \"look right\" " -"to people." +":mod:`!difflib` uses a :dfn:`junk` heuristic: some items are deemed to " +"be :dfn:`junk`, and ignored when searching for similarities. Ideally, these " +"are uninteresting or common items, such as blank lines or whitespace." msgstr "" msgid "" -"**Timing:** The basic Ratcliff-Obershelp algorithm is cubic time in the " -"worst case and quadratic time in the expected case. :class:`SequenceMatcher` " -"is quadratic time for the worst case and has expected-case behavior " -"dependent in a complicated way on how many elements the sequences have in " -"common; best case time is linear." +"This heuristic can speed the algorithm up (because it reduces the number of " +"possible combinations) and it can produce results that are more " +"understandable for humans (typically breaking on whitespace). But it can " +"also cause pathological cases:" msgstr "" msgid "" -"**Automatic junk heuristic:** :class:`SequenceMatcher` supports a heuristic " -"that automatically treats certain sequence items as junk. The heuristic " -"counts how many times each individual item appears in the sequence. If an " -"item's duplicates (after the first one) account for more than 1% of the " -"sequence and the sequence is at least 200 items long, this item is marked as " -"\"popular\" and is treated as junk for the purpose of sequence matching. " -"This heuristic can be turned off by setting the ``autojunk`` argument to " -"``False`` when creating the :class:`SequenceMatcher`." +"Inappropriately chosen junk items can cause an unexpectedly **large** (but " +"still correct) result." msgstr "" -msgid "Added the *autojunk* parameter." +msgid "" +"The default heuristic is **asymmetric**: only the second sequence is " +"inspected when determining what is considered junk, so comparing A to B can " +"give different results than comparing B to A and reversing the result." +msgstr "" + +msgid "" +"By default, if the second input sequence is at least 200 items long, items " +"that account for more than 1% it are considered *junk*." +msgstr "" + +msgid "" +"Depending on your data, you should consider turning this heuristic off " +"(setting :class:`~difflib.SequenceMatcher`'s *autojunk* argument to " +"``False``) or tuning it (using the *isjunk* argument, perhaps to one of " +"the :ref:`predefined functions `)." +msgstr "" + +msgid "The :mod:`!difflib` algorithm" +msgstr "" + +msgid "" +"The algorithm used in :class:`SequenceMatcher` predates, and is a little " +"fancier than, an algorithm published in the late 1980s by Ratcliff and " +"Obershelp under the hyperbolic name \"gestalt pattern matching.\" The idea " +"is to find the longest contiguous subsequence common to both inputs, then " +"recursively handle the pieces of the sequences to the left and to the right " +"of the matching subsequence." +msgstr "" + +msgid "" +"`Pattern Matching: The Gestalt Approach `_" +msgstr "" + +msgid "" +"Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. " +"This was published in Dr. Dobb's Journal in July, 1988." +msgstr "" + +msgid "" +"As an extension to the Ratcliff and Obershelp algorithm, :mod:`!difflib` " +"searches for the longest *junk-free* contiguous subsequence. See " +"the :ref:`difflib-junk` section for details." +msgstr "" + +msgid "Timing" +msgstr "" + +msgid "" +"The basic Ratcliff-Obershelp algorithm is cubic time in the worst case and " +"quadratic time in the expected case. :mod:`difflib`'s algorithm is quadratic " +"time for the worst case and has expected-case behavior dependent in a " +"complicated way on how many elements the sequences have in common; best case " +"time is linear." +msgstr "" + +msgid "Diff generation" msgstr "" msgid "" @@ -122,6 +173,58 @@ msgid "" "tabs or line breaks." msgstr "" +msgid "" +"Note that :class:`Differ`\\ -generated deltas make no claim to be " +"**minimal** diffs. To the contrary, minimal diffs are often counter-" +"intuitive for humans, because they synch up anywhere possible, sometimes at " +"accidental matches 100 pages apart. Restricting synch points to contiguous " +"matches preserves some notion of locality, at the occasional cost of " +"producing a longer diff." +msgstr "" + +msgid "The :class:`Differ` class has this constructor:" +msgstr "" + +msgid "" +"Optional keyword parameters *linejunk* and *charjunk* are for filter " +"functions (or ``None``):" +msgstr "" + +msgid "" +"*linejunk*: A function that accepts a single string argument, and returns " +"true if the string is junk. The default is ``None``, meaning that no line " +"is considered junk." +msgstr "" + +msgid "" +"*charjunk*: A function that accepts a single character argument (a string of " +"length 1), and returns true if the character is junk. The default is " +"``None``, meaning that no character is considered junk." +msgstr "" + +msgid "" +"These junk-filtering functions speed up matching to find differences and do " +"not cause any differing lines or characters to be ignored. Read the " +"description of the :meth:`~SequenceMatcher.find_longest_match` method's " +"*isjunk* parameter for an explanation." +msgstr "" + +msgid "" +":class:`Differ` objects are used (deltas generated) via a single method:" +msgstr "" + +msgid "" +"Compare two sequences of lines, and generate the delta (a sequence of lines)." +msgstr "" + +msgid "" +"Each sequence must contain individual single-line strings ending with " +"newlines. Such sequences can be obtained from " +"the :meth:`~io.IOBase.readlines` method of file-like objects. The generated " +"delta also consists of newline-terminated strings, ready to be printed as-is " +"via the :meth:`~io.IOBase.writelines` method of a file-like object." +msgstr "" + msgid "" "This class can be used to create an HTML table (or a complete HTML file " "containing the table) showing a side by side, line by line comparison of " @@ -129,6 +232,11 @@ msgid "" "generated in either full or contextual difference mode." msgstr "" +msgid "" +"The trailing newlines get stripped before the diff, so the result can be " +"incomplete. See :gh:`71896` for details." +msgstr "" + msgid "The constructor for this class is:" msgstr "" @@ -146,10 +254,10 @@ msgid "" msgstr "" msgid "" -"*linejunk* and *charjunk* are optional keyword arguments passed into :func:" -"`ndiff` (used by :class:`HtmlDiff` to generate the side by side HTML " -"differences). See :func:`ndiff` documentation for argument default values " -"and descriptions." +"*linejunk* and *charjunk* are optional keyword arguments passed " +"into :func:`ndiff` (used by :class:`HtmlDiff` to generate the side by side " +"HTML differences). See :func:`ndiff` documentation for argument default " +"values and descriptions." msgstr "" msgid "The following methods are public:" @@ -195,8 +303,8 @@ msgid "" msgstr "" msgid "" -"The arguments for this method are the same as those for the :meth:" -"`make_file` method." +"The arguments for this method are the same as those for " +"the :meth:`make_file` method." msgstr "" msgid "" @@ -270,7 +378,7 @@ msgid "" "*linejunk*: A function that accepts a single string argument, and returns " "true if the string is junk, or false if not. The default is ``None``. There " "is also a module-level function :func:`IS_LINE_JUNK`, which filters out " -"lines without visible characters, except for at most one pound character " +"lines without visible characters, except for at most one hash character " "(``'#'``) -- however the underlying :class:`SequenceMatcher` class does a " "dynamic analysis of which lines are so frequent as to constitute noise, and " "this usually works better than using this function." @@ -338,6 +446,9 @@ msgid "" "unknown/inconsistent encodings as *a* and *b*." msgstr "" +msgid "Junk definition functions" +msgstr "" + msgid "" "Return ``True`` for ignorable lines. The line *line* is ignorable if *line* " "is blank or contains a single ``'#'``, otherwise it is not ignorable. Used " @@ -350,21 +461,7 @@ msgid "" "for parameter *charjunk* in :func:`ndiff`." msgstr "" -msgid "" -"`Pattern Matching: The Gestalt Approach `_" -msgstr "" - -msgid "" -"Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. " -"This was published in `Dr. Dobb's Journal `_ in " -"July, 1988." -msgstr "" - -msgid "SequenceMatcher Objects" -msgstr "" - -msgid "The :class:`SequenceMatcher` class has this constructor:" +msgid "SequenceMatcher objects" msgstr "" msgid "" @@ -385,8 +482,8 @@ msgstr "" msgid "" "The optional arguments *a* and *b* are sequences to be compared; both " -"default to empty strings. The elements of both sequences must be :term:" -"`hashable`." +"default to empty strings. The elements of both sequences must " +"be :term:`hashable`." msgstr "" msgid "" @@ -394,13 +491,16 @@ msgid "" "heuristic." msgstr "" +msgid "Added the *autojunk* parameter." +msgstr "" + msgid "" "SequenceMatcher objects get three data attributes: *bjunk* is the set of " "elements of *b* for which *isjunk* is ``True``; *bpopular* is the set of non-" "junk elements considered popular by the heuristic (if it is not disabled); " "*b2j* is a dict mapping the remaining elements of *b* to a list of positions " -"where they occur. All three are reset whenever *b* is reset with :meth:" -"`set_seqs` or :meth:`set_seq2`." +"where they occur. All three are reset whenever *b* is reset " +"with :meth:`set_seqs` or :meth:`set_seq2`." msgstr "" msgid "The *bjunk* and *bpopular* attributes." @@ -469,8 +569,8 @@ msgstr "" msgid "" "Return list of triples describing non-overlapping matching subsequences. " -"Each triple is of the form ``(i, j, n)``, and means that ``a[i:i+n] == b[j:" -"j+n]``. The triples are monotonically increasing in *i* and *j*." +"Each triple is of the form ``(i, j, n)``, and means that ``a[i:i+n] == " +"b[j:j+n]``. The triples are monotonically increasing in *i* and *j*." msgstr "" msgid "" @@ -566,27 +666,12 @@ msgid "" msgstr "" msgid "" -"This is expensive to compute if :meth:`get_matching_blocks` or :meth:" -"`get_opcodes` hasn't already been called, in which case you may want to try :" -"meth:`quick_ratio` or :meth:`real_quick_ratio` first to get an upper bound." -msgstr "" - -msgid "" -"Caution: The result of a :meth:`ratio` call may depend on the order of the " -"arguments. For instance::" +"This is expensive to compute if :meth:`get_matching_blocks` " +"or :meth:`get_opcodes` hasn't already been called, in which case you may " +"want to try :meth:`quick_ratio` or :meth:`real_quick_ratio` first to get an " +"upper bound." msgstr "" -msgid "" -">>> SequenceMatcher(None, 'tide', 'diet').ratio()\n" -"0.25\n" -">>> SequenceMatcher(None, 'diet', 'tide').ratio()\n" -"0.5" -msgstr "" -">>> SequenceMatcher(None, 'tide', 'diet').ratio()\n" -"0.25\n" -">>> SequenceMatcher(None, 'diet', 'tide').ratio()\n" -"0.5" - msgid "Return an upper bound on :meth:`ratio` relatively quickly." msgstr "" @@ -595,13 +680,16 @@ msgstr "" msgid "" "The three methods that return the ratio of matching to total characters can " -"give different results due to differing levels of approximation, although :" -"meth:`~SequenceMatcher.quick_ratio` and :meth:`~SequenceMatcher." -"real_quick_ratio` are always at least as large as :meth:`~SequenceMatcher." -"ratio`:" +"give different results due to differing levels of approximation, " +"although :meth:`~SequenceMatcher.quick_ratio` " +"and :meth:`~SequenceMatcher.real_quick_ratio` are always at least as large " +"as :meth:`~SequenceMatcher.ratio`:" msgstr "" -msgid "SequenceMatcher Examples" +msgid "Examples" +msgstr "Przykłady" + +msgid "SequenceMatcher examples" msgstr "" msgid "This example compares two strings, considering blanks to be \"junk\":" @@ -609,25 +697,26 @@ msgstr "" msgid "" ":meth:`~SequenceMatcher.ratio` returns a float in [0, 1], measuring the " -"similarity of the sequences. As a rule of thumb, a :meth:`~SequenceMatcher." -"ratio` value over 0.6 means the sequences are close matches:" +"similarity of the sequences. As a rule of thumb, " +"a :meth:`~SequenceMatcher.ratio` value over 0.6 means the sequences are " +"close matches:" msgstr "" msgid "" -"If you're only interested in where the sequences match, :meth:" -"`~SequenceMatcher.get_matching_blocks` is handy:" +"If you're only interested in where the sequences " +"match, :meth:`~SequenceMatcher.get_matching_blocks` is handy:" msgstr "" msgid "" -"Note that the last tuple returned by :meth:`~SequenceMatcher." -"get_matching_blocks` is always a dummy, ``(len(a), len(b), 0)``, and this is " -"the only case in which the last tuple element (number of elements matched) " -"is ``0``." +"Note that the last tuple returned " +"by :meth:`~SequenceMatcher.get_matching_blocks` is always a dummy, " +"``(len(a), len(b), 0)``, and this is the only case in which the last tuple " +"element (number of elements matched) is ``0``." msgstr "" msgid "" -"If you want to know how to change the first sequence into the second, use :" -"meth:`~SequenceMatcher.get_opcodes`:" +"If you want to know how to change the first sequence into the second, " +"use :meth:`~SequenceMatcher.get_opcodes`:" msgstr "" msgid "" @@ -637,66 +726,11 @@ msgstr "" msgid "" "`Simple version control recipe `_ for a small application built with :class:" -"`SequenceMatcher`." -msgstr "" - -msgid "Differ Objects" -msgstr "" - -msgid "" -"Note that :class:`Differ`\\ -generated deltas make no claim to be " -"**minimal** diffs. To the contrary, minimal diffs are often counter-" -"intuitive, because they synch up anywhere possible, sometimes accidental " -"matches 100 pages apart. Restricting synch points to contiguous matches " -"preserves some notion of locality, at the occasional cost of producing a " -"longer diff." -msgstr "" - -msgid "The :class:`Differ` class has this constructor:" -msgstr "" - -msgid "" -"Optional keyword parameters *linejunk* and *charjunk* are for filter " -"functions (or ``None``):" -msgstr "" - -msgid "" -"*linejunk*: A function that accepts a single string argument, and returns " -"true if the string is junk. The default is ``None``, meaning that no line " -"is considered junk." -msgstr "" - -msgid "" -"*charjunk*: A function that accepts a single character argument (a string of " -"length 1), and returns true if the character is junk. The default is " -"``None``, meaning that no character is considered junk." -msgstr "" - -msgid "" -"These junk-filtering functions speed up matching to find differences and do " -"not cause any differing lines or characters to be ignored. Read the " -"description of the :meth:`~SequenceMatcher.find_longest_match` method's " -"*isjunk* parameter for an explanation." -msgstr "" - -msgid "" -":class:`Differ` objects are used (deltas generated) via a single method:" -msgstr "" - -msgid "" -"Compare two sequences of lines, and generate the delta (a sequence of lines)." -msgstr "" - -msgid "" -"Each sequence must contain individual single-line strings ending with " -"newlines. Such sequences can be obtained from the :meth:`~io.IOBase." -"readlines` method of file-like objects. The delta generated also consists " -"of newline-terminated strings, ready to be printed as-is via the :meth:`~io." -"IOBase.writelines` method of a file-like object." +"simple-version-control/>`_ for a small application built " +"with :class:`SequenceMatcher`." msgstr "" -msgid "Differ Example" +msgid "Differ example" msgstr "" msgid "" @@ -732,7 +766,7 @@ msgid "" msgstr "" msgid "" -"\"\"\" Command line interface to difflib.py providing diffs in four " +"\"\"\" Command-line interface to difflib.py providing diffs in four " "formats:\n" "\n" "* ndiff: lists every line and highlights interline changes.\n" @@ -743,11 +777,11 @@ msgid "" "\"\"\"\n" "\n" "import sys, os, difflib, argparse\n" -"from datetime import datetime, timezone\n" +"import datetime as dt\n" "\n" "def file_mtime(path):\n" -" t = datetime.fromtimestamp(os.stat(path).st_mtime,\n" -" timezone.utc)\n" +" t = dt.datetime.fromtimestamp(os.stat(path).st_mtime,\n" +" dt.timezone.utc)\n" " return t.astimezone().isoformat()\n" "\n" "def main():\n" @@ -785,8 +819,8 @@ msgid "" " elif options.n:\n" " diff = difflib.ndiff(fromlines, tolines)\n" " elif options.m:\n" -" diff = difflib.HtmlDiff().make_file(fromlines,tolines,fromfile," -"tofile,context=options.c,numlines=n)\n" +" diff = " +"difflib.HtmlDiff().make_file(fromlines,tolines,fromfile,tofile,context=options.c,numlines=n)\n" " else:\n" " diff = difflib.context_diff(fromlines, tolines, fromfile, tofile, " "fromdate, todate, n=n)\n" @@ -830,8 +864,8 @@ msgid "" "confusing if the source files contain tab characters.\n" "\n" "The first file can be recovered by retaining only lines that begin with\n" -"\" \" or \"- \", and deleting those 2-character prefixes; use ndiff with -" -"r1.\n" +"\" \" or \"- \", and deleting those 2-character prefixes; use ndiff with " +"-r1.\n" "\n" "The second file can be recovered similarly, but by retaining only \" \" " "and\n" diff --git a/library/dis.po b/library/dis.po index 7ba948f713..1b520b912f 100644 --- a/library/dis.po +++ b/library/dis.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +28,7 @@ msgid ":mod:`!dis` --- Disassembler for Python bytecode" msgstr "" msgid "**Source code:** :source:`Lib/dis.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/dis.py`" msgid "" "The :mod:`dis` module supports the analysis of CPython :term:`bytecode` by " @@ -58,16 +57,16 @@ 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``." +"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 "" "The argument of a jump is the offset of the target instruction relative to " -"the instruction that appears immediately after the jump instruction's :" -"opcode:`CACHE` entries." +"the instruction that appears immediately after the jump " +"instruction's :opcode:`CACHE` entries." msgstr "" msgid "" @@ -109,7 +108,7 @@ msgid "(The \"2\" is a line number)." msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza poleceń" msgid "The :mod:`dis` module can be invoked as a script from the command line:" msgstr "" @@ -139,9 +138,9 @@ msgid "Bytecode analysis" msgstr "" msgid "" -"The bytecode analysis API allows pieces of Python code to be wrapped in a :" -"class:`Bytecode` object that provides easy access to details of the compiled " -"code." +"The bytecode analysis API allows pieces of Python code to be wrapped in " +"a :class:`Bytecode` object that provides easy access to details of the " +"compiled code." msgstr "" msgid "" @@ -196,8 +195,8 @@ msgid "The first source line of the code object (if available)" msgstr "" msgid "" -"Return a formatted view of the bytecode operations (the same as printed by :" -"func:`dis.dis`, but returned as a multi-line string)." +"Return a formatted view of the bytecode operations (the same as printed " +"by :func:`dis.dis`, but returned as a multi-line string)." msgstr "" msgid "" @@ -361,18 +360,18 @@ msgid "" msgstr "" msgid "" -"This generator function uses the :meth:`~codeobject.co_lines` method of the :" -"ref:`code object ` *code* to find the offsets which are starts " -"of lines in the source code. They are generated as ``(offset, lineno)`` " -"pairs." +"This generator function uses the :meth:`~codeobject.co_lines` method of " +"the :ref:`code object ` *code* to find the offsets which are " +"starts of lines in the source code. They are generated as ``(offset, " +"lineno)`` pairs." msgstr "" msgid "Line numbers can be decreasing. Before, they were always increasing." msgstr "" msgid "" -"The :pep:`626` :meth:`~codeobject.co_lines` method is used instead of the :" -"attr:`~codeobject.co_firstlineno` and :attr:`~codeobject.co_lnotab` " +"The :pep:`626` :meth:`~codeobject.co_lines` method is used instead of " +"the :attr:`~codeobject.co_firstlineno` and :attr:`~codeobject.co_lnotab` " "attributes of the :ref:`code object `." msgstr "" @@ -662,7 +661,7 @@ msgid "" "end = STACK.pop()\n" "start = STACK.pop()\n" "container = STACK.pop()\n" -"values = STACK.pop()\n" +"value = STACK.pop()\n" "container[start:end] = value" msgstr "" @@ -713,10 +712,10 @@ msgid "" msgstr "" msgid "" -"Handles an exception raised during a :meth:`~generator.throw` or :meth:" -"`~generator.close` call through the current frame. If ``STACK[-1]`` is an " -"instance of :exc:`StopIteration`, pop three values from the stack and push " -"its ``value`` member. Otherwise, re-raise ``STACK[-1]``." +"Handles an exception raised during a :meth:`~generator.throw` " +"or :meth:`~generator.close` call through the current frame. If " +"``STACK[-1]`` is an instance of :exc:`StopIteration`, pop three values from " +"the stack and push its ``value`` member. Otherwise, re-raise ``STACK[-1]``." msgstr "" msgid "" @@ -761,10 +760,10 @@ msgid "" msgstr "" msgid "" -"For all of the :opcode:`SET_ADD`, :opcode:`LIST_APPEND` and :opcode:" -"`MAP_ADD` instructions, while the added value or key/value pair is popped " -"off, the container object remains on the stack so that it is available for " -"further iterations of the loop." +"For all of the :opcode:`SET_ADD`, :opcode:`LIST_APPEND` " +"and :opcode:`MAP_ADD` instructions, while the added value or key/value pair " +"is popped off, the container object remains on the stack so that it is " +"available for further iterations of the loop." msgstr "" msgid "Returns with ``STACK[-1]`` to the caller of the function." @@ -802,8 +801,8 @@ msgstr "" msgid "" "Re-raises the exception currently on top of the stack. If oparg is non-zero, " -"pops an additional value from the stack which is used to set :attr:`~frame." -"f_lasti` of the current frame." +"pops an additional value from the stack which is used to " +"set :attr:`~frame.f_lasti` of the current frame." msgstr "" msgid "" @@ -855,9 +854,9 @@ 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." +"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 "" @@ -882,8 +881,9 @@ msgstr "" msgid "" "``STACK[-1]`` is a tuple of mapping keys, and ``STACK[-2]`` is the match " -"subject. If ``STACK[-2]`` contains all of the keys in ``STACK[-1]``, push a :" -"class:`tuple` containing the corresponding values. Otherwise, push ``None``." +"subject. If ``STACK[-2]`` contains all of the keys in ``STACK[-1]``, push " +"a :class:`tuple` containing the corresponding values. Otherwise, push " +"``None``." msgstr "" msgid "" @@ -894,13 +894,14 @@ msgstr "" msgid "" "Implements ``name = STACK.pop()``. *namei* is the index of *name* in the " "attribute :attr:`~codeobject.co_names` of the :ref:`code object `. The compiler tries to use :opcode:`STORE_FAST` or :opcode:" -"`STORE_GLOBAL` if possible." +"objects>`. The compiler tries to use :opcode:`STORE_FAST` " +"or :opcode:`STORE_GLOBAL` if possible." msgstr "" msgid "" -"Implements ``del name``, where *namei* is the index into :attr:`~codeobject." -"co_names` attribute of the :ref:`code object `." +"Implements ``del name``, where *namei* is the index " +"into :attr:`~codeobject.co_names` attribute of the :ref:`code object `." msgstr "" msgid "" @@ -945,8 +946,8 @@ msgid "" msgstr "" msgid "" -"where *namei* is the index of name in :attr:`~codeobject.co_names` of the :" -"ref:`code object `." +"where *namei* is the index of name in :attr:`~codeobject.co_names` of " +"the :ref:`code object `." msgstr "" msgid "" @@ -955,8 +956,8 @@ msgid "" msgstr "" msgid "" -"where *namei* is the index of name into :attr:`~codeobject.co_names` of the :" -"ref:`code object `." +"where *namei* is the index of name into :attr:`~codeobject.co_names` of " +"the :ref:`code object `." msgstr "" msgid "Works as :opcode:`STORE_NAME`, but stores the name as a global." @@ -975,8 +976,8 @@ msgstr "" msgid "" "Pushes a reference to the locals dictionary onto the stack. This is used to " -"prepare namespace dictionaries for :opcode:`LOAD_FROM_DICT_OR_DEREF` and :" -"opcode:`LOAD_FROM_DICT_OR_GLOBALS`." +"prepare namespace dictionaries for :opcode:`LOAD_FROM_DICT_OR_DEREF` " +"and :opcode:`LOAD_FROM_DICT_OR_GLOBALS`." msgstr "" msgid "" @@ -1102,9 +1103,9 @@ msgid "" msgstr "" msgid "" -"The low bit of ``namei`` signals to attempt a method load, as with :opcode:" -"`LOAD_ATTR`, which results in pushing ``NULL`` and the loaded method. When " -"it is unset a single value is pushed to the stack." +"The low bit of ``namei`` signals to attempt a method load, as " +"with :opcode:`LOAD_ATTR`, which results in pushing ``NULL`` and the loaded " +"method. When it is unset a single value is pushed to the stack." msgstr "" msgid "" @@ -1119,8 +1120,8 @@ msgid "" msgstr "" msgid "" -"The fifth-lowest bit of the oparg now indicates a forced conversion to :" -"class:`bool`." +"The fifth-lowest bit of the oparg now indicates a forced conversion " +"to :class:`bool`." msgstr "" msgid "Performs ``is`` comparison, or ``is not`` if ``invert`` is 1." @@ -1131,10 +1132,10 @@ msgstr "" msgid "" "Imports the module ``co_names[namei]``. ``STACK[-1]`` and ``STACK[-2]`` are " -"popped and provide the *fromlist* and *level* arguments of :func:" -"`__import__`. The module object is pushed onto the stack. The current " -"namespace is not affected: for a proper import statement, a subsequent :" -"opcode:`STORE_FAST` instruction modifies the namespace." +"popped and provide the *fromlist* and *level* arguments " +"of :func:`__import__`. The module object is pushed onto the stack. The " +"current namespace is not affected: for a proper import statement, a " +"subsequent :opcode:`STORE_FAST` instruction modifies the namespace." msgstr "" msgid "" @@ -1259,8 +1260,8 @@ msgstr "" msgid "" "Pops a mapping off the stack and looks up the name associated with slot " "``i`` of the \"fast locals\" storage in this mapping. If the name is not " -"found there, loads it from the cell contained in slot ``i``, similar to :" -"opcode:`LOAD_DEREF`. This is used for loading :term:`closure variables " +"found there, loads it from the cell contained in slot ``i``, similar " +"to :opcode:`LOAD_DEREF`. This is used for loading :term:`closure variables " "` in class bodies (which previously used :opcode:`!" "LOAD_CLASSDEREF`) and in :ref:`annotation scopes ` within " "class bodies." @@ -1720,8 +1721,9 @@ msgstr "" msgid "" "This variant is used in :keyword:`with` and :keyword:`async with` " -"constructs, which push the return value of the context manager's :meth:" -"`~object.__enter__` or :meth:`~object.__aenter__` to the stack." +"constructs, which push the return value of the context " +"manager's :meth:`~object.__enter__` or :meth:`~object.__aenter__` to the " +"stack." msgstr "" msgid "" diff --git a/library/doctest.po b/library/doctest.po index 13a25818d2..b75699b4f7 100644 --- a/library/doctest.po +++ b/library/doctest.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Wiktor Matuszewski , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,7 +27,7 @@ msgid ":mod:`!doctest` --- Test interactive Python examples" msgstr "" msgid "**Source code:** :source:`Lib/doctest.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/doctest.py`" msgid "" "The :mod:`doctest` module searches for pieces of text that look like " @@ -167,11 +165,11 @@ msgid "" 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`." +"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" @@ -222,9 +220,9 @@ msgstr "" msgid "" "You can force verbose mode by passing ``verbose=True`` to :func:`testmod`, " -"or prohibit it by passing ``verbose=False``. In either of those cases, " -"``sys.argv`` is not examined by :func:`testmod` (so passing ``-v`` or not " -"has no effect)." +"or prohibit it by passing ``verbose=False``. In either of those " +"cases, :data:`sys.argv` is not examined by :func:`testmod` (so passing ``-" +"v`` or not has no effect)." msgstr "" msgid "" @@ -293,8 +291,8 @@ msgstr "" msgid "" "As with :func:`testmod`, :func:`testfile` won't display anything unless an " "example fails. If an example does fail, then the failing example(s) and the " -"cause(s) of the failure(s) are printed to stdout, using the same format as :" -"func:`testmod`." +"cause(s) of the failure(s) are printed to stdout, using the same format " +"as :func:`!testmod`." msgstr "" msgid "" @@ -338,9 +336,9 @@ msgid "python -m doctest -v example.py" msgstr "" msgid "" -"This will import :file:`example.py` as a standalone module and run :func:" -"`testmod` on it. Note that this may not work correctly if the file is part " -"of a package and imports other submodules from that package." +"This will import :file:`example.py` as a standalone module and " +"run :func:`testmod` on it. Note that this may not work correctly if the file " +"is part of a package and imports other submodules from that package." msgstr "" msgid "" @@ -352,8 +350,8 @@ msgid "python -m doctest -v example.txt" msgstr "" msgid "" -"Option flags control various aspects of doctest's behavior, see section :ref:" -"`doctest-options`." +"Option flags control various aspects of doctest's behavior, see " +"section :ref:`doctest-options`." msgstr "" msgid "This is shorthand for ``-o FAIL_FAST``." @@ -385,10 +383,10 @@ msgid "" "the docstring. Doctest looks for a module-level variable called ``__test__`` " "and uses it to locate other tests. If ``M.__test__`` exists, it must be a " "dict, and each entry maps a (string) name to a function object, class " -"object, or string. Function and class object docstrings found from ``M." -"__test__`` are searched, and strings are treated as if they were " -"docstrings. In output, a key ``K`` in ``M.__test__`` appears with name ``M." -"__test__.K``." +"object, or string. Function and class object docstrings found from " +"``M.__test__`` are searched, and strings are treated as if they were " +"docstrings. In output, a key ``K`` in ``M.__test__`` appears with name " +"``M.__test__.K``." msgstr "" msgid "For example, place this block of code at the top of :file:`example.py`:" @@ -409,8 +407,8 @@ msgstr "" msgid "" "The value of ``example.__test__[\"numbers\"]`` will be treated as a " "docstring and all the tests inside it will be run. It is important to note " -"that the value can be mapped to a function, class object, or module; if so, :" -"mod:`!doctest` searches them recursively for docstrings, which are then " +"that the value can be mapped to a function, class object, or module; if " +"so, :mod:`!doctest` searches them recursively for docstrings, which are then " "scanned for tests." msgstr "" @@ -419,6 +417,16 @@ msgid "" "their contained methods and nested classes." msgstr "" +msgid "" +"``doctest`` can only automatically discover classes and functions that are " +"defined at the module level or inside other classes." +msgstr "" + +msgid "" +"Since nested classes and functions only exist when an outer function is " +"called, they cannot be discovered. Define them outside to make them visible." +msgstr "" + msgid "How are Docstring Examples Recognized?" msgstr "" @@ -466,14 +474,14 @@ msgid "" "All hard tab characters are expanded to spaces, using 8-column tab stops. " "Tabs in output generated by the tested code are not modified. Because any " "hard tabs in the sample output *are* expanded, this means that if the code " -"output includes hard tabs, the only way the doctest can pass is if the :" -"const:`NORMALIZE_WHITESPACE` option or :ref:`directive ` " -"is in effect. Alternatively, the test can be rewritten to capture the output " -"and compare it to an expected value as part of the test. This handling of " -"tabs in the source was arrived at through trial and error, and has proven to " -"be the least error prone way of handling them. It is possible to use a " -"different algorithm for handling tabs by writing a custom :class:" -"`DocTestParser` class." +"output includes hard tabs, the only way the doctest can pass is if " +"the :const:`NORMALIZE_WHITESPACE` option or :ref:`directive ` is in effect. Alternatively, the test can be rewritten to " +"capture the output and compare it to an expected value as part of the test. " +"This handling of tabs in the source was arrived at through trial and error, " +"and has proven to be the least error prone way of handling them. It is " +"possible to use a different algorithm for handling tabs by writing a " +"custom :class:`DocTestParser` class." msgstr "" msgid "" @@ -569,8 +577,8 @@ msgid "" msgstr "" msgid "" -"That doctest succeeds if :exc:`ValueError` is raised, with the ``list." -"remove(x): x not in list`` detail as shown." +"That doctest succeeds if :exc:`ValueError` is raised, with the " +"``list.remove(x): x not in list`` detail as shown." msgstr "" msgid "" @@ -628,10 +636,10 @@ msgstr "" msgid "" "Note that tracebacks are treated very specially. In particular, in the " -"rewritten example, the use of ``...`` is independent of doctest's :const:" -"`ELLIPSIS` option. The ellipsis in that example could be left out, or could " -"just as well be three (or three hundred) commas or digits, or an indented " -"transcript of a Monty Python skit." +"rewritten example, the use of ``...`` is independent of " +"doctest's :const:`ELLIPSIS` option. The ellipsis in that example could be " +"left out, or could just as well be three (or three hundred) commas or " +"digits, or an indented transcript of a Monty Python skit." msgstr "" msgid "Some details you should read once, but won't need to remember:" @@ -661,10 +669,10 @@ msgid "" msgstr "" msgid "" -"The interactive shell omits the traceback header line for some :exc:" -"`SyntaxError`\\ s. But doctest uses the traceback header line to " +"The interactive shell omits the traceback header line for " +"some :exc:`SyntaxError`\\ s. But doctest uses the traceback header line to " "distinguish exceptions from non-exceptions. So in the rare case where you " -"need to test a :exc:`SyntaxError` that omits the traceback header, you will " +"need to test a :exc:`!SyntaxError` that omits the traceback header, you will " "need to manually add the traceback header line to your test example." msgstr "" @@ -701,11 +709,11 @@ msgstr "" msgid "" "A number of option flags control various aspects of doctest's behavior. " -"Symbolic names for the flags are supplied as module constants, which can be :" -"ref:`bitwise ORed ` together and passed to various functions. The " -"names can also be used in :ref:`doctest directives `, " -"and may be passed to the doctest command line interface via the ``-o`` " -"option." +"Symbolic names for the flags are supplied as module constants, which can " +"be :ref:`bitwise ORed ` together and passed to various functions. " +"The names can also be used in :ref:`doctest directives `, and may be passed to the doctest command line interface via " +"the ``-o`` option." msgstr "" msgid "" @@ -716,20 +724,21 @@ msgstr "" msgid "" "By default, if an expected output block contains just ``1``, an actual " "output block containing just ``1`` or just ``True`` is considered to be a " -"match, and similarly for ``0`` versus ``False``. When :const:" -"`DONT_ACCEPT_TRUE_FOR_1` is specified, neither substitution is allowed. The " -"default behavior caters to that Python changed the return type of many " -"functions from integer to boolean; doctests expecting \"little integer\" " -"output still work in these cases. This option will probably go away, but " -"not for several years." +"match, and similarly for ``0`` versus ``False``. " +"When :const:`DONT_ACCEPT_TRUE_FOR_1` is specified, neither substitution is " +"allowed. The default behavior caters to that Python changed the return type " +"of many functions from integer to boolean; doctests expecting \"little " +"integer\" output still work in these cases. This option will probably go " +"away, but not for several years." msgstr "" msgid "" "By default, if an expected output block contains a line containing only the " "string ````, then that line will match a blank line in the actual " "output. Because a genuinely blank line delimits the expected output, this " -"is the only way to communicate that a blank line is expected. When :const:" -"`DONT_ACCEPT_BLANKLINE` is specified, this substitution is not allowed." +"is the only way to communicate that a blank line is expected. " +"When :const:`DONT_ACCEPT_BLANKLINE` is specified, this substitution is not " +"allowed." msgstr "" msgid "" @@ -757,11 +766,11 @@ msgstr "" msgid "" "For example, an example expecting ``ValueError: 42`` will pass if the actual " -"exception raised is ``ValueError: 3*14``, but will fail if, say, a :exc:" -"`TypeError` is raised instead. It will also ignore any fully qualified name " -"included before the exception class, which can vary between implementations " -"and versions of Python and the code/libraries in use. Hence, all three of " -"these variations will work with the flag specified:" +"exception raised is ``ValueError: 3*14``, but will fail if, say, " +"a :exc:`TypeError` is raised instead. It will also ignore any fully " +"qualified name included before the exception class, which can vary between " +"implementations and versions of Python and the code/libraries in use. Hence, " +"all three of these variations will work with the flag specified:" msgstr "" msgid "" @@ -853,10 +862,10 @@ msgstr "" msgid "" "Create a new option flag with a given name, and return the new flag's " -"integer value. :func:`register_optionflag` can be used when subclassing :" -"class:`OutputChecker` or :class:`DocTestRunner` to create new options that " -"are supported by your subclasses. :func:`register_optionflag` should always " -"be called using the following idiom::" +"integer value. :func:`register_optionflag` can be used when " +"subclassing :class:`OutputChecker` or :class:`DocTestRunner` to create new " +"options that are supported by your subclasses. :func:`register_optionflag` " +"should always be called using the following idiom::" msgstr "" msgid "MY_FLAG = register_optionflag('MY_FLAG')" @@ -1017,17 +1026,17 @@ 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. ::" +"platforms, because Python defers to the platform C library for some floating-" +"point calculations, and C libraries vary widely in quality here. ::" msgstr "" msgid "" -">>> 1./7 # risky\n" -"0.14285714285714285\n" -">>> print(1./7) # safer\n" -"0.142857142857\n" -">>> print(round(1./7, 6)) # much safer\n" -"0.142857" +">>> 1000**0.1 # risky\n" +"1.9952623149688797\n" +">>> round(1000**0.1, 9) # safer\n" +"1.995262315\n" +">>> print(f'{1000**0.1:.4f}') # much safer\n" +"1.9953" msgstr "" msgid "" @@ -1120,7 +1129,7 @@ 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``." +"v'`` is in :data:`sys.argv`." msgstr "" msgid "" @@ -1130,8 +1139,9 @@ msgid "" msgstr "" msgid "" -"Optional argument *optionflags* (default value 0) takes the :ref:`bitwise OR " -"` of option flags. See section :ref:`doctest-options`." +"Optional argument *optionflags* (default value ``0``) takes " +"the :ref:`bitwise OR ` of option flags. See section :ref:`doctest-" +"options`." msgstr "" msgid "" @@ -1164,10 +1174,10 @@ msgid "" msgstr "" msgid "" -"Also test examples reachable from dict ``m.__test__``, if it exists. ``m." -"__test__`` maps names (strings) to functions, classes and strings; function " -"and class docstrings are searched for examples; strings are searched " -"directly, as if they were docstrings." +"Also test examples reachable from dict ``m.__test__``, if it exists. " +"``m.__test__`` maps names (strings) to functions, classes and strings; " +"function and class docstrings are searched for examples; strings are " +"searched directly, as if they were docstrings." msgstr "" msgid "" @@ -1185,11 +1195,11 @@ msgstr "" msgid "" "Optional argument *exclude_empty* defaults to false. If true, objects for " "which no doctests are found are excluded from consideration. The default is " -"a backward compatibility hack, so that code still using :meth:`doctest." -"master.summarize ` in conjunction with :func:" -"`testmod` continues to get output for objects with no tests. The " -"*exclude_empty* argument to the newer :class:`DocTestFinder` constructor " -"defaults to true." +"a backward compatibility hack, so that code still " +"using :meth:`doctest.master.summarize ` in " +"conjunction with :func:`testmod` continues to get output for objects with no " +"tests. The *exclude_empty* argument to the newer :class:`DocTestFinder` " +"constructor defaults to true." msgstr "" msgid "" @@ -1258,18 +1268,18 @@ msgid "" msgstr "" msgid "" -"Convert doctest tests from one or more text files to a :class:`unittest." -"TestSuite`." +"Convert doctest tests from one or more text files to " +"a :class:`unittest.TestSuite`." msgstr "" msgid "" "The returned :class:`unittest.TestSuite` is to be run by the unittest " "framework and runs the interactive examples in each file. If an example in " -"any file fails, then the synthesized unit test fails, and a :exc:" -"`failureException` exception is raised showing the name of the file " -"containing the test and a (sometimes approximate) line number. If all the " -"examples in a file are skipped, then the synthesized unit test is also " -"marked as skipped." +"any file fails, then the synthesized unit test fails, and " +"a :exc:`~unittest.TestCase.failureException` exception is raised showing the " +"name of the file containing the test and a (sometimes approximate) line " +"number. If all the examples in a file are skipped, then the synthesized " +"unit test is also marked as skipped." msgstr "" msgid "Pass one or more paths (as strings) to text files to be examined." @@ -1311,15 +1321,16 @@ 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." +"will be passed a :class:`DocTest` object. The *setUp* function can access " +"the test globals as the :attr:`~DocTest.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." +"function will be passed a :class:`DocTest` object. The *tearDown* function " +"can access the test globals as the :attr:`~DocTest.globs` attribute of the " +"test passed." msgstr "" msgid "" @@ -1330,9 +1341,10 @@ msgstr "" msgid "" "Optional argument *optionflags* specifies the default doctest options for " -"the tests, created by or-ing together individual option flags. See section :" -"ref:`doctest-options`. See function :func:`set_unittest_reportflags` below " -"for a better way to set reporting options." +"the tests, created by or-ing together individual option flags. See " +"section :ref:`doctest-options`. See " +"function :func:`set_unittest_reportflags` below for a better way to set " +"reporting options." msgstr "" msgid "" @@ -1345,11 +1357,12 @@ 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. If all the examples in a docstring are " -"skipped, then the synthesized unit test is also marked as skipped." +"framework and runs each doctest in the module. Each docstring is run as a " +"separate unit test. If any of the doctests fail, then the synthesized unit " +"test fails, and a :exc:`unittest.TestCase.failureException` exception is " +"raised showing the name of the file containing the test and a (sometimes " +"approximate) line number. If all the examples in a docstring are skipped, " +"then the" msgstr "" msgid "" @@ -1358,6 +1371,12 @@ msgid "" "module calling this function is used." 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 the module's :attr:`~module.__dict__`." +msgstr "" + msgid "" "Optional argument *extraglobs* specifies an extra set of global variables, " "which is merged into *globs*. By default, no extra globals are used." @@ -1370,7 +1389,8 @@ msgstr "" msgid "" "Optional arguments *setUp*, *tearDown*, and *optionflags* are the same as " -"for function :func:`DocFileSuite` above." +"for function :func:`DocFileSuite` above, but they are called for each " +"docstring." msgstr "" msgid "This function uses the same search technique as :func:`testmod`." @@ -1381,13 +1401,6 @@ msgid "" "*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 " @@ -1403,19 +1416,19 @@ msgid "" msgstr "" msgid "" -"So both ways of creating a :class:`unittest.TestSuite` run instances of :" -"class:`!DocTestCase`. This is important for a subtle reason: when you run :" -"mod:`doctest` functions yourself, you can control the :mod:`doctest` 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." +"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` " +"For this reason, :mod:`doctest` also supports a notion of :mod:`!doctest` " "reporting flags specific to :mod:`unittest` support, via this function:" msgstr "" @@ -1430,14 +1443,15 @@ msgstr "" msgid "" "This is a module-global setting, and affects all future doctests run by " "module :mod:`unittest`: the :meth:`!runTest` method of :class:`!" -"DocTestCase` looks at the option flags specified for the test case when the :" -"class:`!DocTestCase` instance was constructed. If no reporting flags were " -"specified (which is the typical and expected case), :mod:`!doctest`'s :mod:" -"`unittest` reporting flags are :ref:`bitwise ORed ` into the option " -"flags, and the option flags so augmented are passed to the :class:" -"`DocTestRunner` instance created to run the doctest. If any reporting flags " -"were specified when the :class:`!DocTestCase` instance was constructed, :mod:" -"`!doctest`'s :mod:`unittest` reporting flags are ignored." +"DocTestCase` looks at the option flags specified for the test case when " +"the :class:`!DocTestCase` instance was constructed. If no reporting flags " +"were specified (which is the typical and expected case), :mod:`!" +"doctest`'s :mod:`!unittest` reporting flags are :ref:`bitwise ORed " +"` into the option flags, and the option flags so augmented are " +"passed to the :class:`DocTestRunner` instance created to run the doctest. " +"If any reporting flags were specified when the :class:`!DocTestCase` " +"instance was constructed, :mod:`!doctest`'s :mod:`!unittest` reporting flags " +"are ignored." msgstr "" msgid "" @@ -1476,9 +1490,9 @@ msgid "" msgstr "" msgid "" -":class:`DocTestFinder`: Finds all docstrings in a given module, and uses a :" -"class:`DocTestParser` to create a :class:`DocTest` from every docstring that " -"contains interactive examples." +":class:`DocTestFinder`: Finds all docstrings in a given module, and uses " +"a :class:`DocTestParser` to create a :class:`DocTest` from every docstring " +"that contains interactive examples." msgstr "" msgid "" @@ -1534,8 +1548,8 @@ msgstr "" msgid "" "The namespace (aka globals) that the examples should be run in. This is a " "dictionary mapping names to values. Any changes to the namespace made by " -"the examples (such as binding new variables) will be reflected in :attr:" -"`globs` after the test is run." +"the examples (such as binding new variables) will be reflected " +"in :attr:`globs` after the test is run." msgstr "" msgid "" @@ -1545,7 +1559,7 @@ 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 " +"``None`` if the filename is unknown, or if the :class:`!DocTest` was not " "extracted from a file." msgstr "" @@ -1590,9 +1604,9 @@ msgstr "" msgid "" "The exception message generated by the example, if the example is expected " "to generate an exception; or ``None`` if it is not expected to generate an " -"exception. This exception message is compared against the return value of :" -"func:`traceback.format_exception_only`. :attr:`exc_msg` ends with a newline " -"unless it's ``None``. The constructor adds a newline if needed." +"exception. This exception message is compared against the return value " +"of :func:`traceback.format_exception_only`. :attr:`exc_msg` ends with a " +"newline unless it's ``None``. The constructor adds a newline if needed." msgstr "" msgid "" @@ -1640,8 +1654,9 @@ msgid "" msgstr "" msgid "" -"If the optional argument *exclude_empty* is false, then :meth:`DocTestFinder." -"find` will include tests for objects with empty docstrings." +"If the optional argument *exclude_empty* is false, " +"then :meth:`DocTestFinder.find` will include tests for objects with empty " +"docstrings." msgstr "" msgid ":class:`DocTestFinder` defines the following method:" @@ -1691,10 +1706,10 @@ 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 ``{}``." +"shallow copy of the globals dictionary is created for each :class:`!" +"DocTest`. If *globs* is not specified, then it defaults to the " +"module's :attr:`~module.__dict__`, if specified, or ``{}`` otherwise. If " +"*extraglobs* is not specified, then it defaults to ``{}``." msgstr "" msgid "DocTestParser objects" @@ -1709,14 +1724,14 @@ msgid ":class:`DocTestParser` defines the following methods:" msgstr "" msgid "" -"Extract all doctest examples from the given string, and collect them into a :" -"class:`DocTest` object." +"Extract all doctest examples from the given string, and collect them into " +"a :class:`DocTest` object." msgstr "" msgid "" -"*globs*, *name*, *filename*, and *lineno* are attributes for the new :class:" -"`DocTest` object. See the documentation for :class:`DocTest` for more " -"information." +"*globs*, *name*, *filename*, and *lineno* are attributes for the " +"new :class:`!DocTest` object. See the documentation for :class:`DocTest` " +"for more information." msgstr "" msgid "" @@ -1729,7 +1744,7 @@ 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 " +"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 "" @@ -1749,27 +1764,28 @@ msgid "DocTestRunner objects" msgstr "" msgid "" -"A processing class used to execute and verify the interactive examples in a :" -"class:`DocTest`." +"A processing class used to execute and verify the interactive examples in " +"a :class:`DocTest`." msgstr "" msgid "" -"The comparison between expected outputs and actual outputs is done by an :" -"class:`OutputChecker`. This comparison may be customized with a number of " -"option flags; see section :ref:`doctest-options` for more information. If " -"the option flags are insufficient, then the comparison may also be " -"customized by passing a subclass of :class:`OutputChecker` to the " +"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:`run`; this function will be called " -"with strings that should be displayed. It defaults to ``sys.stdout." -"write``. If capturing the output is not sufficient, then the display output " -"can be also customized by subclassing DocTestRunner, and overriding the " -"methods :meth:`report_start`, :meth:`report_success`, :meth:" -"`report_unexpected_exception`, and :meth:`report_failure`." +"with strings that should be displayed. It defaults to " +"``sys.stdout.write``. If capturing the output is not sufficient, then the " +"display output can be also customized by subclassing DocTestRunner, and " +"overriding the " +"methods :meth:`report_start`, :meth:`report_success`, :meth:`report_unexpected_exception`, " +"and :meth:`report_failure`." msgstr "" msgid "" @@ -1779,11 +1795,12 @@ msgid "" msgstr "" msgid "" -"The optional keyword argument *verbose* controls the :class:" -"`DocTestRunner`'s verbosity. If *verbose* is ``True``, then information is " -"printed about each example, as it is run. If *verbose* is ``False``, then " -"only failures are printed. If *verbose* is unspecified, or ``None``, then " -"verbose output is used iff the command-line switch ``-v`` is used." +"The optional keyword argument *verbose* controls " +"the :class:`DocTestRunner`'s verbosity. If *verbose* is ``True``, then " +"information is printed about each example, as it is run. If *verbose* is " +"``False``, then only failures are printed. If *verbose* is unspecified, or " +"``None``, then verbose output is used iff the command-line switch ``-v`` is " +"used." msgstr "" msgid "" @@ -1794,9 +1811,10 @@ msgstr "" msgid "" "The test runner accumulates statistics. The aggregated number of attempted, " -"failed and skipped examples is also available via the :attr:`tries`, :attr:" -"`failures` and :attr:`skips` attributes. The :meth:`run` and :meth:" -"`summarize` methods return a :class:`TestResults` instance." +"failed and skipped examples is also available via " +"the :attr:`tries`, :attr:`failures` and :attr:`skips` attributes. " +"The :meth:`run` and :meth:`summarize` methods return a :class:`TestResults` " +"instance." msgstr "" msgid ":class:`DocTestRunner` defines the following methods:" @@ -1810,8 +1828,8 @@ msgstr "" msgid "" "*example* is the example about to be processed. *test* is the test " -"*containing example*. *out* is the output function that was passed to :meth:" -"`DocTestRunner.run`." +"containing *example*. *out* is the output function that was passed " +"to :meth:`DocTestRunner.run`." msgstr "" msgid "" @@ -1840,9 +1858,9 @@ msgstr "" msgid "" "*example* is the example about to be processed. *exc_info* is a tuple " -"containing information about the unexpected exception (as returned by :func:" -"`sys.exc_info`). *test* is the test containing *example*. *out* is the " -"output function that was passed to :meth:`DocTestRunner.run`." +"containing information about the unexpected exception (as returned " +"by :func:`sys.exc_info`). *test* is the test containing *example*. *out* is " +"the output function that was passed to :meth:`DocTestRunner.run`." msgstr "" msgid "" @@ -1866,8 +1884,8 @@ msgstr "" msgid "" "The output of each example is checked using the :class:`DocTestRunner`'s " -"output checker, and the results are formatted by the :meth:`!DocTestRunner." -"report_\\*` methods." +"output checker, and the results are formatted by the :meth:`!" +"DocTestRunner.report_\\*` methods." msgstr "" msgid "" @@ -1898,10 +1916,10 @@ msgstr "" msgid "" "A class used to check the whether the actual output from a doctest example " -"matches the expected output. :class:`OutputChecker` defines two methods: :" -"meth:`check_output`, which compares a given pair of outputs, and returns " -"``True`` if they match; and :meth:`output_difference`, which returns a " -"string describing the differences between two outputs." +"matches the expected output. :class:`OutputChecker` defines two " +"methods: :meth:`check_output`, which compares a given pair of outputs, and " +"returns ``True`` if they match; and :meth:`output_difference`, which returns " +"a string describing the differences between two outputs." msgstr "" msgid ":class:`OutputChecker` defines the following methods:" @@ -1911,8 +1929,8 @@ msgid "" "Return ``True`` iff the actual output from an example (*got*) matches the " "expected output (*want*). These strings are always considered to match if " "they are identical; but depending on what option flags the test runner is " -"using, several non-exact match types are also possible. See section :ref:" -"`doctest-options` for more information about option flags." +"using, several non-exact match types are also possible. See " +"section :ref:`doctest-options` for more information about option flags." msgstr "" msgid "" @@ -1940,15 +1958,15 @@ msgid "" msgstr "" msgid "" -"The :mod:`unittest` cases generated by :func:`DocTestSuite` support the :" -"meth:`debug` method defined by :class:`unittest.TestCase`." +"The :mod:`unittest` cases generated by :func:`DocTestSuite` support " +"the :meth:`debug` method defined by :class:`unittest.TestCase`." msgstr "" msgid "" "You can add a call to :func:`pdb.set_trace` in a doctest example, and you'll " "drop into the Python debugger when that line is executed. Then you can " -"inspect current values of variables, and so on. For example, suppose :file:" -"`a.py` contains just this module docstring::" +"inspect current values of variables, and so on. For example, " +"suppose :file:`a.py` contains just this module docstring::" msgstr "" msgid "" @@ -2070,10 +2088,10 @@ msgid "Debug the doctests for an object." msgstr "" msgid "" -"The *module* and *name* arguments are the same as for function :func:" -"`testsource` above. The synthesized Python script for the named object's " -"docstring is written to a temporary file, and then that file is run under " -"the control of the Python debugger, :mod:`pdb`." +"The *module* and *name* arguments are the same as for " +"function :func:`testsource` above. The synthesized Python script for the " +"named object's docstring is written to a temporary file, and then that file " +"is run under the control of the Python debugger, :mod:`pdb`." msgstr "" msgid "" @@ -2085,8 +2103,8 @@ msgid "" "Optional argument *pm* controls whether post-mortem debugging is used. If " "*pm* has a true value, the script file is run directly, and the debugger " "gets involved only if the script terminates via raising an unhandled " -"exception. If it does, then post-mortem debugging is invoked, via :func:" -"`pdb.post_mortem`, passing the traceback object from the unhandled " +"exception. If it does, then post-mortem debugging is invoked, " +"via :func:`pdb.post_mortem`, passing the traceback object from the unhandled " "exception. If *pm* is not specified, or is false, the script is run under " "the debugger from the start, via passing an appropriate :func:`exec` call " "to :func:`pdb.run`." @@ -2120,11 +2138,11 @@ msgstr "" msgid "" "A subclass of :class:`DocTestRunner` that raises an exception as soon as a " -"failure is encountered. If an unexpected exception occurs, an :exc:" -"`UnexpectedException` exception is raised, containing the test, the example, " -"and the original exception. If the output doesn't match, then a :exc:" -"`DocTestFailure` exception is raised, containing the test, the example, and " -"the actual output." +"failure is encountered. If an unexpected exception occurs, " +"an :exc:`UnexpectedException` exception is raised, containing the test, the " +"example, and the original exception. If the output doesn't match, then " +"a :exc:`DocTestFailure` exception is raised, containing the test, the " +"example, and the actual output." msgstr "" msgid "" @@ -2244,8 +2262,8 @@ msgid "" msgstr "" msgid "" -"Define a ``__test__`` dictionary mapping from regression test topics to " -"docstrings containing test cases." +"Define a :attr:`~module.__test__` dictionary mapping from regression test " +"topics to docstrings containing test cases." msgstr "" msgid "" diff --git a/library/email.charset.po b/library/email.charset.po index 86388cefd7..c3b588f54c 100644 --- a/library/email.charset.po +++ b/library/email.charset.po @@ -43,8 +43,8 @@ msgid "" "This module provides a class :class:`Charset` for representing character " "sets and character set conversions in email messages, as well as a character " "set registry and several convenience methods for manipulating this registry. " -"Instances of :class:`Charset` are used in several other modules within the :" -"mod:`email` package." +"Instances of :class:`Charset` are used in several other modules within " +"the :mod:`email` package." msgstr "" msgid "Import this class from the :mod:`email.charset` module." @@ -97,8 +97,8 @@ msgstr "" msgid "" "Same as *header_encoding*, but describes the encoding for the mail message's " -"body, which indeed may be different than the header encoding. ``Charset." -"SHORTEST`` is not allowed for *body_encoding*." +"body, which indeed may be different than the header encoding. " +"``Charset.SHORTEST`` is not allowed for *body_encoding*." msgstr "" msgid "" @@ -251,6 +251,6 @@ msgstr "" msgid "" "*charset* is the canonical name of a character set. *codecname* is the name " -"of a Python codec, as appropriate for the second argument to the :class:" -"`str`'s :meth:`~str.encode` method." +"of a Python codec, as appropriate for the second argument to " +"the :class:`str`'s :meth:`~str.encode` method." msgstr "" diff --git a/library/email.compat32-message.po b/library/email.compat32-message.po index 69b730c0fd..b087e4bade 100644 --- a/library/email.compat32-message.po +++ b/library/email.compat32-message.po @@ -24,38 +24,38 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "" -":mod:`email.message.Message`: Representing an email message using the :data:" -"`~email.policy.compat32` API" +":mod:`email.message.Message`: Representing an email message using " +"the :data:`~email.policy.compat32` API" msgstr "" msgid "" -"The :class:`Message` class is very similar to the :class:`~email.message." -"EmailMessage` class, without the methods added by that class, and with the " -"default behavior of certain other methods being slightly different. We also " -"document here some methods that, while supported by the :class:`~email." -"message.EmailMessage` class, are not recommended unless you are dealing with " -"legacy code." +"The :class:`Message` class is very similar to " +"the :class:`~email.message.EmailMessage` class, without the methods added by " +"that class, and with the default behavior of certain other methods being " +"slightly different. We also document here some methods that, while " +"supported by the :class:`~email.message.EmailMessage` class, are not " +"recommended unless you are dealing with legacy code." msgstr "" msgid "The philosophy and structure of the two classes is otherwise the same." msgstr "" msgid "" -"This document describes the behavior under the default (for :class:" -"`Message`) policy :attr:`~email.policy.Compat32`. If you are going to use " -"another policy, you should be using the :class:`~email.message.EmailMessage` " -"class instead." +"This document describes the behavior under the default " +"(for :class:`Message`) policy :attr:`~email.policy.Compat32`. If you are " +"going to use another policy, you should be using " +"the :class:`~email.message.EmailMessage` class instead." msgstr "" msgid "" -"An email message consists of *headers* and a *payload*. Headers must be :" -"rfc:`5322` style names and values, where the field name and value are " +"An email message consists of *headers* and a *payload*. Headers must " +"be :rfc:`5322` style names and values, where the field name and value are " "separated by a colon. The colon is not part of either the field name or the " "field value. The payload may be a simple text message, or a binary object, " "or a structured sequence of sub-messages each with their own set of headers " "and their own payload. The latter type of payload is indicated by the " -"message having a MIME type such as :mimetype:`multipart/\\*` or :mimetype:" -"`message/rfc822`." +"message having a MIME type such as :mimetype:`multipart/\\*` " +"or :mimetype:`message/rfc822`." msgstr "" msgid "" @@ -76,8 +76,8 @@ msgid "" "matched case-insensitively. There may also be a single envelope header, " "also known as the *Unix-From* header or the ``From_`` header. The *payload* " "is either a string or bytes, in the case of simple message objects, or a " -"list of :class:`Message` objects, for MIME container documents (e.g. :" -"mimetype:`multipart/\\*` and :mimetype:`message/rfc822`)." +"list of :class:`Message` objects, for MIME container documents " +"(e.g. :mimetype:`multipart/\\*` and :mimetype:`message/rfc822`)." msgstr "" msgid "Here are the methods of the :class:`Message` class:" @@ -86,10 +86,10 @@ msgstr "" msgid "" "If *policy* is specified (it must be an instance of a :mod:`~email.policy` " "class) use the rules it specifies to update and serialize the representation " -"of the message. If *policy* is not set, use the :class:`compat32 ` policy, which maintains backward compatibility with the " -"Python 3.2 version of the email package. For more information see the :mod:" -"`~email.policy` documentation." +"of the message. If *policy* is not set, use the :class:`compat32 " +"` policy, which maintains backward compatibility with " +"the Python 3.2 version of the email package. For more information see " +"the :mod:`~email.policy` documentation." msgstr "" msgid "The *policy* keyword argument was added." @@ -117,16 +117,17 @@ msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it does not do the " "mangling of lines that begin with ``From`` that is required by the Unix mbox " -"format. For more flexibility, instantiate a :class:`~email.generator." -"Generator` instance and use its :meth:`~email.generator.Generator.flatten` " -"method directly. For example::" +"format. For more flexibility, instantiate " +"a :class:`~email.generator.Generator` instance and use " +"its :meth:`~email.generator.Generator.flatten` method directly. For " +"example::" msgstr "" msgid "" "If the message object contains binary data that is not encoded according to " "RFC standards, the non-compliant data will be replaced by unicode \"unknown " -"character\" code points. (See also :meth:`.as_bytes` and :class:`~email." -"generator.BytesGenerator`.)" +"character\" code points. (See also :meth:`.as_bytes` " +"and :class:`~email.generator.BytesGenerator`.)" msgstr "" msgid "the *policy* keyword argument was added." @@ -150,9 +151,10 @@ msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it does not do the " "mangling of lines that begin with ``From`` that is required by the Unix mbox " -"format. For more flexibility, instantiate a :class:`~email.generator." -"BytesGenerator` instance and use its :meth:`~email.generator.BytesGenerator." -"flatten` method directly. For example::" +"format. For more flexibility, instantiate " +"a :class:`~email.generator.BytesGenerator` instance and use " +"its :meth:`~email.generator.BytesGenerator.flatten` method directly. For " +"example::" msgstr "" msgid "" @@ -161,13 +163,14 @@ msgid "" msgstr "" msgid "" -"Return ``True`` if the message's payload is a list of sub-\\ :class:" -"`Message` objects, otherwise return ``False``. When :meth:`is_multipart` " -"returns ``False``, the payload should be a string object (which might be a " -"CTE encoded binary payload). (Note that :meth:`is_multipart` returning " -"``True`` does not necessarily mean that \"msg.get_content_maintype() == " -"'multipart'\" will return the ``True``. For example, ``is_multipart`` will " -"return ``True`` when the :class:`Message` is of type ``message/rfc822``.)" +"Return ``True`` if the message's payload is a list of sub-" +"\\ :class:`Message` objects, otherwise return ``False``. " +"When :meth:`is_multipart` returns ``False``, the payload should be a string " +"object (which might be a CTE encoded binary payload). (Note " +"that :meth:`is_multipart` returning ``True`` does not necessarily mean that " +"\"msg.get_content_maintype() == 'multipart'\" will return the ``True``. For " +"example, ``is_multipart`` will return ``True`` when the :class:`Message` is " +"of type ``message/rfc822``.)" msgstr "" msgid "" @@ -189,8 +192,9 @@ 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." +"class its functionality is replaced " +"by :meth:`~email.message.EmailMessage.set_content` and the related ``make`` " +"and ``add`` methods." msgstr "" msgid "" @@ -205,8 +209,8 @@ msgid "" "element of the payload, counting from zero, if :meth:`is_multipart` is " "``True``. An :exc:`IndexError` will be raised if *i* is less than 0 or " "greater than or equal to the number of items in the payload. If the payload " -"is a string (i.e. :meth:`is_multipart` is ``False``) and *i* is given, a :" -"exc:`TypeError` is raised." +"is a string (i.e. :meth:`is_multipart` is ``False``) and *i* is given, " +"a :exc:`TypeError` is raised." msgstr "" msgid "" @@ -228,16 +232,18 @@ msgid "" "When *decode* is ``False`` (the default) the body is returned as a string " "without decoding the :mailheader:`Content-Transfer-Encoding`. However, for " "a :mailheader:`Content-Transfer-Encoding` of 8bit, an attempt is made to " -"decode the original bytes using the ``charset`` specified by the :mailheader:" -"`Content-Type` header, using the ``replace`` error handler. If no " -"``charset`` is specified, or if the ``charset`` given is not recognized by " -"the email package, the body is decoded using the default ASCII charset." +"decode the original bytes using the ``charset`` specified by " +"the :mailheader:`Content-Type` header, using the ``replace`` error handler. " +"If no ``charset`` is specified, or if the ``charset`` given is not " +"recognized by the email package, the body is decoded using the default ASCII " +"charset." msgstr "" msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " -"class its functionality is replaced by :meth:`~email.message.EmailMessage." -"get_content` and :meth:`~email.message.EmailMessage.iter_parts`." +"class its functionality is replaced " +"by :meth:`~email.message.EmailMessage.get_content` " +"and :meth:`~email.message.EmailMessage.iter_parts`." msgstr "" msgid "" @@ -248,40 +254,40 @@ 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`." +"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 " +"Set the character set of the payload to *charset*, which can either be " +"a :class:`~email.charset.Charset` instance (see :mod:`email.charset`), a " +"string naming a character set, or ``None``. If it is a string, it will be " "converted to a :class:`~email.charset.Charset` instance. If *charset* is " -"``None``, the ``charset`` parameter will be removed from the :mailheader:" -"`Content-Type` header (the message will not be otherwise modified). " -"Anything else will generate a :exc:`TypeError`." +"``None``, the ``charset`` parameter will be removed from " +"the :mailheader:`Content-Type` header (the message will not be otherwise " +"modified). Anything else will generate a :exc:`TypeError`." msgstr "" msgid "" "If there is no existing :mailheader:`MIME-Version` header one will be " "added. If there is no existing :mailheader:`Content-Type` header, one will " -"be added with a value of :mimetype:`text/plain`. Whether the :mailheader:" -"`Content-Type` header already exists or not, its ``charset`` parameter will " -"be set to *charset.output_charset*. If *charset.input_charset* and " -"*charset.output_charset* differ, the payload will be re-encoded to the " -"*output_charset*. If there is no existing :mailheader:`Content-Transfer-" -"Encoding` header, then the payload will be transfer-encoded, if needed, " -"using the specified :class:`~email.charset.Charset`, and a header with the " -"appropriate value will be added. If a :mailheader:`Content-Transfer-" -"Encoding` header already exists, the payload is assumed to already be " -"correctly encoded using that :mailheader:`Content-Transfer-Encoding` and is " -"not modified." +"be added with a value of :mimetype:`text/plain`. Whether " +"the :mailheader:`Content-Type` header already exists or not, its ``charset`` " +"parameter will be set to *charset.output_charset*. If " +"*charset.input_charset* and *charset.output_charset* differ, the payload " +"will be re-encoded to the *output_charset*. If there is no " +"existing :mailheader:`Content-Transfer-Encoding` header, then the payload " +"will be transfer-encoded, if needed, using the " +"specified :class:`~email.charset.Charset`, and a header with the appropriate " +"value will be added. If a :mailheader:`Content-Transfer-Encoding` header " +"already exists, the payload is assumed to already be correctly encoded using " +"that :mailheader:`Content-Transfer-Encoding` and is not modified." msgstr "" msgid "" "This is a legacy method. On the :class:`~email.emailmessage.EmailMessage` " -"class its functionality is replaced by the *charset* parameter of the :meth:" -"`email.emailmessage.EmailMessage.set_content` method." +"class its functionality is replaced by the *charset* parameter of " +"the :meth:`email.emailmessage.EmailMessage.set_content` method." msgstr "" msgid "" @@ -300,10 +306,11 @@ msgid "" "differences between these methods and a normal mapping (i.e. dictionary) " "interface. For example, in a dictionary there are no duplicate keys, but " "here there may be duplicate message headers. Also, in dictionaries there is " -"no guaranteed order to the keys returned by :meth:`keys`, but in a :class:" -"`Message` object, headers are always returned in the order they appeared in " -"the original message, or were added to the message later. Any header " -"deleted and then re-added are always appended to the end of the header list." +"no guaranteed order to the keys returned by :meth:`keys`, but in " +"a :class:`Message` object, headers are always returned in the order they " +"appeared in the original message, or were added to the message later. Any " +"header deleted and then re-added are always appended to the end of the " +"header list." msgstr "" msgid "" @@ -334,8 +341,8 @@ msgstr "" msgid "" "Return the value of the named header field. *name* should not include the " -"colon field separator. If the header is missing, ``None`` is returned; a :" -"exc:`KeyError` is never raised." +"colon field separator. If the header is missing, ``None`` is returned; " +"a :exc:`KeyError` is never raised." msgstr "" msgid "" @@ -374,9 +381,9 @@ msgid "" 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``)." +"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:" @@ -403,11 +410,11 @@ msgid "" "key will be added. If the value contains non-ASCII characters, it can be " "specified as a three tuple in the format ``(CHARSET, LANGUAGE, VALUE)``, " "where ``CHARSET`` is a string naming the charset to be used to encode the " -"value, ``LANGUAGE`` can usually be set to ``None`` or the empty string (see :" -"rfc:`2231` for other possibilities), and ``VALUE`` is the string value " +"value, ``LANGUAGE`` can usually be set to ``None`` or the empty string " +"(see :rfc:`2231` for other possibilities), and ``VALUE`` is the string value " "containing non-ASCII code points. If a three tuple is not passed and the " -"value contains non-ASCII characters, it is automatically encoded in :rfc:" -"`2231` format using a ``CHARSET`` of ``utf-8`` and a ``LANGUAGE`` of " +"value contains non-ASCII characters, it is automatically encoded " +"in :rfc:`2231` format using a ``CHARSET`` of ``utf-8`` and a ``LANGUAGE`` of " "``None``." msgstr "" @@ -431,11 +438,11 @@ msgstr "" msgid "" "Return the message's content type. The returned string is coerced to lower " -"case of the form :mimetype:`maintype/subtype`. If there was no :mailheader:" -"`Content-Type` header in the message the default type as given by :meth:" -"`get_default_type` will be returned. Since according to :rfc:`2045`, " -"messages always have a default type, :meth:`get_content_type` will always " -"return a value." +"case of the form :mimetype:`maintype/subtype`. If there was " +"no :mailheader:`Content-Type` header in the message the default type as " +"given by :meth:`get_default_type` will be returned. Since according " +"to :rfc:`2045`, messages always have a default " +"type, :meth:`get_content_type` will always return a value." msgstr "" msgid "" @@ -458,8 +465,8 @@ msgstr "" msgid "" "Return the default content type. Most messages have a default content type " -"of :mimetype:`text/plain`, except for messages that are subparts of :" -"mimetype:`multipart/digest` containers. Such subparts have a default " +"of :mimetype:`text/plain`, except for messages that are subparts " +"of :mimetype:`multipart/digest` containers. Such subparts have a default " "content type of :mimetype:`message/rfc822`." msgstr "" @@ -474,14 +481,15 @@ msgid "" "elements of the returned list are 2-tuples of key/value pairs, as split on " "the ``'='`` sign. The left hand side of the ``'='`` is the key, while the " "right hand side is the value. If there is no ``'='`` sign in the parameter " -"the value is the empty string, otherwise the value is as described in :meth:" -"`get_param` and is unquoted if optional *unquote* is ``True`` (the default)." +"the value is the empty string, otherwise the value is as described " +"in :meth:`get_param` and is unquoted if optional *unquote* is ``True`` (the " +"default)." msgstr "" msgid "" -"Optional *failobj* is the object to return if there is no :mailheader:" -"`Content-Type` header. Optional *header* is the header to search instead " -"of :mailheader:`Content-Type`." +"Optional *failobj* is the object to return if there is " +"no :mailheader:`Content-Type` header. Optional *header* is the header to " +"search instead of :mailheader:`Content-Type`." msgstr "" msgid "" @@ -498,8 +506,8 @@ msgid "" msgstr "" msgid "" -"Optional *header* if given, specifies the message header to use instead of :" -"mailheader:`Content-Type`." +"Optional *header* if given, specifies the message header to use instead " +"of :mailheader:`Content-Type`." msgstr "" msgid "" @@ -512,11 +520,12 @@ msgid "" msgstr "" msgid "" -"If your application doesn't care whether the parameter was encoded as in :" -"rfc:`2231`, you can collapse the parameter value by calling :func:`email." -"utils.collapse_rfc2231_value`, passing in the return value from :meth:" -"`get_param`. This will return a suitably decoded Unicode string when the " -"value is a tuple, or the original string unquoted if it isn't. For example::" +"If your application doesn't care whether the parameter was encoded as " +"in :rfc:`2231`, you can collapse the parameter value by " +"calling :func:`email.utils.collapse_rfc2231_value`, passing in the return " +"value from :meth:`get_param`. This will return a suitably decoded Unicode " +"string when the value is a tuple, or the original string unquoted if it " +"isn't. For example::" msgstr "" msgid "" @@ -559,8 +568,8 @@ msgid "" "Remove the given parameter completely from the :mailheader:`Content-Type` " "header. The header will be re-written in place without the parameter or its " "value. All values will be quoted as necessary unless *requote* is ``False`` " -"(the default is ``True``). Optional *header* specifies an alternative to :" -"mailheader:`Content-Type`." +"(the default is ``True``). Optional *header* specifies an alternative " +"to :mailheader:`Content-Type`." msgstr "" msgid "" @@ -577,9 +586,9 @@ msgid "" msgstr "" msgid "" -"An alternative header can be specified in the *header* argument. When the :" -"mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` header " -"is also added." +"An alternative header can be specified in the *header* argument. When " +"the :mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` " +"header is also added." msgstr "" msgid "" @@ -611,12 +620,12 @@ msgid "" 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." +"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 "" @@ -626,8 +635,8 @@ msgid "" 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 " +"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 "" @@ -646,10 +655,10 @@ msgid "" msgstr "" msgid "" -"Return the lowercased value (without parameters) of the message's :" -"mailheader:`Content-Disposition` header if it has one, or ``None``. The " -"possible values for this method are *inline*, *attachment* or ``None`` if " -"the message follows :rfc:`2183`." +"Return the lowercased value (without parameters) of the " +"message's :mailheader:`Content-Disposition` header if it has one, or " +"``None``. The possible values for this method are *inline*, *attachment* or " +"``None`` if the message follows :rfc:`2183`." msgstr "" msgid "" @@ -696,11 +705,12 @@ msgid "" "The *preamble* attribute contains this leading extra-armor text for MIME " "documents. When the :class:`~email.parser.Parser` discovers some text after " "the headers but before the first boundary string, it assigns this text to " -"the message's *preamble* attribute. When the :class:`~email.generator." -"Generator` is writing out the plain text representation of a MIME message, " -"and it finds the message has a *preamble* attribute, it will write this text " -"in the area between the headers and the first boundary. See :mod:`email." -"parser` and :mod:`email.generator` for details." +"the message's *preamble* attribute. When " +"the :class:`~email.generator.Generator` is writing out the plain text " +"representation of a MIME message, and it finds the message has a *preamble* " +"attribute, it will write this text in the area between the headers and the " +"first boundary. See :mod:`email.parser` and :mod:`email.generator` for " +"details." msgstr "" msgid "" @@ -715,8 +725,9 @@ msgid "" msgstr "" msgid "" -"You do not need to set the epilogue to the empty string in order for the :" -"class:`~email.generator.Generator` to print a newline at the end of the file." +"You do not need to set the epilogue to the empty string in order for " +"the :class:`~email.generator.Generator` to print a newline at the end of the " +"file." msgstr "" msgid "" diff --git a/library/email.contentmanager.po b/library/email.contentmanager.po index 72d62b36e6..dc5b383188 100644 --- a/library/email.contentmanager.po +++ b/library/email.contentmanager.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,10 +27,10 @@ msgid ":mod:`!email.contentmanager`: Managing MIME Content" msgstr "" msgid "**Source code:** :source:`Lib/email/contentmanager.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/contentmanager.py`" msgid "[1]_" -msgstr "" +msgstr "[1]_" msgid "" "Base class for content managers. Provides the standard registry mechanisms " @@ -84,8 +84,8 @@ msgid "the type itself (``typ``)" msgstr "" msgid "" -"the type's fully qualified name (``typ.__module__ + '.' + typ." -"__qualname__``)." +"the type's fully qualified name (``typ.__module__ + '.' + " +"typ.__qualname__``)." msgstr "" msgid "the type's :attr:`qualname ` (``typ.__qualname__``)" @@ -122,31 +122,32 @@ msgid "Content Manager Instances" msgstr "" msgid "" -"Currently the email package provides only one concrete content manager, :" -"data:`raw_data_manager`, although more may be added in the future. :data:" -"`raw_data_manager` is the :attr:`~email.policy.EmailPolicy.content_manager` " -"provided by :attr:`~email.policy.EmailPolicy` and its derivatives." +"Currently the email package provides only one concrete content " +"manager, :data:`raw_data_manager`, although more may be added in the " +"future. :data:`raw_data_manager` is " +"the :attr:`~email.policy.EmailPolicy.content_manager` provided " +"by :attr:`~email.policy.EmailPolicy` and its derivatives." msgstr "" msgid "" "This content manager provides only a minimum interface beyond that provided " "by :class:`~email.message.Message` itself: it deals only with text, raw " -"byte strings, and :class:`~email.message.Message` objects. Nevertheless, it " +"bytes, and :class:`~email.message.Message` objects. Nevertheless, it " "provides significant advantages compared to the base API: ``get_content`` on " -"a text part will return a unicode string without the application needing to " -"manually decode it, ``set_content`` provides a rich set of options for " -"controlling the headers added to a part and controlling the content transfer " -"encoding, and it enables the use of the various ``add_`` methods, thereby " -"simplifying the creation of multipart messages." +"a text part will return a string without the application needing to manually " +"decode it, ``set_content`` provides a rich set of options for controlling " +"the headers added to a part and controlling the content transfer encoding, " +"and it enables the use of the various ``add_`` methods, thereby simplifying " +"the creation of multipart messages." msgstr "" msgid "" -"Return the payload of the part as either a string (for ``text`` parts), an :" -"class:`~email.message.EmailMessage` object (for ``message/rfc822`` parts), " -"or a ``bytes`` object (for all other non-multipart types). Raise a :exc:" -"`KeyError` if called on a ``multipart``. If the part is a ``text`` part and " -"*errors* is specified, use it as the error handler when decoding the payload " -"to unicode. The default error handler is ``replace``." +"Return the payload of the part as either a string (for ``text`` parts), " +"an :class:`~email.message.EmailMessage` object (for ``message/rfc822`` " +"parts), or a ``bytes`` object (for all other non-multipart types). Raise " +"a :exc:`KeyError` if called on a ``multipart``. If the part is a ``text`` " +"part and *errors* is specified, use it as the error handler when decoding " +"the payload to a string. The default error handler is ``replace``." msgstr "" msgid "Add headers and payload to *msg*:" @@ -162,8 +163,8 @@ msgid "" msgstr "" msgid "" -"For ``bytes``, use the specified *maintype* and *subtype*, or raise a :exc:" -"`TypeError` if they are not specified." +"For ``bytes``, use the specified *maintype* and *subtype*, or raise " +"a :exc:`TypeError` if they are not specified." msgstr "" msgid "" @@ -212,8 +213,8 @@ msgstr "" msgid "" "A *cte* of ``binary`` does not actually work correctly yet. The " -"``EmailMessage`` object as modified by ``set_content`` is correct, but :" -"class:`~email.generator.BytesGenerator` does not serialize it correctly." +"``EmailMessage`` object as modified by ``set_content`` is correct, " +"but :class:`~email.generator.BytesGenerator` does not serialize it correctly." msgstr "" msgid "" @@ -236,8 +237,8 @@ msgstr "" msgid "" "If *params* is specified, iterate its ``items`` method and use the resulting " -"``(key, value)`` pairs to set additional parameters on the :mailheader:" -"`Content-Type` header." +"``(key, value)`` pairs to set additional parameters on " +"the :mailheader:`Content-Type` header." msgstr "" msgid "" diff --git a/library/email.encoders.po b/library/email.encoders.po index 0411469ece..b9cb2463ed 100644 --- a/library/email.encoders.po +++ b/library/email.encoders.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:04+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,12 +27,12 @@ msgid ":mod:`!email.encoders`: Encoders" msgstr "" msgid "**Source code:** :source:`Lib/email/encoders.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/encoders.py`" msgid "" "This module is part of the legacy (``Compat32``) email API. In the new API " -"the functionality is provided by the *cte* parameter of the :meth:`~email." -"message.EmailMessage.set_content` method." +"the functionality is provided by the *cte* parameter of " +"the :meth:`~email.message.EmailMessage.set_content` method." msgstr "" msgid "" @@ -50,35 +50,35 @@ msgstr "" msgid "" "When creating :class:`~email.message.Message` objects from scratch, you " "often need to encode the payloads for transport through compliant mail " -"servers. This is especially true for :mimetype:`image/\\*` and :mimetype:" -"`text/\\*` type messages containing binary data." +"servers. This is especially true for :mimetype:`image/\\*` " +"and :mimetype:`text/\\*` type messages containing binary data." msgstr "" msgid "" -"The :mod:`email` package provides some convenient encoders in its :mod:" -"`~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. " -"They should also set the :mailheader:`Content-Transfer-Encoding` header as " -"appropriate." +"The :mod:`email` package provides some convenient encoders in " +"its :mod:`~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. They should also set " +"the :mailheader:`Content-Transfer-Encoding` header as appropriate." msgstr "" msgid "" "Note that these functions are not meaningful for a multipart message. They " -"must be applied to individual subparts instead, and will raise a :exc:" -"`TypeError` if passed a message whose type is multipart." +"must be applied to individual subparts instead, and will raise " +"a :exc:`TypeError` if passed a message whose type is multipart." msgstr "" msgid "Here are the encoding functions provided:" msgstr "" msgid "" -"Encodes the payload into quoted-printable form and sets the :mailheader:" -"`Content-Transfer-Encoding` header to ``quoted-printable`` [#]_. This is a " -"good encoding to use when most of your payload is normal printable data, but " -"contains a few unprintable characters." +"Encodes the payload into quoted-printable form and sets " +"the :mailheader:`Content-Transfer-Encoding` header to ``quoted-printable`` " +"[#]_. This is a good encoding to use when most of your payload is normal " +"printable data, but contains a few unprintable characters." msgstr "" msgid "" @@ -90,9 +90,9 @@ msgid "" msgstr "" msgid "" -"This doesn't actually modify the message's payload, but it does set the :" -"mailheader:`Content-Transfer-Encoding` header to either ``7bit`` or ``8bit`` " -"as appropriate, based on the payload data." +"This doesn't actually modify the message's payload, but it does set " +"the :mailheader:`Content-Transfer-Encoding` header to either ``7bit`` or " +"``8bit`` as appropriate, based on the payload data." msgstr "" msgid "" diff --git a/library/email.errors.po b/library/email.errors.po index c77f06eb8d..4ce749885a 100644 --- a/library/email.errors.po +++ b/library/email.errors.po @@ -41,20 +41,22 @@ msgid "" msgstr "" msgid "" -"This is the base class for exceptions raised by the :class:`~email.parser." -"Parser` class. It is derived from :exc:`MessageError`. This class is also " -"used internally by the parser used by :mod:`~email.headerregistry`." +"This is the base class for exceptions raised by " +"the :class:`~email.parser.Parser` class. It is derived " +"from :exc:`MessageError`. This class is also used internally by the parser " +"used by :mod:`~email.headerregistry`." msgstr "" msgid "" "Raised under some error conditions when parsing the :rfc:`5322` headers of a " -"message, this class is derived from :exc:`MessageParseError`. The :meth:" -"`~email.message.EmailMessage.set_boundary` method will raise this error if " -"the content type is unknown when the method is called. :class:`~email.header." -"Header` may raise this error for certain base64 decoding errors, and when an " -"attempt is made to create a header that appears to contain an embedded " -"header (that is, there is what is supposed to be a continuation line that " -"has no leading whitespace and looks like a header)." +"message, this class is derived from :exc:`MessageParseError`. " +"The :meth:`~email.message.EmailMessage.set_boundary` method will raise this " +"error if the content type is unknown when the method is " +"called. :class:`~email.header.Header` may raise this error for certain " +"base64 decoding errors, and when an attempt is made to create a header that " +"appears to contain an embedded header (that is, there is what is supposed to " +"be a continuation line that has no leading whitespace and looks like a " +"header)." msgstr "" msgid "Deprecated and no longer used." @@ -63,17 +65,17 @@ msgstr "" msgid "" "Raised when a payload is added to a :class:`~email.message.Message` object " "using :meth:`add_payload`, but the payload is already a scalar and the " -"message's :mailheader:`Content-Type` main type is not either :mimetype:" -"`multipart` or missing. :exc:`MultipartConversionError` multiply inherits " -"from :exc:`MessageError` and the built-in :exc:`TypeError`." +"message's :mailheader:`Content-Type` main type is not " +"either :mimetype:`multipart` or missing. :exc:`MultipartConversionError` " +"multiply inherits from :exc:`MessageError` and the built-in :exc:`TypeError`." msgstr "" msgid "" "Since :meth:`Message.add_payload` is deprecated, this exception is rarely " -"raised in practice. However the exception may also be raised if the :meth:" -"`~email.message.Message.attach` method is called on an instance of a class " -"derived from :class:`~email.mime.nonmultipart.MIMENonMultipart` (e.g. :class:" -"`~email.mime.image.MIMEImage`)." +"raised in practice. However the exception may also be raised if " +"the :meth:`~email.message.Message.attach` method is called on an instance of " +"a class derived from :class:`~email.mime.nonmultipart.MIMENonMultipart` " +"(e.g. :class:`~email.mime.image.MIMEImage`)." msgstr "" msgid "" @@ -95,8 +97,8 @@ msgid "" msgstr "" msgid "" -":class:`StartBoundaryNotFoundDefect` -- The start boundary claimed in the :" -"mailheader:`Content-Type` header was never found." +":class:`StartBoundaryNotFoundDefect` -- The start boundary claimed in " +"the :mailheader:`Content-Type` header was never found." msgstr "" msgid "" @@ -129,11 +131,11 @@ msgid "This defect has not been used for several Python versions." msgstr "" msgid "" -":class:`MultipartInvariantViolationDefect` -- A message claimed to be a :" -"mimetype:`multipart`, but no subparts were found. Note that when a message " -"has this defect, its :meth:`~email.message.Message.is_multipart` method may " -"return ``False`` even though its content type claims to be :mimetype:" -"`multipart`." +":class:`MultipartInvariantViolationDefect` -- A message claimed to be " +"a :mimetype:`multipart`, but no subparts were found. Note that when a " +"message has this defect, its :meth:`~email.message.Message.is_multipart` " +"method may return ``False`` even though its content type claims to " +"be :mimetype:`multipart`." msgstr "" msgid "" diff --git a/library/email.examples.po b/library/email.examples.po index e3bd8290a1..3587608ea9 100644 --- a/library/email.examples.po +++ b/library/email.examples.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,7 +33,7 @@ msgstr "" msgid "" "First, let's see how to create and send a simple text message (both the text " -"content and the addresses may contain unicode characters):" +"content and the addresses may contain Unicode characters):" msgstr "" msgid "" @@ -415,8 +415,8 @@ msgid "" " elif richest['content-type'].subtype == 'html':\n" " body = richest\n" " else:\n" -" print(\"Don't know how to display {}\".format(richest." -"get_content_type()))\n" +" print(\"Don't know how to display {}" +"\".format(richest.get_content_type()))\n" " sys.exit()\n" "elif richest['content-type'].content_type == 'multipart/related':\n" " body = richest.get_body(preferencelist=('html'))\n" @@ -432,8 +432,8 @@ msgid "" " # again strip the <> to go from email form of cid to html form.\n" " partfiles[part['content-id'][1:-1]] = f.name\n" "else:\n" -" print(\"Don't know how to display {}\".format(richest." -"get_content_type()))\n" +" print(\"Don't know how to display {}" +"\".format(richest.get_content_type()))\n" " sys.exit()\n" "with tempfile.NamedTemporaryFile(mode='w', delete=False) as f:\n" " f.write(magic_html_parser(body.get_content(), partfiles))\n" diff --git a/library/email.generator.po b/library/email.generator.po index 28ce9dd576..cca71fe612 100644 --- a/library/email.generator.po +++ b/library/email.generator.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,15 +27,15 @@ msgid ":mod:`!email.generator`: Generating MIME documents" msgstr "" msgid "**Source code:** :source:`Lib/email/generator.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/generator.py`" msgid "" "One of the most common tasks is to generate the flat (serialized) version of " "the email message represented by a message object structure. You will need " -"to do this if you want to send your message via :meth:`smtplib.SMTP." -"sendmail`, or print the message on the console. Taking a message object " -"structure and producing a serialized representation is the job of the " -"generator classes." +"to do this if you want to send your message " +"via :meth:`smtplib.SMTP.sendmail`, or print the message on the console. " +"Taking a message object structure and producing a serialized representation " +"is the job of the generator classes." msgstr "" msgid "" @@ -45,14 +44,14 @@ msgid "" "yourself. However the bundled generator knows how to generate most email in " "a standards-compliant way, should handle MIME and non-MIME email messages " "just fine, and is designed so that the bytes-oriented parsing and generation " -"operations are inverses, assuming the same non-transforming :mod:`~email." -"policy` is used for both. That is, parsing the serialized byte stream via " -"the :class:`~email.parser.BytesParser` class and then regenerating the " -"serialized byte stream using :class:`BytesGenerator` should produce output " -"identical to the input [#]_. (On the other hand, using the generator on an :" -"class:`~email.message.EmailMessage` constructed by program may result in " -"changes to the :class:`~email.message.EmailMessage` object as defaults are " -"filled in.)" +"operations are inverses, assuming the same non-" +"transforming :mod:`~email.policy` is used for both. That is, parsing the " +"serialized byte stream via the :class:`~email.parser.BytesParser` class and " +"then regenerating the serialized byte stream using :class:`BytesGenerator` " +"should produce output identical to the input [#]_. (On the other hand, " +"using the generator on an :class:`~email.message.EmailMessage` constructed " +"by program may result in changes to the :class:`~email.message.EmailMessage` " +"object as defaults are filled in.)" msgstr "" msgid "" @@ -65,9 +64,9 @@ msgid "" msgstr "" msgid "" -"To accommodate reproducible processing of SMIME-signed messages :class:" -"`Generator` disables header folding for message parts of type ``multipart/" -"signed`` and all subparts." +"To accommodate reproducible processing of SMIME-signed " +"messages :class:`Generator` disables header folding for message parts of " +"type ``multipart/signed`` and all subparts." msgstr "" msgid "" @@ -82,11 +81,11 @@ msgid "" "any line in the body that starts with the exact string ``\"From \"``, that " "is ``From`` followed by a space at the beginning of a line. *mangle_from_* " "defaults to the value of the :attr:`~email.policy.Policy.mangle_from_` " -"setting of the *policy* (which is ``True`` for the :data:`~email.policy." -"compat32` policy and ``False`` for all others). *mangle_from_* is intended " -"for use when messages are stored in Unix mbox format (see :mod:`mailbox` and " -"`WHY THE CONTENT-LENGTH FORMAT IS BAD `_)." +"setting of the *policy* (which is ``True`` for " +"the :data:`~email.policy.compat32` policy and ``False`` for all others). " +"*mangle_from_* is intended for use when messages are stored in Unix mbox " +"format (see :mod:`mailbox` and `WHY THE CONTENT-LENGTH FORMAT IS BAD " +"`_)." msgstr "" msgid "" @@ -98,10 +97,10 @@ msgstr "" msgid "" "If *policy* is specified, use that policy to control message generation. If " -"*policy* is ``None`` (the default), use the policy associated with the :" -"class:`~email.message.Message` or :class:`~email.message.EmailMessage` " -"object passed to ``flatten`` to control the message generation. See :mod:" -"`email.policy` for details on what *policy* controls." +"*policy* is ``None`` (the default), use the policy associated with " +"the :class:`~email.message.Message` or :class:`~email.message.EmailMessage` " +"object passed to ``flatten`` to control the message generation. " +"See :mod:`email.policy` for details on what *policy* controls." msgstr "" msgid "Added the *policy* keyword." @@ -122,15 +121,15 @@ msgid "" "If the :mod:`~email.policy` option :attr:`~email.policy.Policy.cte_type` is " "``8bit`` (the default), copy any headers in the original parsed message that " "have not been modified to the output with any bytes with the high bit set " -"reproduced as in the original, and preserve the non-ASCII :mailheader:" -"`Content-Transfer-Encoding` of any body parts that have them. If " -"``cte_type`` is ``7bit``, convert the bytes with the high bit set as needed " -"using an ASCII-compatible :mailheader:`Content-Transfer-Encoding`. That is, " -"transform parts with non-ASCII :mailheader:`Content-Transfer-Encoding` (:" -"mailheader:`Content-Transfer-Encoding: 8bit`) to an ASCII compatible :" -"mailheader:`Content-Transfer-Encoding`, and encode RFC-invalid non-ASCII " -"bytes in headers using the MIME ``unknown-8bit`` character set, thus " -"rendering them RFC-compliant." +"reproduced as in the original, and preserve the non-" +"ASCII :mailheader:`Content-Transfer-Encoding` of any body parts that have " +"them. If ``cte_type`` is ``7bit``, convert the bytes with the high bit set " +"as needed using an ASCII-compatible :mailheader:`Content-Transfer-Encoding`. " +"That is, transform parts with non-ASCII :mailheader:`Content-Transfer-" +"Encoding` (:mailheader:`Content-Transfer-Encoding: 8bit`) to an ASCII " +"compatible :mailheader:`Content-Transfer-Encoding`, and encode RFC-invalid " +"non-ASCII bytes in headers using the MIME ``unknown-8bit`` character set, " +"thus rendering them RFC-compliant." msgstr "" msgid "" @@ -154,26 +153,27 @@ msgstr "" msgid "" "Encode *s* using the ``ASCII`` codec and the ``surrogateescape`` error " -"handler, and pass it to the *write* method of the *outfp* passed to the :" -"class:`BytesGenerator`'s constructor." +"handler, and pass it to the *write* method of the *outfp* passed to " +"the :class:`BytesGenerator`'s constructor." msgstr "" msgid "" -"As a convenience, :class:`~email.message.EmailMessage` provides the methods :" -"meth:`~email.message.EmailMessage.as_bytes` and ``bytes(aMessage)`` (a.k.a. :" -"meth:`~email.message.EmailMessage.__bytes__`), which simplify the generation " -"of a serialized binary representation of a message object. For more detail, " -"see :mod:`email.message`." +"As a convenience, :class:`~email.message.EmailMessage` provides the " +"methods :meth:`~email.message.EmailMessage.as_bytes` and ``bytes(aMessage)`` " +"(a.k.a. :meth:`~email.message.EmailMessage.__bytes__`), which simplify the " +"generation of a serialized binary representation of a message object. For " +"more detail, see :mod:`email.message`." msgstr "" msgid "" "Because strings cannot represent binary data, the :class:`Generator` class " "must convert any binary data in any message it flattens to an ASCII " -"compatible format, by converting them to an ASCII compatible :mailheader:" -"`Content-Transfer_Encoding`. Using the terminology of the email RFCs, you " -"can think of this as :class:`Generator` serializing to an I/O stream that is " -"not \"8 bit clean\". In other words, most applications will want to be " -"using :class:`BytesGenerator`, and not :class:`Generator`." +"compatible format, by converting them to an ASCII " +"compatible :mailheader:`Content-Transfer_Encoding`. Using the terminology " +"of the email RFCs, you can think of this as :class:`Generator` serializing " +"to an I/O stream that is not \"8 bit clean\". In other words, most " +"applications will want to be using :class:`BytesGenerator`, and " +"not :class:`Generator`." msgstr "" msgid "" @@ -193,12 +193,13 @@ msgid "" "If the :mod:`~email.policy` option :attr:`~email.policy.Policy.cte_type` is " "``8bit``, generate the message as if the option were set to ``7bit``. (This " "is required because strings cannot represent non-ASCII bytes.) Convert any " -"bytes with the high bit set as needed using an ASCII-compatible :mailheader:" -"`Content-Transfer-Encoding`. That is, transform parts with non-ASCII :" -"mailheader:`Content-Transfer-Encoding` (:mailheader:`Content-Transfer-" -"Encoding: 8bit`) to an ASCII compatible :mailheader:`Content-Transfer-" -"Encoding`, and encode RFC-invalid non-ASCII bytes in headers using the MIME " -"``unknown-8bit`` character set, thus rendering them RFC-compliant." +"bytes with the high bit set as needed using an ASCII-" +"compatible :mailheader:`Content-Transfer-Encoding`. That is, transform " +"parts with non-ASCII :mailheader:`Content-Transfer-Encoding` " +"(:mailheader:`Content-Transfer-Encoding: 8bit`) to an ASCII " +"compatible :mailheader:`Content-Transfer-Encoding`, and encode RFC-invalid " +"non-ASCII bytes in headers using the MIME ``unknown-8bit`` character set, " +"thus rendering them RFC-compliant." msgstr "" msgid "" @@ -212,32 +213,33 @@ msgid "" msgstr "" msgid "" -"Write *s* to the *write* method of the *outfp* passed to the :class:" -"`Generator`'s constructor. This provides just enough file-like API for :" -"class:`Generator` instances to be used in the :func:`print` function." +"Write *s* to the *write* method of the *outfp* passed to " +"the :class:`Generator`'s constructor. This provides just enough file-like " +"API for :class:`Generator` instances to be used in the :func:`print` " +"function." msgstr "" msgid "" -"As a convenience, :class:`~email.message.EmailMessage` provides the methods :" -"meth:`~email.message.EmailMessage.as_string` and ``str(aMessage)`` (a.k.a. :" -"meth:`~email.message.EmailMessage.__str__`), which simplify the generation " -"of a formatted string representation of a message object. For more detail, " -"see :mod:`email.message`." +"As a convenience, :class:`~email.message.EmailMessage` provides the " +"methods :meth:`~email.message.EmailMessage.as_string` and ``str(aMessage)`` " +"(a.k.a. :meth:`~email.message.EmailMessage.__str__`), which simplify the " +"generation of a formatted string representation of a message object. For " +"more detail, see :mod:`email.message`." msgstr "" msgid "" -"The :mod:`email.generator` module also provides a derived class, :class:" -"`DecodedGenerator`, which is like the :class:`Generator` base class, except " -"that non-\\ :mimetype:`text` parts are not serialized, but are instead " -"represented in the output stream by a string derived from a template filled " -"in with information about the part." +"The :mod:`email.generator` module also provides a derived " +"class, :class:`DecodedGenerator`, which is like the :class:`Generator` base " +"class, except that non-\\ :mimetype:`text` parts are not serialized, but are " +"instead represented in the output stream by a string derived from a template " +"filled in with information about the part." msgstr "" msgid "" "Act like :class:`Generator`, except that for any subpart of the message " -"passed to :meth:`Generator.flatten`, if the subpart is of main type :" -"mimetype:`text`, print the decoded payload of the subpart, and if the main " -"type is not :mimetype:`text`, instead of printing it fill in the string " +"passed to :meth:`Generator.flatten`, if the subpart is of main " +"type :mimetype:`text`, print the decoded payload of the subpart, and if the " +"main type is not :mimetype:`text`, instead of printing it fill in the string " "*fmt* using information from the part and print the resulting filled-in " "string." msgstr "" @@ -277,8 +279,8 @@ msgstr "" "\"[Non-text (%(type)s) part of message omitted, filename %(filename)s]\"" msgid "" -"Optional *_mangle_from_* and *maxheaderlen* are as with the :class:" -"`Generator` base class." +"Optional *_mangle_from_* and *maxheaderlen* are as with " +"the :class:`Generator` base class." msgstr "" msgid "Footnotes" @@ -287,10 +289,10 @@ msgstr "Przypisy" msgid "" "This statement assumes that you use the appropriate setting for " "``unixfrom``, and that there are no :mod:`email.policy` settings calling for " -"automatic adjustments (for example, :attr:`~email.policy.EmailPolicy." -"refold_source` must be ``none``, which is *not* the default). It is also " -"not 100% true, since if the message does not conform to the RFC standards " -"occasionally information about the exact original text is lost during " -"parsing error recovery. It is a goal to fix these latter edge cases when " -"possible." +"automatic adjustments (for " +"example, :attr:`~email.policy.EmailPolicy.refold_source` must be ``none``, " +"which is *not* the default). It is also not 100% true, since if the message " +"does not conform to the RFC standards occasionally information about the " +"exact original text is lost during parsing error recovery. It is a goal to " +"fix these latter edge cases when possible." msgstr "" diff --git a/library/email.header.po b/library/email.header.po index 2b1624a3d5..52441ff72a 100644 --- a/library/email.header.po +++ b/library/email.header.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!email.header`: Internationalized headers" msgstr "" msgid "**Source code:** :source:`Lib/email/header.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/header.py`" msgid "" "This module is part of the legacy (``Compat32``) email API. In the current " @@ -57,18 +57,19 @@ msgid "" "used in email messages. The base standard still requires email messages to " "be transferred using only 7-bit ASCII characters, so a slew of RFCs have " "been written describing how to encode email containing non-ASCII characters " -"into :rfc:`2822`\\ -compliant format. These RFCs include :rfc:`2045`, :rfc:" -"`2046`, :rfc:`2047`, and :rfc:`2231`. The :mod:`email` package supports " -"these standards in its :mod:`email.header` and :mod:`email.charset` modules." +"into :rfc:`2822`\\ -compliant format. These RFCs " +"include :rfc:`2045`, :rfc:`2046`, :rfc:`2047`, and :rfc:`2231`. " +"The :mod:`email` package supports these standards in its :mod:`email.header` " +"and :mod:`email.charset` modules." msgstr "" msgid "" "If you want to include non-ASCII characters in your email headers, say in " -"the :mailheader:`Subject` or :mailheader:`To` fields, you should use the :" -"class:`Header` class and assign the field in the :class:`~email.message." -"Message` object to an instance of :class:`Header` instead of using a string " -"for the header value. Import the :class:`Header` class from the :mod:`email." -"header` module. For example::" +"the :mailheader:`Subject` or :mailheader:`To` fields, you should use " +"the :class:`Header` class and assign the field in " +"the :class:`~email.message.Message` object to an instance of :class:`Header` " +"instead of using a string for the header value. Import the :class:`Header` " +"class from the :mod:`email.header` module. For example::" msgstr "" msgid "" @@ -84,10 +85,11 @@ msgstr "" msgid "" "Notice here how we wanted the :mailheader:`Subject` field to contain a non-" "ASCII character? We did this by creating a :class:`Header` instance and " -"passing in the character set that the byte string was encoded in. When the " -"subsequent :class:`~email.message.Message` instance was flattened, the :" -"mailheader:`Subject` field was properly :rfc:`2047` encoded. MIME-aware " -"mail readers would show this header using the embedded ISO-8859-1 character." +"passing in the character set to use when encoding it. When the " +"subsequent :class:`~email.message.Message` instance was flattened, " +"the :mailheader:`Subject` field was properly :rfc:`2047` encoded. MIME-" +"aware mail readers would show this header using the embedded ISO-8859-1 " +"character." msgstr "" msgid "Here is the :class:`Header` class description:" @@ -100,9 +102,9 @@ msgstr "" msgid "" "Optional *s* is the initial header value. If ``None`` (the default), the " -"initial header value is not set. You can later append to the header with :" -"meth:`append` method calls. *s* may be an instance of :class:`bytes` or :" -"class:`str`, but see the :meth:`append` documentation for semantics." +"initial header value is not set. You can later append to the header " +"with :meth:`append` method calls. *s* may be an instance of :class:`bytes` " +"or :class:`str`, but see the :meth:`append` documentation for semantics." msgstr "" msgid "" @@ -158,9 +160,9 @@ msgid "" msgstr "" msgid "" -"In either case, when producing an :rfc:`2822`\\ -compliant header using :rfc:" -"`2047` rules, the string will be encoded using the output codec of the " -"charset. If the string cannot be encoded using the output codec, a " +"In either case, when producing an :rfc:`2822`\\ -compliant header " +"using :rfc:`2047` rules, the string will be encoded using the output codec " +"of the charset. If the string cannot be encoded using the output codec, a " "UnicodeError will be raised." msgstr "" @@ -209,10 +211,10 @@ msgstr "" msgid "" "Returns an approximation of the :class:`Header` as a string, using an " -"unlimited line length. All pieces are converted to unicode using the " -"specified encoding and joined together appropriately. Any pieces with a " -"charset of ``'unknown-8bit'`` are decoded as ASCII using the ``'replace'`` " -"error handler." +"unlimited line length. All pieces are decoded using the specified encoding " +"and joined together appropriately. Any pieces with a charset of " +"``'unknown-8bit'`` are decoded as ASCII using the ``'replace'`` error " +"handler." msgstr "" msgid "Added handling for the ``'unknown-8bit'`` charset." @@ -237,28 +239,42 @@ msgid "" "header value is in *header*." msgstr "" +msgid "For historical reasons, this function may return either:" +msgstr "" + +msgid "" +"A list of pairs containing each of the decoded parts of the header, " +"``(decoded_bytes, charset)``, where *decoded_bytes* is always an instance " +"of :class:`bytes`, and *charset* is either:" +msgstr "" + +msgid "A lower case string containing the name of the character set specified." +msgstr "" + +msgid "``None`` for non-encoded parts of the header." +msgstr "" + +msgid "" +"A list of length 1 containing a pair ``(string, None)``, where *string* is " +"always an instance of :class:`str`." +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." +"An :exc:`email.errors.HeaderParseError` may be raised when certain decoding " +"errors occur (e.g. a base64 decoding exception)." msgstr "" -msgid "Here's an example::" +msgid "Here are examples:" msgstr "" msgid "" -">>> from email.header import decode_header\n" -">>> decode_header('=?iso-8859-1?q?p=F6stal?=')\n" -"[(b'p\\xf6stal', 'iso-8859-1')]" +"This function exists for backwards compatibility only. For new code, we " +"recommend using :class:`email.headerregistry.HeaderRegistry`." msgstr "" -">>> from email.header import decode_header\n" -">>> decode_header('=?iso-8859-1?q?p=F6stal?=')\n" -"[(b'p\\xf6stal', 'iso-8859-1')]" msgid "" -"Create a :class:`Header` instance from a sequence of pairs as returned by :" -"func:`decode_header`." +"Create a :class:`Header` instance from a sequence of pairs as returned " +"by :func:`decode_header`." msgstr "" msgid "" @@ -268,7 +284,12 @@ msgid "" msgstr "" msgid "" -"This function takes one of those sequence of pairs and returns a :class:" -"`Header` instance. Optional *maxlinelen*, *header_name*, and " +"This function takes one of those sequence of pairs and returns " +"a :class:`Header` instance. Optional *maxlinelen*, *header_name*, and " "*continuation_ws* are as in the :class:`Header` constructor." msgstr "" + +msgid "" +"This function exists for backwards compatibility only, and is not " +"recommended for use in new code." +msgstr "" diff --git a/library/email.headerregistry.po b/library/email.headerregistry.po index e003d27a7e..c8f6176c62 100644 --- a/library/email.headerregistry.po +++ b/library/email.headerregistry.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,46 +27,48 @@ msgid ":mod:`!email.headerregistry`: Custom Header Objects" msgstr "" msgid "**Source code:** :source:`Lib/email/headerregistry.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/headerregistry.py`" msgid "[1]_" -msgstr "" +msgstr "[1]_" msgid "" "Headers are represented by customized subclasses of :class:`str`. The " -"particular class used to represent a given header is determined by the :attr:" -"`~email.policy.EmailPolicy.header_factory` of the :mod:`~email.policy` in " -"effect when the headers are created. This section documents the particular " -"``header_factory`` implemented by the email package for handling :RFC:`5322` " -"compliant email messages, which not only provides customized header objects " -"for various header types, but also provides an extension mechanism for " -"applications to add their own custom header types." +"particular class used to represent a given header is determined by " +"the :attr:`~email.policy.EmailPolicy.header_factory` of " +"the :mod:`~email.policy` in effect when the headers are created. This " +"section documents the particular ``header_factory`` implemented by the email " +"package for handling :RFC:`5322` compliant email messages, which not only " +"provides customized header objects for various header types, but also " +"provides an extension mechanism for applications to add their own custom " +"header types." msgstr "" msgid "" -"When using any of the policy objects derived from :data:`~email.policy." -"EmailPolicy`, all headers are produced by :class:`.HeaderRegistry` and have :" -"class:`.BaseHeader` as their last base class. Each header class has an " -"additional base class that is determined by the type of the header. For " -"example, many headers have the class :class:`.UnstructuredHeader` as their " -"other base class. The specialized second class for a header is determined " -"by the name of the header, using a lookup table stored in the :class:`." -"HeaderRegistry`. All of this is managed transparently for the typical " -"application program, but interfaces are provided for modifying the default " -"behavior for use by more complex applications." +"When using any of the policy objects derived " +"from :data:`~email.policy.EmailPolicy`, all headers are produced " +"by :class:`.HeaderRegistry` and have :class:`.BaseHeader` as their last base " +"class. Each header class has an additional base class that is determined by " +"the type of the header. For example, many headers have the " +"class :class:`.UnstructuredHeader` as their other base class. The " +"specialized second class for a header is determined by the name of the " +"header, using a lookup table stored in the :class:`.HeaderRegistry`. All of " +"this is managed transparently for the typical application program, but " +"interfaces are provided for modifying the default behavior for use by more " +"complex applications." msgstr "" msgid "" "The sections below first document the header base classes and their " -"attributes, followed by the API for modifying the behavior of :class:`." -"HeaderRegistry`, and finally the support classes used to represent the data " -"parsed from structured headers." +"attributes, followed by the API for modifying the behavior " +"of :class:`.HeaderRegistry`, and finally the support classes used to " +"represent the data parsed from structured headers." msgstr "" msgid "" -"*name* and *value* are passed to ``BaseHeader`` from the :attr:`~email." -"policy.EmailPolicy.header_factory` call. The string value of any header " -"object is the *value* fully decoded to unicode." +"*name* and *value* are passed to ``BaseHeader`` from " +"the :attr:`~email.policy.EmailPolicy.header_factory` call. The string value " +"of any header object is the *value* fully decoded to a string." msgstr "" msgid "This base class defines the following read-only properties:" @@ -75,8 +76,9 @@ msgstr "" msgid "" "The name of the header (the portion of the field before the ':'). This is " -"exactly the value passed in the :attr:`~email.policy.EmailPolicy." -"header_factory` call for *name*; that is, case is preserved." +"exactly the value passed in " +"the :attr:`~email.policy.EmailPolicy.header_factory` call for *name*; that " +"is, case is preserved." msgstr "" msgid "" @@ -101,11 +103,11 @@ msgstr "" msgid "" "Return a string containing :attr:`~email.policy.Policy.linesep` characters " -"as required to correctly fold the header according to *policy*. A :attr:" -"`~email.policy.Policy.cte_type` of ``8bit`` will be treated as if it were " -"``7bit``, since headers may not contain arbitrary binary data. If :attr:" -"`~email.policy.EmailPolicy.utf8` is ``False``, non-ASCII data will be :rfc:" -"`2047` encoded." +"as required to correctly fold the header according to *policy*. " +"A :attr:`~email.policy.Policy.cte_type` of ``8bit`` will be treated as if it " +"were ``7bit``, since headers may not contain arbitrary binary data. " +"If :attr:`~email.policy.EmailPolicy.utf8` is ``False``, non-ASCII data will " +"be :rfc:`2047` encoded." msgstr "" msgid "" @@ -123,12 +125,13 @@ msgid "" "``kwds`` is a dictionary containing one pre-initialized key, ``defects``. " "``defects`` is an empty list. The parse method should append any detected " "defects to this list. On return, the ``kwds`` dictionary *must* contain " -"values for at least the keys ``decoded`` and ``defects``. ``decoded`` " -"should be the string value for the header (that is, the header value fully " -"decoded to unicode). The parse method should assume that *string* may " -"contain content-transfer-encoded parts, but should correctly handle all " -"valid unicode characters as well so that it can parse un-encoded header " -"values." +"values for at least the keys ``decoded``, ``defects`` and ``parse_tree``. " +"``decoded`` should be the string value for the header (that is, the header " +"value fully decoded to a string). ``parse_tree`` is set to the parse tree " +"obtained from parsing the header. The parse method should assume that " +"*string* may contain content-transfer-encoded parts, but should correctly " +"handle all valid Unicode characters as well so that it can parse un-encoded " +"header values." msgstr "" msgid "" @@ -163,7 +166,7 @@ msgid "" "mechanism for encoding non-ASCII text as ASCII characters within a header " "value. When a *value* containing encoded words is passed to the " "constructor, the ``UnstructuredHeader`` parser converts such encoded words " -"into unicode, following the :rfc:`2047` rules for unstructured text. The " +"into a string, following the :rfc:`2047` rules for unstructured text. The " "parser uses heuristics to attempt to decode certain non-compliant encoded " "words. Defects are registered in such cases, as well as defects for issues " "such as invalid characters within the encoded words or the non-encoded text." @@ -187,10 +190,11 @@ msgid "" "another, this attribute will contain a :class:`~datetime.datetime` instance " "representing that date. If the timezone of the input date is specified as " "``-0000`` (indicating it is in UTC but contains no information about the " -"source timezone), then :attr:`.datetime` will be a naive :class:`~datetime." -"datetime`. If a specific timezone offset is found (including ``+0000``), " -"then :attr:`.datetime` will contain an aware ``datetime`` that uses :class:" -"`datetime.timezone` to record the timezone offset." +"source timezone), then :attr:`.datetime` will be a " +"naive :class:`~datetime.datetime`. If a specific timezone offset is found " +"(including ``+0000``), then :attr:`.datetime` will contain an aware " +"``datetime`` that uses :class:`datetime.timezone` to record the timezone " +"offset." msgstr "" msgid "" @@ -213,8 +217,8 @@ msgstr "" msgid "" "Because this is a naive ``datetime`` it will be interpreted as a UTC " "timestamp, and the resulting value will have a timezone of ``-0000``. Much " -"more useful is to use the :func:`~email.utils.localtime` function from the :" -"mod:`~email.utils` module::" +"more useful is to use the :func:`~email.utils.localtime` function from " +"the :mod:`~email.utils` module::" msgstr "" msgid "msg['Date'] = utils.localtime()" @@ -246,9 +250,9 @@ msgid "" msgstr "" msgid "" -"The ``decoded`` value of the header will have all encoded words decoded to " -"unicode. :class:`~encodings.idna` encoded domain names are also decoded to " -"unicode. The ``decoded`` value is set by :ref:`joining ` " +"The ``decoded`` value of the header will have all encoded words decoded to a " +"string. :class:`~encodings.idna` encoded domain names are also decoded to a " +"string. The ``decoded`` value is set by :ref:`joining ` " "the :class:`str` value of the elements of the ``groups`` attribute with ``', " "'``." msgstr "" @@ -307,16 +311,16 @@ msgid "A dictionary mapping parameter names to parameter values." msgstr "" msgid "" -"A :class:`ParameterizedMIMEHeader` class that handles the :mailheader:" -"`Content-Type` header." +"A :class:`ParameterizedMIMEHeader` class that handles " +"the :mailheader:`Content-Type` header." msgstr "" msgid "The content type string, in the form ``maintype/subtype``." msgstr "" msgid "" -"A :class:`ParameterizedMIMEHeader` class that handles the :mailheader:" -"`Content-Disposition` header." +"A :class:`ParameterizedMIMEHeader` class that handles " +"the :mailheader:`Content-Disposition` header." msgstr "" msgid "``inline`` and ``attachment`` are the only valid values in common use." @@ -397,7 +401,7 @@ msgid "resent-cc" msgstr "" msgid "bcc" -msgstr "" +msgstr "bcc" msgid "resent-bcc" msgstr "" @@ -483,8 +487,8 @@ msgid "username@domain" msgstr "" msgid "" -"where each part must conform to specific syntax rules spelled out in :rfc:" -"`5322`." +"where each part must conform to specific syntax rules spelled out " +"in :rfc:`5322`." msgstr "" msgid "" @@ -492,7 +496,7 @@ msgid "" "*domain*, in which case *username* and *domain* will be parsed from the " "*addr_spec*. An *addr_spec* must be a properly RFC quoted string; if it is " "not ``Address`` will raise an error. Unicode characters are allowed and " -"will be property encoded when serialized. However, per the RFCs, unicode is " +"will be property encoded when serialized. However, per the RFCs, Unicode is " "*not* allowed in the username portion of the address." msgstr "" @@ -514,8 +518,8 @@ msgid "" msgstr "" msgid "" -"The ``str`` value of the object is the address quoted according to :rfc:" -"`5322` rules, but with no Content Transfer Encoding of any non-ASCII " +"The ``str`` value of the object is the address quoted according " +"to :rfc:`5322` rules, but with no Content Transfer Encoding of any non-ASCII " "characters." msgstr "" diff --git a/library/email.iterators.po b/library/email.iterators.po index e6a5318112..26b313e551 100644 --- a/library/email.iterators.po +++ b/library/email.iterators.po @@ -30,10 +30,10 @@ msgid "**Source code:** :source:`Lib/email/iterators.py`" msgstr "" msgid "" -"Iterating over a message object tree is fairly easy with the :meth:`Message." -"walk ` method. The :mod:`email.iterators` " -"module provides some useful higher level iterations over message object " -"trees." +"Iterating over a message object tree is fairly easy with " +"the :meth:`Message.walk ` method. " +"The :mod:`email.iterators` module provides some useful higher level " +"iterations over message object trees." msgstr "" msgid "" @@ -46,8 +46,8 @@ msgid "" msgstr "" msgid "" -"Optional *decode* is passed through to :meth:`Message.get_payload `." +"Optional *decode* is passed through to :meth:`Message.get_payload " +"`." msgstr "" msgid "" diff --git a/library/email.message.po b/library/email.message.po index 06f067e878..d101575a39 100644 --- a/library/email.message.po +++ b/library/email.message.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,10 +27,10 @@ msgid ":mod:`!email.message`: Representing an email message" msgstr "" msgid "**Source code:** :source:`Lib/email/message.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/message.py`" msgid "[1]_" -msgstr "" +msgstr "[1]_" msgid "" "The central class in the :mod:`email` package is the :class:`EmailMessage` " @@ -81,24 +81,24 @@ msgstr "" msgid "" "If *policy* is specified use the rules it specifies to update and serialize " -"the representation of the message. If *policy* is not set, use the :class:" -"`~email.policy.default` policy, which follows the rules of the email RFCs " -"except for line endings (instead of the RFC mandated ``\\r\\n``, it uses the " -"Python standard ``\\n`` line endings). For more information see the :mod:" -"`~email.policy` documentation." +"the representation of the message. If *policy* is not set, use " +"the :class:`~email.policy.default` policy, which follows the rules of the " +"email RFCs except for line endings (instead of the RFC mandated ``\\r\\n``, " +"it uses the Python standard ``\\n`` line endings). For more information see " +"the :mod:`~email.policy` documentation. [2]_" msgstr "" msgid "" "Return the entire message flattened as a string. When optional *unixfrom* " "is true, the envelope header is included in the returned string. *unixfrom* " -"defaults to ``False``. For backward compatibility with the base :class:" -"`~email.message.Message` class *maxheaderlen* is accepted, but defaults to " -"``None``, which means that by default the line length is controlled by the :" -"attr:`~email.policy.Policy.max_line_length` of the policy. The *policy* " -"argument may be used to override the default policy obtained from the " -"message instance. This can be used to control some of the formatting " -"produced by the method, since the specified *policy* will be passed to the :" -"class:`~email.generator.Generator`." +"defaults to ``False``. For backward compatibility with the " +"base :class:`~email.message.Message` class *maxheaderlen* is accepted, but " +"defaults to ``None``, which means that by default the line length is " +"controlled by the :attr:`~email.policy.Policy.max_line_length` of the " +"policy. The *policy* argument may be used to override the default policy " +"obtained from the message instance. This can be used to control some of the " +"formatting produced by the method, since the specified *policy* will be " +"passed to the :class:`~email.generator.Generator`." msgstr "" msgid "" @@ -112,8 +112,9 @@ msgid "" "useful way to serialize messages in your application, especially if you are " "dealing with multiple messages. See :class:`email.generator.Generator` for " "a more flexible API for serializing messages. Note also that this method is " -"restricted to producing messages serialized as \"7 bit clean\" when :attr:" -"`~email.policy.EmailPolicy.utf8` is ``False``, which is the default." +"restricted to producing messages serialized as \"7 bit clean\" " +"when :attr:`~email.policy.EmailPolicy.utf8` is ``False``, which is the " +"default." msgstr "" msgid "" @@ -130,8 +131,8 @@ msgstr "" msgid "" "the method was changed to use ``utf8=True``, thus producing an :rfc:`6531`-" -"like message representation, instead of being a direct alias for :meth:" -"`as_string`." +"like message representation, instead of being a direct alias " +"for :meth:`as_string`." msgstr "" msgid "" @@ -140,8 +141,8 @@ msgid "" "*unixfrom* defaults to ``False``. The *policy* argument may be used to " "override the default policy obtained from the message instance. This can be " "used to control some of the formatting produced by the method, since the " -"specified *policy* will be passed to the :class:`~email.generator." -"BytesGenerator`." +"specified *policy* will be passed to " +"the :class:`~email.generator.BytesGenerator`." msgstr "" msgid "" @@ -157,14 +158,14 @@ msgid "" msgstr "" msgid "" -"Return ``True`` if the message's payload is a list of sub-\\ :class:" -"`EmailMessage` objects, otherwise return ``False``. When :meth:" -"`is_multipart` returns ``False``, the payload should be a string object " -"(which might be a CTE encoded binary payload). Note that :meth:" -"`is_multipart` returning ``True`` does not necessarily mean that \"msg." -"get_content_maintype() == 'multipart'\" will return the ``True``. For " -"example, ``is_multipart`` will return ``True`` when the :class:" -"`EmailMessage` is of type ``message/rfc822``." +"Return ``True`` if the message's payload is a list of sub-" +"\\ :class:`EmailMessage` objects, otherwise return ``False``. " +"When :meth:`is_multipart` returns ``False``, the payload should be a string " +"object (which might be a CTE encoded binary payload). Note " +"that :meth:`is_multipart` returning ``True`` does not necessarily mean that " +"\"msg.get_content_maintype() == 'multipart'\" will return the ``True``. For " +"example, ``is_multipart`` will return ``True`` when " +"the :class:`EmailMessage` is of type ``message/rfc822``." msgstr "" msgid "" @@ -216,8 +217,8 @@ msgstr "" msgid "" "Return the value of the named header field. *name* does not include the " -"colon field separator. If the header is missing, ``None`` is returned; a :" -"exc:`KeyError` is never raised." +"colon field separator. If the header is missing, ``None`` is returned; " +"a :exc:`KeyError` is never raised." msgstr "" msgid "" @@ -275,9 +276,9 @@ msgid "" msgstr "" msgid "" -"Return the value of the named header field. This is identical to :meth:" -"`~object.__getitem__` except that optional *failobj* is returned if the " -"named header is missing (*failobj* defaults to ``None``)." +"Return the value of the named header field. This is identical " +"to :meth:`~object.__getitem__` except that optional *failobj* is returned if " +"the named header is missing (*failobj* defaults to ``None``)." msgstr "" msgid "Here are some additional useful header related methods:" @@ -343,21 +344,21 @@ msgid "" msgstr "" msgid "" -"Return the message's content type, coerced to lower case of the form :" -"mimetype:`maintype/subtype`. If there is no :mailheader:`Content-Type` " -"header in the message return the value returned by :meth:" -"`get_default_type`. If the :mailheader:`Content-Type` header is invalid, " -"return ``text/plain``." +"Return the message's content type, coerced to lower case of the " +"form :mimetype:`maintype/subtype`. If there is no :mailheader:`Content-" +"Type` header in the message return the value returned " +"by :meth:`get_default_type`. If the :mailheader:`Content-Type` header is " +"invalid, return ``text/plain``." msgstr "" msgid "" -"(According to :rfc:`2045`, messages always have a default type, :meth:" -"`get_content_type` will always return a value. :rfc:`2045` defines a " -"message's default type to be :mimetype:`text/plain` unless it appears inside " -"a :mimetype:`multipart/digest` container, in which case it would be :" -"mimetype:`message/rfc822`. If the :mailheader:`Content-Type` header has an " -"invalid type specification, :rfc:`2045` mandates that the default type be :" -"mimetype:`text/plain`.)" +"(According to :rfc:`2045`, messages always have a default " +"type, :meth:`get_content_type` will always return a value. :rfc:`2045` " +"defines a message's default type to be :mimetype:`text/plain` unless it " +"appears inside a :mimetype:`multipart/digest` container, in which case it " +"would be :mimetype:`message/rfc822`. If the :mailheader:`Content-Type` " +"header has an invalid type specification, :rfc:`2045` mandates that the " +"default type be :mimetype:`text/plain`.)" msgstr "" msgid "" @@ -372,8 +373,8 @@ msgstr "" msgid "" "Return the default content type. Most messages have a default content type " -"of :mimetype:`text/plain`, except for messages that are subparts of :" -"mimetype:`multipart/digest` containers. Such subparts have a default " +"of :mimetype:`text/plain`, except for messages that are subparts " +"of :mimetype:`multipart/digest` containers. Such subparts have a default " "content type of :mimetype:`message/rfc822`." msgstr "" @@ -390,8 +391,8 @@ msgid "" "already exists in the header, replace its value with *value*. When *header* " "is ``Content-Type`` (the default) and the header does not yet exist in the " "message, add it, set its value to :mimetype:`text/plain`, and append the new " -"parameter value. Optional *header* specifies an alternative header to :" -"mailheader:`Content-Type`." +"parameter value. Optional *header* specifies an alternative header " +"to :mailheader:`Content-Type`." msgstr "" msgid "" @@ -415,9 +416,9 @@ msgid "" msgstr "" msgid "" -"Note that existing parameter values of headers may be accessed through the :" -"attr:`~email.headerregistry.ParameterizedMIMEHeader.params` attribute of the " -"header value (for example, ``msg['Content-Type'].params['charset']``)." +"Note that existing parameter values of headers may be accessed through " +"the :attr:`~email.headerregistry.ParameterizedMIMEHeader.params` attribute " +"of the header value (for example, ``msg['Content-Type'].params['charset']``)." msgstr "" msgid "``replace`` keyword was added." @@ -454,10 +455,10 @@ msgid "" msgstr "" msgid "" -"Note that using this method is subtly different from deleting the old :" -"mailheader:`Content-Type` header and adding a new one with the new boundary " -"via :meth:`add_header`, because :meth:`set_boundary` preserves the order of " -"the :mailheader:`Content-Type` header in the list of headers." +"Note that using this method is subtly different from deleting the " +"old :mailheader:`Content-Type` header and adding a new one with the new " +"boundary via :meth:`add_header`, because :meth:`set_boundary` preserves the " +"order of the :mailheader:`Content-Type` header in the list of headers." msgstr "" msgid "" @@ -486,15 +487,15 @@ msgid "" msgstr "" msgid "" -"is_attachment is now a method instead of a property, for consistency with :" -"meth:`~email.message.Message.is_multipart`." +"is_attachment is now a method instead of a property, for consistency " +"with :meth:`~email.message.Message.is_multipart`." msgstr "" msgid "" -"Return the lowercased value (without parameters) of the message's :" -"mailheader:`Content-Disposition` header if it has one, or ``None``. The " -"possible values for this method are *inline*, *attachment* or ``None`` if " -"the message follows :rfc:`2183`." +"Return the lowercased value (without parameters) of the " +"message's :mailheader:`Content-Disposition` header if it has one, or " +"``None``. The possible values for this method are *inline*, *attachment* or " +"``None`` if the message follows :rfc:`2183`." msgstr "" msgid "" @@ -616,8 +617,8 @@ msgid "" "Return an iterator over all of the immediate sub-parts of the message that " "are not candidate \"body\" parts. That is, skip the first occurrence of " "each of ``text/plain``, ``text/html``, ``multipart/related``, or ``multipart/" -"alternative`` (unless they are explicitly marked as attachments via :" -"mailheader:`Content-Disposition: attachment`), and return all remaining " +"alternative`` (unless they are explicitly marked as attachments " +"via :mailheader:`Content-Disposition: attachment`), and return all remaining " "parts. When applied directly to a ``multipart/related``, return an iterator " "over the all the related parts except the root part (ie: the part pointed to " "by the ``start`` parameter, or the first part if there is no ``start`` " @@ -628,8 +629,8 @@ msgstr "" msgid "" "Return an iterator over all of the immediate sub-parts of the message, which " -"will be empty for a non-``multipart``. (See also :meth:`~email.message." -"EmailMessage.walk`.)" +"will be empty for a non-``multipart``. (See " +"also :meth:`~email.message.EmailMessage.walk`.)" msgstr "" msgid "" @@ -668,47 +669,49 @@ msgstr "" msgid "" "Convert a non-``multipart``, a ``multipart/related``, or a ``multipart-" -"alternative`` into a ``multipart/mixed``, moving any existing :mailheader:" -"`Content-` headers and payload into a (new) first part of the " -"``multipart``. If *boundary* is specified, use it as the boundary string in " -"the multipart, otherwise leave the boundary to be automatically created when " -"it is needed (for example, when the message is serialized)." +"alternative`` into a ``multipart/mixed``, moving any " +"existing :mailheader:`Content-` headers and payload into a (new) first part " +"of the ``multipart``. If *boundary* is specified, use it as the boundary " +"string in the multipart, otherwise leave the boundary to be automatically " +"created when it is needed (for example, when the message is serialized)." msgstr "" msgid "" "If the message is a ``multipart/related``, create a new message object, pass " -"all of the arguments to its :meth:`set_content` method, and :meth:`~email." -"message.Message.attach` it to the ``multipart``. If the message is a non-" -"``multipart``, call :meth:`make_related` and then proceed as above. If the " -"message is any other type of ``multipart``, raise a :exc:`TypeError`. If " -"*content_manager* is not specified, use the ``content_manager`` specified by " -"the current :mod:`~email.policy`. If the added part has no :mailheader:" -"`Content-Disposition` header, add one with the value ``inline``." +"all of the arguments to its :meth:`set_content` method, " +"and :meth:`~email.message.Message.attach` it to the ``multipart``. If the " +"message is a non-``multipart``, call :meth:`make_related` and then proceed " +"as above. If the message is any other type of ``multipart``, raise " +"a :exc:`TypeError`. If *content_manager* is not specified, use the " +"``content_manager`` specified by the current :mod:`~email.policy`. If the " +"added part has no :mailheader:`Content-Disposition` header, add one with the " +"value ``inline``." msgstr "" msgid "" "If the message is a ``multipart/alternative``, create a new message object, " -"pass all of the arguments to its :meth:`set_content` method, and :meth:" -"`~email.message.Message.attach` it to the ``multipart``. If the message is " -"a non-``multipart`` or ``multipart/related``, call :meth:`make_alternative` " -"and then proceed as above. If the message is any other type of " -"``multipart``, raise a :exc:`TypeError`. If *content_manager* is not " -"specified, use the ``content_manager`` specified by the current :mod:`~email." -"policy`." +"pass all of the arguments to its :meth:`set_content` method, " +"and :meth:`~email.message.Message.attach` it to the ``multipart``. If the " +"message is a non-``multipart`` or ``multipart/related``, " +"call :meth:`make_alternative` and then proceed as above. If the message is " +"any other type of ``multipart``, raise a :exc:`TypeError`. If " +"*content_manager* is not specified, use the ``content_manager`` specified by " +"the current :mod:`~email.policy`." msgstr "" msgid "" "If the message is a ``multipart/mixed``, create a new message object, pass " -"all of the arguments to its :meth:`set_content` method, and :meth:`~email." -"message.Message.attach` it to the ``multipart``. If the message is a non-" -"``multipart``, ``multipart/related``, or ``multipart/alternative``, call :" -"meth:`make_mixed` and then proceed as above. If *content_manager* is not " -"specified, use the ``content_manager`` specified by the current :mod:`~email." -"policy`. If the added part has no :mailheader:`Content-Disposition` header, " -"add one with the value ``attachment``. This method can be used both for " -"explicit attachments (:mailheader:`Content-Disposition: attachment`) and " -"``inline`` attachments (:mailheader:`Content-Disposition: inline`), by " -"passing appropriate options to the ``content_manager``." +"all of the arguments to its :meth:`set_content` method, " +"and :meth:`~email.message.Message.attach` it to the ``multipart``. If the " +"message is a non-``multipart``, ``multipart/related``, or ``multipart/" +"alternative``, call :meth:`make_mixed` and then proceed as above. If " +"*content_manager* is not specified, use the ``content_manager`` specified by " +"the current :mod:`~email.policy`. If the added part has " +"no :mailheader:`Content-Disposition` header, add one with the value " +"``attachment``. This method can be used both for explicit attachments " +"(:mailheader:`Content-Disposition: attachment`) and ``inline`` attachments " +"(:mailheader:`Content-Disposition: inline`), by passing appropriate options " +"to the ``content_manager``." msgstr "" msgid "Remove the payload and all of the headers." @@ -735,11 +738,12 @@ msgid "" "The *preamble* attribute contains this leading extra-armor text for MIME " "documents. When the :class:`~email.parser.Parser` discovers some text after " "the headers but before the first boundary string, it assigns this text to " -"the message's *preamble* attribute. When the :class:`~email.generator." -"Generator` is writing out the plain text representation of a MIME message, " -"and it finds the message has a *preamble* attribute, it will write this text " -"in the area between the headers and the first boundary. See :mod:`email." -"parser` and :mod:`email.generator` for details." +"the message's *preamble* attribute. When " +"the :class:`~email.generator.Generator` is writing out the plain text " +"representation of a MIME message, and it finds the message has a *preamble* " +"attribute, it will write this text in the area between the headers and the " +"first boundary. See :mod:`email.parser` and :mod:`email.generator` for " +"details." msgstr "" msgid "" @@ -761,10 +765,10 @@ msgid "" msgstr "" msgid "" -"This class represents a subpart of a MIME message. It is identical to :" -"class:`EmailMessage`, except that no :mailheader:`MIME-Version` headers are " -"added when :meth:`~EmailMessage.set_content` is called, since sub-parts do " -"not need their own :mailheader:`MIME-Version` headers." +"This class represents a subpart of a MIME message. It is identical " +"to :class:`EmailMessage`, except that no :mailheader:`MIME-Version` headers " +"are added when :meth:`~EmailMessage.set_content` is called, since sub-parts " +"do not need their own :mailheader:`MIME-Version` headers." msgstr "" msgid "Footnotes" @@ -774,3 +778,11 @@ msgid "" "Originally added in 3.4 as a :term:`provisional module `. Docs for legacy message class moved to :ref:`compat32_message`." msgstr "" + +msgid "" +"The :class:`EmailMessage` class requires a policy that provides a " +"``content_manager`` attribute for content management methods like " +"``set_content()`` and ``get_content()`` to work. The " +"legacy :const:`~email.policy.compat32` policy does not support these methods " +"and should not be used with :class:`EmailMessage`." +msgstr "" diff --git a/library/email.mime.po b/library/email.mime.po index 3ab18d1a50..7aadc0d085 100644 --- a/library/email.mime.po +++ b/library/email.mime.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\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" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -23,11 +23,11 @@ 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 ":mod:`email.mime`: Creating email and MIME objects from scratch" +msgid ":mod:`!email.mime`: Creating email and MIME objects from scratch" msgstr "" msgid "**Source code:** :source:`Lib/email/mime/`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/mime/`" msgid "" "This module is part of the legacy (``Compat32``) email API. Its " @@ -41,16 +41,17 @@ msgid "" "text to a parser, which parses the text and returns the root message " "object. However you can also build a complete message structure from " "scratch, or even individual :class:`~email.message.Message` objects by " -"hand. In fact, you can also take an existing structure and add new :class:" -"`~email.message.Message` objects, move them around, etc. This makes a very " -"convenient interface for slicing-and-dicing MIME messages." +"hand. In fact, you can also take an existing structure and add " +"new :class:`~email.message.Message` objects, move them around, etc. This " +"makes a very convenient interface for slicing-and-dicing MIME messages." msgstr "" msgid "" -"You can create a new object structure by creating :class:`~email.message." -"Message` instances, adding attachments and all the appropriate headers " -"manually. For MIME messages though, the :mod:`email` package provides some " -"convenient subclasses to make things easier." +"You can create a new object structure by " +"creating :class:`~email.message.Message` instances, adding attachments and " +"all the appropriate headers manually. For MIME messages though, " +"the :mod:`email` package provides some convenient subclasses to make things " +"easier." msgstr "" msgid "Here are the classes:" @@ -60,24 +61,26 @@ msgid "Module: :mod:`email.mime.base`" msgstr "" msgid "" -"This is the base class for all the MIME-specific subclasses of :class:" -"`~email.message.Message`. Ordinarily you won't create instances " +"This is the base class for all the MIME-specific subclasses " +"of :class:`~email.message.Message`. Ordinarily you won't create instances " "specifically of :class:`MIMEBase`, although you could. :class:`MIMEBase` is " "provided primarily as a convenient base class for more specific MIME-aware " "subclasses." msgstr "" msgid "" -"*_maintype* is the :mailheader:`Content-Type` major type (e.g. :mimetype:" -"`text` or :mimetype:`image`), and *_subtype* is the :mailheader:`Content-" -"Type` minor type (e.g. :mimetype:`plain` or :mimetype:`gif`). *_params* is " -"a parameter key/value dictionary and is passed directly to :meth:`Message." -"add_header `." +"*_maintype* is the :mailheader:`Content-Type` major type " +"(e.g. :mimetype:`text` or :mimetype:`image`), and *_subtype* is " +"the :mailheader:`Content-Type` minor type (e.g. :mimetype:`plain` " +"or :mimetype:`gif`). *_params* is a parameter key/value dictionary and is " +"passed directly to :meth:`Message.add_header " +"`." msgstr "" msgid "" -"If *policy* is specified, (defaults to the :class:`compat32 ` policy) it will be passed to :class:`~email.message.Message`." +"If *policy* is specified, (defaults to the :class:`compat32 " +"` policy) it will be passed " +"to :class:`~email.message.Message`." msgstr "" msgid "" @@ -95,9 +98,10 @@ msgstr "" msgid "" "A subclass of :class:`~email.mime.base.MIMEBase`, this is an intermediate " "base class for MIME messages that are not :mimetype:`multipart`. The " -"primary purpose of this class is to prevent the use of the :meth:`~email." -"message.Message.attach` method, which only makes sense for :mimetype:" -"`multipart` messages. If :meth:`~email.message.Message.attach` is called, " +"primary purpose of this class is to prevent the use of " +"the :meth:`~email.message.Message.attach` method, which only makes sense " +"for :mimetype:`multipart` messages. " +"If :meth:`~email.message.Message.attach` is called, " "a :exc:`~email.errors.MultipartConversionError` exception is raised." msgstr "" @@ -108,9 +112,9 @@ msgid "" "A subclass of :class:`~email.mime.base.MIMEBase`, this is an intermediate " "base class for MIME messages that are :mimetype:`multipart`. Optional " "*_subtype* defaults to :mimetype:`mixed`, but can be used to specify the " -"subtype of the message. A :mailheader:`Content-Type` header of :mimetype:" -"`multipart/_subtype` will be added to the message object. A :mailheader:" -"`MIME-Version` header will also be added." +"subtype of the message. A :mailheader:`Content-Type` header " +"of :mimetype:`multipart/_subtype` will be added to the message object. " +"A :mailheader:`MIME-Version` header will also be added." msgstr "" msgid "" @@ -122,13 +126,13 @@ msgstr "" msgid "" "*_subparts* is a sequence of initial subparts for the payload. It must be " "possible to convert this sequence to a list. You can always attach new " -"subparts to the message by using the :meth:`Message.attach ` method." +"subparts to the message by using the :meth:`Message.attach " +"` method." msgstr "" msgid "" -"Optional *policy* argument defaults to :class:`compat32 `." +"Optional *policy* argument defaults to :class:`compat32 " +"`." msgstr "" msgid "" @@ -138,25 +142,26 @@ msgid "" msgstr "" msgid "Module: :mod:`email.mime.application`" -msgstr "" +msgstr "Moduł: :mod:`email.mime.application`" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEApplication` class is used to represent MIME message objects of major " -"type :mimetype:`application`. *_data* contains the bytes for the raw " -"application data. Optional *_subtype* specifies the MIME subtype and " +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEApplication` class is used to represent MIME message objects " +"of major type :mimetype:`application`. *_data* contains the bytes for the " +"raw application data. Optional *_subtype* specifies the MIME subtype and " "defaults to :mimetype:`octet-stream`." msgstr "" msgid "" "Optional *_encoder* is a callable (i.e. function) which will perform the " "actual encoding of the data for transport. This callable takes one " -"argument, which is the :class:`MIMEApplication` instance. It should use :" -"meth:`~email.message.Message.get_payload` and :meth:`~email.message.Message." -"set_payload` to change the payload to encoded form. It should also add any :" -"mailheader:`Content-Transfer-Encoding` or other headers to the message " -"object as necessary. The default encoding is base64. See the :mod:`email." -"encoders` module for a list of the built-in encoders." +"argument, which is the :class:`MIMEApplication` instance. It should " +"use :meth:`~email.message.Message.get_payload` " +"and :meth:`~email.message.Message.set_payload` to change the payload to " +"encoded form. It should also add any :mailheader:`Content-Transfer-" +"Encoding` or other headers to the message object as necessary. The default " +"encoding is base64. See the :mod:`email.encoders` module for a list of the " +"built-in encoders." msgstr "" msgid "*_params* are passed straight through to the base class constructor." @@ -166,87 +171,89 @@ msgid "Module: :mod:`email.mime.audio`" msgstr "" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEAudio` class is used to create MIME message objects of major type :" -"mimetype:`audio`. *_audiodata* contains the bytes for the raw audio data. " -"If this data can be decoded as au, wav, aiff, or aifc, then the subtype will " -"be automatically included in the :mailheader:`Content-Type` header. " -"Otherwise you can explicitly specify the audio subtype via the *_subtype* " -"argument. If the minor type could not be guessed and *_subtype* was not " -"given, then :exc:`TypeError` is raised." +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEAudio` class is used to create MIME message objects of major " +"type :mimetype:`audio`. *_audiodata* contains the bytes for the raw audio " +"data. If this data can be decoded as au, wav, aiff, or aifc, then the " +"subtype will be automatically included in the :mailheader:`Content-Type` " +"header. Otherwise you can explicitly specify the audio subtype via the " +"*_subtype* argument. If the minor type could not be guessed and *_subtype* " +"was not given, then :exc:`TypeError` is raised." msgstr "" msgid "" "Optional *_encoder* is a callable (i.e. function) which will perform the " "actual encoding of the audio data for transport. This callable takes one " -"argument, which is the :class:`MIMEAudio` instance. It should use :meth:" -"`~email.message.Message.get_payload` and :meth:`~email.message.Message." -"set_payload` to change the payload to encoded form. It should also add any :" -"mailheader:`Content-Transfer-Encoding` or other headers to the message " -"object as necessary. The default encoding is base64. See the :mod:`email." -"encoders` module for a list of the built-in encoders." +"argument, which is the :class:`MIMEAudio` instance. It should " +"use :meth:`~email.message.Message.get_payload` " +"and :meth:`~email.message.Message.set_payload` to change the payload to " +"encoded form. It should also add any :mailheader:`Content-Transfer-" +"Encoding` or other headers to the message object as necessary. The default " +"encoding is base64. See the :mod:`email.encoders` module for a list of the " +"built-in encoders." msgstr "" msgid "Module: :mod:`email.mime.image`" msgstr "" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEImage` class is used to create MIME message objects of major type :" -"mimetype:`image`. *_imagedata* contains the bytes for the raw image data. " -"If this data type can be detected (jpeg, png, gif, tiff, rgb, pbm, pgm, ppm, " -"rast, xbm, bmp, webp, and exr attempted), then the subtype will be " +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEImage` class is used to create MIME message objects of major " +"type :mimetype:`image`. *_imagedata* contains the bytes for the raw image " +"data. If this data type can be detected (jpeg, png, gif, tiff, rgb, pbm, " +"pgm, ppm, rast, xbm, bmp, webp, and exr attempted), then the subtype will be " "automatically included in the :mailheader:`Content-Type` header. Otherwise " "you can explicitly specify the image subtype via the *_subtype* argument. If " -"the minor type could not be guessed and *_subtype* was not given, then :exc:" -"`TypeError` is raised." +"the minor type could not be guessed and *_subtype* was not given, " +"then :exc:`TypeError` is raised." msgstr "" msgid "" "Optional *_encoder* is a callable (i.e. function) which will perform the " "actual encoding of the image data for transport. This callable takes one " -"argument, which is the :class:`MIMEImage` instance. It should use :meth:" -"`~email.message.Message.get_payload` and :meth:`~email.message.Message." -"set_payload` to change the payload to encoded form. It should also add any :" -"mailheader:`Content-Transfer-Encoding` or other headers to the message " -"object as necessary. The default encoding is base64. See the :mod:`email." -"encoders` module for a list of the built-in encoders." +"argument, which is the :class:`MIMEImage` instance. It should " +"use :meth:`~email.message.Message.get_payload` " +"and :meth:`~email.message.Message.set_payload` to change the payload to " +"encoded form. It should also add any :mailheader:`Content-Transfer-" +"Encoding` or other headers to the message object as necessary. The default " +"encoding is base64. See the :mod:`email.encoders` module for a list of the " +"built-in encoders." msgstr "" msgid "" -"*_params* are passed straight through to the :class:`~email.mime.base." -"MIMEBase` constructor." +"*_params* are passed straight through to " +"the :class:`~email.mime.base.MIMEBase` constructor." msgstr "" msgid "Module: :mod:`email.mime.message`" msgstr "" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEMessage` class is used to create MIME objects of main type :mimetype:" -"`message`. *_msg* is used as the payload, and must be an instance of class :" -"class:`~email.message.Message` (or a subclass thereof), otherwise a :exc:" -"`TypeError` is raised." +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEMessage` class is used to create MIME objects of main " +"type :mimetype:`message`. *_msg* is used as the payload, and must be an " +"instance of class :class:`~email.message.Message` (or a subclass thereof), " +"otherwise a :exc:`TypeError` is raised." msgstr "" msgid "" -"Optional *_subtype* sets the subtype of the message; it defaults to :" -"mimetype:`rfc822`." +"Optional *_subtype* sets the subtype of the message; it defaults " +"to :mimetype:`rfc822`." msgstr "" msgid "Module: :mod:`email.mime.text`" msgstr "" msgid "" -"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" -"`MIMEText` class is used to create MIME objects of major type :mimetype:" -"`text`. *_text* is the string for the payload. *_subtype* is the minor type " -"and defaults to :mimetype:`plain`. *_charset* is the character set of the " -"text and is passed as an argument to the :class:`~email.mime.nonmultipart." -"MIMENonMultipart` constructor; it defaults to ``us-ascii`` if the string " -"contains only ``ascii`` code points, and ``utf-8`` otherwise. The " -"*_charset* parameter accepts either a string or a :class:`~email.charset." -"Charset` instance." +"A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, " +"the :class:`MIMEText` class is used to create MIME objects of major " +"type :mimetype:`text`. *_text* is the string for the payload. *_subtype* is " +"the minor type and defaults to :mimetype:`plain`. *_charset* is the " +"character set of the text and is passed as an argument to " +"the :class:`~email.mime.nonmultipart.MIMENonMultipart` constructor; it " +"defaults to ``us-ascii`` if the string contains only ``ascii`` code points, " +"and ``utf-8`` otherwise. The *_charset* parameter accepts either a string " +"or a :class:`~email.charset.Charset` instance." msgstr "" msgid "" diff --git a/library/email.parser.po b/library/email.parser.po index be98cfbb25..139786ec90 100644 --- a/library/email.parser.po +++ b/library/email.parser.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-01-24 14:16+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!email.parser`: Parsing email messages" msgstr "" msgid "**Source code:** :source:`Lib/email/parser.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/parser.py`" msgid "" "Message object structures can be created in one of two ways: they can be " @@ -45,33 +45,33 @@ msgid "" "root :class:`~email.message.EmailMessage` instance of the object structure. " "For simple, non-MIME messages the payload of this root object will likely be " "a string containing the text of the message. For MIME messages, the root " -"object will return ``True`` from its :meth:`~email.message.EmailMessage." -"is_multipart` method, and the subparts can be accessed via the payload " -"manipulation methods, such as :meth:`~email.message.EmailMessage.get_body`, :" -"meth:`~email.message.EmailMessage.iter_parts`, and :meth:`~email.message." -"EmailMessage.walk`." +"object will return ``True`` from " +"its :meth:`~email.message.EmailMessage.is_multipart` method, and the " +"subparts can be accessed via the payload manipulation methods, such " +"as :meth:`~email.message.EmailMessage.get_body`, :meth:`~email.message.EmailMessage.iter_parts`, " +"and :meth:`~email.message.EmailMessage.walk`." msgstr "" msgid "" -"There are actually two parser interfaces available for use, the :class:" -"`Parser` API and the incremental :class:`FeedParser` API. The :class:" -"`Parser` API is most useful if you have the entire text of the message in " -"memory, or if the entire message lives in a file on the file system. :class:" -"`FeedParser` is more appropriate when you are reading the message from a " -"stream which might block waiting for more input (such as reading an email " -"message from a socket). The :class:`FeedParser` can consume and parse the " -"message incrementally, and only returns the root object when you close the " -"parser." +"There are actually two parser interfaces available for use, " +"the :class:`Parser` API and the incremental :class:`FeedParser` API. " +"The :class:`Parser` API is most useful if you have the entire text of the " +"message in memory, or if the entire message lives in a file on the file " +"system. :class:`FeedParser` is more appropriate when you are reading the " +"message from a stream which might block waiting for more input (such as " +"reading an email message from a socket). The :class:`FeedParser` can " +"consume and parse the message incrementally, and only returns the root " +"object when you close the parser." msgstr "" msgid "" "Note that the parser can be extended in limited ways, and of course you can " "implement your own parser completely from scratch. All of the logic that " -"connects the :mod:`email` package's bundled parser and the :class:`~email." -"message.EmailMessage` class is embodied in the :class:`~email.policy.Policy` " -"class, so a custom parser can create message object trees any way it finds " -"necessary by implementing custom versions of the appropriate :class:`!" -"Policy` methods." +"connects the :mod:`email` package's bundled parser and " +"the :class:`~email.message.EmailMessage` class is embodied in " +"the :class:`~email.policy.Policy` class, so a custom parser can create " +"message object trees any way it finds necessary by implementing custom " +"versions of the appropriate :class:`!Policy` methods." msgstr "" msgid "FeedParser API" @@ -81,11 +81,11 @@ 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." +"message from a source that can block (such as a socket). " +"The :class:`BytesFeedParser` can of course be used to parse an email message " +"fully contained in a :term:`bytes-like object`, string, or file, but " +"the :class:`BytesParser` API may be more convenient for such use cases. The " +"semantics and results of the two parser APIs are identical." msgstr "" msgid "" @@ -94,10 +94,10 @@ msgid "" "to retrieve the root message object. The :class:`BytesFeedParser` is " "extremely accurate when parsing standards-compliant messages, and it does a " "very good job of parsing non-compliant messages, providing information about " -"how a message was deemed broken. It will populate a message object's :attr:" -"`~email.message.EmailMessage.defects` attribute with a list of any problems " -"it found in a message. See the :mod:`email.errors` module for the list of " -"defects that it can find." +"how a message was deemed broken. It will populate a message " +"object's :attr:`~email.message.EmailMessage.defects` attribute with a list " +"of any problems it found in a message. See the :mod:`email.errors` module " +"for the list of defects that it can find." msgstr "" msgid "Here is the API for the :class:`BytesFeedParser`:" @@ -105,20 +105,20 @@ msgstr "" msgid "" "Create a :class:`BytesFeedParser` instance. Optional *_factory* is a no-" -"argument callable; if not specified use the :attr:`~email.policy.Policy." -"message_factory` from the *policy*. Call *_factory* whenever a new message " -"object is needed." +"argument callable; if not specified use " +"the :attr:`~email.policy.Policy.message_factory` from the *policy*. Call " +"*_factory* whenever a new message object is needed." msgstr "" msgid "" "If *policy* is specified use the rules it specifies to update the " -"representation of the message. If *policy* is not set, use the :class:" -"`compat32 ` policy, which maintains backward " -"compatibility with the Python 3.2 version of the email package and provides :" -"class:`~email.message.Message` as the default factory. All other policies " -"provide :class:`~email.message.EmailMessage` as the default *_factory*. For " -"more information on what else *policy* controls, see the :mod:`~email." -"policy` documentation." +"representation of the message. If *policy* is not set, use " +"the :class:`compat32 ` policy, which maintains " +"backward compatibility with the Python 3.2 version of the email package and " +"provides :class:`~email.message.Message` as the default factory. All other " +"policies provide :class:`~email.message.EmailMessage` as the default " +"*_factory*. For more information on what else *policy* controls, see " +"the :mod:`~email.policy` documentation." msgstr "" msgid "" @@ -147,10 +147,10 @@ msgid "" msgstr "" msgid "" -"Works like :class:`BytesFeedParser` except that the input to the :meth:" -"`~BytesFeedParser.feed` method must be a string. This is of limited " -"utility, since the only way for such a message to be valid is for it to " -"contain only ASCII text or, if :attr:`~email.policy.Policy.utf8` is " +"Works like :class:`BytesFeedParser` except that the input to " +"the :meth:`~BytesFeedParser.feed` method must be a string. This is of " +"limited utility, since the only way for such a message to be valid is for it " +"to contain only ASCII text or, if :attr:`~email.policy.EmailPolicy.utf8` is " "``True``, no binary attachments." msgstr "" @@ -161,13 +161,13 @@ msgid "" "The :class:`BytesParser` class, imported from the :mod:`email.parser` " "module, provides an API that can be used to parse a message when the " "complete contents of the message are available in a :term:`bytes-like " -"object` or file. The :mod:`email.parser` module also provides :class:" -"`Parser` for parsing strings, and header-only parsers, :class:" -"`BytesHeaderParser` and :class:`HeaderParser`, which can be used if you're " -"only interested in the headers of the message. :class:`BytesHeaderParser` " -"and :class:`HeaderParser` can be much faster in these situations, since they " -"do not attempt to parse the message body, instead setting the payload to the " -"raw body." +"object` or file. The :mod:`email.parser` module also " +"provides :class:`Parser` for parsing strings, and header-only " +"parsers, :class:`BytesHeaderParser` and :class:`HeaderParser`, which can be " +"used if you're only interested in the headers of the " +"message. :class:`BytesHeaderParser` and :class:`HeaderParser` can be much " +"faster in these situations, since they do not attempt to parse the message " +"body, instead setting the payload to the raw body." msgstr "" msgid "" @@ -186,18 +186,19 @@ 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." +"bytes, and return the message object. *fp* must support both " +"the :meth:`~io.IOBase.readline` and the :meth:`~io.BufferedIOBase.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``)." +"if :attr:`~email.policy.EmailPolicy.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 "" @@ -208,9 +209,9 @@ msgstr "" msgid "" "Similar to the :meth:`parse` method, except it takes a :term:`bytes-like " -"object` instead of a file-like object. Calling this method on a :term:" -"`bytes-like object` is equivalent to wrapping *bytes* in a :class:`~io." -"BytesIO` instance first and calling :meth:`parse`." +"object` instead of a file-like object. Calling this method on " +"a :term:`bytes-like object` is equivalent to wrapping *bytes* in " +"a :class:`~io.BytesIO` instance first and calling :meth:`parse`." msgstr "" msgid "Optional *headersonly* is as with the :meth:`parse` method." @@ -236,15 +237,15 @@ msgid "" msgstr "" msgid "" -"Other than the text mode requirement, this method operates like :meth:" -"`BytesParser.parse`." +"Other than the text mode requirement, this method operates " +"like :meth:`BytesParser.parse`." msgstr "" msgid "" "Similar to the :meth:`parse` method, except it takes a string object instead " "of a file-like object. Calling this method on a string is equivalent to " -"wrapping *text* in a :class:`~io.StringIO` instance first and calling :meth:" -"`parse`." +"wrapping *text* in a :class:`~io.StringIO` instance first and " +"calling :meth:`parse`." msgstr "" msgid "" @@ -290,10 +291,8 @@ msgstr "" msgid "" ">>> import email\n" -">>> msg = email.message_from_bytes(myBytes) " -msgstr "" -">>> import email\n" ">>> msg = email.message_from_bytes(myBytes)" +msgstr "" msgid "Additional notes" msgstr "" @@ -304,34 +303,36 @@ msgstr "" msgid "" "Most non-\\ :mimetype:`multipart` type messages are parsed as a single " "message object with a string payload. These objects will return ``False`` " -"for :meth:`~email.message.EmailMessage.is_multipart`, and :meth:`~email." -"message.EmailMessage.iter_parts` will yield an empty list." +"for :meth:`~email.message.EmailMessage.is_multipart`, " +"and :meth:`~email.message.EmailMessage.iter_parts` will yield an empty list." msgstr "" msgid "" "All :mimetype:`multipart` type messages will be parsed as a container " "message object with a list of sub-message objects for their payload. The " -"outer container message will return ``True`` for :meth:`~email.message." -"EmailMessage.is_multipart`, and :meth:`~email.message.EmailMessage." -"iter_parts` will yield a list of subparts." +"outer container message will return ``True`` " +"for :meth:`~email.message.EmailMessage.is_multipart`, " +"and :meth:`~email.message.EmailMessage.iter_parts` will yield a list of " +"subparts." msgstr "" msgid "" -"Most messages with a content type of :mimetype:`message/\\*` (such as :" -"mimetype:`message/delivery-status` and :mimetype:`message/rfc822`) will also " -"be parsed as container object containing a list payload of length 1. Their :" -"meth:`~email.message.EmailMessage.is_multipart` method will return ``True``. " -"The single element yielded by :meth:`~email.message.EmailMessage.iter_parts` " -"will be a sub-message object." +"Most messages with a content type of :mimetype:`message/\\*` (such " +"as :mimetype:`message/delivery-status` and :mimetype:`message/rfc822`) will " +"also be parsed as container object containing a list payload of length 1. " +"Their :meth:`~email.message.EmailMessage.is_multipart` method will return " +"``True``. The single element yielded " +"by :meth:`~email.message.EmailMessage.iter_parts` will be a sub-message " +"object." msgstr "" msgid "" "Some non-standards-compliant messages may not be internally consistent about " -"their :mimetype:`multipart`\\ -edness. Such messages may have a :mailheader:" -"`Content-Type` header of type :mimetype:`multipart`, but their :meth:`~email." -"message.EmailMessage.is_multipart` method may return ``False``. If such " -"messages were parsed with the :class:`~email.parser.FeedParser`, they will " -"have an instance of the :class:`~email.errors." -"MultipartInvariantViolationDefect` class in their *defects* attribute list. " -"See :mod:`email.errors` for details." +"their :mimetype:`multipart`\\ -edness. Such messages may have " +"a :mailheader:`Content-Type` header of type :mimetype:`multipart`, but " +"their :meth:`~email.message.EmailMessage.is_multipart` method may return " +"``False``. If such messages were parsed with " +"the :class:`~email.parser.FeedParser`, they will have an instance of " +"the :class:`~email.errors.MultipartInvariantViolationDefect` class in their " +"*defects* attribute list. See :mod:`email.errors` for details." msgstr "" diff --git a/library/email.po b/library/email.po index 840a868319..90eb74e3b3 100644 --- a/library/email.po +++ b/library/email.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\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" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+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" @@ -23,20 +23,20 @@ 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 ":mod:`email` --- An email and MIME handling package" -msgstr "" +msgid ":mod:`!email` --- An email and MIME handling package" +msgstr ":mod:`!email` --- pakiet obsługi e-mail oraz MIME" msgid "**Source code:** :source:`Lib/email/__init__.py`" -msgstr "" +msgstr "**kod źródłowy:**. :source:`Lib/email/__init__.py`" msgid "" "The :mod:`email` package is a library for managing email messages. It is " -"specifically *not* designed to do any sending of email messages to SMTP (:" -"rfc:`2821`), NNTP, or other servers; those are functions of modules such as :" -"mod:`smtplib` and :mod:`nntplib`. The :mod:`email` package attempts to be " -"as RFC-compliant as possible, supporting :rfc:`5322` and :rfc:`6532`, as " -"well as such MIME-related RFCs as :rfc:`2045`, :rfc:`2046`, :rfc:`2047`, :" -"rfc:`2183`, and :rfc:`2231`." +"specifically *not* designed to do any sending of email messages to SMTP " +"(:rfc:`2821`), NNTP, or other servers; those are functions of modules such " +"as :mod:`smtplib`. The :mod:`email` package attempts to be as RFC-compliant " +"as possible, supporting :rfc:`5322` and :rfc:`6532`, as well as such MIME-" +"related RFCs as :rfc:`2045`, :rfc:`2046`, :rfc:`2047`, :rfc:`2183`, " +"and :rfc:`2231`." msgstr "" msgid "" @@ -44,6 +44,9 @@ msgid "" "components, plus a fourth component that controls the behavior of the other " "components." msgstr "" +"Ogólna struktura pakietu email może zostać podzielona na trzy główne " +"komponenty, plus czwarty komponent, który kontroluje zachowanie pozostałych " +"komponentów." msgid "" "The central component of the package is an \"object model\" that represents " @@ -53,39 +56,58 @@ msgid "" "to construct a new email, or to add or remove email subcomponents that " "themselves use the same object model interface. That is, following the " "nature of email messages and their MIME subcomponents, the email object " -"model is a tree structure of objects that all provide the :class:`~email." -"message.EmailMessage` API." -msgstr "" +"model is a tree structure of objects that all provide " +"the :class:`~email.message.EmailMessage` API." +msgstr "" +"Centralnym komponentem pakietu jest \"model obiektowy\", który reprezentuje " +"wiadomości e-mail. Aplikacja wchodzi w interakcję z pakietem głównie " +"poprzez model obiektowy interfejsu zdefiniowanego w pod-" +"module :mod:`~email.message` . Aplikacja może używać tego API do zadawania " +"pytań dotyczących istniejącego e-mail, do konstruowania nowego e-mail lub do " +"dodawania lub usuwania e-mail pod-komponentów, które same używają tego " +"samego interfejsu modelu obiektowego. Oznacza to, że zgodnie z naturą " +"wiadomości e-mail i ich podkomponentów MIME, model obiektowy e-mail jest " +"strukturą drzewiastą obiektów, które wszystkie " +"zapewniają :class:`~email.message.EmailMessage` API ." msgid "" "The other two major components of the package are the :mod:`~email.parser` " "and the :mod:`~email.generator`. The parser takes the serialized version of " -"an email message (a stream of bytes) and converts it into a tree of :class:" -"`~email.message.EmailMessage` objects. The generator takes an :class:" -"`~email.message.EmailMessage` and turns it back into a serialized byte " -"stream. (The parser and generator also handle streams of text characters, " -"but this usage is discouraged as it is too easy to end up with messages that " -"are not valid in one way or another.)" -msgstr "" +"an email message (a stream of bytes) and converts it into a tree " +"of :class:`~email.message.EmailMessage` objects. The generator takes " +"an :class:`~email.message.EmailMessage` and turns it back into a serialized " +"byte stream. (The parser and generator also handle streams of text " +"characters, but this usage is discouraged as it is too easy to end up with " +"messages that are not valid in one way or another.)" +msgstr "" +"Pozostałe dwa główne komponenty pakietu to :mod:`~email.parser` " +"i :mod:`~email.generator`. Analizator składni pobiera zserializowaną wersję " +"komunikatu e-mail (strumień bajtów) i przekształca go w drzewo " +"obiektów :class:`~email.message.EmailMessage`. Generator " +"pobiera :class:`~email.message.EmailMessage` i zamienia ją z powrotem w " +"serializowany strumień bajtów. (Analizator składni i generator obsługują " +"również strumienie znaków tekstowych, ale to użycie jest odradzane, ponieważ " +"zbyt łatwo jest skończyć z wiadomościami, które nie są poprawne w jeden ani " +"drugi sposób.)" msgid "" -"The control component is the :mod:`~email.policy` module. Every :class:" -"`~email.message.EmailMessage`, every :mod:`~email.generator`, and every :mod:" -"`~email.parser` has an associated :mod:`~email.policy` object that controls " -"its behavior. Usually an application only needs to specify the policy when " -"an :class:`~email.message.EmailMessage` is created, either by directly " -"instantiating an :class:`~email.message.EmailMessage` to create a new " -"email, or by parsing an input stream using a :mod:`~email.parser`. But the " -"policy can be changed when the message is serialized using a :mod:`~email." -"generator`. This allows, for example, a generic email message to be parsed " -"from disk, but to serialize it using standard SMTP settings when sending it " -"to an email server." +"The control component is the :mod:`~email.policy` module. " +"Every :class:`~email.message.EmailMessage`, every :mod:`~email.generator`, " +"and every :mod:`~email.parser` has an associated :mod:`~email.policy` object " +"that controls its behavior. Usually an application only needs to specify " +"the policy when an :class:`~email.message.EmailMessage` is created, either " +"by directly instantiating an :class:`~email.message.EmailMessage` to create " +"a new email, or by parsing an input stream using a :mod:`~email.parser`. " +"But the policy can be changed when the message is serialized using " +"a :mod:`~email.generator`. This allows, for example, a generic email message " +"to be parsed from disk, but to serialize it using standard SMTP settings " +"when sending it to an email server." msgstr "" msgid "" "The email package does its best to hide the details of the various governing " "RFCs from the application. Conceptually the application should be able to " -"treat the email message as a structured tree of unicode text and binary " +"treat the email message as a structured tree of Unicode text and binary " "attachments, without having to worry about how these are represented when " "serialized. In practice, however, it is often necessary to be aware of at " "least some of the rules governing MIME messages and their structure, " @@ -101,21 +123,21 @@ msgstr "" msgid "" "The following sections describe the functionality of the :mod:`email` " "package. We start with the :mod:`~email.message` object model, which is the " -"primary interface an application will use, and follow that with the :mod:" -"`~email.parser` and :mod:`~email.generator` components. Then we cover the :" -"mod:`~email.policy` controls, which completes the treatment of the main " -"components of the library." +"primary interface an application will use, and follow that with " +"the :mod:`~email.parser` and :mod:`~email.generator` components. Then we " +"cover the :mod:`~email.policy` controls, which completes the treatment of " +"the main components of the library." msgstr "" msgid "" "The next three sections cover the exceptions the package may raise and the " "defects (non-compliance with the RFCs) that the :mod:`~email.parser` may " -"detect. Then we cover the :mod:`~email.headerregistry` and the :mod:`~email." -"contentmanager` sub-components, which provide tools for doing more detailed " -"manipulation of headers and payloads, respectively. Both of these " -"components contain features relevant to consuming and producing non-trivial " -"messages, but also document their extensibility APIs, which will be of " -"interest to advanced applications." +"detect. Then we cover the :mod:`~email.headerregistry` and " +"the :mod:`~email.contentmanager` sub-components, which provide tools for " +"doing more detailed manipulation of headers and payloads, respectively. " +"Both of these components contain features relevant to consuming and " +"producing non-trivial messages, but also document their extensibility APIs, " +"which will be of interest to advanced applications." msgstr "" msgid "" @@ -124,20 +146,22 @@ msgid "" msgstr "" msgid "" -"The foregoing represent the modern (unicode friendly) API of the email " -"package. The remaining sections, starting with the :class:`~email.message." -"Message` class, cover the legacy :data:`~email.policy.compat32` API that " -"deals much more directly with the details of how email messages are " -"represented. The :data:`~email.policy.compat32` API does *not* hide the " -"details of the RFCs from the application, but for applications that need to " -"operate at that level, they can be useful tools. This documentation is also " -"relevant for applications that are still using the :mod:`~email.policy." -"compat32` API for backward compatibility reasons." +"The foregoing represent the modern (Unicode friendly) API of the email " +"package. The remaining sections, starting with " +"the :class:`~email.message.Message` class, cover the " +"legacy :data:`~email.policy.compat32` API that deals much more directly with " +"the details of how email messages are represented. " +"The :data:`~email.policy.compat32` API does *not* hide the details of the " +"RFCs from the application, but for applications that need to operate at that " +"level, they can be useful tools. This documentation is also relevant for " +"applications that are still using the :mod:`~email.policy.compat32` API for " +"backward compatibility reasons." msgstr "" msgid "" -"Docs reorganized and rewritten to promote the new :class:`~email.message." -"EmailMessage`/:class:`~email.policy.EmailPolicy` API." +"Docs reorganized and rewritten to promote the " +"new :class:`~email.message.EmailMessage`/:class:`~email.policy.EmailPolicy` " +"API." msgstr "" msgid "Contents of the :mod:`email` package documentation:" @@ -164,12 +188,6 @@ msgstr "" msgid "IMAP (Internet Message Access Protocol) client" msgstr "" -msgid "Module :mod:`nntplib`" -msgstr "" - -msgid "NNTP (Net News Transport Protocol) client" -msgstr "" - msgid "Module :mod:`mailbox`" msgstr "" @@ -177,9 +195,3 @@ msgid "" "Tools for creating, reading, and managing collections of messages on disk " "using a variety standard formats." msgstr "" - -msgid "Module :mod:`smtpd`" -msgstr "" - -msgid "SMTP server framework (primarily useful for testing)" -msgstr "" diff --git a/library/email.policy.po b/library/email.policy.po index e155763012..4ba1a623db 100644 --- a/library/email.policy.po +++ b/library/email.policy.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!email.policy`: Policy Objects" msgstr "" msgid "**Source code:** :source:`Lib/email/policy.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/policy.py`" msgid "" "The :mod:`email` package's prime focus is the handling of email messages as " @@ -51,37 +50,38 @@ msgstr "" msgid "" "A :class:`Policy` object encapsulates a set of attributes and methods that " -"control the behavior of various components of the email package during use. :" -"class:`Policy` instances can be passed to various classes and methods in the " -"email package to alter the default behavior. The settable values and their " -"defaults are described below." +"control the behavior of various components of the email package during " +"use. :class:`Policy` instances can be passed to various classes and methods " +"in the email package to alter the default behavior. The settable values and " +"their defaults are described below." msgstr "" msgid "" "There is a default policy used by all classes in the email package. For all " "of the :mod:`~email.parser` classes and the related convenience functions, " -"and for the :class:`~email.message.Message` class, this is the :class:" -"`Compat32` policy, via its corresponding pre-defined instance :const:" -"`compat32`. This policy provides for complete backward compatibility (in " -"some cases, including bug compatibility) with the pre-Python3.3 version of " -"the email package." +"and for the :class:`~email.message.Message` class, this is " +"the :class:`Compat32` policy, via its corresponding pre-defined " +"instance :const:`compat32`. This policy provides for complete backward " +"compatibility (in some cases, including bug compatibility) with the pre-" +"Python3.3 version of the email package." msgstr "" msgid "" -"This default value for the *policy* keyword to :class:`~email.message." -"EmailMessage` is the :class:`EmailPolicy` policy, via its pre-defined " -"instance :data:`~default`." +"This default value for the *policy* keyword " +"to :class:`~email.message.EmailMessage` is the :class:`EmailPolicy` policy, " +"via its pre-defined instance :data:`~default`." msgstr "" msgid "" -"When a :class:`~email.message.Message` or :class:`~email.message." -"EmailMessage` object is created, it acquires a policy. If the message is " -"created by a :mod:`~email.parser`, a policy passed to the parser will be the " -"policy used by the message it creates. If the message is created by the " -"program, then the policy can be specified when it is created. When a " -"message is passed to a :mod:`~email.generator`, the generator uses the " -"policy from the message by default, but you can also pass a specific policy " -"to the generator that will override the one stored on the message object." +"When a :class:`~email.message.Message` " +"or :class:`~email.message.EmailMessage` object is created, it acquires a " +"policy. If the message is created by a :mod:`~email.parser`, a policy " +"passed to the parser will be the policy used by the message it creates. If " +"the message is created by the program, then the policy can be specified when " +"it is created. When a message is passed to a :mod:`~email.generator`, the " +"generator uses the policy from the message by default, but you can also pass " +"a specific policy to the generator that will override the one stored on the " +"message object." msgstr "" msgid "" @@ -105,8 +105,8 @@ msgstr "" msgid "" ":class:`Policy` instances are immutable, but they can be cloned, accepting " -"the same keyword arguments as the class constructor and returning a new :" -"class:`Policy` instance that is a copy of the original but with the " +"the same keyword arguments as the class constructor and returning a " +"new :class:`Policy` instance that is a copy of the original but with the " "specified attributes values changed." msgstr "" @@ -249,9 +249,9 @@ msgid "" msgstr "" msgid "" -"If :const:`True`, any defects encountered will be raised as errors. If :" -"const:`False` (the default), defects will be passed to the :meth:" -"`register_defect` method." +"If :const:`True`, any defects encountered will be raised as errors. " +"If :const:`False` (the default), defects will be passed to " +"the :meth:`register_defect` method." msgstr "" msgid "" @@ -262,22 +262,22 @@ msgstr "" msgid "" "A factory function for constructing a new empty message object. Used by the " -"parser when building messages. Defaults to ``None``, in which case :class:" -"`~email.message.Message` is used." +"parser when building messages. Defaults to ``None``, in which " +"case :class:`~email.message.Message` is used." msgstr "" msgid "" -"If ``True`` (the default), the generator will raise :exc:`~email.errors." -"HeaderWriteError` instead of writing a header that is improperly folded or " -"delimited, such that it would be parsed as multiple headers or joined with " -"adjacent data. Such headers can be generated by custom header classes or " -"bugs in the ``email`` module." +"If ``True`` (the default), the generator will " +"raise :exc:`~email.errors.HeaderWriteError` instead of writing a header that " +"is improperly folded or delimited, such that it would be parsed as multiple " +"headers or joined with adjacent data. Such headers can be generated by " +"custom header classes or bugs in the ``email`` module." msgstr "" msgid "" -"As it's a security feature, this defaults to ``True`` even in the :class:" -"`~email.policy.Compat32` policy. For backwards compatible, but unsafe, " -"behavior, it must be set to ``False`` explicitly." +"As it's a security feature, this defaults to ``True`` even in " +"the :class:`~email.policy.Compat32` policy. For backwards compatible, but " +"unsafe, behavior, it must be set to ``False`` explicitly." msgstr "" msgid "" @@ -326,10 +326,11 @@ msgid "Return the maximum allowed number of headers named *name*." msgstr "" msgid "" -"Called when a header is added to an :class:`~email.message.EmailMessage` or :" -"class:`~email.message.Message` object. If the returned value is not ``0`` " -"or ``None``, and there are already a number of headers with the name *name* " -"greater than or equal to the value returned, a :exc:`ValueError` is raised." +"Called when a header is added to an :class:`~email.message.EmailMessage` " +"or :class:`~email.message.Message` object. If the returned value is not " +"``0`` or ``None``, and there are already a number of headers with the name " +"*name* greater than or equal to the value returned, a :exc:`ValueError` is " +"raised." msgstr "" msgid "" @@ -400,9 +401,9 @@ msgid "" "The email package calls this method with the *name* and *value* currently " "stored in the ``Message`` for a given header. The method should return a " "string that represents that header \"folded\" correctly (according to the " -"policy settings) by composing the *name* with the *value* and inserting :" -"attr:`linesep` characters at the appropriate places. See :rfc:`5322` for a " -"discussion of the rules for folding email headers." +"policy settings) by composing the *name* with the *value* and " +"inserting :attr:`linesep` characters at the appropriate places. " +"See :rfc:`5322` for a discussion of the rules for folding email headers." msgstr "" msgid "" @@ -444,7 +445,7 @@ msgid "" msgstr "" msgid "[1]_" -msgstr "" +msgstr "[1]_" msgid "" "If ``False``, follow :rfc:`5322`, supporting non-ASCII characters in headers " @@ -454,9 +455,9 @@ msgid "" msgstr "" msgid "" -"If the value for a header in the ``Message`` object originated from a :mod:" -"`~email.parser` (as opposed to being set by a program), this attribute " -"indicates whether or not a generator should refold that value when " +"If the value for a header in the ``Message`` object originated from " +"a :mod:`~email.parser` (as opposed to being set by a program), this " +"attribute indicates whether or not a generator should refold that value when " "transforming the message back into serialized form. The possible values are:" msgstr "" @@ -494,13 +495,14 @@ msgid "" msgstr "" msgid "" -"An object with at least two methods: get_content and set_content. When the :" -"meth:`~email.message.EmailMessage.get_content` or :meth:`~email.message." -"EmailMessage.set_content` method of an :class:`~email.message.EmailMessage` " -"object is called, it calls the corresponding method of this object, passing " -"it the message object as its first argument, and any arguments or keywords " -"that were passed to it as additional arguments. By default " -"``content_manager`` is set to :data:`~email.contentmanager.raw_data_manager`." +"An object with at least two methods: get_content and set_content. When " +"the :meth:`~email.message.EmailMessage.get_content` " +"or :meth:`~email.message.EmailMessage.set_content` method of " +"an :class:`~email.message.EmailMessage` object is called, it calls the " +"corresponding method of this object, passing it the message object as its " +"first argument, and any arguments or keywords that were passed to it as " +"additional arguments. By default ``content_manager`` is set " +"to :data:`~email.contentmanager.raw_data_manager`." msgstr "" msgid "" @@ -533,7 +535,7 @@ msgid "" "If the value has a ``name`` attribute, it is returned to unmodified. " "Otherwise the *name*, and the *value* with any CR or LF characters removed, " "are passed to the ``header_factory``, and the resulting header object is " -"returned. Any surrogateescaped bytes get turned into the unicode unknown-" +"returned. Any surrogateescaped bytes get turned into the Unicode unknown-" "character glyph." msgstr "" @@ -591,8 +593,8 @@ msgid "" "The same as ``SMTP`` except that :attr:`~EmailPolicy.utf8` is ``True``. " "Useful for serializing messages to a message store without using encoded " "words in the headers. Should only be used for SMTP transmission if the " -"sender or recipient addresses have non-ASCII characters (the :meth:`smtplib." -"SMTP.send_message` method handles this automatically)." +"sender or recipient addresses have non-ASCII characters " +"(the :meth:`smtplib.SMTP.send_message` method handles this automatically)." msgstr "" msgid "" @@ -632,30 +634,31 @@ msgid "" msgstr "" msgid "" -"From the application view, this means that any header obtained through the :" -"class:`~email.message.EmailMessage` is a header object with extra " -"attributes, whose string value is the fully decoded unicode value of the " -"header. Likewise, a header may be assigned a new value, or a new header " -"created, using a unicode string, and the policy will take care of converting " -"the unicode string into the correct RFC encoded form." +"From the application view, this means that any header obtained through " +"the :class:`~email.message.EmailMessage` is a header object with extra " +"attributes, whose string value is the fully decoded value of the header. " +"Likewise, a header may be assigned a new value, or a new header created, " +"using a string, and the policy will take care of converting the string into " +"the correct RFC encoded form." msgstr "" msgid "" -"The header objects and their attributes are described in :mod:`~email." -"headerregistry`." +"The header objects and their attributes are described " +"in :mod:`~email.headerregistry`." msgstr "" msgid "" "This concrete :class:`Policy` is the backward compatibility policy. It " -"replicates the behavior of the email package in Python 3.2. The :mod:" -"`~email.policy` module also defines an instance of this class, :const:" -"`compat32`, that is used as the default policy. Thus the default behavior " -"of the email package is to maintain compatibility with Python 3.2." +"replicates the behavior of the email package in Python 3.2. " +"The :mod:`~email.policy` module also defines an instance of this " +"class, :const:`compat32`, that is used as the default policy. Thus the " +"default behavior of the email package is to maintain compatibility with " +"Python 3.2." msgstr "" msgid "" -"The following attributes have values that are different from the :class:" -"`Policy` default:" +"The following attributes have values that are different from " +"the :class:`Policy` default:" msgstr "" msgid "The default is ``True``." @@ -665,9 +668,9 @@ msgid "The name and value are returned unmodified." msgstr "" msgid "" -"If the value contains binary data, it is converted into a :class:`~email." -"header.Header` object using the ``unknown-8bit`` charset. Otherwise it is " -"returned unmodified." +"If the value contains binary data, it is converted into " +"a :class:`~email.header.Header` object using the ``unknown-8bit`` charset. " +"Otherwise it is returned unmodified." msgstr "" msgid "" @@ -691,6 +694,12 @@ msgid "" "behavior of the email package in Python 3.2." msgstr "" +msgid "" +"The :const:`compat32` policy should not be used as a policy " +"for :class:`~email.message.EmailMessage` objects, and should only be used to " +"serialize messages that were created using the :const:`compat32` policy." +msgstr "" + msgid "Footnotes" msgstr "Przypisy" diff --git a/library/email.utils.po b/library/email.utils.po index e3ce0583a4..6d2dc35b0e 100644 --- a/library/email.utils.po +++ b/library/email.utils.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!email.utils`: Miscellaneous utilities" msgstr "" msgid "**Source code:** :source:`Lib/email/utils.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/email/utils.py`" msgid "" "There are a couple of useful utilities provided in the :mod:`email.utils` " @@ -36,24 +36,24 @@ 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. The *isdst* parameter is " -"ignored." +"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. " +"The *isdst* parameter is ignored." msgstr "" msgid "The *isdst* parameter." msgstr "" msgid "" -"Returns a string suitable for an :rfc:`2822`\\ -compliant :mailheader:" -"`Message-ID` header. Optional *idstring* if given, is a string used to " -"strengthen the uniqueness of the message id. Optional *domain* if given " -"provides the portion of the msgid after the '@'. The default is the local " -"hostname. It is not normally necessary to override this default, but may be " -"useful certain cases, such as a constructing distributed system that uses a " -"consistent domain name across multiple hosts." +"Returns a string suitable for an :rfc:`2822`\\ " +"-compliant :mailheader:`Message-ID` header. Optional *idstring* if given, " +"is a string used to strengthen the uniqueness of the message id. Optional " +"*domain* if given provides the portion of the msgid after the '@'. The " +"default is the local hostname. It is 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." @@ -93,16 +93,16 @@ 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." +"``(realname, email_address)`` and returns the string value suitable for " +"a :mailheader:`To` or :mailheader:`Cc` header. If the first element of " +"*pair* is false, then the second element is returned unmodified." msgstr "" msgid "" "Optional *charset* is the character set that will be used in the :rfc:`2047` " "encoding of the ``realname`` if the ``realname`` contains non-ASCII " -"characters. Can be an instance of :class:`str` or a :class:`~email.charset." -"Charset`. Defaults to ``utf-8``." +"characters. Can be an instance of :class:`str` or " +"a :class:`~email.charset.Charset`. Defaults to ``utf-8``." msgstr "" msgid "Added the *charset* option." @@ -130,10 +130,10 @@ 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 " +"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 "" @@ -148,15 +148,15 @@ msgid "" msgstr "" msgid "" -"The inverse of :func:`format_datetime`. Performs the same function as :func:" -"`parsedate`, but on success returns a :mod:`~datetime.datetime`; otherwise " -"``ValueError`` is raised if *date* contains an invalid value such as an hour " -"greater than 23 or a timezone offset not between -24 and 24 hours. If the " -"input date has a timezone of ``-0000``, the ``datetime`` will be a naive " -"``datetime``, and if the date is conforming to the RFCs it will represent a " -"time in UTC but with no indication of the actual source timezone of the " -"message the date comes from. If the input date has any other valid timezone " -"offset, the ``datetime`` will be an aware ``datetime`` with the " +"The inverse of :func:`format_datetime`. Performs the same function " +"as :func:`parsedate`, but on success returns a :mod:`~datetime.datetime`; " +"otherwise ``ValueError`` is raised if *date* contains an invalid value such " +"as an hour greater than 23 or a timezone offset not between -24 and 24 " +"hours. If the input date has a timezone of ``-0000``, the ``datetime`` will " +"be a naive ``datetime``, and if the date is conforming to the RFCs it will " +"represent a time in UTC but with no indication of the actual source timezone " +"of the message the date comes from. If the input date has any other valid " +"timezone offset, the ``datetime`` will be an aware ``datetime`` with the " "corresponding a :class:`~datetime.timezone` :class:`~datetime.tzinfo`." msgstr "" @@ -173,9 +173,9 @@ msgid "Fri, 09 Nov 2001 01:08:47 -0000" msgstr "" msgid "" -"Optional *timeval* if given is a floating-point time value as accepted by :" -"func:`time.gmtime` and :func:`time.localtime`, otherwise the current time is " -"used." +"Optional *timeval* if given is a floating-point time value as accepted " +"by :func:`time.gmtime` and :func:`time.localtime`, otherwise the current " +"time is used." msgstr "" msgid "" @@ -215,14 +215,14 @@ msgid "" msgstr "" msgid "" -"When a header parameter is encoded in :rfc:`2231` format, :meth:`Message." -"get_param ` may return a 3-tuple containing " -"the character set, language, and value. :func:`collapse_rfc2231_value` " -"turns this into a unicode string. Optional *errors* is passed to the " -"*errors* argument of :class:`str`'s :func:`~str.encode` method; it defaults " -"to ``'replace'``. Optional *fallback_charset* specifies the character set " -"to use if the one in the :rfc:`2231` header is not known by Python; it " -"defaults to ``'us-ascii'``." +"When a header parameter is encoded in :rfc:`2231` " +"format, :meth:`Message.get_param ` may " +"return a 3-tuple containing the character set, language, and " +"value. :func:`collapse_rfc2231_value` turns this into a string. Optional " +"*errors* is passed to the *errors* argument " +"of :class:`str`'s :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 "" diff --git a/library/ensurepip.po b/library/ensurepip.po index 531f99b1fa..39b999d90e 100644 --- a/library/ensurepip.po +++ b/library/ensurepip.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,7 +28,7 @@ msgid ":mod:`!ensurepip` --- Bootstrapping the ``pip`` installer" msgstr "" msgid "**Source code:** :source:`Lib/ensurepip`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/ensurepip`" msgid "" "The :mod:`ensurepip` package provides support for bootstrapping the ``pip`` " @@ -73,7 +73,7 @@ msgid "" "availability>` or :ref:`WebAssembly platforms `." msgstr "" -msgid "Command line interface" +msgid "Command-line interface" msgstr "Interfejs wiersza poleceń" msgid "" @@ -193,8 +193,8 @@ msgid "" msgstr "" msgid "" -"The bootstrapping process has side effects on both ``sys.path`` and ``os." -"environ``. Invoking the command line interface in a subprocess instead " +"The bootstrapping process has side effects on both ``sys.path`` and " +"``os.environ``. Invoking the command line interface in a subprocess instead " "allows these side effects to be avoided." msgstr "" diff --git a/library/enum.po b/library/enum.po index b7c6254acf..28674be7bc 100644 --- a/library/enum.po +++ b/library/enum.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -101,7 +100,7 @@ msgid "" "is ``RED``, the value of :attr:`!Color.BLUE` is ``3``, etc.)" msgstr "" -msgid "Module Contents" +msgid "Module contents" msgstr "" msgid ":class:`EnumType`" @@ -120,16 +119,16 @@ msgid ":class:`IntEnum`" msgstr ":class:`IntEnum`" msgid "" -"Base class for creating enumerated constants that are also subclasses of :" -"class:`int`. (`Notes`_)" +"Base class for creating enumerated constants that are also subclasses " +"of :class:`int`. (`Notes`_)" msgstr "" msgid ":class:`StrEnum`" msgstr ":class:`StrEnum`" msgid "" -"Base class for creating enumerated constants that are also subclasses of :" -"class:`str`. (`Notes`_)" +"Base class for creating enumerated constants that are also subclasses " +"of :class:`str`. (`Notes`_)" msgstr "" msgid ":class:`Flag`" @@ -145,8 +144,9 @@ msgstr ":class:`IntFlag`" msgid "" "Base class for creating enumerated constants that can be combined using the " -"bitwise operators without losing their :class:`IntFlag` membership. :class:" -"`IntFlag` members are also subclasses of :class:`int`. (`Notes`_)" +"bitwise operators without losing their :class:`IntFlag` " +"membership. :class:`IntFlag` members are also subclasses of :class:`int`. " +"(`Notes`_)" msgstr "" msgid ":class:`ReprEnum`" @@ -176,7 +176,7 @@ msgid "" msgstr "" msgid ":class:`EnumDict`" -msgstr "" +msgstr ":class:`EnumDict`" msgid "A subclass of :class:`dict` for use when subclassing :class:`EnumType`." msgstr "" @@ -185,13 +185,13 @@ msgid ":class:`auto`" msgstr ":class:`auto`" msgid "" -"Instances are replaced with an appropriate value for Enum members. :class:" -"`StrEnum` defaults to the lower-cased version of the member name, while " -"other Enums default to 1 and increase from there." +"Instances are replaced with an appropriate value for Enum " +"members. :class:`StrEnum` defaults to the lower-cased version of the member " +"name, while other Enums default to 1 and increase from there." msgstr "" -msgid ":func:`~enum.property`" -msgstr ":func:`~enum.property`" +msgid ":deco:`~enum.property`" +msgstr "" msgid "" "Allows :class:`Enum` members to have attributes without conflicting with " @@ -199,35 +199,35 @@ msgid "" "way." msgstr "" -msgid ":func:`unique`" -msgstr ":func:`unique`" +msgid ":deco:`unique`" +msgstr "" msgid "" "Enum class decorator that ensures only one name is bound to any one value." msgstr "" -msgid ":func:`verify`" -msgstr ":func:`verify`" +msgid ":deco:`verify`" +msgstr "" msgid "" "Enum class decorator that checks user-selectable constraints on an " "enumeration." msgstr "" -msgid ":func:`member`" -msgstr ":func:`member`" +msgid ":deco:`member`" +msgstr "" msgid "Make ``obj`` a member. Can be used as a decorator." msgstr "" -msgid ":func:`nonmember`" -msgstr ":func:`nonmember`" +msgid ":deco:`nonmember`" +msgstr "" msgid "Do not make ``obj`` a member. Can be used as a decorator." msgstr "" -msgid ":func:`global_enum`" -msgstr ":func:`global_enum`" +msgid ":deco:`global_enum`" +msgstr "" msgid "" "Modify the :class:`str() ` and :func:`repr` of an enum to show its " @@ -241,6 +241,15 @@ msgstr ":func:`show_flag_values`" msgid "Return a list of all power-of-two integers contained in a flag." msgstr "" +msgid ":func:`enum.bin`" +msgstr "" + +msgid "" +"Like built-in :func:`bin`, except negative values are represented in two's " +"complement, and the leading bit always indicates sign (``0`` implies " +"positive, ``1`` implies negative)." +msgstr "" + msgid "``Flag``, ``IntFlag``, ``auto``" msgstr "" @@ -252,8 +261,8 @@ msgstr "" msgid "``EnumDict``" msgstr "``EnumDict``" -msgid "Data Types" -msgstr "Typy danych" +msgid "Data types" +msgstr "" msgid "" "*EnumType* is the :term:`metaclass` for *enum* enumerations. It is possible " @@ -262,10 +271,15 @@ msgid "" msgstr "" msgid "" -"``EnumType`` is responsible for setting the correct :meth:`!__repr__`, :meth:" -"`!__str__`, :meth:`!__format__`, and :meth:`!__reduce__` methods on the " -"final *enum*, as well as creating the enum members, properly handling " -"duplicates, providing iteration over the enum class, etc." +"``EnumType`` is responsible for setting the correct :meth:`!" +"__repr__`, :meth:`!__str__`, :meth:`!__format__`, and :meth:`!__reduce__` " +"methods on the final *enum*, as well as creating the enum members, properly " +"handling duplicates, providing iteration over the enum class, etc." +msgstr "" + +msgid "" +"Before 3.11 ``EnumType`` was called ``EnumMeta``, which is still available " +"as an alias." msgstr "" msgid "This method is called in two different ways:" @@ -360,8 +374,8 @@ msgid "" msgstr "" msgid "" -"Returns the Enum member in *cls* matching *name*, or raises a :exc:" -"`KeyError`::" +"Returns the Enum member in *cls* matching *name*, or raises " +"a :exc:`KeyError`::" msgstr "" msgid "" @@ -381,7 +395,7 @@ msgstr "" ">>> list(Color)\n" "[, , ]" -msgid "Returns the number of member in *cls*::" +msgid "Returns the number of members in *cls*::" msgstr "" msgid "" @@ -404,21 +418,6 @@ msgstr "" ">>> list(reversed(Color))\n" "[, , ]" -msgid "" -"Adds a new name as an alias to an existing member. Raises a :exc:" -"`NameError` if the name is already assigned to a different member." -msgstr "" - -msgid "" -"Adds a new value as an alias to an existing member. Raises a :exc:" -"`ValueError` if the value is already linked with a different member." -msgstr "" - -msgid "" -"Before 3.11 ``EnumType`` was called ``EnumMeta``, which is still available " -"as an alias." -msgstr "" - msgid "*Enum* is the base class for all *enum* enumerations." msgstr "" @@ -469,6 +468,31 @@ msgid "" "during class creation)." msgstr "" +msgid "" +"The :attr:`~Enum._order_` attribute can be provided to help keep Python 2 / " +"Python 3 code in sync. It will be checked against the actual order of the " +"enumeration and raise an error if the two do not match::" +msgstr "" + +msgid "" +">>> class Color(Enum):\n" +"... _order_ = 'RED GREEN BLUE'\n" +"... RED = 1\n" +"... BLUE = 3\n" +"... GREEN = 2\n" +"...\n" +"Traceback (most recent call last):\n" +"...\n" +"TypeError: member order does not match _order_:\n" +" ['RED', 'BLUE', 'GREEN']\n" +" ['RED', 'GREEN', 'BLUE']" +msgstr "" + +msgid "" +"In Python 2 code the :attr:`~Enum._order_` attribute is necessary as " +"definition order is lost before it can be recorded." +msgstr "" + msgid "" "``_ignore_`` is only used during creation and is removed from the " "enumeration once creation is complete." @@ -476,8 +500,8 @@ msgstr "" msgid "" "``_ignore_`` is a list of names that will not become members, and whose " -"names will also be removed from the completed enumeration. See :ref:" -"`TimePeriod ` for an example." +"names will also be removed from the completed enumeration. " +"See :ref:`TimePeriod ` for an example." msgstr "" msgid "" @@ -486,7 +510,8 @@ msgid "" msgstr "" msgid "" -">>> from datetime import date\n" +">>> from enum import Enum\n" +">>> import datetime as dt\n" ">>> class Weekday(Enum):\n" "... MONDAY = 1\n" "... TUESDAY = 2\n" @@ -497,7 +522,7 @@ msgid "" "... SUNDAY = 7\n" "... @classmethod\n" "... def today(cls):\n" -"... print('today is %s' % cls(date.today().isoweekday()).name)\n" +"... print(f'today is {cls(dt.date.today().isoweekday()).name}')\n" "...\n" ">>> dir(Weekday.SATURDAY)\n" "['__class__', '__doc__', '__eq__', '__hash__', '__module__', 'name', " @@ -526,12 +551,25 @@ msgid "A list of the previous values." msgstr "" msgid "" -"A *staticmethod* that is used to determine the next value returned by :class:" -"`auto`::" +"A *staticmethod* that is used to determine the next value returned " +"by :class:`auto`." msgstr "" msgid "" -">>> from enum import auto\n" +"For standard :class:`Enum` classes the next value chosen is the highest " +"value seen incremented by one." +msgstr "" + +msgid "" +"For :class:`Flag` classes the next value chosen will be the next highest " +"power-of-two." +msgstr "" + +msgid "This method may be overridden, e.g.::" +msgstr "" + +msgid "" +">>> from enum import auto, Enum\n" ">>> class PowersOfThree(Enum):\n" "... @staticmethod\n" "... def _generate_next_value_(name, start, count, last_values):\n" @@ -543,6 +581,10 @@ msgid "" "9" msgstr "" +msgid "" +"Prior versions would use the last seen value instead of the highest value." +msgstr "" + msgid "" "By default, does nothing. If multiple values are given in the member " "assignment, those values become separate arguments to ``__init__``; e.g." @@ -564,7 +606,7 @@ msgid "" msgstr "" msgid "" -">>> from enum import StrEnum\n" +">>> from enum import auto, StrEnum\n" ">>> class Build(StrEnum):\n" "... DEBUG = auto()\n" "... OPTIMIZED = auto()\n" @@ -603,6 +645,7 @@ msgid "" msgstr "" msgid "" +">>> from enum import auto, Enum\n" ">>> class OtherStyle(Enum):\n" "... ALTERNATE = auto()\n" "... OTHER = auto()\n" @@ -611,8 +654,8 @@ msgid "" "... cls_name = self.__class__.__name__\n" "... return f'{cls_name}.{self.name}'\n" "...\n" -">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), f\"{OtherStyle." -"ALTERNATE}\"\n" +">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), " +"f\"{OtherStyle.ALTERNATE}\"\n" "(OtherStyle.ALTERNATE, 'OtherStyle.ALTERNATE', 'OtherStyle.ALTERNATE')" msgstr "" @@ -622,6 +665,7 @@ msgid "" msgstr "" msgid "" +">>> from enum import auto, Enum\n" ">>> class OtherStyle(Enum):\n" "... ALTERNATE = auto()\n" "... OTHER = auto()\n" @@ -629,8 +673,8 @@ msgid "" "... def __str__(self):\n" "... return f'{self.name}'\n" "...\n" -">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), f\"{OtherStyle." -"ALTERNATE}\"\n" +">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), " +"f\"{OtherStyle.ALTERNATE}\"\n" "(, 'ALTERNATE', 'ALTERNATE')" msgstr "" @@ -640,6 +684,7 @@ msgid "" msgstr "" msgid "" +">>> from enum import auto, Enum\n" ">>> class OtherStyle(Enum):\n" "... ALTERNATE = auto()\n" "... OTHER = auto()\n" @@ -647,8 +692,8 @@ msgid "" "... def __format__(self, spec):\n" "... return f'{self.name}'\n" "...\n" -">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), f\"{OtherStyle." -"ALTERNATE}\"\n" +">>> OtherStyle.ALTERNATE, str(OtherStyle.ALTERNATE), " +"f\"{OtherStyle.ALTERNATE}\"\n" "(, 'OtherStyle.ALTERNATE', 'ALTERNATE')" msgstr "" @@ -660,6 +705,37 @@ msgstr "" msgid "Added :ref:`enum-dataclass-support`" msgstr "" +msgid "Adds a new name as an alias to an existing member::" +msgstr "" + +msgid "" +">>> Color.RED._add_alias_(\"ERROR\")\n" +">>> Color.ERROR\n" +"" +msgstr "" + +msgid "" +"Raises a :exc:`NameError` if the name is already assigned to a different " +"member." +msgstr "" + +msgid "Adds a new value as an alias to an existing member::" +msgstr "" + +msgid "" +">>> Color.RED._add_value_alias_(42)\n" +">>> Color(42)\n" +"" +msgstr "" + +msgid "" +"Raises a :exc:`ValueError` if the value is already linked with a different " +"member." +msgstr "" + +msgid "See :ref:`multi-value-enum` for an example." +msgstr "" + msgid "" "*IntEnum* is the same as :class:`Enum`, but its members are also integers " "and can be used anywhere that an integer can be used. If any integer " @@ -679,17 +755,17 @@ msgid "" msgstr "" msgid "" -"``StrEnum`` is the same as :class:`Enum`, but its members are also strings " -"and can be used in most of the same places that a string can be used. The " -"result of any string operation performed on or with a *StrEnum* member is " -"not part of the enumeration." +"*StrEnum* is the same as :class:`Enum`, but its members are also strings and " +"can be used in most of the same places that a string can be used. The result " +"of any string operation performed on or with a *StrEnum* member is not part " +"of the enumeration." msgstr "" msgid "" "There are places in the stdlib that check for an exact :class:`str` instead " "of a :class:`str` subclass (i.e. ``type(unknown) == str`` instead of " "``isinstance(unknown, str)``), and in those locations you will need to use " -"``str(StrEnum.member)``." +"``str(MyStrEnum.MY_MEMBER)``." msgstr "" msgid "" @@ -872,8 +948,8 @@ msgid "the result is a valid *IntFlag*: an *IntFlag* is returned" msgstr "" msgid "" -"the result is not a valid *IntFlag*: the result depends on the :class:" -"`FlagBoundary` setting" +"the result is not a valid *IntFlag*: the result depends on " +"the :class:`FlagBoundary` setting" msgstr "" msgid "The :func:`repr` of unnamed zero-valued flags has changed. It is now:" @@ -908,9 +984,9 @@ msgid ":meth:`!str.__str__` for :class:`StrEnum`" msgstr "" msgid "" -"Inherit from :class:`!ReprEnum` to keep the :class:`str() ` / :func:" -"`format` of the mixed-in data type instead of using the :class:`Enum`-" -"default :meth:`str() `." +"Inherit from :class:`!ReprEnum` to keep the :class:`str() " +"` / :func:`format` of the mixed-in data type instead of using " +"the :class:`Enum`-default :meth:`str() `." msgstr "" msgid "" @@ -976,8 +1052,8 @@ msgid "" msgstr "" msgid "" -"``FlagBoundary`` controls how out-of-range values are handled in :class:" -"`Flag` and its subclasses." +"``FlagBoundary`` controls how out-of-range values are handled " +"in :class:`Flag` and its subclasses." msgstr "" msgid "" @@ -1001,8 +1077,8 @@ msgid "" msgstr "" msgid "" -"Out-of-range values have invalid values removed, leaving a valid :class:" -"`Flag` value::" +"Out-of-range values have invalid values removed, leaving a " +"valid :class:`Flag` value::" msgstr "" msgid "" @@ -1017,8 +1093,8 @@ msgid "" msgstr "" msgid "" -"Out-of-range values lose their :class:`Flag` membership and revert to :class:" -"`int`." +"Out-of-range values lose their :class:`Flag` membership and revert " +"to :class:`int`." msgstr "" msgid "" @@ -1047,10 +1123,10 @@ msgid "" msgstr "" msgid "" -"Note that only the :class:`~collections.abc.MutableMapping` interface (:meth:" -"`~object.__setitem__` and :meth:`~dict.update`) is overridden. It may be " -"possible to bypass the checks using other :class:`!dict` operations like :" -"meth:`|= `." +"Note that only the :class:`~collections.abc.MutableMapping` interface " +"(:meth:`~object.__setitem__` and :meth:`~dict.update`) is overridden. It may " +"be possible to bypass the checks using other :class:`!dict` operations " +"like :meth:`|= `." msgstr "" msgid "A list of member names." @@ -1066,23 +1142,14 @@ msgstr "" msgid "" ":meth:`~Enum.__new__`, if specified, must create and return the enum " -"members; it is also a very good idea to set the member's :attr:`!_value_` " -"appropriately. Once all the members are created it is no longer used." +"members; it is also a very good idea to set the " +"member's :attr:`~Enum._value_` appropriately. Once all the members are " +"created it is no longer used." msgstr "" msgid "Supported ``_sunder_`` names" msgstr "" -msgid "" -":meth:`~EnumType._add_alias_` -- adds a new name as an alias to an existing " -"member." -msgstr "" - -msgid "" -":meth:`~EnumType._add_value_alias_` -- adds a new value as an alias to an " -"existing member." -msgstr "" - msgid ":attr:`~Enum._name_` -- name of the member" msgstr "" @@ -1095,9 +1162,9 @@ msgid "" msgstr "" msgid "" -":attr:`~Enum._ignore_` -- a list of names, either as a :class:`list` or a :" -"class:`str`, that will not be transformed into members, and will be removed " -"from the final class" +":attr:`~Enum._ignore_` -- a list of names, either as a :class:`list` or " +"a :class:`str`, that will not be transformed into members, and will be " +"removed from the final class" msgstr "" msgid "" @@ -1111,13 +1178,13 @@ msgid "" msgstr "" msgid "" -"For standard :class:`Enum` classes the next value chosen is the highest " -"value seen incremented by one." +":meth:`~Enum._add_alias_` -- adds a new name as an alias to an existing " +"member." msgstr "" msgid "" -"For :class:`Flag` classes the next value chosen will be the next highest " -"power-of-two." +":meth:`~Enum._add_value_alias_` -- adds a new value as an alias to an " +"existing member." msgstr "" msgid "" @@ -1138,21 +1205,23 @@ msgstr "``_ignore_``" msgid "``_add_alias_``, ``_add_value_alias_``, ``_repr_*``" msgstr "" -msgid "Utilities and Decorators" +msgid "Utilities and decorators" msgstr "" msgid "" "*auto* can be used in place of a value. If used, the *Enum* machinery will " "call an :class:`Enum`'s :meth:`~Enum._generate_next_value_` to get an " "appropriate value. For :class:`Enum` and :class:`IntEnum` that appropriate " -"value will be the last value plus one; for :class:`Flag` and :class:" -"`IntFlag` it will be the first power-of-two greater than the highest value; " -"for :class:`StrEnum` it will be the lower-cased version of the member's " -"name. Care must be taken if mixing *auto()* with manually specified values." +"value will be the last value plus one; for :class:`Flag` " +"and :class:`IntFlag` it will be the first power-of-two greater than the " +"highest value; for :class:`StrEnum` it will be the lower-cased version of " +"the member's name. Care must be taken if mixing *auto()* with manually " +"specified values." msgstr "" msgid "" -"*auto* instances are only resolved when at the top level of an assignment:" +"*auto* instances are only resolved when at the top level of an assignment, " +"either by itself or as part of a tuple:" msgstr "" msgid "``FIRST = auto()`` will work (auto() is replaced with ``1``);" @@ -1164,8 +1233,8 @@ msgid "" msgstr "" msgid "" -"``THREE = [auto(), -3]`` will *not* work (``, -3`` is used to " -"create the ``THREE`` enum member)" +"``THREE = [auto(), -3]`` will *not* work (``[, -3]`` is used " +"to create the ``THREE`` enum member)" msgstr "" msgid "" @@ -1185,7 +1254,7 @@ msgid "" msgstr "" msgid "" -"A decorator similar to the built-in *property*, but specifically for " +"A decorator similar to the built-in :deco:`property`, but specifically for " "enumerations. It allows member attributes to have the same names as members " "themselves." msgstr "" @@ -1218,9 +1287,9 @@ msgid "" msgstr "" msgid "" -"A :keyword:`class` decorator specifically for enumerations. Members from :" -"class:`EnumCheck` are used to specify which constraints should be checked on " -"the decorated enumeration." +"A :keyword:`class` decorator specifically for enumerations. Members " +"from :class:`EnumCheck` are used to specify which constraints should be " +"checked on the decorated enumeration." msgstr "" msgid "A decorator for use in enums: its target will become a member." diff --git a/library/errno.po b/library/errno.po index a57761d253..d04294dcdc 100644 --- a/library/errno.po +++ b/library/errno.po @@ -40,8 +40,8 @@ msgid "" msgstr "" msgid "" -"To translate a numeric error code to an error message, use :func:`os." -"strerror`." +"To translate a numeric error code to an error message, " +"use :func:`os.strerror`." msgstr "" msgid "" @@ -51,23 +51,23 @@ msgid "" msgstr "" msgid "" -"Operation not permitted. This error is mapped to the exception :exc:" -"`PermissionError`." +"Operation not permitted. This error is mapped to the " +"exception :exc:`PermissionError`." msgstr "" msgid "" -"No such file or directory. This error is mapped to the exception :exc:" -"`FileNotFoundError`." +"No such file or directory. This error is mapped to the " +"exception :exc:`FileNotFoundError`." msgstr "" msgid "" -"No such process. This error is mapped to the exception :exc:" -"`ProcessLookupError`." +"No such process. This error is mapped to the " +"exception :exc:`ProcessLookupError`." msgstr "" msgid "" -"Interrupted system call. This error is mapped to the exception :exc:" -"`InterruptedError`." +"Interrupted system call. This error is mapped to the " +"exception :exc:`InterruptedError`." msgstr "" msgid "I/O error" @@ -86,8 +86,8 @@ msgid "Bad file number" msgstr "" msgid "" -"No child processes. This error is mapped to the exception :exc:" -"`ChildProcessError`." +"No child processes. This error is mapped to the " +"exception :exc:`ChildProcessError`." msgstr "" msgid "" @@ -98,8 +98,8 @@ msgid "Out of memory" msgstr "" msgid "" -"Permission denied. This error is mapped to the exception :exc:" -"`PermissionError`." +"Permission denied. This error is mapped to the " +"exception :exc:`PermissionError`." msgstr "" msgid "Bad address" @@ -122,13 +122,13 @@ msgid "No such device" msgstr "" msgid "" -"Not a directory. This error is mapped to the exception :exc:" -"`NotADirectoryError`." +"Not a directory. This error is mapped to the " +"exception :exc:`NotADirectoryError`." msgstr "" msgid "" -"Is a directory. This error is mapped to the exception :exc:" -"`IsADirectoryError`." +"Is a directory. This error is mapped to the " +"exception :exc:`IsADirectoryError`." msgstr "" msgid "Invalid argument" @@ -190,8 +190,8 @@ msgid "Too many symbolic links encountered" msgstr "" msgid "" -"Operation would block. This error is mapped to the exception :exc:" -"`BlockingIOError`." +"Operation would block. This error is mapped to the " +"exception :exc:`BlockingIOError`." msgstr "" msgid "No message of desired type" @@ -378,13 +378,13 @@ msgid "Network dropped connection because of reset" msgstr "" msgid "" -"Software caused connection abort. This error is mapped to the exception :exc:" -"`ConnectionAbortedError`." +"Software caused connection abort. This error is mapped to the " +"exception :exc:`ConnectionAbortedError`." msgstr "" msgid "" -"Connection reset by peer. This error is mapped to the exception :exc:" -"`ConnectionResetError`." +"Connection reset by peer. This error is mapped to the " +"exception :exc:`ConnectionResetError`." msgstr "" msgid "No buffer space available" @@ -405,13 +405,13 @@ msgid "Too many references: cannot splice" msgstr "" msgid "" -"Connection timed out. This error is mapped to the exception :exc:" -"`TimeoutError`." +"Connection timed out. This error is mapped to the " +"exception :exc:`TimeoutError`." msgstr "" msgid "" -"Connection refused. This error is mapped to the exception :exc:" -"`ConnectionRefusedError`." +"Connection refused. This error is mapped to the " +"exception :exc:`ConnectionRefusedError`." msgstr "" msgid "Host is down" @@ -421,13 +421,13 @@ msgid "No route to host" msgstr "" msgid "" -"Operation already in progress. This error is mapped to the exception :exc:" -"`BlockingIOError`." +"Operation already in progress. This error is mapped to the " +"exception :exc:`BlockingIOError`." msgstr "" msgid "" -"Operation now in progress. This error is mapped to the exception :exc:" -"`BlockingIOError`." +"Operation now in progress. This error is mapped to the " +"exception :exc:`BlockingIOError`." msgstr "" msgid "Stale NFS file handle" @@ -455,8 +455,8 @@ msgid "Interface output queue is full" msgstr "" msgid "" -"Capabilities insufficient. This error is mapped to the exception :exc:" -"`PermissionError`." +"Capabilities insufficient. This error is mapped to the " +"exception :exc:`PermissionError`." msgstr "" msgid ":ref:`Availability `: WASI, FreeBSD" diff --git a/library/exceptions.po b/library/exceptions.po index ca886a5e92..21998bb989 100644 --- a/library/exceptions.po +++ b/library/exceptions.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-08-21 16:18+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,12 +27,13 @@ msgid "Built-in Exceptions" msgstr "" msgid "" -"In Python, all exceptions must be instances of a class that derives from :" -"class:`BaseException`. In a :keyword:`try` statement with an :keyword:" -"`except` clause that mentions a particular class, that clause also handles " -"any exception classes derived from that class (but not exception classes " -"from which *it* is derived). Two exception classes that are not related via " -"subclassing are never equivalent, even if they have the same name." +"In Python, all exceptions must be instances of a class that derives " +"from :class:`BaseException`. In a :keyword:`try` statement with " +"an :keyword:`except` clause that mentions a particular class, that clause " +"also handles any exception classes derived from that class (but not " +"exception classes from which *it* is derived). Two exception classes that " +"are not related via subclassing are never equivalent, even if they have the " +"same name." msgstr "" msgid "" @@ -55,10 +55,10 @@ msgstr "" msgid "" "The built-in exception classes can be subclassed to define new exceptions; " -"programmers are encouraged to derive new exceptions from the :exc:" -"`Exception` class or one of its subclasses, and not from :exc:" -"`BaseException`. More information on defining exceptions is available in " -"the Python Tutorial under :ref:`tut-userexceptions`." +"programmers are encouraged to derive new exceptions from " +"the :exc:`Exception` class or one of its subclasses, and not " +"from :exc:`BaseException`. More information on defining exceptions is " +"available in the Python Tutorial under :ref:`tut-userexceptions`." msgstr "" msgid "Exception context" @@ -72,9 +72,9 @@ msgstr "" msgid "" "When raising a new exception while another exception is already being " "handled, the new exception's :attr:`!__context__` attribute is automatically " -"set to the handled exception. An exception may be handled when an :keyword:" -"`except` or :keyword:`finally` clause, or a :keyword:`with` statement, is " -"used." +"set to the handled exception. An exception may be handled when " +"an :keyword:`except` or :keyword:`finally` clause, or a :keyword:`with` " +"statement, is used." msgstr "" msgid "" @@ -121,12 +121,13 @@ msgid "" msgstr "" msgid "" -"Most built-in exceptions are implemented in C for efficiency, see: :source:" -"`Objects/exceptions.c`. Some have custom memory layouts which makes it " -"impossible to create a subclass that inherits from multiple exception types. " -"The memory layout of a type is an implementation detail and might change " -"between Python versions, leading to new conflicts in the future. Therefore, " -"it's recommended to avoid subclassing multiple exception types altogether." +"Most built-in exceptions are implemented in C for efficiency, " +"see: :source:`Objects/exceptions.c`. Some have custom memory layouts which " +"makes it impossible to create a subclass that inherits from multiple " +"exception types. The memory layout of a type is an implementation detail and " +"might change between Python versions, leading to new conflicts in the " +"future. Therefore, it's recommended to avoid subclassing multiple exception " +"types altogether." msgstr "" msgid "Base classes" @@ -139,9 +140,9 @@ msgstr "" msgid "" "The base class for all built-in exceptions. It is not meant to be directly " -"inherited by user-defined classes (for that, use :exc:`Exception`). If :" -"func:`str` is called on an instance of this class, the representation of the " -"argument(s) to the instance are returned, or the empty string when there " +"inherited by user-defined classes (for that, use :exc:`Exception`). " +"If :func:`str` is called on an instance of this class, the representation of " +"the argument(s) to the instance are returned, or the empty string when there " "were no arguments." msgstr "" @@ -183,8 +184,9 @@ msgid "" msgstr "" msgid "" -"A list of the notes of this exception, which were added with :meth:" -"`add_note`. This attribute is created when :meth:`add_note` is called." +"A list of the notes of this exception, which were added " +"with :meth:`add_note`. This attribute is created when :meth:`add_note` is " +"called." msgstr "" msgid "" @@ -194,8 +196,8 @@ msgstr "" msgid "" "The base class for those built-in exceptions that are raised for various " -"arithmetic errors: :exc:`OverflowError`, :exc:`ZeroDivisionError`, :exc:" -"`FloatingPointError`." +"arithmetic " +"errors: :exc:`OverflowError`, :exc:`ZeroDivisionError`, :exc:`FloatingPointError`." msgstr "" msgid "" @@ -225,10 +227,14 @@ msgid "" msgstr "" msgid "" -"The :attr:`name` and :attr:`obj` attributes can be set using keyword-only " -"arguments to the constructor. When set they represent the name of the " -"attribute that was attempted to be accessed and the object that was accessed " -"for said attribute, respectively." +"The optional *name* and *obj* keyword-only arguments set the corresponding " +"attributes:" +msgstr "" + +msgid "The name of the attribute that was attempted to be accessed." +msgstr "" + +msgid "The object that was accessed for the named attribute." msgstr "" msgid "Added the :attr:`name` and :attr:`obj` attributes." @@ -236,18 +242,19 @@ msgstr "" msgid "" "Raised when the :func:`input` function hits an end-of-file condition (EOF) " -"without reading any data. (N.B.: the :meth:`io.IOBase.read` and :meth:`io." -"IOBase.readline` methods return an empty string when they hit EOF.)" +"without reading any data. (Note: the :meth:`io.TextIOBase.read` " +"and :meth:`io.IOBase.readline` methods return an empty string when they hit " +"EOF.)" msgstr "" msgid "Not currently used." msgstr "" msgid "" -"Raised when a :term:`generator` or :term:`coroutine` is closed; see :meth:" -"`generator.close` and :meth:`coroutine.close`. It directly inherits from :" -"exc:`BaseException` instead of :exc:`Exception` since it is technically not " -"an error." +"Raised when a :term:`generator` or :term:`coroutine` is closed; " +"see :meth:`generator.close` and :meth:`coroutine.close`. It directly " +"inherits from :exc:`BaseException` instead of :exc:`Exception` since it is " +"technically not an error." msgstr "" msgid "" @@ -272,8 +279,8 @@ msgstr "" msgid "" "A subclass of :exc:`ImportError` which is raised by :keyword:`import` when a " -"module could not be located. It is also raised when ``None`` is found in :" -"data:`sys.modules`." +"module could not be located. It is also raised when ``None`` is found " +"in :data:`sys.modules`." msgstr "" msgid "" @@ -288,9 +295,9 @@ msgid "" msgstr "" msgid "" -"Raised when the user hits the interrupt key (normally :kbd:`Control-C` or :" -"kbd:`Delete`). During execution, a check for interrupts is made regularly. " -"The exception inherits from :exc:`BaseException` so as to not be " +"Raised when the user hits the interrupt key (normally :kbd:`Control-C` " +"or :kbd:`Delete`). During execution, a check for interrupts is made " +"regularly. The exception inherits from :exc:`BaseException` so as to not be " "accidentally caught by code that catches :exc:`Exception` and thus prevent " "the interpreter from exiting." msgstr "" @@ -307,10 +314,11 @@ msgid "" "Raised when an operation runs out of memory but the situation may still be " "rescued (by deleting some objects). The associated value is a string " "indicating what kind of (internal) operation ran out of memory. Note that " -"because of the underlying memory management architecture (C's :c:func:" -"`malloc` function), the interpreter may not always be able to completely " -"recover from this situation; it nevertheless raises an exception so that a " -"stack traceback can be printed, in case a run-away program was the cause." +"because of the underlying memory management architecture " +"(C's :c:func:`malloc` function), the interpreter may not always be able to " +"completely recover from this situation; it nevertheless raises an exception " +"so that a stack traceback can be printed, in case a run-away program was the " +"cause." msgstr "" msgid "" @@ -319,10 +327,10 @@ msgid "" "the name that could not be found." msgstr "" -msgid "" -"The :attr:`name` attribute can be set using a keyword-only argument to the " -"constructor. When set it represent the name of the variable that was " -"attempted to be accessed." +msgid "The optional *name* keyword-only argument sets the attribute:" +msgstr "" + +msgid "The name of the variable that was attempted to be accessed." msgstr "" msgid "Added the :attr:`name` attribute." @@ -343,82 +351,83 @@ msgstr "" msgid "" ":exc:`!NotImplementedError` and :data:`!NotImplemented` are not " -"interchangeable. This exception should only be used as described above; see :" -"data:`NotImplemented` for details on correct usage of the built-in constant." +"interchangeable. This exception should only be used as described above; " +"see :data:`NotImplemented` for details on correct usage of the built-in " +"constant." msgstr "" msgid "" "This exception is raised when a system function returns a system-related " -"error, including I/O failures such as \"file not found\" or \"disk " -"full\" (not for illegal argument types or other incidental errors)." +"error, including I/O failures such as \"file not found\" or \"disk full\" " +"(not for illegal argument types or other incidental errors)." msgstr "" msgid "" "The second form of the constructor sets the corresponding attributes, " "described below. The attributes default to :const:`None` if not specified. " -"For backwards compatibility, if three arguments are passed, the :attr:" -"`~BaseException.args` attribute contains only a 2-tuple of the first two " -"constructor arguments." +"For backwards compatibility, if three arguments are passed, " +"the :attr:`~BaseException.args` attribute contains only a 2-tuple of the " +"first two constructor arguments." msgstr "" msgid "" "The constructor often actually returns a subclass of :exc:`OSError`, as " "described in `OS exceptions`_ below. The particular subclass depends on the " -"final :attr:`.errno` value. This behaviour only occurs when constructing :" -"exc:`OSError` directly or via an alias, and is not inherited when " -"subclassing." +"final :attr:`.errno` value. This behaviour only occurs when " +"constructing :exc:`OSError` directly or via an alias, and is not inherited " +"when subclassing." msgstr "" msgid "A numeric error code from the C variable :c:data:`errno`." msgstr "" msgid "" -"Under Windows, this gives you the native Windows error code. The :attr:`." -"errno` attribute is then an approximate translation, in POSIX terms, of that " -"native error code." +"Under Windows, this gives you the native Windows error code. " +"The :attr:`.errno` attribute is then an approximate translation, in POSIX " +"terms, of that native error code." msgstr "" msgid "" -"Under Windows, if the *winerror* constructor argument is an integer, the :" -"attr:`.errno` attribute is determined from the Windows error code, and the " -"*errno* argument is ignored. On other platforms, the *winerror* argument is " -"ignored, and the :attr:`winerror` attribute does not exist." +"Under Windows, if the *winerror* constructor argument is an integer, " +"the :attr:`.errno` attribute is determined from the Windows error code, and " +"the *errno* argument is ignored. On other platforms, the *winerror* " +"argument is ignored, and the :attr:`winerror` attribute does not exist." msgstr "" msgid "" "The corresponding error message, as provided by the operating system. It is " -"formatted by the C functions :c:func:`perror` under POSIX, and :c:func:" -"`FormatMessage` under Windows." +"formatted by the C functions :c:func:`!perror` under POSIX, and :c:func:`!" +"FormatMessage` under Windows." msgstr "" msgid "" -"For exceptions that involve a file system path (such as :func:`open` or :" -"func:`os.unlink`), :attr:`filename` is the file name passed to the function. " -"For functions that involve two file system paths (such as :func:`os." -"rename`), :attr:`filename2` corresponds to the second file name passed to " -"the function." +"For exceptions that involve a file system path (such as :func:`open` " +"or :func:`os.unlink`), :attr:`filename` is the file name passed to the " +"function. For functions that involve two file system paths (such " +"as :func:`os.rename`), :attr:`filename2` corresponds to the second file name " +"passed to the function." msgstr "" msgid "" -":exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`, :exc:`socket." -"error`, :exc:`select.error` and :exc:`mmap.error` have been merged into :exc:" -"`OSError`, and the constructor may return a subclass." +":exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`, :exc:`socket.error`, :exc:`select.error` " +"and :exc:`!mmap.error` have been merged into :exc:`OSError`, and the " +"constructor may return a subclass." msgstr "" msgid "" "The :attr:`filename` attribute is now the original file name passed to the " -"function, instead of the name encoded to or decoded from the :term:" -"`filesystem encoding and error handler`. Also, the *filename2* constructor " -"argument and attribute was added." +"function, instead of the name encoded to or decoded from " +"the :term:`filesystem encoding and error handler`. Also, the *filename2* " +"constructor argument and attribute was added." msgstr "" msgid "" "Raised when the result of an arithmetic operation is too large to be " -"represented. This cannot occur for integers (which would rather raise :exc:" -"`MemoryError` than give up). However, for historical reasons, OverflowError " -"is sometimes raised for integers that are outside a required range. " -"Because of the lack of standardization of floating-point exception handling " -"in C, most floating-point operations are not checked." +"represented. This cannot occur for integers (which would rather " +"raise :exc:`MemoryError` than give up). However, for historical reasons, " +"OverflowError is sometimes raised for integers that are outside a required " +"range. Because of the lack of standardization of floating-point exception " +"handling in C, most floating-point operations are not checked." msgstr "" msgid "" @@ -428,8 +437,8 @@ msgid "" msgstr "" msgid "" -"Examples of operations which can be blocked with a :exc:" -"`PythonFinalizationError` during the Python finalization:" +"Examples of operations which can be blocked with " +"a :exc:`PythonFinalizationError` during the Python finalization:" msgstr "" msgid "Creating a new Python thread." @@ -446,14 +455,14 @@ msgstr "" msgid "" "This exception is derived from :exc:`RuntimeError`. It is raised when the " -"interpreter detects that the maximum recursion depth (see :func:`sys." -"getrecursionlimit`) is exceeded." +"interpreter detects that the maximum recursion depth " +"(see :func:`sys.getrecursionlimit`) is exceeded." msgstr "" msgid "" -"This exception is raised when a weak reference proxy, created by the :func:" -"`weakref.proxy` function, is used to access an attribute of the referent " -"after it has been garbage collected. For more information on weak " +"This exception is raised when a weak reference proxy, created by " +"the :func:`weakref.proxy` function, is used to access an attribute of the " +"referent after it has been garbage collected. For more information on weak " "references, see the :mod:`weakref` module." msgstr "" @@ -464,21 +473,22 @@ msgid "" msgstr "" msgid "" -"Raised by built-in function :func:`next` and an :term:`iterator`\\'s :meth:" -"`~iterator.__next__` method to signal that there are no further items " -"produced by the iterator." +"Raised by built-in function :func:`next` and " +"an :term:`iterator`\\'s :meth:`~iterator.__next__` method to signal that " +"there are no further items produced by the iterator." msgstr "" msgid "" "The exception object has a single attribute :attr:`!value`, which is given " -"as an argument when constructing the exception, and defaults to :const:" -"`None`." +"as an argument when constructing the exception, and defaults " +"to :const:`None`." msgstr "" msgid "" -"When a :term:`generator` or :term:`coroutine` function returns, a new :exc:" -"`StopIteration` instance is raised, and the value returned by the function " -"is used as the :attr:`value` parameter to the constructor of the exception." +"When a :term:`generator` or :term:`coroutine` function returns, a " +"new :exc:`StopIteration` instance is raised, and the value returned by the " +"function is used as the :attr:`value` parameter to the constructor of the " +"exception." msgstr "" msgid "" @@ -508,10 +518,10 @@ msgid "" msgstr "" msgid "" -"Raised when the parser encounters a syntax error. This may occur in an :" -"keyword:`import` statement, in a call to the built-in functions :func:" -"`compile`, :func:`exec`, or :func:`eval`, or when reading the initial script " -"or standard input (also interactively)." +"Raised when the parser encounters a syntax error. This may occur in " +"an :keyword:`import` statement, in a call to the built-in " +"functions :func:`compile`, :func:`exec`, or :func:`eval`, or when reading " +"the initial script or standard input (also interactively)." msgstr "" msgid "" @@ -568,9 +578,9 @@ msgstr "" msgid "" "Raised when the interpreter finds an internal error, but the situation does " "not look so serious to cause it to abandon all hope. The associated value is " -"a string indicating what went wrong (in low-level terms). In :term:" -"`CPython`, this could be raised by incorrectly using Python's C API, such as " -"returning a ``NULL`` value without an exception set." +"a string indicating what went wrong (in low-level terms). " +"In :term:`CPython`, this could be raised by incorrectly using Python's C " +"API, such as returning a ``NULL`` value without an exception set." msgstr "" msgid "" @@ -589,11 +599,11 @@ msgid "" "accidentally caught by code that catches :exc:`Exception`. This allows the " "exception to properly propagate up and cause the interpreter to exit. When " "it is not handled, the Python interpreter exits; no stack traceback is " -"printed. The constructor accepts the same optional argument passed to :func:" -"`sys.exit`. If the value is an integer, it specifies the system exit status " -"(passed to C's :c:func:`exit` function); if it is ``None``, the exit status " -"is zero; if it has another type (such as a string), the object's value is " -"printed and the exit status is one." +"printed. The constructor accepts the same optional argument passed " +"to :func:`sys.exit`. If the value is an integer, it specifies the system " +"exit status (passed to C's :c:func:`!exit` function); if it is ``None``, the " +"exit status is zero; if it has another type (such as a string), the object's " +"value is printed and the exit status is one." msgstr "" msgid "" @@ -624,16 +634,16 @@ msgid "" msgstr "" msgid "" -"Passing arguments of the wrong type (e.g. passing a :class:`list` when an :" -"class:`int` is expected) should result in a :exc:`TypeError`, but passing " -"arguments with the wrong value (e.g. a number outside expected boundaries) " -"should result in a :exc:`ValueError`." +"Passing arguments of the wrong type (e.g. passing a :class:`list` when " +"an :class:`int` is expected) should result in a :exc:`TypeError`, but " +"passing arguments with the wrong value (e.g. a number outside expected " +"boundaries) should result in a :exc:`ValueError`." msgstr "" msgid "" "Raised when a reference is made to a local variable in a function or method, " -"but no value has been bound to that variable. This is a subclass of :exc:" -"`NameError`." +"but no value has been bound to that variable. This is a subclass " +"of :exc:`NameError`." msgstr "" msgid "" @@ -707,9 +717,9 @@ msgstr "" msgid "" "Raised when an operation would block on an object (e.g. socket) set for non-" -"blocking operation. Corresponds to :c:data:`errno` :py:const:`~errno." -"EAGAIN`, :py:const:`~errno.EALREADY`, :py:const:`~errno.EWOULDBLOCK` and :py:" -"const:`~errno.EINPROGRESS`." +"blocking operation. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EAGAIN`, :py:const:`~errno.EALREADY`, :py:const:`~errno.EWOULDBLOCK` " +"and :py:const:`~errno.EINPROGRESS`." msgstr "" msgid "" @@ -718,41 +728,42 @@ msgid "" msgstr "" msgid "" -"An integer containing the number of characters written to the stream before " -"it blocked. This attribute is available when using the buffered I/O classes " +"An integer containing the number of **bytes** written to the stream before " +"it blocked. This attribute is available when using the buffered I/O classes " "from the :mod:`io` module." msgstr "" msgid "" -"Raised when an operation on a child process failed. Corresponds to :c:data:" -"`errno` :py:const:`~errno.ECHILD`." +"Raised when an operation on a child process failed. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECHILD`." msgstr "" msgid "A base class for connection-related issues." msgstr "" msgid "" -"Subclasses are :exc:`BrokenPipeError`, :exc:`ConnectionAbortedError`, :exc:" -"`ConnectionRefusedError` and :exc:`ConnectionResetError`." +"Subclasses " +"are :exc:`BrokenPipeError`, :exc:`ConnectionAbortedError`, :exc:`ConnectionRefusedError` " +"and :exc:`ConnectionResetError`." msgstr "" msgid "" "A subclass of :exc:`ConnectionError`, raised when trying to write on a pipe " "while the other end has been closed, or trying to write on a socket which " -"has been shutdown for writing. Corresponds to :c:data:`errno` :py:const:" -"`~errno.EPIPE` and :py:const:`~errno.ESHUTDOWN`." +"has been shutdown for writing. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EPIPE` and :py:const:`~errno.ESHUTDOWN`." msgstr "" msgid "" "A subclass of :exc:`ConnectionError`, raised when a connection attempt is " -"aborted by the peer. Corresponds to :c:data:`errno` :py:const:`~errno." -"ECONNABORTED`." +"aborted by the peer. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECONNABORTED`." msgstr "" msgid "" "A subclass of :exc:`ConnectionError`, raised when a connection attempt is " -"refused by the peer. Corresponds to :c:data:`errno` :py:const:`~errno." -"ECONNREFUSED`." +"refused by the peer. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ECONNREFUSED`." msgstr "" msgid "" @@ -790,30 +801,30 @@ msgid "" "Raised when a directory operation (such as :func:`os.listdir`) is requested " "on something which is not a directory. On most POSIX platforms, it may also " "be raised if an operation attempts to open or traverse a non-directory file " -"as if it were a directory. Corresponds to :c:data:`errno` :py:const:`~errno." -"ENOTDIR`." +"as if it were a directory. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ENOTDIR`." msgstr "" msgid "" "Raised when trying to run an operation without the adequate access rights - " -"for example filesystem permissions. Corresponds to :c:data:`errno` :py:const:" -"`~errno.EACCES`, :py:const:`~errno.EPERM`, and :py:const:`~errno." -"ENOTCAPABLE`." +"for example filesystem permissions. Corresponds " +"to :c:data:`errno` :py:const:`~errno.EACCES`, :py:const:`~errno.EPERM`, " +"and :py:const:`~errno.ENOTCAPABLE`." msgstr "" msgid "" -"WASI's :py:const:`~errno.ENOTCAPABLE` is now mapped to :exc:" -"`PermissionError`." +"WASI's :py:const:`~errno.ENOTCAPABLE` is now mapped " +"to :exc:`PermissionError`." msgstr "" msgid "" -"Raised when a given process doesn't exist. Corresponds to :c:data:`errno` :" -"py:const:`~errno.ESRCH`." +"Raised when a given process doesn't exist. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ESRCH`." msgstr "" msgid "" -"Raised when a system function timed out at the system level. Corresponds to :" -"c:data:`errno` :py:const:`~errno.ETIMEDOUT`." +"Raised when a system function timed out at the system level. Corresponds " +"to :c:data:`errno` :py:const:`~errno.ETIMEDOUT`." msgstr "" msgid "All the above :exc:`OSError` subclasses were added." @@ -826,8 +837,8 @@ msgid "Warnings" msgstr "" msgid "" -"The following exceptions are used as warning categories; see the :ref:" -"`warning-categories` documentation for more details." +"The following exceptions are used as warning categories; see " +"the :ref:`warning-categories` documentation for more details." msgstr "" msgid "Base class for warning categories." @@ -842,9 +853,9 @@ msgid "" msgstr "" msgid "" -"Ignored by the default warning filters, except in the ``__main__`` module (:" -"pep:`565`). Enabling the :ref:`Python Development Mode ` shows this " -"warning." +"Ignored by the default warning filters, except in the ``__main__`` module " +"(:pep:`565`). Enabling the :ref:`Python Development Mode ` shows " +"this warning." msgstr "" msgid "The deprecation policy is described in :pep:`387`." @@ -869,6 +880,11 @@ msgstr "" msgid "Base class for warnings about dubious syntax." msgstr "" +msgid "" +"This warning is typically emitted when compiling Python source code, and " +"usually won't be reported when running already compiled code." +msgstr "" + msgid "Base class for warnings about dubious runtime behavior." msgstr "" @@ -911,18 +927,30 @@ msgid "" "Both of these exception types wrap the exceptions in the sequence ``excs``. " "The ``msg`` parameter must be a string. The difference between the two " "classes is that :exc:`BaseExceptionGroup` extends :exc:`BaseException` and " -"it can wrap any exception, while :exc:`ExceptionGroup` extends :exc:" -"`Exception` and it can only wrap subclasses of :exc:`Exception`. This design " -"is so that ``except Exception`` catches an :exc:`ExceptionGroup` but not :" -"exc:`BaseExceptionGroup`." +"it can wrap any exception, while :exc:`ExceptionGroup` " +"extends :exc:`Exception` and it can only wrap subclasses " +"of :exc:`Exception`. This design is so that ``except Exception`` catches " +"an :exc:`ExceptionGroup` but not :exc:`BaseExceptionGroup`." msgstr "" msgid "" "The :exc:`BaseExceptionGroup` constructor returns an :exc:`ExceptionGroup` " -"rather than a :exc:`BaseExceptionGroup` if all contained exceptions are :exc:" -"`Exception` instances, so it can be used to make the selection automatic. " -"The :exc:`ExceptionGroup` constructor, on the other hand, raises a :exc:" -"`TypeError` if any contained exception is not an :exc:`Exception` subclass." +"rather than a :exc:`BaseExceptionGroup` if all contained exceptions " +"are :exc:`Exception` instances, so it can be used to make the selection " +"automatic. The :exc:`ExceptionGroup` constructor, on the other hand, raises " +"a :exc:`TypeError` if any contained exception is not an :exc:`Exception` " +"subclass." +msgstr "" + +msgid "" +"Exception groups are :ref:`generic ` over the type of their " +"contained exceptions." +msgstr "" + +msgid "" +"The ``excs`` parameter may be any sequence, but lists and tuples are " +"specifically processed more efficiently here. For optimal performance, pass " +"a tuple as ``excs``." msgstr "" msgid "The ``msg`` argument to the constructor. This is a read-only attribute." @@ -948,10 +976,10 @@ msgstr "" msgid "" "The nesting structure of the current exception is preserved in the result, " -"as are the values of its :attr:`message`, :attr:`~BaseException." -"__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException." -"__context__` and :attr:`~BaseException.__notes__` fields. Empty nested " -"groups are omitted from the result." +"as are the values of " +"its :attr:`message`, :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` " +"and :attr:`~BaseException.__notes__` fields. Empty nested groups are omitted " +"from the result." msgstr "" msgid "" @@ -982,11 +1010,11 @@ msgid "" msgstr "" msgid "" -":meth:`subgroup` and :meth:`split` copy the :attr:`~BaseException." -"__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException." -"__context__` and :attr:`~BaseException.__notes__` fields from the original " -"exception group to the one returned by :meth:`derive`, so these fields do " -"not need to be updated by :meth:`derive`." +":meth:`subgroup` and :meth:`split` copy " +"the :attr:`~BaseException.__traceback__`, :attr:`~BaseException.__cause__`, :attr:`~BaseException.__context__` " +"and :attr:`~BaseException.__notes__` fields from the original exception " +"group to the one returned by :meth:`derive`, so these fields do not need to " +"be updated by :meth:`derive`." msgstr "" msgid "" @@ -1021,7 +1049,7 @@ msgid "" "Note that :exc:`BaseExceptionGroup` defines :meth:`~object.__new__`, so " "subclasses that need a different constructor signature need to override that " "rather than :meth:`~object.__init__`. For example, the following defines an " -"exception group subclass which accepts an exit_code and and constructs the " +"exception group subclass which accepts an exit_code and constructs the " "group's message from it. ::" msgstr "" @@ -1038,8 +1066,8 @@ msgstr "" msgid "" "Like :exc:`ExceptionGroup`, any subclass of :exc:`BaseExceptionGroup` which " -"is also a subclass of :exc:`Exception` can only wrap instances of :exc:" -"`Exception`." +"is also a subclass of :exc:`Exception` can only wrap instances " +"of :exc:`Exception`." msgstr "" msgid "Exception hierarchy" diff --git a/library/faulthandler.po b/library/faulthandler.po index ea7976a244..bc0471753c 100644 --- a/library/faulthandler.po +++ b/library/faulthandler.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:05+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,10 +28,10 @@ msgstr "" msgid "" "This module contains functions to dump Python tracebacks explicitly, on a " -"fault, after a timeout, or on a user signal. Call :func:`faulthandler." -"enable` to install fault handlers for the :const:`~signal.SIGSEGV`, :const:" -"`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS`, and :" -"const:`~signal.SIGILL` signals. You can also enable them at startup by " +"fault, after a timeout, or on a user signal. " +"Call :func:`faulthandler.enable` to install fault handlers for " +"the :const:`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS`, " +"and :const:`~signal.SIGILL` signals. You can also enable them at startup by " "setting the :envvar:`PYTHONFAULTHANDLER` environment variable or by using " "the :option:`-X` ``faulthandler`` command line option." msgstr "" @@ -81,8 +81,8 @@ msgid "" msgstr "" msgid "" -"The :ref:`Python Development Mode ` calls :func:`faulthandler." -"enable` at Python startup." +"The :ref:`Python Development Mode ` " +"calls :func:`faulthandler.enable` at Python startup." msgstr "" msgid "Module :mod:`pdb`" @@ -118,16 +118,16 @@ msgid "Fault handler state" msgstr "" msgid "" -"Enable the fault handler: install handlers for the :const:`~signal." -"SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal." -"SIGBUS` and :const:`~signal.SIGILL` signals to dump the Python traceback. If " +"Enable the fault handler: install handlers for " +"the :const:`~signal.SIGSEGV`, :const:`~signal.SIGFPE`, :const:`~signal.SIGABRT`, :const:`~signal.SIGBUS` " +"and :const:`~signal.SIGILL` signals to dump the Python traceback. If " "*all_threads* is ``True``, produce tracebacks for every running thread. " "Otherwise, dump only the current thread." msgstr "" msgid "" -"The *file* must be kept open until the fault handler is disabled: see :ref:" -"`issue with file descriptors `." +"The *file* must be kept open until the fault handler is disabled: " +"see :ref:`issue with file descriptors `." msgstr "" msgid "On Windows, a handler for Windows exception is also installed." @@ -139,8 +139,8 @@ msgid "" msgstr "" msgid "" -"Disable the fault handler: uninstall the signal handlers installed by :func:" -"`enable`." +"Disable the fault handler: uninstall the signal handlers installed " +"by :func:`enable`." msgstr "" msgid "Check if the fault handler is enabled." @@ -152,16 +152,16 @@ msgstr "" msgid "" "Dump the tracebacks of all threads, after a timeout of *timeout* seconds, or " "every *timeout* seconds if *repeat* is ``True``. If *exit* is ``True``, " -"call :c:func:`!_exit` with status=1 after dumping the tracebacks. (Note :c:" -"func:`!_exit` exits the process immediately, which means it doesn't do any " -"cleanup like flushing file buffers.) If the function is called twice, the " -"new call replaces previous parameters and resets the timeout. The timer has " -"a sub-second resolution." +"call :c:func:`!_exit` with status=1 after dumping the tracebacks. " +"(Note :c:func:`!_exit` exits the process immediately, which means it doesn't " +"do any cleanup like flushing file buffers.) If the function is called twice, " +"the new call replaces previous parameters and resets the timeout. The timer " +"has a sub-second resolution." msgstr "" msgid "" -"The *file* must be kept open until the traceback is dumped or :func:" -"`cancel_dump_traceback_later` is called: see :ref:`issue with file " +"The *file* must be kept open until the traceback is dumped " +"or :func:`cancel_dump_traceback_later` is called: see :ref:`issue with file " "descriptors `." msgstr "" @@ -184,8 +184,9 @@ msgid "" msgstr "" msgid "" -"The *file* must be kept open until the signal is unregistered by :func:" -"`unregister`: see :ref:`issue with file descriptors `." +"The *file* must be kept open until the signal is unregistered " +"by :func:`unregister`: see :ref:`issue with file descriptors `." msgstr "" msgid "Not available on Windows." diff --git a/library/fcntl.po b/library/fcntl.po index 445875c3d2..0b3ddbf051 100644 --- a/library/fcntl.po +++ b/library/fcntl.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,8 +28,8 @@ msgstr "" msgid "" "This module performs file and I/O control on file descriptors. It is an " -"interface to the :c:func:`fcntl` and :c:func:`ioctl` Unix routines. See the :" -"manpage:`fcntl(2)` and :manpage:`ioctl(2)` Unix manual pages for full " +"interface to the :c:func:`fcntl` and :c:func:`ioctl` Unix routines. See " +"the :manpage:`fcntl(2)` and :manpage:`ioctl(2)` Unix manual pages for full " "details." msgstr "" @@ -38,10 +38,10 @@ msgstr "Dostępność" msgid "" "All functions in this module take a file descriptor *fd* as their first " -"argument. This can be an integer file descriptor, such as returned by ``sys." -"stdin.fileno()``, or an :class:`io.IOBase` object, such as ``sys.stdin`` " -"itself, which provides a :meth:`~io.IOBase.fileno` that returns a genuine " -"file descriptor." +"argument. This can be an integer file descriptor, such as returned by " +"``sys.stdin.fileno()``, or an :class:`io.IOBase` object, such as " +"``sys.stdin`` itself, which provides a :meth:`~io.IOBase.fileno` that " +"returns a genuine file descriptor." msgstr "" msgid "" @@ -57,8 +57,8 @@ msgstr "" msgid "" "On macOS, the :mod:`!fcntl` module exposes the ``F_GETPATH`` constant, which " -"obtains the path of a file from a file descriptor. On Linux(>=3.15), the :" -"mod:`!fcntl` module exposes the ``F_OFD_GETLK``, ``F_OFD_SETLK`` and " +"obtains the path of a file from a file descriptor. On Linux(>=3.15), " +"the :mod:`!fcntl` module exposes the ``F_OFD_GETLK``, ``F_OFD_SETLK`` and " "``F_OFD_SETLKW`` constants, which are used when working with open file " "description locks." msgstr "" @@ -110,10 +110,10 @@ msgid "" "a :meth:`~io.IOBase.fileno` method are accepted as well). The values used " "for *cmd* are operating system dependent, and are available as constants in " "the :mod:`fcntl` module, using the same names as used in the relevant C " -"header files. The argument *arg* can either be an integer value, a :class:" -"`bytes` object, or a string. The type and size of *arg* must match the type " -"and size of the argument of the operation as specified in the relevant C " -"documentation." +"header files. The argument *arg* can either be an integer value, " +"a :class:`bytes` object, or a string. The type and size of *arg* must match " +"the type and size of the argument of the operation as specified in the " +"relevant C documentation." msgstr "" msgid "" @@ -177,8 +177,8 @@ msgid "" "code is passed back to the calling Python, and the buffer's new contents " "reflect the action of the :c:func:`ioctl`. This is a slight simplification, " "because if the supplied buffer is less than 1024 bytes long it is first " -"copied into a static buffer 1024 bytes long which is then passed to :func:" -"`ioctl` and copied back into the supplied buffer." +"copied into a static buffer 1024 bytes long which is then passed " +"to :func:`ioctl` and copied back into the supplied buffer." msgstr "" msgid "" @@ -233,9 +233,9 @@ msgstr "" msgid "" "This is essentially a wrapper around the :func:`~fcntl.fcntl` locking calls. " -"*fd* is the file descriptor (file objects providing a :meth:`~io.IOBase." -"fileno` method are accepted as well) of the file to lock or unlock, and " -"*cmd* is one of the following values:" +"*fd* is the file descriptor (file objects providing " +"a :meth:`~io.IOBase.fileno` method are accepted as well) of the file to lock " +"or unlock, and *cmd* is one of the following values:" msgstr "" msgid "Release an existing lock." @@ -253,18 +253,18 @@ msgid "" msgstr "" msgid "" -"If :const:`!LOCK_NB` is used and the lock cannot be acquired, an :exc:" -"`OSError` will be raised and the exception will have an *errno* attribute " -"set to :const:`~errno.EACCES` or :const:`~errno.EAGAIN` (depending on the " -"operating system; for portability, check for both values). On at least some " -"systems, :const:`!LOCK_EX` can only be used if the file descriptor refers to " -"a file opened for writing." +"If :const:`!LOCK_NB` is used and the lock cannot be acquired, " +"an :exc:`OSError` will be raised and the exception will have an *errno* " +"attribute set to :const:`~errno.EACCES` or :const:`~errno.EAGAIN` (depending " +"on the operating system; for portability, check for both values). On at " +"least some systems, :const:`!LOCK_EX` can only be used if the file " +"descriptor refers to a file opened for writing." msgstr "" msgid "" "*len* is the number of bytes to lock, *start* is the byte offset at which " -"the lock starts, relative to *whence*, and *whence* is as with :func:`io." -"IOBase.seek`, specifically:" +"the lock starts, relative to *whence*, and *whence* is as " +"with :func:`io.IOBase.seek`, specifically:" msgstr "" msgid "``0`` -- relative to the start of the file (:const:`os.SEEK_SET`)" diff --git a/library/filecmp.po b/library/filecmp.po index 56f69deeef..bb5cb1cdc7 100644 --- a/library/filecmp.po +++ b/library/filecmp.po @@ -80,8 +80,8 @@ msgid "" msgstr "" msgid "" -"The *shallow* parameter has the same meaning and default value as for :func:" -"`filecmp.cmp`." +"The *shallow* parameter has the same meaning and default value as " +"for :func:`filecmp.cmp`." msgstr "" msgid "" @@ -101,9 +101,9 @@ msgstr "" msgid "" "Construct a new directory comparison object, to compare the directories *a* " -"and *b*. *ignore* is a list of names to ignore, and defaults to :attr:" -"`filecmp.DEFAULT_IGNORES`. *hide* is a list of names to hide, and defaults " -"to ``[os.curdir, os.pardir]``." +"and *b*. *ignore* is a list of names to ignore, and defaults " +"to :attr:`filecmp.DEFAULT_IGNORES`. *hide* is a list of names to hide, and " +"defaults to ``[os.curdir, os.pardir]``." msgstr "" msgid "" diff --git a/library/fileinput.po b/library/fileinput.po index d70876a921..3a0243d7d0 100644 --- a/library/fileinput.po +++ b/library/fileinput.po @@ -49,9 +49,9 @@ msgstr "" msgid "" "All files are opened in text mode by default, but you can override this by " -"specifying the *mode* parameter in the call to :func:`.input` or :class:" -"`FileInput`. If an I/O error occurs during opening or reading a file, :exc:" -"`OSError` is raised." +"specifying the *mode* parameter in the call to :func:`.input` " +"or :class:`FileInput`. If an I/O error occurs during opening or reading a " +"file, :exc:`OSError` is raised." msgstr "" msgid ":exc:`IOError` used to be raised; it is now an alias of :exc:`OSError`." @@ -95,9 +95,9 @@ msgid "" msgstr "" msgid "" -"The :class:`FileInput` instance can be used as a context manager in the :" -"keyword:`with` statement. In this example, *input* is closed after the :" -"keyword:`!with` statement is exited, even if an exception occurs::" +"The :class:`FileInput` instance can be used as a context manager in " +"the :keyword:`with` statement. In this example, *input* is closed after " +"the :keyword:`!with` statement is exited, even if an exception occurs::" msgstr "" msgid "Can be used as a context manager." @@ -110,8 +110,9 @@ msgid "The keyword-only parameter *encoding* and *errors* are added." msgstr "" msgid "" -"The following functions use the global state created by :func:`fileinput." -"input`; if there is no active state, :exc:`RuntimeError` is raised." +"The following functions use the global state created " +"by :func:`fileinput.input`; if there is no active state, :exc:`RuntimeError` " +"is raised." msgstr "" msgid "" @@ -165,14 +166,13 @@ msgid "" msgstr "" msgid "" -"Class :class:`FileInput` is the implementation; its methods :meth:" -"`filename`, :meth:`fileno`, :meth:`lineno`, :meth:`filelineno`, :meth:" -"`isfirstline`, :meth:`isstdin`, :meth:`nextfile` and :meth:`close` " -"correspond to the functions of the same name in the module. In addition it " -"is :term:`iterable` and has a :meth:`~io.TextIOBase.readline` method which " -"returns the next input line. The sequence must be accessed in strictly " -"sequential order; random access and :meth:`~io.TextIOBase.readline` cannot " -"be mixed." +"Class :class:`FileInput` is the implementation; its " +"methods :meth:`filename`, :meth:`fileno`, :meth:`lineno`, :meth:`filelineno`, :meth:`isfirstline`, :meth:`isstdin`, :meth:`nextfile` " +"and :meth:`close` correspond to the functions of the same name in the " +"module. In addition it is :term:`iterable` and has " +"a :meth:`~io.TextIOBase.readline` method which returns the next input line. " +"The sequence must be accessed in strictly sequential order; random access " +"and :meth:`~io.TextIOBase.readline` cannot be mixed." msgstr "" msgid "" @@ -192,9 +192,9 @@ msgid "" msgstr "" msgid "" -"A :class:`FileInput` instance can be used as a context manager in the :" -"keyword:`with` statement. In this example, *input* is closed after the :" -"keyword:`!with` statement is exited, even if an exception occurs::" +"A :class:`FileInput` instance can be used as a context manager in " +"the :keyword:`with` statement. In this example, *input* is closed after " +"the :keyword:`!with` statement is exited, even if an exception occurs::" msgstr "" msgid "The keyword parameter *mode* and *openhook* are now keyword-only." @@ -234,8 +234,8 @@ msgid "" msgstr "" msgid "" -"Usage example: ``fi = fileinput.FileInput(openhook=fileinput." -"hook_compressed, encoding=\"utf-8\")``" +"Usage example: ``fi = " +"fileinput.FileInput(openhook=fileinput.hook_compressed, encoding=\"utf-8\")``" msgstr "" msgid "" @@ -244,14 +244,15 @@ msgid "" msgstr "" msgid "" -"Usage example: ``fi = fileinput.FileInput(openhook=fileinput." -"hook_encoded(\"utf-8\", \"surrogateescape\"))``" +"Usage example: ``fi = " +"fileinput.FileInput(openhook=fileinput.hook_encoded(\"utf-8\", " +"\"surrogateescape\"))``" msgstr "" msgid "Added the optional *errors* parameter." msgstr "" msgid "" -"This function is deprecated since :func:`fileinput.input` and :class:" -"`FileInput` now have *encoding* and *errors* parameters." +"This function is deprecated since :func:`fileinput.input` " +"and :class:`FileInput` now have *encoding* and *errors* parameters." msgstr "" diff --git a/library/fnmatch.po b/library/fnmatch.po index 6d75b82838..9790a9602c 100644 --- a/library/fnmatch.po +++ b/library/fnmatch.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!fnmatch` --- Unix filename pattern matching" msgstr "" msgid "**Source code:** :source:`Lib/fnmatch.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/fnmatch.py`" msgid "" "This module provides support for Unix shell-style wildcards, which are *not* " @@ -73,10 +72,10 @@ msgstr "" msgid "" "Note that the filename separator (``'/'`` on Unix) is *not* special to this " -"module. See module :mod:`glob` for pathname expansion (:mod:`glob` uses :" -"func:`.filter` to match pathname segments). Similarly, filenames starting " -"with a period are not special for this module, and are matched by the ``*`` " -"and ``?`` patterns." +"module. See module :mod:`glob` for pathname expansion (:mod:`glob` " +"uses :func:`.filter` to match pathname segments). Similarly, filenames " +"starting with a period are not special for this module, and are matched by " +"the ``*`` and ``?`` patterns." msgstr "" msgid "" @@ -87,16 +86,16 @@ msgid "" msgstr "" msgid "" -"Finally, note that :func:`functools.lru_cache` with a *maxsize* of 32768 is " +"Finally, note that :deco:`functools.lru_cache` with a *maxsize* of 32768 is " "used to cache the (typed) compiled regex patterns in the following " "functions: :func:`fnmatch`, :func:`fnmatchcase`, :func:`.filter`." msgstr "" msgid "" "Test whether the filename string *name* matches the pattern string *pat*, " -"returning ``True`` or ``False``. Both parameters are case-normalized using :" -"func:`os.path.normcase`. :func:`fnmatchcase` can be used to perform a case-" -"sensitive comparison, regardless of whether that's standard for the " +"returning ``True`` or ``False``. Both parameters are case-normalized " +"using :func:`os.path.normcase`. :func:`fnmatchcase` can be used to perform a " +"case-sensitive comparison, regardless of whether that's standard for the " "operating system." msgstr "" diff --git a/library/fractions.po b/library/fractions.po index b402aec807..7e9dff1303 100644 --- a/library/fractions.po +++ b/library/fractions.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: -# Transifex Bot <>, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2025-07-11 15:02+0000\n" +"PO-Revision-Date: 2025-05-08 05: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" @@ -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 ":mod:`fractions` --- Rational numbers" +msgid ":mod:`!fractions` --- Rational numbers" msgstr "" msgid "**Source code:** :source:`Lib/fractions.py`" @@ -41,46 +41,76 @@ msgstr "" msgid "" "The first version requires that *numerator* and *denominator* are instances " "of :class:`numbers.Rational` and returns a new :class:`Fraction` instance " -"with value ``numerator/denominator``. If *denominator* is :const:`0`, it " -"raises a :exc:`ZeroDivisionError`. The second version requires that " -"*other_fraction* is an instance of :class:`numbers.Rational` and returns a :" -"class:`Fraction` instance with the same value. The next two versions accept " -"either a :class:`float` or a :class:`decimal.Decimal` instance, and return " -"a :class:`Fraction` instance with exactly the same value. Note that due to " -"the usual issues with binary floating-point (see :ref:`tut-fp-issues`), the " -"argument to ``Fraction(1.1)`` is not exactly equal to 11/10, and so " -"``Fraction(1.1)`` does *not* return ``Fraction(11, 10)`` as one might " +"with value ``numerator/denominator``. If *denominator* is ``0``, it raises " +"a :exc:`ZeroDivisionError`. The second version requires that " +"*other_fraction* is an instance of :class:`numbers.Rational` and returns " +"a :class:`Fraction` instance with the same value. The next two versions " +"accept either a :class:`float` or a :class:`decimal.Decimal` instance, and " +"return a :class:`Fraction` instance with exactly the same value. Note that " +"due to the usual issues with binary floating point (see :ref:`tut-fp-" +"issues`), the argument to ``Fraction(1.1)`` is not exactly equal to 11/10, " +"and so ``Fraction(1.1)`` does *not* return ``Fraction(11, 10)`` as one might " "expect. (But see the documentation for the :meth:`limit_denominator` method " "below.) The last version of the constructor expects a string or unicode " "instance. The usual form for this instance is::" msgstr "" +msgid "[sign] numerator ['/' denominator]" +msgstr "" + msgid "" "where the optional ``sign`` may be either '+' or '-' and ``numerator`` and " "``denominator`` (if present) are strings of decimal digits (underscores may " "be used to delimit digits as with integral literals in code). In addition, " -"any string that represents a finite value and is accepted by the :class:" -"`float` constructor is also accepted by the :class:`Fraction` constructor. " -"In either form the input string may also have leading and/or trailing " -"whitespace. Here are some examples::" +"any string that represents a finite value and is accepted by " +"the :class:`float` constructor is also accepted by the :class:`Fraction` " +"constructor. In either form the input string may also have leading and/or " +"trailing whitespace. Here are some examples::" +msgstr "" + +msgid "" +">>> from fractions import Fraction\n" +">>> Fraction(16, -10)\n" +"Fraction(-8, 5)\n" +">>> Fraction(123)\n" +"Fraction(123, 1)\n" +">>> Fraction()\n" +"Fraction(0, 1)\n" +">>> Fraction('3/7')\n" +"Fraction(3, 7)\n" +">>> Fraction(' -3/7 ')\n" +"Fraction(-3, 7)\n" +">>> Fraction('1.414213 \\t\\n')\n" +"Fraction(1414213, 1000000)\n" +">>> Fraction('-.125')\n" +"Fraction(-1, 8)\n" +">>> Fraction('7e-6')\n" +"Fraction(7, 1000000)\n" +">>> Fraction(2.25)\n" +"Fraction(9, 4)\n" +">>> Fraction(1.1)\n" +"Fraction(2476979795053773, 2251799813685248)\n" +">>> from decimal import Decimal\n" +">>> Fraction(Decimal('1.1'))\n" +"Fraction(11, 10)" msgstr "" msgid "" -"The :class:`Fraction` class inherits from the abstract base class :class:" -"`numbers.Rational`, and implements all of the methods and operations from " -"that class. :class:`Fraction` instances are :term:`hashable`, and should be " -"treated as immutable. In addition, :class:`Fraction` has the following " -"properties and methods:" +"The :class:`Fraction` class inherits from the abstract base " +"class :class:`numbers.Rational`, and implements all of the methods and " +"operations from that class. :class:`Fraction` instances " +"are :term:`hashable`, and should be treated as immutable. In " +"addition, :class:`Fraction` has the following properties and methods:" msgstr "" msgid "" -"The :class:`Fraction` constructor now accepts :class:`float` and :class:" -"`decimal.Decimal` instances." +"The :class:`Fraction` constructor now accepts :class:`float` " +"and :class:`decimal.Decimal` instances." msgstr "" msgid "" "The :func:`math.gcd` function is now used to normalize the *numerator* and " -"*denominator*. :func:`math.gcd` always return a :class:`int` type. " +"*denominator*. :func:`math.gcd` always returns an :class:`int` type. " "Previously, the GCD type depended on *numerator* and *denominator*." msgstr "" @@ -90,8 +120,23 @@ msgid "" msgstr "" msgid "" -":class:`Fraction` implements ``__int__`` now to satisfy ``typing." -"SupportsInt`` instance checks." +":class:`Fraction` implements ``__int__`` now to satisfy " +"``typing.SupportsInt`` instance checks." +msgstr "" + +msgid "" +"Space is allowed around the slash for string inputs: ``Fraction('2 / 3')``." +msgstr "" + +msgid "" +":class:`Fraction` instances now support float-style formatting, with " +"presentation types ``\"e\"``, ``\"E\"``, ``\"f\"``, ``\"F\"``, ``\"g\"``, " +"``\"G\"`` and ``\"%\"\"``." +msgstr "" + +msgid "" +"Formatting of :class:`Fraction` instances without a presentation type now " +"supports fill, alignment, sign handling, minimum width and grouping." msgstr "" msgid "Numerator of the Fraction in lowest term." @@ -101,14 +146,17 @@ msgid "Denominator of the Fraction in lowest term." msgstr "" msgid "" -"Return a tuple of two integers, whose ratio is equal to the Fraction and " -"with a positive denominator." +"Return a tuple of two integers, whose ratio is equal to the original " +"Fraction. The ratio is in lowest terms and has a positive denominator." +msgstr "" + +msgid "Return ``True`` if the Fraction is an integer." msgstr "" msgid "" -"Alternative constructor which only accepts instances of :class:`float` or :" -"class:`numbers.Integral`. Beware that ``Fraction.from_float(0.3)`` is not " -"the same value as ``Fraction(3, 10)``." +"Alternative constructor which only accepts instances of :class:`float` " +"or :class:`numbers.Integral`. Beware that ``Fraction.from_float(0.3)`` is " +"not the same value as ``Fraction(3, 10)``." msgstr "" msgid "" @@ -117,8 +165,8 @@ msgid "" msgstr "" msgid "" -"Alternative constructor which only accepts instances of :class:`decimal." -"Decimal` or :class:`numbers.Integral`." +"Alternative constructor which only accepts instances " +"of :class:`decimal.Decimal` or :class:`numbers.Integral`." msgstr "" msgid "" @@ -149,8 +197,56 @@ msgid "" "The first version returns the nearest :class:`int` to ``self``, rounding " "half to even. The second version rounds ``self`` to the nearest multiple of " "``Fraction(1, 10**ndigits)`` (logically, if ``ndigits`` is negative), again " -"rounding half toward even. This method can also be accessed through the :" -"func:`round` function." +"rounding half toward even. This method can also be accessed through " +"the :func:`round` function." +msgstr "" + +msgid "" +"Provides support for formatting of :class:`Fraction` instances via " +"the :meth:`str.format` method, the :func:`format` built-in function, " +"or :ref:`Formatted string literals `." +msgstr "" + +msgid "" +"If the ``format_spec`` format specification string does not end with one of " +"the presentation types ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, ``'G'`` " +"or ``'%'`` then formatting follows the general rules for fill, alignment, " +"sign handling, minimum width, and grouping as described in the :ref:`format " +"specification mini-language `. The \"alternate form\" flag " +"``'#'`` is supported: if present, it forces the output string to always " +"include an explicit denominator, even when the value being formatted is an " +"exact integer. The zero-fill flag ``'0'`` is not supported." +msgstr "" + +msgid "" +"If the ``format_spec`` format specification string ends with one of the " +"presentation types ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, ``'G'`` or " +"``'%'`` then formatting follows the rules outlined for the :class:`float` " +"type in the :ref:`formatspec` section." +msgstr "" + +msgid "Here are some examples::" +msgstr "Berikut beberapa contoh::" + +msgid "" +">>> from fractions import Fraction\n" +">>> format(Fraction(103993, 33102), '_')\n" +"'103_993/33_102'\n" +">>> format(Fraction(1, 7), '.^+10')\n" +"'...+1/7...'\n" +">>> format(Fraction(3, 1), '')\n" +"'3'\n" +">>> format(Fraction(3, 1), '#')\n" +"'3/1'\n" +">>> format(Fraction(1, 7), '.40g')\n" +"'0.1428571428571428571428571428571428571429'\n" +">>> format(Fraction('1234567.855'), '_.2f')\n" +"'1_234_567.86'\n" +">>> f\"{Fraction(355, 113):*>20.6e}\"\n" +"'********3.141593e+00'\n" +">>> old_price, new_price = 499, 672\n" +">>> \"{:.2%} price increase\".format(Fraction(new_price, old_price) - 1)\n" +"'34.67% price increase'" msgstr "" msgid "Module :mod:`numbers`" diff --git a/library/ftplib.po b/library/ftplib.po index 1f8f987f0b..f4fb99b461 100644 --- a/library/ftplib.po +++ b/library/ftplib.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,15 +28,15 @@ msgid ":mod:`!ftplib` --- FTP protocol client" msgstr "" msgid "**Source code:** :source:`Lib/ftplib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/ftplib.py`" msgid "" -"This module defines the class :class:`FTP` and a few related items. The :" -"class:`FTP` class implements the client side of the FTP protocol. You can " -"use this to write Python programs that perform a variety of automated FTP " -"jobs, such as mirroring other FTP servers. It is also used by the module :" -"mod:`urllib.request` to handle URLs that use FTP. For more information on " -"FTP (File Transfer Protocol), see internet :rfc:`959`." +"This module defines the class :class:`FTP` and a few related items. " +"The :class:`FTP` class implements the client side of the FTP protocol. You " +"can use this to write Python programs that perform a variety of automated " +"FTP jobs, such as mirroring other FTP servers. It is also used by the " +"module :mod:`urllib.request` to handle URLs that use FTP. For more " +"information on FTP (File Transfer Protocol), see internet :rfc:`959`." msgstr "" msgid "The default encoding is UTF-8, following :rfc:`2640`." @@ -75,7 +75,7 @@ msgid "" msgstr "" msgid "Reference" -msgstr "" +msgstr "Dokumentacja" msgid "FTP objects" msgstr "" @@ -123,8 +123,8 @@ msgid "*source_address* parameter was added." msgstr "" msgid "" -"If the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to prevent the creation of a non-blocking socket. The " +"If the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to prevent the creation of a non-blocking socket. The " "*encoding* parameter was added, and the default was changed from Latin-1 to " "UTF-8 to follow :rfc:`2640`." msgstr "" @@ -265,9 +265,9 @@ msgid "An appropriate ``STOR`` command: :samp:`\"STOR {filename}\"`." msgstr "" msgid "" -"A file object (opened in binary mode) which is read until EOF, using its :" -"meth:`~io.RawIOBase.read` method in blocks of size *blocksize* to provide " -"the data to be stored." +"A file object (opened in binary mode) which is read until EOF, using " +"its :meth:`~io.RawIOBase.read` method in blocks of size *blocksize* to " +"provide the data to be stored." msgstr "" msgid "The read block size. Defaults to ``8192``." @@ -317,14 +317,14 @@ msgid "" msgstr "" msgid "" -"List a directory in a standardized format by using ``MLSD`` command (:rfc:" -"`3659`). If *path* is omitted the current directory is assumed. *facts* is " -"a list of strings representing the type of information desired (e.g. " -"``[\"type\", \"size\", \"perm\"]``). Return a generator object yielding a " -"tuple of two elements for every file found in path. First element is the " -"file name, the second one is a dictionary containing facts about the file " -"name. Content of this dictionary might be limited by the *facts* argument " -"but server is not guaranteed to return all requested facts." +"List a directory in a standardized format by using ``MLSD`` command " +"(:rfc:`3659`). If *path* is omitted the current directory is assumed. " +"*facts* is a list of strings representing the type of information desired " +"(e.g. ``[\"type\", \"size\", \"perm\"]``). Return a generator object " +"yielding a tuple of two elements for every file found in path. First " +"element is the file name, the second one is a dictionary containing facts " +"about the file name. Content of this dictionary might be limited by the " +"*facts* argument but server is not guaranteed to return all requested facts." msgstr "" msgid "" @@ -394,14 +394,14 @@ msgid "FTP_TLS objects" msgstr "" msgid "" -"An :class:`FTP` subclass which adds TLS support to FTP as described in :rfc:" -"`4217`. Connect to port 21 implicitly securing the FTP control connection " -"before authenticating." +"An :class:`FTP` subclass which adds TLS support to FTP as described " +"in :rfc:`4217`. Connect to port 21 implicitly securing the FTP control " +"connection before authenticating." msgstr "" msgid "" -"The user must explicitly secure the data connection by calling the :meth:" -"`prot_p` method." +"The user must explicitly secure the data connection by calling " +"the :meth:`prot_p` method." msgstr "" msgid "" @@ -419,8 +419,9 @@ msgid "Added the *source_address* parameter." msgstr "" msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The class now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "The deprecated *keyfile* and *certfile* parameters have been removed." @@ -459,8 +460,9 @@ msgid "" msgstr "" msgid "" -"The method now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The method now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "" diff --git a/library/functional.po b/library/functional.po index e075c6473c..0423458626 100644 --- a/library/functional.po +++ b/library/functional.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/library/functions.po b/library/functions.po index 4a114d2036..778ad6c47d 100644 --- a/library/functions.po +++ b/library/functions.po @@ -1,24 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# haaritsubaki, 2023 -# Ciarbin , 2024 -# Wiktor Matuszewski , 2024 -# Stan Ulbrych, 2024 -# Maciej Olko , 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-08-25 16:23+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -324,9 +320,9 @@ msgid "" "Return an :term:`asynchronous iterator` for an :term:`asynchronous " "iterable`. Equivalent to calling ``x.__aiter__()``." msgstr "" -"Zwraca :term:`asynchroniczny iterator ` dla :term:" -"`asynchronicznego iterable'a `. Ekwiwalent wywołania " -"``x.__aiter__()``." +"Zwraca :term:`asynchroniczny iterator ` " +"dla :term:`asynchronicznego iterable'a `. Ekwiwalent " +"wywołania ``x.__aiter__()``." msgid "Note: Unlike :func:`iter`, :func:`aiter` has no 2-argument variant." msgstr "" @@ -357,9 +353,9 @@ msgid "" "When awaited, return the next item from the given :term:`asynchronous " "iterator`, or *default* if given and the iterator is exhausted." msgstr "" -"W przypadku oczekiwania zwraca następny element z podanego :term:" -"`asynchronicznego iteratora ` lub wartość *default*, " -"jeżeli jest ona podana, a iterator został wyczerpany." +"W przypadku oczekiwania zwraca następny element z " +"podanego :term:`asynchronicznego iteratora ` lub " +"wartość *default*, jeżeli jest ona podana, a iterator został wyczerpany." msgid "" "This is the async variant of the :func:`next` builtin, and behaves similarly." @@ -373,11 +369,11 @@ msgid "" "iterator. If *default* is given, it is returned if the iterator is " "exhausted, otherwise :exc:`StopAsyncIteration` is raised." msgstr "" -"Wywołuje on metodę :meth:`~object.__anext__` *async_iteratora*, zwracając :" -"term:`awaitable`. Oczekiwanie zwraca następną wartość iteratora. Jeśli " -"podano wartość *default*, jest ona zwracana, jeśli iterator zostanie " -"wyczerpany, w przeciwnym razie zostanie podniesiony wyjątek :exc:" -"`StopAsyncIteration`." +"Wywołuje on metodę :meth:`~object.__anext__` *async_iteratora*, " +"zwracając :term:`awaitable`. Oczekiwanie zwraca następną wartość iteratora. " +"Jeśli podano wartość *default*, jest ona zwracana, jeśli iterator zostanie " +"wyczerpany, w przeciwnym razie zostanie podniesiony " +"wyjątek :exc:`StopAsyncIteration`." msgid "" "Return ``True`` if any element of the *iterable* is true. If the iterable " @@ -401,9 +397,9 @@ msgstr "" msgid "" "As :func:`repr`, return a string containing a printable representation of an " -"object, but escape the non-ASCII characters in the string returned by :func:" -"`repr` using ``\\x``, ``\\u``, or ``\\U`` escapes. This generates a string " -"similar to that returned by :func:`repr` in Python 2." +"object, but escape the non-ASCII characters in the string returned " +"by :func:`repr` using ``\\x``, ``\\u``, or ``\\U`` escapes. This generates " +"a string similar to that returned by :func:`repr` in Python 2." msgstr "" "Tak jak :func:`repr`, zwraca ciąg znaków zawierający reprezentację obiektu, " "ale wypisuje znaki nie-ASCII w zwracanym przez :func:`repr` ciągu przy " @@ -412,12 +408,12 @@ msgstr "" 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:`~object.__index__` method that returns an " -"integer. Some examples:" +"result is a valid Python expression. If *integer* is not a " +"Python :class:`int` object, it has to define an :meth:`~object.__index__` " +"method that returns an integer. Some examples:" msgstr "" "Konwertuje liczbę całkowitą do binarnego ciągu znaków z prefiksem „0b”. " -"Wynik jest poprawnym wyrażeniem Pythona. Jeśli *x* nie jest pythonowym " +"Wynik jest poprawnym wyrażeniem Pythona. Jeśli *integer* nie jest pythonowym " "obiektem :class:`int`, musi definiować metodę :meth:`~object.__index__`, " "która zwraca liczbę całkowitą. Kilka przykładów:" @@ -428,6 +424,12 @@ msgstr "" "Jeśli prefiks „0b” nie jest pożądany, możesz użyć któregoś z poniższych " "sposobów." +msgid "" +"See also :func:`enum.bin` to represent negative values as twos-complement." +msgstr "" +"Patrz również :func:`enum.bin` do reprezentowania ujemnych wartości w kodzie " +"uzupełnień do dwóch." + msgid "See also :func:`format` for more information." msgstr "Zobacz też :func:`format` by uzyskać więcej informacji." @@ -435,17 +437,17 @@ msgid "" "Return a Boolean value, i.e. one of ``True`` or ``False``. The argument is " "converted using the standard :ref:`truth testing procedure `. If the " "argument is false or omitted, this returns ``False``; otherwise, it returns " -"``True``. The :class:`bool` class is a subclass of :class:`int` (see :ref:" -"`typesnumeric`). It cannot be subclassed further. Its only instances are " -"``False`` and ``True`` (see :ref:`typebool`)." +"``True``. The :class:`bool` class is a subclass of :class:`int` " +"(see :ref:`typesnumeric`). It cannot be subclassed further. Its only " +"instances are ``False`` and ``True`` (see :ref:`typebool`)." msgstr "" "Zwraca wartość logiczną, tj. jedno z ``True`` lub ``False``. Wartość " -"argumentu jest konwertowana przy użyciu standardowej procedury testowania :" -"ref:`truth testing procedure`. Jeśli argument jest fałszywy lub " -"pominięty, zwraca ``False``; w przeciwnym razie, zwraca ``True``. Klasa :" -"class:`bool` jest podklasą klasy :class:`int` (zobacz :ref:`typesnumeric`). " -"Nie może być dalej podklasowana. Jej jedynymi instancjami są ``False`` i " -"``True`` (zobacz :ref:`typebool`)." +"argumentu jest konwertowana przy użyciu standardowej procedury " +"testowania :ref:`truth testing procedure`. Jeśli argument jest " +"fałszywy lub pominięty, zwraca ``False``; w przeciwnym razie, zwraca " +"``True``. Klasa :class:`bool` jest podklasą klasy :class:`int` " +"(zobacz :ref:`typesnumeric`). Nie może być dalej podklasowana. Jej jedynymi " +"instancjami są ``False`` i ``True`` (zobacz :ref:`typebool`)." msgid "The parameter is now positional-only." msgstr "Parametr jest teraz tylko-pozycyjny." @@ -465,17 +467,17 @@ msgstr "" "szczególności wywołuje :func:`sys.breakpointhook`, przekazując do niego " "bezpośrednio ``args`` i ``kws``. Domyślnie ``sys.breakpointhook()`` wywołuje " "funkcję :func:`pdb.set_trace` nie oczekującą argumentu. W tym przypadku jest " -"to wyłącznie funkcja dla wygody, aby nie trzeba było jawnie importować :mod:" -"`pdb` ani wpisywać tak dużo kodu, aby wejść do debuggera. Jednakże :func:" -"`sys.breakpointhook` może być ustawiony na inną funkcję i :func:`breakpoint` " -"automatycznie wywoła ją, pozwalając na przejście do wybranego debuggera. " -"Jeśli :func:`sys.breakpointhook` nie jest dostępny, funkcja rzuci :exc:" -"`RuntimeError`." +"to wyłącznie funkcja dla wygody, aby nie trzeba było jawnie " +"importować :mod:`pdb` ani wpisywać tak dużo kodu, aby wejść do debuggera. " +"Jednakże :func:`sys.breakpointhook` może być ustawiony na inną funkcję " +"i :func:`breakpoint` automatycznie wywoła ją, pozwalając na przejście do " +"wybranego debuggera. Jeśli :func:`sys.breakpointhook` nie jest dostępny, " +"funkcja rzuci :exc:`RuntimeError`." msgid "" -"By default, the behavior of :func:`breakpoint` can be changed with the :" -"envvar:`PYTHONBREAKPOINT` environment variable. See :func:`sys." -"breakpointhook` for usage details." +"By default, the behavior of :func:`breakpoint` can be changed with " +"the :envvar:`PYTHONBREAKPOINT` environment variable. " +"See :func:`sys.breakpointhook` for usage details." msgstr "" "Domyślnie zachowanie funkcji :func:`breakpoint` można zmienić za pomocą " "zmiennej środowiskowej :envvar:`PYTHONBREAKPOINT`. Szczegółowe informacje " @@ -485,8 +487,8 @@ msgid "" "Note that this is not guaranteed if :func:`sys.breakpointhook` has been " "replaced." msgstr "" -"Należy pamiętać, że nie jest to gwarantowane, jeśli :func:`sys." -"breakpointhook` został wymieniony." +"Należy pamiętać, że nie jest to gwarantowane, " +"jeśli :func:`sys.breakpointhook` został wymieniony." msgid "" "Raises an :ref:`auditing event ` ``builtins.breakpoint`` with " @@ -554,8 +556,8 @@ msgstr "Zobacz też :ref:`binaryseq` i :ref:`typebytearray`." msgid "" "Return a new \"bytes\" object which is an immutable sequence of integers in " -"the range ``0 <= x < 256``. :class:`bytes` is an immutable version of :" -"class:`bytearray` -- it has the same non-mutating methods and the same " +"the range ``0 <= x < 256``. :class:`bytes` is an immutable version " +"of :class:`bytearray` -- it has the same non-mutating methods and the same " "indexing and slicing behavior." msgstr "" "Zwraca nowy obiekt „bajtów”, który jest niemutowalną sekwencją liczb " @@ -576,18 +578,19 @@ msgid "See also :ref:`binaryseq`, :ref:`typebytes`, and :ref:`bytes-methods`." msgstr "Zobacz też :ref:`binaryseq`, :ref:`typebytes` i :ref:`bytes-methods`." msgid "" -"Return :const:`True` if the *object* argument appears callable, :const:" -"`False` if not. If this returns ``True``, it is still possible that a call " -"fails, but if it is ``False``, calling *object* will never succeed. Note " -"that classes are callable (calling a class returns a new instance); " -"instances are callable if their class has a :meth:`~object.__call__` method." +"Return :const:`True` if the *object* argument appears " +"callable, :const:`False` if not. If this returns ``True``, it is still " +"possible that a call fails, but if it is ``False``, calling *object* will " +"never succeed. Note that classes are callable (calling a class returns a new " +"instance); instances are callable if their class has " +"a :meth:`~object.__call__` method." msgstr "" -"Zwraca :const:`True` jeśli argument *object* jest wywoływalny, :const:" -"`False` jeśli nie. Jeśli zwraca ``True``, nadal możliwe jest, że wywołanie " -"nie powiedzie się, ale jeśli zwraca ``False``, wywołanie *object* nigdy się " -"nie powiedzie. Należy pamiętać, że klasy są wywoływalne (wywołanie klasy " -"zwraca nową instancję); instancje są wywoływalne, jeśli ich klasa ma metodę :" -"meth:`~object.__call__`." +"Zwraca :const:`True` jeśli argument *object* jest " +"wywoływalny, :const:`False` jeśli nie. Jeśli zwraca ``True``, nadal możliwe " +"jest, że wywołanie nie powiedzie się, ale jeśli zwraca ``False``, wywołanie " +"*object* nigdy się nie powiedzie. Należy pamiętać, że klasy są wywoływalne " +"(wywołanie klasy zwraca nową instancję); instancje są wywoływalne, jeśli ich " +"klasa ma metodę :meth:`~object.__call__`." msgid "" "This function was first removed in Python 3.0 and then brought back in " @@ -597,21 +600,21 @@ msgstr "" "Pythonie 3.2." msgid "" -"Return the string representing a character whose Unicode code point is the " -"integer *i*. For example, ``chr(97)`` returns the string ``'a'``, while " +"Return the string representing a character with the specified Unicode code " +"point. For example, ``chr(97)`` returns the string ``'a'``, while " "``chr(8364)`` returns the string ``'€'``. This is the inverse of :func:`ord`." msgstr "" -"Zwraca ciąg znaków reprezentujący znak, którego punktem kodowym Unicode jest " -"liczba całkowita *i*. Na przykład ``chr(97)`` zwraca ciąg znaków ``'a'``, a " -"``chr(8364)`` zwraca ciąg ``'€'``. Jest odwrotnością :func:`ord`." +"Zwraca ciąg znaków reprezentujący znak dla podanego punktu kodowego Unicode. " +"Na przykład ``chr(97)`` zwraca ciąg znaków ``'a'``, a ``chr(8364)`` zwraca " +"ciąg ``'€'``. Jest odwrotnością :func:`ord`." msgid "" "The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in " -"base 16). :exc:`ValueError` will be raised if *i* is outside that range." +"base 16). :exc:`ValueError` will be raised if it is outside that range." msgstr "" "Poprawnym zakresem argumentu są wartości od 0 do 1 114 111 (0x10FFFF w " -"systemie szesnastkowym). Dla *i* poza tym zakresem zostanie rzucony :exc:" -"`ValueError`." +"systemie szesnastkowym). Dla wartości poza tym zakresem zostanie " +"rzucony :exc:`ValueError`." msgid "Transform a method into a class method." msgstr "Przekształca metodę w metodę klasową." @@ -635,8 +638,8 @@ msgstr "" " def f(cls, arg1, arg2): ..." msgid "" -"The ``@classmethod`` form is a function :term:`decorator` -- see :ref:" -"`function` for details." +"The ``@classmethod`` form is a function :term:`decorator` -- " +"see :ref:`function` for details." msgstr "" "Forma ``@classmethod`` jest :term:`dekoratorem ` funkcji – " "szczegóły znajdziesz w :ref:`function`." @@ -663,22 +666,21 @@ msgstr "" "metodach klasowych znajdziesz w :ref:`types`." msgid "" -"Class methods can now wrap other :term:`descriptors ` such as :" -"func:`property`." +"Class methods can now wrap other :term:`descriptors ` such " +"as :func:`property`." msgstr "" "Metody klasowe mogą teraz opakowywać inne :term:`deskryptory `, " "takie jak :func:`property`." msgid "" -"Class methods now inherit the method attributes (:attr:`~function." -"__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :" -"attr:`~function.__doc__` and :attr:`~function.__annotations__`) and have a " -"new ``__wrapped__`` attribute." +"Class methods now inherit the method attributes " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"and :attr:`~function.__annotations__`) and have a new ``__wrapped__`` " +"attribute." msgstr "" -"Metody klasowe dziedziczą teraz atrybuty metod (:attr:`~function." -"__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :" -"attr:`~function.__doc__` i :attr:`~function.__annotations__`) i mają nowy " -"atrybut ``__wrapped__``." +"Metody klasowe dziedziczą teraz atrybuty metod " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"i :attr:`~function.__annotations__`) i mają nowy atrybut ``__wrapped__``." msgid "" "Class methods can no longer wrap other :term:`descriptors ` such " @@ -722,23 +724,23 @@ msgstr "" "zostaną wydrukowane na standardowe wyjście)." msgid "" -"The optional arguments *flags* and *dont_inherit* control which :ref:" -"`compiler options ` should be activated and which :ref:" -"`future features ` should be allowed. If neither is present (or both " -"are zero) the code is compiled with the same flags that affect the code that " -"is calling :func:`compile`. If the *flags* argument is given and " -"*dont_inherit* is not (or is zero) then the compiler options and the future " -"statements specified by the *flags* argument are used in addition to those " -"that would be used anyway. If *dont_inherit* is a non-zero integer then the " -"*flags* argument is it -- the flags (future features and compiler options) " -"in the surrounding code are ignored." +"The optional arguments *flags* and *dont_inherit* control " +"which :ref:`compiler options ` should be activated and " +"which :ref:`future features ` should be allowed. If neither is " +"present (or both are zero) the code is compiled with the same flags that " +"affect the code that is calling :func:`compile`. If the *flags* argument is " +"given and *dont_inherit* is not (or is zero) then the compiler options and " +"the future statements specified by the *flags* argument are used in addition " +"to those that would be used anyway. If *dont_inherit* is a non-zero integer " +"then the *flags* argument is it -- the flags (future features and compiler " +"options) in the surrounding code are ignored." msgstr "" "Opcjonalne argumenty *flags* i *dont_inherit* kontrolują, które :ref:`opcje " -"kompilatora ` powinny być aktywowane i które :ref:" -"`przyszłe funkcje ` powinne być dozwolone. Jeśli żaden z nich nie " -"jest obecny (lub oba są zerowe), kod jest kompilowany z tymi samymi flagami, " -"które wpływają na kod wywołujący :func:`compile`. Jeśli argument *flags* " -"jest podany, a *dont_inherit* nie jest (lub wynosi zero), to opcje " +"kompilatora ` powinny być aktywowane i " +"które :ref:`przyszłe funkcje ` powinne być dozwolone. Jeśli żaden z " +"nich nie jest obecny (lub oba są zerowe), kod jest kompilowany z tymi samymi " +"flagami, które wpływają na kod wywołujący :func:`compile`. Jeśli argument " +"*flags* jest podany, a *dont_inherit* nie jest (lub wynosi zero), to opcje " "kompilatora i przyszłe instrukcje określone przez argument *flags* są " "używane w dodatku do tych, które i tak byłyby użyte. Jeśli *dont_inherit* " "jest niezerową liczbą całkowitą, to argument *flags* jest nim – flagi " @@ -747,15 +749,17 @@ msgstr "" msgid "" "Compiler options and future statements are specified by bits which can be " "bitwise ORed together to specify multiple options. The bitfield required to " -"specify a given future feature can be found as the :attr:`~__future__." -"_Feature.compiler_flag` attribute on the :class:`~__future__._Feature` " -"instance in the :mod:`__future__` module. :ref:`Compiler flags ` can be found in :mod:`ast` module, with ``PyCF_`` prefix." +"specify a given future feature can be found as " +"the :attr:`~__future__._Feature.compiler_flag` attribute on " +"the :class:`~__future__._Feature` instance in the :mod:`__future__` " +"module. :ref:`Compiler flags ` can be found " +"in :mod:`ast` module, with ``PyCF_`` prefix." msgstr "" "Opcje kompilatora i przyszłe instrukcja są określone przez bity, które mogą " "być łączone bitowo w celu określenia wielu opcji. Pole bitowe wymagane do " -"określenia danej przyszłej funkcji można znaleźć jako :attr:`~__future__." -"_Feature.compiler_flag` atrybut na instancji :class:`~__future__._Feature` w " +"określenia danej przyszłej funkcji można znaleźć " +"jako :attr:`~__future__._Feature.compiler_flag` atrybut na " +"instancji :class:`~__future__._Feature` w " "module :mod:`__future__` . :ref:`Flagi kompilatora ` " "można znaleźć w module :mod:`ast` , z prefiksem ``PyCF_``." @@ -773,18 +777,18 @@ msgstr "" "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." +"This function raises :exc:`SyntaxError` or :exc:`ValueError` if the compiled " +"source is invalid." 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." +"To funkcja rzuci :exc:`SyntaxError` lub :exc:`ValueError` jeśli skompilowane " +"źródło jest nieprawidłowe." msgid "" -"If you want to parse Python code into its AST representation, see :func:`ast." -"parse`." +"If you want to parse Python code into its AST representation, " +"see :func:`ast.parse`." msgstr "" -"Jeśli chcesz przeanalizować kod Python do jego reprezentacji AST, zobacz :" -"func:`ast.parse`." +"Jeśli chcesz przeanalizować kod Python do jego reprezentacji AST, " +"zobacz :func:`ast.parse`." msgid "" "Raises an :ref:`auditing event ` ``compile`` with arguments " @@ -798,8 +802,8 @@ msgstr "" msgid "" "When compiling a string with multi-line code in ``'single'`` or ``'eval'`` " "mode, input must be terminated by at least one newline character. This is " -"to facilitate detection of incomplete and complete statements in the :mod:" -"`code` module." +"to facilitate detection of incomplete and complete statements in " +"the :mod:`code` module." msgstr "" "Podczas kompilacji napisem z kodem wielowierszowym w trybie ``'single'`` lub " "``'eval'``, dane wejściowe muszą być zakończone co najmniej jedną znak nowej " @@ -892,9 +896,9 @@ msgid "" "and ``')'``, which are ignored. The string must not contain whitespace " "between ``'+'``, ``'-'``, the ``'j'`` or ``'J'`` suffix, and the decimal " "number. For example, ``complex('1+2j')`` is fine, but ``complex('1 + 2j')`` " -"raises :exc:`ValueError`. More precisely, the input must conform to the :" -"token:`~float:complexvalue` production rule in the following grammar, after " -"parentheses and leading and trailing whitespace characters are removed:" +"raises :exc:`ValueError`. More precisely, the input must conform to " +"the :token:`~float:complexvalue` production rule in the following grammar, " +"after parentheses and leading and trailing whitespace characters are removed:" msgstr "" "Jeśli argument jest napisem, musi zawierać albo część rzeczywistą (w tym " "samym formacie co :func:`float`), albo część urojoną (w tym samym formacie, " @@ -911,17 +915,17 @@ msgstr "" msgid "" "If the argument is a number, the constructor serves as a numeric conversion " "like :class:`int` and :class:`float`. For a general Python object ``x``, " -"``complex(x)`` delegates to ``x.__complex__()``. If :meth:`~object." -"__complex__` is not defined then it falls back to :meth:`~object.__float__`. " -"If :meth:`!__float__` is not defined then it falls back to :meth:`~object." -"__index__`." +"``complex(x)`` delegates to ``x.__complex__()``. " +"If :meth:`~object.__complex__` is not defined then it falls back " +"to :meth:`~object.__float__`. If :meth:`!__float__` is not defined then it " +"falls back to :meth:`~object.__index__`." msgstr "" "Jeśli argument jest liczbą, konstruktor służy jako konwersja numeryczna, " "podobnie jak :class:`int` i :class:`float`. Dla ogólnego obiektu Python " -"``x`` , ``complex(x)`` deleguje do ``x.__complex__()``. Jeśli :meth:`~object." -"__complex__` nie jest zdefiniowane, to spada z powrotem do :meth:`~object." -"__float__`. Jeśli :meth:`!__float__` nie jest zdefiniowane, to spada z " -"powrotem do :meth:`~object.__index__`." +"``x`` , ``complex(x)`` deleguje do ``x.__complex__()``. " +"Jeśli :meth:`~object.__complex__` nie jest zdefiniowane, to spada z powrotem " +"do :meth:`~object.__float__`. Jeśli :meth:`!__float__` nie jest " +"zdefiniowane, to spada z powrotem do :meth:`~object.__index__`." msgid "" "If two arguments are provided or keyword arguments are used, each argument " @@ -953,11 +957,11 @@ msgstr "" "kodu." msgid "" -"Falls back to :meth:`~object.__index__` if :meth:`~object.__complex__` and :" -"meth:`~object.__float__` are not defined." +"Falls back to :meth:`~object.__index__` if :meth:`~object.__complex__` " +"and :meth:`~object.__float__` are not defined." msgstr "" -"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__complex__` i :" -"meth:`~object.__float__` nie są zdefiniowane." +"Powraca do :meth:`~object.__index__`, jeśli :meth:`~object.__complex__` " +"i :meth:`~object.__float__` nie są zdefiniowane." msgid "" "This is a relative of :func:`setattr`. The arguments are an object and a " @@ -974,18 +978,18 @@ msgstr "" msgid "" "Create a new dictionary. The :class:`dict` object is the dictionary class. " -"See :class:`dict` and :ref:`typesmapping` for documentation about this class." +"See also :ref:`typesmapping` for documentation about this class." msgstr "" -"Utwórz nowy słownik. Obiekt :class:`dict` jest klasą słownik. Dokumentacja " -"dotycząca tej klasy znajduje się na stronach :class:`dict` i :ref:" -"`typesmapping`." +"Tworzy nowy słownik. Obiekt :class:`dict` jest klasą wbudowaną. Zobacz " +"też :ref:`typesmapping` po więcej dokumentacji na temat tej klasy." msgid "" -"For other containers see the built-in :class:`list`, :class:`set`, and :" -"class:`tuple` classes, as well as the :mod:`collections` module." +"For other containers see the built-in :class:`list`, :class:`set`, " +"and :class:`tuple` classes, as well as the :mod:`collections` module." msgstr "" -"Inne kontenery można znaleźć w klasach wbudowanych :class:`list` , :class:" -"`set` i :class:`tuple`, a także moduł :mod:`collections` ." +"Inne kontenery można znaleźć w klasach " +"wbudowanych :class:`list` , :class:`set` i :class:`tuple`, a także " +"moduł :mod:`collections` ." msgid "" "Without arguments, return the list of names in the current local scope. " @@ -998,28 +1002,28 @@ msgstr "" msgid "" "If the object has a method named :meth:`~object.__dir__`, this method will " "be called and must return the list of attributes. This allows objects that " -"implement a custom :func:`~object.__getattr__` or :func:`~object." -"__getattribute__` function to customize the way :func:`dir` reports their " -"attributes." +"implement a custom :func:`~object.__getattr__` " +"or :func:`~object.__getattribute__` function to customize the " +"way :func:`dir` reports their attributes." msgstr "" "Jeśli obiekt posiada metodę o nazwie :meth:`~object.__dir__`, metoda ta " "zostanie wywołana i musi zwracać listę atrybut. Pozwala to obiektom, które " -"implementują niestandardowe :func:`~object.__getattr__` lub :func:`~object." -"__getattribute__` funkcje na dostosowanie sposobu, w jaki :func:`dir` " -"zgłasza ich atrybuty." +"implementują niestandardowe :func:`~object.__getattr__` " +"lub :func:`~object.__getattribute__` funkcje na dostosowanie sposobu, w " +"jaki :func:`dir` zgłasza ich atrybuty." msgid "" "If the object does not provide :meth:`~object.__dir__`, the function tries " "its best to gather information from the object's :attr:`~object.__dict__` " "attribute, if defined, and from its type object. The resulting list is not " -"necessarily complete and may be inaccurate when the object has a custom :" -"func:`~object.__getattr__`." +"necessarily complete and may be inaccurate when the object has a " +"custom :func:`~object.__getattr__`." msgstr "" "Jeśli obiekt nie udostępnia :meth:`~object.__dir__`, funkcja stara się " "zebrać informacje z :attr:`~object.__dict__` atrybut obiektu, jeśli jest " "zdefiniowany, oraz z jego obiektu typu. Wynikowa lista niekoniecznie jest " -"kompletna i może być niedokładna, jeśli obiekt ma niestandardowy :func:" -"`~object.__getattr__`." +"kompletna i może być niedokładna, jeśli obiekt ma " +"niestandardowy :func:`~object.__getattr__`." msgid "" "The default :func:`dir` mechanism behaves differently with different types " @@ -1074,10 +1078,10 @@ msgid "" "consisting of their quotient and remainder when using integer division. " "With mixed operand types, the rules for binary arithmetic operators apply. " "For integers, the result is the same as ``(a // b, a % b)``. For floating-" -"point numbers the result is ``(q, a % b)``, where *q* is usually ``math." -"floor(a / b)`` but may be 1 less than that. In any case ``q * b + a % b`` " -"is very close to *a*, if ``a % b`` is non-zero it has the same sign as *b*, " -"and ``0 <= abs(a % b) < abs(b)``." +"point numbers the result is ``(q, a % b)``, where *q* is usually " +"``math.floor(a / b)`` but may be 1 less than that. In any case ``q * b + a " +"% b`` is very close to *a*, if ``a % b`` is non-zero it has the same sign as " +"*b*, and ``0 <= abs(a % b) < abs(b)``." msgstr "" "Weź dwie (niezłożone) liczby jako argumenty i zwraca parę liczb składającą " "się z ich ilorazu i reszty, gdy używasz liczba całkowita dzielenia. W " @@ -1090,17 +1094,18 @@ msgstr "" "b) < abs(b)``." msgid "" -"Return an enumerate object. *iterable* must be a sequence, an :term:" -"`iterator`, or some other object which supports iteration. The :meth:" -"`~iterator.__next__` method of the iterator returned by :func:`enumerate` " -"returns a tuple containing a count (from *start* which defaults to 0) and " -"the values obtained from iterating over *iterable*." +"Return an enumerate object. *iterable* must be a sequence, " +"an :term:`iterator`, or some other object which supports iteration. " +"The :meth:`~iterator.__next__` method of the iterator returned " +"by :func:`enumerate` returns a tuple containing a count (from *start* which " +"defaults to 0) and the values obtained from iterating over *iterable*." msgstr "" "Zwraca obiekt wyliczeniowy. *iterable* musi być sekwencją, :term:`iteratorem " -"` lub innym obiektem obsługującym iterację. Metoda :meth:" -"`~iterator.__next__` iteratora zwróconego przez :func:`enumerate` zwraca " -"dwukrotkę zawierającą licznik (od *start*, który domyślnie wynosi 0) i " -"wartości uzyskane z iteracji na argumencie *iterable*." +"` lub innym obiektem obsługującym iterację. " +"Metoda :meth:`~iterator.__next__` iteratora zwróconego " +"przez :func:`enumerate` zwraca dwukrotkę zawierającą licznik (od *start*, " +"który domyślnie wynosi 0) i wartości uzyskane z iteracji na argumencie " +"*iterable*." msgid "Equivalent to::" msgstr "Odpowiednik::" @@ -1143,44 +1148,45 @@ msgid "Syntax errors are reported as exceptions." msgstr "Błędy składni są zgłaszane jako wyjątki." msgid "" -"This function executes arbitrary code. Calling it with user-supplied input " -"may lead to security vulnerabilities." -msgstr "" -"Ta funkcja wykonuje dowolny kod. Wywołanie go z danymi wejściowymi " -"dostarczonymi przez użytkownika może prowadzić do luk w zabezpieczeniach." - -msgid "" -"The *expression* argument is parsed and evaluated as a Python expression " -"(technically speaking, a condition list) using the *globals* and *locals* " -"mappings as global and local namespace. If the *globals* dictionary is " -"present and does not contain a value for the key ``__builtins__``, a " -"reference to the dictionary of the built-in module :mod:`builtins` is " -"inserted under that key before *expression* is parsed. That way you can " -"control what builtins are available to the executed code by inserting your " -"own ``__builtins__`` dictionary into *globals* before passing it to :func:" -"`eval`. If the *locals* mapping is omitted it defaults to the *globals* " -"dictionary. If both mappings are omitted, the expression is executed with " -"the *globals* and *locals* in the environment where :func:`eval` is called. " -"Note, *eval()* will only have access to the :term:`nested scopes ` (non-locals) in the enclosing environment if they are already " -"referenced in the scope that is calling :func:`eval` (e.g. via a :keyword:" -"`nonlocal` statement)." -msgstr "" -"Argument *expression* jest analizowany i ewaluowany jako wyrażenie Python " -"(technicznie rzecz biorąc, lista warunków) przy użyciu mapowań *globals* i " -"*locals* jako globalnej i lokalnej przestrzeni nazw. Jeśli *globals* " -"słownik jest obecny i nie zawiera wartości dla klucza ``__builtins__``, " -"odwołanie do słownika z wbudowanej moduły :mod:`builtins` jest wstawiane pod " -"tym kluczem, zanim *expression* zostanie przeanalizowane. W ten sposób " -"można kontrolować, jakie wbudowany są dostępne dla wykonywanego kodu, " -"wstawiając własne ``__builtins__`` słownik do *globals* przed przekazaniem " -"go do :func:`eval`. Jeśli mapowanie *locals* zostanie pominięte, domyślnie " -"będzie to *globals* słownik. Jeśli oba mapowania są pominięte, wyrażenie " -"jest wykonywane z *globals* i *locals* w środowisku, w którym wywoływane " -"jest :func:`eval`. Uwaga, *eval()* będzie miał dostęp do :term:" -"`zagnieżdżonych zakresów ` (non-locals) w otaczającym " -"środowisku tylko wtedy, gdy są one już przywoływane w zakresie, który " -"wywołuje :func:`eval` (np. poprzez instrukcję :keyword:`nonlocal` )." +"This function executes arbitrary code. Calling it with untrusted user-" +"supplied input will lead to security vulnerabilities." +msgstr "" +"Ta funkcja wykonuje dowolny kod. Wywołanie go z niezaufanymi danymi " +"wejściowymi dostarczonymi przez użytkownika prowadzi do luk w " +"zabezpieczeniach." + +msgid "" +"The *source* argument is parsed and evaluated as a Python expression " +"(technically speaking, an :ref:`expression list `) using the " +"*globals* and *locals* mappings as global and local namespace. If the " +"*globals* dictionary is present and does not contain a value for the key " +"``__builtins__``, a reference to the dictionary of the built-in " +"module :mod:`builtins` is inserted under that key before *source* is parsed. " +"Overriding ``__builtins__`` can be used to restrict or change the available " +"names, but this is **not** a security mechanism: the executed code can still " +"access all builtins. If the *locals* mapping is omitted it defaults to the " +"*globals* dictionary. If both mappings are omitted, the source is executed " +"with the *globals* and *locals* in the environment where :func:`eval` is " +"called. Note, *eval()* will only have access to the :term:`nested scopes " +"` (non-locals) in the enclosing environment if they are " +"already referenced in the scope that is calling :func:`eval` (e.g. via " +"a :keyword:`nonlocal` statement)." +msgstr "" +"Argument *source* jest analizowany i ewaluowany jako wyrażenie Python " +"(technicznie rzecz biorąc, :ref:`expression list `) przy użyciu " +"mapowań *globals* i *locals* jako globalnej i lokalnej przestrzeni nazw. " +"Jeśli słownik *globals* jest obecny i nie zawiera wartości dla klucza " +"``__builtins__``, odwołanie do słownika wbudowanego modułu :mod:`builtins` " +"jest wstawiane pod tym kluczem, zanim *source* zostanie przeanalizowane. " +"Nadpisywanie ``__builtins__`` może służyć do ograniczenia lub zmiany " +"dostępnych nazw, ale **nie** jest to mechanizm zabezpieczający: wykonywany " +"kod nadal ma dostęp do wszystkich wbudowanych funkcji. Jeśli mapowanie " +"*locals* zostanie pominięte, domyślnie będzie to słownik *globals*. Jeśli " +"oba mapowania są pominięte, wyrażenie jest wykonywane z *globals* i *locals* " +"w środowisku, w którym wywoływany jest :func:`eval`. Uwaga, *eval()* będzie " +"miał dostęp do :term:`zagnieżdżonych zakresów ` (non-locals) w " +"otaczającym środowisku tylko wtedy, gdy są one już przywoływane w zakresie, " +"który wywołuje :func:`eval` (np. poprzez instrukcję :keyword:`nonlocal`)." msgid "Example:" msgstr "Przykład:" @@ -1203,11 +1209,11 @@ msgid "" "current global and local dictionary, respectively, which may be useful to " "pass around for use by :func:`eval` or :func:`exec`." msgstr "" -"Wskazówki: dynamiczne wykonywanie instrukcji jest obsługiwane przez :func:" -"`exec` funkcja . Adresy :func:`globals` i :func:`locals` funkcje zwracaja " -"określaaą odpowiednio bieżący globalny i lokalny adres słownika, który może " -"być przydatny do przekazania do użycia przez adresy :func:`eval` lub :func:" -"`exec`." +"Wskazówki: dynamiczne wykonywanie instrukcji jest obsługiwane " +"przez :func:`exec` funkcja . Adresy :func:`globals` i :func:`locals` " +"funkcje zwracaja określaaą odpowiednio bieżący globalny i lokalny adres " +"słownika, który może być przydatny do przekazania do użycia przez " +"adresy :func:`eval` lub :func:`exec`." msgid "" "If the given source is a string, then leading and trailing spaces and tabs " @@ -1217,11 +1223,11 @@ msgstr "" "usuwane." msgid "" -"See :func:`ast.literal_eval` for a function that can safely evaluate strings " -"with expressions containing only literals." +"See :func:`ast.literal_eval` for a function to 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." +"Zobacz :func:`ast.literal_eval` dla funkcja do oceny napisów z wyrażeniami " +"zawierającymi tylko literały." msgid "" "Raises an :ref:`auditing event ` ``exec`` with the code object as " @@ -1248,10 +1254,10 @@ msgid "" "as a suite of Python statements which is then executed (unless a syntax " "error occurs). [#]_ If it is a code object, it is simply executed. In all " "cases, the code that's executed is expected to be valid as file input (see " -"the section :ref:`file-input` in the Reference Manual). Be aware that the :" -"keyword:`nonlocal`, :keyword:`yield`, and :keyword:`return` statements may " -"not be used outside of function definitions even within the context of code " -"passed to the :func:`exec` function. The return value is ``None``." +"the section :ref:`file-input` in the Reference Manual). Be aware that " +"the :keyword:`nonlocal`, :keyword:`yield`, and :keyword:`return` statements " +"may not be used outside of function definitions even within the context of " +"code passed to the :func:`exec` function. The return value is ``None``." msgstr "" "Ta funkcja obsługuje dynamiczne wykonywanie kodu Python. *source* musi być " "albo napis albo obiektem kodu. Jeśli jest to napis, napis jest analizowany " @@ -1259,10 +1265,11 @@ msgstr "" "wystąpi błąd składni). [#]_ Jeśli jest to obiekt kodu, jest on po prostu " "wykonywany. We wszystkich przypadkach wykonywany kod powinien być " "prawidłowy jako plik wejściowy (patrz sekcja :ref:`file-input` w Podręczniku " -"referencyjnym). Należy pamiętać, że wartości :keyword:`nonlocal`, :keyword:" -"`yield` i :keyword:`return` instrukcije nie mogą być używane poza " -"definicjami funkcji, nawet w kontekście kodu przekazywanego do :func:" -"`exec` . Wartość zwracana to ``None``." +"referencyjnym). Należy pamiętać, że " +"wartości :keyword:`nonlocal`, :keyword:`yield` i :keyword:`return` " +"instrukcije nie mogą być używane poza definicjami funkcji, nawet w " +"kontekście kodu przekazywanego do :func:`exec` . Wartość zwracana to " +"``None``." msgid "" "In all cases, if the optional parts are omitted, the code is executed in the " @@ -1297,16 +1304,17 @@ msgstr "" msgid "" "If the *globals* dictionary does not contain a value for the key " -"``__builtins__``, a reference to the dictionary of the built-in module :mod:" -"`builtins` is inserted under that key. That way you can control what " -"builtins are available to the executed code by inserting your own " -"``__builtins__`` dictionary into *globals* before passing it to :func:`exec`." +"``__builtins__``, a reference to the dictionary of the built-in " +"module :mod:`builtins` is inserted under that key. Overriding " +"``__builtins__`` can be used to restrict or change the available names, but " +"this is **not** a security mechanism: the executed code can still access all " +"builtins." msgstr "" "Jeśli *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`." +"pod tym kluczem. Nadpisywanie ``__builtins__`` może służyć do ograniczenia " +"lub zmiany dostępnych nazw, ale **nie** jest to mechanizm zabezpieczający: " +"wykonywany kod nadal ma dostęp do wszystkich wbudowanych funkcji." msgid "" "The *closure* argument specifies a closure--a tuple of cellvars. It's only " @@ -1333,9 +1341,9 @@ msgid "" "Pass an explicit *locals* dictionary if you need to see effects of the code " "on *locals* after function :func:`exec` returns." msgstr "" -"Elementy domyślne *locals* działają w sposób opisany dla funkcji :func:" -"`locals` poniżej. Przekaż jawne *locals* słownik jeśli chcesz zobaczyć " -"efekty kodu na *locals* po funkcji :func:`exec` ." +"Elementy domyślne *locals* działają w sposób opisany dla " +"funkcji :func:`locals` poniżej. Przekaż jawne *locals* słownik jeśli chcesz " +"zobaczyć efekty kodu na *locals* po funkcji :func:`exec` ." msgid "Added the *closure* parameter." msgstr "Dodano parametr *zamknięcie*." @@ -1434,12 +1442,12 @@ msgstr "" "zostanie :exc:`OverflowError`." msgid "" -"For a general Python object ``x``, ``float(x)`` delegates to ``x." -"__float__()``. If :meth:`~object.__float__` is not defined then it falls " -"back to :meth:`~object.__index__`." +"For a general Python object ``x``, ``float(x)`` delegates to " +"``x.__float__()``. If :meth:`~object.__float__` is not defined then it " +"falls back to :meth:`~object.__index__`." msgstr "" -"W przypadku ogólnego obiektu Python ``x`` , ``float(x)`` deleguje do ``x." -"__float__()``. Jeśli :meth:`~object.__float__` nie jest zdefiniowana, to " +"W przypadku ogólnego obiektu Python ``x`` , ``float(x)`` deleguje do " +"``x.__float__()``. Jeśli :meth:`~object.__float__` nie jest zdefiniowana, to " "spada z powrotem do :meth:`~object.__index__`." msgid "If no argument is given, ``0.0`` is returned." @@ -1474,19 +1482,19 @@ msgstr "" "efekt jak wywołanie :func:`str(value) `." msgid "" -"A call to ``format(value, format_spec)`` is translated to ``type(value)." -"__format__(value, format_spec)`` which bypasses the instance dictionary when " -"searching for the value's :meth:`~object.__format__` method. A :exc:" -"`TypeError` exception is raised if the method search reaches :mod:`object` " -"and the *format_spec* is non-empty, or if either the *format_spec* or the " -"return value are not strings." +"A call to ``format(value, format_spec)`` is translated to " +"``type(value).__format__(value, format_spec)`` which bypasses the instance " +"dictionary when searching for the value's :meth:`~object.__format__` method. " +"A :exc:`TypeError` exception is raised if the method search " +"reaches :mod:`object` and the *format_spec* is non-empty, or if either the " +"*format_spec* or the return value are not strings." msgstr "" -"Wywołanie ``format(value, format_spec)`` jest tłumaczone na ``type(value)." -"__format__(value, format_spec)``, które omija instancję słownika podczas " -"wyszukiwania metody :meth:`~object.__format__` wartości . Wyjątek :exc:" -"`TypeError` jest rzucony, jeśli wyszukiwanie metody osiągnie :mod:`object` i " -"*format_spec* jest niepusty, lub jeśli *format_spec* lub wartość zwracana " -"nie są napisem." +"Wywołanie ``format(value, format_spec)`` jest tłumaczone na " +"``type(value).__format__(value, format_spec)``, które omija instancję " +"słownika podczas wyszukiwania metody :meth:`~object.__format__` wartości . " +"Wyjątek :exc:`TypeError` jest rzucony, jeśli wyszukiwanie metody " +"osiągnie :mod:`object` i *format_spec* jest niepusty, lub jeśli " +"*format_spec* lub wartość zwracana nie są napisem." msgid "" "``object().__format__(format_spec)`` raises :exc:`TypeError` if " @@ -1497,19 +1505,21 @@ msgstr "" msgid "" "Return a new :class:`frozenset` object, optionally with elements taken from " -"*iterable*. ``frozenset`` is a built-in class. See :class:`frozenset` and :" -"ref:`types-set` for documentation about this class." +"*iterable*. :class:`frozenset` is a built-in class. See also :ref:`types-" +"set` for documentation about this class." msgstr "" -"Zwraca nowy obiekt :class:`frozenset`, opcjonalnie z elementami pobranymi z " -"*iterable*. ``frozenset`` jest klasą wbudowaną. Dokumentacja dotycząca tej " -"klasy znajduje się na stronach :class:`frozenset` i :ref:`types-set`." +"Zwraca nowy obiekt , opcjonalnie z elementami pobranymi z " +"*iterable*. :class:`frozenset` jest klasą wbudowaną. Zobacz też dokumentację " +"dotycząca tej klasy w :ref:`types-set`." msgid "" -"For other containers see the built-in :class:`set`, :class:`list`, :class:" -"`tuple`, and :class:`dict` classes, as well as the :mod:`collections` module." +"For other containers see the built-" +"in :class:`set`, :class:`list`, :class:`tuple`, and :class:`dict` classes, " +"as well as the :mod:`collections` module." msgstr "" -"Dla innych kontenerów zobacz klasy wbudowane :class:`set` , :class:`list`, :" -"class:`tuple` i :class:`dict`, jak również moduł :mod:`collections` ." +"Dla innych kontenerów zobacz klasy " +"wbudowane :class:`set` , :class:`list`, :class:`tuple` i :class:`dict`, jak " +"również moduł :mod:`collections` ." msgid "" "Return the value of the named attribute of *object*. *name* must be a " @@ -1521,16 +1531,16 @@ msgid "" msgstr "" "Zwraca wartość nazwanego atrybut obiektu *object*. *name* musi być napisem. " "Jeśli napis jest nazwą jednego z atrybut obiektu, wynikiem jest wartość tego " -"atrybutu. Na przykład, ``getattr(x, 'foobar')`` jest równoważne ``x." -"foobar``. Jeśli nazwany atrybut nie istnieje, *default* jest zwracany, jeśli " -"został podany, w przeciwnym razie :exc:`AttributeError` jest rzucony. *name* " -"nie musi być identyfikatorem Pythona (Zobacz :func:`setattr`)." +"atrybutu. Na przykład, ``getattr(x, 'foobar')`` jest równoważne " +"``x.foobar``. Jeśli nazwany atrybut nie istnieje, *default* jest zwracany, " +"jeśli został podany, w przeciwnym razie :exc:`AttributeError` jest rzucony. " +"*name* nie musi być identyfikatorem Pythona (Zobacz :func:`setattr`)." msgid "" "Since :ref:`private name mangling ` happens at " "compilation time, one must manually mangle a private attribute's (attributes " -"with two leading underscores) name in order to retrieve it with :func:" -"`getattr`." +"with two leading underscores) name in order to retrieve it " +"with :func:`getattr`." msgstr "" "Ponieważ :ref:`manipulowanie nazwami prywatnymi ` " "odbywa się w czasie kompilacji, należy ręcznie zmanipulować nazwę prywatną " @@ -1554,8 +1564,8 @@ msgid "" msgstr "" "Argumenty to obiekt i napis. Wynikiem jest ``True`` jeśli napis jest nazwą " "jednego z obiektów atrybut, ``False`` jeśli nie. (Jest to zaimplementowane " -"poprzez wywołanie ``getattr(object, name)`` i sprawdzenie, czy rzucone jest :" -"exc:`AttributeError` )." +"poprzez wywołanie ``getattr(object, name)`` i sprawdzenie, czy rzucone " +"jest :exc:`AttributeError` )." msgid "" "Return the hash value of the object (if it has one). Hash values are " @@ -1570,8 +1580,9 @@ msgstr "" "przypadku 1 i 1.0)." msgid "" -"For objects with custom :meth:`~object.__hash__` methods, note that :func:" -"`hash` truncates the return value based on the bit width of the host machine." +"For objects with custom :meth:`~object.__hash__` methods, note " +"that :func:`hash` truncates the return value based on the bit width of the " +"host machine." msgstr "" "W przypadku obiektów z niestandardowymi metodami :meth:`~object.__hash__` " "należy pamiętać, że :func:`hash` obcina wartość zwracaną w oparciu o " @@ -1607,8 +1618,8 @@ msgstr "" msgid "" "This function is added to the built-in namespace by the :mod:`site` module." msgstr "" -"Ta funkcja jest dodawana do przestrzeni nazw wbudowanych przez moduł :mod:" -"`site` ." +"Ta funkcja jest dodawana do przestrzeni nazw wbudowanych przez " +"moduł :mod:`site` ." msgid "" "Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures " @@ -1619,13 +1630,13 @@ msgstr "" 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:`~object.__index__` method that returns an integer. Some examples:" +"\"0x\". If *integer* is not a Python :class:`int` object, it has to define " +"an :meth:`~object.__index__` method that returns an integer. Some examples:" msgstr "" -"Konwertuje liczbę 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:" +"Konwertuje liczbę całkowitą na zapis szesnastkowy małymi literami " +"poprzedzony \"0x\". Jeśli *integer* nie jest pythonowym " +"obiektem :class:`int` , musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbę całkowitą. Kilka przykładów:" msgid "" "If you want to convert an integer number to an uppercase or lower " @@ -1644,8 +1655,8 @@ msgstr "" "całkowita przy użyciu podstawy 16." msgid "" -"To obtain a hexadecimal string representation for a float, use the :meth:" -"`float.hex` method." +"To obtain a hexadecimal string representation for a float, use " +"the :meth:`float.hex` method." msgstr "" "Aby uzyskać napis szesnastkowej reprezentacj dla zmiennoprzecinkowej, należy " "użyć metody :meth:`float.hex`." @@ -1749,17 +1760,17 @@ msgstr "" "115" msgid "" -"If the argument defines :meth:`~object.__int__`, ``int(x)`` returns ``x." -"__int__()``. If the argument defines :meth:`~object.__index__`, it returns " -"``x.__index__()``. If the argument defines :meth:`~object.__trunc__`, it " -"returns ``x.__trunc__()``. For floating-point numbers, this truncates " -"towards zero." +"If the argument defines :meth:`~object.__int__`, ``int(x)`` returns " +"``x.__int__()``. If the argument defines :meth:`~object.__index__`, it " +"returns ``x.__index__()``. If the argument " +"defines :meth:`~object.__trunc__`, it returns ``x.__trunc__()``. For " +"floating-point numbers, this truncates towards zero." msgstr "" -"Jeśli argument definiuje :meth:`~object.__int__`, ``int(x)`` zwraca ``x." -"__int__()`` . Jeśli argument definiuje :meth:`~object.__index__`, to zwraca " -"``x.__index__()`` . Jeśli argument definiuje :meth:`~object.__trunc__`, to " -"zwraca ``x.__trunc__()`` . W przypadku liczb zmiennoprzecinkowych jest ona " -"obcinana w kierunku zera." +"Jeśli argument definiuje :meth:`~object.__int__`, ``int(x)`` zwraca " +"``x.__int__()`` . Jeśli argument definiuje :meth:`~object.__index__`, to " +"zwraca ``x.__index__()`` . Jeśli argument " +"definiuje :meth:`~object.__trunc__`, to zwraca ``x.__trunc__()`` . W " +"przypadku liczb zmiennoprzecinkowych jest ona obcinana w kierunku zera." msgid "" "If the argument is not a number or if *base* is given, then it must be a " @@ -1803,16 +1814,16 @@ msgid "The integer type is described in :ref:`typesnumeric`." msgstr "Typ liczba całkowita (integer) został opisany w :ref:`typesnumeric`." msgid "" -"If *base* is not an instance of :class:`int` and the *base* object has a :" -"meth:`base.__index__ ` method, that method is called to " +"If *base* is not an instance of :class:`int` and the *base* object has " +"a :meth:`base.__index__ ` method, that method is called to " "obtain an integer for the base. Previous versions used :meth:`base.__int__ " "` instead of :meth:`base.__index__ `." msgstr "" -"Jeśli *base* nie jest instancją :class:`int` i obiekt *base* posiada metodę :" -"meth:`base.__index__ `, metoda ta jest wywoływana w celu " -"uzyskania liczba całkowitych dla bazy. Poprzednie wersje używały :meth:" -"`base.__int__ ` zamiast :meth:`base.__index__ `." +"Jeśli *base* nie jest instancją :class:`int` i obiekt *base* posiada " +"metodę :meth:`base.__index__ `, metoda ta jest wywoływana " +"w celu uzyskania liczba całkowitych dla bazy. Poprzednie wersje " +"używały :meth:`base.__int__ ` zamiast :meth:`base.__index__ " +"`." msgid "The first parameter is now positional-only." msgstr "Pierwszy parametr jest teraz tylko pozycyjny." @@ -1831,15 +1842,15 @@ msgid "" ":class:`int` string inputs and string representations can be limited to help " "avoid denial of service attacks. A :exc:`ValueError` is raised when the " "limit is exceeded while converting a string to an :class:`int` or when " -"converting an :class:`int` into a string would exceed the limit. See the :" -"ref:`integer string conversion length limitation ` " +"converting an :class:`int` into a string would exceed the limit. See " +"the :ref:`integer string conversion length limitation ` " "documentation." msgstr "" ":class:`int` napis wejścia i reprezentacje napisa mogą być ograniczone, aby " "pomóc uniknąć ataków typu \"odmowa usługi\". :exc:`ValueError` jest rzucone, " "gdy limit zostanie przekroczony podczas konwersji napisa na :class:`int` lub " -"gdy konwersja :class:`int` na napis przekroczy limit. Zobacz dokumentację :" -"ref:`liczba całkowita napis ograniczenia długości konwersji " +"gdy konwersja :class:`int` na napis przekroczy limit. Zobacz " +"dokumentację :ref:`liczba całkowita napis ograniczenia długości konwersji " "`." msgid "" @@ -1849,9 +1860,9 @@ msgid "" "the function always returns ``False``. If *classinfo* is a tuple of type " "objects (or recursively, other such tuples) or a :ref:`types-union` of " "multiple types, return ``True`` if *object* is an instance of any of the " -"types. If *classinfo* is not a type or tuple of types and such tuples, a :" -"exc:`TypeError` exception is raised. :exc:`TypeError` may not be raised for " -"an invalid type if an earlier check succeeds." +"types. If *classinfo* is not a type or tuple of types and such tuples, " +"a :exc:`TypeError` exception is raised. :exc:`TypeError` may not be raised " +"for an invalid type if an earlier check succeeds." msgstr "" "Zwraca ``True`` jeśli argument *object* jest instancją argumentu " "*classinfo*, lub jego (bezpośrednią, pośrednią lub :term:`wirtualną " @@ -1868,15 +1879,15 @@ msgid "*classinfo* can be a :ref:`types-union`." msgstr "*classinfo* może być :ref:`types-union`." msgid "" -"Return ``True`` if *class* is a subclass (direct, indirect, or :term:" -"`virtual `) of *classinfo*. A class is considered a " -"subclass of itself. *classinfo* may be a tuple of class objects (or " -"recursively, other such tuples) or a :ref:`types-union`, in which case " +"Return ``True`` if *class* is a subclass (direct, indirect, " +"or :term:`virtual `) of *classinfo*. A class is " +"considered a subclass of itself. *classinfo* may be a tuple of class objects " +"(or recursively, other such tuples) or a :ref:`types-union`, in which case " "return ``True`` if *class* is a subclass of any entry in *classinfo*. In " "any other case, a :exc:`TypeError` exception is raised." msgstr "" -"Zwraca ``True`` jeśli *class* jest podklasą (bezpośrednią, pośrednią lub :" -"term:`wirtualną `) *classinfo*. Klasa jest " +"Zwraca ``True`` jeśli *class* jest podklasą (bezpośrednią, pośrednią " +"lub :term:`wirtualną `) *classinfo*. Klasa jest " "uważana za podklasę samej siebie. *classinfo* może być krotką obiektów klasy " "(lub rekurencyjnie, innych takich krotek) lub :ref:`types-union`, w którym " "to przypadku zwraca ``True`` jeśli *class* jest podklasą dowolnego wpisu w " @@ -1885,29 +1896,31 @@ msgstr "" 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:`~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 " +"second argument, the single argument must be a collection object which " +"supports the :term:`iterable` protocol (the :meth:`~object.__iter__` " +"method), or it must support the sequence protocol " +"(the :meth:`~object.__getitem__` method with integer arguments starting at " +"``0``). If it does not support either of those protocols, :exc:`TypeError` " +"is raised. If the second argument, *sentinel*, is given, then the first " +"argument must be a callable object. The iterator created in this case will " +"call *callable* with no arguments for each call to " "its :meth:`~iterator.__next__` method; if the value returned is equal to " "*sentinel*, :exc:`StopIteration` will be raised, otherwise the value will be " "returned." msgstr "" "Zwraca obiekt :term:`iteratora `. Pierwszy argument jest " "interpretowany bardzo różnie w zależności od obecności drugiego argumentu. " -"Bez drugiego argumentu, *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 " +"Bez drugiego argumentu, jedyny argument musi być obiektem kolekcji, która " +"obsługuje protokół :term:`iterable` (metoda :meth:`~object.__iter__` ), lub " +"musi obsługiwać protokół sekwencji (metoda :meth:`~object.__getitem__` z " "argumentami liczb całkowitych zaczynających się od ``0``). Jeśli nie " "obsługuje żadnego z tych protokołów, zostanie rzucony :exc:`TypeError`. " -"Jeśli podano drugi argument, *sentinel*, to *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ść." +"Jeśli podano drugi argument, *sentinel*, to pierwszy argument musi być " +"obiektem wywoływalnym. Utworzony w tym przypadku iterator będzie wywoływał " +"*callable* bez argumentu dla każdego wywołania jego " +"metody :meth:`~iterator.__next__`; jeśli zwrócona wartość jest równa " +"*sentinel*, zostanie rzucone :exc:`StopIteration`, w przeciwnym razie " +"zostanie zwrócona wartość." msgid "See also :ref:`typeiter`." msgstr "Zobacz także :ref:`typeiter`." @@ -1942,19 +1955,19 @@ msgstr "" "(taką jak słownik, zbiór lub zbiór zamrożony)." msgid "" -"``len`` raises :exc:`OverflowError` on lengths larger than :data:`sys." -"maxsize`, such as :class:`range(2 ** 100) `." +"``len`` raises :exc:`OverflowError` on lengths larger " +"than :data:`sys.maxsize`, such as :class:`range(2 ** 100) `." msgstr "" -"``len`` rzuca :exc:`OverflowError` dla długości większych niż :data:`sys." -"maxsize`, takich jak :class:`range(2 ** 100) `." +"``len`` rzuca :exc:`OverflowError` dla długości większych " +"niż :data:`sys.maxsize`, takich jak :class:`range(2 ** 100) `." msgid "" "Rather than being a function, :class:`list` is actually a mutable sequence " "type, as documented in :ref:`typesseq-list` and :ref:`typesseq`." msgstr "" "Zamiast być funkcją, :class:`list` jest w rzeczywistości typem mutowalnej " -"(zmiennej) sekwencji, jak udokumentowano w :ref:`typesseq-list` i :ref:" -"`typesseq`." +"(zmiennej) sekwencji, jak udokumentowano w :ref:`typesseq-list` " +"i :ref:`typesseq`." msgid "" "Return a mapping object representing the current local symbol table, with " @@ -1967,12 +1980,12 @@ msgstr "" msgid "" "At module scope, as well as when using :func:`exec` or :func:`eval` with a " -"single namespace, this function returns the same namespace as :func:" -"`globals`." +"single namespace, this function returns the same namespace " +"as :func:`globals`." msgstr "" -"W zakresie moduł, a także podczas korzystania z :func:`exec` lub :func:" -"`eval` z pojedynczą przestrzenią nazw, ta funkcja zwraca ta sama przestrzeń " -"nazw co :func:`globals`." +"W zakresie moduł, a także podczas korzystania z :func:`exec` " +"lub :func:`eval` z pojedynczą przestrzenią nazw, ta funkcja zwraca ta sama " +"przestrzeń nazw co :func:`globals`." msgid "" "At class scope, it returns the namespace that will be passed to the " @@ -2052,10 +2065,10 @@ msgstr "" msgid "" "As part of :pep:`667`, the semantics of mutating the mapping objects " -"returned from this function are now defined. The behavior in :term:" -"`optimized scopes ` is now as described above. Aside from " -"being defined, the behaviour in other scopes remains unchanged from previous " -"versions." +"returned from this function are now defined. The behavior " +"in :term:`optimized scopes ` is now as described above. " +"Aside from being defined, the behaviour in other scopes remains unchanged " +"from previous versions." msgstr "" "Jako część :pep:`667`, semantyka mutowania obiektów mapowania zwróconych z " "tej funkcji jest teraz zdefiniowana. Zachowanie w :term:`zoptymalizowanych " @@ -2099,8 +2112,8 @@ msgid "" "There are two optional keyword-only arguments. The *key* argument specifies " "a one-argument ordering function like that used for :meth:`list.sort`. The " "*default* argument specifies an object to return if the provided iterable is " -"empty. If the iterable is empty and *default* is not provided, a :exc:" -"`ValueError` is raised." +"empty. If the iterable is empty and *default* is not provided, " +"a :exc:`ValueError` is raised." msgstr "" "Istnieją dwa opcjonalne tylko ze słowem kluczowym argument. *Kluczowy* " "argument określa jedno-argumentowy uporządkowanie funkcji jak to używane " @@ -2111,8 +2124,8 @@ msgstr "" msgid "" "If multiple items are maximal, the function returns the first one " "encountered. This is consistent with other sort-stability preserving tools " -"such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and ``heapq." -"nlargest(1, iterable, key=keyfunc)``." +"such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and " +"``heapq.nlargest(1, iterable, key=keyfunc)``." msgstr "" "Jeśli wiele elementów jest maksymalnych, funkcja zwraca pierwszy napotkany " "element. Jest to zgodne z innymi narzędziami zachowującymi stabilność " @@ -2126,8 +2139,8 @@ msgid "The *key* can be ``None``." msgstr "*Kluczem* może być ``None``." msgid "" -"Return a \"memory view\" object created from the given argument. See :ref:" -"`typememoryview` for more information." +"Return a \"memory view\" object created from the given argument. " +"See :ref:`typememoryview` for more information." msgstr "" "Zwraca obiekt \"memory view\" utworzony z podanego argumentu. Więcej " "informacji można znaleźć na stronie :ref:`typememoryview`." @@ -2160,14 +2173,15 @@ msgstr "" "iterable, key=keyfunc)``." msgid "" -"Retrieve the next item from the :term:`iterator` by calling its :meth:" -"`~iterator.__next__` method. If *default* is given, it is returned if the " -"iterator is exhausted, otherwise :exc:`StopIteration` is raised." +"Retrieve the next item from the :term:`iterator` by calling " +"its :meth:`~iterator.__next__` method. If *default* is given, it is " +"returned if the iterator is 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." +"Pobiera następny element z :term:`iterator` poprzez wywołanie jego " +"metody :meth:`~iterator.__next__`. Jeśli *domyślny* jest podany, jest " +"zwracany, jeśli iterator jest wyczerpany, w przeciwnym " +"razie :exc:`StopIteration` jest rzucony." msgid "" "This is the ultimate base class of all other classes. It has methods that " @@ -2189,14 +2203,14 @@ 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:`~object.__index__` method that returns an " -"integer. For example:" +"result is a valid Python expression. If *integer* is not a " +"Python :class:`int` object, it has to define an :meth:`~object.__index__` " +"method that returns an integer. For example:" msgstr "" -"Konwertuje liczbę 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:" +"Konwertuje liczbę całkowitą na ósemkowy ciąg znaków z prefiksem \"0o\". " +"Wynikiem jest poprawne wyrażenie Python. Jeśli *integer* nie jest pythonowym " +"obiektem :class:`int`, musi definiować metodę :meth:`~object.__index__`, " +"która zwraca liczbę całkowitą. Na przykład:" msgid "" "If you want to convert an integer number to an octal string either with the " @@ -2235,10 +2249,10 @@ msgid "" "already exists), ``'x'`` for exclusive creation, and ``'a'`` for appending " "(which on *some* Unix systems, means that *all* writes append to the end of " "the file regardless of the current seek position). In text mode, if " -"*encoding* is not specified the encoding used is platform-dependent: :func:" -"`locale.getencoding` is called to get the current locale encoding. (For " -"reading and writing raw bytes use binary mode and leave *encoding* " -"unspecified.) The available modes are:" +"*encoding* is not specified the encoding used is platform-" +"dependent: :func:`locale.getencoding` is called to get the current locale " +"encoding. (For reading and writing raw bytes use binary mode and leave " +"*encoding* unspecified.) The available modes are:" msgstr "" "*mode* to opcjonalny napis , który określa tryb, w którym plik jest " "otwierany. Domyślnie jest to ``'r'``, co oznacza otwarcie do odczytu w " @@ -2355,9 +2369,9 @@ msgstr "" "ten sposób dotyczy binarnie buforowanego wejścia/wyjścia, ale " "``TextIOWrapper`` (tj. pliki otwierane za pomocą ``mode='r+'``) będą miały " "inne buforowanie. Aby wyłączyć buforowanie w ``TextIOWrapper``, należy " -"rozważyć użycie flagi ``write_through`` dla :func:`io.TextIOWrapper." -"reconfigure`. Gdy nie podano *buforowania* argument, polityka buforowania " -"domyślny działa w następujący sposób:" +"rozważyć użycie flagi ``write_through`` " +"dla :func:`io.TextIOWrapper.reconfigure`. Gdy nie podano *buforowania* " +"argument, polityka buforowania domyślny działa w następujący sposób:" msgid "" "Binary files are buffered in fixed-size chunks; the size of the buffer is " @@ -2375,9 +2389,10 @@ msgid "" "returns ``True``) use line buffering. Other text files use the policy " "described above for binary files." msgstr "" -"\"Interaktywne\" pliki tekstowe (pliki, dla których :meth:`~io.IOBase." -"isatty` zwraca ``True`` ) używają buforowania linii. Inne pliki tekstowe " -"używają zasad opisanych powyżej dla plików binarnych." +"\"Interaktywne\" pliki tekstowe (pliki, dla " +"których :meth:`~io.IOBase.isatty` zwraca ``True`` ) używają buforowania " +"linii. Inne pliki tekstowe używają zasad opisanych powyżej dla plików " +"binarnych." msgid "" "*encoding* is the name of the encoding used to decode or encode the file. " @@ -2396,14 +2411,16 @@ msgid "" "*errors* is an optional string that specifies how encoding and decoding " "errors are to be handled—this cannot be used in binary mode. A variety of " "standard error handlers are available (listed under :ref:`error-handlers`), " -"though any error handling name that has been registered with :func:`codecs." -"register_error` is also valid. The standard names include:" +"though any error handling name that has been registered " +"with :func:`codecs.register_error` is also valid. The standard names " +"include:" msgstr "" "*errors* to opcjonalny napis, który określa sposób obsługi błędów kodowania " "i dekodowania - nie może być używany w trybie binarnym. Dostępnych jest " "wiele standardowych programów obsługi błędów (wymienionych w :ref:`error-" -"handlers`), choć każda nazwa obsługi błędów zarejestrowana w :func:`codecs." -"register_error` jest również ważna. Standardowe nazwy obejmują:" +"handlers`), choć każda nazwa obsługi błędów zarejestrowana " +"w :func:`codecs.register_error` jest również ważna. Standardowe nazwy " +"obejmują:" msgid "" "``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding " @@ -2492,10 +2509,10 @@ msgstr "" msgid "" "When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` " -"characters written are translated to the system default line separator, :" -"data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no translation " -"takes place. If *newline* is any of the other legal values, any ``'\\n'`` " -"characters written are translated to the given string." +"characters written are translated to the system default line " +"separator, :data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no " +"translation takes place. If *newline* is any of the other legal values, any " +"``'\\n'`` characters written are translated to the given string." msgstr "" "Podczas zapisywania danych wyjściowych do strumienia, jeśli *newline* ma " "wartość ``None``, wszelkie zapisane ``'\\n'`` znaki są tłumaczone na " @@ -2532,8 +2549,8 @@ msgid "The newly created file is :ref:`non-inheritable `." msgstr "Nowo utworzony plik jest :ref:`non-inheritable `." msgid "" -"The following example uses the :ref:`dir_fd ` parameter of the :func:" -"`os.open` function to open a file relative to a given directory::" +"The following example uses the :ref:`dir_fd ` parameter of " +"the :func:`os.open` function to open a file relative to a given directory::" msgstr "" "Poniższy przykład używa :ref:`dir_fd ` parametr z :func:`os.open` " "funkcji do otwarcia pliku względem danego katalogu::" @@ -2562,37 +2579,38 @@ msgstr "" msgid "" "The type of :term:`file object` returned by the :func:`open` function " "depends on the mode. When :func:`open` is used to open a file in a text " -"mode (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass of :" -"class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When used " -"to open a file in a binary mode with buffering, the returned class is a " +"mode (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass " +"of :class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When " +"used to open a file in a binary mode with buffering, the returned class is a " "subclass of :class:`io.BufferedIOBase`. The exact class varies: in read " "binary mode, it returns an :class:`io.BufferedReader`; in write binary and " "append binary modes, it returns an :class:`io.BufferedWriter`, and in read/" "write mode, it returns an :class:`io.BufferedRandom`. When buffering is " -"disabled, the raw stream, a subclass of :class:`io.RawIOBase`, :class:`io." -"FileIO`, is returned." -msgstr "" -"Typ :term:`file object` zwracany przez :func:`open` zależy od trybu. Gdy :" -"func:`open` jest używany do otwarcia pliku w trybie tekstowym (``'w'``, " -"``'r'``, ``'wt'``, ``'rt'``, itd.), to zwracana jest podklasa klasy :class:" -"`io.TextIOBase` (w szczególności :class:`io.TextIOWrapper`). W przypadku " -"użycia do otwarcia pliku w trybie binarnym z buforowaniem, zwracana klasą " -"jest podklasa z :class:`io.BufferedIOBase`. Dokładna klasa różni się: w " -"trybie odczytu binarnego, jest to zwracane z :class:`io.BufferedReader`; w " -"trybach zapisu binarnego i dołączania binarnego, jest to zwracane z :class:" -"`io.BufferedWriter`, a w trybie odczytu/zapisu, jest to zwracane z :class:" -"`io.BufferedRandom`. Gdy buforowanie jest wyłączone, zwracany jest " -"nieprzetworzony strumień, podklasa z :class:`io.RawIOBase`, :class:`io." -"FileIO`." +"disabled, the raw stream, a subclass " +"of :class:`io.RawIOBase`, :class:`io.FileIO`, is returned." +msgstr "" +"Typ :term:`file object` zwracany przez :func:`open` zależy od trybu. " +"Gdy :func:`open` jest używany do otwarcia pliku w trybie tekstowym (``'w'``, " +"``'r'``, ``'wt'``, ``'rt'``, itd.), to zwracana jest podklasa " +"klasy :class:`io.TextIOBase` (w szczególności :class:`io.TextIOWrapper`). W " +"przypadku użycia do otwarcia pliku w trybie binarnym z buforowaniem, " +"zwracana klasą jest podklasa z :class:`io.BufferedIOBase`. Dokładna klasa " +"różni się: w trybie odczytu binarnego, jest to zwracane " +"z :class:`io.BufferedReader`; w trybach zapisu binarnego i dołączania " +"binarnego, jest to zwracane z :class:`io.BufferedWriter`, a w trybie odczytu/" +"zapisu, jest to zwracane z :class:`io.BufferedRandom`. Gdy buforowanie jest " +"wyłączone, zwracany jest nieprzetworzony strumień, podklasa " +"z :class:`io.RawIOBase`, :class:`io.FileIO`." msgid "" "See also the file handling modules, such as :mod:`fileinput`, :mod:`io` " -"(where :func:`open` is declared), :mod:`os`, :mod:`os.path`, :mod:" -"`tempfile`, and :mod:`shutil`." +"(where :func:`open` is " +"declared), :mod:`os`, :mod:`os.path`, :mod:`tempfile`, and :mod:`shutil`." msgstr "" "Zobacz także moduły obsługę plików, takich jak :mod:`fileinput`, :mod:`io` " -"(gdzie zadeklarowano :func:`open` ), :mod:`os`, :mod:`os.path`, :mod:" -"`tempfile` i :mod:`shutil`." +"(gdzie " +"zadeklarowano :func:`open` ), :mod:`os`, :mod:`os.path`, :mod:`tempfile` " +"i :mod:`shutil`." msgid "" "Raises an :ref:`auditing event ` ``open`` with arguments ``path``, " @@ -2629,8 +2647,8 @@ msgstr "Plik nie jest teraz dziedziczony." msgid "" "If the system call is interrupted and the signal handler does not raise an " -"exception, the function now retries the system call instead of raising an :" -"exc:`InterruptedError` exception (see :pep:`475` for the rationale)." +"exception, the function now retries the system call instead of raising " +"an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)." msgstr "" "Jeśli wywołanie systemowe zostanie przerwane, a program obsługi sygnału nie " "rzuci wyjątku, funkcji ponawia teraz wywołanie systemowe zamiast rzucenja " @@ -2644,25 +2662,36 @@ msgstr "" "Dodano obsługę akceptowania obiektów implementujących :class:`os.PathLike`." msgid "" -"On Windows, opening a console buffer may return a subclass of :class:`io." -"RawIOBase` other than :class:`io.FileIO`." +"On Windows, opening a console buffer may return a subclass " +"of :class:`io.RawIOBase` other than :class:`io.FileIO`." msgstr "" -"W systemie Windows, otwarcie bufora konsoli może zwracać podklasa z :class:" -"`io.RawIOBase` innego niż :class:`io.FileIO`." +"W systemie Windows, otwarcie bufora konsoli może zwracać podklasa " +"z :class:`io.RawIOBase` innego niż :class:`io.FileIO`." msgid "The ``'U'`` mode has been removed." msgstr "Tryb ``'U'`` został usunięty." +msgid "Return the ordinal value of a character." +msgstr "Zwraca wartość porządkową znaku." + +msgid "" +"If the argument is a one-character string, return the Unicode code point of " +"that character. For example, ``ord('a')`` returns the integer ``97`` and " +"``ord('€')`` (Euro sign) returns ``8364``. This is the inverse " +"of :func:`chr`." +msgstr "" +"Jeśli argument jest jedno-znakowym ciągiem znaków, zwraca punkt kodowy " +"Unicode tego znaku. Na przykład, ``ord('a')`` zwraca liczbę całkowitą ``97`` " +"i ``ord('€')`` (znak euro) zwraca ``8364`` . Jest to odwrotność :func:`chr`." + msgid "" -"Given a string representing one Unicode character, return an integer " -"representing the Unicode code point of that character. For example, " -"``ord('a')`` returns the integer ``97`` and ``ord('€')`` (Euro sign) returns " -"``8364``. This is the inverse of :func:`chr`." +"If the argument is a :class:`bytes` or :class:`bytearray` object of length " +"1, return its single byte value. For example, ``ord(b'a')`` returns the " +"integer ``97``." msgstr "" -"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`." +"Jeśli argument jest obiektem :class:`bytes` lub :class:`bytearray` o " +"długości 1, zwraca jego wartość pojedynczego bajtu. Na przykład " +"``ord(b'a')`` zwraca liczbę całkowitą ``97``." msgid "" "Return *base* to the power *exp*; if *mod* is present, return *base* to the " @@ -2676,7 +2705,7 @@ msgstr "" "użyciu operatora potęgi: ``base**exp``." msgid "" -"The arguments must have numeric types. With mixed operand types, the " +"When arguments are builtin numeric types with mixed operand types, the " "coercion rules for binary arithmetic operators apply. For :class:`int` " "operands, the result has the same type as the operands (after coercion) " "unless the second argument is negative; in that case, all arguments are " @@ -2684,22 +2713,22 @@ msgid "" "2)`` returns ``100``, but ``pow(10, -2)`` returns ``0.01``. For a negative " "base of type :class:`int` or :class:`float` and a non-integral exponent, a " "complex result is delivered. For example, ``pow(-9, 0.5)`` returns a value " -"close to ``3j``. Whereas, for a negative base of type :class:`int` or :class:" -"`float` with an integral exponent, a float result is delivered. For example, " -"``pow(-9, 2.0)`` returns ``81.0``." +"close to ``3j``. Whereas, for a negative base of type :class:`int` " +"or :class:`float` with an integral exponent, a float result is delivered. " +"For example, ``pow(-9, 2.0)`` returns ``81.0``." msgstr "" -"Operatory argumentów muszą mieć typy numeryczne. W przypadku mieszanych " -"typów operandów obowiązują zasady koercji dla binarnych operatorów " +"Gdy argumenty są wbudowanymi typami numerycznymi z mieszanymi typami " +"operandów, obowiązują zasady koercji dla binarnych operatorów " "arytmetycznych. Dla operandów :class:`int` wynik ma ten sam typ co operandy " "(po koercji), chyba że drugi argument jest ujemny; w takim przypadku " "wszystkie argument są konwertowane na float i dostarczany jest wynik float. " "Na przykład, ``pow(10, 2)`` zwracać ``100`` , ale ``pow(10, -2)`` zwracać " -"``0.01`` . W przypadku ujemnej podstawy typu :class:`int` lub :class:" -"`float` i wykładnika niecałkowitego dostarczany jest wynik złożony. Na " -"przykład, ``pow(-9, 0.5)`` zwraca wartość zbliżona do ``3j``. Natomiast dla " -"ujemnej podstawy typu :class:`int` lub :class:`float` z wykładnikiem " -"całkowitym, dostarczany jest wynik zmiennoprzecinkowy. Na przykład ``pow(-9, " -"2.0)`` zwraca ``81.0`` ." +"``0.01`` . W przypadku ujemnej podstawy typu :class:`int` " +"lub :class:`float` i wykładnika niecałkowitego dostarczany jest wynik " +"złożony. Na przykład, ``pow(-9, 0.5)`` zwraca wartość zbliżona do ``3j``. " +"Natomiast dla ujemnej podstawy typu :class:`int` lub :class:`float` z " +"wykładnikiem całkowitym, dostarczany jest wynik zmiennoprzecinkowy. Na " +"przykład ``pow(-9, 2.0)`` zwraca ``81.0`` ." msgid "" "For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must " @@ -2773,8 +2802,8 @@ msgstr "" "*Plik* argument musi być obiektem z metodą ``write(string)``; jeśli nie jest " "obecny lub ``None``, zostanie użyty :data:`sys.stdout`. Ponieważ drukowane " "argument są konwertowane na tekst napis, :func:`print` nie może być używany " -"z obiektami plików w trybie binarnym. Zamiast tego należy uży ``file." -"write(...)``." +"z obiektami plików w trybie binarnym. Zamiast tego należy uży " +"``file.write(...)``." msgid "" "Output buffering is usually determined by *file*. However, if *flush* is " @@ -2843,13 +2872,13 @@ msgstr "" msgid "" "If given, *doc* will be the docstring of the property attribute. Otherwise, " "the property will copy *fget*'s docstring (if it exists). This makes it " -"possible to create read-only properties easily using :func:`property` as a :" -"term:`decorator`::" +"possible to create read-only properties easily using :deco:`property` as " +"a :term:`decorator`::" msgstr "" "Jeśli zostanie podana, *doc* będzie docstringiem właściwości atrybut. W " "przeciwnym razie właściwość skopiuje docstring *fget* (jeśli istnieje). " -"Umożliwia to łatwe tworzenie właściwości tylko do odczytu przy użyciu :func:" -"`property` jako :term:`dekorator`::" +"Umożliwia to łatwe tworzenie właściwości tylko do odczytu przy " +"użyciu :deco:`property` jako :term:`dekorator`::" msgid "" "class Parrot:\n" @@ -2976,8 +3005,8 @@ msgstr "" "zawierają nazwę typu obiektu wraz z dodatkowymi informacjami, często " "zawierającymi nazwę i adres obiektu. Klasa może kontrolować co funkcja " "zwraca dla swoich instancji, definiując metodę :meth:`~object.__repr__`. " -"Jeśli :func:`sys.displayhook` nie jest dostępna, ta funkcja będzie rzucona :" -"exc:`RuntimeError` ." +"Jeśli :func:`sys.displayhook` nie jest dostępna, ta funkcja będzie " +"rzucona :exc:`RuntimeError` ." msgid "This class has a custom representation that can be evaluated::" msgstr "Ta klasa ma niestandardową reprezentację, którą można ocenić::" @@ -3000,15 +3029,15 @@ msgstr "" " zwracać f \"Person('{self.imie}', {self.wiek})\"." msgid "" -"Return a reverse :term:`iterator`. *seq* must be an object which has a :" -"meth:`~object.__reversed__` method or supports the sequence protocol (the :" -"meth:`~object.__len__` method and the :meth:`~object.__getitem__` method " -"with integer arguments starting at ``0``)." +"Return a reverse :term:`iterator`. The argument must be an object which has " +"a :meth:`~object.__reversed__` method or supports the sequence protocol " +"(the :meth:`~object.__len__` method and the :meth:`~object.__getitem__` " +"method with integer arguments starting at ``0``)." msgstr "" -"Zwraca a reverse :term:`iterator`. *seq* musi być obiektem, który ma " +"Zwraca odwrócony :term:`iterator`. Argument musi być obiektem, który ma " "metodę :meth:`~object.__reversed__` lub obsługuje protokół sekwencji " "(metoda :meth:`~object.__len__` i metoda :meth:`~object.__getitem__` z " -"liczba całkowita argument począwszy od ``0``)." +"całkowitymi argumentami począwszy od ``0``)." msgid "" "Return *number* rounded to *ndigits* precision after the decimal point. If " @@ -3038,11 +3067,11 @@ msgstr "" "``None``. W przeciwnym razie zwracana wartość ma ten sam typ co *number*." msgid "" -"For a general Python object ``number``, ``round`` delegates to ``number." -"__round__``." +"For a general Python object ``number``, ``round`` delegates to " +"``number.__round__``." msgstr "" -"Dla ogólnego obiektu Python ``number`` , ``round`` deleguje do ``number." -"__round__``." +"Dla ogólnego obiektu Python ``number`` , ``round`` deleguje do " +"``number.__round__``." msgid "" "The behavior of :func:`round` for floats can be surprising: for example, " @@ -3059,21 +3088,21 @@ msgstr "" msgid "" "Return a new :class:`set` object, optionally with elements taken from " -"*iterable*. ``set`` is a built-in class. See :class:`set` and :ref:`types-" -"set` for documentation about this class." +"*iterable*. :class:`set` is a built-in class. See also :ref:`types-set` " +"for documentation about this class." msgstr "" -"Zwraca nowy obiekt :class:`set`, opcjonalnie z elementami pobranymi z " -"*iterable*. ``set`` jest klasą wbudowana. Dokumentacja dotycząca tej klasy " -"znajduje się na stronach :class:`set` i :ref:`types-set`." +"Zwraca nowy obiekt :class:`set`, opcjonalnie z elementami z " +"*iterable*. :class:`set` jest klasą wbudowaną. Zobacz też dokumentację " +"dotycząca tej klasy w :ref:`types-set`." msgid "" -"For other containers see the built-in :class:`frozenset`, :class:`list`, :" -"class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` " -"module." +"For other containers see the built-" +"in :class:`frozenset`, :class:`list`, :class:`tuple`, and :class:`dict` " +"classes, as well as the :mod:`collections` module." msgstr "" -"Dla innych kontenerów zobacz klasy wbudowane :class:`frozenset` , :class:" -"`list`, :class:`tuple` i :class:`dict`, jak również :mod:`collections` " -"moduł ." +"Dla innych kontenerów zobacz klasy " +"wbudowane :class:`frozenset` , :class:`list`, :class:`tuple` " +"i :class:`dict`, jak również :mod:`collections` moduł ." msgid "" "This is the counterpart of :func:`getattr`. The arguments are an object, a " @@ -3089,17 +3118,17 @@ msgstr "" msgid "" "*name* need not be a Python identifier as defined in :ref:`identifiers` " -"unless the object chooses to enforce that, for example in a custom :meth:" -"`~object.__getattribute__` or via :attr:`~object.__slots__`. An attribute " -"whose name is not an identifier will not be accessible using the dot " -"notation, but is accessible through :func:`getattr` etc.." +"unless the object chooses to enforce that, for example in a " +"custom :meth:`~object.__getattribute__` or via :attr:`~object.__slots__`. An " +"attribute whose name is not an identifier will not be accessible using the " +"dot notation, but is accessible through :func:`getattr` etc.." msgstr "" -"*name* nie musi być identyfikatorem Pythona zdefiniowanym w :ref:" -"`identifiers`, chyba że obiekt zdecyduje się to wymusić, na przykład w " -"niestandardowym :meth:`~object.__getattribute__` lub poprzez :attr:`~object." -"__slots__`. Obiekt atrybut, którego nazwa nie jest identyfikatorem, nie " -"będzie dostępny przy użyciu notacji kropkowej, ale będzie dostępny za " -"pośrednictwem :func:`getattr` itd." +"*name* nie musi być identyfikatorem Pythona zdefiniowanym " +"w :ref:`identifiers`, chyba że obiekt zdecyduje się to wymusić, na przykład " +"w niestandardowym :meth:`~object.__getattribute__` lub " +"poprzez :attr:`~object.__slots__`. Obiekt atrybut, którego nazwa nie jest " +"identyfikatorem, nie będzie dostępny przy użyciu notacji kropkowej, ale " +"będzie dostępny za pośrednictwem :func:`getattr` itd." msgid "" "Since :ref:`private name mangling ` happens at " @@ -3132,20 +3161,23 @@ msgstr "" 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`." +"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`." +"Zobacz :func:`itertools.islice` dla alternatywy, która " +"zwraca :term:`iterator`." msgid "" -"Slice objects are now :term:`hashable` (provided :attr:`~slice.start`, :attr:" -"`~slice.stop`, and :attr:`~slice.step` are hashable)." +"Slice objects are now :term:`hashable` " +"(provided :attr:`~slice.start`, :attr:`~slice.stop`, and :attr:`~slice.step` " +"are hashable)." msgstr "" -"Obiekty Slice są teraz :term:`hashable` (pod warunkiem, że :attr:`~slice." -"start`, :attr:`~slice.stop` i :attr:`~slice.step` są hashable)." +"Obiekty Slice są teraz :term:`hashable` (pod warunkiem, " +"że :attr:`~slice.start`, :attr:`~slice.stop` i :attr:`~slice.step` są " +"hashable)." msgid "Return a new sorted list from the items in *iterable*." msgstr "Zwraca nową posortowaną listę z elementów w *iterable*." @@ -3158,12 +3190,14 @@ msgstr "" msgid "" "*key* specifies a function of one argument that is used to extract a " -"comparison key from each element in *iterable* (for example, ``key=str." -"lower``). The default value is ``None`` (compare the elements directly)." +"comparison key from each element in *iterable* (for example, " +"``key=str.lower``). The default value is ``None`` (compare the elements " +"directly)." msgstr "" "*key* określa funkcje jednego argumentu, który jest używany do wyodrębnienia " -"klucza porównania z każdego elementu w *iterable* (na przykład ``key=str." -"lower``). Wartość domyślna to ``None`` (bezpośrednie porównanie elementów)." +"klucza porównania z każdego elementu w *iterable* (na przykład " +"``key=str.lower``). Wartość domyślna to ``None`` (bezpośrednie porównanie " +"elementów)." msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " @@ -3198,23 +3232,24 @@ msgid "" "implemented. This will help avoid bugs when using the same data with other " "ordering tools such as :func:`max` that rely on a different underlying " "method. Implementing all six comparisons also helps avoid confusion for " -"mixed type comparisons which can call reflected the :meth:`~object.__gt__` " +"mixed type comparisons which can call the reflected :meth:`~object.__gt__` " "method." msgstr "" "Algorytm sortowania używa tylko porównań ``<`` między elementami. Podczas " -"gdy zdefiniowanie metoda :meth:`~object.__lt__` wystarczy do sortowania, :" -"PEP:`8` zaleca zaimplementowanie wszystkich sześciu :ref:`bogatych porównań " -"`. Pomoże to uniknąć błędów podczas korzystania z tych samych " -"danych z innymi narzędziami porządkującymi, takimi jak :func:`max`, które " -"opierają się na innej metodzie bazowej. Zaimplementowanie wszystkich sześciu " -"porównań pomaga również uniknąć nieporozumień w przypadku porównań typów " -"mieszanych, które mogą wywoływać metodę :meth:`~object.__gt__`." +"gdy zdefiniowanie metoda :meth:`~object.__lt__` wystarczy do " +"sortowania, :PEP:`8` zaleca zaimplementowanie wszystkich " +"sześciu :ref:`bogatych porównań `. Pomoże to uniknąć błędów " +"podczas korzystania z tych samych danych z innymi narzędziami " +"porządkującymi, takimi jak :func:`max`, które opierają się na innej metodzie " +"bazowej. Zaimplementowanie wszystkich sześciu porównań pomaga również " +"uniknąć nieporozumień w przypadku porównań typów mieszanych, które mogą " +"wywoływać metodę :meth:`~object.__gt__`." msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -"Przykłady sortowania i krótki samouczek sortowania można znaleźć na stronie :" -"ref:`sortinghowto`." +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." msgid "Transform a method into a static method." msgstr "Przekształcenie metody w metodę statyczną." @@ -3236,17 +3271,17 @@ msgstr "" " def f(arg1, arg2, argN): ..." msgid "" -"The ``@staticmethod`` form is a function :term:`decorator` -- see :ref:" -"`function` for details." +"The ``@staticmethod`` form is a function :term:`decorator` -- " +"see :ref:`function` for details." msgstr "" -"Forma ``@staticmethod`` to :term:`dekorator` funkcji -- zobacz :ref:" -"`function` po szczegóły." +"Forma ``@staticmethod`` to :term:`dekorator` funkcji -- " +"zobacz :ref:`function` po szczegóły." msgid "" "A static method can be called either on the class (such as ``C.f()``) or on " -"an instance (such as ``C().f()``). Moreover, the static method :term:" -"`descriptor` is also callable, so it can be used in the class definition " -"(such as ``f()``)." +"an instance (such as ``C().f()``). Moreover, the static " +"method :term:`descriptor` is also callable, so it can be used in the class " +"definition (such as ``f()``)." msgstr "" "Metoda statyczna może być wywołana na klasie (np. ``C.f()``) lub na " "instancji (np. ``C().f()``). Co więcej, metoda statyczna :term:`descriptor` " @@ -3255,12 +3290,12 @@ msgstr "" msgid "" "Static methods in Python are similar to those found in Java or C++. Also, " -"see :func:`classmethod` for a variant that is useful for creating alternate " +"see :deco:`classmethod` for a variant that is useful for creating alternate " "class constructors." msgstr "" -"Metody statyczne w Python są podobne do tych, które można znaleźć w Java lub " -"C++. Zobacz także :func:`classmethod`, aby zapoznać się z wariantem, który " -"jest przydatny do tworzenia alternatywnych konstruktorów klas." +"Metody statyczne w Pythonie są podobne do tych, które można znaleźć w Java " +"lub C++. Zobacz także :deco:`classmethod`, aby zapoznać się z wariantem, " +"który jest przydatny do tworzenia alternatywnych konstruktorów klas." msgid "" "Like all decorators, it is also possible to call ``staticmethod`` as a " @@ -3290,19 +3325,19 @@ msgstr "" msgid "For more information on static methods, see :ref:`types`." msgstr "" -"Więcej informacji na temat metod statycznych można znaleźć na stronie :ref:" -"`types`." +"Więcej informacji na temat metod statycznych można znaleźć na " +"stronie :ref:`types`." msgid "" -"Static methods now inherit the method attributes (:attr:`~function." -"__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :" -"attr:`~function.__doc__` and :attr:`~function.__annotations__`), have a new " -"``__wrapped__`` attribute, and are now callable as regular functions." +"Static methods now inherit the method attributes " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"and :attr:`~function.__annotations__`), have a new ``__wrapped__`` " +"attribute, and are now callable as regular functions." msgstr "" -"Metody statyczne dziedziczą teraz metodę atrybut (:attr:`~function." -"__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :" -"attr:`~function.__doc__` i :attr:`~function.__annotations__`), mają nową " -"``__wrapped__`` atrybut i są teraz wywoływane jako zwykła funkcja." +"Metody statyczne dziedziczą teraz metodę atrybut " +"(:attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__doc__` " +"i :attr:`~function.__annotations__`), mają nową ``__wrapped__`` atrybut i są " +"teraz wywoływane jako zwykła funkcja." msgid "" "Return a :class:`str` version of *object*. See :func:`str` for details." @@ -3328,10 +3363,10 @@ msgstr "" msgid "" "For some use cases, there are good alternatives to :func:`sum`. The " -"preferred, fast way to concatenate a sequence of strings is by calling ``''." -"join(sequence)``. To add floating-point values with extended precision, " -"see :func:`math.fsum`\\. To concatenate a series of iterables, consider " -"using :func:`itertools.chain`." +"preferred, fast way to concatenate a sequence of strings is by calling " +"``''.join(sequence)``. To add floating-point values with extended " +"precision, see :func:`math.fsum`\\. To concatenate a series of iterables, " +"consider using :func:`itertools.chain`." msgstr "" "W niektórych przypadkach istnieją dobra alternatywa dla :func:`sum`. " "Preferowanym, szybkim sposobem na łączyć sekwencji napisów jest wywołanie " @@ -3366,8 +3401,8 @@ msgstr "" "Wyszukiwanie rozpoczyna się od klasy zaraz po *type*." msgid "" -"For example, if :attr:`~type.__mro__` of *object_or_type* is ``D -> B -> C -" -"> A -> object`` and the value of *type* is ``B``, then :func:`super` " +"For example, if :attr:`~type.__mro__` of *object_or_type* is ``D -> B -> C " +"-> A -> object`` and the value of *type* is ``B``, then :func:`super` " "searches ``C -> A -> object``." msgstr "" "Na przykład, jeśli :attr:`~type.__mro__` z *object_or_type* jest ``D -> B -> " @@ -3376,14 +3411,14 @@ msgstr "" msgid "" "The :attr:`~type.__mro__` attribute of the class corresponding to " -"*object_or_type* lists the method resolution search order used by both :func:" -"`getattr` and :func:`super`. The attribute is dynamic and can change " -"whenever the inheritance hierarchy is updated." +"*object_or_type* lists the method resolution search order used by " +"both :func:`getattr` and :func:`super`. The attribute is dynamic and can " +"change whenever the inheritance hierarchy is updated." msgstr "" ":attr:`~type.__mro__` atrybut klasy odpowiadającej *object_or_type* wymienia " -"kolejność wyszukiwania metod używaną zarówno przez :func:`getattr` jak i :" -"func:`super`. Adres atrybut jest dynamiczny i może ulec zmianie przy każdej " -"aktualizacji hierarchii dziedziczenia." +"kolejność wyszukiwania metod używaną zarówno przez :func:`getattr` jak " +"i :func:`super`. Adres atrybut jest dynamiczny i może ulec zmianie przy " +"każdej aktualizacji hierarchii dziedziczenia." msgid "" "If the second argument is omitted, the super object returned is unbound. If " @@ -3466,8 +3501,9 @@ msgid "" "` in a parent or sibling class." msgstr "" "Oprócz wyszukiwania metod, :func:`super` działa również dla wyszukiwania " -"atrybut. Jednym z możliwych przypadków użycia jest wywołanie :term:" -"`descriptors ` w klasie nadrzędnej lub podrzędnej." +"atrybut. Jednym z możliwych przypadków użycia jest " +"wywołanie :term:`descriptors ` w klasie nadrzędnej lub " +"podrzędnej." msgid "" "Note that :func:`super` is implemented as part of the binding process for " @@ -3502,9 +3538,9 @@ msgstr "" "dostęp do bieżącej instancji dla zwykłych metod." msgid "" -"For practical suggestions on how to design cooperative classes using :func:" -"`super`, see `guide to using super() `_." +"For practical suggestions on how to design cooperative classes " +"using :func:`super`, see `guide to using super() `_." msgstr "" "Praktyczne sugestie dotyczące projektowania klas współpracujących przy " "użyciu :func:`super` można znaleźć w `poradniku korzystania z super() " @@ -3519,8 +3555,8 @@ msgstr "" msgid "" "With one argument, return the type of an *object*. The return value is a " -"type object and generally the same object as returned by :attr:`object." -"__class__`." +"type object and generally the same object as returned " +"by :attr:`object.__class__`." msgstr "" "Z jednym argumentem, zwraca typ *obiektu*. Typ zwracanej wartość jest " "obiektem typu i generalnie jest to ten sam obiekt, który został zwrócony " @@ -3540,9 +3576,9 @@ msgid "" "tuple contains the base classes and becomes the :attr:`~type.__bases__` " "attribute; if empty, :class:`object`, the ultimate base of all classes, is " "added. The *dict* dictionary contains attribute and method definitions for " -"the class body; it may be copied or wrapped before becoming the :attr:`~type." -"__dict__` attribute. The following two statements create identical :class:`!" -"type` objects:" +"the class body; it may be copied or wrapped before becoming " +"the :attr:`~type.__dict__` attribute. The following two statements create " +"identical :class:`!type` objects:" msgstr "" "Z trzema argumentamy, zwracać nowy typ obiektu. Jest to zasadniczo " "dynamiczna forma :keyword:`class` instrukcja . *name* napis jest nazwą klasy " @@ -3572,9 +3608,20 @@ msgid "" "would." msgstr "" "Argument nazwane dostarczone do trzech formularzy argumenty są przekazywane " -"do odpowiedniego mechanizmu metaklas (zwykle :meth:`~object." -"__init_subclass__`) w taki sam sposób, jak słowa kluczowe w definicja klasy " -"(poza *metaclass*)." +"do odpowiedniego mechanizmu metaklas " +"(zwykle :meth:`~object.__init_subclass__`) w taki sam sposób, jak słowa " +"kluczowe w definicja klasy (poza *metaclass*)." + +msgid "" +"Unlike a :keyword:`class` statement, the three argument form does not call " +"the metaclass ``__prepare__`` method (see :ref:`prepare`). " +"Use :func:`types.new_class` to dynamically create a class using the " +"appropriate metaclass." +msgstr "" +"W przeciwieństwie do instrukcji :keyword:`class`, forma z trzema argumentami " +"nie wywołuje metody ``__prepare__`` metaklasy (zobacz :ref:`prepare`). Aby " +"dynamicznie utworzyć klasę przy użyciu odpowiedniej metaklasy, należy " +"skorzystać z :func:`types.new_class`." msgid "See also :ref:`class-customization`." msgstr "Zobacz także :ref:`class-customization`." @@ -3594,15 +3641,17 @@ msgstr "" "dowolnego innego obiektu z :attr:`!__dict__` atrybut ." msgid "" -"Objects such as modules and instances have an updateable :attr:`~object." -"__dict__` attribute; however, other objects may have write restrictions on " -"their :attr:`!__dict__` attributes (for example, classes use a :class:`types." -"MappingProxyType` to prevent direct dictionary updates)." +"Objects such as modules and instances have an " +"updateable :attr:`~object.__dict__` attribute; however, other objects may " +"have write restrictions on their :attr:`!__dict__` attributes (for example, " +"classes use a :class:`types.MappingProxyType` to prevent direct dictionary " +"updates)." msgstr "" -"Obiekty takie jak moduł i instancje mają możliwość aktualizacji :attr:" -"`~object.__dict__` atrybut; jednak inne obiekty mogą mieć ograniczenia " -"zapisu na ich :attr:`!__dict__` atrybut (na przykład klasy używają :class:" -"`types.MappingProxyType`, aby zapobiec bezpośrednim aktualizacjom słownika)." +"Obiekty takie jak moduł i instancje mają możliwość " +"aktualizacji :attr:`~object.__dict__` atrybut; jednak inne obiekty mogą mieć " +"ograniczenia zapisu na ich :attr:`!__dict__` atrybut (na przykład klasy " +"używają :class:`types.MappingProxyType`, aby zapobiec bezpośrednim " +"aktualizacjom słownika)." msgid "Without an argument, :func:`vars` acts like :func:`locals`." msgstr "Bez argumenta, :func:`vars` działa jak :func:`locals`." @@ -3657,8 +3706,8 @@ msgstr "" msgid "" "Another way to think of :func:`zip` is that it turns rows into columns, and " -"columns into rows. This is similar to `transposing a matrix `_." +"columns into rows. This is similar to `transposing a matrix `_." msgstr "" "Innym sposobem myślenia o :func:`zip` jest to, że zamienia wiersze w " "kolumny, a kolumny w wiersze. Jest to podobne do `przekształcania macierzy " @@ -3666,8 +3715,8 @@ msgstr "" msgid "" ":func:`zip` is lazy: The elements won't be processed until the iterable is " -"iterated on, e.g. by a :keyword:`!for` loop or by wrapping in a :class:" -"`list`." +"iterated on, e.g. by a :keyword:`!for` loop or by wrapping in " +"a :class:`list`." msgstr "" ":func:`zip` jest leniwy: Elementy nie będą przetwarzane, dopóki iterable nie " "zostanie poddany iteracji, np. przez pętlę :keyword:`!for` lub przez " @@ -3734,12 +3783,12 @@ msgstr "" msgid "" "Shorter iterables can be padded with a constant value to make all the " -"iterables have the same length. This is done by :func:`itertools." -"zip_longest`." +"iterables have the same length. This is done " +"by :func:`itertools.zip_longest`." msgstr "" "Krótsze iterable mogą być uzupełnione stałą wartością, aby wszystkie " -"iterable miały taką samą długość. Odbywa się to poprzez :func:`itertools." -"zip_longest`." +"iterable miały taką samą długość. Odbywa się to " +"poprzez :func:`itertools.zip_longest`." msgid "" "Edge cases: With a single iterable argument, :func:`zip` returns an iterator " @@ -3809,13 +3858,13 @@ msgid "" "discouraged in favor of :func:`importlib.import_module`." msgstr "" "Ten funkcja jest wywoływany przez :keyword:`import` instrukcja . Można go " -"zastąpić (importując :mod:`builtins` moduł i przypisując do ``builtins." -"__import__``) w celu zmiany semantyki :keyword:`!import` instrukcja , ale " -"jest to **bardżo** odradzane, ponieważ zwykle prostsze jest użycie haków " -"importu (zobacz :pep:`302`), aby osiągnąć te same cele i nie powoduje " -"problemów z kodem, który zakłada, że implementacja importu domyślny jest w " -"użyciu. Bezpośrednie użycie :func:`__import__` jest również odradzane na " -"korzyść :func:`importlib.import_module`." +"zastąpić (importując :mod:`builtins` moduł i przypisując do " +"``builtins.__import__``) w celu zmiany semantyki :keyword:`!import` " +"instrukcja , ale jest to **bardżo** odradzane, ponieważ zwykle prostsze jest " +"użycie haków importu (zobacz :pep:`302`), aby osiągnąć te same cele i nie " +"powoduje problemów z kodem, który zakłada, że implementacja importu domyślny " +"jest w użyciu. Bezpośrednie użycie :func:`__import__` jest również " +"odradzane na korzyść :func:`importlib.import_module`." msgid "" "The function imports the module *name*, potentially using the given " diff --git a/library/functools.po b/library/functools.po index 4de93e6f29..edb1ce0205 100644 --- a/library/functools.po +++ b/library/functools.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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/functools.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/functools.py`" msgid "" "The :mod:`functools` module is for higher-order functions: functions that " @@ -49,7 +48,7 @@ msgstr "" msgid "" "Returns the same as ``lru_cache(maxsize=None)``, creating a thin wrapper " "around a dictionary lookup for the function arguments. Because it never " -"needs to evict old values, this is smaller and faster than :func:`lru_cache` " +"needs to evict old values, this is smaller and faster than :deco:`lru_cache` " "with a size limit." msgstr "" @@ -61,13 +60,11 @@ msgid "" "def factorial(n):\n" " return n * factorial(n-1) if n else 1\n" "\n" -">>> factorial(10) # no previously cached result, makes 11 recursive " -"calls\n" +">>> factorial(10) # no previously cached result, makes 11 recursive calls\n" "3628800\n" -">>> factorial(5) # just looks up cached value result\n" +">>> factorial(5) # no new calls, just returns the cached result\n" "120\n" -">>> factorial(12) # makes two new recursive calls, the other 10 are " -"cached\n" +">>> factorial(12) # two new recursive calls, factorial(10) is cached\n" "479001600" msgstr "" @@ -86,7 +83,7 @@ msgstr "" msgid "" "Transform a method of a class into a property whose value is computed once " "and then cached as a normal attribute for the life of the instance. Similar " -"to :func:`property`, with the addition of caching. Useful for expensive " +"to :deco:`property`, with the addition of caching. Useful for expensive " "computed properties of instances that are otherwise effectively immutable." msgstr "" @@ -105,9 +102,9 @@ msgid "" msgstr "" msgid "" -"The mechanics of :func:`cached_property` are somewhat different from :func:" -"`property`. A regular property blocks attribute writes unless a setter is " -"defined. In contrast, a *cached_property* allows writes." +"The mechanics of :deco:`cached_property` are somewhat different " +"from :deco:`property`. A regular property blocks attribute writes unless a " +"setter is defined. In contrast, a *cached_property* allows writes." msgstr "" msgid "" @@ -150,15 +147,15 @@ msgstr "" msgid "" "If a mutable mapping is not available or if space-efficient key sharing is " -"desired, an effect similar to :func:`cached_property` can also be achieved " -"by stacking :func:`property` on top of :func:`lru_cache`. See :ref:`faq-" -"cache-method-calls` for more details on how this differs from :func:" -"`cached_property`." +"desired, an effect similar to :deco:`cached_property` can also be achieved " +"by stacking :deco:`property` on top of :deco:`lru_cache`. See :ref:`faq-" +"cache-method-calls` for more details on how this differs " +"from :deco:`cached_property`." msgstr "" msgid "" -"Prior to Python 3.12, ``cached_property`` included an undocumented lock to " -"ensure that in multi-threaded usage the getter function was guaranteed to " +"Prior to Python 3.12, :deco:`!cached_property` included an undocumented lock " +"to ensure that in multi-threaded usage the getter function was guaranteed to " "run only once per instance. However, the lock was per-property, not per-" "instance, which could result in unacceptably high lock contention. In Python " "3.12+ this locking is removed." @@ -166,11 +163,10 @@ msgstr "" msgid "" "Transform an old-style comparison function to a :term:`key function`. Used " -"with tools that accept key functions (such as :func:`sorted`, :func:`min`, :" -"func:`max`, :func:`heapq.nlargest`, :func:`heapq.nsmallest`, :func:" -"`itertools.groupby`). This function is primarily used as a transition tool " -"for programs being converted from Python 2 which supported the use of " -"comparison functions." +"with tools that accept key functions (such " +"as :func:`sorted`, :func:`min`, :func:`max`, :func:`heapq.nlargest`, :func:`heapq.nsmallest`, :func:`itertools.groupby`). " +"This function is primarily used as a transition tool for programs being " +"converted from Python 2 which supported the use of comparison functions." msgstr "" msgid "" @@ -187,8 +183,8 @@ msgstr "" msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -"Przykłady sortowania i krótki samouczek sortowania można znaleźć na stronie :" -"ref:`sortinghowto`." +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." msgid "" "Decorator to wrap a function with a memoizing callable that saves up to the " @@ -235,7 +231,7 @@ msgstr "" msgid "" "Note, type specificity applies only to the function's immediate arguments " "rather than their contents. The scalar arguments, ``Decimal(42)`` and " -"``Fraction(42)`` are be treated as distinct calls with distinct results. In " +"``Fraction(42)`` are treated as distinct calls with distinct results. In " "contrast, the tuple arguments ``('answer', Decimal(42))`` and ``('answer', " "Fraction(42))`` are treated as equivalent." msgstr "" @@ -249,20 +245,20 @@ msgstr "" msgid "" "To help measure the effectiveness of the cache and tune the *maxsize* " -"parameter, the wrapped function is instrumented with a :func:`cache_info` " +"parameter, the wrapped function is instrumented with a :func:`!cache_info` " "function that returns a :term:`named tuple` showing *hits*, *misses*, " "*maxsize* and *currsize*." msgstr "" msgid "" -"The decorator also provides a :func:`cache_clear` function for clearing or " +"The decorator also provides a :func:`!cache_clear` function for clearing or " "invalidating the cache." msgstr "" msgid "" -"The original underlying function is accessible through the :attr:" -"`__wrapped__` attribute. This is useful for introspection, for bypassing " -"the cache, or for rewrapping the function with a different cache." +"The original underlying function is accessible through " +"the :attr:`__wrapped__` attribute. This is useful for introspection, for " +"bypassing the cache, or for rewrapping the function with a different cache." msgstr "" msgid "" @@ -315,9 +311,10 @@ msgid "" msgstr "" msgid "" -"Example of efficiently computing `Fibonacci numbers `_ using a cache to implement a `dynamic " -"programming `_ technique::" +"Example of efficiently computing `Fibonacci numbers `_ using a cache to implement a " +"`dynamic programming `_ " +"technique::" msgstr "" msgid "" @@ -350,9 +347,10 @@ msgid "" msgstr "" msgid "" -"The class must define one of :meth:`__lt__`, :meth:`__le__`, :meth:`__gt__`, " -"or :meth:`__ge__`. In addition, the class should supply an :meth:`__eq__` " -"method." +"The class must define one " +"of :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__`, " +"or :meth:`~object.__ge__`. In addition, the class should supply " +"an :meth:`~object.__eq__` method." msgstr "" msgid "" @@ -421,9 +419,9 @@ msgid "" msgstr "" msgid "" -"Return a new :class:`partialmethod` descriptor which behaves like :class:" -"`partial` except that it is designed to be used as a method definition " -"rather than being directly callable." +"Return a new :class:`partialmethod` descriptor which behaves " +"like :class:`partial` except that it is designed to be used as a method " +"definition rather than being directly callable." msgstr "" msgid "" @@ -432,19 +430,19 @@ msgid "" msgstr "" msgid "" -"When *func* is a descriptor (such as a normal Python function, :func:" -"`classmethod`, :func:`staticmethod`, :func:`abstractmethod` or another " -"instance of :class:`partialmethod`), calls to ``__get__`` are delegated to " -"the underlying descriptor, and an appropriate :ref:`partial object` returned as the result." +"When *func* is a descriptor (such as a normal Python " +"function, :func:`classmethod`, :func:`staticmethod`, :func:`~abc.abstractmethod` " +"or another instance of :class:`partialmethod`), calls to ``__get__`` are " +"delegated to the underlying descriptor, and an appropriate :ref:`partial " +"object` returned as the result." msgstr "" msgid "" "When *func* is a non-descriptor callable, an appropriate bound method is " "created dynamically. This behaves like a normal Python function when used as " "a method: the *self* argument will be inserted as the first positional " -"argument, even before the *args* and *keywords* supplied to the :class:" -"`partialmethod` constructor." +"argument, even before the *args* and *keywords* supplied to " +"the :class:`partialmethod` constructor." msgstr "" msgid "" @@ -502,8 +500,8 @@ msgid "" msgstr "" msgid "" -"Transform a function into a :term:`single-dispatch ` :term:" -"`generic function`." +"Transform a function into a :term:`single-dispatch ` :term:`generic function`." msgstr "" msgid "" @@ -522,7 +520,7 @@ msgid "" msgstr "" msgid "" -"To add overloaded implementations to the function, use the :func:`register` " +"To add overloaded implementations to the function, use the :func:`!register` " "attribute of the generic function, which can be used as a decorator. For " "functions annotated with types, the decorator will infer the type of the " "first argument automatically::" @@ -602,7 +600,8 @@ msgstr "" msgid "" "To enable registering :term:`lambdas` and pre-existing functions, " -"the :func:`register` attribute can also be used in a functional form::" +"the :func:`~singledispatch.register` attribute can also be used in a " +"functional form::" msgstr "" msgid "" @@ -617,9 +616,9 @@ msgstr "" ">>> fun.register(type(None), nothing)" msgid "" -"The :func:`register` attribute returns the undecorated function. This " -"enables decorator stacking, :mod:`pickling`, and the creation of " -"unit tests for each variant independently::" +"The :func:`~singledispatch.register` attribute returns the undecorated " +"function. This enables decorator stacking, :mod:`pickling`, and the " +"creation of unit tests for each variant independently::" msgstr "" msgid "" @@ -661,9 +660,9 @@ msgstr "" msgid "" "Where there is no registered implementation for a specific type, its method " "resolution order is used to find a more generic implementation. The original " -"function decorated with ``@singledispatch`` is registered for the base :" -"class:`object` type, which means it is used if no better implementation is " -"found." +"function decorated with ``@singledispatch`` is registered for the " +"base :class:`object` type, which means it is used if no better " +"implementation is found." msgstr "" msgid "" @@ -713,23 +712,26 @@ msgid "" "" msgstr "" -msgid "The :func:`register` attribute now supports using type annotations." +msgid "" +"The :func:`~singledispatch.register` attribute now supports using type " +"annotations." msgstr "" msgid "" -"The :func:`register` attribute now supports :data:`types.UnionType` and :" -"data:`typing.Union` as type annotations." +"The :func:`~singledispatch.register` attribute now " +"supports :data:`types.UnionType` and :data:`typing.Union` as type " +"annotations." msgstr "" msgid "" -"Transform a method into a :term:`single-dispatch ` :term:" -"`generic function`." +"Transform a method into a :term:`single-dispatch ` :term:`generic function`." msgstr "" msgid "" "To define a generic method, decorate it with the ``@singledispatchmethod`` " -"decorator. When defining a function using ``@singledispatchmethod``, note " -"that the dispatch happens on the type of the first non-*self* or non-*cls* " +"decorator. When defining a method using ``@singledispatchmethod``, note that " +"the dispatch happens on the type of the first non-*self* or non-*cls* " "argument::" msgstr "" @@ -749,11 +751,11 @@ msgid "" msgstr "" msgid "" -"``@singledispatchmethod`` supports nesting with other decorators such as :" -"func:`@classmethod`. Note that to allow for ``dispatcher." -"register``, ``singledispatchmethod`` must be the *outer most* decorator. " -"Here is the ``Negator`` class with the ``neg`` methods bound to the class, " -"rather than an instance of the class::" +"``@singledispatchmethod`` supports nesting with other decorators such " +"as :deco:`classmethod`. Note that to allow for ``dispatcher.register``, " +"``singledispatchmethod`` must be the *outer most* decorator. Here is the " +"``Negator`` class with the ``neg`` methods bound to the class, rather than " +"an instance of the class::" msgstr "" msgid "" @@ -775,9 +777,8 @@ msgid "" msgstr "" msgid "" -"The same pattern can be used for other similar decorators: :func:" -"`@staticmethod`, :func:`@abstractmethod`, " -"and others." +"The same pattern can be used for other similar " +"decorators: :deco:`staticmethod`, :deco:`~abc.abstractmethod`, and others." msgstr "" msgid "" @@ -787,17 +788,16 @@ msgid "" "function and which attributes of the wrapper function are updated with the " "corresponding attributes from the original function. The default values for " "these arguments are the module level constants ``WRAPPER_ASSIGNMENTS`` " -"(which assigns to the wrapper function's :attr:`~function.__module__`, :attr:" -"`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function." -"__annotations__`, :attr:`~function.__type_params__`, and :attr:`~function." -"__doc__`, the documentation string) and ``WRAPPER_UPDATES`` (which updates " -"the wrapper function's :attr:`~function.__dict__`, i.e. the instance " -"dictionary)." +"(which assigns to the wrapper " +"function's :attr:`~function.__module__`, :attr:`~function.__name__`, :attr:`~function.__qualname__`, :attr:`~function.__annotations__`, :attr:`~function.__type_params__`, " +"and :attr:`~function.__doc__`, the documentation string) and " +"``WRAPPER_UPDATES`` (which updates the wrapper " +"function's :attr:`~function.__dict__`, i.e. the instance dictionary)." msgstr "" msgid "" "To allow access to the original function for introspection and other " -"purposes (e.g. bypassing a caching decorator such as :func:`lru_cache`), " +"purposes (e.g. bypassing a caching decorator such as :deco:`lru_cache`), " "this function automatically adds a ``__wrapped__`` attribute to the wrapper " "that refers to the function being wrapped." msgstr "" @@ -819,15 +819,15 @@ msgid "" msgstr "" msgid "" -"The ``__wrapped__`` attribute is now automatically added. The :attr:" -"`~function.__annotations__` attribute is now copied by default. Missing " -"attributes no longer trigger an :exc:`AttributeError`." +"The ``__wrapped__`` attribute is now automatically added. " +"The :attr:`~function.__annotations__` attribute is now copied by default. " +"Missing attributes no longer trigger an :exc:`AttributeError`." msgstr "" msgid "" "The ``__wrapped__`` attribute now always refers to the wrapped function, " -"even if that function defined a ``__wrapped__`` attribute. (see :issue:" -"`17482`)" +"even if that function defined a ``__wrapped__`` attribute. " +"(see :issue:`17482`)" msgstr "" msgid "" @@ -866,8 +866,8 @@ msgstr "" msgid "" "Without the use of this decorator factory, the name of the example function " -"would have been ``'wrapper'``, and the docstring of the original :func:" -"`example` would have been lost." +"would have been ``'wrapper'``, and the docstring of the original :func:`!" +"example` would have been lost." msgstr "" msgid ":class:`partial` Objects" @@ -896,9 +896,9 @@ msgstr "" msgid "" ":class:`partial` objects are like :ref:`function objects ` in that they are callable, weak referenceable, and can have " -"attributes. There are some important differences. For instance, the :attr:" -"`~function.__name__` and :attr:`function.__doc__` attributes are not created " -"automatically. Also, :class:`partial` objects defined in classes behave " -"like static methods and do not transform into bound methods during instance " -"attribute look-up." +"attributes. There are some important differences. For instance, " +"the :attr:`~function.__name__` and :attr:`function.__doc__` attributes are " +"not created automatically. Also, :class:`partial` objects defined in " +"classes behave like static methods and do not transform into bound methods " +"during instance attribute look-up." msgstr "" diff --git a/library/gc.po b/library/gc.po index 5757239033..ff4f31af5f 100644 --- a/library/gc.po +++ b/library/gc.po @@ -126,9 +126,9 @@ msgid "" "examined. If generation ``0`` has been examined more than *threshold1* " "times since generation ``1`` has been examined, then generation ``1`` is " "examined as well. With the third generation, things are a bit more " -"complicated, see `Collecting the oldest generation `_ for more " -"information." +"complicated, see `Collecting the oldest generation `_ " +"for more information." msgstr "" msgid "" @@ -169,13 +169,14 @@ msgstr "" msgid "" "Return a list of objects directly referred to by any of the arguments. The " -"referents returned are those objects visited by the arguments' C-level :c:" -"member:`~PyTypeObject.tp_traverse` methods (if any), and may not be all " -"objects actually directly reachable. :c:member:`~PyTypeObject.tp_traverse` " -"methods are supported only by objects that support garbage collection, and " -"are only required to visit objects that may be involved in a cycle. So, for " -"example, if an integer is directly reachable from an argument, that integer " -"object may or may not appear in the result list." +"referents returned are those objects visited by the arguments' C-" +"level :c:member:`~PyTypeObject.tp_traverse` methods (if any), and may not be " +"all objects actually directly " +"reachable. :c:member:`~PyTypeObject.tp_traverse` methods are supported only " +"by objects that support garbage collection, and are only required to visit " +"objects that may be involved in a cycle. So, for example, if an integer is " +"directly reachable from an argument, that integer object may or may not " +"appear in the result list." msgstr "" msgid "" @@ -239,15 +240,15 @@ msgid "" msgstr "" msgid "" -"If this list is non-empty at :term:`interpreter shutdown`, a :exc:" -"`ResourceWarning` is emitted, which is silent by default. If :const:" -"`DEBUG_UNCOLLECTABLE` is set, in addition all uncollectable objects are " -"printed." +"If this list is non-empty at :term:`interpreter shutdown`, " +"a :exc:`ResourceWarning` is emitted, which is silent by default. " +"If :const:`DEBUG_UNCOLLECTABLE` is set, in addition all uncollectable " +"objects are printed." msgstr "" msgid "" -"Following :pep:`442`, objects with a :meth:`__del__` method don't end up in :" -"attr:`gc.garbage` anymore." +"Following :pep:`442`, objects with a :meth:`__del__` method don't end up " +"in :attr:`gc.garbage` anymore." msgstr "" msgid "" diff --git a/library/getopt.po b/library/getopt.po index 655cf83721..a3ae9b371c 100644 --- a/library/getopt.po +++ b/library/getopt.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: -# Transifex Bot <>, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2025-08-07 21:40+0000\n" +"PO-Revision-Date: 2025-07-18 19: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" @@ -23,28 +23,37 @@ 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 ":mod:`getopt` --- C-style parser for command line options" +msgid ":mod:`!getopt` --- C-style parser for command line options" msgstr "" msgid "**Source code:** :source:`Lib/getopt.py`" msgstr "" msgid "" -"The :mod:`getopt` module is a parser for command line options whose API is " -"designed to be familiar to users of the C :c:func:`getopt` function. Users " -"who are unfamiliar with the C :c:func:`getopt` function or who would like to " -"write less code and get better help and error messages should consider using " -"the :mod:`argparse` module instead." +"This module is considered feature complete. A more declarative and " +"extensible alternative to this API is provided in the :mod:`optparse` " +"module. Further functional enhancements for command line parameter " +"processing are provided either as third party modules on PyPI, or else as " +"features in the :mod:`argparse` module." msgstr "" msgid "" -"This module helps scripts to parse the command line arguments in ``sys." -"argv``. It supports the same conventions as the Unix :c:func:`getopt` " +"This module helps scripts to parse the command line arguments in " +"``sys.argv``. It supports the same conventions as the Unix :c:func:`!getopt` " "function (including the special meanings of arguments of the form '``-``' " "and '``--``'). Long options similar to those supported by GNU software may " "be used as well via an optional third argument." msgstr "" +msgid "" +"Users who are unfamiliar with the Unix :c:func:`!getopt` function should " +"consider using the :mod:`argparse` module instead. Users who are familiar " +"with the Unix :c:func:`!getopt` function, but would like to get equivalent " +"behavior while writing less code and getting better help and error messages " +"should consider using the :mod:`optparse` module. See :ref:`choosing-an-" +"argument-parser` for additional details." +msgstr "" + msgid "This module provides two functions and an exception:" msgstr "" @@ -53,12 +62,12 @@ msgid "" "to be parsed, without the leading reference to the running program. " "Typically, this means ``sys.argv[1:]``. *shortopts* is the string of option " "letters that the script wants to recognize, with options that require an " -"argument followed by a colon (``':'``; i.e., the same format that Unix :c:" -"func:`getopt` uses)." +"argument followed by a colon (``':'``; i.e., the same format that " +"Unix :c:func:`!getopt` uses)." msgstr "" msgid "" -"Unlike GNU :c:func:`getopt`, after a non-option argument, all further " +"Unlike GNU :c:func:`!getopt`, after a non-option argument, all further " "arguments are considered also non-options. This is similar to the way non-" "GNU Unix systems work." msgstr "" @@ -81,9 +90,9 @@ msgid "" "value)`` pairs; the second is the list of program arguments left after the " "option list was stripped (this is a trailing slice of *args*). Each option-" "and-value pair returned has the option as its first element, prefixed with a " -"hyphen for short options (e.g., ``'-x'``) or two hyphens for long options (e." -"g., ``'--long-option'``), and the option argument as its second element, or " -"an empty string if the option has no argument. The options occur in the " +"hyphen for short options (e.g., ``'-x'``) or two hyphens for long options " +"(e.g., ``'--long-option'``), and the option argument as its second element, " +"or an empty string if the option has no argument. The options occur in the " "list in the same order in which they were found, thus allowing multiple " "occurrences. Long and short options may be mixed." msgstr "" @@ -97,7 +106,7 @@ msgstr "" msgid "" "If the first character of the option string is ``'+'``, or if the " -"environment variable :envvar:`POSIXLY_CORRECT` is set, then option " +"environment variable :envvar:`!POSIXLY_CORRECT` is set, then option " "processing stops as soon as a non-option argument is encountered." msgstr "" @@ -106,9 +115,9 @@ msgid "" "when an option requiring an argument is given none. The argument to the " "exception is a string indicating the cause of the error. For long options, " "an argument given to an option which does not require one will also cause " -"this exception to be raised. The attributes :attr:`msg` and :attr:`opt` " +"this exception to be raised. The attributes :attr:`!msg` and :attr:`!opt` " "give the error message and related option; if there is no specific option to " -"which the exception relates, :attr:`opt` is an empty string." +"which the exception relates, :attr:`!opt` is an empty string." msgstr "" msgid "Alias for :exc:`GetoptError`; for backward compatibility." @@ -117,20 +126,135 @@ msgstr "" msgid "An example using only Unix style options:" msgstr "" +msgid "" +">>> import getopt\n" +">>> args = '-a -b -cfoo -d bar a1 a2'.split()\n" +">>> args\n" +"['-a', '-b', '-cfoo', '-d', 'bar', 'a1', 'a2']\n" +">>> optlist, args = getopt.getopt(args, 'abc:d:')\n" +">>> optlist\n" +"[('-a', ''), ('-b', ''), ('-c', 'foo'), ('-d', 'bar')]\n" +">>> args\n" +"['a1', 'a2']" +msgstr "" + msgid "Using long option names is equally easy:" msgstr "" -msgid "In a script, typical usage is something like this::" +msgid "" +">>> s = '--condition=foo --testing --output-file abc.def -x a1 a2'\n" +">>> args = s.split()\n" +">>> args\n" +"['--condition=foo', '--testing', '--output-file', 'abc.def', '-x', 'a1', " +"'a2']\n" +">>> optlist, args = getopt.getopt(args, 'x', [\n" +"... 'condition=', 'output-file=', 'testing'])\n" +">>> optlist\n" +"[('--condition', 'foo'), ('--testing', ''), ('--output-file', 'abc.def'), ('-" +"x', '')]\n" +">>> args\n" +"['a1', 'a2']" +msgstr "" + +msgid "In a script, typical usage is something like this:" +msgstr "" + +msgid "" +"import getopt, sys\n" +"\n" +"def main():\n" +" try:\n" +" opts, args = getopt.getopt(sys.argv[1:], \"ho:v\", [\"help\", " +"\"output=\"])\n" +" except getopt.GetoptError as err:\n" +" # print help information and exit:\n" +" print(err) # will print something like \"option -a not " +"recognized\"\n" +" usage()\n" +" sys.exit(2)\n" +" output = None\n" +" verbose = False\n" +" for o, a in opts:\n" +" if o == \"-v\":\n" +" verbose = True\n" +" elif o in (\"-h\", \"--help\"):\n" +" usage()\n" +" sys.exit()\n" +" elif o in (\"-o\", \"--output\"):\n" +" output = a\n" +" else:\n" +" assert False, \"unhandled option\"\n" +" process(args, output=output, verbose=verbose)\n" +"\n" +"if __name__ == \"__main__\":\n" +" main()" msgstr "" msgid "" "Note that an equivalent command line interface could be produced with less " -"code and more informative help and error messages by using the :mod:" -"`argparse` module::" +"code and more informative help and error messages by using " +"the :mod:`optparse` module:" +msgstr "" + +msgid "" +"import optparse\n" +"\n" +"if __name__ == '__main__':\n" +" parser = optparse.OptionParser()\n" +" parser.add_option('-o', '--output')\n" +" parser.add_option('-v', dest='verbose', action='store_true')\n" +" opts, args = parser.parse_args()\n" +" process(args, output=opts.output, verbose=opts.verbose)" +msgstr "" +"import optparse\n" +"\n" +"if __name__ == '__main__':\n" +" parser = optparse.OptionParser()\n" +" parser.add_option('-o', '--output')\n" +" parser.add_option('-v', dest='verbose', action='store_true')\n" +" opts, args = parser.parse_args()\n" +" process(args, output=opts.output, verbose=opts.verbose)" + +msgid "" +"A roughly equivalent command line interface for this case can also be " +"produced by using the :mod:`argparse` module:" +msgstr "" + +msgid "" +"import argparse\n" +"\n" +"if __name__ == '__main__':\n" +" parser = argparse.ArgumentParser()\n" +" parser.add_argument('-o', '--output')\n" +" parser.add_argument('-v', dest='verbose', action='store_true')\n" +" parser.add_argument('rest', nargs='*')\n" +" args = parser.parse_args()\n" +" process(args.rest, output=args.output, verbose=args.verbose)" +msgstr "" +"import argparse\n" +"\n" +"if __name__ == '__main__':\n" +" parser = argparse.ArgumentParser()\n" +" parser.add_argument('-o', '--output')\n" +" parser.add_argument('-v', dest='verbose', action='store_true')\n" +" parser.add_argument('rest', nargs='*')\n" +" args = parser.parse_args()\n" +" process(args.rest, output=args.output, verbose=args.verbose)" + +msgid "" +"See :ref:`choosing-an-argument-parser` for details on how the ``argparse`` " +"version of this code differs in behaviour from the ``optparse`` (and " +"``getopt``) version." +msgstr "" + +msgid "Module :mod:`optparse`" +msgstr "" + +msgid "Declarative command line option parsing." msgstr "" msgid "Module :mod:`argparse`" msgstr "" -msgid "Alternative command line option and argument parsing library." +msgid "More opinionated command line option and argument parsing library." msgstr "" diff --git a/library/getpass.po b/library/getpass.po index fb38bb0737..59765b732e 100644 --- a/library/getpass.po +++ b/library/getpass.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!getpass` --- Portable password input" msgstr "" msgid "**Source code:** :source:`Lib/getpass.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/getpass.py`" msgid "Availability" msgstr "Dostępność" @@ -51,8 +51,8 @@ msgstr "" msgid "" "If echo free input is unavailable getpass() falls back to printing a warning " -"message to *stream* and reading from ``sys.stdin`` and issuing a :exc:" -"`GetPassWarning`." +"message to *stream* and reading from ``sys.stdin`` and issuing " +"a :exc:`GetPassWarning`." msgstr "" msgid "" @@ -67,11 +67,12 @@ msgid "Return the \"login name\" of the user." msgstr "" msgid "" -"This function checks the environment variables :envvar:`LOGNAME`, :envvar:" -"`USER`, :envvar:`!LNAME` and :envvar:`USERNAME`, in order, and returns the " -"value of the first one which is set to a non-empty string. If none are set, " -"the login name from the password database is returned on systems which " -"support the :mod:`pwd` module, otherwise, an :exc:`OSError` is raised." +"This function checks the environment " +"variables :envvar:`LOGNAME`, :envvar:`USER`, :envvar:`!LNAME` " +"and :envvar:`USERNAME`, in order, and returns the value of the first one " +"which is set to a non-empty string. If none are set, the login name from " +"the password database is returned on systems which support the :mod:`pwd` " +"module, otherwise, an :exc:`OSError` is raised." msgstr "" msgid "In general, this function should be preferred over :func:`os.getlogin`." diff --git a/library/gettext.po b/library/gettext.po index 07ec6f6a75..348685c558 100644 --- a/library/gettext.po +++ b/library/gettext.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!gettext` --- Multilingual internationalization services" msgstr "" msgid "**Source code:** :source:`Lib/gettext.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/gettext.py`" msgid "" "The :mod:`gettext` module provides internationalization (I18N) and " @@ -58,12 +57,13 @@ msgid "" msgstr "" msgid "" -"Bind the *domain* to the locale directory *localedir*. More concretely, :" -"mod:`gettext` will look for binary :file:`.mo` files for the given domain " -"using the path (on Unix): :file:`{localedir}/{language}/LC_MESSAGES/{domain}." -"mo`, where *language* is searched for in the environment variables :envvar:" -"`LANGUAGE`, :envvar:`LC_ALL`, :envvar:`LC_MESSAGES`, and :envvar:`LANG` " -"respectively." +"Bind the *domain* to the locale directory *localedir*. More " +"concretely, :mod:`gettext` will look for binary :file:`.mo` files for the " +"given domain using the path (on Unix): :file:`{localedir}/{language}/" +"LC_MESSAGES/{domain}.mo`, where *language* is searched for in the " +"environment " +"variables :envvar:`LANGUAGE`, :envvar:`LC_ALL`, :envvar:`LC_MESSAGES`, " +"and :envvar:`LANG` respectively." msgstr "" msgid "" @@ -153,11 +153,12 @@ msgstr "" msgid "" "If *localedir* is not given, then the default system locale directory is " "used. [#]_ If *languages* is not given, then the following environment " -"variables are searched: :envvar:`LANGUAGE`, :envvar:`LC_ALL`, :envvar:" -"`LC_MESSAGES`, and :envvar:`LANG`. The first one returning a non-empty " -"value is used for the *languages* variable. The environment variables should " -"contain a colon separated list of languages, which will be split on the " -"colon to produce the expected list of language code strings." +"variables are " +"searched: :envvar:`LANGUAGE`, :envvar:`LC_ALL`, :envvar:`LC_MESSAGES`, " +"and :envvar:`LANG`. The first one returning a non-empty value is used for " +"the *languages* variable. The environment variables should contain a colon " +"separated list of languages, which will be split on the colon to produce the " +"expected list of language code strings." msgstr "" msgid "" @@ -193,8 +194,8 @@ msgstr "" msgid "" "If no :file:`.mo` file is found, this function raises :exc:`OSError` if " -"*fallback* is false (which is the default), and returns a :class:" -"`NullTranslations` instance if *fallback* is true." +"*fallback* is false (which is the default), and returns " +"a :class:`NullTranslations` instance if *fallback* is true." msgstr "" msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." @@ -205,8 +206,8 @@ msgstr "" msgid "" "This installs the function :func:`!_` in Python's builtins namespace, based " -"on *domain* and *localedir* which are passed to the function :func:" -"`translation`." +"on *domain* and *localedir* which are passed to the " +"function :func:`translation`." msgstr "" msgid "" @@ -306,9 +307,9 @@ msgid "" msgstr "" msgid "" -"Note that this is only one way, albeit the most convenient way, to make the :" -"func:`!_` function available to your application. Because it affects the " -"entire application globally, and specifically the built-in namespace, " +"Note that this is only one way, albeit the most convenient way, to make " +"the :func:`!_` function available to your application. Because it affects " +"the entire application globally, and specifically the built-in namespace, " "localized modules should never install :func:`!_`. Instead, they should use " "this code to make :func:`!_` available to their module::" msgstr "" @@ -331,17 +332,17 @@ msgid "The :class:`GNUTranslations` class" msgstr "" msgid "" -"The :mod:`!gettext` module provides one additional class derived from :class:" -"`NullTranslations`: :class:`GNUTranslations`. This class overrides :meth:`!" -"_parse` to enable reading GNU :program:`gettext` format :file:`.mo` files in " -"both big-endian and little-endian format." +"The :mod:`!gettext` module provides one additional class derived " +"from :class:`NullTranslations`: :class:`GNUTranslations`. This class " +"overrides :meth:`!_parse` to enable reading GNU :program:`gettext` " +"format :file:`.mo` files in both big-endian and little-endian format." msgstr "" msgid "" ":class:`GNUTranslations` parses optional metadata out of the translation " "catalog. It is convention with GNU :program:`gettext` to include metadata as " -"the translation for the empty string. This metadata is in :rfc:`822`\\ -" -"style ``key: value`` pairs, and should contain the ``Project-Id-Version`` " +"the translation for the empty string. This metadata is in :rfc:`822`\\ " +"-style ``key: value`` pairs, and should contain the ``Project-Id-Version`` " "key. If the key ``Content-Type`` is found, then the ``charset`` property is " "used to initialize the \"protected\" :attr:`!_charset` instance variable, " "defaulting to ``None`` if not found. If the charset encoding is specified, " @@ -385,9 +386,9 @@ msgstr "" msgid "" "If the message id is not found in the catalog, and a fallback is specified, " -"the request is forwarded to the fallback's :meth:`~NullTranslations." -"ngettext` method. Otherwise, when *n* is 1 *singular* is returned, and " -"*plural* is returned in all other cases." +"the request is forwarded to the " +"fallback's :meth:`~NullTranslations.ngettext` method. Otherwise, when *n* " +"is 1 *singular* is returned, and *plural* is returned in all other cases." msgstr "" msgid "Here is an example::" @@ -517,32 +518,33 @@ msgid "" msgstr "" msgid "" -"(Python also includes pure-Python versions of these programs, called :" -"program:`pygettext.py` and :program:`msgfmt.py`; some Python distributions " -"will install them for you. :program:`pygettext.py` is similar to :program:" -"`xgettext`, but only understands Python source code and cannot handle other " -"programming languages such as C or C++. :program:`pygettext.py` supports a " -"command-line interface similar to :program:`xgettext`; for details on its " -"use, run ``pygettext.py --help``. :program:`msgfmt.py` is binary compatible " -"with GNU :program:`msgfmt`. With these two programs, you may not need the " -"GNU :program:`gettext` package to internationalize your Python applications.)" +"(Python also includes pure-Python versions of these programs, " +"called :program:`pygettext.py` and :program:`msgfmt.py`; some Python " +"distributions will install them for you. :program:`pygettext.py` is similar " +"to :program:`xgettext`, but only understands Python source code and cannot " +"handle other programming languages such as C or C++. :program:`pygettext.py` " +"supports a command-line interface similar to :program:`xgettext`; for " +"details on its use, run ``pygettext.py --help``. :program:`msgfmt.py` is " +"binary compatible with GNU :program:`msgfmt`. With these two programs, you " +"may not need the GNU :program:`gettext` package to internationalize your " +"Python applications.)" msgstr "" msgid "" -":program:`xgettext`, :program:`pygettext`, and similar tools generate :file:" -"`.po` files that are message catalogs. They are structured human-readable " -"files that contain every marked string in the source code, along with a " -"placeholder for the translated versions of these strings." +":program:`xgettext`, :program:`pygettext`, and similar tools " +"generate :file:`.po` files that are message catalogs. They are structured " +"human-readable files that contain every marked string in the source code, " +"along with a placeholder for the translated versions of these strings." msgstr "" msgid "" "Copies of these :file:`.po` files are then handed over to the individual " "human translators who write translations for every supported natural " -"language. They send back the completed language-specific versions as a :" -"file:`.po` file that's compiled into a machine-readable :file:" -"`.mo` binary catalog file using the :program:`msgfmt` program. The :file:`." -"mo` files are used by the :mod:`gettext` module for the actual translation " -"processing at run-time." +"language. They send back the completed language-specific versions as " +"a :file:`.po` file that's compiled into a machine-" +"readable :file:`.mo` binary catalog file using the :program:`msgfmt` " +"program. The :file:`.mo` files are used by the :mod:`gettext` module for " +"the actual translation processing at run-time." msgstr "" msgid "" @@ -556,8 +558,8 @@ msgstr "" msgid "" "If you are localizing your module, you must take care not to make global " -"changes, e.g. to the built-in namespace. You should not use the GNU :program:" -"`gettext` API but instead the class-based API." +"changes, e.g. to the built-in namespace. You should not use the " +"GNU :program:`gettext` API but instead the class-based API." msgstr "" msgid "" @@ -594,8 +596,8 @@ msgid "" msgstr "" msgid "" -"If you need to set the locale directory, you can pass it into the :func:" -"`install` function::" +"If you need to set the locale directory, you can pass it into " +"the :func:`install` function::" msgstr "" msgid "" diff --git a/library/glob.po b/library/glob.po index c78bb67b55..a35746f1f3 100644 --- a/library/glob.po +++ b/library/glob.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Stefan Ocetkiewicz , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-13 21:57+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,22 +27,26 @@ msgid ":mod:`!glob` --- Unix style pathname pattern expansion" msgstr "" msgid "**Source code:** :source:`Lib/glob.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/glob.py`" msgid "" -"The :mod:`glob` module finds all the pathnames matching a specified pattern " -"according to the rules used by the Unix shell, although results are returned " -"in arbitrary order. No tilde expansion is done, but ``*``, ``?``, and " +"The :mod:`!glob` module finds pathnames using pattern matching rules similar " +"to the Unix shell. No tilde expansion is done, but ``*``, ``?``, and " "character ranges expressed with ``[]`` will be correctly matched. This is " "done by using the :func:`os.scandir` and :func:`fnmatch.fnmatch` functions " "in concert, and not by actually invoking a subshell." msgstr "" msgid "" -"Note that files beginning with a dot (``.``) can only be matched by patterns " -"that also start with a dot, unlike :func:`fnmatch.fnmatch` or :func:`pathlib." -"Path.glob`. (For tilde and shell variable expansion, use :func:`os.path." -"expanduser` and :func:`os.path.expandvars`.)" +"The pathnames are returned in no particular order. If you need a specific " +"order, sort the results." +msgstr "" + +msgid "" +"By default, files beginning with a dot (``.``) can only be matched by " +"patterns that also start with a dot, unlike :func:`fnmatch.fnmatch` " +"or :func:`pathlib.Path.glob`. For tilde and shell variable expansion, " +"use :func:`os.path.expanduser` and :func:`os.path.expandvars`." msgstr "" msgid "" @@ -52,24 +54,24 @@ msgid "" "``'[?]'`` matches the character ``'?'``." msgstr "" -msgid "The :mod:`glob` module defines the following functions:" +msgid "The :mod:`!glob` module defines the following functions:" msgstr "" msgid "" "Return a possibly empty list of path names that match *pathname*, which must " "be a string containing a path specification. *pathname* can be either " -"absolute (like :file:`/usr/src/Python-1.5/Makefile`) or relative (like :file:" -"`../../Tools/\\*/\\*.gif`), and can contain shell-style wildcards. Broken " -"symlinks are included in the results (as in the shell). Whether or not the " -"results are sorted depends on the file system. If a file that satisfies " -"conditions is removed or added during the call of this function, whether a " -"path name for that file will be included is unspecified." +"absolute (like :file:`/usr/src/Python-1.5/Makefile`) or relative " +"(like :file:`../../Tools/\\*/\\*.gif`), and can contain shell-style " +"wildcards. Broken symlinks are included in the results (as in the shell). " +"Whether or not the results are sorted depends on the file system. If a file " +"that satisfies conditions is removed or added during the call of this " +"function, whether a path name for that file will be included is unspecified." msgstr "" msgid "" "If *root_dir* is not ``None``, it should be a :term:`path-like object` " -"specifying the root directory for searching. It has the same effect on :" -"func:`glob` as changing the current directory before calling it. If " +"specifying the root directory for searching. It has the same effect " +"on :func:`!glob` as changing the current directory before calling it. If " "*pathname* is relative, the result will contain paths relative to *root_dir*." msgstr "" @@ -86,8 +88,8 @@ msgid "" msgstr "" msgid "" -"If *include_hidden* is true, \"``**``\" pattern will match hidden " -"directories." +"If *include_hidden* is true, wildcards can match path segments that begin " +"with a dot (``.``)." msgstr "" msgid "" @@ -110,6 +112,12 @@ msgid "" "multiple \"``**``\" patterns and *recursive* is true." msgstr "" +msgid "" +"Any :exc:`OSError` exceptions raised from scanning the filesystem are " +"suppressed. This includes :exc:`PermissionError` when accessing directories " +"without read permission." +msgstr "" + msgid "Support for recursive globs using \"``**``\"." msgstr "" @@ -128,22 +136,23 @@ msgid "" "Escape all special characters (``'?'``, ``'*'`` and ``'['``). This is useful " "if you want to match an arbitrary literal string that may have special " "characters in it. Special characters in drive/UNC sharepoints are not " -"escaped, e.g. on Windows ``escape('//?/c:/Quo vadis?.txt')`` returns ``'//?/" -"c:/Quo vadis[?].txt'``." +"escaped, for example on Windows ``escape('//?/c:/Quo vadis?.txt')`` returns " +"``'//?/c:/Quo vadis[?].txt'``." msgstr "" msgid "" -"Convert the given path specification to a regular expression for use with :" -"func:`re.match`. The path specification can contain shell-style wildcards." +"Convert the given path specification to a regular expression for use " +"with :func:`re.match`. The path specification can contain shell-style " +"wildcards." msgstr "" msgid "For example:" msgstr "Na przykład::" msgid "" -"Path separators and segments are meaningful to this function, unlike :func:" -"`fnmatch.translate`. By default wildcards do not match path separators, and " -"``*`` pattern segments match precisely one path segment." +"Path separators and segments are meaningful to this function, " +"unlike :func:`fnmatch.translate`. By default wildcards do not match path " +"separators, and ``*`` pattern segments match precisely one path segment." msgstr "" msgid "" @@ -170,9 +179,10 @@ msgid "Examples" msgstr "Przykłady" msgid "" -"Consider a directory containing the following files: :file:`1.gif`, :file:`2." -"txt`, :file:`card.gif` and a subdirectory :file:`sub` which contains only " -"the file :file:`3.txt`. :func:`glob` will produce the following results. " +"Consider a directory containing the following " +"files: :file:`1.gif`, :file:`2.txt`, :file:`card.gif` and a " +"subdirectory :file:`sub` which contains only the " +"file :file:`3.txt`. :func:`glob` will produce the following results. " "Notice how any leading components of the path are preserved. ::" msgstr "" @@ -192,8 +202,8 @@ msgstr "" msgid "" "If the directory contains files starting with ``.`` they won't be matched by " -"default. For example, consider a directory containing :file:`card.gif` and :" -"file:`.card.gif`::" +"default. For example, consider a directory containing :file:`card.gif` " +"and :file:`.card.gif`::" msgstr "" msgid "" diff --git a/library/graphlib.po b/library/graphlib.po index 3b1795eef2..d185a5f6b6 100644 --- a/library/graphlib.po +++ b/library/graphlib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:06+0000\n" -"Last-Translator: Igor Zubrycki , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 +28,7 @@ msgid "" msgstr "" msgid "**Source code:** :source:`Lib/graphlib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/graphlib.py`" msgid "" "Provides functionality to topologically sort a graph of :term:`hashable` " @@ -78,8 +78,8 @@ msgstr "" msgid "" "In case just an immediate sorting of the nodes in the graph is required and " -"no parallelism is involved, the convenience method :meth:`TopologicalSorter." -"static_order` can be used directly:" +"no parallelism is involved, the convenience " +"method :meth:`TopologicalSorter.static_order` can be used directly:" msgstr "" msgid "" @@ -141,20 +141,20 @@ msgstr "" msgid "" "Mark the graph as finished and check for cycles in the graph. If any cycle " -"is detected, :exc:`CycleError` will be raised, but :meth:`~TopologicalSorter." -"get_ready` can still be used to obtain as many nodes as possible until " -"cycles block more progress. After a call to this function, the graph cannot " -"be modified, and therefore no more nodes can be added using :meth:" -"`~TopologicalSorter.add`." +"is detected, :exc:`CycleError` will be raised, " +"but :meth:`~TopologicalSorter.get_ready` can still be used to obtain as many " +"nodes as possible until cycles block more progress. After a call to this " +"function, the graph cannot be modified, and therefore no more nodes can be " +"added using :meth:`~TopologicalSorter.add`." msgstr "" msgid "" "Returns ``True`` if more progress can be made and ``False`` otherwise. " "Progress can be made if cycles do not block the resolution and either there " -"are still nodes ready that haven't yet been returned by :meth:" -"`TopologicalSorter.get_ready` or the number of nodes marked :meth:" -"`TopologicalSorter.done` is less than the number that have been returned by :" -"meth:`TopologicalSorter.get_ready`." +"are still nodes ready that haven't yet been returned " +"by :meth:`TopologicalSorter.get_ready` or the number of nodes " +"marked :meth:`TopologicalSorter.done` is less than the number that have been " +"returned by :meth:`TopologicalSorter.get_ready`." msgstr "" msgid "" @@ -176,8 +176,8 @@ msgid "" msgstr "" msgid "" -"Raises :exc:`ValueError` if called without calling :meth:`~TopologicalSorter." -"prepare` previously." +"Raises :exc:`ValueError` if called without " +"calling :meth:`~TopologicalSorter.prepare` previously." msgstr "" msgid "" @@ -189,9 +189,9 @@ msgstr "" msgid "" "Raises :exc:`ValueError` if any node in *nodes* has already been marked as " "processed by a previous call to this method or if a node was not added to " -"the graph by using :meth:`TopologicalSorter.add`, if called without calling :" -"meth:`~TopologicalSorter.prepare` or if node has not yet been returned by :" -"meth:`~TopologicalSorter.get_ready`." +"the graph by using :meth:`TopologicalSorter.add`, if called without " +"calling :meth:`~TopologicalSorter.prepare` or if node has not yet been " +"returned by :meth:`~TopologicalSorter.get_ready`." msgstr "" msgid "" @@ -204,9 +204,9 @@ msgstr "" msgid "" "Returns an iterator object which will iterate over nodes in a topological " -"order. When using this method, :meth:`~TopologicalSorter.prepare` and :meth:" -"`~TopologicalSorter.done` should not be called. This method is equivalent " -"to::" +"order. When using this method, :meth:`~TopologicalSorter.prepare` " +"and :meth:`~TopologicalSorter.done` should not be called. This method is " +"equivalent to::" msgstr "" msgid "" @@ -239,9 +239,9 @@ msgstr "" msgid "" "This is due to the fact that \"0\" and \"2\" are in the same level in the " -"graph (they would have been returned in the same call to :meth:" -"`~TopologicalSorter.get_ready`) and the order between them is determined by " -"the order of insertion." +"graph (they would have been returned in the same call " +"to :meth:`~TopologicalSorter.get_ready`) and the order between them is " +"determined by the order of insertion." msgstr "" msgid "If any cycle is detected, :exc:`CycleError` will be raised." @@ -260,9 +260,10 @@ msgid "" msgstr "" msgid "" -"The detected cycle can be accessed via the second element in the :attr:" -"`~BaseException.args` attribute of the exception instance and consists in a " -"list of nodes, such that each node is, in the graph, an immediate " -"predecessor of the next node in the list. In the reported list, the first " -"and the last node will be the same, to make it clear that it is cyclic." +"The detected cycle can be accessed via the second element in " +"the :attr:`~BaseException.args` attribute of the exception instance and " +"consists in a list of nodes, such that each node is, in the graph, an " +"immediate predecessor of the next node in the list. In the reported list, " +"the first and the last node will be the same, to make it clear that it is " +"cyclic." msgstr "" diff --git a/library/grp.po b/library/grp.po index d4e576f8c4..97babaccc2 100644 --- a/library/grp.po +++ b/library/grp.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -26,7 +24,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid ":mod:`!grp` --- The group database" -msgstr "" +msgstr ":mod:`!grp` --- Baza danych grup" msgid "" "This module provides access to the Unix group database. It is available on " @@ -43,7 +41,7 @@ msgid "" msgstr "" msgid "Index" -msgstr "" +msgstr "Indeks" msgid "Attribute" msgstr "atrybut" @@ -55,7 +53,7 @@ msgid "0" msgstr "0" msgid "gr_name" -msgstr "" +msgstr "gr_name" msgid "the name of the group" msgstr "" @@ -64,7 +62,7 @@ msgid "1" msgstr "1" msgid "gr_passwd" -msgstr "" +msgstr "gr_passwd" msgid "the (encrypted) group password; often empty" msgstr "" @@ -73,7 +71,7 @@ msgid "2" msgstr "2" msgid "gr_gid" -msgstr "" +msgstr "gr_gid" msgid "the numerical group ID" msgstr "" @@ -82,7 +80,7 @@ msgid "3" msgstr "3" msgid "gr_mem" -msgstr "" +msgstr "gr_mem" msgid "all the group member's user names" msgstr "" @@ -93,16 +91,16 @@ msgid "" "members of the group they are in according to the password database. Check " "both databases to get complete membership information. Also note that a " "``gr_name`` that starts with a ``+`` or ``-`` is likely to be a YP/NIS " -"reference and may not be accessible via :func:`getgrnam` or :func:" -"`getgrgid`.)" +"reference and may not be accessible via :func:`getgrnam` " +"or :func:`getgrgid`.)" msgstr "" msgid "It defines the following items:" msgstr "" msgid "" -"Return the group database entry for the given numeric group ID. :exc:" -"`KeyError` is raised if the entry asked for cannot be found." +"Return the group database entry for the given numeric group " +"ID. :exc:`KeyError` is raised if the entry asked for cannot be found." msgstr "" msgid "" @@ -118,7 +116,7 @@ msgid "Return a list of all available group entries, in arbitrary order." msgstr "" msgid "Module :mod:`pwd`" -msgstr "" +msgstr "Moduł :mod:`pwd`" msgid "An interface to the user database, similar to this." msgstr "" diff --git a/library/gzip.po b/library/gzip.po index a2dc9b9dcd..9f335e744c 100644 --- a/library/gzip.po +++ b/library/gzip.po @@ -1,19 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -38,17 +39,17 @@ msgid "The data compression is provided by the :mod:`zlib` module." msgstr "Kompresję danych zapewnia moduł :mod:`zlib`." msgid "" -"The :mod:`gzip` module provides the :class:`GzipFile` class, as well as the :" -"func:`.open`, :func:`compress` and :func:`decompress` convenience functions. " -"The :class:`GzipFile` class reads and writes :program:`gzip`\\ -format " -"files, automatically compressing or decompressing the data so that it looks " -"like an ordinary :term:`file object`." +"The :mod:`gzip` module provides the :class:`GzipFile` class, as well as " +"the :func:`.open`, :func:`compress` and :func:`decompress` convenience " +"functions. The :class:`GzipFile` class reads and writes :program:`gzip`\\ " +"-format files, automatically compressing or decompressing the data so that " +"it looks like an ordinary :term:`file object`." msgstr "" msgid "" -"Note that additional file formats which can be decompressed by the :program:" -"`gzip` and :program:`gunzip` programs, such as those produced by :program:" -"`compress` and :program:`pack`, are not supported by this module." +"Note that additional file formats which can be decompressed by " +"the :program:`gzip` and :program:`gunzip` programs, such as those produced " +"by :program:`compress` and :program:`pack`, are not supported by this module." msgstr "" msgid "The module defines the following items:" @@ -60,8 +61,9 @@ msgid "" msgstr "" msgid "" -"The *filename* argument can be an actual filename (a :class:`str` or :class:" -"`bytes` object), or an existing file object to read from or write to." +"The *filename* argument can be an actual filename (a :class:`str` " +"or :class:`bytes` object), or an existing file object to read from or write " +"to." msgstr "" msgid "" @@ -71,8 +73,8 @@ msgid "" msgstr "" msgid "" -"The *compresslevel* argument is an integer from 0 to 9, as for the :class:" -"`GzipFile` constructor." +"The *compresslevel* argument is an integer from 0 to 9, as for " +"the :class:`GzipFile` constructor." msgstr "" msgid "" @@ -82,8 +84,8 @@ msgid "" msgstr "" msgid "" -"For text mode, a :class:`GzipFile` object is created, and wrapped in an :" -"class:`io.TextIOWrapper` instance with the specified encoding, error " +"For text mode, a :class:`GzipFile` object is created, and wrapped in " +"an :class:`io.TextIOWrapper` instance with the specified encoding, error " "handling behavior, and line ending(s)." msgstr "" @@ -99,16 +101,16 @@ msgid "Accepts a :term:`path-like object`." msgstr "" msgid "" -"An exception raised for invalid gzip files. It inherits from :exc:" -"`OSError`. :exc:`EOFError` and :exc:`zlib.error` can also be raised for " -"invalid gzip files." +"An exception raised for invalid gzip files. It inherits " +"from :exc:`OSError`. :exc:`EOFError` and :exc:`zlib.error` can also be " +"raised for invalid gzip files." msgstr "" msgid "" "Constructor for the :class:`GzipFile` class, which simulates most of the " -"methods of a :term:`file object`, with the exception of the :meth:`~io." -"IOBase.truncate` method. At least one of *fileobj* and *filename* must be " -"given a non-trivial value." +"methods of a :term:`file object`, with the exception of " +"the :meth:`~io.IOBase.truncate` method. At least one of *fileobj* and " +"*filename* must be given a non-trivial value." msgstr "" msgid "" @@ -163,14 +165,14 @@ msgid "" "Calling a :class:`GzipFile` object's :meth:`!close` method does not close " "*fileobj*, since you might wish to append more material after the compressed " "data. This also allows you to pass an :class:`io.BytesIO` object opened for " -"writing as *fileobj*, and retrieve the resulting memory buffer using the :" -"class:`io.BytesIO` object's :meth:`~io.BytesIO.getvalue` method." +"writing as *fileobj*, and retrieve the resulting memory buffer using " +"the :class:`io.BytesIO` object's :meth:`~io.BytesIO.getvalue` method." msgstr "" msgid "" ":class:`GzipFile` supports the :class:`io.BufferedIOBase` interface, " -"including iteration and the :keyword:`with` statement. Only the :meth:`~io." -"IOBase.truncate` method isn't implemented." +"including iteration and the :keyword:`with` statement. Only " +"the :meth:`~io.IOBase.truncate` method isn't implemented." msgstr "" msgid ":class:`GzipFile` also provides the following method and attribute:" @@ -182,9 +184,10 @@ msgid "" msgstr "" msgid "" -"While calling :meth:`peek` does not change the file position of the :class:" -"`GzipFile`, it may change the position of the underlying file object (e.g. " -"if the :class:`GzipFile` was constructed with the *fileobj* parameter)." +"While calling :meth:`peek` does not change the file position of " +"the :class:`GzipFile`, it may change the position of the underlying file " +"object (e.g. if the :class:`GzipFile` was constructed with the *fileobj* " +"parameter)." msgstr "" msgid "``'rb'`` for reading and ``'wb'`` for writing." @@ -247,10 +250,10 @@ msgstr "" msgid "" "Speed is improved by compressing all data at once instead of in a streamed " -"fashion. Calls with *mtime* set to ``0`` are delegated to :func:`zlib." -"compress` for better speed. In this situation the output may contain a gzip " -"header \"OS\" byte value other than 255 \"unknown\" as supplied by the " -"underlying zlib implementation." +"fashion. Calls with *mtime* set to ``0`` are delegated " +"to :func:`zlib.compress` for better speed. In this situation the output may " +"contain a gzip header \"OS\" byte value other than 255 \"unknown\" as " +"supplied by the underlying zlib implementation." msgstr "" msgid "" @@ -326,8 +329,8 @@ msgid "" "speeds up (de)compression with a mostly compatible API." msgstr "" -msgid "Command Line Interface" -msgstr "Interfejs linii komend" +msgid "Command-line interface" +msgstr "Interfejs wiersza poleceń" msgid "" "The :mod:`gzip` module provides a simple command line interface to compress " @@ -342,8 +345,8 @@ msgid "" "execute the CLI, the default compression level is 6." msgstr "" -msgid "Command line options" -msgstr "Opcje wiersza poleceń" +msgid "Command-line options" +msgstr "" msgid "If *file* is not specified, read from :data:`sys.stdin`." msgstr "" diff --git a/library/hashlib.po b/library/hashlib.po index 83d1ffebf9..b275fb6f72 100644 --- a/library/hashlib.po +++ b/library/hashlib.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,7 +27,7 @@ msgid ":mod:`!hashlib` --- Secure hashes and message digests" msgstr "" msgid "**Source code:** :source:`Lib/hashlib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/hashlib.py`" msgid "" "This module implements a common interface to many different hash algorithms. " @@ -40,8 +38,8 @@ msgid "" msgstr "" msgid "" -"If you want the adler32 or crc32 hash functions, they are available in the :" -"mod:`zlib` module." +"If you want the adler32 or crc32 hash functions, they are available in " +"the :mod:`zlib` module." msgstr "" msgid "Hash algorithms" @@ -49,36 +47,35 @@ msgstr "" msgid "" "There is one constructor method named for each type of :dfn:`hash`. All " -"return a hash object with the same simple interface. For example: use :func:" -"`sha256` to create a SHA-256 hash object. You can now feed this object with :" -"term:`bytes-like objects ` (normally :class:`bytes`) " -"using the :meth:`update` method. At any point you can ask it " -"for the :dfn:`digest` of the concatenation of the data fed to it so far " -"using the :meth:`digest()` or :meth:`hexdigest()` methods." +"return a hash object with the same simple interface. For example: " +"use :func:`sha256` to create a SHA-256 hash object. You can now feed this " +"object with :term:`bytes-like objects ` " +"(normally :class:`bytes`) using the :meth:`update` method. At " +"any point you can ask it for the :dfn:`digest` of the concatenation of the " +"data fed to it so far using the :meth:`digest()` " +"or :meth:`hexdigest()` methods." msgstr "" msgid "" "To allow multithreading, the Python :term:`GIL` is released while computing " -"a hash supplied more than 2047 bytes of data at once in its constructor or :" -"meth:`.update` method." +"a hash supplied more than 2047 bytes of data at once in its constructor " +"or :meth:`.update` method." msgstr "" msgid "" -"Constructors for hash algorithms that are always present in this module are :" -"func:`sha1`, :func:`sha224`, :func:`sha256`, :func:`sha384`, :func:" -"`sha512`, :func:`sha3_224`, :func:`sha3_256`, :func:`sha3_384`, :func:" -"`sha3_512`, :func:`shake_128`, :func:`shake_256`, :func:`blake2b`, and :func:" -"`blake2s`. :func:`md5` is normally available as well, though it may be " -"missing or blocked if you are using a rare \"FIPS compliant\" build of " -"Python. These correspond to :data:`algorithms_guaranteed`." +"Constructors for hash algorithms that are always present in this module " +"are :func:`sha1`, :func:`sha224`, :func:`sha256`, :func:`sha384`, :func:`sha512`, :func:`sha3_224`, :func:`sha3_256`, :func:`sha3_384`, :func:`sha3_512`, :func:`shake_128`, :func:`shake_256`, :func:`blake2b`, " +"and :func:`blake2s`. :func:`md5` is normally available as well, though it " +"may be missing or blocked if you are using a rare \"FIPS compliant\" build " +"of Python. These correspond to :data:`algorithms_guaranteed`." msgstr "" msgid "" -"Additional algorithms may also be available if your Python distribution's :" -"mod:`hashlib` was linked against a build of OpenSSL that provides others. " -"Others *are not guaranteed available* on all installations and will only be " -"accessible by name via :func:`new`. See :data:`algorithms_available`." +"Additional algorithms may also be available if your Python " +"distribution's :mod:`hashlib` was linked against a build of OpenSSL that " +"provides others. Others *are not guaranteed available* on all installations " +"and will only be accessible by name via :func:`new`. " +"See :data:`algorithms_available`." msgstr "" msgid "" @@ -88,9 +85,9 @@ msgid "" msgstr "" msgid "" -"SHA3 (Keccak) and SHAKE constructors :func:`sha3_224`, :func:`sha3_256`, :" -"func:`sha3_384`, :func:`sha3_512`, :func:`shake_128`, :func:`shake_256` were " -"added. :func:`blake2b` and :func:`blake2s` were added." +"SHA3 (Keccak) and SHAKE " +"constructors :func:`sha3_224`, :func:`sha3_256`, :func:`sha3_384`, :func:`sha3_512`, :func:`shake_128`, :func:`shake_256` " +"were added. :func:`blake2b` and :func:`blake2s` were added." msgstr "" msgid "" @@ -111,7 +108,7 @@ msgid "" msgstr "" msgid "Usage" -msgstr "" +msgstr "Użytek" msgid "" "To obtain the digest of the byte string ``b\"Nobody inspects the spammish " @@ -125,11 +122,19 @@ msgid "" ">>> m.update(b\" the spammish repetition\")\n" ">>> m.digest()\n" "b'\\x03\\x1e\\xdd}Ae\\x15\\x93\\xc5\\xfe\\\\" -"\\x00o\\xa5u+7\\xfd\\xdf\\xf7\\xbcN\\x84:" -"\\xa6\\xaf\\x0c\\x95\\x0fK\\x94\\x06'\n" +"\\x00o\\xa5u+7\\xfd\\xdf\\xf7\\xbcN\\x84:\\xa6\\xaf\\x0c\\x95\\x0fK\\x94\\x06'\n" ">>> m.hexdigest()\n" "'031edd7d41651593c5fe5c006fa5752b37fddff7bc4e843aa6af0c950f4b9406'" msgstr "" +">>> import hashlib\n" +">>> m = hashlib.sha256()\n" +">>> m.update(b\"Nobody inspects\")\n" +">>> m.update(b\" the spammish repetition\")\n" +">>> m.digest()\n" +"b'\\x03\\x1e\\xdd}Ae\\x15\\x93\\xc5\\xfe\\\\" +"\\x00o\\xa5u+7\\xfd\\xdf\\xf7\\xbcN\\x84:\\xa6\\xaf\\x0c\\x95\\x0fK\\x94\\x06'\n" +">>> m.hexdigest()\n" +"'031edd7d41651593c5fe5c006fa5752b37fddff7bc4e843aa6af0c950f4b9406'" msgid "More condensed:" msgstr "" @@ -167,8 +172,8 @@ msgstr "" msgid "" "A set containing the names of the hash algorithms that are available in the " -"running Python interpreter. These names will be recognized when passed to :" -"func:`new`. :attr:`algorithms_guaranteed` will always be a subset. The " +"running Python interpreter. These names will be recognized when passed " +"to :func:`new`. :attr:`algorithms_guaranteed` will always be a subset. The " "same algorithm may appear multiple times in this set under different names " "(thanks to OpenSSL)." msgstr "" @@ -268,15 +273,15 @@ msgid "" "*fileobj* must be a file-like object opened for reading in binary mode. It " "accepts file objects from builtin :func:`open`, :class:`~io.BytesIO` " "instances, SocketIO objects from :meth:`socket.socket.makefile`, and " -"similar. *fileobj* must be opened in blocking mode, otherwise a :exc:" -"`BlockingIOError` may be raised." +"similar. *fileobj* must be opened in blocking mode, otherwise " +"a :exc:`BlockingIOError` may be raised." msgstr "" msgid "" -"The function may bypass Python's I/O and use the file descriptor from :meth:" -"`~io.IOBase.fileno` directly. *fileobj* must be assumed to be in an unknown " -"state after this function returns or raises. It is up to the caller to close " -"*fileobj*." +"The function may bypass Python's I/O and use the file descriptor " +"from :meth:`~io.IOBase.fileno` directly. *fileobj* must be assumed to be in " +"an unknown state after this function returns or raises. It is up to the " +"caller to close *fileobj*." msgstr "" msgid "" @@ -288,8 +293,8 @@ msgid "Example:" msgstr "Przykład:" msgid "" -"Now raises a :exc:`BlockingIOError` if the file is opened in blocking mode. " -"Previously, spurious null bytes were added to the digest." +"Now raises a :exc:`BlockingIOError` if the file is opened in non-blocking " +"mode. Previously, spurious null bytes were added to the digest." msgstr "" msgid "Key derivation" @@ -357,7 +362,7 @@ msgid "" msgstr "" msgid "BLAKE2" -msgstr "" +msgstr "BLAKE2" msgid "" "BLAKE2_ is a cryptographic hash function defined in :rfc:`7693` that comes " @@ -380,8 +385,8 @@ msgid "" msgstr "" msgid "" -"Hash objects from this module follow the API of standard library's :mod:" -"`hashlib` objects." +"Hash objects from this module follow the API of standard " +"library's :mod:`hashlib` objects." msgstr "" msgid "Creating hash objects" @@ -428,28 +433,28 @@ msgid "digest_size" msgstr "" msgid "len(key)" -msgstr "" +msgstr "len(key)" msgid "len(salt)" -msgstr "" +msgstr "len(salt)" msgid "len(person)" -msgstr "" +msgstr "len(person)" msgid "BLAKE2b" -msgstr "" +msgstr "BLAKE2b" msgid "64" -msgstr "" +msgstr "64" msgid "16" -msgstr "" +msgstr "16" msgid "BLAKE2s" -msgstr "" +msgstr "BLAKE2s" msgid "32" -msgstr "" +msgstr "32" msgid "8" msgstr "8" @@ -534,10 +539,11 @@ msgstr "" msgid "" "To calculate hash of some data, you should first construct a hash object by " -"calling the appropriate constructor function (:func:`blake2b` or :func:" -"`blake2s`), then update it with the data by calling :meth:`~hash.update` on " -"the object, and, finally, get the digest out of the object by calling :meth:" -"`~hash.digest` (or :meth:`~hash.hexdigest` for hex-encoded string)." +"calling the appropriate constructor function (:func:`blake2b` " +"or :func:`blake2s`), then update it with the data by " +"calling :meth:`~hash.update` on the object, and, finally, get the digest out " +"of the object by calling :meth:`~hash.digest` (or :meth:`~hash.hexdigest` " +"for hex-encoded string)." msgstr "" msgid "" @@ -570,9 +576,9 @@ msgstr "" msgid "" "Keyed hashing can be used for authentication as a faster and simpler " -"replacement for `Hash-based message authentication code `_ (HMAC). BLAKE2 can be securely used in prefix-MAC " -"mode thanks to the indifferentiability property inherited from BLAKE." +"replacement for `Hash-based message authentication code `_ (HMAC). BLAKE2 can be securely used in prefix-" +"MAC mode thanks to the indifferentiability property inherited from BLAKE." msgstr "" msgid "" @@ -736,6 +742,9 @@ msgid "" " / \\\n" "00 01" msgstr "" +" 10\n" +" / \\\n" +"00 01" msgid "" "This example uses 64-byte internal digests, and returns the 32-byte final " @@ -887,4 +896,4 @@ msgid "(use in module hashlib)" msgstr "" msgid "blake2b, blake2s" -msgstr "" +msgstr "blake2b, blake2s" diff --git a/library/heapq.po b/library/heapq.po index f1fcb59f48..3528f70a47 100644 --- a/library/heapq.po +++ b/library/heapq.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,15 +24,17 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid ":mod:`!heapq` --- Heap queue algorithm" -msgstr "" +msgstr ":mod:`!heapq` --- Algorytm kolejki kopcowej" msgid "**Source code:** :source:`Lib/heapq.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/heapq.py`" msgid "" "This module provides an implementation of the heap queue algorithm, also " "known as the priority queue algorithm." msgstr "" +"Ten moduł zawiera implementację algorytmu kolejki kopcowej, znanego również " +"jako algorytm kolejki priorytetowej." msgid "" "Heaps are binary trees for which every parent node has a value less than or " @@ -73,6 +74,9 @@ msgstr "" msgid "The following functions are provided:" msgstr "W module znajdują się następujące funkcje:" +msgid "Transform list *x* into a heap, in-place, in linear time." +msgstr "" + msgid "Push the value *item* onto the *heap*, maintaining the heap invariant." msgstr "" @@ -88,13 +92,10 @@ msgid "" "followed by a separate call to :func:`heappop`." msgstr "" -msgid "Transform list *x* into a heap, in-place, in linear time." -msgstr "" - msgid "" "Pop and return the smallest item from the *heap*, and also push the new " -"*item*. The heap size doesn't change. If the heap is empty, :exc:" -"`IndexError` is raised." +"*item*. The heap size doesn't change. If the heap is " +"empty, :exc:`IndexError` is raised." msgstr "" msgid "" @@ -160,20 +161,20 @@ msgid "" "Return a list with the *n* smallest elements from the dataset defined by " "*iterable*. *key*, if provided, specifies a function of one argument that " "is used to extract a comparison key from each element in *iterable* (for " -"example, ``key=str.lower``). Equivalent to: ``sorted(iterable, key=key)[:" -"n]``." +"example, ``key=str.lower``). Equivalent to: ``sorted(iterable, key=key)" +"[:n]``." msgstr "" msgid "" "The latter two functions perform best for smaller values of *n*. For larger " "values, it is more efficient to use the :func:`sorted` function. Also, when " -"``n==1``, it is more efficient to use the built-in :func:`min` and :func:" -"`max` functions. If repeated usage of these functions is required, consider " -"turning the iterable into an actual heap." +"``n==1``, it is more efficient to use the built-in :func:`min` " +"and :func:`max` functions. If repeated usage of these functions is " +"required, consider turning the iterable into an actual heap." msgstr "" msgid "Basic Examples" -msgstr "" +msgstr "Podstawowe przykłady" msgid "" "A `heapsort `_ can be implemented by " @@ -191,6 +192,14 @@ msgid "" ">>> heapsort([1, 3, 5, 7, 9, 2, 4, 6, 8, 0])\n" "[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]" msgstr "" +">>> def heapsort(iterable):\n" +"... h = []\n" +"... for value in iterable:\n" +"... heappush(h, value)\n" +"... return [heappop(h) for i in range(len(h))]\n" +"...\n" +">>> heapsort([1, 3, 5, 7, 9, 2, 4, 6, 8, 0])\n" +"[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]" msgid "" "This is similar to ``sorted(iterable)``, but unlike :func:`sorted`, this " @@ -263,6 +272,13 @@ msgid "" " priority: int\n" " item: Any=field(compare=False)" msgstr "" +"from dataclasses import dataclass, field\n" +"from typing import Any\n" +"\n" +"@dataclass(order=True)\n" +"class PrioritizedItem:\n" +" priority: int\n" +" item: Any=field(compare=False)" msgid "" "The remaining challenges revolve around finding a pending task and making " @@ -307,7 +323,7 @@ msgid "" msgstr "" msgid "Theory" -msgstr "" +msgstr "Teoria" msgid "" "Heaps are arrays for which ``a[k] <= a[2*k+1]`` and ``a[k] <= a[2*k+2]`` for " @@ -332,6 +348,15 @@ msgid "" "\n" "15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30" msgstr "" +" 0\n" +"\n" +" 1 2\n" +"\n" +" 3 4 5 6\n" +"\n" +" 7 8 9 10 11 12 13 14\n" +"\n" +"15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30" msgid "" "In the tree above, each cell *k* is topping ``2*k+1`` and ``2*k+2``. In a " diff --git a/library/hmac.po b/library/hmac.po index e9aeb55610..d7bfe5528f 100644 --- a/library/hmac.po +++ b/library/hmac.po @@ -56,8 +56,8 @@ msgid "" "Return digest of *msg* for given secret *key* and *digest*. The function is " "equivalent to ``HMAC(key, msg, digest).digest()``, but uses an optimized C " "or inline implementation, which is faster for messages that fit into memory. " -"The parameters *key*, *msg*, and *digest* have the same meaning as in :func:" -"`~hmac.new`." +"The parameters *key*, *msg*, and *digest* have the same meaning as " +"in :func:`~hmac.new`." msgstr "" msgid "" @@ -71,8 +71,8 @@ msgstr "" msgid "" "Update the hmac object with *msg*. Repeated calls are equivalent to a " -"single call with the concatenation of all the arguments: ``m.update(a); m." -"update(b)`` is equivalent to ``m.update(a + b)``." +"single call with the concatenation of all the arguments: ``m.update(a); " +"m.update(b)`` is equivalent to ``m.update(a + b)``." msgstr "" msgid "Parameter *msg* can be of any type supported by :mod:`hashlib`." @@ -87,9 +87,9 @@ msgstr "" msgid "" "When comparing the output of :meth:`digest` to an externally supplied digest " -"during a verification routine, it is recommended to use the :func:" -"`compare_digest` function instead of the ``==`` operator to reduce the " -"vulnerability to timing attacks." +"during a verification routine, it is recommended to use " +"the :func:`compare_digest` function instead of the ``==`` operator to reduce " +"the vulnerability to timing attacks." msgstr "" msgid "" @@ -100,9 +100,9 @@ msgstr "" msgid "" "When comparing the output of :meth:`hexdigest` to an externally supplied " -"digest during a verification routine, it is recommended to use the :func:" -"`compare_digest` function instead of the ``==`` operator to reduce the " -"vulnerability to timing attacks." +"digest during a verification routine, it is recommended to use " +"the :func:`compare_digest` function instead of the ``==`` operator to reduce " +"the vulnerability to timing attacks." msgstr "" msgid "" @@ -124,9 +124,9 @@ msgid "The canonical name of this HMAC, always lowercase, e.g. ``hmac-md5``." msgstr "" msgid "" -"The undocumented attributes ``HMAC.digest_cons``, ``HMAC.inner``, and ``HMAC." -"outer`` are internal implementation details and will be removed in Python " -"3.10." +"The undocumented attributes ``HMAC.digest_cons``, ``HMAC.inner``, and " +"``HMAC.outer`` are internal implementation details and will be removed in " +"Python 3.10." msgstr "" msgid "This module also provides the following helper function:" @@ -136,8 +136,8 @@ msgid "" "Return ``a == b``. This function uses an approach designed to prevent " "timing analysis by avoiding content-based short circuiting behaviour, making " "it appropriate for cryptography. *a* and *b* must both be of the same type: " -"either :class:`str` (ASCII only, as e.g. returned by :meth:`HMAC." -"hexdigest`), or a :term:`bytes-like object`." +"either :class:`str` (ASCII only, as e.g. returned " +"by :meth:`HMAC.hexdigest`), or a :term:`bytes-like object`." msgstr "" msgid "" diff --git a/library/html.entities.po b/library/html.entities.po index 66ebf36f9a..4998c355e0 100644 --- a/library/html.entities.po +++ b/library/html.entities.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Maciej Olko , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,11 +27,12 @@ msgid ":mod:`!html.entities` --- Definitions of HTML general entities" msgstr "" msgid "**Source code:** :source:`Lib/html/entities.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/html/entities.py`" msgid "" -"This module defines four dictionaries, :data:`html5`, :data:" -"`name2codepoint`, :data:`codepoint2name`, and :data:`entitydefs`." +"This module defines four " +"dictionaries, :data:`html5`, :data:`name2codepoint`, :data:`codepoint2name`, " +"and :data:`entitydefs`." msgstr "" msgid "" @@ -39,8 +40,8 @@ msgid "" "equivalent Unicode character(s), e.g. ``html5['gt;'] == '>'``. Note that the " "trailing semicolon is included in the name (e.g. ``'gt;'``), however some of " "the names are accepted by the standard even without the semicolon: in this " -"case the name is present with and without the ``';'``. See also :func:`html." -"unescape`." +"case the name is present with and without the ``';'``. See " +"also :func:`html.unescape`." msgstr "" msgid "" diff --git a/library/html.parser.po b/library/html.parser.po index aa0ec65cdd..0f398d2f27 100644 --- a/library/html.parser.po +++ b/library/html.parser.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!html.parser` --- Simple HTML and XHTML parser" msgstr "" msgid "**Source code:** :source:`Lib/html/parser.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/html/parser.py`" msgid "" "This module defines a class :class:`HTMLParser` which serves as the basis " @@ -40,9 +39,15 @@ msgid "Create a parser instance able to parse invalid markup." msgstr "" msgid "" -"If *convert_charrefs* is ``True`` (the default), all character references " -"(except the ones in ``script``/``style`` elements) are automatically " -"converted to the corresponding Unicode characters." +"If *convert_charrefs* is true (the default), all character references " +"(except the ones in elements like ``script`` and ``style``) are " +"automatically converted to the corresponding Unicode characters." +msgstr "" + +msgid "" +"If *scripting* is false (the default), the content of the ``noscript`` " +"element is parsed normally; if it's true, it's returned as is without being " +"parsed." msgstr "" msgid "" @@ -64,13 +69,16 @@ msgstr "" msgid "The default value for argument *convert_charrefs* is now ``True``." msgstr "" +msgid "Added the *scripting* parameter." +msgstr "" + msgid "Example HTML Parser Application" msgstr "" msgid "" -"As a basic example, below is a simple HTML parser that uses the :class:" -"`HTMLParser` class to print out start tags, end tags, and data as they are " -"encountered::" +"As a basic example, below is a simple HTML parser that uses " +"the :class:`HTMLParser` class to print out start tags, end tags, and data as " +"they are encountered:" msgstr "" msgid "" @@ -117,8 +125,8 @@ msgstr "" msgid "" "Feed some text to the parser. It is processed insofar as it consists of " -"complete elements; incomplete data is buffered until more data is fed or :" -"meth:`close` is called. *data* must be :class:`str`." +"complete elements; incomplete data is buffered until more data is fed " +"or :meth:`close` is called. *data* must be :class:`str`." msgstr "" msgid "" @@ -146,8 +154,8 @@ msgstr "" msgid "" "The following methods are called when data or markup elements are " "encountered and they are meant to be overridden in a subclass. The base " -"class implementations do nothing (except for :meth:`~HTMLParser." -"handle_startendtag`):" +"class implementations do nothing (except " +"for :meth:`~HTMLParser.handle_startendtag`):" msgstr "" msgid "" @@ -160,13 +168,14 @@ msgid "" "*attrs* argument is a list of ``(name, value)`` pairs containing the " "attributes found inside the tag's ``<>`` brackets. The *name* will be " "translated to lower case, and quotes in the *value* have been removed, and " -"character and entity references have been replaced." +"character and entity references have been replaced. For empty attributes, " +"*value* is ``None``." msgstr "" msgid "" "For instance, for the tag ````, this method " -"would be called as ``handle_starttag('a', [('href', 'https://www.cwi." -"nl/')])``." +"would be called as ``handle_starttag('a', [('href', 'https://" +"www.cwi.nl/')])``." msgstr "" msgid "" @@ -185,27 +194,27 @@ msgid "" "Similar to :meth:`handle_starttag`, but called when the parser encounters an " "XHTML-style empty tag (````). This method may be overridden by " "subclasses which require this particular lexical information; the default " -"implementation simply calls :meth:`handle_starttag` and :meth:" -"`handle_endtag`." +"implementation simply calls :meth:`handle_starttag` " +"and :meth:`handle_endtag`." msgstr "" msgid "" "This method is called to process arbitrary data (e.g. text nodes and the " -"content of ```` and ````)." +"content of elements like ``script`` and ``style``)." msgstr "" msgid "" "This method is called to process a named character reference of the form " "``&name;`` (e.g. ``>``), where *name* is a general entity reference (e.g. " -"``'gt'``). This method is never called if *convert_charrefs* is ``True``." +"``'gt'``). This method is only called if *convert_charrefs* is false." msgstr "" msgid "" "This method is called to process decimal and hexadecimal numeric character " "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``." +"``>``; in this case the method will receive ``'62'`` or ``'x3E'``. This " +"method is only called if *convert_charrefs* is false." msgstr "" msgid "" @@ -264,7 +273,7 @@ msgstr "Przykłady" msgid "" "The following class implements a parser that will be used to illustrate more " -"examples::" +"examples:" msgstr "" msgid "" @@ -303,17 +312,17 @@ msgid "" "parser = MyHTMLParser()" msgstr "" -msgid "Parsing a doctype::" +msgid "Parsing a doctype:" msgstr "" msgid "" ">>> parser.feed('')\n" -"Decl : DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\" \"http://www.w3." -"org/TR/html4/strict.dtd\"" +"Decl : DOCTYPE HTML PUBLIC \"-//W3C//DTD HTML 4.01//EN\" \"http://" +"www.w3.org/TR/html4/strict.dtd\"" msgstr "" -msgid "Parsing an element with a few attributes and a title::" +msgid "Parsing an element with a few attributes and a title:" msgstr "" msgid "" @@ -329,8 +338,8 @@ msgid "" msgstr "" msgid "" -"The content of ``script`` and ``style`` elements is returned as is, without " -"further parsing::" +"The content of elements like ``script`` and ``style`` is returned as is, " +"without further parsing:" msgstr "" msgid "" @@ -342,57 +351,74 @@ msgid "" "End tag : style\n" "\n" ">>> parser.feed('')\n" +"... 'alert(\"hello! ☺\");')\n" "Start tag: script\n" " attr: ('type', 'text/javascript')\n" -"Data : alert(\"hello!\");\n" +"Data : alert(\"hello! ☺\");\n" "End tag : script" msgstr "" -msgid "Parsing comments::" +msgid "" +"Attribute names are converted to lowercase, quotes from attribute values " +"removed, and ``None`` is returned as *value* for empty attributes (such as " +"``checked``):" +msgstr "" + +msgid "" +">>> parser.feed(\"\")\n" +"Start tag: input\n" +" attr: ('type', 'checkbox')\n" +" attr: ('checked', None)\n" +" attr: ('required', '')\n" +" attr: ('disabled', 'disabled')" +msgstr "" + +msgid "Parsing comments:" msgstr "" msgid "" -">>> parser.feed(''\n" +">>> parser.feed(''\n" "... '')\n" -"Comment : a comment\n" +"Comment : a comment\n" "Comment : [if IE 9]>IE-specific content'``)::" +"correct char (note: these 3 references are all equivalent to ``'>'``):" msgstr "" msgid "" +">>> parser = MyHTMLParser()\n" ">>> parser.feed('>>>')\n" -"Named ent: >\n" -"Num ent : >\n" -"Num ent : >" -msgstr "" +"Data : >>>\n" +"\n" +">>> parser = MyHTMLParser(convert_charrefs=False)\n" ">>> parser.feed('>>>')\n" "Named ent: >\n" "Num ent : >\n" "Num ent : >" +msgstr "" msgid "" -"Feeding incomplete chunks to :meth:`~HTMLParser.feed` works, but :meth:" -"`~HTMLParser.handle_data` might be called more than once (unless " -"*convert_charrefs* is set to ``True``)::" +"Feeding incomplete chunks to :meth:`~HTMLParser.feed` works, " +"but :meth:`~HTMLParser.handle_data` might be called more than once if " +"*convert_charrefs* is false:" msgstr "" msgid "" -">>> for chunk in ['buff', 'ered ', 'text']:\n" +">>> for chunk in ['buff', 'ered', ' text']:\n" "... parser.feed(chunk)\n" "...\n" "Start tag: span\n" "Data : buff\n" "Data : ered\n" -"Data : text\n" +"Data : text\n" "End tag : span" msgstr "" -msgid "Parsing invalid HTML (e.g. unquoted attributes) also works::" +msgid "Parsing invalid HTML (e.g. unquoted attributes) also works:" msgstr "" msgid "" diff --git a/library/html.po b/library/html.po index 0ef6204c57..9d185dd6f0 100644 --- a/library/html.po +++ b/library/html.po @@ -41,11 +41,11 @@ msgid "" msgstr "" msgid "" -"Convert all named and numeric character references (e.g. ``>``, ``>" -"``, ``>``) in the string *s* to the corresponding Unicode characters. " -"This function uses the rules defined by the HTML 5 standard for both valid " -"and invalid character references, and the :data:`list of HTML 5 named " -"character references `." +"Convert all named and numeric character references (e.g. ``>``, " +"``>``, ``>``) in the string *s* to the corresponding Unicode " +"characters. This function uses the rules defined by the HTML 5 standard for " +"both valid and invalid character references, and the :data:`list of HTML 5 " +"named character references `." msgstr "" msgid "Submodules in the ``html`` package are:" diff --git a/library/http.client.po b/library/http.client.po index e51675a78d..47976bc5f6 100644 --- a/library/http.client.po +++ b/library/http.client.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,12 +27,12 @@ msgid ":mod:`!http.client` --- HTTP protocol client" msgstr "" msgid "**Source code:** :source:`Lib/http/client.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/http/client.py`" msgid "" "This module defines classes that implement the client side of the HTTP and " -"HTTPS protocols. It is normally not used directly --- the module :mod:" -"`urllib.request` uses it to handle URLs that use HTTP and HTTPS." +"HTTPS protocols. It is normally not used directly --- the " +"module :mod:`urllib.request` uses it to handle URLs that use HTTP and HTTPS." msgstr "" msgid "" @@ -107,8 +106,8 @@ msgid "*source_address*, *context* and *check_hostname* were added." msgstr "" msgid "" -"This class now supports HTTPS virtual hosts if possible (that is, if :const:" -"`ssl.HAS_SNI` is true)." +"This class now supports HTTPS virtual hosts if possible (that is, " +"if :const:`ssl.HAS_SNI` is true)." msgstr "" msgid "" @@ -118,8 +117,8 @@ msgstr "" msgid "" "This class now performs all the necessary certificate and hostname checks by " -"default. To revert to the previous, unverified, behavior :func:`!ssl." -"_create_unverified_context` can be passed to the *context* parameter." +"default. To revert to the previous, unverified, behavior :func:`!" +"ssl._create_unverified_context` can be passed to the *context* parameter." msgstr "" msgid "" @@ -130,8 +129,8 @@ msgstr "" msgid "" "This class now sends an ALPN extension with protocol indicator ``http/1.1`` " -"when no *context* is given. Custom *context* should set ALPN protocols with :" -"meth:`~ssl.SSLContext.set_alpn_protocols`." +"when no *context* is given. Custom *context* should set ALPN protocols " +"with :meth:`~ssl.SSLContext.set_alpn_protocols`." msgstr "" msgid "" @@ -155,14 +154,15 @@ msgstr "" msgid "" "Parse the headers from a file pointer *fp* representing a HTTP request/" "response. The file has to be a :class:`~io.BufferedIOBase` reader (i.e. not " -"text) and must provide a valid :rfc:`2822` style header." +"text) and must provide a valid :rfc:`5322` style header." msgstr "" msgid "" "This function returns an instance of :class:`http.client.HTTPMessage` that " -"holds the header fields, but no payload (the same as :attr:`HTTPResponse." -"msg` and :attr:`http.server.BaseHTTPRequestHandler.headers`). After " -"returning, the file pointer *fp* is ready to read the HTTP body." +"holds the header fields, but no payload (the same " +"as :attr:`HTTPResponse.msg` " +"and :attr:`http.server.BaseHTTPRequestHandler.headers`). After returning, " +"the file pointer *fp* is ready to read the HTTP body." msgstr "" msgid "" @@ -176,8 +176,8 @@ msgid "The following exceptions are raised as appropriate:" msgstr "" msgid "" -"The base class of the other exceptions in this module. It is a subclass of :" -"exc:`Exception`." +"The base class of the other exceptions in this module. It is a subclass " +"of :exc:`Exception`." msgstr "" msgid "A subclass of :exc:`HTTPException`." @@ -248,16 +248,16 @@ msgstr "" msgid "" "If *body* is specified, the specified data is sent after the headers are " -"finished. It may be a :class:`str`, a :term:`bytes-like object`, an open :" -"term:`file object`, or an iterable of :class:`bytes`. If *body* is a " +"finished. It may be a :class:`str`, a :term:`bytes-like object`, an " +"open :term:`file object`, or an iterable of :class:`bytes`. If *body* is a " "string, it is encoded as ISO-8859-1, the default for HTTP. If it is a bytes-" "like object, the bytes are sent as is. If it is a :term:`file object`, the " "contents of the file is sent; this file object should support at least the " -"``read()`` method. If the file object is an instance of :class:`io." -"TextIOBase`, the data returned by the ``read()`` method will be encoded as " -"ISO-8859-1, otherwise the data returned by ``read()`` is sent as is. If " -"*body* is an iterable, the elements of the iterable are sent as is until the " -"iterable is exhausted." +"``read()`` method. If the file object is an instance " +"of :class:`io.TextIOBase`, the data returned by the ``read()`` method will " +"be encoded as ISO-8859-1, otherwise the data returned by ``read()`` is sent " +"as is. If *body* is an iterable, the elements of the iterable are sent as " +"is until the iterable is exhausted." msgstr "" msgid "" @@ -308,6 +308,12 @@ msgid "" "that is not also a file as the body representation." msgstr "" +msgid "" +"Note that you must have read the whole response or call :meth:`close` " +"if :meth:`getresponse` raised an non-:exc:`ConnectionError` exception before " +"you can send a new request to the server." +msgstr "" + msgid "*body* can now be an iterable." msgstr "" @@ -324,14 +330,15 @@ msgid "" msgstr "" msgid "" -"Note that you must have read the whole response before you can send a new " -"request to the server." +"If a :exc:`ConnectionError` or subclass is raised, " +"the :class:`HTTPConnection` object will be ready to reconnect when a new " +"request is sent." msgstr "" msgid "" -"If a :exc:`ConnectionError` or subclass is raised, the :class:" -"`HTTPConnection` object will be ready to reconnect when a new request is " -"sent." +"Note that this does not apply to :exc:`OSError`\\s raised by the underlying " +"socket. Instead the caller is responsible to call :meth:`close` on the " +"existing connection." msgstr "" msgid "" @@ -449,11 +456,11 @@ msgid "" "*message_body* will be chunk-encoded as specified in :rfc:`7230`, Section " "3.3.1. How the data is encoded is dependent on the type of *message_body*. " "If *message_body* implements the :ref:`buffer interface ` the " -"encoding will result in a single chunk. If *message_body* is a :class:" -"`collections.abc.Iterable`, each iteration of *message_body* will result in " -"a chunk. If *message_body* is a :term:`file object`, each call to ``." -"read()`` will result in a chunk. The method automatically signals the end of " -"the chunk-encoded data immediately after *message_body*." +"encoding will result in a single chunk. If *message_body* is " +"a :class:`collections.abc.Iterable`, each iteration of *message_body* will " +"result in a chunk. If *message_body* is a :term:`file object`, each call to " +"``.read()`` will result in a chunk. The method automatically signals the end " +"of the chunk-encoded data immediately after *message_body*." msgstr "" msgid "" @@ -467,8 +474,9 @@ msgid "Added chunked encoding support and the *encode_chunked* parameter." msgstr "" msgid "" -"Send data to the server. This should be used directly only after the :meth:" -"`endheaders` method has been called and before :meth:`getresponse` is called." +"Send data to the server. This should be used directly only after " +"the :meth:`endheaders` method has been called and before :meth:`getresponse` " +"is called." msgstr "" msgid "" @@ -513,8 +521,8 @@ msgstr "" msgid "" "A :class:`http.client.HTTPMessage` instance containing the response " -"headers. :class:`http.client.HTTPMessage` is a subclass of :class:`email." -"message.Message`." +"headers. :class:`http.client.HTTPMessage` is a subclass " +"of :class:`email.message.Message`." msgstr "" msgid "" @@ -527,8 +535,8 @@ msgid "" msgstr "" msgid "" -"Headers of the response in the form of an :class:`email.message." -"EmailMessage` instance." +"Headers of the response in the form of " +"an :class:`email.message.EmailMessage` instance." msgstr "" msgid "Status code returned by server." @@ -620,8 +628,8 @@ msgid "" "302 Found\n" ">>> data = response.read()\n" ">>> data\n" -"b'Redirecting to https://bugs." -"python.org/issue12524'\n" +"b'Redirecting to https://" +"bugs.python.org/issue12524'\n" ">>> conn.close()" msgstr "" diff --git a/library/http.cookiejar.po b/library/http.cookiejar.po index 8ee16060e0..95c915cc46 100644 --- a/library/http.cookiejar.po +++ b/library/http.cookiejar.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,22 +27,22 @@ msgid ":mod:`!http.cookiejar` --- Cookie handling for HTTP clients" msgstr "" msgid "**Source code:** :source:`Lib/http/cookiejar.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/http/cookiejar.py`" 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." +"HTTP cookies. It is useful for accessing websites 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 " +"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`` " @@ -51,11 +50,11 @@ msgid "" msgstr "" msgid "" -"The various named parameters found in :mailheader:`Set-Cookie` and :" -"mailheader:`Set-Cookie2` headers (eg. ``domain`` and ``expires``) are " -"conventionally referred to as :dfn:`attributes`. To distinguish them from " -"Python attributes, the documentation for this module uses the term :dfn:" -"`cookie-attribute` instead." +"The various named parameters found in :mailheader:`Set-Cookie` " +"and :mailheader:`Set-Cookie2` headers (for example, ``domain`` and " +"``expires``) are conventionally referred to as :dfn:`attributes`. To " +"distinguish them from Python attributes, the documentation for this module " +"uses the term :dfn:`cookie-attribute` instead." msgstr "" msgid "The module defines the following exception:" @@ -112,31 +111,31 @@ msgstr "" msgid "" "Constructor arguments should be passed as keyword arguments only. " "*blocked_domains* is a sequence of domain names that we never accept cookies " -"from, nor return cookies to. *allowed_domains* if not :const:`None`, this is " -"a sequence of the only domains for which we accept and return cookies. " +"from, nor return cookies to. *allowed_domains* if not ``None``, this is a " +"sequence of the only domains for which we accept and return cookies. " "*secure_protocols* is a sequence of protocols for which secure cookies can " "be added to. By default *https* and *wss* (secure websocket) are considered " -"secure protocols. For all other arguments, see the documentation for :class:" -"`CookiePolicy` and :class:`DefaultCookiePolicy` objects." +"secure protocols. For all other arguments, see the documentation " +"for :class:`CookiePolicy` and :class:`DefaultCookiePolicy` objects." msgstr "" msgid "" ":class:`DefaultCookiePolicy` implements the standard accept / reject rules " -"for Netscape and :rfc:`2965` cookies. By default, :rfc:`2109` cookies (ie. " -"cookies received in a :mailheader:`Set-Cookie` header with a version cookie-" -"attribute of 1) are treated according to the RFC 2965 rules. However, if " -"RFC 2965 handling is turned off or :attr:`rfc2109_as_netscape` is ``True``, " -"RFC 2109 cookies are 'downgraded' by the :class:`CookieJar` instance to " -"Netscape cookies, by setting the :attr:`version` attribute of the :class:" -"`Cookie` instance to 0. :class:`DefaultCookiePolicy` also provides some " -"parameters to allow some fine-tuning of policy." +"for Netscape and :rfc:`2965` cookies. By default, :rfc:`2109` cookies (that " +"is, cookies received in a :mailheader:`Set-Cookie` header with a version " +"cookie-attribute of 1) are treated according to the RFC 2965 rules. " +"However, if RFC 2965 handling is turned off or :attr:`rfc2109_as_netscape` " +"is ``True``, RFC 2109 cookies are 'downgraded' by the :class:`CookieJar` " +"instance to Netscape cookies, by setting the :attr:`~Cookie.version` " +"attribute of the :class:`Cookie` instance to 0. :class:`DefaultCookiePolicy` " +"also provides some parameters to allow some fine-tuning of policy." msgstr "" msgid "" "This class represents Netscape, :rfc:`2109` and :rfc:`2965` cookies. It is " -"not expected that users of :mod:`http.cookiejar` construct their own :class:" -"`Cookie` instances. Instead, if necessary, call :meth:`make_cookies` on a :" -"class:`CookieJar` instance." +"not expected that users of :mod:`http.cookiejar` construct their " +"own :class:`Cookie` instances. Instead, if necessary, " +"call :meth:`~CookieJar.make_cookies` on a :class:`CookieJar` instance." msgstr "" msgid "Module :mod:`urllib.request`" @@ -149,8 +148,9 @@ 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." +"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" @@ -186,7 +186,7 @@ msgstr "" msgid ":rfc:`2964` - Use of HTTP State Management" msgstr "" -msgid "CookieJar and FileCookieJar Objects" +msgid "CookieJar and FileCookieJar objects" msgstr "" msgid "" @@ -201,49 +201,56 @@ msgid "Add correct :mailheader:`Cookie` header to *request*." msgstr "" msgid "" -"If policy allows (ie. the :attr:`rfc2965` and :attr:`hide_cookie2` " -"attributes of the :class:`CookieJar`'s :class:`CookiePolicy` instance are " -"true and false respectively), the :mailheader:`Cookie2` header is also added " -"when appropriate." +"If policy allows (that is, the :attr:`~CookiePolicy.rfc2965` " +"and :attr:`~CookiePolicy.hide_cookie2` attributes of " +"the :class:`CookieJar`'s :class:`CookiePolicy` instance are true and false " +"respectively), the :mailheader:`Cookie2` header is also added when " +"appropriate." msgstr "" msgid "" "The *request* object (usually a :class:`urllib.request.Request` instance) " -"must support the methods :meth:`get_full_url`, :meth:`has_header`, :meth:" -"`get_header`, :meth:`header_items`, :meth:`add_unredirected_header` and the " -"attributes :attr:`host`, :attr:`!type`, :attr:`unverifiable` and :attr:" -"`origin_req_host` as documented by :mod:`urllib.request`." +"must support the " +"methods :meth:`~urllib.request.Request.get_full_url`, :meth:`~urllib.request.Request.has_header`, :meth:`~urllib.request.Request.get_header`, :meth:`~urllib.request.Request.header_items`, :meth:`~urllib.request.Request.add_unredirected_header` " +"and the " +"attributes :attr:`~urllib.request.Request.host`, :attr:`~urllib.request.Request.type`, :attr:`~urllib.request.Request.unverifiable` " +"and :attr:`~urllib.request.Request.origin_req_host` as documented " +"by :mod:`urllib.request`." msgstr "" msgid "" -"*request* object needs :attr:`origin_req_host` attribute. Dependency on a " -"deprecated method :meth:`get_origin_req_host` has been removed." +"*request* object needs :attr:`~urllib.request.Request.origin_req_host` " +"attribute. Dependency on a deprecated method :meth:`!get_origin_req_host` " +"has been removed." msgstr "" msgid "" -"Extract cookies from HTTP *response* and store them in the :class:" -"`CookieJar`, where allowed by policy." +"Extract cookies from HTTP *response* and store them in " +"the :class:`CookieJar`, where allowed by policy." msgstr "" msgid "" -"The :class:`CookieJar` will look for allowable :mailheader:`Set-Cookie` and :" -"mailheader:`Set-Cookie2` headers in the *response* argument, and store " +"The :class:`CookieJar` will look for allowable :mailheader:`Set-Cookie` " +"and :mailheader:`Set-Cookie2` headers in the *response* argument, and store " "cookies as appropriate (subject to the :meth:`CookiePolicy.set_ok` method's " "approval)." msgstr "" msgid "" -"The *response* object (usually the result of a call to :meth:`urllib.request." -"urlopen`, or similar) should support an :meth:`info` method, which returns " +"The *response* object (usually the result of a call " +"to :meth:`urllib.request.urlopen`, or similar) should support " +"an :meth:`~http.client.HTTPResponse.info` method, which returns " "an :class:`email.message.Message` instance." msgstr "" msgid "" "The *request* object (usually a :class:`urllib.request.Request` instance) " -"must support the method :meth:`get_full_url` and the attributes :attr:" -"`host`, :attr:`unverifiable` and :attr:`origin_req_host`, as documented by :" -"mod:`urllib.request`. The request is used to set default values for cookie-" -"attributes as well as for checking that the cookie is allowed to be set." +"must support the method :meth:`~urllib.request.Request.get_full_url` and the " +"attributes :attr:`~urllib.request.Request.host`, :attr:`~urllib.request.Request.unverifiable` " +"and :attr:`~urllib.request.Request.origin_req_host`, as documented " +"by :mod:`urllib.request`. The request is used to set default values for " +"cookie-attributes as well as for checking that the cookie is allowed to be " +"set." msgstr "" msgid "Set the :class:`CookiePolicy` instance to be used." @@ -284,16 +291,16 @@ msgid "Discard all session cookies." msgstr "" msgid "" -"Discards all contained cookies that have a true :attr:`discard` attribute " -"(usually because they had either no ``max-age`` or ``expires`` cookie-" -"attribute, or an explicit ``discard`` cookie-attribute). For interactive " -"browsers, the end of a session usually corresponds to closing the browser " -"window." +"Discards all contained cookies that have a true :attr:`~Cookie.discard` " +"attribute (usually because they had either no ``max-age`` or ``expires`` " +"cookie-attribute, or an explicit ``discard`` cookie-attribute). For " +"interactive browsers, the end of a session usually corresponds to closing " +"the browser window." msgstr "" msgid "" -"Note that the :meth:`save` method won't save session cookies anyway, unless " -"you ask otherwise by passing a true *ignore_discard* argument." +"Note that the :meth:`~FileCookieJar.save` method won't save session cookies " +"anyway, unless you ask otherwise by passing a true *ignore_discard* argument." msgstr "" msgid ":class:`FileCookieJar` implements the following additional methods:" @@ -309,9 +316,10 @@ msgstr "" msgid "" "*filename* is the name of file in which to save cookies. If *filename* is " -"not specified, :attr:`self.filename` is used (whose default is the value " -"passed to the constructor, if any); if :attr:`self.filename` is :const:" -"`None`, :exc:`ValueError` is raised." +"not specified, :attr:`self.filename ` is used (whose " +"default is the value passed to the constructor, if any); " +"if :attr:`self.filename ` is " +"``None``, :exc:`ValueError` is raised." msgstr "" msgid "" @@ -321,8 +329,8 @@ msgstr "" msgid "" "The file is overwritten if it already exists, thus wiping all the cookies it " -"contains. Saved cookies can be restored later using the :meth:`load` or :" -"meth:`revert` methods." +"contains. Saved cookies can be restored later using the :meth:`load` " +"or :meth:`revert` methods." msgstr "" msgid "Load cookies from a file." @@ -335,9 +343,9 @@ msgid "Arguments are as for :meth:`save`." msgstr "" msgid "" -"The named file must be in the format understood by the class, or :exc:" -"`LoadError` will be raised. Also, :exc:`OSError` may be raised, for example " -"if the file does not exist." +"The named file must be in the format understood by the class, " +"or :exc:`LoadError` will be raised. Also, :exc:`OSError` may be raised, for " +"example if the file does not exist." msgstr "" msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`." @@ -404,7 +412,7 @@ msgid "" "file." msgstr "" -msgid "CookiePolicy Objects" +msgid "CookiePolicy objects" msgstr "" msgid "" @@ -419,8 +427,8 @@ msgstr "" msgid "" "*cookie* is a :class:`Cookie` instance. *request* is an object implementing " -"the interface defined by the documentation for :meth:`CookieJar." -"extract_cookies`." +"the interface defined by the documentation " +"for :meth:`CookieJar.extract_cookies`." msgstr "" msgid "" @@ -429,8 +437,8 @@ msgstr "" msgid "" "*cookie* is a :class:`Cookie` instance. *request* is an object implementing " -"the interface defined by the documentation for :meth:`CookieJar." -"add_cookie_header`." +"the interface defined by the documentation " +"for :meth:`CookieJar.add_cookie_header`." msgstr "" msgid "" @@ -445,12 +453,13 @@ msgid "" msgstr "" msgid "" -"If :meth:`domain_return_ok` returns true for the cookie domain, :meth:" -"`path_return_ok` is called for the cookie path. Otherwise, :meth:" -"`path_return_ok` and :meth:`return_ok` are never called for that cookie " -"domain. If :meth:`path_return_ok` returns true, :meth:`return_ok` is called " -"with the :class:`Cookie` object itself for a full check. Otherwise, :meth:" -"`return_ok` is never called for that cookie path." +"If :meth:`domain_return_ok` returns true for the cookie " +"domain, :meth:`path_return_ok` is called for the cookie path. " +"Otherwise, :meth:`path_return_ok` and :meth:`return_ok` are never called for " +"that cookie domain. If :meth:`path_return_ok` returns " +"true, :meth:`return_ok` is called with the :class:`Cookie` object itself for " +"a full check. Otherwise, :meth:`return_ok` is never called for that cookie " +"path." msgstr "" msgid "" @@ -470,10 +479,10 @@ msgid "See the documentation for :meth:`domain_return_ok`." msgstr "" msgid "" -"In addition to implementing the methods above, implementations of the :class:" -"`CookiePolicy` interface must also supply the following attributes, " -"indicating which protocols should be used, and how. All of these attributes " -"may be assigned to." +"In addition to implementing the methods above, implementations of " +"the :class:`CookiePolicy` interface must also supply the following " +"attributes, indicating which protocols should be used, and how. All of " +"these attributes may be assigned to." msgstr "" msgid "Implement Netscape protocol." @@ -495,7 +504,7 @@ msgid "" "to be useful)." msgstr "" -msgid "DefaultCookiePolicy Objects" +msgid "DefaultCookiePolicy objects" msgstr "" msgid "Implements the standard rules for accepting and returning cookies." @@ -536,10 +545,11 @@ msgid "" "A domain blocklist and allowlist is provided (both off by default). Only " "domains not in the blocklist and present in the allowlist (if the allowlist " "is active) participate in cookie setting and returning. Use the " -"*blocked_domains* constructor argument, and :meth:`blocked_domains` and :" -"meth:`set_blocked_domains` methods (and the corresponding argument and " -"methods for *allowed_domains*). If you set an allowlist, you can turn it " -"off again by setting it to :const:`None`." +"*blocked_domains* constructor argument, " +"and :meth:`~DefaultCookiePolicy.blocked_domains` " +"and :meth:`~DefaultCookiePolicy.set_blocked_domains` methods (and the " +"corresponding argument and methods for *allowed_domains*). If you set an " +"allowlist, you can turn it off again by setting it to ``None``." msgstr "" msgid "" @@ -547,11 +557,12 @@ msgid "" "cookie domain to be matched. For example, ``\"example.com\"`` matches a " "blocklist entry of ``\"example.com\"``, but ``\"www.example.com\"`` does " "not. Domains that do start with a dot are matched by more specific domains " -"too. For example, both ``\"www.example.com\"`` and ``\"www.coyote.example." -"com\"`` match ``\".example.com\"`` (but ``\"example.com\"`` itself does " -"not). IP addresses are an exception, and must match exactly. For example, " -"if blocked_domains contains ``\"192.168.1.2\"`` and ``\".168.1.2\"``, " -"192.168.1.2 is blocked, but 193.168.1.2 is not." +"too. For example, both ``\"www.example.com\"`` and " +"``\"www.coyote.example.com\"`` match ``\".example.com\"`` (but " +"``\"example.com\"`` itself does not). IP addresses are an exception, and " +"must match exactly. For example, if blocked_domains contains " +"``\"192.168.1.2\"`` and ``\".168.1.2\"``, 192.168.1.2 is blocked, but " +"193.168.1.2 is not." msgstr "" msgid "" @@ -569,10 +580,10 @@ msgid "" "cookies." msgstr "" -msgid "Return :const:`None`, or the sequence of allowed domains (as a tuple)." +msgid "Return ``None``, or the sequence of allowed domains (as a tuple)." msgstr "" -msgid "Set the sequence of allowed domains, or :const:`None`." +msgid "Set the sequence of allowed domains, or ``None``." msgstr "" msgid "" @@ -588,12 +599,12 @@ msgstr "" msgid "" "If true, request that the :class:`CookieJar` instance downgrade :rfc:`2109` " -"cookies (ie. cookies received in a :mailheader:`Set-Cookie` header with a " -"version cookie-attribute of 1) to Netscape cookies by setting the version " -"attribute of the :class:`Cookie` instance to 0. The default value is :const:" -"`None`, in which case RFC 2109 cookies are downgraded if and only if :rfc:" -"`2965` handling is turned off. Therefore, RFC 2109 cookies are downgraded " -"by default." +"cookies (that is, cookies received in a :mailheader:`Set-Cookie` header with " +"a version cookie-attribute of 1) to Netscape cookies by setting the version " +"attribute of the :class:`Cookie` instance to 0. The default value is " +"``None``, in which case RFC 2109 cookies are downgraded if and only " +"if :rfc:`2965` handling is turned off. Therefore, RFC 2109 cookies are " +"downgraded by default." msgstr "" msgid "General strictness switches:" @@ -636,22 +647,22 @@ 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|" +":attr:`~DefaultCookiePolicy.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`` " +"When setting cookies, the 'host prefix' must not contain a dot (for example, " +"``www.foo.bar.com`` can't set a cookie for ``.bar.com``, because ``www.foo`` " "contains a dot)." msgstr "" msgid "" "Cookies that did not explicitly specify a ``domain`` cookie-attribute can " -"only be returned to a domain equal to the domain that set the cookie (eg. " -"``spam.example.com`` won't be returned cookies from ``example.com`` that had " -"no ``domain`` cookie-attribute)." +"only be returned to a domain equal to the domain that set the cookie (for " +"example, ``spam.example.com`` won't be returned cookies from ``example.com`` " +"that had no ``domain`` cookie-attribute)." msgstr "" msgid "When setting cookies, require a full :rfc:`2965` domain-match." @@ -663,14 +674,14 @@ msgid "" msgstr "" msgid "" -"Equivalent to 0 (ie. all of the above Netscape domain strictness flags " +"Equivalent to 0 (that is, all of the above Netscape domain strictness flags " "switched off)." msgstr "" msgid "Equivalent to ``DomainStrictNoDots|DomainStrictNonDomain``." msgstr "" -msgid "Cookie Objects" +msgid "Cookie objects" msgstr "" msgid "" @@ -690,52 +701,52 @@ msgid "" msgstr "" msgid "" -"Integer or :const:`None`. Netscape cookies have :attr:`version` 0. :rfc:" -"`2965` and :rfc:`2109` cookies have a ``version`` cookie-attribute of 1. " -"However, note that :mod:`http.cookiejar` may 'downgrade' RFC 2109 cookies to " -"Netscape cookies, in which case :attr:`version` is 0." +"Integer or ``None``. Netscape cookies have :attr:`version` 0. :rfc:`2965` " +"and :rfc:`2109` cookies have a ``version`` cookie-attribute of 1. However, " +"note that :mod:`http.cookiejar` may 'downgrade' RFC 2109 cookies to Netscape " +"cookies, in which case :attr:`version` is 0." msgstr "" msgid "Cookie name (a string)." msgstr "" -msgid "Cookie value (a string), or :const:`None`." +msgid "Cookie value (a string), or ``None``." msgstr "" msgid "" -"String representing a port or a set of ports (eg. '80', or '80,8080'), or :" -"const:`None`." +"String representing a port or a set of ports (for example, '80', or " +"'80,8080'), or ``None``." msgstr "" msgid "Cookie domain (a string)." msgstr "" -msgid "Cookie path (a string, eg. ``'/acme/rocket_launchers'``)." +msgid "Cookie path (a string, for example, ``'/acme/rocket_launchers'``)." msgstr "" msgid "``True`` if cookie should only be returned over a secure connection." msgstr "" msgid "" -"Integer expiry date in seconds since epoch, or :const:`None`. See also the :" -"meth:`is_expired` method." +"Integer expiry date in seconds since epoch, or ``None``. See also " +"the :meth:`is_expired` method." msgstr "" msgid "``True`` if this is a session cookie." msgstr "" msgid "" -"String comment from the server explaining the function of this cookie, or :" -"const:`None`." +"String comment from the server explaining the function of this cookie, or " +"``None``." msgstr "" msgid "" "URL linking to a comment from the server explaining the function of this " -"cookie, or :const:`None`." +"cookie, or ``None``." msgstr "" msgid "" -"``True`` if this cookie was received as an :rfc:`2109` cookie (ie. the " +"``True`` if this cookie was received as an :rfc:`2109` cookie (that is, the " "cookie arrived in a :mailheader:`Set-Cookie` header, and the value of the " "Version cookie-attribute in that header was 1). This attribute is provided " "because :mod:`http.cookiejar` may 'downgrade' RFC 2109 cookies to Netscape " @@ -790,8 +801,8 @@ msgstr "" msgid "" "import http.cookiejar, urllib.request\n" "cj = http.cookiejar.CookieJar()\n" -"opener = urllib.request.build_opener(urllib.request." -"HTTPCookieProcessor(cj))\n" +"opener = " +"urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj))\n" "r = opener.open(\"http://example.com/\")" msgstr "" @@ -804,10 +815,10 @@ msgstr "" msgid "" "import os, http.cookiejar, urllib.request\n" "cj = http.cookiejar.MozillaCookieJar()\n" -"cj.load(os.path.join(os.path.expanduser(\"~\"), \".netscape\", \"cookies." -"txt\"))\n" -"opener = urllib.request.build_opener(urllib.request." -"HTTPCookieProcessor(cj))\n" +"cj.load(os.path.join(os.path.expanduser(\"~\"), \".netscape\", " +"\"cookies.txt\"))\n" +"opener = " +"urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj))\n" "r = opener.open(\"http://example.com/\")" msgstr "" @@ -825,7 +836,7 @@ msgid "" " rfc2965=True, strict_ns_domain=Policy.DomainStrict,\n" " blocked_domains=[\"ads.net\", \".ads.net\"])\n" "cj = CookieJar(policy)\n" -"opener = urllib.request.build_opener(urllib.request." -"HTTPCookieProcessor(cj))\n" +"opener = " +"urllib.request.build_opener(urllib.request.HTTPCookieProcessor(cj))\n" "r = opener.open(\"http://example.com/\")" msgstr "" diff --git a/library/http.cookies.po b/library/http.cookies.po index 431e281c65..220f42d446 100644 --- a/library/http.cookies.po +++ b/library/http.cookies.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!http.cookies` --- HTTP state management" msgstr "" msgid "**Source code:** :source:`Lib/http/cookies.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/http/cookies.py`" msgid "" "The :mod:`http.cookies` module defines classes for abstracting the concept " @@ -37,12 +37,12 @@ msgid "" msgstr "" msgid "" -"The module formerly strictly applied the parsing rules described in the :rfc:" -"`2109` and :rfc:`2068` specifications. It has since been discovered that " -"MSIE 3.0x didn't follow the character rules outlined in those specs; many " -"current-day browsers and servers have also relaxed parsing rules when it " -"comes to cookie handling. As a result, this module now uses parsing rules " -"that are a bit less strict than they once were." +"The module formerly strictly applied the parsing rules described in " +"the :rfc:`2109` and :rfc:`2068` specifications. It has since been " +"discovered that MSIE 3.0x didn't follow the character rules outlined in " +"those specs; many current-day browsers and servers have also relaxed parsing " +"rules when it comes to cookie handling. As a result, this module now uses " +"parsing rules that are a bit less strict than they once were." msgstr "" msgid "" @@ -76,19 +76,20 @@ msgid "If *input* is given, it is passed to the :meth:`load` method." msgstr "" msgid "" -"This class derives from :class:`BaseCookie` and overrides :meth:`~BaseCookie." -"value_decode` and :meth:`~BaseCookie.value_encode`. :class:`!SimpleCookie` " -"supports strings as cookie values. When setting the value, :class:`!" -"SimpleCookie` calls the builtin :func:`str` to convert the value to a " -"string. Values received from HTTP are kept as strings." +"This class derives from :class:`BaseCookie` and " +"overrides :meth:`~BaseCookie.value_decode` " +"and :meth:`~BaseCookie.value_encode`. :class:`!SimpleCookie` supports " +"strings as cookie values. When setting the value, :class:`!SimpleCookie` " +"calls the builtin :func:`str` to convert the value to a string. Values " +"received from HTTP are kept as strings." msgstr "" msgid "Module :mod:`http.cookiejar`" msgstr "" msgid "" -"HTTP cookie handling for web *clients*. The :mod:`http.cookiejar` and :mod:" -"`http.cookies` modules do not depend on each other." +"HTTP cookie handling for web *clients*. The :mod:`http.cookiejar` " +"and :mod:`http.cookies` modules do not depend on each other." msgstr "" msgid ":rfc:`2109` - HTTP State Management Mechanism" @@ -102,8 +103,8 @@ msgstr "" msgid "" "Return a tuple ``(real_value, coded_value)`` from a string representation. " -"``real_value`` can be any type. This method does no decoding in :class:" -"`BaseCookie` --- it exists so it can be overridden." +"``real_value`` can be any type. This method does no decoding " +"in :class:`BaseCookie` --- it exists so it can be overridden." msgstr "" msgid "" @@ -113,8 +114,8 @@ msgid "" msgstr "" msgid "" -"In general, it should be the case that :meth:`value_encode` and :meth:" -"`value_decode` are inverses on the range of *value_decode*." +"In general, it should be the case that :meth:`value_encode` " +"and :meth:`value_decode` are inverses on the range of *value_decode*." msgstr "" msgid "" @@ -161,9 +162,12 @@ msgid "" msgstr "" msgid "" -"The attribute :attr:`samesite` specifies that the browser is not allowed to " -"send the cookie along with cross-site requests. This helps to mitigate CSRF " -"attacks. Valid values for this attribute are \"Strict\" and \"Lax\"." +"The attribute :attr:`samesite` controls when the browser sends the cookie " +"with cross-site requests. This helps to mitigate CSRF attacks. Valid values " +"are \"Strict\" (only sent with same-site requests), \"Lax\" (sent with same-" +"site requests and top-level navigations), and \"None\" (sent with same-site " +"and cross-site requests). When using \"None\", the \"secure\" attribute must " +"also be set, as required by modern browsers." msgstr "" msgid "The keys are case-insensitive and their default value is ``''``." @@ -175,8 +179,9 @@ msgid "" msgstr "" msgid "" -"Attributes :attr:`~Morsel.key`, :attr:`~Morsel.value` and :attr:`~Morsel." -"coded_value` are read-only. Use :meth:`~Morsel.set` for setting them." +"Attributes :attr:`~Morsel.key`, :attr:`~Morsel.value` " +"and :attr:`~Morsel.coded_value` are read-only. Use :meth:`~Morsel.set` for " +"setting them." msgstr "" msgid "Added support for the :attr:`samesite` attribute." @@ -266,9 +271,9 @@ msgid "" "Set-Cookie: chips=ahoy\n" "Set-Cookie: vienna=finger\n" ">>> C = cookies.SimpleCookie()\n" -">>> C.load('keebler=\"E=everybody; L=\\\\\"Loves\\\\\"; fudge=\\\\012;\";')\n" +">>> C.load('keebler=\"E=everybody; L=\\\\\"Loves\\\\\"; fudge=;\";')\n" ">>> print(C)\n" -"Set-Cookie: keebler=\"E=everybody; L=\\\"Loves\\\"; fudge=\\012;\"\n" +"Set-Cookie: keebler=\"E=everybody; L=\\\"Loves\\\"; fudge=;\"\n" ">>> C = cookies.SimpleCookie()\n" ">>> C[\"oreo\"] = \"doublestuff\"\n" ">>> C[\"oreo\"][\"path\"] = \"/\"\n" diff --git a/library/http.po b/library/http.po index 54fa37bf87..83c4a24b37 100644 --- a/library/http.po +++ b/library/http.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!http` --- HTTP modules" msgstr "" msgid "**Source code:** :source:`Lib/http/__init__.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/http/__init__.py`" msgid "" ":mod:`http` is a package that collects several modules for working with the " @@ -41,8 +40,8 @@ msgid "" msgstr "" msgid "" -":mod:`http.server` contains basic HTTP server classes based on :mod:" -"`socketserver`" +":mod:`http.server` contains basic HTTP server classes based " +"on :mod:`socketserver`" msgstr "" msgid "" @@ -87,8 +86,8 @@ msgstr "" msgid "" "Supported, `IANA-registered status codes `_ available in :class:`http." -"HTTPStatus` are:" +"http-status-codes/http-status-codes.xhtml>`_ available " +"in :class:`http.HTTPStatus` are:" msgstr "" msgid "Code" @@ -212,7 +211,7 @@ msgid "``208``" msgstr "``208``" msgid "``ALREADY_REPORTED``" -msgstr "" +msgstr "``ALREADY_REPORTED``" msgid "WebDAV Binding Extensions :rfc:`5842`, Section 7.1 (Experimental)" msgstr "" @@ -230,7 +229,7 @@ msgid "``300``" msgstr "``300``" msgid "``MULTIPLE_CHOICES``" -msgstr "" +msgstr "``MULTIPLE_CHOICES``" msgid "HTTP Semantics :rfc:`9110`, Section 15.4.1" msgstr "" @@ -239,7 +238,7 @@ msgid "``301``" msgstr "``301``" msgid "``MOVED_PERMANENTLY``" -msgstr "" +msgstr "``MOVED_PERMANENTLY``" msgid "HTTP Semantics :rfc:`9110`, Section 15.4.2" msgstr "" @@ -257,7 +256,7 @@ msgid "``303``" msgstr "``303``" msgid "``SEE_OTHER``" -msgstr "" +msgstr "``SEE_OTHER``" msgid "HTTP Semantics :rfc:`9110`, Section 15.4.4" msgstr "" @@ -356,7 +355,7 @@ msgid "``406``" msgstr "``406``" msgid "``NOT_ACCEPTABLE``" -msgstr "" +msgstr "``NOT_ACCEPTABLE``" msgid "HTTP Semantics :rfc:`9110`, Section 15.5.7" msgstr "" @@ -401,7 +400,7 @@ msgid "``411``" msgstr "``411``" msgid "``LENGTH_REQUIRED``" -msgstr "" +msgstr "``LENGTH_REQUIRED``" msgid "HTTP Semantics :rfc:`9110`, Section 15.5.12" msgstr "" @@ -473,7 +472,7 @@ msgid "``421``" msgstr "``421``" msgid "``MISDIRECTED_REQUEST``" -msgstr "" +msgstr "``MISDIRECTED_REQUEST``" msgid "HTTP Semantics :rfc:`9110`, Section 15.5.20" msgstr "" @@ -518,7 +517,7 @@ msgid "``426``" msgstr "``426``" msgid "``UPGRADE_REQUIRED``" -msgstr "" +msgstr "``UPGRADE_REQUIRED``" msgid "HTTP Semantics :rfc:`9110`, Section 15.5.22" msgstr "" @@ -611,7 +610,7 @@ msgid "``506``" msgstr "``506``" msgid "``VARIANT_ALSO_NEGOTIATES``" -msgstr "" +msgstr "``VARIANT_ALSO_NEGOTIATES``" msgid "" "Transparent Content Negotiation in HTTP :rfc:`2295`, Section 8.1 " @@ -622,7 +621,7 @@ msgid "``507``" msgstr "``507``" msgid "``INSUFFICIENT_STORAGE``" -msgstr "" +msgstr "``INSUFFICIENT_STORAGE``" msgid "WebDAV :rfc:`4918`, Section 11.5" msgstr "" @@ -674,7 +673,9 @@ msgstr "" msgid "" "Implemented RFC9110 naming for status constants. Old constant names are " -"preserved for backwards compatibility." +"preserved for backwards compatibility: ``413 REQUEST_ENTITY_TOO_LARGE``, " +"``414 REQUEST_URI_TOO_LONG``, ``416 REQUESTED_RANGE_NOT_SATISFIABLE`` and " +"``422 UNPROCESSABLE_ENTITY``." msgstr "" msgid "HTTP status category" @@ -776,55 +777,55 @@ msgid "Method" msgstr "" msgid "``GET``" -msgstr "" +msgstr "``GET``" msgid "HTTP Semantics :rfc:`9110`, Section 9.3.1" msgstr "" msgid "``HEAD``" -msgstr "" +msgstr "``HEAD``" msgid "HTTP Semantics :rfc:`9110`, Section 9.3.2" msgstr "" msgid "``POST``" -msgstr "" +msgstr "``POST``" msgid "HTTP Semantics :rfc:`9110`, Section 9.3.3" msgstr "" msgid "``PUT``" -msgstr "" +msgstr "``PUT``" msgid "HTTP Semantics :rfc:`9110`, Section 9.3.4" msgstr "" msgid "``DELETE``" -msgstr "" +msgstr "``DELETE``" msgid "HTTP Semantics :rfc:`9110`, Section 9.3.5" msgstr "" msgid "``CONNECT``" -msgstr "" +msgstr "``CONNECT``" msgid "HTTP Semantics :rfc:`9110`, Section 9.3.6" msgstr "" msgid "``OPTIONS``" -msgstr "" +msgstr "``OPTIONS``" msgid "HTTP Semantics :rfc:`9110`, Section 9.3.7" msgstr "" msgid "``TRACE``" -msgstr "" +msgstr "``TRACE``" msgid "HTTP Semantics :rfc:`9110`, Section 9.3.8" msgstr "" msgid "``PATCH``" -msgstr "" +msgstr "``PATCH``" msgid "HTTP/1.1 :rfc:`5789`" msgstr "" diff --git a/library/http.server.po b/library/http.server.po index 5d66d9f835..a32507cddb 100644 --- a/library/http.server.po +++ b/library/http.server.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,14 +28,14 @@ msgid ":mod:`!http.server` --- HTTP servers" msgstr "" msgid "**Source code:** :source:`Lib/http/server.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/http/server.py`" msgid "This module defines classes for implementing HTTP servers." msgstr "" msgid "" -":mod:`http.server` is not recommended for production. It only implements :" -"ref:`basic security checks `." +":mod:`http.server` is not recommended for production. It only " +"implements :ref:`basic security checks `." msgstr "" msgid "Availability" @@ -61,9 +61,16 @@ msgstr "" msgid "" "This class builds on the :class:`~socketserver.TCPServer` class by storing " -"the server address as instance variables named :attr:`server_name` and :attr:" -"`server_port`. The server is accessible by the handler, typically through " -"the handler's :attr:`server` instance variable." +"the server address as instance variables named :attr:`server_name` " +"and :attr:`server_port`. The server is accessible by the handler, typically " +"through the handler's :attr:`~socketserver.BaseRequestHandler.server` " +"instance variable." +msgstr "" + +msgid "The HTTP server's fully qualified domain name." +msgstr "" + +msgid "The HTTP server's port number obtained from *server_address*." msgstr "" msgid "" @@ -82,9 +89,9 @@ 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." +"subclassed to handle each request method (for example, ``'GET'`` or " +"``'POST'``). :class:`BaseHTTPRequestHandler` provides a number of class and " +"instance variables, and methods for use by subclasses." msgstr "" msgid "" @@ -115,18 +122,18 @@ msgstr "" msgid "" "Contains the string representation of the HTTP request line. The terminating " -"CRLF is stripped. This attribute should be set by :meth:" -"`handle_one_request`. If no valid request line was processed, it should be " -"set to the empty string." +"CRLF is stripped. This attribute should be set " +"by :meth:`handle_one_request`. If no valid request line was processed, it " +"should be set to the empty string." msgstr "" msgid "Contains the command (request type). For example, ``'GET'``." msgstr "" msgid "" -"Contains the request path. If query component of the URL is present, then " -"``path`` includes the query. Using the terminology of :rfc:`3986`, ``path`` " -"here includes ``hier-part`` and the ``query``." +"Contains the request path. If the query component of the URL is present, " +"then ``path`` includes the query. Using the terminology of :rfc:`3986`, " +"``path`` here includes ``hier-part`` and the ``query``." msgstr "" msgid "" @@ -138,7 +145,7 @@ msgid "" "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." +"valid :rfc:`5322` style header." msgstr "" msgid "" @@ -165,15 +172,15 @@ msgid "" msgstr "" msgid "" -"Contains the Python system version, in a form usable by the :attr:" -"`version_string` method and the :attr:`server_version` class variable. For " -"example, ``'Python/1.4'``." +"Contains the Python system version, in a form usable by " +"the :attr:`version_string` method and the :attr:`server_version` class " +"variable. For example, ``'Python/1.4'``." msgstr "" msgid "" "Specifies a format string that should be used by :meth:`send_error` method " "for building an error response to the client. The string is filled by " -"default with variables from :attr:`responses` based on the status code that " +"default with variables from :attr:`responses` based on the status code " "passed to :meth:`send_error`." msgstr "" @@ -194,8 +201,8 @@ msgstr "" msgid "" "Specifies an :class:`email.message.Message`\\ -like class to parse HTTP " -"headers. Typically, this is not overridden, and it defaults to :class:`http." -"client.HTTPMessage`." +"headers. Typically, this is not overridden, and it defaults " +"to :class:`http.client.HTTPMessage`." msgstr "" msgid "" @@ -222,9 +229,9 @@ 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 " +"request header it responds with a ``100 Continue`` followed by ``200 OK`` " +"headers. This method can be overridden to raise an error if the server does " +"not want the client to continue. For example, the server can choose to send " "``417 Expectation Failed`` as a response header and ``return False``." msgstr "" @@ -266,8 +273,11 @@ msgid "" "Adds the HTTP header to an internal buffer which will be written to the " "output stream when either :meth:`end_headers` or :meth:`flush_headers` is " "invoked. *keyword* should specify the header keyword, with *value* " -"specifying its value. Note that, after the send_header calls are done, :meth:" -"`end_headers` MUST BE called in order to complete the operation." +"specifying its value. Note that, after the send_header calls are " +"done, :meth:`end_headers` MUST BE called in order to complete the operation." +msgstr "" + +msgid "This method does not reject input containing CRLF sequences." msgstr "" msgid "Headers are stored in an internal buffer." @@ -275,9 +285,12 @@ msgstr "" msgid "" "Sends the response header only, used for the purposes when ``100 Continue`` " -"response is sent by the server to the client. The headers not buffered and " -"sent directly the output stream.If the *message* is not specified, the HTTP " -"message corresponding the response *code* is sent." +"response is sent by the server to the client. The headers are not buffered " +"and sent directly the output stream. If the *message* is not specified, the " +"HTTP message corresponding the response *code* is sent." +msgstr "" + +msgid "This method does not reject *message* containing CRLF sequences." msgstr "" msgid "" @@ -308,14 +321,14 @@ msgstr "" msgid "" "Logs an arbitrary message to ``sys.stderr``. This is typically overridden to " "create custom error logging mechanisms. The *format* argument is a standard " -"printf-style format string, where the additional arguments to :meth:" -"`log_message` are applied as inputs to the formatting. The client ip address " -"and current date and time are prefixed to every message logged." +"printf-style format string, where the additional arguments " +"to :meth:`log_message` are applied as inputs to the formatting. The client " +"IP address and current date and time are prefixed to every message logged." msgstr "" msgid "" -"Returns the server software's version string. This is a combination of the :" -"attr:`server_version` and :attr:`sys_version` attributes." +"Returns the server software's version string. This is a combination of " +"the :attr:`server_version` and :attr:`sys_version` attributes." msgstr "" msgid "" @@ -351,14 +364,14 @@ msgid "The *directory* parameter accepts a :term:`path-like object`." msgstr "" msgid "" -"A lot of the work, such as parsing the request, is done by the base class :" -"class:`BaseHTTPRequestHandler`. This class implements the :func:`do_GET` " -"and :func:`do_HEAD` functions." +"A lot of the work, such as parsing the request, is done by the base " +"class :class:`BaseHTTPRequestHandler`. This class implements " +"the :func:`do_GET` and :func:`do_HEAD` functions." msgstr "" msgid "" -"The following are defined as class-level attributes of :class:" -"`SimpleHTTPRequestHandler`:" +"The following are defined as class-level attributes " +"of :class:`SimpleHTTPRequestHandler`:" msgstr "" msgid "" @@ -366,6 +379,12 @@ msgid "" "defined at the module level." msgstr "" +msgid "Specifies the filenames that are treated as directory index pages." +msgstr "" + +msgid "Defaults to ``(\"index.html\", \"index.htm\")``." +msgstr "" + msgid "" "A dictionary mapping suffixes into MIME types, contains custom overrides for " "the default system mappings. The mapping is used case-insensitively, and so " @@ -393,12 +412,12 @@ msgid "" msgstr "" msgid "" -"If the request was mapped to a directory, the directory is checked for a " -"file named ``index.html`` or ``index.htm`` (in that order). If found, the " -"file's contents are returned; otherwise a directory listing is generated by " -"calling the :meth:`list_directory` method. This method uses :func:`os." -"listdir` to scan the directory, and returns a ``404`` error response if the :" -"func:`~os.listdir` fails." +"If the request was mapped to a directory, the directory is checked for an " +"index page as specified by :attr:`index_pages`. If found, the file's " +"contents are returned; otherwise a directory listing is generated by calling " +"the :meth:`list_directory` method. This method uses :func:`os.listdir` to " +"scan the directory, and returns a ``404`` error response if " +"the :func:`~os.listdir` fails." msgstr "" msgid "" @@ -419,22 +438,46 @@ 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." +"contents of the file are output." msgstr "" msgid "" -"For example usage, see the implementation of the ``test`` function in :" -"source:`Lib/http/server.py`." +"For example usage, see the implementation of the ``test`` function " +"in :source:`Lib/http/server.py`." msgstr "" msgid "Support of the ``'If-Modified-Since'`` header." msgstr "" +msgid "Helper to list the contents of *path* when no index page is present." +msgstr "" + +msgid "" +"This returns either a :term:`file-like object` (which must be closed by the " +"caller) or ``None`` to indicate an error, in which case the caller has " +"nothing further to do. In either case, the headers are sent." +msgstr "" + +msgid "Guess the type of the file at the given *path*." +msgstr "" + +msgid "" +"This returns a string of the form ``type/subtype``, usable for a MIME " +"Content-type header." +msgstr "" + +msgid "" +"The default implementation looks the file's extension up " +"in :attr:`extensions_map`, falling back to :func:`mimetypes.guess_file_type` " +"and then to ``'application/octet-stream'``." +msgstr "" + +msgid "Add :func:`mimetypes.guess_file_type` as a fallback." +msgstr "" + msgid "" -"The :class:`SimpleHTTPRequestHandler` class can be used in the following " -"manner in order to create a very basic webserver serving files relative to " -"the current directory::" +"The :class:`SimpleHTTPRequestHandler` class can be used to create a very " +"basic webserver serving files relative to the current directory as follows::" msgstr "" msgid "" @@ -453,7 +496,7 @@ msgstr "" msgid "" ":class:`SimpleHTTPRequestHandler` can also be subclassed to enhance " "behavior, such as using different index file names by overriding the class " -"attribute :attr:`index_pages`." +"attribute :attr:`~SimpleHTTPRequestHandler.index_pages`." msgstr "" msgid "" @@ -476,9 +519,10 @@ msgid "" msgstr "" msgid "" -"The :func:`do_GET` and :func:`do_HEAD` functions are modified to run CGI " -"scripts and serve the output, instead of serving files, if the request leads " -"to somewhere below the ``cgi_directories`` path." +"The :func:`~SimpleHTTPRequestHandler.do_GET` " +"and :func:`~SimpleHTTPRequestHandler.do_HEAD` functions are modified to run " +"CGI scripts and serve the output, instead of serving files, if the request " +"leads to somewhere below the ``cgi_directories`` path." msgstr "" msgid "The :class:`CGIHTTPRequestHandler` defines the following data member:" @@ -507,17 +551,17 @@ msgid "" ":class:`CGIHTTPRequestHandler` is being removed in 3.15. CGI has not been " "considered a good way to do things for well over a decade. This code has " "been unmaintained for a while now and sees very little practical use. " -"Retaining it could lead to further :ref:`security considerations `." +"Retaining it could lead to further :ref:`security considerations " +"`." msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza poleceń" msgid "" ":mod:`http.server` can also be invoked directly using the :option:`-m` " "switch of the interpreter. The following example illustrates how to serve " -"files relative to the current directory::" +"files relative to the current directory:" msgstr "" msgid "python -m http.server [OPTIONS] [port]" @@ -528,7 +572,7 @@ msgstr "" msgid "" "The server listens to port 8000 by default. The default can be overridden by " -"passing the desired port number as an argument::" +"passing the desired port number as an argument:" msgstr "" msgid "python -m http.server 9000" @@ -538,7 +582,7 @@ msgid "" "Specifies a specific address to which it should bind. Both IPv4 and IPv6 " "addresses are supported. By default, the server binds itself to all " "interfaces. For example, the following command causes the server to bind to " -"localhost only::" +"localhost only:" msgstr "" msgid "python -m http.server --bind 127.0.0.1" @@ -550,7 +594,7 @@ msgstr "" msgid "" "Specifies a directory to which it should serve the files. By default, the " "server uses the current directory. For example, the following command uses a " -"specific directory::" +"specific directory:" msgstr "" msgid "python -m http.server --directory /tmp/" @@ -559,7 +603,7 @@ msgstr "" msgid "" "Specifies the HTTP version to which the server is conformant. By default, " "the server is conformant to HTTP/1.0. For example, the following command " -"runs an HTTP/1.1 conformant server::" +"runs an HTTP/1.1 conformant server:" msgstr "" msgid "python -m http.server --protocol HTTP/1.1" @@ -567,15 +611,15 @@ msgstr "" msgid "" ":class:`CGIHTTPRequestHandler` can be enabled in the command line by passing " -"the ``--cgi`` option::" +"the ``--cgi`` option:" msgstr "" msgid "python -m http.server --cgi" msgstr "" msgid "" -":mod:`http.server` command line ``--cgi`` support is being removed because :" -"class:`CGIHTTPRequestHandler` is being removed." +":mod:`http.server` command line ``--cgi`` support is being removed " +"because :class:`CGIHTTPRequestHandler` is being removed." msgstr "" msgid "" @@ -589,16 +633,23 @@ msgstr "" msgid "" ":class:`SimpleHTTPRequestHandler` will follow symbolic links when handling " -"requests, this makes it possible for files outside of the specified " +"requests which makes it possible for files outside of the specified " "directory to be served." msgstr "" +msgid "" +"Methods :meth:`BaseHTTPRequestHandler.send_header` " +"and :meth:`BaseHTTPRequestHandler.send_response_only` assume sanitized input " +"and do not perform input validation such as checking for the presence of " +"CRLF sequences. Untrusted input may result in HTTP header injection attacks." +msgstr "" + msgid "" "Earlier versions of Python did not scrub control characters from the log " -"messages emitted to stderr from ``python -m http.server`` or the default :" -"class:`BaseHTTPRequestHandler` ``.log_message`` implementation. This could " -"allow remote clients connecting to your server to send nefarious control " -"codes to your terminal." +"messages emitted to stderr from ``python -m http.server`` or the " +"default :class:`BaseHTTPRequestHandler` ``.log_message`` implementation. " +"This could allow remote clients connecting to your server to send nefarious " +"control codes to your terminal." msgstr "" msgid "Control characters are scrubbed in stderr logs." diff --git a/library/idle.po b/library/idle.po index 3ffd7b95ff..c0ea6ef660 100644 --- a/library/idle.po +++ b/library/idle.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Stan Ulbrych, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Stan Ulbrych, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,7 +28,7 @@ msgid "IDLE --- Python editor and shell" msgstr "IDLE --- Python edytor i powłoka" msgid "**Source code:** :source:`Lib/idlelib/`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/idlelib/`" msgid "IDLE is Python's Integrated Development and Learning Environment." msgstr "" @@ -62,6 +62,15 @@ msgstr "" msgid "configuration, browsers, and other dialogs" msgstr "" +msgid "The IDLE application is implemented in the :mod:`idlelib` package." +msgstr "" + +msgid "" +"This is an optional module. If it is missing from your copy of CPython, look " +"for documentation from your distributor (that is, whoever provided Python to " +"you). If you are the distributor, see Requirements for optional modules." +msgstr "" + msgid "Menus" msgstr "" @@ -142,7 +151,7 @@ msgstr "" msgid "" "Save the current window with a Save As dialog. The file saved becomes the " -"new associated file for the window. (If your file namager is set to hide " +"new associated file for the window. (If your file manager is set to hide " "extensions, the current extension will be omitted in the file name box. If " "the new filename has no '.', '.py' and '.txt' will be added for Python and " "text files, except that on macOS Aqua,'.py' is added for all files.)" @@ -208,7 +217,7 @@ msgid "" msgstr "" msgid "Copy" -msgstr "" +msgstr "Kopiuj" msgid "Copy selection into the system-wide clipboard." msgstr "" @@ -265,8 +274,9 @@ msgid "Show Completions" msgstr "" msgid "" -"Open a scrollable list allowing selection of existing names. See :ref:" -"`Completions ` in the Editing and navigation section below." +"Open a scrollable list allowing selection of existing names. " +"See :ref:`Completions ` in the Editing and Navigation section " +"below." msgstr "" msgid "Expand Word" @@ -283,7 +293,7 @@ msgstr "" msgid "" "After an unclosed parenthesis for a function, open a small window with " "function parameter hints. See :ref:`Calltips ` in the Editing and " -"navigation section below." +"Navigation section below." msgstr "" msgid "Show Surrounding Parens" @@ -299,9 +309,9 @@ msgid "Format Paragraph" msgstr "" msgid "" -"Reformat the current blank-line-delimited paragraph in comment block or " -"multiline string or selected line in a string. All lines in the paragraph " -"will be formatted to less than N columns, where N defaults to 72." +"Rewrap the text block containing the text insert cursor. Avoid code lines. " +"See :ref:`Format block` in the Editing and Navigation section " +"below." msgstr "" msgid "Indent Region" @@ -356,12 +366,12 @@ msgid "" "community is 4 spaces." msgstr "" -msgid "Strip Trailing Chitespace" +msgid "Strip Trailing Whitespace" msgstr "" msgid "" "Remove trailing space and other whitespace characters after the last non-" -"whitespace character of a line by applying str.rstrip to each line, " +"whitespace character of a line by applying :meth:`str.rstrip` to each line, " "including lines within multiline strings. Except for Shell windows, remove " "extra newlines at the end of the file." msgstr "" @@ -733,11 +743,11 @@ msgid "" "attributes of classes or functions, or filenames. Each request method " "displays a completion box with existing names. (See tab completions below " "for an exception.) For any box, change the name being completed and the item " -"highlighted in the box by typing and deleting characters; by hitting :kbd:" -"`Up`, :kbd:`Down`, :kbd:`PageUp`, :kbd:`PageDown`, :kbd:`Home`, and :kbd:" -"`End` keys; and by a single click within the box. Close the box with :kbd:" -"`Escape`, :kbd:`Enter`, and double :kbd:`Tab` keys or clicks outside the " -"box. A double click within the box selects and closes." +"highlighted in the box by typing and deleting characters; by " +"hitting :kbd:`Up`, :kbd:`Down`, :kbd:`PageUp`, :kbd:`PageDown`, :kbd:`Home`, " +"and :kbd:`End` keys; and by a single click within the box. Close the box " +"with :kbd:`Escape`, :kbd:`Enter`, and double :kbd:`Tab` keys or clicks " +"outside the box. A double click within the box selects and closes." msgstr "" msgid "" @@ -745,20 +755,20 @@ msgid "" "interval. This defaults to 2 seconds; customize it in the settings dialog. " "(To prevent auto popups, set the delay to a large number of milliseconds, " "such as 100000000.) For imported module names or class or function " -"attributes, type '.'. For filenames in the root directory, type :data:`os." -"sep` or :data:`os.altsep` immediately after an opening quote. (On Windows, " -"one can specify a drive first.) Move into subdirectories by typing a " -"directory name and a separator." +"attributes, type '.'. For filenames in the root directory, " +"type :data:`os.sep` or :data:`os.altsep` immediately after an opening " +"quote. (On Windows, one can specify a drive first.) Move into " +"subdirectories by typing a directory name and a separator." msgstr "" msgid "" "Instead of waiting, or after a box is closed, open a completion box " -"immediately with Show Completions on the Edit menu. The default hot key is :" -"kbd:`C-space`. If one types a prefix for the desired name before opening " -"the box, the first match or near miss is made visible. The result is the " -"same as if one enters a prefix after the box is displayed. Show Completions " -"after a quote completes filenames in the current directory instead of a root " -"directory." +"immediately with Show Completions on the Edit menu. The default hot key " +"is :kbd:`C-space`. If one types a prefix for the desired name before " +"opening the box, the first match or near miss is made visible. The result is " +"the same as if one enters a prefix after the box is displayed. Show " +"Completions after a quote completes filenames in the current directory " +"instead of a root directory." msgstr "" msgid "" @@ -828,6 +838,19 @@ msgid "" "function definitions, or after opening an existing file." msgstr "" +msgid "Format block" +msgstr "" + +msgid "" +"Reformat Paragraph rewraps a block ('paragraph') of contiguous equally " +"indented non-blank comments, a similar block of text within a multiline " +"string, or a selected subset of either. If needed, add a blank line to " +"separate string from code. Partial lines in a selection expand to complete " +"lines. The resulting lines have the same indent as before but have maximum " +"total length of N columns (characters). Change the default N of 72 on the " +"Window tab of IDLE Settings." +msgstr "" + msgid "Code Context" msgstr "" @@ -859,9 +882,9 @@ msgstr "" msgid "" "Submit a single-line statement for execution by hitting :kbd:`Return` with " -"the cursor anywhere on the line. If a line is extended with Backslash (:kbd:" -"`\\\\`), the cursor must be on the last physical line. Submit a multi-line " -"compound statement by entering a blank line after the statement." +"the cursor anywhere on the line. If a line is extended with Backslash " +"(:kbd:`\\\\`), the cursor must be on the last physical line. Submit a multi-" +"line compound statement by entering a blank line after the statement." msgstr "" msgid "" @@ -914,11 +937,11 @@ msgid "" msgstr "" msgid "" -"IDLE also highlights the :ref:`soft keywords ` :keyword:" -"`match`, :keyword:`case `, and :keyword:`_ ` in " -"pattern-matching statements. However, this highlighting is not perfect and " -"will be incorrect in some rare cases, including some ``_``-s in ``case`` " -"patterns." +"IDLE also highlights the :ref:`soft keywords ` :keyword:`match`, :keyword:`case `, and :keyword:`_ " +"` in pattern-matching statements. However, this " +"highlighting is not perfect and will be incorrect in some rare cases, " +"including some ``_``-s in ``case`` patterns." msgstr "" msgid "" @@ -933,13 +956,13 @@ msgstr "" msgid "" "Upon startup with the ``-s`` option, IDLE will execute the file referenced " -"by the environment variables :envvar:`IDLESTARTUP` or :envvar:" -"`PYTHONSTARTUP`. IDLE first checks for ``IDLESTARTUP``; if ``IDLESTARTUP`` " -"is present the file referenced is run. If ``IDLESTARTUP`` is not present, " -"IDLE checks for ``PYTHONSTARTUP``. Files referenced by these environment " -"variables are convenient places to store functions that are used frequently " -"from the IDLE shell, or for executing import statements to import common " -"modules." +"by the environment variables :envvar:`IDLESTARTUP` " +"or :envvar:`PYTHONSTARTUP`. IDLE first checks for ``IDLESTARTUP``; if " +"``IDLESTARTUP`` is present the file referenced is run. If ``IDLESTARTUP`` " +"is not present, IDLE checks for ``PYTHONSTARTUP``. Files referenced by " +"these environment variables are convenient places to store functions that " +"are used frequently from the IDLE shell, or for executing import statements " +"to import common modules." msgstr "" msgid "" @@ -950,7 +973,7 @@ msgid "" "importing functions to be used from IDLE's Python shell." msgstr "" -msgid "Command line usage" +msgid "Command-line usage" msgstr "" msgid "" @@ -986,8 +1009,9 @@ msgid "Run the specified file in the shell window." msgstr "" msgid "" -"Run the startup file (as defined by the environment variables :envvar:" -"`IDLESTARTUP` or :envvar:`PYTHONSTARTUP`) before opening the shell window." +"Run the startup file (as defined by the environment " +"variables :envvar:`IDLESTARTUP` or :envvar:`PYTHONSTARTUP`) before opening " +"the shell window." msgstr "" msgid "Set the title of the shell window." @@ -1002,10 +1026,10 @@ msgid "If arguments are provided:" msgstr "" msgid "" -"If ``-``, ``-c``, or ``-r`` is used, all arguments are placed in ``sys." -"argv[1:]``, and ``sys.argv[0]`` is set to ``''``, ``'-c'``, or ``'-r'`` " -"respectively. No editor window is opened, even if that is the default set in " -"the *Options* dialog." +"If ``-``, ``-c``, or ``-r`` is used, all arguments are placed in " +"``sys.argv[1:]``, and ``sys.argv[0]`` is set to ``''``, ``'-c'``, or ``'-" +"r'`` respectively. No editor window is opened, even if that is the default " +"set in the *Options* dialog." msgstr "" msgid "" @@ -1067,8 +1091,8 @@ msgid "" msgstr "" msgid "" -"When IDLE first starts, it attempts to read user configuration files in ``~/." -"idlerc/`` (~ is one's home directory). If there is a problem, an error " +"When IDLE first starts, it attempts to read user configuration files in " +"``~/.idlerc/`` (~ is one's home directory). If there is a problem, an error " "message should be displayed. Leaving aside random disk glitches, this can " "be prevented by never editing the files by hand. Instead, use the " "configuration dialog, under Options. Once there is an error in a user " @@ -1107,8 +1131,8 @@ msgid "" "user interface process that runs the shell and editor. In the execution " "process, it replaces ``sys.stdin``, ``sys.stdout``, and ``sys.stderr`` with " "objects that get input from and send output to the Shell window. The " -"original values stored in ``sys.__stdin__``, ``sys.__stdout__``, and ``sys." -"__stderr__`` are not touched, but may be ``None``." +"original values stored in ``sys.__stdin__``, ``sys.__stdout__``, and " +"``sys.__stderr__`` are not touched, but may be ``None``." msgstr "" msgid "" @@ -1125,9 +1149,9 @@ msgstr "" msgid "" "IDLE's standard stream replacements are not inherited by subprocesses " "created in the execution process, whether directly by user code or by " -"modules such as multiprocessing. If such subprocess use ``input`` from sys." -"stdin or ``print`` or ``write`` to sys.stdout or sys.stderr, IDLE should be " -"started in a command line window. (On Windows, use ``python`` or ``py`` " +"modules such as multiprocessing. If such subprocess use ``input`` from " +"sys.stdin or ``print`` or ``write`` to sys.stdout or sys.stderr, IDLE should " +"be started in a command line window. (On Windows, use ``python`` or ``py`` " "rather than ``pythonw`` or ``pyw``.) The secondary subprocess will then be " "attached to that window for input and output." msgstr "" @@ -1162,9 +1186,9 @@ msgstr "" msgid "" "When a program outputs text, the result is determined by the corresponding " -"output device. When IDLE executes user code, ``sys.stdout`` and ``sys." -"stderr`` are connected to the display area of IDLE's Shell. Some of its " -"features are inherited from the underlying Tk Text widget. Others are " +"output device. When IDLE executes user code, ``sys.stdout`` and " +"``sys.stderr`` are connected to the display area of IDLE's Shell. Some of " +"its features are inherited from the underlying Tk Text widget. Others are " "programmed additions. Where it matters, Shell is designed for development " "rather than production runs." msgstr "" @@ -1240,13 +1264,13 @@ msgstr "" msgid "" "IDLE is intentionally different from standard Python in order to facilitate " -"development of tkinter programs. Enter ``import tkinter as tk; root = tk." -"Tk()`` in standard Python and nothing appears. Enter the same in IDLE and a " -"tk window appears. In standard Python, one must also enter ``root." -"update()`` to see the window. IDLE does the equivalent in the background, " -"about 20 times a second, which is about every 50 milliseconds. Next enter " -"``b = tk.Button(root, text='button'); b.pack()``. Again, nothing visibly " -"changes in standard Python until one enters ``root.update()``." +"development of tkinter programs. Enter ``import tkinter as tk; root = " +"tk.Tk()`` in standard Python and nothing appears. Enter the same in IDLE " +"and a tk window appears. In standard Python, one must also enter " +"``root.update()`` to see the window. IDLE does the equivalent in the " +"background, about 20 times a second, which is about every 50 milliseconds. " +"Next enter ``b = tk.Button(root, text='button'); b.pack()``. Again, nothing " +"visibly changes in standard Python until one enters ``root.update()``." msgstr "" msgid "" @@ -1372,7 +1396,7 @@ msgid "idlelib --- implementation of IDLE application" msgstr "" msgid "**Source code:** :source:`Lib/idlelib`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/idlelib`" msgid "" "The Lib/idlelib package implements the IDLE application. See the rest of " diff --git a/library/imaplib.po b/library/imaplib.po index d88309aa03..c3cec57f21 100644 --- a/library/imaplib.po +++ b/library/imaplib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,14 +27,14 @@ msgid ":mod:`!imaplib` --- IMAP4 protocol client" msgstr "" msgid "**Source code:** :source:`Lib/imaplib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/imaplib.py`" msgid "" -"This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` and :" -"class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server and " -"implement a large subset of the IMAP4rev1 client protocol as defined in :rfc:" -"`2060`. It is backward compatible with IMAP4 (:rfc:`1730`) servers, but note " -"that the ``STATUS`` command is not supported in IMAP4." +"This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` " +"and :class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server " +"and implement a large subset of the IMAP4rev1 client protocol as defined " +"in :rfc:`3501`. It is backward compatible with IMAP4 (:rfc:`1730`) servers, " +"but note that the ``STATUS`` command is not supported in IMAP4." msgstr "" msgid "Availability" @@ -62,8 +62,8 @@ msgstr "" msgid "" "The :class:`IMAP4` class supports the :keyword:`with` statement. When used " -"like this, the IMAP4 ``LOGOUT`` command is issued automatically when the :" -"keyword:`!with` statement exits. E.g.::" +"like this, the IMAP4 ``LOGOUT`` command is issued automatically when " +"the :keyword:`!with` statement exits. E.g.::" msgstr "" msgid "" @@ -115,6 +115,12 @@ msgid "" "for best practices." msgstr "" +msgid "" +"With the default *ssl_context*, the connection is encrypted but the server " +"certificate and hostname are not verified. To verify them, pass a context " +"created by :func:`ssl.create_default_context`." +msgstr "" + msgid "" "The optional *timeout* parameter specifies a timeout in seconds for the " "connection attempt. If timeout is not given or is ``None``, the global " @@ -125,8 +131,9 @@ msgid "*ssl_context* parameter was added." msgstr "" msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The class now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "The deprecated *keyfile* and *certfile* parameters have been removed." @@ -137,17 +144,17 @@ msgstr "" msgid "" "This is a subclass derived from :class:`IMAP4` that connects to the ``stdin/" -"stdout`` file descriptors created by passing *command* to ``subprocess." -"Popen()``." +"stdout`` file descriptors created by passing *command* to " +"``subprocess.Popen()``." msgstr "" msgid "The following utility functions are defined:" msgstr "" msgid "" -"Parse an IMAP4 ``INTERNALDATE`` string and return corresponding local time. " -"The return value is a :class:`time.struct_time` tuple or ``None`` if the " -"string has wrong format." +"Parse a :term:`bytes-like object` containing an IMAP4 ``INTERNALDATE`` " +"response and return the corresponding local time. The return value is " +"a :class:`time.struct_time` tuple or ``None`` if the input has wrong format." msgstr "" msgid "" @@ -155,7 +162,10 @@ msgid "" "set [``A`` .. ``P``]." msgstr "" -msgid "Converts an IMAP4 ``FLAGS`` response to a tuple of individual flags." +msgid "" +"Converts a :term:`bytes-like object` containing an IMAP4 ``FLAGS`` response " +"to a tuple of individual flags as :class:`bytes`. The return value is an " +"empty tuple if the input has wrong format." msgstr "" msgid "" @@ -164,9 +174,9 @@ msgid "" "double-quotes). The *date_time* argument can be a number (int or float) " "representing seconds since epoch (as returned by :func:`time.time`), a 9-" "tuple representing local time an instance of :class:`time.struct_time` (as " -"returned by :func:`time.localtime`), an aware instance of :class:`datetime." -"datetime`, or a double-quoted string. In the last case, it is assumed to " -"already be in the correct format." +"returned by :func:`time.localtime`), an aware instance " +"of :class:`datetime.datetime`, or a double-quoted string. In the last case, " +"it is assumed to already be in the correct format." msgstr "" msgid "" @@ -203,7 +213,10 @@ msgid "" "string is quoted. However, the *password* argument to the ``LOGIN`` command " "is always quoted. If you want to avoid having an argument string quoted (eg: " "the *flags* argument to ``STORE``) then enclose the string in parentheses " -"(eg: ``r'(\\Deleted)'``)." +"(eg: ``r'(\\Deleted)'``). In general, pass arguments unquoted and let the " +"module quote them as needed. An argument that is already enclosed in double " +"quotes is left unchanged, so that code which quotes arguments itself keeps " +"working." msgstr "" msgid "" @@ -228,6 +241,12 @@ msgstr "" msgid "Append *message* to named mailbox." msgstr "" +msgid "" +"*flags* may be ``None`` or a string of IMAP flag tokens. Multiple flags are " +"separated by spaces, for example ``r'\\Seen \\Answered'``. If *flags* is not " +"already enclosed in parentheses, parentheses are added automatically." +msgstr "" + msgid "Authenticate command --- requires response processing." msgstr "" @@ -277,8 +296,8 @@ msgstr "" msgid "" "Enable *capability* (see :rfc:`5161`). Most capabilities do not need to be " -"enabled. Currently only the ``UTF8=ACCEPT`` capability is supported (see :" -"RFC:`6855`)." +"enabled. Currently only the ``UTF8=ACCEPT`` capability is supported " +"(see :RFC:`6855`)." msgstr "" msgid "The :meth:`enable` method itself, and :RFC:`6855` support." @@ -333,6 +352,9 @@ msgid "" "includes the phrase ``AUTH=CRAM-MD5``." msgstr "" +msgid "An :exc:`IMAP4.error` is raised if MD5 support is not available." +msgstr "" + msgid "Shutdown connection to server. Returns server ``BYE`` response." msgstr "" @@ -358,12 +380,12 @@ msgid "" "Opens socket to *port* at *host*. The optional *timeout* parameter specifies " "a timeout in seconds for the connection attempt. If timeout is not given or " "is ``None``, the global default socket timeout is used. Also note that if " -"the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to reject creating a non-blocking socket. This method is " -"implicitly called by the :class:`IMAP4` constructor. The connection objects " -"established by this method will be used in the :meth:`IMAP4.read`, :meth:" -"`IMAP4.readline`, :meth:`IMAP4.send`, and :meth:`IMAP4.shutdown` methods. " -"You may override this method." +"the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to reject creating a non-blocking socket. This method " +"is implicitly called by the :class:`IMAP4` constructor. The connection " +"objects established by this method will be used in " +"the :meth:`IMAP4.read`, :meth:`IMAP4.readline`, :meth:`IMAP4.send`, " +"and :meth:`IMAP4.shutdown` methods. You may override this method." msgstr "" msgid "" @@ -409,8 +431,8 @@ msgid "" "case no ``CHARSET`` will be specified in the request to the server. The " "IMAP protocol requires that at least one criterion be specified; an " "exception will be raised when the server returns an error. *charset* must " -"be ``None`` if the ``UTF8=ACCEPT`` capability was enabled using the :meth:" -"`enable` command." +"be ``None`` if the ``UTF8=ACCEPT`` capability was enabled using " +"the :meth:`enable` command." msgstr "" msgid "Example::" @@ -488,8 +510,9 @@ msgid "" msgstr "" msgid "" -"The method now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The method now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "Request named status conditions for *mailbox*." @@ -497,7 +520,7 @@ msgstr "" msgid "" "Alters flag dispositions for messages in mailbox. *command* is specified by " -"section 6.4.6 of :rfc:`2060` as being one of \"FLAGS\", \"+FLAGS\", or \"-" +"section 6.4.6 of :rfc:`3501` as being one of \"FLAGS\", \"+FLAGS\", or \"-" "FLAGS\", optionally with a suffix of \".SILENT\"." msgstr "" @@ -514,10 +537,10 @@ msgstr "" msgid "" "Creating flags containing ']' (for example: \"[test]\") violates :rfc:`3501` " "(the IMAP protocol). However, imaplib has historically allowed creation of " -"such tags, and popular IMAP servers, such as Gmail, accept and produce such " -"flags. There are non-Python programs which also create such tags. Although " -"it is an RFC violation and IMAP clients and servers are supposed to be " -"strict, imaplib still continues to allow such tags to be created for " +"such flags, and popular IMAP servers, such as Gmail, accept and produce such " +"flags. There are non-Python programs which also create such flags. " +"Although it is an RFC violation and IMAP clients and servers are supposed to " +"be strict, imaplib still continues to allow such flags to be created for " "backward compatibility reasons, and as of Python 3.6, handles them if they " "are sent from the server, since this improves real-world compatibility." msgstr "" @@ -573,6 +596,19 @@ msgstr "" msgid "The following attributes are defined on instances of :class:`IMAP4`:" msgstr "" +msgid "A tuple of the capabilities advertised by the server, in upper case." +msgstr "" + +msgid "" +"It is set when the connection is established, and refreshed after a " +"successful :meth:`~IMAP4.login`, :meth:`~IMAP4.authenticate` " +"or :meth:`~IMAP4.starttls`, because the server can advertise different " +"capabilities in different connection states." +msgstr "" + +msgid "Refreshed after :meth:`~IMAP4.login` and :meth:`~IMAP4.authenticate`." +msgstr "" + msgid "" "The most recent supported protocol in the ``CAPABILITY`` response from the " "server." @@ -585,8 +621,9 @@ msgid "" msgstr "" msgid "" -"Boolean value that is normally ``False``, but is set to ``True`` if an :meth:" -"`enable` command is successfully issued for the ``UTF8=ACCEPT`` capability." +"Boolean value that is normally ``False``, but is set to ``True`` if " +"an :meth:`enable` command is successfully issued for the ``UTF8=ACCEPT`` " +"capability." msgstr "" msgid "IMAP4 Example" @@ -611,6 +648,12 @@ msgid "" "M.logout()" msgstr "" +msgid "" +"A ``FETCH`` response may contain additional or unsolicited data " +"(see :rfc:`3501`, section 7.4.2), so production code should inspect the " +"whole response rather than rely on ``data[0][1]``." +msgstr "" + msgid "IMAP4" msgstr "" diff --git a/library/importlib.metadata.po b/library/importlib.metadata.po index cd515f3728..4ab722a6c7 100644 --- a/library/importlib.metadata.po +++ b/library/importlib.metadata.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,7 +30,7 @@ msgid "``importlib.metadata`` is no longer provisional." msgstr "" msgid "**Source code:** :source:`Lib/importlib/metadata/__init__.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/importlib/metadata/__init__.py`" msgid "" "``importlib.metadata`` is a library that provides access to the metadata of " @@ -39,18 +38,17 @@ msgid "" "glossary/#term-Distribution-Package>`_, such as its entry points or its top-" "level names (`Import Package `_\\s, modules, if any). Built in part on " -"Python's import system, this library intends to replace similar " -"functionality in the `entry point API`_ and `metadata API`_ of " -"``pkg_resources``. Along with :mod:`importlib.resources`, this package can " -"eliminate the need to use the older and less efficient ``pkg_resources`` " -"package." +"Python's import system, this library provides the entry point and metadata " +"APIs that were previously exposed by the now-removed ``pkg_resources`` " +"package. Along with :mod:`importlib.resources`, it supersedes " +"``pkg_resources``." msgstr "" msgid "" "``importlib.metadata`` operates on third-party *distribution packages* " -"installed into Python's ``site-packages`` directory via tools such as :pypi:" -"`pip`. Specifically, it works with distributions with discoverable ``dist-" -"info`` or ``egg-info`` directories, and metadata defined by the `Core " +"installed into Python's ``site-packages`` directory via tools such " +"as :pypi:`pip`. Specifically, it works with distributions with discoverable " +"``dist-info`` or ``egg-info`` directories, and metadata defined by the `Core " "metadata specifications `_." msgstr "" @@ -60,9 +58,9 @@ msgid "" "level *import package* names that can be imported inside Python code. One " "*distribution package* can contain multiple *import packages* (and single " "modules), and one top-level *import package* may map to multiple " -"*distribution packages* if it is a namespace package. You can use :ref:" -"`packages_distributions() ` to get a mapping between " -"them." +"*distribution packages* if it is a namespace package. You can " +"use :ref:`packages_distributions() ` to get a mapping " +"between them." msgstr "" msgid "" @@ -78,8 +76,8 @@ msgid "" "The documentation for ``importlib_metadata``, which supplies a backport of " "``importlib.metadata``. This includes an `API reference `__ for this module's classes and " -"functions, as well as a `migration guide `__ for existing users of " +"functions, as well as a `migration guide `__ for existing users of " "``pkg_resources``." msgstr "" @@ -112,14 +110,15 @@ msgstr "" msgid "" "You can also get a collection of entry points selectable by properties of " "the EntryPoint (typically 'group' or 'name'), such as ``console_scripts``, " -"``distutils.commands`` and others. Each group contains a collection of :ref:" -"`EntryPoint ` objects." +"``distutils.commands`` and others. Each group contains a collection " +"of :ref:`EntryPoint ` objects." msgstr "" msgid "You can get the :ref:`metadata for a distribution `::" msgstr "" msgid "" +">>> from importlib.metadata import metadata\n" ">>> list(metadata('wheel'))\n" "['Metadata-Version', 'Name', 'Version', 'Summary', 'Home-page', 'Author', " "'Author-email', 'Maintainer', 'Maintainer-email', 'License', 'Project-URL', " @@ -131,9 +130,9 @@ msgid "" msgstr "" msgid "" -"You can also get a :ref:`distribution's version number `, list its :" -"ref:`constituent files `, and get a list of the distribution's :ref:" -"`requirements`." +"You can also get a :ref:`distribution's version number `, list " +"its :ref:`constituent files `, and get a list of the " +"distribution's :ref:`requirements`." msgstr "" msgid "" @@ -159,10 +158,10 @@ msgid "" msgstr "" msgid "" -"Note: it is not currently possible to query for entry points based on their :" -"attr:`!EntryPoint.dist` attribute (as different :class:`!Distribution` " -"instances do not currently compare equal, even if they have the same " -"attributes)" +"Note: it is not currently possible to query for entry points based on " +"their :attr:`!EntryPoint.dist` attribute (as different :class:`!" +"Distribution` instances do not currently compare equal, even if they have " +"the same attributes)" msgstr "" msgid "Details of a collection of installed entry points." @@ -179,10 +178,10 @@ msgstr "" msgid "" "Each :class:`!EntryPoint` instance has ``.name``, ``.group``, and ``.value`` " -"attributes and a ``.load()`` method to resolve the value. There are also ``." -"module``, ``.attr``, and ``.extras`` attributes for getting the components " -"of the ``.value`` attribute, and ``.dist`` for obtaining information " -"regarding the distribution package that provides the entry point." +"attributes and a ``.load()`` method to resolve the value. There are also " +"``.module``, ``.attr``, and ``.extras`` attributes for getting the " +"components of the ``.value`` attribute, and ``.dist`` for obtaining " +"information regarding the distribution package that provides the entry point." msgstr "" msgid "Query all entry points::" @@ -268,13 +267,13 @@ msgid "" "3.6 and Python 3.10. Prior to those changes, ``entry_points`` accepted no " "parameters and always returned a dictionary of entry points, keyed by group. " "With ``importlib_metadata`` 5.0 and Python 3.12, ``entry_points`` always " -"returns an ``EntryPoints`` object. See :pypi:`backports." -"entry_points_selectable` for compatibility options." +"returns an ``EntryPoints`` object. " +"See :pypi:`backports.entry_points_selectable` for compatibility options." msgstr "" msgid "" -"``EntryPoint`` objects no longer present a tuple-like interface (:meth:" -"`~object.__getitem__`)." +"``EntryPoint`` objects no longer present a tuple-like interface " +"(:meth:`~object.__getitem__`)." msgstr "" msgid "Distribution metadata" @@ -292,8 +291,8 @@ msgstr "" msgid "" "A concrete implementation of the `PackageMetadata protocol `_." +"importlib-metadata.readthedocs.io/en/latest/" +"api.html#importlib_metadata.PackageMetadata>`_." msgstr "" msgid "" @@ -350,9 +349,9 @@ msgid "Distribution versions" msgstr "" msgid "" -"Return the installed distribution package `version `__ for the named " -"distribution package." +"Return the installed distribution package `version `__ for " +"the named distribution package." msgstr "" msgid "" @@ -386,10 +385,10 @@ msgid "" msgstr "" msgid "" -"The :func:`!files` function takes a `Distribution Package `_ name and returns " -"all of the files installed by this distribution. Each file is reported as a :" -"class:`PackagePath` instance. For example::" +"The :func:`!files` function takes a `Distribution Package `_ name " +"and returns all of the files installed by this distribution. Each file is " +"reported as a :class:`PackagePath` instance. For example::" msgstr "" msgid "" @@ -429,12 +428,13 @@ msgid "" msgstr "" msgid "" -"In the case where the metadata file listing files (``RECORD`` or ``SOURCES." -"txt``) is missing, :func:`!files` will return :const:`None`. The caller may " -"wish to wrap calls to :func:`!files` in `always_iterable `_ or otherwise guard against this condition if the target " -"distribution is not known to have the metadata present." +"In the case where the metadata file listing files (``RECORD`` or " +"``SOURCES.txt``) is missing, :func:`!files` will return :const:`None`. The " +"caller may wish to wrap calls to :func:`!files` in `always_iterable `_ or otherwise guard against this " +"condition if the target distribution is not known to have the metadata " +"present." msgstr "" msgid "Distribution requirements" @@ -471,11 +471,11 @@ msgid "" msgstr "" msgid "" -"A convenience method to resolve the `Distribution Package `_ name (or names, " -"in the case of a namespace package) that provide each importable top-level " -"Python module or `Import Package `_::" +"A convenience method to resolve the `Distribution Package `_ name " +"(or names, in the case of a namespace package) that provide each importable " +"top-level Python module or `Import Package `_::" msgstr "" msgid "" @@ -515,9 +515,9 @@ msgid "" "usage, you can get all of that information from the :class:`!Distribution` " "class. :class:`!Distribution` is an abstract object that represents the " "metadata for a Python `Distribution Package `_. You can get the concrete :" -"class:`!Distribution` subclass instance for an installed distribution " -"package by calling the :func:`distribution` function::" +"latest/glossary/#term-Distribution-Package>`_. You can get the " +"concrete :class:`!Distribution` subclass instance for an installed " +"distribution package by calling the :func:`distribution` function::" msgstr "" msgid "" @@ -569,10 +569,11 @@ msgstr "" msgid "" "By default, this package provides built-in support for discovery of metadata " -"for file system and zip file `Distribution Package `_\\s. This metadata " -"finder search defaults to ``sys.path``, but varies slightly in how it " -"interprets those values from how other import machinery does. In particular:" +"for file system and zip file `Distribution Package `_\\s. " +"This metadata finder search defaults to ``sys.path``, but varies slightly in " +"how it interprets those values from how other import machinery does. In " +"particular:" msgstr "" msgid "" @@ -589,12 +590,12 @@ msgstr "" msgid "" "Because `Distribution Package `_ metadata is not available through :" -"data:`sys.path` searches, or package loaders directly, the metadata for a " -"distribution is found through import system :ref:`finders `. To find a distribution package's metadata, ``importlib." -"metadata`` queries the list of :term:`meta path finders ` " -"on :data:`sys.meta_path`." +"glossary/#term-Distribution-Package>`_ metadata is not available " +"through :data:`sys.path` searches, or package loaders directly, the metadata " +"for a distribution is found through import system :ref:`finders `. To find a distribution package's metadata, " +"``importlib.metadata`` queries the list of :term:`meta path finders ` on :data:`sys.meta_path`." msgstr "" msgid "" @@ -605,8 +606,8 @@ msgstr "" msgid "" "The abstract class :py:class:`importlib.abc.MetaPathFinder` defines the " -"interface expected of finders by Python's import system. ``importlib." -"metadata`` extends this protocol by looking for an optional " +"interface expected of finders by Python's import system. " +"``importlib.metadata`` extends this protocol by looking for an optional " "``find_distributions`` callable on the finders from :data:`sys.meta_path` " "and presents this extended interface as the ``DistributionFinder`` abstract " "base class, which defines this abstract method::" diff --git a/library/importlib.po b/library/importlib.po index 156f554ebc..7efdeb98c9 100644 --- a/library/importlib.po +++ b/library/importlib.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,7 +27,7 @@ msgid ":mod:`!importlib` --- The implementation of :keyword:`!import`" msgstr "" msgid "**Source code:** :source:`Lib/importlib/__init__.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/importlib/__init__.py`" msgid "Introduction" msgstr "Wprowadzenie" @@ -81,8 +79,8 @@ msgstr "" msgid "" "Original specification of packages. Some semantics have changed since the " -"writing of this document (e.g. redirecting based on ``None`` in :data:`sys." -"modules`)." +"writing of this document (e.g. redirecting based on ``None`` " +"in :data:`sys.modules`)." msgstr "" msgid "The :func:`.__import__` function" @@ -190,11 +188,11 @@ msgid "" msgstr "" msgid "" -"The :func:`import_module` function acts as a simplifying wrapper around :" -"func:`importlib.__import__`. This means all semantics of the function are " -"derived from :func:`importlib.__import__`. The most important difference " -"between these two functions is that :func:`import_module` returns the " -"specified package or module (e.g. ``pkg.mod``), while :func:`__import__` " +"The :func:`import_module` function acts as a simplifying wrapper " +"around :func:`importlib.__import__`. This means all semantics of the " +"function are derived from :func:`importlib.__import__`. The most important " +"difference between these two functions is that :func:`import_module` returns " +"the specified package or module (e.g. ``pkg.mod``), while :func:`__import__` " "returns the top-level package or module (e.g. ``pkg``)." msgstr "" @@ -287,11 +285,11 @@ msgid "" msgstr "" msgid "" -"If a module imports objects from another module using :keyword:`from` ... :" -"keyword:`import` ..., calling :func:`reload` for the other module does not " -"redefine the objects imported from it --- one way around this is to re-" -"execute the :keyword:`!from` statement, another is to use :keyword:`!import` " -"and qualified names (*module.name*) instead." +"If a module imports objects from another module " +"using :keyword:`from` ... :keyword:`import` ..., calling :func:`reload` for " +"the other module does not redefine the objects imported from it --- one way " +"around this is to re-execute the :keyword:`!from` statement, another is to " +"use :keyword:`!import` and qualified names (*module.name*) instead." msgstr "" msgid "" @@ -302,15 +300,22 @@ msgid "" msgstr "" msgid "" -":exc:`ModuleNotFoundError` is raised when the module being reloaded lacks a :" -"class:`~importlib.machinery.ModuleSpec`." +":exc:`ModuleNotFoundError` is raised when the module being reloaded lacks " +"a :class:`~importlib.machinery.ModuleSpec`." +msgstr "" + +msgid "" +"This function is not thread-safe. Calling it from multiple threads can " +"result in unexpected behavior. It's recommended to use " +"the :class:`threading.Lock` or other synchronization primitives for thread-" +"safe module reloading." msgstr "" msgid ":mod:`importlib.abc` -- Abstract base classes related to import" msgstr "" msgid "**Source code:** :source:`Lib/importlib/abc.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/importlib/abc.py`" msgid "" "The :mod:`importlib.abc` module contains all of the core abstract base " @@ -362,24 +367,25 @@ msgstr "" msgid "" "An abstract base class representing a :term:`path entry finder`. Though it " "bears some similarities to :class:`MetaPathFinder`, ``PathEntryFinder`` is " -"meant for use only within the path-based import subsystem provided by :class:" -"`importlib.machinery.PathFinder`." +"meant for use only within the path-based import subsystem provided " +"by :class:`importlib.machinery.PathFinder`." msgstr "" msgid "" "An abstract method for finding a :term:`spec ` for the " -"specified module. The finder will search for the module only within the :" -"term:`path entry` to which it is assigned. If a spec cannot be found, " +"specified module. The finder will search for the module only within " +"the :term:`path entry` to which it is assigned. If a spec cannot be found, " "``None`` is returned. When passed in, ``target`` is a module object that " -"the finder may use to make a more educated guess about what spec to return. :" -"func:`importlib.util.spec_from_loader` may be useful for implementing " -"concrete ``PathEntryFinders``." +"the finder may use to make a more educated guess about what spec to " +"return. :func:`importlib.util.spec_from_loader` may be useful for " +"implementing concrete ``PathEntryFinders``." msgstr "" msgid "" "An optional method which, when called, should invalidate any internal cache " -"used by the finder. Used by :meth:`importlib.machinery.PathFinder." -"invalidate_caches` when invalidating the caches of all cached finders." +"used by the finder. Used " +"by :meth:`importlib.machinery.PathFinder.invalidate_caches` when " +"invalidating the caches of all cached finders." msgstr "" msgid "" @@ -388,12 +394,12 @@ msgid "" msgstr "" msgid "" -"Loaders that wish to support resource reading should implement a :meth:" -"`get_resource_reader` method as specified by :class:`importlib.resources.abc." -"ResourceReader`." +"Loaders that wish to support resource reading should implement a :meth:`!" +"get_resource_reader` method as specified " +"by :class:`importlib.resources.abc.ResourceReader`." msgstr "" -msgid "Introduced the optional :meth:`get_resource_reader` method." +msgid "Introduced the optional :meth:`!get_resource_reader` method." msgstr "" msgid "" @@ -408,16 +414,17 @@ msgstr "" msgid "" "An abstract method that executes the module in its own namespace when a " "module is imported or reloaded. The module should already be initialized " -"when :meth:`exec_module` is called. When this method exists, :meth:" -"`create_module` must be defined." +"when :meth:`exec_module` is called. When this method " +"exists, :meth:`create_module` must be defined." msgstr "" msgid ":meth:`create_module` must also be defined." msgstr "" msgid "" -"A legacy method for loading a module. If the module cannot be loaded, :exc:" -"`ImportError` is raised, otherwise the loaded module is returned." +"A legacy method for loading a module. If the module cannot be " +"loaded, :exc:`ImportError` is raised, otherwise the loaded module is " +"returned." msgstr "" msgid "" @@ -464,9 +471,9 @@ msgid "" msgstr "" msgid "" -"The recommended API for loading a module is :meth:`exec_module` (and :meth:" -"`create_module`). Loaders should implement it instead of :meth:" -"`load_module`. The import machinery takes care of all the other " +"The recommended API for loading a module is :meth:`exec_module` " +"(and :meth:`create_module`). Loaders should implement it instead " +"of :meth:`load_module`. The import machinery takes care of all the other " "responsibilities of :meth:`load_module` when :meth:`exec_module` is " "implemented." msgstr "" @@ -475,13 +482,14 @@ msgid "*Superseded by TraversableResources*" msgstr "" msgid "" -"An abstract base class for a :term:`loader` which implements the optional :" -"pep:`302` protocol for loading arbitrary resources from the storage back-end." +"An abstract base class for a :term:`loader` which implements the " +"optional :pep:`302` protocol for loading arbitrary resources from the " +"storage back-end." msgstr "" msgid "" -"This ABC is deprecated in favour of supporting resource loading through :" -"class:`importlib.resources.abc.TraversableResources`." +"This ABC is deprecated in favour of supporting resource loading " +"through :class:`importlib.resources.abc.TraversableResources`." msgstr "" msgid "" @@ -489,16 +497,17 @@ msgid "" "Loaders that have a file-like storage back-end that allows storing arbitrary " "data can implement this abstract method to give direct access to the data " "stored. :exc:`OSError` is to be raised if the *path* cannot be found. The " -"*path* is expected to be constructed using a module's :attr:`~module." -"__file__` attribute or an item from a package's :attr:`~module.__path__`." +"*path* is expected to be constructed using a " +"module's :attr:`~module.__file__` attribute or an item from a " +"package's :attr:`~module.__path__`." msgstr "" msgid "Raises :exc:`OSError` instead of :exc:`NotImplementedError`." msgstr "" msgid "" -"An abstract base class for a :term:`loader` which implements the optional :" -"pep:`302` protocol for loaders that inspect modules." +"An abstract base class for a :term:`loader` which implements the " +"optional :pep:`302` protocol for loaders that inspect modules." msgstr "" msgid "" @@ -536,10 +545,10 @@ msgid "Create a code object from Python source." msgstr "" msgid "" -"The *data* argument can be whatever the :func:`compile` function supports (i." -"e. string or bytes). The *path* argument should be the \"path\" to where the " -"source code originated from, which can be an abstract concept (e.g. location " -"in a zip file)." +"The *data* argument can be whatever the :func:`compile` function supports " +"(i.e. string or bytes). The *path* argument should be the \"path\" to where " +"the source code originated from, which can be an abstract concept (e.g. " +"location in a zip file)." msgstr "" msgid "" @@ -577,9 +586,9 @@ msgid "" msgstr "" msgid "" -"An abstract base class which inherits from :class:`ResourceLoader` and :" -"class:`ExecutionLoader`, providing concrete implementations of :meth:" -"`ResourceLoader.get_data` and :meth:`ExecutionLoader.get_filename`." +"An abstract base class which inherits from :class:`ResourceLoader` " +"and :class:`ExecutionLoader`, providing concrete implementations " +"of :meth:`ResourceLoader.get_data` and :meth:`ExecutionLoader.get_filename`." msgstr "" msgid "" @@ -607,8 +616,8 @@ msgstr "" msgid "" "An abstract base class for implementing source (and optionally bytecode) " -"file loading. The class inherits from both :class:`ResourceLoader` and :" -"class:`ExecutionLoader`, requiring the implementation of:" +"file loading. The class inherits from both :class:`ResourceLoader` " +"and :class:`ExecutionLoader`, requiring the implementation of:" msgstr "" msgid ":meth:`ResourceLoader.get_data`" @@ -624,9 +633,9 @@ msgstr "" msgid "" "The abstract methods defined by this class are to add optional bytecode file " -"support. Not implementing these optional methods (or causing them to raise :" -"exc:`NotImplementedError`) causes the loader to only work with source code. " -"Implementing the methods allows the loader to work with source *and* " +"support. Not implementing these optional methods (or causing them to " +"raise :exc:`NotImplementedError`) causes the loader to only work with source " +"code. Implementing the methods allows the loader to work with source *and* " "bytecode files; it does not allow for *sourceless* loading where only " "bytecode is provided. Bytecode files are an optimization to speed up " "loading by removing the parsing step of Python's compiler, and so no " @@ -672,8 +681,9 @@ msgid "" msgstr "" msgid "" -"When writing to the path fails because the path is read-only (:const:`errno." -"EACCES`/:exc:`PermissionError`), do not propagate the exception." +"When writing to the path fails because the path is read-only " +"(:const:`errno.EACCES`/:exc:`PermissionError`), do not propagate the " +"exception." msgstr "" msgid "No longer raises :exc:`NotImplementedError` when called." @@ -696,9 +706,9 @@ msgstr "" msgid "" "Concrete implementation of :meth:`InspectLoader.is_package`. A module is " -"determined to be a package if its file path (as provided by :meth:" -"`ExecutionLoader.get_filename`) is a file named ``__init__`` when the file " -"extension is removed **and** the module name itself does not end in " +"determined to be a package if its file path (as provided " +"by :meth:`ExecutionLoader.get_filename`) is a file named ``__init__`` when " +"the file extension is removed **and** the module name itself does not end in " "``__init__``." msgstr "" @@ -716,9 +726,9 @@ msgid "" msgstr "" msgid "" -"For any of methods of this class, a *resource* argument is expected to be a :" -"term:`path-like object` which represents conceptually just a file name. This " -"means that no subdirectory paths should be included in the *resource* " +"For any of methods of this class, a *resource* argument is expected to be " +"a :term:`path-like object` which represents conceptually just a file name. " +"This means that no subdirectory paths should be included in the *resource* " "argument. This is because the location of the package the reader is for, " "acts as the \"directory\". Hence the metaphor for directories and file names " "is packages and resources, respectively. This is also why instances of this " @@ -749,20 +759,20 @@ msgid "Returns the file system path to the *resource*." msgstr "" msgid "" -"If the resource does not concretely exist on the file system, raise :exc:" -"`FileNotFoundError`." +"If the resource does not concretely exist on the file system, " +"raise :exc:`FileNotFoundError`." msgstr "" msgid "" -"Returns ``True`` if the named *name* is considered a resource. :exc:" -"`FileNotFoundError` is raised if *name* does not exist." +"Returns ``True`` if the named *name* is considered a " +"resource. :exc:`FileNotFoundError` is raised if *name* does not exist." msgstr "" msgid "" "Returns an :term:`iterable` of strings over the contents of the package. Do " "note that it is not required that all names returned by the iterator be " -"actual resources, e.g. it is acceptable to return names for which :meth:" -"`is_resource` would be false." +"actual resources, e.g. it is acceptable to return names for " +"which :meth:`is_resource` would be false." msgstr "" msgid "" @@ -782,8 +792,8 @@ msgid "" msgstr "" msgid "" -"For a representation of the object on the file-system, use :meth:`importlib." -"resources.as_file`." +"For a representation of the object on the file-system, " +"use :meth:`importlib.resources.as_file`." msgstr "" msgid "Use :class:`importlib.resources.abc.Traversable` instead." @@ -813,8 +823,8 @@ msgid "" msgstr "" msgid "" -"When opening as text, accepts encoding parameters such as those accepted by :" -"class:`io.TextIOWrapper`." +"When opening as text, accepts encoding parameters such as those accepted " +"by :class:`io.TextIOWrapper`." msgstr "" msgid "Read contents of ``self`` as bytes." @@ -824,10 +834,11 @@ 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. " +"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 "" @@ -846,7 +857,7 @@ msgid ":mod:`importlib.machinery` -- Importers and path hooks" msgstr "" msgid "**Source code:** :source:`Lib/importlib/machinery.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/importlib/machinery.py`" msgid "" "This module contains the various objects that help :keyword:`import` find " @@ -888,14 +899,15 @@ msgid "" "Returns a combined list of strings representing all file suffixes for " "modules recognized by the standard import machinery. This is a helper for " "code which simply needs to know if a filesystem path potentially refers to a " -"module without needing any details on the kind of module (for example, :func:" -"`inspect.getmodulename`)." +"module without needing any details on the kind of module (for " +"example, :func:`inspect.getmodulename`)." msgstr "" msgid "" "An :term:`importer` for built-in modules. All known built-in modules are " -"listed in :data:`sys.builtin_module_names`. This class implements the :class:" -"`importlib.abc.MetaPathFinder` and :class:`importlib.abc.InspectLoader` ABCs." +"listed in :data:`sys.builtin_module_names`. This class implements " +"the :class:`importlib.abc.MetaPathFinder` " +"and :class:`importlib.abc.InspectLoader` ABCs." msgstr "" msgid "" @@ -904,17 +916,20 @@ msgid "" msgstr "" msgid "" -"As part of :pep:`489`, the builtin importer now implements :meth:`Loader." -"create_module` and :meth:`Loader.exec_module`" +"As part of :pep:`489`, the builtin importer now " +"implements :meth:`Loader.create_module ` " +"and :meth:`Loader.exec_module `" msgstr "" msgid "" -"An :term:`importer` for frozen modules. This class implements the :class:" -"`importlib.abc.MetaPathFinder` and :class:`importlib.abc.InspectLoader` ABCs." +"An :term:`importer` for frozen modules. This class implements " +"the :class:`importlib.abc.MetaPathFinder` " +"and :class:`importlib.abc.InspectLoader` ABCs." msgstr "" msgid "" -"Gained :meth:`~Loader.create_module` and :meth:`~Loader.exec_module` methods." +"Gained :meth:`~importlib.abc.Loader.create_module` " +"and :meth:`~importlib.abc.Loader.exec_module` methods." msgstr "" msgid "" @@ -936,20 +951,21 @@ msgstr "" msgid "" "Class method that attempts to find a :term:`spec ` for the " "module specified by *fullname* on :data:`sys.path` or, if defined, on " -"*path*. For each path entry that is searched, :data:`sys." -"path_importer_cache` is checked. If a non-false object is found then it is " -"used as the :term:`path entry finder` to look for the module being searched " -"for. If no entry is found in :data:`sys.path_importer_cache`, then :data:" -"`sys.path_hooks` is searched for a finder for the path entry and, if found, " -"is stored in :data:`sys.path_importer_cache` along with being queried about " -"the module. If no finder is ever found then ``None`` is both stored in the " -"cache and returned." +"*path*. For each path entry that is " +"searched, :data:`sys.path_importer_cache` is checked. If a non-false object " +"is found then it is used as the :term:`path entry finder` to look for the " +"module being searched for. If no entry is found " +"in :data:`sys.path_importer_cache`, then :data:`sys.path_hooks` is searched " +"for a finder for the path entry and, if found, is stored " +"in :data:`sys.path_importer_cache` along with being queried about the " +"module. If no finder is ever found then ``None`` is both stored in the cache " +"and returned." msgstr "" msgid "" "If the current working directory -- represented by an empty string -- is no " -"longer valid then ``None`` is returned but no value is cached in :data:`sys." -"path_importer_cache`." +"longer valid then ``None`` is returned but no value is cached " +"in :data:`sys.path_importer_cache`." msgstr "" msgid "" @@ -1011,8 +1027,8 @@ msgid "" msgstr "" msgid "" -"If the argument to the closure is not an existing directory, :exc:" -"`ImportError` is raised." +"If the argument to the closure is not an existing " +"directory, :exc:`ImportError` is raised." msgstr "" msgid "" @@ -1098,8 +1114,8 @@ msgid "Path to the extension module." msgstr "" msgid "" -"Creates the module object from the given specification in accordance with :" -"pep:`489`." +"Creates the module object from the given specification in accordance " +"with :pep:`489`." msgstr "" msgid "Initializes the given module object in accordance with :pep:`489`." @@ -1140,13 +1156,13 @@ msgid "" "the *values* are usually equivalent, they can differ since there is no " "synchronization between the two objects. For example, it is possible to " "update the module's :attr:`~module.__file__` at runtime and this will not be " -"automatically reflected in the module's :attr:`__spec__.origin `, and vice versa." +"automatically reflected in the module's :attr:`__spec__.origin " +"`, and vice versa." msgstr "" msgid "" -"The module's fully qualified name (see :attr:`module.__name__`). The :term:" -"`finder` should always set this attribute to a non-empty string." +"The module's fully qualified name (see :attr:`module.__name__`). " +"The :term:`finder` should always set this attribute to a non-empty string." msgstr "" msgid "" @@ -1155,11 +1171,12 @@ msgid "" msgstr "" msgid "" -"The location the :term:`loader` should use to load the module (see :attr:" -"`module.__file__`). For example, for modules loaded from a ``.py`` file this " -"is the filename. The :term:`finder` should always set this attribute to a " -"meaningful value for the :term:`loader` to use. In the uncommon case that " -"there is not one (like for namespace packages), it should be set to ``None``." +"The location the :term:`loader` should use to load the module " +"(see :attr:`module.__file__`). For example, for modules loaded from a " +"``.py`` file this is the filename. The :term:`finder` should always set this " +"attribute to a meaningful value for the :term:`loader` to use. In the " +"uncommon case that there is not one (like for namespace packages), it should " +"be set to ``None``." msgstr "" msgid "" @@ -1182,9 +1199,10 @@ msgid "" msgstr "" msgid "" -"The filename of a compiled version of the module's code (see :attr:`module." -"__cached__`). The :term:`finder` should always set this attribute but it may " -"be ``None`` for modules that do not need compiled code stored." +"The filename of a compiled version of the module's code " +"(see :attr:`module.__cached__`). The :term:`finder` should always set this " +"attribute but it may be ``None`` for modules that do not need compiled code " +"stored." msgstr "" msgid "" @@ -1216,28 +1234,28 @@ msgid "" "To accommodate this requirement, when running on iOS, extension module " "binaries are *not* packaged as ``.so`` files on ``sys.path``, but as " "individual standalone frameworks. To discover those frameworks, this loader " -"is be registered against the ``.fwork`` file extension, with a ``.fwork`` " -"file acting as a placeholder in the original location of the binary on ``sys." -"path``. The ``.fwork`` file contains the path of the actual binary in the " -"``Frameworks`` folder, relative to the app bundle. To allow for resolving a " -"framework-packaged binary back to the original location, the framework is " -"expected to contain a ``.origin`` file that contains the location of the ``." -"fwork`` file, relative to the app bundle." +"is registered against the ``.fwork`` file extension, with a ``.fwork`` file " +"acting as a placeholder in the original location of the binary on " +"``sys.path``. The ``.fwork`` file contains the path of the actual binary in " +"the ``Frameworks`` folder, relative to the app bundle. To allow for " +"resolving a framework-packaged binary back to the original location, the " +"framework is expected to contain a ``.origin`` file that contains the " +"location of the ``.fwork`` file, relative to the app bundle." msgstr "" msgid "" "For example, consider the case of an import ``from foo.bar import _whiz``, " "where ``_whiz`` is implemented with the binary module ``sources/foo/bar/" -"_whiz.abi3.so``, with ``sources`` being the location registered on ``sys." -"path``, relative to the application bundle. This module *must* be " +"_whiz.abi3.so``, with ``sources`` being the location registered on " +"``sys.path``, relative to the application bundle. This module *must* be " "distributed as ``Frameworks/foo.bar._whiz.framework/foo.bar._whiz`` " "(creating the framework name from the full import path of the module), with " "an ``Info.plist`` file in the ``.framework`` directory identifying the " "binary as a framework. The ``foo.bar._whiz`` module would be represented in " "the original location with a ``sources/foo/bar/_whiz.abi3.fwork`` marker " "file, containing the path ``Frameworks/foo.bar._whiz/foo.bar._whiz``. The " -"framework would also contain ``Frameworks/foo.bar._whiz.framework/foo.bar." -"_whiz.origin``, containing the path to the ``.fwork`` file." +"framework would also contain ``Frameworks/foo.bar._whiz.framework/" +"foo.bar._whiz.origin``, containing the path to the ``.fwork`` file." msgstr "" msgid "" @@ -1268,7 +1286,7 @@ msgid ":mod:`importlib.util` -- Utility code for importers" msgstr "" msgid "**Source code:** :source:`Lib/importlib/util.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/importlib/util.py`" msgid "" "This module contains the various objects that help in the construction of " @@ -1284,9 +1302,9 @@ msgid "" "Return the :pep:`3147`/:pep:`488` path to the byte-compiled file associated " "with the source *path*. For example, if *path* is ``/foo/bar/baz.py`` the " "return value would be ``/foo/bar/__pycache__/baz.cpython-32.pyc`` for Python " -"3.2. The ``cpython-32`` string comes from the current magic tag (see :func:" -"`get_tag`; if :attr:`sys.implementation.cache_tag` is not defined then :exc:" -"`NotImplementedError` will be raised)." +"3.2. The ``cpython-32`` string comes from the current magic tag " +"(see :attr:`sys.implementation.cache_tag `; if it is not " +"defined then :exc:`NotImplementedError` will be raised)." msgstr "" msgid "" @@ -1296,9 +1314,9 @@ msgid "" "``/foo/bar/__pycache__/baz.cpython-32.pyc``. ``None`` causes the " "interpreter's optimization level to be used. Any other value's string " "representation is used, so ``/foo/bar/baz.py`` with an *optimization* of " -"``2`` will lead to the bytecode path of ``/foo/bar/__pycache__/baz." -"cpython-32.opt-2.pyc``. The string representation of *optimization* can only " -"be alphanumeric, else :exc:`ValueError` is raised." +"``2`` will lead to the bytecode path of ``/foo/bar/__pycache__/" +"baz.cpython-32.opt-2.pyc``. The string representation of *optimization* can " +"only be alphanumeric, else :exc:`ValueError` is raised." msgstr "" msgid "" @@ -1319,17 +1337,18 @@ msgstr "" msgid "" "Given the *path* to a :pep:`3147` file name, return the associated source " -"code file path. For example, if *path* is ``/foo/bar/__pycache__/baz." -"cpython-32.pyc`` the returned path would be ``/foo/bar/baz.py``. *path* " +"code file path. For example, if *path* is ``/foo/bar/__pycache__/" +"baz.cpython-32.pyc`` the returned path would be ``/foo/bar/baz.py``. *path* " "need not exist, however if it does not conform to :pep:`3147` or :pep:`488` " -"format, a :exc:`ValueError` is raised. If :attr:`sys.implementation." -"cache_tag` is not defined, :exc:`NotImplementedError` is raised." +"format, a :exc:`ValueError` is raised. " +"If :attr:`sys.implementation.cache_tag ` is not " +"defined, :exc:`NotImplementedError` is raised." msgstr "" msgid "" "Decode the given bytes representing source code and return it as a string " -"with universal newlines (as required by :meth:`importlib.abc.InspectLoader." -"get_source`)." +"with universal newlines (as required " +"by :meth:`importlib.abc.InspectLoader.get_source`)." msgstr "" msgid "Resolve a relative module name to an absolute one." @@ -1337,15 +1356,17 @@ msgstr "" msgid "" "If **name** has no leading dots, then **name** is simply returned. This " -"allows for usage such as ``importlib.util.resolve_name('sys', __spec__." -"parent)`` without doing a check to see if the **package** argument is needed." +"allows for usage such as ``importlib.util.resolve_name('sys', " +"__spec__.parent)`` without doing a check to see if the **package** argument " +"is needed." msgstr "" msgid "" ":exc:`ImportError` is raised if **name** is a relative module name but " -"**package** is a false value (e.g. ``None`` or the empty string). :exc:" -"`ImportError` is also raised if a relative name would escape its containing " -"package (e.g. requesting ``..bacon`` from within the ``spam`` package)." +"**package** is a false value (e.g. ``None`` or the empty " +"string). :exc:`ImportError` is also raised if a relative name would escape " +"its containing package (e.g. requesting ``..bacon`` from within the ``spam`` " +"package)." msgstr "" msgid "" @@ -1367,7 +1388,9 @@ msgid "" "automatically imported." msgstr "" -msgid "**name** and **package** work the same as for :func:`import_module`." +msgid "" +"**name** and **package** work the same as " +"for :func:`importlib.import_module`." msgstr "" msgid "" @@ -1397,9 +1420,10 @@ msgstr "" msgid "" "A factory function for creating a :class:`~importlib.machinery.ModuleSpec` " "instance based on a loader. The parameters have the same meaning as they do " -"for ModuleSpec. The function uses available :term:`loader` APIs, such as :" -"meth:`InspectLoader.is_package`, to fill in any missing information on the " -"spec." +"for ModuleSpec. The function uses available :term:`loader` APIs, such " +"as :meth:`InspectLoader.is_package " +"`, to fill in any missing " +"information on the spec." msgstr "" msgid "" @@ -1446,15 +1470,16 @@ msgid "" msgstr "" msgid "" -"This class **only** works with loaders that define :meth:`~importlib.abc." -"Loader.exec_module` as control over what module type is used for the module " -"is required. For those same reasons, the loader's :meth:`~importlib.abc." -"Loader.create_module` method must return ``None`` or a type for which its " -"``__class__`` attribute can be mutated along with not using :term:`slots " -"<__slots__>`. Finally, modules which substitute the object placed into :data:" -"`sys.modules` will not work as there is no way to properly replace the " -"module references throughout the interpreter safely; :exc:`ValueError` is " -"raised if such a substitution is detected." +"This class **only** works with loaders that " +"define :meth:`~importlib.abc.Loader.exec_module` as control over what module " +"type is used for the module is required. For those same reasons, the " +"loader's :meth:`~importlib.abc.Loader.create_module` method must return " +"``None`` or a type for which its ``__class__`` attribute can be mutated " +"along with not using :term:`slots <__slots__>`. Finally, modules which " +"substitute the object placed into :data:`sys.modules` will not work as there " +"is no way to properly replace the module references throughout the " +"interpreter safely; :exc:`ValueError` is raised if such a substitution is " +"detected." msgstr "" msgid "" @@ -1467,8 +1492,8 @@ msgstr "" msgid "" "Began calling :meth:`~importlib.abc.Loader.create_module`, removing the " -"compatibility warning for :class:`importlib.machinery.BuiltinImporter` and :" -"class:`importlib.machinery.ExtensionFileLoader`." +"compatibility warning for :class:`importlib.machinery.BuiltinImporter` " +"and :class:`importlib.machinery.ExtensionFileLoader`." msgstr "" msgid "" @@ -1509,8 +1534,8 @@ msgid "" msgstr "" msgid "" -"Note that if ``name`` is a submodule (contains a dot), :func:`importlib.util." -"find_spec` will import the parent module. ::" +"Note that if ``name`` is a submodule (contains a " +"dot), :func:`importlib.util.find_spec` will import the parent module. ::" msgstr "" msgid "" @@ -1537,11 +1562,11 @@ msgstr "" msgid "" "This recipe should be used with caution: it is an approximation of an import " -"statement where the file path is specified directly, rather than :data:`sys." -"path` being searched. Alternatives should first be considered first, such as " -"modifying :data:`sys.path` when a proper module is required, or using :func:" -"`runpy.run_path` when the global namespace resulting from running a Python " -"file is appropriate." +"statement where the file path is specified directly, rather " +"than :data:`sys.path` being searched. Alternatives should first be " +"considered first, such as modifying :data:`sys.path` when a proper module is " +"required, or using :func:`runpy.run_path` when the global namespace " +"resulting from running a Python file is appropriate." msgstr "" msgid "" @@ -1600,16 +1625,17 @@ msgid "Setting up an importer" msgstr "" msgid "" -"For deep customizations of import, you typically want to implement an :term:" -"`importer`. This means managing both the :term:`finder` and :term:`loader` " -"side of things. For finders there are two flavours to choose from depending " -"on your needs: a :term:`meta path finder` or a :term:`path entry finder`. " -"The former is what you would put on :data:`sys.meta_path` while the latter " -"is what you create using a :term:`path entry hook` on :data:`sys.path_hooks` " -"which works with :data:`sys.path` entries to potentially create a finder. " -"This example will show you how to register your own importers so that import " -"will use them (for creating an importer for yourself, read the documentation " -"for the appropriate classes defined within this package)::" +"For deep customizations of import, you typically want to implement " +"an :term:`importer`. This means managing both the :term:`finder` " +"and :term:`loader` side of things. For finders there are two flavours to " +"choose from depending on your needs: a :term:`meta path finder` or " +"a :term:`path entry finder`. The former is what you would put " +"on :data:`sys.meta_path` while the latter is what you create using " +"a :term:`path entry hook` on :data:`sys.path_hooks` which works " +"with :data:`sys.path` entries to potentially create a finder. This example " +"will show you how to register your own importers so that import will use " +"them (for creating an importer for yourself, read the documentation for the " +"appropriate classes defined within this package)::" msgstr "" msgid "" diff --git a/library/importlib.resources.abc.po b/library/importlib.resources.abc.po index c607c46fb9..a970d92190 100644 --- a/library/importlib.resources.abc.po +++ b/library/importlib.resources.abc.po @@ -46,9 +46,9 @@ msgid "" msgstr "" msgid "" -"For any of methods of this class, a *resource* argument is expected to be a :" -"term:`path-like object` which represents conceptually just a file name. This " -"means that no subdirectory paths should be included in the *resource* " +"For any of methods of this class, a *resource* argument is expected to be " +"a :term:`path-like object` which represents conceptually just a file name. " +"This means that no subdirectory paths should be included in the *resource* " "argument. This is because the location of the package the reader is for, " "acts as the \"directory\". Hence the metaphor for directories and file names " "is packages and resources, respectively. This is also why instances of this " @@ -76,20 +76,20 @@ msgid "Returns the file system path to the *resource*." msgstr "" msgid "" -"If the resource does not concretely exist on the file system, raise :exc:" -"`FileNotFoundError`." +"If the resource does not concretely exist on the file system, " +"raise :exc:`FileNotFoundError`." msgstr "" msgid "" -"Returns ``True`` if the named *name* is considered a resource. :exc:" -"`FileNotFoundError` is raised if *name* does not exist." +"Returns ``True`` if the named *name* is considered a " +"resource. :exc:`FileNotFoundError` is raised if *name* does not exist." msgstr "" msgid "" "Returns an :term:`iterable` of strings over the contents of the package. Do " "note that it is not required that all names returned by the iterator be " -"actual resources, e.g. it is acceptable to return names for which :meth:" -"`is_resource` would be false." +"actual resources, e.g. it is acceptable to return names for " +"which :meth:`is_resource` would be false." msgstr "" msgid "" @@ -109,8 +109,8 @@ msgid "" msgstr "" msgid "" -"For a representation of the object on the file-system, use :meth:`importlib." -"resources.as_file`." +"For a representation of the object on the file-system, " +"use :meth:`importlib.resources.as_file`." msgstr "" msgid "Abstract. The base name of this object without any parent references." @@ -134,8 +134,8 @@ msgid "" msgstr "" msgid "" -"When opening as text, accepts encoding parameters such as those accepted by :" -"attr:`io.TextIOWrapper`." +"When opening as text, accepts encoding parameters such as those accepted " +"by :attr:`io.TextIOWrapper`." msgstr "" msgid "Read contents of self as bytes." @@ -145,10 +145,11 @@ 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. " +"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 "" diff --git a/library/importlib.resources.po b/library/importlib.resources.po index d811af5474..2da4bae507 100644 --- a/library/importlib.resources.po +++ b/library/importlib.resources.po @@ -69,8 +69,8 @@ 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``." +"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]``." @@ -84,8 +84,8 @@ msgid "" msgstr "" msgid "" -"*package* is either a name or a module object which conforms to the :data:" -"`Package` requirements." +"*package* is either a name or a module object which conforms to " +"the :data:`Package` requirements." msgstr "" msgid "" @@ -130,8 +130,8 @@ 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." +"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::" diff --git a/library/index.po b/library/index.po index 3399ca932d..db3497d85d 100644 --- a/library/index.po +++ b/library/index.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -24,43 +24,48 @@ msgstr "" "(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && " "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" -msgid "The Python Standard Library" +msgid "The Python standard library" msgstr "Biblioteka standardowa Pythona" msgid "" -"While :ref:`reference-index` describes the exact syntax and semantics of the " -"Python language, this library reference manual describes the standard " -"library that is distributed with Python. It also describes some of the " -"optional components that are commonly included in Python distributions." +"This library reference manual describes the standard library distributed " +"with Python. It also describes some of the optional components that are " +"commonly included in Python distributions." msgstr "" -"W odróżnieniu od :ref:`dokumentacji języka Python `, która " -"opisuje dokładną składnię i semantykę języka Python, ta dokumentacja opisuje " -"bibliotekę standardową, która jest rozpowszechniana z Pythonem. Opisuje " -"również niektóre opcjonalne komponenty, które często są zawarte w " -"dystrybucjach Pythona." +"Ta dokumentacja opisuje bibliotekę standardową, która jest rozpowszechniana " +"z Pythonem. Opisuje również niektóre opcjonalne komponenty, które często są " +"zawarte w dystrybucjach Pythona." msgid "" -"Python's standard library is very extensive, offering a wide range of " -"facilities as indicated by the long table of contents listed below. The " -"library contains built-in modules (written in C) that provide access to " -"system functionality such as file I/O that would otherwise be inaccessible " -"to Python programmers, as well as modules written in Python that provide " +"Elsewhere, :ref:`reference-index` describes the exact syntax and semantics " +"of the Python language, and :ref:`builtins-index` describes the built-in " +"functions." +msgstr "" +"Inne miejsce, strona :ref:`reference-index`, opisuje dokładną strukturę " +"składni oraz semantykę języka Python, a strona :ref:`builtins-index` omawia " +"wbudowane funkcje." + +msgid "" +"Python's standard library is extensive, offering a wide range of facilities " +"as indicated by the long table of contents listed below. The library " +"contains built-in modules (written in C) that provide access to system " +"functionality such as file I/O that would otherwise be inaccessible to " +"Python programmers, as well as modules written in Python that provide " "standardized solutions for many problems that occur in everyday programming. " "Some of these modules are explicitly designed to encourage and enhance the " "portability of Python programs by abstracting away platform-specifics into " "platform-neutral APIs." msgstr "" -"Biblioteka standardowa Pythona jest bardzo obszerna i oferuje szeroki " -"wachlarz narzędzi, co widać w długości spisu treści poniżej. Biblioteka " -"zawiera wbudowane moduły (napisane w C), które dają dostęp do " -"funkcjonalności systemowych, takich jak pliki wejścia/wyjścia, które w " -"przeciwnym przypadku byłyby niedostępne dla programistów Pythona. Zawiera " -"również moduły napisane w Pythonie, które dostarczają ustandaryzowane " -"rozwiązania wielu problemów, które napotyka się podczas programowania na co " -"dzień. Niektóre z tych modułów są bezpośrednio zaprojektowane tak, by " -"zachęcać i zwiększać przenośność programów napisanych w Pythonie przez " -"dodawanie abstrakcji nad specyfikami platform i tworzenie API neutralnych " -"platformowo." +"Biblioteka standardowa Pythona jest obszerna i oferuje szeroki wachlarz " +"narzędzi, co widać w długości spisu treści poniżej. Biblioteka zawiera " +"wbudowane moduły (napisane w C), które dają dostęp do funkcjonalności " +"systemowych, takich jak pliki wejścia/wyjścia, które w przeciwnym przypadku " +"byłyby niedostępne dla programistów Pythona. Zawiera również moduły napisane " +"w Pythonie, które dostarczają ustandaryzowane rozwiązania wielu problemów, " +"które napotyka się podczas programowania na co dzień. Niektóre z tych " +"modułów są bezpośrednio zaprojektowane tak, by zachęcać i zwiększać " +"przenośność programów napisanych w Pythonie przez dodawanie abstrakcji nad " +"specyfikami platform i tworzenie API neutralnych platformowo." msgid "" "The Python installers for the Windows platform usually include the entire " diff --git a/library/inspect.po b/library/inspect.po index c8ba7880b4..756608e8a0 100644 --- a/library/inspect.po +++ b/library/inspect.po @@ -1,22 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,7 +28,7 @@ msgid ":mod:`!inspect` --- Inspect live objects" msgstr "" msgid "**Source code:** :source:`Lib/inspect.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/inspect.py`" msgid "" "The :mod:`inspect` module provides several useful functions to help get " @@ -53,10 +51,10 @@ msgstr "" msgid "" "The :func:`getmembers` function retrieves the members of an object such as a " "class or module. The functions whose names begin with \"is\" are mainly " -"provided as convenient choices for the second argument to :func:" -"`getmembers`. They also help you determine when you can expect to find the " -"following special attributes (see :ref:`import-mod-attrs` for module " -"attributes):" +"provided as convenient choices for the second argument " +"to :func:`getmembers`. They also help you determine when you can expect to " +"find the following special attributes (see :ref:`import-mod-attrs` for " +"module attributes):" msgstr "" msgid "Type" @@ -180,19 +178,19 @@ msgid "traceback" msgstr "" msgid "tb_frame" -msgstr "" +msgstr "tb_frame" msgid "frame object at this level" msgstr "" msgid "tb_lasti" -msgstr "" +msgstr "tb_lasti" msgid "index of last attempted instruction in bytecode" msgstr "" msgid "tb_lineno" -msgstr "" +msgstr "tb_lineno" msgid "current line number in Python source code" msgstr "" @@ -207,25 +205,25 @@ msgid "frame" msgstr "" msgid "f_back" -msgstr "" +msgstr "f_back" msgid "next outer frame object (this frame's caller)" msgstr "" msgid "f_builtins" -msgstr "" +msgstr "f_builtins" msgid "builtins namespace seen by this frame" msgstr "" msgid "f_code" -msgstr "" +msgstr "f_code" msgid "code object being executed in this frame" msgstr "" msgid "f_globals" -msgstr "" +msgstr "f_globals" msgid "global namespace seen by this frame" msgstr "" @@ -234,10 +232,10 @@ msgid "f_lasti" msgstr "" msgid "f_lineno" -msgstr "" +msgstr "f_lineno" msgid "f_locals" -msgstr "" +msgstr "f_locals" msgid "local namespace seen by this frame" msgstr "" @@ -252,7 +250,7 @@ msgid "code" msgstr "" msgid "co_argcount" -msgstr "" +msgstr "co_argcount" msgid "" "number of arguments (not including keyword only arguments, \\* or \\*\\* " @@ -260,7 +258,7 @@ msgid "" msgstr "" msgid "co_code" -msgstr "" +msgstr "co_code" msgid "string of raw compiled bytecode" msgstr "" @@ -272,7 +270,7 @@ msgid "tuple of names of cell variables (referenced by containing scopes)" msgstr "" msgid "co_consts" -msgstr "" +msgstr "co_consts" msgid "tuple of constants used in the bytecode" msgstr "" @@ -284,13 +282,13 @@ msgid "name of file in which this code object was created" msgstr "" msgid "co_firstlineno" -msgstr "" +msgstr "co_firstlineno" msgid "number of first line in Python source code" msgstr "" msgid "co_flags" -msgstr "" +msgstr "co_flags" msgid "" "bitmap of ``CO_*`` flags, read more :ref:`here `" @@ -309,19 +307,19 @@ msgid "tuple of names of free variables (referenced via a function's closure)" msgstr "" msgid "co_posonlyargcount" -msgstr "" +msgstr "co_posonlyargcount" msgid "number of positional only arguments" msgstr "" msgid "co_kwonlyargcount" -msgstr "" +msgstr "co_kwonlyargcount" msgid "number of keyword only arguments (not including \\*\\* arg)" msgstr "" msgid "co_name" -msgstr "" +msgstr "co_name" msgid "name with which this code object was defined" msgstr "" @@ -339,13 +337,13 @@ msgid "tuple of names other than arguments and function locals" msgstr "" msgid "co_nlocals" -msgstr "" +msgstr "co_nlocals" msgid "number of local variables" msgstr "" msgid "co_stacksize" -msgstr "" +msgstr "co_stacksize" msgid "virtual machine stack space required" msgstr "" @@ -363,14 +361,20 @@ msgid "name" msgstr "nazwa" msgid "gi_frame" -msgstr "" +msgstr "gi_frame" msgid "gi_running" -msgstr "" +msgstr "gi_running" msgid "is the generator running?" msgstr "" +msgid "gi_suspended" +msgstr "" + +msgid "is the generator suspended?" +msgstr "" + msgid "gi_code" msgstr "" @@ -395,6 +399,9 @@ msgstr "" msgid "ag_running" msgstr "" +msgid "ag_suspended" +msgstr "" + msgid "ag_code" msgstr "" @@ -402,10 +409,10 @@ msgid "coroutine" msgstr "" msgid "cr_await" -msgstr "" +msgstr "cr_await" msgid "cr_frame" -msgstr "" +msgstr "cr_frame" msgid "cr_running" msgstr "" @@ -413,9 +420,15 @@ msgstr "" msgid "is the coroutine running?" msgstr "" -msgid "cr_code" +msgid "cr_suspended" +msgstr "" + +msgid "is the coroutine suspended?" msgstr "" +msgid "cr_code" +msgstr "cr_code" + msgid "cr_origin" msgstr "" @@ -445,6 +458,15 @@ msgstr "" msgid "Add ``__builtins__`` attribute to functions." msgstr "" +msgid "Add ``gi_suspended`` attribute to generators." +msgstr "" + +msgid "Add ``cr_suspended`` attribute to coroutines." +msgstr "" + +msgid "Add ``ag_suspended`` attribute to async generators." +msgstr "" + msgid "" "Return all the members of an object in a list of ``(name, value)`` pairs " "sorted by name. If the optional *predicate* argument—which will be called " @@ -498,6 +520,11 @@ msgid "" "Python code." msgstr "" +msgid "" +"This function returns ``False`` for :ref:`generic aliases ` of classes, such as ``list[int]``." +msgstr "" + msgid "Return ``True`` if the object is a bound method written in Python." msgstr "" @@ -514,6 +541,11 @@ msgid "" "wrapped function is a Python generator function." msgstr "" +msgid "" +":term:`Duck-typed ` function-like objects now return ``True`` " +"if their code object has the :data:`CO_GENERATOR` flag." +msgstr "" + msgid "" "Functions wrapped in :func:`functools.partialmethod` now return ``True`` if " "the wrapped function is a Python generator function." @@ -525,8 +557,8 @@ msgstr "" msgid "" "Return ``True`` if the object is a :term:`coroutine function` (a function " "defined with an :keyword:`async def` syntax), a :func:`functools.partial` " -"wrapping a :term:`coroutine function`, or a sync function marked with :func:" -"`markcoroutinefunction`." +"wrapping a :term:`coroutine function`, or a sync function marked " +"with :func:`markcoroutinefunction`." msgstr "" msgid "" @@ -534,6 +566,11 @@ msgid "" "wrapped function is a :term:`coroutine function`." msgstr "" +msgid "" +":term:`Duck-typed ` function-like objects now return ``True`` " +"if their code object has the :data:`CO_COROUTINE` flag." +msgstr "" + msgid "" "Sync functions marked with :func:`markcoroutinefunction` now return ``True``." msgstr "" @@ -555,13 +592,13 @@ msgstr "" msgid "" "When possible, using an :keyword:`async def` function is preferred. Also " -"acceptable is calling the function and testing the return with :func:" -"`iscoroutine`." +"acceptable is calling the function and testing the return " +"with :func:`iscoroutine`." msgstr "" msgid "" -"Return ``True`` if the object is a :term:`coroutine` created by an :keyword:" -"`async def` function." +"Return ``True`` if the object is a :term:`coroutine` created by " +"an :keyword:`async def` function." msgstr "" msgid "" @@ -609,6 +646,16 @@ msgid "" "wrapped function is an :term:`asynchronous generator` function." msgstr "" +msgid "" +":term:`Duck-typed ` function-like objects now return ``True`` " +"if their code object has the :data:`CO_ASYNC_GENERATOR` flag." +msgstr "" + +msgid "" +"Functions wrapped in :func:`functools.partialmethod` now return ``True`` if " +"the wrapped function is a :term:`asynchronous generator` function." +msgstr "" + msgid "" "Return ``True`` if the object is an :term:`asynchronous generator iterator` " "created by an :term:`asynchronous generator` function." @@ -633,8 +680,9 @@ msgid "" msgstr "" msgid "" -"These are instances of :class:`~types.MethodWrapperType`, such as :meth:" -"`~object.__str__`, :meth:`~object.__eq__` and :meth:`~object.__repr__`." +"These are instances of :class:`~types.MethodWrapperType`, such " +"as :meth:`~object.__str__`, :meth:`~object.__eq__` " +"and :meth:`~object.__repr__`." msgstr "" msgid "" @@ -646,9 +694,8 @@ msgid "Return ``True`` if the object is an abstract base class." msgstr "" msgid "" -"Return ``True`` if the object is a method descriptor, but not if :func:" -"`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are " -"true." +"Return ``True`` if the object is a method descriptor, but not " +"if :func:`isclass`, :func:`ismethod` or :func:`isfunction` is true." msgstr "" msgid "" @@ -660,59 +707,81 @@ msgid "" msgstr "" msgid "" -"Methods implemented via descriptors that also pass one of the other tests " -"return ``False`` from the :func:`ismethoddescriptor` test, simply because " -"the other tests promise more -- you can, e.g., count on having the :attr:" -"`~method.__func__` attribute (etc) when an object passes :func:`ismethod`." +"Method descriptors that also pass any of the other tests (:func:`!" +"isclass`, :func:`!ismethod` or :func:`!isfunction`) make this function " +"return ``False``, simply because those other tests promise more -- you can, " +"for example, count on having the :attr:`~method.__func__` attribute when an " +"object passes :func:`ismethod`." +msgstr "" + +msgid "" +"This function no longer incorrectly reports objects " +"with :meth:`~object.__get__` and :meth:`~object.__delete__`, but " +"not :meth:`~object.__set__`, as being method descriptors (such objects are " +"data descriptors, not method descriptors)." +msgstr "" + +msgid "" +"Return ``True`` if the object is a data descriptor, but not " +"if :func:`isclass`, :func:`ismethod` or :func:`isfunction` is true." msgstr "" msgid "" -"This function no longer incorrectly reports objects with :meth:`~object." -"__get__` and :meth:`~object.__delete__`, but not :meth:`~object.__set__`, as " -"being method descriptors (such objects are data descriptors, not method " -"descriptors)." +"Data descriptors always have a :meth:`~object.__set__` method and/or " +"a :meth:`~object.__delete__` method. Optionally, they may also have " +"a :meth:`~object.__get__` method." msgstr "" -msgid "Return ``True`` if the object is a data descriptor." +msgid "" +"Examples of data descriptors are :func:`properties `, getsets and " +"member descriptors. Note that for the latter two (defined only in C " +"extension modules), more specific tests are " +"available: :func:`isgetsetdescriptor` and :func:`ismemberdescriptor`, " +"respectively." +msgstr "" + +msgid "" +"While data descriptors may also have :attr:`~definition.__name__` " +"and :attr:`!__doc__` attributes (as properties, getsets and member " +"descriptors do), this is not necessarily the case in general." msgstr "" msgid "" -"Data descriptors have a :attr:`~object.__set__` or a :attr:`~object." -"__delete__` method. Examples are properties (defined in Python), getsets, " -"and members. The latter two are defined in C and there are more specific " -"tests available for those types, which is robust across Python " -"implementations. Typically, data descriptors will also have :attr:" -"`~definition.__name__` and :attr:`!__doc__` attributes (properties, getsets, " -"and members have both of these attributes), but this is not guaranteed." +"This function now reports objects with only a :meth:`~object.__set__` method " +"as being data descriptors (the presence of :meth:`~object.__get__` is no " +"longer required for that). Moreover, objects " +"with :meth:`~object.__delete__`, but not :meth:`~object.__set__`, are now " +"properly recognized as data descriptors as well, which was not the case " +"previously." msgstr "" msgid "Return ``True`` if the object is a getset descriptor." msgstr "" msgid "" -"getsets are attributes defined in extension modules via :c:type:" -"`PyGetSetDef` structures. For Python implementations without such types, " -"this method will always return ``False``." +"getsets are attributes defined in extension modules " +"via :c:type:`PyGetSetDef` structures. For Python implementations without " +"such types, this method will always return ``False``." msgstr "" msgid "Return ``True`` if the object is a member descriptor." msgstr "" msgid "" -"Member descriptors are attributes defined in extension modules via :c:type:" -"`PyMemberDef` structures. For Python implementations without such types, " -"this method will always return ``False``." +"Member descriptors are attributes defined in extension modules " +"via :c:type:`PyMemberDef` structures. For Python implementations without " +"such types, this method will always return ``False``." msgstr "" msgid "Retrieving source code" msgstr "" msgid "" -"Get the documentation string for an object, cleaned up with :func:" -"`cleandoc`. If the documentation string for an object is not provided and " -"the object is a class, a method, a property or a descriptor, retrieve the " -"documentation string from the inheritance hierarchy. Return ``None`` if the " -"documentation string is invalid or missing." +"Get the documentation string for an object, cleaned up " +"with :func:`cleandoc`. If the documentation string for an object is not " +"provided and the object is a class, a method, a property or a descriptor, " +"retrieve the documentation string from the inheritance hierarchy. Return " +"``None`` if the documentation string is invalid or missing." msgstr "" msgid "Documentation strings are now inherited if not overridden." @@ -728,8 +797,9 @@ msgstr "" msgid "" "Return the name of the (text or binary) file in which an object was defined. " -"This will fail with a :exc:`TypeError` if the object is a built-in module, " -"class, or function." +"An :exc:`OSError` is raised if the source code cannot be retrieved. This " +"will fail with a :exc:`TypeError` if the object is a built-in module, class, " +"or function." msgstr "" msgid "" @@ -739,7 +809,8 @@ msgstr "" msgid "" "Return the name of the Python source file in which an object was defined or " -"``None`` if no way can be identified to get the source. This will fail with " +"``None`` if no way can be identified to get the source. An :exc:`OSError` " +"is raised if the source code cannot be retrieved. This will fail with " "a :exc:`TypeError` if the object is a built-in module, class, or function." msgstr "" @@ -816,14 +887,15 @@ 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:`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." +"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 " +"Raises :exc:`ValueError` if no signature can be provided, " +"and :exc:`TypeError` if that type of object is not supported. Also, if the " "annotations are stringized, and *eval_str* is not false, the ``eval()`` " "call(s) to un-stringize the annotations in :func:`get_annotations` could " "potentially raise any kind of exception." @@ -888,9 +960,9 @@ msgid "A special class-level marker to specify absence of a return annotation." msgstr "" msgid "" -"An ordered mapping of parameters' names to the corresponding :class:" -"`Parameter` objects. Parameters appear in strict definition order, " -"including keyword-only parameters." +"An ordered mapping of parameters' names to the " +"corresponding :class:`Parameter` objects. Parameters appear in strict " +"definition order, including keyword-only parameters." msgstr "" msgid "" @@ -918,11 +990,11 @@ msgid "" msgstr "" msgid "" -"Create a new :class:`Signature` instance based on the instance :meth:" -"`replace` was invoked on. It is possible to pass different *parameters* and/" -"or *return_annotation* to override the corresponding properties of the base " -"signature. To remove ``return_annotation`` from the copied :class:`!" -"Signature`, pass in :attr:`Signature.empty`." +"Create a new :class:`Signature` instance based on the " +"instance :meth:`replace` was invoked on. It is possible to pass different " +"*parameters* and/or *return_annotation* to override the corresponding " +"properties of the base signature. To remove ``return_annotation`` from the " +"copied :class:`!Signature`, pass in :attr:`Signature.empty`." msgstr "" msgid "" @@ -936,8 +1008,8 @@ msgid "" msgstr "" msgid "" -":class:`Signature` objects are also supported by the generic function :func:" -"`copy.replace`." +":class:`Signature` objects are also supported by the generic " +"function :func:`copy.replace`." msgstr "" msgid "Create a string representation of the :class:`Signature` object." @@ -969,8 +1041,8 @@ msgstr "" msgid "" ":class:`!Parameter` objects are *immutable*. Instead of modifying a :class:`!" -"Parameter` object, you can use :meth:`Parameter.replace` or :func:`copy." -"replace` to create a modified copy." +"Parameter` object, you can use :meth:`Parameter.replace` " +"or :func:`copy.replace` to create a modified copy." msgstr "" msgid "Parameter objects are now picklable and :term:`hashable`." @@ -1008,8 +1080,9 @@ msgstr "" msgid "" "Describes how argument values are bound to the parameter. The possible " -"values are accessible via :class:`Parameter` (like ``Parameter." -"KEYWORD_ONLY``), and support comparison and ordering, in the following order:" +"values are accessible via :class:`Parameter` (like " +"``Parameter.KEYWORD_ONLY``), and support comparison and ordering, in the " +"following order:" msgstr "" msgid "Name" @@ -1115,8 +1188,8 @@ msgid "" msgstr "" msgid "" -":class:`Parameter` objects are also supported by the generic function :func:" -"`copy.replace`." +":class:`Parameter` objects are also supported by the generic " +"function :func:`copy.replace`." msgstr "" msgid "" @@ -1132,8 +1205,8 @@ msgstr "" msgid "" "A mutable mapping of parameters' names to arguments' values. Contains only " -"explicitly bound arguments. Changes in :attr:`arguments` will reflect in :" -"attr:`args` and :attr:`kwargs`." +"explicitly bound arguments. Changes in :attr:`arguments` will reflect " +"in :attr:`args` and :attr:`kwargs`." msgstr "" msgid "" @@ -1143,24 +1216,24 @@ msgstr "" msgid "" "Arguments for which :meth:`Signature.bind` or :meth:`Signature.bind_partial` " -"relied on a default value are skipped. However, if needed, use :meth:" -"`BoundArguments.apply_defaults` to add them." +"relied on a default value are skipped. However, if needed, " +"use :meth:`BoundArguments.apply_defaults` to add them." msgstr "" msgid "" -":attr:`arguments` is now of type :class:`dict`. Formerly, it was of type :" -"class:`collections.OrderedDict`." +":attr:`arguments` is now of type :class:`dict`. Formerly, it was of " +"type :class:`collections.OrderedDict`." msgstr "" msgid "" -"A tuple of positional arguments values. Dynamically computed from the :attr:" -"`arguments` attribute." +"A tuple of positional arguments values. Dynamically computed from " +"the :attr:`arguments` attribute." msgstr "" msgid "" -"A dict of keyword arguments values. Dynamically computed from the :attr:" -"`arguments` attribute. Arguments that can be passed positionally are " -"included in :attr:`args` instead." +"A dict of keyword arguments values. Dynamically computed from " +"the :attr:`arguments` attribute. Arguments that can be passed positionally " +"are included in :attr:`args` instead." msgstr "" msgid "A reference to the parent :class:`Signature` object." @@ -1219,8 +1292,8 @@ msgid "" msgstr "" msgid "" -"Get the names and default values of a Python function's parameters. A :term:" -"`named tuple` is returned:" +"Get the names and default values of a Python function's parameters. " +"A :term:`named tuple` is returned:" msgstr "" msgid "" @@ -1258,27 +1331,28 @@ msgid "" msgstr "" msgid "" -"This method was previously documented as deprecated in favour of :func:" -"`signature` in Python 3.5, but that decision has been reversed in order to " -"restore a clearly supported standard interface for single-source Python 2/3 " -"code migrating away from the legacy :func:`getargspec` API." +"This method was previously documented as deprecated in favour " +"of :func:`signature` in Python 3.5, but that decision has been reversed in " +"order to restore a clearly supported standard interface for single-source " +"Python 2/3 code migrating away from the legacy :func:`!getargspec` API." msgstr "" msgid "" -"Get information about arguments passed into a particular frame. A :term:" -"`named tuple` ``ArgInfo(args, varargs, keywords, locals)`` is returned. " -"*args* is a list of the argument names. *varargs* and *keywords* are the " -"names of the ``*`` and ``**`` arguments or ``None``. *locals* is the locals " -"dictionary of the given frame." +"Get information about arguments passed into a particular frame. " +"A :term:`named tuple` ``ArgInfo(args, varargs, keywords, locals)`` is " +"returned. *args* is a list of the argument names. *varargs* and *keywords* " +"are the names of the ``*`` and ``**`` arguments or ``None``. *locals* is " +"the locals dictionary of the given frame." msgstr "" msgid "This function was inadvertently marked as deprecated in Python 3.5." msgstr "" msgid "" -"Format a pretty argument spec from the four values returned by :func:" -"`getargvalues`. The format\\* arguments are the corresponding optional " -"formatting functions that are called to turn names and values into strings." +"Format a pretty argument spec from the four values returned " +"by :func:`getargvalues`. The format\\* arguments are the corresponding " +"optional formatting functions that are called to turn names and values into " +"strings." msgstr "" msgid "" @@ -1335,17 +1409,17 @@ msgid "" msgstr "" msgid "" -"Get the object wrapped by *func*. It follows the chain of :attr:" -"`__wrapped__` attributes returning the last object in the chain." +"Get the object wrapped by *func*. It follows the chain " +"of :attr:`__wrapped__` attributes returning the last object in the chain." msgstr "" msgid "" "*stop* is an optional callback accepting an object in the wrapper chain as " "its sole argument that allows the unwrapping to be terminated early if the " "callback returns a true value. If the callback never returns a true value, " -"the last object in the chain is returned as usual. For example, :func:" -"`signature` uses this to stop unwrapping if any object in the chain has a " -"``__signature__`` attribute defined." +"the last object in the chain is returned as usual. For " +"example, :func:`signature` uses this to stop unwrapping if any object in the " +"chain has a ``__signature__`` attribute defined." msgstr "" msgid ":exc:`ValueError` is raised if a cycle is encountered." @@ -1369,9 +1443,9 @@ msgid "This function handles several details for you:" msgstr "" msgid "" -"If ``eval_str`` is true, values of type ``str`` will be un-stringized using :" -"func:`eval`. This is intended for use with stringized annotations (``from " -"__future__ import annotations``)." +"If ``eval_str`` is true, values of type ``str`` will be un-stringized " +"using :func:`eval`. This is intended for use with stringized annotations " +"(``from __future__ import annotations``)." msgstr "" msgid "" @@ -1419,14 +1493,15 @@ msgid "If ``obj`` is a module, ``globals`` defaults to ``obj.__dict__``." msgstr "" msgid "" -"If ``obj`` is a class, ``globals`` defaults to ``sys.modules[obj.__module__]." -"__dict__`` and ``locals`` defaults to the ``obj`` class namespace." +"If ``obj`` is a class, ``globals`` defaults to " +"``sys.modules[obj.__module__].__dict__`` and ``locals`` defaults to the " +"``obj`` class namespace." msgstr "" msgid "" "If ``obj`` is a callable, ``globals`` defaults to :attr:`obj.__globals__ " -"`, although if ``obj`` is a wrapped function (using :" -"func:`functools.update_wrapper`) it is first unwrapped." +"`, although if ``obj`` is a wrapped function " +"(using :func:`functools.update_wrapper`) it is first unwrapped." msgstr "" msgid "" @@ -1531,9 +1606,10 @@ msgstr "" msgid "" "Though the cycle detector will catch these, destruction of the frames (and " -"local variables) can be made deterministic by removing the cycle in a :" -"keyword:`finally` clause. This is also important if the cycle detector was " -"disabled when Python was compiled or using :func:`gc.disable`. For example::" +"local variables) can be made deterministic by removing the cycle in " +"a :keyword:`finally` clause. This is also important if the cycle detector " +"was disabled when Python was compiled or using :func:`gc.disable`. For " +"example::" msgstr "" msgid "" @@ -1616,14 +1692,14 @@ msgstr "" msgid "" "Both :func:`getattr` and :func:`hasattr` can trigger code execution when " "fetching or checking for the existence of attributes. Descriptors, like " -"properties, will be invoked and :meth:`~object.__getattr__` and :meth:" -"`~object.__getattribute__` may be called." +"properties, will be invoked and :meth:`~object.__getattr__` " +"and :meth:`~object.__getattribute__` may be called." msgstr "" msgid "" "For cases where you want passive introspection, like documentation tools, " -"this can be inconvenient. :func:`getattr_static` has the same signature as :" -"func:`getattr` but avoids executing code when it fetches attributes." +"this can be inconvenient. :func:`getattr_static` has a similar signature " +"as :func:`getattr` but avoids executing code when it fetches attributes." msgstr "" msgid "" @@ -1727,10 +1803,10 @@ msgstr "" msgid "" "Get current state of an asynchronous generator object. The function is " -"intended to be used with asynchronous iterator objects created by :keyword:" -"`async def` functions which use the :keyword:`yield` statement, but will " -"accept any asynchronous generator-like object that has ``ag_running`` and " -"``ag_frame`` attributes." +"intended to be used with asynchronous iterator objects created " +"by :keyword:`async def` functions which use the :keyword:`yield` statement, " +"but will accept any asynchronous generator-like object that has " +"``ag_running`` and ``ag_frame`` attributes." msgstr "" msgid "AGEN_CREATED: Waiting to start execution." @@ -1842,15 +1918,15 @@ msgstr "" msgid "" "This is an :class:`enum.IntFlag` that represents the flags that can be " -"passed to the :meth:`~object.__buffer__` method of objects implementing the :" -"ref:`buffer protocol `." +"passed to the :meth:`~object.__buffer__` method of objects implementing " +"the :ref:`buffer protocol `." msgstr "" msgid "The meaning of the flags is explained at :ref:`buffer-request-types`." msgstr "" -msgid "Command Line Interface" -msgstr "Interfejs linii komend" +msgid "Command-line interface" +msgstr "Interfejs wiersza poleceń" msgid "" "The :mod:`inspect` module also provides a basic introspection capability " diff --git a/library/internet.po b/library/internet.po index 33b7d5819b..5a2d5f7f17 100644 --- a/library/internet.po +++ b/library/internet.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,9 +29,9 @@ msgstr "" msgid "" "The modules described in this chapter implement internet protocols and " "support for related technology. They are all implemented in Python. Most of " -"these modules require the presence of the system-dependent module :mod:" -"`socket`, which is currently supported on most popular platforms. Here is " -"an overview:" +"these modules require the presence of the system-dependent " +"module :mod:`socket`, which is currently supported on most popular " +"platforms. Here is an overview:" msgstr "" msgid "WWW" diff --git a/library/intro.po b/library/intro.po index ddf8947aa5..9ca1e09da5 100644 --- a/library/intro.po +++ b/library/intro.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Seweryn Piórkowski , 2021\n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -26,61 +26,37 @@ msgstr "" msgid "Introduction" msgstr "Wprowadzenie" -msgid "The \"Python library\" contains several different kinds of components." -msgstr "" - -msgid "" -"It contains data types that would normally be considered part of the " -"\"core\" of a language, such as numbers and lists. For these types, the " -"Python language core defines the form of literals and places some " -"constraints on their semantics, but does not fully define the semantics. " -"(On the other hand, the language core does define syntactic properties like " -"the spelling and priorities of operators.)" -msgstr "" - -msgid "" -"The library also contains built-in functions and exceptions --- objects that " -"can be used by all Python code without the need of an :keyword:`import` " -"statement. Some of these are defined by the core language, but many are not " -"essential for the core semantics and are only described here." -msgstr "" - -msgid "" -"The bulk of the library, however, consists of a collection of modules. There " -"are many ways to dissect this collection. Some modules are written in C and " -"built in to the Python interpreter; others are written in Python and " -"imported in source form. Some modules provide interfaces that are highly " -"specific to Python, like printing a stack trace; some provide interfaces " -"that are specific to particular operating systems, such as access to " -"specific hardware; others provide interfaces that are specific to a " -"particular application domain, like the World Wide Web. Some modules are " -"available in all versions and ports of Python; others are only available " -"when the underlying system supports or requires them; yet others are " -"available only when a particular configuration option was chosen at the time " -"when Python was compiled and installed." -msgstr "" - msgid "" -"This manual is organized \"from the inside out:\" it first describes the " -"built-in functions, data types and exceptions, and finally the modules, " -"grouped in chapters of related modules." +"The Python standard library consists of a collection of modules. There are " +"many ways to dissect this collection. Most modules are written in Python, " +"but some are written in C. All can be imported into your program to add " +"functionality. Some modules provide interfaces that are highly specific to " +"Python, like printing a stack trace; some provide interfaces that are " +"specific to particular operating systems, such as access to specific " +"hardware; others provide interfaces that are specific to a particular " +"application domain, like web development. Some modules are available in all " +"versions and ports of Python; others are only available when the underlying " +"system supports or requires them; yet others are available only when a " +"particular configuration option was chosen at the time when Python was " +"compiled and installed." msgstr "" msgid "" -"This means that if you start reading this manual from the start, and skip to " -"the next chapter when you get bored, you will get a reasonable overview of " -"the available modules and application areas that are supported by the Python " +"If you start reading this manual from the start, and skip to the next " +"chapter when you get bored, you will get a reasonable overview of the " +"available modules and application areas that are supported by the Python " "library. Of course, you don't *have* to read it like a novel --- you can " "also browse the table of contents (in front of the manual), or look for a " "specific function, module or term in the index (in the back). And finally, " -"if you enjoy learning about random subjects, you choose a random page number " -"(see module :mod:`random`) and read a section or two. Regardless of the " -"order in which you read the sections of this manual, it helps to start with " -"chapter :ref:`built-in-funcs`, as the remainder of the manual assumes " -"familiarity with this material." +"if you enjoy learning about random subjects, you choose a random page and " +"read a section or two. Regardless of the order in which you read the " +"sections of this manual, it helps to first read :ref:`built-in-funcs`, as " +"the remainder of this section assumes familiarity with this material." msgstr "" -msgid "Let the show begin!" +msgid "" +"The built-in functions and classes (which can be used without " +"an :keyword:`import` statement) are described in :ref:`builtins-index`." msgstr "" msgid "Notes on availability" @@ -138,10 +114,11 @@ msgstr "" msgid "" "Process-related APIs are not available or always fail with an error. That " -"includes APIs that spawn new processes (:func:`~os.fork`, :func:`~os." -"execve`), wait for processes (:func:`~os.waitpid`), send signals (:func:`~os." -"kill`), or otherwise interact with processes. The :mod:`subprocess` is " -"importable but does not work." +"includes APIs that spawn new processes " +"(:func:`~os.fork`, :func:`~os.execve`), wait for processes " +"(:func:`~os.waitpid`), send signals (:func:`~os.kill`), or otherwise " +"interact with processes. The :mod:`subprocess` is importable but does not " +"work." msgstr "" msgid "" @@ -175,10 +152,10 @@ msgstr "" msgid "" "Mobile platforms can only use Python in \"embedded\" mode. There is no " -"Python REPL, and no ability to use separate executables such as :program:" -"`python` or :program:`pip`. To add Python code to your mobile app, you must " -"use the :ref:`Python embedding API `. For more details, see :ref:" -"`using-android` and :ref:`using-ios`." +"Python REPL, and no ability to use separate executables such " +"as :program:`python` or :program:`pip`. To add Python code to your mobile " +"app, you must use the :ref:`Python embedding API `. For more " +"details, see :ref:`using-android` and :ref:`using-ios`." msgstr "" msgid "Subprocesses:" @@ -187,8 +164,8 @@ msgstr "" msgid "" "On Android, creating subprocesses is possible but `officially unsupported " "`__. In " -"particular, Android does not support any part of the System V IPC API, so :" -"mod:`multiprocessing` is not available." +"particular, Android does not support any part of the System V IPC API, " +"so :mod:`multiprocessing` is not available." msgstr "" msgid "" @@ -212,8 +189,8 @@ msgstr "" msgid "" "On Android, the native ``stdout`` and ``stderr`` are not connected to " "anything, so Python installs its own streams which redirect messages to the " -"system log. These can be seen under the tags ``python.stdout`` and ``python." -"stderr`` respectively." +"system log. These can be seen under the tags ``python.stdout`` and " +"``python.stderr`` respectively." msgstr "" msgid "" @@ -232,6 +209,6 @@ msgid "" msgstr "" msgid "" -"As a result, Python modules that involve console manipulation (such as :mod:" -"`curses` and :mod:`readline`) are not available on mobile platforms." +"As a result, Python modules that involve console manipulation (such " +"as :mod:`curses` and :mod:`readline`) are not available on mobile platforms." msgstr "" diff --git a/library/io.po b/library/io.po index 292855d279..7ecb8b1e4d 100644 --- a/library/io.po +++ b/library/io.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-23 19:49+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,7 +27,7 @@ msgid ":mod:`!io` --- Core tools for working with streams" msgstr "" msgid "**Source code:** :source:`Lib/io.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/io.py`" msgid "Overview" msgstr "Skorowidz" @@ -54,8 +52,8 @@ msgstr "" msgid "" "All streams are careful about the type of data you give to them. For " "example giving a :class:`str` object to the :meth:`!write` method of a " -"binary stream will raise a :exc:`TypeError`. So will giving a :class:" -"`bytes` object to the :meth:`!write` method of a text stream." +"binary stream will raise a :exc:`TypeError`. So will giving " +"a :class:`bytes` object to the :meth:`!write` method of a text stream." msgstr "" msgid "" @@ -89,8 +87,8 @@ msgid "f = io.StringIO(\"some initial text data\")" msgstr "" msgid "" -"The text stream API is described in detail in the documentation of :class:" -"`TextIOBase`." +"The text stream API is described in detail in the documentation " +"of :class:`TextIOBase`." msgstr "" msgid "Binary I/O" @@ -120,8 +118,8 @@ msgid "f = io.BytesIO(b\"some initial binary data: \\x00\\x01\")" msgstr "" msgid "" -"The binary stream API is described in detail in the docs of :class:" -"`BufferedIOBase`." +"The binary stream API is described in detail in the docs " +"of :class:`BufferedIOBase`." msgstr "" msgid "" @@ -146,6 +144,15 @@ msgid "" "The raw stream API is described in detail in the docs of :class:`RawIOBase`." msgstr "" +msgid "" +"Raw I/O is a low-level interface and methods generally must have their " +"return values checked and be explicitly retried to ensure an operation " +"completes. For instance :meth:`~RawIOBase.write` returns the number of bytes " +"written which may be less than the number of bytes provided (a partial " +"write). High-level I/O objects like :ref:`binary-io` and :ref:`text-io` " +"implement retry behavior." +msgstr "" + msgid "Text Encoding" msgstr "" @@ -195,18 +202,19 @@ msgid "See :pep:`597` for more details." msgstr "" msgid "" -"To find where the default locale encoding is used, you can enable the :" -"option:`-X warn_default_encoding <-X>` command line option or set the :" -"envvar:`PYTHONWARNDEFAULTENCODING` environment variable, which will emit an :" -"exc:`EncodingWarning` when the default encoding is used." +"To find where the default locale encoding is used, you can enable " +"the :option:`-X warn_default_encoding <-X>` command line option or set " +"the :envvar:`PYTHONWARNDEFAULTENCODING` environment variable, which will " +"emit an :exc:`EncodingWarning` when the default encoding is used." msgstr "" msgid "" "If you are providing an API that uses :func:`open` or :class:`TextIOWrapper` " -"and passes ``encoding=None`` as a parameter, you can use :func:" -"`text_encoding` so that callers of the API will emit an :exc:" -"`EncodingWarning` if they don't pass an ``encoding``. However, please " -"consider using UTF-8 by default (i.e. ``encoding=\"utf-8\"``) for new APIs." +"and passes ``encoding=None`` as a parameter, you can " +"use :func:`text_encoding` so that callers of the API will emit " +"an :exc:`EncodingWarning` if they don't pass an ``encoding``. However, " +"please consider using UTF-8 by default (i.e. ``encoding=\"utf-8\"``) for new " +"APIs." msgstr "" msgid "High-level Module Interface" @@ -214,8 +222,8 @@ msgstr "" msgid "" "An int containing the default buffer size used by the module's buffered I/O " -"classes. :func:`open` uses the file's blksize (as obtained by :func:`os." -"stat`) if possible." +"classes. :func:`open` uses the file's blksize (as obtained " +"by :func:`os.stat`) if possible." msgstr "" msgid "This is an alias for the builtin :func:`open` function." @@ -236,16 +244,16 @@ msgid "*path* should be a :class:`str` and an absolute path." msgstr "" msgid "" -"The behavior of this function may be overridden by an earlier call to the :c:" -"func:`PyFile_SetOpenCodeHook`. However, assuming that *path* is a :class:" -"`str` and an absolute path, ``open_code(path)`` should always behave the " -"same as ``open(path, 'rb')``. Overriding the behavior is intended for " -"additional validation or preprocessing of the file." +"The behavior of this function may be overridden by an earlier call to " +"the :c:func:`PyFile_SetOpenCodeHook`. However, assuming that *path* is " +"a :class:`str` and an absolute path, ``open_code(path)`` should always " +"behave the same as ``open(path, 'rb')``. Overriding the behavior is intended " +"for additional validation or preprocessing of the file." msgstr "" msgid "" -"This is a helper function for callables that use :func:`open` or :class:" -"`TextIOWrapper` and have an ``encoding=None`` parameter." +"This is a helper function for callables that use :func:`open` " +"or :class:`TextIOWrapper` and have an ``encoding=None`` parameter." msgstr "" msgid "" @@ -255,9 +263,10 @@ msgid "" msgstr "" msgid "" -"This function emits an :class:`EncodingWarning` if :data:`sys.flags." -"warn_default_encoding ` is true and *encoding* is ``None``. " -"*stacklevel* specifies where the warning is emitted. For example::" +"This function emits an :class:`EncodingWarning` " +"if :data:`sys.flags.warn_default_encoding ` is true and " +"*encoding* is ``None``. *stacklevel* specifies where the warning is emitted. " +"For example::" msgstr "" msgid "" @@ -311,8 +320,8 @@ msgstr "" msgid "" "The abstract base classes also provide default implementations of some " "methods in order to help implementation of concrete stream classes. For " -"example, :class:`BufferedIOBase` provides unoptimized implementations of :" -"meth:`!readinto` and :meth:`!readline`." +"example, :class:`BufferedIOBase` provides unoptimized implementations " +"of :meth:`!readinto` and :meth:`!readline`." msgstr "" msgid "" @@ -325,18 +334,20 @@ msgstr "" msgid "" "The :class:`RawIOBase` ABC extends :class:`IOBase`. It deals with the " -"reading and writing of bytes to a stream. :class:`FileIO` subclasses :class:" -"`RawIOBase` to provide an interface to files in the machine's file system." +"reading and writing of bytes to a stream. :class:`FileIO` " +"subclasses :class:`RawIOBase` to provide an interface to files in the " +"machine's file system." msgstr "" msgid "" "The :class:`BufferedIOBase` ABC extends :class:`IOBase`. It deals with " -"buffering on a raw binary stream (:class:`RawIOBase`). Its subclasses, :" -"class:`BufferedWriter`, :class:`BufferedReader`, and :class:`BufferedRWPair` " -"buffer raw binary streams that are writable, readable, and both readable and " -"writable, respectively. :class:`BufferedRandom` provides a buffered " -"interface to seekable streams. Another :class:`BufferedIOBase` subclass, :" -"class:`BytesIO`, is a stream of in-memory bytes." +"buffering on a raw binary stream (:class:`RawIOBase`). Its " +"subclasses, :class:`BufferedWriter`, :class:`BufferedReader`, " +"and :class:`BufferedRWPair` buffer raw binary streams that are writable, " +"readable, and both readable and writable, " +"respectively. :class:`BufferedRandom` provides a buffered interface to " +"seekable streams. Another :class:`BufferedIOBase` " +"subclass, :class:`BytesIO`, is a stream of in-memory bytes." msgstr "" msgid "" @@ -348,8 +359,8 @@ msgid "" msgstr "" msgid "" -"Argument names are not part of the specification, and only the arguments of :" -"func:`open` are intended to be used as keyword arguments." +"Argument names are not part of the specification, and only the arguments " +"of :func:`open` are intended to be used as keyword arguments." msgstr "" msgid "" @@ -429,9 +440,10 @@ msgid "" msgstr "" msgid "" -"The basic type used for binary data read from or written to a file is :class:" -"`bytes`. Other :term:`bytes-like objects ` are accepted " -"as method arguments too. Text I/O classes work with :class:`str` data." +"The basic type used for binary data read from or written to a file " +"is :class:`bytes`. Other :term:`bytes-like objects ` are " +"accepted as method arguments too. Text I/O classes work with :class:`str` " +"data." msgstr "" msgid "" @@ -448,9 +460,10 @@ msgid "" msgstr "" msgid "" -":class:`IOBase` is also a context manager and therefore supports the :" -"keyword:`with` statement. In this example, *file* is closed after the :" -"keyword:`!with` statement's suite is finished---even if an exception occurs::" +":class:`IOBase` is also a context manager and therefore supports " +"the :keyword:`with` statement. In this example, *file* is closed after " +"the :keyword:`!with` statement's suite is finished---even if an exception " +"occurs::" msgstr "" msgid "" @@ -547,14 +560,15 @@ msgid "The :data:`!SEEK_*` constants." msgstr "" msgid "" -"Some operating systems could support additional values, like :const:`os." -"SEEK_HOLE` or :const:`os.SEEK_DATA`. The valid values for a file could " -"depend on it being open in text or binary mode." +"Some operating systems could support additional values, " +"like :const:`os.SEEK_HOLE` or :const:`os.SEEK_DATA`. The valid values for a " +"file could depend on it being open in text or binary mode." msgstr "" msgid "" -"Return ``True`` if the stream supports random access. If ``False``, :meth:" -"`seek`, :meth:`tell` and :meth:`truncate` will raise :exc:`OSError`." +"Return ``True`` if the stream supports random access. If " +"``False``, :meth:`seek`, :meth:`tell` and :meth:`truncate` will " +"raise :exc:`OSError`." msgstr "" msgid "Return the current stream position." @@ -583,8 +597,8 @@ msgstr "" msgid "" "Prepare for object destruction. :class:`IOBase` provides a default " -"implementation of this method that calls the instance's :meth:`~IOBase." -"close` method." +"implementation of this method that calls the " +"instance's :meth:`~IOBase.close` method." msgstr "" msgid "Base class for raw binary streams. It inherits from :class:`IOBase`." @@ -598,15 +612,20 @@ msgid "" msgstr "" msgid "" -":class:`RawIOBase` provides these methods in addition to those from :class:" -"`IOBase`:" +":class:`RawIOBase` provides these methods in addition to those " +"from :class:`IOBase`:" msgstr "" msgid "" "Read up to *size* bytes from the object and return them. As a convenience, " -"if *size* is unspecified or -1, all bytes until EOF are returned. Otherwise, " -"only one system call is ever made. Fewer than *size* bytes may be returned " -"if the operating system call returns fewer than *size* bytes." +"if *size* is unspecified or -1, all bytes until EOF are returned." +msgstr "" + +msgid "" +"Attempts to make only one system call but will retry if interrupted and the " +"signal handler does not raise an exception (see :pep:`475` for the " +"rationale). This means fewer than *size* bytes may be returned if the " +"operating system call returns fewer than *size* bytes." msgstr "" msgid "" @@ -624,11 +643,22 @@ msgid "" "calls to the stream if necessary." msgstr "" +msgid "" +"If ``0`` bytes are returned this indicates end of file. If the object is in " +"non-blocking mode and the underlying :meth:`read` returns ``None`` " +"indicating no bytes are available, ``None`` is returned." +msgstr "" + msgid "" "Read bytes into a pre-allocated, writable :term:`bytes-like object` *b*, and " -"return the number of bytes read. For example, *b* might be a :class:" -"`bytearray`. If the object is in non-blocking mode and no bytes are " -"available, ``None`` is returned." +"return the number of bytes read. For example, *b* might be " +"a :class:`bytearray`." +msgstr "" + +msgid "" +"If ``0`` is returned and ``len(b)`` is not ``0``, this indicates end of " +"file. If the object is in non-blocking mode and no bytes are available, " +"``None`` is returned." msgstr "" msgid "" @@ -641,23 +671,31 @@ msgid "" "the implementation should only access *b* during the method call." msgstr "" +msgid "" +"This function does not ensure all bytes are written or an exception is " +"thrown. Callers may implement that behavior by checking the return value " +"and, if it is less than the length of *b*, looping with additional write " +"calls until all unwritten bytes are written. High-level I/O objects " +"like :ref:`binary-io` and :ref:`text-io` implement retry behavior." +msgstr "" + msgid "" "Base class for binary streams that support some kind of buffering. It " "inherits from :class:`IOBase`." msgstr "" msgid "" -"The main difference with :class:`RawIOBase` is that methods :meth:`read`, :" -"meth:`readinto` and :meth:`write` will try (respectively) to read as much " -"input as requested or to consume all given output, at the expense of making " -"perhaps more than one system call." +"The main difference with :class:`RawIOBase` is that " +"methods :meth:`read`, :meth:`readinto` and :meth:`write` will try " +"(respectively) to read as much input as requested or to emit all provided " +"data." msgstr "" msgid "" -"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``." +"In addition, if the underlying raw stream is in non-blocking mode, when the " +"system returns would block :meth:`write` will raise :exc:`BlockingIOError` " +"with :attr:`BlockingIOError.characters_written` and :meth:`read` will return " +"data read so far or ``None`` if no data is available." msgstr "" msgid "" @@ -666,9 +704,9 @@ msgid "" msgstr "" msgid "" -"A typical :class:`BufferedIOBase` implementation should not inherit from a :" -"class:`RawIOBase` implementation, but wrap one, like :class:`BufferedWriter` " -"and :class:`BufferedReader` do." +"A typical :class:`BufferedIOBase` implementation should not inherit from " +"a :class:`RawIOBase` implementation, but wrap one, " +"like :class:`BufferedWriter` and :class:`BufferedReader` do." msgstr "" msgid "" @@ -677,9 +715,9 @@ msgid "" msgstr "" msgid "" -"The underlying raw stream (a :class:`RawIOBase` instance) that :class:" -"`BufferedIOBase` deals with. This is not part of the :class:" -"`BufferedIOBase` API and may not exist on some implementations." +"The underlying raw stream (a :class:`RawIOBase` instance) " +"that :class:`BufferedIOBase` deals with. This is not part of " +"the :class:`BufferedIOBase` API and may not exist on some implementations." msgstr "" msgid "Separate the underlying raw stream from the buffer and return it." @@ -695,40 +733,44 @@ msgid "" 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." +"Read and return up to *size* bytes. If the argument is omitted, ``None``, or " +"negative read as much as possible." 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." +"Fewer bytes may be returned than requested. An empty :class:`bytes` object " +"is returned if the stream is already at EOF. More than one read may be made " +"and calls may be retried if specific errors are encountered, " +"see :meth:`os.read` and :pep:`475` for more details. Less than size bytes " +"being returned does not imply that EOF is imminent." 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." +"When reading as much as possible the default implementation will use " +"``raw.readall`` if available (which should " +"implement :meth:`RawIOBase.readall`), otherwise will read in a loop until " +"read returns ``None``, an empty :class:`bytes`, or a non-retryable error. " +"For most streams this is to EOF, but for non-blocking streams more data may " +"become available." msgstr "" msgid "" -"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." +"When the underlying raw stream is non-blocking, implementations may either " +"raise :exc:`BlockingIOError` or return ``None`` if no data is " +"available. :mod:`io` implementations return ``None``." msgstr "" msgid "" -"If *size* is ``-1`` (the default), an arbitrary number of bytes are returned " -"(more than zero unless EOF is reached)." +"Read and return up to *size* bytes, calling :meth:`~RawIOBase.readinto` " +"which may retry if :py:const:`~errno.EINTR` is encountered per :pep:`475`. " +"If *size* is ``-1`` or not provided, the implementation will choose an " +"arbitrary value for *size*." msgstr "" msgid "" "Read bytes into a pre-allocated, writable :term:`bytes-like object` *b* and " -"return the number of bytes read. For example, *b* might be a :class:" -"`bytearray`." +"return the number of bytes read. For example, *b* might be " +"a :class:`bytearray`." msgstr "" msgid "" @@ -736,11 +778,16 @@ msgid "" "stream, unless the latter is interactive." 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 bytes into a pre-allocated, writable :term:`bytes-like object` *b*, " -"using at most one call to the underlying raw stream's :meth:`~RawIOBase." -"read` (or :meth:`~RawIOBase.readinto`) method. Return the number of bytes " -"read." +"using at most one call to the underlying raw " +"stream's :meth:`~RawIOBase.read` (or :meth:`~RawIOBase.readinto`) method. " +"Return the number of bytes read." msgstr "" msgid "" @@ -767,7 +814,11 @@ msgstr "" msgid "" "A raw binary stream representing an OS-level file containing bytes data. It " -"inherits from :class:`RawIOBase`." +"inherits from :class:`RawIOBase` and implements its low-level access design. " +"This means :meth:`~RawIOBase.write` does not guarantee all bytes are written " +"and :meth:`~RawIOBase.read` may read less bytes than requested even when " +"more bytes may be present in the underlying file. To get \"write all\" and " +"\"read at least\" behavior, use :ref:`binary-io`." msgstr "" msgid "The *name* can be one of two things:" @@ -796,12 +847,6 @@ msgid "" "``'+'`` to the mode to allow simultaneous reading and writing." msgstr "" -msgid "" -"The :meth:`~RawIOBase.read` (when called with a positive argument), :meth:" -"`~RawIOBase.readinto` and :meth:`~RawIOBase.write` methods on this class " -"will only make one system call." -msgstr "" - msgid "" "A custom opener can be used by passing a callable as *opener*. The " "underlying file descriptor for the file object is then obtained by calling " @@ -818,6 +863,14 @@ msgid "" "parameter." msgstr "" +msgid "" +":class:`FileIO` is a low-level I/O object and members, such " +"as :meth:`~RawIOBase.read` and :meth:`~RawIOBase.write`, need to have their " +"return values checked explicitly in a retry loop to implement \"write all\" " +"and \"read at least\" behavior. High-level I/O objects :ref:`binary-io` " +"and :ref:`text-io` implement retry behavior." +msgstr "" + msgid "The *opener* parameter was added. The ``'x'`` mode was added." msgstr "" @@ -825,8 +878,8 @@ msgid "The file is now non-inheritable." msgstr "Plik nie jest teraz dziedziczony." msgid "" -":class:`FileIO` provides these data attributes in addition to those from :" -"class:`RawIOBase` and :class:`IOBase`:" +":class:`FileIO` provides these data attributes in addition to those " +"from :class:`RawIOBase` and :class:`IOBase`:" msgstr "" msgid "The mode as given in the constructor." @@ -846,9 +899,9 @@ msgid "" msgstr "" msgid "" -"A binary stream using an in-memory bytes buffer. It inherits from :class:" -"`BufferedIOBase`. The buffer is discarded when the :meth:`~IOBase.close` " -"method is called." +"A binary stream using an in-memory bytes buffer. It inherits " +"from :class:`BufferedIOBase`. The buffer is discarded when " +"the :meth:`~IOBase.close` method is called." msgstr "" msgid "" @@ -895,8 +948,8 @@ msgstr "" msgid "" "A buffered binary stream providing higher-level access to a readable, non " -"seekable :class:`RawIOBase` raw binary stream. It inherits from :class:" -"`BufferedIOBase`." +"seekable :class:`RawIOBase` raw binary stream. It inherits " +"from :class:`BufferedIOBase`." msgstr "" msgid "" @@ -907,8 +960,8 @@ msgstr "" msgid "" "The constructor creates a :class:`BufferedReader` for the given readable " -"*raw* stream and *buffer_size*. If *buffer_size* is omitted, :data:" -"`DEFAULT_BUFFER_SIZE` is used." +"*raw* stream and *buffer_size*. If *buffer_size* is " +"omitted, :data:`DEFAULT_BUFFER_SIZE` is used." msgstr "" msgid "" @@ -917,26 +970,24 @@ msgid "" 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." +"Return bytes from the stream without advancing the position. The number of " +"bytes returned may be less or more than requested. If the underlying raw " +"stream is non-blocking and the operation would block, returns empty bytes." 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." +"In :class:`BufferedReader` this is the same as :meth:`io.BufferedIOBase.read`" 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." +"In :class:`BufferedReader` this is the same " +"as :meth:`io.BufferedIOBase.read1`" msgstr "" msgid "" "A buffered binary stream providing higher-level access to a writeable, non " -"seekable :class:`RawIOBase` raw binary stream. It inherits from :class:" -"`BufferedIOBase`." +"seekable :class:`RawIOBase` raw binary stream. It inherits " +"from :class:`BufferedIOBase`." msgstr "" msgid "" @@ -961,8 +1012,8 @@ msgstr "" msgid "" "The constructor creates a :class:`BufferedWriter` for the given writeable " -"*raw* stream. If the *buffer_size* is not given, it defaults to :data:" -"`DEFAULT_BUFFER_SIZE`." +"*raw* stream. If the *buffer_size* is not given, it defaults " +"to :data:`DEFAULT_BUFFER_SIZE`." msgstr "" msgid "" @@ -971,50 +1022,51 @@ msgid "" msgstr "" msgid "" -"Force bytes held in the buffer into the raw stream. A :exc:" -"`BlockingIOError` should be raised if the raw stream blocks." +"Force bytes held in the buffer into the raw stream. " +"A :exc:`BlockingIOError` should be raised if the raw stream blocks." msgstr "" msgid "" "Write the :term:`bytes-like object`, *b*, and return the number of bytes " -"written. When in non-blocking mode, a :exc:`BlockingIOError` is raised if " -"the buffer needs to be written out but the raw stream blocks." +"written. When in non-blocking mode, a :exc:`BlockingIOError` " +"with :attr:`BlockingIOError.characters_written` set is raised if the buffer " +"needs to be written out but the raw stream blocks." msgstr "" msgid "" -"A buffered binary stream providing higher-level access to a seekable :class:" -"`RawIOBase` raw binary stream. It inherits from :class:`BufferedReader` " -"and :class:`BufferedWriter`." +"A buffered binary stream implementing :class:`BufferedIOBase` interfaces " +"providing higher-level access to a seekable :class:`RawIOBase` raw binary " +"stream." msgstr "" msgid "" "The constructor creates a reader and writer for a seekable raw stream, given " -"in the first argument. If the *buffer_size* is omitted it defaults to :data:" -"`DEFAULT_BUFFER_SIZE`." +"in the first argument. If the *buffer_size* is omitted it defaults " +"to :data:`DEFAULT_BUFFER_SIZE`." msgstr "" msgid "" -":class:`BufferedRandom` is capable of anything :class:`BufferedReader` or :" -"class:`BufferedWriter` can do. In addition, :meth:`~IOBase.seek` and :meth:" -"`~IOBase.tell` are guaranteed to be implemented." +":class:`BufferedRandom` is capable of anything :class:`BufferedReader` " +"or :class:`BufferedWriter` can do. In addition, :meth:`~IOBase.seek` " +"and :meth:`~IOBase.tell` are guaranteed to be implemented." msgstr "" msgid "" -"A buffered binary stream providing higher-level access to two non seekable :" -"class:`RawIOBase` raw binary streams---one readable, the other writeable. It " -"inherits from :class:`BufferedIOBase`." +"A buffered binary stream providing higher-level access to two non " +"seekable :class:`RawIOBase` raw binary streams---one readable, the other " +"writeable. It inherits from :class:`BufferedIOBase`." msgstr "" msgid "" "*reader* and *writer* are :class:`RawIOBase` objects that are readable and " -"writeable respectively. If the *buffer_size* is omitted it defaults to :" -"data:`DEFAULT_BUFFER_SIZE`." +"writeable respectively. If the *buffer_size* is omitted it defaults " +"to :data:`DEFAULT_BUFFER_SIZE`." msgstr "" msgid "" ":class:`BufferedRWPair` implements all of :class:`BufferedIOBase`\\'s " -"methods except for :meth:`~BufferedIOBase.detach`, which raises :exc:" -"`UnsupportedOperation`." +"methods except for :meth:`~BufferedIOBase.detach`, which " +"raises :exc:`UnsupportedOperation`." msgstr "" msgid "" @@ -1048,9 +1100,10 @@ msgid "" 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." +"The underlying binary buffer (a :class:`BufferedIOBase` " +"or :class:`RawIOBase` instance) that :class:`TextIOBase` deals with. This is " +"not part of the :class:`TextIOBase` API and may not exist in some " +"implementations." msgstr "" msgid "" @@ -1065,13 +1118,13 @@ msgstr "" msgid "" "Some :class:`TextIOBase` implementations, like :class:`StringIO`, may not " -"have the concept of an underlying buffer and calling this method will raise :" -"exc:`UnsupportedOperation`." +"have the concept of an underlying buffer and calling this method will " +"raise :exc:`UnsupportedOperation`." msgstr "" msgid "" -"Read and return at most *size* characters from the stream as a single :class:" -"`str`. If *size* is negative or ``None``, reads until EOF." +"Read and return at most *size* characters from the stream as a " +"single :class:`str`. If *size* is negative or ``None``, reads until EOF." msgstr "" msgid "" @@ -1117,14 +1170,15 @@ msgid "" msgstr "" msgid "" -"A buffered text stream providing higher-level access to a :class:" -"`BufferedIOBase` buffered binary stream. It inherits from :class:" -"`TextIOBase`." +"A buffered text stream providing higher-level access to " +"a :class:`BufferedIOBase` buffered binary stream. It inherits " +"from :class:`TextIOBase`." msgstr "" msgid "" "*encoding* gives the name of the encoding that the stream will be decoded or " -"encoded with. It defaults to :func:`locale.getencoding`. " +"encoded with. In :ref:`UTF-8 Mode `, this defaults to UTF-8. " +"Otherwise, 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 "" @@ -1149,10 +1203,10 @@ msgid "" msgstr "" msgid "" -"When reading input from the stream, if *newline* is ``None``, :term:" -"`universal newlines` mode is enabled. Lines in the input can end in " -"``'\\n'``, ``'\\r'``, or ``'\\r\\n'``, and these are translated into " -"``'\\n'`` before being returned to the caller. If *newline* is ``''``, " +"When reading input from the stream, if *newline* is " +"``None``, :term:`universal newlines` mode is enabled. Lines in the input " +"can end in ``'\\n'``, ``'\\r'``, or ``'\\r\\n'``, and these are translated " +"into ``'\\n'`` before being returned to the caller. If *newline* is ``''``, " "universal newlines mode is enabled, but line endings are returned to the " "caller untranslated. If *newline* has any of the other legal values, input " "lines are only terminated by the given string, and the line ending is " @@ -1161,10 +1215,10 @@ msgstr "" msgid "" "When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` " -"characters written are translated to the system default line separator, :" -"data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no translation " -"takes place. If *newline* is any of the other legal values, any ``'\\n'`` " -"characters written are translated to the given string." +"characters written are translated to the system default line " +"separator, :data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no " +"translation takes place. If *newline* is any of the other legal values, any " +"``'\\n'`` characters written are translated to the given string." msgstr "" "Podczas zapisywania danych wyjściowych do strumienia, jeśli *newline* ma " "wartość ``None``, wszelkie zapisane ``'\\n'`` znaki są tłumaczone na " @@ -1180,9 +1234,9 @@ msgstr "" msgid "" "If *write_through* is ``True``, calls to :meth:`~BufferedIOBase.write` are " -"guaranteed not to be buffered: any data written on the :class:" -"`TextIOWrapper` object is immediately handled to its underlying binary " -"*buffer*." +"guaranteed not to be buffered: any data written on " +"the :class:`TextIOWrapper` object is immediately handled to its underlying " +"binary *buffer*." msgstr "" msgid "The *write_through* argument has been added." @@ -1268,8 +1322,8 @@ msgid "" msgstr "" msgid "" -"A text stream using an in-memory text buffer. It inherits from :class:" -"`TextIOBase`." +"A text stream using an in-memory text buffer. It inherits " +"from :class:`TextIOBase`." msgstr "" msgid "" @@ -1278,10 +1332,10 @@ msgstr "" msgid "" "The initial value of the buffer can be set by providing *initial_value*. If " -"newline translation is enabled, newlines will be encoded as if by :meth:" -"`~TextIOBase.write`. The stream is positioned at the start of the buffer " -"which emulates opening an existing file in a ``w+`` mode, making it ready " -"for an immediate write from the beginning or for a write that would " +"newline translation is enabled, newlines will be encoded as if " +"by :meth:`~TextIOBase.write`. The stream is positioned at the start of the " +"buffer which emulates opening an existing file in a ``w+`` mode, making it " +"ready for an immediate write from the beginning or for a write that would " "overwrite the initial value. To emulate opening a file in an ``a+`` mode " "ready for appending, use ``f.seek(0, io.SEEK_END)`` to reposition the stream " "at the end of the buffer." @@ -1294,8 +1348,8 @@ msgid "" msgstr "" msgid "" -":class:`StringIO` provides this method in addition to those from :class:" -"`TextIOBase` and :class:`IOBase`:" +":class:`StringIO` provides this method in addition to those " +"from :class:`TextIOBase` and :class:`IOBase`:" msgstr "" msgid "" @@ -1352,9 +1406,9 @@ msgid "" "Text I/O over a binary storage (such as a file) is significantly slower than " "binary I/O over the same storage, because it requires conversions between " "unicode and binary data using a character codec. This can become noticeable " -"handling huge amounts of text data like large log files. Also, :meth:" -"`~TextIOBase.tell` and :meth:`~TextIOBase.seek` are both quite slow due to " -"the reconstruction algorithm used." +"handling huge amounts of text data like large log files. " +"Also, :meth:`~TextIOBase.tell` and :meth:`~TextIOBase.seek` are both quite " +"slow due to the reconstruction algorithm used." msgstr "" msgid "" @@ -1372,10 +1426,10 @@ msgid "" msgstr "" msgid "" -"Binary buffered objects (instances of :class:`BufferedReader`, :class:" -"`BufferedWriter`, :class:`BufferedRandom` and :class:`BufferedRWPair`) " -"protect their internal structures using a lock; it is therefore safe to call " -"them from multiple threads at once." +"Binary buffered objects (instances " +"of :class:`BufferedReader`, :class:`BufferedWriter`, :class:`BufferedRandom` " +"and :class:`BufferedRWPair`) protect their internal structures using a lock; " +"it is therefore safe to call them from multiple threads at once." msgstr "" msgid ":class:`TextIOWrapper` objects are not thread-safe." @@ -1385,13 +1439,13 @@ msgid "Reentrancy" msgstr "" msgid "" -"Binary buffered objects (instances of :class:`BufferedReader`, :class:" -"`BufferedWriter`, :class:`BufferedRandom` and :class:`BufferedRWPair`) are " -"not reentrant. While reentrant calls will not happen in normal situations, " -"they can arise from doing I/O in a :mod:`signal` handler. If a thread tries " -"to re-enter a buffered object which it is already accessing, a :exc:" -"`RuntimeError` is raised. Note this doesn't prohibit a different thread " -"from entering the buffered object." +"Binary buffered objects (instances " +"of :class:`BufferedReader`, :class:`BufferedWriter`, :class:`BufferedRandom` " +"and :class:`BufferedRWPair`) are not reentrant. While reentrant calls will " +"not happen in normal situations, they can arise from doing I/O in " +"a :mod:`signal` handler. If a thread tries to re-enter a buffered object " +"which it is already accessing, a :exc:`RuntimeError` is raised. Note this " +"doesn't prohibit a different thread from entering the buffered object." msgstr "" msgid "" diff --git a/library/ipaddress.po b/library/ipaddress.po index c4e825e516..c577130593 100644 --- a/library/ipaddress.po +++ b/library/ipaddress.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!ipaddress` --- IPv4/IPv6 manipulation library" msgstr "" msgid "**Source code:** :source:`Lib/ipaddress.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/ipaddress.py`" msgid "" ":mod:`ipaddress` provides the capabilities to create, manipulate and operate " @@ -43,8 +43,8 @@ msgid "" msgstr "" msgid "" -"This is the full module API reference—for an overview and introduction, see :" -"ref:`ipaddress-howto`." +"This is the full module API reference—for an overview and introduction, " +"see :ref:`ipaddress-howto`." msgstr "" msgid "Convenience factory functions" @@ -77,9 +77,9 @@ msgid "" "Return an :class:`IPv4Interface` or :class:`IPv6Interface` object depending " "on the IP address passed as argument. *address* is a string or integer " "representing the IP address. Either IPv4 or IPv6 addresses may be supplied; " -"integers less than ``2**32`` will be considered to be IPv4 by default. A :" -"exc:`ValueError` is raised if *address* does not represent a valid IPv4 or " -"IPv6 address." +"integers less than ``2**32`` will be considered to be IPv4 by default. " +"A :exc:`ValueError` is raised if *address* does not represent a valid IPv4 " +"or IPv6 address." msgstr "" msgid "" @@ -259,16 +259,31 @@ msgid "" msgstr "" msgid "" -"``True`` if the address is unspecified. See :RFC:`5735` (for IPv4) or :RFC:" -"`2373` (for IPv6)." +"``True`` if the address is unspecified. See :RFC:`5735` (for IPv4) " +"or :RFC:`2373` (for IPv6)." +msgstr "" + +msgid "" +"``True`` if the address is noted as reserved by the IETF. For IPv4, this is " +"only ``240.0.0.0/4``, the ``Reserved`` address block. For IPv6, this is all " +"addresses `allocated `__ as ``Reserved by IETF`` " +"for future use." msgstr "" -msgid "``True`` if the address is otherwise IETF reserved." +msgid "" +"For IPv4, ``is_reserved`` is not related to the address block value of the " +"``Reserved-by-Protocol`` column in iana-ipv4-special-registry_." +msgstr "" + +msgid "" +"For IPv6, ``fec0::/10`` a former Site-Local scoped address prefix is " +"currently excluded from that list (see :attr:`~IPv6Address.is_site_local` " +"& :rfc:`3879`)." msgstr "" msgid "" -"``True`` if this is a loopback address. See :RFC:`3330` (for IPv4) or :RFC:" -"`2373` (for IPv6)." +"``True`` if this is a loopback address. See :RFC:`3330` (for IPv4) " +"or :RFC:`2373` (for IPv6)." msgstr "" msgid "" @@ -276,8 +291,8 @@ msgid "" msgstr "" msgid "" -":class:`IPv4Address` object representing the IPv4-mapped IPv6 address. See :" -"RFC:`4291`." +":class:`IPv6Address` object representing the IPv4-mapped IPv6 address. " +"See :RFC:`4291`." msgstr "" msgid "" @@ -344,15 +359,15 @@ msgstr "" msgid "" "``True`` if the address is reserved for site-local usage. Note that the " -"site-local address space has been deprecated by :RFC:`3879`. Use :attr:" -"`~IPv4Address.is_private` to test if this address is in the space of unique " -"local addresses as defined by :RFC:`4193`." +"site-local address space has been deprecated by :RFC:`3879`. " +"Use :attr:`~IPv4Address.is_private` to test if this address is in the space " +"of unique local addresses as defined by :RFC:`4193`." msgstr "" msgid "" -"For addresses that appear to be IPv4 mapped addresses (starting with ``::" -"FFFF/96``), this property will report the embedded IPv4 address. For any " -"other address, this property will be ``None``." +"For addresses that appear to be IPv4 mapped addresses in the range " +"``::FFFF:0:0/96`` as defined by :RFC:`4291`, this property reports the " +"embedded IPv4 address. For any other address, this property will be ``None``." msgstr "" msgid "" @@ -495,10 +510,10 @@ msgstr "" msgid "" "All attributes implemented by address objects are implemented by network " "objects as well. In addition, network objects implement additional " -"attributes. All of these are common between :class:`IPv4Network` and :class:" -"`IPv6Network`, so to avoid duplication they are only documented for :class:" -"`IPv4Network`. Network objects are :term:`hashable`, so they can be used as " -"keys in dictionaries." +"attributes. All of these are common between :class:`IPv4Network` " +"and :class:`IPv6Network`, so to avoid duplication they are only documented " +"for :class:`IPv4Network`. Network objects are :term:`hashable`, so they can " +"be used as keys in dictionaries." msgstr "" msgid "" @@ -547,9 +562,9 @@ msgid "" msgstr "" msgid "" -"If *strict* is ``True`` and host bits are set in the supplied address, then :" -"exc:`ValueError` is raised. Otherwise, the host bits are masked out to " -"determine the appropriate network address." +"If *strict* is ``True`` and host bits are set in the supplied address, " +"then :exc:`ValueError` is raised. Otherwise, the host bits are masked out " +"to determine the appropriate network address." msgstr "" msgid "" @@ -625,8 +640,9 @@ msgstr "" msgid "" "Computes the network definitions resulting from removing the given *network* " -"from this one. Returns an iterator of network objects. Raises :exc:" -"`ValueError` if *network* is not completely contained in this network." +"from this one. Returns an iterator of network objects. " +"Raises :exc:`ValueError` if *network* is not completely contained in this " +"network." msgstr "" msgid "" @@ -675,14 +691,15 @@ msgid "" msgstr "" msgid "" -"Note that currently expanded netmasks are not supported. That means ``2001:" -"db00::0/24`` is a valid argument while ``2001:db00::0/ffff:ff00::`` is not." +"Note that currently expanded netmasks are not supported. That means " +"``2001:db00::0/24`` is a valid argument while ``2001:db00::0/ffff:ff00::`` " +"is not." msgstr "" msgid "" "An integer that fits into 128 bits. This is equivalent to a single-address " -"network, with the network address being *address* and the mask being " -"``/128``." +"network, with the network address being *address* and the mask being ``/" +"128``." msgstr "" msgid "" @@ -868,33 +885,33 @@ msgstr "" msgid "" "Represent an address as 4 packed bytes in network (big-endian) order. " -"*address* is an integer representation of an IPv4 IP address. A :exc:" -"`ValueError` is raised if the integer is negative or too large to be an IPv4 " -"IP address." +"*address* is an integer representation of an IPv4 IP address. " +"A :exc:`ValueError` is raised if the integer is negative or too large to be " +"an IPv4 IP address." msgstr "" msgid "" "Represent an address as 16 packed bytes in network (big-endian) order. " -"*address* is an integer representation of an IPv6 IP address. A :exc:" -"`ValueError` is raised if the integer is negative or too large to be an IPv6 " -"IP address." +"*address* is an integer representation of an IPv6 IP address. " +"A :exc:`ValueError` is raised if the integer is negative or too large to be " +"an IPv6 IP address." msgstr "" msgid "" "Return an iterator of the summarized network range given the first and last " -"IP addresses. *first* is the first :class:`IPv4Address` or :class:" -"`IPv6Address` in the range and *last* is the last :class:`IPv4Address` or :" -"class:`IPv6Address` in the range. A :exc:`TypeError` is raised if *first* " -"or *last* are not IP addresses or are not of the same version. A :exc:" -"`ValueError` is raised if *last* is not greater than *first* or if *first* " -"address version is not 4 or 6." +"IP addresses. *first* is the first :class:`IPv4Address` " +"or :class:`IPv6Address` in the range and *last* is the " +"last :class:`IPv4Address` or :class:`IPv6Address` in the range. " +"A :exc:`TypeError` is raised if *first* or *last* are not IP addresses or " +"are not of the same version. A :exc:`ValueError` is raised if *last* is not " +"greater than *first* or if *first* address version is not 4 or 6." msgstr "" msgid "" -"Return an iterator of the collapsed :class:`IPv4Network` or :class:" -"`IPv6Network` objects. *addresses* is an :term:`iterable` of :class:" -"`IPv4Network` or :class:`IPv6Network` objects. A :exc:`TypeError` is raised " -"if *addresses* contains mixed version objects." +"Return an iterator of the collapsed :class:`IPv4Network` " +"or :class:`IPv6Network` objects. *addresses* is an :term:`iterable` " +"of :class:`IPv4Network` or :class:`IPv6Network` objects. A :exc:`TypeError` " +"is raised if *addresses* contains mixed version objects." msgstr "" msgid "" diff --git a/library/ipc.po b/library/ipc.po index a7ce7cf8d0..b0fc7bb993 100644 --- a/library/ipc.po +++ b/library/ipc.po @@ -32,9 +32,9 @@ msgid "" msgstr "" msgid "" -"Some modules only work for two processes that are on the same machine, e.g. :" -"mod:`signal` and :mod:`mmap`. Other modules support networking protocols " -"that two or more processes can use to communicate across machines." +"Some modules only work for two processes that are on the same machine, " +"e.g. :mod:`signal` and :mod:`mmap`. Other modules support networking " +"protocols that two or more processes can use to communicate across machines." msgstr "" msgid "The list of modules described in this chapter is:" diff --git a/library/itertools.po b/library/itertools.po index 8f6cd6e0c1..d4c9b53ac4 100644 --- a/library/itertools.po +++ b/library/itertools.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -78,7 +77,7 @@ msgid ":func:`cycle`" msgstr ":func:`cycle`" msgid "p" -msgstr "" +msgstr "p" msgid "p0, p1, ... plast, p0, p1, ..." msgstr "" @@ -291,19 +290,19 @@ msgid "Examples" msgstr "Przykłady" msgid "``product('ABCD', repeat=2)``" -msgstr "" +msgstr "``product('ABCD', repeat=2)``" msgid "``AA AB AC AD BA BB BC BD CA CB CC CD DA DB DC DD``" msgstr "" msgid "``permutations('ABCD', 2)``" -msgstr "" +msgstr "``permutations('ABCD', 2)``" msgid "``AB AC AD BA BC BD CA CB CD DA DB DC``" msgstr "" msgid "``combinations('ABCD', 2)``" -msgstr "" +msgstr "``combinations('ABCD', 2)``" msgid "``AB AC AD BC BD CD``" msgstr "" @@ -464,9 +463,9 @@ msgstr "" msgid "" "The output is a subsequence of :func:`product` keeping only entries that are " -"subsequences of the *iterable*. The length of the output is given by :func:" -"`math.comb` which computes ``n! / r! / (n - r)!`` when ``0 ≤ r ≤ n`` or zero " -"when ``r > n``." +"subsequences of the *iterable*. The length of the output is given " +"by :func:`math.comb` which computes ``n! / r! / (n - r)!`` when ``0 ≤ r ≤ " +"n`` or zero when ``r > n``." msgstr "" msgid "" @@ -564,8 +563,8 @@ msgstr "" msgid "" "Make an iterator that returns evenly spaced values beginning with *start*. " -"Can be used with :func:`map` to generate consecutive data points or with :" -"func:`zip` to add sequence numbers. Roughly equivalent to::" +"Can be used with :func:`map` to generate consecutive data points or " +"with :func:`zip` to add sequence numbers. Roughly equivalent to::" msgstr "" msgid "" @@ -673,9 +672,9 @@ msgstr "" msgid "" "The returned group is itself an iterator that shares the underlying iterable " -"with :func:`groupby`. Because the source is shared, when the :func:" -"`groupby` object is advanced, the previous group is no longer visible. So, " -"if that data is needed later, it should be stored as a list::" +"with :func:`groupby`. Because the source is shared, when " +"the :func:`groupby` object is advanced, the previous group is no longer " +"visible. So, if that data is needed later, it should be stored as a list::" msgstr "" msgid "" @@ -795,8 +794,8 @@ msgid "" msgstr "" msgid "" -"Return successive *r* length `permutations of elements `_ from the *iterable*." +"Return successive *r* length `permutations of elements `_ from the *iterable*." msgstr "" msgid "" @@ -806,9 +805,9 @@ msgstr "" msgid "" "The output is a subsequence of :func:`product` where entries with repeated " -"elements have been filtered out. The length of the output is given by :func:" -"`math.perm` which computes ``n! / (n - r)!`` when ``0 ≤ r ≤ n`` or zero when " -"``r > n``." +"elements have been filtered out. The length of the output is given " +"by :func:`math.perm` which computes ``n! / (n - r)!`` when ``0 ≤ r ≤ n`` or " +"zero when ``r > n``." msgstr "" msgid "" @@ -969,8 +968,9 @@ msgid "" "the input iterator and there is no way to access it. This could be an issue " "if an application wants to further consume the input iterator after " "*takewhile* has been run to exhaustion. To work around this problem, " -"consider using `more-itertools before_and_after() `_ instead." +"consider using `more-itertools before_and_after() `_ instead." msgstr "" msgid "Return *n* independent iterators from a single iterable." @@ -1014,9 +1014,9 @@ msgstr "" msgid "" "When the input *iterable* is already a tee iterator object, all members of " "the return tuple are constructed as if they had been produced by the " -"upstream :func:`tee` call. This \"flattening step\" allows nested :func:" -"`tee` calls to share the same underlying data chain and to have a single " -"update step rather than a chain of calls." +"upstream :func:`tee` call. This \"flattening step\" allows " +"nested :func:`tee` calls to share the same underlying data chain and to have " +"a single update step rather than a chain of calls." msgstr "" msgid "The flattening property makes tee iterators efficiently peekable:" @@ -1049,8 +1049,8 @@ msgstr "" msgid "" "This itertool may require significant auxiliary storage (depending on how " "much temporary data needs to be stored). In general, if one iterator uses " -"most or all of the data before another iterator starts, it is faster to use :" -"func:`list` instead of :func:`tee`." +"most or all of the data before another iterator starts, it is faster to " +"use :func:`list` instead of :func:`tee`." msgstr "" msgid "Make an iterator that aggregates elements from each of the *iterables*." @@ -1089,9 +1089,9 @@ msgid "" msgstr "" msgid "" -"If one of the iterables is potentially infinite, then the :func:" -"`zip_longest` function should be wrapped with something that limits the " -"number of calls (for example :func:`islice` or :func:`takewhile`)." +"If one of the iterables is potentially infinite, then " +"the :func:`zip_longest` function should be wrapped with something that " +"limits the number of calls (for example :func:`islice` or :func:`takewhile`)." msgstr "" msgid "Itertools Recipes" @@ -1108,9 +1108,9 @@ msgid "" "``chain.from_iterable`` is related to the concept of flattening. The " "recipes also give ideas about ways that the tools can be combined — for " "example, how ``starmap()`` and ``repeat()`` can work together. The recipes " -"also show patterns for using itertools with the :mod:`operator` and :mod:" -"`collections` modules as well as with the built-in itertools such as " -"``map()``, ``filter()``, ``reversed()``, and ``enumerate()``." +"also show patterns for using itertools with the :mod:`operator` " +"and :mod:`collections` modules as well as with the built-in itertools such " +"as ``map()``, ``filter()``, ``reversed()``, and ``enumerate()``." msgstr "" msgid "" @@ -1144,7 +1144,7 @@ msgid "" "from contextlib import suppress\n" "from functools import reduce\n" "from math import comb, prod, sumprod, isqrt\n" -"from operator import itemgetter, getitem, mul, neg\n" +"from operator import itemgetter, getitem, mul, neg, truediv\n" "\n" "def take(n, iterable):\n" " \"Return first n items of the iterable as a list.\"\n" @@ -1155,9 +1155,10 @@ msgid "" " # prepend(1, [2, 3, 4]) → 1 2 3 4\n" " return chain([value], iterable)\n" "\n" -"def tabulate(function, start=0):\n" -" \"Return function(0), function(1), ...\"\n" -" return map(function, count(start))\n" +"def running_mean(iterable):\n" +" \"Yield the average of all values seen so far.\"\n" +" # running_mean([8.5, 9.5, 7.5, 6.5]) → 8.5 9.0 8.5 8.0\n" +" return map(truediv, accumulate(iterable), count(1))\n" "\n" "def repeatfunc(function, times=None, *args):\n" " \"Repeat calls to a function with specified arguments.\"\n" @@ -1239,10 +1240,10 @@ msgid "" " yield element\n" "\n" "def unique(iterable, key=None, reverse=False):\n" -" \"Yield unique elements in sorted order. Supports unhashable inputs.\"\n" -" # unique([[1, 2], [3, 4], [1, 2]]) → [1, 2] [3, 4]\n" -" sequenced = sorted(iterable, key=key, reverse=reverse)\n" -" return unique_justseen(sequenced, key=key)\n" +" \"Yield unique elements in sorted order. Supports unhashable inputs.\"\n" +" # unique([[1, 2], [3, 4], [1, 2]]) → [1, 2] [3, 4]\n" +" sequenced = sorted(iterable, key=key, reverse=reverse)\n" +" return unique_justseen(sequenced, key=key)\n" "\n" "def sliding_window(iterable, n):\n" " \"Collect data into overlapping fixed-length chunks or blocks.\"\n" diff --git a/library/json.po b/library/json.po index fea63b357d..29ccfacd65 100644 --- a/library/json.po +++ b/library/json.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Igor Zubrycki , 2021 -# Waldemar Stoczkowski, 2023 -# haaritsubaki, 2023 -# Maciej Olko , 2025 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,15 +27,21 @@ msgid ":mod:`!json` --- JSON encoder and decoder" msgstr "" msgid "**Source code:** :source:`Lib/json/__init__.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/json/__init__.py`" msgid "" -"`JSON (JavaScript Object Notation) `_, specified by :rfc:" -"`7159` (which obsoletes :rfc:`4627`) and by `ECMA-404 `_, specified " +"by :rfc:`7159` (which obsoletes :rfc:`4627`) and by `ECMA-404 `_, is a " -"lightweight data interchange format inspired by `JavaScript `_ object literal syntax (although it is not a " -"strict subset of JavaScript [#rfc-errata]_ )." +"lightweight data interchange format inspired by `JavaScript `_ object literal syntax (although it is " +"not a strict subset of JavaScript [#rfc-errata]_ )." +msgstr "" + +msgid "" +"The term \"object\" in the context of JSON processing in Python can be " +"ambiguous. All values in Python are objects. In JSON, an object refers to " +"any data wrapped in curly braces, similar to a Python dictionary." msgstr "" msgid "" @@ -49,8 +51,8 @@ msgid "" msgstr "" msgid "" -":mod:`json` exposes an API familiar to users of the standard library :mod:" -"`marshal` and :mod:`pickle` modules." +"This module exposes an API familiar to users of the standard " +"library :mod:`marshal` and :mod:`pickle` modules." msgstr "" msgid "Encoding basic Python object hierarchies::" @@ -96,15 +98,15 @@ msgid "" "}" msgstr "" -msgid "Specializing JSON object encoding::" +msgid "Customizing JSON object encoding::" msgstr "" msgid "" ">>> import json\n" ">>> def custom_json(obj):\n" "... if isinstance(obj, complex):\n" -"... return {'__complex__': True, 'real': obj.real, 'imag': obj." -"imag}\n" +"... return {'__complex__': True, 'real': obj.real, 'imag': " +"obj.imag}\n" "... raise TypeError(f'Cannot serialize object of {type(obj)}')\n" "...\n" ">>> json.dumps(1 + 2j, default=custom_json)\n" @@ -126,7 +128,7 @@ msgid "" "['streaming API']" msgstr "" -msgid "Specializing JSON object decoding::" +msgid "Customizing JSON object decoding::" msgstr "" msgid "" @@ -219,15 +221,17 @@ msgid "" msgstr "" msgid "" -"If ``True``, keys that are not of a basic type (:class:`str`, :class:`int`, :" -"class:`float`, :class:`bool`, ``None``) will be skipped instead of raising " -"a :exc:`TypeError`. Default ``False``." +"If ``True``, keys that are not of a basic type " +"(:class:`str`, :class:`int`, :class:`float`, :class:`bool`, ``None``) will " +"be skipped instead of raising a :exc:`TypeError`. Default ``False``." msgstr "" msgid "" "If ``True`` (the default), the output is guaranteed to have all incoming non-" -"ASCII characters escaped. If ``False``, these characters will be outputted " -"as-is." +"ASCII and non-printable characters escaped. If ``False``, all characters " +"will be outputted as-is, except for the characters that must be escaped: " +"quotation mark, reverse solidus, and the control characters U+0000 through " +"U+001F." msgstr "" msgid "" @@ -254,7 +258,7 @@ msgid "" "be pretty-printed with that indent level. A positive integer indents that " "many spaces per level; a string (such as ``\"\\t\"``) is used to indent each " "level. If zero, negative, or ``\"\"`` (the empty string), only newlines are " -"inserted. If ``None`` (the default), the most compact representation is used." +"inserted. If ``None`` (the default), no newlines are inserted." msgstr "" msgid "" @@ -266,14 +270,24 @@ msgstr "" msgid "" "A function that is called for objects that can't otherwise be serialized. It " -"should return a JSON encodable version of the object or raise a :exc:" -"`TypeError`. If ``None`` (the default), :exc:`!TypeError` is raised." +"should return a JSON encodable version of the object or raise " +"a :exc:`TypeError`. If ``None`` (the default), :exc:`!TypeError` is raised." msgstr "" msgid "" "If ``True``, dictionaries will be outputted sorted by key. Default ``False``." msgstr "" +msgid "" +"Keys in key/value pairs of JSON are always of the type :class:`str`. When a " +"dictionary is converted into JSON, all the keys of the dictionary are " +"converted to strings. As a result of this, if a dictionary is converted into " +"JSON and then back into a dictionary, the dictionary may not equal the " +"original one. That is, ``loads(dumps(x)) != x`` if x has non-string keys. " +"*sort_keys* sorts the keys before they are converted to strings, so numeric " +"keys are sorted by value, not by their string representation." +msgstr "" + msgid "Allow strings for *indent* in addition to integers." msgstr "" @@ -286,16 +300,8 @@ msgstr "" msgid "" "Serialize *obj* to a JSON formatted :class:`str` using this :ref:`conversion " -"table `. The arguments have the same meaning as in :func:" -"`dump`." -msgstr "" - -msgid "" -"Keys in key/value pairs of JSON are always of the type :class:`str`. When a " -"dictionary is converted into JSON, all the keys of the dictionary are " -"coerced to strings. As a result of this, if a dictionary is converted into " -"JSON and then back into a dictionary, the dictionary may not equal the " -"original one. That is, ``loads(dumps(x)) != x`` if x has non-string keys." +"table `. The arguments have the same meaning as " +"in :func:`dump`." msgstr "" msgid "" @@ -310,12 +316,12 @@ msgstr "" msgid "" "If set, a custom JSON decoder. Additional keyword arguments to :func:`!load` " -"will be passed to the constructor of *cls*. If ``None`` (the default), :" -"class:`!JSONDecoder` is used." +"will be passed to the constructor of *cls*. If ``None`` (the " +"default), :class:`!JSONDecoder` is used." msgstr "" msgid "" -"If set, a function that is called with the result of any object literal " +"If set, a function that is called with the result of any JSON object literal " "decoded (a :class:`dict`). The return value of this function will be used " "instead of the :class:`dict`. This feature can be used to implement custom " "decoders, for example `JSON-RPC `_ class hinting. " @@ -323,7 +329,7 @@ msgid "" msgstr "" msgid "" -"If set, a function that is called with the result of any object literal " +"If set, a function that is called with the result of any JSON object literal " "decoded with an ordered list of pairs. The return value of this function " "will be used instead of the :class:`dict`. This feature can be used to " "implement custom decoders. If *object_hook* is also set, *object_pairs_hook* " @@ -333,15 +339,15 @@ msgstr "" msgid "" "If set, a function that is called with the string of every JSON float to be " "decoded. If ``None`` (the default), it is equivalent to ``float(num_str)``. " -"This can be used to parse JSON floats into custom datatypes, for example :" -"class:`decimal.Decimal`." +"This can be used to parse JSON floats into custom datatypes, for " +"example :class:`decimal.Decimal`." msgstr "" msgid "" "If set, a function that is called with the string of every JSON int to be " "decoded. If ``None`` (the default), it is equivalent to ``int(num_str)``. " -"This can be used to parse JSON integers into custom datatypes, for example :" -"class:`float`." +"This can be used to parse JSON integers into custom datatypes, for " +"example :class:`float`." msgstr "" msgid "" @@ -406,7 +412,7 @@ msgid "JSON" msgstr "" msgid "Python" -msgstr "" +msgstr "Python" msgid "object" msgstr "obiekt" @@ -464,16 +470,16 @@ msgstr "" msgid "" "*object_hook* is an optional function that will be called with the result of " "every JSON object decoded and its return value will be used in place of the " -"given :class:`dict`. This can be used to provide custom deserializations (e." -"g. to support `JSON-RPC `_ class hinting)." +"given :class:`dict`. This can be used to provide custom deserializations " +"(e.g. to support `JSON-RPC `_ class hinting)." msgstr "" msgid "" "*object_pairs_hook* is an optional function that will be called with the " "result of every JSON object decoded with an ordered list of pairs. The " -"return value of *object_pairs_hook* will be used instead of the :class:" -"`dict`. This feature can be used to implement custom decoders. If " -"*object_hook* is also defined, the *object_pairs_hook* takes priority." +"return value of *object_pairs_hook* will be used instead of " +"the :class:`dict`. This feature can be used to implement custom decoders. " +"If *object_hook* is also defined, the *object_pairs_hook* takes priority." msgstr "" msgid "Added support for *object_pairs_hook*." @@ -507,8 +513,8 @@ msgid "" msgstr "" msgid "" -"If the data being deserialized is not a valid JSON document, a :exc:" -"`JSONDecodeError` will be raised." +"If the data being deserialized is not a valid JSON document, " +"a :exc:`JSONDecodeError` will be raised." msgstr "" msgid "All parameters are now :ref:`keyword-only `." @@ -554,23 +560,25 @@ msgid "Added support for int- and float-derived Enum classes." msgstr "" msgid "" -"To extend this to recognize other objects, subclass and implement a :meth:" -"`~JSONEncoder.default` method with another method that returns a " +"To extend this to recognize other objects, subclass and implement " +"a :meth:`~JSONEncoder.default` method with another method that returns a " "serializable object for ``o`` if possible, otherwise it should call the " "superclass implementation (to raise :exc:`TypeError`)." msgstr "" msgid "" "If *skipkeys* is false (the default), a :exc:`TypeError` will be raised when " -"trying to encode keys that are not :class:`str`, :class:`int`, :class:" -"`float`, :class:`bool` or ``None``. If *skipkeys* is true, such items are " -"simply skipped." +"trying to encode keys that are " +"not :class:`str`, :class:`int`, :class:`float`, :class:`bool` or ``None``. " +"If *skipkeys* is true, such items are simply skipped." msgstr "" msgid "" "If *ensure_ascii* is true (the default), the output is guaranteed to have " -"all incoming non-ASCII characters escaped. If *ensure_ascii* is false, " -"these characters will be output as-is." +"all incoming non-ASCII and non-printable characters escaped. If " +"*ensure_ascii* is false, all characters will be output as-is, except for the " +"characters that must be escaped: quotation mark, reverse solidus, and the " +"control characters U+0000 through U+001F." msgstr "" msgid "" @@ -612,19 +620,19 @@ msgstr "" msgid "" "If specified, *default* should be a function that gets called for objects " "that can't otherwise be serialized. It should return a JSON encodable " -"version of the object or raise a :exc:`TypeError`. If not specified, :exc:" -"`TypeError` is raised." +"version of the object or raise a :exc:`TypeError`. If not " +"specified, :exc:`TypeError` is raised." msgstr "" msgid "" "Implement this method in a subclass such that it returns a serializable " -"object for *o*, or calls the base implementation (to raise a :exc:" -"`TypeError`)." +"object for *o*, or calls the base implementation (to raise " +"a :exc:`TypeError`)." msgstr "" msgid "" -"For example, to support arbitrary iterators, you could implement :meth:" -"`~JSONEncoder.default` like this::" +"For example, to support arbitrary iterators, you could " +"implement :meth:`~JSONEncoder.default` like this::" msgstr "" msgid "" @@ -724,7 +732,7 @@ msgstr "" msgid "" "As permitted, though not required, by the RFC, this module's serializer sets " "*ensure_ascii=True* by default, thus escaping the output so that the " -"resulting strings only contain ASCII characters." +"resulting strings only contain printable ASCII characters." msgstr "" msgid "" @@ -746,8 +754,8 @@ msgid "" "The RFC does not explicitly forbid JSON strings which contain byte sequences " "that don't correspond to valid Unicode characters (e.g. unpaired UTF-16 " "surrogates), but it does note that they may cause interoperability problems. " -"By default, this module accepts and outputs (when present in the original :" -"class:`str`) code points for such sequences." +"By default, this module accepts and outputs (when present in the " +"original :class:`str`) code points for such sequences." msgstr "" msgid "Infinite and NaN Number Values" @@ -855,7 +863,7 @@ msgid "Command Line Interface" msgstr "Interfejs linii komend" msgid "**Source code:** :source:`Lib/json/tool.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/json/tool.py`" msgid "" "The :mod:`json.tool` module provides a simple command line interface to " @@ -863,8 +871,9 @@ msgid "" msgstr "" msgid "" -"If the optional ``infile`` and ``outfile`` arguments are not specified, :" -"data:`sys.stdin` and :data:`sys.stdout` will be used respectively:" +"If the optional ``infile`` and ``outfile`` arguments are not " +"specified, :data:`sys.stdin` and :data:`sys.stdout` will be used " +"respectively:" msgstr "" msgid "" diff --git a/library/keyword.po b/library/keyword.po index d5dda6d39b..8406e264e4 100644 --- a/library/keyword.po +++ b/library/keyword.po @@ -30,8 +30,8 @@ msgid "**Source code:** :source:`Lib/keyword.py`" msgstr "" msgid "" -"This module allows a Python program to determine if a string is a :ref:" -"`keyword ` or :ref:`soft keyword `." +"This module allows a Python program to determine if a string is " +"a :ref:`keyword ` or :ref:`soft keyword `." msgstr "" msgid "Return ``True`` if *s* is a Python :ref:`keyword `." @@ -39,8 +39,9 @@ msgstr "" msgid "" "Sequence containing all the :ref:`keywords ` defined for the " -"interpreter. If any keywords are defined to only be active when particular :" -"mod:`__future__` statements are in effect, these will be included as well." +"interpreter. If any keywords are defined to only be active when " +"particular :mod:`__future__` statements are in effect, these will be " +"included as well." msgstr "" msgid "Return ``True`` if *s* is a Python :ref:`soft keyword `." diff --git a/library/linecache.po b/library/linecache.po index af49ed3d6a..a10947f842 100644 --- a/library/linecache.po +++ b/library/linecache.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,14 +27,14 @@ msgid ":mod:`!linecache` --- Random access to text lines" msgstr "" msgid "**Source code:** :source:`Lib/linecache.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/linecache.py`" msgid "" "The :mod:`linecache` module allows one to get any line from a Python source " "file, while attempting to optimize internally, using a cache, the common " -"case where many lines are read from a single file. This is used by the :mod:" -"`traceback` module to retrieve source lines for inclusion in the formatted " -"traceback." +"case where many lines are read from a single file. This is used by " +"the :mod:`traceback` module to retrieve source lines for inclusion in the " +"formatted traceback." msgstr "" msgid "" @@ -54,12 +53,12 @@ msgid "" msgstr "" msgid "" -"If a file named *filename* is not found, the function first checks for a :" -"pep:`302` ``__loader__`` in *module_globals*. If there is such a loader and " -"it defines a ``get_source`` method, then that determines the source lines " -"(if ``get_source()`` returns ``None``, then ``''`` is returned). Finally, if " -"*filename* is a relative filename, it is looked up relative to the entries " -"in the module search path, ``sys.path``." +"If a file named *filename* is not found, the function first checks for " +"a :pep:`302` ``__loader__`` in *module_globals*. If there is such a loader " +"and it defines a ``get_source`` method, then that determines the source " +"lines (if ``get_source()`` returns ``None``, then ``''`` is returned). " +"Finally, if *filename* is a relative filename, it is looked up relative to " +"the entries in the module search path, ``sys.path``." msgstr "" msgid "" diff --git a/library/locale.po b/library/locale.po index 1ae96f70a2..d4b63da26b 100644 --- a/library/locale.po +++ b/library/locale.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:08+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!locale` --- Internationalization services" msgstr "" msgid "**Source code:** :source:`Lib/locale.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/locale.py`" msgid "" "The :mod:`locale` module opens access to the POSIX locale database and " @@ -53,22 +52,43 @@ msgstr "" msgid "" "If *locale* is given and not ``None``, :func:`setlocale` modifies the locale " "setting for the *category*. The available categories are listed in the data " -"description below. *locale* may be a string, or an iterable of two strings " -"(language code and encoding). If it's an iterable, it's converted to a " -"locale name using the locale aliasing engine. An empty string specifies the " -"user's default settings. If the modification of the locale fails, the " +"description below. *locale* may be a :ref:`string `, or a pair, " +"language code and encoding. An empty string specifies the user's default " +"settings. If the modification of the locale fails, the " "exception :exc:`Error` is raised. If successful, the new locale setting is " "returned." msgstr "" +msgid "" +"If *locale* is a pair, it is converted to a locale name using the locale " +"aliasing engine. The language code has the same format as a :ref:`locale " +"name `, but without encoding and ``@``-modifier. The language " +"code and encoding can be ``None``." +msgstr "" + msgid "" "If *locale* is omitted or ``None``, the current setting for *category* is " "returned." msgstr "" +msgid "Example::" +msgstr "Przykład::" + +msgid "" +">>> import locale\n" +">>> loc = locale.setlocale(locale.LC_ALL) # get current locale\n" +"# use German locale; name and availability varies with platform\n" +">>> locale.setlocale(locale.LC_ALL, 'de_DE.UTF-8')\n" +">>> locale.strcoll('f\\xe4n', 'foo') # compare a string containing an " +"umlaut\n" +">>> locale.setlocale(locale.LC_ALL, '') # use user's preferred locale\n" +">>> locale.setlocale(locale.LC_ALL, 'C') # use default (C) locale\n" +">>> locale.setlocale(locale.LC_ALL, loc) # restore saved locale" +msgstr "" + msgid "" ":func:`setlocale` is not thread-safe on most systems. Applications typically " -"start with a call of ::" +"start with a call of::" msgstr "" msgid "" @@ -111,9 +131,9 @@ msgstr "" msgid "" "Sequence of numbers specifying which relative positions the " -"``'thousands_sep'`` is expected. If the sequence is terminated with :const:" -"`CHAR_MAX`, no further grouping is performed. If the sequence terminates " -"with a ``0``, the last group size is repeatedly used." +"``'thousands_sep'`` is expected. If the sequence is terminated " +"with :const:`CHAR_MAX`, no further grouping is performed. If the sequence " +"terminates with a ``0``, the last group size is repeatedly used." msgstr "" msgid "``'thousands_sep'``" @@ -368,8 +388,8 @@ msgid "" "the ``E`` modifier in their format strings causes the :func:`time.strftime` " "function to use this information. The format of the returned string is " "specified in *The Open Group Base Specifications Issue 8*, paragraph " -"`7.3.5.2 LC_TIME C-Language Access `_." +"`7.3.5.2 LC_TIME C-Language Access `_." msgstr "" msgid "" @@ -416,15 +436,17 @@ msgid "" msgstr "" msgid "" -"Except for the code ``'C'``, the language code corresponds to :rfc:`1766`. " -"*language code* and *encoding* may be ``None`` if their values cannot be " -"determined." +"The language code has the same format as a :ref:`locale name `, " +"but without encoding and ``@``-modifier. The language code and encoding may " +"be ``None`` if their values cannot be determined. The \"C\" locale is " +"represented as ``(None, None)``." 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`." +"Returns the current setting for the given locale category as a tuple " +"containing the language code and encoding. *category* may be one of " +"the :const:`!LC_\\*` values except :const:`LC_ALL`. It defaults " +"to :const:`LC_CTYPE`." msgstr "" msgid "" @@ -452,8 +474,8 @@ msgid "" msgstr "" msgid "" -"The function now always returns ``\"utf-8\"`` on Android or if the :ref:" -"`Python UTF-8 Mode ` is enabled." +"The function now always returns ``\"utf-8\"`` on Android or if " +"the :ref:`Python UTF-8 Mode ` is enabled." msgstr "" msgid "Get the current :term:`locale encoding`:" @@ -545,13 +567,13 @@ msgid "" msgstr "" msgid "" -"Converts a string into a normalized number string, following the :const:" -"`LC_NUMERIC` settings." +"Converts a string into a normalized number string, following " +"the :const:`LC_NUMERIC` settings." msgstr "" msgid "" -"Converts a normalized number string into a formatted string following the :" -"const:`LC_NUMERIC` settings." +"Converts a normalized number string into a formatted string following " +"the :const:`LC_NUMERIC` settings." msgstr "" msgid "" @@ -575,18 +597,18 @@ 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`." +"functions from ``ctype.h``. Instead, ``pyctype.h`` provides locale-" +"independent equivalents like :c:macro:`Py_TOLOWER`." msgstr "" msgid "" -"Locale category for sorting strings. The functions :func:`strcoll` and :" -"func:`strxfrm` of the :mod:`locale` module are affected." +"Locale category for sorting strings. The functions :func:`strcoll` " +"and :func:`strxfrm` of the :mod:`locale` module are affected." msgstr "" msgid "" -"Locale category for the formatting of time. The function :func:`time." -"strftime` follows these conventions." +"Locale category for the formatting of time. The " +"function :func:`time.strftime` follows these conventions." msgstr "" msgid "" @@ -607,10 +629,10 @@ msgid "" msgstr "" msgid "" -"Locale category for formatting numbers. The functions :func:" -"`format_string`, :func:`atoi`, :func:`atof` and :func:`.str` of the :mod:" -"`locale` module are affected by that category. All other numeric formatting " -"operations are not affected." +"Locale category for formatting numbers. The " +"functions :func:`format_string`, :func:`atoi`, :func:`atof` and :func:`.str` " +"of the :mod:`locale` module are affected by that category. All other " +"numeric formatting operations are not affected." msgstr "" msgid "" @@ -623,23 +645,8 @@ msgid "" msgstr "" msgid "" -"This is a symbolic constant used for different values returned by :func:" -"`localeconv`." -msgstr "" - -msgid "Example::" -msgstr "Przykład::" - -msgid "" -">>> import locale\n" -">>> loc = locale.getlocale() # get current locale\n" -"# use German locale; name might vary with platform\n" -">>> locale.setlocale(locale.LC_ALL, 'de_DE')\n" -">>> locale.strcoll('f\\xe4n', 'foo') # compare a string containing an " -"umlaut\n" -">>> locale.setlocale(locale.LC_ALL, '') # use user's preferred locale\n" -">>> locale.setlocale(locale.LC_ALL, 'C') # use default (C) locale\n" -">>> locale.setlocale(locale.LC_ALL, loc) # restore saved locale" +"This is a symbolic constant used for different values returned " +"by :func:`localeconv`." msgstr "" msgid "Background, details, hints, tips and caveats" @@ -654,9 +661,9 @@ msgstr "" msgid "" "Initially, when a program is started, the locale is the ``C`` locale, no " -"matter what the user's preferred locale is. There is one exception: the :" -"data:`LC_CTYPE` category is changed at startup to set the current locale " -"encoding to the user's preferred locale encoding. The program must " +"matter what the user's preferred locale is. There is one exception: " +"the :data:`LC_CTYPE` category is changed at startup to set the current " +"locale encoding to the user's preferred locale encoding. The program must " "explicitly say that it wants the user's preferred locale settings for other " "categories by calling ``setlocale(LC_ALL, '')``." msgstr "" @@ -680,8 +687,8 @@ msgstr "" msgid "" "The only way to perform numeric operations according to the locale is to use " -"the special functions defined by this module: :func:`atof`, :func:`atoi`, :" -"func:`format_string`, :func:`.str`." +"the special functions defined by this " +"module: :func:`atof`, :func:`atoi`, :func:`format_string`, :func:`.str`." msgstr "" msgid "" @@ -694,6 +701,68 @@ msgid "" "whitespace." msgstr "" +msgid "Locale names" +msgstr "" + +msgid "" +"The format of the locale name is platform dependent, and the set of " +"supported locales can depend on the system configuration." +msgstr "" + +msgid "On Posix platforms, it usually has the format [1]_:" +msgstr "" + +msgid "" +"where *language* is a two- or three-letter language code from `ISO 639`_, " +"*territory* is a two-letter country or region code from `ISO 3166`_, " +"*charset* is a locale encoding, and *modifier* is a script name, a language " +"subtag, a sort order identifier, or other locale modifier (for example, " +"\"latin\", \"valencia\", \"stroke\" and \"euro\")." +msgstr "" + +msgid "" +"On Windows, several formats are supported. [2]_ [3]_ A subset of `IETF BCP " +"47`_ tags:" +msgstr "" + +msgid "" +"where *language* and *territory* have the same meaning as in Posix, *script* " +"is a four-letter script code from `ISO 15924`_, and *modifier* is a language " +"subtag, a sort order identifier or custom modifier (for example, " +"\"valencia\", \"stroke\" or \"x-python\"). Both hyphen (``'-'``) and " +"underscore (``'_'``) separators are supported. Only UTF-8 encoding is " +"allowed for BCP 47 tags." +msgstr "" + +msgid "Windows also supports locale names in the format:" +msgstr "" + +msgid "" +"where *language* and *territory* are full names, such as \"English\" and " +"\"United States\", and *charset* is either a code page number (for example, " +"\"1252\") or UTF-8. Only the underscore separator is supported in this " +"format." +msgstr "" + +msgid "The \"C\" locale is supported on all platforms." +msgstr "" + +msgid "" +"`IEEE Std 1003.1-2024; 8.2 Internationalization Variables `_" +msgstr "" + +msgid "" +"`UCRT Locale names, Languages, and Country/Region strings `_" +msgstr "" + +msgid "" +"`Locale Names `_" +msgstr "" + msgid "For extension writers and programs that embed Python" msgstr "" @@ -708,9 +777,9 @@ msgid "" "When Python code uses the :mod:`locale` module to change the locale, this " "also affects the embedding application. If the embedding application " "doesn't want this to happen, it should remove the :mod:`!_locale` extension " -"module (which does all the work) from the table of built-in modules in the :" -"file:`config.c` file, and make sure that the :mod:`!_locale` module is not " -"accessible as a shared library." +"module (which does all the work) from the table of built-in modules in " +"the :file:`config.c` file, and make sure that the :mod:`!_locale` module is " +"not accessible as a shared library." msgstr "" msgid "Access to message catalogs" @@ -718,8 +787,8 @@ msgstr "" msgid "" "The locale module exposes the C library's gettext interface on systems that " -"provide this interface. It consists of the functions :func:`gettext`, :func:" -"`dgettext`, :func:`dcgettext`, :func:`textdomain`, :func:`bindtextdomain`, " +"provide this interface. It consists of the " +"functions :func:`gettext`, :func:`dgettext`, :func:`dcgettext`, :func:`textdomain`, :func:`bindtextdomain`, " "and :func:`bind_textdomain_codeset`. These are similar to the same " "functions in the :mod:`gettext` module, but use the C library's binary " "format for message catalogs, and the C library's search algorithms for " diff --git a/library/logging.config.po b/library/logging.config.po index d65f9c8796..52c814844b 100644 --- a/library/logging.config.po +++ b/library/logging.config.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!logging.config` --- Logging configuration" msgstr "" msgid "**Source code:** :source:`Lib/logging/config.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/logging/config.py`" msgid "" "This page contains only reference information. For tutorials, please see" @@ -63,10 +62,10 @@ msgid "" msgstr "" msgid "" -"If an error is encountered during configuration, this function will raise a :" -"exc:`ValueError`, :exc:`TypeError`, :exc:`AttributeError` or :exc:" -"`ImportError` with a suitably descriptive message. The following is a " -"(possibly incomplete) list of conditions which will raise an error:" +"If an error is encountered during configuration, this function will raise " +"a :exc:`ValueError`, :exc:`TypeError`, :exc:`AttributeError` " +"or :exc:`ImportError` with a suitably descriptive message. The following is " +"a (possibly incomplete) list of conditions which will raise an error:" msgstr "" msgid "" @@ -91,11 +90,11 @@ msgstr "" msgid "" "Parsing is performed by the :class:`DictConfigurator` class, whose " -"constructor is passed the dictionary used for configuration, and has a :meth:" -"`configure` method. The :mod:`logging.config` module has a callable " -"attribute :attr:`dictConfigClass` which is initially set to :class:" -"`DictConfigurator`. You can replace the value of :attr:`dictConfigClass` " -"with a suitable implementation of your own." +"constructor is passed the dictionary used for configuration, and has " +"a :meth:`configure` method. The :mod:`logging.config` module has a callable " +"attribute :attr:`dictConfigClass` which is initially set " +"to :class:`DictConfigurator`. You can replace the value " +"of :attr:`dictConfigClass` with a suitable implementation of your own." msgstr "" msgid "" @@ -113,9 +112,9 @@ msgid "" "For example, a subclass of :class:`DictConfigurator` could call " "``DictConfigurator.__init__()`` in its own :meth:`__init__`, then set up " "custom prefixes which would be usable in the subsequent :meth:`configure` " -"call. :attr:`dictConfigClass` would be bound to this new subclass, and then :" -"func:`dictConfig` could be called exactly as in the default, uncustomized " -"state." +"call. :attr:`dictConfigClass` would be bound to this new subclass, and " +"then :func:`dictConfig` could be called exactly as in the default, " +"uncustomized state." msgstr "" msgid "" @@ -128,22 +127,22 @@ msgid "" msgstr "" msgid "" -"It will raise :exc:`FileNotFoundError` if the file doesn't exist and :exc:" -"`RuntimeError` if the file is invalid or empty." +"It will raise :exc:`FileNotFoundError` if the file doesn't exist " +"and :exc:`RuntimeError` if the file is invalid or empty." msgstr "" msgid "Parameters" msgstr "parametry" msgid "" -"A filename, or a file-like object, or an instance derived from :class:" -"`~configparser.RawConfigParser`. If a :class:`!RawConfigParser`-derived " -"instance is passed, it is used as is. Otherwise, a :class:`~configparser." -"ConfigParser` is instantiated, and the configuration read by it from the " -"object passed in ``fname``. If that has a :meth:`readline` method, it is " -"assumed to be a file-like object and read using :meth:`~configparser." -"ConfigParser.read_file`; otherwise, it is assumed to be a filename and " -"passed to :meth:`~configparser.ConfigParser.read`." +"A filename, or a file-like object, or an instance derived " +"from :class:`~configparser.RawConfigParser`. If a :class:`!RawConfigParser`-" +"derived instance is passed, it is used as is. Otherwise, " +"a :class:`~configparser.ConfigParser` is instantiated, and the configuration " +"read by it from the object passed in ``fname``. If that has " +"a :meth:`readline` method, it is assumed to be a file-like object and read " +"using :meth:`~configparser.ConfigParser.read_file`; otherwise, it is assumed " +"to be a filename and passed to :meth:`~configparser.ConfigParser.read`." msgstr "" msgid "" @@ -188,13 +187,13 @@ msgstr "" msgid "" "Starts up a socket server on the specified port, and listens for new " -"configurations. If no port is specified, the module's default :const:" -"`DEFAULT_LOGGING_CONFIG_PORT` is used. Logging configurations will be sent " -"as a file suitable for processing by :func:`dictConfig` or :func:" -"`fileConfig`. Returns a :class:`~threading.Thread` instance on which you can " -"call :meth:`~threading.Thread.start` to start the server, and which you can :" -"meth:`~threading.Thread.join` when appropriate. To stop the server, call :" -"func:`stopListening`." +"configurations. If no port is specified, the module's " +"default :const:`DEFAULT_LOGGING_CONFIG_PORT` is used. Logging configurations " +"will be sent as a file suitable for processing by :func:`dictConfig` " +"or :func:`fileConfig`. Returns a :class:`~threading.Thread` instance on " +"which you can call :meth:`~threading.Thread.start` to start the server, and " +"which you can :meth:`~threading.Thread.join` when appropriate. To stop the " +"server, call :func:`stopListening`." msgstr "" msgid "" @@ -297,8 +296,8 @@ msgid "" "All other keys are optional, but if present they will be interpreted as " "described below. In all cases below where a 'configuring dict' is " "mentioned, it will be checked for the special ``'()'`` key to see if a " -"custom instantiation is required. If so, the mechanism described in :ref:" -"`logging-config-dict-userdef` below is used to create an instance; " +"custom instantiation is required. If so, the mechanism described " +"in :ref:`logging-config-dict-userdef` below is used to create an instance; " "otherwise, the context is used to determine what to instantiate." msgstr "" @@ -331,11 +330,11 @@ msgstr "" msgid "" "An optional ``class`` key indicates the name of the formatter's class (as a " -"dotted module and class name). The instantiation arguments are as for :" -"class:`~logging.Formatter`, thus this key is most useful for instantiating a " -"customised subclass of :class:`~logging.Formatter`. For example, the " -"alternative class might present exception tracebacks in an expanded or " -"condensed format. If your formatter requires different or extra " +"dotted module and class name). The instantiation arguments are as " +"for :class:`~logging.Formatter`, thus this key is most useful for " +"instantiating a customised subclass of :class:`~logging.Formatter`. For " +"example, the alternative class might present exception tracebacks in an " +"expanded or condensed format. If your formatter requires different or extra " "configuration keys, you should use :ref:`logging-config-dict-userdef`." msgstr "" @@ -399,11 +398,11 @@ msgid "" msgstr "" msgid "" -"the handler with id ``console`` is instantiated as a :class:`logging." -"StreamHandler`, using ``sys.stdout`` as the underlying stream. The handler " -"with id ``file`` is instantiated as a :class:`logging.handlers." -"RotatingFileHandler` with the keyword arguments ``filename='logconfig.log', " -"maxBytes=1024, backupCount=3``." +"the handler with id ``console`` is instantiated as " +"a :class:`logging.StreamHandler`, using ``sys.stdout`` as the underlying " +"stream. The handler with id ``file`` is instantiated as " +"a :class:`logging.handlers.RotatingFileHandler` with the keyword arguments " +"``filename='logconfig.log', maxBytes=1024, backupCount=3``." msgstr "" msgid "" @@ -440,8 +439,8 @@ msgid "" "*incremental* - whether the configuration is to be interpreted as " "incremental to the existing configuration. This value defaults to " "``False``, which means that the specified configuration replaces the " -"existing configuration with the same semantics as used by the existing :func:" -"`fileConfig` API." +"existing configuration with the same semantics as used by the " +"existing :func:`fileConfig` API." msgstr "" msgid "" @@ -451,9 +450,9 @@ msgstr "" msgid "" "*disable_existing_loggers* - whether any existing non-root loggers are to be " -"disabled. This setting mirrors the parameter of the same name in :func:" -"`fileConfig`. If absent, this parameter defaults to ``True``. This value is " -"ignored if *incremental* is ``True``." +"disabled. This setting mirrors the parameter of the same name " +"in :func:`fileConfig`. If absent, this parameter defaults to ``True``. This " +"value is ignored if *incremental* is ``True``." msgstr "" msgid "Incremental Configuration" @@ -538,12 +537,12 @@ msgstr "" msgid "" "The ids for loggers are the logger names which would be used " -"programmatically to obtain a reference to those loggers, e.g. ``foo.bar." -"baz``. The ids for Formatters and Filters can be any string value (such as " -"``brief``, ``precise`` above) and they are transient, in that they are only " -"meaningful for processing the configuration dictionary and used to determine " -"connections between objects, and are not persisted anywhere when the " -"configuration call is complete." +"programmatically to obtain a reference to those loggers, e.g. " +"``foo.bar.baz``. The ids for Formatters and Filters can be any string value " +"(such as ``brief``, ``precise`` above) and they are transient, in that they " +"are only meaningful for processing the configuration dictionary and used to " +"determine connections between objects, and are not persisted anywhere when " +"the configuration call is complete." msgstr "" msgid "" @@ -593,9 +592,9 @@ msgid "" "The above YAML snippet defines three formatters. The first, with id " "``brief``, is a standard :class:`logging.Formatter` instance with the " "specified format string. The second, with id ``default``, has a longer " -"format and also defines the time format explicitly, and will result in a :" -"class:`logging.Formatter` initialized with those two format strings. Shown " -"in Python source form, the ``brief`` and ``default`` formatters have " +"format and also defines the time format explicitly, and will result in " +"a :class:`logging.Formatter` initialized with those two format strings. " +"Shown in Python source form, the ``brief`` and ``default`` formatters have " "configuration sub-dictionaries::" msgstr "" @@ -669,10 +668,10 @@ msgid "" 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::" +"You can also specify a special key ``'.'`` whose value 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 "" @@ -681,7 +680,7 @@ msgid "" " 'bar' : 'baz',\n" " 'spam' : 99.9,\n" " 'answer' : 42,\n" -" '.' {\n" +" '.' : {\n" " 'foo': 'bar',\n" " 'baz': 'bozz'\n" " }\n" @@ -712,15 +711,15 @@ msgid "" "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 " +"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." +"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" @@ -734,10 +733,10 @@ msgid "" "text file, there is no standard way to distinguish ``sys.stderr`` from the " "literal string ``'sys.stderr'``. To facilitate this distinction, the " "configuration system looks for certain special prefixes in string values and " -"treat them specially. For example, if the literal string ``'ext://sys." -"stderr'`` is provided as a value in the configuration, then the ``ext://`` " -"will be stripped off and the remainder of the value processed using normal " -"import mechanisms." +"treat them specially. For example, if the literal string ``'ext://" +"sys.stderr'`` is provided as a value in the configuration, then the ``ext://" +"`` will be stripped off and the remainder of the value processed using " +"normal import mechanisms." msgstr "" msgid "" @@ -764,15 +763,16 @@ msgstr "" msgid "" "However, a more generic mechanism is needed for user-defined objects which " -"are not known to the :mod:`logging` module. For example, consider :class:" -"`logging.handlers.MemoryHandler`, which takes a ``target`` argument which is " -"another handler to delegate to. Since the system already knows about this " -"class, then in the configuration, the given ``target`` just needs to be the " -"object id of the relevant target handler, and the system will resolve to the " -"handler from the id. If, however, a user defines a ``my.package.MyHandler`` " -"which has an ``alternate`` handler, the configuration system would not know " -"that the ``alternate`` referred to a handler. To cater for this, a generic " -"resolution system allows the user to specify:" +"are not known to the :mod:`logging` module. For example, " +"consider :class:`logging.handlers.MemoryHandler`, which takes a ``target`` " +"argument which is another handler to delegate to. Since the system already " +"knows about this class, then in the configuration, the given ``target`` just " +"needs to be the object id of the relevant target handler, and the system " +"will resolve to the handler from the id. If, however, a user defines a " +"``my.package.MyHandler`` which has an ``alternate`` handler, the " +"configuration system would not know that the ``alternate`` referred to a " +"handler. To cater for this, a generic resolution system allows the user to " +"specify:" msgstr "" msgid "" @@ -789,8 +789,8 @@ msgid "" "The literal string ``'cfg://handlers.file'`` will be resolved in an " "analogous way to strings with the ``ext://`` prefix, but looking in the " "configuration itself rather than the import namespace. The mechanism allows " -"access by dot or by index, in a similar way to that provided by ``str." -"format``. Thus, given the following snippet:" +"access by dot or by index, in a similar way to that provided by " +"``str.format``. Thus, given the following snippet:" msgstr "" msgid "" @@ -810,15 +810,15 @@ msgid "" "dict with key ``handlers``, the string ``'cfg://handlers.email`` would " "resolve to the dict with key ``email`` in the ``handlers`` dict, and so on. " "The string ``'cfg://handlers.email.toaddrs[1]`` would resolve to " -"``'dev_team@domain.tld'`` and the string ``'cfg://handlers.email." -"toaddrs[0]'`` would resolve to the value ``'support_team@domain.tld'``. The " -"``subject`` value could be accessed using either ``'cfg://handlers.email." -"subject'`` or, equivalently, ``'cfg://handlers.email[subject]'``. The " -"latter form only needs to be used if the key contains spaces or non-" -"alphanumeric characters. Please note that the characters ``[`` and ``]`` are " -"not allowed in the keys. If an index value consists only of decimal digits, " -"access will be attempted using the corresponding integer value, falling back " -"to the string value if needed." +"``'dev_team@domain.tld'`` and the string ``'cfg://" +"handlers.email.toaddrs[0]'`` would resolve to the value " +"``'support_team@domain.tld'``. The ``subject`` value could be accessed using " +"either ``'cfg://handlers.email.subject'`` or, equivalently, ``'cfg://" +"handlers.email[subject]'``. The latter form only needs to be used if the " +"key contains spaces or non-alphanumeric characters. Please note that the " +"characters ``[`` and ``]`` are not allowed in the keys. If an index value " +"consists only of decimal digits, access will be attempted using the " +"corresponding integer value, falling back to the string value if needed." msgstr "" msgid "" @@ -836,12 +836,13 @@ msgstr "" msgid "" "Import resolution, by default, uses the builtin :func:`__import__` function " "to do its importing. You may want to replace this with your own importing " -"mechanism: if so, you can replace the :attr:`importer` attribute of the :" -"class:`DictConfigurator` or its superclass, the :class:`BaseConfigurator` " -"class. However, you need to be careful because of the way functions are " -"accessed from classes via descriptors. If you are using a Python callable to " -"do your imports, and you want to define it at class level rather than " -"instance level, you need to wrap it with :func:`staticmethod`. For example::" +"mechanism: if so, you can replace the :attr:`importer` attribute of " +"the :class:`DictConfigurator` or its superclass, " +"the :class:`BaseConfigurator` class. However, you need to be careful because " +"of the way functions are accessed from classes via descriptors. If you are " +"using a Python callable to do your imports, and you want to define it at " +"class level rather than instance level, you need to wrap it " +"with :func:`staticmethod`. For example::" msgstr "" msgid "" @@ -861,14 +862,14 @@ msgstr "" msgid "" "If you want to configure a :class:`~logging.handlers.QueueHandler`, noting " -"that this is normally used in conjunction with a :class:`~logging.handlers." -"QueueListener`, you can configure both together. After the configuration, " -"the ``QueueListener`` instance will be available as the :attr:`~logging." -"handlers.QueueHandler.listener` attribute of the created handler, and that " -"in turn will be available to you using :func:`~logging.getHandlerByName` and " -"passing the name you have used for the ``QueueHandler`` in your " -"configuration. The dictionary schema for configuring the pair is shown in " -"the example YAML snippet below." +"that this is normally used in conjunction with " +"a :class:`~logging.handlers.QueueListener`, you can configure both together. " +"After the configuration, the ``QueueListener`` instance will be available as " +"the :attr:`~logging.handlers.QueueHandler.listener` attribute of the created " +"handler, and that in turn will be available to you " +"using :func:`~logging.getHandlerByName` and passing the name you have used " +"for the ``QueueHandler`` in your configuration. The dictionary schema for " +"configuring the pair is shown in the example YAML snippet below." msgstr "" msgid "" @@ -905,9 +906,9 @@ msgstr "" msgid "" "A string that resolves to a callable which, when called with no arguments, " -"returns the queue instance to use. That callable could be a :class:`queue." -"Queue` subclass or a function which returns a suitable queue instance, such " -"as ``my.module.queue_factory()``." +"returns the queue instance to use. That callable could be " +"a :class:`queue.Queue` subclass or a function which returns a suitable queue " +"instance, such as ``my.module.queue_factory()``." msgstr "" msgid "" @@ -957,16 +958,17 @@ msgstr "" msgid "" "Any custom queue handler and listener classes will need to be defined with " -"the same initialization signatures as :class:`~logging.handlers." -"QueueHandler` and :class:`~logging.handlers.QueueListener`." +"the same initialization signatures " +"as :class:`~logging.handlers.QueueHandler` " +"and :class:`~logging.handlers.QueueListener`." msgstr "" msgid "Configuration file format" msgstr "" msgid "" -"The configuration file format understood by :func:`fileConfig` is based on :" -"mod:`configparser` functionality. The file must contain sections called " +"The configuration file format understood by :func:`fileConfig` is based " +"on :mod:`configparser` functionality. The file must contain sections called " "``[loggers]``, ``[handlers]`` and ``[formatters]`` which identify by name " "the entities of each type which are defined in the file. For each such " "entity, there is a separate section which identifies how that entity is " @@ -984,12 +986,12 @@ msgid "" "The :func:`fileConfig` API is older than the :func:`dictConfig` API and does " "not provide functionality to cover certain aspects of logging. For example, " "you cannot configure :class:`~logging.Filter` objects, which provide for " -"filtering of messages beyond simple integer levels, using :func:" -"`fileConfig`. If you need to have instances of :class:`~logging.Filter` in " -"your logging configuration, you will need to use :func:`dictConfig`. Note " -"that future enhancements to configuration functionality will be added to :" -"func:`dictConfig`, so it's worth considering transitioning to this newer API " -"when it's convenient to do so." +"filtering of messages beyond simple integer levels, " +"using :func:`fileConfig`. If you need to have instances " +"of :class:`~logging.Filter` in your logging configuration, you will need to " +"use :func:`dictConfig`. Note that future enhancements to configuration " +"functionality will be added to :func:`dictConfig`, so it's worth considering " +"transitioning to this newer API when it's convenient to do so." msgstr "" msgid "Examples of these sections in the file are given below." @@ -1070,9 +1072,9 @@ msgid "" msgstr "" msgid "" -"The ``class`` entry indicates the handler's class (as determined by :func:" -"`eval` in the ``logging`` package's namespace). The ``level`` is interpreted " -"as for loggers, and ``NOTSET`` is taken to mean 'log everything'." +"The ``class`` entry indicates the handler's class (as determined " +"by :func:`eval` in the ``logging`` package's namespace). The ``level`` is " +"interpreted as for loggers, and ``NOTSET`` is taken to mean 'log everything'." msgstr "" msgid "" @@ -1120,8 +1122,8 @@ msgid "" "class=handlers.SysLogHandler\n" "level=ERROR\n" "formatter=form05\n" -"args=(('localhost', handlers.SYSLOG_UDP_PORT), handlers.SysLogHandler." -"LOG_USER)\n" +"args=(('localhost', handlers.SYSLOG_UDP_PORT), " +"handlers.SysLogHandler.LOG_USER)\n" "\n" "[handler_hand06]\n" "class=handlers.NTEventLogHandler\n" @@ -1182,8 +1184,8 @@ msgid "" "Due to the use of :func:`eval` as described above, there are potential " "security risks which result from using the :func:`listen` to send and " "receive configurations via sockets. The risks are limited to where multiple " -"users with no mutual trust run code on the same machine; see the :func:" -"`listen` documentation for more information." +"users with no mutual trust run code on the same machine; see " +"the :func:`listen` documentation for more information." msgstr "" msgid "Module :mod:`logging`" diff --git a/library/logging.handlers.po b/library/logging.handlers.po index 059d75fa24..63c64975f6 100644 --- a/library/logging.handlers.po +++ b/library/logging.handlers.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!logging.handlers` --- Logging handlers" msgstr "" msgid "**Source code:** :source:`Lib/logging/handlers.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/logging/handlers.py`" msgid "" "This page contains only reference information. For tutorials, please see" @@ -45,9 +44,9 @@ msgstr "" msgid "" "The following useful handlers are provided in the package. Note that three " -"of the handlers (:class:`StreamHandler`, :class:`FileHandler` and :class:" -"`NullHandler`) are actually defined in the :mod:`logging` module itself, but " -"have been documented here along with the other handlers." +"of the handlers (:class:`StreamHandler`, :class:`FileHandler` " +"and :class:`NullHandler`) are actually defined in the :mod:`logging` module " +"itself, but have been documented here along with the other handlers." msgstr "" msgid "StreamHandler" @@ -56,27 +55,27 @@ msgstr "" msgid "" "The :class:`StreamHandler` class, located in the core :mod:`logging` " "package, sends logging output to streams such as *sys.stdout*, *sys.stderr* " -"or any file-like object (or, more precisely, any object which supports :meth:" -"`write` and :meth:`flush` methods)." +"or any file-like object (or, more precisely, any object which " +"supports :meth:`write` and :meth:`flush` methods)." msgstr "" msgid "" "Returns a new instance of the :class:`StreamHandler` class. If *stream* is " -"specified, the instance will use it for logging output; otherwise, *sys." -"stderr* will be used." +"specified, the instance will use it for logging output; otherwise, " +"*sys.stderr* will be used." msgstr "" msgid "" "If a formatter is specified, it is used to format the record. The record is " "then written to the stream followed by :attr:`terminator`. If exception " -"information is present, it is formatted using :func:`traceback." -"print_exception` and appended to the stream." +"information is present, it is formatted " +"using :func:`traceback.print_exception` and appended to the stream." msgstr "" msgid "" -"Flushes the stream by calling its :meth:`flush` method. Note that the :meth:" -"`close` method is inherited from :class:`~logging.Handler` and so does no " -"output, so an explicit :meth:`flush` call may be needed at times." +"Flushes the stream by calling its :meth:`flush` method. Note that " +"the :meth:`close` method is inherited from :class:`~logging.Handler` and so " +"does no output, so an explicit :meth:`flush` call may be needed at times." msgstr "" msgid "" @@ -168,18 +167,18 @@ msgid "" msgstr "" msgid "" -"See :ref:`library-config` for more information on how to use :class:" -"`NullHandler`." +"See :ref:`library-config` for more information on how to " +"use :class:`NullHandler`." msgstr "" msgid "WatchedFileHandler" msgstr "" msgid "" -"The :class:`WatchedFileHandler` class, located in the :mod:`logging." -"handlers` module, is a :class:`FileHandler` which watches the file it is " -"logging to. If the file changes, it is closed and reopened using the file " -"name." +"The :class:`WatchedFileHandler` class, located in " +"the :mod:`logging.handlers` module, is a :class:`FileHandler` which watches " +"the file it is logging to. If the file changes, it is closed and reopened " +"using the file name." msgstr "" msgid "" @@ -224,11 +223,11 @@ msgid "BaseRotatingHandler" msgstr "" msgid "" -"The :class:`BaseRotatingHandler` class, located in the :mod:`logging." -"handlers` module, is the base class for the rotating file handlers, :class:" -"`RotatingFileHandler` and :class:`TimedRotatingFileHandler`. You should not " -"need to instantiate this class, but it has attributes and methods you may " -"need to override." +"The :class:`BaseRotatingHandler` class, located in " +"the :mod:`logging.handlers` module, is the base class for the rotating file " +"handlers, :class:`RotatingFileHandler` " +"and :class:`TimedRotatingFileHandler`. You should not need to instantiate " +"this class, but it has attributes and methods you may need to override." msgstr "" msgid "The parameters are as for :class:`FileHandler`. The attributes are:" @@ -257,10 +256,10 @@ msgid "" "determining the oldest files to delete. For this to happen, the filenames " "should be sortable using the date/time portion of the filename, and a namer " "needs to respect this. (If a namer is wanted that doesn't respect this " -"scheme, it will need to be used in a subclass of :class:" -"`TimedRotatingFileHandler` which overrides the :meth:" -"`~TimedRotatingFileHandler.getFilesToDelete` method to fit in with the " -"custom naming scheme.)" +"scheme, it will need to be used in a subclass " +"of :class:`TimedRotatingFileHandler` which overrides " +"the :meth:`~TimedRotatingFileHandler.getFilesToDelete` method to fit in with " +"the custom naming scheme.)" msgstr "" msgid "" @@ -299,17 +298,17 @@ msgid "" msgstr "" msgid "" -"The destination filename. This is normally what the source is rotated to, e." -"g. 'test.log.1'." +"The destination filename. This is normally what the source is rotated to, " +"e.g. 'test.log.1'." msgstr "" msgid "" "The reason the attributes exist is to save you having to subclass - you can " -"use the same callables for instances of :class:`RotatingFileHandler` and :" -"class:`TimedRotatingFileHandler`. If either the namer or rotator callable " -"raises an exception, this will be handled in the same way as any other " -"exception during an :meth:`emit` call, i.e. via the :meth:`handleError` " -"method of the handler." +"use the same callables for instances of :class:`RotatingFileHandler` " +"and :class:`TimedRotatingFileHandler`. If either the namer or rotator " +"callable raises an exception, this will be handled in the same way as any " +"other exception during an :meth:`emit` call, i.e. via " +"the :meth:`handleError` method of the handler." msgstr "" msgid "" @@ -324,8 +323,8 @@ msgid "RotatingFileHandler" msgstr "" msgid "" -"The :class:`RotatingFileHandler` class, located in the :mod:`logging." -"handlers` module, supports rotation of disk log files." +"The :class:`RotatingFileHandler` class, located in " +"the :mod:`logging.handlers` module, supports rotation of disk log files." msgstr "" msgid "" @@ -339,20 +338,21 @@ msgid "" msgstr "" msgid "" -"You can use the *maxBytes* and *backupCount* values to allow the file to :" -"dfn:`rollover` at a predetermined size. When the size is about to be " +"You can use the *maxBytes* and *backupCount* values to allow the file " +"to :dfn:`rollover` at a predetermined size. When the size is about to be " "exceeded, the file is closed and a new file is silently opened for output. " "Rollover occurs whenever the current log file is nearly *maxBytes* in " "length; but if either of *maxBytes* or *backupCount* is zero, rollover never " "occurs, so you generally want to set *backupCount* to at least 1, and have a " "non-zero *maxBytes*. When *backupCount* is non-zero, the system will save " "old log files by appending the extensions '.1', '.2' etc., to the filename. " -"For example, with a *backupCount* of 5 and a base file name of :file:`app." -"log`, you would get :file:`app.log`, :file:`app.log.1`, :file:`app.log.2`, " -"up to :file:`app.log.5`. The file being written to is always :file:`app." -"log`. When this file is filled, it is closed and renamed to :file:`app." -"log.1`, and if files :file:`app.log.1`, :file:`app.log.2`, etc. exist, then " -"they are renamed to :file:`app.log.2`, :file:`app.log.3` etc. respectively." +"For example, with a *backupCount* of 5 and a base file name " +"of :file:`app.log`, you would " +"get :file:`app.log`, :file:`app.log.1`, :file:`app.log.2`, up " +"to :file:`app.log.5`. The file being written to is always :file:`app.log`. " +"When this file is filled, it is closed and renamed to :file:`app.log.1`, and " +"if files :file:`app.log.1`, :file:`app.log.2`, etc. exist, then they are " +"renamed to :file:`app.log.2`, :file:`app.log.3` etc. respectively." msgstr "" msgid "Does a rollover, as described above." @@ -363,13 +363,18 @@ msgid "" "previously." msgstr "" -msgid "TimedRotatingFileHandler" +msgid "" +"See if the supplied record would cause the file to exceed the configured " +"size limit." msgstr "" +msgid "TimedRotatingFileHandler" +msgstr "TimedRotatingFileHandler" + msgid "" -"The :class:`TimedRotatingFileHandler` class, located in the :mod:`logging." -"handlers` module, supports rotation of disk log files at certain timed " -"intervals." +"The :class:`TimedRotatingFileHandler` class, located in " +"the :mod:`logging.handlers` module, supports rotation of disk log files at " +"certain timed intervals." msgstr "" msgid "" @@ -467,8 +472,8 @@ msgid "" msgstr "" msgid "" -"If *delay* is true, then file opening is deferred until the first call to :" -"meth:`emit`." +"If *delay* is true, then file opening is deferred until the first call " +"to :meth:`emit`." msgstr "" msgid "" @@ -512,6 +517,11 @@ msgid "" "handler." msgstr "" +msgid "" +"See if enough time has passed for a rollover to occur and if it has, compute " +"the next rollover time." +msgstr "" + msgid "SocketHandler" msgstr "" @@ -539,8 +549,9 @@ msgid "" "Pickles the record's attribute dictionary and writes it to the socket in " "binary format. If there is an error with the socket, silently drops the " "packet. If the connection was previously lost, re-establishes the " -"connection. To unpickle the record at the receiving end into a :class:" -"`~logging.LogRecord`, use the :func:`~logging.makeLogRecord` function." +"connection. To unpickle the record at the receiving end into " +"a :class:`~logging.LogRecord`, use the :func:`~logging.makeLogRecord` " +"function." msgstr "" msgid "" @@ -551,8 +562,8 @@ msgstr "" msgid "" "This is a factory method which allows subclasses to define the precise type " -"of socket they want. The default implementation creates a TCP socket (:const:" -"`socket.SOCK_STREAM`)." +"of socket they want. The default implementation creates a TCP socket " +"(:const:`socket.SOCK_STREAM`)." msgstr "" msgid "" @@ -577,8 +588,8 @@ msgstr "" msgid "" "Send a pickled byte-string *packet* to the socket. The format of the sent " -"byte-string is as described in the documentation for :meth:`~SocketHandler." -"makePickle`." +"byte-string is as described in the documentation " +"for :meth:`~SocketHandler.makePickle`." msgstr "" msgid "" @@ -647,8 +658,9 @@ msgstr "" msgid "" "Pickles the record's attribute dictionary and writes it to the socket in " "binary format. If there is an error with the socket, silently drops the " -"packet. To unpickle the record at the receiving end into a :class:`~logging." -"LogRecord`, use the :func:`~logging.makeLogRecord` function." +"packet. To unpickle the record at the receiving end into " +"a :class:`~logging.LogRecord`, use the :func:`~logging.makeLogRecord` " +"function." msgstr "" msgid "" @@ -676,21 +688,22 @@ msgid "" "``('localhost', 514)`` is used. The address is used to open a socket. An " "alternative to providing a ``(host, port)`` tuple is providing an address as " "a string, for example '/dev/log'. In this case, a Unix domain socket is used " -"to send the message to the syslog. If *facility* is not specified, :const:" -"`LOG_USER` is used. The type of socket opened depends on the *socktype* " -"argument, which defaults to :const:`socket.SOCK_DGRAM` and thus opens a UDP " -"socket. To open a TCP socket (for use with the newer syslog daemons such as " -"rsyslog), specify a value of :const:`socket.SOCK_STREAM`." +"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." +"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 "" @@ -774,7 +787,7 @@ msgid "``alert``" msgstr "" msgid "LOG_ALERT" -msgstr "" +msgstr "LOG_ALERT" msgid "``crit`` or ``critical``" msgstr "" @@ -786,19 +799,19 @@ msgid "``debug``" msgstr "" msgid "LOG_DEBUG" -msgstr "" +msgstr "LOG_DEBUG" msgid "``emerg`` or ``panic``" msgstr "" msgid "LOG_EMERG" -msgstr "" +msgstr "LOG_EMERG" msgid "``err`` or ``error``" msgstr "" msgid "LOG_ERR" -msgstr "" +msgstr "LOG_ERR" msgid "``info``" msgstr "``info``" @@ -810,13 +823,13 @@ msgid "``notice``" msgstr "" msgid "LOG_NOTICE" -msgstr "" +msgstr "LOG_NOTICE" msgid "``warn`` or ``warning``" msgstr "" msgid "LOG_WARNING" -msgstr "" +msgstr "LOG_WARNING" msgid "**Facilities**" msgstr "" @@ -825,25 +838,25 @@ msgid "``auth``" msgstr "``auth``" msgid "LOG_AUTH" -msgstr "" +msgstr "LOG_AUTH" msgid "``authpriv``" msgstr "``authpriv``" msgid "LOG_AUTHPRIV" -msgstr "" +msgstr "LOG_AUTHPRIV" msgid "``cron``" msgstr "``cron``" msgid "LOG_CRON" -msgstr "" +msgstr "LOG_CRON" msgid "``daemon``" msgstr "" msgid "LOG_DAEMON" -msgstr "" +msgstr "LOG_DAEMON" msgid "``ftp``" msgstr "``ftp``" @@ -867,7 +880,7 @@ msgid "``mail``" msgstr "``mail``" msgid "LOG_MAIL" -msgstr "" +msgstr "LOG_MAIL" msgid "``news``" msgstr "``news``" @@ -879,19 +892,19 @@ msgid "``syslog``" msgstr "" msgid "LOG_SYSLOG" -msgstr "" +msgstr "LOG_SYSLOG" msgid "``user``" msgstr "" msgid "LOG_USER" -msgstr "" +msgstr "LOG_USER" msgid "``uucp``" msgstr "``uucp``" msgid "LOG_UUCP" -msgstr "" +msgstr "LOG_UUCP" msgid "``local0``" msgstr "``local0``" @@ -903,13 +916,13 @@ msgid "``local1``" msgstr "``local1``" msgid "LOG_LOCAL1" -msgstr "" +msgstr "LOG_LOCAL1" msgid "``local2``" msgstr "" msgid "LOG_LOCAL2" -msgstr "" +msgstr "LOG_LOCAL2" msgid "``local3``" msgstr "``local3``" @@ -927,7 +940,7 @@ msgid "``local5``" msgstr "``local5``" msgid "LOG_LOCAL5" -msgstr "" +msgstr "LOG_LOCAL5" msgid "``local6``" msgstr "``local6``" @@ -939,7 +952,7 @@ msgid "``local7``" msgstr "``local7``" msgid "LOG_LOCAL7" -msgstr "" +msgstr "LOG_LOCAL7" msgid "" "Maps a logging level name to a syslog priority name. You may need to " @@ -964,14 +977,14 @@ msgid "" "*appname* is used to define the application name as it appears in the event " "log. An appropriate registry entry is created using this name. The *dllname* " "should give the fully qualified pathname of a .dll or .exe which contains " -"message definitions to hold in the log (if not specified, ``'win32service." -"pyd'`` is used - this is installed with the Win32 extensions and contains " -"some basic placeholder message definitions. Note that use of these " -"placeholders will make your event logs big, as the entire message source is " -"held in the log. If you want slimmer logs, you have to pass in the name of " -"your own .dll or .exe which contains the message definitions you want to use " -"in the event log). The *logtype* is one of ``'Application'``, ``'System'`` " -"or ``'Security'``, and defaults to ``'Application'``." +"message definitions to hold in the log (if not specified, " +"``'win32service.pyd'`` is used - this is installed with the Win32 extensions " +"and contains some basic placeholder message definitions. Note that use of " +"these placeholders will make your event logs big, as the entire message " +"source is held in the log. If you want slimmer logs, you have to pass in the " +"name of your own .dll or .exe which contains the message definitions you " +"want to use in the event log). The *logtype* is one of ``'Application'``, " +"``'System'`` or ``'Security'``, and defaults to ``'Application'``." msgstr "" msgid "" @@ -996,10 +1009,11 @@ msgid "" "Returns the event type for the record. Override this if you want to specify " "your own types. This version does a mapping using the handler's typemap " "attribute, which is set up in :meth:`__init__` to a dictionary which " -"contains mappings for :const:`DEBUG`, :const:`INFO`, :const:`WARNING`, :" -"const:`ERROR` and :const:`CRITICAL`. If you are using your own levels, you " -"will either need to override this method or place a suitable dictionary in " -"the handler's *typemap* attribute." +"contains mappings " +"for :const:`DEBUG`, :const:`INFO`, :const:`WARNING`, :const:`ERROR` " +"and :const:`CRITICAL`. If you are using your own levels, you will either " +"need to override this method or place a suitable dictionary in the handler's " +"*typemap* attribute." msgstr "" msgid "" @@ -1011,7 +1025,7 @@ msgid "" msgstr "" msgid "SMTPHandler" -msgstr "" +msgstr "SMTPHandler" msgid "" "The :class:`SMTPHandler` class, located in the :mod:`logging.handlers` " @@ -1033,8 +1047,8 @@ msgid "" "*secure* argument. This will only be used when authentication credentials " "are supplied. The tuple should be either an empty tuple, or a single-value " "tuple with the name of a keyfile, or a 2-value tuple with the names of the " -"keyfile and certificate file. (This tuple is passed to the :meth:`smtplib." -"SMTP.starttls` method.)" +"keyfile and certificate file. (This tuple is passed to " +"the :meth:`smtplib.SMTP.starttls` method.)" msgstr "" msgid "" @@ -1064,11 +1078,11 @@ msgid "" msgstr "" msgid "" -":class:`MemoryHandler` is a subclass of the more general :class:" -"`BufferingHandler`, which is an abstract class. This buffers logging records " -"in memory. Whenever each record is added to the buffer, a check is made by " -"calling :meth:`shouldFlush` to see if the buffer should be flushed. If it " -"should, then :meth:`flush` is expected to do the flushing." +":class:`MemoryHandler` is a subclass of the more " +"general :class:`BufferingHandler`, which is an abstract class. This buffers " +"logging records in memory. Whenever each record is added to the buffer, a " +"check is made by calling :meth:`shouldFlush` to see if the buffer should be " +"flushed. If it should, then :meth:`flush` is expected to do the flushing." msgstr "" msgid "" @@ -1077,8 +1091,8 @@ msgid "" msgstr "" msgid "" -"Append the record to the buffer. If :meth:`shouldFlush` returns true, call :" -"meth:`flush` to process the buffer." +"Append the record to the buffer. If :meth:`shouldFlush` returns true, " +"call :meth:`flush` to process the buffer." msgstr "" msgid "" @@ -1123,7 +1137,7 @@ msgid "Checks for buffer full or a record at the *flushLevel* or higher." msgstr "" msgid "HTTPHandler" -msgstr "" +msgstr "HTTPHandler" msgid "" "The :class:`HTTPHandler` class, located in the :mod:`logging.handlers` " @@ -1135,13 +1149,13 @@ msgid "" "Returns a new instance of the :class:`HTTPHandler` class. The *host* can be " "of the form ``host:port``, should you need to use a specific port number. " "If no *method* is specified, ``GET`` is used. If *secure* is true, a HTTPS " -"connection will be used. The *context* parameter may be set to a :class:`ssl." -"SSLContext` instance to configure the SSL settings used for the HTTPS " -"connection. If *credentials* is specified, it should be a 2-tuple consisting " -"of userid and password, which will be placed in a HTTP 'Authorization' " -"header using Basic authentication. If you specify credentials, you should " -"also specify secure=True so that your userid and password are not passed in " -"cleartext across the wire." +"connection will be used. The *context* parameter may be set to " +"a :class:`ssl.SSLContext` instance to configure the SSL settings used for " +"the HTTPS connection. If *credentials* is specified, it should be a 2-tuple " +"consisting of userid and password, which will be placed in a HTTP " +"'Authorization' header using Basic authentication. If you specify " +"credentials, you should also specify secure=True so that your userid and " +"password are not passed in cleartext across the wire." msgstr "" msgid "The *context* parameter was added." @@ -1149,16 +1163,16 @@ msgstr "" msgid "" "Provides a dictionary, based on ``record``, which is to be URL-encoded and " -"sent to the web server. The default implementation just returns ``record." -"__dict__``. This method can be overridden if e.g. only a subset of :class:" -"`~logging.LogRecord` is to be sent to the web server, or if more specific " -"customization of what's sent to the server is required." +"sent to the web server. The default implementation just returns " +"``record.__dict__``. This method can be overridden if e.g. only a subset " +"of :class:`~logging.LogRecord` is to be sent to the web server, or if more " +"specific customization of what's sent to the server is required." msgstr "" msgid "" -"Sends the record to the web server as a URL-encoded dictionary. The :meth:" -"`mapLogRecord` method is used to convert the record to the dictionary to be " -"sent." +"Sends the record to the web server as a URL-encoded dictionary. " +"The :meth:`mapLogRecord` method is used to convert the record to the " +"dictionary to be sent." msgstr "" msgid "" @@ -1198,17 +1212,28 @@ msgid "" msgstr "" msgid "" -"If you are using :mod:`multiprocessing`, you should avoid using :class:" -"`~queue.SimpleQueue` and instead use :class:`multiprocessing.Queue`." +"If you are using :mod:`multiprocessing`, you should avoid " +"using :class:`~queue.SimpleQueue` and instead " +"use :class:`multiprocessing.Queue`." +msgstr "" + +msgid "" +"The :mod:`multiprocessing` module uses an internal logger created and " +"accessed " +"via :meth:`~multiprocessing.get_logger`. :class:`multiprocessing.Queue` will " +"log ``DEBUG`` level messages upon items being queued. If those log messages " +"are processed by a :class:`QueueHandler` using the " +"same :class:`multiprocessing.Queue` instance, it will cause a deadlock or " +"infinite recursion." msgstr "" msgid "" -"Enqueues the result of preparing the LogRecord. Should an exception occur (e." -"g. because a bounded queue has filled up), the :meth:`~logging.Handler." -"handleError` method is called to handle the error. This can result in the " -"record silently being dropped (if :data:`logging.raiseExceptions` is " -"``False``) or a message printed to ``sys.stderr`` (if :data:`logging." -"raiseExceptions` is ``True``)." +"Enqueues the result of preparing the LogRecord. Should an exception occur " +"(e.g. because a bounded queue has filled up), " +"the :meth:`~logging.Handler.handleError` method is called to handle the " +"error. This can result in the record silently being dropped " +"(if :data:`logging.raiseExceptions` is ``False``) or a message printed to " +"``sys.stderr`` (if :data:`logging.raiseExceptions` is ``True``)." msgstr "" msgid "" @@ -1219,10 +1244,11 @@ msgstr "" msgid "" "The base implementation formats the record to merge the message, arguments, " "exception and stack information, if present. It also removes unpickleable " -"items from the record in-place. Specifically, it overwrites the record's :" -"attr:`msg` and :attr:`message` attributes with the merged message (obtained " -"by calling the handler's :meth:`format` method), and sets the :attr:`args`, :" -"attr:`exc_info` and :attr:`exc_text` attributes to ``None``." +"items from the record in-place. Specifically, it overwrites the " +"record's :attr:`msg` and :attr:`message` attributes with the merged message " +"(obtained by calling the handler's :meth:`format` method), and sets " +"the :attr:`args`, :attr:`exc_info` and :attr:`exc_text` attributes to " +"``None``." msgstr "" msgid "" @@ -1235,8 +1261,8 @@ msgid "" "The base implementation formats the message with arguments, sets the " "``message`` and ``msg`` attributes to the formatted message and sets the " "``args`` and ``exc_text`` attributes to ``None`` to allow pickling and to " -"prevent further attempts at formatting. This means that a handler on the :" -"class:`QueueListener` side won't have the information to do custom " +"prevent further attempts at formatting. This means that a handler on " +"the :class:`QueueListener` side won't have the information to do custom " "formatting, e.g. of exceptions. You may wish to subclass ``QueueHandler`` " "and override this method to e.g. avoid setting ``exc_text`` to ``None``. " "Note that the ``message`` / ``msg`` / ``args`` changes are related to " @@ -1266,9 +1292,9 @@ msgid "" "module, supports receiving logging messages from a queue, such as those " "implemented in the :mod:`queue` or :mod:`multiprocessing` modules. The " "messages are received from a queue in an internal thread and passed, on the " -"same thread, to one or more handlers for processing. While :class:" -"`QueueListener` is not itself a handler, it is documented here because it " -"works hand-in-hand with :class:`QueueHandler`." +"same thread, to one or more handlers for processing. " +"While :class:`QueueListener` is not itself a handler, it is documented here " +"because it works hand-in-hand with :class:`QueueHandler`." msgstr "" msgid "" @@ -1286,8 +1312,8 @@ msgid "" "will handle entries placed on the queue. The queue can be any queue-like " "object; it's passed as-is to the :meth:`dequeue` method, which needs to know " "how to get messages from it. The queue is not *required* to have the task " -"tracking API (though it's used if available), which means that you can use :" -"class:`~queue.SimpleQueue` instances for *queue*." +"tracking API (though it's used if available), which means that you can " +"use :class:`~queue.SimpleQueue` instances for *queue*." msgstr "" msgid "" @@ -1322,8 +1348,8 @@ msgstr "" msgid "" "This just loops through the handlers offering them the record to handle. The " -"actual object passed to the handlers is that which is returned from :meth:" -"`prepare`." +"actual object passed to the handlers is that which is returned " +"from :meth:`prepare`." msgstr "" msgid "Starts the listener." diff --git a/library/logging.po b/library/logging.po index 7ed86b24cf..bec298132e 100644 --- a/library/logging.po +++ b/library/logging.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!logging` --- Logging facility for Python" msgstr "" msgid "**Source code:** :source:`Lib/logging/__init__.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/logging/__init__.py`" msgid "" "This page contains the API reference information. For tutorial information " @@ -159,14 +158,14 @@ msgid "" "are all descendants of ``foo``. In addition, all loggers are descendants of " "the root logger. The logger name hierarchy is analogous to the Python " "package hierarchy, and identical to it if you organise your loggers on a per-" -"module basis using the recommended construction ``logging." -"getLogger(__name__)``. That's because in a module, ``__name__`` is the " -"module's name in the Python package namespace." +"module basis using the recommended construction " +"``logging.getLogger(__name__)``. That's because in a module, ``__name__`` " +"is the module's name in the Python package namespace." msgstr "" msgid "" -"This is the logger's name, and is the value that was passed to :func:" -"`getLogger` to obtain the logger." +"This is the logger's name, and is the value that was passed " +"to :func:`getLogger` to obtain the logger." msgstr "" msgid "This attribute should be treated as read-only." @@ -287,25 +286,27 @@ msgstr "" msgid "" "Indicates if a message of severity *level* would be processed by this " -"logger. This method checks first the module-level level set by ``logging." -"disable(level)`` and then the logger's effective level as determined by :" -"meth:`getEffectiveLevel`." +"logger. This method checks first the module-level level set by " +"``logging.disable(level)`` and then the logger's effective level as " +"determined by :meth:`getEffectiveLevel`." msgstr "" msgid "" -"Indicates the effective level for this logger. If a value other than :const:" -"`NOTSET` has been set using :meth:`setLevel`, it is returned. Otherwise, the " -"hierarchy is traversed towards the root until a value other than :const:" -"`NOTSET` is found, and that value is returned. The value returned is an " -"integer, typically one of :const:`logging.DEBUG`, :const:`logging.INFO` etc." +"Indicates the effective level for this logger. If a value other " +"than :const:`NOTSET` has been set using :meth:`setLevel`, it is returned. " +"Otherwise, the hierarchy is traversed towards the root until a value other " +"than :const:`NOTSET` is found, and that value is returned. The value " +"returned is an integer, typically one " +"of :const:`logging.DEBUG`, :const:`logging.INFO` etc." msgstr "" msgid "" "Returns a logger which is a descendant to this logger, as determined by the " "suffix. Thus, ``logging.getLogger('abc').getChild('def.ghi')`` would return " -"the same logger as would be returned by ``logging.getLogger('abc.def." -"ghi')``. This is a convenience method, useful when the parent logger is " -"named using e.g. ``__name__`` rather than a literal string." +"the same logger as would be returned by " +"``logging.getLogger('abc.def.ghi')``. This is a convenience method, useful " +"when the parent logger is named using e.g. ``__name__`` rather than a " +"literal string." msgstr "" msgid "" @@ -367,18 +368,18 @@ msgstr "" msgid "" "The third optional keyword argument is *stacklevel*, which defaults to " "``1``. If greater than 1, the corresponding number of stack frames are " -"skipped when computing the line number and function name set in the :class:" -"`LogRecord` created for the logging event. This can be used in logging " -"helpers so that the function name, filename and line number recorded are not " -"the information for the helper function/method, but rather its caller. The " -"name of this parameter mirrors the equivalent one in the :mod:`warnings` " -"module." +"skipped when computing the line number and function name set in " +"the :class:`LogRecord` created for the logging event. This can be used in " +"logging helpers so that the function name, filename and line number recorded " +"are not the information for the helper function/method, but rather its " +"caller. The name of this parameter mirrors the equivalent one in " +"the :mod:`warnings` module." msgstr "" msgid "" "The fourth keyword argument is *extra* which can be used to pass a " -"dictionary which is used to populate the :attr:`~object.__dict__` of the :" -"class:`LogRecord` created for the logging event with user-defined " +"dictionary which is used to populate the :attr:`~object.__dict__` of " +"the :class:`LogRecord` created for the logging event with user-defined " "attributes. These custom attributes can then be used as you like. For " "example, they could be incorporated into logged messages. For example::" msgstr "" @@ -407,12 +408,12 @@ msgstr "" msgid "" "If you choose to use these attributes in logged messages, you need to " -"exercise some care. In the above example, for instance, the :class:" -"`Formatter` has been set up with a format string which expects 'clientip' " -"and 'user' in the attribute dictionary of the :class:`LogRecord`. If these " -"are missing, the message will not be logged because a string formatting " -"exception will occur. So in this case, you always need to pass the *extra* " -"dictionary with these keys." +"exercise some care. In the above example, for instance, " +"the :class:`Formatter` has been set up with a format string which expects " +"'clientip' and 'user' in the attribute dictionary of the :class:`LogRecord`. " +"If these are missing, the message will not be logged because a string " +"formatting exception will occur. So in this case, you always need to pass " +"the *extra* dictionary with these keys." msgstr "" msgid "" @@ -520,8 +521,8 @@ msgid "" "Handles a record by passing it to all handlers associated with this logger " "and its ancestors (until a false value of *propagate* is found). This method " "is used for unpickled records received from a socket, as well as those " -"created locally. Logger-level filtering is applied using :meth:`~Logger." -"filter`." +"created locally. Logger-level filtering is applied " +"using :meth:`~Logger.filter`." msgstr "" msgid "" @@ -613,16 +614,16 @@ msgid "Handler Objects" msgstr "" msgid "" -"Handlers have the following attributes and methods. Note that :class:" -"`Handler` is never instantiated directly; this class acts as a base for more " -"useful subclasses. However, the :meth:`!__init__` method in subclasses needs " -"to call :meth:`Handler.__init__`." +"Handlers have the following attributes and methods. Note " +"that :class:`Handler` is never instantiated directly; this class acts as a " +"base for more useful subclasses. However, the :meth:`!__init__` method in " +"subclasses needs to call :meth:`Handler.__init__`." msgstr "" msgid "" "Initializes the :class:`Handler` instance by setting its level, setting the " -"list of filters to the empty list and creating a lock (using :meth:" -"`createLock`) for serializing access to an I/O mechanism." +"list of filters to the empty list and creating a lock " +"(using :meth:`createLock`) for serializing access to an I/O mechanism." msgstr "" msgid "" @@ -648,8 +649,8 @@ msgid "" msgstr "" msgid "" -"Sets the formatter for this handler to *fmt*. The *fmt* argument must be a :" -"class:`Formatter` instance or ``None``." +"Sets the formatter for this handler to *fmt*. The *fmt* argument must be " +"a :class:`Formatter` instance or ``None``." msgstr "" msgid "Adds the specified filter *filter* to this handler." @@ -690,14 +691,15 @@ msgstr "" msgid "" "This method should be called from handlers when an exception is encountered " -"during an :meth:`emit` call. If the module-level attribute :data:" -"`raiseExceptions` is ``False``, exceptions get silently ignored. This is " -"what is mostly wanted for a logging system - most users will not care about " -"errors in the logging system, they are more interested in application " -"errors. You could, however, replace this with a custom handler if you wish. " -"The specified record is the one which was being processed when the exception " -"occurred. (The default value of :data:`raiseExceptions` is ``True``, as that " -"is more useful during development)." +"during an :meth:`emit` call. If the module-level " +"attribute :data:`raiseExceptions` is ``False``, exceptions get silently " +"ignored. This is what is mostly wanted for a logging system - most users " +"will not care about errors in the logging system, they are more interested " +"in application errors. You could, however, replace this with a custom " +"handler if you wish. The specified record is the one which was being " +"processed when the exception occurred. (The default value " +"of :data:`raiseExceptions` is ``True``, as that is more useful during " +"development)." msgstr "" msgid "" @@ -707,8 +709,8 @@ msgstr "" msgid "" "Do whatever it takes to actually log the specified logging record. This " -"version is intended to be implemented by subclasses and so raises a :exc:" -"`NotImplementedError`." +"version is intended to be implemented by subclasses and so raises " +"a :exc:`NotImplementedError`." msgstr "" msgid "" @@ -750,31 +752,30 @@ msgstr "parametry" msgid "" "A format string in the given *style* for the logged output as a whole. The " -"possible mapping keys are drawn from the :class:`LogRecord` object's :ref:" -"`logrecord-attributes`. If not specified, ``'%(message)s'`` is used, which " -"is just the logged message." +"possible mapping keys are drawn from the :class:`LogRecord` " +"object's :ref:`logrecord-attributes`. If not specified, ``'%(message)s'`` is " +"used, which is just the logged message." msgstr "" msgid "" -"A format string in the given *style* for the date/time portion of the logged " -"output. If not specified, the default described in :meth:`formatTime` is " -"used." +"A format string for the date/time portion of the logged output. If not " +"specified, the default described in :meth:`formatTime` is used." msgstr "" msgid "" "Can be one of ``'%'``, ``'{'`` or ``'$'`` and determines how the format " "string will be merged with its data: using one of :ref:`old-string-" "formatting` (``%``), :meth:`str.format` (``{``) or :class:`string.Template` " -"(``$``). This only applies to *fmt* and *datefmt* (e.g. ``'%(message)s'`` " -"versus ``'{message}'``), not to the actual log messages passed to the " -"logging methods. However, there are :ref:`other ways ` to " -"use ``{``- and ``$``-formatting for log messages." +"(``$``). This only applies to *fmt* (e.g. ``'%(message)s'`` versus " +"``'{message}'``), not to the actual log messages passed to the logging " +"methods. However, there are :ref:`other ways ` to use " +"``{``- and ``$``-formatting for log messages." msgstr "" msgid "" "If ``True`` (the default), incorrect or mismatched *fmt* and *style* will " -"raise a :exc:`ValueError`; for example, ``logging.Formatter('%(asctime)s - " -"%(message)s', style='{')``." +"raise a :exc:`ValueError`; for example, ``logging.Formatter('%(asctime)s - %" +"(message)s', style='{')``." msgstr "" msgid "" @@ -797,11 +798,11 @@ msgid "" "dictionary, a couple of preparatory steps are carried out. The *message* " "attribute of the record is computed using *msg* % *args*. If the formatting " "string contains ``'(asctime)'``, :meth:`formatTime` is called to format the " -"event time. If there is exception information, it is formatted using :meth:" -"`formatException` and appended to the message. Note that the formatted " -"exception information is cached in attribute *exc_text*. This is useful " -"because the exception information can be pickled and sent across the wire, " -"but you should be careful if you have more than one :class:`Formatter` " +"event time. If there is exception information, it is formatted " +"using :meth:`formatException` and appended to the message. Note that the " +"formatted exception information is cached in attribute *exc_text*. This is " +"useful because the exception information can be pickled and sent across the " +"wire, but you should be careful if you have more than one :class:`Formatter` " "subclass which customizes the formatting of exception information. In this " "case, you will have to clear the cached value (by setting the *exc_text* " "attribute to ``None``) after a formatter has done its formatting, so that " @@ -818,12 +819,12 @@ msgid "" "This method should be called from :meth:`format` by a formatter which wants " "to make use of a formatted time. This method can be overridden in formatters " "to provide for any specific requirement, but the basic behavior is as " -"follows: if *datefmt* (a string) is specified, it is used with :func:`time." -"strftime` to format the creation time of the record. Otherwise, the format " -"'%Y-%m-%d %H:%M:%S,uuu' is used, where the uuu part is a millisecond value " -"and the other letters are as per the :func:`time.strftime` documentation. " -"An example time in this format is ``2003-01-23 00:29:50,411``. The " -"resulting string is returned." +"follows: if *datefmt* (a string) is specified, it is used " +"with :func:`time.strftime` to format the creation time of the record. " +"Otherwise, the format '%Y-%m-%d %H:%M:%S,uuu' is used, where the uuu part is " +"a millisecond value and the other letters are as per " +"the :func:`time.strftime` documentation. An example time in this format is " +"``2003-01-23 00:29:50,411``. The resulting string is returned." msgstr "" msgid "" @@ -860,9 +861,9 @@ msgid "" msgstr "" msgid "" -"Formats the specified stack information (a string as returned by :func:" -"`traceback.print_stack`, but with the last newline removed) as a string. " -"This default implementation just returns the input value." +"Formats the specified stack information (a string as returned " +"by :func:`traceback.print_stack`, but with the last newline removed) as a " +"string. This default implementation just returns the input value." msgstr "" msgid "" @@ -937,8 +938,8 @@ msgid "" "You don't need to create specialized ``Filter`` classes, or use other " "classes with a ``filter`` method: you can use a function (or other callable) " "as a filter. The filtering logic will check to see if the filter object has " -"a ``filter`` attribute: if it does, it's assumed to be a ``Filter`` and its :" -"meth:`~Filter.filter` method is called. Otherwise, it's assumed to be a " +"a ``filter`` attribute: if it does, it's assumed to be a ``Filter`` and " +"its :meth:`~Filter.filter` method is called. Otherwise, it's assumed to be a " "callable and called with the record as the single parameter. The returned " "value should conform to that returned by :meth:`~Filter.filter`." msgstr "" @@ -965,10 +966,10 @@ msgid "LogRecord Objects" msgstr "" msgid "" -":class:`LogRecord` instances are created automatically by the :class:" -"`Logger` every time something is logged, and can be created manually via :" -"func:`makeLogRecord` (for example, from a pickled event received over the " -"wire)." +":class:`LogRecord` instances are created automatically by " +"the :class:`Logger` every time something is logged, and can be created " +"manually via :func:`makeLogRecord` (for example, from a pickled event " +"received over the wire)." msgstr "" msgid "Contains all the information pertinent to the event being logged." @@ -989,8 +990,8 @@ msgstr "" msgid "" "The :ref:`numeric level ` of the logging event (such as ``10`` for " "``DEBUG``, ``20`` for ``INFO``, etc). Note that this is converted to *two* " -"attributes of the LogRecord: :attr:`!levelno` for the numeric value and :" -"attr:`!levelname` for the corresponding level name." +"attributes of the LogRecord: :attr:`!levelno` for the numeric value " +"and :attr:`!levelname` for the corresponding level name." msgstr "" msgid "" @@ -1012,8 +1013,9 @@ msgid "" msgstr "" msgid "" -"An exception tuple with the current exception information, as returned by :" -"func:`sys.exc_info`, or ``None`` if no exception information is available." +"An exception tuple with the current exception information, as returned " +"by :func:`sys.exc_info`, or ``None`` if no exception information is " +"available." msgstr "" msgid "" @@ -1041,8 +1043,8 @@ msgid "" msgstr "" msgid "" -"This functionality can be used to inject your own values into a :class:" -"`LogRecord` at creation time. You can use the following pattern::" +"This functionality can be used to inject your own values into " +"a :class:`LogRecord` at creation time. You can use the following pattern::" msgstr "" msgid "" @@ -1077,8 +1079,8 @@ msgstr "" msgid "" "If you are using {}-formatting (:func:`str.format`), you can use ``{attrname}" -"`` as the placeholder in the format string. If you are using $-formatting (:" -"class:`string.Template`), use the form ``${attrname}``. In both cases, of " +"`` as the placeholder in the format string. If you are using $-formatting " +"(:class:`string.Template`), use the form ``${attrname}``. In both cases, of " "course, replace ``attrname`` with the actual attribute name you want to use." msgstr "" @@ -1130,8 +1132,8 @@ msgid "``%(created)f``" msgstr "``%(created)f``" msgid "" -"Time when the :class:`LogRecord` was created (as returned by :func:`time." -"time_ns` / 1e9)." +"Time when the :class:`LogRecord` was created (as returned " +"by :func:`time.time_ns` / 1e9)." msgstr "" msgid "exc_info" @@ -1142,6 +1144,15 @@ msgid "" "``None``." msgstr "" +msgid "exc_text" +msgstr "" + +msgid "" +"Exception information formatted as a string. This is set " +"when :meth:`Formatter.format` is invoked, or ``None`` if no exception has " +"occurred." +msgstr "" + msgid "filename" msgstr "" @@ -1178,8 +1189,8 @@ msgid "``%(levelno)s``" msgstr "``%(levelno)s``" msgid "" -"Numeric logging level for the message (:const:`DEBUG`, :const:`INFO`, :const:" -"`WARNING`, :const:`ERROR`, :const:`CRITICAL`)." +"Numeric logging level for the message " +"(:const:`DEBUG`, :const:`INFO`, :const:`WARNING`, :const:`ERROR`, :const:`CRITICAL`)." msgstr "" msgid "lineno" @@ -1198,8 +1209,8 @@ msgid "``%(message)s``" msgstr "``%(message)s``" msgid "" -"The logged message, computed as ``msg % args``. This is set when :meth:" -"`Formatter.format` is invoked." +"The logged message, computed as ``msg % args``. This is set " +"when :meth:`Formatter.format` is invoked." msgstr "" msgid "module" @@ -1326,17 +1337,19 @@ msgstr "" msgid "" ":class:`LoggerAdapter` instances are used to conveniently pass contextual " -"information into logging calls. For a usage example, see the section on :ref:" -"`adding contextual information to your logging output `." +"information into logging calls. For a usage example, see the section " +"on :ref:`adding contextual information to your logging output `." msgstr "" msgid "" "Returns an instance of :class:`LoggerAdapter` initialized with an " -"underlying :class:`Logger` instance, a dict-like object (*extra*), and a " -"boolean (*merge_extra*) indicating whether or not the *extra* argument of " -"individual log calls should be merged with the :class:`LoggerAdapter` extra. " -"The default behavior is to ignore the *extra* argument of individual log " -"calls and only use the one of the :class:`LoggerAdapter` instance" +"underlying :class:`Logger` instance, an optional dict-like object (*extra*), " +"and an optional boolean (*merge_extra*) indicating whether or not the " +"*extra* argument of individual log calls should be merged with " +"the :class:`LoggerAdapter` extra. The default behavior is to ignore the " +"*extra* argument of individual log calls and only use the one of " +"the :class:`LoggerAdapter` instance" msgstr "" msgid "" @@ -1355,19 +1368,17 @@ msgstr "" msgid "" "In addition to the above, :class:`LoggerAdapter` supports the following " -"methods of :class:`Logger`: :meth:`~Logger.debug`, :meth:`~Logger.info`, :" -"meth:`~Logger.warning`, :meth:`~Logger.error`, :meth:`~Logger.exception`, :" -"meth:`~Logger.critical`, :meth:`~Logger.log`, :meth:`~Logger.isEnabledFor`, :" -"meth:`~Logger.getEffectiveLevel`, :meth:`~Logger.setLevel` and :meth:" -"`~Logger.hasHandlers`. These methods have the same signatures as their " -"counterparts in :class:`Logger`, so you can use the two types of instances " -"interchangeably." +"methods " +"of :class:`Logger`: :meth:`~Logger.debug`, :meth:`~Logger.info`, :meth:`~Logger.warning`, :meth:`~Logger.error`, :meth:`~Logger.exception`, :meth:`~Logger.critical`, :meth:`~Logger.log`, :meth:`~Logger.isEnabledFor`, :meth:`~Logger.getEffectiveLevel`, :meth:`~Logger.setLevel` " +"and :meth:`~Logger.hasHandlers`. These methods have the same signatures as " +"their counterparts in :class:`Logger`, so you can use the two types of " +"instances interchangeably." msgstr "" msgid "" -"The :meth:`~Logger.isEnabledFor`, :meth:`~Logger.getEffectiveLevel`, :meth:" -"`~Logger.setLevel` and :meth:`~Logger.hasHandlers` methods were added to :" -"class:`LoggerAdapter`. These methods delegate to the underlying logger." +"The :meth:`~Logger.isEnabledFor`, :meth:`~Logger.getEffectiveLevel`, :meth:`~Logger.setLevel` " +"and :meth:`~Logger.hasHandlers` methods were added " +"to :class:`LoggerAdapter`. These methods delegate to the underlying logger." msgstr "" msgid "" @@ -1375,7 +1386,10 @@ msgid "" "delegate to the underlying logger and allow adapters to be nested." msgstr "" -msgid "The *merge_extra* argument was added." +msgid "The *extra* argument is now optional." +msgstr "" + +msgid "The *merge_extra* parameter was added." msgstr "" msgid "Thread Safety" @@ -1383,7 +1397,7 @@ msgstr "" msgid "" "The logging module is intended to be thread-safe without any special work " -"needing to be done by its clients. It achieves this though using threading " +"needing to be done by its clients. It achieves this through using threading " "locks; there is one lock to serialize access to the module's shared data, " "and each handler also creates a lock to serialize access to its underlying I/" "O." @@ -1453,8 +1467,9 @@ msgid "" msgstr "" msgid "" -"The only difference is that if the root logger has no handlers, then :func:" -"`basicConfig` is called, prior to calling ``debug`` on the root logger." +"The only difference is that if the root logger has no handlers, " +"then :func:`basicConfig` is called, prior to calling ``debug`` on the root " +"logger." msgstr "" msgid "" @@ -1511,10 +1526,10 @@ msgid "" "useful. Its effect is to disable all logging calls of severity *level* and " "below, so that if you call it with a value of INFO, then all INFO and DEBUG " "events would be discarded, whereas those of severity WARNING and above would " -"be processed according to the logger's effective level. If ``logging." -"disable(logging.NOTSET)`` is called, it effectively removes this overriding " -"level, so that logging output again depends on the effective levels of " -"individual loggers." +"be processed according to the logger's effective level. If " +"``logging.disable(logging.NOTSET)`` is called, it effectively removes this " +"overriding level, so that logging output again depends on the effective " +"levels of individual loggers." msgstr "" msgid "" @@ -1525,8 +1540,8 @@ msgid "" msgstr "" msgid "" -"The *level* parameter was defaulted to level ``CRITICAL``. See :issue:" -"`28524` for more information about this change." +"The *level* parameter was defaulted to level ``CRITICAL``. " +"See :issue:`28524` for more information about this change." msgstr "" msgid "" @@ -1539,8 +1554,8 @@ msgid "" msgstr "" msgid "" -"If you are thinking of defining your own levels, please see the section on :" -"ref:`custom-levels`." +"If you are thinking of defining your own levels, please see the section " +"on :ref:`custom-levels`." msgstr "" msgid "" @@ -1553,12 +1568,13 @@ msgid "Returns the textual or numeric representation of logging level *level*." msgstr "" msgid "" -"If *level* is one of the predefined levels :const:`CRITICAL`, :const:" -"`ERROR`, :const:`WARNING`, :const:`INFO` or :const:`DEBUG` then you get the " -"corresponding string. If you have associated levels with names using :func:" -"`addLevelName` then the name you have associated with *level* is returned. " -"If a numeric value corresponding to one of the defined levels is passed in, " -"the corresponding string representation is returned." +"If *level* is one of the predefined " +"levels :const:`CRITICAL`, :const:`ERROR`, :const:`WARNING`, :const:`INFO` " +"or :const:`DEBUG` then you get the corresponding string. If you have " +"associated levels with names using :func:`addLevelName` then the name you " +"have associated with *level* is returned. If a numeric value corresponding " +"to one of the defined levels is passed in, the corresponding string " +"representation is returned." msgstr "" msgid "" @@ -1575,9 +1591,9 @@ msgstr "" msgid "" "Levels are internally integers (as they need to be compared in the logging " "logic). This function is used to convert between an integer level and the " -"level name displayed in the formatted log output by means of the " -"``%(levelname)s`` format specifier (see :ref:`logrecord-attributes`), and " -"vice versa." +"level name displayed in the formatted log output by means of the ``%" +"(levelname)s`` format specifier (see :ref:`logrecord-attributes`), and vice " +"versa." msgstr "" msgid "" @@ -1597,17 +1613,18 @@ msgstr "" msgid "" "Creates and returns a new :class:`LogRecord` instance whose attributes are " -"defined by *attrdict*. This function is useful for taking a pickled :class:" -"`LogRecord` attribute dictionary, sent over a socket, and reconstituting it " -"as a :class:`LogRecord` instance at the receiving end." +"defined by *attrdict*. This function is useful for taking a " +"pickled :class:`LogRecord` attribute dictionary, sent over a socket, and " +"reconstituting it as a :class:`LogRecord` instance at the receiving end." msgstr "" msgid "" -"Does basic configuration for the logging system by creating a :class:" -"`StreamHandler` with a default :class:`Formatter` and adding it to the root " -"logger. The functions :func:`debug`, :func:`info`, :func:`warning`, :func:" -"`error` and :func:`critical` will call :func:`basicConfig` automatically if " -"no handlers are defined for the root logger." +"Does basic configuration for the logging system by creating " +"a :class:`StreamHandler` with a default :class:`Formatter` and adding it to " +"the root logger. The " +"functions :func:`debug`, :func:`info`, :func:`warning`, :func:`error` " +"and :func:`critical` will call :func:`basicConfig` automatically if no " +"handlers are defined for the root logger." msgstr "" msgid "" @@ -1718,8 +1735,9 @@ msgid "" "If this keyword argument is specified along with *filename*, its value is " "used when the :class:`FileHandler` is created, and thus used when opening " "the output file. If not specified, the value 'backslashreplace' is used. " -"Note that if ``None`` is specified, it will be passed as such to :func:" -"`open`, which means that it will be treated the same as passing 'errors'." +"Note that if ``None`` is specified, it will be passed as such " +"to :func:`open`, which means that it will be treated the same as passing " +"'errors'." msgstr "" msgid "The *style* argument was added." @@ -1751,8 +1769,8 @@ msgstr "" msgid "" "Tells the logging system to use the class *klass* when instantiating a " "logger. The class should define :meth:`!__init__` such that only a name " -"argument is required, and the :meth:`!__init__` should call :meth:`!Logger." -"__init__`. This function is typically called before any loggers are " +"argument is required, and the :meth:`!__init__` should call :meth:`!" +"Logger.__init__`. This function is typically called before any loggers are " "instantiated by applications which need to use custom logger behavior. After " "this call, as at any other time, do not instantiate loggers directly using " "the subclass: continue to use the :func:`logging.getLogger` API to get your " @@ -1833,13 +1851,13 @@ msgid "Module-Level Attributes" msgstr "" msgid "" -"A \"handler of last resort\" is available through this attribute. This is a :" -"class:`StreamHandler` writing to ``sys.stderr`` with a level of ``WARNING``, " -"and is used to handle logging events in the absence of any logging " -"configuration. The end result is to just print the message to ``sys." -"stderr``. This replaces the earlier error message saying that \"no handlers " -"could be found for logger XYZ\". If you need the earlier behaviour for some " -"reason, ``lastResort`` can be set to ``None``." +"A \"handler of last resort\" is available through this attribute. This is " +"a :class:`StreamHandler` writing to ``sys.stderr`` with a level of " +"``WARNING``, and is used to handle logging events in the absence of any " +"logging configuration. The end result is to just print the message to " +"``sys.stderr``. This replaces the earlier error message saying that \"no " +"handlers could be found for logger XYZ\". If you need the earlier behaviour " +"for some reason, ``lastResort`` can be set to ``None``." msgstr "" msgid "Used to see if exceptions during handling should be propagated." @@ -1871,14 +1889,14 @@ msgid "" "If *capture* is ``True``, warnings issued by the :mod:`warnings` module will " "be redirected to the logging system. Specifically, a warning will be " "formatted using :func:`warnings.formatwarning` and the resulting string " -"logged to a logger named ``'py.warnings'`` with a severity of :const:" -"`WARNING`." +"logged to a logger named ``'py.warnings'`` with a severity " +"of :const:`WARNING`." msgstr "" msgid "" "If *capture* is ``False``, the redirection of warnings to the logging system " -"will stop, and warnings will be redirected to their original destinations (i." -"e. those in effect before ``captureWarnings(True)`` was called)." +"will stop, and warnings will be redirected to their original destinations " +"(i.e. those in effect before ``captureWarnings(True)`` was called)." msgstr "" msgid "Module :mod:`logging.config`" @@ -1902,8 +1920,8 @@ msgid "" msgstr "" msgid "" -"`Original Python logging package `_" +"`Original Python logging package `_" msgstr "" msgid "" diff --git a/library/lzma.po b/library/lzma.po index 52768cfe32..b4d1c37e07 100644 --- a/library/lzma.po +++ b/library/lzma.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,7 +27,7 @@ msgid ":mod:`!lzma` --- Compression using the LZMA algorithm" msgstr "" msgid "**Source code:** :source:`Lib/lzma.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/lzma.py`" msgid "" "This module provides classes and convenience functions for compressing and " @@ -38,10 +37,10 @@ msgid "" msgstr "" msgid "" -"The interface provided by this module is very similar to that of the :mod:" -"`bz2` module. Note that :class:`LZMAFile` and :class:`bz2.BZ2File` are *not* " -"thread-safe, so if you need to use a single :class:`LZMAFile` instance from " -"multiple threads, it is necessary to protect it with a lock." +"The interface provided by this module is very similar to that of " +"the :mod:`bz2` module. Note that :class:`LZMAFile` and :class:`bz2.BZ2File` " +"are *not* thread-safe, so if you need to use a single :class:`LZMAFile` " +"instance from multiple threads, it is necessary to protect it with a lock." msgstr "" msgid "" @@ -58,10 +57,10 @@ msgid "" msgstr "" msgid "" -"The *filename* argument can be either an actual file name (given as a :class:" -"`str`, :class:`bytes` or :term:`path-like ` object), in " -"which case the named file is opened, or it can be an existing file object to " -"read from or write to." +"The *filename* argument can be either an actual file name (given as " +"a :class:`str`, :class:`bytes` or :term:`path-like ` " +"object), in which case the named file is opened, or it can be an existing " +"file object to read from or write to." msgstr "" msgid "" @@ -89,8 +88,8 @@ msgid "" msgstr "" msgid "" -"For text mode, a :class:`LZMAFile` object is created, and wrapped in an :" -"class:`io.TextIOWrapper` instance with the specified encoding, error " +"For text mode, a :class:`LZMAFile` object is created, and wrapped in " +"an :class:`io.TextIOWrapper` instance with the specified encoding, error " "handling behavior, and line ending(s)." msgstr "" @@ -106,10 +105,10 @@ msgstr "" msgid "" "An :class:`LZMAFile` can wrap an already-open :term:`file object`, or " "operate directly on a named file. The *filename* argument specifies either " -"the file object to wrap, or the name of the file to open (as a :class:" -"`str`, :class:`bytes` or :term:`path-like ` object). When " -"wrapping an existing file object, the wrapped file will not be closed when " -"the :class:`LZMAFile` is closed." +"the file object to wrap, or the name of the file to open (as " +"a :class:`str`, :class:`bytes` or :term:`path-like ` " +"object). When wrapping an existing file object, the wrapped file will not be " +"closed when the :class:`LZMAFile` is closed." msgstr "" msgid "" @@ -131,9 +130,10 @@ msgid "" msgstr "" msgid "" -":class:`LZMAFile` supports all the members specified by :class:`io." -"BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` and :meth:`~io." -"IOBase.truncate`. Iteration and the :keyword:`with` statement are supported." +":class:`LZMAFile` supports all the members specified " +"by :class:`io.BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` " +"and :meth:`~io.IOBase.truncate`. Iteration and the :keyword:`with` statement " +"are supported." msgstr "" msgid "The following method and attributes are also provided:" @@ -146,10 +146,10 @@ msgid "" msgstr "" msgid "" -"While calling :meth:`peek` does not change the file position of the :class:" -"`LZMAFile`, it may change the position of the underlying file object (e.g. " -"if the :class:`LZMAFile` was constructed by passing a file object for " -"*filename*)." +"While calling :meth:`peek` does not change the file position of " +"the :class:`LZMAFile`, it may change the position of the underlying file " +"object (e.g. if the :class:`LZMAFile` was constructed by passing a file " +"object for *filename*)." msgstr "" msgid "``'rb'`` for reading and ``'wb'`` for writing." @@ -176,59 +176,22 @@ msgid "" msgstr "" msgid "" -"For a more convenient way of compressing a single chunk of data, see :func:" -"`compress`." +"For a more convenient way of compressing a single chunk of data, " +"see :func:`compress`." msgstr "" msgid "" "The *format* argument specifies what container format should be used. " -"Possible values are:" -msgstr "" - -msgid ":const:`FORMAT_XZ`: The ``.xz`` container format." -msgstr "" - -msgid "This is the default format." -msgstr "" - -msgid ":const:`FORMAT_ALONE`: The legacy ``.lzma`` container format." -msgstr "" - -msgid "" -"This format is more limited than ``.xz`` -- it does not support integrity " -"checks or multiple filters." -msgstr "" - -msgid ":const:`FORMAT_RAW`: A raw data stream, not using any container format." -msgstr "" - -msgid "" -"This format specifier does not support integrity checks, and requires that " -"you always specify a custom filter chain (for both compression and " -"decompression). Additionally, data compressed in this manner cannot be " -"decompressed using :const:`FORMAT_AUTO` (see :class:`LZMADecompressor`)." +"Possible values are :const:`FORMAT_XZ` (the default), :const:`FORMAT_ALONE` " +"and :const:`FORMAT_RAW`." msgstr "" msgid "" "The *check* argument specifies the type of integrity check to include in the " "compressed data. This check is used when decompressing, to ensure that the " -"data has not been corrupted. Possible values are:" -msgstr "" - -msgid "" -":const:`CHECK_NONE`: No integrity check. This is the default (and the only " -"acceptable value) for :const:`FORMAT_ALONE` and :const:`FORMAT_RAW`." -msgstr "" - -msgid ":const:`CHECK_CRC32`: 32-bit Cyclic Redundancy Check." -msgstr "" - -msgid "" -":const:`CHECK_CRC64`: 64-bit Cyclic Redundancy Check. This is the default " -"for :const:`FORMAT_XZ`." -msgstr "" - -msgid ":const:`CHECK_SHA256`: 256-bit Secure Hash Algorithm." +"data has not been corrupted. Possible values " +"are :const:`CHECK_NONE`, :const:`CHECK_CRC32`, :const:`CHECK_CRC64` (the " +"default for :const:`FORMAT_XZ`) and :const:`CHECK_SHA256`." msgstr "" msgid "" @@ -243,18 +206,19 @@ msgstr "" msgid "" "The *preset* argument (if provided) should be an integer between ``0`` and " -"``9`` (inclusive), optionally OR-ed with the constant :const:" -"`PRESET_EXTREME`. If neither *preset* nor *filters* are given, the default " -"behavior is to use :const:`PRESET_DEFAULT` (preset level ``6``). Higher " -"presets produce smaller output, but make the compression process slower." +"``9`` (inclusive), optionally OR-ed with the " +"constant :const:`PRESET_EXTREME`. If neither *preset* nor *filters* are " +"given, the default behavior is to use :const:`PRESET_DEFAULT` (preset level " +"``6``). Higher presets produce smaller output, but make the compression " +"process slower." msgstr "" msgid "" "In addition to being more CPU-intensive, compression with higher presets " "also requires much more memory (and produces output that needs more memory " -"to decompress). With preset ``9`` for example, the overhead for an :class:" -"`LZMACompressor` object can be as high as 800 MiB. For this reason, it is " -"generally best to stick with the default preset." +"to decompress). With preset ``9`` for example, the overhead for " +"an :class:`LZMACompressor` object can be as high as 800 MiB. For this " +"reason, it is generally best to stick with the default preset." msgstr "" msgid "" @@ -265,9 +229,9 @@ msgstr "" msgid "" "Compress *data* (a :class:`bytes` object), returning a :class:`bytes` object " "containing compressed data for at least part of the input. Some of *data* " -"may be buffered internally, for use in later calls to :meth:`compress` and :" -"meth:`flush`. The returned data should be concatenated with the output of " -"any previous calls to :meth:`compress`." +"may be buffered internally, for use in later calls to :meth:`compress` " +"and :meth:`flush`. The returned data should be concatenated with the output " +"of any previous calls to :meth:`compress`." msgstr "" msgid "" @@ -291,8 +255,8 @@ msgstr "" msgid "" "The *format* argument specifies the container format that should be used. " "The default is :const:`FORMAT_AUTO`, which can decompress both ``.xz`` and " -"``.lzma`` files. Other possible values are :const:`FORMAT_XZ`, :const:" -"`FORMAT_ALONE`, and :const:`FORMAT_RAW`." +"``.lzma`` files. Other possible values " +"are :const:`FORMAT_XZ`, :const:`FORMAT_ALONE`, and :const:`FORMAT_RAW`." msgstr "" msgid "" @@ -304,9 +268,9 @@ msgstr "" msgid "" "The *filters* argument specifies the filter chain that was used to create " -"the stream being decompressed. This argument is required if *format* is :" -"const:`FORMAT_RAW`, but should not be used for other formats. See :ref:" -"`filter-chain-specs` for more information about filter chains." +"the stream being decompressed. This argument is required if *format* " +"is :const:`FORMAT_RAW`, but should not be used for other formats. " +"See :ref:`filter-chain-specs` for more information about filter chains." msgstr "" msgid "" @@ -338,18 +302,18 @@ msgid "" msgstr "" msgid "" -"Attempting to decompress data after the end of stream is reached raises an :" -"exc:`EOFError`. Any data found after the end of the stream is ignored and " -"saved in the :attr:`~.unused_data` attribute." +"Attempting to decompress data after the end of stream is reached raises " +"an :exc:`EOFError`. Any data found after the end of the stream is ignored " +"and saved in the :attr:`~.unused_data` attribute." msgstr "" msgid "Added the *max_length* parameter." msgstr "" msgid "" -"The ID of the integrity check used by the input stream. This may be :const:" -"`CHECK_UNKNOWN` until enough of the input has been decoded to determine what " -"integrity check it uses." +"The ID of the integrity check used by the input stream. This may " +"be :const:`CHECK_UNKNOWN` until enough of the input has been decoded to " +"determine what integrity check it uses." msgstr "" msgid "``True`` if the end-of-stream marker has been reached." @@ -399,9 +363,10 @@ msgid "" msgstr "" msgid "" -":const:`CHECK_NONE` and :const:`CHECK_CRC32` are always supported. :const:" -"`CHECK_CRC64` and :const:`CHECK_SHA256` may be unavailable if you are using " -"a version of :program:`liblzma` that was compiled with a limited feature set." +":const:`CHECK_NONE` and :const:`CHECK_CRC32` are always " +"supported. :const:`CHECK_CRC64` and :const:`CHECK_SHA256` may be unavailable " +"if you are using a version of :program:`liblzma` that was compiled with a " +"limited feature set." msgstr "" msgid "Specifying custom filter chains" @@ -421,8 +386,8 @@ msgid ":const:`FILTER_LZMA1` (for use with :const:`FORMAT_ALONE`)" msgstr "" msgid "" -":const:`FILTER_LZMA2` (for use with :const:`FORMAT_XZ` and :const:" -"`FORMAT_RAW`)" +":const:`FILTER_LZMA2` (for use with :const:`FORMAT_XZ` " +"and :const:`FORMAT_RAW`)" msgstr "" msgid "Delta filter:" @@ -434,23 +399,23 @@ msgstr ":const:`FILTER_DELTA`" msgid "Branch-Call-Jump (BCJ) filters:" msgstr "" -msgid ":const:`FILTER_X86`" -msgstr ":const:`FILTER_X86`" +msgid ":const:`!FILTER_X86`" +msgstr "" -msgid ":const:`FILTER_IA64`" -msgstr ":const:`FILTER_IA64`" +msgid ":const:`!FILTER_IA64`" +msgstr "" -msgid ":const:`FILTER_ARM`" -msgstr ":const:`FILTER_ARM`" +msgid ":const:`!FILTER_ARM`" +msgstr "" -msgid ":const:`FILTER_ARMTHUMB`" -msgstr ":const:`FILTER_ARMTHUMB`" +msgid ":const:`!FILTER_ARMTHUMB`" +msgstr "" -msgid ":const:`FILTER_POWERPC`" -msgstr ":const:`FILTER_POWERPC`" +msgid ":const:`!FILTER_POWERPC`" +msgstr "" -msgid ":const:`FILTER_SPARC`" -msgstr ":const:`FILTER_SPARC`" +msgid ":const:`!FILTER_SPARC`" +msgstr "" msgid "" "A filter chain can consist of up to 4 filters, and cannot be empty. The last " @@ -493,8 +458,9 @@ msgid "" msgstr "" msgid "" -"``mf``: What match finder to use -- :const:`MF_HC3`, :const:`MF_HC4`, :const:" -"`MF_BT2`, :const:`MF_BT3`, or :const:`MF_BT4`." +"``mf``: What match finder to use " +"-- :const:`MF_HC3`, :const:`MF_HC4`, :const:`MF_BT2`, :const:`MF_BT3`, " +"or :const:`MF_BT4`." msgstr "" msgid "" @@ -519,6 +485,99 @@ msgid "" "data. The default is 0." msgstr "" +msgid "Constants" +msgstr "Stały" + +msgid "" +"The following module-level constants are provided for use as the *format*, " +"*check*, *preset* and *filters* arguments of the classes and functions above." +msgstr "" + +msgid "Container formats:" +msgstr "" + +msgid "The ``.xz`` container format." +msgstr "" + +msgid "" +"The legacy ``.lzma`` container format. This format is more limited than " +"``.xz`` -- it does not support integrity checks or multiple filters." +msgstr "" + +msgid "" +"A raw data stream, not using any container format. This format specifier " +"does not support integrity checks, and requires that you always specify a " +"custom filter chain (for both compression and decompression). Additionally, " +"data compressed in this manner cannot be decompressed " +"using :const:`FORMAT_AUTO`." +msgstr "" + +msgid "" +"Used for decompression only. The container format is detected " +"automatically, so that both ``.xz`` and ``.lzma`` files can be decompressed." +msgstr "" + +msgid "Integrity checks:" +msgstr "" + +msgid "" +"No integrity check. This is the default (and the only acceptable value) " +"for :const:`FORMAT_ALONE` and :const:`FORMAT_RAW`." +msgstr "" + +msgid "A 32-bit Cyclic Redundancy Check." +msgstr "" + +msgid "" +"A 64-bit Cyclic Redundancy Check. This is the default " +"for :const:`FORMAT_XZ`." +msgstr "" + +msgid "A 256-bit Secure Hash Algorithm." +msgstr "" + +msgid "" +"The integrity check used by a stream could not yet be determined. This may " +"be the value of the :attr:`LZMADecompressor.check` attribute until enough of " +"the input has been decoded." +msgstr "" + +msgid "The largest supported integrity-check ID." +msgstr "" + +msgid "Compression presets:" +msgstr "" + +msgid "The default compression preset, equivalent to preset level ``6``." +msgstr "" + +msgid "" +"A flag that may be bitwise OR-ed with a preset level (``0`` to ``9``) to " +"select a slower but more thorough variant of that preset." +msgstr "" + +msgid "Filter IDs and options:" +msgstr "" + +msgid "" +"The LZMA1 and LZMA2 compression filters. :const:`FILTER_LZMA1` is for use " +"with :const:`FORMAT_ALONE`, while :const:`FILTER_LZMA2` is for use " +"with :const:`FORMAT_XZ` and :const:`FORMAT_RAW`." +msgstr "" + +msgid "The delta filter." +msgstr "" + +msgid "" +"Compression modes that may be used as the ``mode`` option of a filter " +"specifier (see :ref:`filter-chain-specs`)." +msgstr "" + +msgid "" +"Match finders that may be used as the ``mf`` option of a filter specifier " +"(see :ref:`filter-chain-specs`)." +msgstr "" + msgid "Examples" msgstr "Przykłady" diff --git a/library/mailbox.po b/library/mailbox.po index 65e9be0c62..2a8702ecc8 100644 --- a/library/mailbox.po +++ b/library/mailbox.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,15 +27,16 @@ msgid ":mod:`!mailbox` --- Manipulate mailboxes in various formats" msgstr "" msgid "**Source code:** :source:`Lib/mailbox.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/mailbox.py`" msgid "" "This module defines two classes, :class:`Mailbox` and :class:`Message`, for " -"accessing and manipulating on-disk mailboxes and the messages they contain. :" -"class:`!Mailbox` offers a dictionary-like mapping from keys to messages. :" -"class:`!Message` extends the :mod:`email.message` module's :class:`~email." -"message.Message` class with format-specific state and behavior. Supported " -"mailbox formats are Maildir, mbox, MH, Babyl, and MMDF." +"accessing and manipulating on-disk mailboxes and the messages they " +"contain. :class:`!Mailbox` offers a dictionary-like mapping from keys to " +"messages. :class:`!Message` extends the :mod:`email.message` " +"module's :class:`~email.message.Message` class with format-specific state " +"and behavior. Supported mailbox formats are Maildir, mbox, MH, Babyl, and " +"MMDF." msgstr "" msgid "Module :mod:`email`" @@ -54,8 +53,9 @@ msgstr "" msgid "" "The :class:`!Mailbox` class defines an interface and is not intended to be " -"instantiated. Instead, format-specific subclasses should inherit from :" -"class:`!Mailbox` and your code should instantiate a particular subclass." +"instantiated. Instead, format-specific subclasses should inherit " +"from :class:`!Mailbox` and your code should instantiate a particular " +"subclass." msgstr "" msgid "" @@ -97,8 +97,8 @@ msgstr "" msgid "" "Be very cautious when modifying mailboxes that might be simultaneously " "changed by some other process. The safest mailbox format to use for such " -"tasks is :class:`Maildir`; try to avoid using single-file formats such as :" -"class:`mbox` for concurrent writing. If you're modifying a mailbox, you " +"tasks is :class:`Maildir`; try to avoid using single-file formats such " +"as :class:`mbox` for concurrent writing. If you're modifying a mailbox, you " "*must* lock it by calling the :meth:`lock` and :meth:`unlock` methods " "*before* reading any messages in the file or making any changes by adding or " "deleting a message. Failing to lock the mailbox runs the risk of losing " @@ -113,13 +113,13 @@ msgid "" msgstr "" msgid "" -"Parameter *message* may be a :class:`Message` instance, an :class:`email." -"message.Message` instance, a string, a byte string, or a file-like object " -"(which should be open in binary mode). If *message* is an instance of the " -"appropriate format-specific :class:`Message` subclass (e.g., if it's an :" -"class:`mboxMessage` instance and this is an :class:`mbox` instance), its " -"format-specific information is used. Otherwise, reasonable defaults for " -"format-specific information are used." +"Parameter *message* may be a :class:`Message` instance, " +"an :class:`email.message.Message` instance, a string, a byte string, or a " +"file-like object (which should be open in binary mode). If *message* is an " +"instance of the appropriate format-specific :class:`Message` subclass (e.g., " +"if it's an :class:`mboxMessage` instance and this is an :class:`mbox` " +"instance), its format-specific information is used. Otherwise, reasonable " +"defaults for format-specific information are used." msgstr "" msgid "Support for binary input was added." @@ -131,14 +131,14 @@ msgstr "" msgid "" "If no such message exists, a :exc:`KeyError` exception is raised if the " "method was called as :meth:`remove` or :meth:`__delitem__` but no exception " -"is raised if the method was called as :meth:`discard`. The behavior of :meth:" -"`discard` may be preferred if the underlying mailbox format supports " -"concurrent modification by other processes." +"is raised if the method was called as :meth:`discard`. The behavior " +"of :meth:`discard` may be preferred if the underlying mailbox format " +"supports concurrent modification by other processes." msgstr "" msgid "" -"Replace the message corresponding to *key* with *message*. Raise a :exc:" -"`KeyError` exception if no message already corresponds to *key*." +"Replace the message corresponding to *key* with *message*. Raise " +"a :exc:`KeyError` exception if no message already corresponds to *key*." msgstr "" msgid "" @@ -162,9 +162,9 @@ msgstr "" msgid "" "Return an :term:`iterator` over representations of all messages. The " -"messages are represented as instances of the appropriate format-specific :" -"class:`Message` subclass unless a custom message factory was specified when " -"the :class:`!Mailbox` instance was initialized." +"messages are represented as instances of the appropriate format-" +"specific :class:`Message` subclass unless a custom message factory was " +"specified when the :class:`!Mailbox` instance was initialized." msgstr "" msgid "" @@ -192,18 +192,18 @@ msgstr "" msgid "" "Return a representation of the message corresponding to *key*. If no such " -"message exists, *default* is returned if the method was called as :meth:" -"`get` and a :exc:`KeyError` exception is raised if the method was called as :" -"meth:`!__getitem__`. The message is represented as an instance of the " -"appropriate format-specific :class:`Message` subclass unless a custom " +"message exists, *default* is returned if the method was called " +"as :meth:`get` and a :exc:`KeyError` exception is raised if the method was " +"called as :meth:`!__getitem__`. The message is represented as an instance of " +"the appropriate format-specific :class:`Message` subclass unless a custom " "message factory was specified when the :class:`!Mailbox` instance was " "initialized." msgstr "" msgid "" "Return a representation of the message corresponding to *key* as an instance " -"of the appropriate format-specific :class:`Message` subclass, or raise a :" -"exc:`KeyError` exception if no such message exists." +"of the appropriate format-specific :class:`Message` subclass, or raise " +"a :exc:`KeyError` exception if no such message exists." msgstr "" msgid "" @@ -251,18 +251,18 @@ msgstr "" msgid "" "Return a representation of the message corresponding to *key* and delete the " "message. If no such message exists, return *default*. The message is " -"represented as an instance of the appropriate format-specific :class:" -"`Message` subclass unless a custom message factory was specified when the :" -"class:`!Mailbox` instance was initialized." +"represented as an instance of the appropriate format-" +"specific :class:`Message` subclass unless a custom message factory was " +"specified when the :class:`!Mailbox` instance was initialized." msgstr "" msgid "" "Return an arbitrary (*key*, *message*) pair, where *key* is a key and " "*message* is a message representation, and delete the corresponding message. " "If the mailbox is empty, raise a :exc:`KeyError` exception. The message is " -"represented as an instance of the appropriate format-specific :class:" -"`Message` subclass unless a custom message factory was specified when the :" -"class:`!Mailbox` instance was initialized." +"represented as an instance of the appropriate format-" +"specific :class:`Message` subclass unless a custom message factory was " +"specified when the :class:`!Mailbox` instance was initialized." msgstr "" msgid "" @@ -271,8 +271,8 @@ msgid "" "and *message*, the message corresponding to *key* is set to *message* as if " "by using :meth:`__setitem__`. As with :meth:`__setitem__`, each *key* must " "already correspond to a message in the mailbox or else a :exc:`KeyError` " -"exception will be raised, so in general it is incorrect for *arg* to be a :" -"class:`!Mailbox` instance." +"exception will be raised, so in general it is incorrect for *arg* to be " +"a :class:`!Mailbox` instance." msgstr "" msgid "Unlike with dictionaries, keyword arguments are not supported." @@ -332,19 +332,20 @@ msgid "" msgstr "" msgid "" -"Maildir mailboxes contain three subdirectories, namely: :file:`tmp`, :file:" -"`new`, and :file:`cur`. Messages are created momentarily in the :file:`tmp` " -"subdirectory and then moved to the :file:`new` subdirectory to finalize " -"delivery. A mail user agent may subsequently move the message to the :file:" -"`cur` subdirectory and store information about the state of the message in a " -"special \"info\" section appended to its file name." +"Maildir mailboxes contain three subdirectories, " +"namely: :file:`tmp`, :file:`new`, and :file:`cur`. Messages are created " +"momentarily in the :file:`tmp` subdirectory and then moved to " +"the :file:`new` subdirectory to finalize delivery. A mail user agent may " +"subsequently move the message to the :file:`cur` subdirectory and store " +"information about the state of the message in a special \"info\" section " +"appended to its file name." msgstr "" msgid "" "Folders of the style introduced by the Courier mail transfer agent are also " "supported. Any subdirectory of the main mailbox is considered a folder if " -"``'.'`` is the first character in its name. Folder names are represented by :" -"class:`!Maildir` without the leading ``'.'``. Each folder is itself a " +"``'.'`` is the first character in its name. Folder names are represented " +"by :class:`!Maildir` without the leading ``'.'``. Each folder is itself a " "Maildir mailbox but should not contain other folders. Instead, a logical " "nesting is indicated using ``'.'`` to delimit levels, e.g., " "\"Archived.2005.07\"." @@ -408,11 +409,12 @@ msgid "" msgstr "" msgid "" -"If you do have a :class:`MaildirMessage` object, use its :meth:" -"`~MaildirMessage.get_flags` method instead, because changes made by the " -"message's :meth:`~MaildirMessage.set_flags`, :meth:`~MaildirMessage." -"add_flag` and :meth:`~MaildirMessage.remove_flag` methods are not reflected " -"here until the mailbox's :meth:`__setitem__` method is called." +"If you do have a :class:`MaildirMessage` object, use " +"its :meth:`~MaildirMessage.get_flags` method instead, because changes made " +"by the " +"message's :meth:`~MaildirMessage.set_flags`, :meth:`~MaildirMessage.add_flag` " +"and :meth:`~MaildirMessage.remove_flag` methods are not reflected here until " +"the mailbox's :meth:`__setitem__` method is called." msgstr "" msgid "" @@ -431,10 +433,10 @@ msgid "but faster, because it does not open the message file." msgstr "" msgid "" -"If you do have a :class:`MaildirMessage` object, use its :meth:" -"`~MaildirMessage.set_flags` method instead, because changes made with this " -"mailbox method will not be visible to the message object's method, :meth:" -"`~MaildirMessage.get_flags`." +"If you do have a :class:`MaildirMessage` object, use " +"its :meth:`~MaildirMessage.set_flags` method instead, because changes made " +"with this mailbox method will not be visible to the message object's " +"method, :meth:`~MaildirMessage.get_flags`." msgstr "" msgid "" @@ -444,9 +446,9 @@ msgid "" msgstr "" msgid "" -"Considerations for using this method versus the message object's :meth:" -"`~MaildirMessage.add_flag` method are similar to those for :meth:" -"`set_flags`; see the discussion there." +"Considerations for using this method versus the message " +"object's :meth:`~MaildirMessage.add_flag` method are similar to those " +"for :meth:`set_flags`; see the discussion there." msgstr "" msgid "" @@ -456,9 +458,9 @@ msgid "" msgstr "" msgid "" -"Considerations for using this method versus the message object's :meth:" -"`~MaildirMessage.remove_flag` method are similar to those for :meth:" -"`set_flags`; see the discussion there." +"Considerations for using this method versus the message " +"object's :meth:`~MaildirMessage.remove_flag` method are similar to those " +"for :meth:`set_flags`; see the discussion there." msgstr "" msgid "" @@ -469,9 +471,9 @@ msgid "" msgstr "" msgid "" -"If you do have a :class:`MaildirMessage` object, use its :meth:" -"`~MaildirMessage.get_info` method instead, because changes made by the " -"message's :meth:`~MaildirMessage.set_info` method are not reflected here " +"If you do have a :class:`MaildirMessage` object, use " +"its :meth:`~MaildirMessage.get_info` method instead, because changes made by " +"the message's :meth:`~MaildirMessage.set_info` method are not reflected here " "until the mailbox's :meth:`__setitem__` method is called." msgstr "" @@ -487,10 +489,10 @@ msgid "" msgstr "" msgid "" -"If you do have a :class:`MaildirMessage` object, use its :meth:" -"`~MaildirMessage.set_info` method instead, because changes made with this " -"mailbox method will not be visible to the message object's method, :meth:" -"`~MaildirMessage.get_info`." +"If you do have a :class:`MaildirMessage` object, use " +"its :meth:`~MaildirMessage.set_info` method instead, because changes made " +"with this mailbox method will not be visible to the message object's " +"method, :meth:`~MaildirMessage.get_info`." msgstr "" msgid "" @@ -564,8 +566,8 @@ msgstr "" msgid "" "Several variations of the mbox format exist to address perceived " "shortcomings in the original. In the interest of compatibility, :class:`!" -"mbox` implements the original format, which is sometimes referred to as :dfn:" -"`mboxo`. This means that the :mailheader:`Content-Length` header, if " +"mbox` implements the original format, which is sometimes referred to " +"as :dfn:`mboxo`. This means that the :mailheader:`Content-Length` header, if " "present, is ignored and that any occurrences of \"From \" at the beginning " "of a line in a message body are transformed to \">From \" when storing the " "message, although occurrences of \">From \" are not transformed to \"From \" " @@ -584,14 +586,14 @@ msgid "" msgstr "" msgid "" -"Using the file after calling :meth:`~Mailbox.flush` or :meth:`~Mailbox." -"close` on the :class:`!mbox` instance may yield unpredictable results or " -"raise an exception." +"Using the file after calling :meth:`~Mailbox.flush` " +"or :meth:`~Mailbox.close` on the :class:`!mbox` instance may yield " +"unpredictable results or raise an exception." msgstr "" msgid "" -"Three locking mechanisms are used---dot locking and, if available, the :c:" -"func:`!flock` and :c:func:`!lockf` system calls." +"Three locking mechanisms are used---dot locking and, if available, " +"the :c:func:`!flock` and :c:func:`!lockf` system calls." msgstr "" msgid "" @@ -673,8 +675,8 @@ msgstr "" msgid "" "Re-define the sequences that exist in the mailbox based upon *sequences*, a " -"dictionary of names mapped to key lists, like returned by :meth:" -"`get_sequences`." +"dictionary of names mapped to key lists, like returned " +"by :meth:`get_sequences`." msgstr "" msgid "" @@ -698,11 +700,11 @@ msgid "" msgstr "" msgid "" -"Three locking mechanisms are used---dot locking and, if available, the :c:" -"func:`!flock` and :c:func:`!lockf` system calls. For MH mailboxes, locking " -"the mailbox means locking the :file:`.mh_sequences` file and, only for the " -"duration of any operations that affect them, locking individual message " -"files." +"Three locking mechanisms are used---dot locking and, if available, " +"the :c:func:`!flock` and :c:func:`!lockf` system calls. For MH mailboxes, " +"locking the mailbox means locking the :file:`.mh_sequences` file and, only " +"for the duration of any operations that affect them, locking individual " +"message files." msgstr "" msgid "" @@ -724,8 +726,8 @@ msgid "`nmh - Message Handling System `_" msgstr "" msgid "" -"Home page of :program:`nmh`, an updated version of the original :program:" -"`mh`." +"Home page of :program:`nmh`, an updated version of the " +"original :program:`mh`." msgstr "" msgid "" @@ -843,9 +845,9 @@ msgid "" msgstr "" msgid "" -"Using the file after calling :meth:`~Mailbox.flush` or :meth:`~Mailbox." -"close` on the :class:`!MMDF` instance may yield unpredictable results or " -"raise an exception." +"Using the file after calling :meth:`~Mailbox.flush` " +"or :meth:`~Mailbox.close` on the :class:`!MMDF` instance may yield " +"unpredictable results or raise an exception." msgstr "" msgid "" @@ -869,9 +871,9 @@ msgid ":class:`!Message` objects" msgstr "" msgid "" -"A subclass of the :mod:`email.message` module's :class:`~email.message." -"Message`. Subclasses of :class:`!mailbox.Message` add mailbox-format-" -"specific state and behavior." +"A subclass of the :mod:`email.message` " +"module's :class:`~email.message.Message`. Subclasses of :class:`!" +"mailbox.Message` add mailbox-format-specific state and behavior." msgstr "" msgid "" @@ -879,9 +881,9 @@ msgid "" "state. If *message* is an :class:`email.message.Message` instance, its " "contents are copied; furthermore, any format-specific information is " "converted insofar as possible if *message* is a :class:`!Message` instance. " -"If *message* is a string, a byte string, or a file, it should contain an :" -"rfc:`2822`\\ -compliant message, which is read and parsed. Files should be " -"open in binary mode, but text mode files are accepted for backward " +"If *message* is a string, a byte string, or a file, it should contain " +"an :rfc:`5322`\\ -compliant message, which is read and parsed. Files should " +"be open in binary mode, but text mode files are accepted for backward " "compatibility." msgstr "" @@ -915,16 +917,16 @@ msgid "" msgstr "" msgid "" -"Typically, a mail user agent application moves all of the messages in the :" -"file:`new` subdirectory to the :file:`cur` subdirectory after the first time " -"the user opens and closes the mailbox, recording that the messages are old " -"whether or not they've actually been read. Each message in :file:`cur` has " -"an \"info\" section added to its file name to store information about its " -"state. (Some mail readers may also add an \"info\" section to messages in :" -"file:`new`.) The \"info\" section may take one of two forms: it may contain " -"\"2,\" followed by a list of standardized flags (e.g., \"2,FR\") or it may " -"contain \"1,\" followed by so-called experimental information. Standard " -"flags for Maildir messages are as follows:" +"Typically, a mail user agent application moves all of the messages in " +"the :file:`new` subdirectory to the :file:`cur` subdirectory after the first " +"time the user opens and closes the mailbox, recording that the messages are " +"old whether or not they've actually been read. Each message in :file:`cur` " +"has an \"info\" section added to its file name to store information about " +"its state. (Some mail readers may also add an \"info\" section to messages " +"in :file:`new`.) The \"info\" section may take one of two forms: it may " +"contain \"2,\" followed by a list of standardized flags (e.g., \"2,FR\") or " +"it may contain \"1,\" followed by so-called experimental information. " +"Standard flags for Maildir messages are as follows:" msgstr "" msgid "Flag" @@ -1030,7 +1032,7 @@ msgstr "" msgid "" "Unset the flag(s) specified by *flag* without changing other flags. To " -"remove more than one flag at a time, *flag* maybe a string of more than one " +"remove more than one flag at a time, *flag* may be a string of more than one " "character. If \"info\" contains experimental information rather than flags, " "the current \"info\" is not modified." msgstr "" @@ -1055,10 +1057,10 @@ msgid "Set \"info\" to *info*, which should be a string." msgstr "" msgid "" -"When a :class:`!MaildirMessage` instance is created based upon an :class:" -"`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` " -"and :mailheader:`X-Status` headers are omitted and the following conversions " -"take place:" +"When a :class:`!MaildirMessage` instance is created based upon " +"an :class:`mboxMessage` or :class:`MMDFMessage` instance, " +"the :mailheader:`Status` and :mailheader:`X-Status` headers are omitted and " +"the following conversions take place:" msgstr "" msgid "Resulting state" @@ -1092,8 +1094,8 @@ msgid "D flag" msgstr "" msgid "" -"When a :class:`!MaildirMessage` instance is created based upon an :class:" -"`MHMessage` instance, the following conversions take place:" +"When a :class:`!MaildirMessage` instance is created based upon " +"an :class:`MHMessage` instance, the following conversions take place:" msgstr "" msgid ":class:`MHMessage` state" @@ -1115,8 +1117,8 @@ msgid "\"replied\" sequence" msgstr "" msgid "" -"When a :class:`!MaildirMessage` instance is created based upon a :class:" -"`BabylMessage` instance, the following conversions take place:" +"When a :class:`!MaildirMessage` instance is created based upon " +"a :class:`BabylMessage` instance, the following conversions take place:" msgstr "" msgid ":class:`BabylMessage` state" @@ -1199,8 +1201,8 @@ msgid "" "leading \"From \" or trailing newline. For convenience, *time_* may be " "specified and will be formatted appropriately and appended to *from_*. If " "*time_* is specified, it should be a :class:`time.struct_time` instance, a " -"tuple suitable for passing to :func:`time.strftime`, or ``True`` (to use :" -"func:`time.gmtime`)." +"tuple suitable for passing to :func:`time.strftime`, or ``True`` (to " +"use :func:`time.gmtime`)." msgstr "" msgid "" @@ -1224,14 +1226,14 @@ msgstr "" msgid "" "Unset the flag(s) specified by *flag* without changing other flags. To " -"remove more than one flag at a time, *flag* maybe a string of more than one " +"remove more than one flag at a time, *flag* may be a string of more than one " "character." msgstr "" msgid "" -"When an :class:`!mboxMessage` instance is created based upon a :class:" -"`MaildirMessage` instance, a \"From \" line is generated based upon the :" -"class:`MaildirMessage` instance's delivery date, and the following " +"When an :class:`!mboxMessage` instance is created based upon " +"a :class:`MaildirMessage` instance, a \"From \" line is generated based upon " +"the :class:`MaildirMessage` instance's delivery date, and the following " "conversions take place:" msgstr "" @@ -1239,22 +1241,22 @@ msgid ":class:`MaildirMessage` state" msgstr "" msgid "" -"When an :class:`!mboxMessage` instance is created based upon an :class:" -"`MHMessage` instance, the following conversions take place:" +"When an :class:`!mboxMessage` instance is created based upon " +"an :class:`MHMessage` instance, the following conversions take place:" msgstr "" msgid "R flag and O flag" msgstr "" msgid "" -"When an :class:`!mboxMessage` instance is created based upon a :class:" -"`BabylMessage` instance, the following conversions take place:" +"When an :class:`!mboxMessage` instance is created based upon " +"a :class:`BabylMessage` instance, the following conversions take place:" msgstr "" msgid "" -"When a :class:`!mboxMessage` instance is created based upon an :class:" -"`MMDFMessage` instance, the \"From \" line is copied and all flags directly " -"correspond:" +"When a :class:`!mboxMessage` instance is created based upon " +"an :class:`MMDFMessage` instance, the \"From \" line is copied and all flags " +"directly correspond:" msgstr "" msgid ":class:`MMDFMessage` state" @@ -1271,9 +1273,9 @@ msgstr "" msgid "" "MH messages do not support marks or flags in the traditional sense, but they " "do support sequences, which are logical groupings of arbitrary messages. " -"Some mail reading programs (although not the standard :program:`mh` and :" -"program:`nmh`) use sequences in much the same way flags are used with other " -"formats, as follows:" +"Some mail reading programs (although not the standard :program:`mh` " +"and :program:`nmh`) use sequences in much the same way flags are used with " +"other formats, as follows:" msgstr "" msgid "Sequence" @@ -1307,26 +1309,26 @@ msgid "Remove *sequence* from the list of sequences that include this message." msgstr "" msgid "" -"When an :class:`!MHMessage` instance is created based upon a :class:" -"`MaildirMessage` instance, the following conversions take place:" +"When an :class:`!MHMessage` instance is created based upon " +"a :class:`MaildirMessage` instance, the following conversions take place:" msgstr "" msgid "no S flag" msgstr "" msgid "" -"When an :class:`!MHMessage` instance is created based upon an :class:" -"`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` " -"and :mailheader:`X-Status` headers are omitted and the following conversions " -"take place:" +"When an :class:`!MHMessage` instance is created based upon " +"an :class:`mboxMessage` or :class:`MMDFMessage` instance, " +"the :mailheader:`Status` and :mailheader:`X-Status` headers are omitted and " +"the following conversions take place:" msgstr "" msgid "no R flag" msgstr "" msgid "" -"When an :class:`!MHMessage` instance is created based upon a :class:" -"`BabylMessage` instance, the following conversions take place:" +"When an :class:`!MHMessage` instance is created based upon " +"a :class:`BabylMessage` instance, the following conversions take place:" msgstr "" msgid ":class:`!BabylMessage` objects" @@ -1403,8 +1405,8 @@ msgstr "" msgid "" "Set the message's visible headers to be the same as the headers in " -"*message*. Parameter *visible* should be a :class:`Message` instance, an :" -"class:`email.message.Message` instance, a string, or a file-like object " +"*message*. Parameter *visible* should be a :class:`Message` instance, " +"an :class:`email.message.Message` instance, a string, or a file-like object " "(which should be open in text mode)." msgstr "" @@ -1414,30 +1416,30 @@ msgid "" "updates the visible headers as follows: each visible header with a " "corresponding original header is set to the value of the original header, " "each visible header without a corresponding original header is removed, and " -"any of :mailheader:`Date`, :mailheader:`From`, :mailheader:`Reply-To`, :" -"mailheader:`To`, :mailheader:`CC`, and :mailheader:`Subject` that are " +"any of :mailheader:`Date`, :mailheader:`From`, :mailheader:`Reply-" +"To`, :mailheader:`To`, :mailheader:`CC`, and :mailheader:`Subject` that are " "present in the original headers but not the visible headers are added to the " "visible headers." msgstr "" msgid "" -"When a :class:`!BabylMessage` instance is created based upon a :class:" -"`MaildirMessage` instance, the following conversions take place:" +"When a :class:`!BabylMessage` instance is created based upon " +"a :class:`MaildirMessage` instance, the following conversions take place:" msgstr "" msgid "\"forwarded\" label" msgstr "" msgid "" -"When a :class:`!BabylMessage` instance is created based upon an :class:" -"`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` " -"and :mailheader:`X-Status` headers are omitted and the following conversions " -"take place:" +"When a :class:`!BabylMessage` instance is created based upon " +"an :class:`mboxMessage` or :class:`MMDFMessage` instance, " +"the :mailheader:`Status` and :mailheader:`X-Status` headers are omitted and " +"the following conversions take place:" msgstr "" msgid "" -"When a :class:`!BabylMessage` instance is created based upon an :class:" -"`MHMessage` instance, the following conversions take place:" +"When a :class:`!BabylMessage` instance is created based upon " +"an :class:`MHMessage` instance, the following conversions take place:" msgstr "" msgid ":class:`!MMDFMessage` objects" @@ -1466,26 +1468,26 @@ msgid "" msgstr "" msgid "" -"When an :class:`!MMDFMessage` instance is created based upon a :class:" -"`MaildirMessage` instance, a \"From \" line is generated based upon the :" -"class:`MaildirMessage` instance's delivery date, and the following " +"When an :class:`!MMDFMessage` instance is created based upon " +"a :class:`MaildirMessage` instance, a \"From \" line is generated based upon " +"the :class:`MaildirMessage` instance's delivery date, and the following " "conversions take place:" msgstr "" msgid "" -"When an :class:`!MMDFMessage` instance is created based upon an :class:" -"`MHMessage` instance, the following conversions take place:" +"When an :class:`!MMDFMessage` instance is created based upon " +"an :class:`MHMessage` instance, the following conversions take place:" msgstr "" msgid "" -"When an :class:`!MMDFMessage` instance is created based upon a :class:" -"`BabylMessage` instance, the following conversions take place:" +"When an :class:`!MMDFMessage` instance is created based upon " +"a :class:`BabylMessage` instance, the following conversions take place:" msgstr "" msgid "" -"When an :class:`!MMDFMessage` instance is created based upon an :class:" -"`mboxMessage` instance, the \"From \" line is copied and all flags directly " -"correspond:" +"When an :class:`!MMDFMessage` instance is created based upon " +"an :class:`mboxMessage` instance, the \"From \" line is copied and all flags " +"directly correspond:" msgstr "" msgid ":class:`mboxMessage` state" @@ -1498,7 +1500,7 @@ msgid "" "The following exception classes are defined in the :mod:`!mailbox` module:" msgstr "" -msgid "The based class for all other module-specific exceptions." +msgid "The base class for all other module-specific exceptions." msgstr "" msgid "" @@ -1516,8 +1518,8 @@ msgstr "" msgid "" "Raised when some mailbox-related condition beyond the control of the program " "causes it to be unable to proceed, such as when failing to acquire a lock " -"that another program already holds a lock, or when a uniquely generated file " -"name already exists." +"that another program already holds, or when a uniquely generated file name " +"already exists." msgstr "" msgid "" diff --git a/library/marshal.po b/library/marshal.po index 6e5951d774..62874943ee 100644 --- a/library/marshal.po +++ b/library/marshal.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# haaritsubaki, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,15 +39,16 @@ msgid "" "This is not a general \"persistence\" module. For general persistence and " "transfer of Python objects through RPC calls, see the modules :mod:`pickle` " "and :mod:`shelve`. The :mod:`marshal` module exists mainly to support " -"reading and writing the \"pseudo-compiled\" code for Python modules of :file:" -"`.pyc` files. Therefore, the Python maintainers reserve the right to modify " -"the marshal format in backward incompatible ways should the need arise. The " -"format of code objects is not compatible between Python versions, even if " -"the version of the format is the same. De-serializing a code object in the " -"incorrect Python version has undefined behavior. If you're serializing and " -"de-serializing Python objects, use the :mod:`pickle` module instead -- the " -"performance is comparable, version independence is guaranteed, and pickle " -"supports a substantially wider range of objects than marshal." +"reading and writing the \"pseudo-compiled\" code for Python modules " +"of :file:`.pyc` files. Therefore, the Python maintainers reserve the right " +"to modify the marshal format in backward incompatible ways should the need " +"arise. The format of code objects is not compatible between Python versions, " +"even if the version of the format is the same. De-serializing a code object " +"in the incorrect Python version has undefined behavior. If you're " +"serializing and de-serializing Python objects, use the :mod:`pickle` module " +"instead -- the performance is comparable, version independence is " +"guaranteed, and pickle supports a substantially wider range of objects than " +"marshal." msgstr "" msgid "" @@ -65,10 +65,10 @@ msgid "" "bytearrays, tuples, lists, sets, frozensets, dictionaries, and code objects " "(if *allow_code* is true), where it should be understood that tuples, lists, " "sets, frozensets and dictionaries are only supported as long as the values " -"contained therein are themselves supported. The singletons :const:`None`, :" -"const:`Ellipsis` and :exc:`StopIteration` can also be marshalled and " -"unmarshalled. For format *version* lower than 3, recursive lists, sets and " -"dictionaries cannot be written (see below)." +"contained therein are themselves supported. The " +"singletons :const:`None`, :const:`Ellipsis` and :exc:`StopIteration` can " +"also be marshalled and unmarshalled. For format *version* lower than 3, " +"recursive lists, sets and dictionaries cannot be written (see below)." msgstr "" msgid "" @@ -85,10 +85,10 @@ msgid "" msgstr "" msgid "" -"If the value has (or contains an object that has) an unsupported type, a :" -"exc:`ValueError` exception is raised --- but garbage data will also be " -"written to the file. The object will not be properly read back by :func:" -"`load`. :ref:`Code objects ` are only supported if " +"If the value has (or contains an object that has) an unsupported type, " +"a :exc:`ValueError` exception is raised --- but garbage data will also be " +"written to the file. The object will not be properly read back " +"by :func:`load`. :ref:`Code objects ` are only supported if " "*allow_code* is true." msgstr "" @@ -108,9 +108,9 @@ msgstr "" msgid "" "Read one value from the open file and return it. If no valid value is read " "(e.g. because the data has a different Python version's incompatible marshal " -"format), raise :exc:`EOFError`, :exc:`ValueError` or :exc:`TypeError`. :ref:" -"`Code objects ` are only supported if *allow_code* is true. " -"The file must be a readable :term:`binary file`." +"format), raise :exc:`EOFError`, :exc:`ValueError` " +"or :exc:`TypeError`. :ref:`Code objects ` are only supported " +"if *allow_code* is true. The file must be a readable :term:`binary file`." msgstr "" msgid "" @@ -119,8 +119,9 @@ msgid "" msgstr "" msgid "" -"If an object containing an unsupported type was marshalled with :func:" -"`dump`, :func:`load` will substitute ``None`` for the unmarshallable type." +"If an object containing an unsupported type was marshalled " +"with :func:`dump`, :func:`load` will substitute ``None`` for the " +"unmarshallable type." msgstr "" msgid "" @@ -143,9 +144,9 @@ msgstr "" msgid "" "Convert the :term:`bytes-like object` to a value. If no valid value is " -"found, raise :exc:`EOFError`, :exc:`ValueError` or :exc:`TypeError`. :ref:" -"`Code objects ` are only supported if *allow_code* is true. " -"Extra bytes in the input are ignored." +"found, raise :exc:`EOFError`, :exc:`ValueError` " +"or :exc:`TypeError`. :ref:`Code objects ` are only supported " +"if *allow_code* is true. Extra bytes in the input are ignored." msgstr "" msgid "" diff --git a/library/math.po b/library/math.po index 7908b8cf93..84b305847b 100644 --- a/library/math.po +++ b/library/math.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,8 +27,8 @@ msgid ":mod:`!math` --- Mathematical functions" msgstr "" msgid "" -"This module provides access to the mathematical functions defined by the C " -"standard." +"This module provides access to common mathematical functions and constants, " +"including those defined by the C standard." msgstr "" msgid "" @@ -61,25 +59,25 @@ msgid "" msgstr "" msgid ":func:`factorial(n) `" -msgstr "" +msgstr ":func:`factorial(n) `" msgid "*n* factorial" msgstr "" msgid ":func:`gcd(*integers) `" -msgstr "" +msgstr ":func:`gcd(*integers) `" msgid "Greatest common divisor of the integer arguments" msgstr "" msgid ":func:`isqrt(n) `" -msgstr "" +msgstr ":func:`isqrt(n) `" msgid "Integer square root of a nonnegative integer *n*" msgstr "" msgid ":func:`lcm(*integers) `" -msgstr "" +msgstr ":func:`lcm(*integers) `" msgid "Least common multiple of the integer arguments" msgstr "" @@ -96,19 +94,19 @@ msgid "**Floating point arithmetic**" msgstr "" msgid ":func:`ceil(x) `" -msgstr "" +msgstr ":func:`ceil(x) `" msgid "Ceiling of *x*, the smallest integer greater than or equal to *x*" msgstr "" msgid ":func:`fabs(x) `" -msgstr "" +msgstr ":func:`fabs(x) `" msgid "Absolute value of *x*" msgstr "" msgid ":func:`floor(x) `" -msgstr "" +msgstr ":func:`floor(x) `" msgid "Floor of *x*, the largest integer less than or equal to *x*" msgstr "" @@ -126,7 +124,7 @@ msgid "Remainder of division ``x / y``" msgstr "" msgid ":func:`modf(x) `" -msgstr "" +msgstr ":func:`modf(x) `" msgid "Fractional and integer parts of *x*" msgstr "" @@ -138,7 +136,7 @@ msgid "Remainder of *x* with respect to *y*" msgstr "" msgid ":func:`trunc(x) `" -msgstr "" +msgstr ":func:`trunc(x) `" msgid "Integer part of *x*" msgstr "" @@ -153,7 +151,7 @@ msgid "Magnitude (absolute value) of *x* with the sign of *y*" msgstr "" msgid ":func:`frexp(x) `" -msgstr "" +msgstr ":func:`frexp(x) `" msgid "Mantissa and exponent of *x*" msgstr "" @@ -165,19 +163,19 @@ msgid "Check if the values *a* and *b* are close to each other" msgstr "" msgid ":func:`isfinite(x) `" -msgstr "" +msgstr ":func:`isfinite(x) `" msgid "Check if *x* is neither an infinity nor a NaN" msgstr "" msgid ":func:`isinf(x) `" -msgstr "" +msgstr ":func:`isinf(x) `" msgid "Check if *x* is a positive or negative infinity" msgstr "" msgid ":func:`isnan(x) `" -msgstr "" +msgstr ":func:`isnan(x) `" msgid "Check if *x* is a NaN (not a number)" msgstr "" @@ -195,7 +193,7 @@ msgid "Floating-point value *steps* steps after *x* towards *y*" msgstr "" msgid ":func:`ulp(x) `" -msgstr "" +msgstr ":func:`ulp(x) `" msgid "Value of the least significant bit of *x*" msgstr "" @@ -204,25 +202,25 @@ msgid "**Power, exponential and logarithmic functions**" msgstr "" msgid ":func:`cbrt(x) `" -msgstr "" +msgstr ":func:`cbrt(x) `" msgid "Cube root of *x*" msgstr "" msgid ":func:`exp(x) `" -msgstr "" +msgstr ":func:`exp(x) `" msgid "*e* raised to the power *x*" msgstr "" msgid ":func:`exp2(x) `" -msgstr "" +msgstr ":func:`exp2(x) `" msgid "*2* raised to the power *x*" msgstr "" msgid ":func:`expm1(x) `" -msgstr "" +msgstr ":func:`expm1(x) `" msgid "*e* raised to the power *x*, minus 1" msgstr "" @@ -234,19 +232,19 @@ msgid "Logarithm of *x* to the given base (*e* by default)" msgstr "" msgid ":func:`log1p(x) `" -msgstr "" +msgstr ":func:`log1p(x) `" msgid "Natural logarithm of *1+x* (base *e*)" msgstr "" msgid ":func:`log2(x) `" -msgstr "" +msgstr ":func:`log2(x) `" msgid "Base-2 logarithm of *x*" msgstr "" msgid ":func:`log10(x) `" -msgstr "" +msgstr ":func:`log10(x) `" msgid "Base-10 logarithm of *x*" msgstr "" @@ -258,7 +256,7 @@ msgid "*x* raised to the power *y*" msgstr "" msgid ":func:`sqrt(x) `" -msgstr "" +msgstr ":func:`sqrt(x) `" msgid "Square root of *x*" msgstr "" @@ -275,13 +273,13 @@ msgid "" msgstr "" msgid ":func:`fsum(iterable) `" -msgstr "" +msgstr ":func:`fsum(iterable) `" msgid "Sum of values in the input *iterable*" msgstr "" msgid ":func:`hypot(*coordinates) `" -msgstr "" +msgstr ":func:`hypot(*coordinates) `" msgid "Euclidean norm of an iterable of coordinates" msgstr "" @@ -302,13 +300,13 @@ msgid "**Angular conversion**" msgstr "" msgid ":func:`degrees(x) `" -msgstr "" +msgstr ":func:`degrees(x) `" msgid "Convert angle *x* from radians to degrees" msgstr "" msgid ":func:`radians(x) `" -msgstr "" +msgstr ":func:`radians(x) `" msgid "Convert angle *x* from degrees to radians" msgstr "" @@ -317,19 +315,19 @@ msgid "**Trigonometric functions**" msgstr "" msgid ":func:`acos(x) `" -msgstr "" +msgstr ":func:`acos(x) `" msgid "Arc cosine of *x*" msgstr "" msgid ":func:`asin(x) `" -msgstr "" +msgstr ":func:`asin(x) `" msgid "Arc sine of *x*" msgstr "" msgid ":func:`atan(x) `" -msgstr "" +msgstr ":func:`atan(x) `" msgid "Arc tangent of *x*" msgstr "" @@ -341,19 +339,19 @@ msgid "``atan(y / x)``" msgstr "``atan(y / x)``" msgid ":func:`cos(x) `" -msgstr "" +msgstr ":func:`cos(x) `" msgid "Cosine of *x*" msgstr "" msgid ":func:`sin(x) `" -msgstr "" +msgstr ":func:`sin(x) `" msgid "Sine of *x*" msgstr "" msgid ":func:`tan(x) `" -msgstr "" +msgstr ":func:`tan(x) `" msgid "Tangent of *x*" msgstr "" @@ -362,37 +360,37 @@ msgid "**Hyperbolic functions**" msgstr "" msgid ":func:`acosh(x) `" -msgstr "" +msgstr ":func:`acosh(x) `" msgid "Inverse hyperbolic cosine of *x*" msgstr "" msgid ":func:`asinh(x) `" -msgstr "" +msgstr ":func:`asinh(x) `" msgid "Inverse hyperbolic sine of *x*" msgstr "" msgid ":func:`atanh(x) `" -msgstr "" +msgstr ":func:`atanh(x) `" msgid "Inverse hyperbolic tangent of *x*" msgstr "" msgid ":func:`cosh(x) `" -msgstr "" +msgstr ":func:`cosh(x) `" msgid "Hyperbolic cosine of *x*" msgstr "" msgid ":func:`sinh(x) `" -msgstr "" +msgstr ":func:`sinh(x) `" msgid "Hyperbolic sine of *x*" msgstr "" msgid ":func:`tanh(x) `" -msgstr "" +msgstr ":func:`tanh(x) `" msgid "Hyperbolic tangent of *x*" msgstr "" @@ -401,13 +399,13 @@ msgid "**Special functions**" msgstr "" msgid ":func:`erf(x) `" -msgstr "" +msgstr ":func:`erf(x) `" msgid "`Error function `_ at *x*" msgstr "" msgid ":func:`erfc(x) `" -msgstr "" +msgstr ":func:`erfc(x) `" msgid "" "`Complementary error function `" -msgstr "" +msgstr ":func:`gamma(x) `" msgid "`Gamma function `_ at *x*" msgstr "" msgid ":func:`lgamma(x) `" -msgstr "" +msgstr ":func:`lgamma(x) `" msgid "" -"Natural logarithm of the absolute value of the `Gamma function `_ at *x*" +"Natural logarithm of the absolute value of the `Gamma function `_ at *x*" msgstr "" msgid "**Constants**" @@ -480,13 +478,11 @@ msgid "" msgstr "" msgid "" -"Raises :exc:`TypeError` if either of the arguments are not integers. Raises :" -"exc:`ValueError` if either of the arguments are negative." +"Raises :exc:`TypeError` if either of the arguments are not integers. " +"Raises :exc:`ValueError` if either of the arguments are negative." msgstr "" -msgid "" -"Return *n* factorial as an integer. Raises :exc:`ValueError` if *n* is not " -"integral or is negative." +msgid "Return factorial of the nonnegative integer *n*." msgstr "" msgid "Floats with integral values (like ``5.0``) are no longer accepted." @@ -546,8 +542,8 @@ msgstr "" msgid "" "Return the ceiling of *x*, the smallest integer greater than or equal to " -"*x*. If *x* is not a float, delegates to :meth:`x.__ceil__ `, which should return an :class:`~numbers.Integral` value." +"*x*. If *x* is not a float, delegates to :meth:`x.__ceil__ " +"`, which should return an :class:`~numbers.Integral` value." msgstr "" msgid "Return the absolute value of *x*." @@ -626,8 +622,8 @@ msgid "" "Return *x* with the fractional part removed, leaving the integer part. This " "rounds toward 0: ``trunc()`` is equivalent to :func:`floor` for positive " "*x*, and equivalent to :func:`ceil` for negative *x*. If *x* is not a float, " -"delegates to :meth:`x.__trunc__ `, which should return an :" -"class:`~numbers.Integral` value." +"delegates to :meth:`x.__trunc__ `, which should return " +"an :class:`~numbers.Integral` value." msgstr "" msgid "" @@ -648,10 +644,11 @@ msgid "" msgstr "" msgid "" -"Return the mantissa and exponent of *x* as the pair ``(m, e)``. *m* is a " -"float and *e* is an integer such that ``x == m * 2**e`` exactly. If *x* is " -"zero, returns ``(0.0, 0)``, otherwise ``0.5 <= abs(m) < 1``. This is used " -"to \"pick apart\" the internal representation of a float in a portable way." +"Return the mantissa and exponent of *x* as the pair ``(m, e)``. If *x* is a " +"finite nonzero number, then *m* is a float with ``0.5 <= abs(m) < 1.0`` and " +"an integer *e* is such that ``x == m * 2**e`` exactly. Else, return ``(x, " +"0)``. This is used to \"pick apart\" the internal representation of a float " +"in a portable way." msgstr "" msgid "" @@ -716,8 +713,8 @@ msgid "" msgstr "" msgid "" -"Return ``x * (2**i)``. This is essentially the inverse of function :func:" -"`frexp`." +"Return ``x * (2**i)``. This is essentially the inverse of " +"function :func:`frexp`." msgstr "" msgid "Return the floating-point value *steps* steps after *x* towards *y*." @@ -761,8 +758,8 @@ msgstr "" msgid "" "If *x* is equal to zero, return the smallest positive *denormalized* " -"representable float (smaller than the minimum positive *normalized* float, :" -"data:`sys.float_info.min `)." +"representable float (smaller than the minimum positive *normalized* " +"float, :data:`sys.float_info.min `)." msgstr "" msgid "" @@ -781,8 +778,8 @@ msgid "ULP stands for \"Unit in the Last Place\"." msgstr "" msgid "" -"See also :func:`math.nextafter` and :data:`sys.float_info.epsilon `." +"See also :func:`math.nextafter` and :data:`sys.float_info.epsilon " +"`." msgstr "" msgid "Power, exponential and logarithmic functions" @@ -889,9 +886,9 @@ msgstr "" msgid "" "For further discussion and two alternative approaches, see the `ASPN " -"cookbook recipes for accurate floating-point summation `_\\." +"cookbook recipes for accurate floating-point summation `_\\." msgstr "" msgid "" @@ -974,8 +971,8 @@ msgid "" "``pi``. The vector in the plane from the origin to point ``(x, y)`` makes " "this angle with the positive X axis. The point of :func:`atan2` is that the " "signs of both inputs are known to it, so it can compute the correct quadrant " -"for the angle. For example, ``atan(1)`` and ``atan2(1, 1)`` are both " -"``pi/4``, but ``atan2(-1, -1)`` is ``-3*pi/4``." +"for the angle. For example, ``atan(1)`` and ``atan2(1, 1)`` are both ``pi/" +"4``, but ``atan2(-1, -1)`` is ``-3*pi/4``." msgstr "" msgid "Return the cosine of *x* radians." @@ -1024,8 +1021,8 @@ msgstr "" msgid "" "The :func:`erf` function can be used to compute traditional statistical " -"functions such as the `cumulative standard normal distribution `_::" +"functions such as the `cumulative standard normal distribution `_::" msgstr "" msgid "" @@ -1065,13 +1062,13 @@ msgid "" "The mathematical constant *τ* = 6.283185..., to available precision. Tau is " "a circle constant equal to 2\\ *π*, the ratio of a circle's circumference to " "its radius. To learn more about Tau, check out Vi Hart's video `Pi is " -"(still) Wrong `_, and start " -"celebrating `Tau day `_ by eating twice as much pie!" +"(still) Wrong `_, and start celebrating `Tau " +"day `_ by eating twice as much pie!" msgstr "" msgid "" -"A floating-point positive infinity. (For negative infinity, use ``-math." -"inf``.) Equivalent to the output of ``float('inf')``." +"A floating-point positive infinity. (For negative infinity, use ``-" +"math.inf``.) Equivalent to the output of ``float('inf')``." msgstr "" msgid "" @@ -1089,15 +1086,15 @@ msgstr "" msgid "" "The :mod:`math` module consists mostly of thin wrappers around the platform " "C math library functions. Behavior in exceptional cases follows Annex F of " -"the C99 standard where appropriate. The current implementation will raise :" -"exc:`ValueError` for invalid operations like ``sqrt(-1.0)`` or ``log(0.0)`` " -"(where C99 Annex F recommends signaling invalid operation or divide-by-" -"zero), and :exc:`OverflowError` for results that overflow (for example, " -"``exp(1000.0)``). A NaN will not be returned from any of the functions " -"above unless one or more of the input arguments was a NaN; in that case, " -"most functions will return a NaN, but (again following C99 Annex F) there " -"are some exceptions to this rule, for example ``pow(float('nan'), 0.0)`` or " -"``hypot(float('nan'), float('inf'))``." +"the C99 standard where appropriate. The current implementation will " +"raise :exc:`ValueError` for invalid operations like ``sqrt(-1.0)`` or " +"``log(0.0)`` (where C99 Annex F recommends signaling invalid operation or " +"divide-by-zero), and :exc:`OverflowError` for results that overflow (for " +"example, ``exp(1000.0)``). A NaN will not be returned from any of the " +"functions above unless one or more of the input arguments was a NaN; in that " +"case, most functions will return a NaN, but (again following C99 Annex F) " +"there are some exceptions to this rule, for example ``pow(float('nan'), " +"0.0)`` or ``hypot(float('nan'), float('inf'))``." msgstr "" msgid "" diff --git a/library/mimetypes.po b/library/mimetypes.po index 7f9f7b3cd4..743d45c5d6 100644 --- a/library/mimetypes.po +++ b/library/mimetypes.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!mimetypes` --- Map filenames to MIME types" msgstr "" msgid "**Source code:** :source:`Lib/mimetypes.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/mimetypes.py`" msgid "" "The :mod:`mimetypes` module converts between a filename or URL and the MIME " @@ -63,8 +62,8 @@ msgstr "" msgid "" "*encoding* is ``None`` for no encoding or the name of the program used to " "encode (e.g. :program:`compress` or :program:`gzip`). The encoding is " -"suitable for use as a :mailheader:`Content-Encoding` header, **not** as a :" -"mailheader:`Content-Transfer-Encoding` header. The mappings are table " +"suitable for use as a :mailheader:`Content-Encoding` header, **not** as " +"a :mailheader:`Content-Transfer-Encoding` header. The mappings are table " "driven. Encoding suffixes are case sensitive; type suffixes are first tried " "case sensitively, then case insensitively." msgstr "" @@ -82,14 +81,14 @@ msgid "Added support for *url* being a :term:`path-like object`." msgstr "" msgid "" -"Passing a file path instead of URL is :term:`soft deprecated`. Use :func:" -"`guess_file_type` for this." +"Passing a file path instead of URL is :term:`soft deprecated`. " +"Use :func:`guess_file_type` for this." msgstr "" msgid "" -"Guess the type of a file based on its path, given by *path*. Similar to the :" -"func:`guess_type` function, but accepts a path instead of URL. Path can be a " -"string, a bytes object or a :term:`path-like object`." +"Guess the type of a file based on its path, given by *path*. Similar to " +"the :func:`guess_type` function, but accepts a path instead of URL. Path can " +"be a string, a bytes object or a :term:`path-like object`." msgstr "" msgid "" @@ -101,16 +100,16 @@ msgid "" msgstr "" msgid "" -"The optional *strict* argument has the same meaning as with the :func:" -"`guess_type` function." +"The optional *strict* argument has the same meaning as with " +"the :func:`guess_type` function." msgstr "" msgid "" "Guess the extension for a file based on its MIME type, given by *type*. The " "return value is a string giving a filename extension, including the leading " "dot (``'.'``). The extension is not guaranteed to have been associated with " -"any particular data stream, but would be mapped to the MIME type *type* by :" -"func:`guess_type` and :func:`guess_file_type`. If no extension can be " +"any particular data stream, but would be mapped to the MIME type *type* " +"by :func:`guess_type` and :func:`guess_file_type`. If no extension can be " "guessed for *type*, ``None`` is returned." msgstr "" @@ -144,10 +143,11 @@ msgid "Previously, Windows registry settings were ignored." msgstr "" msgid "" -"Load the type map given in the file *filename*, if it exists. The type map " -"is returned as a dictionary mapping filename extensions, including the " -"leading dot (``'.'``), to strings of the form ``'type/subtype'``. If the " -"file *filename* does not exist or cannot be read, ``None`` is returned." +"Load the type map given in the file named by *file*, if it exists. *file* " +"must be a string specifying the name of the file to read. The type map is " +"returned as a dictionary mapping file extensions, including the leading dot " +"(``'.'``), to strings of the form ``'type/subtype'``. If the file does not " +"exist or cannot be read, ``None`` is returned." msgstr "" msgid "" @@ -176,8 +176,9 @@ msgstr "" msgid "" "Dictionary mapping suffixes to suffixes. This is used to allow recognition " "of encoded files for which the encoding and the type are indicated by the " -"same extension. For example, the :file:`.tgz` extension is mapped to :file:" -"`.tar.gz` to allow the encoding and type to be recognized separately." +"same extension. For example, the :file:`.tgz` extension is mapped " +"to :file:`.tar.gz` to allow the encoding and type to be recognized " +"separately." msgstr "" msgid "Dictionary mapping filename extensions to encoding types." @@ -218,11 +219,12 @@ msgstr "" msgid "" "This class represents a MIME-types database. By default, it provides access " -"to the same database as the rest of this module. The initial database is a " -"copy of that provided by the module, and may be extended by loading " -"additional :file:`mime.types`\\ -style files into the database using the :" -"meth:`read` or :meth:`readfp` methods. The mapping dictionaries may also be " -"cleared before loading additional data if the default data is not desired." +"to the same database as the rest of this module. The initial database is " +"created from Python's built-in MIME type tables. It may be extended by " +"loading additional :file:`mime.types`\\ -style files into the database using " +"the :meth:`read` or :meth:`readfp` methods. The mapping dictionaries may " +"also be cleared before loading additional data if the default data is not " +"desired." msgstr "" msgid "" @@ -233,28 +235,30 @@ msgstr "" msgid "" "Dictionary mapping suffixes to suffixes. This is used to allow recognition " "of encoded files for which the encoding and the type are indicated by the " -"same extension. For example, the :file:`.tgz` extension is mapped to :file:" -"`.tar.gz` to allow the encoding and type to be recognized separately. This " -"is initially a copy of the global :data:`suffix_map` defined in the module." +"same extension. For example, the :file:`.tgz` extension is mapped " +"to :file:`.tar.gz` to allow the encoding and type to be recognized " +"separately. This is initialized with some predefined values." msgstr "" msgid "" -"Dictionary mapping filename extensions to encoding types. This is initially " -"a copy of the global :data:`encodings_map` defined in the module." +"Dictionary mapping filename extensions to encoding types. This is " +"initialized with some predefined values." msgstr "" msgid "" "Tuple containing two dictionaries, mapping filename extensions to MIME " "types: the first dictionary is for the non-standards types and the second " -"one is for the standard types. They are initialized by :data:`common_types` " -"and :data:`types_map`." +"one is for the standard types. They are initialized with some predefined " +"values and MIME type information loaded from files specified by the " +"*filenames* argument." msgstr "" msgid "" "Tuple containing two dictionaries, mapping MIME types to a list of filename " "extensions: the first dictionary is for the non-standards types and the " -"second one is for the standard types. They are initialized by :data:" -"`common_types` and :data:`types_map`." +"second one is for the standard types. They are initialized with some " +"predefined values and MIME type information loaded from files specified by " +"the *filenames* argument." msgstr "" msgid "" @@ -278,8 +282,8 @@ msgid "" msgstr "" msgid "" -"Load MIME information from a file named *filename*. This uses :meth:" -"`readfp` to parse the file." +"Load MIME information from a file named *filename*. This " +"uses :meth:`readfp` to parse the file." msgstr "" msgid "" diff --git a/library/mmap.po b/library/mmap.po index c349b092b3..1c994c4031 100644 --- a/library/mmap.po +++ b/library/mmap.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,14 +35,14 @@ msgid "" msgstr "" msgid "" -"Memory-mapped file objects behave like both :class:`bytearray` and like :" -"term:`file objects `. You can use mmap objects in most places " -"where :class:`bytearray` are expected; for example, you can use the :mod:" -"`re` module to search through a memory-mapped file. You can also change a " -"single byte by doing ``obj[index] = 97``, or change a subsequence by " -"assigning to a slice: ``obj[i1:i2] = b'...'``. You can also read and write " -"data starting at the current file position, and :meth:`seek` through the " -"file to different positions." +"Memory-mapped file objects behave like both :class:`bytearray` and " +"like :term:`file objects `. You can use mmap objects in most " +"places where :class:`bytearray` are expected; for example, you can use " +"the :mod:`re` module to search through a memory-mapped file. You can also " +"change a single byte by doing ``obj[index] = 97``, or change a subsequence " +"by assigning to a slice: ``obj[i1:i2] = b'...'``. You can also read and " +"write data starting at the current file position, and :meth:`seek` through " +"the file to different positions." msgstr "" msgid "" @@ -71,10 +71,10 @@ msgid "" "Unix and Windows. If *access* is not specified, Windows mmap returns a " "write-through mapping. The initial memory values for all three access types " "are taken from the specified file. Assignment to an :const:`ACCESS_READ` " -"memory map raises a :exc:`TypeError` exception. Assignment to an :const:" -"`ACCESS_WRITE` memory map affects both memory and the underlying file. " -"Assignment to an :const:`ACCESS_COPY` memory map affects memory but does not " -"update the underlying file." +"memory map raises a :exc:`TypeError` exception. Assignment to " +"an :const:`ACCESS_WRITE` memory map affects both memory and the underlying " +"file. Assignment to an :const:`ACCESS_COPY` memory map affects memory but " +"does not update the underlying file." msgstr "" msgid "Added :const:`ACCESS_DEFAULT` constant." @@ -107,8 +107,8 @@ msgstr "" msgid "" "*offset* may be specified as a non-negative integer offset. mmap references " "will be relative to the offset from the beginning of the file. *offset* " -"defaults to 0. *offset* must be a multiple of the :const:" -"`ALLOCATIONGRANULARITY`." +"defaults to 0. *offset* must be a multiple of " +"the :const:`ALLOCATIONGRANULARITY`." msgstr "" msgid "" @@ -119,8 +119,8 @@ msgstr "" msgid "" "**(Unix version)** Maps *length* bytes from the file specified by the file " "descriptor *fileno*, and returns a mmap object. If *length* is ``0``, the " -"maximum length of the map will be the current size of the file when :class:" -"`~mmap.mmap` is called." +"maximum length of the map will be the current size of the file " +"when :class:`~mmap.mmap` is called." msgstr "" msgid "" @@ -157,9 +157,9 @@ msgstr "" msgid "" "If *trackfd* is ``False``, the file descriptor specified by *fileno* will " "not be duplicated, and the resulting :class:`!mmap` object will not be " -"associated with the map's underlying file. This means that the :meth:`~mmap." -"mmap.size` and :meth:`~mmap.mmap.resize` methods will fail. This mode is " -"useful to limit the number of open file descriptors." +"associated with the map's underlying file. This means that " +"the :meth:`~mmap.mmap.size` and :meth:`~mmap.mmap.resize` methods will fail. " +"This mode is useful to limit the number of open file descriptors." msgstr "" msgid "" @@ -199,8 +199,8 @@ msgid "" msgstr "" msgid "" -":class:`~mmap.mmap` can also be used as a context manager in a :keyword:" -"`with` statement::" +":class:`~mmap.mmap` can also be used as a context manager in " +"a :keyword:`with` statement::" msgstr "" msgid "" @@ -260,8 +260,8 @@ msgid "" "use of this call there is no guarantee that changes are written back before " "the object is destroyed. If *offset* and *size* are specified, only changes " "to the given range of bytes will be flushed to disk; otherwise, the whole " -"extent of the mapping is flushed. *offset* must be a multiple of the :const:" -"`PAGESIZE` or :const:`ALLOCATIONGRANULARITY`." +"extent of the mapping is flushed. *offset* must be a multiple of " +"the :const:`PAGESIZE` or :const:`ALLOCATIONGRANULARITY`." msgstr "" msgid "" @@ -277,10 +277,11 @@ msgstr "" msgid "" "Send advice *option* to the kernel about the memory region beginning at " -"*start* and extending *length* bytes. *option* must be one of the :ref:" -"`MADV_* constants ` available on the system. If *start* " -"and *length* are omitted, the entire mapping is spanned. On some systems " -"(including Linux), *start* must be a multiple of the :const:`PAGESIZE`." +"*start* and extending *length* bytes. *option* must be one of " +"the :ref:`MADV_* constants ` available on the system. If " +"*start* and *length* are omitted, the entire mapping is spanned. On some " +"systems (including Linux), *start* must be a multiple of " +"the :const:`PAGESIZE`." msgstr "" msgid "Availability: Systems with the ``madvise()`` system call." @@ -317,9 +318,9 @@ msgid "Resizes the map and the underlying file, if any." msgstr "" msgid "" -"Resizing a map created with *access* of :const:`ACCESS_READ` or :const:" -"`ACCESS_COPY`, will raise a :exc:`TypeError` exception. Resizing a map " -"created with with *trackfd* set to ``False``, will raise a :exc:`ValueError` " +"Resizing a map created with *access* of :const:`ACCESS_READ` " +"or :const:`ACCESS_COPY`, will raise a :exc:`TypeError` exception. Resizing a " +"map created with *trackfd* set to ``False``, will raise a :exc:`ValueError` " "exception." msgstr "" @@ -345,8 +346,8 @@ msgstr "" msgid "" "Set the file's current position. *whence* argument is optional and defaults " "to ``os.SEEK_SET`` or ``0`` (absolute file positioning); other values are " -"``os.SEEK_CUR`` or ``1`` (seek relative to the current position) and ``os." -"SEEK_END`` or ``2`` (seek relative to the file's end)." +"``os.SEEK_CUR`` or ``1`` (seek relative to the current position) and " +"``os.SEEK_END`` or ``2`` (seek relative to the file's end)." msgstr "" msgid "Return the new absolute position instead of ``None``." @@ -399,10 +400,10 @@ msgid "MAP_* Constants" msgstr "" msgid "" -"These are the various flags that can be passed to :meth:`mmap.mmap`. :data:" -"`MAP_ALIGNED_SUPER` is only available at FreeBSD and :data:`MAP_CONCEAL` is " -"only available at OpenBSD. Note that some options might not be present on " -"some systems." +"These are the various flags that can be passed " +"to :meth:`mmap.mmap`. :data:`MAP_ALIGNED_SUPER` is only available at " +"FreeBSD and :data:`MAP_CONCEAL` is only available at OpenBSD. Note that " +"some options might not be present on some systems." msgstr "" msgid "Added :data:`MAP_POPULATE` constant." @@ -415,8 +416,6 @@ msgid "Added :data:`MAP_ALIGNED_SUPER` and :data:`MAP_CONCEAL` constants." msgstr "" msgid "" -"Added :data:`MAP_32BIT`, :data:`MAP_HASSEMAPHORE`, :data:`MAP_JIT`, :data:" -"`MAP_NOCACHE`, :data:`MAP_NOEXTEND`, :data:`MAP_NORESERVE`, :data:" -"`MAP_RESILIENT_CODESIGN`, :data:`MAP_RESILIENT_MEDIA`, :data:`MAP_TPRO`, :" -"data:`MAP_TRANSLATED_ALLOW_EXECUTE`, and :data:`MAP_UNIX03` constants." +"Added :data:`MAP_32BIT`, :data:`MAP_HASSEMAPHORE`, :data:`MAP_JIT`, :data:`MAP_NOCACHE`, :data:`MAP_NOEXTEND`, :data:`MAP_NORESERVE`, :data:`MAP_RESILIENT_CODESIGN`, :data:`MAP_RESILIENT_MEDIA`, :data:`MAP_TPRO`, :data:`MAP_TRANSLATED_ALLOW_EXECUTE`, " +"and :data:`MAP_UNIX03` constants." msgstr "" diff --git a/library/modules.po b/library/modules.po index 4ab3d987c7..97c728b6eb 100644 --- a/library/modules.po +++ b/library/modules.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: -# Transifex Bot <>, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2025-07-11 15:02+0000\n" +"PO-Revision-Date: 2025-05-08 05: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" @@ -24,7 +24,7 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Importing Modules" -msgstr "" +msgstr "Mengimpor Modul" msgid "" "The modules described in this chapter provide new ways to import other " diff --git a/library/msvcrt.po b/library/msvcrt.po index 68c1055ac6..3ed9f72c1f 100644 --- a/library/msvcrt.po +++ b/library/msvcrt.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:09+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -23,13 +23,13 @@ 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 ":mod:`msvcrt` --- Useful routines from the MS VC++ runtime" +msgid ":mod:`!msvcrt` --- Useful routines from the MS VC++ runtime" msgstr "" msgid "" "These functions provide access to some useful capabilities on Windows " -"platforms. Some higher-level modules use these functions to build the " -"Windows implementations of their services. For example, the :mod:`getpass` " +"platforms. Some higher-level modules use these functions to build the " +"Windows implementations of their services. For example, the :mod:`getpass` " "module uses this in the implementation of the :func:`getpass` function." msgstr "" @@ -45,6 +45,9 @@ msgid "" "where ever possible." msgstr "" +msgid "Availability" +msgstr "Dostępność" + msgid "" "Operations in this module now raise :exc:`OSError` where :exc:`IOError` was " "raised." @@ -54,12 +57,12 @@ msgid "File Operations" msgstr "" msgid "" -"Lock part of a file based on file descriptor *fd* from the C runtime. " -"Raises :exc:`OSError` on failure. The locked region of the file extends " -"from the current file position for *nbytes* bytes, and may continue beyond " -"the end of the file. *mode* must be one of the :const:`LK_\\*` constants " -"listed below. Multiple regions in a file may be locked at the same time, but " -"may not overlap. Adjacent regions are not merged; they must be unlocked " +"Lock part of a file based on file descriptor *fd* from the C runtime. " +"Raises :exc:`OSError` on failure. The locked region of the file extends from " +"the current file position for *nbytes* bytes, and may continue beyond the " +"end of the file. *mode* must be one of the :const:`!LK_\\*` constants listed " +"below. Multiple regions in a file may be locked at the same time, but may " +"not overlap. Adjacent regions are not merged; they must be unlocked " "individually." msgstr "" @@ -70,7 +73,7 @@ msgstr "" msgid "" "Locks the specified bytes. If the bytes cannot be locked, the program " -"immediately tries again after 1 second. If, after 10 attempts, the bytes " +"immediately tries again after 1 second. If, after 10 attempts, the bytes " "cannot be locked, :exc:`OSError` is raised." msgstr "" @@ -84,15 +87,21 @@ msgstr "" msgid "" "Set the line-end translation mode for the file descriptor *fd*. To set it to " -"text mode, *flags* should be :const:`os.O_TEXT`; for binary, it should be :" -"const:`os.O_BINARY`." +"text mode, *flags* should be :const:`os.O_TEXT`; for binary, it should " +"be :const:`os.O_BINARY`." +msgstr "" + +msgid "" +"Create a C runtime file descriptor from the file handle *handle*. The " +"*flags* parameter should be a bitwise OR " +"of :const:`os.O_APPEND`, :const:`os.O_RDONLY`, :const:`os.O_TEXT` " +"and :const:`os.O_NOINHERIT`. The returned file descriptor may be used as a " +"parameter to :func:`os.fdopen` to create a file object." msgstr "" msgid "" -"Create a C runtime file descriptor from the file handle *handle*. The " -"*flags* parameter should be a bitwise OR of :const:`os.O_APPEND`, :const:`os." -"O_RDONLY`, and :const:`os.O_TEXT`. The returned file descriptor may be used " -"as a parameter to :func:`os.fdopen` to create a file object." +"The file descriptor is inheritable by default. Pass :const:`os.O_NOINHERIT` " +"flag to make it non inheritable." msgstr "" msgid "" @@ -101,7 +110,7 @@ msgid "" msgstr "" msgid "" -"Return the file handle for the file descriptor *fd*. Raises :exc:`OSError` " +"Return the file handle for the file descriptor *fd*. Raises :exc:`OSError` " "if *fd* is not recognized." msgstr "" @@ -113,12 +122,14 @@ msgstr "" msgid "Console I/O" msgstr "" -msgid "Return ``True`` if a keypress is waiting to be read." +msgid "" +"Returns a nonzero value if a keypress is waiting to be read. Otherwise, " +"return 0." msgstr "" msgid "" "Read a keypress and return the resulting character as a byte string. Nothing " -"is echoed to the console. This call will block if a keypress is not already " +"is echoed to the console. This call will block if a keypress is not already " "available, but will not wait for :kbd:`Enter` to be pressed. If the pressed " "key was a special function key, this will return ``'\\000'`` or ``'\\xe0'``; " "the next call will return the keycode. The :kbd:`Control-C` keypress cannot " @@ -129,8 +140,8 @@ msgid "Wide char variant of :func:`getch`, returning a Unicode value." msgstr "" msgid "" -"Similar to :func:`getch`, but the keypress will be echoed if it represents " -"a printable character." +"Similar to :func:`getch`, but the keypress will be echoed if it represents a " +"printable character." msgstr "" msgid "Wide char variant of :func:`getche`, returning a Unicode value." @@ -155,5 +166,88 @@ msgstr "" msgid "" "Force the :c:func:`malloc` heap to clean itself up and return unused blocks " -"to the operating system. On failure, this raises :exc:`OSError`." +"to the operating system. On failure, this raises :exc:`OSError`." +msgstr "" + +msgid "" +"Changes the location where the C runtime writes an error message for an " +"error that might end the program. *mode* must be one of the :const:`!" +"OUT_\\*` constants listed below or :const:`REPORT_ERRMODE`. Returns the old " +"setting or -1 if an error occurs. Only available in :ref:`debug build of " +"Python `." +msgstr "" + +msgid "" +"Error sink is determined by the app's type. Only available in :ref:`debug " +"build of Python `." +msgstr "" + +msgid "" +"Error sink is a standard error. Only available in :ref:`debug build of " +"Python `." +msgstr "" + +msgid "" +"Error sink is a message box. Only available in :ref:`debug build of Python " +"`." +msgstr "" + +msgid "" +"Report the current error mode value. Only available in :ref:`debug build of " +"Python `." +msgstr "" + +msgid "" +"Specifies the destination or destinations for a specific report type " +"generated by :c:func:`!_CrtDbgReport` in the MS VC++ runtime. *type* must be " +"one of the :const:`!CRT_\\*` constants listed below. *mode* must be one of " +"the :const:`!CRTDBG_\\*` constants listed below. Only available " +"in :ref:`debug build of Python `." +msgstr "" + +msgid "" +"After you use :func:`CrtSetReportMode` to specify :const:`CRTDBG_MODE_FILE`, " +"you can specify the file handle to receive the message text. *type* must be " +"one of the :const:`!CRT_\\*` constants listed below. *file* should be the " +"file handle your want specified. Only available in :ref:`debug build of " +"Python `." +msgstr "" + +msgid "" +"Warnings, messages, and information that doesn't need immediate attention." +msgstr "" + +msgid "" +"Errors, unrecoverable problems, and issues that require immediate attention." +msgstr "" + +msgid "Assertion failures." +msgstr "" + +msgid "Writes the message to the debugger's output window." +msgstr "" + +msgid "" +"Writes the message to a user-supplied file handle. :func:`CrtSetReportFile` " +"should be called to define the specific file or stream to use as the " +"destination." +msgstr "" + +msgid "" +"Creates a message box to display the message along with the ``Abort``, " +"``Retry``, and ``Ignore`` buttons." +msgstr "" + +msgid "Returns current *mode* for the specified *type*." +msgstr "" + +msgid "The CRT Assembly version, from the :file:`crtassem.h` header file." +msgstr "" + +msgid "" +"The VC Assembly public key token, from the :file:`crtassem.h` header file." +msgstr "" + +msgid "" +"The Libraries Assembly name prefix, from the :file:`crtassem.h` header file." msgstr "" diff --git a/library/multiprocessing.po b/library/multiprocessing.po index de9f1d7267..f4dd6fc220 100644 --- a/library/multiprocessing.po +++ b/library/multiprocessing.po @@ -1,23 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Seweryn Piórkowski , 2024 -# Stefan Ocetkiewicz , 2024 -# Maciej Olko , 2024 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,7 +28,7 @@ msgid ":mod:`!multiprocessing` --- Process-based parallelism" msgstr "" msgid "**Source code:** :source:`Lib/multiprocessing/`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/multiprocessing/`" msgid "Availability" msgstr "Dostępność" @@ -55,15 +52,14 @@ msgid "" 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 " +"The :mod:`multiprocessing` module also introduces " +"the :class:`~multiprocessing.pool.Pool` object which offers a convenient " +"means of parallelizing the execution of a function across multiple input " +"values, distributing the input data across processes (data parallelism). " +"The following example demonstrates the common practice of defining such " "functions in a module so that child processes can successfully import that " -"module. This basic example of data parallelism using :class:" -"`~multiprocessing.pool.Pool`, ::" +"module. This basic example of data parallelism " +"using :class:`~multiprocessing.pool.Pool`, ::" msgstr "" msgid "" @@ -83,23 +79,30 @@ msgstr "" msgid "[1, 4, 9]" msgstr "" +msgid "" +"The :mod:`multiprocessing` module also introduces APIs which do not have " +"analogs in the :mod:`threading` module, like the ability to :meth:`terminate " +"`, :meth:`interrupt ` or :meth:`kill " +"` a running process." +msgstr "" + msgid "" ":class:`concurrent.futures.ProcessPoolExecutor` offers a higher level " "interface to push tasks to a background process without blocking execution " -"of the calling process. Compared to using the :class:`~multiprocessing.pool." -"Pool` interface directly, the :mod:`concurrent.futures` API more readily " -"allows the submission of work to the underlying process pool to be separated " -"from waiting for the results." +"of the calling process. Compared to using " +"the :class:`~multiprocessing.pool.Pool` interface directly, " +"the :mod:`concurrent.futures` API more readily allows the submission of work " +"to the underlying process pool to be separated from waiting for the results." msgstr "" msgid "The :class:`Process` class" msgstr "" msgid "" -"In :mod:`multiprocessing`, processes are spawned by creating a :class:" -"`Process` object and then calling its :meth:`~Process.start` method. :class:" -"`Process` follows the API of :class:`threading.Thread`. A trivial example " -"of a multiprocess program is ::" +"In :mod:`multiprocessing`, processes are spawned by creating " +"a :class:`Process` object and then calling its :meth:`~Process.start` " +"method. :class:`Process` follows the API of :class:`threading.Thread`. A " +"trivial example of a multiprocess program is ::" msgstr "" msgid "" @@ -144,6 +147,13 @@ msgid "" "necessary, see :ref:`multiprocessing-programming`." msgstr "" +msgid "" +"The arguments to :class:`Process` usually need to be picklable so they can " +"be passed to the child process. If you tried typing the above example " +"directly into a REPL it could lead to an :exc:`AttributeError` in the child " +"process trying to locate the *f* function in the ``__main__`` module." +msgstr "" + msgid "Contexts and start methods" msgstr "" @@ -189,10 +199,10 @@ msgid "" msgstr "" msgid "" -"If Python is able to detect that your process has multiple threads, the :" -"func:`os.fork` function that this start method calls internally will raise " -"a :exc:`DeprecationWarning`. Use a different start method. See the :func:`os." -"fork` documentation for further explanation." +"If Python is able to detect that your process has multiple threads, " +"the :func:`os.fork` function that this start method calls internally will " +"raise a :exc:`DeprecationWarning`. Use a different start method. See " +"the :func:`os.fork` documentation for further explanation." msgstr "" msgid "*forkserver*" @@ -227,15 +237,15 @@ msgstr "" msgid "" "On POSIX using the *spawn* or *forkserver* start methods will also start a " "*resource tracker* process which tracks the unlinked named system resources " -"(such as named semaphores or :class:`~multiprocessing.shared_memory." -"SharedMemory` objects) created by processes of the program. When all " -"processes have exited the resource tracker unlinks any remaining tracked " -"object. Usually there should be none, but if a process was killed by a " -"signal there may be some \"leaked\" resources. (Neither leaked semaphores " -"nor shared memory segments will be automatically unlinked until the next " -"reboot. This is problematic for both objects because the system allows only " -"a limited number of named semaphores, and shared memory segments occupy some " -"space in the main memory.)" +"(such as named semaphores " +"or :class:`~multiprocessing.shared_memory.SharedMemory` objects) created by " +"processes of the program. When all processes have exited the resource " +"tracker unlinks any remaining tracked object. Usually there should be none, " +"but if a process was killed by a signal there may be some \"leaked\" " +"resources. (Neither leaked semaphores nor shared memory segments will be " +"automatically unlinked until the next reboot. This is problematic for both " +"objects because the system allows only a limited number of named semaphores, " +"and shared memory segments occupy some space in the main memory.)" msgstr "" msgid "" @@ -291,8 +301,12 @@ msgid "" 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." +"Libraries using :mod:`multiprocessing` " +"or :class:`~concurrent.futures.ProcessPoolExecutor` should be designed to " +"allow their users to provide their own multiprocessing context. Using a " +"specific context of your own within a library can lead to incompatibilities " +"with the rest of the library user's application. Always document if your " +"library requires a specific start method." msgstr "" msgid "" @@ -333,8 +347,8 @@ msgid "" msgstr "" msgid "" -"Queues are thread and process safe. Any object put into a :mod:" -"`~multiprocessing` queue will be serialized." +"Queues are thread and process safe. Any object put into " +"a :mod:`~multiprocessing` queue will be serialized." msgstr "" msgid "**Pipes**" @@ -362,16 +376,17 @@ msgstr "" msgid "" "The two connection objects returned by :func:`Pipe` represent the two ends " -"of the pipe. Each connection object has :meth:`~Connection.send` and :meth:" -"`~Connection.recv` methods (among others). Note that data in a pipe may " -"become corrupted if two processes (or threads) try to read from or write to " -"the *same* end of the pipe at the same time. Of course there is no risk of " -"corruption from processes using different ends of the pipe at the same time." +"of the pipe. Each connection object has :meth:`~Connection.send` " +"and :meth:`~Connection.recv` methods (among others). Note that data in a " +"pipe may become corrupted if two processes (or threads) try to read from or " +"write to the *same* end of the pipe at the same time. Of course there is no " +"risk of corruption from processes using different ends of the pipe at the " +"same time." msgstr "" msgid "" -"The :meth:`~Connection.send` method serializes the object and :meth:" -"`~Connection.recv` re-creates the object." +"The :meth:`~Connection.send` method serializes the object " +"and :meth:`~Connection.recv` re-creates the object." msgstr "" msgid "Synchronization between processes" @@ -415,16 +430,16 @@ msgid "" msgstr "" msgid "" -"However, if you really do need to use some shared data then :mod:" -"`multiprocessing` provides a couple of ways of doing so." +"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 ::" +"Data can be stored in a shared memory map using :class:`Value` " +"or :class:`Array`. For example, the following code ::" msgstr "" msgid "" @@ -463,9 +478,9 @@ msgid "" msgstr "" msgid "" -"For more flexibility in using shared memory one can use the :mod:" -"`multiprocessing.sharedctypes` module which supports the creation of " -"arbitrary ctypes objects allocated from shared memory." +"For more flexibility in using shared memory one can use " +"the :mod:`multiprocessing.sharedctypes` module which supports the creation " +"of arbitrary ctypes objects allocated from shared memory." msgstr "" msgid "**Server process**" @@ -478,11 +493,9 @@ msgid "" 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, ::" +"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 "" @@ -570,8 +583,8 @@ msgid "" " try:\n" " print(res.get(timeout=1))\n" " except TimeoutError:\n" -" print(\"We lacked patience and got a multiprocessing." -"TimeoutError\")\n" +" print(\"We lacked patience and got a " +"multiprocessing.TimeoutError\")\n" "\n" " print(\"For the moment, the pool remains available for more work\")\n" "\n" @@ -621,33 +634,50 @@ msgid "" msgstr "" msgid "Reference" +msgstr "Dokumentacja" + +msgid "" +"The :mod:`multiprocessing` package mostly replicates the API of " +"the :mod:`threading` module." +msgstr "" + +msgid "Global start method" +msgstr "" + +msgid "" +"Python supports several ways to create and initialize a process. The global " +"start method sets the default mechanism for creating a process." msgstr "" msgid "" -"The :mod:`multiprocessing` package mostly replicates the API of the :mod:" -"`threading` module." +"Several multiprocessing functions and methods that may also instantiate " +"certain objects will implicitly set the global start method to the system's " +"default, if it hasn’t been set already. The global start method can only be " +"set once. If you need to change the start method from the system default, " +"you must proactively set the global start method before calling functions or " +"methods, or creating these objects." 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`." +"Process objects represent activity that is run in a separate process. " +"The :class:`Process` class has equivalents of all the methods " +"of :class:`threading.Thread`." msgstr "" msgid "" "The constructor should always be called with keyword arguments. *group* " -"should always be ``None``; it exists solely for compatibility with :class:" -"`threading.Thread`. *target* is the callable object to be invoked by the :" -"meth:`run` method. It defaults to ``None``, meaning nothing is called. " -"*name* is the process name (see :attr:`name` for more details). *args* is " -"the argument tuple for the target invocation. *kwargs* is a dictionary of " -"keyword arguments for the target invocation. If provided, the keyword-only " -"*daemon* argument sets the process :attr:`daemon` flag to ``True`` or " -"``False``. If ``None`` (the default), this flag will be inherited from the " -"creating process." +"should always be ``None``; it exists solely for compatibility " +"with :class:`threading.Thread`. *target* is the callable object to be " +"invoked by the :meth:`run` method. It defaults to ``None``, meaning nothing " +"is called. *name* is the process name (see :attr:`name` for more details). " +"*args* is the argument tuple for the target invocation. *kwargs* is a " +"dictionary of keyword arguments for the target invocation. If provided, the " +"keyword-only *daemon* argument sets the process :attr:`daemon` flag to " +"``True`` or ``False``. If ``None`` (the default), this flag will be " +"inherited from the creating process." msgstr "" msgid "" @@ -658,10 +688,50 @@ 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 " +"base class constructor (``super().__init__()``) before doing anything else " "to the process." msgstr "" +msgid "" +"In general, all arguments to :class:`Process` must be picklable. This is " +"frequently observed when trying to create a :class:`Process` or use " +"a :class:`concurrent.futures.ProcessPoolExecutor` from a REPL with a locally " +"defined *target* function." +msgstr "" + +msgid "" +"Passing a callable object defined in the current REPL session causes the " +"child process to die via an uncaught :exc:`AttributeError` exception when " +"starting as *target* must have been defined within an importable module in " +"order to be loaded during unpickling." +msgstr "" + +msgid "Example of this uncatchable error from the child::" +msgstr "" + +msgid "" +">>> import multiprocessing as mp\n" +">>> def knigit():\n" +"... print(\"Ni!\")\n" +"...\n" +">>> process = mp.Process(target=knigit)\n" +">>> process.start()\n" +">>> Traceback (most recent call last):\n" +" File \".../multiprocessing/spawn.py\", line ..., in spawn_main\n" +" File \".../multiprocessing/spawn.py\", line ..., in _main\n" +"AttributeError: module '__main__' has no attribute 'knigit'\n" +">>> process\n" +"" +msgstr "" + +msgid "" +"See :ref:`multiprocessing-programming-spawn`. While this restriction is not " +"true if using the ``\"fork\"`` start method, as of Python ``3.14`` that is " +"no longer the default on any platform. See :ref:`multiprocessing-start-" +"methods`. See also :gh:`132898`." +msgstr "" + msgid "Added the *daemon* parameter." msgstr "" @@ -725,9 +795,9 @@ msgstr "" msgid "" "The initial name is set by the constructor. If no explicit name is provided " -"to the constructor, a name of the form 'Process-N\\ :sub:`1`:N\\ :sub:" -"`2`:...:N\\ :sub:`k`' is constructed, where each N\\ :sub:`k` is the N-th " -"child of its parent." +"to the constructor, a name of the form 'Process-" +"N\\ :sub:`1`:N\\ :sub:`2`:...:N\\ :sub:`k`' is constructed, where each " +"N\\ :sub:`k` is the N-th child of its parent." msgstr "" msgid "Return whether the process is alive." @@ -739,8 +809,8 @@ msgid "" msgstr "" msgid "" -"The process's daemon flag, a Boolean value. This must be set before :meth:" -"`start` is called." +"The process's daemon flag, a Boolean value. This must be set " +"before :meth:`start` is called." msgstr "" msgid "The initial value is inherited from the creating process." @@ -808,9 +878,9 @@ msgid "" msgstr "" msgid "" -"You can use this value if you want to wait on several events at once using :" -"func:`multiprocessing.connection.wait`. Otherwise calling :meth:`join` is " -"simpler." +"You can use this value if you want to wait on several events at once " +"using :func:`multiprocessing.connection.wait`. Otherwise " +"calling :meth:`join` is simpler." msgstr "" msgid "" @@ -820,9 +890,10 @@ msgid "" msgstr "" msgid "" -"Terminate the process. On POSIX this is done using the :py:const:`~signal." -"SIGTERM` signal; on Windows :c:func:`!TerminateProcess` is used. Note that " -"exit handlers and finally clauses, etc., will not be executed." +"Terminate the process. On POSIX this is done using " +"the :py:const:`~signal.SIGTERM` signal; on Windows :c:func:`!" +"TerminateProcess` is used. Note that exit handlers and finally clauses, " +"etc., will not be executed." msgstr "" msgid "" @@ -849,9 +920,10 @@ msgid "" msgstr "" msgid "" -"Note that the :meth:`start`, :meth:`join`, :meth:`is_alive`, :meth:" -"`terminate` and :attr:`exitcode` methods should only be called by the " -"process that created the process object." +"Note that " +"the :meth:`start`, :meth:`join`, :meth:`is_alive`, :meth:`terminate` " +"and :attr:`exitcode` methods should only be called by the process that " +"created the process object." msgstr "" msgid "Example usage of some of the methods of :class:`Process`:" @@ -911,23 +983,23 @@ msgid "" "The :class:`Queue`, :class:`SimpleQueue` and :class:`JoinableQueue` types " "are multi-producer, multi-consumer :abbr:`FIFO (first-in, first-out)` queues " "modelled on the :class:`queue.Queue` class in the standard library. They " -"differ in that :class:`Queue` lacks the :meth:`~queue.Queue.task_done` and :" -"meth:`~queue.Queue.join` methods introduced into Python 2.5's :class:`queue." -"Queue` class." +"differ in that :class:`Queue` lacks the :meth:`~queue.Queue.task_done` " +"and :meth:`~queue.Queue.join` methods introduced into Python " +"2.5's :class:`queue.Queue` class." msgstr "" msgid "" -"If you use :class:`JoinableQueue` then you **must** call :meth:" -"`JoinableQueue.task_done` for each task removed from the queue or else the " -"semaphore used to count the number of unfinished tasks may eventually " -"overflow, raising an exception." +"If you use :class:`JoinableQueue` then you **must** " +"call :meth:`JoinableQueue.task_done` for each task removed from the queue or " +"else the semaphore used to count the number of unfinished tasks may " +"eventually overflow, raising an exception." msgstr "" msgid "" -"One difference from other Python queue implementations, is that :mod:" -"`multiprocessing` queues serializes all objects that are put into them " -"using :mod:`pickle`. The object return by the get method is a re-created " -"object that does not share memory with the original object." +"One difference from other Python queue implementations, is " +"that :mod:`multiprocessing` queues serializes all objects that are put into " +"them using :mod:`pickle`. The object return by the get method is a re-" +"created object that does not share memory with the original object." msgstr "" msgid "" @@ -936,9 +1008,10 @@ msgid "" msgstr "" msgid "" -":mod:`multiprocessing` uses the usual :exc:`queue.Empty` and :exc:`queue." -"Full` exceptions to signal a timeout. They are not available in the :mod:" -"`multiprocessing` namespace so you need to import them from :mod:`queue`." +":mod:`multiprocessing` uses the usual :exc:`queue.Empty` " +"and :exc:`queue.Full` exceptions to signal a timeout. They are not " +"available in the :mod:`multiprocessing` namespace so you need to import them " +"from :mod:`queue`." msgstr "" msgid "" @@ -971,9 +1044,9 @@ msgstr "" msgid "" "As mentioned above, if a child process has put items on a queue (and it has " -"not used :meth:`JoinableQueue.cancel_join_thread `), then that process will not terminate until all " -"buffered items have been flushed to the pipe." +"not used :meth:`JoinableQueue.cancel_join_thread " +"`), then that process will not " +"terminate until all buffered items have been flushed to the pipe." msgstr "" msgid "" @@ -985,18 +1058,19 @@ msgid "" msgstr "" msgid "" -"Note that a queue created using a manager does not have this issue. See :" -"ref:`multiprocessing-programming`." +"Note that a queue created using a manager does not have this issue. " +"See :ref:`multiprocessing-programming`." msgstr "" msgid "" -"For an example of the usage of queues for interprocess communication see :" -"ref:`multiprocessing-examples`." +"For an example of the usage of queues for interprocess communication " +"see :ref:`multiprocessing-examples`." msgstr "" msgid "" -"Returns a pair ``(conn1, conn2)`` of :class:`~multiprocessing.connection." -"Connection` objects representing the ends of a pipe." +"Returns a pair ``(conn1, conn2)`` " +"of :class:`~multiprocessing.connection.Connection` objects representing the " +"ends of a pipe." msgstr "" msgid "" @@ -1018,6 +1092,11 @@ msgid "" "is started which transfers objects from a buffer into the pipe." msgstr "" +msgid "" +"Instantiating this class may set the global start method. See :ref:`global-" +"start-method` for more details." +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." @@ -1025,7 +1104,8 @@ msgstr "" msgid "" ":class:`Queue` implements all the methods of :class:`queue.Queue` except " -"for :meth:`~queue.Queue.task_done` and :meth:`~queue.Queue.join`." +"for :meth:`~queue.Queue.task_done`, :meth:`~queue.Queue.join`, " +"and :meth:`~queue.Queue.shutdown`." msgstr "" msgid "" @@ -1062,8 +1142,8 @@ msgid "" msgstr "" msgid "" -"If the queue is closed, :exc:`ValueError` is raised instead of :exc:" -"`AssertionError`." +"If the queue is closed, :exc:`ValueError` is raised instead " +"of :exc:`AssertionError`." msgstr "" msgid "Equivalent to ``put(obj, False)``." @@ -1075,28 +1155,36 @@ msgid "" "necessary until an item is available. If *timeout* is a positive number, it " "blocks at most *timeout* seconds and raises the :exc:`queue.Empty` exception " "if no item was available within that time. Otherwise (block is ``False``), " -"return an item if one is immediately available, else raise the :exc:`queue." -"Empty` exception (*timeout* is ignored in that case)." +"return an item if one is immediately available, else raise " +"the :exc:`queue.Empty` exception (*timeout* is ignored in that case)." msgstr "" msgid "" -"If the queue is closed, :exc:`ValueError` is raised instead of :exc:" -"`OSError`." +"If the queue is closed, :exc:`ValueError` is raised instead " +"of :exc:`OSError`." msgstr "" msgid "Equivalent to ``get(False)``." msgstr "" msgid "" -":class:`multiprocessing.Queue` has a few additional methods not found in :" -"class:`queue.Queue`. These methods are usually unnecessary for most code:" +":class:`multiprocessing.Queue` has a few additional methods not found " +"in :class:`queue.Queue`. These methods are usually unnecessary for most " +"code:" +msgstr "" + +msgid "Close the queue: release internal resources." +msgstr "" + +msgid "" +"A queue must not be used anymore after it is closed. For " +"example, :meth:`~Queue.get`, :meth:`~Queue.put` and :meth:`~Queue.empty` " +"methods must no longer be called." 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." +"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 "" @@ -1107,8 +1195,8 @@ msgstr "" msgid "" "By default if a process is not the creator of the queue then on exit it will " -"attempt to join the queue's background thread. The process can call :meth:" -"`cancel_join_thread` to make :meth:`join_thread` do nothing." +"attempt to join the queue's background thread. The process can " +"call :meth:`cancel_join_thread` to make :meth:`join_thread` do nothing." msgstr "" msgid "" @@ -1138,12 +1226,10 @@ 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." +"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." @@ -1208,8 +1294,8 @@ msgstr "" msgid "" "This number is not equivalent to the number of CPUs the current process can " -"use. The number of usable CPUs can be obtained with :func:`os." -"process_cpu_count` (or ``len(os.sched_getaffinity(0))``)." +"use. The number of usable CPUs can be obtained " +"with :func:`os.process_cpu_count` (or ``len(os.sched_getaffinity(0))``)." msgstr "" msgid "" @@ -1218,7 +1304,7 @@ msgid "" msgstr "" msgid ":func:`os.cpu_count` :func:`os.process_cpu_count`" -msgstr "" +msgstr ":func:`os.cpu_count` :func:`os.process_cpu_count`" msgid "" "The return value can also be overridden using the :option:`-X cpu_count <-" @@ -1241,7 +1327,7 @@ 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**, " +"frozen to produce an executable. (Has been tested with **py2exe**, " "**PyInstaller** and **cx_Freeze**.)" msgstr "" @@ -1267,38 +1353,40 @@ msgid "" 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." +"Calling ``freeze_support()`` has no effect when the start method is not " +"*spawn*. In addition, if the module is being run normally by the Python " +"interpreter (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'``. Not all platforms support all methods. See :ref:" -"`multiprocessing-start-methods`." +"``'forkserver'``. Not all platforms support all methods. " +"See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" -"Return a context object which has the same attributes as the :mod:" -"`multiprocessing` module." +"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. See :" -"ref:`multiprocessing-start-methods`." +"If *method* is ``None`` then the default context is returned. Note that if " +"the global start method has not been set, this will set it to the system " +"default See :ref:`global-start-method` for more details. Otherwise *method* " +"should be ``'fork'``, ``'spawn'``, ``'forkserver'``. :exc:`ValueError` is " +"raised if the specified start method is not available. " +"See :ref:`multiprocessing-start-methods`." 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." +"If the global start method is not set and *allow_none* is ``False``, the " +"global start method is set to the default, and its name is returned. " +"See :ref:`global-start-method` for more details." msgstr "" msgid "" @@ -1315,7 +1403,7 @@ 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 ::" +"to do something like ::" msgstr "" msgid "set_executable(os.path.join(sys.exec_prefix, 'pythonw.exe'))" @@ -1344,17 +1432,17 @@ msgid "" msgstr "" msgid "" -"Only meaningful when using the ``'forkserver'`` start method. See :ref:" -"`multiprocessing-start-methods`." +"Only meaningful when using the ``'forkserver'`` start method. " +"See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" "Set the method which should be used to start child processes. The *method* " -"argument can be ``'fork'``, ``'spawn'`` or ``'forkserver'``. Raises :exc:" -"`RuntimeError` if the start method has already been set and *force* is not " -"``True``. If *method* is ``None`` and *force* is ``True`` then the start " -"method is set to ``None``. If *method* is ``None`` and *force* is ``False`` " -"then the context is set to the default context." +"argument can be ``'fork'``, ``'spawn'`` or ``'forkserver'``. " +"Raises :exc:`RuntimeError` if the start method has already been set and " +"*force* is not ``True``. If *method* is ``None`` and *force* is ``True`` " +"then the start method is set to ``None``. If *method* is ``None`` and " +"*force* is ``False`` then the context is set to the default context." msgstr "" msgid "" @@ -1366,10 +1454,9 @@ msgid "See :ref:`multiprocessing-start-methods`." msgstr "" msgid "" -":mod:`multiprocessing` contains no analogues of :func:`threading." -"active_count`, :func:`threading.enumerate`, :func:`threading.settrace`, :" -"func:`threading.setprofile`, :class:`threading.Timer`, or :class:`threading." -"local`." +":mod:`multiprocessing` contains no analogues " +"of :func:`threading.active_count`, :func:`threading.enumerate`, :func:`threading.settrace`, :func:`threading.setprofile`, :class:`threading.Timer`, " +"or :class:`threading.local`." msgstr "" msgid "Connection Objects" @@ -1381,8 +1468,8 @@ msgid "" msgstr "" msgid "" -"Connection objects are usually created using :func:`Pipe ` -- see also :ref:`multiprocessing-listeners-clients`." +"Connection objects are usually created using :func:`Pipe " +"` -- see also :ref:`multiprocessing-listeners-clients`." msgstr "" msgid "" @@ -1396,9 +1483,10 @@ msgid "" msgstr "" msgid "" -"Return an object sent from the other end of the connection using :meth:" -"`send`. Blocks until there is something to receive. Raises :exc:`EOFError` " -"if there is nothing left to receive and the other end was closed." +"Return an object sent from the other end of the connection " +"using :meth:`send`. Blocks until there is something to receive. " +"Raises :exc:`EOFError` if there is nothing left to receive and the other end " +"was closed." msgstr "" msgid "Return the file descriptor or handle used by the connection." @@ -1420,48 +1508,48 @@ msgid "" msgstr "" msgid "" -"Note that multiple connection objects may be polled at once by using :func:" -"`multiprocessing.connection.wait`." +"Note that multiple connection objects may be polled at once by " +"using :func:`multiprocessing.connection.wait`." msgstr "" msgid "Send byte data from a :term:`bytes-like object` as a complete message." 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" +"If *offset* is given then data is read from that position in *buf*. If " +"*size* is given then that many bytes will be read from *buf*. Very large " +"buffers (approximately 32 MiB+, though it depends on the OS) may raise " +"a :exc:`ValueError` exception" msgstr "" msgid "" "Return a complete message of byte data sent from the other end of the " -"connection as a string. Blocks until there is something to receive. Raises :" -"exc:`EOFError` if there is nothing left to receive and the other end has " -"closed." +"connection as a string. Blocks until there is something to receive. " +"Raises :exc:`EOFError` if there is nothing left to receive and the other end " +"has closed." msgstr "" msgid "" -"If *maxlength* is specified and the message is longer than *maxlength* then :" -"exc:`OSError` is raised and the connection will no longer be readable." +"If *maxlength* is specified and the message is longer than *maxlength* " +"then :exc:`OSError` is raised and the connection will no longer be readable." msgstr "" msgid "" -"This function used to raise :exc:`IOError`, which is now an alias of :exc:" -"`OSError`." +"This function used to raise :exc:`IOError`, which is now an alias " +"of :exc:`OSError`." msgstr "" msgid "" -"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." +"Read into *buf* 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 " +"*buf* 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)." +"must be a non-negative integer less than the length of *buf* (in bytes)." msgstr "" msgid "" @@ -1476,9 +1564,10 @@ msgid "" msgstr "" msgid "" -"Connection objects also now support the context management protocol -- see :" -"ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the " -"connection object, and :meth:`~contextmanager.__exit__` calls :meth:`close`." +"Connection objects also now support the context management protocol -- " +"see :ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` returns " +"the connection object, and :meth:`~contextmanager.__exit__` " +"calls :meth:`close`." msgstr "" msgid "For example:" @@ -1512,8 +1601,8 @@ msgstr "" msgid "" "Therefore, unless the connection object was produced using :func:`Pipe` you " "should only use the :meth:`~Connection.recv` and :meth:`~Connection.send` " -"methods after performing some sort of authentication. See :ref:" -"`multiprocessing-auth-keys`." +"methods after performing some sort of authentication. " +"See :ref:`multiprocessing-auth-keys`." msgstr "" msgid "" @@ -1527,8 +1616,8 @@ msgstr "" msgid "" "Generally synchronization primitives are not as necessary in a multiprocess " -"program as they are in a multithreaded program. See the documentation for :" -"mod:`threading` module." +"program as they are in a multithreaded program. See the documentation " +"for :mod:`threading` module." msgstr "" msgid "" @@ -1540,8 +1629,8 @@ msgid "A barrier object: a clone of :class:`threading.Barrier`." msgstr "" msgid "" -"A bounded semaphore object: a close analog of :class:`threading." -"BoundedSemaphore`." +"A bounded semaphore object: a close analog " +"of :class:`threading.BoundedSemaphore`." msgstr "" msgid "" @@ -1572,10 +1661,10 @@ msgid "" "A non-recursive lock object: a close analog of :class:`threading.Lock`. Once " "a process or thread has acquired a lock, subsequent attempts to acquire it " "from any process or thread will block until it is released; any process or " -"thread may release it. The concepts and behaviors of :class:`threading." -"Lock` as it applies to threads are replicated here in :class:" -"`multiprocessing.Lock` as it applies to either processes or threads, except " -"as noted." +"thread may release it. The concepts and behaviors " +"of :class:`threading.Lock` as it applies to threads are replicated here " +"in :class:`multiprocessing.Lock` as it applies to either processes or " +"threads, except as noted." msgstr "" msgid "" @@ -1670,9 +1759,9 @@ msgid "" msgstr "" msgid "" -"Use and behaviors of the *timeout* argument are the same as in :meth:`Lock." -"acquire`. Note that some of these behaviors of *timeout* differ from the " -"implemented behaviors in :meth:`threading.RLock.acquire`." +"Use and behaviors of the *timeout* argument are the same as " +"in :meth:`Lock.acquire`. Note that some of these behaviors of *timeout* " +"differ from the implemented behaviors in :meth:`threading.RLock.acquire`." msgstr "" msgid "" @@ -1685,8 +1774,8 @@ msgid "" msgstr "" msgid "" -"Only call this method when the calling process or thread owns the lock. An :" -"exc:`AssertionError` is raised if this method is called by a process or " +"Only call this method when the calling process or thread owns the lock. " +"An :exc:`AssertionError` is raised if this method is called by a process or " "thread other than the owner or if the lock is in an unlocked (unowned) " "state. Note that the type of exception raised in this situation differs " "from the implemented behavior in :meth:`threading.RLock.release`." @@ -1702,9 +1791,9 @@ msgstr "" msgid "" "Some of this package's functionality requires a functioning shared semaphore " -"implementation on the host operating system. Without one, the :mod:" -"`multiprocessing.synchronize` module will be disabled, and attempts to " -"import it will result in an :exc:`ImportError`. See :issue:`3770` for " +"implementation on the host operating system. Without one, " +"the :mod:`multiprocessing.synchronize` module will be disabled, and attempts " +"to import it will result in an :exc:`ImportError`. See :issue:`3770` for " "additional information." msgstr "" @@ -1724,8 +1813,9 @@ msgstr "" msgid "" "*typecode_or_type* determines the type of the returned object: it is either " -"a ctypes type or a one character typecode of the kind used by the :mod:" -"`array` module. *\\*args* is passed on to the constructor for the type." +"a ctypes type or a one character typecode of the kind used by " +"the :mod:`array` module. *\\*args* is passed on to the constructor for the " +"type." msgstr "" msgid "" @@ -1766,20 +1856,23 @@ 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." +"array: it is either a :ref:`ctypes type ` or " +"a one character typecode of the kind used by the :mod:`array` module with " +"the exception of ``'w'``, which is not supported. In addition, the ``'c'`` " +"typecode is an alias for :class:`ctypes.c_char`. 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\"." +"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." @@ -1787,7 +1880,10 @@ msgstr "" msgid "" "Note that an array of :data:`ctypes.c_char` has *value* and *raw* attributes " -"which allow one to use it to store and retrieve strings." +"which can both be used to store and retrieve byte strings. While *raw* " +"allows interaction with a :class:`bytes` object the full size of the array, " +"reading *value* will terminate after a null byte, like most programming " +"languages handle strings." msgstr "" msgid "The :mod:`multiprocessing.sharedctypes` module" @@ -1820,18 +1916,18 @@ msgid "" msgstr "" msgid "" -"Note that setting and getting an element is potentially non-atomic -- use :" -"func:`Array` instead to make sure that access is automatically synchronized " -"using a lock." +"Note that setting and getting an element is potentially non-atomic -- " +"use :func:`Array` instead to make sure that access is automatically " +"synchronized using a lock." msgstr "" msgid "Return a ctypes object allocated from shared memory." msgstr "" msgid "" -"Note that setting and getting the value is potentially non-atomic -- use :" -"func:`Value` instead to make sure that access is automatically synchronized " -"using a lock." +"Note that setting and getting the value is potentially non-atomic -- " +"use :func:`Value` instead to make sure that access is automatically " +"synchronized using a lock." msgstr "" msgid "" @@ -1848,11 +1944,20 @@ msgstr "" msgid "" "If *lock* is ``True`` (the default) then a new lock object is created to " -"synchronize access to the value. If *lock* is a :class:`~multiprocessing." -"Lock` or :class:`~multiprocessing.RLock` object then that will be used to " -"synchronize access to the value. If *lock* is ``False`` then access to the " -"returned object will not be automatically protected by a lock, so it will " -"not necessarily be \"process-safe\"." +"synchronize access to the value. If *lock* is " +"a :class:`~multiprocessing.Lock` or :class:`~multiprocessing.RLock` object " +"then that will be used to synchronize access to the value. If *lock* is " +"``False`` then access to the returned object will not be automatically " +"protected by a lock, so it will not necessarily be \"process-safe\"." +msgstr "" + +msgid "" +"*ctx* is a context object, or ``None`` (use the current context). If " +"``None``, calling this may set the global start method. See :ref:`global-" +"start-method` for more details." +msgstr "" + +msgid "Note that *lock* and *ctx* are keyword-only parameters." msgstr "" msgid "" @@ -1868,14 +1973,14 @@ msgstr "" msgid "" "Return a process-safe wrapper object for a ctypes object which uses *lock* " -"to synchronize access. If *lock* is ``None`` (the default) then a :class:" -"`multiprocessing.RLock` object is created automatically." +"to synchronize access. If *lock* is ``None`` (the default) then " +"a :class:`multiprocessing.RLock` object is created automatically." msgstr "" msgid "" "A synchronized wrapper will have two methods in addition to those of the " -"object it wraps: :meth:`get_obj` returns the wrapped object and :meth:" -"`get_lock` returns the lock object used for synchronization." +"object it wraps: :meth:`get_obj` returns the wrapped object " +"and :meth:`get_lock` returns the lock object used for synchronization." msgstr "" msgid "" @@ -2003,17 +2108,17 @@ msgstr "" msgid "" "Manager processes will be shutdown as soon as they are garbage collected or " -"their parent process exits. The manager classes are defined in the :mod:" -"`multiprocessing.managers` module:" +"their parent process exits. The manager classes are defined in " +"the :mod:`multiprocessing.managers` module:" msgstr "" msgid "Create a BaseManager object." msgstr "" msgid "" -"Once created one should call :meth:`start` or ``get_server()." -"serve_forever()`` to ensure that the manager object refers to a started " -"manager process." +"Once created one should call :meth:`start` or " +"``get_server().serve_forever()`` to ensure that the manager object refers to " +"a started manager process." msgstr "" msgid "" @@ -2033,11 +2138,6 @@ msgid "" "``'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 " @@ -2055,8 +2155,8 @@ msgstr "" msgid "" "Returns a :class:`Server` object which represents the actual server under " -"the control of the Manager. The :class:`Server` object supports the :meth:" -"`serve_forever` method::" +"the control of the Manager. The :class:`Server` object supports " +"the :meth:`serve_forever` method::" msgstr "" msgid "" @@ -2082,8 +2182,8 @@ msgstr "" ">>> m.connect()" msgid "" -"Stop the process used by the manager. This is only available if :meth:" -"`start` has been used to start the server process." +"Stop the process used by the manager. This is only available " +"if :meth:`start` has been used to start the server process." msgstr "" msgid "This can be called multiple times." @@ -2114,21 +2214,22 @@ msgstr "" msgid "" "*exposed* is used to specify a sequence of method names which proxies for " -"this typeid should be allowed to access using :meth:`BaseProxy." -"_callmethod`. (If *exposed* is ``None`` then :attr:`proxytype._exposed_` is " -"used instead if it exists.) In the case where no exposed list is specified, " -"all \"public methods\" of the shared object will be accessible. (Here a " -"\"public method\" means any attribute which has a :meth:`~object.__call__` " -"method and whose name does not begin with ``'_'``.)" +"this typeid should be allowed to access " +"using :meth:`BaseProxy._callmethod`. (If *exposed* is ``None`` " +"then :attr:`proxytype._exposed_` is used instead if it exists.) In the case " +"where no exposed list is specified, all \"public methods\" of the shared " +"object will be accessible. (Here a \"public method\" means any attribute " +"which has a :meth:`~object.__call__` method and whose name does not begin " +"with ``'_'``.)" msgstr "" msgid "" "*method_to_typeid* is a mapping used to specify the return type of those " "exposed methods which should return a proxy. It maps method names to typeid " -"strings. (If *method_to_typeid* is ``None`` then :attr:`proxytype." -"_method_to_typeid_` is used instead if it exists.) If a method's name is " -"not a key of this mapping or if the mapping is ``None`` then the object " -"returned by the method will be copied by value." +"strings. (If *method_to_typeid* is ``None`` " +"then :attr:`proxytype._method_to_typeid_` is used instead if it exists.) If " +"a method's name is not a key of this mapping or if the mapping is ``None`` " +"then the object returned by the method will be copied by value." msgstr "" msgid "" @@ -2144,9 +2245,9 @@ msgid "The address used by the manager." msgstr "" msgid "" -"Manager objects support the context management protocol -- see :ref:" -"`typecontextmanager`. :meth:`~contextmanager.__enter__` starts the server " -"process (if it has not already started) and then returns the manager " +"Manager objects support the context management protocol -- " +"see :ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` starts the " +"server process (if it has not already started) and then returns the manager " "object. :meth:`~contextmanager.__exit__` calls :meth:`shutdown`." msgstr "" @@ -2157,8 +2258,8 @@ msgstr "" msgid "" "A subclass of :class:`BaseManager` which can be used for the synchronization " -"of processes. Objects of this type are returned by :func:`multiprocessing." -"Manager`." +"of processes. Objects of this type are returned " +"by :func:`multiprocessing.Manager`." msgstr "" msgid "" @@ -2182,8 +2283,8 @@ msgid "" msgstr "" msgid "" -"If *lock* is supplied then it should be a proxy for a :class:`threading." -"Lock` or :class:`threading.RLock` object." +"If *lock* is supplied then it should be a proxy for " +"a :class:`threading.Lock` or :class:`threading.RLock` object." msgstr "" msgid "" @@ -2401,9 +2502,9 @@ msgstr "" msgid "" "An important feature of proxy objects is that they are picklable so they can " -"be passed between processes. As such, a referent can contain :ref:" -"`multiprocessing-proxy_objects`. This permits nesting of these managed " -"lists, dicts, and other :ref:`multiprocessing-proxy_objects`:" +"be passed between processes. As such, a referent can " +"contain :ref:`multiprocessing-proxy_objects`. This permits nesting of these " +"managed lists, dicts, and other :ref:`multiprocessing-proxy_objects`:" msgstr "" msgid "" @@ -2457,9 +2558,9 @@ msgid "" msgstr "" msgid "" -"This approach is perhaps less convenient than employing nested :ref:" -"`multiprocessing-proxy_objects` for most use cases but also demonstrates a " -"level of control over the synchronization." +"This approach is perhaps less convenient than employing " +"nested :ref:`multiprocessing-proxy_objects` for most use cases but also " +"demonstrates a level of control over the synchronization." msgstr "" msgid "" @@ -2507,10 +2608,10 @@ msgid "" msgstr "" msgid "" -"If an exception is raised by the call, then is re-raised by :meth:" -"`_callmethod`. If some other exception is raised in the manager's process " -"then this is converted into a :exc:`RemoteError` exception and is raised by :" -"meth:`_callmethod`." +"If an exception is raised by the call, then is re-raised " +"by :meth:`_callmethod`. If some other exception is raised in the manager's " +"process then this is converted into a :exc:`RemoteError` exception and is " +"raised by :meth:`_callmethod`." msgstr "" msgid "" @@ -2591,9 +2692,12 @@ msgstr "" msgid "" "*context* can be used to specify the context used for starting the worker " -"processes. Usually a pool is created using the function :func:" -"`multiprocessing.Pool` or the :meth:`Pool` method of a context object. In " -"both cases *context* is set appropriately." +"processes. Usually a pool is created using the " +"function :func:`multiprocessing.Pool` or the :meth:`Pool` method of a " +"context object. In both cases *context* is set appropriately. If ``None``, " +"calling this function will have the side effect of setting the current " +"global start method if it has not been set already. See " +"the :func:`get_context` function." msgstr "" msgid "" @@ -2621,8 +2725,8 @@ msgid "Added the *context* parameter." msgstr "" msgid "" -"*processes* uses :func:`os.process_cpu_count` by default, instead of :func:" -"`os.cpu_count`." +"*processes* uses :func:`os.process_cpu_count` by default, instead " +"of :func:`os.cpu_count`." msgstr "" msgid "" @@ -2630,9 +2734,9 @@ msgid "" "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." +"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 "" @@ -2643,8 +2747,8 @@ msgid "" msgstr "" msgid "" -"A variant of the :meth:`apply` method which returns a :class:" -"`~multiprocessing.pool.AsyncResult` object." +"A variant of the :meth:`apply` method which returns " +"a :class:`~multiprocessing.pool.AsyncResult` object." msgstr "" msgid "" @@ -2684,11 +2788,11 @@ msgid "" msgstr "" msgid "" -"A variant of the :meth:`.map` method which returns a :class:" -"`~multiprocessing.pool.AsyncResult` object." +"A variant of the :meth:`.map` method which returns " +"a :class:`~multiprocessing.pool.AsyncResult` object." msgstr "" -msgid "A lazier version of :meth:`.map`." +msgid "An iterator-based version of :meth:`.map`." msgstr "" msgid "" @@ -2738,26 +2842,27 @@ msgid "" msgstr "" msgid "" -"Wait for the worker processes to exit. One must call :meth:`close` or :meth:" -"`terminate` before using :meth:`join`." +"Wait for the worker processes to exit. One must call :meth:`close` " +"or :meth:`terminate` before using :meth:`join`." msgstr "" msgid "" -"Pool objects now support the context management protocol -- see :ref:" -"`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the pool " -"object, and :meth:`~contextmanager.__exit__` calls :meth:`terminate`." +"Pool objects now support the context management protocol -- " +"see :ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` returns " +"the pool object, and :meth:`~contextmanager.__exit__` " +"calls :meth:`terminate`." msgstr "" msgid "" -"The class of the result returned by :meth:`Pool.apply_async` and :meth:`Pool." -"map_async`." +"The class of the result returned by :meth:`Pool.apply_async` " +"and :meth:`Pool.map_async`." msgstr "" msgid "" "Return the result when it arrives. If *timeout* is not ``None`` and the " -"result does not arrive within *timeout* seconds then :exc:`multiprocessing." -"TimeoutError` is raised. If the remote call raised an exception then that " -"exception will be reraised by :meth:`get`." +"result does not arrive within *timeout* seconds " +"then :exc:`multiprocessing.TimeoutError` is raised. If the remote call " +"raised an exception then that exception will be reraised by :meth:`get`." msgstr "" msgid "Wait until the result is available or until *timeout* seconds pass." @@ -2767,13 +2872,13 @@ msgid "Return whether the call has completed." msgstr "" msgid "" -"Return whether the call completed without raising an exception. Will raise :" -"exc:`ValueError` if the result is not ready." +"Return whether the call completed without raising an exception. Will " +"raise :exc:`ValueError` if the result is not ready." msgstr "" msgid "" -"If the result is not ready, :exc:`ValueError` is raised instead of :exc:" -"`AssertionError`." +"If the result is not ready, :exc:`ValueError` is raised instead " +"of :exc:`AssertionError`." msgstr "" msgid "The following example demonstrates the use of a pool::" @@ -2802,16 +2907,16 @@ msgid "" "computer is *very* slow\n" "\n" " result = pool.apply_async(time.sleep, (10,))\n" -" print(result.get(timeout=1)) # raises multiprocessing." -"TimeoutError" +" print(result.get(timeout=1)) # raises " +"multiprocessing.TimeoutError" msgstr "" msgid "Listeners and Clients" msgstr "" msgid "" -"Usually message passing between processes is done using queues or by using :" -"class:`~Connection` objects returned by :func:`~multiprocessing.Pipe`." +"Usually message passing between processes is done using queues or by " +"using :class:`~Connection` objects returned by :func:`~multiprocessing.Pipe`." msgstr "" msgid "" @@ -2839,8 +2944,8 @@ msgid "" msgstr "" msgid "" -"If a welcome message is not received, then :exc:`~multiprocessing." -"AuthenticationError` is raised." +"If a welcome message is not received, " +"then :exc:`~multiprocessing.AuthenticationError` is raised." msgstr "" msgid "" @@ -2857,9 +2962,9 @@ msgstr "" msgid "" "If *authkey* is given and not ``None``, it should be a byte string and will " "be used as the secret key for an HMAC-based authentication challenge. No " -"authentication is done if *authkey* is ``None``. :exc:`~multiprocessing." -"AuthenticationError` is raised if authentication fails. See :ref:" -"`multiprocessing-auth-keys`." +"authentication is done if *authkey* is " +"``None``. :exc:`~multiprocessing.AuthenticationError` is raised if " +"authentication fails. See :ref:`multiprocessing-auth-keys`." msgstr "" msgid "" @@ -2921,9 +3026,10 @@ msgid "" msgstr "" msgid "" -"Listener objects now support the context management protocol -- see :ref:" -"`typecontextmanager`. :meth:`~contextmanager.__enter__` returns the " -"listener object, and :meth:`~contextmanager.__exit__` calls :meth:`close`." +"Listener objects now support the context management protocol -- " +"see :ref:`typecontextmanager`. :meth:`~contextmanager.__enter__` returns " +"the listener object, and :meth:`~contextmanager.__exit__` " +"calls :meth:`close`." msgstr "" msgid "" @@ -2945,8 +3051,8 @@ msgid "a connected and readable :class:`socket.socket` object; or" msgstr "" msgid "" -"the :attr:`~multiprocessing.Process.sentinel` attribute of a :class:" -"`~multiprocessing.Process` object." +"the :attr:`~multiprocessing.Process.sentinel` attribute of " +"a :class:`~multiprocessing.Process` object." msgstr "" msgid "" @@ -2955,17 +3061,18 @@ msgid "" msgstr "" msgid "" -"**POSIX**: ``wait(object_list, timeout)`` almost equivalent ``select." -"select(object_list, [], [], timeout)``. The difference is that, if :func:" -"`select.select` is interrupted by a signal, it can raise :exc:`OSError` with " -"an error number of ``EINTR``, whereas :func:`wait` will not." +"**POSIX**: ``wait(object_list, timeout)`` almost equivalent " +"``select.select(object_list, [], [], timeout)``. The difference is that, " +"if :func:`select.select` is interrupted by a signal, it can " +"raise :exc:`OSError` with an error number of ``EINTR``, whereas :func:`wait` " +"will not." msgstr "" msgid "" "**Windows**: An item in *object_list* must either be an integer handle which " "is waitable (according to the definition used by the documentation of the " -"Win32 function ``WaitForMultipleObjects()``) or it can be an object with a :" -"meth:`~io.IOBase.fileno` method which returns a socket handle or pipe " +"Win32 function ``WaitForMultipleObjects()``) or it can be an object with " +"a :meth:`~io.IOBase.fileno` method which returns a socket handle or pipe " "handle. (Note that pipe handles and socket handles are **not** waitable " "handles.)" msgstr "" @@ -3100,27 +3207,39 @@ msgstr "" msgid "" "If authentication is requested but no authentication key is specified then " -"the return value of ``current_process().authkey`` is used (see :class:" -"`~multiprocessing.Process`). This value will be automatically inherited by " -"any :class:`~multiprocessing.Process` object that the current process " -"creates. This means that (by default) all processes of a multi-process " -"program will share a single authentication key which can be used when " -"setting up connections between themselves." +"the return value of ``current_process().authkey`` is used " +"(see :class:`~multiprocessing.Process`). This value will be automatically " +"inherited by any :class:`~multiprocessing.Process` object that the current " +"process creates. This means that (by default) all processes of a multi-" +"process program will share a single authentication key which can be used " +"when setting up connections between themselves." +msgstr "" + +msgid "" +"Suitable authentication keys can also be generated by " +"using :func:`os.urandom`." msgstr "" msgid "" -"Suitable authentication keys can also be generated by using :func:`os." -"urandom`." +"This authentication protects :class:`Listener` and :func:`Client` " +"connections, which are reachable by address. It is not applied to the " +"anonymous pipes created by :func:`~multiprocessing.Pipe` or used internally " +"by :class:`~multiprocessing.Queue`. :mod:`multiprocessing` treats all local " +"processes running as the same user as trusted; on most operating systems " +"such processes can access each other's pipe file descriptors regardless. " +"Applications that require isolation between processes of the same user must " +"arrange it at the operating-system level -- for example, by running workers " +"under a different user account or in a sandbox." 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." +"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 "" @@ -3178,10 +3297,10 @@ msgid "" msgstr "" msgid "" -"In particular, the ``Pool`` function provided by :mod:`multiprocessing." -"dummy` returns an instance of :class:`ThreadPool`, which is a subclass of :" -"class:`Pool` that supports all the same method calls but uses a pool of " -"worker threads rather than worker processes." +"In particular, the ``Pool`` function provided " +"by :mod:`multiprocessing.dummy` returns an instance of :class:`ThreadPool`, " +"which is a subclass of :class:`Pool` that supports all the same method calls " +"but uses a pool of worker threads rather than worker processes." msgstr "" msgid "" @@ -3189,8 +3308,8 @@ msgid "" "can be submitted. :class:`ThreadPool` instances are fully interface " "compatible with :class:`Pool` instances, and their resources must also be " "properly managed, either by using the pool as a context manager or by " -"calling :meth:`~multiprocessing.pool.Pool.close` and :meth:`~multiprocessing." -"pool.Pool.terminate` manually." +"calling :meth:`~multiprocessing.pool.Pool.close` " +"and :meth:`~multiprocessing.pool.Pool.terminate` manually." msgstr "" msgid "" @@ -3204,19 +3323,19 @@ msgstr "" msgid "" "A :class:`ThreadPool` shares the same interface as :class:`Pool`, which is " -"designed around a pool of processes and predates the introduction of the :" -"class:`concurrent.futures` module. As such, it inherits some operations " -"that don't make sense for a pool backed by threads, and it has its own type " -"for representing the status of asynchronous jobs, :class:`AsyncResult`, that " -"is not understood by any other libraries." +"designed around a pool of processes and predates the introduction of " +"the :class:`concurrent.futures` module. As such, it inherits some " +"operations that don't make sense for a pool backed by threads, and it has " +"its own type for representing the status of asynchronous " +"jobs, :class:`AsyncResult`, that is not understood by any other libraries." msgstr "" msgid "" -"Users should generally prefer to use :class:`concurrent.futures." -"ThreadPoolExecutor`, which has a simpler interface that was designed around " -"threads from the start, and which returns :class:`concurrent.futures.Future` " -"instances that are compatible with many other libraries, including :mod:" -"`asyncio`." +"Users should generally prefer to " +"use :class:`concurrent.futures.ThreadPoolExecutor`, which has a simpler " +"interface that was designed around threads from the start, and which " +"returns :class:`concurrent.futures.Future` instances that are compatible " +"with many other libraries, including :mod:`asyncio`." msgstr "" msgid "Programming guidelines" @@ -3273,21 +3392,21 @@ msgid "" "zombie. There should never be very many because each time a new process " "starts (or :func:`~multiprocessing.active_children` is called) all completed " "processes which have not yet been joined will be joined. Also calling a " -"finished process's :meth:`Process.is_alive ` will join the process. Even so it is probably good practice to " -"explicitly join all the processes that you start." +"finished process's :meth:`Process.is_alive " +"` will join the process. Even so it is " +"probably good practice to explicitly join all the processes that you start." msgstr "" msgid "Better to inherit than pickle/unpickle" 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." +"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" @@ -3301,9 +3420,9 @@ msgid "" msgstr "" msgid "" -"Therefore it is probably best to only consider using :meth:`Process." -"terminate ` on processes which never use " -"any shared resources." +"Therefore it is probably best to only consider " +"using :meth:`Process.terminate ` on " +"processes which never use any shared resources." msgstr "" msgid "Joining processes that use queues" @@ -3312,9 +3431,10 @@ msgstr "" msgid "" "Bear in mind that a process that has put items in a queue will wait before " "terminating until all the buffered items are fed by the \"feeder\" thread to " -"the underlying pipe. (The child process can call the :meth:`Queue." -"cancel_join_thread ` method of the " -"queue to avoid this behaviour.)" +"the underlying pipe. (The child process can call " +"the :meth:`Queue.cancel_join_thread " +"` method of the queue to avoid " +"this behaviour.)" msgstr "" msgid "" @@ -3343,8 +3463,8 @@ msgid "" msgstr "" msgid "" -"A fix here would be to swap the last two lines (or simply remove the ``p." -"join()`` line)." +"A fix here would be to swap the last two lines (or simply remove the " +"``p.join()`` line)." msgstr "" msgid "Explicitly pass resources to child processes" @@ -3418,9 +3538,10 @@ msgid "" "Which solves the fundamental issue of processes colliding with each other " "resulting in a bad file descriptor error, but introduces a potential danger " "to applications which replace :func:`sys.stdin` with a \"file-like object\" " -"with output buffering. This danger is that if multiple processes call :meth:" -"`~io.IOBase.close` on this file-like object, it could result in the same " -"data being flushed to the object multiple times, resulting in corruption." +"with output buffering. This danger is that if multiple processes " +"call :meth:`~io.IOBase.close` on this file-like object, it could result in " +"the same data being flushed to the object multiple times, resulting in " +"corruption." msgstr "" msgid "" @@ -3455,10 +3576,10 @@ 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." +"Ensure that all arguments to :class:`~multiprocessing.Process` are " +"picklable. Also, if you subclass ``Process.__init__``, you must make sure " +"that instances will be picklable when the :meth:`Process.start " +"` method is called." msgstr "" msgid "Global variables" @@ -3467,8 +3588,8 @@ msgstr "" msgid "" "Bear in mind that if code run in a child process tries to access a global " "variable, then the value it sees (if any) may not be the same as the value " -"in the parent process at the time that :meth:`Process.start ` was called." +"in the parent process at the time that :meth:`Process.start " +"` was called." msgstr "" msgid "" @@ -3736,8 +3857,8 @@ msgid "" " try:\n" " print(list(pool.imap(f, list(range(10)))))\n" " except ZeroDivisionError:\n" -" print('\\tGot ZeroDivisionError as expected from list(pool." -"imap())')\n" +" print('\\tGot ZeroDivisionError as expected from " +"list(pool.imap())')\n" " else:\n" " raise AssertionError('expected ZeroDivisionError')\n" "\n" @@ -3755,8 +3876,8 @@ msgid "" " raise AssertionError('expected ZeroDivisionError')\n" "\n" " assert i == 9\n" -" print('\\tGot ZeroDivisionError as expected from IMapIterator." -"next()')\n" +" print('\\tGot ZeroDivisionError as expected from " +"IMapIterator.next()')\n" " print()\n" "\n" " #\n" diff --git a/library/multiprocessing.shared_memory.po b/library/multiprocessing.shared_memory.po index 562cf8488e..144e6d17f3 100644 --- a/library/multiprocessing.shared_memory.po +++ b/library/multiprocessing.shared_memory.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,16 +29,16 @@ msgid "" msgstr "" msgid "**Source code:** :source:`Lib/multiprocessing/shared_memory.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/multiprocessing/shared_memory.py`" 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." +"a :class:`~multiprocessing.managers.BaseManager` " +"subclass, :class:`~multiprocessing.managers.SharedMemoryManager`, is also " +"provided in the :mod:`multiprocessing.managers` module." msgstr "" msgid "" @@ -117,19 +116,21 @@ msgid "Added the *track* parameter." msgstr "" msgid "" -"Close the file descriptor/handle to the shared memory from this instance. :" -"meth:`close` should be called once access to the shared memory block from " -"this instance is no longer needed. Depending on operating system, the " -"underlying memory may or may not be freed even if all handles to it have " -"been closed. To ensure proper cleanup, use the :meth:`unlink` method." +"Close the file descriptor/handle to the shared memory from this " +"instance. :meth:`close` should be called once access to the shared memory " +"block from this instance is no longer needed. Depending on operating " +"system, the underlying memory may or may not be freed even if all handles to " +"it have been closed. To ensure proper cleanup, use the :meth:`unlink` " +"method." msgstr "" msgid "" "Delete the underlying shared memory block. This should be called only once " "per shared memory block regardless of the number of handles to it, even in " "other processes. :meth:`unlink` and :meth:`close` can be called in any " -"order, but trying to access data inside a shared memory block after :meth:" -"`unlink` may result in memory access errors, depending on platform." +"order, but trying to access data inside a shared memory block " +"after :meth:`unlink` may result in memory access errors, depending on " +"platform." msgstr "" msgid "" @@ -176,9 +177,9 @@ msgid "" msgstr "" msgid "" -"The following example demonstrates a practical use of the :class:" -"`SharedMemory` class with `NumPy arrays `_, accessing " -"the same :class:`!numpy.ndarray` from two distinct Python shells:" +"The following example demonstrates a practical use of " +"the :class:`SharedMemory` class with `NumPy arrays `_, " +"accessing the same :class:`!numpy.ndarray` from two distinct Python shells:" msgstr "" msgid "" @@ -236,13 +237,13 @@ msgid "" "SharedMemoryManager` instance causes a new process to be started. This new " "process's sole purpose is to manage the life cycle of all shared memory " "blocks created through it. To trigger the release of all shared memory " -"blocks managed by that process, call :meth:`~multiprocessing.managers." -"BaseManager.shutdown` on the instance. This triggers a :meth:" -"`~multiprocessing.shared_memory.SharedMemory.unlink` call on all of the :" -"class:`SharedMemory` objects managed by that process and then stops the " -"process itself. By creating :class:`!SharedMemory` instances through a :" -"class:`!SharedMemoryManager`, we avoid the need to manually track and " -"trigger the freeing of shared memory resources." +"blocks managed by that process, " +"call :meth:`~multiprocessing.managers.BaseManager.shutdown` on the instance. " +"This triggers a :meth:`~multiprocessing.shared_memory.SharedMemory.unlink` " +"call on all of the :class:`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 "" @@ -269,8 +270,8 @@ msgid "" msgstr "" msgid "" -"The following example demonstrates the basic mechanisms of a :class:" -"`~multiprocessing.managers.SharedMemoryManager`:" +"The following example demonstrates the basic mechanisms of " +"a :class:`~multiprocessing.managers.SharedMemoryManager`:" msgstr "" msgid "" @@ -309,8 +310,8 @@ msgid "" msgstr "" msgid "" -"When using a :class:`~multiprocessing.managers.SharedMemoryManager` in a :" -"keyword:`with` statement, the shared memory blocks created using that " +"When using a :class:`~multiprocessing.managers.SharedMemoryManager` in " +"a :keyword:`with` statement, the shared memory blocks created using that " "manager are all released when the :keyword:`!with` statement's code block " "finishes execution." msgstr "" @@ -354,16 +355,16 @@ msgstr "" msgid "" "*name* is the unique name for the requested shared memory, as described in " -"the definition for :class:`SharedMemory`. When attaching to an existing :" -"class:`!ShareableList`, specify its shared memory block's unique name while " -"leaving *sequence* set to ``None``." +"the definition for :class:`SharedMemory`. When attaching to an " +"existing :class:`!ShareableList`, specify its shared memory block's unique " +"name while leaving *sequence* set to ``None``." msgstr "" msgid "" "A known issue exists for :class:`bytes` and :class:`str` values. If they end " "with ``\\x00`` nul bytes or characters, those may be *silently stripped* " -"when fetching them by index from the :class:`!ShareableList`. This ``." -"rstrip(b'\\x00')`` behavior is considered a bug and may go away in the " +"when fetching them by index from the :class:`!ShareableList`. This " +"``.rstrip(b'\\x00')`` behavior is considered a bug and may go away in the " "future. See :gh:`106939`." msgstr "" diff --git a/library/netrc.po b/library/netrc.po index 955cec0365..6c84568380 100644 --- a/library/netrc.po +++ b/library/netrc.po @@ -42,20 +42,20 @@ msgid "" "be read. Otherwise, a :exc:`FileNotFoundError` exception will be raised. " "Parse errors will raise :exc:`NetrcParseError` with diagnostic information " "including the file name, line number, and terminating token. If no argument " -"is specified on a POSIX system, the presence of passwords in the :file:`." -"netrc` file will raise a :exc:`NetrcParseError` if the file ownership or " -"permissions are insecure (owned by a user other than the user running the " -"process, or accessible for read or write by any other user). This implements " -"security behavior equivalent to that of ftp and other programs that use :" -"file:`.netrc`." +"is specified on a POSIX system, the presence of passwords in " +"the :file:`.netrc` file will raise a :exc:`NetrcParseError` if the file " +"ownership or permissions are insecure (owned by a user other than the user " +"running the process, or accessible for read or write by any other user). " +"This implements security behavior equivalent to that of ftp and other " +"programs that use :file:`.netrc`." msgstr "" msgid "Added the POSIX permission check." msgstr "" msgid "" -":func:`os.path.expanduser` is used to find the location of the :file:`." -"netrc` file when *file* is not passed as argument." +":func:`os.path.expanduser` is used to find the location of " +"the :file:`.netrc` file when *file* is not passed as argument." msgstr "" msgid "" @@ -70,9 +70,9 @@ msgstr "" msgid "" "Exception raised by the :class:`~netrc.netrc` class when syntactical errors " "are encountered in source text. Instances of this exception provide three " -"interesting attributes: :attr:`msg` is a textual explanation of the error, :" -"attr:`filename` is the name of the source file, and :attr:`lineno` gives the " -"line number on which the error was found." +"interesting attributes: :attr:`msg` is a textual explanation of the " +"error, :attr:`filename` is the name of the source file, and :attr:`lineno` " +"gives the line number on which the error was found." msgstr "" msgid "netrc Objects" diff --git a/library/numbers.po b/library/numbers.po index c1f80a47d9..605dc75e86 100644 --- a/library/numbers.po +++ b/library/numbers.po @@ -30,10 +30,10 @@ msgid "**Source code:** :source:`Lib/numbers.py`" msgstr "" msgid "" -"The :mod:`numbers` module (:pep:`3141`) defines a hierarchy of numeric :term:" -"`abstract base classes ` which progressively define " -"more operations. None of the types defined in this module are intended to " -"be instantiated." +"The :mod:`numbers` module (:pep:`3141`) defines a hierarchy of " +"numeric :term:`abstract base classes ` which " +"progressively define more operations. None of the types defined in this " +"module are intended to be instantiated." msgstr "" msgid "" @@ -46,9 +46,9 @@ msgstr "" msgid "" "Subclasses of this type describe complex numbers and include the operations " -"that work on the built-in :class:`complex` type. These are: conversions to :" -"class:`complex` and :class:`bool`, :attr:`.real`, :attr:`.imag`, ``+``, ``-" -"``, ``*``, ``/``, ``**``, :func:`abs`, :meth:`conjugate`, ``==``, and ``!" +"that work on the built-in :class:`complex` type. These are: conversions " +"to :class:`complex` and :class:`bool`, :attr:`.real`, :attr:`.imag`, ``+``, " +"``-``, ``*``, ``/``, ``**``, :func:`abs`, :meth:`conjugate`, ``==``, and ``!" "=``. All except ``-`` and ``!=`` are abstract." msgstr "" @@ -69,26 +69,27 @@ msgid "" msgstr "" msgid "" -"In short, those are: a conversion to :class:`float`, :func:`math.trunc`, :" -"func:`round`, :func:`math.floor`, :func:`math.ceil`, :func:`divmod`, ``//``, " -"``%``, ``<``, ``<=``, ``>``, and ``>=``." +"In short, those are: a conversion " +"to :class:`float`, :func:`math.trunc`, :func:`round`, :func:`math.floor`, :func:`math.ceil`, :func:`divmod`, " +"``//``, ``%``, ``<``, ``<=``, ``>``, and ``>=``." msgstr "" msgid "" -"Real also provides defaults for :func:`complex`, :attr:`~Complex.real`, :" -"attr:`~Complex.imag`, and :meth:`~Complex.conjugate`." +"Real also provides defaults " +"for :func:`complex`, :attr:`~Complex.real`, :attr:`~Complex.imag`, " +"and :meth:`~Complex.conjugate`." msgstr "" msgid "" -"Subtypes :class:`Real` and adds :attr:`~Rational.numerator` and :attr:" -"`~Rational.denominator` properties. It also provides a default for :func:" -"`float`." +"Subtypes :class:`Real` and adds :attr:`~Rational.numerator` " +"and :attr:`~Rational.denominator` properties. It also provides a default " +"for :func:`float`." msgstr "" msgid "" "The :attr:`~Rational.numerator` and :attr:`~Rational.denominator` values " -"should be instances of :class:`Integral` and should be in lowest terms with :" -"attr:`~Rational.denominator` positive." +"should be instances of :class:`Integral` and should be in lowest terms " +"with :attr:`~Rational.denominator` positive." msgstr "" msgid "Abstract." @@ -96,9 +97,10 @@ msgstr "" msgid "" "Subtypes :class:`Rational` and adds a conversion to :class:`int`. Provides " -"defaults for :func:`float`, :attr:`~Rational.numerator`, and :attr:" -"`~Rational.denominator`. Adds abstract methods for :func:`pow` with modulus " -"and bit-string operations: ``<<``, ``>>``, ``&``, ``^``, ``|``, ``~``." +"defaults for :func:`float`, :attr:`~Rational.numerator`, " +"and :attr:`~Rational.denominator`. Adds abstract methods for :func:`pow` " +"with modulus and bit-string operations: ``<<``, ``>>``, ``&``, ``^``, ``|``, " +"``~``." msgstr "" msgid "Notes for type implementors" @@ -107,8 +109,8 @@ msgstr "" msgid "" "Implementors should be careful to make equal numbers equal and hash them to " "the same values. This may be subtle if there are two different extensions of " -"the real numbers. For example, :class:`fractions.Fraction` implements :func:" -"`hash` as follows::" +"the real numbers. For example, :class:`fractions.Fraction` " +"implements :func:`hash` as follows::" msgstr "" msgid "Adding More Numeric ABCs" @@ -132,10 +134,10 @@ msgid "" msgstr "" msgid "" -"There are 5 different cases for a mixed-type operation on subclasses of :" -"class:`Complex`. I'll refer to all of the above code that doesn't refer to " -"``MyIntegral`` and ``OtherTypeIKnowAbout`` as \"boilerplate\". ``a`` will be " -"an instance of ``A``, which is a subtype of :class:`Complex` (``a : A <: " +"There are 5 different cases for a mixed-type operation on subclasses " +"of :class:`Complex`. I'll refer to all of the above code that doesn't refer " +"to ``MyIntegral`` and ``OtherTypeIKnowAbout`` as \"boilerplate\". ``a`` will " +"be an instance of ``A``, which is a subtype of :class:`Complex` (``a : A <: " "Complex``), and ``b : B <: Complex``. I'll consider ``a + b``:" msgstr "" @@ -145,9 +147,9 @@ msgstr "" msgid "" "If ``A`` falls back to the boilerplate code, and it were to return a value " "from :meth:`__add__`, we'd miss the possibility that ``B`` defines a more " -"intelligent :meth:`__radd__`, so the boilerplate should return :const:" -"`NotImplemented` from :meth:`__add__`. (Or ``A`` may not implement :meth:" -"`__add__` at all.)" +"intelligent :meth:`__radd__`, so the boilerplate should " +"return :const:`NotImplemented` from :meth:`__add__`. (Or ``A`` may not " +"implement :meth:`__add__` at all.)" msgstr "" msgid "" @@ -168,13 +170,14 @@ msgstr "" msgid "" "If ``A <: Complex`` and ``B <: Real`` without sharing any other knowledge, " -"then the appropriate shared operation is the one involving the built in :" -"class:`complex`, and both :meth:`__radd__` s land there, so ``a+b == b+a``." +"then the appropriate shared operation is the one involving the built " +"in :class:`complex`, and both :meth:`__radd__` s land there, so ``a+b == " +"b+a``." msgstr "" msgid "" "Because most of the operations on any given type will be very similar, it " "can be useful to define a helper function which generates the forward and " -"reverse instances of any given operator. For example, :class:`fractions." -"Fraction` uses::" +"reverse instances of any given operator. For " +"example, :class:`fractions.Fraction` uses::" msgstr "" diff --git a/library/numeric.po b/library/numeric.po index 8e91420f18..1ce26924e9 100644 --- a/library/numeric.po +++ b/library/numeric.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Krzysztof Abramowicz, 2022\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,8 +30,8 @@ msgid "" "The modules described in this chapter provide numeric and math-related " "functions and data types. The :mod:`numbers` module defines an abstract " "hierarchy of numeric types. The :mod:`math` and :mod:`cmath` modules contain " -"various mathematical functions for floating-point and complex numbers. The :" -"mod:`decimal` module supports exact representations of decimal numbers, " +"various mathematical functions for floating-point and complex numbers. " +"The :mod:`decimal` module supports exact representations of decimal numbers, " "using arbitrary precision arithmetic." msgstr "" diff --git a/library/operator.po b/library/operator.po index 961c3f0010..8813ebd242 100644 --- a/library/operator.po +++ b/library/operator.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2024 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,16 +27,16 @@ msgid ":mod:`!operator` --- Standard operators as functions" msgstr "" msgid "**Source code:** :source:`Lib/operator.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/operator.py`" msgid "" "The :mod:`operator` module exports a set of efficient functions " -"corresponding to the intrinsic operators of Python. For example, ``operator." -"add(x, y)`` is equivalent to the expression ``x+y``. Many function names are " -"those used for special methods, without the double underscores. For " -"backward compatibility, many of these have a variant with the double " -"underscores kept. The variants without the double underscores are preferred " -"for clarity." +"corresponding to the intrinsic operators of Python. For example, " +"``operator.add(x, y)`` is equivalent to the expression ``x+y``. Many " +"function names are those used for special methods, without the double " +"underscores. For backward compatibility, many of these have a variant with " +"the double underscores kept. The variants without the double underscores are " +"preferred for clarity." msgstr "" msgid "" @@ -57,8 +55,8 @@ msgid "" "``eq(a, b)`` is equivalent to ``a == b``, ``ne(a, b)`` is equivalent to ``a !" "= b``, ``gt(a, b)`` is equivalent to ``a > b`` and ``ge(a, b)`` is " "equivalent to ``a >= b``. Note that these functions can return any value, " -"which may or may not be interpretable as a Boolean value. See :ref:" -"`comparisons` for more information about rich comparisons." +"which may or may not be interpretable as a Boolean value. " +"See :ref:`comparisons` for more information about rich comparisons." msgstr "" msgid "" @@ -69,8 +67,8 @@ msgstr "" msgid "" "Return the outcome of :keyword:`not` *obj*. (Note that there is no :meth:`!" "__not__` method for object instances; only the interpreter core defines this " -"operation. The result is affected by the :meth:`~object.__bool__` and :meth:" -"`~object.__len__` methods.)" +"operation. The result is affected by the :meth:`~object.__bool__` " +"and :meth:`~object.__len__` methods.)" msgstr "" msgid "" @@ -93,7 +91,7 @@ msgstr "" msgid "Return ``a + b``, for *a* and *b* numbers." msgstr "" -msgid "Return the bitwise and of *a* and *b*." +msgid "Return ``a & b``." msgstr "" msgid "Return ``a // b``." @@ -107,18 +105,16 @@ msgid "" "have been an instance of a subclass of ``int``." msgstr "" -msgid "" -"Return the bitwise inverse of the number *obj*. This is equivalent to " -"``~obj``." +msgid "Return ``~obj``." msgstr "" -msgid "Return *a* shifted left by *b*." +msgid "Return ``a << b``." msgstr "" msgid "Return ``a % b``." msgstr "" -msgid "Return ``a * b``, for *a* and *b* numbers." +msgid "Return ``a * b``." msgstr "" msgid "Return ``a @ b``." @@ -127,16 +123,16 @@ msgstr "" msgid "Return *obj* negated (``-obj``)." msgstr "" -msgid "Return the bitwise or of *a* and *b*." +msgid "Return ``a | b``." msgstr "" -msgid "Return *obj* positive (``+obj``)." +msgid "Return ``+obj``." msgstr "" -msgid "Return ``a ** b``, for *a* and *b* numbers." +msgid "Return ``a ** b``." msgstr "" -msgid "Return *a* shifted right by *b*." +msgid "Return ``a >> b``." msgstr "" msgid "Return ``a - b``." @@ -147,7 +143,7 @@ msgid "" "\"true\" division." msgstr "" -msgid "Return the bitwise exclusive or of *a* and *b*." +msgid "Return ``a ^ b``." msgstr "" msgid "" @@ -205,8 +201,8 @@ msgid "After ``f = attrgetter('name')``, the call ``f(b)`` returns ``b.name``." msgstr "" msgid "" -"After ``f = attrgetter('name', 'date')``, the call ``f(b)`` returns ``(b." -"name, b.date)``." +"After ``f = attrgetter('name', 'date')``, the call ``f(b)`` returns " +"``(b.name, b.date)``." msgstr "" msgid "" @@ -263,9 +259,10 @@ msgid "" msgstr "" msgid "" -"The items can be any type accepted by the operand's :meth:`~object." -"__getitem__` method. Dictionaries accept any :term:`hashable` value. " -"Lists, tuples, and strings accept an index or a slice:" +"The items can be any type accepted by the " +"operand's :meth:`~object.__getitem__` method. Dictionaries accept " +"any :term:`hashable` value. Lists, tuples, and strings accept an index or a " +"slice:" msgstr "" msgid "" @@ -325,7 +322,7 @@ msgid "Concatenation" msgstr "" msgid "``seq1 + seq2``" -msgstr "" +msgstr "``seq1 + seq2``" msgid "``concat(seq1, seq2)``" msgstr "``concat(seq1, seq2)``" @@ -334,7 +331,7 @@ msgid "Containment Test" msgstr "" msgid "``obj in seq``" -msgstr "" +msgstr "``obj in seq``" msgid "``contains(seq, obj)``" msgstr "``contains(seq, obj)``" @@ -354,7 +351,7 @@ msgstr "``a // b``" msgid "``floordiv(a, b)``" msgstr "``floordiv(a, b)``" -msgid "Bitwise And" +msgid "Bitwise And, or Intersection" msgstr "" msgid "``a & b``" @@ -363,7 +360,7 @@ msgstr "``a & b``" msgid "``and_(a, b)``" msgstr "``and_(a, b)``" -msgid "Bitwise Exclusive Or" +msgid "Bitwise Exclusive Or, or Symmetric Difference" msgstr "" msgid "``a ^ b``" @@ -372,7 +369,7 @@ msgstr "``a ^ b``" msgid "``xor(a, b)``" msgstr "``xor(a, b)``" -msgid "Bitwise Inversion" +msgid "Bitwise Inversion, or Complement" msgstr "" msgid "``~ a``" @@ -381,7 +378,7 @@ msgstr "``~ a``" msgid "``invert(a)``" msgstr "``invert(a)``" -msgid "Bitwise Or" +msgid "Bitwise Or, or Union" msgstr "" msgid "``a | b``" diff --git a/library/optparse.po b/library/optparse.po index 20ba235ee3..b29ae34fdf 100644 --- a/library/optparse.po +++ b/library/optparse.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Igor Zubrycki , 2023 -# Rafael Fontenelle , 2024 -# Seweryn Piórkowski , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,7 +27,7 @@ msgid ":mod:`!optparse` --- Parser for command line options" msgstr "" msgid "**Source code:** :source:`Lib/optparse.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/optparse.py`" msgid "Choosing an argument parsing library" msgstr "" @@ -61,10 +57,10 @@ msgid "" msgstr "" msgid "" -"In the absence of more specific argument parsing design constraints, :mod:" -"`argparse` is the recommended choice for implementing command line " -"applications, as it offers the highest level of baseline functionality with " -"the least application level code." +"In the absence of more specific argument parsing design " +"constraints, :mod:`argparse` is the recommended choice for implementing " +"command line applications, as it offers the highest level of baseline " +"functionality with the least application level code." msgstr "" msgid "" @@ -200,12 +196,12 @@ msgstr "Wprowadzenie" msgid "" ":mod:`optparse` is a more convenient, flexible, and powerful library for " -"parsing command-line options than the minimalist :mod:`getopt` module. :mod:" -"`optparse` uses a more declarative style of command-line parsing: you create " -"an instance of :class:`OptionParser`, populate it with options, and parse " -"the command line. :mod:`optparse` allows users to specify options in the " -"conventional GNU/POSIX syntax, and additionally generates usage and help " -"messages for you." +"parsing command-line options than the minimalist :mod:`getopt` " +"module. :mod:`optparse` uses a more declarative style of command-line " +"parsing: you create an instance of :class:`OptionParser`, populate it with " +"options, and parse the command line. :mod:`optparse` allows users to specify " +"options in the conventional GNU/POSIX syntax, and additionally generates " +"usage and help messages for you." msgstr "" msgid "Here's an example of using :mod:`optparse` in a simple script::" @@ -304,10 +300,10 @@ msgid "" msgstr "" msgid "" -"It is occasionally desirable to substitute an argument list other than ``sys." -"argv[1:]``, so you should read \"argument\" as \"an element of ``sys." -"argv[1:]``, or of some other list provided as a substitute for ``sys." -"argv[1:]``\"." +"It is occasionally desirable to substitute an argument list other than " +"``sys.argv[1:]``, so you should read \"argument\" as \"an element of " +"``sys.argv[1:]``, or of some other list provided as a substitute for " +"``sys.argv[1:]``\"." msgstr "" msgid "option" @@ -316,10 +312,10 @@ msgstr "" msgid "" "an argument used to supply extra information to guide or customize the " "execution of a program. There are many different syntaxes for options; the " -"traditional Unix syntax is a hyphen (\"-\") followed by a single letter, e." -"g. ``-x`` or ``-F``. Also, traditional Unix syntax allows multiple options " -"to be merged into a single argument, e.g. ``-x -F`` is equivalent to ``-" -"xF``. The GNU project introduced ``--`` followed by a series of hyphen-" +"traditional Unix syntax is a hyphen (\"-\") followed by a single letter, " +"e.g. ``-x`` or ``-F``. Also, traditional Unix syntax allows multiple " +"options to be merged into a single argument, e.g. ``-x -F`` is equivalent to " +"``-xF``. The GNU project introduced ``--`` followed by a series of hyphen-" "separated words, e.g. ``--file`` or ``--dry-run``. These are the only two " "option syntaxes provided by :mod:`optparse`." msgstr "" @@ -360,9 +356,9 @@ 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:" +"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 "" @@ -543,8 +539,9 @@ 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." +"refer to *encountering an option* on the command line; in " +"reality, :mod:`optparse` encounters *option strings* and looks up options " +"from them." msgstr "" msgid "" @@ -556,9 +553,9 @@ msgid "(options, args) = parser.parse_args()" msgstr "" msgid "" -"(If you like, you can pass a custom argument list to :meth:`~OptionParser." -"parse_args`, but that's rarely necessary: by default it uses ``sys." -"argv[1:]``.)" +"(If you like, you can pass a custom argument list " +"to :meth:`~OptionParser.parse_args`, but that's rarely necessary: by default " +"it uses ``sys.argv[1:]``.)" msgstr "" msgid ":meth:`~OptionParser.parse_args` returns two values:" @@ -577,9 +574,9 @@ msgstr "" msgid "" "This tutorial section only covers the four most important option " -"attributes: :attr:`~Option.action`, :attr:`~Option.type`, :attr:`~Option." -"dest` (destination), and :attr:`~Option.help`. Of these, :attr:`~Option." -"action` is the most fundamental." +"attributes: :attr:`~Option.action`, :attr:`~Option.type`, :attr:`~Option.dest` " +"(destination), and :attr:`~Option.help`. Of these, :attr:`~Option.action` is " +"the most fundamental." msgstr "" msgid "Understanding option actions" @@ -587,11 +584,11 @@ 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``." +"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 "" @@ -703,8 +700,8 @@ msgstr "" msgid "" "When :mod:`optparse` encounters ``-v`` on the command line, it sets " -"``options.verbose`` to ``True``; when it encounters ``-q``, ``options." -"verbose`` is set to ``False``." +"``options.verbose`` to ``True``; when it encounters ``-q``, " +"``options.verbose`` is set to ``False``." msgstr "" msgid "Other actions" @@ -738,8 +735,8 @@ msgid "call a specified function" msgstr "" msgid "" -"These are covered in section :ref:`optparse-reference-guide`, and section :" -"ref:`optparse-option-callbacks`." +"These are covered in section :ref:`optparse-reference-guide`, and " +"section :ref:`optparse-option-callbacks`." msgstr "" msgid "Default values" @@ -794,8 +791,8 @@ msgstr "" msgid "" "A clearer way to specify default values is the :meth:`set_defaults` method " -"of OptionParser, which you can call at any time before calling :meth:" -"`~OptionParser.parse_args`::" +"of OptionParser, which you can call at any time before " +"calling :meth:`~OptionParser.parse_args`::" msgstr "" msgid "" @@ -901,11 +898,11 @@ 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::" +"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 "-f FILE, --filename=FILE" @@ -953,19 +950,20 @@ msgid "description, optional, is a long description of the group" msgstr "" msgid "" -":class:`OptionGroup` inherits from :class:`OptionContainer` (like :class:" -"`OptionParser`) and so the :meth:`add_option` method can be used to add an " -"option to the group." +":class:`OptionGroup` inherits from :class:`OptionContainer` " +"(like :class:`OptionParser`) and so the :meth:`add_option` method can be " +"used to add an option to the group." msgstr "" msgid "" -"Once all the options are declared, using the :class:`OptionParser` method :" -"meth:`add_option_group` the group is added to the previously defined parser." +"Once all the options are declared, using the :class:`OptionParser` " +"method :meth:`add_option_group` the group is added to the previously defined " +"parser." msgstr "" msgid "" -"Continuing with the parser defined in the previous section, adding an :class:" -"`OptionGroup` to a parser is easy::" +"Continuing with the parser defined in the previous section, adding " +"an :class:`OptionGroup` to a parser is easy::" msgstr "" msgid "" @@ -1054,8 +1052,8 @@ msgstr "" msgid "" "Return the :class:`OptionGroup` to which the short or long option string " -"*opt_str* (e.g. ``'-o'`` or ``'--option'``) belongs. If there's no such :" -"class:`OptionGroup`, return ``None``." +"*opt_str* (e.g. ``'-o'`` or ``'--option'``) belongs. If there's no " +"such :class:`OptionGroup`, return ``None``." msgstr "" msgid "Printing a version string" @@ -1073,10 +1071,10 @@ 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." +"``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``:" @@ -1114,8 +1112,9 @@ msgid "" "about: programmer errors and user errors. Programmer errors are usually " "erroneous calls to :func:`OptionParser.add_option`, e.g. invalid option " "strings, unknown option attributes, missing option attributes, etc. These " -"are dealt with in the usual way: raise an exception (either :exc:`optparse." -"OptionError` or :exc:`TypeError`) and let the program crash." +"are dealt with in the usual way: raise an exception " +"(either :exc:`optparse.OptionError` or :exc:`TypeError`) and let the program " +"crash." msgstr "" msgid "" @@ -1169,14 +1168,14 @@ msgstr "" msgid "" ":mod:`optparse`\\ -generated error messages take care always to mention the " -"option involved in the error; be sure to do the same when calling :func:" -"`OptionParser.error` from your application code." +"option involved in the error; be sure to do the same when " +"calling :func:`OptionParser.error` from your application code." msgstr "" msgid "" "If :mod:`optparse`'s default error-handling behaviour does not suit your " -"needs, you'll need to subclass OptionParser and override its :meth:" -"`~OptionParser.exit` and/or :meth:`~OptionParser.error` methods." +"needs, you'll need to subclass OptionParser and override " +"its :meth:`~OptionParser.exit` and/or :meth:`~OptionParser.error` methods." msgstr "" msgid "Putting it all together" @@ -1318,8 +1317,9 @@ msgstr "" msgid "" "There are several ways to populate the parser with options. The preferred " -"way is by using :meth:`OptionParser.add_option`, as shown in section :ref:" -"`optparse-tutorial`. :meth:`add_option` can be called in one of two ways:" +"way is by using :meth:`OptionParser.add_option`, as shown in " +"section :ref:`optparse-tutorial`. :meth:`add_option` can be called in one " +"of two ways:" msgstr "" msgid "pass it an Option instance (as returned by :func:`make_option`)" @@ -1348,10 +1348,10 @@ msgstr "" msgid "" "(:func:`make_option` is a factory function for creating Option instances; " -"currently it is an alias for the Option constructor. A future version of :" -"mod:`optparse` may split Option into several classes, and :func:" -"`make_option` will pick the right class to instantiate. Do not instantiate " -"Option directly.)" +"currently it is an alias for the Option constructor. A future version " +"of :mod:`optparse` may split Option into several classes, " +"and :func:`make_option` will pick the right class to instantiate. Do not " +"instantiate Option directly.)" msgstr "" msgid "Defining options" @@ -1364,8 +1364,8 @@ msgid "" msgstr "" msgid "" -"The canonical way to create an :class:`Option` instance is with the :meth:" -"`add_option` method of :class:`OptionParser`." +"The canonical way to create an :class:`Option` instance is with " +"the :meth:`add_option` method of :class:`OptionParser`." msgstr "" msgid "To define an option with only a short option string::" @@ -1432,16 +1432,17 @@ msgid "" msgstr "" msgid "" -"As you can see, most actions involve storing or updating a value somewhere. :" -"mod:`optparse` always creates a special object for this, conventionally " -"called ``options``, which is an instance of :class:`optparse.Values`." +"As you can see, most actions involve storing or updating a value " +"somewhere. :mod:`optparse` always creates a special object for this, " +"conventionally called ``options``, which is an instance " +"of :class:`optparse.Values`." msgstr "" msgid "" "An object holding parsed argument names and values as attributes. Normally " "created by calling when calling :meth:`OptionParser.parse_args`, and can be " -"overridden by a custom subclass passed to the *values* argument of :meth:" -"`OptionParser.parse_args` (as described in :ref:`optparse-parsing-" +"overridden by a custom subclass passed to the *values* argument " +"of :meth:`OptionParser.parse_args` (as described in :ref:`optparse-parsing-" "arguments`)." msgstr "" @@ -1506,9 +1507,9 @@ msgid "" msgstr "" msgid "" -"The following option attributes may be passed as keyword arguments to :meth:" -"`OptionParser.add_option`. If you pass an option attribute that is not " -"relevant to a particular option, or fail to pass a required option " +"The following option attributes may be passed as keyword arguments " +"to :meth:`OptionParser.add_option`. If you pass an option attribute that is " +"not relevant to a particular option, or fail to pass a required option " "attribute, :mod:`optparse` raises :exc:`OptionError`." msgstr "" @@ -1550,8 +1551,8 @@ msgstr "" msgid "" "How many arguments of type :attr:`~Option.type` should be consumed when this " -"option is seen. If > 1, :mod:`optparse` will store a tuple of values to :" -"attr:`~Option.dest`." +"option is seen. If > 1, :mod:`optparse` will store a tuple of values " +"to :attr:`~Option.dest`." msgstr "" msgid "For actions that store a constant value, the constant value to store." @@ -1596,14 +1597,14 @@ msgid "" msgstr "" msgid "" -"``\"store\"`` [relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:" -"`~Option.nargs`, :attr:`~Option.choices`]" +"``\"store\"`` " +"[relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:`~Option.nargs`, :attr:`~Option.choices`]" msgstr "" msgid "" "The option must be followed by an argument, which is converted to a value " -"according to :attr:`~Option.type` and stored in :attr:`~Option.dest`. If :" -"attr:`~Option.nargs` > 1, multiple arguments will be consumed from the " +"according to :attr:`~Option.type` and stored in :attr:`~Option.dest`. " +"If :attr:`~Option.nargs` > 1, multiple arguments will be consumed from the " "command line; all will be converted according to :attr:`~Option.type` and " "stored to :attr:`~Option.dest` as a tuple. See the :ref:`optparse-standard-" "option-types` section." @@ -1648,8 +1649,8 @@ msgid "" msgstr "" msgid "" -"``\"store_const\"`` [required: :attr:`~Option.const`; relevant: :attr:" -"`~Option.dest`]" +"``\"store_const\"`` [required: :attr:`~Option.const`; " +"relevant: :attr:`~Option.dest`]" msgstr "" msgid "The value :attr:`~Option.const` is stored in :attr:`~Option.dest`." @@ -1674,8 +1675,8 @@ msgid "``\"store_true\"`` [relevant: :attr:`~Option.dest`]" msgstr "" msgid "" -"A special case of ``\"store_const\"`` that stores ``True`` to :attr:`~Option." -"dest`." +"A special case of ``\"store_const\"`` that stores ``True`` " +"to :attr:`~Option.dest`." msgstr "" msgid "``\"store_false\"`` [relevant: :attr:`~Option.dest`]" @@ -1690,8 +1691,8 @@ msgid "" msgstr "" msgid "" -"``\"append\"`` [relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:" -"`~Option.nargs`, :attr:`~Option.choices`]" +"``\"append\"`` " +"[relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:`~Option.nargs`, :attr:`~Option.choices`]" msgstr "" msgid "" @@ -1745,8 +1746,8 @@ msgid "" msgstr "" msgid "" -"``\"append_const\"`` [required: :attr:`~Option.const`; relevant: :attr:" -"`~Option.dest`]" +"``\"append_const\"`` [required: :attr:`~Option.const`; " +"relevant: :attr:`~Option.dest`]" msgstr "" msgid "" @@ -1785,9 +1786,8 @@ msgid "options.verbosity += 1" msgstr "" msgid "" -"``\"callback\"`` [required: :attr:`~Option.callback`; relevant: :attr:" -"`~Option.type`, :attr:`~Option.nargs`, :attr:`~Option.callback_args`, :attr:" -"`~Option.callback_kwargs`]" +"``\"callback\"`` [required: :attr:`~Option.callback`; " +"relevant: :attr:`~Option.type`, :attr:`~Option.nargs`, :attr:`~Option.callback_args`, :attr:`~Option.callback_kwargs`]" msgstr "" msgid "" @@ -1861,9 +1861,9 @@ msgid "" "Prints the version number supplied to the OptionParser to stdout and exits. " "The version number is actually formatted and printed by the " "``print_version()`` method of OptionParser. Generally only relevant if the " -"``version`` argument is supplied to the OptionParser constructor. As with :" -"attr:`~Option.help` options, you will rarely create ``version`` options, " -"since :mod:`optparse` automatically adds them when needed." +"``version`` argument is supplied to the OptionParser constructor. As " +"with :attr:`~Option.help` options, you will rarely create ``version`` " +"options, since :mod:`optparse` automatically adds them when needed." msgstr "" msgid "Standard option types" @@ -1908,19 +1908,19 @@ msgid "" msgstr "" msgid "" -"``\"choice\"`` options are a subtype of ``\"string\"`` options. The :attr:" -"`~Option.choices` option attribute (a sequence of strings) defines the set " -"of allowed option arguments. :func:`optparse.check_choice` compares user-" -"supplied option arguments against this master list and raises :exc:" -"`OptionValueError` if an invalid string is given." +"``\"choice\"`` options are a subtype of ``\"string\"`` options. " +"The :attr:`~Option.choices` option attribute (a sequence of strings) defines " +"the set of allowed option arguments. :func:`optparse.check_choice` compares " +"user-supplied option arguments against this master list and " +"raises :exc:`OptionValueError` if an invalid string is given." msgstr "" msgid "Parsing arguments" msgstr "Parsowanie argumentów" msgid "" -"The whole point of creating and populating an OptionParser is to call its :" -"meth:`~OptionParser.parse_args` method." +"The whole point of creating and populating an OptionParser is to call " +"its :meth:`~OptionParser.parse_args` method." msgstr "" msgid "Parse the command-line options found in *args*." @@ -2072,8 +2072,8 @@ msgid "``\"error\"`` (default)" msgstr "``\"error\"`` (default)" msgid "" -"assume option conflicts are a programming error and raise :exc:" -"`OptionConflictError`" +"assume option conflicts are a programming error and " +"raise :exc:`OptionConflictError`" msgstr "" msgid "``\"resolve\"``" @@ -2160,8 +2160,8 @@ msgstr "" msgid "" "Print the usage message for the current program (``self.usage``) to *file* " "(default stdout). Any occurrence of the string ``%prog`` in ``self.usage`` " -"is replaced with the name of the current program. Does nothing if ``self." -"usage`` is empty or not defined." +"is replaced with the name of the current program. Does nothing if " +"``self.usage`` is empty or not defined." msgstr "" msgid "" @@ -2170,11 +2170,11 @@ msgid "" msgstr "" msgid "" -"Set default values for several option destinations at once. Using :meth:" -"`set_defaults` is the preferred way to set default values for options, since " -"multiple options can share the same destination. For example, if several " -"\"mode\" options all set the same destination, any one of them can set the " -"default, and the last one wins::" +"Set default values for several option destinations at once. " +"Using :meth:`set_defaults` is the preferred way to set default values for " +"options, since multiple options can share the same destination. For " +"example, if several \"mode\" options all set the same destination, any one " +"of them can set the default, and the last one wins::" msgstr "" msgid "" @@ -2222,10 +2222,10 @@ msgid "Defining a callback option" msgstr "" msgid "" -"As always, the easiest way to define a callback option is by using the :meth:" -"`OptionParser.add_option` method. Apart from :attr:`~Option.action`, the " -"only option attribute you must specify is ``callback``, the function to " -"call::" +"As always, the easiest way to define a callback option is by using " +"the :meth:`OptionParser.add_option` method. Apart " +"from :attr:`~Option.action`, the only option attribute you must specify is " +"``callback``, the function to call::" msgstr "" msgid "parser.add_option(\"-c\", action=\"callback\", callback=my_callback)" @@ -2244,9 +2244,9 @@ msgstr "" msgid "" ":mod:`optparse` always passes four particular arguments to your callback, " -"and it will only pass additional arguments if you specify them via :attr:" -"`~Option.callback_args` and :attr:`~Option.callback_kwargs`. Thus, the " -"minimal callback function signature is::" +"and it will only pass additional arguments if you specify them " +"via :attr:`~Option.callback_args` and :attr:`~Option.callback_kwargs`. " +"Thus, the minimal callback function signature is::" msgstr "" msgid "def my_callback(option, opt, value, parser):" @@ -2265,9 +2265,9 @@ msgstr ":attr:`~Option.type`" msgid "" "has its usual meaning: as with the ``\"store\"`` or ``\"append\"`` actions, " -"it instructs :mod:`optparse` to consume one argument and convert it to :attr:" -"`~Option.type`. Rather than storing the converted value(s) anywhere, " -"though, :mod:`optparse` passes it to your callback function." +"it instructs :mod:`optparse` to consume one argument and convert it " +"to :attr:`~Option.type`. Rather than storing the converted value(s) " +"anywhere, though, :mod:`optparse` passes it to your callback function." msgstr "" msgid ":attr:`~Option.nargs`" @@ -2321,10 +2321,10 @@ msgstr "" msgid "" "is the argument to this option seen on the command-line. :mod:`optparse` " "will only expect an argument if :attr:`~Option.type` is set; the type of " -"``value`` will be the type implied by the option's type. If :attr:`~Option." -"type` for this option is ``None`` (no argument expected), then ``value`` " -"will be ``None``. If :attr:`~Option.nargs` > 1, ``value`` will be a tuple " -"of values of the appropriate type." +"``value`` will be the type implied by the option's type. " +"If :attr:`~Option.type` for this option is ``None`` (no argument expected), " +"then ``value`` will be ``None``. If :attr:`~Option.nargs` > 1, ``value`` " +"will be a tuple of values of the appropriate type." msgstr "" msgid "``parser``" @@ -2342,8 +2342,8 @@ msgid "" "the current list of leftover arguments, ie. arguments that have been " "consumed but are neither options nor option arguments. Feel free to modify " "``parser.largs``, e.g. by adding more arguments to it. (This list will " -"become ``args``, the second return value of :meth:`~OptionParser." -"parse_args`.)" +"become ``args``, the second return value " +"of :meth:`~OptionParser.parse_args`.)" msgstr "" msgid "``parser.rargs``" @@ -2367,16 +2367,16 @@ msgid "" msgstr "" msgid "" -"is a tuple of arbitrary positional arguments supplied via the :attr:`~Option." -"callback_args` option attribute." +"is a tuple of arbitrary positional arguments supplied via " +"the :attr:`~Option.callback_args` option attribute." msgstr "" msgid "``kwargs``" msgstr "``kwargs``" msgid "" -"is a dictionary of arbitrary keyword arguments supplied via :attr:`~Option." -"callback_kwargs`." +"is a dictionary of arbitrary keyword arguments supplied " +"via :attr:`~Option.callback_kwargs`." msgstr "" msgid "Raising errors in a callback" @@ -2482,8 +2482,9 @@ msgid "" "take a fixed number of arguments. Specifying that a callback option takes " "arguments is similar to defining a ``\"store\"`` or ``\"append\"`` option: " "if you define :attr:`~Option.type`, then the option takes one argument that " -"must be convertible to that type; if you further define :attr:`~Option." -"nargs`, then the option takes :attr:`~Option.nargs` arguments." +"must be convertible to that type; if you further " +"define :attr:`~Option.nargs`, then the option takes :attr:`~Option.nargs` " +"arguments." msgstr "" msgid "" @@ -2512,9 +2513,9 @@ 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:" +"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" @@ -2585,15 +2586,15 @@ 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`." +"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." +"A tuple of type names; in your subclass, simply define a new " +"tuple :attr:`TYPES` that builds on the standard one." msgstr "" msgid "" @@ -2663,9 +2664,9 @@ 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.)" +"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 "" @@ -2695,8 +2696,8 @@ msgid "Adding new actions" msgstr "" msgid "" -"Adding new actions is a bit trickier, because you have to understand that :" -"mod:`optparse` has a couple of classifications for actions:" +"Adding new actions is a bit trickier, because you have to understand " +"that :mod:`optparse` has a couple of classifications for actions:" msgstr "" msgid "\"store\" actions" @@ -2704,8 +2705,8 @@ msgstr "" msgid "" "actions that result in :mod:`optparse` storing a value to an attribute of " -"the current OptionValues instance; these options require a :attr:`~Option." -"dest` attribute to be supplied to the Option constructor." +"the current OptionValues instance; these options require " +"a :attr:`~Option.dest` attribute to be supplied to the Option constructor." msgstr "" msgid "\"typed\" actions" @@ -2747,8 +2748,9 @@ msgid "" msgstr "" msgid "" -"In order to actually implement your new action, you must override Option's :" -"meth:`take_action` method and add a case that recognizes your action." +"In order to actually implement your new action, you must override " +"Option's :meth:`take_action` method and add a case that recognizes your " +"action." msgstr "" msgid "" @@ -2794,14 +2796,14 @@ msgstr "" msgid "" "``\"extend\"`` both expects a value on the command-line and stores that " -"value somewhere, so it goes in both :attr:`~Option.STORE_ACTIONS` and :attr:" -"`~Option.TYPED_ACTIONS`." +"value somewhere, so it goes in both :attr:`~Option.STORE_ACTIONS` " +"and :attr:`~Option.TYPED_ACTIONS`." msgstr "" msgid "" "to ensure that :mod:`optparse` assigns the default type of ``\"string\"`` to " -"``\"extend\"`` actions, we put the ``\"extend\"`` action in :attr:`~Option." -"ALWAYS_TYPED_ACTIONS` as well." +"``\"extend\"`` actions, we put the ``\"extend\"`` action " +"in :attr:`~Option.ALWAYS_TYPED_ACTIONS` as well." msgstr "" msgid "" @@ -2827,8 +2829,8 @@ msgid "" "variable to be of a certain type (a list for the first two, an integer for " "the latter). Using :meth:`ensure_value` means that scripts using your " "action don't have to worry about setting a default value for the option " -"destinations in question; they can just leave the default as ``None`` and :" -"meth:`ensure_value` will take care of getting it right when it's needed." +"destinations in question; they can just leave the default as ``None`` " +"and :meth:`ensure_value` will take care of getting it right when it's needed." msgstr "" msgid "Exceptions" diff --git a/library/os.path.po b/library/os.path.po index 2db0d0e5ee..2613c80660 100644 --- a/library/os.path.po +++ b/library/os.path.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,31 +56,48 @@ msgstr "" msgid "" "Since different operating systems have different path name conventions, " -"there are several versions of this module in the standard library. The :mod:" -"`os.path` module is always the path module suitable for the operating system " -"Python is running on, and therefore usable for local paths. However, you " -"can also import and use the individual modules if you want to manipulate a " -"path that is *always* in one of the different formats. They all have the " -"same interface:" +"there are several versions of this module in the standard library. " +"The :mod:`os.path` module is always the path module suitable for the " +"operating system Python is running on, and therefore usable for local " +"paths. However, you can also import and use the individual modules if you " +"want to manipulate a path that is *always* in one of the different formats. " +"They all have the same interface:" msgstr "" -msgid ":mod:`posixpath` for UNIX-style paths" +msgid ":mod:`!posixpath` for UNIX-style paths" msgstr "" -msgid ":mod:`ntpath` for Windows paths" +msgid ":mod:`!ntpath` for Windows paths" msgstr "" msgid "" -":func:`exists`, :func:`lexists`, :func:`isdir`, :func:`isfile`, :func:" -"`islink`, and :func:`ismount` now return ``False`` instead of raising an " -"exception for paths that contain characters or bytes unrepresentable at the " -"OS level." +":func:`exists`, :func:`lexists`, :func:`isdir`, :func:`isfile`, :func:`islink`, " +"and :func:`ismount` now return ``False`` instead of raising an exception for " +"paths that contain characters or bytes unrepresentable at the OS level." msgstr "" msgid "" "Return a normalized absolutized version of the pathname *path*. On most " -"platforms, this is equivalent to calling the function :func:`normpath` as " -"follows: ``normpath(join(os.getcwd(), path))``." +"platforms, this is equivalent to calling ``normpath(join(os.getcwd(), " +"path))``." +msgstr "" + +msgid "" +"On Windows the path is normalized by the operating system, therefore the " +"result can differ from ``normpath(join(os.getcwd(), path))``. A drive-" +"relative path is resolved against the current directory of the specified " +"drive, and the drive letter is capitalized. Trailing dots and spaces are " +"stripped. For example::" +msgstr "" + +msgid "" +">>> os.path.abspath('c:spam')\n" +"'C:\\\\Temp\\\\spam'\n" +">>> os.path.abspath('c:/temp/spam. . .')\n" +"'c:\\\\temp\\\\spam'" +msgstr "" + +msgid ":func:`os.path.join` and :func:`os.path.normpath`." msgstr "" msgid "Accepts a :term:`path-like object`." @@ -110,14 +125,16 @@ msgid "Any iterable can now be passed, rather than just sequences." msgstr "" msgid "" -"Return the longest path prefix (taken character-by-character) that is a " -"prefix of all paths in *list*. If *list* is empty, return the empty string " -"(``''``)." +"Return the longest string prefix (taken character-by-character) that is a " +"prefix of all strings in *list*. If *list* is empty, return the empty " +"string (``''``)." msgstr "" msgid "" "This function may return invalid paths because it works a character at a " -"time. To obtain a valid path, see :func:`commonpath`." +"time. If you need a **common path prefix**, then the algorithm implemented " +"in this function is not secure. Use :func:`commonpath` for finding a common " +"path prefix." msgstr "" msgid "" @@ -153,8 +170,8 @@ msgstr "" msgid "" "Return ``True`` if *path* refers to an existing path, including broken " -"symbolic links. Equivalent to :func:`exists` on platforms lacking :func:" -"`os.lstat`." +"symbolic links. Equivalent to :func:`exists` on platforms " +"lacking :func:`os.lstat`." msgstr "" msgid "" @@ -163,10 +180,11 @@ msgid "" msgstr "" msgid "" -"On Unix, an initial ``~`` is replaced by the environment variable :envvar:" -"`HOME` if it is set; otherwise the current user's home directory is looked " -"up in the password directory through the built-in module :mod:`pwd`. An " -"initial ``~user`` is looked up directly in the password directory." +"On Unix, an initial ``~`` is replaced by the environment " +"variable :envvar:`HOME` if it is set; otherwise the current user's home " +"directory is looked up in the password directory through the built-in " +"module :mod:`pwd`. An initial ``~user`` is looked up directly in the " +"password directory." msgstr "" msgid "" @@ -199,9 +217,9 @@ msgstr "" msgid "" "Return the time of last access of *path*. The return value is a floating-" -"point number giving the number of seconds since the epoch (see the :mod:" -"`time` module). Raise :exc:`OSError` if the file does not exist or is " -"inaccessible." +"point number giving the number of seconds since the epoch (see " +"the :mod:`time` module). Raise :exc:`OSError` if the file does not exist " +"or is inaccessible." msgstr "" msgid "" @@ -230,6 +248,9 @@ msgid "" "drive letter, colon, and (back)slash together." msgstr "" +msgid ":func:`abspath`" +msgstr "" + msgid "" "On Windows, returns ``False`` if the given path starts with exactly one " "(back)slash." @@ -266,9 +287,11 @@ msgid "" "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. It is not able to reliably detect bind " -"mounts on the same filesystem. On Windows, a drive letter root and a share " -"UNC are always mount points, and for any other path ``GetVolumePathName`` is " -"called to see if it is different from the input path." +"mounts on the same filesystem. On Linux systems, it will always return " +"``True`` for btrfs subvolumes, even if they aren't mount points. On Windows, " +"a drive letter root and a share UNC are always mount points, and for any " +"other path ``GetVolumePathName`` is called to see if it is different from " +"the input path." msgstr "" msgid "Added support for detecting non-root mount points on Windows." @@ -320,18 +343,40 @@ msgid "" "concatenation of *path* and all members of *\\*paths*, with exactly one " "directory separator following each non-empty part, except the last. That is, " "the result will only end in a separator if the last part is either empty or " -"ends in a separator. If a segment is an absolute path (which on Windows " -"requires both a drive and a root), then all previous segments are ignored " -"and joining continues from the absolute path segment." +"ends in a separator." +msgstr "" + +msgid "" +"If a segment is an absolute path (which on Windows requires both a drive and " +"a root), then all previous segments are ignored and joining continues from " +"the absolute path segment. On Linux, for example::" +msgstr "" + +msgid "" +">>> os.path.join('/home/foo', 'bar')\n" +"'/home/foo/bar'\n" +">>> os.path.join('/home/foo', '/home/bar')\n" +"'/home/bar'" msgstr "" msgid "" "On Windows, the drive is not reset when a rooted path segment (e.g., " "``r'\\foo'``) is encountered. If a segment is on a different drive or is an " -"absolute path, all previous segments are ignored and the drive is reset. " -"Note that since there is a current directory for each drive, ``os.path." -"join(\"c:\", \"foo\")`` represents a path relative to the current directory " -"on drive :file:`C:` (:file:`c:foo`), not :file:`c:\\\\foo`." +"absolute path, all previous segments are ignored and the drive is reset. For " +"example::" +msgstr "" + +msgid "" +">>> os.path.join('c:\\\\', 'foo')\n" +"'c:\\\\foo'\n" +">>> os.path.join('c:\\\\foo', 'd:\\\\bar')\n" +"'d:\\\\bar'" +msgstr "" + +msgid "" +"Note that since there is a current directory for each drive, " +"``os.path.join(\"c:\", \"foo\")`` represents a path relative to the current " +"directory on drive :file:`C:` (:file:`c:foo`), not :file:`c:\\\\foo`." msgstr "" msgid "Accepts a :term:`path-like object` for *path* and *paths*." @@ -365,13 +410,39 @@ msgid "" "symbolic links encountered in the path (if they are supported by the " "operating system). On Windows, this function will also resolve MS-DOS (also " "called 8.3) style names such as ``C:\\\\PROGRA~1`` to ``C:\\\\Program " -"Files``." +"Files``. The returned path uses the case reported by the operating system, " +"which can differ from the case of *path*, in particular the drive letter is " +"capitalized." +msgstr "" + +msgid "" +"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 a path doesn't exist or a symlink loop is encountered, and *strict* is " -"``True``, :exc:`OSError` is raised. If *strict* is ``False`` these errors " -"are ignored, and so the result might be missing or otherwise inaccessible." +"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 "" @@ -391,6 +462,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 " @@ -421,9 +500,10 @@ msgstr "" msgid "" "Return ``True`` if the stat tuples *stat1* and *stat2* refer to the same " -"file. These structures may have been returned by :func:`os.fstat`, :func:`os." -"lstat`, or :func:`os.stat`. This function implements the underlying " -"comparison used by :func:`samefile` and :func:`sameopenfile`." +"file. These structures may have been returned " +"by :func:`os.fstat`, :func:`os.lstat`, or :func:`os.stat`. This function " +"implements the underlying comparison used by :func:`samefile` " +"and :func:`sameopenfile`." msgstr "" msgid "" @@ -434,8 +514,8 @@ msgid "" "*path* is empty, both *head* and *tail* are empty. Trailing slashes are " "stripped from *head* unless it is the root (one or more slashes only). In " "all cases, ``join(head, tail)`` returns a path to the same location as " -"*path* (but the strings may differ). Also see the functions :func:`dirname` " -"and :func:`basename`." +"*path* (but the strings may differ). Also see the " +"functions :func:`join`, :func:`dirname` and :func:`basename`." msgstr "" msgid "" diff --git a/library/os.po b/library/os.po index e8c4bb02fc..5f36df8721 100644 --- a/library/os.po +++ b/library/os.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:10+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,16 +27,16 @@ msgid ":mod:`!os` --- Miscellaneous operating system interfaces" msgstr "" msgid "**Source code:** :source:`Lib/os.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/os.py`" msgid "" "This module provides a portable way of using operating system dependent " "functionality. If you just want to read or write a file see :func:`open`, " "if you want to manipulate paths, see the :mod:`os.path` module, and if you " -"want to read all the lines in all the files on the command line see the :mod:" -"`fileinput` module. For creating temporary files and directories see the :" -"mod:`tempfile` module, and for high-level file and directory handling see " -"the :mod:`shutil` module." +"want to read all the lines in all the files on the command line see " +"the :mod:`fileinput` module. For creating temporary files and directories " +"see the :mod:`tempfile` module, and for high-level file and directory " +"handling see the :mod:`shutil` module." msgstr "" msgid "Notes on the availability of these functions:" @@ -70,11 +68,11 @@ msgstr "" msgid "" "On WebAssembly platforms, Android and iOS, large parts of the :mod:`os` " -"module are not available or behave differently. APIs related to processes (e." -"g. :func:`~os.fork`, :func:`~os.execve`) and resources (e.g. :func:`~os." -"nice`) are not available. Others like :func:`~os.getuid` and :func:`~os." -"getpid` are emulated or stubs. WebAssembly platforms also lack support for " -"signals (e.g. :func:`~os.kill`, :func:`~os.wait`)." +"module are not available or behave differently. APIs related to processes " +"(e.g. :func:`~os.fork`, :func:`~os.execve`) and resources " +"(e.g. :func:`~os.nice`) are not available. Others like :func:`~os.getuid` " +"and :func:`~os.getpid` are emulated or stubs. WebAssembly platforms also " +"lack support for signals (e.g. :func:`~os.kill`, :func:`~os.wait`)." msgstr "" msgid "" @@ -114,9 +112,9 @@ msgstr "" msgid "" "The :term:`filesystem encoding and error handler` are configured at Python " -"startup by the :c:func:`PyConfig_Read` function: see :c:member:`~PyConfig." -"filesystem_encoding` and :c:member:`~PyConfig.filesystem_errors` members of :" -"c:type:`PyConfig`." +"startup by the :c:func:`PyConfig_Read` function: " +"see :c:member:`~PyConfig.filesystem_encoding` " +"and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" msgid "" @@ -130,8 +128,8 @@ msgstr "" msgid "" "The :term:`file system encoding ` " "must guarantee to successfully decode all bytes below 128. If the file " -"system encoding fails to provide this guarantee, API functions can raise :" -"exc:`UnicodeError`." +"system encoding fails to provide this guarantee, API functions can " +"raise :exc:`UnicodeError`." msgstr "" msgid "See also the :term:`locale encoding`." @@ -175,9 +173,9 @@ msgid "" msgstr "" msgid "" -"Note that the standard stream settings in UTF-8 mode can be overridden by :" -"envvar:`PYTHONIOENCODING` (just as they can be in the default locale-aware " -"mode)." +"Note that the standard stream settings in UTF-8 mode can be overridden " +"by :envvar:`PYTHONIOENCODING` (just as they can be in the default locale-" +"aware mode)." msgstr "" msgid "" @@ -226,8 +224,8 @@ msgid "" msgstr "" msgid "" -"See also the :ref:`UTF-8 mode on Windows ` and the :term:" -"`filesystem encoding and error handler`." +"See also the :ref:`UTF-8 mode on Windows ` and " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid ":pep:`686`" @@ -261,9 +259,9 @@ msgstr "" msgid "" "This mapping is captured the first time the :mod:`os` module is imported, " "typically during Python startup as part of processing :file:`site.py`. " -"Changes to the environment made after this time are not reflected in :data:" -"`os.environ`, except for changes made by modifying :data:`os.environ` " -"directly." +"Changes to the environment made after this time are not reflected " +"in :data:`os.environ`, except for changes made by " +"modifying :data:`os.environ` directly." msgstr "" msgid "" @@ -295,10 +293,10 @@ msgid "" msgstr "" msgid "" -"You can delete items in this mapping to unset environment variables. :func:" -"`unsetenv` will be called automatically when an item is deleted from :data:" -"`os.environ`, and when one of the :meth:`pop` or :meth:`clear` methods is " -"called." +"You can delete items in this mapping to unset environment " +"variables. :func:`unsetenv` will be called automatically when an item is " +"deleted from :data:`os.environ`, and when one of the :meth:`pop` " +"or :meth:`clear` methods is called." msgstr "" msgid "" @@ -307,9 +305,9 @@ msgstr "" msgid "" "Bytes version of :data:`environ`: a :term:`mapping` object where both keys " -"and values are :class:`bytes` objects representing the process environment. :" -"data:`environ` and :data:`environb` are synchronized (modifying :data:" -"`environb` updates :data:`environ`, and vice versa)." +"and values are :class:`bytes` objects representing the process " +"environment. :data:`environ` and :data:`environb` are synchronized " +"(modifying :data:`environb` updates :data:`environ`, and vice versa)." msgstr "" msgid "" @@ -321,8 +319,9 @@ msgid "These functions are described in :ref:`os-file-dir`." msgstr "" msgid "" -"Encode :term:`path-like ` *filename* to the :term:" -"`filesystem encoding and error handler`; return :class:`bytes` unchanged." +"Encode :term:`path-like ` *filename* to " +"the :term:`filesystem encoding and error handler`; return :class:`bytes` " +"unchanged." msgstr "" msgid ":func:`fsdecode` is the reverse function." @@ -334,8 +333,9 @@ msgid "" msgstr "" msgid "" -"Decode the :term:`path-like ` *filename* from the :term:" -"`filesystem encoding and error handler`; return :class:`str` unchanged." +"Decode the :term:`path-like ` *filename* from " +"the :term:`filesystem encoding and error handler`; return :class:`str` " +"unchanged." msgstr "" msgid ":func:`fsencode` is the reverse function." @@ -366,10 +366,10 @@ msgstr "" msgid "" "Return the value of the environment variable *key* as a string if it exists, " -"or *default* if it doesn't. *key* is a string. Note that since :func:" -"`getenv` uses :data:`os.environ`, the mapping of :func:`getenv` is similarly " -"also captured on import, and the function may not reflect future environment " -"changes." +"or *default* if it doesn't. *key* is a string. Note that " +"since :func:`getenv` uses :data:`os.environ`, the mapping of :func:`getenv` " +"is similarly also captured on import, and the function may not reflect " +"future environment changes." msgstr "" msgid "" @@ -380,10 +380,10 @@ msgstr "" msgid "" "Return the value of the environment variable *key* as bytes if it exists, or " -"*default* if it doesn't. *key* must be bytes. Note that since :func:" -"`getenvb` uses :data:`os.environb`, the mapping of :func:`getenvb` is " -"similarly also captured on import, and the function may not reflect future " -"environment changes." +"*default* if it doesn't. *key* must be bytes. Note that " +"since :func:`getenvb` uses :data:`os.environb`, the mapping " +"of :func:`getenvb` is similarly also captured on import, and the function " +"may not reflect future environment changes." msgstr "" msgid "" @@ -436,17 +436,18 @@ msgid "" "access list for the user associated with the effective user id of the " "process; the group access list may change over the lifetime of the process, " "it is not affected by calls to :func:`setgroups`, and its length is not " -"limited to 16. The deployment target value, :const:" -"`MACOSX_DEPLOYMENT_TARGET`, can be obtained with :func:`sysconfig." -"get_config_var`." +"limited to 16. The deployment target " +"value, :const:`MACOSX_DEPLOYMENT_TARGET`, can be obtained " +"with :func:`sysconfig.get_config_var`." msgstr "" msgid "" "Return the name of the user logged in on the controlling terminal of the " -"process. For most purposes, it is more useful to use :func:`getpass." -"getuser` since the latter checks the environment variables :envvar:`LOGNAME` " -"or :envvar:`USERNAME` to find out who the user is, and falls back to ``pwd." -"getpwuid(os.getuid())[0]`` to get the login name of the current real user id." +"process. For most purposes, it is more useful to " +"use :func:`getpass.getuser` since the latter checks the environment " +"variables :envvar:`LOGNAME` or :envvar:`USERNAME` to find out who the user " +"is, and falls back to ``pwd.getpwuid(os.getuid())[0]`` to get the login name " +"of the current real user id." msgstr "" msgid "" @@ -470,13 +471,13 @@ msgid "Added support for Windows." msgstr "Dodane wsparcie dla Windowsa." msgid "" -"Get program scheduling priority. The value *which* is one of :const:" -"`PRIO_PROCESS`, :const:`PRIO_PGRP`, or :const:`PRIO_USER`, and *who* is " -"interpreted relative to *which* (a process identifier for :const:" -"`PRIO_PROCESS`, process group identifier for :const:`PRIO_PGRP`, and a user " -"ID for :const:`PRIO_USER`). A zero value for *who* denotes (respectively) " -"the calling process, the process group of the calling process, or the real " -"user ID of the calling process." +"Get program scheduling priority. The value *which* is one " +"of :const:`PRIO_PROCESS`, :const:`PRIO_PGRP`, or :const:`PRIO_USER`, and " +"*who* is interpreted relative to *which* (a process identifier " +"for :const:`PRIO_PROCESS`, process group identifier for :const:`PRIO_PGRP`, " +"and a user ID for :const:`PRIO_USER`). A zero value for *who* denotes " +"(respectively) the calling process, the process group of the calling " +"process, or the real user ID of the calling process." msgstr "" msgid "" @@ -497,24 +498,24 @@ 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." +"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`." +"changes to the environment affect subprocesses started " +"with :func:`os.system`, :func:`popen` or :func:`fork` and :func:`execv`." msgstr "" msgid "" "Assignments to items in :data:`os.environ` are automatically translated into " "corresponding calls to :func:`putenv`; however, calls to :func:`putenv` " "don't update :data:`os.environ`, so it is actually preferable to assign to " -"items of :data:`os.environ`. This also applies to :func:`getenv` and :func:" -"`getenvb`, which respectively use :data:`os.environ` and :data:`os.environb` " -"in their implementations." +"items of :data:`os.environ`. This also applies to :func:`getenv` " +"and :func:`getenvb`, which respectively use :data:`os.environ` " +"and :data:`os.environb` in their implementations." msgstr "" msgid "" @@ -548,14 +549,15 @@ msgstr "" msgid "" "On macOS, the length of *groups* may not exceed the system-defined maximum " -"number of effective group ids, typically 16. See the documentation for :func:" -"`getgroups` for cases where it may not return the same group list set by " -"calling setgroups()." +"number of effective group ids, typically 16. See the documentation " +"for :func:`getgroups` for cases where it may not return the same group list " +"set by calling setgroups()." msgstr "" msgid "" -"Reassociate the current thread with a Linux namespace. See the :manpage:" -"`setns(2)` and :manpage:`namespaces(7)` man pages for more details." +"Reassociate the current thread with a Linux namespace. See " +"the :manpage:`setns(2)` and :manpage:`namespaces(7)` man pages for more " +"details." msgstr "" msgid "" @@ -567,13 +569,14 @@ msgid "" msgstr "" msgid "" -"Since Linux 5.8, *fd* may refer to a PID file descriptor obtained from :func:" -"`~os.pidfd_open`. In this case, ``setns()`` reassociates the calling thread " -"into one or more of the same namespaces as the thread referred to by *fd*. " -"This is subject to any constraints imposed by *nstype*, which is a bit mask " -"combining one or more of the :ref:`CLONE_NEW* constants `, e.g. ``setns(fd, os.CLONE_NEWUTS | os.CLONE_NEWPID)``. The caller's " -"memberships in unspecified namespaces are left unchanged." +"Since Linux 5.8, *fd* may refer to a PID file descriptor obtained " +"from :func:`~os.pidfd_open`. In this case, ``setns()`` reassociates the " +"calling thread into one or more of the same namespaces as the thread " +"referred to by *fd*. This is subject to any constraints imposed by *nstype*, " +"which is a bit mask combining one or more of the :ref:`CLONE_NEW* constants " +"`, e.g. ``setns(fd, os.CLONE_NEWUTS | " +"os.CLONE_NEWPID)``. The caller's memberships in unspecified namespaces are " +"left unchanged." msgstr "" msgid "" @@ -608,15 +611,15 @@ msgid "" msgstr "" msgid "" -"Set program scheduling priority. The value *which* is one of :const:" -"`PRIO_PROCESS`, :const:`PRIO_PGRP`, or :const:`PRIO_USER`, and *who* is " -"interpreted relative to *which* (a process identifier for :const:" -"`PRIO_PROCESS`, process group identifier for :const:`PRIO_PGRP`, and a user " -"ID for :const:`PRIO_USER`). A zero value for *who* denotes (respectively) " -"the calling process, the process group of the calling process, or the real " -"user ID of the calling process. *priority* is a value in the range -20 to " -"19. The default priority is 0; lower priorities cause more favorable " -"scheduling." +"Set program scheduling priority. The value *which* is one " +"of :const:`PRIO_PROCESS`, :const:`PRIO_PGRP`, or :const:`PRIO_USER`, and " +"*who* is interpreted relative to *which* (a process identifier " +"for :const:`PRIO_PROCESS`, process group identifier for :const:`PRIO_PGRP`, " +"and a user ID for :const:`PRIO_USER`). A zero value for *who* denotes " +"(respectively) the calling process, the process group of the calling " +"process, or the real user ID of the calling process. *priority* is a value " +"in the range -20 to 19. The default priority is 0; lower priorities cause " +"more favorable scheduling." msgstr "" msgid "Set the current process's real and effective group ids." @@ -660,52 +663,59 @@ msgstr "" msgid "" "Returns information identifying the current operating system. The return " -"value is an object with five attributes:" +"value is a :class:`uname_result`." msgstr "" -msgid ":attr:`sysname` - operating system name" -msgstr "" - -msgid ":attr:`nodename` - name of machine on network (implementation-defined)" +msgid "" +"On macOS, iOS and Android, this returns the *kernel* name and release (i.e., " +"``'Darwin'`` on macOS and iOS; ``'Linux'`` on " +"Android). :func:`platform.uname` can be used to get the user-facing " +"operating system name and release on iOS and Android." msgstr "" -msgid ":attr:`release` - operating system release" +msgid ":data:`sys.platform` which has finer granularity." msgstr "" -msgid ":attr:`version` - operating system version" +msgid "" +"Return type changed from a tuple to a tuple-like object with named " +"attributes." msgstr "" -msgid ":attr:`machine` - hardware identifier" +msgid "" +"Name and information about the system returned by :func:`os.uname`. These " +"attributes correspond to the members described in :manpage:`uname(2)`." msgstr "" msgid "" "For backwards compatibility, this object is also iterable, behaving like a " -"five-tuple containing :attr:`sysname`, :attr:`nodename`, :attr:`release`, :" -"attr:`version`, and :attr:`machine` in that order." +"five-tuple " +"containing :attr:`~uname_result.sysname`, :attr:`~uname_result.nodename`, :attr:`~uname_result.release`, :attr:`~uname_result.version`, " +"and :attr:`~uname_result.machine` in that order." msgstr "" -msgid "" -"Some systems truncate :attr:`nodename` to 8 characters or to the leading " -"component; a better way to get the hostname is :func:`socket.gethostname` " -"or even ``socket.gethostbyaddr(socket.gethostname())``." +msgid "Operating system name." msgstr "" msgid "" -"On macOS, iOS and Android, this returns the *kernel* name and version (i.e., " -"``'Darwin'`` on macOS and iOS; ``'Linux'`` on Android). :func:`platform." -"uname` can be used to get the user-facing operating system name and version " -"on iOS and Android." +"Name of machine on network. Some systems " +"truncate :attr:`~uname_result.nodename` to 8 characters or to the leading " +"component; a better way to get the hostname is :func:`socket.gethostname` or " +"even ``socket.gethostbyaddr(socket.gethostname())``." msgstr "" -msgid "" -"Return type changed from a tuple to a tuple-like object with named " -"attributes." +msgid "Operating system release." +msgstr "" + +msgid "Operating system version." +msgstr "" + +msgid "Hardware identifier." msgstr "" msgid "" "Unset (delete) the environment variable named *key*. Such changes to the " -"environment affect subprocesses started with :func:`os.system`, :func:" -"`popen` or :func:`fork` and :func:`execv`." +"environment affect subprocesses started " +"with :func:`os.system`, :func:`popen` or :func:`fork` and :func:`execv`." msgstr "" msgid "" @@ -726,11 +736,11 @@ msgstr "" msgid "" "Disassociate parts of the process execution context, and move them into a " "newly created namespace. See the :manpage:`unshare(2)` man page for more " -"details. The *flags* argument is a bit mask, combining zero or more of the :" -"ref:`CLONE_* constants `, that specifies which parts " -"of the execution context should be unshared from their existing associations " -"and moved to a new namespace. If the *flags* argument is ``0``, no changes " -"are made to the calling process's execution context." +"details. The *flags* argument is a bit mask, combining zero or more of " +"the :ref:`CLONE_* constants `, that specifies which " +"parts of the execution context should be unshared from their existing " +"associations and moved to a new namespace. If the *flags* argument is ``0``, " +"no changes are made to the calling process's execution context." msgstr "" msgid "The :func:`~os.setns` function." @@ -746,8 +756,8 @@ msgid "File Object Creation" msgstr "" msgid "" -"These functions create new :term:`file objects `. (See also :" -"func:`~os.open` for opening file descriptors.)" +"These functions create new :term:`file objects `. (See " +"also :func:`~os.open` for opening file descriptors.)" msgstr "" msgid "" @@ -786,8 +796,8 @@ msgstr "" msgid "" "This function is intended for low-level I/O and must be applied to a file " "descriptor as returned by :func:`os.open` or :func:`pipe`. To close a " -"\"file object\" returned by the built-in function :func:`open` or by :func:" -"`popen` or :func:`fdopen`, use its :meth:`~io.IOBase.close` method." +"\"file object\" returned by the built-in function :func:`open` or " +"by :func:`popen` or :func:`fdopen`, use its :meth:`~io.IOBase.close` method." msgstr "" msgid "" @@ -812,8 +822,8 @@ msgstr "" msgid "" "In Linux kernel older than 5.3, the files pointed to by *src* and *dst* must " -"reside in the same filesystem, otherwise an :exc:`OSError` is raised with :" -"attr:`~OSError.errno` set to :const:`errno.EXDEV`." +"reside in the same filesystem, otherwise an :exc:`OSError` is raised " +"with :attr:`~OSError.errno` set to :const:`errno.EXDEV`." msgstr "" msgid "" @@ -856,8 +866,8 @@ msgid "On Unix, the function now implements the Python UTF-8 Mode." msgstr "" msgid "" -"Return a duplicate of file descriptor *fd*. The new file descriptor is :ref:" -"`non-inheritable `." +"Return a duplicate of file descriptor *fd*. The new file descriptor " +"is :ref:`non-inheritable `." msgstr "" msgid "" @@ -902,8 +912,9 @@ msgstr "" msgid "" "Change the owner and group id of the file given by *fd* to the numeric *uid* " -"and *gid*. To leave one of the ids unchanged, set it to -1. See :func:" -"`chown`. As of Python 3.3, this is equivalent to ``os.chown(fd, uid, gid)``." +"and *gid*. To leave one of the ids unchanged, set it to -1. " +"See :func:`chown`. As of Python 3.3, this is equivalent to ``os.chown(fd, " +"uid, gid)``." msgstr "" msgid "" @@ -916,9 +927,6 @@ msgid "" "of metadata." msgstr "" -msgid "This function is not available on MacOS." -msgstr "Ta funkcja nie jest dostępna w macOS." - msgid "" "Return system configuration information relevant to an open file. *name* " "specifies the configuration value to retrieve; it may be a string which is " @@ -932,8 +940,8 @@ msgstr "" msgid "" "If *name* is a string and is not known, :exc:`ValueError` is raised. If a " "specific value for *name* is not supported by the host system, even if it is " -"included in ``pathconf_names``, an :exc:`OSError` is raised with :const:" -"`errno.EINVAL` for the error number." +"included in ``pathconf_names``, an :exc:`OSError` is raised " +"with :const:`errno.EINVAL` for the error number." msgstr "" msgid "As of Python 3.3, this is equivalent to ``os.pathconf(fd, name)``." @@ -952,8 +960,8 @@ msgstr "" msgid "" "Return information about the filesystem containing the file associated with " -"file descriptor *fd*, like :func:`statvfs`. As of Python 3.3, this is " -"equivalent to ``os.statvfs(fd)``." +"file descriptor *fd* in a :class:`statvfs_result`, like :func:`statvfs`. As " +"of Python 3.3, this is equivalent to ``os.statvfs(fd)``." msgstr "" msgid "" @@ -970,8 +978,8 @@ msgstr "" msgid "" "Truncate the file corresponding to file descriptor *fd*, so that it is at " -"most *length* bytes in size. As of Python 3.3, this is equivalent to ``os." -"truncate(fd, length)``." +"most *length* bytes in size. As of Python 3.3, this is equivalent to " +"``os.truncate(fd, length)``." msgstr "" msgid "" @@ -983,8 +991,8 @@ msgid "Added support for Windows" msgstr "" msgid "" -"Get the blocking mode of the file descriptor: ``False`` if the :data:" -"`O_NONBLOCK` flag is set, ``True`` if the flag is cleared." +"Get the blocking mode of the file descriptor: ``False`` if " +"the :data:`O_NONBLOCK` flag is set, ``True`` if the flag is cleared." msgstr "" msgid "See also :func:`set_blocking` and :meth:`socket.socket.setblocking`." @@ -1012,8 +1020,8 @@ msgstr "" msgid "" "Apply, test or remove a POSIX lock on an open file descriptor. *fd* is an " -"open file descriptor. *cmd* specifies the command to use - one of :data:" -"`F_LOCK`, :data:`F_TLOCK`, :data:`F_ULOCK` or :data:`F_TEST`. *len* " +"open file descriptor. *cmd* specifies the command to use - one " +"of :data:`F_LOCK`, :data:`F_TLOCK`, :data:`F_ULOCK` or :data:`F_TEST`. *len* " "specifies the section of the file to lock." msgstr "" @@ -1121,8 +1129,8 @@ msgstr "" msgid "" "For a description of the flag and mode values, see the C run-time " "documentation; flag constants (like :const:`O_RDONLY` and :const:`O_WRONLY`) " -"are defined in the :mod:`os` module. In particular, on Windows adding :" -"const:`O_BINARY` is needed to open files in binary mode." +"are defined in the :mod:`os` module. In particular, on Windows " +"adding :const:`O_BINARY` is needed to open files in binary mode." msgstr "" msgid "" @@ -1139,9 +1147,9 @@ msgstr "" msgid "" "This function is intended for low-level I/O. For normal usage, use the " -"built-in function :func:`open`, which returns a :term:`file object` with :" -"meth:`~file.read` and :meth:`~file.write` methods (and many more). To wrap " -"a file descriptor in a file object, use :func:`fdopen`." +"built-in function :func:`open`, which returns a :term:`file object` " +"with :meth:`~io.BufferedIOBase.read` and :meth:`~io.BufferedIOBase.write` " +"methods. To wrap a file descriptor in a file object, use :func:`fdopen`." msgstr "" msgid "Added the *dir_fd* parameter." @@ -1149,8 +1157,8 @@ msgstr "" msgid "" "If the system call is interrupted and the signal handler does not raise an " -"exception, the function now retries the system call instead of raising an :" -"exc:`InterruptedError` exception (see :pep:`475` for the rationale)." +"exception, the function now retries the system call instead of raising " +"an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)." msgstr "" "Jeśli wywołanie systemowe zostanie przerwane, a program obsługi sygnału nie " "rzuci wyjątku, funkcji ponawia teraz wywołanie systemowe zamiast rzucenja " @@ -1160,12 +1168,12 @@ msgid "Accepts a :term:`path-like object`." msgstr "" msgid "" -"The following constants are options for the *flags* parameter to the :func:" -"`~os.open` function. They can be combined using the bitwise OR operator ``|" -"``. Some of them are not available on all platforms. For descriptions of " -"their availability and use, consult the :manpage:`open(2)` manual page on " -"Unix or `the MSDN `_ " -"on Windows." +"The following constants are options for the *flags* parameter to " +"the :func:`~os.open` function. They can be combined using the bitwise OR " +"operator ``|``. Some of them are not available on all platforms. For " +"descriptions of their availability and use, consult the :manpage:`open(2)` " +"manual page on Unix or `the MSDN `_ on Windows." msgstr "" msgid "The above constants are available on Unix and Windows." @@ -1184,8 +1192,8 @@ msgid "The above constants are only available on macOS." msgstr "" msgid "" -"Add :data:`O_EVTONLY`, :data:`O_FSYNC`, :data:`O_SYMLINK` and :data:" -"`O_NOFOLLOW_ANY` constants." +"Add :data:`O_EVTONLY`, :data:`O_FSYNC`, :data:`O_SYMLINK` " +"and :data:`O_NOFOLLOW_ANY` constants." msgstr "" msgid "" @@ -1216,9 +1224,9 @@ msgstr "" msgid "" "Create a pipe with *flags* set atomically. *flags* can be constructed by " -"ORing together one or more of these values: :data:`O_NONBLOCK`, :data:" -"`O_CLOEXEC`. Return a pair of file descriptors ``(r, w)`` usable for reading " -"and writing, respectively." +"ORing together one or more of these " +"values: :data:`O_NONBLOCK`, :data:`O_CLOEXEC`. Return a pair of file " +"descriptors ``(r, w)`` usable for reading and writing, respectively." msgstr "" msgid "" @@ -1230,10 +1238,9 @@ msgid "" "Announces an intention to access data in a specific pattern thus allowing " "the kernel to make optimizations. The advice applies to the region of the " "file specified by *fd* starting at *offset* and continuing for *len* bytes. " -"*advice* is one of :data:`POSIX_FADV_NORMAL`, :data:" -"`POSIX_FADV_SEQUENTIAL`, :data:`POSIX_FADV_RANDOM`, :data:" -"`POSIX_FADV_NOREUSE`, :data:`POSIX_FADV_WILLNEED` or :data:" -"`POSIX_FADV_DONTNEED`." +"*advice* is one " +"of :data:`POSIX_FADV_NORMAL`, :data:`POSIX_FADV_SEQUENTIAL`, :data:`POSIX_FADV_RANDOM`, :data:`POSIX_FADV_NOREUSE`, :data:`POSIX_FADV_WILLNEED` " +"or :data:`POSIX_FADV_DONTNEED`." msgstr "" msgid "" @@ -1267,10 +1274,11 @@ msgid "" msgstr "" msgid "" -"Read from a file descriptor *fd* at a position of *offset* into mutable :" -"term:`bytes-like objects ` *buffers*, leaving the file " -"offset unchanged. Transfer data into each buffer until it is full and then " -"move on to the next buffer in the sequence to hold the rest of the data." +"Read from a file descriptor *fd* at a position of *offset* into " +"mutable :term:`bytes-like objects ` *buffers*, leaving " +"the file offset unchanged. Transfer data into each buffer until it is full " +"and then move on to the next buffer in the sequence to hold the rest of the " +"data." msgstr "" msgid "" @@ -1308,8 +1316,8 @@ msgstr "" msgid "" "If some data was successfully read, it will return the number of bytes read. " -"If no bytes were read, it will return ``-1`` and set errno to :const:`errno." -"EAGAIN`." +"If no bytes were read, it will return ``-1`` and set errno " +"to :const:`errno.EAGAIN`." msgstr "" msgid "" @@ -1344,10 +1352,10 @@ msgstr "" msgid "" "Write the *buffers* contents to file descriptor *fd* at an offset *offset*, " -"leaving the file offset unchanged. *buffers* must be a sequence of :term:" -"`bytes-like objects `. Buffers are processed in array " -"order. Entire contents of the first buffer is written before proceeding to " -"the second, and so on." +"leaving the file offset unchanged. *buffers* must be a sequence " +"of :term:`bytes-like objects `. Buffers are processed in " +"array order. Entire contents of the first buffer is written before " +"proceeding to the second, and so on." msgstr "" msgid ":data:`RWF_DSYNC`" @@ -1391,8 +1399,8 @@ 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." +"or :func:`fdopen`, or :data:`sys.stdin`, use its :meth:`~io.TextIOBase.read` " +"or :meth:`~io.IOBase.readline` methods." msgstr "" msgid "" @@ -1402,8 +1410,8 @@ msgid "" msgstr "" msgid "" -"The first function notation is supported by all platforms that define :func:" -"`sendfile`." +"The first function notation is supported by all platforms that " +"define :func:`sendfile`." msgstr "" msgid "" @@ -1434,8 +1442,8 @@ msgid "" msgstr "" msgid "" -"For a higher-level wrapper of :func:`sendfile`, see :meth:`socket.socket." -"sendfile`." +"For a higher-level wrapper of :func:`sendfile`, " +"see :meth:`socket.socket.sendfile`." msgstr "" msgid "Parameters *out* and *in* was renamed to *out_fd* and *in_fd*." @@ -1453,8 +1461,9 @@ msgid "" msgstr "" msgid "" -"Set the blocking mode of the specified file descriptor. Set the :data:" -"`O_NONBLOCK` flag if blocking is ``False``, clear the flag otherwise." +"Set the blocking mode of the specified file descriptor. Set " +"the :data:`O_NONBLOCK` flag if blocking is ``False``, clear the flag " +"otherwise." msgstr "" msgid "See also :func:`get_blocking` and :meth:`socket.socket.setblocking`." @@ -1467,8 +1476,8 @@ msgid "" "is ``None``, then *src* is read from the current position; respectively for " "*offset_dst*. The offset associated to the file descriptor that refers to a " "pipe must be ``None``. The files pointed to by *src* and *dst* must reside " -"in the same filesystem, otherwise an :exc:`OSError` is raised with :attr:" -"`~OSError.errno` set to :const:`errno.EXDEV`." +"in the same filesystem, otherwise an :exc:`OSError` is raised " +"with :attr:`~OSError.errno` set to :const:`errno.EXDEV`." msgstr "" msgid "" @@ -1524,9 +1533,9 @@ msgstr "" msgid "" "This function is intended for low-level I/O and must be applied to a file " "descriptor as returned by :func:`os.open` or :func:`pipe`. To write a " -"\"file object\" returned by the built-in function :func:`open` or by :func:" -"`popen` or :func:`fdopen`, or :data:`sys.stdout` or :data:`sys.stderr`, use " -"its :meth:`~file.write` method." +"\"file object\" returned by the built-in function :func:`open` or " +"by :func:`popen` or :func:`fdopen`, or :data:`sys.stdout` " +"or :data:`sys.stderr`, use its :meth:`~io.TextIOBase.write` method." msgstr "" msgid "" @@ -1584,7 +1593,9 @@ 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." +"the execution of a new program, other file descriptors are inherited. Note " +"that non-inheritable file descriptors are still *inherited* by child " +"processes on :func:`os.fork`." msgstr "" msgid "" @@ -1626,16 +1637,15 @@ msgid "" "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``).)" +"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`." +"this functionality is unavailable, using it will raise " +"a :exc:`NotImplementedError`." msgstr "" msgid "" @@ -1647,7 +1657,7 @@ 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 " +"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``)." @@ -1663,8 +1673,8 @@ 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.)" +"link. For POSIX systems, Python will call the ``l...`` variant of the " +"function." msgstr "" msgid "" @@ -1678,10 +1688,10 @@ msgid "" "operations will use the effective uid/gid, therefore this routine can be " "used in a suid/sgid environment to test if the invoking user has the " "specified access to *path*. *mode* should be :const:`F_OK` to test the " -"existence of *path*, or it can be the inclusive OR of one or more of :const:" -"`R_OK`, :const:`W_OK`, and :const:`X_OK` to test permissions. Return :const:" -"`True` if access is allowed, :const:`False` if not. See the Unix man page :" -"manpage:`access(2)` for more information." +"existence of *path*, or it can be the inclusive OR of one or more " +"of :const:`R_OK`, :const:`W_OK`, and :const:`X_OK` to test permissions. " +"Return :const:`True` if access is allowed, :const:`False` if not. See the " +"Unix man page :manpage:`access(2)` for more information." msgstr "" msgid "" @@ -1749,8 +1759,9 @@ msgid "" msgstr "" msgid "" -"This function can raise :exc:`OSError` and subclasses such as :exc:" -"`FileNotFoundError`, :exc:`PermissionError`, and :exc:`NotADirectoryError`." +"This function can raise :exc:`OSError` and subclasses such " +"as :exc:`FileNotFoundError`, :exc:`PermissionError`, " +"and :exc:`NotADirectoryError`." msgstr "" msgid "" @@ -1758,14 +1769,19 @@ msgid "" "``path``." msgstr "" +msgid "" +"The :func:`contextlib.chdir` context manager, which changes the current " +"working directory on entering and restores the previous one on exit." +msgstr "" + msgid "" "Added support for specifying *path* as a file descriptor on some platforms." msgstr "" msgid "" "Set the flags of *path* to the numeric *flags*. *flags* may take a " -"combination (bitwise OR) of the following values (as defined in the :mod:" -"`stat` module):" +"combination (bitwise OR) of the following values (as defined in " +"the :mod:`stat` module):" msgstr "" msgid ":const:`stat.UF_NODUMP`" @@ -1880,9 +1896,9 @@ msgid ":const:`stat.S_IXOTH`" msgstr ":const:`stat.S_IXOTH`" msgid "" -"This function can support :ref:`specifying a file descriptor `, :" -"ref:`paths relative to directory descriptors ` and :ref:`not " -"following symlinks `." +"This function can support :ref:`specifying a file descriptor " +"`, :ref:`paths relative to directory descriptors ` " +"and :ref:`not following symlinks `." msgstr "" msgid "" @@ -1938,15 +1954,15 @@ msgstr "" msgid "" "Set the flags of *path* to the numeric *flags*, like :func:`chflags`, but do " -"not follow symbolic links. As of Python 3.3, this is equivalent to ``os." -"chflags(path, flags, follow_symlinks=False)``." +"not follow symbolic links. As of Python 3.3, this is equivalent to " +"``os.chflags(path, flags, follow_symlinks=False)``." msgstr "" msgid "" "Change the mode of *path* to the numeric *mode*. If path is a symlink, this " "affects the symlink rather than the target. See the docs for :func:`chmod` " -"for possible values of *mode*. As of Python 3.3, this is equivalent to ``os." -"chmod(path, mode, follow_symlinks=False)``." +"for possible values of *mode*. As of Python 3.3, this is equivalent to " +"``os.chmod(path, mode, follow_symlinks=False)``." msgstr "" msgid "" @@ -1965,8 +1981,8 @@ msgstr "" msgid "" "This function can support specifying *src_dir_fd* and/or *dst_dir_fd* to " -"supply :ref:`paths relative to directory descriptors `, and :ref:" -"`not following symlinks `." +"supply :ref:`paths relative to directory descriptors `, " +"and :ref:`not following symlinks `." msgstr "" msgid "" @@ -2045,10 +2061,10 @@ msgid "" msgstr "" msgid "" -"*volume* must be represented as a GUID path, like those returned by :func:" -"`os.listvolumes`. Volumes may be mounted in multiple locations or not at " -"all. In the latter case, the list will be empty. Mount points that are not " -"associated with a volume will not be returned by this function." +"*volume* must be represented as a GUID path, like those returned " +"by :func:`os.listvolumes`. Volumes may be mounted in multiple locations or " +"not at all. In the latter case, the list will be empty. Mount points that " +"are not associated with a volume will not be returned by this function." msgstr "" msgid "" @@ -2087,13 +2103,13 @@ msgstr "" msgid "" "Perform the equivalent of an :c:func:`!lstat` system call on the given path. " -"Similar to :func:`~os.stat`, but does not follow symbolic links. Return a :" -"class:`stat_result` object." +"Similar to :func:`~os.stat`, but does not follow symbolic links. Return " +"a :class:`stat_result` object." msgstr "" msgid "" -"On platforms that do not support symbolic links, this is an alias for :func:" -"`~os.stat`." +"On platforms that do not support symbolic links, this is an alias " +"for :func:`~os.stat`." msgstr "" msgid "" @@ -2112,8 +2128,8 @@ msgstr "" msgid "" "On Windows, now opens reparse points that represent another path (name " "surrogates), including symbolic links and directory junctions. Other kinds " -"of reparse points are resolved by the operating system as for :func:`~os." -"stat`." +"of reparse points are resolved by the operating system as " +"for :func:`~os.stat`." msgstr "" msgid "Create a directory named *path* with numeric mode *mode*." @@ -2182,10 +2198,10 @@ msgid "Added the *exist_ok* parameter." msgstr "" msgid "" -"Before Python 3.4.1, if *exist_ok* was ``True`` and the directory existed, :" -"func:`makedirs` would still raise an error if *mode* did not match the mode " -"of the existing directory. Since this behavior was impossible to implement " -"safely, it was removed in Python 3.4.1. See :issue:`21082`." +"Before Python 3.4.1, if *exist_ok* was ``True`` and the directory " +"existed, :func:`makedirs` would still raise an error if *mode* did not match " +"the mode of the existing directory. Since this behavior was impossible to " +"implement safely, it was removed in Python 3.4.1. See :issue:`21082`." msgstr "" msgid "" @@ -2210,21 +2226,21 @@ msgstr "" msgid "" "Create a filesystem node (file, device special file or named pipe) named " "*path*. *mode* specifies both the permissions to use and the type of node to " -"be created, being combined (bitwise OR) with one of ``stat.S_IFREG``, ``stat." -"S_IFCHR``, ``stat.S_IFBLK``, and ``stat.S_IFIFO`` (those constants are " -"available in :mod:`stat`). For ``stat.S_IFCHR`` and ``stat.S_IFBLK``, " -"*device* defines the newly created device special file (probably using :func:" -"`os.makedev`), otherwise it is ignored." +"be created, being combined (bitwise OR) with one of ``stat.S_IFREG``, " +"``stat.S_IFCHR``, ``stat.S_IFBLK``, and ``stat.S_IFIFO`` (those constants " +"are available in :mod:`stat`). For ``stat.S_IFCHR`` and ``stat.S_IFBLK``, " +"*device* defines the newly created device special file (probably " +"using :func:`os.makedev`), otherwise it is ignored." msgstr "" msgid "" -"Extract the device major number from a raw device number (usually the :attr:" -"`st_dev` or :attr:`st_rdev` field from :c:struct:`stat`)." +"Extract the device major number from a raw device number (usually " +"the :attr:`st_dev` or :attr:`st_rdev` field from :c:struct:`stat`)." msgstr "" msgid "" -"Extract the device minor number from a raw device number (usually the :attr:" -"`st_dev` or :attr:`st_rdev` field from :c:struct:`stat`)." +"Extract the device minor number from a raw device number (usually " +"the :attr:`st_dev` or :attr:`st_rdev` field from :c:struct:`stat`)." msgstr "" msgid "Compose a raw device number from the major and minor device numbers." @@ -2253,20 +2269,21 @@ msgstr "" msgid "" "Return a string representing the path to which the symbolic link points. " "The result may be either an absolute or relative pathname; if it is " -"relative, it may be converted to an absolute pathname using ``os.path." -"join(os.path.dirname(path), result)``." +"relative, it may be converted to an absolute pathname using " +"``os.path.join(os.path.dirname(path), result)``." msgstr "" msgid "" -"If the *path* is a string object (directly or indirectly through a :class:" -"`PathLike` interface), the result will also be a string object, and the call " -"may raise a UnicodeDecodeError. If the *path* is a bytes object (direct or " -"indirectly), the result will be a bytes object." +"If the *path* is a string object (directly or indirectly through " +"a :class:`PathLike` interface), the result will also be a string object, and " +"the call may raise a UnicodeDecodeError. If the *path* is a bytes object " +"(direct or indirectly), the result will be a bytes object." msgstr "" msgid "" -"When trying to resolve a path that may contain links, use :func:`~os.path." -"realpath` to properly handle recursion and platform differences." +"When trying to resolve a path that may contain links, " +"use :func:`~os.path.realpath` to properly handle recursion and platform " +"differences." msgstr "" msgid "Accepts a :term:`path-like object` on Unix." @@ -2282,9 +2299,9 @@ msgid "" msgstr "" msgid "" -"Remove (delete) the file *path*. If *path* is a directory, an :exc:" -"`OSError` is raised. Use :func:`rmdir` to remove directories. If the file " -"does not exist, a :exc:`FileNotFoundError` is raised." +"Remove (delete) the file *path*. If *path* is a directory, " +"an :exc:`OSError` is raised. Use :func:`rmdir` to remove directories. If " +"the file does not exist, a :exc:`FileNotFoundError` is raised." msgstr "" msgid "" @@ -2325,13 +2342,13 @@ msgstr "" msgid "" "On Windows, if *dst* exists a :exc:`FileExistsError` is always raised. The " -"operation may fail if *src* and *dst* are on different filesystems. Use :" -"func:`shutil.move` to support moves to a different filesystem." +"operation may fail if *src* and *dst* are on different filesystems. " +"Use :func:`shutil.move` to support moves to a different filesystem." msgstr "" msgid "" -"On Unix, if *src* is a file and *dst* is a directory or vice-versa, an :exc:" -"`IsADirectoryError` or a :exc:`NotADirectoryError` will be raised " +"On Unix, if *src* is a file and *dst* is a directory or vice-versa, " +"an :exc:`IsADirectoryError` or a :exc:`NotADirectoryError` will be raised " "respectively. If both are directories and *dst* is empty, *dst* will be " "silently replaced. If *dst* is a non-empty directory, an :exc:`OSError` is " "raised. If both are files, *dst* will be replaced silently if the user has " @@ -2346,8 +2363,8 @@ msgid "" msgstr "" msgid "" -"If you want cross-platform overwriting of the destination, use :func:" -"`replace`." +"If you want cross-platform overwriting of the destination, " +"use :func:`replace`." msgstr "" msgid "" @@ -2385,8 +2402,8 @@ msgstr "" msgid "" "Remove (delete) the directory *path*. If the directory does not exist or is " "not empty, a :exc:`FileNotFoundError` or an :exc:`OSError` is raised " -"respectively. In order to remove whole directory trees, :func:`shutil." -"rmtree` can be used." +"respectively. In order to remove whole directory " +"trees, :func:`shutil.rmtree` can be used." msgstr "" msgid "" @@ -2407,11 +2424,12 @@ msgid "" "Using :func:`scandir` instead of :func:`listdir` can significantly increase " "the performance of code that also needs file type or file attribute " "information, because :class:`os.DirEntry` objects expose this information if " -"the operating system provides it when scanning a directory. All :class:`os." -"DirEntry` methods may perform a system call, but :func:`~os.DirEntry.is_dir` " -"and :func:`~os.DirEntry.is_file` usually only require a system call for " -"symbolic links; :func:`os.DirEntry.stat` always requires a system call on " -"Unix but only requires one for symbolic links on Windows." +"the operating system provides it when scanning a directory. " +"All :class:`os.DirEntry` methods may perform a system call, " +"but :func:`~os.DirEntry.is_dir` and :func:`~os.DirEntry.is_file` usually " +"only require a system call for symbolic links; :func:`os.DirEntry.stat` " +"always requires a system call on Unix but only requires one for symbolic " +"links on Windows." msgstr "" msgid "" @@ -2460,16 +2478,16 @@ msgid "" "pubs.opengroup.org/onlinepubs/009695399/functions/opendir.html>`_ and " "`readdir() `_ functions. On Windows, it uses the Win32 `FindFirstFileW " -"`_ and `FindNextFileW `_ functions." +"`_ and `FindNextFileW `_ functions." msgstr "" msgid "" -"Added support for the :term:`context manager` protocol and the :func:" -"`~scandir.close` method. If a :func:`scandir` iterator is neither exhausted " -"nor explicitly closed a :exc:`ResourceWarning` will be emitted in its " -"destructor." +"Added support for the :term:`context manager` protocol and " +"the :func:`~scandir.close` method. If a :func:`scandir` iterator is neither " +"exhausted nor explicitly closed a :exc:`ResourceWarning` will be emitted in " +"its destructor." msgstr "" msgid "The function accepts a :term:`path-like object`." @@ -2508,6 +2526,11 @@ msgid "" "implements the :class:`PathLike` interface." msgstr "" +msgid "" +":class:`!DirEntry` objects are :ref:`generic ` over the type of " +"the path (:class:`str` or :class:`bytes`)." +msgstr "" + msgid "Attributes and methods on a ``os.DirEntry`` instance are as follows:" msgstr "" @@ -2517,31 +2540,38 @@ msgstr "" msgid "" "The :attr:`name` attribute will be ``bytes`` if the :func:`scandir` *path* " -"argument is of type ``bytes`` and ``str`` otherwise. Use :func:`~os." -"fsdecode` to decode byte filenames." +"argument is of type ``bytes`` and ``str`` otherwise. " +"Use :func:`~os.fsdecode` to decode byte filenames." msgstr "" msgid "" -"The entry's full path name: equivalent to ``os.path.join(scandir_path, entry." -"name)`` where *scandir_path* is the :func:`scandir` *path* argument. The " -"path is only absolute if the :func:`scandir` *path* argument was absolute. " -"If the :func:`scandir` *path* argument was a :ref:`file descriptor " +"The entry's path name: equivalent to ``os.path.join(scandir_path, " +"entry.name)`` where *scandir_path* is the original :func:`scandir` *path* " +"argument. Apart from the filename, the path preserves the " +"original :func:`scandir` argument. If the :func:`scandir` *path* argument " +"was relative, the :attr:`path` attribute is also relative. Changing the " +"current working directory after creating the :func:`scandir` iterator may " +"cause later uses of :attr:`path` to resolve differently. On some platforms, " +"the constructed path may not be valid if the original :func:`scandir` " +"argument was usable for enumeration but not for joining with the entry " +"name. If the :func:`scandir` *path* argument was a :ref:`file descriptor " "`, the :attr:`path` attribute is the same as the :attr:`name` " "attribute." msgstr "" msgid "" "The :attr:`path` attribute will be ``bytes`` if the :func:`scandir` *path* " -"argument is of type ``bytes`` and ``str`` otherwise. Use :func:`~os." -"fsdecode` to decode byte filenames." +"argument is of type ``bytes`` and ``str`` otherwise. " +"Use :func:`~os.fsdecode` to decode byte filenames." msgstr "" msgid "Return the inode number of the entry." msgstr "" msgid "" -"The result is cached on the ``os.DirEntry`` object. Use ``os.stat(entry." -"path, follow_symlinks=False).st_ino`` to fetch up-to-date information." +"The result is cached on the ``os.DirEntry`` object. Use " +"``os.stat(entry.path, follow_symlinks=False).st_ino`` to fetch up-to-date " +"information." msgstr "" msgid "" @@ -2577,8 +2607,8 @@ msgid "" msgstr "" msgid "" -"This method can raise :exc:`OSError`, such as :exc:`PermissionError`, but :" -"exc:`FileNotFoundError` is caught and not raised." +"This method can raise :exc:`OSError`, such as :exc:`PermissionError`, " +"but :exc:`FileNotFoundError` is caught and not raised." msgstr "" msgid "" @@ -2605,8 +2635,8 @@ msgid "" msgstr "" msgid "" -"The result is cached on the ``os.DirEntry`` object. Call :func:`os.path." -"islink` to fetch up-to-date information." +"The result is cached on the ``os.DirEntry`` object. " +"Call :func:`os.path.islink` to fetch up-to-date information." msgstr "" msgid "" @@ -2623,8 +2653,8 @@ msgid "" msgstr "" msgid "" -"The result is cached on the ``os.DirEntry`` object. Call :func:`os.path." -"isjunction` to fetch up-to-date information." +"The result is cached on the ``os.DirEntry`` object. " +"Call :func:`os.path.isjunction` to fetch up-to-date information." msgstr "" msgid "" @@ -2640,8 +2670,8 @@ msgid "" msgstr "" msgid "" -"On Windows, the ``st_ino``, ``st_dev`` and ``st_nlink`` attributes of the :" -"class:`stat_result` are always set to zero. Call :func:`os.stat` to get " +"On Windows, the ``st_ino``, ``st_dev`` and ``st_nlink`` attributes of " +"the :class:`stat_result` are always set to zero. Call :func:`os.stat` to get " "these attributes." msgstr "" @@ -2659,8 +2689,8 @@ msgid "" msgstr "" msgid "" -"Added support for the :class:`~os.PathLike` interface. Added support for :" -"class:`bytes` paths on Windows." +"Added support for the :class:`~os.PathLike` interface. Added support " +"for :class:`bytes` paths on Windows." msgstr "" msgid "" @@ -2671,11 +2701,11 @@ msgid "" msgstr "" msgid "" -"Get the status of a file or a file descriptor. Perform the equivalent of a :" -"c:func:`stat` system call on the given path. *path* may be specified as " -"either a string or bytes -- directly or indirectly through the :class:" -"`PathLike` interface -- or as an open file descriptor. Return a :class:" -"`stat_result` object." +"Get the status of a file or a file descriptor. Perform the equivalent of " +"a :c:func:`stat` system call on the given path. *path* may be specified as " +"either a string or bytes -- directly or indirectly through " +"the :class:`PathLike` interface -- or as an open file descriptor. Return " +"a :class:`stat_result` object." msgstr "" msgid "" @@ -2684,8 +2714,8 @@ msgid "" msgstr "" msgid "" -"This function can support :ref:`specifying a file descriptor ` and :" -"ref:`not following symlinks `." +"This function can support :ref:`specifying a file descriptor ` " +"and :ref:`not following symlinks `." msgstr "" msgid "" @@ -2695,10 +2725,10 @@ msgid "" "the operating system is unable to follow will be opened directly. When " "following a chain of multiple links, this may result in the original link " "being returned instead of the non-link that prevented full traversal. To " -"obtain stat results for the final path in this case, use the :func:`os.path." -"realpath` function to resolve the path name as far as possible and call :" -"func:`lstat` on the result. This does not apply to dangling symlinks or " -"junction points, which will raise the usual exceptions." +"obtain stat results for the final path in this case, use " +"the :func:`os.path.realpath` function to resolve the path name as far as " +"possible and call :func:`lstat` on the result. This does not apply to " +"dangling symlinks or junction points, which will raise the usual exceptions." msgstr "" msgid "Example::" @@ -2733,9 +2763,9 @@ msgid "" msgstr "" msgid "" -"Object whose attributes correspond roughly to the members of the :c:struct:" -"`stat` structure. It is used for the result of :func:`os.stat`, :func:`os." -"fstat` and :func:`os.lstat`." +"Object whose attributes correspond roughly to the members of " +"the :c:struct:`stat` structure. It is used for the result " +"of :func:`os.stat`, :func:`os.fstat` and :func:`os.lstat`." msgstr "" msgid "Attributes:" @@ -2825,24 +2855,25 @@ msgid "" msgstr "" msgid "" -"The exact meaning and resolution of the :attr:`st_atime`, :attr:`st_mtime`, :" -"attr:`st_ctime` and :attr:`st_birthtime` attributes depend on the operating " -"system and the file system. For example, on Windows systems using the FAT32 " -"file systems, :attr:`st_mtime` has 2-second resolution, and :attr:`st_atime` " -"has only 1-day resolution. See your operating system documentation for " -"details." +"The exact meaning and resolution of " +"the :attr:`st_atime`, :attr:`st_mtime`, :attr:`st_ctime` " +"and :attr:`st_birthtime` attributes depend on the operating system and the " +"file system. For example, on Windows systems using the FAT32 file " +"systems, :attr:`st_mtime` has 2-second resolution, and :attr:`st_atime` has " +"only 1-day resolution. See your operating system documentation for details." msgstr "" msgid "" -"Similarly, although :attr:`st_atime_ns`, :attr:`st_mtime_ns`, :attr:" -"`st_ctime_ns` and :attr:`st_birthtime_ns` are always expressed in " -"nanoseconds, many systems do not provide nanosecond precision. On systems " -"that do provide nanosecond precision, the floating-point object used to " -"store :attr:`st_atime`, :attr:`st_mtime`, :attr:`st_ctime` and :attr:" -"`st_birthtime` cannot preserve all of it, and as such will be slightly " -"inexact. If you need the exact timestamps you should always use :attr:" -"`st_atime_ns`, :attr:`st_mtime_ns`, :attr:`st_ctime_ns` and :attr:" -"`st_birthtime_ns`." +"Similarly, " +"although :attr:`st_atime_ns`, :attr:`st_mtime_ns`, :attr:`st_ctime_ns` " +"and :attr:`st_birthtime_ns` are always expressed in nanoseconds, many " +"systems do not provide nanosecond precision. On systems that do provide " +"nanosecond precision, the floating-point object used to " +"store :attr:`st_atime`, :attr:`st_mtime`, :attr:`st_ctime` " +"and :attr:`st_birthtime` cannot preserve all of it, and as such will be " +"slightly inexact. If you need the exact timestamps you should always " +"use :attr:`st_atime_ns`, :attr:`st_mtime_ns`, :attr:`st_ctime_ns` " +"and :attr:`st_birthtime_ns`." msgstr "" msgid "" @@ -2851,8 +2882,8 @@ msgid "" msgstr "" msgid "" -"Number of 512-byte blocks allocated for file. This may be smaller than :attr:" -"`st_size`/512 when the file has holes." +"Number of 512-byte blocks allocated for file. This may be smaller " +"than :attr:`st_size`/512 when the file has holes." msgstr "" msgid "" @@ -2901,15 +2932,15 @@ msgstr "" msgid "" "Windows file attributes: ``dwFileAttributes`` member of the " "``BY_HANDLE_FILE_INFORMATION`` structure returned by :c:func:`!" -"GetFileInformationByHandle`. See the :const:`!FILE_ATTRIBUTE_* ` constants in the :mod:`stat` module." +"GetFileInformationByHandle`. See the :const:`!FILE_ATTRIBUTE_* " +"` constants in the :mod:`stat` module." msgstr "" msgid "" -"When :attr:`st_file_attributes` has the :const:`~stat." -"FILE_ATTRIBUTE_REPARSE_POINT` set, this field contains the tag identifying " -"the type of reparse point. See the :const:`IO_REPARSE_TAG_* ` constants in the :mod:`stat` module." +"When :attr:`st_file_attributes` has " +"the :const:`~stat.FILE_ATTRIBUTE_REPARSE_POINT` set, this field contains the " +"tag identifying the type of reparse point. See the :const:`IO_REPARSE_TAG_* " +"` constants in the :mod:`stat` module." msgstr "" msgid "" @@ -2921,12 +2952,11 @@ msgstr "" msgid "" "For backward compatibility, a :class:`stat_result` instance is also " "accessible as a tuple of at least 10 integers giving the most important (and " -"portable) members of the :c:struct:`stat` structure, in the order :attr:" -"`st_mode`, :attr:`st_ino`, :attr:`st_dev`, :attr:`st_nlink`, :attr:" -"`st_uid`, :attr:`st_gid`, :attr:`st_size`, :attr:`st_atime`, :attr:" -"`st_mtime`, :attr:`st_ctime`. More items may be added at the end by some " -"implementations. For compatibility with older Python versions, accessing :" -"class:`stat_result` as a tuple always returns integers." +"portable) members of the :c:struct:`stat` structure, in the " +"order :attr:`st_mode`, :attr:`st_ino`, :attr:`st_dev`, :attr:`st_nlink`, :attr:`st_uid`, :attr:`st_gid`, :attr:`st_size`, :attr:`st_atime`, :attr:`st_mtime`, :attr:`st_ctime`. " +"More items may be added at the end by some implementations. For " +"compatibility with older Python versions, accessing :class:`stat_result` as " +"a tuple always returns integers." msgstr "" msgid "Windows now returns the file index as :attr:`st_ino` when available." @@ -2939,8 +2969,8 @@ msgid "Added the :attr:`st_reparse_tag` member on Windows." msgstr "" msgid "" -"On Windows, the :attr:`st_mode` member now identifies special files as :" -"const:`S_IFCHR`, :const:`S_IFIFO` or :const:`S_IFBLK` as appropriate." +"On Windows, the :attr:`st_mode` member now identifies special files " +"as :const:`S_IFCHR`, :const:`S_IFIFO` or :const:`S_IFBLK` as appropriate." msgstr "" msgid "" @@ -2964,44 +2994,95 @@ msgid "Added the :attr:`st_birthtime` member on Windows." msgstr "" msgid "" -"Perform a :c:func:`!statvfs` system call on the given path. The return " -"value is an object whose attributes describe the filesystem on the given " -"path, and correspond to the members of the :c:struct:`statvfs` structure, " -"namely: :attr:`f_bsize`, :attr:`f_frsize`, :attr:`f_blocks`, :attr:" -"`f_bfree`, :attr:`f_bavail`, :attr:`f_files`, :attr:`f_ffree`, :attr:" -"`f_favail`, :attr:`f_flag`, :attr:`f_namemax`, :attr:`f_fsid`." +"Perform a :manpage:`statvfs(3)` system call on the given path. The return " +"value is a :class:`statvfs_result` whose attributes describe the filesystem " +"on the given path and correspond to the members of the :c:struct:`statvfs` " +"structure." msgstr "" msgid "" -"Two module-level constants are defined for the :attr:`f_flag` attribute's " -"bit-flags: if :const:`ST_RDONLY` is set, the filesystem is mounted read-" -"only, and if :const:`ST_NOSUID` is set, the semantics of setuid/setgid bits " -"are disabled or not supported." +"Filesystem statistics returned by :func:`os.statvfs` " +"and :func:`os.fstatvfs`. See :manpage:`statvfs(3)` for more details." +msgstr "" + +msgid "Block size." +msgstr "" + +msgid "Fragment size." msgstr "" msgid "" -"Additional module-level constants are defined for GNU/glibc based systems. " -"These are :const:`ST_NODEV` (disallow access to device special files), :" -"const:`ST_NOEXEC` (disallow program execution), :const:`ST_SYNCHRONOUS` " -"(writes are synced at once), :const:`ST_MANDLOCK` (allow mandatory locks on " -"an FS), :const:`ST_WRITE` (write on file/directory/symlink), :const:" -"`ST_APPEND` (append-only file), :const:`ST_IMMUTABLE` (immutable file), :" -"const:`ST_NOATIME` (do not update access times), :const:`ST_NODIRATIME` (do " -"not update directory access times), :const:`ST_RELATIME` (update atime " -"relative to mtime/ctime)." +"Number of :attr:`~statvfs_result.f_frsize` sized blocks the filesystem can " +"contain." +msgstr "" + +msgid "Number of free blocks." +msgstr "" + +msgid "Number of free blocks for unprivileged users." +msgstr "" + +msgid "Number of file entries, inodes, the filesystem can contain." +msgstr "" + +msgid "Number of free files entries." msgstr "" -msgid "The :const:`ST_RDONLY` and :const:`ST_NOSUID` constants were added." +msgid "Number of free file entries for unprivileged users." 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." +"Bit-mask of mount flags. The following flags are " +"defined: :data:`ST_RDONLY`, :data:`ST_NOSUID`, :data:`ST_NODEV`, :data:`ST_NOEXEC`, :data:`ST_SYNCHRONOUS`, :data:`ST_MANDLOCK`, :data:`ST_WRITE`, :data:`ST_APPEND`, :data:`ST_IMMUTABLE`, :data:`ST_NOATIME`, :data:`ST_NODIRATIME`, " +"and :data:`ST_RELATIME`." +msgstr "" + +msgid "" +"Filesystem max filename length. OS specific limitations such " +"as :ref:`Windows MAX_PATH ` and those described in " +"Linux :manpage:`pathname(7)` may exist." +msgstr "" + +msgid "Filesystem ID." +msgstr "" + +msgid "The following flags are used in :attr:`statvfs_result.f_flag`." +msgstr "" + +msgid "Read-only filesystem." +msgstr "" + +msgid "Setuid/setgid bits are disabled or not supported." +msgstr "" + +msgid "Disallow access to device special files." +msgstr "" + +msgid "Disallow program execution." +msgstr "" + +msgid "Writes are synced at once." +msgstr "" + +msgid "Allow mandatory locks on an FS." msgstr "" -msgid "Added the :attr:`f_fsid` attribute." +msgid "Write on file/directory/symlink." +msgstr "" + +msgid "Append-only file." +msgstr "" + +msgid "Immutable file." +msgstr "" + +msgid "Do not update access times." +msgstr "" + +msgid "Do not update directory access times." +msgstr "" + +msgid "Update atime relative to mtime/ctime." msgstr "" msgid "" @@ -3034,8 +3115,8 @@ msgid "" "A :class:`set` object indicating whether :func:`os.access` permits " "specifying ``True`` for its *effective_ids* parameter on the local platform. " "(Specifying ``False`` for *effective_ids* is always supported on all " -"platforms.) If the local platform supports it, the collection will contain :" -"func:`os.access`; otherwise it will be empty." +"platforms.) If the local platform supports it, the collection will " +"contain :func:`os.access`; otherwise it will be empty." msgstr "" msgid "" @@ -3062,8 +3143,8 @@ msgstr "" msgid "" "To determine whether a particular function permits specifying an open file " "descriptor for its *path* parameter, use the ``in`` operator on " -"``supports_fd``. As an example, this expression evaluates to ``True`` if :" -"func:`os.chdir` accepts open file descriptors for *path* on your local " +"``supports_fd``. As an example, this expression evaluates to ``True`` " +"if :func:`os.chdir` accepts open file descriptors for *path* on your local " "platform::" msgstr "" @@ -3086,8 +3167,8 @@ msgid "" "To check whether a particular function accepts ``False`` for its " "*follow_symlinks* parameter, use the ``in`` operator on " "``supports_follow_symlinks``. As an example, this expression evaluates to " -"``True`` if you may specify ``follow_symlinks=False`` when calling :func:`os." -"stat` on the local platform::" +"``True`` if you may specify ``follow_symlinks=False`` when " +"calling :func:`os.stat` on the local platform::" msgstr "" msgid "os.stat in os.supports_follow_symlinks" @@ -3096,6 +3177,11 @@ msgstr "" msgid "Create a symbolic link pointing to *src* named *dst*." msgstr "" +msgid "" +"The *src* parameter refers to the target of the link (the file or directory " +"being linked to), and *dst* is the name of the link being created." +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 " @@ -3175,12 +3261,12 @@ msgid "It is an error to specify tuples for both *times* and *ns*." msgstr "" msgid "" -"Note that the exact times you set here may not be returned by a subsequent :" -"func:`~os.stat` call, depending on the resolution with which your operating " -"system records access and modification times; see :func:`~os.stat`. The best " -"way to preserve exact times is to use the *st_atime_ns* and *st_mtime_ns* " -"fields from the :func:`os.stat` result object with the *ns* parameter to :" -"func:`utime`." +"Note that the exact times you set here may not be returned by a " +"subsequent :func:`~os.stat` call, depending on the resolution with which " +"your operating system records access and modification times; " +"see :func:`~os.stat`. The best way to preserve exact times is to use the " +"*st_atime_ns* and *st_mtime_ns* fields from the :func:`os.stat` result " +"object with the *ns* parameter to :func:`utime`." msgstr "" msgid "" @@ -3335,9 +3421,9 @@ msgstr "" msgid "" "import os\n" "for root, dirs, files, rootfd in os.fwalk('python/Lib/xml'):\n" -" print(root, \"consumes\", end=\"\")\n" +" print(root, \"consumes\", end=\" \")\n" " print(sum([os.stat(name, dir_fd=rootfd).st_size for name in files]),\n" -" end=\"\")\n" +" end=\" \")\n" " print(\"bytes in\", len(files), \"non-directory files\")\n" " if '__pycache__' in dirs:\n" " dirs.remove('__pycache__') # don't visit __pycache__ directories" @@ -3393,10 +3479,10 @@ msgstr "" msgid "" "Create and return an event file descriptor. The file descriptors supports " -"raw :func:`read` and :func:`write` with a buffer size of 8, :func:`~select." -"select`, :func:`~select.poll` and similar. See man page :manpage:" -"`eventfd(2)` for more information. By default, the new file descriptor is :" -"ref:`non-inheritable `." +"raw :func:`read` and :func:`write` with a buffer size of " +"8, :func:`~select.select`, :func:`~select.poll` and similar. See man " +"page :manpage:`eventfd(2)` for more information. By default, the new file " +"descriptor is :ref:`non-inheritable `." msgstr "" msgid "" @@ -3412,8 +3498,8 @@ msgid "" msgstr "" msgid "" -"If :const:`EFD_SEMAPHORE` is specified and the event counter is non-zero, :" -"func:`eventfd_read` returns 1 and decrements the counter by one." +"If :const:`EFD_SEMAPHORE` is specified and the event counter is non-" +"zero, :func:`eventfd_read` returns 1 and decrements the counter by one." msgstr "" msgid "" @@ -3423,21 +3509,21 @@ msgid "" msgstr "" msgid "" -"If the event counter is zero and :const:`EFD_NONBLOCK` is not specified, :" -"func:`eventfd_read` blocks." +"If the event counter is zero and :const:`EFD_NONBLOCK` is not " +"specified, :func:`eventfd_read` blocks." msgstr "" msgid "" ":func:`eventfd_write` increments the event counter. Write blocks if the " -"write operation would increment the counter to a value larger than 2\\ :sup:" -"`64`\\ -\\ 2." +"write operation would increment the counter to a value larger than " +"2\\ :sup:`64`\\ -\\ 2." msgstr "" msgid "" "import os\n" "\n" "# semaphore with start value '1'\n" -"fd = os.eventfd(1, os.EFD_SEMAPHORE | os.EFC_CLOEXEC)\n" +"fd = os.eventfd(1, os.EFD_SEMAPHORE | os.EFD_CLOEXEC)\n" "try:\n" " # acquire semaphore\n" " v = os.eventfd_read(fd)\n" @@ -3499,8 +3585,8 @@ msgid "" "The file descriptor's :func:`read` method can be called with a buffer size " "of 8. If the timer has already expired one or more times, :func:`read` " "returns the number of expirations with the host's endianness, which may be " -"converted to an :class:`int` by ``int.from_bytes(x, byteorder=sys." -"byteorder)``." +"converted to an :class:`int` by ``int.from_bytes(x, " +"byteorder=sys.byteorder)``." msgstr "" msgid "" @@ -3524,9 +3610,9 @@ msgstr "" msgid "" "If *clockid* is :const:`time.CLOCK_REALTIME`, a settable system-wide real-" -"time clock is used. If system clock is changed, timer setting need to be " -"updated. To cancel timer when system clock is changed, see :const:" -"`TFD_TIMER_CANCEL_ON_SET`." +"time clock is used. If the system clock is changed, the timer setting needs " +"to be updated. To cancel the timer when the system clock is changed, " +"see :const:`TFD_TIMER_CANCEL_ON_SET`." msgstr "" msgid "" @@ -3536,13 +3622,14 @@ msgid "" msgstr "" msgid "" -"If *clockid* is :const:`time.CLOCK_BOOTTIME`, same as :const:`time." -"CLOCK_MONOTONIC` except it includes any time that the system is suspended." +"If *clockid* is :const:`time.CLOCK_BOOTTIME`, it is the same " +"as :const:`time.CLOCK_MONOTONIC` except it includes any time that the system " +"is suspended." msgstr "" msgid "" "The file descriptor's behaviour can be modified by specifying a *flags* " -"value. Any of the following variables may used, combined using bitwise OR " +"value. Any of the following variables may be used, combined using bitwise OR " "(the ``|`` operator):" msgstr "" @@ -3554,9 +3641,9 @@ msgstr ":const:`TFD_CLOEXEC`" msgid "" "If :const:`TFD_NONBLOCK` is not set as a flag, :func:`read` blocks until the " -"timer expires. If it is set as a flag, :func:`read` doesn't block, but If " +"timer expires. If it is set as a flag, :func:`read` doesn't block, but if " "there hasn't been an expiration since the last call to read, :func:`read` " -"raises :class:`OSError` with ``errno`` is set to :const:`errno.EAGAIN`." +"raises :class:`OSError` with ``errno`` set to :const:`errno.EAGAIN`." msgstr "" msgid ":const:`TFD_CLOEXEC` is always set by Python automatically." @@ -3580,7 +3667,7 @@ msgstr "" msgid "" "The timer's behaviour can be modified by specifying a *flags* value. Any of " -"the following variables may used, combined using bitwise OR (the ``|`` " +"the following variables may be used, combined using bitwise OR (the ``|`` " "operator):" msgstr "" @@ -3592,14 +3679,12 @@ msgstr ":const:`TFD_TIMER_CANCEL_ON_SET`" msgid "" "The timer is disabled by setting *initial* to zero (``0``). If *initial* is " -"equal to or greater than zero, the timer is enabled. If *initial* is less " -"than zero, it raises an :class:`OSError` exception with ``errno`` set to :" -"const:`errno.EINVAL`" +"greater than zero, the timer is enabled. If *initial* is less than zero, it " +"raises an :class:`OSError` exception with ``errno`` set " +"to :const:`errno.EINVAL`." msgstr "" -msgid "" -"By default the timer will fire when *initial* seconds have elapsed. (If " -"*initial* is zero, timer will fire immediately.)" +msgid "By default the timer will fire when *initial* seconds have elapsed." msgstr "" msgid "" @@ -3613,16 +3698,16 @@ msgid "" "*interval* is zero, the timer only fires once, on the initial expiration. If " "*interval* is greater than zero, the timer fires every time *interval* " "seconds have elapsed since the previous expiration. If *interval* is less " -"than zero, it raises :class:`OSError` with ``errno`` set to :const:`errno." -"EINVAL`" +"than zero, it raises :class:`OSError` with ``errno`` set " +"to :const:`errno.EINVAL`." msgstr "" msgid "" -"If the :const:`TFD_TIMER_CANCEL_ON_SET` flag is set along with :const:" -"`TFD_TIMER_ABSTIME` and the clock for this timer is :const:`time." -"CLOCK_REALTIME`, the timer is marked as cancelable if the real-time clock is " -"changed discontinuously. Reading the descriptor is aborted with the error " -"ECANCELED." +"If the :const:`TFD_TIMER_CANCEL_ON_SET` flag is set along " +"with :const:`TFD_TIMER_ABSTIME` and the clock for this timer " +"is :const:`time.CLOCK_REALTIME`, the timer is marked as cancelable if the " +"real-time clock is changed discontinuously. Reading the descriptor is " +"aborted with the error :const:`errno.ECANCELED`." msgstr "" msgid "" @@ -3650,8 +3735,8 @@ msgid "" msgstr "" msgid "" -":manpage:`timerfd_create(2)`, :manpage:`timerfd_settime(2)`, :manpage:" -"`settimeofday(2)`, :manpage:`clock_settime(2)`, and :manpage:`date(1)`." +":manpage:`timerfd_create(2)`, :manpage:`timerfd_settime(2)`, :manpage:`settimeofday(2)`, :manpage:`clock_settime(2)`, " +"and :manpage:`date(1)`." msgstr "" msgid "" @@ -3663,8 +3748,8 @@ msgid "Return a two-item tuple of floats (``next_expiration``, ``interval``)." msgstr "" msgid "" -"``next_expiration`` denotes the relative time until next the timer next " -"fires, regardless of if the :const:`TFD_TIMER_ABSTIME` flag is set." +"``next_expiration`` denotes the relative time until the timer next fires, " +"regardless of if the :const:`TFD_TIMER_ABSTIME` flag is set." msgstr "" msgid "" @@ -3679,9 +3764,9 @@ msgid "Similar to :func:`timerfd_gettime`, but return time as nanoseconds." msgstr "" msgid "" -"A flag for the :func:`timerfd_create` function, which sets the :const:" -"`O_NONBLOCK` status flag for the new timer file descriptor. If :const:" -"`TFD_NONBLOCK` is not set as a flag, :func:`read` blocks." +"A flag for the :func:`timerfd_create` function, which sets " +"the :const:`O_NONBLOCK` status flag for the new timer file descriptor. " +"If :const:`TFD_NONBLOCK` is not set as a flag, :func:`read` blocks." msgstr "" msgid "" @@ -3710,9 +3795,9 @@ msgstr "" msgid "" "Return the value of the extended filesystem attribute *attribute* for " -"*path*. *attribute* can be bytes or str (directly or indirectly through the :" -"class:`PathLike` interface). If it is str, it is encoded with the filesystem " -"encoding." +"*path*. *attribute* can be bytes or str (directly or indirectly through " +"the :class:`PathLike` interface). If it is str, it is encoded with the " +"filesystem encoding." msgstr "" msgid "" @@ -3737,9 +3822,9 @@ msgstr "" msgid "" "Removes the extended filesystem attribute *attribute* from *path*. " -"*attribute* should be bytes or str (directly or indirectly through the :" -"class:`PathLike` interface). If it is a string, it is encoded with the :term:" -"`filesystem encoding and error handler`." +"*attribute* should be bytes or str (directly or indirectly through " +"the :class:`PathLike` interface). If it is a string, it is encoded with " +"the :term:`filesystem encoding and error handler`." msgstr "" msgid "" @@ -3753,9 +3838,9 @@ msgid "" "indirectly through the :class:`PathLike` interface). If it is a str, it is " "encoded with the :term:`filesystem encoding and error handler`. *flags* may " "be :data:`XATTR_REPLACE` or :data:`XATTR_CREATE`. If :data:`XATTR_REPLACE` " -"is given and the attribute does not exist, ``ENODATA`` will be raised. If :" -"data:`XATTR_CREATE` is given and the attribute already exists, the attribute " -"will not be created and ``EEXISTS`` will be raised." +"is given and the attribute does not exist, ``ENODATA`` will be raised. " +"If :data:`XATTR_CREATE` is given and the attribute already exists, the " +"attribute will not be created and ``EEXISTS`` will be raised." msgstr "" msgid "" @@ -3803,8 +3888,8 @@ msgid "" "Generate a :const:`SIGABRT` signal to the current process. On Unix, the " "default behavior is to produce a core dump; on Windows, the process " "immediately returns an exit code of ``3``. Be aware that calling this " -"function will not call the Python signal handler registered for :const:" -"`SIGABRT` with :func:`signal.signal`." +"function will not call the Python signal handler registered " +"for :const:`SIGABRT` with :func:`signal.signal`." msgstr "" msgid "Add a path to the DLL search path." @@ -3822,9 +3907,9 @@ msgid "" msgstr "" msgid "" -"See the `Microsoft documentation `_ for more information about how " -"DLLs are loaded." +"See the `Microsoft documentation `_ for more information about how DLLs " +"are loaded." msgstr "" msgid "" @@ -3855,8 +3940,8 @@ msgstr "" msgid "" "The current process is replaced immediately. Open file objects and " "descriptors are not flushed, so if there may be data buffered on these open " -"files, you should flush them using :func:`sys.stdout.flush` or :func:`os." -"fsync` before calling an :func:`exec\\* ` function." +"files, you should flush them using :func:`~io.IOBase.flush` " +"or :func:`os.fsync` before calling an :func:`exec\\* ` function." msgstr "" msgid "" @@ -3872,33 +3957,34 @@ msgid "" msgstr "" msgid "" -"The variants which include a \"p\" near the end (:func:`execlp`, :func:" -"`execlpe`, :func:`execvp`, and :func:`execvpe`) will use the :envvar:`PATH` " -"environment variable to locate the program *file*. When the environment is " -"being replaced (using one of the :func:`exec\\*e ` variants, " -"discussed in the next paragraph), the new environment is used as the source " -"of the :envvar:`PATH` variable. The other variants, :func:`execl`, :func:" -"`execle`, :func:`execv`, and :func:`execve`, will not use the :envvar:`PATH` " -"variable to locate the executable; *path* must contain an appropriate " -"absolute or relative path. Relative paths must include at least one slash, " -"even on Windows, as plain names will not be resolved." +"The variants which include a \"p\" near the end " +"(:func:`execlp`, :func:`execlpe`, :func:`execvp`, and :func:`execvpe`) will " +"use the :envvar:`PATH` environment variable to locate the program *file*. " +"When the environment is being replaced (using one of the :func:`exec\\*e " +"` variants, discussed in the next paragraph), the new environment is " +"used as the source of the :envvar:`PATH` variable. The other " +"variants, :func:`execl`, :func:`execle`, :func:`execv`, and :func:`execve`, " +"will not use the :envvar:`PATH` variable to locate the executable; *path* " +"must contain an appropriate absolute or relative path. Relative paths must " +"include at least one slash, even on Windows, as plain names will not be " +"resolved." msgstr "" msgid "" "For :func:`execle`, :func:`execlpe`, :func:`execve`, and :func:`execvpe` " "(note that these all end in \"e\"), the *env* parameter must be a mapping " "which is used to define the environment variables for the new process (these " -"are used instead of the current process' environment); the functions :func:" -"`execl`, :func:`execlp`, :func:`execv`, and :func:`execvp` all cause the new " -"process to inherit the environment of the current process." +"are used instead of the current process' environment); the " +"functions :func:`execl`, :func:`execlp`, :func:`execv`, and :func:`execvp` " +"all cause the new process to inherit the environment of the current process." msgstr "" msgid "" "For :func:`execve` on some platforms, *path* may also be specified as an " "open file descriptor. This functionality may not be supported on your " -"platform; you can check whether or not it is available using :data:`os." -"supports_fd`. If it is unavailable, using it will raise a :exc:" -"`NotImplementedError`." +"platform; you can check whether or not it is available " +"using :data:`os.supports_fd`. If it is unavailable, using it will raise " +"a :exc:`NotImplementedError`." msgstr "" msgid "" @@ -3907,8 +3993,8 @@ msgid "" msgstr "" msgid "" -"Added support for specifying *path* as an open file descriptor for :func:" -"`execve`." +"Added support for specifying *path* as an open file descriptor " +"for :func:`execve`." msgstr "" msgid "" @@ -4026,13 +4112,13 @@ msgid "" msgstr "" msgid "" -"Calling ``fork()`` in a subinterpreter is no longer supported (:exc:" -"`RuntimeError` is raised)." +"Calling ``fork()`` in a subinterpreter is no longer supported " +"(:exc:`RuntimeError` is raised)." msgstr "" msgid "" -"If Python is able to detect that your process has multiple threads, :func:" -"`os.fork` now raises a :exc:`DeprecationWarning`." +"If Python is able to detect that your process has multiple " +"threads, :func:`os.fork` now raises a :exc:`DeprecationWarning`." msgstr "" msgid "" @@ -4070,14 +4156,14 @@ msgid "" msgstr "" msgid "" -"Calling ``forkpty()`` in a subinterpreter is no longer supported (:exc:" -"`RuntimeError` is raised)." +"Calling ``forkpty()`` in a subinterpreter is no longer supported " +"(:exc:`RuntimeError` is raised)." msgstr "" msgid "" "If Python is able to detect that your process has multiple threads, this now " -"raises a :exc:`DeprecationWarning`. See the longer explanation on :func:`os." -"fork`." +"raises a :exc:`DeprecationWarning`. See the longer explanation " +"on :func:`os.fork`." msgstr "" msgid "" @@ -4086,10 +4172,10 @@ msgid "" msgstr "" msgid "" -"Windows: The :const:`signal.CTRL_C_EVENT` and :const:`signal." -"CTRL_BREAK_EVENT` signals are special signals which can only be sent to " -"console processes which share a common console window, e.g., some " -"subprocesses. Any other value for *sig* will cause the process to be " +"Windows: The :const:`signal.CTRL_C_EVENT` " +"and :const:`signal.CTRL_BREAK_EVENT` signals are special signals which can " +"only be sent to console processes which share a common console window, e.g., " +"some subprocesses. Any other value for *sig* will cause the process to be " "unconditionally killed by the TerminateProcess API, and the exit code will " "be set to *sig*." msgstr "" @@ -4139,9 +4225,9 @@ msgid "" "Open a pipe to or from command *cmd*. The return value is an open file " "object connected to the pipe, which can be read or written depending on " "whether *mode* is ``'r'`` (default) or ``'w'``. The *buffering* argument " -"have the same meaning as the corresponding argument to the built-in :func:" -"`open` function. The returned file object reads or writes text strings " -"rather than bytes." +"have the same meaning as the corresponding argument to the built-" +"in :func:`open` function. The returned file object reads or writes text " +"strings rather than bytes." msgstr "" msgid "" @@ -4173,9 +4259,9 @@ msgid "" msgstr "" msgid "" -":func:`popen` is a simple wrapper around :class:`subprocess.Popen`. Use :" -"class:`subprocess.Popen` or :func:`subprocess.run` to control options like " -"encodings." +":func:`popen` is a simple wrapper around :class:`subprocess.Popen`. " +"Use :class:`subprocess.Popen` or :func:`subprocess.run` to control options " +"like encodings." msgstr "" msgid "Wraps the :c:func:`!posix_spawn` C library API for use from Python." @@ -4186,9 +4272,9 @@ msgid "" msgstr "" msgid "" -"The positional-only arguments *path*, *args*, and *env* are similar to :func:" -"`execve`. *env* is allowed to be ``None``, in which case current process' " -"environment is used." +"The positional-only arguments *path*, *args*, and *env* are similar " +"to :func:`execve`. *env* is allowed to be ``None``, in which case current " +"process' environment is used." msgstr "" msgid "" @@ -4234,8 +4320,8 @@ msgid "" "posix_spawn_file_actions_addopen`, :c:func:`!" "posix_spawn_file_actions_addclose`, :c:func:`!" "posix_spawn_file_actions_adddup2`, and :c:func:`!" -"posix_spawn_file_actions_addclosefrom_np` API calls used to prepare for the :" -"c:func:`!posix_spawn` call itself." +"posix_spawn_file_actions_addclosefrom_np` API calls used to prepare for " +"the :c:func:`!posix_spawn` call itself." msgstr "" msgid "" @@ -4258,9 +4344,9 @@ msgstr "" msgid "" "If the *setsid* argument is ``True``, it will create a new session ID for " -"``posix_spawn``. *setsid* requires :c:macro:`!POSIX_SPAWN_SETSID` or :c:" -"macro:`!POSIX_SPAWN_SETSID_NP` flag. Otherwise, :exc:`NotImplementedError` " -"is raised." +"``posix_spawn``. *setsid* requires :c:macro:`!POSIX_SPAWN_SETSID` " +"or :c:macro:`!POSIX_SPAWN_SETSID_NP` flag. " +"Otherwise, :exc:`NotImplementedError` is raised." msgstr "" msgid "" @@ -4309,9 +4395,9 @@ msgid "See :func:`posix_spawn` documentation." msgstr "" msgid "" -"Register callables to be executed when a new child process is forked using :" -"func:`os.fork` or similar process cloning APIs. The parameters are optional " -"and keyword-only. Each specifies a different call point." +"Register callables to be executed when a new child process is forked " +"using :func:`os.fork` or similar process cloning APIs. The parameters are " +"optional and keyword-only. Each specifies a different call point." msgstr "" msgid "*before* is a function called before forking a child process." @@ -4339,8 +4425,9 @@ msgstr "" msgid "" "Note that :c:func:`fork` calls made by third-party C code may not call those " -"functions, unless it explicitly calls :c:func:`PyOS_BeforeFork`, :c:func:" -"`PyOS_AfterFork_Parent` and :c:func:`PyOS_AfterFork_Child`." +"functions, unless it explicitly " +"calls :c:func:`PyOS_BeforeFork`, :c:func:`PyOS_AfterFork_Parent` " +"and :c:func:`PyOS_AfterFork_Child`." msgstr "" msgid "There is no way to unregister a function." @@ -4352,8 +4439,8 @@ msgstr "" msgid "" "(Note that the :mod:`subprocess` module provides more powerful facilities " "for spawning new processes and retrieving their results; using that module " -"is preferable to using these functions. Check especially the :ref:" -"`subprocess-replacements` section.)" +"is preferable to using these functions. Check especially " +"the :ref:`subprocess-replacements` section.)" msgstr "" msgid "" @@ -4381,26 +4468,27 @@ msgid "" msgstr "" msgid "" -"The variants which include a second \"p\" near the end (:func:`spawnlp`, :" -"func:`spawnlpe`, :func:`spawnvp`, and :func:`spawnvpe`) will use the :envvar:" -"`PATH` environment variable to locate the program *file*. When the " -"environment is being replaced (using one of the :func:`spawn\\*e ` " -"variants, discussed in the next paragraph), the new environment is used as " -"the source of the :envvar:`PATH` variable. The other variants, :func:" -"`spawnl`, :func:`spawnle`, :func:`spawnv`, and :func:`spawnve`, will not use " -"the :envvar:`PATH` variable to locate the executable; *path* must contain an " -"appropriate absolute or relative path." +"The variants which include a second \"p\" near the end " +"(:func:`spawnlp`, :func:`spawnlpe`, :func:`spawnvp`, and :func:`spawnvpe`) " +"will use the :envvar:`PATH` environment variable to locate the program " +"*file*. When the environment is being replaced (using one of " +"the :func:`spawn\\*e ` variants, discussed in the next paragraph), " +"the new environment is used as the source of the :envvar:`PATH` variable. " +"The other variants, :func:`spawnl`, :func:`spawnle`, :func:`spawnv`, " +"and :func:`spawnve`, will not use the :envvar:`PATH` variable to locate the " +"executable; *path* must contain an appropriate absolute or relative path." msgstr "" msgid "" "For :func:`spawnle`, :func:`spawnlpe`, :func:`spawnve`, and :func:`spawnvpe` " "(note that these all end in \"e\"), the *env* parameter must be a mapping " "which is used to define the environment variables for the new process (they " -"are used instead of the current process' environment); the functions :func:" -"`spawnl`, :func:`spawnlp`, :func:`spawnv`, and :func:`spawnvp` all cause the " -"new process to inherit the environment of the current process. Note that " -"keys and values in the *env* dictionary must be strings; invalid keys or " -"values will cause the function to fail, with a return value of ``127``." +"are used instead of the current process' environment); the " +"functions :func:`spawnl`, :func:`spawnlp`, :func:`spawnv`, " +"and :func:`spawnvp` all cause the new process to inherit the environment of " +"the current process. Note that keys and values in the *env* dictionary must " +"be strings; invalid keys or values will cause the function to fail, with a " +"return value of ``127``." msgstr "" msgid "" @@ -4430,9 +4518,9 @@ msgstr "" msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " -"family of functions. If either of these values is given, the :func:" -"`spawn\\* ` functions will return as soon as the new process has " -"been created, with the process id as the return value." +"family of functions. If either of these values is given, " +"the :func:`spawn\\* ` functions will return as soon as the new " +"process has been created, with the process id as the return value." msgstr "" msgid "" @@ -4445,11 +4533,11 @@ msgstr "" msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " -"family of functions. These are less portable than those listed above. :" -"const:`P_DETACH` is similar to :const:`P_NOWAIT`, but the new process is " -"detached from the console of the calling process. If :const:`P_OVERLAY` is " -"used, the current process will be replaced; the :func:`spawn\\* ` " -"function will not return." +"family of functions. These are less portable than those listed " +"above. :const:`P_DETACH` is similar to :const:`P_NOWAIT`, but the new " +"process is detached from the console of the calling process. " +"If :const:`P_OVERLAY` is used, the current process will be replaced; " +"the :func:`spawn\\* ` function will not return." msgstr "" msgid "Start a file with its associated application." @@ -4457,9 +4545,9 @@ msgstr "" msgid "" "When *operation* is not specified, this acts like double-clicking the file " -"in Windows Explorer, or giving the file name as an argument to the :program:" -"`start` command from the interactive command shell: the file is opened with " -"whatever application (if any) its extension is associated." +"in Windows Explorer, or giving the file name as an argument to " +"the :program:`start` command from the interactive command shell: the file is " +"opened with whatever application (if any) its extension is associated." msgstr "" msgid "" @@ -4514,8 +4602,8 @@ msgid "" msgstr "" msgid "" -"Added the *arguments*, *cwd* and *show_cmd* arguments, and the ``os." -"startfile/2`` audit event." +"Added the *arguments*, *cwd* and *show_cmd* arguments, and the " +"``os.startfile/2`` audit event." msgstr "" msgid "" @@ -4535,10 +4623,10 @@ msgstr "" msgid "" "On Windows, the return value is that returned by the system shell after " -"running *command*. The shell is given by the Windows environment variable :" -"envvar:`COMSPEC`: it is usually :program:`cmd.exe`, which returns the exit " -"status of the command run; on systems using a non-native shell, consult your " -"shell documentation." +"running *command*. The shell is given by the Windows environment " +"variable :envvar:`COMSPEC`: it is usually :program:`cmd.exe`, which returns " +"the exit status of the command run; on systems using a non-native shell, " +"consult your shell documentation." msgstr "" msgid "" @@ -4586,8 +4674,8 @@ msgid "" msgstr "" msgid "" -"See the Unix manual page :manpage:`times(2)` and `times(3) `_ manual page on Unix or `the " +"See the Unix manual page :manpage:`times(2)` and `times(3) `_ manual page on Unix or `the " "GetProcessTimes MSDN `_ on Windows. On " "Windows, only :attr:`!user` and :attr:`!system` are known; the other " @@ -4614,28 +4702,28 @@ msgstr "" msgid "" "The other :func:`!wait*` functions documented below can be used to wait for " -"the completion of a specific child process and have more options. :func:" -"`waitpid` is the only one also available on Windows." +"the completion of a specific child process and have more " +"options. :func:`waitpid` is the only one also available on Windows." msgstr "" msgid "Wait for the completion of a child process." msgstr "" msgid "" -"*idtype* can be :data:`P_PID`, :data:`P_PGID`, :data:`P_ALL`, or (on Linux) :" -"data:`P_PIDFD`. The interpretation of *id* depends on it; see their " +"*idtype* can be :data:`P_PID`, :data:`P_PGID`, :data:`P_ALL`, or (on " +"Linux) :data:`P_PIDFD`. The interpretation of *id* depends on it; see their " "individual descriptions." msgstr "" msgid "" -"*options* is an OR combination of flags. At least one of :data:`WEXITED`, :" -"data:`WSTOPPED` or :data:`WCONTINUED` is required; :data:`WNOHANG` and :data:" -"`WNOWAIT` are additional optional flags." +"*options* is an OR combination of flags. At least one " +"of :data:`WEXITED`, :data:`WSTOPPED` or :data:`WCONTINUED` is " +"required; :data:`WNOHANG` and :data:`WNOWAIT` are additional optional flags." msgstr "" msgid "" -"The return value is an object representing the data contained in the :c:type:" -"`siginfo_t` structure with the following attributes:" +"The return value is an object representing the data contained in " +"the :c:type:`siginfo_t` structure with the following attributes:" msgstr "" msgid ":attr:`!si_pid` (process ID)" @@ -4698,9 +4786,9 @@ msgid "" "bits (shifting makes cross-platform use of the function easier). A *pid* " "less than or equal to ``0`` has no special meaning on Windows, and raises an " "exception. The value of integer *options* has no effect. *pid* can refer to " -"any process whose id is known, not necessarily a child process. The :func:" -"`spawn\\* ` functions called with :const:`P_NOWAIT` return suitable " -"process handles." +"any process whose id is known, not necessarily a child process. " +"The :func:`spawn\\* ` functions called with :const:`P_NOWAIT` return " +"suitable process handles." msgstr "" msgid "" @@ -4750,8 +4838,8 @@ msgid "The :data:`!P_PIDFD` constant." msgstr "" msgid "" -"This *options* flag for :func:`waitpid`, :func:`wait3`, :func:`wait4`, and :" -"func:`waitid` causes child processes to be reported if they have been " +"This *options* flag for :func:`waitpid`, :func:`wait3`, :func:`wait4`, " +"and :func:`waitid` causes child processes to be reported if they have been " "continued from a job control stop since they were last reported." msgstr "" @@ -4835,14 +4923,14 @@ msgid "" msgstr "" msgid "" -":func:`WIFEXITED`, :func:`WEXITSTATUS`, :func:`WIFSIGNALED`, :func:" -"`WTERMSIG`, :func:`WIFSTOPPED`, :func:`WSTOPSIG` functions." +":func:`WIFEXITED`, :func:`WEXITSTATUS`, :func:`WIFSIGNALED`, :func:`WTERMSIG`, :func:`WIFSTOPPED`, :func:`WSTOPSIG` " +"functions." msgstr "" msgid "" -"The following functions take a process status code as returned by :func:" -"`system`, :func:`wait`, or :func:`waitpid` as a parameter. They may be used " -"to determine the disposition of a process." +"The following functions take a process status code as returned " +"by :func:`system`, :func:`wait`, or :func:`waitpid` as a parameter. They " +"may be used to determine the disposition of a process." msgstr "" msgid "" @@ -4854,9 +4942,9 @@ msgid "This function should be employed only if :func:`WIFSIGNALED` is true." msgstr "" msgid "" -"Return ``True`` if a stopped child has been resumed by delivery of :const:" -"`~signal.SIGCONT` (if the process has been continued from a job control " -"stop), otherwise return ``False``." +"Return ``True`` if a stopped child has been resumed by delivery " +"of :const:`~signal.SIGCONT` (if the process has been continued from a job " +"control stop), otherwise return ``False``." msgstr "" msgid "See :data:`WCONTINUED` option." @@ -4940,9 +5028,9 @@ msgid "" msgstr "" msgid "" -"This class represents tunable scheduling parameters used in :func:" -"`sched_setparam`, :func:`sched_setscheduler`, and :func:`sched_getparam`. It " -"is immutable." +"This class represents tunable scheduling parameters used " +"in :func:`sched_setparam`, :func:`sched_setscheduler`, " +"and :func:`sched_getparam`. It is immutable." msgstr "" msgid "At the moment, there is only one possible parameter:" @@ -5030,8 +5118,8 @@ msgstr "" msgid "" "If *name* is a string and is not known, :exc:`ValueError` is raised. If a " "specific value for *name* is not supported by the host system, even if it is " -"included in ``confstr_names``, an :exc:`OSError` is raised with :const:" -"`errno.EINVAL` for the error number." +"included in ``confstr_names``, an :exc:`OSError` is raised " +"with :const:`errno.EINVAL` for the error number." msgstr "" msgid "" @@ -5052,7 +5140,7 @@ msgstr "" msgid "" "If :option:`-X cpu_count <-X>` is given or :envvar:`PYTHON_CPU_COUNT` is " -"set, :func:`cpu_count` returns the overridden value *n*." +"set, :func:`cpu_count` returns the override value *n*." msgstr "" msgid "" @@ -5063,8 +5151,8 @@ msgstr "" msgid "" "Get the number of logical CPUs usable by the calling thread of the **current " -"process**. Returns ``None`` if undetermined. It can be less than :func:" -"`cpu_count` depending on the CPU affinity." +"process**. Returns ``None`` if undetermined. It can be less " +"than :func:`cpu_count` depending on the CPU affinity." msgstr "" msgid "" @@ -5074,7 +5162,7 @@ msgstr "" msgid "" "If :option:`-X cpu_count <-X>` is given or :envvar:`PYTHON_CPU_COUNT` is " -"set, :func:`process_cpu_count` returns the overridden value *n*." +"set, :func:`process_cpu_count` returns the override value *n*." msgstr "" msgid "See also the :func:`sched_getaffinity` function." @@ -5109,22 +5197,22 @@ msgstr "" msgid "" "The constant string used by the operating system to refer to the current " -"directory. This is ``'.'`` for Windows and POSIX. Also available via :mod:" -"`os.path`." +"directory. This is ``'.'`` for Windows and POSIX. Also available " +"via :mod:`os.path`." msgstr "" msgid "" "The constant string used by the operating system to refer to the parent " -"directory. This is ``'..'`` for Windows and POSIX. Also available via :mod:" -"`os.path`." +"directory. This is ``'..'`` for Windows and POSIX. Also available " +"via :mod:`os.path`." msgstr "" msgid "" "The character used by the operating system to separate pathname components. " "This is ``'/'`` for POSIX and ``'\\\\'`` for Windows. Note that knowing " -"this is not sufficient to be able to parse or concatenate pathnames --- use :" -"func:`os.path.split` and :func:`os.path.join` --- but it is occasionally " -"useful. Also available via :mod:`os.path`." +"this is not sufficient to be able to parse or concatenate pathnames --- " +"use :func:`os.path.split` and :func:`os.path.join` --- but it is " +"occasionally useful. Also available via :mod:`os.path`." msgstr "" msgid "" @@ -5146,17 +5234,17 @@ msgid "" msgstr "" msgid "" -"The default search path used by :func:`exec\\*p\\* ` and :func:" -"`spawn\\*p\\* ` if the environment doesn't have a ``'PATH'`` key. " -"Also available via :mod:`os.path`." +"The default search path used by :func:`exec\\*p\\* ` " +"and :func:`spawn\\*p\\* ` if the environment doesn't have a " +"``'PATH'`` key. Also available via :mod:`os.path`." msgstr "" msgid "" "The string used to separate (or, rather, terminate) lines on the current " "platform. This may be a single character, such as ``'\\n'`` for POSIX, or " -"multiple characters, for example, ``'\\r\\n'`` for Windows. Do not use *os." -"linesep* as a line terminator when writing files opened in text mode (the " -"default); use a single ``'\\n'`` instead, on all platforms." +"multiple characters, for example, ``'\\r\\n'`` for Windows. Do not use " +"*os.linesep* as a line terminator when writing files opened in text mode " +"(the default); use a single ``'\\n'`` instead, on all platforms." msgstr "" msgid "" @@ -5165,9 +5253,9 @@ msgid "" msgstr "" msgid "" -"Flags for use with the :func:`~sys.setdlopenflags` and :func:`~sys." -"getdlopenflags` functions. See the Unix manual page :manpage:`dlopen(3)` " -"for what the different flags mean." +"Flags for use with the :func:`~sys.setdlopenflags` " +"and :func:`~sys.getdlopenflags` functions. See the Unix manual " +"page :manpage:`dlopen(3)` for what the different flags mean." msgstr "" msgid "Random numbers" @@ -5192,8 +5280,8 @@ msgstr "" msgid "" "The flags argument is a bit mask that can contain zero or more of the " -"following values ORed together: :py:const:`os.GRND_RANDOM` and :py:data:" -"`GRND_NONBLOCK`." +"following values ORed together: :py:const:`os.GRND_RANDOM` " +"and :py:data:`GRND_NONBLOCK`." msgstr "" msgid "" diff --git a/library/pathlib.po b/library/pathlib.po index 92c6159596..8fbbcc4a2c 100644 --- a/library/pathlib.po +++ b/library/pathlib.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Rafael Fontenelle , 2024 -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-09 21:16+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +28,7 @@ msgid ":mod:`!pathlib` --- Object-oriented filesystem paths" msgstr "" msgid "**Source code:** :source:`Lib/pathlib/`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/pathlib/`" msgid "" "This module offers classes representing filesystem paths with semantics " @@ -74,8 +73,8 @@ msgid ":pep:`428`: The pathlib module -- object-oriented filesystem paths." msgstr "" msgid "" -"For low-level path manipulation on strings, you can also use the :mod:`os." -"path` module." +"For low-level path manipulation on strings, you can also use " +"the :mod:`os.path` module." msgstr "" msgid "Basic use" @@ -207,8 +206,8 @@ msgstr "" "PurePosixPath('.')" msgid "" -"If a segment is an absolute path, all previous segments are ignored (like :" -"func:`os.path.join`)::" +"If a segment is an absolute path, all previous segments are ignored " +"(like :func:`os.path.join`)::" msgstr "" msgid "" @@ -223,8 +222,8 @@ msgstr "" "PureWindowsPath('d:bar')" msgid "" -"On Windows, the drive is not reset when a rooted relative path segment (e." -"g., ``r'\\foo'``) is encountered::" +"On Windows, the drive is not reset when a rooted relative path segment " +"(e.g., ``r'\\foo'``) is encountered::" msgstr "" msgid "" @@ -380,8 +379,8 @@ msgstr "" "PureWindowsPath('c:/Program Files')" msgid "" -"A path object can be used anywhere an object implementing :class:`os." -"PathLike` is accepted::" +"A path object can be used anywhere an object " +"implementing :class:`os.PathLike` is accepted::" msgstr "" msgid "" @@ -472,7 +471,7 @@ msgstr "" msgid "" "The implementation of the :mod:`os.path` module used for low-level path " -"parsing and joining: either :mod:`posixpath` or :mod:`ntpath`." +"parsing and joining: either :mod:`!posixpath` or :mod:`!ntpath`." msgstr "" msgid "A string representing the drive letter or name, if any::" @@ -532,8 +531,8 @@ msgstr "" "'\\\\'" msgid "" -"If the path starts with more than two successive slashes, :class:`~pathlib." -"PurePosixPath` collapses them::" +"If the path starts with more than two successive " +"slashes, :class:`~pathlib.PurePosixPath` collapses them::" msgstr "" msgid "" @@ -553,8 +552,8 @@ msgstr "" msgid "" "This behavior conforms to *The Open Group Base Specifications Issue 6*, " -"paragraph `4.11 Pathname Resolution `_:" +"paragraph `4.11 Pathname Resolution `_:" msgstr "" msgid "" @@ -941,8 +940,8 @@ msgstr "" msgid "" "When *walk_up* is false (the default), the path must start with *other*. " "When the argument is true, ``..`` entries may be added to form the relative " -"path. In all other cases, such as the paths referencing different drives, :" -"exc:`ValueError` is raised.::" +"path. In all other cases, such as the paths referencing different " +"drives, :exc:`ValueError` is raised.::" msgstr "" msgid "" @@ -1131,8 +1130,8 @@ msgstr "" "PosixPath('/etc/hosts')" msgid "" -"Raises :exc:`UnsupportedOperation` on Windows. In previous versions, :exc:" -"`NotImplementedError` was raised instead." +"Raises :exc:`UnsupportedOperation` on Windows. In previous " +"versions, :exc:`NotImplementedError` was raised instead." msgstr "" msgid "" @@ -1286,8 +1285,8 @@ msgstr "" msgid "" "Return a new path with expanded ``~`` and ``~user`` constructs, as returned " -"by :meth:`os.path.expanduser`. If a home directory can't be resolved, :exc:" -"`RuntimeError` is raised." +"by :meth:`os.path.expanduser`. If a home directory can't be " +"resolved, :exc:`RuntimeError` is raised." msgstr "" msgid "" @@ -1300,8 +1299,8 @@ msgstr "" "PosixPath('/home/eric/films/Monty Python')" msgid "" -"Return a new path object representing the current directory (as returned by :" -"func:`os.getcwd`)::" +"Return a new path object representing the current directory (as returned " +"by :func:`os.getcwd`)::" msgstr "" msgid "" @@ -1378,8 +1377,8 @@ msgid "" msgstr "" msgid "" -"Return the path to which the symbolic link points (as returned by :func:`os." -"readlink`)::" +"Return the path to which the symbolic link points (as returned " +"by :func:`os.readlink`)::" msgstr "" msgid "" @@ -1402,9 +1401,7 @@ msgid "Querying file type and status" msgstr "" msgid "" -":meth:`~Path.exists`, :meth:`~Path.is_dir`, :meth:`~Path.is_file`, :meth:" -"`~Path.is_mount`, :meth:`~Path.is_symlink`, :meth:`~Path.is_block_device`, :" -"meth:`~Path.is_char_device`, :meth:`~Path.is_fifo`, :meth:`~Path.is_socket` " +":meth:`~Path.exists`, :meth:`~Path.is_dir`, :meth:`~Path.is_file`, :meth:`~Path.is_mount`, :meth:`~Path.is_symlink`, :meth:`~Path.is_block_device`, :meth:`~Path.is_char_device`, :meth:`~Path.is_fifo`, :meth:`~Path.is_socket` " "now return ``False`` instead of raising an exception for paths that contain " "characters unrepresentable at the OS level." msgstr "" @@ -1544,8 +1541,8 @@ msgstr "" msgid "" "Return whether this path points to the same file as *other_path*, which can " -"be either a Path object, or a string. The semantics are similar to :func:" -"`os.path.samefile` and :func:`os.path.samestat`." +"be either a Path object, or a string. The semantics are similar " +"to :func:`os.path.samefile` and :func:`os.path.samestat`." msgstr "" msgid "" @@ -1563,7 +1560,7 @@ msgid "" msgstr "" msgid "Reading and writing files" -msgstr "" +msgstr "Odczytywanie i zapisywanie plików" msgid "" "Open the file pointed to by the path, like the built-in :func:`open` " @@ -1666,8 +1663,8 @@ msgstr "" msgid "" ">>> sorted(Path('.').glob('*.py'))\n" -"[PosixPath('pathlib.py'), PosixPath('setup.py'), PosixPath('test_pathlib." -"py')]\n" +"[PosixPath('pathlib.py'), PosixPath('setup.py'), " +"PosixPath('test_pathlib.py')]\n" ">>> sorted(Path('.').glob('*/*.py'))\n" "[PosixPath('docs/conf.py')]\n" ">>> sorted(Path('.').glob('**/*.py'))\n" @@ -1678,6 +1675,11 @@ msgid "" " PosixPath('test_pathlib.py')]" msgstr "" +msgid "" +"The paths are returned in no particular order. If you need a specific order, " +"sort the results." +msgstr "" + msgid "" "By default, or when the *case_sensitive* keyword-only argument is set to " "``None``, this method matches paths using platform-specific casing rules: " @@ -1691,6 +1693,12 @@ msgid "" "wildcards. Set *recurse_symlinks* to ``True`` to always follow symlinks." msgstr "" +msgid "" +"Any :exc:`OSError` exceptions raised from scanning the filesystem are " +"suppressed. This includes :exc:`PermissionError` when accessing directories " +"without read permission." +msgstr "" + msgid "" "Raises an :ref:`auditing event ` ``pathlib.Path.glob`` with " "arguments ``self``, ``pattern``." @@ -1706,8 +1714,8 @@ msgid "" msgstr "" msgid "" -"Glob the given relative *pattern* recursively. This is like calling :func:" -"`Path.glob` with \"``**/``\" added in front of the *pattern*." +"Glob the given relative *pattern* recursively. This is like " +"calling :func:`Path.glob` with \"``**/``\" added in front of the *pattern*." msgstr "" msgid ":ref:`pathlib-pattern-language` and :meth:`Path.glob` documentation." @@ -1750,14 +1758,15 @@ msgstr "" msgid "" "When *top_down* is true, the caller can modify the *dirnames* list in-place " -"(for example, using :keyword:`del` or slice assignment), and :meth:`Path." -"walk` will only recurse into the subdirectories whose names remain in " -"*dirnames*. This can be used to prune the search, or to impose a specific " -"order of visiting, or even to inform :meth:`Path.walk` about directories the " -"caller creates or renames before it resumes :meth:`Path.walk` again. " -"Modifying *dirnames* when *top_down* is false has no effect on the behavior " -"of :meth:`Path.walk` since the directories in *dirnames* have already been " -"generated by the time *dirnames* is yielded to the caller." +"(for example, using :keyword:`del` or slice assignment), " +"and :meth:`Path.walk` will only recurse into the subdirectories whose names " +"remain in *dirnames*. This can be used to prune the search, or to impose a " +"specific order of visiting, or even to inform :meth:`Path.walk` about " +"directories the caller creates or renames before it " +"resumes :meth:`Path.walk` again. Modifying *dirnames* when *top_down* is " +"false has no effect on the behavior of :meth:`Path.walk` since the " +"directories in *dirnames* have already been generated by the time *dirnames* " +"is yielded to the caller." msgstr "" msgid "" @@ -1778,8 +1787,9 @@ msgstr "" msgid "" "Be aware that setting *follow_symlinks* to true can lead to infinite " -"recursion if a link points to a parent directory of itself. :meth:`Path." -"walk` does not keep track of the directories it has already visited." +"recursion if a link points to a parent directory of " +"itself. :meth:`Path.walk` does not keep track of the directories it has " +"already visited." msgstr "" msgid "" @@ -1802,8 +1812,8 @@ msgstr "" msgid "" "from pathlib import Path\n" -"for root, dirs, files in Path(\"cpython/Lib/concurrent\")." -"walk(on_error=print):\n" +"for root, dirs, files in Path(\"cpython/Lib/" +"concurrent\").walk(on_error=print):\n" " print(\n" " root,\n" " \"consumes\",\n" @@ -1840,13 +1850,13 @@ msgid "" "Create a file at this given path. If *mode* is given, it is combined with " "the process's ``umask`` value to determine the file mode and access flags. " "If the file already exists, the function succeeds when *exist_ok* is true " -"(and its modification time is updated to the current time), otherwise :exc:" -"`FileExistsError` is raised." +"(and its modification time is updated to the current time), " +"otherwise :exc:`FileExistsError` is raised." msgstr "" msgid "" -"The :meth:`~Path.open`, :meth:`~Path.write_text` and :meth:`~Path." -"write_bytes` methods are often used to create files." +"The :meth:`~Path.open`, :meth:`~Path.write_text` " +"and :meth:`~Path.write_bytes` methods are often used to create files." msgstr "" msgid "" @@ -1862,8 +1872,8 @@ msgid "" msgstr "" msgid "" -"If *parents* is false (the default), a missing parent raises :exc:" -"`FileNotFoundError`." +"If *parents* is false (the default), a missing parent " +"raises :exc:`FileNotFoundError`." msgstr "" msgid "" @@ -1927,11 +1937,11 @@ msgid "Renaming and deleting" msgstr "" msgid "" -"Rename this file or directory to the given *target*, and return a new :class:" -"`!Path` instance pointing to *target*. On Unix, if *target* exists and is a " -"file, it will be replaced silently if the user has permission. On Windows, " -"if *target* exists, :exc:`FileExistsError` will be raised. *target* can be " -"either a string or another path object::" +"Rename this file or directory to the given *target*, and return a " +"new :class:`!Path` instance pointing to *target*. On Unix, if *target* " +"exists and is a file, it will be replaced silently if the user has " +"permission. On Windows, if *target* exists, :exc:`FileExistsError` will be " +"raised. *target* can be either a string or another path object::" msgstr "" msgid "" @@ -1947,8 +1957,8 @@ msgstr "" msgid "" "The target path may be absolute or relative. Relative paths are interpreted " -"relative to the current working directory, *not* the directory of the :class:" -"`!Path` object." +"relative to the current working directory, *not* the directory of " +"the :class:`!Path` object." msgstr "" msgid "" @@ -1960,14 +1970,14 @@ msgid "Added return value, return the new :class:`!Path` instance." msgstr "" msgid "" -"Rename this file or directory to the given *target*, and return a new :class:" -"`!Path` instance pointing to *target*. If *target* points to an existing " -"file or empty directory, it will be unconditionally replaced." +"Rename this file or directory to the given *target*, and return a " +"new :class:`!Path` instance pointing to *target*. If *target* points to an " +"existing file or empty directory, it will be unconditionally replaced." msgstr "" msgid "" -"Remove this file or symbolic link. If the path points to a directory, use :" -"func:`Path.rmdir` instead." +"Remove this file or symbolic link. If the path points to a directory, " +"use :func:`Path.rmdir` instead." msgstr "" msgid "" @@ -2052,8 +2062,8 @@ msgid "Pattern language" msgstr "" msgid "" -"The following wildcards are supported in patterns for :meth:`~PurePath." -"full_match`, :meth:`~Path.glob` and :meth:`~Path.rglob`:" +"The following wildcards are supported in patterns " +"for :meth:`~PurePath.full_match`, :meth:`~Path.glob` and :meth:`~Path.rglob`:" msgstr "" msgid "``**`` (entire segment)" @@ -2083,13 +2093,19 @@ msgstr "" msgid "``[seq]``" msgstr "``[seq]``" -msgid "Matches one character in *seq*." +msgid "" +"Matches one character in *seq*, where *seq* is a sequence of characters. " +"Range expressions are supported; for example, ``[a-z]`` matches any " +"lowercase ASCII letter. Multiple ranges can be combined: ``[a-zA-Z0-9_]`` " +"matches any ASCII letter, digit, or underscore." msgstr "" msgid "``[!seq]``" msgstr "``[!seq]``" -msgid "Matches one character not in *seq*." +msgid "" +"Matches one character not in *seq*, where *seq* follows the same rules as " +"above." msgstr "" msgid "" @@ -2119,13 +2135,13 @@ msgid "Any path with a final segment ending \"``.py``\"." msgstr "" msgid "\"``assets/**``\"" -msgstr "" +msgstr "\"``assets/**``\"" msgid "Any path starting with \"``assets/``\"." msgstr "" msgid "\"``assets/**/*``\"" -msgstr "" +msgstr "\"``assets/**/*``\"" msgid "" "Any path starting with \"``assets/``\", excluding \"``assets/``\" itself." @@ -2147,16 +2163,16 @@ msgid "" msgstr "" msgid "" -"Globbing with a pattern that ends with a pathname components separator (:" -"data:`~os.sep` or :data:`~os.altsep`) returns only directories." +"Globbing with a pattern that ends with a pathname components separator " +"(:data:`~os.sep` or :data:`~os.altsep`) returns only directories." msgstr "" msgid "Comparison to the :mod:`glob` module" msgstr "" msgid "" -"The patterns accepted and results generated by :meth:`Path.glob` and :meth:" -"`Path.rglob` differ slightly from those by the :mod:`glob` module:" +"The patterns accepted and results generated by :meth:`Path.glob` " +"and :meth:`Path.rglob` differ slightly from those by the :mod:`glob` module:" msgstr "" msgid "" @@ -2182,8 +2198,8 @@ msgstr "" msgid "" "The values returned from pathlib's ``path.glob()`` and ``path.rglob()`` " -"include the *path* as a prefix, unlike the results of ``glob." -"glob(root_dir=path)``." +"include the *path* as a prefix, unlike the results of " +"``glob.glob(root_dir=path)``." msgstr "" msgid "" @@ -2198,22 +2214,22 @@ msgstr "" msgid "" "pathlib implements path operations using :class:`PurePath` and :class:`Path` " -"objects, and so it's said to be *object-oriented*. On the other hand, the :" -"mod:`os` and :mod:`os.path` modules supply functions that work with low-" +"objects, and so it's said to be *object-oriented*. On the other hand, " +"the :mod:`os` and :mod:`os.path` modules supply functions that work with low-" "level ``str`` and ``bytes`` objects, which is a more *procedural* approach. " "Some users consider the object-oriented style to be more readable." msgstr "" msgid "" -"Many functions in :mod:`os` and :mod:`os.path` support ``bytes`` paths and :" -"ref:`paths relative to directory descriptors `. These features " +"Many functions in :mod:`os` and :mod:`os.path` support ``bytes`` paths " +"and :ref:`paths relative to directory descriptors `. These features " "aren't available in pathlib." msgstr "" msgid "" -"Python's ``str`` and ``bytes`` types, and portions of the :mod:`os` and :mod:" -"`os.path` modules, are written in C and are very speedy. pathlib is written " -"in pure Python and is often slower, but rarely slow enough to matter." +"Python's ``str`` and ``bytes`` types, and portions of the :mod:`os` " +"and :mod:`os.path` modules, are written in C and are very speedy. pathlib is " +"written in pure Python and is often slower, but rarely slow enough to matter." msgstr "" msgid "" @@ -2253,8 +2269,8 @@ msgid "Corresponding tools" msgstr "" msgid "" -"Below is a table mapping various :mod:`os` functions to their corresponding :" -"class:`PurePath`/:class:`Path` equivalent." +"Below is a table mapping various :mod:`os` functions to their " +"corresponding :class:`PurePath`/:class:`Path` equivalent." msgstr "" msgid ":mod:`os` and :mod:`os.path`" @@ -2297,13 +2313,13 @@ msgid ":func:`os.path.relpath`" msgstr ":func:`os.path.relpath`" msgid ":meth:`PurePath.relative_to` [1]_" -msgstr "" +msgstr ":meth:`PurePath.relative_to` [1]_" msgid ":func:`os.path.expanduser`" msgstr ":func:`os.path.expanduser`" msgid ":meth:`Path.expanduser` [2]_" -msgstr "" +msgstr ":meth:`Path.expanduser` [2]_" msgid ":func:`os.path.realpath`" msgstr ":func:`os.path.realpath`" @@ -2315,7 +2331,7 @@ msgid ":func:`os.path.abspath`" msgstr ":func:`os.path.abspath`" msgid ":meth:`Path.absolute` [3]_" -msgstr "" +msgstr ":meth:`Path.absolute` [3]_" msgid ":func:`os.path.exists`" msgstr ":func:`os.path.exists`" @@ -2387,10 +2403,10 @@ msgid ":func:`os.walk`" msgstr ":func:`os.walk`" msgid ":meth:`Path.walk` [4]_" -msgstr "" +msgstr ":meth:`Path.walk` [4]_" msgid ":func:`os.mkdir`, :func:`os.makedirs`" -msgstr "" +msgstr ":func:`os.mkdir`, :func:`os.makedirs`" msgid ":meth:`Path.mkdir`" msgstr ":meth:`Path.mkdir`" @@ -2426,7 +2442,7 @@ msgid ":meth:`Path.replace`" msgstr ":meth:`Path.replace`" msgid ":func:`os.remove`, :func:`os.unlink`" -msgstr "" +msgstr ":func:`os.remove`, :func:`os.unlink`" msgid ":meth:`Path.unlink`" msgstr ":meth:`Path.unlink`" @@ -2461,14 +2477,14 @@ msgstr "" msgid "" ":func:`os.path.expanduser` returns the path unchanged if the home directory " -"can't be resolved, whereas :meth:`Path.expanduser` raises :exc:" -"`RuntimeError`." +"can't be resolved, whereas :meth:`Path.expanduser` " +"raises :exc:`RuntimeError`." msgstr "" msgid "" ":func:`os.path.abspath` removes \"``..``\" components without resolving " -"symlinks, which may change the meaning of the path, whereas :meth:`Path." -"absolute` leaves any \"``..``\" components in the path." +"symlinks, which may change the meaning of the path, " +"whereas :meth:`Path.absolute` leaves any \"``..``\" components in the path." msgstr "" msgid "" diff --git a/library/pdb.po b/library/pdb.po index 7a001f6796..068927d4d8 100644 --- a/library/pdb.po +++ b/library/pdb.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# haaritsubaki, 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +28,7 @@ msgid ":mod:`pdb` --- The Python Debugger" msgstr "" msgid "**Source code:** :source:`Lib/pdb.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/pdb.py`" msgid "" "The module :mod:`pdb` defines an interactive source code debugger for Python " @@ -41,9 +40,10 @@ msgid "" msgstr "" msgid "" -"The debugger is extensible -- it is actually defined as the class :class:" -"`Pdb`. This is currently undocumented but easily understood by reading the " -"source. The extension interface uses the modules :mod:`bdb` and :mod:`cmd`." +"The debugger is extensible -- it is actually defined as the " +"class :class:`Pdb`. This is currently undocumented but easily understood by " +"reading the source. The extension interface uses the modules :mod:`bdb` " +"and :mod:`cmd`." msgstr "" msgid "Module :mod:`faulthandler`" @@ -113,6 +113,9 @@ msgid "" "arguments of the ``p`` command." msgstr "" +msgid "Command-line interface" +msgstr "Interfejs wiersza poleceń" + msgid "" "You can also invoke :mod:`pdb` from the command line to debug other " "scripts. For example::" @@ -197,8 +200,8 @@ msgid "" "statement using :pdbcmd:`step` or :pdbcmd:`next` (all these commands are " "explained below). The optional *globals* and *locals* arguments specify the " "environment in which the code is executed; by default the dictionary of the " -"module :mod:`__main__` is used. (See the explanation of the built-in :func:" -"`exec` or :func:`eval` functions.)" +"module :mod:`__main__` is used. (See the explanation of the built-" +"in :func:`exec` or :func:`eval` functions.)" msgstr "" msgid "" @@ -264,15 +267,15 @@ msgstr "" msgid "" "By default, Pdb sets a handler for the SIGINT signal (which is sent when the " -"user presses :kbd:`Ctrl-C` on the console) when you give a :pdbcmd:" -"`continue` command. This allows you to break into the debugger again by " -"pressing :kbd:`Ctrl-C`. If you want Pdb not to touch the SIGINT handler, " -"set *nosigint* to true." +"user presses :kbd:`Ctrl-C` on the console) when you give " +"a :pdbcmd:`continue` command. This allows you to break into the debugger " +"again by pressing :kbd:`Ctrl-C`. If you want Pdb not to touch the SIGINT " +"handler, set *nosigint* to true." msgstr "" msgid "" -"The *readrc* argument defaults to true and controls whether Pdb will load ." -"pdbrc files from the filesystem." +"The *readrc* argument defaults to true and controls whether Pdb will " +"load .pdbrc files from the filesystem." msgstr "" msgid "Example call to enable tracing with *skip*::" @@ -299,7 +302,7 @@ msgstr "" msgid "See the documentation for the functions explained above." msgstr "" -msgid "Debugger Commands" +msgid "Debugger commands" msgstr "" msgid "" @@ -383,8 +386,8 @@ msgid "" msgstr "" msgid "" -":file:`.pdbrc` can now contain commands that continue debugging, such as :" -"pdbcmd:`continue` or :pdbcmd:`next`. Previously, these commands had no " +":file:`.pdbrc` can now contain commands that continue debugging, such " +"as :pdbcmd:`continue` or :pdbcmd:`next`. Previously, these commands had no " "effect." msgstr "" @@ -422,8 +425,8 @@ msgid "" "The line number may be prefixed with a *filename* and a colon, to specify a " "breakpoint in another file (possibly one that hasn't been loaded yet). The " "file is searched on :data:`sys.path`. Accepatable forms of *filename* are " -"``/abspath/to/file.py``, ``relpath/file.py``, ``module`` and ``package." -"module``." +"``/abspath/to/file.py``, ``relpath/file.py``, ``module`` and " +"``package.module``." msgstr "" msgid "" @@ -512,13 +515,13 @@ msgid "" msgstr "" msgid "" -"Specifying any command resuming execution (currently :pdbcmd:`continue`, :" -"pdbcmd:`step`, :pdbcmd:`next`, :pdbcmd:`return`, :pdbcmd:`jump`, :pdbcmd:" -"`quit` and their abbreviations) terminates the command list (as if that " -"command was immediately followed by end). This is because any time you " -"resume execution (even with a simple next or step), you may encounter " -"another breakpoint—which could have its own command list, leading to " -"ambiguities about which list to execute." +"Specifying any command resuming execution " +"(currently :pdbcmd:`continue`, :pdbcmd:`step`, :pdbcmd:`next`, :pdbcmd:`return`, :pdbcmd:`jump`, :pdbcmd:`quit` " +"and their abbreviations) terminates the command list (as if that command was " +"immediately followed by end). This is because any time you resume execution " +"(even with a simple next or step), you may encounter another breakpoint—" +"which could have its own command list, leading to ambiguities about which " +"list to execute." msgstr "" msgid "" @@ -570,8 +573,8 @@ msgstr "" msgid "" "It should be noted that not all jumps are allowed -- for instance it is not " -"possible to jump into the middle of a :keyword:`for` loop or out of a :" -"keyword:`finally` clause." +"possible to jump into the middle of a :keyword:`for` loop or out of " +"a :keyword:`finally` clause." msgstr "" msgid "" @@ -727,8 +730,8 @@ msgid "" msgstr "" msgid "" -"As an example, here are two useful aliases (especially when placed in the :" -"file:`.pdbrc` file)::" +"As an example, here are two useful aliases (especially when placed in " +"the :file:`.pdbrc` file)::" msgstr "" msgid "" @@ -753,8 +756,8 @@ msgid "" msgstr "" msgid "" -"To set a global variable, you can prefix the assignment command with a :" -"keyword:`global` statement on the same line, e.g.:" +"To set a global variable, you can prefix the assignment command with " +"a :keyword:`global` statement on the same line, e.g.:" msgstr "" msgid "" @@ -765,8 +768,8 @@ msgstr "" msgid "" "Restart the debugged Python program. If *args* is supplied, it is split " "with :mod:`shlex` and the result is used as the new :data:`sys.argv`. " -"History, breakpoints, actions and debugger options are preserved. :pdbcmd:" -"`restart` is an alias for :pdbcmd:`run`." +"History, breakpoints, actions and debugger options are " +"preserved. :pdbcmd:`restart` is an alias for :pdbcmd:`run`." msgstr "" msgid "Quit from the debugger. The program being executed is aborted." @@ -806,7 +809,7 @@ msgid "" "def inner(x):\n" " 1 / x\n" "\n" -" out()" +"out()" msgstr "" msgid "calling ``pdb.pm()`` will allow to move between exceptions::" diff --git a/library/pickle.po b/library/pickle.po index cd85dbd84d..664303d1bc 100644 --- a/library/pickle.po +++ b/library/pickle.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,15 +27,15 @@ msgid ":mod:`!pickle` --- Python object serialization" msgstr "" msgid "**Source code:** :source:`Lib/pickle.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/pickle.py`" msgid "" "The :mod:`pickle` module implements binary protocols for serializing and de-" "serializing a Python object structure. *\"Pickling\"* is the process " "whereby a Python object hierarchy is converted into a byte stream, and " -"*\"unpickling\"* is the inverse operation, whereby a byte stream (from a :" -"term:`binary file` or :term:`bytes-like object`) is converted back into an " -"object hierarchy. Pickling (and unpickling) is alternatively known as " +"*\"unpickling\"* is the inverse operation, whereby a byte stream (from " +"a :term:`binary file` or :term:`bytes-like object`) is converted back into " +"an object hierarchy. Pickling (and unpickling) is alternatively known as " "\"serialization\", \"marshalling,\" [#]_ or \"flattening\"; however, to " "avoid confusion, the terms used here are \"pickling\" and \"unpickling\"." msgstr "" @@ -70,8 +68,8 @@ msgstr "" msgid "" "Python has a more primitive serialization module called :mod:`marshal`, but " "in general :mod:`pickle` should always be the preferred way to serialize " -"Python objects. :mod:`marshal` exists primarily to support Python's :file:`." -"pyc` files." +"Python objects. :mod:`marshal` exists primarily to support " +"Python's :file:`.pyc` files." msgstr "" msgid "" @@ -79,41 +77,23 @@ msgid "" "ways:" msgstr "" -msgid "" -"The :mod:`pickle` module keeps track of the objects it has already " -"serialized, so that later references to the same object won't be serialized " -"again. :mod:`marshal` doesn't do this." -msgstr "" - -msgid "" -"This has implications both for recursive objects and object sharing. " -"Recursive objects are objects that contain references to themselves. These " -"are not handled by marshal, and in fact, attempting to marshal recursive " -"objects will crash your Python interpreter. Object sharing happens when " -"there are multiple references to the same object in different places in the " -"object hierarchy being serialized. :mod:`pickle` stores such objects only " -"once, and ensures that all other references point to the master copy. " -"Shared objects remain shared, which can be very important for mutable " -"objects." -msgstr "" - msgid "" ":mod:`marshal` cannot be used to serialize user-defined classes and their " "instances. :mod:`pickle` can save and restore class instances " "transparently, however the class definition must be importable and live in " -"the same module as when the object was stored." +"the same module as when the object was pickled." msgstr "" msgid "" "The :mod:`marshal` serialization format is not guaranteed to be portable " -"across Python versions. Because its primary job in life is to support :file:" -"`.pyc` files, the Python implementers reserve the right to change the " -"serialization format in non-backwards compatible ways should the need arise. " -"The :mod:`pickle` serialization format is guaranteed to be backwards " -"compatible across Python releases provided a compatible pickle protocol is " -"chosen and pickling and unpickling code deals with Python 2 to Python 3 type " -"differences if your data is crossing that unique breaking change language " -"boundary." +"across Python versions. Because its primary job in life is to " +"support :file:`.pyc` files, the Python implementers reserve the right to " +"change the serialization format in non-backwards compatible ways should the " +"need arise. The :mod:`pickle` serialization format is guaranteed to be " +"backwards compatible across Python releases provided a compatible pickle " +"protocol is chosen and pickling and unpickling code deals with Python 2 to " +"Python 3 type differences if your data is crossing that unique breaking " +"change language boundary." msgstr "" msgid "Comparison with ``json``" @@ -142,8 +122,8 @@ msgid "" "JSON, by default, can only represent a subset of the Python built-in types, " "and no custom classes; pickle can represent an extremely large number of " "Python types (many of them automatically, by clever usage of Python's " -"introspection facilities; complex cases can be tackled by implementing :ref:" -"`specific object APIs `);" +"introspection facilities; complex cases can be tackled by " +"implementing :ref:`specific object APIs `);" msgstr "" msgid "" @@ -201,9 +181,9 @@ msgid "" msgstr "" msgid "" -"Protocol version 3 was added in Python 3.0. It has explicit support for :" -"class:`bytes` objects and cannot be unpickled by Python 2.x. This was the " -"default protocol in Python 3.0--3.7." +"Protocol version 3 was added in Python 3.0. It has explicit support " +"for :class:`bytes` objects and cannot be unpickled by Python 2.x. This was " +"the default protocol in Python 3.0--3.7." msgstr "" msgid "" @@ -220,9 +200,9 @@ msgid "" msgstr "" msgid "" -"Serialization is a more primitive notion than persistence; although :mod:" -"`pickle` reads and writes file objects, it does not handle the issue of " -"naming persistent objects, nor the (even more complicated) issue of " +"Serialization is a more primitive notion than persistence; " +"although :mod:`pickle` reads and writes file objects, it does not handle the " +"issue of naming persistent objects, nor the (even more complicated) issue of " "concurrent access to persistent objects. The :mod:`pickle` module can " "transform a complex object into a byte stream and it can transform the byte " "stream into an object with the same internal structure. Perhaps the most " @@ -237,10 +217,10 @@ msgstr "" msgid "" "To serialize an object hierarchy, you simply call the :func:`dumps` " -"function. Similarly, to de-serialize a data stream, you call the :func:" -"`loads` function. However, if you want more control over serialization and " -"de-serialization, you can create a :class:`Pickler` or an :class:`Unpickler` " -"object, respectively." +"function. Similarly, to de-serialize a data stream, you call " +"the :func:`loads` function. However, if you want more control over " +"serialization and de-serialization, you can create a :class:`Pickler` or " +"an :class:`Unpickler` object, respectively." msgstr "" msgid "The :mod:`pickle` module provides the following constants:" @@ -248,8 +228,9 @@ msgstr "" msgid "" "An integer, the highest :ref:`protocol version ` " -"available. This value can be passed as a *protocol* value to functions :" -"func:`dump` and :func:`dumps` as well as the :class:`Pickler` constructor." +"available. This value can be passed as a *protocol* value to " +"functions :func:`dump` and :func:`dumps` as well as the :class:`Pickler` " +"constructor." msgstr "" msgid "" @@ -327,8 +308,8 @@ msgid "The :mod:`pickle` module defines three exceptions:" msgstr "" msgid "" -"Common base class for the other pickling exceptions. It inherits from :exc:" -"`Exception`." +"Common base class for the other pickling exceptions. It inherits " +"from :exc:`Exception`." msgstr "" msgid "" @@ -353,8 +334,8 @@ msgid "" msgstr "" msgid "" -"The :mod:`pickle` module exports three classes, :class:`Pickler`, :class:" -"`Unpickler` and :class:`PickleBuffer`:" +"The :mod:`pickle` module exports three " +"classes, :class:`Pickler`, :class:`Unpickler` and :class:`PickleBuffer`:" msgstr "" msgid "This takes a binary file for writing a pickle data stream." @@ -369,8 +350,8 @@ msgstr "" msgid "" "The *file* argument must have a write() method that accepts a single bytes " -"argument. It can thus be an on-disk file opened for binary writing, an :" -"class:`io.BytesIO` instance, or any other custom object that meets this " +"argument. It can thus be an on-disk file opened for binary writing, " +"an :class:`io.BytesIO` instance, or any other custom object that meets this " "interface." msgstr "" @@ -417,8 +398,8 @@ msgid "See :ref:`pickle-persistent` for details and examples of uses." msgstr "" msgid "" -"Add the default implementation of this method in the C implementation of :" -"class:`!Pickler`." +"Add the default implementation of this method in the C implementation " +"of :class:`!Pickler`." msgstr "" msgid "" @@ -431,12 +412,12 @@ msgstr "" msgid "" "By default, a pickler object will not have a :attr:`dispatch_table` " -"attribute, and it will instead use the global dispatch table managed by the :" -"mod:`copyreg` module. However, to customize the pickling for a specific " +"attribute, and it will instead use the global dispatch table managed by " +"the :mod:`copyreg` module. However, to customize the pickling for a specific " "pickler object one can set the :attr:`dispatch_table` attribute to a dict-" -"like object. Alternatively, if a subclass of :class:`Pickler` has a :attr:" -"`dispatch_table` attribute then this will be used as the default dispatch " -"table for instances of that class." +"like object. Alternatively, if a subclass of :class:`Pickler` has " +"a :attr:`dispatch_table` attribute then this will be used as the default " +"dispatch table for instances of that class." msgstr "" msgid "See :ref:`pickle-dispatch` for usage examples." @@ -446,8 +427,8 @@ msgid "" "Special reducer that can be defined in :class:`Pickler` subclasses. This " "method has priority over any reducer in the :attr:`dispatch_table`. It " "should conform to the same interface as a :meth:`~object.__reduce__` method, " -"and can optionally return :data:`NotImplemented` to fallback on :attr:" -"`dispatch_table`-registered reducers to pickle ``obj``." +"and can optionally return :data:`NotImplemented` to fallback " +"on :attr:`dispatch_table`-registered reducers to pickle ``obj``." msgstr "" msgid "For a detailed example, see :ref:`reducer_override`." @@ -474,10 +455,10 @@ msgstr "" msgid "" "The argument *file* must have three methods, a read() method that takes an " "integer argument, a readinto() method that takes a buffer argument and a " -"readline() method that requires no arguments, as in the :class:`io." -"BufferedIOBase` interface. Thus *file* can be an on-disk file opened for " -"binary reading, an :class:`io.BytesIO` object, or any other custom object " -"that meets this interface." +"readline() method that requires no arguments, as in " +"the :class:`io.BufferedIOBase` interface. Thus *file* can be an on-disk " +"file opened for binary reading, an :class:`io.BytesIO` object, or any other " +"custom object that meets this interface." msgstr "" msgid "" @@ -488,9 +469,9 @@ msgid "" "decode 8-bit string instances pickled by Python 2; these default to 'ASCII' " "and 'strict', respectively. The *encoding* can be 'bytes' to read these 8-" "bit string instances as bytes objects. Using ``encoding='latin1'`` is " -"required for unpickling NumPy arrays and instances of :class:`~datetime." -"datetime`, :class:`~datetime.date` and :class:`~datetime.time` pickled by " -"Python 2." +"required for unpickling NumPy arrays and instances " +"of :class:`~datetime.datetime`, :class:`~datetime.date` " +"and :class:`~datetime.time` pickled by Python 2." msgstr "" msgid "" @@ -518,13 +499,13 @@ msgstr "" msgid "" "If defined, :meth:`persistent_load` should return the object specified by " -"the persistent ID *pid*. If an invalid persistent ID is encountered, an :" -"exc:`UnpicklingError` should be raised." +"the persistent ID *pid*. If an invalid persistent ID is encountered, " +"an :exc:`UnpicklingError` should be raised." msgstr "" msgid "" -"Add the default implementation of this method in the C implementation of :" -"class:`!Unpickler`." +"Add the default implementation of this method in the C implementation " +"of :class:`!Unpickler`." msgstr "" msgid "" @@ -536,8 +517,8 @@ msgstr "" msgid "" "Subclasses may override this to gain control over what type of objects and " -"how they can be loaded, potentially reducing security risks. Refer to :ref:" -"`pickle-restrict` for details." +"how they can be loaded, potentially reducing security risks. Refer " +"to :ref:`pickle-restrict` for details." msgstr "" msgid "" @@ -546,15 +527,15 @@ msgid "" msgstr "" msgid "" -"A wrapper for a buffer representing picklable data. *buffer* must be a :ref:" -"`buffer-providing ` object, such as a :term:`bytes-like " -"object` or a N-dimensional array." +"A wrapper for a buffer representing picklable data. *buffer* must be " +"a :ref:`buffer-providing ` object, such as a :term:`bytes-" +"like object` or a N-dimensional array." msgstr "" msgid "" ":class:`PickleBuffer` is itself a buffer provider, therefore it is possible " -"to pass it to other APIs expecting a buffer-providing object, such as :class:" -"`memoryview`." +"to pass it to other APIs expecting a buffer-providing object, such " +"as :class:`memoryview`." msgstr "" msgid "" @@ -580,8 +561,8 @@ msgid "The following types can be pickled:" msgstr "" msgid "" -"built-in constants (``None``, ``True``, ``False``, ``Ellipsis``, and :data:" -"`NotImplemented`);" +"built-in constants (``None``, ``True``, ``False``, ``Ellipsis``, " +"and :data:`NotImplemented`);" msgstr "" msgid "integers, floating-point numbers, complex numbers;" @@ -603,25 +584,26 @@ msgid "classes accessible from the top level of a module;" msgstr "" msgid "" -"instances of such classes whose the result of calling :meth:`~object." -"__getstate__` is picklable (see section :ref:`pickle-inst` for details)." +"instances of such classes for which the result of " +"calling :meth:`~object.__getstate__` is picklable (see section :ref:`pickle-" +"inst` for details)." msgstr "" msgid "" "Attempts to pickle unpicklable objects will raise the :exc:`PicklingError` " "exception; when this happens, an unspecified number of bytes may have " "already been written to the underlying file. Trying to pickle a highly " -"recursive data structure may exceed the maximum recursion depth, a :exc:" -"`RecursionError` will be raised in this case. You can carefully raise this " -"limit with :func:`sys.setrecursionlimit`." +"recursive data structure may exceed the maximum recursion depth, " +"a :exc:`RecursionError` will be raised in this case. You can carefully " +"raise this limit with :func:`sys.setrecursionlimit`." msgstr "" msgid "" -"Note that functions (built-in and user-defined) are pickled by fully :term:" -"`qualified name`, not by value. [#]_ This means that only the function name " -"is pickled, along with the name of the containing module and classes. " -"Neither the function's code, nor any of its function attributes are " -"pickled. Thus the defining module must be importable in the unpickling " +"Note that functions (built-in and user-defined) are pickled by " +"fully :term:`qualified name`, not by value. [#]_ This means that only the " +"function name is pickled, along with the name of the containing module and " +"classes. Neither the function's code, nor any of its function attributes " +"are pickled. Thus the defining module must be importable in the unpickling " "environment, and the module must contain the named object, otherwise an " "exception will be raised. [#]_" msgstr "" @@ -652,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:`~object." -"__setstate__` method." +"that suitable conversions can be made by the " +"class's :meth:`~object.__setstate__` method." msgstr "" msgid "Pickling Class Instances" @@ -667,10 +649,11 @@ msgstr "" msgid "" "In most cases, no additional code is needed to make instances picklable. By " "default, pickle will retrieve the class and the attributes of an instance " -"via introspection. When a class instance is unpickled, its :meth:`~object." -"__init__` method is usually *not* invoked. The default behaviour first " -"creates an uninitialized instance and then restores the saved attributes. " -"The following code shows an implementation of this behaviour::" +"via introspection. When a class instance is unpickled, " +"its :meth:`~object.__init__` method is usually *not* invoked. The default " +"behaviour first creates an uninitialized instance and then restores the " +"saved attributes. The following code shows an implementation of this " +"behaviour::" msgstr "" msgid "" @@ -689,12 +672,12 @@ msgid "" msgstr "" msgid "" -"In protocols 2 and newer, classes that implements the :meth:" -"`__getnewargs_ex__` method can dictate the values passed to the :meth:" -"`__new__` method upon unpickling. The method must return a pair ``(args, " -"kwargs)`` where *args* is a tuple of positional arguments and *kwargs* a " -"dictionary of named arguments for constructing the object. Those will be " -"passed to the :meth:`__new__` method upon unpickling." +"In protocols 2 and newer, classes that implement " +"the :meth:`__getnewargs_ex__` method can dictate the values passed to " +"the :meth:`__new__` method upon unpickling. The method must return a pair " +"``(args, kwargs)`` where *args* is a tuple of positional arguments and " +"*kwargs* a dictionary of named arguments for constructing the object. Those " +"will be passed to the :meth:`__new__` method upon unpickling." msgstr "" msgid "" @@ -718,8 +701,8 @@ msgid "" msgstr "" msgid "" -"Before Python 3.6, :meth:`__getnewargs__` was called instead of :meth:" -"`__getnewargs_ex__` in protocols 2 and 3." +"Before Python 3.6, :meth:`__getnewargs__` was called instead " +"of :meth:`__getnewargs_ex__` in protocols 2 and 3." msgstr "" msgid "" @@ -730,32 +713,32 @@ msgid "" msgstr "" msgid "" -"For a class that has no instance :attr:`~object.__dict__` and no :attr:" -"`~object.__slots__`, the default state is ``None``." +"For a class that has no instance :attr:`~object.__dict__` and " +"no :attr:`~object.__slots__`, the default state is ``None``." msgstr "" msgid "" -"For a class that has an instance :attr:`~object.__dict__` and no :attr:" -"`~object.__slots__`, the default state is ``self.__dict__``." +"For a class that has an instance :attr:`~object.__dict__` and " +"no :attr:`~object.__slots__`, the default state is ``self.__dict__``." msgstr "" msgid "" -"For a class that has an instance :attr:`~object.__dict__` and :attr:`~object." -"__slots__`, the default state is a tuple consisting of two dictionaries: " -"``self.__dict__``, and a dictionary mapping slot names to slot values. Only " -"slots that have a value are included in the latter." +"For a class that has an instance :attr:`~object.__dict__` " +"and :attr:`~object.__slots__`, the default state is a tuple consisting of " +"two dictionaries: ``self.__dict__``, and a dictionary mapping slot names to " +"slot values. Only slots that have a value are included in the latter." msgstr "" msgid "" -"For a class that has :attr:`~object.__slots__` and no instance :attr:" -"`~object.__dict__`, the default state is a tuple whose first item is " -"``None`` and whose second item is a dictionary mapping slot names to slot " -"values described in the previous bullet." +"For a class that has :attr:`~object.__slots__` and no " +"instance :attr:`~object.__dict__`, the default state is a tuple whose first " +"item is ``None`` and whose second item is a dictionary mapping slot names to " +"slot values described in the previous bullet." msgstr "" msgid "" -"Added the default implementation of the ``__getstate__()`` method in the :" -"class:`object` class." +"Added the default implementation of the ``__getstate__()`` method in " +"the :class:`object` class." msgstr "" msgid "" @@ -766,29 +749,29 @@ msgid "" msgstr "" msgid "" -"If :meth:`__reduce__` returns a state with value ``None`` at pickling, the :" -"meth:`__setstate__` method will not be called upon unpickling." +"If :meth:`__reduce__` returns a state with value ``None`` at pickling, " +"the :meth:`__setstate__` method will not be called upon unpickling." msgstr "" msgid "" "Refer to the section :ref:`pickle-state` for more information about how to " -"use the methods :meth:`~object.__getstate__` and :meth:`~object." -"__setstate__`." +"use the methods :meth:`~object.__getstate__` " +"and :meth:`~object.__setstate__`." msgstr "" msgid "" -"At unpickling time, some methods like :meth:`~object.__getattr__`, :meth:" -"`~object.__getattribute__`, or :meth:`~object.__setattr__` may be called " -"upon the instance. In case those methods rely on some internal invariant " -"being true, the type should implement :meth:`~object.__new__` to establish " -"such an invariant, as :meth:`~object.__init__` is not called when unpickling " -"an instance." +"At unpickling time, some methods " +"like :meth:`~object.__getattr__`, :meth:`~object.__getattribute__`, " +"or :meth:`~object.__setattr__` may be called upon the instance. In case " +"those methods rely on some internal invariant being true, the type should " +"implement :meth:`~object.__new__` to establish such an invariant, " +"as :meth:`~object.__init__` is not called when unpickling an instance." msgstr "" msgid "" "As we shall see, pickle does not use directly the methods described above. " -"In fact, these methods are part of the copy protocol which implements the :" -"meth:`~object.__reduce__` special method. The copy protocol provides a " +"In fact, these methods are part of the copy protocol which implements " +"the :meth:`~object.__reduce__` special method. The copy protocol provides a " "unified interface for retrieving the data necessary for pickling and copying " "objects. [#]_" msgstr "" @@ -796,10 +779,11 @@ msgstr "" msgid "" "Although powerful, implementing :meth:`~object.__reduce__` directly in your " "classes is error prone. For this reason, class designers should use the " -"high-level interface (i.e., :meth:`~object.__getnewargs_ex__`, :meth:" -"`~object.__getstate__` and :meth:`~object.__setstate__`) whenever possible. " -"We will show, however, cases where using :meth:`!__reduce__` is the only " -"option or leads to more efficient pickling or both." +"high-level interface " +"(i.e., :meth:`~object.__getnewargs_ex__`, :meth:`~object.__getstate__` " +"and :meth:`~object.__setstate__`) whenever possible. We will show, however, " +"cases where using :meth:`!__reduce__` is the only option or leads to more " +"efficient pickling or both." msgstr "" msgid "" @@ -812,7 +796,10 @@ msgid "" "If a string is returned, the string should be interpreted as the name of a " "global variable. It should be the object's local name relative to its " "module; the pickle module searches the module namespace to determine the " -"object's module. This behaviour is typically useful for singletons." +"object's module: for a given ``obj`` to be pickled, the ``__module__`` " +"attribute is looked up on ``obj`` directly, which falls back to a lookup on " +"the type of ``obj`` if no ``__module__`` instance attribute is set. This " +"behaviour is typically useful for singletons." msgstr "" msgid "" @@ -832,21 +819,21 @@ msgid "" msgstr "" msgid "" -"Optionally, the object's state, which will be passed to the object's :meth:" -"`__setstate__` method as previously described. If the object has no such " -"method then, the value must be a dictionary and it will be added to the " -"object's :attr:`~object.__dict__` attribute." +"Optionally, the object's state, which will be passed to the " +"object's :meth:`__setstate__` method as previously described. If the object " +"has no such method then, the value must be a dictionary and it will be added " +"to the object's :attr:`~object.__dict__` attribute." msgstr "" msgid "" "Optionally, an iterator (and not a sequence) yielding successive items. " "These items will be appended to the object either using ``obj.append(item)`` " "or, in batch, using ``obj.extend(list_of_items)``. This is primarily used " -"for list subclasses, but may be used by other classes as long as they have :" -"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.)" +"for list subclasses, but may be used by other classes as long as they " +"have :meth:`~sequence.append` and :meth:`~sequence.extend` methods with the " +"appropriate signature. (Whether :meth:`!append` or :meth:`!extend` is used " +"depends on which pickle protocol version is used as well as the number of " +"items to append, so both must be supported.)" msgstr "" msgid "" @@ -860,8 +847,8 @@ msgid "" "Optionally, a callable with a ``(obj, state)`` signature. This callable " "allows the user to programmatically control the state-updating behavior of a " "specific object, instead of using ``obj``'s static :meth:`__setstate__` " -"method. If not ``None``, this callable will have priority over ``obj``'s :" -"meth:`__setstate__`." +"method. If not ``None``, this callable will have priority over " +"``obj``'s :meth:`__setstate__`." msgstr "" msgid "The optional sixth tuple item, ``(obj, state)``, was added." @@ -870,10 +857,11 @@ msgstr "" msgid "" "Alternatively, a :meth:`__reduce_ex__` method may be defined. The only " "difference is this method should take a single integer argument, the " -"protocol version. When defined, pickle will prefer it over the :meth:" -"`__reduce__` method. In addition, :meth:`__reduce__` automatically becomes " -"a synonym for the extended version. The main use for this method is to " -"provide backwards-compatible reduce values for older Python releases." +"protocol version. When defined, pickle will prefer it over " +"the :meth:`__reduce__` method. In addition, :meth:`__reduce__` " +"automatically becomes a synonym for the extended version. The main use for " +"this method is to provide backwards-compatible reduce values for older " +"Python releases." msgstr "" msgid "Persistence of External Objects" @@ -890,8 +878,8 @@ msgstr "" msgid "" "The resolution of such persistent IDs is not defined by the :mod:`pickle` " "module; it will delegate this resolution to the user-defined methods on the " -"pickler and unpickler, :meth:`~Pickler.persistent_id` and :meth:`~Unpickler." -"persistent_load` respectively." +"pickler and unpickler, :meth:`~Pickler.persistent_id` " +"and :meth:`~Unpickler.persistent_load` respectively." msgstr "" msgid "" @@ -905,9 +893,9 @@ msgid "" msgstr "" msgid "" -"To unpickle external objects, the unpickler must have a custom :meth:" -"`~Unpickler.persistent_load` method that takes a persistent ID object and " -"returns the referenced object." +"To unpickle external objects, the unpickler must have a " +"custom :meth:`~Unpickler.persistent_load` method that takes a persistent ID " +"object and returns the referenced object." msgstr "" msgid "" @@ -977,8 +965,8 @@ msgid "" " # Initialize and populate our database.\n" " conn = sqlite3.connect(\":memory:\")\n" " cursor = conn.cursor()\n" -" cursor.execute(\"CREATE TABLE memos(key INTEGER PRIMARY KEY, task " -"TEXT)\")\n" +" cursor.execute(\"CREATE TABLE memos(key INTEGER PRIMARY KEY, task TEXT)" +"\")\n" " tasks = (\n" " 'give food to fish',\n" " 'prepare group meeting',\n" @@ -1152,17 +1140,17 @@ msgid "" msgstr "" msgid "" -"If both the :attr:`~Pickler.dispatch_table` and :meth:`~Pickler." -"reducer_override` are defined, then :meth:`~Pickler.reducer_override` method " -"takes priority." +"If both the :attr:`~Pickler.dispatch_table` " +"and :meth:`~Pickler.reducer_override` are defined, " +"then :meth:`~Pickler.reducer_override` method takes priority." msgstr "" msgid "" "For performance reasons, :meth:`~Pickler.reducer_override` may not be called " "for the following objects: ``None``, ``True``, ``False``, and exact " -"instances of :class:`int`, :class:`float`, :class:`bytes`, :class:`str`, :" -"class:`dict`, :class:`set`, :class:`frozenset`, :class:`list` and :class:" -"`tuple`." +"instances " +"of :class:`int`, :class:`float`, :class:`bytes`, :class:`str`, :class:`dict`, :class:`set`, :class:`frozenset`, :class:`list` " +"and :class:`tuple`." msgstr "" msgid "" @@ -1223,10 +1211,10 @@ msgid "Provider API" msgstr "" msgid "" -"The large data objects to be pickled must implement a :meth:`~object." -"__reduce_ex__` method specialized for protocol 5 and higher, which returns " -"a :class:`PickleBuffer` instance (instead of e.g. a :class:`bytes` object) " -"for any large data." +"The large data objects to be pickled must implement " +"a :meth:`~object.__reduce_ex__` method specialized for protocol 5 and " +"higher, which returns a :class:`PickleBuffer` instance (instead of e.g. " +"a :class:`bytes` object) for any large data." msgstr "" msgid "" @@ -1241,26 +1229,27 @@ msgid "Consumer API" msgstr "" msgid "" -"A communications system can enable custom handling of the :class:" -"`PickleBuffer` objects generated when serializing an object graph." +"A communications system can enable custom handling of " +"the :class:`PickleBuffer` objects generated when serializing an object graph." msgstr "" msgid "" -"On the sending side, it needs to pass a *buffer_callback* argument to :class:" -"`Pickler` (or to the :func:`dump` or :func:`dumps` function), which will be " -"called with each :class:`PickleBuffer` generated while pickling the object " -"graph. Buffers accumulated by the *buffer_callback* will not see their data " -"copied into the pickle stream, only a cheap marker will be inserted." +"On the sending side, it needs to pass a *buffer_callback* argument " +"to :class:`Pickler` (or to the :func:`dump` or :func:`dumps` function), " +"which will be called with each :class:`PickleBuffer` generated while " +"pickling the object graph. Buffers accumulated by the *buffer_callback* " +"will not see their data copied into the pickle stream, only a cheap marker " +"will be inserted." msgstr "" msgid "" -"On the receiving side, it needs to pass a *buffers* argument to :class:" -"`Unpickler` (or to the :func:`load` or :func:`loads` function), which is an " -"iterable of the buffers which were passed to *buffer_callback*. That " -"iterable should produce buffers in the same order as they were passed to " -"*buffer_callback*. Those buffers will provide the data expected by the " -"reconstructors of the objects whose pickling produced the original :class:" -"`PickleBuffer` objects." +"On the receiving side, it needs to pass a *buffers* argument " +"to :class:`Unpickler` (or to the :func:`load` or :func:`loads` function), " +"which is an iterable of the buffers which were passed to *buffer_callback*. " +"That iterable should produce buffers in the same order as they were passed " +"to *buffer_callback*. Those buffers will provide the data expected by the " +"reconstructors of the objects whose pickling produced the " +"original :class:`PickleBuffer` objects." msgstr "" msgid "" @@ -1375,16 +1364,16 @@ msgid "" msgstr "" msgid "" -"For this reason, you may want to control what gets unpickled by customizing :" -"meth:`Unpickler.find_class`. Unlike its name suggests, :meth:`Unpickler." -"find_class` is called whenever a global (i.e., a class or a function) is " -"requested. Thus it is possible to either completely forbid globals or " -"restrict them to a safe subset." +"For this reason, you may want to control what gets unpickled by " +"customizing :meth:`Unpickler.find_class`. Unlike its name " +"suggests, :meth:`Unpickler.find_class` is called whenever a global (i.e., a " +"class or a function) is requested. Thus it is possible to either completely " +"forbid globals or restrict them to a safe subset." msgstr "" msgid "" -"Here is an example of an unpickler allowing only few safe classes from the :" -"mod:`builtins` module to be loaded::" +"Here is an example of an unpickler allowing only few safe classes from " +"the :mod:`builtins` module to be loaded::" msgstr "" msgid "" @@ -1525,8 +1514,8 @@ msgid "" msgstr "" msgid "" -"The exception raised will likely be an :exc:`ImportError` or an :exc:" -"`AttributeError` but it could be something else." +"The exception raised will likely be an :exc:`ImportError` or " +"an :exc:`AttributeError` but it could be something else." msgstr "" msgid "" diff --git a/library/pickletools.po b/library/pickletools.po index 774bc79b29..fd73f1c5cf 100644 --- a/library/pickletools.po +++ b/library/pickletools.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,15 +27,15 @@ msgid ":mod:`!pickletools` --- Tools for pickle developers" msgstr "" msgid "**Source code:** :source:`Lib/pickletools.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/pickletools.py`" msgid "" "This module contains various constants relating to the intimate details of " "the :mod:`pickle` module, some lengthy comments about the implementation, " "and a few useful functions for analyzing pickled data. The contents of this " -"module are useful for Python core developers who are working on the :mod:" -"`pickle`; ordinary users of the :mod:`pickle` module probably won't find " -"the :mod:`pickletools` module relevant." +"module are useful for Python core developers who are working on " +"the :mod:`pickle`; ordinary users of the :mod:`pickle` module probably won't " +"find the :mod:`pickletools` module relevant." msgstr "" msgid "Command line usage" diff --git a/library/pkgutil.po b/library/pkgutil.po index 58cd770bf5..f63bcc949a 100644 --- a/library/pkgutil.po +++ b/library/pkgutil.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!pkgutil` --- Package extension utility" msgstr "" msgid "**Source code:** :source:`Lib/pkgutil.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/pkgutil.py`" msgid "" "This module provides utilities for the import system, in particular package " @@ -49,19 +49,20 @@ msgstr "" msgid "" "For each directory on :data:`sys.path` that has a subdirectory that matches " -"the package name, add the subdirectory to the package's :attr:`~module." -"__path__`. This is useful if one wants to distribute different parts of a " -"single logical package as multiple directories." +"the package name, add the subdirectory to the " +"package's :attr:`~module.__path__`. This is useful if one wants to " +"distribute different parts of a single logical package as multiple " +"directories." msgstr "" msgid "" "It also looks for :file:`\\*.pkg` files beginning where ``*`` matches the " -"*name* argument. This feature is similar to :file:`\\*.pth` files (see the :" -"mod:`site` module for more information), except that it doesn't special-case " -"lines starting with ``import``. A :file:`\\*.pkg` file is trusted at face " -"value: apart from skipping blank lines and ignoring comments, all entries " -"found in a :file:`\\*.pkg` file are added to the path, regardless of whether " -"they exist on the filesystem (this is a feature)." +"*name* argument. This feature is similar to :file:`\\*.pth` files (see " +"the :mod:`site` module for more information), except that it doesn't special-" +"case lines starting with ``import``. A :file:`\\*.pkg` file is trusted at " +"face value: apart from skipping blank lines and ignoring comments, all " +"entries found in a :file:`\\*.pkg` file are added to the path, regardless of " +"whether they exist on the filesystem (this is a feature)." msgstr "" msgid "" @@ -71,21 +72,21 @@ msgid "" msgstr "" msgid "" -"It is assumed that :data:`sys.path` is a sequence. Items of :data:`sys." -"path` that are not strings referring to existing directories are ignored. " -"Unicode items on :data:`sys.path` that cause errors when used as filenames " -"may cause this function to raise an exception (in line with :func:`os.path." -"isdir` behavior)." +"It is assumed that :data:`sys.path` is a sequence. Items " +"of :data:`sys.path` that are not strings referring to existing directories " +"are ignored. Unicode items on :data:`sys.path` that cause errors when used " +"as filenames may cause this function to raise an exception (in line " +"with :func:`os.path.isdir` behavior)." msgstr "" msgid "Retrieve a 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`." +"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 "" @@ -108,8 +109,8 @@ msgid "" msgstr "" msgid "" -"The cache (or part of it) can be cleared manually if a rescan of :data:`sys." -"path_hooks` is necessary." +"The cache (or part of it) can be cleared manually if a rescan " +"of :data:`sys.path_hooks` is necessary." msgstr "" msgid "Get a :term:`loader` object for *module_or_name*." @@ -127,9 +128,10 @@ 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`)." +"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 "" @@ -156,8 +158,8 @@ msgstr "" msgid "" "Only works for a :term:`finder` which defines an ``iter_modules()`` method. " "This interface is non-standard, so the module also provides implementations " -"for :class:`importlib.machinery.FileFinder` and :class:`zipimport." -"zipimporter`." +"for :class:`importlib.machinery.FileFinder` " +"and :class:`zipimport.zipimporter`." msgstr "" msgid "" @@ -174,9 +176,9 @@ msgstr "" msgid "" "*onerror* is a function which gets called with one argument (the name of the " "package which was being imported) if any exception occurs while trying to " -"import a package. If no *onerror* function is supplied, :exc:" -"`ImportError`\\s are caught and ignored, while all other exceptions are " -"propagated, terminating the search." +"import a package. If no *onerror* function is " +"supplied, :exc:`ImportError`\\s are caught and ignored, while all other " +"exceptions are propagated, terminating the search." msgstr "" msgid "Examples::" @@ -194,12 +196,11 @@ msgid "Get a resource from a package." msgstr "" msgid "" -"This is a wrapper for the :term:`loader` :meth:`get_data ` API. The *package* argument should be the name of " -"a package, in standard module format (``foo.bar``). The *resource* argument " -"should be in the form of a relative filename, using ``/`` as the path " -"separator. The parent directory name ``..`` is not allowed, and nor is a " -"rooted name (starting with a ``/``)." +"This is a wrapper for the :term:`loader` :meth:`get_data " +"` API. The *package* argument should " +"be the name of a package, in standard module format (``foo.bar``). The " +"*resource* argument should be in the form of a relative filename, using ``/" +"`` as the path separator." msgstr "" msgid "" @@ -207,6 +208,12 @@ msgid "" "resource." msgstr "" +msgid "" +"This function uses the :term:`loader` " +"method :func:`~importlib.abc.FileLoader.get_data` to support modules " +"installed in the filesystem, but also in zip files, databases, or elsewhere." +msgstr "" + msgid "" "For packages located in the filesystem, which have already been imported, " "this is the rough equivalent of::" @@ -217,21 +224,47 @@ msgid "" "data = open(os.path.join(d, resource), 'rb').read()" msgstr "" +msgid "" +"Like the :func:`open` function, :func:`!get_data` can follow parent " +"directories (``../``) and absolute paths (starting with ``/`` or ``C:/``, " +"for example). It can open compilation/installation artifacts like ``.py`` " +"and ``.pyc`` files or files with :func:`reserved filenames " +"`. To be compatible with non-filesystem loaders, avoid " +"using these features." +msgstr "" + +msgid "" +"This function is intended for trusted input. It does not verify that " +"*resource* \"belongs\" to *package*." +msgstr "" + +msgid "" +"If you use a user-provided *resource* path, consider verifying it. For " +"example, require an alphanumeric filename with a known extension, or install " +"and check a list of known resources." +msgstr "" + msgid "" "If the package cannot be located or loaded, or it uses a :term:`loader` " -"which does not support :meth:`get_data `, then ``None`` is returned. In particular, the :term:`loader` " -"for :term:`namespace packages ` does not support :meth:" -"`get_data `." +"which does not support :meth:`get_data " +"`, then ``None`` is returned. In " +"particular, the :term:`loader` for :term:`namespace packages ` does not support :meth:`get_data " +"`." +msgstr "" + +msgid "" +"The :mod:`importlib.resources` module provides structured access to module " +"resources." 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." +"This functionality is used in numerous places in the standard library " +"(see :issue:`12915`) - and equivalent functionality is also in widely used " +"third-party packages such as setuptools, Django and Pyramid." msgstr "" msgid "" diff --git a/library/platform.po b/library/platform.po index b1a0b83556..89eb10d5a0 100644 --- a/library/platform.po +++ b/library/platform.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,14 +27,14 @@ msgid ":mod:`!platform` --- Access to underlying platform's identifying data" msgstr "" msgid "**Source code:** :source:`Lib/platform.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/platform.py`" msgid "" "Specific platforms listed alphabetically, with Linux included in the Unix " "section." msgstr "" -msgid "Cross Platform" +msgid "Cross platform" msgstr "" msgid "" @@ -80,6 +80,11 @@ msgid "" "the value cannot be determined." msgstr "" +msgid "" +"The output is platform-dependent and may differ in casing and naming " +"conventions." +msgstr "" + msgid "" "Returns the computer's network name (may not be fully qualified!). An empty " "string is returned if the value cannot be determined." @@ -163,6 +168,11 @@ msgid "" "is returned if the value cannot be determined." msgstr "" +msgid "" +"On iOS and Android, this is the user-facing OS release. To obtain the Darwin " +"or Linux kernel release, use :func:`os.uname`." +msgstr "" + msgid "" "Returns the system/OS name, such as ``'Linux'``, ``'Darwin'``, ``'Java'``, " "``'Windows'``. An empty string is returned if the value cannot be determined." @@ -185,23 +195,20 @@ msgid "" "string is returned if the value cannot be determined." msgstr "" -msgid "" -"On iOS and Android, this is the user-facing OS version. To obtain the Darwin " -"or Linux kernel version, use :func:`os.uname`." -msgstr "" - msgid "" "Fairly portable uname interface. Returns a :func:`~collections.namedtuple` " -"containing six attributes: :attr:`system`, :attr:`node`, :attr:`release`, :" -"attr:`version`, :attr:`machine`, and :attr:`processor`." +"containing six " +"attributes: :attr:`system`, :attr:`node`, :attr:`release`, :attr:`version`, :attr:`machine`, " +"and :attr:`processor`." msgstr "" msgid ":attr:`processor` is resolved late, on demand." msgstr "" msgid "" -"Note: the first two attribute names differ from the names presented by :func:" -"`os.uname`, where they are named :attr:`sysname` and :attr:`nodename`." +"Note: the first two attribute names differ from the names presented " +"by :func:`os.uname`, where they are named :attr:`!sysname` and :attr:`!" +"nodename`." msgstr "" msgid "Entries which cannot be determined are set to ``''``." @@ -213,7 +220,7 @@ msgstr "" msgid ":attr:`processor` is resolved late instead of immediately." msgstr "" -msgid "Java Platform" +msgid "Java platform" msgstr "" msgid "Version interface for Jython." @@ -231,7 +238,7 @@ msgid "" "support." msgstr "" -msgid "Windows Platform" +msgid "Windows platform" msgstr "" msgid "" @@ -246,8 +253,8 @@ msgid "" "As a hint: *ptype* is ``'Uniprocessor Free'`` on single processor NT " "machines and ``'Multiprocessor Free'`` on multi processor machines. The " "``'Free'`` refers to the OS version being free of debugging code. It could " -"also state ``'Checked'`` which means the OS version uses debugging code, i." -"e. code that checks arguments, ranges, etc." +"also state ``'Checked'`` which means the OS version uses debugging code, " +"i.e. code that checks arguments, ranges, etc." msgstr "" msgid "" @@ -262,7 +269,7 @@ msgid "" "recognized as an IoT edition." msgstr "" -msgid "macOS Platform" +msgid "macOS platform" msgstr "" msgid "" @@ -276,12 +283,12 @@ msgid "" "strings." msgstr "" -msgid "iOS Platform" +msgid "iOS platform" msgstr "" msgid "" -"Get iOS version information and return it as a :func:`~collections." -"namedtuple` with the following attributes:" +"Get iOS version information and return it as " +"a :func:`~collections.namedtuple` with the following attributes:" msgstr "" msgid "``system`` is the OS name; either ``'iOS'`` or ``'iPadOS'``." @@ -305,7 +312,7 @@ msgid "" "parameters." msgstr "" -msgid "Unix Platforms" +msgid "Unix platforms" msgstr "" msgid "" @@ -324,7 +331,7 @@ msgstr "" msgid "The file is read and scanned in chunks of *chunksize* bytes." msgstr "" -msgid "Linux Platforms" +msgid "Linux platforms" msgstr "" msgid "" @@ -368,7 +375,7 @@ msgid "" " return ids" msgstr "" -msgid "Android Platform" +msgid "Android platform" msgstr "" msgid "" @@ -382,8 +389,8 @@ msgstr "" msgid "" "``api_level`` - API level of the running device, as an integer (e.g. ``34`` " -"for Android 14). To get the API level which Python was built against, see :" -"func:`sys.getandroidapilevel`." +"for Android 14). To get the API level which Python was built against, " +"see :func:`sys.getandroidapilevel`." msgstr "" msgid "" @@ -407,6 +414,37 @@ msgid "" msgstr "" msgid "" -"Google maintains a `list of known model and device names `__." +"Google maintains a `list of known model and device names `__." +msgstr "" + +msgid "Command-line usage" +msgstr "" + +msgid "" +":mod:`platform` can also be invoked directly using the :option:`-m` switch " +"of the interpreter::" +msgstr "" + +msgid "python -m platform [--terse] [--nonaliased] [{nonaliased,terse} ...]" +msgstr "" + +msgid "The following options are accepted:" +msgstr "" + +msgid "" +"Print terse information about the platform. This is equivalent to " +"calling :func:`platform.platform` with the *terse* argument set to ``True``." +msgstr "" + +msgid "" +"Print platform information without system/OS name aliasing. This is " +"equivalent to calling :func:`platform.platform` with the *aliased* argument " +"set to ``True``." +msgstr "" + +msgid "" +"You can also pass one or more positional arguments (``terse``, " +"``nonaliased``) to explicitly control the output format. These behave " +"similarly to their corresponding options." msgstr "" diff --git a/library/plistlib.po b/library/plistlib.po index c4f0e5ee9c..ae16b9796e 100644 --- a/library/plistlib.po +++ b/library/plistlib.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# haaritsubaki, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!plistlib` --- Generate and parse Apple ``.plist`` files" msgstr "" msgid "**Source code:** :source:`Lib/plistlib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/plistlib.py`" msgid "" "This module provides an interface for reading and writing the \"property " @@ -43,13 +42,13 @@ msgid "" msgstr "" msgid "" -"To write out and to parse a plist file, use the :func:`dump` and :func:" -"`load` functions." +"To write out and to parse a plist file, use the :func:`dump` " +"and :func:`load` functions." msgstr "" msgid "" -"To work with plist data in bytes or string objects, use :func:`dumps` and :" -"func:`loads`." +"To work with plist data in bytes or string objects, use :func:`dumps` " +"and :func:`loads`." msgstr "" msgid "" @@ -173,8 +172,9 @@ msgid "" msgstr "" msgid "" -"Return *value* as a plist-formatted bytes object. See the documentation for :" -"func:`dump` for an explanation of the keyword arguments of this function." +"Return *value* as a plist-formatted bytes object. See the documentation " +"for :func:`dump` for an explanation of the keyword arguments of this " +"function." msgstr "" msgid "The following classes are available:" @@ -210,7 +210,7 @@ msgid "Generating a plist::" msgstr "" msgid "" -"import datetime\n" +"import datetime as dt\n" "import plistlib\n" "\n" "pl = dict(\n" @@ -226,7 +226,7 @@ msgid "" " ),\n" " someData = b\"\",\n" " someMoreData = b\"\" * 10,\n" -" aDate = datetime.datetime.now()\n" +" aDate = dt.datetime.now()\n" ")\n" "print(plistlib.dumps(pl).decode())" msgstr "" diff --git a/library/poplib.po b/library/poplib.po index abc16e39b8..966e6a06ea 100644 --- a/library/poplib.po +++ b/library/poplib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,13 +27,13 @@ msgid ":mod:`!poplib` --- POP3 protocol client" msgstr "" msgid "**Source code:** :source:`Lib/poplib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/poplib.py`" msgid "" "This module defines a class, :class:`POP3`, which encapsulates a connection " -"to a POP3 server and implements the protocol as defined in :rfc:`1939`. The :" -"class:`POP3` class supports both the minimal and optional command sets from :" -"rfc:`1939`. The :class:`POP3` class also supports the ``STLS`` command " +"to a POP3 server and implements the protocol as defined in :rfc:`1939`. " +"The :class:`POP3` class supports both the minimal and optional command sets " +"from :rfc:`1939`. The :class:`POP3` class also supports the ``STLS`` command " "introduced in :rfc:`2595` to enable encrypted communication on an already " "established connection." msgstr "" @@ -47,8 +47,9 @@ msgstr "" msgid "" "Note that POP3, though widely supported, is obsolescent. The implementation " "quality of POP3 servers varies widely, and too many are quite poor. If your " -"mailserver supports IMAP, you would be better off using the :class:`imaplib." -"IMAP4` class, as IMAP servers tend to be better implemented." +"mailserver supports IMAP, you would be better off using " +"the :class:`imaplib.IMAP4` class, as IMAP servers tend to be better " +"implemented." msgstr "" msgid "Availability" @@ -76,14 +77,14 @@ msgid "" msgstr "" msgid "" -"All commands will raise an :ref:`auditing event ` ``poplib." -"putline`` with arguments ``self`` and ``line``, where ``line`` is the bytes " -"about to be sent to the remote host." +"All commands will raise an :ref:`auditing event ` " +"``poplib.putline`` with arguments ``self`` and ``line``, where ``line`` is " +"the bytes about to be sent to the remote host." msgstr "" msgid "" -"If the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to prevent the creation of a non-blocking socket." +"If the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to prevent the creation of a non-blocking socket." msgstr "" msgid "" @@ -100,8 +101,9 @@ msgid "*context* parameter added." msgstr "" msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The class now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "The deprecated *keyfile* and *certfile* parameters have been removed." @@ -244,8 +246,9 @@ msgid "" msgstr "" msgid "" -"This method supports hostname checking via :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"This method supports hostname checking " +"via :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "" diff --git a/library/posix.po b/library/posix.po index 44b7740e29..4a9aba1fb6 100644 --- a/library/posix.po +++ b/library/posix.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2024 -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,15 +36,15 @@ msgid "Availability" msgstr "Dostępność" msgid "" -"**Do not import this module directly.** Instead, import the module :mod:" -"`os`, which provides a *portable* version of this interface. On Unix, the :" -"mod:`os` module provides a superset of the :mod:`posix` interface. On non-" -"Unix operating systems the :mod:`posix` module is not available, but a " -"subset is always available through the :mod:`os` interface. Once :mod:`os` " -"is imported, there is *no* performance penalty in using it instead of :mod:" -"`posix`. In addition, :mod:`os` provides some additional functionality, " -"such as automatically calling :func:`~os.putenv` when an entry in ``os." -"environ`` is changed." +"**Do not import this module directly.** Instead, import the " +"module :mod:`os`, which provides a *portable* version of this interface. On " +"Unix, the :mod:`os` module provides a superset of the :mod:`posix` " +"interface. On non-Unix operating systems the :mod:`posix` module is not " +"available, but a subset is always available through the :mod:`os` " +"interface. Once :mod:`os` is imported, there is *no* performance penalty in " +"using it instead of :mod:`posix`. In addition, :mod:`os` provides some " +"additional functionality, such as automatically calling :func:`~os.putenv` " +"when an entry in ``os.environ`` is changed." msgstr "" msgid "" @@ -59,10 +57,10 @@ msgstr "" msgid "" "Several operating systems (including AIX and Solaris) provide support for " -"files that are larger than 2 GiB from a C programming model where :c:expr:" -"`int` and :c:expr:`long` are 32-bit values. This is typically accomplished " -"by defining the relevant size and offset types as 64-bit values. Such files " -"are sometimes referred to as :dfn:`large files`." +"files that are larger than 2 GiB from a C programming model " +"where :c:expr:`int` and :c:expr:`long` are 32-bit values. This is typically " +"accomplished by defining the relevant size and offset types as 64-bit " +"values. Such files are sometimes referred to as :dfn:`large files`." msgstr "" msgid "" @@ -111,8 +109,8 @@ msgid "" "Modifying this dictionary does not affect the string environment passed on " "by :func:`~os.execv`, :func:`~os.popen` or :func:`~os.system`; if you need " "to change the environment, pass ``environ`` to :func:`~os.execve` or add " -"variable assignments and export statements to the command string for :func:" -"`~os.system` or :func:`~os.popen`." +"variable assignments and export statements to the command string " +"for :func:`~os.system` or :func:`~os.popen`." msgstr "" msgid "On Unix, keys and values are bytes." @@ -120,10 +118,10 @@ msgstr "" msgid "" "The :mod:`os` module provides an alternate implementation of ``environ`` " -"which updates the environment on modification. Note also that updating :data:" -"`os.environ` will render this dictionary obsolete. Use of the :mod:`os` " -"module version of this is recommended over direct access to the :mod:`posix` " -"module." +"which updates the environment on modification. Note also that " +"updating :data:`os.environ` will render this dictionary obsolete. Use of " +"the :mod:`os` module version of this is recommended over direct access to " +"the :mod:`posix` module." msgstr "" msgid "module" diff --git a/library/pprint.po b/library/pprint.po index c51156b9f4..2b6d199599 100644 --- a/library/pprint.po +++ b/library/pprint.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Maciej Olko , 2024 -# Wiktor Matuszewski , 2024 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 +27,7 @@ msgid ":mod:`!pprint` --- Data pretty printer" msgstr "" msgid "**Source code:** :source:`Lib/pprint.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/pprint.py`" msgid "" "The :mod:`pprint` module provides a capability to \"pretty-print\" arbitrary " @@ -47,9 +44,6 @@ msgid "" "adjustable by the *width* parameter defaulting to 80 characters." msgstr "" -msgid "Dictionaries are sorted by key before the display is computed." -msgstr "" - msgid "Added support for pretty-printing :class:`types.SimpleNamespace`." msgstr "" @@ -61,9 +55,9 @@ msgstr "Zadania" msgid "" "Prints the formatted representation of *object*, followed by a newline. This " -"function may be used in the interactive interpreter instead of the :func:" -"`print` function for inspecting values. Tip: you can reassign ``print = " -"pprint.pp`` for use within a scope." +"function may be used in the interactive interpreter instead of " +"the :func:`print` function for inspecting values. Tip: you can reassign " +"``print = pprint.pp`` for use within a scope." msgstr "" msgid "Parameters" @@ -73,8 +67,9 @@ msgid "The object to be printed." msgstr "" msgid "" -"A file-like object to which the output will be written by calling its :meth:" -"`!write` method. If ``None`` (the default), :data:`sys.stdout` is used." +"A file-like object to which the output will be written by calling " +"its :meth:`!write` method. If ``None`` (the default), :data:`sys.stdout` is " +"used." msgstr "" msgid "The amount of indentation added for each nesting level." @@ -137,11 +132,12 @@ msgstr "" msgid "" "Return a string representation of *object*, protected against recursion in " -"some common data structures, namely instances of :class:`dict`, :class:" -"`list` and :class:`tuple` or subclasses whose ``__repr__`` has not been " -"overridden. If the representation of object exposes a recursive entry, the " -"recursive reference will be represented as ````. The representation is not otherwise formatted." +"some common data structures, namely instances " +"of :class:`dict`, :class:`list` and :class:`tuple` or subclasses whose " +"``__repr__`` has not been overridden. If the representation of object " +"exposes a recursive entry, the recursive reference will be represented as " +"````. The representation is not " +"otherwise formatted." msgstr "" msgid "PrettyPrinter Objects" @@ -190,9 +186,9 @@ msgstr "" msgid "" "Determine if the formatted representation of the object is \"readable,\" or " "can be used to reconstruct the value using :func:`eval`. Note that this " -"returns ``False`` for recursive objects. If the *depth* parameter of the :" -"class:`PrettyPrinter` is set and the object is deeper than allowed, this " -"returns ``False``." +"returns ``False`` for recursive objects. If the *depth* parameter of " +"the :class:`PrettyPrinter` is set and the object is deeper than allowed, " +"this returns ``False``." msgstr "" msgid "Determine if the object requires a recursive representation." @@ -226,8 +222,8 @@ msgstr "Przykład" msgid "" "To demonstrate several uses of the :func:`~pprint.pp` function and its " -"parameters, let's fetch information about a project from `PyPI `_::" +"parameters, let's fetch information about a project from `PyPI `_::" msgstr "" msgid "" diff --git a/library/profile.po b/library/profile.po index 2f7a83b834..5786ce4562 100644 --- a/library/profile.po +++ b/library/profile.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,7 +28,7 @@ msgid "The Python Profilers" msgstr "" msgid "**Source code:** :source:`Lib/profile.py` and :source:`Lib/pstats.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/profile.py`" msgid "Introduction to the profilers" msgstr "" @@ -53,19 +53,20 @@ msgid "" msgstr "" msgid "" -":mod:`profile`, a pure Python module whose interface is imitated by :mod:" -"`cProfile`, but which adds significant overhead to profiled programs. If " -"you're trying to extend the profiler in some way, the task might be easier " -"with this module. Originally designed and written by Jim Roskind." +":mod:`profile`, a pure Python module whose interface is imitated " +"by :mod:`cProfile`, but which adds significant overhead to profiled " +"programs. If you're trying to extend the profiler in some way, the task " +"might be easier with this module. Originally designed and written by Jim " +"Roskind." msgstr "" msgid "" "The profiler modules are designed to provide an execution profile for a " -"given program, not for benchmarking purposes (for that, there is :mod:" -"`timeit` for reasonably accurate results). This particularly applies to " -"benchmarking Python code against C code: the profilers introduce overhead " -"for Python code, but not for C-level functions, and so the C code would seem " -"faster than any Python one." +"given program, not for benchmarking purposes (for that, there " +"is :mod:`timeit` for reasonably accurate results). This particularly " +"applies to benchmarking Python code against C code: the profilers introduce " +"overhead for Python code, but not for C-level functions, and so the C code " +"would seem faster than any Python one." msgstr "" msgid "Instant User's Manual" @@ -325,7 +326,7 @@ msgid "" msgstr "" msgid "exec(command, __main__.__dict__, __main__.__dict__)" -msgstr "" +msgstr "exec(polecenie, __main__.__dict__, __main__.__dict__)" msgid "" "and gathers profiling statistics from the execution. If no file name is " @@ -341,7 +342,7 @@ msgid "" msgstr "" msgid "exec(command, globals, locals)" -msgstr "" +msgstr "exec(polecenie, globalne, lokalne)" msgid "and gathers profiling statistics as in the :func:`run` function above." msgstr "" @@ -394,7 +395,7 @@ msgid "" msgstr "" msgid "Added context manager support." -msgstr "" +msgstr "Dodano obsługę menedżera kontekstu v" msgid "Start collecting profiling data. Only in :mod:`cProfile`." msgstr "" @@ -482,19 +483,20 @@ msgid "" "printout to fit within (close to) 80 columns. This method modifies the " "object, and the stripped information is lost. After performing a strip " "operation, the object is considered to have its entries in a \"random\" " -"order, as it was just after object initialization and loading. If :meth:" -"`~pstats.Stats.strip_dirs` causes two function names to be indistinguishable " -"(they are on the same line of the same filename, and have the same function " -"name), then the statistics for these two entries are accumulated into a " -"single entry." +"order, as it was just after object initialization and loading. " +"If :meth:`~pstats.Stats.strip_dirs` causes two function names to be " +"indistinguishable (they are on the same line of the same filename, and have " +"the same function name), then the statistics for these two entries are " +"accumulated into a single entry." msgstr "" msgid "" "This method of the :class:`Stats` class accumulates additional profiling " "information into the current profiling object. Its arguments should refer " -"to filenames created by the corresponding version of :func:`profile.run` or :" -"func:`cProfile.run`. Statistics for identically named (re: file, line, name) " -"functions are automatically accumulated into single function statistics." +"to filenames created by the corresponding version of :func:`profile.run` " +"or :func:`cProfile.run`. Statistics for identically named (re: file, line, " +"name) functions are automatically accumulated into single function " +"statistics." msgstr "" msgid "" @@ -640,12 +642,12 @@ msgstr "" msgid "" "Note that all sorts on statistics are in descending order (placing most time " "consuming items first), where as name, file, and line number searches are in " -"ascending order (alphabetical). The subtle distinction between ``SortKey." -"NFL`` and ``SortKey.STDNAME`` is that the standard name is a sort of the " -"name as printed, which means that the embedded line numbers get compared in " -"an odd way. For example, lines 3, 20, and 40 would (if the file names were " -"the same) appear in the string order 20, 3 and 40. In contrast, ``SortKey." -"NFL`` does a numeric compare of the line numbers. In fact, " +"ascending order (alphabetical). The subtle distinction between " +"``SortKey.NFL`` and ``SortKey.STDNAME`` is that the standard name is a sort " +"of the name as printed, which means that the embedded line numbers get " +"compared in an odd way. For example, lines 3, 20, and 40 would (if the file " +"names were the same) appear in the string order 20, 3 and 40. In contrast, " +"``SortKey.NFL`` does a numeric compare of the line numbers. In fact, " "``sort_stats(SortKey.NFL)`` is the same as ``sort_stats(SortKey.NAME, " "SortKey.FILENAME, SortKey.LINE)``." msgstr "" @@ -673,9 +675,10 @@ msgid "" msgstr "" msgid "" -"The order of the printing is based on the last :meth:`~pstats.Stats." -"sort_stats` operation done on the object (subject to caveats in :meth:" -"`~pstats.Stats.add` and :meth:`~pstats.Stats.strip_dirs`)." +"The order of the printing is based on the " +"last :meth:`~pstats.Stats.sort_stats` operation done on the object (subject " +"to caveats in :meth:`~pstats.Stats.add` " +"and :meth:`~pstats.Stats.strip_dirs`)." msgstr "" msgid "" @@ -683,7 +686,7 @@ msgid "" "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 " +"select a percentage of lines), or a string that will be 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::" @@ -785,7 +788,7 @@ msgid "" msgstr "" msgid "Limitations" -msgstr "" +msgstr "Ograniczenia" msgid "" "One limitation has to do with accuracy of timing information. There is a " @@ -880,7 +883,7 @@ msgid "" msgstr "" msgid "Using a custom timer" -msgstr "" +msgstr "Korzystanie z niestandardowego timera" msgid "" "If you want to change how current time is determined (for example, to force " @@ -942,8 +945,8 @@ msgstr "" msgid "" "Python 3.3 adds several new functions in :mod:`time` that can be used to " -"make precise measurements of process or wall-clock time. For example, see :" -"func:`time.perf_counter`." +"make precise measurements of process or wall-clock time. For example, " +"see :func:`time.perf_counter`." msgstr "" msgid "deterministic profiling" diff --git a/library/pty.po b/library/pty.po index e71c89a197..ef3fb2ad1d 100644 --- a/library/pty.po +++ b/library/pty.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!pty` --- Pseudo-terminal utilities" msgstr "" msgid "**Source code:** :source:`Lib/pty.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/pty.py`" msgid "" "The :mod:`pty` module defines operations for handling the pseudo-terminal " diff --git a/library/pwd.po b/library/pwd.po index be3d7925e9..a6a99f9d0a 100644 --- a/library/pwd.po +++ b/library/pwd.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 +41,7 @@ msgid "" msgstr "" msgid "Index" -msgstr "" +msgstr "Indeks" msgid "Attribute" msgstr "atrybut" diff --git a/library/py_compile.po b/library/py_compile.po index 1591092652..ee9a88b5cc 100644 --- a/library/py_compile.po +++ b/library/py_compile.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: haaritsubaki, 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!py_compile` --- Compile Python source files" msgstr "" msgid "**Source code:** :source:`Lib/py_compile.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/py_compile.py`" msgid "" "The :mod:`py_compile` module provides a function to generate a byte-code " @@ -64,9 +64,9 @@ msgid "" "The *doraise* and *quiet* arguments determine how errors are handled while " "compiling file. If *quiet* is 0 or 1, and *doraise* is false, the default " "behaviour is enabled: an error string is written to ``sys.stderr``, and the " -"function returns ``None`` instead of a path. If *doraise* is true, a :exc:" -"`PyCompileError` is raised instead. However if *quiet* is 2, no message is " -"written, and *doraise* has no effect." +"function returns ``None`` instead of a path. If *doraise* is true, " +"a :exc:`PyCompileError` is raised instead. However if *quiet* is 2, no " +"message is written, and *doraise* has no effect." msgstr "" msgid "" @@ -79,16 +79,16 @@ msgid "" msgstr "" msgid "" -"*optimize* controls the optimization level and is passed to the built-in :" -"func:`compile` function. The default of ``-1`` selects the optimization " +"*optimize* controls the optimization level and is passed to the built-" +"in :func:`compile` function. The default of ``-1`` selects the optimization " "level of the current interpreter." msgstr "" msgid "" "*invalidation_mode* should be a member of the :class:`PycInvalidationMode` " "enum and controls how the generated bytecode cache is invalidated at " -"runtime. The default is :attr:`PycInvalidationMode.CHECKED_HASH` if the :" -"envvar:`SOURCE_DATE_EPOCH` environment variable is set, otherwise the " +"runtime. The default is :attr:`PycInvalidationMode.CHECKED_HASH` if " +"the :envvar:`SOURCE_DATE_EPOCH` environment variable is set, otherwise the " "default is :attr:`PycInvalidationMode.TIMESTAMP`." msgstr "" @@ -109,8 +109,8 @@ msgstr "" msgid "" "The *invalidation_mode* parameter was added as specified in :pep:`552`. If " "the :envvar:`SOURCE_DATE_EPOCH` environment variable is set, " -"*invalidation_mode* will be forced to :attr:`PycInvalidationMode." -"CHECKED_HASH`." +"*invalidation_mode* will be forced " +"to :attr:`PycInvalidationMode.CHECKED_HASH`." msgstr "" msgid "" diff --git a/library/pyclbr.po b/library/pyclbr.po index 6a142a526d..2d4466ceb7 100644 --- a/library/pyclbr.po +++ b/library/pyclbr.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Waldemar Stoczkowski, 2023 -# Maciej Olko , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:11+0000\n" -"Last-Translator: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!pyclbr` --- Python module browser support" msgstr "" msgid "**Source code:** :source:`Lib/pyclbr.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/pyclbr.py`" msgid "" "The :mod:`pyclbr` module provides limited information about the functions, " diff --git a/library/pydoc.po b/library/pydoc.po index 7dbd0e7997..b099696ce9 100644 --- a/library/pydoc.po +++ b/library/pydoc.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!pydoc` --- Documentation generator and online help system" msgstr "" msgid "**Source code:** :source:`Lib/pydoc.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/pydoc.py`" msgid "" "The :mod:`!pydoc` module automatically generates documentation from Python " @@ -41,8 +41,8 @@ msgid "" "of the object, and recursively of its documentable members. If there is no " "docstring, :mod:`!pydoc` tries to obtain a description from the block of " "comment lines just above the definition of the class, function or method in " -"the source file, or at the top of the module (see :func:`inspect." -"getcomments`)." +"the source file, or at the top of the module " +"(see :func:`inspect.getcomments`)." msgstr "" msgid "" @@ -76,9 +76,10 @@ msgstr "" msgid "" "When printing output to the console, :program:`pydoc` attempts to paginate " -"the output for easier reading. If either the :envvar:`MANPAGER` or the :" -"envvar:`PAGER` environment variable is set, :program:`pydoc` will use its " -"value as a pagination program. When both are set, :envvar:`MANPAGER` is used." +"the output for easier reading. If either the :envvar:`MANPAGER` or " +"the :envvar:`PAGER` environment variable is set, :program:`pydoc` will use " +"its value as a pagination program. When both are set, :envvar:`MANPAGER` is " +"used." msgstr "" msgid "" @@ -96,11 +97,16 @@ msgstr "" msgid "" "You can also use :program:`pydoc` to start an HTTP server on the local " -"machine that will serve documentation to visiting web browsers. :program:" -"`python -m pydoc -p 1234` will start a HTTP server on port 1234, allowing " -"you to browse the documentation at ``http://localhost:1234/`` in your " -"preferred web browser. Specifying ``0`` as the port number will select an " -"arbitrary unused port." +"machine that will serve documentation to visiting web " +"browsers. :program:`python -m pydoc -p 1234` will start a HTTP server on " +"port 1234, allowing you to browse the documentation at ``http://" +"localhost:1234/`` in your preferred web browser. Specifying ``0`` as the " +"port number will select an arbitrary unused port." +msgstr "" + +msgid "" +"The :mod:`!pydoc` HTTP server is intended for local use during development " +"and is not suitable for production use." msgstr "" msgid "" @@ -127,11 +133,11 @@ msgid "" msgstr "" msgid "" -"Module docs for core modules are assumed to reside in ``https://docs.python." -"org/X.Y/library/`` where ``X`` and ``Y`` are the major and minor version " -"numbers of the Python interpreter. This can be overridden by setting the :" -"envvar:`!PYTHONDOCS` environment variable to a different URL or to a local " -"directory containing the Library Reference Manual pages." +"Module docs for core modules are assumed to reside in ``https://" +"docs.python.org/X.Y/library/`` where ``X`` and ``Y`` are the major and minor " +"version numbers of the Python interpreter. This can be overridden by " +"setting the :envvar:`!PYTHONDOCS` environment variable to a different URL or " +"to a local directory containing the Library Reference Manual pages." msgstr "" msgid "Added the ``-b`` option." @@ -141,8 +147,9 @@ msgid "The ``-g`` command line option was removed." msgstr "" msgid "" -":mod:`!pydoc` now uses :func:`inspect.signature` rather than :func:`inspect." -"getfullargspec` to extract signature information from callables." +":mod:`!pydoc` now uses :func:`inspect.signature` rather " +"than :func:`inspect.getfullargspec` to extract signature information from " +"callables." msgstr "" msgid "Added the ``-n`` option." diff --git a/library/pyexpat.po b/library/pyexpat.po index 252b3aba21..441a272915 100644 --- a/library/pyexpat.po +++ b/library/pyexpat.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,19 +27,18 @@ msgid ":mod:`!xml.parsers.expat` --- Fast XML parsing using Expat" msgstr "" msgid "" -"The :mod:`pyexpat` module is not secure against maliciously constructed " -"data. If you need to parse untrusted or unauthenticated data see :ref:`xml-" -"vulnerabilities`." +"If you need to parse untrusted or unauthenticated data, see :ref:`xml-" +"security`." msgstr "" msgid "" "The :mod:`xml.parsers.expat` module is a Python interface to the Expat non-" -"validating XML parser. The module provides a single extension type, :class:" -"`xmlparser`, that represents the current state of an XML parser. After an :" -"class:`xmlparser` object has been created, various attributes of the object " -"can be set to handler functions. When an XML document is then fed to the " -"parser, the handler functions are called for the character data and markup " -"in the XML document." +"validating XML parser. The module provides a single extension " +"type, :class:`xmlparser`, that represents the current state of an XML " +"parser. After an :class:`xmlparser` object has been created, various " +"attributes of the object can be set to handler functions. When an XML " +"document is then fed to the parser, the handler functions are called for the " +"character data and markup in the XML document." msgstr "" msgid "" @@ -48,12 +46,14 @@ msgid "" "parser. Direct use of the :mod:`pyexpat` module is deprecated." msgstr "" -msgid "This module provides one exception and one type object:" +msgid "" +"This module provides the following exception, type object and data items:" msgstr "" msgid "" -"The exception raised when Expat reports an error. See section :ref:" -"`expaterror-objects` for more information on interpreting Expat errors." +"The exception raised when Expat reports an error. See " +"section :ref:`expaterror-objects` for more information on interpreting Expat " +"errors." msgstr "" msgid "Alias for :exc:`ExpatError`." @@ -62,6 +62,25 @@ msgstr "" msgid "The type of the return values from the :func:`ParserCreate` function." msgstr "" +msgid "" +"The version string of the Expat library loaded by the interpreter, like " +"``'expat_2.8.4'``." +msgstr "" + +msgid "" +"The version of the Expat library loaded by the interpreter, as a tuple of " +"three integers: major, minor and micro version." +msgstr "" + +msgid "" +"The list of the features with which the loaded Expat library was compiled, " +"as ``(name, value)`` pairs. The value is only meaningful for features which " +"have one, like ``'XML_CONTEXT_BYTES'`` or the default protection limits " +"``'XML_BLAP_ACT_THRES'`` and ``'XML_AT_MAX_AMP'``; for other features, like " +"``'XML_DTD'`` and ``'XML_NS'``, the value is ``0`` and only the presence of " +"the name is significant." +msgstr "" + msgid "The :mod:`xml.parsers.expat` module contains two functions:" msgstr "" @@ -77,6 +96,13 @@ msgid "" "implicit or explicit encoding of the document." msgstr "" +msgid "" +"Parsers created through :func:`!ParserCreate` are called \"root\" parsers, " +"in the sense that they do not have any parent parser attached. Non-root " +"parsers are created by :meth:`parser.ExternalEntityParserCreate " +"`." +msgstr "" + msgid "" "Expat can optionally do XML namespace processing for you, enabled by " "providing a value for *namespace_separator*. The value must be a one-" @@ -117,10 +143,16 @@ msgid "" msgstr "" msgid "" -"Due to limitations in the ``Expat`` library used by :mod:`pyexpat`, the :" -"class:`xmlparser` instance returned can only be used to parse a single XML " -"document. Call ``ParserCreate`` for each document to provide unique parser " -"instances." +"*intern*, if given, must be a dictionary. It is used to intern the names of " +"elements and attributes, and is available as the :attr:`~xmlparser.intern` " +"attribute. By default a new empty dictionary is created for every parser." +msgstr "" + +msgid "" +"Due to limitations in the ``Expat`` library used by :mod:`pyexpat`, " +"the :class:`xmlparser` instance returned can only be used to parse a single " +"XML document. Call ``ParserCreate`` for each document to provide unique " +"parser instances." msgstr "" msgid "`The Expat XML Parser `_" @@ -136,53 +168,59 @@ msgid ":class:`xmlparser` objects have the following methods:" msgstr "" msgid "" -"Parses the contents of the string *data*, calling the appropriate handler " -"functions to process the parsed data. *isfinal* must be true on the final " -"call to this method; it allows the parsing of a single file in fragments, " -"not the submission of multiple files. *data* can be the empty string at any " -"time." +"Parses the contents of *data*, calling the appropriate handler functions to " +"process the parsed data. *data* can be a :term:`bytes-like object` or a " +"string. If it is a string, the encoding declaration in the XML data is " +"ignored, and the data is parsed as already decoded text. *isfinal* must be " +"true on the final call to this method; it allows the parsing of a single " +"file in fragments, not the submission of multiple files. *data* can be empty " +"at any time." msgstr "" msgid "" -"Parse XML data reading from the object *file*. *file* only needs to provide " -"the ``read(nbytes)`` method, returning the empty string when there's no more " -"data." +"Parse XML data reading from the object *file*. *file* only needs to provide " +"the ``read(nbytes)`` method, which returns bytes, and an empty bytes object " +"when there's no more data. Text files are not supported; use :meth:`Parse` " +"for data which is already decoded." msgstr "" msgid "" "Sets the base to be used for resolving relative URIs in system identifiers " "in declarations. Resolving relative identifiers is left to the application: " -"this value will be passed through as the *base* argument to the :func:" -"`ExternalEntityRefHandler`, :func:`NotationDeclHandler`, and :func:" -"`UnparsedEntityDeclHandler` functions." +"this value will be passed through as the *base* argument to " +"the :func:`ExternalEntityRefHandler`, :func:`NotationDeclHandler`, " +"and :func:`UnparsedEntityDeclHandler` functions." msgstr "" msgid "" -"Returns a string containing the base set by a previous call to :meth:" -"`SetBase`, or ``None`` if :meth:`SetBase` hasn't been called." +"Returns a string containing the base set by a previous call " +"to :meth:`SetBase`, or ``None`` if :meth:`SetBase` hasn't been called." msgstr "" msgid "" -"Returns the input data that generated the current event as a string. The " -"data is in the encoding of the entity which contains the text. When called " -"while an event handler is not active, the return value is ``None``." +"Returns the input data which generated the current event as a :class:`bytes` " +"object. The data is in the encoding of the entity which contains the text. " +"It extends to the end of the currently buffered input, therefore it can " +"contain also the data of the following events, and if the event was " +"generated by a large amount of text, not all of it may be available. When " +"called while an event handler is not active, the return value is ``None``." msgstr "" msgid "" "Create a \"child\" parser which can be used to parse an external parsed " "entity referred to by content parsed by the parent parser. The *context* " -"parameter should be the string passed to the :meth:" -"`ExternalEntityRefHandler` handler function, described below. The child " -"parser is created with the :attr:`ordered_attributes` and :attr:" -"`specified_attributes` set to the values of this parser." +"parameter should be the string passed to " +"the :meth:`ExternalEntityRefHandler` handler function, described below. The " +"child parser is created with the :attr:`ordered_attributes` " +"and :attr:`specified_attributes` set to the values of this parser." msgstr "" msgid "" "Control parsing of parameter entities (including the external DTD subset). " -"Possible *flag* values are :const:`XML_PARAM_ENTITY_PARSING_NEVER`, :const:" -"`XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE` and :const:" -"`XML_PARAM_ENTITY_PARSING_ALWAYS`. Return true if setting the flag was " -"successful." +"Possible *flag* values " +"are :const:`XML_PARAM_ENTITY_PARSING_NEVER`, :const:`XML_PARAM_ENTITY_PARSING_UNLESS_STANDALONE` " +"and :const:`XML_PARAM_ENTITY_PARSING_ALWAYS`. Return true if setting the " +"flag was successful." msgstr "" msgid "" @@ -190,8 +228,8 @@ msgid "" "call the :attr:`ExternalEntityRefHandler` with :const:`None` for all " "arguments to allow an alternate DTD to be loaded. If the document does not " "contain a document type declaration, the :attr:`ExternalEntityRefHandler` " -"will still be called, but the :attr:`StartDoctypeDeclHandler` and :attr:" -"`EndDoctypeDeclHandler` will not be called." +"will still be called, but the :attr:`StartDoctypeDeclHandler` " +"and :attr:`EndDoctypeDeclHandler` will not be called." msgstr "" msgid "" @@ -228,8 +266,8 @@ msgstr "" msgid "" "Note that :meth:`SetReparseDeferralEnabled` has been backported to some " -"prior releases of CPython as a security fix. Check for availability of :" -"meth:`SetReparseDeferralEnabled` using :func:`hasattr` if used in code " +"prior releases of CPython as a security fix. Check for availability " +"of :meth:`SetReparseDeferralEnabled` using :func:`hasattr` if used in code " "running across a variety of Python versions." msgstr "" @@ -238,6 +276,110 @@ msgid "" "parser instance." msgstr "" +msgid "" +":class:`!xmlparser` objects have the following methods to tune protections " +"against some common XML vulnerabilities." +msgstr "" + +msgid "" +"Sets the number of output bytes needed to activate protection against " +"`billion laughs`_ attacks." +msgstr "" + +msgid "" +"The number of output bytes includes amplification from entity expansion and " +"reading DTD files." +msgstr "" + +msgid "" +"Parser objects usually have a protection activation threshold of 8 MiB, but " +"the actual default value depends on the underlying Expat library." +msgstr "" + +msgid "" +"An :exc:`ExpatError` is raised if this method is called on a |xml-non-root-" +"parser| parser. The corresponding :attr:`~ExpatError.lineno` " +"and :attr:`~ExpatError.offset` should not be used as they may have no " +"special meaning." +msgstr "" + +msgid "" +"Activation thresholds below 4 MiB are known to break support for DITA 1.3 " +"payload and are hence not recommended." +msgstr "" + +msgid "" +"Sets the maximum tolerated amplification factor for protection against " +"`billion laughs`_ attacks." +msgstr "" + +msgid "" +"The amplification factor is calculated as ``(direct + indirect) / direct`` " +"while parsing, where ``direct`` is the number of bytes read from the primary " +"document in parsing and ``indirect`` is the number of bytes added by " +"expanding entities and reading of external DTD files." +msgstr "" + +msgid "" +"The *max_factor* value must be a non-NaN :class:`float` value greater than " +"or equal to 1.0. Peak amplifications of factor 15,000 for the entire payload " +"and of factor 30,000 in the middle of parsing have been observed with small " +"benign files in practice. In particular, the activation threshold should be " +"carefully chosen to avoid false positives." +msgstr "" + +msgid "" +"Parser objects usually have a maximum amplification factor of 100, but the " +"actual default value depends on the underlying Expat library." +msgstr "" + +msgid "" +"An :exc:`ExpatError` is raised if this method is called on a |xml-non-root-" +"parser| parser or if *max_factor* is outside the valid range. The " +"corresponding :attr:`~ExpatError.lineno` and :attr:`~ExpatError.offset` " +"should not be used as they may have no special meaning." +msgstr "" + +msgid "" +"The maximum amplification factor is only considered if the threshold that " +"can be adjusted " +"by :meth:`.SetBillionLaughsAttackProtectionActivationThreshold` is exceeded." +msgstr "" + +msgid "" +"Sets the number of allocated bytes of dynamic memory needed to activate " +"protection against disproportionate use of RAM." +msgstr "" + +msgid "" +"Parser objects usually have an allocation activation threshold of 64 MiB, " +"but the actual default value depends on the underlying Expat library." +msgstr "" + +msgid "" +"Sets the maximum amplification factor between direct input and bytes of " +"dynamic memory allocated." +msgstr "" + +msgid "" +"The amplification factor is calculated as ``allocated / direct`` while " +"parsing, where ``direct`` is the number of bytes read from the primary " +"document in parsing and ``allocated`` is the number of bytes of dynamic " +"memory allocated in the parser hierarchy." +msgstr "" + +msgid "" +"The *max_factor* value must be a non-NaN :class:`float` value greater than " +"or equal to 1.0. Amplification factors greater than 100.0 can be observed " +"near the start of parsing even with benign files in practice. In particular, " +"the activation threshold should be carefully chosen to avoid false positives." +msgstr "" + +msgid "" +"The maximum amplification factor is only considered if the threshold that " +"can be adjusted by :meth:`.SetAllocTrackerActivationThreshold` is exceeded." +msgstr "" + msgid ":class:`xmlparser` objects have the following attributes:" msgstr "" @@ -249,12 +391,12 @@ msgstr "" msgid "" "Setting this to true causes the :class:`xmlparser` object to buffer textual " -"content returned by Expat to avoid multiple calls to the :meth:" -"`CharacterDataHandler` callback whenever possible. This can improve " -"performance substantially since Expat normally breaks character data into " -"chunks at every line ending. This attribute is false by default, and may be " -"changed at any time. Note that when it is false, data that does not contain " -"newlines may be chunked too." +"content returned by Expat to avoid multiple calls to " +"the :meth:`CharacterDataHandler` callback whenever possible. This can " +"improve performance substantially since Expat normally breaks character data " +"into chunks at every line ending. This attribute is false by default, and " +"may be changed at any time. Note that when it is false, data that does not " +"contain newlines may be chunked too." msgstr "" msgid "" @@ -282,20 +424,33 @@ msgid "" "time." msgstr "" +msgid "" +"The dictionary used to intern the names of elements and attributes. It is " +"either the dictionary passed as the *intern* argument " +"of :func:`ParserCreate`, or a new dictionary created for this parser." +msgstr "" + +msgid "" +"If set to a true value, and namespace processing is enabled, the namespace " +"prefix is reported as the third part of the expanded name, separated by the " +"namespace separator. Names which have no prefix are not affected. By " +"default, this attribute is false; it may be changed at any time." +msgstr "" + msgid "" "The following attributes contain values relating to the most recent error " "encountered by an :class:`xmlparser` object, and will only have correct " -"values once a call to :meth:`Parse` or :meth:`ParseFile` has raised an :exc:" -"`xml.parsers.expat.ExpatError` exception." +"values once a call to :meth:`Parse` or :meth:`ParseFile` has raised " +"an :exc:`xml.parsers.expat.ExpatError` exception." msgstr "" msgid "Byte index at which an error occurred." msgstr "" msgid "" -"Numeric code specifying the problem. This value can be passed to the :func:" -"`ErrorString` function, or compared to one of the constants defined in the " -"``errors`` object." +"Numeric code specifying the problem. This value can be passed to " +"the :func:`ErrorString` function, or compared to one of the constants " +"defined in the ``errors`` object." msgstr "" msgid "Column number at which an error occurred." @@ -323,11 +478,11 @@ msgid "Current line number in the parser input." msgstr "" msgid "" -"Here is the list of handlers that can be set. To set a handler on an :class:" -"`xmlparser` object *o*, use ``o.handlername = func``. *handlername* must be " -"taken from the following list, and *func* must be a callable object " -"accepting the correct number of arguments. The arguments are all strings, " -"unless otherwise stated." +"Here is the list of handlers that can be set. To set a handler on " +"an :class:`xmlparser` object *o*, use ``o.handlername = func``. " +"*handlername* must be taken from the following list, and *func* must be a " +"callable object accepting the correct number of arguments. The arguments " +"are all strings, unless otherwise stated." msgstr "" msgid "" @@ -336,8 +491,7 @@ msgid "" "the encoding of the document text, and an optional \"standalone\" " "declaration. *version* and *encoding* will be strings, and *standalone* will " "be ``1`` if the document is declared standalone, ``0`` if it is declared not " -"to be standalone, or ``-1`` if the standalone clause was omitted. This is " -"only available with Expat version 1.95.0 or newer." +"to be standalone, or ``-1`` if the standalone clause was omitted." msgstr "" msgid "" @@ -345,13 +499,10 @@ msgid "" "DOCTYPE ...``). The *doctypeName* is provided exactly as presented. The " "*systemId* and *publicId* parameters give the system and public identifiers " "if specified, or ``None`` if omitted. *has_internal_subset* will be true if " -"the document contains and internal document declaration subset. This " -"requires Expat version 1.2 or newer." +"the document contains an internal document declaration subset." msgstr "" -msgid "" -"Called when Expat is done parsing the document type declaration. This " -"requires Expat version 1.2 or newer." +msgid "Called when Expat is done parsing the document type declaration." msgstr "" msgid "" @@ -364,20 +515,22 @@ msgid "" "list declaration declares three attributes, this handler is called three " "times, once for each attribute. *elname* is the name of the element to " "which the declaration applies and *attname* is the name of the attribute " -"declared. The attribute type is a string passed as *type*; the possible " -"values are ``'CDATA'``, ``'ID'``, ``'IDREF'``, ... *default* gives the " -"default value for the attribute used when the attribute is not specified by " -"the document instance, or ``None`` if there is no default value " -"(``#IMPLIED`` values). If the attribute is required to be given in the " -"document instance, *required* will be true. This requires Expat version " -"1.95.0 or newer." +"declared. The The attribute type is a string passed as *type*: ``'CDATA'``, " +"``'ID'``, ``'IDREF'``, ``'IDREFS'``, ``'ENTITY'``, ``'ENTITIES'``, " +"``'NMTOKEN'`` or ``'NMTOKENS'``, an enumeration like ``'(x|y)'``, or a " +"notation list like ``'NOTATION(n1|n2)'``. *default* gives the default value " +"for the attribute used when the attribute is not specified by the document " +"instance, or ``None`` if there is no default value (``#IMPLIED`` values). " +"If the attribute is required to be given in the document instance, " +"*required* will be true." msgstr "" msgid "" "Called for the start of every element. *name* is a string containing the " -"element name, and *attributes* is the element attributes. If :attr:" -"`ordered_attributes` is true, this is a list (see :attr:`ordered_attributes` " -"for a full description). Otherwise it's a dictionary mapping names to values." +"element name, and *attributes* is the element attributes. " +"If :attr:`ordered_attributes` is true, this is a list " +"(see :attr:`ordered_attributes` for a full description). Otherwise it's a " +"dictionary mapping names to values." msgstr "" msgid "Called for the end of every element." @@ -389,19 +542,19 @@ msgstr "" msgid "" "Called for character data. This will be called for normal character data, " "CDATA marked content, and ignorable whitespace. Applications which must " -"distinguish these cases can use the :attr:`StartCdataSectionHandler`, :attr:" -"`EndCdataSectionHandler`, and :attr:`ElementDeclHandler` callbacks to " -"collect the required information. Note that the character data may be " -"chunked even if it is short and so you may receive more than one call to :" -"meth:`CharacterDataHandler`. Set the :attr:`buffer_text` instance attribute " -"to ``True`` to avoid that." +"distinguish these cases can use " +"the :attr:`StartCdataSectionHandler`, :attr:`EndCdataSectionHandler`, " +"and :attr:`ElementDeclHandler` callbacks to collect the required " +"information. Note that the character data may be chunked even if it is short " +"and so you may receive more than one call to :meth:`CharacterDataHandler`. " +"Set the :attr:`buffer_text` instance attribute to ``True`` to avoid that." msgstr "" msgid "" -"Called for unparsed (NDATA) entity declarations. This is only present for " -"version 1.2 of the Expat library; for more recent versions, use :attr:" -"`EntityDeclHandler` instead. (The underlying function in the Expat library " -"has been declared obsolete.)" +"Called for unparsed (NDATA) entity declarations. If this handler is not set, " +"such declarations are reported by :attr:`EntityDeclHandler`, which is " +"preferred for new code. (The underlying function in the Expat library has " +"been declared obsolete.)" msgstr "" msgid "" @@ -411,8 +564,7 @@ msgid "" "be ``None`` for parsed entities, and the name of the notation for unparsed " "entities. *is_parameter_entity* will be true if the entity is a parameter " "entity or false for general entities (most applications only need to be " -"concerned with general entities). This is only available starting with " -"version 1.95.0 of the Expat library." +"concerned with general entities)." msgstr "" msgid "" @@ -430,10 +582,10 @@ msgstr "" msgid "" "Called when the closing tag is reached for an element that contained a " "namespace declaration. This is called once for each namespace declaration " -"on the element in the reverse of the order for which the :attr:" -"`StartNamespaceDeclHandler` was called to indicate the start of each " -"namespace declaration's scope. Calls to this handler are made after the " -"corresponding :attr:`EndElementHandler` for the end of the element." +"on the element in the reverse of the order for which " +"the :attr:`StartNamespaceDeclHandler` was called to indicate the start of " +"each namespace declaration's scope. Calls to this handler are made after " +"the corresponding :attr:`EndElementHandler` for the end of the element." msgstr "" msgid "" @@ -442,9 +594,9 @@ msgid "" msgstr "" msgid "" -"Called at the start of a CDATA section. This and :attr:" -"`EndCdataSectionHandler` are needed to be able to identify the syntactical " -"start and end for CDATA sections." +"Called at the start of a CDATA section. This " +"and :attr:`EndCdataSectionHandler` are needed to be able to identify the " +"syntactical start and end for CDATA sections." msgstr "" msgid "Called at the end of a CDATA section." @@ -458,7 +610,7 @@ msgid "" msgstr "" msgid "" -"This is the same as the :func:`DefaultHandler`, but doesn't inhibit " +"This is the same as the :attr:`DefaultHandler`, but doesn't inhibit " "expansion of internal entities. The entity reference will not be passed to " "the default handler." msgstr "" @@ -472,6 +624,14 @@ msgid "" "set, no exception is raised by the parser for this condition." msgstr "" +msgid "" +"Implementing a handler that accesses local files and/or the network may " +"create a vulnerability to `external entity attacks `_ if :class:`xmlparser` is used with user-" +"provided XML content. Please reflect on your `threat model `_ before implementing this handler." +msgstr "" + msgid "" "Called for references to external entities. *base* is the current base, as " "set by a previous call to :meth:`SetBase`. The public and system " @@ -485,13 +645,21 @@ msgid "" "responsible for creating the sub-parser using " "``ExternalEntityParserCreate(context)``, initializing it with the " "appropriate callbacks, and parsing the entity. This handler should return " -"an integer; if it returns ``0``, the parser will raise an :const:" -"`XML_ERROR_EXTERNAL_ENTITY_HANDLING` error, otherwise parsing will continue." +"an integer; if it returns ``0``, the parser will raise " +"an :const:`XML_ERROR_EXTERNAL_ENTITY_HANDLING` error, otherwise parsing will " +"continue." +msgstr "" + +msgid "" +"If this handler is not provided, external entities are reported by " +"the :attr:`DefaultHandler` callback, if provided." msgstr "" msgid "" -"If this handler is not provided, external entities are reported by the :attr:" -"`DefaultHandler` callback, if provided." +"Called for entity references which are not expanded, because the parser did " +"not read the declaration of the entity. This happens when the external DTD " +"subset or an external parameter entity is not parsed. *is_parameter_entity* " +"is true for a parameter entity and false for a general entity." msgstr "" msgid "ExpatError Exceptions" @@ -501,9 +669,9 @@ msgid ":exc:`ExpatError` exceptions have a number of interesting attributes:" msgstr "" msgid "" -"Expat's internal error number for the specific error. The :data:`errors." -"messages ` dictionary maps these error " -"numbers to Expat's error messages. For example::" +"Expat's internal error number for the specific error. " +"The :data:`errors.messages ` dictionary " +"maps these error numbers to Expat's error messages. For example::" msgstr "" msgid "" @@ -589,9 +757,9 @@ msgid "" msgstr "" msgid "" -"The values of the first two fields are constants defined in the :mod:`xml." -"parsers.expat.model` module. These constants can be collected in two " -"groups: the model type group and the quantifier group." +"The values of the first two fields are constants defined in " +"the :mod:`xml.parsers.expat.model` module. These constants can be collected " +"in two groups: the model type group and the quantifier group." msgstr "" msgid "The constants in the model type group are:" @@ -610,6 +778,15 @@ msgstr "" msgid "Elements which are declared to be ``EMPTY`` have this model type." msgstr "" +msgid "" +"The named element allows character data, optionally interspersed with the " +"named children; this is used for content models such as ``(#PCDATA)`` and " +"``(#PCDATA | A | B)*``." +msgstr "" + +msgid "The model names a single element, as for ``A``." +msgstr "" + msgid "" "Models which represent a series of models which follow one after the other " "are indicated with this model type. This is used for models such as ``(A, " @@ -640,8 +817,8 @@ msgid "" "of the :exc:`ExpatError` exception objects raised when an error has " "occurred. Since for backwards compatibility reasons, the constants' value is " "the error *message* and not the numeric error *code*, you do this by " -"comparing its :attr:`code` attribute with :samp:`errors.codes[errors." -"XML_ERROR_{CONSTANT_NAME}]`." +"comparing its :attr:`code` attribute " +"with :samp:`errors.codes[errors.XML_ERROR_{CONSTANT_NAME}]`." msgstr "" msgid "The ``errors`` module has the following attributes:" @@ -686,7 +863,7 @@ msgstr "" msgid "" "The document contains no elements (XML requires all documents to contain " -"exactly one top-level element).." +"exactly one top-level element)." msgstr "" msgid "Expat was not able to allocate memory internally." @@ -725,8 +902,8 @@ msgstr "" msgid "" "The parser determined that the document was not \"standalone\" though it " -"declared itself to be in the XML declaration, and the :attr:" -"`NotStandaloneHandler` was set and returned ``0``." +"declared itself to be in the XML declaration, and " +"the :attr:`NotStandaloneHandler` was set and returned ``0``." msgstr "" msgid "" @@ -737,8 +914,8 @@ msgstr "" msgid "" "A behavioral change was requested after parsing started that can only be " -"changed before parsing has started. This is (currently) only raised by :" -"meth:`UseForeignDTD`." +"changed before parsing has started. This is (currently) only raised " +"by :meth:`UseForeignDTD`." msgstr "" msgid "An undeclared prefix was found when namespace processing was enabled." @@ -752,7 +929,7 @@ msgstr "" msgid "A parameter entity contained incomplete markup." msgstr "" -msgid "The document contained no document element at all." +msgid "There was an error parsing the XML declaration." msgstr "" msgid "There was an error parsing a text declaration in an external entity." @@ -806,8 +983,8 @@ msgstr "Przypisy" msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See https://" -"www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl and https://www.iana." -"org/assignments/character-sets/character-sets.xhtml." +"www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl and https://" +"www.iana.org/assignments/character-sets/character-sets.xhtml." msgstr "" msgid "Expat" diff --git a/library/queue.po b/library/queue.po index 483edd9b56..f2767f45c3 100644 --- a/library/queue.po +++ b/library/queue.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2023, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Transifex Bot <>, 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -23,11 +23,11 @@ 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 ":mod:`queue` --- A synchronized queue class" +msgid ":mod:`!queue` --- A synchronized queue class" msgstr "" msgid "**Source code:** :source:`Lib/queue.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/queue.py`" msgid "" "The :mod:`queue` module implements multi-producer, multi-consumer queues. It " @@ -96,27 +96,55 @@ msgid "" "class that ignores the data item and only compares the priority number::" msgstr "" +msgid "" +"from dataclasses import dataclass, field\n" +"from typing import Any\n" +"\n" +"@dataclass(order=True)\n" +"class PrioritizedItem:\n" +" priority: int\n" +" item: Any=field(compare=False)" +msgstr "" +"from dataclasses import dataclass, field\n" +"from typing import Any\n" +"\n" +"@dataclass(order=True)\n" +"class PrioritizedItem:\n" +" priority: int\n" +" item: Any=field(compare=False)" + msgid "" "Constructor for an unbounded :abbr:`FIFO (first-in, first-out)` queue. " "Simple queues lack advanced functionality such as task tracking." msgstr "" msgid "" -"Exception raised when non-blocking :meth:`~Queue.get` (or :meth:`~Queue." -"get_nowait`) is called on a :class:`Queue` object which is empty." +"Simple queues are :ref:`generic ` over the type of their items." +msgstr "" + +msgid "" +"Exception raised when non-blocking :meth:`~Queue.get` " +"(or :meth:`~Queue.get_nowait`) is called on a :class:`Queue` object which is " +"empty." +msgstr "" + +msgid "" +"Exception raised when non-blocking :meth:`~Queue.put` " +"(or :meth:`~Queue.put_nowait`) is called on a :class:`Queue` object which is " +"full." msgstr "" msgid "" -"Exception raised when non-blocking :meth:`~Queue.put` (or :meth:`~Queue." -"put_nowait`) is called on a :class:`Queue` object which is full." +"Exception raised when :meth:`~Queue.put` or :meth:`~Queue.get` is called on " +"a :class:`Queue` object which has been shut down." msgstr "" msgid "Queue Objects" msgstr "" msgid "" -"Queue objects (:class:`Queue`, :class:`LifoQueue`, or :class:" -"`PriorityQueue`) provide the public methods described below." +"Queue objects (:class:`Queue`, :class:`LifoQueue`, " +"or :class:`PriorityQueue`) provide the public methods described below." msgstr "" msgid "" @@ -149,6 +177,9 @@ msgid "" "(*timeout* is ignored in that case)." msgstr "" +msgid "Raises :exc:`ShutDown` if the queue has been shut down." +msgstr "" + msgid "Equivalent to ``put(item, block=False)``." msgstr "" @@ -166,8 +197,13 @@ msgid "" "Prior to 3.0 on POSIX systems, and for all versions on Windows, if *block* " "is true and *timeout* is ``None``, this operation goes into an " "uninterruptible wait on an underlying lock. This means that no exceptions " -"can occur, and in particular a SIGINT will not trigger a :exc:" -"`KeyboardInterrupt`." +"can occur, and in particular a SIGINT will not trigger " +"a :exc:`KeyboardInterrupt`." +msgstr "" + +msgid "" +"Raises :exc:`ShutDown` if the queue has been shut down and is empty, or if " +"the queue has been shut down immediately." msgstr "" msgid "Equivalent to ``get(False)``." @@ -180,8 +216,9 @@ msgstr "" msgid "" "Indicate that a formerly enqueued task is complete. Used by queue consumer " -"threads. For each :meth:`get` used to fetch a task, a subsequent call to :" -"meth:`task_done` tells the queue that the processing on the task is complete." +"threads. For each :meth:`get` used to fetch a task, a subsequent call " +"to :meth:`task_done` tells the queue that the processing on the task is " +"complete." msgstr "" msgid "" @@ -200,15 +237,90 @@ msgstr "" msgid "" "The count of unfinished tasks goes up whenever an item is added to the " -"queue. The count goes down whenever a consumer thread calls :meth:" -"`task_done` to indicate that the item was retrieved and all work on it is " -"complete. When the count of unfinished tasks drops to zero, :meth:`join` " -"unblocks." +"queue. The count goes down whenever a consumer thread " +"calls :meth:`task_done` to indicate that the item was retrieved and all work " +"on it is complete. When the count of unfinished tasks drops to " +"zero, :meth:`join` unblocks." +msgstr "" + +msgid "Waiting for task completion" msgstr "" msgid "Example of how to wait for enqueued tasks to be completed::" msgstr "" +msgid "" +"import threading\n" +"import queue\n" +"\n" +"q = queue.Queue()\n" +"\n" +"def worker():\n" +" while True:\n" +" item = q.get()\n" +" print(f'Working on {item}')\n" +" print(f'Finished {item}')\n" +" q.task_done()\n" +"\n" +"# Turn-on the worker thread.\n" +"threading.Thread(target=worker, daemon=True).start()\n" +"\n" +"# Send thirty task requests to the worker.\n" +"for item in range(30):\n" +" q.put(item)\n" +"\n" +"# Block until all tasks are done.\n" +"q.join()\n" +"print('All work completed')" +msgstr "" + +msgid "Terminating queues" +msgstr "" + +msgid "" +"When no longer needed, :class:`Queue` objects can be wound down until empty " +"or terminated immediately with a hard shutdown." +msgstr "" + +msgid "Put a :class:`Queue` instance into a shutdown mode." +msgstr "" + +msgid "" +"The queue can no longer grow. Future calls to :meth:`~Queue.put` " +"raise :exc:`ShutDown`. Currently blocked callers of :meth:`~Queue.put` will " +"be unblocked and will raise :exc:`ShutDown` in the formerly blocked thread." +msgstr "" + +msgid "" +"If *immediate* is false (the default), the queue can be wound down normally " +"with :meth:`~Queue.get` calls to extract tasks that have already been loaded." +msgstr "" + +msgid "" +"And if :meth:`~Queue.task_done` is called for each remaining task, a " +"pending :meth:`~Queue.join` will be unblocked normally." +msgstr "" + +msgid "" +"Once the queue is empty, future calls to :meth:`~Queue.get` will " +"raise :exc:`ShutDown`." +msgstr "" + +msgid "" +"If *immediate* is true, the queue is terminated immediately. The queue is " +"drained to be completely empty and the count of unfinished tasks is reduced " +"by the number of tasks drained. If unfinished tasks is zero, callers " +"of :meth:`~Queue.join` are unblocked. Also, blocked callers " +"of :meth:`~Queue.get` are unblocked and will raise :exc:`ShutDown` because " +"the queue is empty." +msgstr "" + +msgid "" +"Use caution when using :meth:`~Queue.join` with *immediate* set to true. " +"This unblocks the join even when no work has been done on the tasks, " +"violating the usual invariant for joining a queue." +msgstr "" + msgid "SimpleQueue Objects" msgstr "" @@ -243,8 +355,8 @@ msgid "" msgstr "" msgid "" -"Equivalent to ``put(item, block=False)``, provided for compatibility with :" -"meth:`Queue.put_nowait`." +"Equivalent to ``put(item, block=False)``, provided for compatibility " +"with :meth:`Queue.put_nowait`." msgstr "" msgid "Class :class:`multiprocessing.Queue`" @@ -257,7 +369,7 @@ msgstr "" msgid "" ":class:`collections.deque` is an alternative implementation of unbounded " -"queues with fast atomic :meth:`~collections.deque.append` and :meth:" -"`~collections.deque.popleft` operations that do not require locking and also " -"support indexing." +"queues with fast atomic :meth:`~collections.deque.append` " +"and :meth:`~collections.deque.popleft` operations that do not require " +"locking and also support indexing." msgstr "" diff --git a/library/quopri.po b/library/quopri.po index 65c3f5144c..ca2ea6f3e8 100644 --- a/library/quopri.po +++ b/library/quopri.po @@ -50,13 +50,13 @@ msgstr "" msgid "" "Encode the contents of the *input* file and write the resulting quoted-" -"printable data to the *output* file. *input* and *output* must be :term:" -"`binary file objects `. *quotetabs*, a non-optional flag which " -"controls whether to encode embedded spaces and tabs; when true it encodes " -"such embedded whitespace, and when false it leaves them unencoded. Note that " -"spaces and tabs appearing at the end of lines are always encoded, as per :" -"rfc:`1521`. *header* is a flag which controls if spaces are encoded as " -"underscores as per :rfc:`1522`." +"printable data to the *output* file. *input* and *output* must " +"be :term:`binary file objects `. *quotetabs*, a non-optional " +"flag which controls whether to encode embedded spaces and tabs; when true it " +"encodes such embedded whitespace, and when false it leaves them unencoded. " +"Note that spaces and tabs appearing at the end of lines are always encoded, " +"as per :rfc:`1521`. *header* is a flag which controls if spaces are encoded " +"as underscores as per :rfc:`1522`." msgstr "" msgid "" diff --git a/library/random.po b/library/random.po index b85dedf616..4643380878 100644 --- a/library/random.po +++ b/library/random.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!random` --- Generate pseudo-random numbers" msgstr "" msgid "**Source code:** :source:`Lib/random.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/random.py`" msgid "" "This module implements pseudo-random number generators for various " @@ -99,8 +98,8 @@ msgid "" "The global random number generator and instances of :class:`Random` are " "thread-safe. However, in the free-threaded build, concurrent calls to the " "global generator or to the same instance of :class:`Random` may encounter " -"contention and poor performance. Consider using separate instances of :class:" -"`Random` per thread instead." +"contention and poor performance. Consider using separate instances " +"of :class:`Random` per thread instead." msgstr "" msgid "Bookkeeping functions" @@ -116,13 +115,13 @@ msgid "" "on availability)." msgstr "" -msgid "If *a* is an int, it is used directly." +msgid "If *a* is an int, its absolute value is used directly." msgstr "" msgid "" -"With version 2 (the default), a :class:`str`, :class:`bytes`, or :class:" -"`bytearray` object gets converted to an :class:`int` and all of its bits are " -"used." +"With version 2 (the default), a :class:`str`, :class:`bytes`, " +"or :class:`bytearray` object gets converted to an :class:`int` and all of " +"its bits are used." msgstr "" msgid "" @@ -136,8 +135,9 @@ msgid "" msgstr "" msgid "" -"The *seed* must be one of the following types: ``None``, :class:`int`, :" -"class:`float`, :class:`str`, :class:`bytes`, or :class:`bytearray`." +"The *seed* must be one of the following types: " +"``None``, :class:`int`, :class:`float`, :class:`str`, :class:`bytes`, " +"or :class:`bytearray`." msgstr "" msgid "" @@ -158,8 +158,8 @@ msgid "Generate *n* random bytes." msgstr "" msgid "" -"This method should not be used for generating security tokens. Use :func:" -"`secrets.token_bytes` instead." +"This method should not be used for generating security tokens. " +"Use :func:`secrets.token_bytes` instead." msgstr "" msgid "Functions for integers" @@ -190,8 +190,8 @@ msgstr "" msgid "" "Automatic conversion of non-integer types is no longer supported. Calls such " -"as ``randrange(10.0)`` and ``randrange(Fraction(10, 1))`` now raise a :exc:" -"`TypeError`." +"as ``randrange(10.0)`` and ``randrange(Fraction(10, 1))`` now raise " +"a :exc:`TypeError`." msgstr "" msgid "" @@ -202,8 +202,9 @@ msgstr "" msgid "" "Returns a non-negative Python integer with *k* random bits. This method is " "supplied with the Mersenne Twister generator and some other generators may " -"also provide it as an optional part of the API. When available, :meth:" -"`getrandbits` enables :meth:`randrange` to handle arbitrarily large ranges." +"also provide it as an optional part of the API. When " +"available, :meth:`getrandbits` enables :meth:`randrange` to handle " +"arbitrarily large ranges." msgstr "" msgid "This method now accepts zero for *k*." @@ -249,11 +250,11 @@ msgstr "" msgid "" "For a given seed, the :func:`choices` function with equal weighting " -"typically produces a different sequence than repeated calls to :func:" -"`choice`. The algorithm used by :func:`choices` uses floating-point " -"arithmetic for internal consistency and speed. The algorithm used by :func:" -"`choice` defaults to integer arithmetic with repeated selections to avoid " -"small biases from round-off error." +"typically produces a different sequence than repeated calls " +"to :func:`choice`. The algorithm used by :func:`choices` uses floating-" +"point arithmetic for internal consistency and speed. The algorithm used " +"by :func:`choice` defaults to integer arithmetic with repeated selections to " +"avoid small biases from round-off error." msgstr "" msgid "Raises a :exc:`ValueError` if all weights are zero." @@ -330,9 +331,9 @@ msgid "The following function generates a discrete distribution." msgstr "" msgid "" -"`Binomial distribution `_. Return the number of successes for *n* independent trials with the " -"probability of success in each trial being *p*:" +"`Binomial distribution `_. Return the number of successes for *n* " +"independent trials with the probability of success in each trial being *p*:" msgstr "" msgid "Mathematically equivalent to::" @@ -463,8 +464,8 @@ msgstr "" msgid "" "Formerly the *seed* could be any hashable object. Now it is limited to: " -"``None``, :class:`int`, :class:`float`, :class:`str`, :class:`bytes`, or :" -"class:`bytearray`." +"``None``, :class:`int`, :class:`float`, :class:`str`, :class:`bytes`, " +"or :class:`bytearray`." msgstr "" msgid "" @@ -497,8 +498,13 @@ msgid "" msgstr "" msgid "" -"Override this method in subclasses to customise the :meth:`~random." -"getrandbits` behaviour of :class:`!Random` instances." +"Override this method in subclasses to customise " +"the :meth:`~random.getrandbits` behaviour of :class:`!Random` instances." +msgstr "" + +msgid "" +"Override this method in subclasses to customise " +"the :meth:`~random.randbytes` behaviour of :class:`!Random` instances." msgstr "" msgid "" @@ -506,8 +512,8 @@ msgid "" "numbers from sources provided by the operating system. Not available on all " "systems. Does not rely on software state, and sequences are not " "reproducible. Accordingly, the :meth:`seed` method has no effect and is " -"ignored. The :meth:`getstate` and :meth:`setstate` methods raise :exc:" -"`NotImplementedError` if called." +"ignored. The :meth:`getstate` and :meth:`setstate` methods " +"raise :exc:`NotImplementedError` if called." msgstr "" msgid "Notes on Reproducibility" @@ -691,11 +697,11 @@ msgid "" msgstr "" msgid "" -"`Economics Simulation `_ a simulation of a marketplace by `Peter Norvig `_ that shows effective use of many of the tools and distributions " -"provided by this module (gauss, uniform, sample, betavariate, choice, " -"triangular, and randrange)." +"`Economics Simulation `_ a simulation of a marketplace by `Peter Norvig `_ that shows effective use of many of the tools and " +"distributions provided by this module (gauss, uniform, sample, betavariate, " +"choice, triangular, and randrange)." msgstr "" msgid "" @@ -714,9 +720,11 @@ msgid "" msgstr "" msgid "" -"def random_product(*args, repeat=1):\n" -" \"Random selection from itertools.product(*args, **kwds)\"\n" -" pools = [tuple(pool) for pool in args] * repeat\n" +"import random\n" +"\n" +"def random_product(*iterables, repeat=1):\n" +" \"Random selection from itertools.product(*iterables, repeat=repeat)\"\n" +" pools = tuple(map(tuple, iterables)) * repeat\n" " return tuple(map(random.choice, pools))\n" "\n" "def random_permutation(iterable, r=None):\n" @@ -735,12 +743,27 @@ msgid "" "def random_combination_with_replacement(iterable, r):\n" " \"Choose r elements with replacement. Order the result to match the " "iterable.\"\n" -" # Result will be in set(itertools." -"combinations_with_replacement(iterable, r)).\n" +" # Result will be in " +"set(itertools.combinations_with_replacement(iterable, r)).\n" " pool = tuple(iterable)\n" " n = len(pool)\n" " indices = sorted(random.choices(range(n), k=r))\n" -" return tuple(pool[i] for i in indices)" +" return tuple(pool[i] for i in indices)\n" +"\n" +"def random_derangement(iterable):\n" +" \"Choose a permutation where no element stays in its original position." +"\"\n" +" seq = tuple(iterable)\n" +" if len(seq) < 2:\n" +" if not seq:\n" +" return ()\n" +" raise IndexError('No derangments to choose from')\n" +" perm = list(range(len(seq)))\n" +" start = tuple(perm)\n" +" while True:\n" +" random.shuffle(perm)\n" +" if all(p != q for p, q in zip(start, perm)):\n" +" return tuple([seq[i] for i in perm])" msgstr "" msgid "" @@ -804,8 +827,8 @@ msgstr "" msgid "" "`Generating Pseudo-random Floating-Point Values `_ a paper by Allen B. Downey describing " -"ways to generate more fine-grained floats than normally generated by :func:`." -"random`." +"ways to generate more fine-grained floats than normally generated " +"by :func:`.random`." msgstr "" msgid "Command-line usage" @@ -832,8 +855,8 @@ msgid "" msgstr "" msgid "" -"Print a random floating-point number between 0 and N inclusive, using :meth:" -"`uniform`." +"Print a random floating-point number between 0 and N inclusive, " +"using :meth:`uniform`." msgstr "" msgid "If no options are given, the output depends on the input:" diff --git a/library/re.po b/library/re.po index ac7e44fb99..6a83da7633 100644 --- a/library/re.po +++ b/library/re.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Krzysztof Abramowicz, 2022 -# Igor Zubrycki , 2022 -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 +27,7 @@ msgid ":mod:`!re` --- Regular expression operations" msgstr "" msgid "**Source code:** :source:`Lib/re/`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/re/`" msgid "" "This module provides regular expression matching operations similar to those " @@ -38,12 +35,12 @@ msgid "" msgstr "" msgid "" -"Both patterns and strings to be searched can be Unicode strings (:class:" -"`str`) as well as 8-bit strings (:class:`bytes`). However, Unicode strings " -"and 8-bit strings cannot be mixed: that is, you cannot match a Unicode " -"string with a bytes pattern or vice-versa; similarly, when asking for a " -"substitution, the replacement string must be of the same type as both the " -"pattern and the search string." +"Both patterns and strings to be searched can be Unicode strings " +"(:class:`str`) as well as 8-bit strings (:class:`bytes`). However, Unicode " +"strings and 8-bit strings cannot be mixed: that is, you cannot match a " +"Unicode string with a bytes pattern or vice-versa; similarly, when asking " +"for a substitution, the replacement string must be of the same type as both " +"the pattern and the search string." msgstr "" msgid "" @@ -163,10 +160,10 @@ msgid "" "string, and in :const:`MULTILINE` mode also matches before a newline. " "``foo`` matches both 'foo' and 'foobar', while the regular expression " "``foo$`` matches only 'foo'. More interestingly, searching for ``foo.$`` in " -"``'foo1\\nfoo2\\n'`` matches 'foo2' normally, but 'foo1' in :const:" -"`MULTILINE` mode; searching for a single ``$`` in ``'foo\\n'`` will find two " -"(empty) matches: one just before the newline, and one at the end of the " -"string." +"``'foo1\\nfoo2\\n'`` matches 'foo2' normally, but 'foo1' " +"in :const:`MULTILINE` mode; searching for a single ``$`` in ``'foo\\n'`` " +"will find two (empty) matches: one just before the newline, and one at the " +"end of the string." msgstr "" msgid "``*``" @@ -333,12 +330,12 @@ msgid "" msgstr "" msgid "" -"Characters that are not within a range can be matched by :dfn:" -"`complementing` the set. If the first character of the set is ``'^'``, all " -"the characters that are *not* in the set will be matched. For example, " -"``[^5]`` will match any character except ``'5'``, and ``[^^]`` will match " -"any character except ``'^'``. ``^`` has no special meaning if it's not the " -"first character in the set." +"Characters that are not within a range can be matched " +"by :dfn:`complementing` the set. If the first character of the set is " +"``'^'``, all the characters that are *not* in the set will be matched. For " +"example, ``[^5]`` will match any character except ``'5'``, and ``[^^]`` will " +"match any character except ``'^'``. ``^`` has no special meaning if it's " +"not the first character in the set." msgstr "" msgid "" @@ -485,13 +482,13 @@ msgid "" "Attempts to match ``...`` as if it was a separate regular expression, and if " "successful, continues to match the rest of the pattern following it. If the " "subsequent pattern fails to match, the stack can only be unwound to a point " -"*before* the ``(?>...)`` because once exited, the expression, known as an :" -"dfn:`atomic group`, has thrown away all stack points within itself. Thus, " -"``(?>.*).`` would never match anything because first the ``.*`` would match " -"all characters possible, then, having nothing left to match, the final ``.`` " -"would fail to match. Since there are no stack points saved in the Atomic " -"Group, and there is no stack point before it, the entire expression would " -"thus fail to match." +"*before* the ``(?>...)`` because once exited, the expression, known as " +"an :dfn:`atomic group`, has thrown away all stack points within itself. " +"Thus, ``(?>.*).`` would never match anything because first the ``.*`` would " +"match all characters possible, then, having nothing left to match, the final " +"``.`` would fail to match. Since there are no stack points saved in the " +"Atomic Group, and there is no stack point before it, the entire expression " +"would thus fail to match." msgstr "" msgid "``(?P...)``" @@ -594,8 +591,8 @@ msgid "" "length, meaning that ``abc`` or ``a|b`` are allowed, but ``a*`` and ``a{3,4}" "`` are not. Note that patterns which start with positive lookbehind " "assertions will not match at the beginning of the string being searched; you " -"will most likely want to use the :func:`search` function rather than the :" -"func:`match` function:" +"will most likely want to use the :func:`search` function rather than " +"the :func:`match` function:" msgstr "" msgid "This example looks for a word following a hyphen:" @@ -622,9 +619,10 @@ msgid "" "Will try to match with ``yes-pattern`` if the group with given *id* or " "*name* exists, and with ``no-pattern`` if it doesn't. ``no-pattern`` is " "optional and can be omitted. For example, ``(<)?(\\w+@\\w+(?:\\.\\w+)+)(?" -"(1)>|$)`` is a poor email matching pattern, which will match with " -"``''`` as well as ``'user@host.com'``, but not with " -"``''``." +"(1)>|$)`` is a poor email matching pattern, which matches " +"``''`` as well as ``'user@host.com'``, but does not match " +"``''`` in their entirety " +"(:func:`re.search` finds only ``'user@host.com'`` in the former)." msgstr "" msgid "" @@ -673,9 +671,9 @@ msgstr "" msgid "" "The default word characters in Unicode (str) patterns are Unicode " -"alphanumerics and the underscore, but this can be changed by using the :py:" -"const:`~re.ASCII` flag. Word boundaries are determined by the current locale " -"if the :py:const:`~re.LOCALE` flag is used." +"alphanumerics and the underscore, but this can be changed by using " +"the :py:const:`~re.ASCII` flag. Word boundaries are determined by the " +"current locale if the :py:const:`~re.LOCALE` flag is used." msgstr "" msgid "" @@ -740,10 +738,10 @@ msgid "``\\s``" msgstr "``\\s``" msgid "" -"Matches Unicode whitespace characters (as defined by :py:meth:`str." -"isspace`). This includes ``[ \\t\\n\\r\\f\\v]``, and also many other " -"characters, for example the non-breaking spaces mandated by typography rules " -"in many languages." +"Matches Unicode whitespace characters (as defined " +"by :py:meth:`str.isspace`). This includes ``[ \\t\\n\\r\\f\\v]``, and also " +"many other characters, for example the non-breaking spaces mandated by " +"typography rules in many languages." msgstr "" msgid "" @@ -791,8 +789,8 @@ msgstr "``\\W``" msgid "" "Matches any character which is not a word character. This is the opposite of " -"``\\w``. By default, matches non-underscore (``_``) characters for which :py:" -"meth:`str.isalnum` returns ``False``." +"``\\w``. By default, matches non-underscore (``_``) characters for " +"which :py:meth:`str.isalnum` returns ``False``." msgstr "" msgid "Matches ``[^a-zA-Z0-9_]`` if the :py:const:`~re.ASCII` flag is used." @@ -889,8 +887,9 @@ msgstr "" msgid "" "The :py:const:`~re.U` flag still exists for backward compatibility, but is " "redundant in Python 3 since matches are Unicode by default for ``str`` " -"patterns, and Unicode matching isn't allowed for bytes patterns. :py:const:" -"`~re.UNICODE` and the inline flag ``(?u)`` are similarly redundant." +"patterns, and Unicode matching isn't allowed for bytes " +"patterns. :py:const:`~re.UNICODE` and the inline flag ``(?u)`` are similarly " +"redundant." msgstr "" msgid "Display debug information about compiled expression." @@ -914,8 +913,8 @@ msgid "" "Note that when the Unicode patterns ``[a-z]`` or ``[A-Z]`` are used in " "combination with the :const:`IGNORECASE` flag, they will match the 52 ASCII " "letters and 4 additional non-ASCII letters: 'İ' (U+0130, Latin capital " -"letter I with dot above), 'ı' (U+0131, Latin small letter dotless i), " -"'ſ' (U+017F, Latin small letter long s) and 'K' (U+212A, Kelvin sign). If " +"letter I with dot above), 'ı' (U+0131, Latin small letter dotless i), 'ſ' " +"(U+017F, Latin small letter long s) and 'K' (U+212A, Kelvin sign). If " "the :py:const:`~re.ASCII` flag is used, only letters 'a' to 'z' and 'A' to " "'Z' are matched." msgstr "" @@ -1023,8 +1022,9 @@ msgstr "Zadania" msgid "" "Compile a regular expression pattern into a :ref:`regular expression object " -"`, which can be used for matching using its :func:`~Pattern." -"match`, :func:`~Pattern.search` and other methods, described below." +"`, which can be used for matching using " +"its :func:`~Pattern.match`, :func:`~Pattern.search` and other methods, " +"described below." msgstr "" msgid "" @@ -1054,18 +1054,18 @@ msgid "" msgstr "" msgid "" -"The compiled versions of the most recent patterns passed to :func:`re." -"compile` and the module-level matching functions are cached, so programs " -"that use only a few regular expressions at a time needn't worry about " -"compiling regular expressions." +"The compiled versions of the most recent patterns passed " +"to :func:`re.compile` and the module-level matching functions are cached, so " +"programs that use only a few regular expressions at a time needn't worry " +"about compiling regular expressions." msgstr "" msgid "" "Scan through *string* looking for the first location where the regular " -"expression *pattern* produces a match, and return a corresponding :class:" -"`~re.Match`. Return ``None`` if no position in the string matches the " -"pattern; note that this is different from finding a zero-length match at " -"some point in the string." +"expression *pattern* produces a match, and return a " +"corresponding :class:`~re.Match`. Return ``None`` if no position in the " +"string matches the pattern; note that this is different from finding a zero-" +"length match at some point in the string." msgstr "" msgid "" @@ -1129,8 +1129,8 @@ msgid "" msgstr "" msgid "" -"Empty matches for the pattern split the string only when not adjacent to a " -"previous empty match." +"Adjacent empty matches are not possible, but an empty match can occur " +"immediately after a non-empty match." msgstr "" msgid "" @@ -1218,8 +1218,8 @@ msgid "" "...\n" ">>> re.sub('-{1,2}', dashrepl, 'pro----gram-files')\n" "'pro--gram files'\n" -">>> re.sub(r'\\sAND\\s', ' & ', 'Baked Beans And Spam', flags=re." -"IGNORECASE)\n" +">>> re.sub(r'\\sAND\\s', ' & ', 'Baked Beans And Spam', " +"flags=re.IGNORECASE)\n" "'Baked Beans & Spam'" msgstr "" @@ -1229,9 +1229,13 @@ msgstr "" msgid "" "The optional argument *count* is the maximum number of pattern occurrences " "to be replaced; *count* must be a non-negative integer. If omitted or zero, " -"all occurrences will be replaced. Empty matches for the pattern are replaced " -"only when not adjacent to a previous empty match, so ``sub('x*', '-', " -"'abxd')`` returns ``'-a-b--d-'``." +"all occurrences will be replaced." +msgstr "" + +msgid "" +"Adjacent empty matches are not possible, but an empty match can occur " +"immediately after a non-empty match. As a result, ``sub('x*', '-', 'abxd')`` " +"returns ``'-a-b--d-'`` instead of ``'-a-b-d-'``." msgstr "" msgid "" @@ -1256,8 +1260,7 @@ msgstr "" msgid "" "Unknown escapes in *repl* consisting of ``'\\'`` and an ASCII letter now are " -"errors. Empty matches for the pattern are replaced when adjacent to a " -"previous non-empty match." +"errors. An empty match can occur immediately after a non-empty match." msgstr "" msgid "" @@ -1363,6 +1366,11 @@ msgstr "" msgid "Compiled regular expression object returned by :func:`re.compile`." msgstr "" +msgid "" +"Patterns are :ref:`generic ` over the type of string they handle " +"(:class:`str` or :class:`bytes`)." +msgstr "" + msgid "" ":py:class:`re.Pattern` supports ``[]`` to indicate a Unicode (str) or bytes " "pattern. See :ref:`types-genericalias`." @@ -1408,8 +1416,8 @@ msgid "" msgstr "" msgid "" -"The optional *pos* and *endpos* parameters have the same meaning as for the :" -"meth:`~Pattern.search` method. ::" +"The optional *pos* and *endpos* parameters have the same meaning as for " +"the :meth:`~Pattern.search` method. ::" msgstr "" msgid "" @@ -1422,8 +1430,8 @@ msgid "" msgstr "" msgid "" -"If you want to locate a match anywhere in *string*, use :meth:`~Pattern." -"search` instead (see also :ref:`search-vs-match`)." +"If you want to locate a match anywhere in *string*, " +"use :meth:`~Pattern.search` instead (see also :ref:`search-vs-match`)." msgstr "" msgid "" @@ -1464,9 +1472,10 @@ msgid "Identical to the :func:`subn` function, using the compiled pattern." msgstr "" msgid "" -"The regex matching flags. This is a combination of the flags given to :func:" -"`.compile`, any ``(?...)`` inline flags in the pattern, and implicit flags " -"such as :py:const:`~re.UNICODE` if the pattern is a Unicode string." +"The regex matching flags. This is a combination of the flags given " +"to :func:`.compile`, any ``(?...)`` inline flags in the pattern, and " +"implicit flags such as :py:const:`~re.UNICODE` if the pattern is a Unicode " +"string." msgstr "" msgid "The number of capturing groups in the pattern." @@ -1490,9 +1499,10 @@ msgid "Match Objects" msgstr "" msgid "" -"Match objects always have a boolean value of ``True``. Since :meth:`~Pattern." -"match` and :meth:`~Pattern.search` return ``None`` when there is no match, " -"you can test whether there was a match with a simple ``if`` statement::" +"Match objects always have a boolean value of ``True``. " +"Since :meth:`~Pattern.match` and :meth:`~Pattern.search` return ``None`` " +"when there is no match, you can test whether there was a match with a simple " +"``if`` statement::" msgstr "" msgid "" @@ -1504,6 +1514,11 @@ msgstr "" msgid "Match object returned by successful ``match``\\ es and ``search``\\ es." msgstr "" +msgid "" +"Matches are :ref:`generic ` over the type of string which was " +"matched (:class:`str` or :class:`bytes`)." +msgstr "" + msgid "" ":py:class:`re.Match` supports ``[]`` to indicate a Unicode (str) or bytes " "match. See :ref:`types-genericalias`." @@ -1523,13 +1538,13 @@ msgid "" "the result is a single string; if there are multiple arguments, the result " "is a tuple with one item per argument. Without arguments, *group1* defaults " "to zero (the whole match is returned). If a *groupN* argument is zero, the " -"corresponding return value is the entire matching string; if it is in the " -"inclusive range [1..99], it is the string matching the corresponding " -"parenthesized group. If a group number is negative or larger than the " -"number of groups defined in the pattern, an :exc:`IndexError` exception is " -"raised. If a group is contained in a part of the pattern that did not match, " -"the corresponding result is ``None``. If a group is contained in a part of " -"the pattern that matched multiple times, the last match is returned. ::" +"corresponding return value is the entire matching string; if it is a " +"positive integer, it is the string matching the corresponding parenthesized " +"group. If a group number is negative or larger than the number of groups " +"defined in the pattern, an :exc:`IndexError` exception is raised. If a group " +"is contained in a part of the pattern that did not match, the corresponding " +"result is ``None``. If a group is contained in a part of the pattern that " +"matched multiple times, the last match is returned. ::" msgstr "" msgid "" @@ -1547,8 +1562,8 @@ msgstr "" msgid "" "If the regular expression uses the ``(?P...)`` syntax, the *groupN* " "arguments may also be strings identifying groups by their group name. If a " -"string argument is not used as a group name in the pattern, an :exc:" -"`IndexError` exception is raised." +"string argument is not used as a group name in the pattern, " +"an :exc:`IndexError` exception is raised." msgstr "" msgid "A moderately complicated example::" @@ -1687,9 +1702,9 @@ msgstr "m.string[m.start(g):m.end(g)]" msgid "" "Note that ``m.start(group)`` will equal ``m.end(group)`` if *group* matched " -"a null string. For example, after ``m = re.search('b(c?)', 'cba')``, ``m." -"start(0)`` is 1, ``m.end(0)`` is 2, ``m.start(1)`` and ``m.end(1)`` are both " -"2, and ``m.start(2)`` raises an :exc:`IndexError` exception." +"a null string. For example, after ``m = re.search('b(c?)', 'cba')``, " +"``m.start(0)`` is 1, ``m.end(0)`` is 2, ``m.start(1)`` and ``m.end(1)`` are " +"both 2, and ``m.start(2)`` raises an :exc:`IndexError` exception." msgstr "" msgid "An example that will remove *remove_this* from email addresses::" @@ -1709,15 +1724,16 @@ msgid "" msgstr "" msgid "" -"The value of *pos* which was passed to the :meth:`~Pattern.search` or :meth:" -"`~Pattern.match` method of a :ref:`regex object `. This is the " -"index into the string at which the RE engine started looking for a match." +"The value of *pos* which was passed to the :meth:`~Pattern.search` " +"or :meth:`~Pattern.match` method of a :ref:`regex object `. " +"This is the index into the string at which the RE engine started looking for " +"a match." msgstr "" msgid "" -"The value of *endpos* which was passed to the :meth:`~Pattern.search` or :" -"meth:`~Pattern.match` method of a :ref:`regex object `. This is " -"the index into the string beyond which the RE engine will not go." +"The value of *endpos* which was passed to the :meth:`~Pattern.search` " +"or :meth:`~Pattern.match` method of a :ref:`regex object `. " +"This is the index into the string beyond which the RE engine will not go." msgstr "" msgid "" @@ -1734,8 +1750,9 @@ msgid "" msgstr "" msgid "" -"The :ref:`regular expression object ` whose :meth:`~Pattern." -"match` or :meth:`~Pattern.search` method produced this match instance." +"The :ref:`regular expression object ` " +"whose :meth:`~Pattern.match` or :meth:`~Pattern.search` method produced this " +"match instance." msgstr "" msgid "The string passed to :meth:`~Pattern.match` or :meth:`~Pattern.search`." @@ -1800,8 +1817,8 @@ msgid "" msgstr "" msgid "" -"To find out what card the pair consists of, one could use the :meth:`~Match." -"group` method of the match object in the following manner::" +"To find out what card the pair consists of, one could use " +"the :meth:`~Match.group` method of the match object in the following manner::" msgstr "" msgid "" @@ -1826,9 +1843,9 @@ msgstr "" msgid "" "Python does not currently have an equivalent to :c:func:`!scanf`. Regular " -"expressions are generally more powerful, though also more verbose, than :c:" -"func:`!scanf` format strings. The table below offers some more-or-less " -"equivalent mappings between :c:func:`!scanf` format tokens and regular " +"expressions are generally more powerful, though also more verbose, " +"than :c:func:`!scanf` format strings. The table below offers some more-or-" +"less equivalent mappings between :c:func:`!scanf` format tokens and regular " "expressions." msgstr "" @@ -2136,7 +2153,7 @@ msgid "" "\n" "class Token(NamedTuple):\n" " type: str\n" -" value: str\n" +" value: int | float | str\n" " line: int\n" " column: int\n" "\n" @@ -2308,7 +2325,7 @@ msgid "\\A" msgstr "" msgid "\\b" -msgstr "" +msgstr "\\b" msgid "\\B" msgstr "" @@ -2335,34 +2352,34 @@ msgid "\\Z" msgstr "" msgid "\\a" -msgstr "" +msgstr "\\a" msgid "\\f" -msgstr "" +msgstr "\\f" msgid "\\n" -msgstr "" +msgstr "\\n" msgid "\\r" -msgstr "" +msgstr "\\r" msgid "\\t" -msgstr "" +msgstr "\\t" msgid "\\u" -msgstr "" +msgstr "\\u" msgid "\\U" -msgstr "" +msgstr "\\U" msgid "\\v" -msgstr "" +msgstr "\\v" msgid "\\x" -msgstr "" +msgstr "\\x" msgid "\\\\" -msgstr "" +msgstr "\\\\" msgid "# (hash)" msgstr "# (kratka)" diff --git a/library/readline.po b/library/readline.po index 37eba012dd..0a6992022c 100644 --- a/library/readline.po +++ b/library/readline.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,8 +32,8 @@ msgid "" "This module can be used directly, or via the :mod:`rlcompleter` module, " "which supports completion of Python identifiers at the interactive prompt. " "Settings made using this module affect the behaviour of both the " -"interpreter's interactive prompt and the prompts offered by the built-in :" -"func:`input` function." +"interpreter's interactive prompt and the prompts offered by the built-" +"in :func:`input` function." msgstr "" msgid "" @@ -61,8 +61,8 @@ msgstr "" msgid "" "The configuration file for ``editline`` is different from that of GNU " -"readline. If you programmatically load configuration strings you can use :" -"data:`backend` to determine which library is being used." +"readline. If you programmatically load configuration strings you can " +"use :data:`backend` to determine which library is being used." msgstr "" msgid "" @@ -95,8 +95,8 @@ msgid "The following functions relate to the init file and user configuration:" msgstr "" msgid "" -"Execute the init line provided in the *string* argument. This calls :c:func:" -"`!rl_parse_and_bind` in the underlying library." +"Execute the init line provided in the *string* argument. This " +"calls :c:func:`!rl_parse_and_bind` in the underlying library." msgstr "" msgid "" @@ -117,8 +117,9 @@ msgid "" msgstr "" msgid "" -"Insert text into the line buffer at the cursor position. This calls :c:func:" -"`!rl_insert_text` in the underlying library, but ignores the return value." +"Insert text into the line buffer at the cursor position. This " +"calls :c:func:`!rl_insert_text` in the underlying library, but ignores the " +"return value." msgstr "" msgid "" @@ -146,15 +147,16 @@ 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." +"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 " +"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 "" @@ -322,8 +324,8 @@ msgid "" msgstr "" msgid "" -"This code is actually automatically run when Python is run in :ref:" -"`interactive mode ` (see :ref:`rlcompleter-config`)." +"This code is actually automatically run when Python is run " +"in :ref:`interactive mode ` (see :ref:`rlcompleter-config`)." msgstr "" msgid "" @@ -381,3 +383,9 @@ msgid "" " readline.set_history_length(1000)\n" " readline.write_history_file(histfile)" msgstr "" + +msgid "" +"The new :term:`REPL` introduced in version 3.13 doesn't support readline. " +"However, readline can still be used by setting " +"the :envvar:`PYTHON_BASIC_REPL` environment variable." +msgstr "" diff --git a/library/reprlib.po b/library/reprlib.po index ceca913b5b..d52325698c 100644 --- a/library/reprlib.po +++ b/library/reprlib.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Wiktor Matuszewski , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Wiktor Matuszewski , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!reprlib` --- Alternate :func:`repr` implementation" msgstr "" msgid "**Source code:** :source:`Lib/reprlib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/reprlib.py`" msgid "" "The :mod:`!reprlib` module provides a means for producing object " @@ -71,9 +71,10 @@ msgid "Allow attributes to be set via keyword arguments." msgstr "" msgid "" -"This is an instance of :class:`Repr` which is used to provide the :func:`." -"repr` function described below. Changing the attributes of this object will " -"affect the size limits used by :func:`.repr` and the Python debugger." +"This is an instance of :class:`Repr` which is used to provide " +"the :func:`.repr` function described below. Changing the attributes of this " +"object will affect the size limits used by :func:`.repr` and the Python " +"debugger." msgstr "" msgid "" @@ -226,18 +227,18 @@ msgstr "" msgid "" "Formatting methods for specific types are implemented as methods with a name " -"based on the type name. In the method name, **TYPE** is replaced by ``'_'." -"join(type(obj).__name__.split())``. Dispatch to these methods is handled by :" -"meth:`repr1`. Type-specific methods which need to recursively format a value " -"should call ``self.repr1(subobj, level - 1)``." +"based on the type name. In the method name, **TYPE** is replaced by " +"``'_'.join(type(obj).__name__.split())``. Dispatch to these methods is " +"handled by :meth:`repr1`. Type-specific methods which need to recursively " +"format a value should call ``self.repr1(subobj, level - 1)``." msgstr "" msgid "Subclassing Repr Objects" msgstr "" msgid "" -"The use of dynamic dispatching by :meth:`Repr.repr1` allows subclasses of :" -"class:`Repr` to add support for additional built-in object types or to " +"The use of dynamic dispatching by :meth:`Repr.repr1` allows subclasses " +"of :class:`Repr` to add support for additional built-in object types or to " "modify the handling of types already supported. This example shows how " "special support for file objects could be added:" msgstr "" diff --git a/library/resource.po b/library/resource.po index 836bdaf822..0f06267f90 100644 --- a/library/resource.po +++ b/library/resource.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,18 +81,18 @@ 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 " +"of :const:`~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." +"limit. Specifying a limit of :const:`~resource.RLIM_INFINITY` when the hard " +"or system limit for that resource is not unlimited will result in " +"a :exc:`ValueError`. A process with the effective UID of super-user can " +"request any valid limit value, including unlimited, but :exc:`ValueError` " +"will still be raised if the requested limit exceeds the system imposed limit." msgstr "" msgid "" @@ -101,7 +100,7 @@ msgid "" "fails." msgstr "" -msgid "VxWorks only supports setting :data:`RLIMIT_NOFILE`." +msgid "VxWorks only supports setting :const:`RLIMIT_NOFILE`." msgstr "" msgid "" @@ -124,9 +123,9 @@ msgid "" msgstr "" msgid "" -"Raises :exc:`ProcessLookupError` when *pid* can't be found and :exc:" -"`PermissionError` when the user doesn't have ``CAP_SYS_RESOURCE`` for the " -"process." +"Raises :exc:`ProcessLookupError` when *pid* can't be found " +"and :exc:`PermissionError` when the user doesn't have ``CAP_SYS_RESOURCE`` " +"for the process." msgstr "" msgid "" @@ -156,9 +155,10 @@ 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.)" +"this limit is exceeded, a :const:`~signal.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." @@ -188,7 +188,9 @@ 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." +msgid "" +"The largest area of mapped memory which the process may occupy. Usually an " +"alias of :const:`RLIMIT_AS`." msgstr "" msgid "" @@ -222,9 +224,9 @@ msgstr "" msgid "" "The maximum size (in bytes) of the swap space that may be reserved or used " "by all of this user id's processes. This limit is enforced only if bit 1 of " -"the vm.overcommit sysctl is set. Please see `tuning(7) `__ for a complete description of " -"this sysctl." +"the vm.overcommit sysctl is set. Please see `tuning(7) `__ for a complete " +"description of this sysctl." msgstr "" msgid "The maximum number of pseudo-terminals created by this user id." @@ -242,8 +244,8 @@ msgstr "" msgid "" "This function returns an object that describes the resources consumed by " "either the current process or its children, as specified by the *who* " -"parameter. The *who* parameter should be specified using one of the :const:" -"`!RUSAGE_\\*` constants described below." +"parameter. The *who* parameter should be specified using one of " +"the :const:`!RUSAGE_\\*` constants described below." msgstr "" msgid "A simple example::" @@ -265,9 +267,9 @@ 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 " +"resource has been used, e.g. amount of time spent running in 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 " +"dependent on the clock tick interval, e.g. the amount of memory the process " "is using." msgstr "" @@ -277,16 +279,16 @@ msgid "" msgstr "" msgid "" -"The fields :attr:`ru_utime` and :attr:`ru_stime` of the return value are " +"The fields :attr:`!ru_utime` and :attr:`!ru_stime` of the return value are " "floating-point values representing the amount of time spent executing in " "user mode and the amount of time spent executing in system mode, " -"respectively. The remaining values are integers. Consult the :manpage:" -"`getrusage(2)` man page for detailed information about these values. A brief " -"summary is presented here:" +"respectively. The remaining values are integers. Consult " +"the :manpage:`getrusage(2)` man page for detailed information about these " +"values. A brief summary is presented here:" msgstr "" msgid "Index" -msgstr "" +msgstr "Indeks" msgid "Field" msgstr "Pole" @@ -297,8 +299,8 @@ msgstr "" msgid "``0``" msgstr "``0``" -msgid ":attr:`ru_utime`" -msgstr ":attr:`ru_utime`" +msgid ":attr:`!ru_utime`" +msgstr "" msgid "time in user mode (float seconds)" msgstr "" @@ -306,8 +308,8 @@ msgstr "" msgid "``1``" msgstr "``1``" -msgid ":attr:`ru_stime`" -msgstr ":attr:`ru_stime`" +msgid ":attr:`!ru_stime`" +msgstr "" msgid "time in system mode (float seconds)" msgstr "" @@ -315,8 +317,8 @@ msgstr "" msgid "``2``" msgstr "``2``" -msgid ":attr:`ru_maxrss`" -msgstr ":attr:`ru_maxrss`" +msgid ":attr:`!ru_maxrss`" +msgstr "" msgid "maximum resident set size" msgstr "" @@ -324,8 +326,8 @@ msgstr "" msgid "``3``" msgstr "``3``" -msgid ":attr:`ru_ixrss`" -msgstr ":attr:`ru_ixrss`" +msgid ":attr:`!ru_ixrss`" +msgstr "" msgid "shared memory size" msgstr "" @@ -333,8 +335,8 @@ msgstr "" msgid "``4``" msgstr "``4``" -msgid ":attr:`ru_idrss`" -msgstr ":attr:`ru_idrss`" +msgid ":attr:`!ru_idrss`" +msgstr "" msgid "unshared memory size" msgstr "" @@ -342,8 +344,8 @@ msgstr "" msgid "``5``" msgstr "``5``" -msgid ":attr:`ru_isrss`" -msgstr ":attr:`ru_isrss`" +msgid ":attr:`!ru_isrss`" +msgstr "" msgid "unshared stack size" msgstr "" @@ -351,8 +353,8 @@ msgstr "" msgid "``6``" msgstr "``6``" -msgid ":attr:`ru_minflt`" -msgstr ":attr:`ru_minflt`" +msgid ":attr:`!ru_minflt`" +msgstr "" msgid "page faults not requiring I/O" msgstr "" @@ -360,8 +362,8 @@ msgstr "" msgid "``7``" msgstr "``7``" -msgid ":attr:`ru_majflt`" -msgstr ":attr:`ru_majflt`" +msgid ":attr:`!ru_majflt`" +msgstr "" msgid "page faults requiring I/O" msgstr "" @@ -369,8 +371,8 @@ msgstr "" msgid "``8``" msgstr "``8``" -msgid ":attr:`ru_nswap`" -msgstr ":attr:`ru_nswap`" +msgid ":attr:`!ru_nswap`" +msgstr "" msgid "number of swap outs" msgstr "" @@ -378,8 +380,8 @@ msgstr "" msgid "``9``" msgstr "``9``" -msgid ":attr:`ru_inblock`" -msgstr ":attr:`ru_inblock`" +msgid ":attr:`!ru_inblock`" +msgstr "" msgid "block input operations" msgstr "" @@ -387,8 +389,8 @@ msgstr "" msgid "``10``" msgstr "``10``" -msgid ":attr:`ru_oublock`" -msgstr ":attr:`ru_oublock`" +msgid ":attr:`!ru_oublock`" +msgstr "" msgid "block output operations" msgstr "" @@ -396,8 +398,8 @@ msgstr "" msgid "``11``" msgstr "``11``" -msgid ":attr:`ru_msgsnd`" -msgstr ":attr:`ru_msgsnd`" +msgid ":attr:`!ru_msgsnd`" +msgstr "" msgid "messages sent" msgstr "" @@ -405,8 +407,8 @@ msgstr "" msgid "``12``" msgstr "``12``" -msgid ":attr:`ru_msgrcv`" -msgstr ":attr:`ru_msgrcv`" +msgid ":attr:`!ru_msgrcv`" +msgstr "" msgid "messages received" msgstr "" @@ -414,8 +416,8 @@ msgstr "" msgid "``13``" msgstr "``13``" -msgid ":attr:`ru_nsignals`" -msgstr ":attr:`ru_nsignals`" +msgid ":attr:`!ru_nsignals`" +msgstr "" msgid "signals received" msgstr "" @@ -423,8 +425,8 @@ msgstr "" msgid "``14``" msgstr "``14``" -msgid ":attr:`ru_nvcsw`" -msgstr ":attr:`ru_nvcsw`" +msgid ":attr:`!ru_nvcsw`" +msgstr "" msgid "voluntary context switches" msgstr "" @@ -432,8 +434,8 @@ msgstr "" msgid "``15``" msgstr "``15``" -msgid ":attr:`ru_nivcsw`" -msgstr ":attr:`ru_nivcsw`" +msgid ":attr:`!ru_nivcsw`" +msgstr "" msgid "involuntary context switches" msgstr "" @@ -450,9 +452,9 @@ msgid "" msgstr "" msgid "" -"The following :const:`!RUSAGE_\\*` symbols are passed to the :func:" -"`getrusage` function to specify which processes information should be " -"provided for." +"The following :const:`!RUSAGE_\\*` symbols are passed to " +"the :func:`getrusage` function to specify which processes information should " +"be provided for." msgstr "" msgid "" diff --git a/library/rlcompleter.po b/library/rlcompleter.po index bfe14b54f5..dd055aaabc 100644 --- a/library/rlcompleter.po +++ b/library/rlcompleter.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!rlcompleter` --- Completion function for GNU readline" msgstr "" msgid "**Source code:** :source:`Lib/rlcompleter.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/rlcompleter.py`" msgid "" "The :mod:`!rlcompleter` module defines a completion function suitable to be " @@ -50,19 +50,19 @@ msgid "" ">>> import readline\n" ">>> readline.parse_and_bind(\"tab: complete\")\n" ">>> readline. \n" -"readline.__doc__ readline.get_line_buffer( readline." -"read_init_file(\n" -"readline.__file__ readline.insert_text( readline." -"set_completer(\n" +"readline.__doc__ " +"readline.get_line_buffer( readline.read_init_file(\n" +"readline.__file__ " +"readline.insert_text( readline.set_completer(\n" "readline.__name__ readline.parse_and_bind(\n" ">>> readline." msgstr "" msgid "" -"The :mod:`!rlcompleter` module is designed for use with Python's :ref:" -"`interactive mode `. Unless Python is run with the :option:" -"`-S` option, the module is automatically imported and configured (see :ref:" -"`rlcompleter-config`)." +"The :mod:`!rlcompleter` module is designed for use with " +"Python's :ref:`interactive mode `. Unless Python is run " +"with the :option:`-S` option, the module is automatically imported and " +"configured (see :ref:`rlcompleter-config`)." msgstr "" msgid "" @@ -84,8 +84,9 @@ msgstr "" msgid "" "If called for *text* that doesn't include a period character (``'.'``), it " -"will complete from names currently defined in :mod:`__main__`, :mod:" -"`builtins` and keywords (as defined by the :mod:`keyword` module)." +"will complete from names currently defined " +"in :mod:`__main__`, :mod:`builtins` and keywords (as defined by " +"the :mod:`keyword` module)." msgstr "" msgid "" diff --git a/library/runpy.po b/library/runpy.po index e23cd750ab..cb44f852a9 100644 --- a/library/runpy.po +++ b/library/runpy.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!runpy` --- Locating and executing Python modules" msgstr "" msgid "**Source code:** :source:`Lib/runpy.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/runpy.py`" msgid "" "The :mod:`runpy` module is used to locate and run Python modules without " @@ -71,8 +70,8 @@ msgid "" "The optional dictionary argument *init_globals* may be used to pre-populate " "the module's globals dictionary before the code is executed. *init_globals* " "will not be modified. If any of the special global variables below are " -"defined in *init_globals*, those definitions are overridden by :func:" -"`run_module`." +"defined in *init_globals*, those definitions are overridden " +"by :func:`run_module`." msgstr "" msgid "" @@ -84,28 +83,28 @@ msgid "" msgstr "" msgid "" -"``__name__`` is set to *run_name* if this optional argument is not :const:" -"`None`, to ``mod_name + '.__main__'`` if the named module is a package and " -"to the *mod_name* argument otherwise." +"``__name__`` is set to *run_name* if this optional argument is " +"not :const:`None`, to ``mod_name + '.__main__'`` if the named module is a " +"package and to the *mod_name* argument otherwise." msgstr "" msgid "" "``__spec__`` will be set appropriately for the *actually* imported module " -"(that is, ``__spec__.name`` will always be *mod_name* or ``mod_name + '." -"__main__'``, never *run_name*)." +"(that is, ``__spec__.name`` will always be *mod_name* or ``mod_name + " +"'.__main__'``, never *run_name*)." msgstr "" msgid "" -"``__file__``, ``__cached__``, ``__loader__`` and ``__package__`` are :ref:" -"`set as normal ` based on the module spec." +"``__file__``, ``__cached__``, ``__loader__`` and ``__package__`` " +"are :ref:`set as normal ` based on the module spec." msgstr "" msgid "" "If the argument *alter_sys* is supplied and evaluates to :const:`True`, then " -"``sys.argv[0]`` is updated with the value of ``__file__`` and ``sys." -"modules[__name__]`` is updated with a temporary module object for the module " -"being executed. Both ``sys.argv[0]`` and ``sys.modules[__name__]`` are " -"restored to their original values before the function returns." +"``sys.argv[0]`` is updated with the value of ``__file__`` and " +"``sys.modules[__name__]`` is updated with a temporary module object for the " +"module being executed. Both ``sys.argv[0]`` and ``sys.modules[__name__]`` " +"are restored to their original values before the function returns." msgstr "" msgid "" @@ -130,8 +129,8 @@ msgstr "" msgid "" "Updated to take advantage of the module spec feature added by :pep:`451`. " "This allows ``__cached__`` to be set correctly for modules run this way, as " -"well as ensuring the real module name is always accessible as ``__spec__." -"name``." +"well as ensuring the real module name is always accessible as " +"``__spec__.name``." msgstr "" msgid "" @@ -161,13 +160,13 @@ msgid "" "The optional dictionary argument *init_globals* may be used to pre-populate " "the module's globals dictionary before the code is executed. *init_globals* " "will not be modified. If any of the special global variables below are " -"defined in *init_globals*, those definitions are overridden by :func:" -"`run_path`." +"defined in *init_globals*, those definitions are overridden " +"by :func:`run_path`." msgstr "" msgid "" -"``__name__`` is set to *run_name* if this optional argument is not :const:" -"`None` and to ``''`` otherwise." +"``__name__`` is set to *run_name* if this optional argument is " +"not :const:`None` and to ``''`` otherwise." msgstr "" msgid "" @@ -181,14 +180,14 @@ msgid "" "If *file_path* is a reference to a valid :data:`sys.path` entry, then " "``__spec__`` will be set appropriately for the imported :mod:`__main__` " "module (that is, ``__spec__.name`` will always be ``__main__``). " -"``__file__``, ``__cached__``, ``__loader__`` and ``__package__`` will be :" -"ref:`set as normal ` based on the module spec." +"``__file__``, ``__cached__``, ``__loader__`` and ``__package__`` will " +"be :ref:`set as normal ` based on the module spec." msgstr "" msgid "" -"A number of alterations are also made to the :mod:`sys` module. Firstly, :" -"data:`sys.path` may be altered as described above. ``sys.argv[0]`` is " -"updated with the value of *file_path* and ``sys.modules[__name__]`` is " +"A number of alterations are also made to the :mod:`sys` module. " +"Firstly, :data:`sys.path` may be altered as described above. ``sys.argv[0]`` " +"is updated with the value of *file_path* and ``sys.modules[__name__]`` is " "updated with a temporary module object for the module being executed. All " "modifications to items in :mod:`sys` are reverted before the function " "returns." diff --git a/library/sched.po b/library/sched.po index 0b5034a8a4..30e3273b0d 100644 --- a/library/sched.po +++ b/library/sched.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!sched` --- Event scheduler" msgstr "" msgid "**Source code:** :source:`Lib/sched.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/sched.py`" msgid "" "The :mod:`sched` module defines a class which implements a general purpose " @@ -136,9 +136,11 @@ msgid "" msgstr "" msgid "" -"If *blocking* is false executes the scheduled events due to expire soonest " -"(if any) and then return the deadline of the next scheduled call in the " -"scheduler (if any)." +"If *blocking* is false, immediately executes all events in the queue which " +"have a time value less than or equal to the current *timefunc* value (if " +"any) and returns the difference between the current *timefunc* value and the " +"time value of the next scheduled event in the scheduler's event queue. If " +"the queue is empty, returns ``None``." msgstr "" msgid "" diff --git a/library/secrets.po b/library/secrets.po index 65205a08d3..86bd77c244 100644 --- a/library/secrets.po +++ b/library/secrets.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!secrets` --- Generate secure random numbers for managing secrets" msgstr "" msgid "**Source code:** :source:`Lib/secrets.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/secrets.py`" msgid "" "The :mod:`secrets` module is used for generating cryptographically strong " @@ -76,9 +76,12 @@ msgid "" "similar." msgstr "" +msgid "Return a random byte string containing *nbytes* number of bytes." +msgstr "" + msgid "" -"Return a random byte string containing *nbytes* number of bytes. If *nbytes* " -"is ``None`` or not supplied, a reasonable default is used." +"If *nbytes* is not specified or ``None``, :const:`DEFAULT_ENTROPY` is used " +"instead." msgstr "" msgid "" @@ -88,8 +91,7 @@ msgstr "" msgid "" "Return a random text string, in hexadecimal. The string has *nbytes* random " -"bytes, each byte converted to two hex digits. If *nbytes* is ``None`` or " -"not supplied, a reasonable default is used." +"bytes, each byte converted to two hex digits." msgstr "" msgid "" @@ -100,8 +102,7 @@ msgstr "" msgid "" "Return a random URL-safe text string, containing *nbytes* random bytes. The " "text is Base64 encoded, so on average each byte results in approximately 1.3 " -"characters. If *nbytes* is ``None`` or not supplied, a reasonable default " -"is used." +"characters." msgstr "" msgid "" @@ -131,12 +132,16 @@ msgstr "" msgid "" "Otherwise, if no argument is provided, or if the argument is ``None``, the " -"``token_*`` functions will use a reasonable default instead." +"``token_*`` functions use :const:`DEFAULT_ENTROPY` instead." +msgstr "" + +msgid "" +"Default number of bytes of randomness used by the ``token_*`` functions." msgstr "" msgid "" -"That default is subject to change at any time, including during maintenance " -"releases." +"The exact value is subject to change at any time, including during " +"maintenance releases." msgstr "" msgid "Other functions" @@ -145,9 +150,9 @@ msgstr "" msgid "" "Return ``True`` if strings or :term:`bytes-like objects ` " "*a* and *b* are equal, otherwise ``False``, using a \"constant-time " -"compare\" to reduce the risk of `timing attacks `_. See :func:`hmac.compare_digest` for additional " -"details." +"compare\" to reduce the risk of `timing attacks `__. " +"See :func:`hmac.compare_digest` for additional details." msgstr "" msgid "Recipes and best practices" diff --git a/library/security_warnings.po b/library/security_warnings.po index fb9353b113..b1485f933f 100644 --- a/library/security_warnings.po +++ b/library/security_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: -# Transifex Bot <>, 2023 +# Rafael Fontenelle , 2025 # #, fuzzy msgid "" msgstr "" -"Project-Id-Version: Python 3.11\n" +"Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2023-05-19 14:13+0000\n" -"PO-Revision-Date: 2021-08-10 13:22+0000\n" -"Last-Translator: Transifex Bot <>, 2023\n" +"POT-Creation-Date: 2025-07-11 15:02+0000\n" +"PO-Revision-Date: 2025-05-08 05: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" @@ -24,17 +24,14 @@ msgstr "" "n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n" msgid "Security Considerations" -msgstr "" +msgstr "Güvenlik Hususları" msgid "The following modules have specific security considerations:" msgstr "" msgid "" -":mod:`base64`: :ref:`base64 security considerations ` in :" -"rfc:`4648`" -msgstr "" - -msgid ":mod:`cgi`: :ref:`CGI security considerations `" +":mod:`base64`: :ref:`base64 security considerations ` " +"in :rfc:`4648`" msgstr "" msgid "" @@ -85,7 +82,7 @@ msgid "" "conditions `" msgstr "" -msgid ":mod:`xml`: :ref:`XML vulnerabilities `" +msgid ":mod:`xml`: :ref:`XML security `" msgstr "" msgid "" @@ -95,9 +92,9 @@ msgstr "" msgid "" "The :option:`-I` command line option can be used to run Python in isolated " -"mode. When it cannot be used, the :option:`-P` option or the :envvar:" -"`PYTHONSAFEPATH` environment variable can be used to not prepend a " -"potentially unsafe path to :data:`sys.path` such as the current directory, " +"mode. When it cannot be used, the :option:`-P` option or " +"the :envvar:`PYTHONSAFEPATH` environment variable can be used to not prepend " +"a potentially unsafe path to :data:`sys.path` such as the current directory, " "the script's directory or an empty string." msgstr "" diff --git a/library/select.po b/library/select.po index c719bbab67..6e2144a4fa 100644 --- a/library/select.po +++ b/library/select.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,11 +29,11 @@ msgstr "" msgid "" "This module provides access to the :c:func:`!select` and :c:func:`!poll` " "functions available in most operating systems, :c:func:`!devpoll` available " -"on Solaris and derivatives, :c:func:`!epoll` available on Linux 2.5+ and :c:" -"func:`!kqueue` available on most BSD. Note that on Windows, it only works " -"for sockets; on other operating systems, it also works for other file types " -"(in particular, on Unix, it works on pipes). It cannot be used on regular " -"files to determine whether a file has grown since it was last read." +"on Solaris and derivatives, :c:func:`!epoll` available on Linux 2.5+ " +"and :c:func:`!kqueue` available on most BSD. Note that on Windows, it only " +"works for sockets; on other operating systems, it also works for other file " +"types (in particular, on Unix, it works on pipes). It cannot be used on " +"regular files to determine whether a file has grown since it was last read." msgstr "" msgid "" @@ -62,16 +61,16 @@ msgid "Following :pep:`3151`, this class was made an alias of :exc:`OSError`." msgstr "" msgid "" -"(Only supported on Solaris and derivatives.) Returns a ``/dev/poll`` " -"polling object; see section :ref:`devpoll-objects` below for the methods " -"supported by devpoll objects." +"Returns a ``/dev/poll`` polling object; see section :ref:`devpoll-objects` " +"below for the methods supported by devpoll objects." msgstr "" msgid "" ":c:func:`!devpoll` objects are linked to the number of file descriptors " -"allowed at the time of instantiation. If your program reduces this value, :c:" -"func:`!devpoll` will fail. If your program increases this value, :c:func:`!" -"devpoll` may return an incomplete list of active file descriptors." +"allowed at the time of instantiation. If your program reduces this " +"value, :c:func:`!devpoll` will fail. If your program increases this " +"value, :c:func:`!devpoll` may return an incomplete list of active file " +"descriptors." msgstr "" msgid "The new file descriptor is :ref:`non-inheritable `." @@ -81,8 +80,8 @@ msgid "The new file descriptor is now non-inheritable." msgstr "" msgid "" -"(Only supported on Linux 2.5.44 and newer.) Return an edge polling object, " -"which can be used as Edge or Level Triggered interface for I/O events." +"Return an edge polling object, which can be used as Edge or Level Triggered " +"interface for I/O events." msgstr "" msgid "" @@ -104,9 +103,9 @@ msgid "" msgstr "" msgid "" -"``epoll`` objects support the context management protocol: when used in a :" -"keyword:`with` statement, the new file descriptor is automatically closed at " -"the end of the block." +"``epoll`` objects support the context management protocol: when used in " +"a :keyword:`with` statement, the new file descriptor is automatically closed " +"at the end of the block." msgstr "" msgid "Added the *flags* parameter." @@ -123,20 +122,19 @@ msgid "" msgstr "" msgid "" -"(Not supported by all operating systems.) Returns a polling object, which " -"supports registering and unregistering file descriptors, and then polling " -"them for I/O events; see section :ref:`poll-objects` below for the methods " -"supported by polling objects." +"Returns a polling object, which supports registering and unregistering file " +"descriptors, and then polling them for I/O events; see section :ref:`poll-" +"objects` below for the methods supported by polling objects." msgstr "" msgid "" -"(Only supported on BSD.) Returns a kernel queue object; see section :ref:" -"`kqueue-objects` below for the methods supported by kqueue objects." +"Returns a kernel queue object; see section :ref:`kqueue-objects` below for " +"the methods supported by kqueue objects." msgstr "" msgid "" -"(Only supported on BSD.) Returns a kernel event object; see section :ref:" -"`kevent-objects` below for the methods supported by kevent objects." +"Returns a kernel event object; see section :ref:`kevent-objects` below for " +"the methods supported by kevent objects." msgstr "" msgid "" @@ -161,9 +159,9 @@ msgid "" "Empty iterables are allowed, but acceptance of three empty iterables is " "platform-dependent. (It is known to work on Unix but not on Windows.) The " "optional *timeout* argument specifies a time-out as a floating-point number " -"in seconds. When the *timeout* argument is omitted the function blocks " -"until at least one file descriptor is ready. A time-out value of zero " -"specifies a poll and never blocks." +"in seconds. When the *timeout* argument is omitted or ``None``, the function " +"blocks until at least one file descriptor is ready. A time-out value of " +"zero specifies a poll and never blocks." msgstr "" msgid "" @@ -174,11 +172,11 @@ msgstr "" msgid "" "Among the acceptable object types in the iterables are Python :term:`file " -"objects ` (e.g. ``sys.stdin``, or objects returned by :func:" -"`open` or :func:`os.popen`), socket objects returned by :func:`socket." -"socket`. You may also define a :dfn:`wrapper` class yourself, as long as it " -"has an appropriate :meth:`~io.IOBase.fileno` method (that really returns a " -"file descriptor, not just a random integer)." +"objects ` (e.g. ``sys.stdin``, or objects returned " +"by :func:`open` or :func:`os.popen`), socket objects returned " +"by :func:`socket.socket`. You may also define a :dfn:`wrapper` class " +"yourself, as long as it has an appropriate :meth:`~io.IOBase.fileno` method " +"(that really returns a file descriptor, not just a random integer)." msgstr "" msgid "" @@ -196,15 +194,16 @@ msgstr "" msgid "" "The minimum number of bytes which can be written without blocking to a pipe " -"when the pipe has been reported as ready for writing by :func:`~select." -"select`, :func:`!poll` or another interface in this module. This doesn't " -"apply to other kind of file-like objects such as sockets." +"when the pipe has been reported as ready for writing " +"by :func:`~select.select`, :func:`!poll` or another interface in this " +"module. This doesn't apply to other kinds of file-like objects such as " +"sockets." msgstr "" msgid "This value is guaranteed by POSIX to be at least 512." msgstr "" -msgid "``/dev/poll`` Polling Objects" +msgid "``/dev/poll`` polling objects" msgstr "" msgid "" @@ -227,18 +226,18 @@ msgid "Return the file descriptor number of the polling object." msgstr "" msgid "" -"Register a file descriptor with the polling object. Future calls to the :" -"meth:`poll` method will then check whether the file descriptor has any " -"pending I/O events. *fd* can be either an integer, or an object with a :" -"meth:`~io.IOBase.fileno` method that returns an integer. File objects " +"Register a file descriptor with the polling object. Future calls to " +"the :meth:`poll` method will then check whether the file descriptor has any " +"pending I/O events. *fd* can be either an integer, or an object with " +"a :meth:`~io.IOBase.fileno` method that returns an integer. File objects " "implement :meth:`!fileno`, so they can also be used as the argument." msgstr "" msgid "" "*eventmask* is an optional bitmask describing the type of events you want to " -"check for. The constants are the same that with :c:func:`!poll` object. The " -"default value is a combination of the constants :const:`POLLIN`, :const:" -"`POLLPRI`, and :const:`POLLOUT`." +"check for. The constants are the same as with :c:func:`!poll` object. The " +"default value is a combination of the " +"constants :const:`POLLIN`, :const:`POLLPRI`, and :const:`POLLOUT`." msgstr "" msgid "" @@ -249,13 +248,13 @@ msgstr "" msgid "" "This method does an :meth:`unregister` followed by a :meth:`register`. It is " -"(a bit) more efficient that doing the same explicitly." +"(a bit) more efficient than doing the same explicitly." msgstr "" msgid "" -"Remove a file descriptor being tracked by a polling object. Just like the :" -"meth:`register` method, *fd* can be an integer or an object with a :meth:" -"`~io.IOBase.fileno` method that returns an integer." +"Remove a file descriptor being tracked by a polling object. Just like " +"the :meth:`register` method, *fd* can be an integer or an object with " +"a :meth:`~io.IOBase.fileno` method that returns an integer." msgstr "" msgid "" @@ -267,22 +266,23 @@ msgid "" "Polls the set of registered file descriptors, and returns a possibly empty " "list containing ``(fd, event)`` 2-tuples for the descriptors that have " "events or errors to report. *fd* is the file descriptor, and *event* is a " -"bitmask with bits set for the reported events for that descriptor --- :const:" -"`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the descriptor " -"can be written to, and so forth. An empty list indicates that the call timed " -"out and no file descriptors had any events to report. If *timeout* is given, " -"it specifies the length of time in milliseconds which the system will wait " -"for events before returning. If *timeout* is omitted, -1, or :const:`None`, " -"the call will block until there is an event for this poll object." +"bitmask with bits set for the reported events for that descriptor " +"--- :const:`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the " +"descriptor can be written to, and so forth. An empty list indicates that the " +"call timed out and no file descriptors had any events to report. If " +"*timeout* is given, it specifies the length of time in milliseconds which " +"the system will wait for events before returning. If *timeout* is omitted, " +"-1, or :const:`None`, the call will block until there is an event for this " +"poll object." msgstr "" -msgid "Edge and Level Trigger Polling (epoll) Objects" +msgid "Edge and level trigger polling (epoll) objects" msgstr "" msgid "https://linux.die.net/man/4/epoll" msgstr "https://linux.die.net/man/4/epoll" -msgid "*eventmask*" +msgid "The *eventmask* is a bit mask using the following constants:" msgstr "" msgid "Constant" @@ -294,37 +294,37 @@ msgstr "Znaczenie" msgid ":const:`EPOLLIN`" msgstr ":const:`EPOLLIN`" -msgid "Available for read" +msgid "Available for read." msgstr "" msgid ":const:`EPOLLOUT`" msgstr ":const:`EPOLLOUT`" -msgid "Available for write" +msgid "Available for write." msgstr "" msgid ":const:`EPOLLPRI`" msgstr ":const:`EPOLLPRI`" -msgid "Urgent data for read" +msgid "Urgent data for read." msgstr "" msgid ":const:`EPOLLERR`" msgstr ":const:`EPOLLERR`" -msgid "Error condition happened on the assoc. fd" +msgid "Error condition happened on the associated fd." msgstr "" msgid ":const:`EPOLLHUP`" msgstr ":const:`EPOLLHUP`" -msgid "Hang up happened on the assoc. fd" +msgid "Hang up happened on the associated fd." msgstr "" msgid ":const:`EPOLLET`" msgstr ":const:`EPOLLET`" -msgid "Set Edge Trigger behavior, the default is Level Trigger behavior" +msgid "Set Edge Trigger behavior, the default is Level Trigger behavior." msgstr "" msgid ":const:`EPOLLONESHOT`" @@ -332,7 +332,7 @@ msgstr ":const:`EPOLLONESHOT`" msgid "" "Set one-shot behavior. After one event is pulled out, the fd is internally " -"disabled" +"disabled." msgstr "" msgid ":const:`EPOLLEXCLUSIVE`" @@ -340,7 +340,7 @@ msgstr ":const:`EPOLLEXCLUSIVE`" msgid "" "Wake only one epoll object when the associated fd has an event. The default " -"(if this flag is not set) is to wake all epoll objects polling on a fd." +"(if this flag is not set) is to wake all epoll objects polling on an fd." msgstr "" msgid ":const:`EPOLLRDHUP`" @@ -365,7 +365,7 @@ msgstr "" msgid ":const:`EPOLLWRNORM`" msgstr ":const:`EPOLLWRNORM`" -msgid "Equivalent to :const:`EPOLLOUT`" +msgid "Equivalent to :const:`EPOLLOUT`." msgstr "" msgid ":const:`EPOLLWRBAND`" @@ -397,10 +397,10 @@ msgstr "" msgid "Create an epoll object from a given file descriptor." msgstr "" -msgid "Register a fd descriptor with the epoll object." +msgid "Register a file descriptor *fd* with the epoll object." msgstr "" -msgid "Modify a registered file descriptor." +msgid "Modify a registered file descriptor *fd*." msgstr "" msgid "Remove a registered file descriptor from the epoll object." @@ -412,7 +412,7 @@ msgstr "" msgid "Wait for events. timeout in seconds (float)" msgstr "" -msgid "Polling Objects" +msgid "Polling objects" msgstr "" msgid "" @@ -428,52 +428,54 @@ msgstr "" msgid "" "*eventmask* is an optional bitmask describing the type of events you want to " -"check for, and can be a combination of the constants :const:`POLLIN`, :const:" -"`POLLPRI`, and :const:`POLLOUT`, described in the table below. If not " -"specified, the default value used will check for all 3 types of events." +"check for, and can be a combination of the " +"constants :const:`POLLIN`, :const:`POLLPRI`, and :const:`POLLOUT`, described " +"in the table below. If not specified, the default value used will check for " +"all 3 types of events." msgstr "" msgid ":const:`POLLIN`" msgstr ":const:`POLLIN`" -msgid "There is data to read" +msgid "There is data to read." msgstr "" msgid ":const:`POLLPRI`" msgstr ":const:`POLLPRI`" -msgid "There is urgent data to read" +msgid "There is urgent data to read." msgstr "" msgid ":const:`POLLOUT`" msgstr ":const:`POLLOUT`" -msgid "Ready for output: writing will not block" +msgid "Ready for output: writing will not block." msgstr "" msgid ":const:`POLLERR`" msgstr ":const:`POLLERR`" -msgid "Error condition of some sort" +msgid "Error condition of some sort." msgstr "" msgid ":const:`POLLHUP`" msgstr ":const:`POLLHUP`" -msgid "Hung up" +msgid "Hung up." msgstr "" msgid ":const:`POLLRDHUP`" msgstr ":const:`POLLRDHUP`" msgid "" -"Stream socket peer closed connection, or shut down writing half of connection" +"Stream socket peer closed connection, or shut down writing half of " +"connection." msgstr "" msgid ":const:`POLLNVAL`" msgstr ":const:`POLLNVAL`" -msgid "Invalid request: descriptor not open" +msgid "Invalid request: descriptor not open." msgstr "" msgid "" @@ -484,29 +486,30 @@ msgstr "" msgid "" "Modifies an already registered fd. This has the same effect as " "``register(fd, eventmask)``. Attempting to modify a file descriptor that " -"was never registered causes an :exc:`OSError` exception with errno :const:" -"`ENOENT` to be raised." +"was never registered causes an :exc:`OSError` exception with " +"errno :const:`ENOENT` to be raised." msgstr "" msgid "" -"Attempting to remove a file descriptor that was never registered causes a :" -"exc:`KeyError` exception to be raised." +"Attempting to remove a file descriptor that was never registered causes " +"a :exc:`KeyError` exception to be raised." msgstr "" msgid "" "Polls the set of registered file descriptors, and returns a possibly empty " "list containing ``(fd, event)`` 2-tuples for the descriptors that have " "events or errors to report. *fd* is the file descriptor, and *event* is a " -"bitmask with bits set for the reported events for that descriptor --- :const:" -"`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the descriptor " -"can be written to, and so forth. An empty list indicates that the call timed " -"out and no file descriptors had any events to report. If *timeout* is given, " -"it specifies the length of time in milliseconds which the system will wait " -"for events before returning. If *timeout* is omitted, negative, or :const:" -"`None`, the call will block until there is an event for this poll object." +"bitmask with bits set for the reported events for that descriptor " +"--- :const:`POLLIN` for waiting input, :const:`POLLOUT` to indicate that the " +"descriptor can be written to, and so forth. An empty list indicates that the " +"call timed out and no file descriptors had any events to report. If " +"*timeout* is given, it specifies the length of time in milliseconds which " +"the system will wait for events before returning. If *timeout* is omitted, " +"negative, or :const:`None`, the call will block until there is an event for " +"this poll object." msgstr "" -msgid "Kqueue Objects" +msgid "Kqueue objects" msgstr "" msgid "Close the control file descriptor of the kqueue object." @@ -532,7 +535,7 @@ msgid "" "forever" msgstr "" -msgid "Kevent Objects" +msgid "Kevent objects" msgstr "" msgid "https://man.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2" @@ -551,51 +554,52 @@ msgstr "" msgid ":const:`KQ_FILTER_READ`" msgstr ":const:`KQ_FILTER_READ`" -msgid "Takes a descriptor and returns whenever there is data available to read" +msgid "" +"Takes a descriptor and returns whenever there is data available to read." msgstr "" msgid ":const:`KQ_FILTER_WRITE`" msgstr ":const:`KQ_FILTER_WRITE`" msgid "" -"Takes a descriptor and returns whenever there is data available to write" +"Takes a descriptor and returns whenever there is data available to write." msgstr "" msgid ":const:`KQ_FILTER_AIO`" msgstr ":const:`KQ_FILTER_AIO`" -msgid "AIO requests" +msgid "AIO requests." msgstr "" msgid ":const:`KQ_FILTER_VNODE`" msgstr ":const:`KQ_FILTER_VNODE`" msgid "" -"Returns when one or more of the requested events watched in *fflag* occurs" +"Returns when one or more of the requested events watched in *fflag* occurs." msgstr "" msgid ":const:`KQ_FILTER_PROC`" msgstr ":const:`KQ_FILTER_PROC`" -msgid "Watch for events on a process id" +msgid "Watch for events on a process ID." msgstr "" msgid ":const:`KQ_FILTER_NETDEV`" msgstr ":const:`KQ_FILTER_NETDEV`" -msgid "Watch for events on a network device [not available on macOS]" +msgid "Watch for events on a network device (not available on macOS)." msgstr "" msgid ":const:`KQ_FILTER_SIGNAL`" msgstr ":const:`KQ_FILTER_SIGNAL`" -msgid "Returns whenever the watched signal is delivered to the process" +msgid "Returns whenever the watched signal is delivered to the process." msgstr "" msgid ":const:`KQ_FILTER_TIMER`" msgstr ":const:`KQ_FILTER_TIMER`" -msgid "Establishes an arbitrary timer" +msgid "Establishes an arbitrary timer." msgstr "" msgid "Filter action." @@ -604,43 +608,43 @@ msgstr "" msgid ":const:`KQ_EV_ADD`" msgstr ":const:`KQ_EV_ADD`" -msgid "Adds or modifies an event" +msgid "Adds or modifies an event." msgstr "" msgid ":const:`KQ_EV_DELETE`" msgstr ":const:`KQ_EV_DELETE`" -msgid "Removes an event from the queue" +msgid "Removes an event from the queue." msgstr "" msgid ":const:`KQ_EV_ENABLE`" msgstr ":const:`KQ_EV_ENABLE`" -msgid "Permitscontrol() to returns the event" +msgid "Permits control() to return the event." msgstr "" msgid ":const:`KQ_EV_DISABLE`" msgstr ":const:`KQ_EV_DISABLE`" -msgid "Disablesevent" +msgid "Disables event." msgstr "" msgid ":const:`KQ_EV_ONESHOT`" msgstr ":const:`KQ_EV_ONESHOT`" -msgid "Removes event after first occurrence" +msgid "Removes event after first occurrence." msgstr "" msgid ":const:`KQ_EV_CLEAR`" msgstr ":const:`KQ_EV_CLEAR`" -msgid "Reset the state after an event is retrieved" +msgid "Reset the state after an event is retrieved." msgstr "" msgid ":const:`KQ_EV_SYSFLAGS`" msgstr ":const:`KQ_EV_SYSFLAGS`" -msgid "internal event" +msgid "Internal event." msgstr "" msgid ":const:`KQ_EV_FLAG1`" @@ -649,16 +653,16 @@ msgstr ":const:`KQ_EV_FLAG1`" msgid ":const:`KQ_EV_EOF`" msgstr ":const:`KQ_EV_EOF`" -msgid "Filter specific EOF condition" +msgid "Filter-specific EOF condition." msgstr "" msgid ":const:`KQ_EV_ERROR`" msgstr ":const:`KQ_EV_ERROR`" -msgid "See return values" +msgid "See return values." msgstr "" -msgid "Filter specific flags." +msgid "Filter-specific flags." msgstr "" msgid ":const:`KQ_FILTER_READ` and :const:`KQ_FILTER_WRITE` filter flags:" @@ -667,7 +671,7 @@ msgstr "" msgid ":const:`KQ_NOTE_LOWAT`" msgstr ":const:`KQ_NOTE_LOWAT`" -msgid "low water mark of a socket buffer" +msgid "Low water mark of a socket buffer." msgstr "" msgid ":const:`KQ_FILTER_VNODE` filter flags:" @@ -676,43 +680,43 @@ msgstr "" msgid ":const:`KQ_NOTE_DELETE`" msgstr ":const:`KQ_NOTE_DELETE`" -msgid "*unlink()* was called" +msgid "*unlink()* was called." msgstr "" msgid ":const:`KQ_NOTE_WRITE`" msgstr ":const:`KQ_NOTE_WRITE`" -msgid "a write occurred" +msgid "A write occurred." msgstr "" msgid ":const:`KQ_NOTE_EXTEND`" msgstr ":const:`KQ_NOTE_EXTEND`" -msgid "the file was extended" +msgid "The file was extended." msgstr "" msgid ":const:`KQ_NOTE_ATTRIB`" msgstr ":const:`KQ_NOTE_ATTRIB`" -msgid "an attribute was changed" +msgid "An attribute was changed." msgstr "" msgid ":const:`KQ_NOTE_LINK`" msgstr ":const:`KQ_NOTE_LINK`" -msgid "the link count has changed" +msgid "The link count has changed." msgstr "" msgid ":const:`KQ_NOTE_RENAME`" msgstr ":const:`KQ_NOTE_RENAME`" -msgid "the file was renamed" +msgid "The file was renamed." msgstr "" msgid ":const:`KQ_NOTE_REVOKE`" msgstr ":const:`KQ_NOTE_REVOKE`" -msgid "access to the file was revoked" +msgid "Access to the file was revoked." msgstr "" msgid ":const:`KQ_FILTER_PROC` filter flags:" @@ -721,25 +725,25 @@ msgstr "" msgid ":const:`KQ_NOTE_EXIT`" msgstr ":const:`KQ_NOTE_EXIT`" -msgid "the process has exited" +msgid "The process has exited." msgstr "" msgid ":const:`KQ_NOTE_FORK`" msgstr ":const:`KQ_NOTE_FORK`" -msgid "the process has called *fork()*" +msgid "The process has called *fork()*." msgstr "" msgid ":const:`KQ_NOTE_EXEC`" msgstr ":const:`KQ_NOTE_EXEC`" -msgid "the process has executed a new process" +msgid "The process has executed a new process." msgstr "" msgid ":const:`KQ_NOTE_PCTRLMASK`" msgstr ":const:`KQ_NOTE_PCTRLMASK`" -msgid "internal filter flag" +msgid "Internal filter flag." msgstr "" msgid ":const:`KQ_NOTE_PDATAMASK`" @@ -748,19 +752,19 @@ msgstr ":const:`KQ_NOTE_PDATAMASK`" msgid ":const:`KQ_NOTE_TRACK`" msgstr ":const:`KQ_NOTE_TRACK`" -msgid "follow a process across *fork()*" +msgid "Follow a process across *fork()*." msgstr "" msgid ":const:`KQ_NOTE_CHILD`" msgstr ":const:`KQ_NOTE_CHILD`" -msgid "returned on the child process for *NOTE_TRACK*" +msgid "Returned on the child process for *NOTE_TRACK*." msgstr "" msgid ":const:`KQ_NOTE_TRACKERR`" msgstr ":const:`KQ_NOTE_TRACKERR`" -msgid "unable to attach to a child" +msgid "Unable to attach to a child." msgstr "" msgid ":const:`KQ_FILTER_NETDEV` filter flags (not available on macOS):" @@ -769,25 +773,25 @@ msgstr "" msgid ":const:`KQ_NOTE_LINKUP`" msgstr ":const:`KQ_NOTE_LINKUP`" -msgid "link is up" +msgid "Link is up." msgstr "" msgid ":const:`KQ_NOTE_LINKDOWN`" msgstr ":const:`KQ_NOTE_LINKDOWN`" -msgid "link is down" +msgid "Link is down." msgstr "" msgid ":const:`KQ_NOTE_LINKINV`" msgstr ":const:`KQ_NOTE_LINKINV`" -msgid "link state is invalid" +msgid "Link state is invalid." msgstr "" -msgid "Filter specific data." +msgid "Filter-specific data." msgstr "" -msgid "User defined value." +msgid "User-defined value." msgstr "" msgid "socket() (in module socket)" diff --git a/library/selectors.po b/library/selectors.po index 3a615e3017..c86c11126d 100644 --- a/library/selectors.po +++ b/library/selectors.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 +27,7 @@ msgid ":mod:`!selectors` --- High-level I/O multiplexing" msgstr "" msgid "**Source code:** :source:`Lib/selectors.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/selectors.py`" msgid "Introduction" msgstr "Wprowadzenie" @@ -43,10 +40,11 @@ msgstr "" msgid "" "It defines a :class:`BaseSelector` abstract base class, along with several " -"concrete implementations (:class:`KqueueSelector`, :class:" -"`EpollSelector`...), that can be used to wait for I/O readiness notification " -"on multiple file objects. In the following, \"file object\" refers to any " -"object with a :meth:`~io.IOBase.fileno` method, or a raw file descriptor. " +"concrete implementations " +"(:class:`KqueueSelector`, :class:`EpollSelector`...), that can be used to " +"wait for I/O readiness notification on multiple file objects. In the " +"following, \"file object\" refers to any object with " +"a :meth:`~io.IOBase.fileno` method, or a raw file descriptor. " "See :term:`file object`." msgstr "" @@ -95,7 +93,7 @@ msgstr "" msgid "" "In the following, *events* is a bitwise mask indicating which I/O events " "should be waited for on a given file object. It can be a combination of the " -"modules constants below:" +"module's constants below:" msgstr "" msgid "Constant" @@ -135,11 +133,12 @@ msgid "" "A :class:`BaseSelector` is used to wait for I/O event readiness on multiple " "file objects. It supports file stream registration, unregistration, and a " "method to wait for I/O events on those streams, with an optional timeout. " -"It's an abstract base class, so cannot be instantiated. Use :class:" -"`DefaultSelector` instead, or one of :class:`SelectSelector`, :class:" -"`KqueueSelector` etc. if you want to specifically use an implementation, and " -"your platform supports it. :class:`BaseSelector` and its concrete " -"implementations support the :term:`context manager` protocol." +"It's an abstract base class, so cannot be instantiated. " +"Use :class:`DefaultSelector` instead, or one " +"of :class:`SelectSelector`, :class:`KqueueSelector` etc. if you want to " +"specifically use an implementation, and your platform supports " +"it. :class:`BaseSelector` and its concrete implementations support " +"the :term:`context manager` protocol." msgstr "" msgid "Register a file object for selection, monitoring it for I/O events." @@ -152,9 +151,9 @@ msgid "" msgstr "" msgid "" -"This returns a new :class:`SelectorKey` instance, or raises a :exc:" -"`ValueError` in case of invalid event mask or file descriptor, or :exc:" -"`KeyError` if the file object is already registered." +"This returns a new :class:`SelectorKey` instance, or raises " +"a :exc:`ValueError` in case of invalid event mask or file descriptor, " +"or :exc:`KeyError` if the file object is already registered." msgstr "" msgid "" @@ -166,10 +165,10 @@ msgid "*fileobj* must be a file object previously registered." msgstr "" msgid "" -"This returns the associated :class:`SelectorKey` instance, or raises a :exc:" -"`KeyError` if *fileobj* is not registered. It will raise :exc:`ValueError` " -"if *fileobj* is invalid (e.g. it has no ``fileno()`` method or its " -"``fileno()`` method has an invalid return value)." +"This returns the associated :class:`SelectorKey` instance, or raises " +"a :exc:`KeyError` if *fileobj* is not registered. It will " +"raise :exc:`ValueError` if *fileobj* is invalid (e.g. it has no ``fileno()`` " +"method or its ``fileno()`` method has an invalid return value)." msgstr "" msgid "Change a registered file object's monitored events or attached data." @@ -182,9 +181,9 @@ msgid "" msgstr "" msgid "" -"This returns a new :class:`SelectorKey` instance, or raises a :exc:" -"`ValueError` in case of invalid event mask or file descriptor, or :exc:" -"`KeyError` if the file object is not registered." +"This returns a new :class:`SelectorKey` instance, or raises " +"a :exc:`ValueError` in case of invalid event mask or file descriptor, " +"or :exc:`KeyError` if the file object is not registered." msgstr "" msgid "" @@ -269,16 +268,16 @@ msgid ":func:`select.devpoll`-based selector." msgstr "" msgid "" -"This returns the file descriptor used by the underlying :func:`select." -"devpoll` object." +"This returns the file descriptor used by the " +"underlying :func:`select.devpoll` object." msgstr "" msgid ":func:`select.kqueue`-based selector." msgstr "" msgid "" -"This returns the file descriptor used by the underlying :func:`select." -"kqueue` object." +"This returns the file descriptor used by the " +"underlying :func:`select.kqueue` object." msgstr "" msgid "Examples" diff --git a/library/shelve.po b/library/shelve.po index 7635d25796..14ad6b07b3 100644 --- a/library/shelve.po +++ b/library/shelve.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2024 -# Rafael Fontenelle , 2024 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:12+0000\n" -"Last-Translator: Rafael Fontenelle , 2024\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +28,7 @@ msgid ":mod:`!shelve` --- Python object persistence" msgstr "" msgid "**Source code:** :source:`Lib/shelve.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/shelve.py`" msgid "" "A \"shelf\" is a persistent, dictionary-like object. The difference with " @@ -45,8 +44,8 @@ msgid "" "for the underlying database. As a side-effect, an extension may be added to " "the filename and more than one file may be created. By default, the " "underlying database file is opened for reading and writing. The optional " -"*flag* parameter has the same interpretation as the *flag* parameter of :" -"func:`dbm.open`." +"*flag* parameter has the same interpretation as the *flag* parameter " +"of :func:`dbm.open`." msgstr "" msgid "" @@ -60,13 +59,13 @@ msgid "" "dictionary entry is modified. By default modified objects are written " "*only* when assigned to the shelf (see :ref:`shelve-example`). If the " "optional *writeback* parameter is set to ``True``, all entries accessed are " -"also cached in memory, and written back on :meth:`~Shelf.sync` and :meth:" -"`~Shelf.close`; this can make it handier to mutate mutable entries in the " -"persistent dictionary, but, if many entries are accessed, it can consume " -"vast amounts of memory for the cache, and it can make the close operation " -"very slow since all accessed entries are written back (there is no way to " -"determine which accessed entries are mutable, nor which ones were actually " -"mutated)." +"also cached in memory, and written back on :meth:`~Shelf.sync` " +"and :meth:`~Shelf.close`; this can make it handier to mutate mutable entries " +"in the persistent dictionary, but, if many entries are accessed, it can " +"consume vast amounts of memory for the cache, and it can make the close " +"operation very slow since all accessed entries are written back (there is no " +"way to determine which accessed entries are mutable, nor which ones were " +"actually mutated)." msgstr "" msgid "" @@ -77,9 +76,9 @@ msgid "Accepts :term:`path-like object` for filename." msgstr "" msgid "" -"Do not rely on the shelf being closed automatically; always call :meth:" -"`~Shelf.close` explicitly when you don't need it any more, or use :func:" -"`shelve.open` as a context manager::" +"Do not rely on the shelf being closed automatically; always " +"call :meth:`~Shelf.close` explicitly when you don't need it any more, or " +"use :func:`shelve.open` as a context manager::" msgstr "" msgid "" @@ -94,7 +93,7 @@ msgid "" msgstr "" msgid "" -"Shelf objects support most of methods and operations supported by " +"Shelf objects support most of the methods and operations supported by " "dictionaries (except copying, constructors and operators ``|`` and ``|=``). " "This eases the transition from dictionary based scripts to those requiring " "persistent storage." @@ -183,27 +182,27 @@ msgid "" msgstr "" msgid "Added context manager support." -msgstr "" +msgstr "Dodano obsługę menedżera kontekstu v" msgid "" -"A subclass of :class:`Shelf` which exposes :meth:`!first`, :meth:`!next`, :" -"meth:`!previous`, :meth:`!last` and :meth:`!set_location` methods. These are " -"available in the third-party :mod:`!bsddb` module from `pybsddb `_ but not in other database modules. The " -"*dict* object passed to the constructor must support those methods. This is " -"generally accomplished by calling one of :func:`!bsddb.hashopen`, :func:`!" -"bsddb.btopen` or :func:`!bsddb.rnopen`. The optional *protocol*, " -"*writeback*, and *keyencoding* parameters have the same interpretation as " -"for the :class:`Shelf` class." +"A subclass of :class:`Shelf` which exposes :meth:`!first`, :meth:`!" +"next`, :meth:`!previous`, :meth:`!last` and :meth:`!set_location` methods. " +"These are available in the third-party :mod:`!bsddb` module from `pybsddb " +"`_ but not in other database " +"modules. The *dict* object passed to the constructor must support those " +"methods. This is generally accomplished by calling one of :func:`!" +"bsddb.hashopen`, :func:`!bsddb.btopen` or :func:`!bsddb.rnopen`. The " +"optional *protocol*, *writeback*, and *keyencoding* parameters have the same " +"interpretation as for the :class:`Shelf` class." msgstr "" msgid "" "A subclass of :class:`Shelf` which accepts a *filename* instead of a dict-" "like object. The underlying file will be opened using :func:`dbm.open`. By " "default, the file will be created and opened for both read and write. The " -"optional *flag* parameter has the same interpretation as for the :func:`." -"open` function. The optional *protocol* and *writeback* parameters have the " -"same interpretation as for the :class:`Shelf` class." +"optional *flag* parameter has the same interpretation as for " +"the :func:`.open` function. The optional *protocol* and *writeback* " +"parameters have the same interpretation as for the :class:`Shelf` class." msgstr "" msgid "Example" diff --git a/library/shlex.po b/library/shlex.po index 2d4ceef257..4783ab0462 100644 --- a/library/shlex.po +++ b/library/shlex.po @@ -40,12 +40,12 @@ msgid "The :mod:`shlex` module defines the following functions:" msgstr "" msgid "" -"Split the string *s* using shell-like syntax. If *comments* is :const:" -"`False` (the default), the parsing of comments in the given string will be " -"disabled (setting the :attr:`~shlex.commenters` attribute of the :class:" -"`~shlex.shlex` instance to the empty string). This function operates in " -"POSIX mode by default, but uses non-POSIX mode if the *posix* argument is " -"false." +"Split the string *s* using shell-like syntax. If *comments* " +"is :const:`False` (the default), the parsing of comments in the given string " +"will be disabled (setting the :attr:`~shlex.commenters` attribute of " +"the :class:`~shlex.shlex` instance to the empty string). This function " +"operates in POSIX mode by default, but uses non-POSIX mode if the *posix* " +"argument is false." msgstr "" msgid "" @@ -85,8 +85,8 @@ msgid "" msgstr "" msgid "" -"Consider using functions that pass command arguments with lists such as :" -"func:`subprocess.run` with ``shell=False``." +"Consider using functions that pass command arguments with lists such " +"as :func:`subprocess.run` with ``shell=False``." msgstr "" msgid "This idiom would be unsafe:" @@ -104,25 +104,26 @@ msgstr "" msgid "" "A :class:`~shlex.shlex` instance or subclass instance is a lexical analyzer " "object. The initialization argument, if present, specifies where to read " -"characters from. It must be a file-/stream-like object with :meth:`~io." -"TextIOBase.read` and :meth:`~io.TextIOBase.readline` methods, or a string. " -"If no argument is given, input will be taken from ``sys.stdin``. The second " -"optional argument is a filename string, which sets the initial value of the :" -"attr:`~shlex.infile` attribute. If the *instream* argument is omitted or " -"equal to ``sys.stdin``, this second argument defaults to \"stdin\". The " -"*posix* argument defines the operational mode: when *posix* is not true " -"(default), the :class:`~shlex.shlex` instance will operate in compatibility " -"mode. When operating in POSIX mode, :class:`~shlex.shlex` will try to be as " -"close as possible to the POSIX shell parsing rules. The *punctuation_chars* " -"argument provides a way to make the behaviour even closer to how real shells " -"parse. This can take a number of values: the default value, ``False``, " -"preserves the behaviour seen under Python 3.5 and earlier. If set to " -"``True``, then parsing of the characters ``();<>|&`` is changed: any run of " -"these characters (considered punctuation characters) is returned as a single " -"token. If set to a non-empty string of characters, those characters will be " -"used as the punctuation characters. Any characters in the :attr:`wordchars` " -"attribute that appear in *punctuation_chars* will be removed from :attr:" -"`wordchars`. See :ref:`improved-shell-compatibility` for more information. " +"characters from. It must be a file-/stream-like object " +"with :meth:`~io.TextIOBase.read` and :meth:`~io.TextIOBase.readline` " +"methods, or a string. If no argument is given, input will be taken from " +"``sys.stdin``. The second optional argument is a filename string, which sets " +"the initial value of the :attr:`~shlex.infile` attribute. If the *instream* " +"argument is omitted or equal to ``sys.stdin``, this second argument defaults " +"to \"stdin\". The *posix* argument defines the operational mode: when " +"*posix* is not true (default), the :class:`~shlex.shlex` instance will " +"operate in compatibility mode. When operating in POSIX " +"mode, :class:`~shlex.shlex` will try to be as close as possible to the POSIX " +"shell parsing rules. The *punctuation_chars* argument provides a way to " +"make the behaviour even closer to how real shells parse. This can take a " +"number of values: the default value, ``False``, preserves the behaviour seen " +"under Python 3.5 and earlier. If set to ``True``, then parsing of the " +"characters ``();<>|&`` is changed: any run of these characters (considered " +"punctuation characters) is returned as a single token. If set to a non-" +"empty string of characters, those characters will be used as the punctuation " +"characters. Any characters in the :attr:`wordchars` attribute that appear " +"in *punctuation_chars* will be removed from :attr:`wordchars`. " +"See :ref:`improved-shell-compatibility` for more information. " "*punctuation_chars* can be set only upon :class:`~shlex.shlex` instance " "creation and can't be modified later." msgstr "" @@ -185,8 +186,9 @@ msgstr "" msgid "" "This hook is exposed so that you can use it to implement directory search " "paths, addition of file extensions, and other namespace hacks. There is no " -"corresponding 'close' hook, but a shlex instance will call the :meth:`~io." -"IOBase.close` method of the sourced input stream when it returns EOF." +"corresponding 'close' hook, but a shlex instance will call " +"the :meth:`~io.IOBase.close` method of the sourced input stream when it " +"returns EOF." msgstr "" msgid "" @@ -233,10 +235,10 @@ msgstr "" msgid "" "The string of characters that will accumulate into multi-character tokens. " "By default, includes all ASCII alphanumerics and underscore. In POSIX mode, " -"the accented characters in the Latin-1 set are also included. If :attr:" -"`punctuation_chars` is not empty, the characters ``~-./*?=``, which can " -"appear in filename specifications and command line parameters, will also be " -"included in this attribute, and any characters which appear in " +"the accented characters in the Latin-1 set are also included. " +"If :attr:`punctuation_chars` is not empty, the characters ``~-./*?=``, which " +"can appear in filename specifications and command line parameters, will also " +"be included in this attribute, and any characters which appear in " "``punctuation_chars`` will be removed from ``wordchars`` if they are present " "there. If :attr:`whitespace_split` is set to ``True``, this will have no " "effect." @@ -269,14 +271,14 @@ msgstr "" msgid "" "If ``True``, tokens will only be split in whitespaces. This is useful, for " "example, for parsing command lines with :class:`~shlex.shlex`, getting " -"tokens in a similar way to shell arguments. When used in combination with :" -"attr:`punctuation_chars`, tokens will be split on whitespace in addition to " -"those characters." +"tokens in a similar way to shell arguments. When used in combination " +"with :attr:`punctuation_chars`, tokens will be split on whitespace in " +"addition to those characters." msgstr "" msgid "" -"The :attr:`punctuation_chars` attribute was made compatible with the :attr:" -"`whitespace_split` attribute." +"The :attr:`punctuation_chars` attribute was made compatible with " +"the :attr:`whitespace_split` attribute." msgstr "" msgid "" @@ -382,18 +384,19 @@ msgid "" msgstr "" msgid "" -"Enclosing characters in quotes which are not part of :attr:`~shlex." -"escapedquotes` (e.g. ``\"'\"``) preserve the literal value of all characters " -"within the quotes;" +"Enclosing characters in quotes which are not part " +"of :attr:`~shlex.escapedquotes` (e.g. ``\"'\"``) preserve the literal value " +"of all characters within the quotes;" msgstr "" msgid "" -"Enclosing characters in quotes which are part of :attr:`~shlex." -"escapedquotes` (e.g. ``'\"'``) preserves the literal value of all characters " -"within the quotes, with the exception of the characters mentioned in :attr:" -"`~shlex.escape`. The escape characters retain its special meaning only when " -"followed by the quote in use, or the escape character itself. Otherwise the " -"escape character will be considered a normal character." +"Enclosing characters in quotes which are part " +"of :attr:`~shlex.escapedquotes` (e.g. ``'\"'``) preserves the literal value " +"of all characters within the quotes, with the exception of the characters " +"mentioned in :attr:`~shlex.escape`. The escape characters retain its " +"special meaning only when followed by the quote in use, or the escape " +"character itself. Otherwise the escape character will be considered a normal " +"character." msgstr "" msgid "EOF is signaled with a :const:`None` value;" @@ -439,13 +442,13 @@ msgstr "" msgid "" "However, to match the shell as closely as possible, it is recommended to " -"always use ``posix`` and :attr:`~shlex.whitespace_split` when using :attr:" -"`~shlex.punctuation_chars`, which will negate :attr:`~shlex.wordchars` " -"entirely." +"always use ``posix`` and :attr:`~shlex.whitespace_split` when " +"using :attr:`~shlex.punctuation_chars`, which will " +"negate :attr:`~shlex.wordchars` entirely." msgstr "" msgid "" "For best effect, ``punctuation_chars`` should be set in conjunction with " -"``posix=True``. (Note that ``posix=False`` is the default for :class:`~shlex." -"shlex`.)" +"``posix=True``. (Note that ``posix=False`` is the default " +"for :class:`~shlex.shlex`.)" msgstr "" diff --git a/library/shutil.po b/library/shutil.po index 3a8718c4b2..36b2770b37 100644 --- a/library/shutil.po +++ b/library/shutil.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-27 21:02+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!shutil` --- High-level file operations" msgstr "" msgid "**Source code:** :source:`Lib/shutil.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/shutil.py`" msgid "" "The :mod:`shutil` module offers a number of high-level operations on files " @@ -38,8 +37,8 @@ msgid "" msgstr "" msgid "" -"Even the higher-level file copying functions (:func:`shutil.copy`, :func:" -"`shutil.copy2`) cannot copy all file metadata." +"Even the higher-level file copying functions " +"(:func:`shutil.copy`, :func:`shutil.copy2`) cannot copy all file metadata." msgstr "" msgid "" @@ -109,6 +108,11 @@ msgid "" "copy-operations` section." msgstr "" +msgid "" +"This exception is raised when :func:`copyfile` or :func:`copytree` attempt " +"to copy a named pipe." +msgstr "" + msgid "" "This exception is raised if source and destination in :func:`copyfile` are " "the same file." @@ -120,10 +124,10 @@ msgid "" "like object>` or path names given as strings. If *follow_symlinks* is false, " "and both *src* and *dst* are symbolic links, :func:`copymode` will attempt " "to modify the mode of *dst* itself (rather than the file it points to). " -"This functionality is not available on every platform; please see :func:" -"`copystat` for more information. If :func:`copymode` cannot modify symbolic " -"links on the local platform, and it is asked to do so, it will do nothing " -"and return." +"This functionality is not available on every platform; please " +"see :func:`copystat` for more information. If :func:`copymode` cannot " +"modify symbolic links on the local platform, and it is asked to do so, it " +"will do nothing and return." msgstr "" msgid "" @@ -165,9 +169,9 @@ msgid "" msgstr "" msgid "" -"If ``os.chflags in os.supports_follow_symlinks`` is ``True``, :func:" -"`copystat` can modify the flags of a symbolic link. (``os.chflags`` is not " -"available on all platforms.)" +"If ``os.chflags in os.supports_follow_symlinks`` is " +"``True``, :func:`copystat` can modify the flags of a symbolic link. " +"(``os.chflags`` is not available on all platforms.)" msgstr "" msgid "" @@ -223,14 +227,15 @@ msgid "" "attempts to copy all metadata from the *src* symbolic link to the newly " "created *dst* symbolic link. However, this functionality is not available on " "all platforms. On platforms where some or all of this functionality is " -"unavailable, :func:`copy2` will preserve all the metadata it can; :func:" -"`copy2` never raises an exception because it cannot preserve file metadata." +"unavailable, :func:`copy2` will preserve all the metadata it " +"can; :func:`copy2` never raises an exception because it cannot preserve file " +"metadata." msgstr "" msgid "" -":func:`copy2` uses :func:`copystat` to copy the file metadata. Please see :" -"func:`copystat` for more information about platform support for modifying " -"symbolic link metadata." +":func:`copy2` uses :func:`copystat` to copy the file metadata. Please " +"see :func:`copystat` for more information about platform support for " +"modifying symbolic link metadata." msgstr "" msgid "" @@ -240,9 +245,9 @@ msgid "" msgstr "" msgid "" -"This factory function creates a function that can be used as a callable for :" -"func:`copytree`\\'s *ignore* argument, ignoring files and directories that " -"match one of the glob-style *patterns* provided. See the example below." +"This factory function creates a function that can be used as a callable " +"for :func:`copytree`\\'s *ignore* argument, ignoring files and directories " +"that match one of the glob-style *patterns* provided. See the example below." msgstr "" msgid "" @@ -265,9 +270,9 @@ msgstr "" msgid "" "When *symlinks* is false, if the file pointed to by the symlink doesn't " -"exist, an exception will be added in the list of errors raised in an :exc:" -"`Error` exception at the end of the copy process. You can set the optional " -"*ignore_dangling_symlinks* flag to true if you want to silence this " +"exist, an exception will be added in the list of errors raised in " +"an :exc:`Error` exception at the end of the copy process. You can set the " +"optional *ignore_dangling_symlinks* flag to true if you want to silence this " "exception. Notice that this option has no effect on platforms that don't " "support :func:`os.symlink`." msgstr "" @@ -296,8 +301,8 @@ msgid "" msgstr "" msgid "" -"If *dirs_exist_ok* is false (the default) and *dst* already exists, a :exc:" -"`FileExistsError` is raised. If *dirs_exist_ok* is true, the copying " +"If *dirs_exist_ok* is false (the default) and *dst* already exists, " +"a :exc:`FileExistsError` is raised. If *dirs_exist_ok* is true, the copying " "operation will continue if it encounters existing directories, and files " "within the *dst* tree will be overwritten by corresponding files from the " "*src* tree." @@ -361,6 +366,11 @@ msgid "" "parameter it receives is the tuple returned from :func:`sys.exc_info`." msgstr "" +msgid "" +":ref:`shutil-rmtree-example` for an example of handling the removal of a " +"directory tree that contains read-only files." +msgstr "" + msgid "" "Raises an :ref:`auditing event ` ``shutil.rmtree`` with arguments " "``path``, ``dir_fd``." @@ -384,8 +394,8 @@ msgstr "" msgid "" ":func:`!rmtree` now ignores :exc:`FileNotFoundError` exceptions for all but " -"the top-level path. Exceptions other than :exc:`OSError` and subclasses of :" -"exc:`!OSError` are now always propagated to the caller." +"the top-level path. Exceptions other than :exc:`OSError` and subclasses " +"of :exc:`!OSError` are now always propagated to the caller." msgstr "" msgid "" @@ -411,18 +421,25 @@ msgid "" msgstr "" msgid "" -"If the destination is on the current filesystem, then :func:`os.rename` is " -"used. Otherwise, *src* is copied to the destination using *copy_function* " -"and then removed. In case of symlinks, a new symlink pointing to the target " -"of *src* will be created as the destination and *src* will be removed." +":func:`os.rename` is preferably used internally when *src* and the " +"destination are on the same filesystem. In case :func:`os.rename` fails due " +"to :exc:`OSError` (e.g. the user has write permission to the destination " +"file but not to its parent directory), this method falls back to using " +"*copy_function*, in which case *src* is copied to the destination using " +"*copy_function* and then removed." +msgstr "" + +msgid "" +"In case of symlinks, a new symlink pointing to the target of *src* will be " +"created in or as the destination, and *src* will be removed." msgstr "" msgid "" "If *copy_function* is given, it must be a callable that takes two arguments, " "*src* and the destination, and will be used to copy *src* to the destination " -"if :func:`os.rename` cannot be used. If the source is a directory, :func:" -"`copytree` is called, passing it the *copy_function*. The default " -"*copy_function* is :func:`copy2`. Using :func:`~shutil.copy` as the " +"if :func:`os.rename` cannot be used. If the source is a " +"directory, :func:`copytree` is called, passing it the *copy_function*. The " +"default *copy_function* is :func:`copy2`. Using :func:`~shutil.copy` as the " "*copy_function* allows the move to succeed when it is not possible to also " "copy the metadata, at the expense of not copying any of the metadata." msgstr "" @@ -492,9 +509,15 @@ msgstr "" msgid "" "*path* is a \"``PATH`` string\" specifying the directories to look in, " -"delimited by :data:`os.pathsep`. When no *path* is specified, the :envvar:" -"`PATH` environment variable is read from :data:`os.environ`, falling back " -"to :data:`os.defpath` if it is not set." +"delimited by :data:`os.pathsep`. When no *path* is specified, " +"the :envvar:`PATH` environment variable is read from :data:`os.environ`, " +"falling back to :data:`os.defpath` if it is not set." +msgstr "" + +msgid "" +"If *cmd* contains a directory component, :func:`!which` only checks the " +"specified path directly and does not search the directories listed in *path* " +"or in the system's :envvar:`PATH` environment variable." msgstr "" msgid "" @@ -556,12 +579,12 @@ msgid "Platform-dependent efficient copy operations" msgstr "" msgid "" -"Starting from Python 3.8, all functions involving a file copy (:func:" -"`copyfile`, :func:`~shutil.copy`, :func:`copy2`, :func:`copytree`, and :func:" -"`move`) may use platform-specific \"fast-copy\" syscalls in order to copy " -"the file more efficiently (see :issue:`33671`). \"fast-copy\" means that the " -"copying operation occurs within the kernel, avoiding the use of userspace " -"buffers in Python as in \"``outfd.write(infd.read())``\"." +"Starting from Python 3.8, all functions involving a file copy " +"(:func:`copyfile`, :func:`~shutil.copy`, :func:`copy2`, :func:`copytree`, " +"and :func:`move`) may use platform-specific \"fast-copy\" syscalls in order " +"to copy the file more efficiently (see :issue:`33671`). \"fast-copy\" means " +"that the copying operation occurs within the kernel, avoiding the use of " +"userspace buffers in Python as in \"``outfd.write(infd.read())``\"." msgstr "" msgid "On macOS `fcopyfile`_ is used to copy the file content (not metadata)." @@ -572,14 +595,14 @@ msgstr "" msgid "" "On Windows :func:`shutil.copyfile` uses a bigger default buffer size (1 MiB " -"instead of 64 KiB) and a :func:`memoryview`-based variant of :func:`shutil." -"copyfileobj` is used." +"instead of 64 KiB) and a :func:`memoryview`-based variant " +"of :func:`shutil.copyfileobj` is used." msgstr "" msgid "" "If the fast-copy operation fails and no data was written in the destination " -"file then shutil will silently fallback on using less efficient :func:" -"`copyfileobj` function internally." +"file then shutil will silently fall back to less " +"efficient :func:`copyfileobj` function internally." msgstr "" msgid "copytree example" @@ -657,8 +680,8 @@ msgstr "" msgid "" "*format* is the archive format: one of \"zip\" (if the :mod:`zlib` module is " "available), \"tar\", \"gztar\" (if the :mod:`zlib` module is available), " -"\"bztar\" (if the :mod:`bz2` module is available), or \"xztar\" (if the :mod:" -"`lzma` module is available)." +"\"bztar\" (if the :mod:`bz2` module is available), or \"xztar\" (if " +"the :mod:`lzma` module is available)." msgstr "" msgid "" @@ -701,10 +724,10 @@ msgid "" msgstr "" msgid "" -"This function is not thread-safe when custom archivers registered with :func:" -"`register_archive_format` do not support the *root_dir* argument. In this " -"case it temporarily changes the current working directory of the process to " -"*root_dir* to perform archiving." +"This function is not thread-safe when custom archivers registered " +"with :func:`register_archive_format` do not support the *root_dir* " +"argument. In this case it temporarily changes the current working directory " +"of the process to *root_dir* to perform archiving." msgstr "" msgid "" @@ -750,7 +773,7 @@ msgid "Register an archiver for the format *name*." msgstr "" msgid "" -"*function* is the callable that will be used to unpack archives. The " +"*function* is the callable that will be used to create archives. The " "callable will receive the *base_name* of the file to create, followed by the " "*base_dir* (which defaults to :data:`os.curdir`) to start archiving from. " "Further arguments are passed as keyword arguments: *owner*, *group*, " @@ -791,10 +814,11 @@ msgstr "" msgid "" "*format* is the archive format: one of \"zip\", \"tar\", \"gztar\", " -"\"bztar\", or \"xztar\". Or any other format registered with :func:" -"`register_unpack_format`. If not provided, :func:`unpack_archive` will use " -"the archive file name extension and see if an unpacker was registered for " -"that extension. In case none is found, a :exc:`ValueError` is raised." +"\"bztar\", or \"xztar\". Or any other format registered " +"with :func:`register_unpack_format`. If not " +"provided, :func:`unpack_archive` will use the archive file name extension " +"and see if an unpacker was registered for that extension. In case none is " +"found, a :exc:`ValueError` is raised." msgstr "" msgid "" @@ -814,8 +838,8 @@ msgstr "" msgid "" "Never extract archives from untrusted sources without prior inspection. It " "is possible that files are created outside of the path specified in the " -"*extract_dir* argument, e.g. members that have absolute filenames starting " -"with \"/\" or filenames with two dots \"..\"." +"*extract_dir* argument, for example, members that have absolute filenames or " +"filenames with \"..\" components." msgstr "" msgid "Accepts a :term:`path-like object` for *filename* and *extract_dir*." @@ -826,8 +850,8 @@ msgstr "" msgid "" "Registers an unpack format. *name* is the name of the format and " -"*extensions* is a list of extensions corresponding to the format, like ``." -"zip`` for Zip files." +"*extensions* is a list of extensions corresponding to the format, like " +"``.zip`` for Zip files." msgstr "" msgid "" @@ -843,8 +867,8 @@ msgid "" msgstr "" msgid "" -"possibly a *filter* keyword argument, if it was given to :func:" -"`unpack_archive`;" +"possibly a *filter* keyword argument, if it was given " +"to :func:`unpack_archive`;" msgstr "" msgid "" @@ -930,8 +954,8 @@ msgid "" msgstr "" msgid "" -"In the final archive, :file:`please_add.txt` should be included, but :file:" -"`do_not_add.txt` should not. Therefore we use the following::" +"In the final archive, :file:`please_add.txt` should be included, " +"but :file:`do_not_add.txt` should not. Therefore we use the following::" msgstr "" msgid "" @@ -944,7 +968,7 @@ msgid "" "... root_dir='tmp/root',\n" "... base_dir='structure/content',\n" "... )\n" -"'/Users/tarek/my_archive.tar'" +"'/Users/tarek/myarchive.tar'" msgstr "" msgid "Listing the files in the resulting archive gives us:" @@ -973,8 +997,8 @@ msgstr "" msgid "" "When ``COLUMNS`` or ``LINES`` is not defined, which is the common case, the " -"terminal connected to :data:`sys.__stdout__` is queried by invoking :func:" -"`os.get_terminal_size`." +"terminal connected to :data:`sys.__stdout__` is queried by " +"invoking :func:`os.get_terminal_size`." msgstr "" msgid "" diff --git a/library/signal.po b/library/signal.po index d4bd741804..20a2694ef6 100644 --- a/library/signal.po +++ b/library/signal.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2022 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!signal` --- Set handlers for asynchronous events" msgstr "" msgid "**Source code:** :source:`Lib/signal.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/signal.py`" msgid "This module provides mechanisms to use signal handlers in Python." msgstr "" @@ -48,8 +47,8 @@ msgstr "" msgid "" "A handler for a particular signal, once set, remains installed until it is " "explicitly reset (Python emulates the BSD style interface regardless of the " -"underlying implementation), with the exception of the handler for :const:" -"`SIGCHLD`, which follows the underlying implementation." +"underlying implementation), with the exception of the handler " +"for :const:`SIGCHLD`, which follows the underlying implementation." msgstr "" msgid "" @@ -65,17 +64,17 @@ msgid "" "A Python signal handler does not get executed inside the low-level (C) " "signal handler. Instead, the low-level signal handler sets a flag which " "tells the :term:`virtual machine` to execute the corresponding Python signal " -"handler at a later point(for example at the next :term:`bytecode` " +"handler at a later point (for example, at the next :term:`bytecode` " "instruction). This has consequences:" msgstr "" msgid "" -"It makes little sense to catch synchronous errors like :const:`SIGFPE` or :" -"const:`SIGSEGV` that are caused by an invalid operation in C code. Python " -"will return from the signal handler to the C code, which is likely to raise " -"the same signal again, causing Python to apparently hang. From Python 3.3 " -"onwards, you can use the :mod:`faulthandler` module to report on synchronous " -"errors." +"It makes little sense to catch synchronous errors like :const:`SIGFPE` " +"or :const:`SIGSEGV` that are caused by an invalid operation in C code. " +"Python will return from the signal handler to the C code, which is likely to " +"raise the same signal again, causing Python to apparently hang. From Python " +"3.3 onwards, you can use the :mod:`faulthandler` module to report on " +"synchronous errors." msgstr "" msgid "" @@ -107,17 +106,22 @@ msgid "" "new signal handler." msgstr "" +msgid "" +"Synchronization primitives such as :class:`threading.Lock` should not be " +"used within signal handlers. Doing so can lead to unexpected deadlocks." +msgstr "" + msgid "Module contents" msgstr "" msgid "" -"signal (SIG*), handler (:const:`SIG_DFL`, :const:`SIG_IGN`) and sigmask (:" -"const:`SIG_BLOCK`, :const:`SIG_UNBLOCK`, :const:`SIG_SETMASK`) related " -"constants listed below were turned into :class:`enums ` (:" -"class:`Signals`, :class:`Handlers` and :class:`Sigmasks` respectively). :" -"func:`getsignal`, :func:`pthread_sigmask`, :func:`sigpending` and :func:" -"`sigwait` functions return human-readable :class:`enums ` as :" -"class:`Signals` objects." +"signal (SIG*), handler (:const:`SIG_DFL`, :const:`SIG_IGN`) and sigmask " +"(:const:`SIG_BLOCK`, :const:`SIG_UNBLOCK`, :const:`SIG_SETMASK`) related " +"constants listed below were turned into :class:`enums ` " +"(:class:`Signals`, :class:`Handlers` and :class:`Sigmasks` " +"respectively). :func:`getsignal`, :func:`pthread_sigmask`, :func:`sigpending` " +"and :func:`sigwait` functions return human-readable :class:`enums " +"` as :class:`Signals` objects." msgstr "" msgid "The signal module defines three enums:" @@ -128,13 +132,13 @@ msgid "" msgstr "" msgid "" -":class:`enum.IntEnum` collection the constants :const:`SIG_DFL` and :const:" -"`SIG_IGN`." +":class:`enum.IntEnum` collection of the constants :const:`SIG_DFL` " +"and :const:`SIG_IGN`." msgstr "" msgid "" -":class:`enum.IntEnum` collection the constants :const:`SIG_BLOCK`, :const:" -"`SIG_UNBLOCK` and :const:`SIG_SETMASK`." +":class:`enum.IntEnum` collection of the " +"constants :const:`SIG_BLOCK`, :const:`SIG_UNBLOCK` and :const:`SIG_SETMASK`." msgstr "" msgid "Availability" @@ -214,17 +218,26 @@ msgstr "" msgid "Default action is to ignore the signal." msgstr "" +msgid "Profiling timer expired." +msgstr "" + +msgid "Terminal quit signal." +msgstr "" + msgid "Segmentation fault: invalid memory reference." msgstr "" +msgid "Stop executing (cannot be caught or ignored)." +msgstr "" + msgid "" "Stack fault on coprocessor. The Linux kernel does not raise this signal: it " "can only be raised in user space." msgstr "" msgid "" -"On architectures where the signal is available. See the man page :manpage:" -"`signal(7)` for further information." +"On architectures where the signal is available. See the man " +"page :manpage:`signal(7)` for further information." msgstr "" msgid "Termination signal." @@ -236,17 +249,24 @@ msgstr "" msgid "User-defined signal 2." msgstr "" +msgid "Virtual timer expired." +msgstr "" + msgid "Window resize signal." msgstr "" +msgid "CPU time limit exceeded." +msgstr "" + msgid "" "All the signal numbers are defined symbolically. For example, the hangup " "signal is defined as :const:`signal.SIGHUP`; the variable names are " "identical to the names used in C programs, as found in ````. The " -"Unix man page for ':c:func:`signal`' lists the existing signals (on some " -"systems this is :manpage:`signal(2)`, on others the list is in :manpage:" -"`signal(7)`). Note that not all systems define the same set of signal names; " -"only those names defined by the system are defined by this module." +"Unix man page for '``signal``' lists the existing signals (on some systems " +"this is :manpage:`signal(2)`, on others the list is " +"in :manpage:`signal(7)`). Note that not all systems define the same set of " +"signal names; only those names defined by the system are defined by this " +"module." msgstr "" msgid "" @@ -260,8 +280,8 @@ msgid "" msgstr "" msgid "" -"One more than the number of the highest signal number. Use :func:" -"`valid_signals` to get valid signal numbers." +"One more than the number of the highest signal number. " +"Use :func:`valid_signals` to get valid signal numbers." msgstr "" msgid "" @@ -300,15 +320,15 @@ msgid "The :mod:`signal` module defines one exception:" msgstr "" msgid "" -"Raised to signal an error from the underlying :func:`setitimer` or :func:" -"`getitimer` implementation. Expect this error if an invalid interval timer " -"or a negative time is passed to :func:`setitimer`. This error is a subtype " -"of :exc:`OSError`." +"Raised to signal an error from the underlying :func:`setitimer` " +"or :func:`getitimer` implementation. Expect this error if an invalid " +"interval timer or a negative time is passed to :func:`setitimer`. This error " +"is a subtype of :exc:`OSError`." msgstr "" msgid "" -"This error used to be a subtype of :exc:`IOError`, which is now an alias of :" -"exc:`OSError`." +"This error used to be a subtype of :exc:`IOError`, which is now an alias " +"of :exc:`OSError`." msgstr "" msgid "The :mod:`signal` module defines the following functions:" @@ -329,18 +349,18 @@ msgstr "" msgid "" "Return the current signal handler for the signal *signalnum*. The returned " -"value may be a callable Python object, or one of the special values :const:" -"`signal.SIG_IGN`, :const:`signal.SIG_DFL` or :const:`None`. Here, :const:" -"`signal.SIG_IGN` means that the signal was previously ignored, :const:" -"`signal.SIG_DFL` means that the default way of handling the signal was " -"previously in use, and ``None`` means that the previous signal handler was " -"not installed from Python." +"value may be a callable Python object, or one of the special " +"values :const:`signal.SIG_IGN`, :const:`signal.SIG_DFL` or :const:`None`. " +"Here, :const:`signal.SIG_IGN` means that the signal was previously " +"ignored, :const:`signal.SIG_DFL` means that the default way of handling the " +"signal was previously in use, and ``None`` means that the previous signal " +"handler was not installed from Python." msgstr "" msgid "" -"Returns the description of signal *signalnum*, such as \"Interrupt\" for :" -"const:`SIGINT`. Returns :const:`None` if *signalnum* has no description. " -"Raises :exc:`ValueError` if *signalnum* is invalid." +"Returns the description of signal *signalnum*, such as \"Interrupt\" " +"for :const:`SIGINT`. Returns :const:`None` if *signalnum* has no " +"description. Raises :exc:`ValueError` if *signalnum* is invalid." msgstr "" msgid "" @@ -358,8 +378,8 @@ msgid "See the man page :manpage:`signal(2)` for further information." msgstr "" msgid "" -"See also :func:`sigwait`, :func:`sigwaitinfo`, :func:`sigtimedwait` and :" -"func:`sigpending`." +"See also :func:`sigwait`, :func:`sigwaitinfo`, :func:`sigtimedwait` " +"and :func:`sigpending`." msgstr "" msgid "Sends a signal to the calling process. Returns nothing." @@ -434,9 +454,9 @@ msgid "" msgstr "" msgid "" -"*mask* is a set of signal numbers (e.g. {:const:`signal.SIGINT`, :const:" -"`signal.SIGTERM`}). Use :func:`~signal.valid_signals` for a full mask " -"including all signals." +"*mask* is a set of signal numbers (e.g. " +"{:const:`signal.SIGINT`, :const:`signal.SIGTERM`}). " +"Use :func:`~signal.valid_signals` for a full mask including all signals." msgstr "" msgid "" @@ -451,27 +471,28 @@ msgid "See also :func:`pause`, :func:`sigpending` and :func:`sigwait`." msgstr "" msgid "" -"Sets given interval timer (one of :const:`signal.ITIMER_REAL`, :const:" -"`signal.ITIMER_VIRTUAL` or :const:`signal.ITIMER_PROF`) specified by *which* " -"to fire after *seconds* (float is accepted, different from :func:`alarm`) " -"and after that every *interval* seconds (if *interval* is non-zero). The " -"interval timer specified by *which* can be cleared by setting *seconds* to " -"zero." +"Sets given interval timer (one " +"of :const:`signal.ITIMER_REAL`, :const:`signal.ITIMER_VIRTUAL` " +"or :const:`signal.ITIMER_PROF`) specified by *which* to fire after *seconds* " +"(float is accepted, different from :func:`alarm`) and after that every " +"*interval* seconds (if *interval* is non-zero). The interval timer specified " +"by *which* can be cleared by setting *seconds* to zero." msgstr "" msgid "" "When an interval timer fires, a signal is sent to the process. The signal " "sent is dependent on the timer being used; :const:`signal.ITIMER_REAL` will " -"deliver :const:`SIGALRM`, :const:`signal.ITIMER_VIRTUAL` sends :const:" -"`SIGVTALRM`, and :const:`signal.ITIMER_PROF` will deliver :const:`SIGPROF`." +"deliver :const:`SIGALRM`, :const:`signal.ITIMER_VIRTUAL` " +"sends :const:`SIGVTALRM`, and :const:`signal.ITIMER_PROF` will " +"deliver :const:`SIGPROF`." msgstr "" msgid "The old values are returned as a tuple: (delay, interval)." msgstr "" msgid "" -"Attempting to pass an invalid interval timer will cause an :exc:" -"`ItimerError`." +"Attempting to pass an invalid interval timer will cause " +"an :exc:`ItimerError`." msgstr "" msgid "Returns current value of a given interval timer specified by *which*." @@ -550,9 +571,9 @@ msgid "" "Set the handler for signal *signalnum* to the function *handler*. *handler* " "can be a callable Python object taking two arguments (see below), or one of " "the special values :const:`signal.SIG_IGN` or :const:`signal.SIG_DFL`. The " -"previous signal handler will be returned (see the description of :func:" -"`getsignal` above). (See the Unix man page :manpage:`signal(2)` for further " -"information.)" +"previous signal handler will be returned (see the description " +"of :func:`getsignal` above). (See the Unix man page :manpage:`signal(2)` " +"for further information.)" msgstr "" msgid "" @@ -563,10 +584,10 @@ msgid "" msgstr "" msgid "" -"On Windows, :func:`signal` can only be called with :const:`SIGABRT`, :const:" -"`SIGFPE`, :const:`SIGILL`, :const:`SIGINT`, :const:`SIGSEGV`, :const:" -"`SIGTERM`, or :const:`SIGBREAK`. A :exc:`ValueError` will be raised in any " -"other case. Note that not all systems define the same set of signal names; " +"On Windows, :func:`signal` can only be called " +"with :const:`SIGABRT`, :const:`SIGFPE`, :const:`SIGILL`, :const:`SIGINT`, :const:`SIGSEGV`, :const:`SIGTERM`, " +"or :const:`SIGBREAK`. A :exc:`ValueError` will be raised in any other case. " +"Note that not all systems define the same set of signal names; " "an :exc:`AttributeError` will be raised if a signal name is not defined as " "``SIG*`` module level constant." msgstr "" @@ -594,8 +615,9 @@ msgid "See the man page :manpage:`sigwait(3)` for further information." msgstr "" msgid "" -"See also :func:`pause`, :func:`pthread_sigmask`, :func:`sigpending`, :func:" -"`sigwaitinfo` and :func:`sigtimedwait`." +"See " +"also :func:`pause`, :func:`pthread_sigmask`, :func:`sigpending`, :func:`sigwaitinfo` " +"and :func:`sigtimedwait`." msgstr "" msgid "" @@ -604,15 +626,15 @@ msgid "" "signal and removes it from the pending list of signals. If one of the " "signals in *sigset* is already pending for the calling thread, the function " "will return immediately with information about that signal. The signal " -"handler is not called for the delivered signal. The function raises an :exc:" -"`InterruptedError` if it is interrupted by a signal that is not in *sigset*." +"handler is not called for the delivered signal. The function raises " +"an :exc:`InterruptedError` if it is interrupted by a signal that is not in " +"*sigset*." msgstr "" msgid "" -"The return value is an object representing the data contained in the :c:type:" -"`siginfo_t` structure, namely: :attr:`si_signo`, :attr:`si_code`, :attr:" -"`si_errno`, :attr:`si_pid`, :attr:`si_uid`, :attr:`si_status`, :attr:" -"`si_band`." +"The return value is an object representing the data contained in the " +"``siginfo_t`` structure, namely: ``si_signo``, ``si_code``, ``si_errno``, " +"``si_pid``, ``si_uid``, ``si_status``, ``si_band``." msgstr "" msgid "See the man page :manpage:`sigwaitinfo(2)` for further information." @@ -679,11 +701,11 @@ msgid "Note on SIGPIPE" msgstr "" msgid "" -"Piping output of your program to tools like :manpage:`head(1)` will cause a :" -"const:`SIGPIPE` signal to be sent to your process when the receiver of its " -"standard output closes early. This results in an exception like :code:" -"`BrokenPipeError: [Errno 32] Broken pipe`. To handle this case, wrap your " -"entry point to catch this exception as follows::" +"Piping output of your program to tools like :manpage:`head(1)` will cause " +"a :const:`SIGPIPE` signal to be sent to your process when the receiver of " +"its standard output closes early. This results in an exception " +"like :code:`BrokenPipeError: [Errno 32] Broken pipe`. To handle this case, " +"wrap your entry point to catch this exception as follows::" msgstr "" msgid "" @@ -751,9 +773,9 @@ msgid "" msgstr "" msgid "" -"For many programs, especially those that merely want to exit on :exc:" -"`KeyboardInterrupt`, this is not a problem, but applications that are " -"complex or require high reliability should avoid raising exceptions from " +"For many programs, especially those that merely want to exit " +"on :exc:`KeyboardInterrupt`, this is not a problem, but applications that " +"are complex or require high reliability should avoid raising exceptions from " "signal handlers. They should also avoid catching :exc:`KeyboardInterrupt` as " "a means of gracefully shutting down. Instead, they should install their " "own :const:`SIGINT` handler. Below is an example of an HTTP server that " diff --git a/library/site.po b/library/site.po index de9a6546e9..de142ca1b8 100644 --- a/library/site.po +++ b/library/site.po @@ -1,22 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,7 +28,7 @@ msgid ":mod:`!site` --- Site-specific configuration hook" msgstr "" msgid "**Source code:** :source:`Lib/site.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/site.py`" msgid "" "**This module is automatically imported during initialization.** The " @@ -49,8 +47,8 @@ msgid "" msgstr "" msgid "" -"Importing the module used to trigger paths manipulation even when using :" -"option:`-S`." +"Importing the module used to trigger paths manipulation even when " +"using :option:`-S`." msgstr "" msgid "" @@ -79,22 +77,22 @@ msgid "" "If a file named \"pyvenv.cfg\" exists one directory above sys.executable, " "sys.prefix and sys.exec_prefix are set to that directory and it is also " "checked for site-packages (sys.base_prefix and sys.base_exec_prefix will " -"always be the \"real\" prefixes of the Python installation). If \"pyvenv." -"cfg\" (a bootstrap configuration file) contains the key \"include-system-" -"site-packages\" set to anything other than \"true\" (case-insensitive), the " -"system-level prefixes will not be searched for site-packages; otherwise they " -"will." +"always be the \"real\" prefixes of the Python installation). If " +"\"pyvenv.cfg\" (a bootstrap configuration file) contains the key \"include-" +"system-site-packages\" set to anything other than \"true\" (case-" +"insensitive), the system-level prefixes will not be searched for site-" +"packages; otherwise they will." msgstr "" msgid "" -"A path configuration file is a file whose name has the form :file:`{name}." -"pth` and exists in one of the four directories mentioned above; its contents " -"are additional items (one per line) to be added to ``sys.path``. Non-" -"existing items are never added to ``sys.path``, and no check is made that " -"the item refers to a directory rather than a file. No item is added to " -"``sys.path`` more than once. Blank lines and lines beginning with ``#`` are " -"skipped. Lines starting with ``import`` (followed by space or tab) are " -"executed." +"A path configuration file is a file whose name has the " +"form :file:`{name}.pth` and exists in one of the four directories mentioned " +"above; its contents are additional items (one per line) to be added to " +"``sys.path``. Non-existing items are never added to ``sys.path``, and no " +"check is made that the item refers to a directory rather than a file. No " +"item is added to ``sys.path`` more than once. Blank lines and lines " +"beginning with ``#`` are skipped. Lines starting with ``import`` (followed " +"by space or tab) are executed." msgstr "" msgid "" @@ -109,17 +107,18 @@ msgid "" msgstr "" msgid "" -"The :file:`.pth` files are now decoded by UTF-8 at first and then by the :" -"term:`locale encoding` if it fails." +"The :file:`.pth` files are now decoded by UTF-8 at first and then by " +"the :term:`locale encoding` if it fails." msgstr "" msgid "" -"For example, suppose ``sys.prefix`` and ``sys.exec_prefix`` are set to :file:" -"`/usr/local`. The Python X.Y library is then installed in :file:`/usr/local/" -"lib/python{X.Y}`. Suppose this has a subdirectory :file:`/usr/local/lib/" -"python{X.Y}/site-packages` with three subsubdirectories, :file:`foo`, :file:" -"`bar` and :file:`spam`, and two path configuration files, :file:`foo.pth` " -"and :file:`bar.pth`. Assume :file:`foo.pth` contains the following::" +"For example, suppose ``sys.prefix`` and ``sys.exec_prefix`` are set " +"to :file:`/usr/local`. The Python X.Y library is then installed in :file:`/" +"usr/local/lib/python{X.Y}`. Suppose this has a subdirectory :file:`/usr/" +"local/lib/python{X.Y}/site-packages` with three " +"subsubdirectories, :file:`foo`, :file:`bar` and :file:`spam`, and two path " +"configuration files, :file:`foo.pth` and :file:`bar.pth`. " +"Assume :file:`foo.pth` contains the following::" msgstr "" msgid "" @@ -150,46 +149,47 @@ msgid "" msgstr "" msgid "" -"Note that :file:`bletch` is omitted because it doesn't exist; the :file:" -"`bar` directory precedes the :file:`foo` directory because :file:`bar.pth` " -"comes alphabetically before :file:`foo.pth`; and :file:`spam` is omitted " -"because it is not mentioned in either path configuration file." +"Note that :file:`bletch` is omitted because it doesn't exist; " +"the :file:`bar` directory precedes the :file:`foo` directory " +"because :file:`bar.pth` comes alphabetically before :file:`foo.pth`; " +"and :file:`spam` is omitted because it is not mentioned in either path " +"configuration file." msgstr "" msgid ":mod:`sitecustomize`" msgstr ":mod:`sitecustomize`" msgid "" -"After these path manipulations, an attempt is made to import a module named :" -"mod:`sitecustomize`, which can perform arbitrary site-specific " +"After these path manipulations, an attempt is made to import a module " +"named :mod:`sitecustomize`, which can perform arbitrary site-specific " "customizations. It is typically created by a system administrator in the " "site-packages directory. If this import fails with an :exc:`ImportError` or " "its subclass exception, and the exception's :attr:`~ImportError.name` " -"attribute equals 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." +"attribute equals ``'sitecustomize'``, it is silently ignored. If Python is " +"started without output streams available, as with :file:`pythonw.exe` on " +"Windows (which is used by default to start IDLE), attempted output " +"from :mod:`sitecustomize` is ignored. Any other exception causes a silent " +"and perhaps mysterious failure of the process." 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:`~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." +"After this, an attempt is made to import a module " +"named :mod:`usercustomize`, which can perform arbitrary user-specific " +"customizations, if :data:`~site.ENABLE_USER_SITE` is true. This file is " +"intended to be created in the user site-packages directory (see below), " +"which is part of ``sys.path`` unless disabled by :option:`-s`. If this " +"import fails with an :exc:`ImportError` or its subclass exception, and the " +"exception's :attr:`~ImportError.name` attribute equals ``'usercustomize'``, " +"it is silently ignored." msgstr "" msgid "" "Note that for some non-Unix systems, ``sys.prefix`` and ``sys.exec_prefix`` " -"are empty, and the path manipulations are skipped; however the import of :" -"mod:`sitecustomize` and :mod:`usercustomize` is still attempted." +"are empty, and the path manipulations are skipped; however the import " +"of :mod:`sitecustomize` and :mod:`usercustomize` is still attempted." msgstr "" msgid "Readline configuration" @@ -197,13 +197,13 @@ msgstr "" msgid "" "On systems that support :mod:`readline`, this module will also import and " -"configure the :mod:`rlcompleter` module, if Python is started in :ref:" -"`interactive mode ` and without the :option:`-S` option. " -"The default behavior is enable tab-completion and to use :file:`~/." -"python_history` as the history save file. To disable it, delete (or " -"override) the :data:`sys.__interactivehook__` attribute in your :mod:" -"`sitecustomize` or :mod:`usercustomize` module or your :envvar:" -"`PYTHONSTARTUP` file." +"configure the :mod:`rlcompleter` module, if Python is started " +"in :ref:`interactive mode ` and without the :option:`-S` " +"option. The default behavior is to enable tab completion and to " +"use :file:`~/.python_history` as the history save file. To disable it, " +"delete (or override) the :data:`sys.__interactivehook__` attribute in " +"your :mod:`sitecustomize` or :mod:`usercustomize` module or " +"your :envvar:`PYTHONSTARTUP` file." msgstr "" msgid "Activation of rlcompleter and history was made automatic." @@ -218,30 +218,32 @@ msgstr "" msgid "" "Flag showing the status of the user site-packages directory. ``True`` means " "that it is enabled and was added to ``sys.path``. ``False`` means that it " -"was disabled by user request (with :option:`-s` or :envvar:" -"`PYTHONNOUSERSITE`). ``None`` means it was disabled for security reasons " -"(mismatch between user or group id and effective id) or by an administrator." +"was disabled by user request (with :option:`-s` " +"or :envvar:`PYTHONNOUSERSITE`). ``None`` means it was disabled for security " +"reasons (mismatch between user or group id and effective id) or by an " +"administrator." msgstr "" msgid "" -"Path to the user site-packages for the running Python. Can be ``None`` if :" -"func:`getusersitepackages` hasn't been called yet. Default value is :file:" -"`~/.local/lib/python{X.Y}[t]/site-packages` for UNIX and non-framework macOS " -"builds, :file:`~/Library/Python/{X.Y}/lib/python/site-packages` for macOS " -"framework builds, and :file:`{%APPDATA%}\\\\Python\\\\Python{XY}\\\\site-" -"packages` on Windows. The optional \"t\" indicates the free-threaded " -"build. This directory is a site directory, which means that :file:`.pth` " -"files in it will be processed." +"Path to the user site-packages for the running Python. Can be ``None`` " +"if :func:`getusersitepackages` hasn't been called yet. Default value " +"is :file:`~/.local/lib/python{X.Y}[t]/site-packages` for UNIX and non-" +"framework macOS builds, :file:`~/Library/Python/{X.Y}/lib/python/site-" +"packages` for macOS framework builds, and :file:`{%APPDATA%}\\\\Python\\" +"\\Python{XY}\\\\site-packages` on Windows. The optional \"t\" indicates the " +"free-threaded build. This directory is a site directory, which means " +"that :file:`.pth` files in it will be processed." msgstr "" msgid "" -"Path to the base directory for the user site-packages. Can be ``None`` if :" -"func:`getuserbase` hasn't been called yet. Default value is :file:`~/." -"local` for UNIX and macOS non-framework builds, :file:`~/Library/Python/{X.Y}" -"` for macOS framework builds, and :file:`{%APPDATA%}\\\\Python` for " -"Windows. This value is used to compute the installation directories for " -"scripts, data files, Python modules, etc. for the :ref:`user installation " -"scheme `. See also :envvar:`PYTHONUSERBASE`." +"Path to the base directory for the user site-packages. Can be ``None`` " +"if :func:`getuserbase` hasn't been called yet. Default value " +"is :file:`~/.local` for UNIX and macOS non-framework builds, :file:`~/" +"Library/Python/{X.Y}` for macOS framework builds, and :file:`{%APPDATA%}\\" +"\\Python` for Windows. This value is used to compute the installation " +"directories for scripts, data files, Python modules, etc. for the :ref:`user " +"installation scheme `. See " +"also :envvar:`PYTHONUSERBASE`." msgstr "" msgid "" @@ -261,21 +263,32 @@ msgstr "" msgid "Return a list containing all global site-packages directories." msgstr "" +msgid "" +"For each directory given in *prefixes* (or :data:`PREFIXES` if *prefixes* is " +"``None``), this function will compute its site-packages subdirectory " +"depending on the system environment, and will return a list of full paths, " +"which are not checked for existence." +msgstr "" + +msgid "Added the optional *prefixes* parameter." +msgstr "" + msgid "" "Return the path of the user base directory, :data:`USER_BASE`. If it is not " -"initialized yet, this function will also set it, respecting :envvar:" -"`PYTHONUSERBASE`." +"initialized yet, this function will also set it, " +"respecting :envvar:`PYTHONUSERBASE`." msgstr "" msgid "" -"Return the path of the user-specific site-packages directory, :data:" -"`USER_SITE`. If it is not initialized yet, this function will also set it, " -"respecting :data:`USER_BASE`. To determine if the user-specific site-" -"packages was added to ``sys.path`` :data:`ENABLE_USER_SITE` should be used." +"Return the path of the user-specific site-packages " +"directory, :data:`USER_SITE`. If it is not initialized yet, this function " +"will also set it, respecting :data:`USER_BASE`. To determine if the user-" +"specific site-packages was added to ``sys.path`` :data:`ENABLE_USER_SITE` " +"should be used." msgstr "" -msgid "Command Line Interface" -msgstr "Interfejs linii komend" +msgid "Command-line interface" +msgstr "Interfejs wiersza poleceń" msgid "" "The :mod:`site` module also provides a way to get the user directories from " @@ -290,10 +303,10 @@ msgstr "" "/home/user/.local/lib/python3.11/site-packages" msgid "" -"If it is called without arguments, it will print the contents of :data:`sys." -"path` on the standard output, followed by the value of :data:`USER_BASE` and " -"whether the directory exists, then the same thing for :data:`USER_SITE`, and " -"finally the value of :data:`ENABLE_USER_SITE`." +"If it is called without arguments, it will print the contents " +"of :data:`sys.path` on the standard output, followed by the value " +"of :data:`USER_BASE` and whether the directory exists, then the same thing " +"for :data:`USER_SITE`, and finally the value of :data:`ENABLE_USER_SITE`." msgstr "" msgid "Print the path to the user base directory." diff --git a/library/smtplib.po b/library/smtplib.po index 809ce2d7b5..94ec73b292 100644 --- a/library/smtplib.po +++ b/library/smtplib.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!smtplib` --- SMTP protocol client" msgstr "" msgid "**Source code:** :source:`Lib/smtplib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/smtplib.py`" msgid "" "The :mod:`smtplib` module defines an SMTP client session object that can be " @@ -51,28 +50,30 @@ msgid "" "*host* and *port* parameters are given, the SMTP :meth:`connect` method is " "called with those parameters during initialization. If specified, " "*local_hostname* is used as the FQDN of the local host in the HELO/EHLO " -"command. Otherwise, the local hostname is found using :func:`socket." -"getfqdn`. If the :meth:`connect` call returns anything other than a success " -"code, an :exc:`SMTPConnectError` is raised. The optional *timeout* parameter " -"specifies a timeout in seconds for blocking operations like the connection " -"attempt (if not specified, the global default timeout setting will be " -"used). If the timeout expires, :exc:`TimeoutError` is raised. The optional " -"*source_address* parameter allows binding to some specific source address in " -"a machine with multiple network interfaces, and/or to some specific source " -"TCP port. It takes a 2-tuple ``(host, port)``, for the socket to bind to as " -"its source address before connecting. If omitted (or if *host* or *port* are " -"``''`` and/or ``0`` respectively) the OS default behavior will be used." +"command. Otherwise, the local hostname is found " +"using :func:`socket.getfqdn`. If the :meth:`connect` call returns anything " +"other than a success code, an :exc:`SMTPConnectError` is raised. The " +"optional *timeout* parameter specifies a timeout in seconds for blocking " +"operations like the connection attempt (if not specified, the global default " +"timeout setting will be used). If the timeout expires, :exc:`TimeoutError` " +"is raised. The optional *source_address* parameter allows binding to some " +"specific source address in a machine with multiple network interfaces, and/" +"or to some specific source TCP port. It takes a 2-tuple ``(host, port)``, " +"for the socket to bind to as its source address before connecting. If " +"omitted (or if *host* or *port* are ``''`` and/or ``0`` respectively) the OS " +"default behavior will be used." msgstr "" msgid "" -"For normal use, you should only require the initialization/connect, :meth:" -"`sendmail`, and :meth:`SMTP.quit` methods. An example is included below." +"For normal use, you should only require the initialization/" +"connect, :meth:`sendmail`, and :meth:`SMTP.quit` methods. An example is " +"included below." msgstr "" msgid "" "The :class:`SMTP` class supports the :keyword:`with` statement. When used " -"like this, the SMTP ``QUIT`` command is issued automatically when the :" -"keyword:`!with` statement exits. E.g.::" +"like this, the SMTP ``QUIT`` command is issued automatically when " +"the :keyword:`!with` statement exits. E.g.::" msgstr "" msgid "" @@ -85,9 +86,9 @@ msgid "" msgstr "" msgid "" -"All commands will raise an :ref:`auditing event ` ``smtplib.SMTP." -"send`` with arguments ``self`` and ``data``, where ``data`` is the bytes " -"about to be sent to the remote host." +"All commands will raise an :ref:`auditing event ` " +"``smtplib.SMTP.send`` with arguments ``self`` and ``data``, where ``data`` " +"is the bytes about to be sent to the remote host." msgstr "" msgid "Support for the :keyword:`with` statement was added." @@ -100,21 +101,21 @@ msgid "The SMTPUTF8 extension (:rfc:`6531`) is now supported." msgstr "" msgid "" -"If the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to prevent the creation of a non-blocking socket." +"If the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to prevent the creation of a non-blocking socket." msgstr "" msgid "" -"An :class:`SMTP_SSL` instance behaves exactly the same as instances of :" -"class:`SMTP`. :class:`SMTP_SSL` should be used for situations where SSL is " -"required from the beginning of the connection and using :meth:`starttls` is " -"not appropriate. If *host* is not specified, the local host is used. If " -"*port* is zero, the standard SMTP-over-SSL port (465) is used. The optional " -"arguments *local_hostname*, *timeout* and *source_address* have the same " -"meaning as they do in the :class:`SMTP` class. *context*, also optional, " -"can contain a :class:`~ssl.SSLContext` and allows configuring various " -"aspects of the secure connection. Please read :ref:`ssl-security` for best " -"practices." +"An :class:`SMTP_SSL` instance behaves exactly the same as instances " +"of :class:`SMTP`. :class:`SMTP_SSL` should be used for situations where SSL " +"is required from the beginning of the connection and " +"using :meth:`~SMTP.starttls` is not appropriate. If *host* is not specified, " +"the local host is used. If *port* is zero, the standard SMTP-over-SSL port " +"(465) is used. The optional arguments *local_hostname*, *timeout* and " +"*source_address* have the same meaning as they do in the :class:`SMTP` " +"class. *context*, also optional, can contain a :class:`~ssl.SSLContext` and " +"allows configuring various aspects of the secure connection. Please " +"read :ref:`ssl-security` for best practices." msgstr "" msgid "*context* was added." @@ -124,13 +125,14 @@ msgid "The *source_address* argument was added." msgstr "" msgid "" -"The class now supports hostname check with :attr:`ssl.SSLContext." -"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)." +"The class now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indication* " +"(see :const:`ssl.HAS_SNI`)." msgstr "" msgid "" -"If the *timeout* parameter is set to be zero, it will raise a :class:" -"`ValueError` to prevent the creation of a non-blocking socket" +"If the *timeout* parameter is set to be zero, it will raise " +"a :class:`ValueError` to prevent the creation of a non-blocking socket" msgstr "" msgid "The deprecated *keyfile* and *certfile* parameters have been removed." @@ -138,11 +140,12 @@ msgstr "" msgid "" "The LMTP protocol, which is very similar to ESMTP, is heavily based on the " -"standard SMTP client. It's common to use Unix sockets for LMTP, so our :meth:" -"`connect` method must support that as well as a regular host:port server. " -"The optional arguments *local_hostname* and *source_address* have the same " -"meaning as they do in the :class:`SMTP` class. To specify a Unix socket, you " -"must use an absolute path for *host*, starting with a '/'." +"standard SMTP client. It's common to use Unix sockets for LMTP, so " +"our :meth:`~SMTP.connect` method must support that as well as a regular " +"host:port server. The optional arguments *local_hostname* and " +"*source_address* have the same meaning as they do in the :class:`SMTP` " +"class. To specify a Unix socket, you must use an absolute path for *host*, " +"starting with a '/'." msgstr "" msgid "" @@ -174,20 +177,27 @@ 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." +"error code." +msgstr "" + +msgid "The error code." +msgstr "" + +msgid "The error message." msgstr "" msgid "" -"Sender address refused. In addition to the attributes set by on all :exc:" -"`SMTPResponseException` exceptions, this sets 'sender' to the string that " -"the SMTP server refused." +"Sender address refused. In addition to the attributes set by on " +"all :exc:`SMTPResponseException` exceptions, this sets 'sender' to the " +"string that the SMTP server refused." +msgstr "" + +msgid "All recipient addresses refused." 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." +"A dictionary of exactly the same sort as returned by :meth:`SMTP.sendmail` " +"containing the errors for each recipient." msgstr "" msgid "The SMTP server refused to accept the message data." @@ -257,8 +267,8 @@ msgid "" msgstr "" msgid "" -"If the connection to the server is lost while waiting for the reply, :exc:" -"`SMTPServerDisconnected` will be raised." +"If the connection to the server is lost while waiting for the " +"reply, :exc:`SMTPServerDisconnected` will be raised." msgstr "" msgid "" @@ -295,9 +305,9 @@ msgid "" "response for ESMTP option and store them for use by :meth:`has_extn`. Also " "sets several informational attributes: the message returned by the server is " "stored as the :attr:`ehlo_resp` attribute, :attr:`does_esmtp` is set to " -"``True`` or ``False`` depending on whether the server supports ESMTP, and :" -"attr:`esmtp_features` will be a dictionary containing the names of the SMTP " -"service extensions this server supports, and their parameters (if any)." +"``True`` or ``False`` depending on whether the server supports ESMTP, " +"and :attr:`esmtp_features` will be a dictionary containing the names of the " +"SMTP service extensions this server supports, and their parameters (if any)." msgstr "" msgid "" @@ -416,10 +426,10 @@ msgstr "" msgid "" "The ``SMTP`` class provides ``authobjects`` for the ``CRAM-MD5``, ``PLAIN``, " -"and ``LOGIN`` mechanisms; they are named ``SMTP.auth_cram_md5``, ``SMTP." -"auth_plain``, and ``SMTP.auth_login`` respectively. They all require that " -"the ``user`` and ``password`` properties of the ``SMTP`` instance are set to " -"appropriate values." +"and ``LOGIN`` mechanisms; they are named ``SMTP.auth_cram_md5``, " +"``SMTP.auth_plain``, and ``SMTP.auth_login`` respectively. They all require " +"that the ``user`` and ``password`` properties of the ``SMTP`` instance are " +"set to appropriate values." msgstr "" msgid "" @@ -437,8 +447,8 @@ msgid "" msgstr "" msgid "" -"If *keyfile* and *certfile* are provided, they are used to create an :class:" -"`ssl.SSLContext`." +"If *keyfile* and *certfile* are provided, they are used to create " +"an :class:`ssl.SSLContext`." msgstr "" msgid "" @@ -462,25 +472,29 @@ 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`)." +"The method now supports hostname check " +"with :attr:`ssl.SSLContext.check_hostname` and *Server Name Indicator* " +"(see :const:`~ssl.HAS_SNI`)." msgstr "" msgid "" -"The error raised for lack of STARTTLS support is now the :exc:" -"`SMTPNotSupportedError` subclass instead of the base :exc:`SMTPException`." +"The error raised for lack of STARTTLS support is now " +"the :exc:`SMTPNotSupportedError` subclass instead of the " +"base :exc:`SMTPException`." msgstr "" msgid "" "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.)" +"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*. " +"Each option should be passed as a string containing the full text of the " +"option, including any potential key (for instance, " +"``\"NOTIFY=SUCCESS,FAILURE\"``). (If you need to use different ESMTP options " +"to different recipients you have to use the low-level methods such " +"as :meth:`!mail`, :meth:`!rcpt` and :meth:`!data` to send the message.)" msgstr "" msgid "" @@ -524,11 +538,7 @@ 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)." +msgid "All recipients were refused. Nobody got the mail." msgstr "" msgid ":exc:`SMTPSenderRefused`" @@ -575,27 +585,28 @@ msgid "" "those arguments with addresses extracted from the headers of *msg* as " "specified in :rfc:`5322`\\: *from_addr* is set to the :mailheader:`Sender` " "field if it is present, and otherwise to the :mailheader:`From` field. " -"*to_addrs* combines the values (if any) of the :mailheader:`To`, :mailheader:" -"`Cc`, and :mailheader:`Bcc` fields from *msg*. If exactly one set of :" -"mailheader:`Resent-*` headers appear in the message, the regular headers are " -"ignored and the :mailheader:`Resent-*` headers are used instead. If the " -"message contains more than one set of :mailheader:`Resent-*` headers, a :exc:" -"`ValueError` is raised, since there is no way to unambiguously detect the " -"most recent set of :mailheader:`Resent-` headers." -msgstr "" - -msgid "" -"``send_message`` serializes *msg* using :class:`~email.generator." -"BytesGenerator` with ``\\r\\n`` as the *linesep*, and calls :meth:`sendmail` " -"to transmit the resulting message. Regardless of the values of *from_addr* " -"and *to_addrs*, ``send_message`` does not transmit any :mailheader:`Bcc` or :" -"mailheader:`Resent-Bcc` headers that may appear in *msg*. If any of the " -"addresses in *from_addr* and *to_addrs* contain non-ASCII characters and the " -"server does not advertise ``SMTPUTF8`` support, an :exc:" -"`SMTPNotSupportedError` is raised. Otherwise the ``Message`` is serialized " -"with a clone of its :mod:`~email.policy` with the :attr:`~email.policy." -"EmailPolicy.utf8` attribute set to ``True``, and ``SMTPUTF8`` and " -"``BODY=8BITMIME`` are added to *mail_options*." +"*to_addrs* combines the values (if any) of " +"the :mailheader:`To`, :mailheader:`Cc`, and :mailheader:`Bcc` fields from " +"*msg*. If exactly one set of :mailheader:`Resent-*` headers appear in the " +"message, the regular headers are ignored and the :mailheader:`Resent-*` " +"headers are used instead. If the message contains more than one set " +"of :mailheader:`Resent-*` headers, a :exc:`ValueError` is raised, since " +"there is no way to unambiguously detect the most recent set " +"of :mailheader:`Resent-` headers." +msgstr "" + +msgid "" +"``send_message`` serializes *msg* " +"using :class:`~email.generator.BytesGenerator` with ``\\r\\n`` as the " +"*linesep*, and calls :meth:`sendmail` to transmit the resulting message. " +"Regardless of the values of *from_addr* and *to_addrs*, ``send_message`` " +"does not transmit any :mailheader:`Bcc` or :mailheader:`Resent-Bcc` headers " +"that may appear in *msg*. If any of the addresses in *from_addr* and " +"*to_addrs* contain non-ASCII characters and the server does not advertise " +"``SMTPUTF8`` support, an :exc:`SMTPNotSupportedError` is raised. Otherwise " +"the ``Message`` is serialized with a clone of its :mod:`~email.policy` with " +"the :attr:`~email.policy.EmailPolicy.utf8` attribute set to ``True``, and " +"``SMTPUTF8`` and ``BODY=8BITMIME`` are added to *mail_options*." msgstr "" msgid "Support for internationalized addresses (``SMTPUTF8``)." @@ -613,6 +624,25 @@ msgid "" "documented here. For details, consult the module code." msgstr "" +msgid "Additionally, an SMTP instance has the following attributes:" +msgstr "" + +msgid "The response to the ``HELO`` command, see :meth:`helo`." +msgstr "" + +msgid "The response to the ``EHLO`` command, see :meth:`ehlo`." +msgstr "" + +msgid "" +"A boolean value indicating whether the server supports ESMTP, " +"see :meth:`ehlo`." +msgstr "" + +msgid "" +"A dictionary of the names of SMTP service extensions supported by the " +"server, see :meth:`ehlo`." +msgstr "" + msgid "SMTP Example" msgstr "" @@ -656,8 +686,8 @@ msgstr "" msgid "" "In general, you will want to use the :mod:`email` package's features to " -"construct an email message, which you can then send via :meth:`~smtplib.SMTP." -"send_message`; see :ref:`email-examples`." +"construct an email message, which you can then send " +"via :meth:`~smtplib.SMTP.send_message`; see :ref:`email-examples`." msgstr "" msgid "SMTP" diff --git a/library/socket.po b/library/socket.po index c958581c76..2ddbdbc752 100644 --- a/library/socket.po +++ b/library/socket.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# haaritsubaki, 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,7 +27,7 @@ msgid ":mod:`!socket` --- Low-level networking interface" msgstr "" msgid "**Source code:** :source:`Lib/socket.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/socket.py`" msgid "" "This module provides access to the BSD *socket* interface. It is available " @@ -57,8 +53,8 @@ msgid "" "call and library interface for sockets to Python's object-oriented style: " "the :func:`~socket.socket` function returns a :dfn:`socket object` whose " "methods implement the various socket system calls. Parameter types are " -"somewhat higher-level than in the C interface: as with :meth:`read` and :" -"meth:`write` operations on Python files, buffer allocation on receive " +"somewhat higher-level than in the C interface: as with :meth:`read` " +"and :meth:`write` operations on Python files, buffer allocation on receive " "operations is automatic, and buffer length is implicit on send operations." msgstr "" @@ -116,10 +112,10 @@ msgstr "" msgid "" "For IPv4 addresses, two special forms are accepted instead of a host " "address: ``''`` represents :const:`INADDR_ANY`, which is used to bind to all " -"interfaces, and the string ``''`` represents :const:" -"`INADDR_BROADCAST`. This behavior is not compatible with IPv6, therefore, " -"you may want to avoid these if you intend to support IPv6 with your Python " -"programs." +"interfaces, and the string ``''`` " +"represents :const:`INADDR_BROADCAST`. This behavior is not compatible with " +"IPv6, therefore, you may want to avoid these if you intend to support IPv6 " +"with your Python programs." msgstr "" msgid "" @@ -182,16 +178,16 @@ msgid "" msgstr "" msgid "" -":const:`CAN_ISOTP` protocol require a tuple ``(interface, rx_addr, " +":const:`CAN_ISOTP` protocol requires a tuple ``(interface, rx_addr, " "tx_addr)`` where both additional parameters are unsigned long integer that " "represent a CAN identifier (standard or extended)." msgstr "" msgid "" -":const:`CAN_J1939` protocol require a tuple ``(interface, name, pgn, addr)`` " -"where additional parameters are 64-bit unsigned integer representing the ECU " -"name, a 32-bit unsigned integer representing the Parameter Group Number " -"(PGN), and an 8-bit integer representing the address." +":const:`CAN_J1939` protocol requires a tuple ``(interface, name, pgn, " +"addr)`` where additional parameters are 64-bit unsigned integer representing " +"the ECU name, a 32-bit unsigned integer representing the Parameter Group " +"Number (PGN), and an 8-bit integer representing the address." msgstr "" msgid "" @@ -399,8 +395,8 @@ msgstr "" msgid "" "Non-blocking mode is supported through :meth:`~socket.setblocking`. A " -"generalization of this based on timeouts is supported through :meth:`~socket." -"settimeout`." +"generalization of this based on timeouts is supported " +"through :meth:`~socket.settimeout`." msgstr "" msgid "Module contents" @@ -420,11 +416,12 @@ msgstr "" msgid "" "A subclass of :exc:`OSError`, this exception is raised for address-related " -"errors, i.e. for functions that use *h_errno* in the POSIX C API, including :" -"func:`gethostbyname_ex` and :func:`gethostbyaddr`. The accompanying value is " -"a pair ``(h_errno, string)`` representing an error returned by a library " -"call. *h_errno* is a numeric value, while *string* represents the " -"description of *h_errno*, as returned by the :c:func:`hstrerror` C function." +"errors, i.e. for functions that use *h_errno* in the POSIX C API, " +"including :func:`gethostbyname_ex` and :func:`gethostbyaddr`. The " +"accompanying value is a pair ``(h_errno, string)`` representing an error " +"returned by a library call. *h_errno* is a numeric value, while *string* " +"represents the description of *h_errno*, as returned by " +"the :c:func:`hstrerror` C function." msgstr "" msgid "This class was made a subclass of :exc:`OSError`." @@ -444,10 +441,10 @@ msgstr "" msgid "" "A subclass of :exc:`OSError`, this exception is raised when a timeout occurs " -"on a socket which has had timeouts enabled via a prior call to :meth:" -"`~socket.settimeout` (or implicitly through :func:`~socket." -"setdefaulttimeout`). The accompanying value is a string whose value is " -"currently always \"timed out\"." +"on a socket which has had timeouts enabled via a prior call " +"to :meth:`~socket.settimeout` (or implicitly " +"through :func:`~socket.setdefaulttimeout`). The accompanying value is a " +"string whose value is currently always \"timed out\"." msgstr "" msgid "This class was made an alias of :exc:`TimeoutError`." @@ -457,8 +454,8 @@ msgid "Constants" msgstr "Stały" msgid "" -"The AF_* and SOCK_* constants are now :class:`AddressFamily` and :class:" -"`SocketKind` :class:`.IntEnum` collections." +"The AF_* and SOCK_* constants are now :class:`AddressFamily` " +"and :class:`SocketKind` :class:`.IntEnum` collections." msgstr "" msgid "" @@ -475,8 +472,8 @@ msgid "" msgstr "" msgid "" -"These constants represent the socket types, used for the second argument to :" -"func:`~socket.socket`. More constants may be available depending on the " +"These constants represent the socket types, used for the second argument " +"to :func:`~socket.socket`. More constants may be available depending on the " "system. (Only :const:`SOCK_STREAM` and :const:`SOCK_DGRAM` appear to be " "generally useful.)" msgstr "" @@ -488,17 +485,17 @@ msgid "" msgstr "" msgid "" -"`Secure File Descriptor Handling `_ for a more thorough explanation." +"`Secure File Descriptor Handling `_ for a more thorough explanation." msgstr "" msgid "" "Many constants of these forms, documented in the Unix documentation on " "sockets and/or the IP protocol, are also defined in the socket module. They " -"are generally used in arguments to the :meth:`~socket.setsockopt` and :meth:" -"`~socket.getsockopt` methods of socket objects. In most cases, only those " -"symbols that are defined in the Unix header files are defined; for a few " -"symbols, default values are provided." +"are generally used in arguments to the :meth:`~socket.setsockopt` " +"and :meth:`~socket.getsockopt` methods of socket objects. In most cases, " +"only those symbols that are defined in the Unix header files are defined; " +"for a few symbols, default values are provided." msgstr "" msgid "" @@ -659,8 +656,8 @@ msgid "" msgstr "" msgid "" -"Constant to optimize CPU locality, to be used in conjunction with :data:" -"`SO_REUSEPORT`." +"Constant to optimize CPU locality, to be used in conjunction " +"with :data:`SO_REUSEPORT`." msgstr "" msgid "Constants for Windows Hyper-V sockets for host/guest communications." @@ -687,76 +684,16 @@ msgid "" msgstr "" msgid "" -"Create a new socket using the given address family, socket type and protocol " -"number. The address family should be :const:`AF_INET` (the default), :const:" -"`AF_INET6`, :const:`AF_UNIX`, :const:`AF_CAN`, :const:`AF_PACKET`, or :const:" -"`AF_RDS`. The socket type should be :const:`SOCK_STREAM` (the default), :" -"const:`SOCK_DGRAM`, :const:`SOCK_RAW` or perhaps one of the other ``SOCK_`` " -"constants. The protocol number is usually zero and may be omitted or in the " -"case where the address family is :const:`AF_CAN` the protocol should be one " -"of :const:`CAN_RAW`, :const:`CAN_BCM`, :const:`CAN_ISOTP` or :const:" -"`CAN_J1939`." -msgstr "" - -msgid "" -"If *fileno* is specified, the values for *family*, *type*, and *proto* are " -"auto-detected from the specified file descriptor. Auto-detection can be " -"overruled by calling the function with explicit *family*, *type*, or *proto* " -"arguments. This only affects how Python represents e.g. the return value " -"of :meth:`socket.getpeername` but not the actual OS resource. Unlike :func:" -"`socket.fromfd`, *fileno* will return the same socket and not a duplicate. " -"This may help close a detached socket using :meth:`socket.close`." -msgstr "" - -msgid "The newly created socket is :ref:`non-inheritable `." -msgstr "" - -msgid "" -"Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " -"``self``, ``family``, ``type``, ``protocol``." -msgstr "" - -msgid "The AF_CAN family was added. The AF_RDS family was added." -msgstr "" - -msgid "The CAN_BCM protocol was added." -msgstr "" - -msgid "The returned socket is now non-inheritable." -msgstr "" - -msgid "The CAN_ISOTP protocol was added." -msgstr "" - -msgid "" -"When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied " -"to *type* they are cleared, and :attr:`socket.type` will not reflect them. " -"They are still passed to the underlying system ``socket()`` call. Therefore," -msgstr "" - -msgid "" -"sock = socket.socket(\n" -" socket.AF_INET,\n" -" socket.SOCK_STREAM | socket.SOCK_NONBLOCK)" -msgstr "" - -msgid "" -"will still create a non-blocking socket on OSes that support " -"``SOCK_NONBLOCK``, but ``sock.type`` will be set to ``socket.SOCK_STREAM``." -msgstr "" - -msgid "The CAN_J1939 protocol was added." -msgstr "" - -msgid "The IPPROTO_MPTCP protocol was added." +"The :class:`socket ` class constructor creates a new socket " +"directly; see :ref:`socket-objects` for its parameters and full description." msgstr "" msgid "" "Build a pair of connected socket objects using the given address family, " "socket type, and protocol number. Address family, socket type, and protocol " -"number are as for the :func:`~socket.socket` function 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. 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 `." @@ -816,8 +753,8 @@ msgstr "" msgid "" "*family* should be either :data:`AF_INET` or :data:`AF_INET6`. *backlog* is " "the queue size passed to :meth:`socket.listen`; if not specified , a default " -"reasonable value is chosen. *reuse_port* dictates whether to set the :data:" -"`SO_REUSEPORT` socket option." +"reasonable value is chosen. *reuse_port* dictates whether to set " +"the :data:`SO_REUSEPORT` socket option." msgstr "" msgid "" @@ -857,8 +794,8 @@ msgstr "" msgid "" "Duplicate the file descriptor *fd* (an integer as returned by a file " "object's :meth:`~io.IOBase.fileno` method) and build a socket object from " -"the result. Address family, socket type and protocol number are as for the :" -"func:`~socket.socket` function above. The file descriptor should refer to a " +"the result. Address family, socket type and protocol number are as for " +"the :func:`~socket.socket` function. The file descriptor should refer to a " "socket, but this is not checked --- subsequent operations on the object may " "fail if the file descriptor is invalid. This function is rarely needed, but " "can be used to get or set socket options on a socket passed to a program as " @@ -866,14 +803,15 @@ msgid "" "daemon). The socket is assumed to be in blocking mode." msgstr "" -msgid "" -"Instantiate a socket from data obtained from the :meth:`socket.share` " -"method. The socket is assumed to be in blocking mode." +msgid "The newly created socket is :ref:`non-inheritable `." +msgstr "" + +msgid "The returned socket is now non-inheritable." msgstr "" msgid "" -"This is a Python type object that represents the socket object type. It is " -"the same as ``type(socket(...))``." +"Instantiate a socket from data obtained from the :meth:`socket.share` " +"method. The socket is assumed to be in blocking mode." msgstr "" msgid "Other functions" @@ -884,8 +822,8 @@ msgstr "" msgid "" "Close a socket file descriptor. This is like :func:`os.close`, but for " -"sockets. On some platforms (most noticeable Windows) :func:`os.close` does " -"not work for socket file descriptors." +"sockets. On some platforms (most notably Windows) :func:`os.close` does not " +"work for socket file descriptors." msgstr "" msgid "" @@ -910,9 +848,9 @@ msgstr "" msgid "" "The *flags* argument can be one or several of the ``AI_*`` constants, and " -"will influence how results are computed and returned. For example, :const:" -"`AI_NUMERICHOST` will disable domain name resolution and will raise an error " -"if *host* is a domain name." +"will influence how results are computed and returned. For " +"example, :const:`AI_NUMERICHOST` will disable domain name resolution and " +"will raise an error if *host* is a domain name." msgstr "" msgid "The function returns a list of 5-tuples with the following structure:" @@ -924,12 +862,13 @@ msgstr "" msgid "" "In these tuples, *family*, *type*, *proto* are all integers and are meant to " "be passed to the :func:`~socket.socket` function. *canonname* will be a " -"string representing the canonical name of the *host* if :const:" -"`AI_CANONNAME` is part of the *flags* argument; else *canonname* will be " -"empty. *sockaddr* is a tuple describing a socket address, whose format " -"depends on the returned *family* (a ``(address, port)`` 2-tuple for :const:" -"`AF_INET`, a ``(address, port, flowinfo, scope_id)`` 4-tuple for :const:" -"`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." +"string representing the canonical name of the *host* " +"if :const:`AI_CANONNAME` is part of the *flags* argument; else *canonname* " +"will be empty. *sockaddr* is a tuple describing a socket address, whose " +"format depends on the returned *family* (a ``(address, port)`` 2-tuple " +"for :const:`AF_INET`, a ``(address, port, flowinfo, scope_id)`` 4-tuple " +"for :const:`AF_INET6`), and is meant to be passed to " +"the :meth:`socket.connect` method." msgstr "" msgid "" @@ -1043,8 +982,8 @@ msgid "" "(possibly empty) list of alternative host names for the same address, and " "*ipaddrlist* is a list of IPv4/v6 addresses for the same interface on the " "same host (most likely containing only a single address). To find the fully " -"qualified domain name, use the function :func:`getfqdn`. :func:" -"`gethostbyaddr` supports both IPv4 and IPv6." +"qualified domain name, use the " +"function :func:`getfqdn`. :func:`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" msgid "" @@ -1075,10 +1014,11 @@ msgstr "" msgid "" "Translate an internet protocol name (for example, ``'icmp'``) to a constant " -"suitable for passing as the (optional) third argument to the :func:`~socket." -"socket` function. This is usually only needed for sockets opened in \"raw\" " -"mode (:const:`SOCK_RAW`); for the normal socket modes, the correct protocol " -"is chosen automatically if the protocol is omitted or zero." +"suitable for passing as the (optional) third argument to " +"the :func:`~socket.socket` function. This is usually only needed for " +"sockets opened in \"raw\" mode (:const:`SOCK_RAW`); for the normal socket " +"modes, the correct protocol is chosen automatically if the protocol is " +"omitted or zero." msgstr "" msgid "" @@ -1145,9 +1085,9 @@ msgid "" msgstr "" msgid "" -"If the IPv4 address string passed to this function is invalid, :exc:" -"`OSError` will be raised. Note that exactly what is valid depends on the " -"underlying C implementation of :c:func:`inet_aton`." +"If the IPv4 address string passed to this function is " +"invalid, :exc:`OSError` will be raised. Note that exactly what is valid " +"depends on the underlying C implementation of :c:func:`inet_aton`." msgstr "" msgid "" @@ -1174,16 +1114,16 @@ msgstr "" msgid "" "Convert an IP address from its family-specific string format to a packed, " "binary format. :func:`inet_pton` is useful when a library or network " -"protocol calls for an object of type :c:struct:`in_addr` (similar to :func:" -"`inet_aton`) or :c:struct:`in6_addr`." +"protocol calls for an object of type :c:struct:`in_addr` (similar " +"to :func:`inet_aton`) or :c:struct:`in6_addr`." msgstr "" msgid "" -"Supported values for *address_family* are currently :const:`AF_INET` and :" -"const:`AF_INET6`. If the IP address string *ip_string* is invalid, :exc:" -"`OSError` will be raised. Note that exactly what is valid depends on both " -"the value of *address_family* and the underlying implementation of :c:func:" -"`inet_pton`." +"Supported values for *address_family* are currently :const:`AF_INET` " +"and :const:`AF_INET6`. If the IP address string *ip_string* is " +"invalid, :exc:`OSError` will be raised. Note that exactly what is valid " +"depends on both the value of *address_family* and the underlying " +"implementation of :c:func:`inet_pton`." msgstr "" msgid "Windows support added" @@ -1198,20 +1138,21 @@ msgid "" msgstr "" msgid "" -"Supported values for *address_family* are currently :const:`AF_INET` and :" -"const:`AF_INET6`. If the bytes object *packed_ip* is not the correct length " -"for the specified address family, :exc:`ValueError` will be raised. :exc:" -"`OSError` is raised for errors from the call to :func:`inet_ntop`." +"Supported values for *address_family* are currently :const:`AF_INET` " +"and :const:`AF_INET6`. If the bytes object *packed_ip* is not the correct " +"length for the specified address family, :exc:`ValueError` will be " +"raised. :exc:`OSError` is raised for errors from the call " +"to :func:`inet_ntop`." msgstr "" msgid "" "Return the total length, without trailing padding, of an ancillary data item " "with associated data of the given *length*. This value can often be used as " "the buffer size for :meth:`~socket.recvmsg` to receive a single item of " -"ancillary data, but :rfc:`3542` requires portable applications to use :func:" -"`CMSG_SPACE` and thus include space for padding, even when the item will be " -"the last in the buffer. Raises :exc:`OverflowError` if *length* is outside " -"the permissible range of values." +"ancillary data, but :rfc:`3542` requires portable applications to " +"use :func:`CMSG_SPACE` and thus include space for padding, even when the " +"item will be the last in the buffer. Raises :exc:`OverflowError` if " +"*length* is outside the permissible range of values." msgstr "" msgid "Most Unix platforms." @@ -1244,8 +1185,9 @@ msgstr "" msgid "" "Set the default timeout in seconds (float) for new socket objects. When the " -"socket module is first imported, the default is ``None``. See :meth:" -"`~socket.settimeout` for possible values and their respective meanings." +"socket module is first imported, the default is ``None``. " +"See :meth:`~socket.settimeout` for possible values and their respective " +"meanings." msgstr "" msgid "" @@ -1289,22 +1231,22 @@ msgid "" msgstr "" msgid "" -"Return a network interface index number corresponding to an interface name. :" -"exc:`OSError` if no interface with the given name exists." +"Return a network interface index number corresponding to an interface " +"name. :exc:`OSError` if no interface with the given name exists." msgstr "" msgid "\"Interface name\" is a name as documented in :func:`if_nameindex`." msgstr "" msgid "" -"Return a network interface name corresponding to an interface index number. :" -"exc:`OSError` if no interface with the given index exists." +"Return a network interface name corresponding to an interface index " +"number. :exc:`OSError` if no interface with the given index exists." msgstr "" msgid "" "Send the list of file descriptors *fds* over an :const:`AF_UNIX` socket " -"*sock*. The *fds* parameter is a sequence of file descriptors. Consult :meth:" -"`~socket.sendmsg` for the documentation of these parameters." +"*sock*. The *fds* parameter is a sequence of file descriptors. " +"Consult :meth:`~socket.sendmsg` for the documentation of these parameters." msgstr "" msgid "" @@ -1314,8 +1256,13 @@ msgstr "" msgid "" "Receive up to *maxfds* file descriptors from an :const:`AF_UNIX` socket " -"*sock*. Return ``(msg, list(fds), flags, addr)``. Consult :meth:`~socket." -"recvmsg` for the documentation of these parameters." +"*sock*. Return ``(msg, list(fds), flags, addr)``. " +"Consult :meth:`~socket.recvmsg` for the documentation of these parameters." +msgstr "" + +msgid "" +"Unix platforms supporting :meth:`~socket.recvmsg` and :const:`SCM_RIGHTS` " +"mechanism." msgstr "" msgid "Any truncated integers at the end of the list of file descriptors." @@ -1325,13 +1272,74 @@ msgid "Socket Objects" msgstr "" msgid "" -"Socket objects have the following methods. Except for :meth:`~socket." -"makefile`, these correspond to Unix system calls applicable to sockets." +"Create a new socket using the given address family, socket type and protocol " +"number. The address family should be :const:`AF_INET` (the " +"default), :const:`AF_INET6`, :const:`AF_UNIX`, :const:`AF_CAN`, :const:`AF_PACKET`, " +"or :const:`AF_RDS`. The socket type should be :const:`SOCK_STREAM` (the " +"default), :const:`SOCK_DGRAM`, :const:`SOCK_RAW` or perhaps one of the other " +"``SOCK_`` constants. The protocol number is usually zero and may be omitted " +"or in the case where the address family is :const:`AF_CAN` the protocol " +"should be one of :const:`CAN_RAW`, :const:`CAN_BCM`, :const:`CAN_ISOTP` " +"or :const:`CAN_J1939`." +msgstr "" + +msgid "" +"If *fileno* is specified, the values for *family*, *type*, and *proto* are " +"auto-detected from the specified file descriptor. Auto-detection can be " +"overruled by calling the function with explicit *family*, *type*, or *proto* " +"arguments. This only affects how Python represents e.g. the return value " +"of :meth:`socket.getpeername` but not the actual OS resource. " +"Unlike :func:`socket.fromfd`, *fileno* will return the same socket and not a " +"duplicate. This may help close a detached socket " +"using :meth:`~socket.socket.close`." +msgstr "" + +msgid "" +"Raises an :ref:`auditing event ` ``socket.__new__`` with arguments " +"``self``, ``family``, ``type``, ``protocol``." +msgstr "" + +msgid "The AF_CAN family was added. The AF_RDS family was added." +msgstr "" + +msgid "The CAN_BCM protocol was added." +msgstr "" + +msgid "The CAN_ISOTP protocol was added." +msgstr "" + +msgid "" +"When :const:`SOCK_NONBLOCK` or :const:`SOCK_CLOEXEC` bit flags are applied " +"to *type* they are cleared, and :attr:`socket.type` will not reflect them. " +"They are still passed to the underlying system ``socket()`` call. Therefore," +msgstr "" + +msgid "" +"sock = socket.socket(\n" +" socket.AF_INET,\n" +" socket.SOCK_STREAM | socket.SOCK_NONBLOCK)" +msgstr "" + +msgid "" +"will still create a non-blocking socket on OSes that support " +"``SOCK_NONBLOCK``, but ``sock.type`` will be set to ``socket.SOCK_STREAM``." +msgstr "" + +msgid "The CAN_J1939 protocol was added." +msgstr "" + +msgid "The IPPROTO_MPTCP protocol was added." +msgstr "" + +msgid "" +"Socket objects have the following methods. Except " +"for :meth:`~socket.makefile`, these correspond to Unix system calls " +"applicable to sockets." msgstr "" msgid "" "Support for the :term:`context manager` protocol was added. Exiting the " -"context manager is equivalent to calling :meth:`~socket.close`." +"context manager is equivalent to calling :meth:`~socket.socket.close`." msgstr "" msgid "" @@ -1347,13 +1355,14 @@ msgstr "" msgid "" "If the system call is interrupted and the signal handler does not raise an " -"exception, the method now retries the system call instead of raising an :exc:" -"`InterruptedError` exception (see :pep:`475` for the rationale)." +"exception, the method now retries the system call instead of raising " +"an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)." msgstr "" msgid "" -"Bind the socket to *address*. The socket must not already be bound. (The " -"format of *address* depends on the address family --- see above.)" +"Bind the socket to *address*. The socket must not already be bound. The " +"format of *address* depends on the address family --- see :ref:`socket-" +"addresses`." msgstr "" msgid "" @@ -1376,8 +1385,8 @@ msgid "" msgstr "" msgid "" -":exc:`OSError` is now raised if an error occurs when the underlying :c:func:" -"`close` call is made." +":exc:`OSError` is now raised if an error occurs when the " +"underlying :c:func:`!close` call is made." msgstr "" msgid "" @@ -1387,17 +1396,17 @@ msgid "" msgstr "" msgid "" -"Connect to a remote socket at *address*. (The format of *address* depends on " -"the address family --- see above.)" +"Connect to a remote socket at *address*. The format of *address* depends on " +"the address family --- see :ref:`socket-addresses`." msgstr "" msgid "" "If the connection is interrupted by a signal, the method waits until the " -"connection completes, or raise a :exc:`TimeoutError` on timeout, if the " +"connection completes, or raises a :exc:`TimeoutError` on timeout, if the " "signal handler doesn't raise an exception and the socket is blocking or has " -"a timeout. For non-blocking sockets, the method raises an :exc:" -"`InterruptedError` exception if the connection is interrupted by a signal " -"(or the exception raised by the signal handler)." +"a timeout. For non-blocking sockets, the method raises " +"an :exc:`InterruptedError` exception if the connection is interrupted by a " +"signal (or the exception raised by the signal handler)." msgstr "" msgid "" @@ -1406,15 +1415,15 @@ msgid "" msgstr "" msgid "" -"The method now waits until the connection completes instead of raising an :" -"exc:`InterruptedError` exception if the connection is interrupted by a " +"The method now waits until the connection completes instead of raising " +"an :exc:`InterruptedError` exception if the connection is interrupted by a " "signal, the signal handler doesn't raise an exception and the socket is " "blocking or has a timeout (see the :pep:`475` for the rationale)." msgstr "" msgid "" "Like ``connect(address)``, but return an error indicator instead of raising " -"an exception for errors returned by the C-level :c:func:`connect` call " +"an exception for errors returned by the C-level :c:func:`!connect` call " "(other problems, such as \"host not found,\" can still raise exceptions). " "The error indicator is ``0`` if the operation succeeded, otherwise the value " "of the :c:data:`errno` variable. This is useful to support, for example, " @@ -1449,27 +1458,27 @@ msgstr "" msgid "" "Return the remote address to which the socket is connected. This is useful " -"to find out the port number of a remote IPv4/v6 socket, for instance. (The " -"format of the address returned depends on the address family --- see " -"above.) On some systems this function is not supported." +"to find out the port number of a remote IPv4/v6 socket, for instance. The " +"format of the address returned depends on the address family --- " +"see :ref:`socket-addresses`. On some systems this function is not supported." msgstr "" msgid "" "Return the socket's own address. This is useful to find out the port number " -"of an IPv4/v6 socket, for instance. (The format of the address returned " -"depends on the address family --- see above.)" +"of an IPv4/v6 socket, for instance. The format of the address returned " +"depends on the address family --- see :ref:`socket-addresses`." msgstr "" msgid "" -"Return the value of the given socket option (see the Unix man page :manpage:" -"`getsockopt(2)`). The needed symbolic constants (:ref:`SO_\\* etc. `) are defined in this module. If *buflen* is absent, an " -"integer option is assumed and its integer value is returned by the " -"function. If *buflen* is present, it specifies the maximum length of the " -"buffer used to receive the option in, and this buffer is returned as a bytes " -"object. It is up to the caller to decode the contents of the buffer (see " -"the optional built-in module :mod:`struct` for a way to decode C structures " -"encoded as byte strings)." +"Return the value of the given socket option (see the Unix man " +"page :manpage:`getsockopt(2)`). The needed symbolic constants (:ref:`SO_\\* " +"etc. `) are defined in this module. If *buflen* is " +"absent, an integer option is assumed and its integer value is returned by " +"the function. If *buflen* is present, it specifies the maximum length of " +"the buffer used to receive the option in, and this buffer is returned as a " +"bytes object. It is up to the caller to decode the contents of the buffer " +"(see the optional built-in module :mod:`struct` for a way to decode C " +"structures encoded as byte strings)." msgstr "" msgid "" @@ -1481,20 +1490,15 @@ msgstr "" msgid "" "Return the timeout in seconds (float) associated with socket operations, or " -"``None`` if no timeout is set. This reflects the last call to :meth:" -"`setblocking` or :meth:`settimeout`." +"``None`` if no timeout is set. This reflects the last call " +"to :meth:`setblocking` or :meth:`settimeout`." msgstr "" -msgid "platform" -msgstr "" - -msgid "Windows" -msgstr "Windows" - msgid "" "The :meth:`ioctl` method is a limited interface to the WSAIoctl system " -"interface. Please refer to the `Win32 documentation `_ for more information." +"interface. Please refer to the `Win32 documentation `_ for more " +"information." msgstr "" msgid "" @@ -1533,8 +1537,8 @@ msgstr "" msgid "" "Closing the file object returned by :meth:`makefile` won't close the " -"original socket unless all other file objects have been closed and :meth:" -"`socket.close` has been called on the socket object." +"original socket unless all other file objects have been closed " +"and :meth:`~socket.socket.close` has been called on the socket object." msgstr "" msgid "" @@ -1547,9 +1551,9 @@ msgid "" "Receive data from the socket. The return value is a bytes object " "representing the data received. The maximum amount of data to be received " "at once is specified by *bufsize*. A returned empty bytes object indicates " -"that the client has disconnected. See the Unix manual page :manpage:" -"`recv(2)` for the meaning of the optional argument *flags*; it defaults to " -"zero." +"that the client has disconnected. See the Unix manual " +"page :manpage:`recv(2)` for the meaning of the optional argument *flags*; it " +"defaults to zero." msgstr "" msgid "" @@ -1557,14 +1561,14 @@ msgid "" "address)`` where *bytes* is a bytes object representing the data received " "and *address* is the address of the socket sending the data. See the Unix " "manual page :manpage:`recv(2)` for the meaning of the optional argument " -"*flags*; it defaults to zero. (The format of *address* depends on the " -"address family --- see above.)" +"*flags*; it defaults to zero. The format of *address* depends on the address " +"family --- see :ref:`socket-addresses`." msgstr "" msgid "" "For multicast IPv6 address, first item of *address* does not contain " -"``%scope_id`` part anymore. In order to get full IPv6 address use :func:" -"`getnameinfo`." +"``%scope_id`` part anymore. In order to get full IPv6 address " +"use :func:`getnameinfo`." msgstr "" msgid "" @@ -1596,27 +1600,28 @@ msgid "" "file descriptors between processes over an :const:`AF_UNIX` socket. When " "this facility is used (it is often restricted to :const:`SOCK_STREAM` " "sockets), :meth:`recvmsg` will return, in its ancillary data, items of the " -"form ``(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)``, where *fds* is a :" -"class:`bytes` object representing the new file descriptors as a binary array " -"of the native C :c:expr:`int` type. If :meth:`recvmsg` raises an exception " -"after the system call returns, it will first attempt to close any file " -"descriptors received via this mechanism." +"form ``(socket.SOL_SOCKET, socket.SCM_RIGHTS, fds)``, where *fds* is " +"a :class:`bytes` object representing the new file descriptors as a binary " +"array of the native C :c:expr:`int` type. If :meth:`recvmsg` raises an " +"exception after the system call returns, it will first attempt to close any " +"file descriptors received via this mechanism." msgstr "" msgid "" "Some systems do not indicate the truncated length of ancillary data items " "which have been only partially received. If an item appears to extend " -"beyond the end of the buffer, :meth:`recvmsg` will issue a :exc:" -"`RuntimeWarning`, and will return the part of it which is inside the buffer " -"provided it has not been truncated before the start of its associated data." +"beyond the end of the buffer, :meth:`recvmsg` will issue " +"a :exc:`RuntimeWarning`, and will return the part of it which is inside the " +"buffer provided it has not been truncated before the start of its associated " +"data." msgstr "" msgid "" -"On systems which support the :const:`SCM_RIGHTS` mechanism, the following " +"On systems which support the :const:`!SCM_RIGHTS` mechanism, the following " "function will receive up to *maxfds* file descriptors, returning the message " "data and a list containing the descriptors (while ignoring unexpected " -"conditions such as unrelated control messages being received). See also :" -"meth:`sendmsg`. ::" +"conditions such as unrelated control messages being received). See " +"also :meth:`sendmsg`. ::" msgstr "" msgid "" @@ -1627,24 +1632,25 @@ msgid "" " msg, ancdata, flags, addr = sock.recvmsg(msglen, socket.CMSG_LEN(maxfds " "* fds.itemsize))\n" " for cmsg_level, cmsg_type, cmsg_data in ancdata:\n" -" if cmsg_level == socket.SOL_SOCKET and cmsg_type == socket." -"SCM_RIGHTS:\n" +" if cmsg_level == socket.SOL_SOCKET and cmsg_type == " +"socket.SCM_RIGHTS:\n" " # Append data, ignoring any truncated integers at the end.\n" -" fds.frombytes(cmsg_data[:len(cmsg_data) - (len(cmsg_data) % fds." -"itemsize)])\n" +" fds.frombytes(cmsg_data[:len(cmsg_data) - (len(cmsg_data) % " +"fds.itemsize)])\n" " return msg, list(fds)" msgstr "" msgid "" -"Receive normal data and ancillary data from the socket, behaving as :meth:" -"`recvmsg` would, but scatter the non-ancillary data into a series of buffers " -"instead of returning a new bytes object. The *buffers* argument must be an " -"iterable of objects that export writable buffers (e.g. :class:`bytearray` " -"objects); these will be filled with successive chunks of the non-ancillary " -"data until it has all been written or there are no more buffers. The " -"operating system may set a limit (:func:`~os.sysconf` value ``SC_IOV_MAX``) " -"on the number of buffers that can be used. The *ancbufsize* and *flags* " -"arguments have the same meaning as for :meth:`recvmsg`." +"Receive normal data and ancillary data from the socket, behaving " +"as :meth:`recvmsg` would, but scatter the non-ancillary data into a series " +"of buffers instead of returning a new bytes object. The *buffers* argument " +"must be an iterable of objects that export writable buffers " +"(e.g. :class:`bytearray` objects); these will be filled with successive " +"chunks of the non-ancillary data until it has all been written or there are " +"no more buffers. The operating system may set a limit (:func:`~os.sysconf` " +"value ``SC_IOV_MAX``) on the number of buffers that can be used. The " +"*ancbufsize* and *flags* arguments have the same meaning as " +"for :meth:`recvmsg`." msgstr "" msgid "" @@ -1676,8 +1682,9 @@ msgid "" "new bytestring. The return value is a pair ``(nbytes, address)`` where " "*nbytes* is the number of bytes received and *address* is the address of the " "socket sending the data. See the Unix manual page :manpage:`recv(2)` for " -"the meaning of the optional argument *flags*; it defaults to zero. (The " -"format of *address* depends on the address family --- see above.)" +"the meaning of the optional argument *flags*; it defaults to zero. The " +"format of *address* depends on the address family --- see :ref:`socket-" +"addresses`." msgstr "" msgid "" @@ -1690,20 +1697,20 @@ msgstr "" msgid "" "Send data to the socket. The socket must be connected to a remote socket. " -"The optional *flags* argument has the same meaning as for :meth:`recv` " -"above. Returns the number of bytes sent. Applications are responsible for " -"checking that all data has been sent; if only some of the data was " -"transmitted, the application needs to attempt delivery of the remaining " -"data. For further information on this topic, consult the :ref:`socket-howto`." +"The optional *flags* argument has the same meaning as for :meth:`recv`. " +"Returns the number of bytes sent. Applications are responsible for checking " +"that all data has been sent; if only some of the data was transmitted, the " +"application needs to attempt delivery of the remaining data. For further " +"information on this topic, consult the :ref:`socket-howto`." msgstr "" msgid "" "Send data to the socket. The socket must be connected to a remote socket. " -"The optional *flags* argument has the same meaning as for :meth:`recv` " -"above. Unlike :meth:`send`, this method continues to send data from *bytes* " -"until either all data has been sent or an error occurs. ``None`` is " -"returned on success. On error, an exception is raised, and there is no way " -"to determine how much data, if any, was successfully sent." +"The optional *flags* argument has the same meaning as for :meth:`recv`. " +"Unlike :meth:`send`, this method continues to send data from *bytes* until " +"either all data has been sent or an error occurs. ``None`` is returned on " +"success. On error, an exception is raised, and there is no way to determine " +"how much data, if any, was successfully sent." msgstr "" msgid "" @@ -1714,9 +1721,9 @@ msgstr "" msgid "" "Send data to the socket. The socket should not be connected to a remote " "socket, since the destination socket is specified by *address*. The " -"optional *flags* argument has the same meaning as for :meth:`recv` above. " -"Return the number of bytes sent. (The format of *address* depends on the " -"address family --- see above.)" +"optional *flags* argument has the same meaning as for :meth:`recv`. Return " +"the number of bytes sent. The format of *address* depends on the address " +"family --- see :ref:`socket-addresses`." msgstr "" msgid "" @@ -1727,9 +1734,9 @@ msgstr "" msgid "" "Send normal and ancillary data to the socket, gathering the non-ancillary " "data from a series of buffers and concatenating it into a single message. " -"The *buffers* argument specifies the non-ancillary data as an iterable of :" -"term:`bytes-like objects ` (e.g. :class:`bytes` objects); " -"the operating system may set a limit (:func:`~os.sysconf` value " +"The *buffers* argument specifies the non-ancillary data as an iterable " +"of :term:`bytes-like objects ` (e.g. :class:`bytes` " +"objects); the operating system may set a limit (:func:`~os.sysconf` value " "``SC_IOV_MAX``) on the number of buffers that can be used. The *ancdata* " "argument specifies the ancillary data (control messages) as an iterable of " "zero or more tuples ``(cmsg_level, cmsg_type, cmsg_data)``, where " @@ -1744,17 +1751,17 @@ msgid "" msgstr "" msgid "" -"The following function sends the list of file descriptors *fds* over an :" -"const:`AF_UNIX` socket, on systems which support the :const:`SCM_RIGHTS` " -"mechanism. See also :meth:`recvmsg`. ::" +"The following function sends the list of file descriptors *fds* over " +"an :const:`AF_UNIX` socket, on systems which support the :const:`!" +"SCM_RIGHTS` mechanism. See also :meth:`recvmsg`. ::" msgstr "" msgid "" "import socket, array\n" "\n" "def send_fds(sock, msg, fds):\n" -" return sock.sendmsg([msg], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, array." -"array(\"i\", fds))])" +" return sock.sendmsg([msg], [(socket.SOL_SOCKET, socket.SCM_RIGHTS, " +"array.array(\"i\", fds))])" msgstr "" msgid "" @@ -1769,16 +1776,17 @@ msgid "" msgstr "" msgid "" -"Send a file until EOF is reached by using high-performance :mod:`os." -"sendfile` and return the total number of bytes which were sent. *file* must " -"be a regular file object opened in binary mode. If :mod:`os.sendfile` is not " -"available (e.g. Windows) or *file* is not a regular file :meth:`send` will " -"be used instead. *offset* tells from where to start reading the file. If " -"specified, *count* is the total number of bytes to transmit as opposed to " -"sending the file until EOF is reached. File position is updated on return or " -"also in case of error in which case :meth:`file.tell() ` can " -"be used to figure out the number of bytes which were sent. The socket must " -"be of :const:`SOCK_STREAM` type. Non-blocking sockets are not supported." +"Send a file until EOF is reached by using high-" +"performance :mod:`os.sendfile` and return the total number of bytes which " +"were sent. *file* must be a regular file object opened in binary mode. " +"If :mod:`os.sendfile` is not available (e.g. Windows) or *file* is not a " +"regular file :meth:`send` will be used instead. *offset* tells from where to " +"start reading the file. If specified, *count* is the total number of bytes " +"to transmit as opposed to sending the file until EOF is reached. File " +"position is updated on return or also in case of error in which " +"case :meth:`file.tell() ` can be used to figure out the " +"number of bytes which were sent. The socket must be of :const:`SOCK_STREAM` " +"type. Non-blocking sockets are not supported." msgstr "" msgid "" @@ -1802,17 +1810,17 @@ msgid "``sock.setblocking(False)`` is equivalent to ``sock.settimeout(0.0)``" msgstr "" msgid "" -"The method no longer applies :const:`SOCK_NONBLOCK` flag on :attr:`socket." -"type`." +"The method no longer applies :const:`SOCK_NONBLOCK` flag " +"on :attr:`socket.type`." msgstr "" msgid "" "Set a timeout on blocking socket operations. The *value* argument can be a " -"nonnegative floating-point number expressing seconds, or ``None``. If a non-" -"zero value is given, subsequent socket operations will raise a :exc:" -"`timeout` exception if the timeout period *value* has elapsed before the " -"operation has completed. If zero is given, the socket is put in non-" -"blocking mode. If ``None`` is given, the socket is put in blocking mode." +"nonnegative real number expressing seconds, or ``None``. If a non-zero value " +"is given, subsequent socket operations will raise a :exc:`timeout` exception " +"if the timeout period *value* has elapsed before the operation has " +"completed. If zero is given, the socket is put in non-blocking mode. If " +"``None`` is given, the socket is put in blocking mode." msgstr "" msgid "" @@ -1821,45 +1829,47 @@ msgid "" msgstr "" msgid "" -"The method no longer toggles :const:`SOCK_NONBLOCK` flag on :attr:`socket." -"type`." +"The method no longer toggles :const:`SOCK_NONBLOCK` flag " +"on :attr:`socket.type`." msgstr "" msgid "" -"Set the value of the given socket option (see the Unix manual page :manpage:" -"`setsockopt(2)`). The needed symbolic constants are defined in this module " -"(:ref:`!SO_\\* etc. `). The value can be an integer, " -"``None`` or a :term:`bytes-like object` representing a buffer. In the 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 " -"encode C structures as bytestrings). When *value* is set to ``None``, " -"*optlen* argument is required. It's equivalent to call :c:func:`setsockopt` " -"C function with ``optval=NULL`` and ``optlen=optlen``." +"Set the value of the given socket option (see the Unix manual " +"page :manpage:`setsockopt(2)`). The needed symbolic constants are defined " +"in this module (:ref:`!SO_\\* etc. `). The value can " +"be an integer, ``None`` or a :term:`bytes-like object` representing a " +"buffer. In the latter case it is up to the caller to ensure that the " +"bytestring contains the proper bits (see the optional built-in " +"module :mod:`struct` for a way to encode C structures as bytestrings). When " +"*value* is set to ``None``, *optlen* argument is required. It's equivalent " +"to calling :c:func:`!setsockopt` C function with ``optval=NULL`` and " +"``optlen=optlen``." msgstr "" msgid "setsockopt(level, optname, None, optlen: int) form added." msgstr "" msgid "" -"Shut down one or both halves of the connection. If *how* is :const:" -"`SHUT_RD`, further receives are disallowed. If *how* is :const:`SHUT_WR`, " -"further sends are disallowed. If *how* is :const:`SHUT_RDWR`, further sends " -"and receives are disallowed." +"Shut down one or both halves of the connection. If *how* " +"is :const:`SHUT_RD`, further receives are disallowed. If *how* " +"is :const:`SHUT_WR`, further sends are disallowed. If *how* " +"is :const:`SHUT_RDWR`, further sends and receives are disallowed." msgstr "" msgid "" "Duplicate a socket and prepare it for sharing with a target process. The " "target process must be provided with *process_id*. The resulting bytes " "object can then be passed to the target process using some form of " -"interprocess communication and the socket can be recreated there using :func:" -"`fromshare`. Once this method has been called, it is safe to close the " -"socket since the operating system has already duplicated it for the target " -"process." +"interprocess communication and the socket can be recreated there " +"using :func:`fromshare`. Once this method has been called, it is safe to " +"close the socket since the operating system has already duplicated it for " +"the target process." msgstr "" msgid "" -"Note that there are no methods :meth:`read` or :meth:`write`; use :meth:" -"`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." +"Note that there are no methods :meth:`!read` or :meth:`!write`; " +"use :meth:`~socket.recv` and :meth:`~socket.send` without *flags* argument " +"instead." msgstr "" msgid "" @@ -1876,6 +1886,13 @@ msgstr "" msgid "The socket protocol." msgstr "" +msgid "" +"The base class of the :class:`~socket.socket` type, re-exported from :mod:`!" +"_socket`. An instance check such as ``isinstance(socket(...), SocketType)`` " +"is true, but ``SocketType`` is not the same as ``type(socket(...))``, which " +"is :class:`~socket.socket` itself." +msgstr "" + msgid "Notes on socket timeouts" msgstr "" @@ -1917,19 +1934,19 @@ msgstr "" msgid "" "The :meth:`~socket.connect` operation is also subject to the timeout " "setting, and in general it is recommended to call :meth:`~socket.settimeout` " -"before calling :meth:`~socket.connect` or pass a timeout parameter to :meth:" -"`create_connection`. However, the system network stack may also return a " -"connection timeout error of its own regardless of any Python socket timeout " -"setting." +"before calling :meth:`~socket.connect` or pass a timeout parameter " +"to :meth:`create_connection`. However, the system network stack may also " +"return a connection timeout error of its own regardless of any Python socket " +"timeout setting." msgstr "" msgid "Timeouts and the ``accept`` method" msgstr "" msgid "" -"If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by the :" -"meth:`~socket.accept` method inherit that timeout. Otherwise, the behaviour " -"depends on settings of the listening socket:" +"If :func:`getdefaulttimeout` is not :const:`None`, sockets returned by " +"the :meth:`~socket.accept` method inherit that timeout. Otherwise, the " +"behaviour depends on settings of the listening socket:" msgstr "" msgid "" @@ -1950,13 +1967,14 @@ msgstr "Przykład" msgid "" "Here are four minimal example programs using the TCP/IP protocol: a server " "that echoes all data that it receives back (servicing only one client), and " -"a client using it. Note that a server must perform the sequence :func:" -"`~socket.socket`, :meth:`~socket.bind`, :meth:`~socket.listen`, :meth:" -"`~socket.accept` (possibly repeating the :meth:`~socket.accept` to service " -"more than one client), while a client only needs the sequence :func:`~socket." -"socket`, :meth:`~socket.connect`. Also note that the server does not :meth:" -"`~socket.sendall`/:meth:`~socket.recv` on the socket it is listening on but " -"on the new socket returned by :meth:`~socket.accept`." +"a client using it. Note that a server must perform the " +"sequence :func:`~socket.socket`, :meth:`~socket.bind`, :meth:`~socket.listen`, :meth:`~socket.accept` " +"(possibly repeating the :meth:`~socket.accept` to service more than one " +"client), while a client only needs the " +"sequence :func:`~socket.socket`, :meth:`~socket.connect`. Also note that " +"the server does not :meth:`~socket.sendall`/:meth:`~socket.recv` on the " +"socket it is listening on but on the new socket returned " +"by :meth:`~socket.accept`." msgstr "" msgid "The first two examples support IPv4 only. ::" @@ -2046,8 +2064,8 @@ msgid "" "HOST = 'daring.cwi.nl' # The remote host\n" "PORT = 50007 # The same port as used by the server\n" "s = None\n" -"for res in socket.getaddrinfo(HOST, PORT, socket.AF_UNSPEC, socket." -"SOCK_STREAM):\n" +"for res in socket.getaddrinfo(HOST, PORT, socket.AF_UNSPEC, " +"socket.SOCK_STREAM):\n" " af, socktype, proto, canonname, sa = res\n" " try:\n" " s = socket.socket(af, socktype, proto)\n" @@ -2172,8 +2190,8 @@ msgid "" msgstr "" msgid "" -"There is a :mod:`socket` flag to set, in order to prevent this, :const:" -"`socket.SO_REUSEADDR`::" +"There is a :mod:`socket` flag to set, in order to prevent " +"this, :const:`socket.SO_REUSEADDR`::" msgstr "" msgid "" diff --git a/library/socketserver.po b/library/socketserver.po index 440bf345ab..66c11c1a65 100644 --- a/library/socketserver.po +++ b/library/socketserver.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!socketserver` --- A framework for network servers" msgstr "" msgid "**Source code:** :source:`Lib/socketserver.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/socketserver.py`" msgid "" "The :mod:`socketserver` module simplifies the task of writing network " @@ -84,9 +83,9 @@ msgid "" "classes, passing it the server's address and the request handler class. It " "is recommended to use the server in a :keyword:`with` statement. Then call " "the :meth:`~BaseServer.handle_request` or :meth:`~BaseServer.serve_forever` " -"method of the server object to process one or many requests. Finally, call :" -"meth:`~BaseServer.server_close` to close the socket (unless you used a :" -"keyword:`!with` statement)." +"method of the server object to process one or many requests. Finally, " +"call :meth:`~BaseServer.server_close` to close the socket (unless you used " +"a :keyword:`!with` statement)." msgstr "" msgid "" @@ -96,8 +95,8 @@ msgid "" "attribute *daemon_threads*, which indicates whether or not the server should " "wait for thread termination. You should set the flag explicitly if you " "would like threads to behave autonomously; the default is :const:`False`, " -"meaning that Python will not exit until all threads created by :class:" -"`ThreadingMixIn` have exited." +"meaning that Python will not exit until all threads created " +"by :class:`ThreadingMixIn` have exited." msgstr "" msgid "" @@ -147,9 +146,9 @@ msgid "" msgstr "" msgid "" -"The mix-in class comes first, since it overrides a method defined in :class:" -"`UDPServer`. Setting the various attributes also changes the behavior of " -"the underlying server mechanism." +"The mix-in class comes first, since it overrides a method defined " +"in :class:`UDPServer`. Setting the various attributes also changes the " +"behavior of the underlying server mechanism." msgstr "" msgid "" @@ -170,17 +169,17 @@ msgid "" msgstr "" msgid "" -"For :class:`ThreadingMixIn` use daemonic threads by setting :data:" -"`ThreadingMixIn.daemon_threads ` to ``True`` to not wait " -"until threads complete." +"For :class:`ThreadingMixIn` use daemonic threads by " +"setting :data:`ThreadingMixIn.daemon_threads ` to ``True`` " +"to not wait until threads complete." msgstr "" msgid "" -":meth:`ForkingMixIn.server_close ` and :meth:" -"`ThreadingMixIn.server_close ` now waits until all " -"child processes and non-daemonic threads complete. Add a new :attr:" -"`ForkingMixIn.block_on_close ` class attribute to opt-in for " -"the pre-3.7 behaviour." +":meth:`ForkingMixIn.server_close ` " +"and :meth:`ThreadingMixIn.server_close ` now waits " +"until all child processes and non-daemonic threads complete. Add a " +"new :attr:`ForkingMixIn.block_on_close ` class attribute to " +"opt-in for the pre-3.7 behaviour." msgstr "" msgid "These classes are pre-defined using the mix-in classes." @@ -192,13 +191,13 @@ msgid "" msgstr "" msgid "" -"To implement a service, you must derive a class from :class:" -"`BaseRequestHandler` and redefine its :meth:`~BaseRequestHandler.handle` " -"method. You can then run various versions of the service by combining one of " -"the server classes with your request handler class. The request handler " -"class must be different for datagram or stream services. This can be hidden " -"by using the handler subclasses :class:`StreamRequestHandler` or :class:" -"`DatagramRequestHandler`." +"To implement a service, you must derive a class " +"from :class:`BaseRequestHandler` and redefine " +"its :meth:`~BaseRequestHandler.handle` method. You can then run various " +"versions of the service by combining one of the server classes with your " +"request handler class. The request handler class must be different for " +"datagram or stream services. This can be hidden by using the handler " +"subclasses :class:`StreamRequestHandler` or :class:`DatagramRequestHandler`." msgstr "" msgid "" @@ -223,8 +222,8 @@ msgid "" "In some cases, it may be appropriate to process part of a request " "synchronously, but to finish processing in a forked child depending on the " "request data. This can be implemented by using a synchronous server and " -"doing an explicit fork in the request handler class :meth:" -"`~BaseRequestHandler.handle` method." +"doing an explicit fork in the request handler " +"class :meth:`~BaseRequestHandler.handle` method." msgstr "" msgid "" @@ -244,8 +243,8 @@ msgstr "" msgid "" "This is the superclass of all Server objects in the module. It defines the " "interface, given below, but does not implement most of the methods, which is " -"done in subclasses. The two parameters are stored in the respective :attr:" -"`server_address` and :attr:`RequestHandlerClass` attributes." +"done in subclasses. The two parameters are stored in the " +"respective :attr:`server_address` and :attr:`RequestHandlerClass` attributes." msgstr "" msgid "" @@ -256,12 +255,13 @@ msgstr "" msgid "" "Process a single request. This function calls the following methods in " -"order: :meth:`get_request`, :meth:`verify_request`, and :meth:" -"`process_request`. If the user-provided :meth:`~BaseRequestHandler.handle` " -"method of the handler class raises an exception, the server's :meth:" -"`handle_error` method will be called. If no request is received within :" -"attr:`timeout` seconds, :meth:`handle_timeout` will be called and :meth:" -"`handle_request` will return." +"order: :meth:`get_request`, :meth:`verify_request`, " +"and :meth:`process_request`. If the user-" +"provided :meth:`~BaseRequestHandler.handle` method of the handler class " +"raises an exception, the server's :meth:`handle_error` method will be " +"called. If no request is received within :attr:`timeout` " +"seconds, :meth:`handle_timeout` will be called and :meth:`handle_request` " +"will return." msgstr "" msgid "" @@ -283,9 +283,9 @@ msgid "" msgstr "" msgid "" -"Tell the :meth:`serve_forever` loop to stop and wait until it does. :meth:" -"`shutdown` must be called while :meth:`serve_forever` is running in a " -"different thread otherwise it will deadlock." +"Tell the :meth:`serve_forever` loop to stop and wait until it " +"does. :meth:`shutdown` must be called while :meth:`serve_forever` is running " +"in a different thread otherwise it will deadlock." msgstr "" msgid "Clean up the server. May be overridden." @@ -293,10 +293,10 @@ msgstr "" msgid "" "The family of protocols to which the server's socket belongs. Common " -"examples are :const:`socket.AF_INET`, :const:`socket.AF_INET6`, and :const:" -"`socket.AF_UNIX`. Subclass the TCP or UDP server classes in this module " -"with class attribute ``address_family = AF_INET6`` set if you want IPv6 " -"server classes." +"examples are :const:`socket.AF_INET`, :const:`socket.AF_INET6`, " +"and :const:`socket.AF_UNIX`. Subclass the TCP or UDP server classes in this " +"module with class attribute ``address_family = AF_INET6`` set if you want " +"IPv6 server classes." msgstr "" msgid "" @@ -306,9 +306,9 @@ msgstr "" msgid "" "The address on which the server is listening. The format of addresses " -"varies depending on the protocol family; see the documentation for the :mod:" -"`socket` module for details. For internet protocols, this is a tuple " -"containing a string giving the address, and an integer port number: " +"varies depending on the protocol family; see the documentation for " +"the :mod:`socket` module for details. For internet protocols, this is a " +"tuple containing a string giving the address, and an integer port number: " "``('127.0.0.1', 80)``, for example." msgstr "" @@ -320,8 +320,8 @@ msgid "The server classes support the following class variables:" msgstr "" msgid "" -"Whether the server will allow the reuse of an address. This defaults to :" -"const:`False`, and can be set in subclasses to change the policy." +"Whether the server will allow the reuse of an address. This defaults " +"to :const:`False`, and can be set in subclasses to change the policy." msgstr "" msgid "" @@ -333,8 +333,8 @@ msgid "" msgstr "" msgid "" -"The type of socket used by the server; :const:`socket.SOCK_STREAM` and :" -"const:`socket.SOCK_DGRAM` are two common values." +"The type of socket used by the server; :const:`socket.SOCK_STREAM` " +"and :const:`socket.SOCK_DGRAM` are two common values." msgstr "" msgid "" @@ -379,10 +379,10 @@ msgid "" msgstr "" msgid "" -"Calls :meth:`finish_request` to create an instance of the :attr:" -"`RequestHandlerClass`. If desired, this function can create a new process " -"or thread to handle the request; the :class:`ForkingMixIn` and :class:" -"`ThreadingMixIn` classes do this." +"Calls :meth:`finish_request` to create an instance of " +"the :attr:`RequestHandlerClass`. If desired, this function can create a new " +"process or thread to handle the request; the :class:`ForkingMixIn` " +"and :class:`ThreadingMixIn` classes do this." msgstr "" msgid "" @@ -427,8 +427,8 @@ msgid "" "This function must do all the work required to service a request. The " "default implementation does nothing. Several instance attributes are " "available to it; the request is available as :attr:`request`; the client " -"address as :attr:`client_address`; and the server instance as :attr:" -"`server`, in case it needs access to per-server information." +"address as :attr:`client_address`; and the server instance " +"as :attr:`server`, in case it needs access to per-server information." msgstr "" msgid "" @@ -455,19 +455,19 @@ msgid ":class:`BaseServer` object used for handling the request." msgstr "" msgid "" -"These :class:`BaseRequestHandler` subclasses override the :meth:" -"`~BaseRequestHandler.setup` and :meth:`~BaseRequestHandler.finish` methods, " -"and provide :attr:`rfile` and :attr:`wfile` attributes." +"These :class:`BaseRequestHandler` subclasses override " +"the :meth:`~BaseRequestHandler.setup` and :meth:`~BaseRequestHandler.finish` " +"methods, and provide :attr:`rfile` and :attr:`wfile` attributes." msgstr "" msgid "" -"A file object from which receives the request is read. Support the :class:" -"`io.BufferedIOBase` readable interface." +"A file object from which receives the request is read. Support " +"the :class:`io.BufferedIOBase` readable interface." msgstr "" msgid "" -"A file object to which the reply is written. Support the :class:`io." -"BufferedIOBase` writable interface" +"A file object to which the reply is written. Support " +"the :class:`io.BufferedIOBase` writable interface" msgstr "" msgid "" @@ -544,11 +544,11 @@ msgstr "" 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 the first handler had to use a ``recv()`` loop to accumulate data " +"while the first handler had to use a ``recv()`` loop to accumulate data " "until a newline itself. If it had just used a single ``recv()`` without the " "loop it would just have returned what has been received so far from the " "client. TCP is stream based: data arrives in the order it was sent, but " -"there no correlation between client ``send()`` or ``sendall()`` calls and " +"there is no correlation between client ``send()`` or ``sendall()`` calls and " "the number of ``recv()`` calls on the server required to receive it." msgstr "" @@ -657,8 +657,8 @@ msgid "Asynchronous Mixins" msgstr "" msgid "" -"To build asynchronous handlers, use the :class:`ThreadingMixIn` and :class:" -"`ForkingMixIn` classes." +"To build asynchronous handlers, use the :class:`ThreadingMixIn` " +"and :class:`ForkingMixIn` classes." msgstr "" msgid "An example for the :class:`ThreadingMixIn` class::" @@ -677,8 +677,8 @@ msgid "" " response = bytes(\"{}: {}\".format(cur_thread.name, data), 'ascii')\n" " self.request.sendall(response)\n" "\n" -"class ThreadedTCPServer(socketserver.ThreadingMixIn, socketserver." -"TCPServer):\n" +"class ThreadedTCPServer(socketserver.ThreadingMixIn, " +"socketserver.TCPServer):\n" " pass\n" "\n" "def client(ip, port, message):\n" diff --git a/library/sqlite3.po b/library/sqlite3.po index 7b0188ef77..66496157f5 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.po @@ -1,23 +1,21 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Waldemar Stoczkowski, 2023 -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -31,7 +29,7 @@ msgid ":mod:`!sqlite3` --- DB-API 2.0 interface for SQLite databases" msgstr "" msgid "**Source code:** :source:`Lib/sqlite3/`" -msgstr "" +msgstr "**Kod źródłowy:**. :source:`Lib/sqlite3/`" msgid "" "SQLite is a C library that provides a lightweight disk-based database that " @@ -44,8 +42,8 @@ msgstr "" msgid "" "The :mod:`!sqlite3` module was written by Gerhard Häring. It provides an " -"SQL interface compliant with the DB-API 2.0 specification described by :pep:" -"`249`, and requires SQLite 3.15.2 or newer." +"SQL interface compliant with the DB-API 2.0 specification described " +"by :pep:`249`, and requires SQLite 3.15.2 or newer." msgstr "" msgid "This document includes four main sections:" @@ -107,6 +105,8 @@ msgid "" "import sqlite3\n" "con = sqlite3.connect(\"tutorial.db\")" msgstr "" +"import sqlite3\n" +"con = sqlite3.connect(\"tutorial.db\")" msgid "" "The returned :class:`Connection` object ``con`` represents the connection to " @@ -115,8 +115,8 @@ msgstr "" msgid "" "In order to execute SQL statements and fetch results from SQL queries, we " -"will need to use a database cursor. Call :meth:`con.cursor() ` to create the :class:`Cursor`:" +"will need to use a database cursor. Call :meth:`con.cursor() " +"` to create the :class:`Cursor`:" msgstr "" msgid "cur = con.cursor()" @@ -127,8 +127,8 @@ msgid "" "database table ``movie`` with columns for title, release year, and review " "score. For simplicity, we can just use column names in the table declaration " "-- thanks to the `flexible typing`_ feature of SQLite, specifying the data " -"types is optional. Execute the ``CREATE TABLE`` statement by calling :meth:" -"`cur.execute(...) `:" +"types is optional. Execute the ``CREATE TABLE`` statement by " +"calling :meth:`cur.execute(...) `:" msgstr "" msgid "cur.execute(\"CREATE TABLE movie(title, year, score)\")" @@ -138,9 +138,9 @@ msgid "" "We can verify that the new table has been created by querying the " "``sqlite_master`` table built-in to SQLite, which should now contain an " "entry for the ``movie`` table definition (see `The Schema Table`_ for " -"details). Execute that query by calling :meth:`cur.execute(...) `, assign the result to ``res``, and call :meth:`res.fetchone() " -"` to fetch the resulting row:" +"details). Execute that query by calling :meth:`cur.execute(...) " +"`, assign the result to ``res``, and " +"call :meth:`res.fetchone() ` to fetch the resulting row:" msgstr "" msgid "" @@ -153,9 +153,10 @@ msgstr "" "('movie',)" msgid "" -"We can see that the table has been created, as the query returns a :class:" -"`tuple` containing the table's name. If we query ``sqlite_master`` for a non-" -"existent table ``spam``, :meth:`!res.fetchone` will return ``None``:" +"We can see that the table has been created, as the query returns " +"a :class:`tuple` containing the table's name. If we query ``sqlite_master`` " +"for a non-existent table ``spam``, :meth:`!res.fetchone` will return " +"``None``:" msgstr "" msgid "" @@ -166,8 +167,8 @@ msgstr "" msgid "" "Now, add two rows of data supplied as SQL literals by executing an " -"``INSERT`` statement, once again by calling :meth:`cur.execute(...) `:" +"``INSERT`` statement, once again by calling :meth:`cur.execute(...) " +"`:" msgstr "" msgid "" @@ -181,8 +182,8 @@ msgstr "" msgid "" "The ``INSERT`` statement implicitly opens a transaction, which needs to be " "committed before changes are saved in the database (see :ref:`sqlite3-" -"controlling-transactions` for details). Call :meth:`con.commit() ` on the connection object to commit the transaction:" +"controlling-transactions` for details). Call :meth:`con.commit() " +"` on the connection object to commit the transaction:" msgstr "" msgid "con.commit()" @@ -191,8 +192,8 @@ msgstr "" msgid "" "We can verify that the data was inserted correctly by executing a ``SELECT`` " "query. Use the now-familiar :meth:`cur.execute(...) ` to " -"assign the result to ``res``, and call :meth:`res.fetchall() ` to return all resulting rows:" +"assign the result to ``res``, and call :meth:`res.fetchall() " +"` to return all resulting rows:" msgstr "" msgid "" @@ -210,8 +211,8 @@ msgid "" msgstr "" msgid "" -"Now, insert three more rows by calling :meth:`cur.executemany(...) `:" +"Now, insert three more rows by calling :meth:`cur.executemany(...) " +"`:" msgstr "" msgid "" @@ -253,9 +254,10 @@ msgid "" msgstr "" msgid "" -"Finally, verify that the database has been written to disk by calling :meth:" -"`con.close() ` to close the existing connection, opening a " -"new one, creating a new cursor, then querying the database:" +"Finally, verify that the database has been written to disk by " +"calling :meth:`con.close() ` to close the existing " +"connection, opening a new one, creating a new cursor, then querying the " +"database:" msgstr "" msgid "" @@ -300,7 +302,7 @@ msgid "" msgstr "" msgid "Reference" -msgstr "" +msgstr "Dokumentacja" msgid "Module functions" msgstr "" @@ -318,9 +320,9 @@ msgid "" msgstr "" msgid "" -"How many seconds the connection should wait before raising an :exc:" -"`OperationalError` when a table is locked. If another connection opens a " -"transaction to modify a table, that table will be locked until the " +"How many seconds the connection should wait before raising " +"an :exc:`OperationalError` when a table is locked. If another connection " +"opens a transaction to modify a table, that table will be locked until the " "transaction is committed. Default five seconds." msgstr "" @@ -328,18 +330,19 @@ msgid "" "Control whether and how data types not :ref:`natively supported by SQLite " "` are looked up to be converted to Python types, using the " "converters registered with :func:`register_converter`. Set it to any " -"combination (using ``|``, bitwise or) of :const:`PARSE_DECLTYPES` and :const:" -"`PARSE_COLNAMES` to enable this. Column names takes precedence over declared " -"types if both flags are set. By default (``0``), type detection is disabled." +"combination (using ``|``, bitwise or) of :const:`PARSE_DECLTYPES` " +"and :const:`PARSE_COLNAMES` to enable this. Column names take precedence " +"over declared types if both flags are set. By default (``0``), type " +"detection is disabled." msgstr "" msgid "" -"Control legacy transaction handling behaviour. See :attr:`Connection." -"isolation_level` and :ref:`sqlite3-transaction-control-isolation-level` for " -"more information. Can be ``\"DEFERRED\"`` (default), ``\"EXCLUSIVE\"`` or " -"``\"IMMEDIATE\"``; or ``None`` to disable opening transactions implicitly. " -"Has no effect unless :attr:`Connection.autocommit` is set to :const:" -"`~sqlite3.LEGACY_TRANSACTION_CONTROL` (the default)." +"Control legacy transaction handling behaviour. " +"See :attr:`Connection.isolation_level` and :ref:`sqlite3-transaction-control-" +"isolation-level` for more information. Can be ``\"DEFERRED\"`` (default), " +"``\"EXCLUSIVE\"`` or ``\"IMMEDIATE\"``; or ``None`` to disable opening " +"transactions implicitly. Has no effect unless :attr:`Connection.autocommit` " +"is set to :const:`~sqlite3.LEGACY_TRANSACTION_CONTROL` (the default)." msgstr "" msgid "" @@ -369,11 +372,11 @@ msgid "" msgstr "" msgid "" -"Control :pep:`249` transaction handling behaviour. See :attr:`Connection." -"autocommit` and :ref:`sqlite3-transaction-control-autocommit` for more " -"information. *autocommit* currently defaults to :const:`~sqlite3." -"LEGACY_TRANSACTION_CONTROL`. The default will change to ``False`` in a " -"future Python release." +"Control :pep:`249` transaction handling behaviour. " +"See :attr:`Connection.autocommit` and :ref:`sqlite3-transaction-control-" +"autocommit` for more information. *autocommit* currently defaults " +"to :const:`~sqlite3.LEGACY_TRANSACTION_CONTROL`. The default will change to " +"``False`` in a future Python release." msgstr "" msgid "Return type" @@ -506,8 +509,8 @@ msgid "" msgstr "" msgid "" -"Generated fields (for example ``MAX(p)``) are returned as :class:`str`. Use :" -"const:`!PARSE_COLNAMES` to enforce types for such queries." +"Generated fields (for example ``MAX(p)``) are returned as :class:`str`. " +"Use :const:`!PARSE_COLNAMES` to enforce types for such queries." msgstr "" msgid "" @@ -562,8 +565,8 @@ msgid "" msgstr "" msgid "" -"Version number of the runtime SQLite library as a :class:`tuple` of :class:" -"`integers `." +"Version number of the runtime SQLite library as a :class:`tuple` " +"of :class:`integers `." msgstr "" msgid "" @@ -656,8 +659,8 @@ msgid "" msgstr "" msgid "" -"These constants are used for the :meth:`Connection.setconfig` and :meth:" -"`~Connection.getconfig` methods." +"These constants are used for the :meth:`Connection.setconfig` " +"and :meth:`~Connection.getconfig` methods." msgstr "" msgid "" @@ -676,16 +679,17 @@ msgstr "" msgid "" "Each open SQLite database is represented by a ``Connection`` object, which " -"is created using :func:`sqlite3.connect`. Their main purpose is creating :" -"class:`Cursor` objects, and :ref:`sqlite3-controlling-transactions`." +"is created using :func:`sqlite3.connect`. Their main purpose is " +"creating :class:`Cursor` objects, and :ref:`sqlite3-controlling-" +"transactions`." msgstr "" msgid ":ref:`sqlite3-connection-shortcuts`" msgstr ":ref:`sqlite3-connection-shortcuts`" msgid "" -"A :exc:`ResourceWarning` is emitted if :meth:`close` is not called before a :" -"class:`!Connection` object is deleted." +"A :exc:`ResourceWarning` is emitted if :meth:`close` is not called before " +"a :class:`!Connection` object is deleted." msgstr "" msgid "An SQLite database connection has the following attributes and methods:" @@ -693,8 +697,9 @@ msgstr "" msgid "" "Create and return a :class:`Cursor` object. The cursor method accepts a " -"single optional parameter *factory*. If supplied, this must be a :term:" -"`callable` returning an instance of :class:`Cursor` or its subclasses." +"single optional parameter *factory*. If supplied, this must be " +"a :term:`callable` returning an instance of :class:`Cursor` or its " +"subclasses." msgstr "" msgid "" @@ -708,7 +713,7 @@ msgstr "" msgid "The name of the column where the blob is located." msgstr "" -msgid "The name of the row where the blob is located." +msgid "The row id where the blob is located." msgstr "" msgid "" @@ -733,16 +738,16 @@ msgstr "" msgid "" "Commit any pending transaction to the database. If :attr:`autocommit` is " -"``True``, or there is no open transaction, this method does nothing. If :" -"attr:`!autocommit` is ``False``, a new transaction is implicitly opened if a " -"pending transaction was committed by this method." +"``True``, or there is no open transaction, this method does nothing. " +"If :attr:`!autocommit` is ``False``, a new transaction is implicitly opened " +"if a pending transaction was committed by this method." msgstr "" msgid "" "Roll back to the start of any pending transaction. If :attr:`autocommit` is " -"``True``, or there is no open transaction, this method does nothing. If :" -"attr:`!autocommit` is ``False``, a new transaction is implicitly opened if a " -"pending transaction was rolled back by this method." +"``True``, or there is no open transaction, this method does nothing. " +"If :attr:`!autocommit` is ``False``, a new transaction is implicitly opened " +"if a pending transaction was rolled back by this method." msgstr "" msgid "" @@ -1010,6 +1015,23 @@ msgid "" " print(row)\n" "con.close()" msgstr "" +"def collate_reverse(string1, string2):\n" +" if string1 == string2:\n" +" return 0\n" +" elif string1 < string2:\n" +" return 1\n" +" else:\n" +" return -1\n" +"\n" +"con = sqlite3.connect(\":memory:\")\n" +"con.create_collation(\"reverse\", collate_reverse)\n" +"\n" +"cur = con.execute(\"CREATE TABLE test(x)\")\n" +"cur.executemany(\"INSERT INTO test(x) VALUES(?)\", [(\"a\",), (\"b\",)])\n" +"cur.execute(\"SELECT x FROM test ORDER BY x COLLATE reverse\")\n" +"for row in cur:\n" +" print(row)\n" +"con.close()" msgid "Remove a collation function by setting *callable* to ``None``." msgstr "" @@ -1021,16 +1043,16 @@ msgstr "" msgid "" "Call this method from a different thread to abort any queries that might be " -"executing on the connection. Aborted queries will raise an :exc:" -"`OperationalError`." +"executing on the connection. Aborted queries will raise " +"an :exc:`OperationalError`." msgstr "" msgid "" "Register :term:`callable` *authorizer_callback* to be invoked for each " "attempt to access a column of a table in the database. The callback should " -"return one of :const:`SQLITE_OK`, :const:`SQLITE_DENY`, or :const:" -"`SQLITE_IGNORE` to signal how access to the column should be handled by the " -"underlying SQLite library." +"return one of :const:`SQLITE_OK`, :const:`SQLITE_DENY`, " +"or :const:`SQLITE_IGNORE` to signal how access to the column should be " +"handled by the underlying SQLite library." msgstr "" msgid "" @@ -1091,10 +1113,11 @@ msgstr "" msgid "" "The only argument passed to the callback is the statement (as :class:`str`) " "that is being executed. The return value of the callback is ignored. Note " -"that the backend does not only run statements passed to the :meth:`Cursor." -"execute` methods. Other sources include the :ref:`transaction management " -"` of the :mod:`!sqlite3` module and the " -"execution of triggers defined in the current database." +"that the backend does not only run statements passed to " +"the :meth:`Cursor.execute` methods. Other sources include " +"the :ref:`transaction management ` of " +"the :mod:`!sqlite3` module and the execution of triggers defined in the " +"current database." msgstr "" msgid "Passing ``None`` as *trace_callback* will disable the trace callback." @@ -1123,8 +1146,8 @@ msgid "" "The :mod:`!sqlite3` module is not built with loadable extension support by " "default, because some platforms (notably macOS) have SQLite libraries which " "are compiled without this feature. To get loadable extension support, you " -"must pass the :option:`--enable-loadable-sqlite-extensions` option to :" -"program:`configure`." +"must pass the :option:`--enable-loadable-sqlite-extensions` option " +"to :program:`configure`." msgstr "" msgid "" @@ -1191,8 +1214,8 @@ msgstr "" msgid "" "Return an :term:`iterator` to dump the database as SQL source code. Useful " -"when saving an in-memory database for later restoration. Similar to the ``." -"dump`` command in the :program:`sqlite3` shell." +"when saving an in-memory database for later restoration. Similar to the " +"``.dump`` command in the :program:`sqlite3` shell." msgstr "" msgid "" @@ -1286,8 +1309,8 @@ msgid "If *category* is not recognised by the underlying SQLite library." msgstr "" msgid "" -"Example, query the maximum length of an SQL statement for :class:" -"`Connection` ``con`` (the default is 1000000000):" +"Example, query the maximum length of an SQL statement " +"for :class:`Connection` ``con`` (the default is 1000000000):" msgstr "" msgid "" @@ -1358,10 +1381,10 @@ msgid "" msgstr "" msgid "" -"Deserialize a :meth:`serialized ` database into a :class:" -"`Connection`. This method causes the database connection to disconnect from " -"database *name*, and reopen *name* as an in-memory database based on the " -"serialization contained in *data*." +"Deserialize a :meth:`serialized ` database into " +"a :class:`Connection`. This method causes the database connection to " +"disconnect from database *name*, and reopen *name* as an in-memory database " +"based on the serialization contained in *data*." msgstr "" msgid "A serialized database." @@ -1392,17 +1415,17 @@ msgid "" msgstr "" msgid "" -"``False``: Select :pep:`249`-compliant transaction behaviour, implying that :" -"mod:`!sqlite3` ensures a transaction is always open. Use :meth:`commit` and :" -"meth:`rollback` to close transactions." +"``False``: Select :pep:`249`-compliant transaction behaviour, implying " +"that :mod:`!sqlite3` ensures a transaction is always open. " +"Use :meth:`commit` and :meth:`rollback` to close transactions." msgstr "" msgid "This is the recommended value of :attr:`!autocommit`." msgstr "" msgid "" -"``True``: Use SQLite's `autocommit mode`_. :meth:`commit` and :meth:" -"`rollback` have no effect in this mode." +"``True``: Use SQLite's `autocommit mode`_. :meth:`commit` " +"and :meth:`rollback` have no effect in this mode." msgstr "" msgid "" @@ -1422,8 +1445,8 @@ msgid "See :ref:`sqlite3-transaction-control-autocommit` for more details." msgstr "" msgid "" -"The :attr:`isolation_level` attribute has no effect unless :attr:" -"`autocommit` is :data:`LEGACY_TRANSACTION_CONTROL`." +"The :attr:`isolation_level` attribute has no effect " +"unless :attr:`autocommit` is :data:`LEGACY_TRANSACTION_CONTROL`." msgstr "" msgid "" @@ -1459,15 +1482,18 @@ msgstr "" msgid "" "The initial :attr:`~Cursor.row_factory` for :class:`Cursor` objects created " -"from this connection. Assigning to this attribute does not affect the :attr:" -"`!row_factory` of existing cursors belonging to this connection, only new " -"ones. Is ``None`` by default, meaning each row is returned as a :class:" -"`tuple`." +"from this connection. Assigning to this attribute does not affect " +"the :attr:`!row_factory` of existing cursors belonging to this connection, " +"only new ones. Is ``None`` by default, meaning each row is returned as " +"a :class:`tuple`." msgstr "" msgid "See :ref:`sqlite3-howto-row-factory` for more details." msgstr "" +msgid "Deleting the ``row_factory`` attribute is no longer allowed." +msgstr "" + msgid "" "A :term:`callable` that accepts a :class:`bytes` parameter and returns a " "text representation of it. The callable is invoked for SQLite values with " @@ -1477,6 +1503,9 @@ msgstr "" msgid "See :ref:`sqlite3-howto-encoding` for more details." msgstr "" +msgid "Deleting the ``text_factory`` attribute is no longer allowed." +msgstr "" + msgid "" "Return the total number of database rows that have been modified, inserted, " "or deleted since the database connection was opened." @@ -1488,14 +1517,14 @@ msgstr "" msgid "" "A ``Cursor`` object represents a `database cursor`_ which is used to execute " "SQL statements, and manage the context of a fetch operation. Cursors are " -"created using :meth:`Connection.cursor`, or by using any of the :ref:" -"`connection shortcut methods `." +"created using :meth:`Connection.cursor`, or by using any of " +"the :ref:`connection shortcut methods `." msgstr "" msgid "" -"Cursor objects are :term:`iterators `, meaning that if you :meth:" -"`~Cursor.execute` a ``SELECT`` query, you can simply iterate over the cursor " -"to fetch the resulting rows:" +"Cursor objects are :term:`iterators `, meaning that if " +"you :meth:`~Cursor.execute` a ``SELECT`` query, you can simply iterate over " +"the cursor to fetch the resulting rows:" msgstr "" msgid "" @@ -1507,8 +1536,8 @@ msgid "A :class:`Cursor` instance has the following attributes and methods." msgstr "" msgid "" -"Execute a single SQL statement, optionally binding Python values using :ref:" -"`placeholders `." +"Execute a single SQL statement, optionally binding Python values " +"using :ref:`placeholders `." msgstr "" msgid "A single SQL statement." @@ -1524,17 +1553,18 @@ msgid "If *sql* contains more than one SQL statement." msgstr "" msgid "" -"If :attr:`~Connection.autocommit` is :data:`LEGACY_TRANSACTION_CONTROL`, :" -"attr:`~Connection.isolation_level` is not ``None``, *sql* is an ``INSERT``, " -"``UPDATE``, ``DELETE``, or ``REPLACE`` statement, and there is no open " -"transaction, a transaction is implicitly opened before executing *sql*." +"If :attr:`~Connection.autocommit` " +"is :data:`LEGACY_TRANSACTION_CONTROL`, :attr:`~Connection.isolation_level` " +"is not ``None``, *sql* is an ``INSERT``, ``UPDATE``, ``DELETE``, or " +"``REPLACE`` statement, and there is no open transaction, a transaction is " +"implicitly opened before executing *sql*." msgstr "" msgid "" ":exc:`DeprecationWarning` is emitted if :ref:`named placeholders ` are used and *parameters* is a sequence instead of a :class:" -"`dict`. Starting with Python 3.14, :exc:`ProgrammingError` will be raised " -"instead." +"placeholders>` are used and *parameters* is a sequence instead of " +"a :class:`dict`. Starting with Python 3.14, :exc:`ProgrammingError` will be " +"raised instead." msgstr "" msgid "Use :meth:`executescript` to execute multiple SQL statements." @@ -1583,11 +1613,11 @@ msgid "" msgstr "" msgid "" -"Execute the SQL statements in *sql_script*. If the :attr:`~Connection." -"autocommit` is :data:`LEGACY_TRANSACTION_CONTROL` and there is a pending " -"transaction, an implicit ``COMMIT`` statement is executed first. No other " -"implicit transaction control is performed; any transaction control must be " -"added to *sql_script*." +"Execute the SQL statements in *sql_script*. If " +"the :attr:`~Connection.autocommit` is :data:`LEGACY_TRANSACTION_CONTROL` and " +"there is a pending transaction, an implicit ``COMMIT`` statement is executed " +"first. No other implicit transaction control is performed; any transaction " +"control must be added to *sql_script*." msgstr "" msgid "*sql_script* must be a :class:`string `." @@ -1629,6 +1659,9 @@ msgid "" "the same value from one :meth:`fetchmany` call to the next." msgstr "" +msgid "Negative *size* values are rejected by raising :exc:`ValueError`." +msgstr "" + msgid "" "Return all (remaining) rows of a query result as a :class:`list`. Return an " "empty list if no rows are available. Note that the :attr:`arraysize` " @@ -1639,25 +1672,28 @@ msgid "Close the cursor now (rather than whenever ``__del__`` is called)." msgstr "" msgid "" -"The cursor will be unusable from this point forward; a :exc:" -"`ProgrammingError` exception will be raised if any operation is attempted " -"with the cursor." +"The cursor will be unusable from this point forward; " +"a :exc:`ProgrammingError` exception will be raised if any operation is " +"attempted with the cursor." msgstr "" msgid "Required by the DB-API. Does nothing in :mod:`!sqlite3`." msgstr "" msgid "" -"Read/write attribute that controls the number of rows returned by :meth:" -"`fetchmany`. The default value is 1 which means a single row would be " -"fetched per call." +"Read/write attribute that controls the number of rows returned " +"by :meth:`fetchmany`. The default value is 1 which means a single row would " +"be fetched per call." +msgstr "" + +msgid "Negative values are rejected by raising :exc:`ValueError`." msgstr "" msgid "" "Read-only attribute that provides the SQLite database :class:`Connection` " -"belonging to the cursor. A :class:`Cursor` object created by calling :meth:" -"`con.cursor() ` will have a :attr:`connection` attribute " -"that refers to *con*:" +"belonging to the cursor. A :class:`Cursor` object created by " +"calling :meth:`con.cursor() ` will have " +"a :attr:`connection` attribute that refers to *con*:" msgstr "" msgid "" @@ -1711,18 +1747,18 @@ msgstr "" msgid "" "Defaults to what :attr:`Connection.row_factory` was set to when the :class:`!" -"Cursor` was created. Assigning to this attribute does not affect :attr:" -"`Connection.row_factory` of the parent connection." +"Cursor` was created. Assigning to this attribute does not " +"affect :attr:`Connection.row_factory` of the parent connection." msgstr "" msgid "Row objects" msgstr "" msgid "" -"A :class:`!Row` instance serves as a highly optimized :attr:`~Connection." -"row_factory` for :class:`Connection` objects. It supports iteration, " -"equality testing, :func:`len`, and :term:`mapping` access by column name and " -"index." +"A :class:`!Row` instance serves as a highly " +"optimized :attr:`~Connection.row_factory` for :class:`Connection` objects. " +"It supports iteration, equality testing, :func:`len`, and :term:`mapping` " +"access by column name and index." msgstr "" msgid "" @@ -1732,8 +1768,8 @@ msgstr "" msgid "" "Return a :class:`list` of column names as :class:`strings `. " -"Immediately after a query, it is the first member of each tuple in :attr:" -"`Cursor.description`." +"Immediately after a query, it is the first member of each tuple " +"in :attr:`Cursor.description`." msgstr "" msgid "Added support of slicing." @@ -1744,9 +1780,9 @@ msgstr "" msgid "" "A :class:`Blob` instance is a :term:`file-like object` that can read and " -"write data in an SQLite :abbr:`BLOB (Binary Large OBject)`. Call :func:" -"`len(blob) ` to get the size (number of bytes) of the blob. Use indices " -"and :term:`slices ` for direct access to the blob data." +"write data in an SQLite :abbr:`BLOB (Binary Large OBject)`. " +"Call :func:`len(blob) ` to get the size (number of bytes) of the blob. " +"Use indices and :term:`slices ` for direct access to the blob data." msgstr "" msgid "" @@ -1779,22 +1815,22 @@ msgid "Close the blob." msgstr "" msgid "" -"The blob will be unusable from this point onward. An :class:`~sqlite3." -"Error` (or subclass) exception will be raised if any further operation is " -"attempted with the blob." +"The blob will be unusable from this point onward. " +"An :class:`~sqlite3.Error` (or subclass) exception will be raised if any " +"further operation is attempted with the blob." msgstr "" msgid "" "Read *length* bytes of data from the blob at the current offset position. If " "the end of the blob is reached, the data up to :abbr:`EOF (End of File)` " -"will be returned. When *length* is not specified, or is negative, :meth:" -"`~Blob.read` will read until the end of the blob." +"will be returned. When *length* is not specified, or is " +"negative, :meth:`~Blob.read` will read until the end of the blob." msgstr "" msgid "" "Write *data* to the blob at the current offset. This function cannot change " -"the blob length. Writing beyond the end of the blob will raise :exc:" -"`ValueError`." +"the blob length. Writing beyond the end of the blob will " +"raise :exc:`ValueError`." msgstr "" msgid "Return the current access position of the blob." @@ -1841,8 +1877,8 @@ msgid "" msgstr "" msgid "" -"The numeric error code from the `SQLite API `_" +"The numeric error code from the `SQLite API `_" msgstr "" msgid "" @@ -1890,8 +1926,8 @@ msgstr "" msgid "" "Exception raised for :mod:`!sqlite3` API programming errors, for example " "supplying the wrong number of bindings to a query, or trying to operate on a " -"closed :class:`Connection`. ``ProgrammingError`` is a subclass of :exc:" -"`DatabaseError`." +"closed :class:`Connection`. ``ProgrammingError`` is a subclass " +"of :exc:`DatabaseError`." msgstr "" msgid "" @@ -1987,8 +2023,8 @@ msgid "" msgstr "" msgid "" -"A converter for :ref:`declared ` \"date\" types to :" -"class:`datetime.date` objects." +"A converter for :ref:`declared ` \"date\" types " +"to :class:`datetime.date` objects." msgstr "" msgid "" @@ -2005,7 +2041,7 @@ msgid "" msgstr "" msgid "Command-line interface" -msgstr "" +msgstr "Interfejs wiersza poleceń" msgid "" "The :mod:`!sqlite3` module can be invoked as a script, using the " @@ -2207,8 +2243,8 @@ msgid "Explicit: set *detect_types* to :const:`PARSE_COLNAMES`" msgstr "" msgid "" -"Both: set *detect_types* to ``sqlite3.PARSE_DECLTYPES | sqlite3." -"PARSE_COLNAMES``. Column names take precedence over declared types." +"Both: set *detect_types* to ``sqlite3.PARSE_DECLTYPES | " +"sqlite3.PARSE_COLNAMES``. Column names take precedence over declared types." msgstr "" msgid "The following example illustrates the implicit and explicit approaches:" @@ -2262,7 +2298,7 @@ msgid "This section shows recipes for common adapters and converters." msgstr "" msgid "" -"import datetime\n" +"import datetime as dt\n" "import sqlite3\n" "\n" "def adapt_date_iso(val):\n" @@ -2271,27 +2307,27 @@ msgid "" "\n" "def adapt_datetime_iso(val):\n" " \"\"\"Adapt datetime.datetime to timezone-naive ISO 8601 date.\"\"\"\n" -" return val.isoformat()\n" +" return val.replace(tzinfo=None).isoformat()\n" "\n" "def adapt_datetime_epoch(val):\n" " \"\"\"Adapt datetime.datetime to Unix timestamp.\"\"\"\n" " return int(val.timestamp())\n" "\n" -"sqlite3.register_adapter(datetime.date, adapt_date_iso)\n" -"sqlite3.register_adapter(datetime.datetime, adapt_datetime_iso)\n" -"sqlite3.register_adapter(datetime.datetime, adapt_datetime_epoch)\n" +"sqlite3.register_adapter(dt.date, adapt_date_iso)\n" +"sqlite3.register_adapter(dt.datetime, adapt_datetime_iso)\n" +"sqlite3.register_adapter(dt.datetime, adapt_datetime_epoch)\n" "\n" "def convert_date(val):\n" " \"\"\"Convert ISO 8601 date to datetime.date object.\"\"\"\n" -" return datetime.date.fromisoformat(val.decode())\n" +" return dt.date.fromisoformat(val.decode())\n" "\n" "def convert_datetime(val):\n" " \"\"\"Convert ISO 8601 datetime to datetime.datetime object.\"\"\"\n" -" return datetime.datetime.fromisoformat(val.decode())\n" +" return dt.datetime.fromisoformat(val.decode())\n" "\n" "def convert_timestamp(val):\n" " \"\"\"Convert Unix epoch timestamp to datetime.datetime object.\"\"\"\n" -" return datetime.datetime.fromtimestamp(int(val))\n" +" return dt.datetime.fromtimestamp(int(val))\n" "\n" "sqlite3.register_converter(\"date\", convert_date)\n" "sqlite3.register_converter(\"datetime\", convert_datetime)\n" @@ -2302,14 +2338,14 @@ msgid "How to use connection shortcut methods" msgstr "" msgid "" -"Using the :meth:`~Connection.execute`, :meth:`~Connection.executemany`, and :" -"meth:`~Connection.executescript` methods of the :class:`Connection` class, " -"your code can be written more concisely because you don't have to create the " -"(often superfluous) :class:`Cursor` objects explicitly. Instead, the :class:" -"`Cursor` objects are created implicitly and these shortcut methods return " -"the cursor objects. This way, you can execute a ``SELECT`` statement and " -"iterate over it directly using only a single call on the :class:`Connection` " -"object." +"Using the :meth:`~Connection.execute`, :meth:`~Connection.executemany`, " +"and :meth:`~Connection.executescript` methods of the :class:`Connection` " +"class, your code can be written more concisely because you don't have to " +"create the (often superfluous) :class:`Cursor` objects explicitly. Instead, " +"the :class:`Cursor` objects are created implicitly and these shortcut " +"methods return the cursor objects. This way, you can execute a ``SELECT`` " +"statement and iterate over it directly using only a single call on " +"the :class:`Connection` object." msgstr "" msgid "" @@ -2357,14 +2393,14 @@ msgstr "" msgid "" "The context manager neither implicitly opens a new transaction nor closes " -"the connection. If you need a closing context manager, consider using :meth:" -"`contextlib.closing`." +"the connection. If you need a closing context manager, consider " +"using :meth:`contextlib.closing`." msgstr "" msgid "" "con = sqlite3.connect(\":memory:\")\n" -"con.execute(\"CREATE TABLE lang(id INTEGER PRIMARY KEY, name VARCHAR " -"UNIQUE)\")\n" +"con.execute(\"CREATE TABLE lang(id INTEGER PRIMARY KEY, name VARCHAR UNIQUE)" +"\")\n" "\n" "# Successful, con.commit() is called automatically afterwards\n" "with con:\n" @@ -2438,16 +2474,16 @@ msgid "How to create and use row factories" msgstr "" msgid "" -"By default, :mod:`!sqlite3` represents each row as a :class:`tuple`. If a :" -"class:`!tuple` does not suit your needs, you can use the :class:`sqlite3." -"Row` class or a custom :attr:`~Cursor.row_factory`." +"By default, :mod:`!sqlite3` represents each row as a :class:`tuple`. If " +"a :class:`!tuple` does not suit your needs, you can use " +"the :class:`sqlite3.Row` class or a custom :attr:`~Cursor.row_factory`." msgstr "" msgid "" -"While :attr:`!row_factory` exists as an attribute both on the :class:" -"`Cursor` and the :class:`Connection`, it is recommended to set :class:" -"`Connection.row_factory`, so all cursors created from the connection will " -"use the same row factory." +"While :attr:`!row_factory` exists as an attribute both on " +"the :class:`Cursor` and the :class:`Connection`, it is recommended to " +"set :class:`Connection.row_factory`, so all cursors created from the " +"connection will use the same row factory." msgstr "" msgid "" @@ -2542,9 +2578,9 @@ msgid "" msgstr "" msgid "" -"With some adjustments, the above recipe can be adapted to use a :class:" -"`~dataclasses.dataclass`, or any other custom class, instead of a :class:" -"`~collections.namedtuple`." +"With some adjustments, the above recipe can be adapted to use " +"a :class:`~dataclasses.dataclass`, or any other custom class, instead of " +"a :class:`~collections.namedtuple`." msgstr "" msgid "How to handle non-UTF-8 text encodings" @@ -2553,8 +2589,8 @@ msgstr "" msgid "" "By default, :mod:`!sqlite3` uses :class:`str` to adapt SQLite values with " "the ``TEXT`` data type. This works well for UTF-8 encoded text, but it might " -"fail for other encodings and invalid UTF-8. You can use a custom :attr:" -"`~Connection.text_factory` to handle such cases." +"fail for other encodings and invalid UTF-8. You can use a " +"custom :attr:`~Connection.text_factory` to handle such cases." msgstr "" msgid "" @@ -2562,9 +2598,9 @@ msgid "" "table columns with the ``TEXT`` data type containing non-UTF-8 encodings, or " "even arbitrary data. To demonstrate, let's assume we have a database with " "ISO-8859-2 (Latin-2) encoded text, for example a table of Czech-English " -"dictionary entries. Assuming we now have a :class:`Connection` instance :py:" -"data:`!con` connected to this database, we can decode the Latin-2 encoded " -"text using this :attr:`~Connection.text_factory`:" +"dictionary entries. Assuming we now have a :class:`Connection` " +"instance :py:data:`!con` connected to this database, we can decode the " +"Latin-2 encoded text using this :attr:`~Connection.text_factory`:" msgstr "" msgid "con.text_factory = lambda data: str(data, encoding=\"latin2\")" @@ -2603,9 +2639,9 @@ msgid "Transaction control via the ``autocommit`` attribute" msgstr "" msgid "" -"The recommended way of controlling transaction behaviour is through the :" -"attr:`Connection.autocommit` attribute, which should preferably be set using " -"the *autocommit* parameter of :func:`connect`." +"The recommended way of controlling transaction behaviour is through " +"the :attr:`Connection.autocommit` attribute, which should preferably be set " +"using the *autocommit* parameter of :func:`connect`." msgstr "" msgid "" @@ -2614,11 +2650,11 @@ msgid "" msgstr "" msgid "" -":mod:`!sqlite3` ensures that a transaction is always open, so :func:" -"`connect`, :meth:`Connection.commit`, and :meth:`Connection.rollback` will " -"implicitly open a new transaction (immediately after closing the pending " -"one, for the latter two). :mod:`!sqlite3` uses ``BEGIN DEFERRED`` statements " -"when opening transactions." +":mod:`!sqlite3` ensures that a transaction is always open, " +"so :func:`connect`, :meth:`Connection.commit`, " +"and :meth:`Connection.rollback` will implicitly open a new transaction " +"(immediately after closing the pending one, for the latter two). :mod:`!" +"sqlite3` uses ``BEGIN DEFERRED`` statements when opening transactions." msgstr "" msgid "Transactions should be committed explicitly using :meth:`!commit`." @@ -2628,51 +2664,52 @@ msgid "Transactions should be rolled back explicitly using :meth:`!rollback`." msgstr "" msgid "" -"An implicit rollback is performed if the database is :meth:`~Connection." -"close`-ed with pending changes." +"An implicit rollback is performed if the database " +"is :meth:`~Connection.close`-ed with pending changes." msgstr "" msgid "" "Set *autocommit* to ``True`` to enable SQLite's `autocommit mode`_. In this " "mode, :meth:`Connection.commit` and :meth:`Connection.rollback` have no " "effect. Note that SQLite's autocommit mode is distinct from the :pep:`249`-" -"compliant :attr:`Connection.autocommit` attribute; use :attr:`Connection." -"in_transaction` to query the low-level SQLite autocommit mode." +"compliant :attr:`Connection.autocommit` attribute; " +"use :attr:`Connection.in_transaction` to query the low-level SQLite " +"autocommit mode." msgstr "" msgid "" "Set *autocommit* to :data:`LEGACY_TRANSACTION_CONTROL` to leave transaction " -"control behaviour to the :attr:`Connection.isolation_level` attribute. See :" -"ref:`sqlite3-transaction-control-isolation-level` for more information." +"control behaviour to the :attr:`Connection.isolation_level` attribute. " +"See :ref:`sqlite3-transaction-control-isolation-level` for more information." msgstr "" msgid "Transaction control via the ``isolation_level`` attribute" msgstr "" msgid "" -"The recommended way of controlling transactions is via the :attr:" -"`~Connection.autocommit` attribute. See :ref:`sqlite3-transaction-control-" -"autocommit`." +"The recommended way of controlling transactions is via " +"the :attr:`~Connection.autocommit` attribute. See :ref:`sqlite3-transaction-" +"control-autocommit`." msgstr "" msgid "" -"If :attr:`Connection.autocommit` is set to :data:" -"`LEGACY_TRANSACTION_CONTROL` (the default), transaction behaviour is " -"controlled using the :attr:`Connection.isolation_level` attribute. " +"If :attr:`Connection.autocommit` is set " +"to :data:`LEGACY_TRANSACTION_CONTROL` (the default), transaction behaviour " +"is controlled using the :attr:`Connection.isolation_level` attribute. " "Otherwise, :attr:`!isolation_level` has no effect." msgstr "" msgid "" "If the connection attribute :attr:`~Connection.isolation_level` is not " -"``None``, new transactions are implicitly opened before :meth:`~Cursor." -"execute` and :meth:`~Cursor.executemany` executes ``INSERT``, ``UPDATE``, " -"``DELETE``, or ``REPLACE`` statements; for other statements, no implicit " -"transaction handling is performed. Use the :meth:`~Connection.commit` and :" -"meth:`~Connection.rollback` methods to respectively commit and roll back " -"pending transactions. You can choose the underlying `SQLite transaction " -"behaviour`_ — that is, whether and what type of ``BEGIN`` statements :mod:`!" -"sqlite3` implicitly executes – via the :attr:`~Connection.isolation_level` " -"attribute." +"``None``, new transactions are implicitly opened " +"before :meth:`~Cursor.execute` and :meth:`~Cursor.executemany` executes " +"``INSERT``, ``UPDATE``, ``DELETE``, or ``REPLACE`` statements; for other " +"statements, no implicit transaction handling is performed. Use " +"the :meth:`~Connection.commit` and :meth:`~Connection.rollback` methods to " +"respectively commit and roll back pending transactions. You can choose the " +"underlying `SQLite transaction behaviour`_ — that is, whether and what type " +"of ``BEGIN`` statements :mod:`!sqlite3` implicitly executes – via " +"the :attr:`~Connection.isolation_level` attribute." msgstr "" msgid "" @@ -2680,8 +2717,8 @@ msgid "" "are implicitly opened at all. This leaves the underlying SQLite library in " "`autocommit mode`_, but also allows the user to perform their own " "transaction handling using explicit SQL statements. The underlying SQLite " -"library autocommit mode can be queried using the :attr:`~Connection." -"in_transaction` attribute." +"library autocommit mode can be queried using " +"the :attr:`~Connection.in_transaction` attribute." msgstr "" msgid "" @@ -2696,8 +2733,8 @@ msgid "" msgstr "" msgid "" -"The recommended way of controlling transactions is now via the :attr:" -"`~Connection.autocommit` attribute." +"The recommended way of controlling transactions is now via " +"the :attr:`~Connection.autocommit` attribute." msgstr "" msgid "? (question mark)" diff --git a/library/ssl.po b/library/ssl.po index e613c644d2..8ff8167c39 100644 --- a/library/ssl.po +++ b/library/ssl.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 +27,7 @@ msgid ":mod:`!ssl` --- TLS/SSL wrapper for socket objects" msgstr "" msgid "**Source code:** :source:`Lib/ssl.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/ssl.py`" msgid "" "This module provides access to Transport Layer Security (often known as " @@ -74,8 +71,8 @@ msgid "" "also encrypts and decrypts the data going over the socket with SSL. It " "supports additional methods such as :meth:`getpeercert`, which retrieves the " "certificate of the other side of the connection, :meth:`cipher`, which " -"retrieves the cipher being used for the secure connection or :meth:" -"`get_verified_chain`, :meth:`get_unverified_chain` which retrieves " +"retrieves the cipher being used for the secure connection " +"or :meth:`get_verified_chain`, :meth:`get_unverified_chain` which retrieves " "certificate chain." msgstr "" @@ -102,16 +99,17 @@ msgid "" "Use of deprecated constants and functions result in deprecation warnings." msgstr "" -msgid "Functions, Constants, and Exceptions" +msgid "Functions, constants, and exceptions" msgstr "" msgid "Socket creation" msgstr "" msgid "" -"Instances of :class:`SSLSocket` must be created using the :meth:`SSLContext." -"wrap_socket` method. The helper function :func:`create_default_context` " -"returns a new context with secure default settings." +"Instances of :class:`SSLSocket` must be created using " +"the :meth:`SSLContext.wrap_socket` method. The helper " +"function :func:`create_default_context` returns a new context with secure " +"default settings." msgstr "" msgid "Client socket example with default context and IPv4/IPv6 dual stack::" @@ -181,13 +179,13 @@ msgid "" msgstr "" msgid "" -"The settings are: :data:`PROTOCOL_TLS_CLIENT` or :data:" -"`PROTOCOL_TLS_SERVER`, :data:`OP_NO_SSLv2`, and :data:`OP_NO_SSLv3` with " -"high encryption cipher suites without RC4 and without unauthenticated cipher " -"suites. Passing :const:`~Purpose.SERVER_AUTH` as *purpose* sets :data:" -"`~SSLContext.verify_mode` to :data:`CERT_REQUIRED` and either loads CA " -"certificates (when at least one of *cafile*, *capath* or *cadata* is given) " -"or uses :meth:`SSLContext.load_default_certs` to load default CA " +"The settings are: :data:`PROTOCOL_TLS_CLIENT` " +"or :data:`PROTOCOL_TLS_SERVER`, :data:`OP_NO_SSLv2`, and :data:`OP_NO_SSLv3` " +"with high encryption cipher suites without RC4 and without unauthenticated " +"cipher suites. Passing :const:`~Purpose.SERVER_AUTH` as *purpose* " +"sets :data:`~SSLContext.verify_mode` to :data:`CERT_REQUIRED` and either " +"loads CA certificates (when at least one of *cafile*, *capath* or *cadata* " +"is given) or uses :meth:`SSLContext.load_default_certs` to load default CA " "certificates." msgstr "" @@ -198,10 +196,10 @@ msgid "" msgstr "" msgid "" -"The default settings for this context include :data:" -"`VERIFY_X509_PARTIAL_CHAIN` and :data:`VERIFY_X509_STRICT`. These make the " -"underlying OpenSSL implementation behave more like a conforming " -"implementation of :rfc:`5280`, in exchange for a small amount of " +"The default settings for this context " +"include :data:`VERIFY_X509_PARTIAL_CHAIN` and :data:`VERIFY_X509_STRICT`. " +"These make the underlying OpenSSL implementation behave more like a " +"conforming implementation of :rfc:`5280`, in exchange for a small amount of " "incompatibility with older X.509 certificates." msgstr "" @@ -212,8 +210,8 @@ msgid "" msgstr "" msgid "" -"If your application needs specific settings, you should create a :class:" -"`SSLContext` and apply the settings yourself." +"If your application needs specific settings, you should create " +"a :class:`SSLContext` and apply the settings yourself." msgstr "" msgid "" @@ -221,9 +219,9 @@ msgid "" "with a :class:`SSLContext` created by this function that they get an error " "stating \"Protocol or cipher suite mismatch\", it may be that they only " "support SSL3.0 which this function excludes using the :data:`OP_NO_SSLv3`. " -"SSL3.0 is widely considered to be `completely broken `_. If you still wish to continue to use this function but " -"still allow SSL 3.0 connections you can re-enable them using::" +"SSL3.0 is widely considered to be `completely broken `_. If you still wish to continue to use this " +"function but still allow SSL 3.0 connections you can re-enable them using::" msgstr "" msgid "" @@ -256,13 +254,14 @@ msgid "Support for key logging to :envvar:`SSLKEYLOGFILE` was added." msgstr "" msgid "" -"The context now uses :data:`PROTOCOL_TLS_CLIENT` or :data:" -"`PROTOCOL_TLS_SERVER` protocol instead of generic :data:`PROTOCOL_TLS`." +"The context now uses :data:`PROTOCOL_TLS_CLIENT` " +"or :data:`PROTOCOL_TLS_SERVER` protocol instead of " +"generic :data:`PROTOCOL_TLS`." msgstr "" msgid "" -"The context now uses :data:`VERIFY_X509_PARTIAL_CHAIN` and :data:" -"`VERIFY_X509_STRICT` in its default verify flags." +"The context now uses :data:`VERIFY_X509_PARTIAL_CHAIN` " +"and :data:`VERIFY_X509_STRICT` in its default verify flags." msgstr "" msgid "Exceptions" @@ -342,11 +341,11 @@ msgid "Random generation" msgstr "" msgid "" -"Return *num* cryptographically strong pseudo-random bytes. Raises an :class:" -"`SSLError` if the PRNG has not been seeded with enough data or if the " -"operation is not supported by the current RAND method. :func:`RAND_status` " -"can be used to check the status of the PRNG and :func:`RAND_add` can be used " -"to seed the PRNG." +"Return *num* cryptographically strong pseudo-random bytes. Raises " +"an :class:`SSLError` if the PRNG has not been seeded with enough data or if " +"the operation is not supported by the current RAND " +"method. :func:`RAND_status` can be used to check the status of the PRNG " +"and :func:`RAND_add` can be used to seed the PRNG." msgstr "" msgid "For almost all applications :func:`os.urandom` is preferable." @@ -361,9 +360,9 @@ msgstr "" msgid "" "Return ``True`` if the SSL pseudo-random number generator has been seeded " -"with 'enough' randomness, and ``False`` otherwise. You can use :func:`ssl." -"RAND_egd` and :func:`ssl.RAND_add` to increase the randomness of the pseudo-" -"random number generator." +"with 'enough' randomness, and ``False`` otherwise. You can " +"use :func:`ssl.RAND_egd` and :func:`ssl.RAND_add` to increase the randomness " +"of the pseudo-random number generator." msgstr "" msgid "" @@ -380,7 +379,7 @@ msgid "Certificate handling" msgstr "" msgid "" -"Return the time in seconds since the Epoch, given the ``cert_time`` string " +"Return the time in seconds since the epoch, given the ``cert_time`` string " "representing the \"notBefore\" or \"notAfter\" date from a certificate in " "``\"%b %d %H:%M:%S %Y %Z\"`` strptime format (C locale)." msgstr "" @@ -390,12 +389,12 @@ msgstr "" msgid "" ">>> import ssl\n" +">>> import datetime as dt\n" ">>> timestamp = ssl.cert_time_to_seconds(\"Jan 5 09:34:43 2018 GMT\")\n" ">>> timestamp\n" "1515144883\n" -">>> from datetime import datetime\n" -">>> print(datetime.utcfromtimestamp(timestamp))\n" -"2018-01-05 09:34:43" +">>> print(dt.datetime.fromtimestamp(timestamp, dt.UTC))\n" +"2018-01-05 09:34:43+00:00" msgstr "" msgid "\"notBefore\" or \"notAfter\" dates must use GMT (:rfc:`5280`)." @@ -413,19 +412,19 @@ msgid "" "PEM-encoded string. If ``ssl_version`` is specified, uses that version of " "the SSL protocol to attempt to connect to the server. If *ca_certs* is " "specified, it should be a file containing a list of root certificates, the " -"same format as used for the *cafile* parameter in :meth:`SSLContext." -"load_verify_locations`. The call will attempt to validate the server " -"certificate against that set of root certificates, and will fail if the " -"validation attempt fails. A timeout can be specified with the ``timeout`` " -"parameter." +"same format as used for the *cafile* parameter " +"in :meth:`SSLContext.load_verify_locations`. The call will attempt to " +"validate the server certificate against that set of root certificates, and " +"will fail if the validation attempt fails. A timeout can be specified with " +"the ``timeout`` parameter." msgstr "" msgid "This function is now IPv6-compatible." msgstr "" msgid "" -"The default *ssl_version* is changed from :data:`PROTOCOL_SSLv3` to :data:" -"`PROTOCOL_TLS` for maximum compatibility with modern servers." +"The default *ssl_version* is changed from :data:`PROTOCOL_SSLv3` " +"to :data:`PROTOCOL_TLS` for maximum compatibility with modern servers." msgstr "" msgid "The *timeout* parameter was added." @@ -481,10 +480,11 @@ msgstr "" msgid "" "The function returns a list of (cert_bytes, encoding_type, trust) tuples. " -"The encoding_type specifies the encoding of cert_bytes. It is either :const:" -"`x509_asn` for X.509 ASN.1 data or :const:`pkcs_7_asn` for PKCS#7 ASN.1 " -"data. Trust specifies the purpose of the certificate as a set of OIDS or " -"exactly ``True`` if the certificate is trustworthy for all purposes." +"The encoding_type specifies the encoding of cert_bytes. It is " +"either :const:`x509_asn` for X.509 ASN.1 data or :const:`pkcs_7_asn` for " +"PKCS#7 ASN.1 data. Trust specifies the purpose of the certificate as a set " +"of OIDS or exactly ``True`` if the certificate is trustworthy for all " +"purposes." msgstr "" msgid "Example::" @@ -506,8 +506,9 @@ msgstr "" msgid "" "The function returns a list of (cert_bytes, encoding_type, trust) tuples. " -"The encoding_type specifies the encoding of cert_bytes. It is either :const:" -"`x509_asn` for X.509 ASN.1 data or :const:`pkcs_7_asn` for PKCS#7 ASN.1 data." +"The encoding_type specifies the encoding of cert_bytes. It is " +"either :const:`x509_asn` for X.509 ASN.1 data or :const:`pkcs_7_asn` for " +"PKCS#7 ASN.1 data." msgstr "" msgid "Constants" @@ -519,10 +520,11 @@ msgid "" msgstr "" msgid "" -"Possible value for :attr:`SSLContext.verify_mode`. Except for :const:" -"`PROTOCOL_TLS_CLIENT`, it is the default mode. With client-side sockets, " -"just about any cert is accepted. Validation errors, such as untrusted or " -"expired cert, are ignored and do not abort the TLS/SSL handshake." +"Possible value for :attr:`SSLContext.verify_mode`. Except " +"for :const:`PROTOCOL_TLS_CLIENT`, it is the default mode. With client-side " +"sockets, just about any cert is accepted. Validation errors, such as " +"untrusted or expired cert, are ignored and do not abort the TLS/SSL " +"handshake." msgstr "" msgid "" @@ -534,9 +536,10 @@ msgid "See the discussion of :ref:`ssl-security` below." msgstr "" msgid "" -"Possible value for :attr:`SSLContext.verify_mode`. In client mode, :const:" -"`CERT_OPTIONAL` has the same meaning as :const:`CERT_REQUIRED`. It is " -"recommended to use :const:`CERT_REQUIRED` for client-side sockets instead." +"Possible value for :attr:`SSLContext.verify_mode`. In client " +"mode, :const:`CERT_OPTIONAL` has the same meaning as :const:`CERT_REQUIRED`. " +"It is recommended to use :const:`CERT_REQUIRED` for client-side sockets " +"instead." msgstr "" msgid "" @@ -548,19 +551,20 @@ msgid "" msgstr "" msgid "" -"Use of this setting requires a valid set of CA certificates to be passed to :" -"meth:`SSLContext.load_verify_locations`." +"Use of this setting requires a valid set of CA certificates to be passed " +"to :meth:`SSLContext.load_verify_locations`." msgstr "" msgid "" "Possible value for :attr:`SSLContext.verify_mode`. In this mode, " -"certificates are required from the other side of the socket connection; an :" -"class:`SSLError` will be raised if no certificate is provided, or if its " +"certificates are required from the other side of the socket connection; " +"an :class:`SSLError` will be raised if no certificate is provided, or if its " "validation fails. This mode is **not** sufficient to verify a certificate in " -"client mode as it does not match hostnames. :attr:`~SSLContext." -"check_hostname` must be enabled as well to verify the authenticity of a " -"cert. :const:`PROTOCOL_TLS_CLIENT` uses :const:`CERT_REQUIRED` and enables :" -"attr:`~SSLContext.check_hostname` by default." +"client mode as it does not match " +"hostnames. :attr:`~SSLContext.check_hostname` must be enabled as well to " +"verify the authenticity of a cert. :const:`PROTOCOL_TLS_CLIENT` " +"uses :const:`CERT_REQUIRED` and enables :attr:`~SSLContext.check_hostname` " +"by default." msgstr "" msgid "" @@ -582,8 +586,8 @@ msgid "" "Possible value for :attr:`SSLContext.verify_flags`. In this mode, only the " "peer cert is checked but none of the intermediate CA certificates. The mode " "requires a valid CRL that is signed by the peer cert's issuer (its direct " -"ancestor CA). If no proper CRL has been loaded with :attr:`SSLContext." -"load_verify_locations`, validation will fail." +"ancestor CA). If no proper CRL has been loaded " +"with :attr:`SSLContext.load_verify_locations`, validation will fail." msgstr "" msgid "" @@ -626,8 +630,8 @@ msgstr "" msgid "" "TLS clients and servers require different default settings for secure " -"communication. The generic TLS protocol constant is deprecated in favor of :" -"data:`PROTOCOL_TLS_CLIENT` and :data:`PROTOCOL_TLS_SERVER`." +"communication. The generic TLS protocol constant is deprecated in favor " +"of :data:`PROTOCOL_TLS_CLIENT` and :data:`PROTOCOL_TLS_SERVER`." msgstr "" msgid "" @@ -661,9 +665,9 @@ msgstr "" msgid "" "OpenSSL has deprecated all version specific protocols. Use the default " -"protocol :data:`PROTOCOL_TLS_SERVER` or :data:`PROTOCOL_TLS_CLIENT` with :" -"attr:`SSLContext.minimum_version` and :attr:`SSLContext.maximum_version` " -"instead." +"protocol :data:`PROTOCOL_TLS_SERVER` or :data:`PROTOCOL_TLS_CLIENT` " +"with :attr:`SSLContext.minimum_version` " +"and :attr:`SSLContext.maximum_version` instead." msgstr "" msgid "Selects TLS version 1.0 as the channel encryption protocol." @@ -713,8 +717,9 @@ msgid "" msgstr "" msgid "" -"The option is deprecated since OpenSSL 1.1.0, use the new :attr:`SSLContext." -"minimum_version` and :attr:`SSLContext.maximum_version` instead." +"The option is deprecated since OpenSSL 1.1.0, use the " +"new :attr:`SSLContext.minimum_version` " +"and :attr:`SSLContext.maximum_version` instead." msgstr "" msgid "" @@ -919,33 +924,34 @@ msgid "" msgstr "" msgid "" -"Used as the return value of the callback function in :meth:`SSLContext." -"set_servername_callback`." +"Used as the return value of the callback function " +"in :meth:`SSLContext.set_servername_callback`." msgstr "" msgid ":class:`enum.IntEnum` collection of ALERT_DESCRIPTION_* constants." msgstr "" msgid "" -"Option for :func:`create_default_context` and :meth:`SSLContext." -"load_default_certs`. This value indicates that the context may be used to " -"authenticate web servers (therefore, it will be used to create client-side " -"sockets)." +"Option for :func:`create_default_context` " +"and :meth:`SSLContext.load_default_certs`. This value indicates that the " +"context may be used to authenticate web servers (therefore, it will be used " +"to create client-side sockets)." msgstr "" msgid "" -"Option for :func:`create_default_context` and :meth:`SSLContext." -"load_default_certs`. This value indicates that the context may be used to " -"authenticate web clients (therefore, it will be used to create server-side " -"sockets)." +"Option for :func:`create_default_context` " +"and :meth:`SSLContext.load_default_certs`. This value indicates that the " +"context may be used to authenticate web clients (therefore, it will be used " +"to create server-side sockets)." msgstr "" msgid ":class:`enum.IntEnum` collection of SSL_ERROR_* constants." msgstr "" msgid "" -":class:`enum.IntEnum` collection of SSL and TLS versions for :attr:" -"`SSLContext.maximum_version` and :attr:`SSLContext.minimum_version`." +":class:`enum.IntEnum` collection of SSL and TLS versions " +"for :attr:`SSLContext.maximum_version` " +"and :attr:`SSLContext.minimum_version`." msgstr "" msgid "" @@ -958,11 +964,11 @@ msgid "SSL 3.0 to TLS 1.3." msgstr "" msgid "" -"All :class:`TLSVersion` members except :attr:`TLSVersion.TLSv1_2` and :attr:" -"`TLSVersion.TLSv1_3` are deprecated." +"All :class:`TLSVersion` members except :attr:`TLSVersion.TLSv1_2` " +"and :attr:`TLSVersion.TLSv1_3` are deprecated." msgstr "" -msgid "SSL Sockets" +msgid "SSL sockets" msgstr "" msgid "SSL sockets provide the following methods of :ref:`socket-objects`:" @@ -987,14 +993,12 @@ msgid ":meth:`~socket.socket.fileno`" msgstr ":meth:`~socket.socket.fileno`" msgid ":meth:`~socket.socket.getpeername`, :meth:`~socket.socket.getsockname`" -msgstr "" +msgstr ":meth:`~socket.socket.getpeername`, :meth:`~socket.socket.getsockname`" msgid ":meth:`~socket.socket.getsockopt`, :meth:`~socket.socket.setsockopt`" -msgstr "" +msgstr ":meth:`~socket.socket.getsockopt`, :meth:`~socket.socket.setsockopt`" -msgid "" -":meth:`~socket.socket.gettimeout`, :meth:`~socket.socket.settimeout`, :meth:" -"`~socket.socket.setblocking`" +msgid ":meth:`~socket.socket.gettimeout`, :meth:`~socket.socket.settimeout`, :meth:`~socket.socket.setblocking`" msgstr "" msgid ":meth:`~socket.socket.listen`" @@ -1029,8 +1033,8 @@ msgid "" msgstr "" msgid "" -"Instances of :class:`SSLSocket` must be created using the :meth:`SSLContext." -"wrap_socket` method." +"Instances of :class:`SSLSocket` must be created using " +"the :meth:`SSLContext.wrap_socket` method." msgstr "" msgid "The :meth:`sendfile` method was added." @@ -1043,14 +1047,15 @@ msgid "" msgstr "" msgid "" -"It is deprecated to create a :class:`SSLSocket` instance directly, use :meth:" -"`SSLContext.wrap_socket` to wrap a socket." +"It is deprecated to create a :class:`SSLSocket` instance directly, " +"use :meth:`SSLContext.wrap_socket` to wrap a socket." msgstr "" msgid "" -":class:`SSLSocket` instances must to created with :meth:`~SSLContext." -"wrap_socket`. In earlier versions, it was possible to create instances " -"directly. This was never documented or officially supported." +":class:`SSLSocket` instances must be created " +"with :meth:`~SSLContext.wrap_socket`. In earlier versions, it was possible " +"to create instances directly. This was never documented or officially " +"supported." msgstr "" msgid "" @@ -1069,8 +1074,8 @@ msgid "" msgstr "" msgid "" -"Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket is :" -"ref:`non-blocking ` and the read would block." +"Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket " +"is :ref:`non-blocking ` and the read would block." msgstr "" msgid "" @@ -1088,13 +1093,13 @@ msgid "Use :meth:`~SSLSocket.recv` instead of :meth:`~SSLSocket.read`." msgstr "" msgid "" -"Write *buf* to the SSL socket and return the number of bytes written. The " -"*buf* argument must be an object supporting the buffer interface." +"Write *data* to the SSL socket and return the number of bytes written. The " +"*data* argument must be an object supporting the buffer interface." msgstr "" msgid "" -"Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket is :" -"ref:`non-blocking ` and the write would block." +"Raise :exc:`SSLWantReadError` or :exc:`SSLWantWriteError` if the socket " +"is :ref:`non-blocking ` and the write would block." msgstr "" msgid "" @@ -1104,7 +1109,7 @@ msgstr "" msgid "" "The socket timeout is no longer reset each time bytes are received or sent. " -"The socket timeout is now the maximum total duration to write *buf*." +"The socket timeout is now the maximum total duration to write *data*." msgstr "" msgid "Use :meth:`~SSLSocket.send` instead of :meth:`~SSLSocket.write`." @@ -1114,22 +1119,29 @@ msgid "" "The :meth:`~SSLSocket.read` and :meth:`~SSLSocket.write` methods are the low-" "level methods that read and write unencrypted, application-level data and " "decrypt/encrypt it to encrypted, wire-level data. These methods require an " -"active SSL connection, i.e. the handshake was completed and :meth:`SSLSocket." -"unwrap` was not called." +"active SSL connection, i.e. the handshake was completed " +"and :meth:`SSLSocket.unwrap` was not called." msgstr "" msgid "" -"Normally you should use the socket API methods like :meth:`~socket.socket." -"recv` and :meth:`~socket.socket.send` instead of these methods." +"Normally you should use the socket API methods " +"like :meth:`~socket.socket.recv` and :meth:`~socket.socket.send` instead of " +"these methods." msgstr "" msgid "Perform the SSL setup handshake." msgstr "" msgid "" -"The handshake method also performs :func:`match_hostname` when the :attr:" -"`~SSLContext.check_hostname` attribute of the socket's :attr:`~SSLSocket." -"context` is true." +"If *block* is true and the timeout obtained " +"by :meth:`~socket.socket.gettimeout` is zero, the socket is set in blocking " +"mode until the handshake is performed." +msgstr "" + +msgid "" +"The handshake method also performs :func:`!match_hostname` when " +"the :attr:`~SSLContext.check_hostname` attribute of the " +"socket's :attr:`~SSLSocket.context` is true." msgstr "" msgid "" @@ -1138,16 +1150,16 @@ msgid "" msgstr "" msgid "" -"Hostname or IP address is matched by OpenSSL during handshake. The function :" -"func:`match_hostname` is no longer used. In case OpenSSL refuses a hostname " -"or IP address, the handshake is aborted early and a TLS alert message is " -"sent to the peer." +"Hostname or IP address is matched by OpenSSL during handshake. The " +"function :func:`!match_hostname` is no longer used. In case OpenSSL refuses " +"a hostname or IP address, the handshake is aborted early and a TLS alert " +"message is sent to the peer." msgstr "" msgid "" "If there is no certificate for the peer on the other end of the connection, " -"return ``None``. If the SSL handshake hasn't been done yet, raise :exc:" -"`ValueError`." +"return ``None``. If the SSL handshake hasn't been done yet, " +"raise :exc:`ValueError`." msgstr "" msgid "" @@ -1205,9 +1217,9 @@ msgstr "" msgid "" "for a server SSL socket, the client will only provide a certificate when " -"requested by the server; therefore :meth:`getpeercert` will return :const:" -"`None` if you used :const:`CERT_NONE` (rather than :const:`CERT_OPTIONAL` " -"or :const:`CERT_REQUIRED`)." +"requested by the server; therefore :meth:`getpeercert` will " +"return :const:`None` if you used :const:`CERT_NONE` (rather " +"than :const:`CERT_OPTIONAL` or :const:`CERT_REQUIRED`)." msgstr "" msgid "See also :attr:`SSLContext.check_hostname`." @@ -1272,16 +1284,17 @@ msgstr "" msgid "" "The *cb_type* parameter allow selection of the desired channel binding type. " "Valid channel binding types are listed in the :data:`CHANNEL_BINDING_TYPES` " -"list. Currently only the 'tls-unique' channel binding, defined by :rfc:" -"`5929`, is supported. :exc:`ValueError` will be raised if an unsupported " -"channel binding type is requested." +"list. Currently only the 'tls-unique' channel binding, defined " +"by :rfc:`5929`, is supported. :exc:`ValueError` will be raised if an " +"unsupported channel binding type is requested." msgstr "" msgid "" -"Return the protocol that was selected during the TLS handshake. If :meth:" -"`SSLContext.set_alpn_protocols` was not called, if the other party does not " -"support ALPN, if this socket does not support any of the client's proposed " -"protocols, or if the handshake has not happened yet, ``None`` is returned." +"Return the protocol that was selected during the TLS handshake. " +"If :meth:`SSLContext.set_alpn_protocols` was not called, if the other party " +"does not support ALPN, if this socket does not support any of the client's " +"proposed protocols, or if the handshake has not happened yet, ``None`` is " +"returned." msgstr "" msgid "" @@ -1305,8 +1318,8 @@ msgstr "" msgid "" "Requests post-handshake authentication (PHA) from a TLS 1.3 client. PHA can " "only be initiated for a TLS 1.3 connection from a server-side socket, after " -"the initial TLS handshake and with PHA enabled on both sides, see :attr:" -"`SSLContext.post_handshake_auth`." +"the initial TLS handshake and with PHA enabled on both sides, " +"see :attr:`SSLContext.post_handshake_auth`." msgstr "" msgid "" @@ -1316,8 +1329,8 @@ msgid "" msgstr "" msgid "" -"If any precondition isn't met (e.g. not TLS 1.3, PHA not enabled), an :exc:" -"`SSLError` is raised." +"If any precondition isn't met (e.g. not TLS 1.3, PHA not enabled), " +"an :exc:`SSLError` is raised." msgstr "" msgid "" @@ -1354,18 +1367,18 @@ msgstr "" msgid "" "The attribute is now always ASCII text. When ``server_hostname`` is an " "internationalized domain name (IDN), this attribute now stores the A-label " -"form (``\"xn--pythn-mua.org\"``), rather than the U-label form (``\"pythön." -"org\"``)." +"form (``\"xn--pythn-mua.org\"``), rather than the U-label form " +"(``\"pythön.org\"``)." msgstr "" msgid "" "The :class:`SSLSession` for this SSL connection. The session is available " "for client and server side sockets after the TLS handshake has been " -"performed. For client sockets the session can be set before :meth:" -"`~SSLSocket.do_handshake` has been called to reuse a session." +"performed. For client sockets the session can be set " +"before :meth:`~SSLSocket.do_handshake` has been called to reuse a session." msgstr "" -msgid "SSL Contexts" +msgid "SSL contexts" msgstr "" msgid "" @@ -1461,26 +1474,25 @@ msgid "" msgstr "" msgid "" -"The context is created with secure default values. The options :data:" -"`OP_NO_COMPRESSION`, :data:`OP_CIPHER_SERVER_PREFERENCE`, :data:" -"`OP_SINGLE_DH_USE`, :data:`OP_SINGLE_ECDH_USE`, :data:`OP_NO_SSLv2`, and :" -"data:`OP_NO_SSLv3` (except for :data:`PROTOCOL_SSLv3`) are set by default. " -"The initial cipher suite list contains only ``HIGH`` ciphers, no ``NULL`` " -"ciphers and no ``MD5`` ciphers." +"The context is created with secure default values. The " +"options :data:`OP_NO_COMPRESSION`, :data:`OP_CIPHER_SERVER_PREFERENCE`, :data:`OP_SINGLE_DH_USE`, :data:`OP_SINGLE_ECDH_USE`, :data:`OP_NO_SSLv2`, " +"and :data:`OP_NO_SSLv3` (except for :data:`PROTOCOL_SSLv3`) are set by " +"default. The initial cipher suite list contains only ``HIGH`` ciphers, no " +"``NULL`` ciphers and no ``MD5`` ciphers." msgstr "" msgid "" ":class:`SSLContext` without protocol argument is deprecated. The context " -"class will either require :data:`PROTOCOL_TLS_CLIENT` or :data:" -"`PROTOCOL_TLS_SERVER` protocol in the future." +"class will either require :data:`PROTOCOL_TLS_CLIENT` " +"or :data:`PROTOCOL_TLS_SERVER` protocol in the future." msgstr "" msgid "" "The default cipher suites now include only secure AES and ChaCha20 ciphers " "with forward secrecy and security level 2. RSA and DH keys with less than " -"2048 bits and ECC keys with less than 224 bits are prohibited. :data:" -"`PROTOCOL_TLS`, :data:`PROTOCOL_TLS_CLIENT`, and :data:`PROTOCOL_TLS_SERVER` " -"use TLS 1.2 as minimum TLS version." +"2048 bits and ECC keys with less than 224 bits are " +"prohibited. :data:`PROTOCOL_TLS`, :data:`PROTOCOL_TLS_CLIENT`, " +"and :data:`PROTOCOL_TLS_SERVER` use TLS 1.2 as minimum TLS version." msgstr "" msgid "" @@ -1553,9 +1565,9 @@ msgstr "" msgid "" "Load a set of default \"certification authority\" (CA) certificates from " "default locations. On Windows it loads CA certs from the ``CA`` and ``ROOT`` " -"system stores. On all systems it calls :meth:`SSLContext." -"set_default_verify_paths`. In the future the method may load CA certificates " -"from other locations, too." +"system stores. On all systems it " +"calls :meth:`SSLContext.set_default_verify_paths`. In the future the method " +"may load CA certificates from other locations, too." msgstr "" msgid "" @@ -1568,8 +1580,9 @@ msgstr "" msgid "" "Load a set of \"certification authority\" (CA) certificates used to validate " -"other peers' certificates when :data:`verify_mode` is other than :data:" -"`CERT_NONE`. At least one of *cafile* or *capath* must be specified." +"other peers' certificates when :data:`verify_mode` is other " +"than :data:`CERT_NONE`. At least one of *cafile* or *capath* must be " +"specified." msgstr "" msgid "" @@ -1615,8 +1628,8 @@ msgid "" msgstr "" msgid "" -"Get a list of enabled ciphers. The list is in order of cipher priority. See :" -"meth:`SSLContext.set_ciphers`." +"Get a list of enabled ciphers. The list is in order of cipher priority. " +"See :meth:`SSLContext.set_ciphers`." msgstr "" msgid "" @@ -1672,15 +1685,15 @@ msgid "" msgstr "" msgid "" -"TLS 1.3 cipher suites cannot be disabled with :meth:`~SSLContext." -"set_ciphers`." +"TLS 1.3 cipher suites cannot be disabled " +"with :meth:`~SSLContext.set_ciphers`." msgstr "" msgid "" "Specify which protocols the socket should advertise during the SSL/TLS " -"handshake. It should be a list of ASCII strings, like ``['http/1.1', " -"'spdy/2']``, ordered by preference. The selection of a protocol will happen " -"during the handshake, and will play out according to :rfc:`7301`. After a " +"handshake. It should be a list of ASCII strings, like ``['http/1.1', 'spdy/" +"2']``, ordered by preference. The selection of a protocol will happen during " +"the handshake, and will play out according to :rfc:`7301`. After a " "successful handshake, the :meth:`SSLSocket.selected_alpn_protocol` method " "will return the agreed-upon protocol." msgstr "" @@ -1696,9 +1709,9 @@ msgid "" "ordered by preference. The selection of a protocol will happen during the " "handshake, and will play out according to the `Application Layer Protocol " "Negotiation `_. After a successful handshake, the :meth:" -"`SSLSocket.selected_npn_protocol` method will return the agreed-upon " -"protocol." +"Layer_Protocol_Negotiation>`_. After a successful handshake, " +"the :meth:`SSLSocket.selected_npn_protocol` method will return the agreed-" +"upon protocol." msgstr "" msgid "" @@ -1730,34 +1743,41 @@ msgid "" msgstr "" msgid "" -"A typical use of this callback is to change the :class:`ssl.SSLSocket`'s :" -"attr:`SSLSocket.context` attribute to a new object of type :class:" -"`SSLContext` representing a certificate chain that matches the server name." +"A typical use of this callback is to change " +"the :class:`ssl.SSLSocket`'s :attr:`SSLSocket.context` attribute to a new " +"object of type :class:`SSLContext` representing a certificate chain that " +"matches the server name." +msgstr "" + +msgid "" +"If the callback assigns a new context to :attr:`SSLSocket.context`, any " +"further ClientHello message on the same connection (for example after a TLS " +"1.3 HelloRetryRequest) is dispatched to the new context's *sni_callback*, if " +"it has one; the original callback is not called again for that connection." msgstr "" msgid "" "Due to the early negotiation phase of the TLS connection, only limited " -"methods and attributes are usable like :meth:`SSLSocket." -"selected_alpn_protocol` and :attr:`SSLSocket.context`. The :meth:`SSLSocket." -"getpeercert`, :meth:`SSLSocket.get_verified_chain`, :meth:`SSLSocket." -"get_unverified_chain` :meth:`SSLSocket.cipher` and :meth:`SSLSocket." -"compression` methods require that the TLS connection has progressed beyond " -"the TLS Client Hello and therefore will not return meaningful values nor can " -"they be called safely." +"methods and attributes are usable " +"like :meth:`SSLSocket.selected_alpn_protocol` and :attr:`SSLSocket.context`. " +"The :meth:`SSLSocket.getpeercert`, :meth:`SSLSocket.get_verified_chain`, :meth:`SSLSocket.get_unverified_chain` :meth:`SSLSocket.cipher` " +"and :meth:`SSLSocket.compression` methods require that the TLS connection " +"has progressed beyond the TLS Client Hello and therefore will not return " +"meaningful values nor can they be called safely." msgstr "" msgid "" "The *sni_callback* function must return ``None`` to allow the TLS " -"negotiation to continue. If a TLS failure is required, a constant :const:" -"`ALERT_DESCRIPTION_* ` can be returned. " -"Other return values will result in a TLS fatal error with :const:" -"`ALERT_DESCRIPTION_INTERNAL_ERROR`." +"negotiation to continue. If a TLS failure is required, a " +"constant :const:`ALERT_DESCRIPTION_* ` can " +"be returned. Other return values will result in a TLS fatal error " +"with :const:`ALERT_DESCRIPTION_INTERNAL_ERROR`." msgstr "" msgid "" "If an exception is raised from the *sni_callback* function the TLS " -"connection will terminate with a fatal TLS alert message :const:" -"`ALERT_DESCRIPTION_HANDSHAKE_FAILURE`." +"connection will terminate with a fatal TLS alert " +"message :const:`ALERT_DESCRIPTION_HANDSHAKE_FAILURE`." msgstr "" msgid "" @@ -1765,6 +1785,12 @@ msgid "" "OPENSSL_NO_TLSEXT defined when it was built." msgstr "" +msgid "" +"After the callback assigns a new :attr:`SSLSocket.context`, later " +"ClientHello messages on the connection are dispatched to the new context's " +"*sni_callback*." +msgstr "" + msgid "" "This is a legacy API retained for backwards compatibility. When possible, " "you should use :attr:`sni_callback` instead. The given " @@ -1788,8 +1814,8 @@ msgid "" msgstr "" msgid "" -"This setting doesn't apply to client sockets. You can also use the :data:" -"`OP_SINGLE_DH_USE` option to further improve security." +"This setting doesn't apply to client sockets. You can also use " +"the :data:`OP_SINGLE_DH_USE` option to further improve security." msgstr "" msgid "" @@ -1801,8 +1827,8 @@ msgid "" msgstr "" msgid "" -"This setting doesn't apply to client sockets. You can also use the :data:" -"`OP_SINGLE_ECDH_USE` option to further improve security." +"This setting doesn't apply to client sockets. You can also use " +"the :data:`OP_SINGLE_ECDH_USE` option to further improve security." msgstr "" msgid "This method is not available if :data:`HAS_ECDH` is ``False``." @@ -1817,10 +1843,11 @@ msgid "Vincent Bernat." msgstr "" msgid "" -"Wrap an existing Python socket *sock* and return an instance of :attr:" -"`SSLContext.sslsocket_class` (default :class:`SSLSocket`). The returned SSL " -"socket is tied to the context, its settings and certificates. *sock* must be " -"a :const:`~socket.SOCK_STREAM` socket; other socket types are unsupported." +"Wrap an existing Python socket *sock* and return an instance " +"of :attr:`SSLContext.sslsocket_class` (default :class:`SSLSocket`). The " +"returned SSL socket is tied to the context, its settings and certificates. " +"*sock* must be a :const:`~socket.SOCK_STREAM` socket; other socket types are " +"unsupported." msgstr "" msgid "" @@ -1834,8 +1861,8 @@ msgid "" "after :meth:`connect` is called on the socket. For server-side sockets, if " "the socket has no remote peer, it is assumed to be a listening socket, and " "the server-side SSL wrapping is automatically performed on client " -"connections accepted via the :meth:`accept` method. The method may raise :" -"exc:`SSLError`." +"connections accepted via the :meth:`accept` method. The method may " +"raise :exc:`SSLError`." msgstr "" msgid "" @@ -1849,27 +1876,27 @@ msgstr "" msgid "" "The parameter ``do_handshake_on_connect`` specifies whether to do the SSL " "handshake automatically after doing a :meth:`socket.connect`, or whether the " -"application program will call it explicitly, by invoking the :meth:" -"`SSLSocket.do_handshake` method. Calling :meth:`SSLSocket.do_handshake` " -"explicitly gives the program control over the blocking behavior of the " -"socket I/O involved in the handshake." +"application program will call it explicitly, by invoking " +"the :meth:`SSLSocket.do_handshake` method. " +"Calling :meth:`SSLSocket.do_handshake` explicitly gives the program control " +"over the blocking behavior of the socket I/O involved in the handshake." msgstr "" msgid "" -"The parameter ``suppress_ragged_eofs`` specifies how the :meth:`SSLSocket." -"recv` method should signal unexpected EOF from the other end of the " -"connection. If specified as :const:`True` (the default), it returns a " -"normal EOF (an empty bytes object) in response to unexpected EOF errors " -"raised from the underlying socket; if :const:`False`, it will raise the " -"exceptions back to the caller." +"The parameter ``suppress_ragged_eofs`` specifies how " +"the :meth:`SSLSocket.recv` method should signal unexpected EOF from the " +"other end of the connection. If specified as :const:`True` (the default), " +"it returns a normal EOF (an empty bytes object) in response to unexpected " +"EOF errors raised from the underlying socket; if :const:`False`, it will " +"raise the exceptions back to the caller." msgstr "" msgid "*session*, see :attr:`~SSLSocket.session`." msgstr "" msgid "" -"To wrap an :class:`SSLSocket` in another :class:`SSLSocket`, use :meth:" -"`SSLContext.wrap_bio`." +"To wrap an :class:`SSLSocket` in another :class:`SSLSocket`, " +"use :meth:`SSLContext.wrap_bio`." msgstr "" msgid "" @@ -1886,21 +1913,26 @@ msgid "" msgstr "" msgid "" -"The return type of :meth:`SSLContext.wrap_socket`, defaults to :class:" -"`SSLSocket`. The attribute can be overridden on instance of class in order " -"to return a custom subclass of :class:`SSLSocket`." +"The return type of :meth:`SSLContext.wrap_socket`, defaults " +"to :class:`SSLSocket`. The attribute can be assigned to on instances " +"of :class:`SSLContext` in order to return a custom subclass " +"of :class:`SSLSocket`." msgstr "" msgid "" -"Wrap the BIO objects *incoming* and *outgoing* and return an instance of :" -"attr:`SSLContext.sslobject_class` (default :class:`SSLObject`). The SSL " +"Wrap the BIO objects *incoming* and *outgoing* and return an instance " +"of :attr:`SSLContext.sslobject_class` (default :class:`SSLObject`). The SSL " "routines will read input data from the incoming BIO and write data to the " "outgoing BIO." msgstr "" msgid "" "The *server_side*, *server_hostname* and *session* parameters have the same " -"meaning as in :meth:`SSLContext.wrap_socket`." +"meaning as in :meth:`SSLContext.wrap_socket`, and are validated in the same " +"way: in particular a :exc:`ValueError` is raised " +"when :attr:`~SSLContext.check_hostname` is enabled but no *server_hostname* " +"is given, since there would be no name to match the peer's certificate " +"against." msgstr "" msgid "" @@ -1909,9 +1941,17 @@ msgid "" msgstr "" msgid "" -"The return type of :meth:`SSLContext.wrap_bio`, defaults to :class:" -"`SSLObject`. The attribute can be overridden on instance of class in order " -"to return a custom subclass of :class:`SSLObject`." +"The *server_side*, *server_hostname* and *session* parameters are now " +"validated as :meth:`SSLContext.wrap_socket` validates them. Previously a " +"context with :attr:`~SSLContext.check_hostname` enabled and no " +"*server_hostname* was accepted, and verified the certificate chain but never " +"the peer's identity." +msgstr "" + +msgid "" +"The return type of :meth:`SSLContext.wrap_bio`, defaults " +"to :class:`SSLObject`. The attribute can be overridden on instance of class " +"in order to return a custom subclass of :class:`SSLObject`." msgstr "" msgid "" @@ -1933,14 +1973,15 @@ msgstr "" msgid "" "Whether to match the peer cert's hostname in :meth:`SSLSocket.do_handshake`. " -"The context's :attr:`~SSLContext.verify_mode` must be set to :data:" -"`CERT_OPTIONAL` or :data:`CERT_REQUIRED`, and you must pass " +"The context's :attr:`~SSLContext.verify_mode` must be set " +"to :data:`CERT_OPTIONAL` or :data:`CERT_REQUIRED`, and you must pass " "*server_hostname* to :meth:`~SSLContext.wrap_socket` in order to match the " -"hostname. Enabling hostname checking automatically sets :attr:`~SSLContext." -"verify_mode` from :data:`CERT_NONE` to :data:`CERT_REQUIRED`. It cannot be " -"set back to :data:`CERT_NONE` as long as hostname checking is enabled. The :" -"data:`PROTOCOL_TLS_CLIENT` protocol enables hostname checking by default. " -"With other protocols, hostname checking must be enabled explicitly." +"hostname. Enabling hostname checking automatically " +"sets :attr:`~SSLContext.verify_mode` from :data:`CERT_NONE` " +"to :data:`CERT_REQUIRED`. It cannot be set back to :data:`CERT_NONE` as " +"long as hostname checking is enabled. The :data:`PROTOCOL_TLS_CLIENT` " +"protocol enables hostname checking by default. With other protocols, " +"hostname checking must be enabled explicitly." msgstr "" msgid "" @@ -1957,10 +1998,10 @@ msgid "" msgstr "" msgid "" -":attr:`~SSLContext.verify_mode` is now automatically changed to :data:" -"`CERT_REQUIRED` when hostname checking is enabled and :attr:`~SSLContext." -"verify_mode` is :data:`CERT_NONE`. Previously the same operation would have " -"failed with a :exc:`ValueError`." +":attr:`~SSLContext.verify_mode` is now automatically changed " +"to :data:`CERT_REQUIRED` when hostname checking is enabled " +"and :attr:`~SSLContext.verify_mode` is :data:`CERT_NONE`. Previously the " +"same operation would have failed with a :exc:`ValueError`." msgstr "" msgid "" @@ -1974,17 +2015,20 @@ msgstr "" msgid "" "A :class:`TLSVersion` enum member representing the highest supported TLS " "version. The value defaults to :attr:`TLSVersion.MAXIMUM_SUPPORTED`. The " -"attribute is read-only for protocols other than :const:`PROTOCOL_TLS`, :" -"const:`PROTOCOL_TLS_CLIENT`, and :const:`PROTOCOL_TLS_SERVER`." +"attribute is read-only for protocols other " +"than :const:`PROTOCOL_TLS`, :const:`PROTOCOL_TLS_CLIENT`, " +"and :const:`PROTOCOL_TLS_SERVER`." msgstr "" msgid "" -"The attributes :attr:`~SSLContext.maximum_version`, :attr:`~SSLContext." -"minimum_version` and :attr:`SSLContext.options` all affect the supported SSL " -"and TLS versions of the context. The implementation does not prevent invalid " -"combination. For example a context with :attr:`OP_NO_TLSv1_2` in :attr:" -"`~SSLContext.options` and :attr:`~SSLContext.maximum_version` set to :attr:" -"`TLSVersion.TLSv1_2` will not be able to establish a TLS 1.2 connection." +"The " +"attributes :attr:`~SSLContext.maximum_version`, :attr:`~SSLContext.minimum_version` " +"and :attr:`SSLContext.options` all affect the supported SSL and TLS versions " +"of the context. The implementation does not prevent invalid combinations. " +"For example a context with :attr:`OP_NO_TLSv1_2` " +"in :attr:`~SSLContext.options` and :attr:`~SSLContext.maximum_version` set " +"to :attr:`TLSVersion.TLSv1_2` will not be able to establish a TLS 1.2 " +"connection." msgstr "" msgid "" @@ -1993,15 +2037,15 @@ msgid "" msgstr "" msgid "" -"Control the number of TLS 1.3 session tickets of a :const:" -"`PROTOCOL_TLS_SERVER` context. The setting has no impact on TLS 1.0 to 1.2 " -"connections." +"Control the number of TLS 1.3 session tickets of " +"a :const:`PROTOCOL_TLS_SERVER` context. The setting has no impact on TLS 1.0 " +"to 1.2 connections." msgstr "" msgid "" "An integer representing the set of SSL options enabled on this context. The " -"default value is :data:`OP_ALL`, but you can specify other options such as :" -"data:`OP_NO_SSLv2` by ORing them together." +"default value is :data:`OP_ALL`, but you can specify other options such " +"as :data:`OP_NO_SSLv2` by ORing them together." msgstr "" msgid ":attr:`SSLContext.options` returns :class:`Options` flags:" @@ -2009,8 +2053,8 @@ msgstr "" msgid "" "All ``OP_NO_SSL*`` and ``OP_NO_TLS*`` options have been deprecated since " -"Python 3.7. Use :attr:`SSLContext.minimum_version` and :attr:`SSLContext." -"maximum_version` instead." +"Python 3.7. Use :attr:`SSLContext.minimum_version` " +"and :attr:`SSLContext.maximum_version` instead." msgstr "" msgid "" @@ -2028,8 +2072,9 @@ msgstr "" msgid "" "When enabled on server-side sockets, :attr:`SSLContext.verify_mode` must be " "set to :data:`CERT_OPTIONAL` or :data:`CERT_REQUIRED`, too. The actual " -"client cert exchange is delayed until :meth:`SSLSocket." -"verify_client_post_handshake` is called and some I/O is performed." +"client cert exchange is delayed " +"until :meth:`SSLSocket.verify_client_post_handshake` is called and some I/O " +"is performed." msgstr "" msgid "" @@ -2055,9 +2100,9 @@ msgid "" msgstr "" msgid "" -"The flags for certificate verification operations. You can set flags like :" -"data:`VERIFY_CRL_CHECK_LEAF` by ORing them together. By default OpenSSL does " -"neither require nor verify certificate revocation lists (CRLs)." +"The flags for certificate verification operations. You can set flags " +"like :data:`VERIFY_CRL_CHECK_LEAF` by ORing them together. By default " +"OpenSSL does neither require nor verify certificate revocation lists (CRLs)." msgstr "" msgid ":attr:`SSLContext.verify_flags` returns :class:`VerifyFlags` flags:" @@ -2065,8 +2110,8 @@ msgstr "" msgid "" "Whether to try to verify other peers' certificates and how to behave if " -"verification fails. This attribute must be one of :data:`CERT_NONE`, :data:" -"`CERT_OPTIONAL` or :data:`CERT_REQUIRED`." +"verification fails. This attribute must be one " +"of :data:`CERT_NONE`, :data:`CERT_OPTIONAL` or :data:`CERT_REQUIRED`." msgstr "" msgid ":attr:`SSLContext.verify_mode` returns :class:`VerifyMode` enum:" @@ -2262,9 +2307,9 @@ msgid "" "certificate chains for each issuer you are willing to trust. Again, this " "file just contains these chains concatenated together. For validation, " "Python will use the first chain it finds in the file which matches. The " -"platform's certificates file can be used by calling :meth:`SSLContext." -"load_default_certs`, this is done automatically with :func:`." -"create_default_context`." +"platform's certificates file can be used by " +"calling :meth:`SSLContext.load_default_certs`, this is done automatically " +"with :func:`.create_default_context`." msgstr "" msgid "Combined key and certificate" @@ -2386,8 +2431,8 @@ msgid "" msgstr "" msgid "" -"When you use the context to connect to a server, :const:`CERT_REQUIRED` and :" -"attr:`~SSLContext.check_hostname` validate the server certificate: it " +"When you use the context to connect to a server, :const:`CERT_REQUIRED` " +"and :attr:`~SSLContext.check_hostname` validate the server certificate: it " "ensures that the server certificate was signed with one of the CA " "certificates, checks the signature for correctness, and verifies other " "properties like validity and identity of the hostname::" @@ -2418,10 +2463,10 @@ msgid "" "{'OCSP': ('http://ocsp.digicert.com',),\n" " 'caIssuers': ('http://cacerts.digicert.com/" "DigiCertSHA2ExtendedValidationServerCA.crt',),\n" -" 'crlDistributionPoints': ('http://crl3.digicert.com/sha2-ev-server-g1." -"crl',\n" -" 'http://crl4.digicert.com/sha2-ev-server-g1." -"crl'),\n" +" 'crlDistributionPoints': ('http://crl3.digicert.com/sha2-ev-server-" +"g1.crl',\n" +" 'http://crl4.digicert.com/sha2-ev-server-" +"g1.crl'),\n" " 'issuer': ((('countryName', 'US'),),\n" " (('organizationName', 'DigiCert Inc'),),\n" " (('organizationalUnitName', 'www.digicert.com'),),\n" @@ -2510,8 +2555,9 @@ msgstr "" msgid "" "When a client connects, you'll call :meth:`accept` on the socket to get the " -"new socket from the other end, and use the context's :meth:`SSLContext." -"wrap_socket` method to create a server-side SSL socket for the connection::" +"new socket from the other end, and use the " +"context's :meth:`SSLContext.wrap_socket` method to create a server-side SSL " +"socket for the connection::" msgstr "" msgid "" @@ -2563,10 +2609,10 @@ msgid "" "Most :class:`SSLSocket` methods will raise either :exc:`SSLWantWriteError` " "or :exc:`SSLWantReadError` instead of :exc:`BlockingIOError` if an I/O " "operation would block. :exc:`SSLWantReadError` will be raised if a read " -"operation on the underlying socket is necessary, and :exc:" -"`SSLWantWriteError` for a write operation on the underlying socket. Note " -"that attempts to *write* to an SSL socket may require *reading* from the " -"underlying socket first, and attempts to *read* from the SSL socket may " +"operation on the underlying socket is necessary, " +"and :exc:`SSLWantWriteError` for a write operation on the underlying socket. " +"Note that attempts to *write* to an SSL socket may require *reading* from " +"the underlying socket first, and attempts to *read* from the SSL socket may " "require a prior *write* to the underlying socket." msgstr "" @@ -2580,8 +2626,8 @@ msgid "" "read from (or written to), but it does not imply that there is sufficient " "data at the upper SSL layer. For example, only part of an SSL frame might " "have arrived. Therefore, you must be ready to handle :meth:`SSLSocket.recv` " -"and :meth:`SSLSocket.send` failures, and retry after another call to :func:" -"`~select.select`." +"and :meth:`SSLSocket.send` failures, and retry after another call " +"to :func:`~select.select`." msgstr "" msgid "" @@ -2593,15 +2639,15 @@ msgid "" msgstr "" msgid "" -"(of course, similar provisions apply when using other primitives such as :" -"func:`~select.poll`, or those in the :mod:`selectors` module)" +"(of course, similar provisions apply when using other primitives such " +"as :func:`~select.poll`, or those in the :mod:`selectors` module)" msgstr "" msgid "" -"The SSL handshake itself will be non-blocking: the :meth:`SSLSocket." -"do_handshake` method has to be retried until it returns successfully. Here " -"is a synopsis using :func:`~select.select` to wait for the socket's " -"readiness::" +"The SSL handshake itself will be non-blocking: " +"the :meth:`SSLSocket.do_handshake` method has to be retried until it returns " +"successfully. Here is a synopsis using :func:`~select.select` to wait for " +"the socket's readiness::" msgstr "" msgid "" @@ -2619,17 +2665,17 @@ msgid "" "The :mod:`asyncio` module supports :ref:`non-blocking SSL sockets ` and provides a higher level :ref:`Streams API `. It polls for events using the :mod:`selectors` module and " -"handles :exc:`SSLWantWriteError`, :exc:`SSLWantReadError` and :exc:" -"`BlockingIOError` exceptions. It runs the SSL handshake asynchronously as " -"well." +"handles :exc:`SSLWantWriteError`, :exc:`SSLWantReadError` " +"and :exc:`BlockingIOError` exceptions. It runs the SSL handshake " +"asynchronously as well." msgstr "" -msgid "Memory BIO Support" +msgid "Memory BIO support" msgstr "" msgid "" -"Ever since the SSL module was introduced in Python 2.6, the :class:" -"`SSLSocket` class has provided two related but distinct areas of " +"Ever since the SSL module was introduced in Python 2.6, " +"the :class:`SSLSocket` class has provided two related but distinct areas of " "functionality:" msgstr "" @@ -2650,11 +2696,11 @@ msgid "" "Combining SSL protocol handling and network IO usually works well, but there " "are some cases where it doesn't. An example is async IO frameworks that want " "to use a different IO multiplexing model than the \"select/poll on a file " -"descriptor\" (readiness based) model that is assumed by :class:`socket." -"socket` and by the internal OpenSSL socket IO routines. This is mostly " -"relevant for platforms like Windows where this model is not efficient. For " -"this purpose, a reduced scope variant of :class:`SSLSocket` called :class:" -"`SSLObject` is provided." +"descriptor\" (readiness based) model that is assumed " +"by :class:`socket.socket` and by the internal OpenSSL socket IO routines. " +"This is mostly relevant for platforms like Windows where this model is not " +"efficient. For this purpose, a reduced scope variant of :class:`SSLSocket` " +"called :class:`SSLObject` is provided." msgstr "" msgid "" @@ -2762,8 +2808,8 @@ msgstr "" msgid "" "There is no handling of *suppress_ragged_eofs*. All end-of-file conditions " -"that are in violation of the protocol are reported via the :exc:" -"`SSLEOFError` exception." +"that are in violation of the protocol are reported via " +"the :exc:`SSLEOFError` exception." msgstr "" msgid "" @@ -2772,9 +2818,9 @@ msgid "" msgstr "" msgid "" -"The *server_name_callback* callback passed to :meth:`SSLContext." -"set_servername_callback` will get an :class:`SSLObject` instance instead of " -"a :class:`SSLSocket` instance as its first parameter." +"The *server_name_callback* callback passed " +"to :meth:`SSLContext.set_servername_callback` will get an :class:`SSLObject` " +"instance instead of a :class:`SSLSocket` instance as its first parameter." msgstr "" msgid "Some notes related to the use of :class:`SSLObject`:" @@ -2782,14 +2828,15 @@ msgstr "" msgid "" "All IO on an :class:`SSLObject` is :ref:`non-blocking `. " -"This means that for example :meth:`~SSLSocket.read` will raise an :exc:" -"`SSLWantReadError` if it needs more data than the incoming BIO has available." +"This means that for example :meth:`~SSLSocket.read` will raise " +"an :exc:`SSLWantReadError` if it needs more data than the incoming BIO has " +"available." msgstr "" msgid "" -":class:`SSLObject` instances must be created with :meth:`~SSLContext." -"wrap_bio`. In earlier versions, it was possible to create instances " -"directly. This was never documented or officially supported." +":class:`SSLObject` instances must be created " +"with :meth:`~SSLContext.wrap_bio`. In earlier versions, it was possible to " +"create instances directly. This was never documented or officially supported." msgstr "" msgid "" @@ -2846,11 +2893,11 @@ msgstr "" msgid "" "For **client use**, if you don't have any special requirements for your " -"security policy, it is highly recommended that you use the :func:" -"`create_default_context` function to create your SSL context. It will load " -"the system's trusted CA certificates, enable certificate validation and " -"hostname checking, and try to choose reasonably secure protocol and cipher " -"settings." +"security policy, it is highly recommended that you use " +"the :func:`create_default_context` function to create your SSL context. It " +"will load the system's trusted CA certificates, enable certificate " +"validation and hostname checking, and try to choose reasonably secure " +"protocol and cipher settings." msgstr "" msgid "" @@ -2867,15 +2914,15 @@ msgid "" msgstr "" msgid "" -"If a client certificate is needed for the connection, it can be added with :" -"meth:`SSLContext.load_cert_chain`." +"If a client certificate is needed for the connection, it can be added " +"with :meth:`SSLContext.load_cert_chain`." msgstr "" msgid "" -"By contrast, if you create the SSL context by calling the :class:" -"`SSLContext` constructor yourself, it will not have certificate validation " -"nor hostname checking enabled by default. If you do so, please read the " -"paragraphs below to achieve a good security level." +"By contrast, if you create the SSL context by calling " +"the :class:`SSLContext` constructor yourself, it will not have certificate " +"validation nor hostname checking enabled by default. If you do so, please " +"read the paragraphs below to achieve a good security level." msgstr "" msgid "Manual settings" @@ -2885,22 +2932,22 @@ msgid "Verifying certificates" msgstr "" msgid "" -"When calling the :class:`SSLContext` constructor directly, :const:" -"`CERT_NONE` is the default. Since it does not authenticate the other peer, " -"it can be insecure, especially in client mode where most of the time you " -"would like to ensure the authenticity of the server you're talking to. " -"Therefore, when in client mode, it is highly recommended to use :const:" -"`CERT_REQUIRED`. However, it is in itself not sufficient; you also have to " -"check that the server certificate, which can be obtained by calling :meth:" -"`SSLSocket.getpeercert`, matches the desired service. For many protocols " -"and applications, the service can be identified by the hostname. This common " -"check is automatically performed when :attr:`SSLContext.check_hostname` is " -"enabled." +"When calling the :class:`SSLContext` constructor " +"directly, :const:`CERT_NONE` is the default. Since it does not authenticate " +"the other peer, it can be insecure, especially in client mode where most of " +"the time you would like to ensure the authenticity of the server you're " +"talking to. Therefore, when in client mode, it is highly recommended to " +"use :const:`CERT_REQUIRED`. However, it is in itself not sufficient; you " +"also have to check that the server certificate, which can be obtained by " +"calling :meth:`SSLSocket.getpeercert`, matches the desired service. For " +"many protocols and applications, the service can be identified by the " +"hostname. This common check is automatically performed " +"when :attr:`SSLContext.check_hostname` is enabled." msgstr "" msgid "" -"Hostname matchings is now performed by OpenSSL. Python no longer uses :func:" -"`match_hostname`." +"Hostname matchings is now performed by OpenSSL. Python no longer " +"uses :func:`!match_hostname`." msgstr "" msgid "" @@ -2916,25 +2963,22 @@ msgstr "" msgid "" "SSL versions 2 and 3 are considered insecure and are therefore dangerous to " "use. If you want maximum compatibility between clients and servers, it is " -"recommended to use :const:`PROTOCOL_TLS_CLIENT` or :const:" -"`PROTOCOL_TLS_SERVER` as the protocol version. SSLv2 and SSLv3 are disabled " -"by default." +"recommended to use :const:`PROTOCOL_TLS_CLIENT` " +"or :const:`PROTOCOL_TLS_SERVER` as the protocol version. SSLv2 and SSLv3 are " +"disabled by default." msgstr "" msgid "" ">>> client_context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)\n" -">>> client_context.minimum_version = ssl.TLSVersion.TLSv1_3\n" +">>> client_context.minimum_version = ssl.TLSVersion.TLSv1_2\n" ">>> client_context.maximum_version = ssl.TLSVersion.TLSv1_3" msgstr "" -">>> client_context = ssl.SSLContext(ssl.PROTOCOL_TLS_CLIENT)\n" -">>> client_context.minimum_version = ssl.TLSVersion.TLSv1_3\n" -">>> client_context.maximum_version = ssl.TLSVersion.TLSv1_3" msgid "" -"The SSL context created above will only allow TLSv1.3 and later (if " -"supported by your system) connections to a server. :const:" -"`PROTOCOL_TLS_CLIENT` implies certificate validation and hostname checks by " -"default. You have to load certificates into the context." +"The SSL client context created above will only allow TLSv1.2 and TLSv1.3 (if " +"supported by your system) connections to a " +"server. :const:`PROTOCOL_TLS_CLIENT` implies certificate validation and " +"hostname checks by default. You have to load certificates into the context." msgstr "" msgid "Cipher selection" @@ -2942,14 +2986,14 @@ msgstr "" msgid "" "If you have advanced security requirements, fine-tuning of the ciphers " -"enabled when negotiating a SSL session is possible through the :meth:" -"`SSLContext.set_ciphers` method. Starting from Python 3.2.3, the ssl module " -"disables certain weak ciphers by default, but you may want to further " -"restrict the cipher choice. Be sure to read OpenSSL's documentation about " -"the `cipher list format `_. If you want to check which ciphers are enabled by a given " -"cipher list, use :meth:`SSLContext.get_ciphers` or the ``openssl ciphers`` " -"command on your system." +"enabled when negotiating a SSL session is possible through " +"the :meth:`SSLContext.set_ciphers` method. Starting from Python 3.2.3, the " +"ssl module disables certain weak ciphers by default, but you may want to " +"further restrict the cipher choice. Be sure to read OpenSSL's documentation " +"about the `cipher list format `_. If you want to check which ciphers are enabled by a " +"given cipher list, use :meth:`SSLContext.get_ciphers` or the ``openssl " +"ciphers`` command on your system." msgstr "" msgid "Multi-processing" @@ -2975,9 +3019,9 @@ msgstr "" msgid "" "TLS 1.3 uses a disjunct set of cipher suites. All AES-GCM and ChaCha20 " -"cipher suites are enabled by default. The method :meth:`SSLContext." -"set_ciphers` cannot enable or disable any TLS 1.3 ciphers yet, but :meth:" -"`SSLContext.get_ciphers` returns them." +"cipher suites are enabled by default. The " +"method :meth:`SSLContext.set_ciphers` cannot enable or disable any TLS 1.3 " +"ciphers yet, but :meth:`SSLContext.get_ciphers` returns them." msgstr "" msgid "" @@ -3023,7 +3067,7 @@ msgstr "" msgid ":rfc:`RFC 4086: Randomness Requirements for Security <4086>`" msgstr "" -msgid "Donald E., Jeffrey I. Schiller" +msgid "Donald E. Eastlake, Jeffrey I. Schiller, Steve Crocker" msgstr "" msgid "" @@ -3031,7 +3075,7 @@ msgid "" "Certificate Revocation List (CRL) Profile <5280>`" msgstr "" -msgid "D. Cooper" +msgid "David Cooper et al." msgstr "" msgid "" @@ -3039,13 +3083,13 @@ msgid "" "<5246>`" msgstr "" -msgid "T. Dierks et. al." +msgid "Tim Dierks and Eric Rescorla." msgstr "" msgid ":rfc:`RFC 6066: Transport Layer Security (TLS) Extensions <6066>`" msgstr "" -msgid "D. Eastlake" +msgid "Donald E. Eastlake" msgstr "" msgid "" diff --git a/library/stat.po b/library/stat.po index 85012fc8f4..79011f6f8a 100644 --- a/library/stat.po +++ b/library/stat.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!stat` --- Interpreting :func:`~os.stat` results" msgstr "" msgid "**Source code:** :source:`Lib/stat.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/stat.py`" msgid "" "The :mod:`stat` module defines constants and functions for interpreting the " @@ -185,11 +185,12 @@ msgid "" "The interpretation of \"file size\" changes according to the file type. For " "plain files this is the size of the file in bytes. For FIFOs and sockets " "under most flavors of Unix (including Linux in particular), the \"size\" is " -"the number of bytes waiting to be read at the time of the call to :func:`os." -"stat`, :func:`os.fstat`, or :func:`os.lstat`; this can sometimes be useful, " -"especially for polling one of these special files after a non-blocking " -"open. The meaning of the size field for other character and block devices " -"varies more, depending on the implementation of the underlying system call." +"the number of bytes waiting to be read at the time of the call " +"to :func:`os.stat`, :func:`os.fstat`, or :func:`os.lstat`; this can " +"sometimes be useful, especially for polling one of these special files after " +"a non-blocking open. The meaning of the size field for other character and " +"block devices varies more, depending on the implementation of the underlying " +"system call." msgstr "" msgid "The variables below define the flags used in the :data:`ST_MODE` field." @@ -236,8 +237,8 @@ msgid "" msgstr "" msgid "" -"The following flags can also be used in the *mode* argument of :func:`os." -"chmod`:" +"The following flags can also be used in the *mode* argument " +"of :func:`os.chmod`:" msgstr "" msgid "Set UID bit." @@ -296,9 +297,9 @@ msgid "Others have execute permission." msgstr "" msgid "" -"System V file locking enforcement. This flag is shared with :data:" -"`S_ISGID`: file/record locking is enforced on files that do not have the " -"group execution bit (:data:`S_IXGRP`) set." +"System V file locking enforcement. This flag is shared " +"with :data:`S_ISGID`: file/record locking is enforced on files that do not " +"have the group execution bit (:data:`S_IXGRP`) set." msgstr "" msgid "Unix V7 synonym for :data:`S_IRUSR`." @@ -311,8 +312,8 @@ msgid "Unix V7 synonym for :data:`S_IXUSR`." msgstr "" msgid "" -"The following flags can be used in the *flags* argument of :func:`os." -"chflags`:" +"The following flags can be used in the *flags* argument " +"of :func:`os.chflags`:" msgstr "" msgid "All user settable flags." @@ -379,10 +380,10 @@ msgstr "" msgid "" "On Windows, the following file attribute constants are available for use " -"when testing bits in the ``st_file_attributes`` member returned by :func:`os." -"stat`. See the `Windows API documentation `_ for more detail on the meaning of " -"these constants." +"when testing bits in the ``st_file_attributes`` member returned " +"by :func:`os.stat`. See the `Windows API documentation `_ for more " +"detail on the meaning of these constants." msgstr "" msgid "" diff --git a/library/statistics.po b/library/statistics.po index 195799f1ea..3f7bc48701 100644 --- a/library/statistics.po +++ b/library/statistics.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-11 20:17+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,7 +27,7 @@ msgid ":mod:`!statistics` --- Mathematical statistics functions" msgstr "" msgid "**Source code:** :source:`Lib/statistics.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/statistics.py`" msgid "" "This module provides functions for calculating mathematical statistics of " @@ -45,13 +43,13 @@ msgid "" msgstr "" msgid "" -"Unless explicitly noted, these functions support :class:`int`, :class:" -"`float`, :class:`~decimal.Decimal` and :class:`~fractions.Fraction`. " -"Behaviour with other types (whether in the numeric tower or not) is " -"currently unsupported. Collections with a mix of types are also undefined " -"and implementation-dependent. If your input data consists of mixed types, " -"you may be able to use :func:`map` to ensure a consistent result, for " -"example: ``map(float, input_data)``." +"Unless explicitly noted, these functions " +"support :class:`int`, :class:`float`, :class:`~decimal.Decimal` " +"and :class:`~fractions.Fraction`. Behaviour with other types (whether in the " +"numeric tower or not) is currently unsupported. Collections with a mix of " +"types are also undefined and implementation-dependent. If your input data " +"consists of mixed types, you may be able to use :func:`map` to ensure a " +"consistent result, for example: ``map(float, input_data)``." msgstr "" msgid "" @@ -289,8 +287,8 @@ msgid "Convert *data* to floats and compute the arithmetic mean." msgstr "" msgid "" -"This runs faster than the :func:`mean` function and it always returns a :" -"class:`float`. The *data* may be a sequence or iterable. If the input " +"This runs faster than the :func:`mean` function and it always returns " +"a :class:`float`. The *data* may be a sequence or iterable. If the input " "dataset is empty, raises a :exc:`StatisticsError`." msgstr "" @@ -315,8 +313,8 @@ msgid "" msgstr "" msgid "" -"If *weights* is supplied, it must be the same length as the *data* or a :exc:" -"`ValueError` will be raised." +"If *weights* is supplied, it must be the same length as the *data* or " +"a :exc:`ValueError` will be raised." msgstr "" msgid "Added support for *weights*." @@ -412,9 +410,9 @@ msgid "" msgstr "" msgid "" -"The basic idea is to smooth the data using `a kernel function `_. to help draw inferences about a " -"population from a sample." +"The basic idea is to smooth the data using `a kernel function `_. to help draw inferences about " +"a population from a sample." msgstr "" msgid "" @@ -468,6 +466,13 @@ msgstr "" msgid "Scatter plot of the estimated probability density function." msgstr "" +msgid "" +"Because the returned ``f_hat`` function is typically called many times, it " +"caches the *data* for performance. To support dynamic datasets, this cache " +"automatically refreshes whenever the length of the *data* changes. This " +"allows new samples to be added as they become available." +msgstr "" + msgid "" "Return a function that makes a random selection from the estimated " "probability density function produced by ``kde(data, h, kernel)``." @@ -528,8 +533,9 @@ msgid "" msgstr "" msgid "" -"Return the low median of numeric data. If *data* is empty, :exc:" -"`StatisticsError` is raised. *data* can be a sequence or iterable." +"Return the low median of numeric data. If *data* is " +"empty, :exc:`StatisticsError` is raised. *data* can be a sequence or " +"iterable." msgstr "" msgid "" @@ -890,9 +896,9 @@ msgid "" msgstr "" msgid "" -"If you somehow know the actual population mean μ you should pass it to the :" -"func:`pvariance` function as the *mu* parameter to get the variance of a " -"sample." +"If you somehow know the actual population mean μ you should pass it to " +"the :func:`pvariance` function as the *mu* parameter to get the variance of " +"a sample." msgstr "" msgid "" @@ -968,8 +974,8 @@ msgid "" msgstr "" msgid "" -"Both inputs must be of the same length (no less than two), otherwise :exc:" -"`StatisticsError` is raised." +"Both inputs must be of the same length (no less than two), " +"otherwise :exc:`StatisticsError` is raised." msgstr "" msgid "" @@ -1043,8 +1049,8 @@ msgid "Added support for Spearman's rank correlation coefficient." msgstr "" msgid "" -"Return the slope and intercept of `simple linear regression `_ parameters estimated using " +"Return the slope and intercept of `simple linear regression `_ parameters estimated using " "ordinary least squares. Simple linear regression describes the relationship " "between an independent variable *x* and a dependent variable *y* in terms of " "this linear function:" @@ -1062,8 +1068,8 @@ msgstr "" msgid "" "Both inputs must be of the same length (no less than two), and the " -"independent variable *x* cannot be constant; otherwise a :exc:" -"`StatisticsError` is raised." +"independent variable *x* cannot be constant; otherwise " +"a :exc:`StatisticsError` is raised." msgstr "" msgid "" @@ -1129,14 +1135,14 @@ msgstr "" msgid "" ":class:`NormalDist` is a tool for creating and manipulating normal " -"distributions of a `random variable `_. It is a class that treats the mean and " -"standard deviation of data measurements as a single entity." +"distributions of a `random variable `_. It is a class that treats the mean and standard " +"deviation of data measurements as a single entity." msgstr "" msgid "" -"Normal distributions arise from the `Central Limit Theorem `_ and have a wide range of " +"Normal distributions arise from the `Central Limit Theorem `_ and have a wide range of " "applications in statistics." msgstr "" @@ -1228,8 +1234,8 @@ msgstr "" msgid "" "Compute the inverse cumulative distribution function, also known as the " "`quantile function `_ or " -"the `percent-point `_ " +"the `percent-point `_ " "function. Mathematically, it is written ``x : P(X <= x) = p``." msgstr "" @@ -1284,8 +1290,8 @@ msgid "" "Since normal distributions arise from additive effects of independent " "variables, it is possible to `add and subtract two independent normally " "distributed random variables `_ represented as instances of :" -"class:`NormalDist`. For example:" +"Sum_of_normally_distributed_random_variables>`_ represented as instances " +"of :class:`NormalDist`. For example:" msgstr "" msgid "" @@ -1402,8 +1408,8 @@ msgid "Normal distributions commonly arise in machine learning problems." msgstr "" msgid "" -"Wikipedia has a `nice example of a Naive Bayesian Classifier `_. The " +"Wikipedia has a `nice example of a Naive Bayesian Classifier `_. The " "challenge is to predict a person's gender from measurements of normally " "distributed features including height, weight, and foot size." msgstr "" diff --git a/library/stdtypes.po b/library/stdtypes.po index 7e5dbbaf5e..3b51ae8486 100644 --- a/library/stdtypes.po +++ b/library/stdtypes.po @@ -1,26 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Tadeusz Karpiński , 2023 -# haaritsubaki, 2023 -# gresm, 2024 -# Wiktor Matuszewski , 2024 -# Rafael Fontenelle , 2024 -# Stan Ulbrych, 2025 -# Stefan Ocetkiewicz , 2025 -# Maciej Olko , 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:13+0000\n" -"Last-Translator: Maciej Olko , 2025\n" +"POT-Creation-Date: 2026-09-07 20:26+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -61,15 +54,15 @@ msgid "Truth Value Testing" msgstr "" msgid "" -"Any object can be tested for truth value, for use in an :keyword:`if` or :" -"keyword:`while` condition or as operand of the Boolean operations below." +"Any object can be tested for truth value, for use in an :keyword:`if` " +"or :keyword:`while` condition or as operand of the Boolean operations below." msgstr "" msgid "" -"By default, an object is considered true unless its class defines either a :" -"meth:`~object.__bool__` method that returns ``False`` or a :meth:`~object." -"__len__` method that returns zero, when called with the object. [1]_ Here " -"are most of the built-in objects considered false:" +"By default, an object is considered true unless its class defines either " +"a :meth:`~object.__bool__` method that returns ``False`` or " +"a :meth:`~object.__len__` method that returns zero, when called with the " +"object. [1]_ Here are most of the built-in objects considered false:" msgstr "" msgid "constants defined to be false: ``None`` and ``False``" @@ -117,7 +110,7 @@ msgid "\\(1)" msgstr "\\(1)" msgid "``x and y``" -msgstr "" +msgstr "``x and y``" msgid "if *x* is false, then *x*, else *y*" msgstr "" @@ -218,12 +211,12 @@ msgid "negated object identity" msgstr "" msgid "" -"Objects of different types, except different numeric types, never compare " -"equal. The ``==`` operator is always defined but for some object types (for " -"example, class objects) is equivalent to :keyword:`is`. The ``<``, ``<=``, " -"``>`` and ``>=`` operators are only defined where they make sense; for " -"example, they raise a :exc:`TypeError` exception when one of the arguments " -"is a complex number." +"Unless stated otherwise, objects of different types never compare equal. The " +"``==`` operator is always defined but for some object types (for example, " +"class objects) is equivalent to :keyword:`is`. The ``<``, ``<=``, ``>`` and " +"``>=`` operators are only defined where they make sense; for example, they " +"raise a :exc:`TypeError` exception when one of the arguments is a complex " +"number." msgstr "" msgid "" @@ -234,10 +227,11 @@ msgstr "" msgid "" "Instances of a class cannot be ordered with respect to other instances of " "the same class, or other types of object, unless the class defines enough of " -"the methods :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object." -"__gt__`, and :meth:`~object.__ge__` (in general, :meth:`~object.__lt__` and :" -"meth:`~object.__eq__` are sufficient, if you want the conventional meanings " -"of the comparison operators)." +"the " +"methods :meth:`~object.__lt__`, :meth:`~object.__le__`, :meth:`~object.__gt__`, " +"and :meth:`~object.__ge__` (in general, :meth:`~object.__lt__` " +"and :meth:`~object.__eq__` are sufficient, if you want the conventional " +"meanings of the comparison operators)." msgstr "" msgid "" @@ -247,8 +241,8 @@ msgid "" msgstr "" msgid "" -"Two more operations with the same syntactic priority, :keyword:`in` and :" -"keyword:`not in`, are supported by types that are :term:`iterable` or " +"Two more operations with the same syntactic priority, :keyword:`in` " +"and :keyword:`not in`, are supported by types that are :term:`iterable` or " "implement the :meth:`~object.__contains__` method." msgstr "" @@ -261,12 +255,13 @@ msgid "" "subtype of integers. Integers have unlimited precision. Floating-point " "numbers are usually implemented using :c:expr:`double` in C; information " "about the precision and internal representation of floating-point numbers " -"for the machine on which your program is running is available in :data:`sys." -"float_info`. Complex numbers have a real and imaginary part, which are each " -"a floating-point number. To extract these parts from a complex number *z*, " -"use ``z.real`` and ``z.imag``. (The standard library includes the additional " -"numeric types :mod:`fractions.Fraction`, for rationals, and :mod:`decimal." -"Decimal`, for floating-point numbers with user-definable precision.)" +"for the machine on which your program is running is available " +"in :data:`sys.float_info`. Complex numbers have a real and imaginary part, " +"which are each a floating-point number. To extract these parts from a " +"complex number *z*, use ``z.real`` and ``z.imag``. (The standard library " +"includes the additional numeric types :mod:`fractions.Fraction`, for " +"rationals, and :mod:`decimal.Decimal`, for floating-point numbers with user-" +"definable precision.)" msgstr "" msgid "" @@ -394,7 +389,7 @@ msgid "" msgstr "" msgid "\\(6)" -msgstr "" +msgstr "\\(6)" msgid ":func:`complex`" msgstr ":func:`complex`" @@ -476,13 +471,13 @@ msgid "" msgstr "" msgid ":func:`math.trunc(\\ x) `" -msgstr "" +msgstr ":func:`math.trunc(\\ x) `" msgid "*x* truncated to :class:`~numbers.Integral`" msgstr "" msgid ":func:`round(x[, n]) `" -msgstr "" +msgstr ":func:`round(x[, n]) `" msgid "" "*x* rounded to *n* digits, rounding half to even. If *n* is omitted, it " @@ -490,7 +485,7 @@ msgid "" msgstr "" msgid ":func:`math.floor(\\ x) `" -msgstr "" +msgstr ":func:`math.floor(\\ x) `" msgid "the greatest :class:`~numbers.Integral` <= *x*" msgstr "" @@ -584,8 +579,8 @@ msgstr "" msgid "" "Performing these calculations with at least one extra sign extension bit in " -"a finite two's complement representation (a working bit-width of ``1 + max(x." -"bit_length(), y.bit_length())`` or more) is sufficient to get the same " +"a finite two's complement representation (a working bit-width of ``1 + " +"max(x.bit_length(), y.bit_length())`` or more) is sufficient to get the same " "result as if there were an infinite number of sign bits." msgstr "" @@ -619,8 +614,8 @@ msgid "" "More precisely, if ``x`` is nonzero, then ``x.bit_length()`` is the unique " "positive integer ``k`` such that ``2**(k-1) <= abs(x) < 2**k``. " "Equivalently, when ``abs(x)`` is small enough to have a correctly rounded " -"logarithm, then ``k = 1 + int(log(abs(x), 2))``. If ``x`` is zero, then ``x." -"bit_length()`` returns ``0``." +"logarithm, then ``k = 1 + int(log(abs(x), 2))``. If ``x`` is zero, then " +"``x.bit_length()`` returns ``0``." msgstr "" msgid "Equivalent to::" @@ -664,9 +659,9 @@ msgid "Return an array of bytes representing an integer." msgstr "" msgid "" -"The integer is represented using *length* bytes, and defaults to 1. An :exc:" -"`OverflowError` is raised if the integer is not representable with the given " -"number of bytes." +"The integer is represented using *length* bytes, and defaults to 1. " +"An :exc:`OverflowError` is raised if the integer is not representable with " +"the given number of bytes." msgstr "" msgid "" @@ -728,8 +723,8 @@ msgid "" "integer, and defaults to ``\"big\"``. If *byteorder* is ``\"big\"``, the " "most significant byte is at the beginning of the byte array. If *byteorder* " "is ``\"little\"``, the most significant byte is at the end of the byte " -"array. To request the native byte order of the host system, use :data:`sys." -"byteorder` as the byte order value." +"array. To request the native byte order of the host system, " +"use :data:`sys.byteorder` as the byte order value." msgstr "" msgid "" @@ -763,8 +758,8 @@ msgid "" msgstr "" msgid "" -"Returns ``True``. Exists for duck type compatibility with :meth:`float." -"is_integer`." +"Returns ``True``. Exists for duck type compatibility " +"with :meth:`float.is_integer`." msgstr "" msgid "Additional Methods on Float" @@ -777,8 +772,8 @@ msgstr "" msgid "" "Return a pair of integers whose ratio is exactly equal to the original " -"float. The ratio is in lowest terms and has a positive denominator. Raises :" -"exc:`OverflowError` on infinities and a :exc:`ValueError` on NaNs." +"float. The ratio is in lowest terms and has a positive denominator. " +"Raises :exc:`OverflowError` on infinities and a :exc:`ValueError` on NaNs." msgstr "" msgid "" @@ -818,8 +813,8 @@ msgid "" msgstr "" msgid "" -"Note that :meth:`float.hex` is an instance method, while :meth:`float." -"fromhex` is a class method." +"Note that :meth:`float.hex` is an instance method, " +"while :meth:`float.fromhex` is a class method." msgstr "" msgid "A hexadecimal string takes the form::" @@ -829,7 +824,7 @@ msgid "[sign] ['0x'] integer ['.' fraction] ['p' exponent]" msgstr "" msgid "" -"where the optional ``sign`` may by either ``+`` or ``-``, ``integer`` and " +"where the optional ``sign`` may be either ``+`` or ``-``, ``integer`` and " "``fraction`` are strings of hexadecimal digits, and ``exponent`` is a " "decimal integer with an optional leading sign. Case is not significant, and " "there must be at least one hexadecimal digit in either the integer or the " @@ -872,17 +867,18 @@ msgstr "" msgid "" "For numbers ``x`` and ``y``, possibly of different types, it's a requirement " -"that ``hash(x) == hash(y)`` whenever ``x == y`` (see the :meth:`~object." -"__hash__` method documentation for more details). For ease of " -"implementation and efficiency across a variety of numeric types (including :" -"class:`int`, :class:`float`, :class:`decimal.Decimal` and :class:`fractions." -"Fraction`) Python's hash for numeric types is based on a single mathematical " -"function that's defined for any rational number, and hence applies to all " -"instances of :class:`int` and :class:`fractions.Fraction`, and all finite " -"instances of :class:`float` and :class:`decimal.Decimal`. Essentially, this " -"function is given by reduction modulo ``P`` for a fixed prime ``P``. The " -"value of ``P`` is made available to Python as the :attr:`~sys.hash_info." -"modulus` attribute of :data:`sys.hash_info`." +"that ``hash(x) == hash(y)`` whenever ``x == y`` (see " +"the :meth:`~object.__hash__` method documentation for more details). For " +"ease of implementation and efficiency across a variety of numeric types " +"(including :class:`int`, :class:`float`, :class:`decimal.Decimal` " +"and :class:`fractions.Fraction`) Python's hash for numeric types is based on " +"a single mathematical function that's defined for any rational number, and " +"hence applies to all instances of :class:`int` " +"and :class:`fractions.Fraction`, and all finite instances of :class:`float` " +"and :class:`decimal.Decimal`. Essentially, this function is given by " +"reduction modulo ``P`` for a fixed prime ``P``. The value of ``P`` is made " +"available to Python as the :attr:`~sys.hash_info.modulus` attribute " +"of :data:`sys.hash_info`." msgstr "" msgid "" @@ -919,16 +915,17 @@ msgstr "" msgid "" "For a :class:`complex` number ``z``, the hash values of the real and " -"imaginary parts are combined by computing ``hash(z.real) + sys.hash_info." -"imag * hash(z.imag)``, reduced modulo ``2**sys.hash_info.width`` so that it " -"lies in ``range(-2**(sys.hash_info.width - 1), 2**(sys.hash_info.width - " -"1))``. Again, if the result is ``-1``, it's replaced with ``-2``." +"imaginary parts are combined by computing ``hash(z.real) + " +"sys.hash_info.imag * hash(z.imag)``, reduced modulo " +"``2**sys.hash_info.width`` so that it lies in " +"``range(-2**(sys.hash_info.width - 1), 2**(sys.hash_info.width - 1))``. " +"Again, if the result is ``-1``, it's replaced with ``-2``." msgstr "" msgid "" "To clarify the above rules, here's some example Python code, equivalent to " -"the built-in hash, for computing the hash of a rational number, :class:" -"`float`, or :class:`complex`::" +"the built-in hash, for computing the hash of a rational " +"number, :class:`float`, or :class:`complex`::" msgstr "" msgid "" @@ -972,8 +969,8 @@ msgid "" "def hash_complex(z):\n" " \"\"\"Compute the hash of a complex number z.\"\"\"\n" "\n" -" hash_value = hash_float(z.real) + sys.hash_info.imag * hash_float(z." -"imag)\n" +" hash_value = hash_float(z.real) + sys.hash_info.imag * " +"hash_float(z.imag)\n" " # do a signed reduction modulo 2**sys.hash_info.width\n" " M = 2**(sys.hash_info.width - 1)\n" " hash_value = (hash_value & (M - 1)) - (hash_value & M)\n" @@ -1026,8 +1023,8 @@ msgid "" msgstr "" msgid "" -"One method needs to be defined for container objects to provide :term:" -"`iterable` support:" +"One method needs to be defined for container objects to " +"provide :term:`iterable` support:" msgstr "" msgid "" @@ -1036,9 +1033,9 @@ msgid "" "of iteration, additional methods can be provided to specifically request " "iterators for those iteration types. (An example of an object supporting " "multiple forms of iteration would be a tree structure which supports both " -"breadth-first and depth-first traversal.) This method corresponds to the :c:" -"member:`~PyTypeObject.tp_iter` slot of the type structure for Python objects " -"in the Python/C API." +"breadth-first and depth-first traversal.) This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iter` slot of the type structure for Python " +"objects in the Python/C API." msgstr "" msgid "" @@ -1048,9 +1045,10 @@ msgstr "" msgid "" "Return the :term:`iterator` object itself. This is required to allow both " -"containers and iterators to be used with the :keyword:`for` and :keyword:" -"`in` statements. This method corresponds to the :c:member:`~PyTypeObject." -"tp_iter` slot of the type structure for Python objects in the Python/C API." +"containers and iterators to be used with the :keyword:`for` " +"and :keyword:`in` statements. This method corresponds to " +"the :c:member:`~PyTypeObject.tp_iter` slot of the type structure for Python " +"objects in the Python/C API." msgstr "" msgid "" @@ -1068,8 +1066,8 @@ msgid "" msgstr "" msgid "" -"Once an iterator's :meth:`~iterator.__next__` method raises :exc:" -"`StopIteration`, it must continue to do so on subsequent calls. " +"Once an iterator's :meth:`~iterator.__next__` method " +"raises :exc:`StopIteration`, it must continue to do so on subsequent calls. " "Implementations that do not obey this property are deemed broken." msgstr "" @@ -1080,10 +1078,10 @@ msgid "" "Python's :term:`generator`\\s provide a convenient way to implement the " "iterator protocol. If a container object's :meth:`~object.__iter__` method " "is implemented as a generator, it will automatically return an iterator " -"object (technically, a generator object) supplying the :meth:`~iterator." -"__iter__` and :meth:`~generator.__next__` methods. More information about " -"generators can be found in :ref:`the documentation for the yield expression " -"`." +"object (technically, a generator object) supplying " +"the :meth:`~iterator.__iter__` and :meth:`~generator.__next__` methods. More " +"information about generators can be found in :ref:`the documentation for the " +"yield expression `." msgstr "" msgid "Sequence Types --- :class:`list`, :class:`tuple`, :class:`range`" @@ -1121,7 +1119,7 @@ msgid "" msgstr "" msgid "``x in s``" -msgstr "" +msgstr "``x in s``" msgid "``True`` if an item of *s* is equal to *x*, else ``False``" msgstr "" @@ -1156,6 +1154,9 @@ msgstr "``s[i]``" msgid "*i*\\ th item of *s*, origin 0" msgstr "" +msgid "(3)(8)" +msgstr "" + msgid "``s[i:j]``" msgstr "``s[i:j]``" @@ -1192,23 +1193,6 @@ msgstr "``max(s)``" msgid "largest item of *s*" msgstr "" -msgid "``s.index(x[, i[, j]])``" -msgstr "``s.index(x[, i[, j]])``" - -msgid "" -"index of the first occurrence of *x* in *s* (at or after index *i* and " -"before index *j*)" -msgstr "" - -msgid "\\(8)" -msgstr "" - -msgid "``s.count(x)``" -msgstr "``s.count(x)``" - -msgid "total number of occurrences of *x* in *s*" -msgstr "" - msgid "" "Sequences of the same type also support comparisons. In particular, tuples " "and lists are compared lexicographically by comparing corresponding " @@ -1220,9 +1204,9 @@ msgstr "" msgid "" "Forward and reversed iterators over mutable sequences access values using an " "index. That index will continue to march forward (or backward) even if the " -"underlying sequence is mutated. The iterator terminates only when an :exc:" -"`IndexError` or a :exc:`StopIteration` is encountered (or when the index " -"drops below zero)." +"underlying sequence is mutated. The iterator terminates only when " +"an :exc:`IndexError` or a :exc:`StopIteration` is encountered (or when the " +"index drops below zero)." msgstr "" msgid "" @@ -1284,10 +1268,22 @@ msgstr "" msgid "" "The slice of *s* from *i* to *j* is defined as the sequence of items with " -"index *k* such that ``i <= k < j``. If *i* or *j* is greater than " -"``len(s)``, use ``len(s)``. If *i* is omitted or ``None``, use ``0``. If " -"*j* is omitted or ``None``, use ``len(s)``. If *i* is greater than or equal " -"to *j*, the slice is empty." +"index *k* such that ``i <= k < j``." +msgstr "" + +msgid "If *i* is omitted or ``None``, use ``0``." +msgstr "" + +msgid "If *j* is omitted or ``None``, use ``len(s)``." +msgstr "" + +msgid "If *i* or *j* is less than ``-len(s)``, use ``0``." +msgstr "" + +msgid "If *i* or *j* is greater than ``len(s)``, use ``len(s)``." +msgstr "" + +msgid "If *i* is greater than or equal to *j*, the slice is empty." msgstr "" msgid "" @@ -1310,16 +1306,16 @@ msgid "" msgstr "" msgid "" -"if concatenating :class:`str` objects, you can build a list and use :meth:" -"`str.join` at the end or else write to an :class:`io.StringIO` instance and " -"retrieve its value when complete" +"if concatenating :class:`str` objects, you can build a list and " +"use :meth:`str.join` at the end or else write to an :class:`io.StringIO` " +"instance and retrieve its value when complete" msgstr "" msgid "" -"if concatenating :class:`bytes` objects, you can similarly use :meth:`bytes." -"join` or :class:`io.BytesIO`, or you can do in-place concatenation with a :" -"class:`bytearray` object. :class:`bytearray` objects are mutable and have " -"an efficient overallocation mechanism" +"if concatenating :class:`bytes` objects, you can similarly " +"use :meth:`bytes.join` or :class:`io.BytesIO`, or you can do in-place " +"concatenation with a :class:`bytearray` object. :class:`bytearray` objects " +"are mutable and have an efficient overallocation mechanism" msgstr "" msgid "if concatenating :class:`tuple` objects, extend a :class:`list` instead" @@ -1334,13 +1330,33 @@ msgid "" "concatenation or repetition." msgstr "" +msgid "An :exc:`IndexError` is raised if *i* is outside the sequence range." +msgstr "" + +msgid "Sequence Methods" +msgstr "" + +msgid "Sequence types also support the following methods:" +msgstr "" + +msgid "Return the total number of occurrences of *value* in *sequence*." +msgstr "" + +msgid "Return the index of the first occurrence of *value* in *sequence*." +msgstr "" + +msgid "Raises :exc:`ValueError` if *value* is not found in *sequence*." +msgstr "" + msgid "" -"``index`` raises :exc:`ValueError` when *x* is not found in *s*. Not all " -"implementations support passing the additional arguments *i* and *j*. These " -"arguments allow efficient searching of subsections of the sequence. Passing " -"the extra arguments is roughly equivalent to using ``s[i:j].index(x)``, only " -"without copying any data and with the returned index being relative to the " -"start of the sequence rather than the start of the slice." +"The *start* or *stop* arguments allow for efficient searching of subsections " +"of the sequence, beginning at *start* and ending at *stop*. This is roughly " +"equivalent to ``start + sequence[start:stop].index(value)``, only without " +"copying any data." +msgstr "" + +msgid "" +"Not all sequence types support passing the *start* and *stop* arguments." msgstr "" msgid "Immutable Sequence Types" @@ -1348,14 +1364,14 @@ msgstr "" msgid "" "The only operation that immutable sequence types generally implement that is " -"not also implemented by mutable sequence types is support for the :func:" -"`hash` built-in." +"not also implemented by mutable sequence types is support for " +"the :func:`hash` built-in." msgstr "" msgid "" "This support allows immutable sequences, such as :class:`tuple` instances, " -"to be used as :class:`dict` keys and stored in :class:`set` and :class:" -"`frozenset` instances." +"to be used as :class:`dict` keys and stored in :class:`set` " +"and :class:`frozenset` instances." msgstr "" msgid "" @@ -1385,9 +1401,15 @@ msgstr "``s[i] = x``" msgid "item *i* of *s* is replaced by *x*" msgstr "" -msgid "``s[i:j] = t``" +msgid "``del s[i]``" +msgstr "``del s[i]``" + +msgid "removes item *i* of *s*" msgstr "" +msgid "``s[i:j] = t``" +msgstr "``s[i:j] = t``" + msgid "" "slice of *s* from *i* to *j* is replaced by the contents of the iterable *t*" msgstr "" @@ -1395,11 +1417,12 @@ msgstr "" msgid "``del s[i:j]``" msgstr "``del s[i:j]``" -msgid "same as ``s[i:j] = []``" +msgid "" +"removes the elements of ``s[i:j]`` from the list (same as ``s[i:j] = []``)" msgstr "" msgid "``s[i:j:k] = t``" -msgstr "" +msgstr "``s[i:j:k] = t``" msgid "the elements of ``s[i:j:k]`` are replaced by those of *t*" msgstr "" @@ -1410,26 +1433,7 @@ msgstr "``del s[i:j:k]``" msgid "removes the elements of ``s[i:j:k]`` from the list" msgstr "" -msgid "``s.append(x)``" -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 "``s.clear()``" - -msgid "removes all items from *s* (same as ``del s[:]``)" -msgstr "" - -msgid "``s.copy()``" -msgstr "``s.copy()``" - -msgid "creates a shallow copy of *s* (same as ``s[:]``)" -msgstr "" - -msgid "``s.extend(t)`` or ``s += t``" +msgid "``s += t``" msgstr "" msgid "" @@ -1443,66 +1447,68 @@ msgstr "``s *= n``" msgid "updates *s* with its contents repeated *n* times" msgstr "" -msgid "``s.insert(i, x)``" -msgstr "``s.insert(i, x)``" - msgid "" -"inserts *x* into *s* at the index given by *i* (same as ``s[i:i] = [x]``)" +"If *k* is not equal to ``1``, *t* must have the same length as the slice it " +"is replacing." msgstr "" -msgid "``s.pop()`` or ``s.pop(i)``" +msgid "" +"The value *n* is an integer, or an object " +"implementing :meth:`~object.__index__`. Zero and negative values of *n* " +"clear the sequence. Items in the sequence are not copied; they are " +"referenced multiple times, as explained for ``s * n`` under :ref:`typesseq-" +"common`." msgstr "" -msgid "retrieves the item at *i* and also removes it from *s*" +msgid "Mutable Sequence Methods" msgstr "" -msgid "``s.remove(x)``" -msgstr "``s.remove(x)``" - -msgid "removes the first item from *s* where ``s[i]`` is equal to *x*" +msgid "Mutable sequence types also support the following methods:" msgstr "" -msgid "``s.reverse()``" -msgstr "``s.reverse()``" +msgid "" +"Append *value* to the end of the sequence. This is equivalent to writing " +"``seq[len(seq):len(seq)] = [value]``." +msgstr "" -msgid "reverses the items of *s* in place" +msgid "" +"Remove all items from *sequence*. This is equivalent to writing ``del " +"sequence[:]``." msgstr "" msgid "" -"If *k* is not equal to ``1``, *t* must have the same length as the slice it " -"is replacing." +"Create a shallow copy of *sequence*. This is equivalent to writing " +"``sequence[:]``." msgstr "" msgid "" -"The optional argument *i* defaults to ``-1``, so that by default the last " -"item is removed and returned." +"The :meth:`!copy` method is not part of " +"the :class:`~collections.abc.MutableSequence` :class:`~abc.ABC`, but most " +"concrete mutable sequence types provide it." msgstr "" -msgid ":meth:`remove` raises :exc:`ValueError` when *x* is not found in *s*." +msgid "" +"Extend *sequence* with the contents of *iterable*. For the most part, this " +"is the same as writing ``seq[len(seq):len(seq)] = iterable``." msgstr "" msgid "" -"The :meth:`reverse` method modifies the sequence in place for economy of " -"space when reversing a large sequence. To remind users that it operates by " -"side effect, it does not return the reversed sequence." +"Insert *value* into *sequence* at the given *index*. This is equivalent to " +"writing ``sequence[index:index] = [value]``." msgstr "" msgid "" -":meth:`clear` and :meth:`!copy` are included for consistency with the " -"interfaces of mutable containers that don't support slicing operations (such " -"as :class:`dict` and :class:`set`). :meth:`!copy` is not part of the :class:" -"`collections.abc.MutableSequence` ABC, but most concrete mutable sequence " -"classes provide it." +"Retrieve the item at *index* and also remove it from *sequence*. By default, " +"the last item in *sequence* is removed and returned." msgstr "" -msgid ":meth:`clear` and :meth:`!copy` methods." +msgid "Remove the first item from *sequence* where ``sequence[i] == value``." msgstr "" msgid "" -"The value *n* is an integer, or an object implementing :meth:`~object." -"__index__`. Zero and negative values of *n* clear the sequence. Items in " -"the sequence are not copied; they are referenced multiple times, as " -"explained for ``s * n`` under :ref:`typesseq-common`." +"Reverse the items of *sequence* in place. This method maintains economy of " +"space when reversing a large sequence. To remind users that it operates by " +"side-effect, it returns ``None``." msgstr "" msgid "Lists" @@ -1545,6 +1551,9 @@ msgid "" "in." msgstr "" +msgid "Lists are :ref:`generic ` over the types of their items." +msgstr "" + msgid "" "Lists implement all of the :ref:`common ` and :ref:`mutable " "` sequence operations. Lists also provide the following " @@ -1559,8 +1568,8 @@ msgid "" msgstr "" msgid "" -":meth:`sort` accepts two arguments that can only be passed by keyword (:ref:" -"`keyword-only arguments `):" +":meth:`sort` accepts two arguments that can only be passed by keyword " +"(:ref:`keyword-only arguments `):" msgstr "" msgid "" @@ -1600,8 +1609,8 @@ msgstr "" msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -"Przykłady sortowania i krótki samouczek sortowania można znaleźć na stronie :" -"ref:`sortinghowto`." +"Przykłady sortowania i krótki samouczek sortowania można znaleźć na " +"stronie :ref:`sortinghowto`." msgid "" "While a list is being sorted, the effect of attempting to mutate, or even " @@ -1617,8 +1626,8 @@ msgid "" "Tuples are immutable sequences, typically used to store collections of " "heterogeneous data (such as the 2-tuples produced by the :func:`enumerate` " "built-in). Tuples are also used for cases where an immutable sequence of " -"homogeneous data is needed (such as allowing storage in a :class:`set` or :" -"class:`dict` instance)." +"homogeneous data is needed (such as allowing storage in a :class:`set` " +"or :class:`dict` instance)." msgstr "" msgid "Tuples may be constructed in a number of ways:" @@ -1663,6 +1672,12 @@ msgid "" "operations." msgstr "" +msgid "" +"Tuples are :ref:`generic ` over the types of their contents. For " +"more information, refer to :ref:`the typing documentation on annotating " +"tuples `." +msgstr "" + msgid "" "For heterogeneous collections of data where access by name is clearer than " "access by index, :func:`collections.namedtuple` may be a more appropriate " @@ -1678,8 +1693,8 @@ msgid "" msgstr "" msgid "" -"The arguments to the range constructor must be integers (either built-in :" -"class:`int` or any object that implements the :meth:`~object.__index__` " +"The arguments to the range constructor must be integers (either built-" +"in :class:`int` or any object that implements the :meth:`~object.__index__` " "special method). If the *step* argument is omitted, it defaults to ``1``. " "If the *start* argument is omitted, it defaults to ``0``. If *step* is " "zero, :exc:`ValueError` is raised." @@ -1704,8 +1719,8 @@ msgstr "" msgid "" "Ranges containing absolute values larger than :data:`sys.maxsize` are " -"permitted but some features (such as :func:`len`) may raise :exc:" -"`OverflowError`." +"permitted but some features (such as :func:`len`) may " +"raise :exc:`OverflowError`." msgstr "" msgid "Range examples::" @@ -1749,8 +1764,8 @@ msgid "" msgstr "" msgid "" -"The advantage of the :class:`range` type over a regular :class:`list` or :" -"class:`tuple` is that a :class:`range` object will always take the same " +"The advantage of the :class:`range` type over a regular :class:`list` " +"or :class:`tuple` is that a :class:`range` object will always take the same " "(small) amount of memory, no matter the size of the range it represents (as " "it only stores the ``start``, ``stop`` and ``step`` values, calculating " "individual items and subranges as needed)." @@ -1772,9 +1787,9 @@ msgid "" msgstr "" msgid "" -"Implement the Sequence ABC. Support slicing and negative indices. Test :" -"class:`int` objects for membership in constant time instead of iterating " -"through all items." +"Implement the Sequence ABC. Support slicing and negative indices. " +"Test :class:`int` objects for membership in constant time instead of " +"iterating through all items." msgstr "" msgid "" @@ -1797,9 +1812,9 @@ msgid "Text Sequence Type --- :class:`str`" msgstr "" msgid "" -"Textual data in Python is handled with :class:`str` objects, or :dfn:" -"`strings`. Strings are immutable :ref:`sequences ` of Unicode code " -"points. String literals are written in a variety of ways:" +"Textual data in Python is handled with :class:`str` objects, " +"or :dfn:`strings`. Strings are immutable :ref:`sequences ` of " +"Unicode code points. String literals are written in a variety of ways:" msgstr "" msgid "Single quotes: ``'allows embedded \"double\" quotes'``" @@ -1841,9 +1856,9 @@ msgid "" msgstr "" msgid "" -"There is also no mutable string type, but :meth:`str.join` or :class:`io." -"StringIO` can be used to efficiently construct strings from multiple " -"fragments." +"There is also no mutable string type, but :meth:`str.join` " +"or :class:`io.StringIO` can be used to efficiently construct strings from " +"multiple fragments." msgstr "" msgid "" @@ -1859,23 +1874,23 @@ msgid "" msgstr "" msgid "" -"If neither *encoding* nor *errors* is given, ``str(object)`` returns :meth:" -"`type(object).__str__(object) `, which is the \"informal\" " -"or nicely printable string representation of *object*. For string objects, " -"this is the string itself. If *object* does not have a :meth:`~object." -"__str__` method, then :func:`str` falls back to returning :func:" -"`repr(object) `." +"If neither *encoding* nor *errors* is given, ``str(object)`` " +"returns :meth:`type(object).__str__(object) `, which is the " +"\"informal\" or nicely printable string representation of *object*. For " +"string objects, this is the string itself. If *object* does not have " +"a :meth:`~object.__str__` method, then :func:`str` falls back to " +"returning :func:`repr(object) `." msgstr "" msgid "" -"If at least one of *encoding* or *errors* is given, *object* should be a :" -"term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " +"If at least one of *encoding* or *errors* is given, *object* should be " +"a :term:`bytes-like object` (e.g. :class:`bytes` or :class:`bytearray`). In " "this case, if *object* is a :class:`bytes` (or :class:`bytearray`) object, " -"then ``str(bytes, encoding, errors)`` is equivalent to :meth:`bytes." -"decode(encoding, errors) `. Otherwise, the bytes object " -"underlying the buffer object is obtained before calling :meth:`bytes." -"decode`. See :ref:`binaryseq` and :ref:`bufferobjects` for information on " -"buffer objects." +"then ``str(bytes, encoding, errors)`` is equivalent " +"to :meth:`bytes.decode(encoding, errors) `. Otherwise, the " +"bytes object underlying the buffer object is obtained before " +"calling :meth:`bytes.decode`. See :ref:`binaryseq` and :ref:`bufferobjects` " +"for information on buffer objects." msgstr "" msgid "" @@ -1893,10 +1908,10 @@ msgstr "" "\"b'Zoot!'\"" msgid "" -"For more information on the ``str`` class and its methods, see :ref:" -"`textseq` and the :ref:`string-methods` section below. To output formatted " -"strings, see the :ref:`f-strings` and :ref:`formatstrings` sections. In " -"addition, see the :ref:`stringservices` section." +"For more information on the ``str`` class and its methods, " +"see :ref:`textseq` and the :ref:`string-methods` section below. To output " +"formatted strings, see the :ref:`f-strings` and :ref:`formatstrings` " +"sections. In addition, see the :ref:`stringservices` section." msgstr "" msgid "String Methods" @@ -1909,11 +1924,11 @@ msgstr "" msgid "" "Strings also support two styles of string formatting, one providing a large " -"degree of flexibility and customization (see :meth:`str.format`, :ref:" -"`formatstrings` and :ref:`string-formatting`) and the other based on C " -"``printf`` style formatting that handles a narrower range of types and is " -"slightly harder to use correctly, but is often faster for the cases it can " -"handle (:ref:`old-string-formatting`)." +"degree of flexibility and customization " +"(see :meth:`str.format`, :ref:`formatstrings` and :ref:`string-formatting`) " +"and the other based on C ``printf`` style formatting that handles a narrower " +"range of types and is slightly harder to use correctly, but is often faster " +"for the cases it can handle (:ref:`old-string-formatting`)." msgstr "" msgid "" @@ -1942,8 +1957,15 @@ msgid "" "Casefolding is similar to lowercasing but more aggressive because it is " "intended to remove all case distinctions in a string. For example, the " "German lowercase letter ``'ß'`` is equivalent to ``\"ss\"``. Since it is " -"already lowercase, :meth:`lower` would do nothing to ``'ß'``; :meth:" -"`casefold` converts it to ``\"ss\"``." +"already lowercase, :meth:`lower` would do nothing to " +"``'ß'``; :meth:`casefold` converts it to ``\"ss\"``. For example:" +msgstr "" + +msgid "" +">>> 'straße'.lower()\n" +"'straße'\n" +">>> 'straße'.casefold()\n" +"'strasse'" msgstr "" msgid "" @@ -1955,7 +1977,16 @@ msgstr "" msgid "" "Return centered in a string of length *width*. Padding is done using the " "specified *fillchar* (default is an ASCII space). The original string is " -"returned if *width* is less than or equal to ``len(s)``." +"returned if *width* is less than or equal to ``len(s)``. For example::" +msgstr "" + +msgid "" +">>> 'Python'.center(10)\n" +"' Python '\n" +">>> 'Python'.center(10, '-')\n" +"'--Python--'\n" +">>> 'Python'.center(4)\n" +"'Python'" msgstr "" msgid "" @@ -1966,7 +1997,20 @@ msgstr "" msgid "" "If *sub* is empty, returns the number of empty strings between characters " -"which is the length of the string plus one." +"which is the length of the string plus one. For example::" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.count('spam')\n" +"3\n" +">>> 'spam, spam, spam'.count('spam', 5)\n" +"2\n" +">>> 'spam, spam, spam'.count('spam', 5, 10)\n" +"1\n" +">>> 'spam, spam, spam'.count('eggs')\n" +"0\n" +">>> 'spam, spam, spam'.count('')\n" +"17" msgstr "" msgid "Return the string encoded to :class:`bytes`." @@ -1981,29 +2025,52 @@ msgid "" "*errors* controls how encoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " "are ``'ignore'``, ``'replace'``, ``'xmlcharrefreplace'``, " -"``'backslashreplace'`` and any other name registered via :func:`codecs." -"register_error`. See :ref:`error-handlers` for details." +"``'backslashreplace'`` and any other name registered " +"via :func:`codecs.register_error`. See :ref:`error-handlers` for details." msgstr "" msgid "" "For performance reasons, the value of *errors* is not checked for validity " -"unless an encoding error actually occurs, :ref:`devmode` is enabled or a :" -"ref:`debug build ` is used." +"unless an encoding error actually occurs, :ref:`devmode` is enabled or " +"a :ref:`debug build ` is used. For example::" +msgstr "" + +msgid "" +">>> encoded_str_to_bytes = 'Python'.encode()\n" +">>> type(encoded_str_to_bytes)\n" +"\n" +">>> encoded_str_to_bytes\n" +"b'Python'" msgstr "" msgid "Added support for keyword arguments." msgstr "" msgid "" -"The value of the *errors* argument is now checked in :ref:`devmode` and in :" -"ref:`debug mode `." +"The value of the *errors* argument is now checked in :ref:`devmode` and " +"in :ref:`debug mode `." msgstr "" msgid "" "Return ``True`` if the string ends with the specified *suffix*, otherwise " "return ``False``. *suffix* can also be a tuple of suffixes to look for. " "With optional *start*, test beginning at that position. With optional " -"*end*, stop comparing at that position." +"*end*, stop comparing at that position. Using *start* and *end* is " +"equivalent to ``str[start:end].endswith(suffix)``. For example::" +msgstr "" + +msgid "" +">>> 'Python'.endswith('on')\n" +"True\n" +">>> 'a tuple of suffixes'.endswith(('at', 'in'))\n" +"False\n" +">>> 'a tuple of suffixes'.endswith(('at', 'es'))\n" +"True\n" +">>> 'Python is amazing'.endswith('is', 0, 9)\n" +"True" +msgstr "" + +msgid "See also :meth:`startswith` and :meth:`removesuffix`." msgstr "" msgid "" @@ -2018,19 +2085,40 @@ msgid "" "(``\\n``) or return (``\\r``), it is copied and the current column is reset " "to zero. Any other character is copied unchanged and the current column is " "incremented by one regardless of how the character is represented when " -"printed." +"printed. For example::" +msgstr "" + +msgid "" +">>> '01\\t012\\t0123\\t01234'.expandtabs()\n" +"'01 012 0123 01234'\n" +">>> '01\\t012\\t0123\\t01234'.expandtabs(4)\n" +"'01 012 0123 01234'\n" +">>> print('01\\t012\\n0123\\t01234'.expandtabs(4))\n" +"01 012\n" +"0123 01234" msgstr "" msgid "" "Return the lowest index in the string where substring *sub* is found within " "the slice ``s[start:end]``. Optional arguments *start* and *end* are " -"interpreted as in slice notation. Return ``-1`` if *sub* is not found." +"interpreted as in slice notation. Return ``-1`` if *sub* is not found. For " +"example::" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.find('sp')\n" +"0\n" +">>> 'spam, spam, spam'.find('sp', 5)\n" +"6" +msgstr "" + +msgid "See also :meth:`rfind` and :meth:`index`." msgstr "" msgid "" "The :meth:`~str.find` method should be used only if you need to know the " -"position of *sub*. To check if *sub* is a substring or not, use the :" -"keyword:`in` operator::" +"position of *sub*. To check if *sub* is a substring or not, use " +"the :keyword:`in` operator::" msgstr "" msgid "" @@ -2046,7 +2134,16 @@ msgid "" "``{}``. Each replacement field contains either the numeric index of a " "positional argument, or the name of a keyword argument. Returns a copy of " "the string where each replacement field is replaced with the string value of " -"the corresponding argument." +"the corresponding argument. For example:" +msgstr "" + +msgid "" +">>> \"The sum of 1 + 2 is {0}\".format(1+2)\n" +"'The sum of 1 + 2 is 3'\n" +">>> \"The sum of {a} + {b} is {answer}\".format(answer=1+2, a=1, b=2)\n" +"'The sum of 1 + 2 is 3'\n" +">>> \"{1} expects the {0} Inquisition!\".format(\"Spanish\", \"Nobody\")\n" +"'Nobody expects the Spanish Inquisition!'" msgstr "" msgid "" @@ -2055,13 +2152,14 @@ msgid "" msgstr "" msgid "" -"When formatting a number (:class:`int`, :class:`float`, :class:`complex`, :" -"class:`decimal.Decimal` and subclasses) with the ``n`` type (ex: ``'{:n}'." -"format(1234)``), the function temporarily sets the ``LC_CTYPE`` locale to " -"the ``LC_NUMERIC`` locale to decode ``decimal_point`` and ``thousands_sep`` " -"fields of :c:func:`localeconv` if they are non-ASCII or longer than 1 byte, " -"and the ``LC_NUMERIC`` locale is different than the ``LC_CTYPE`` locale. " -"This temporary change affects other threads." +"When formatting a number " +"(:class:`int`, :class:`float`, :class:`complex`, :class:`decimal.Decimal` " +"and subclasses) with the ``n`` type (ex: ``'{:n}'.format(1234)``), the " +"function temporarily sets the ``LC_CTYPE`` locale to the ``LC_NUMERIC`` " +"locale to decode ``decimal_point`` and ``thousands_sep`` fields " +"of :c:func:`localeconv` if they are non-ASCII or longer than 1 byte, and the " +"``LC_NUMERIC`` locale is different than the ``LC_CTYPE`` locale. This " +"temporary change affects other threads." msgstr "" msgid "" @@ -2077,39 +2175,93 @@ msgstr "" msgid "" "Like :meth:`~str.find`, but raise :exc:`ValueError` when the substring is " -"not found." +"not found. For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.index('spam')\n" +"0\n" +">>> 'spam, spam, spam'.index('eggs')\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +" 'spam, spam, spam'.index('eggs')\n" +" ~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^\n" +"ValueError: substring not found" +msgstr "" + +msgid "See also :meth:`rindex`." msgstr "" msgid "" "Return ``True`` if all characters in the string are alphanumeric and there " "is at least one character, ``False`` otherwise. A character ``c`` is " -"alphanumeric if one of the following returns ``True``: ``c.isalpha()``, ``c." -"isdecimal()``, ``c.isdigit()``, or ``c.isnumeric()``." +"alphanumeric if one of the following returns ``True``: ``c.isalpha()``, " +"``c.isdecimal()``, ``c.isdigit()``, or ``c.isnumeric()``. For example:" +msgstr "" + +msgid "" +">>> 'abc123'.isalnum()\n" +"True\n" +">>> 'abc123!@#'.isalnum()\n" +"False\n" +">>> ''.isalnum()\n" +"False\n" +">>> ' '.isalnum()\n" +"False" msgstr "" msgid "" "Return ``True`` if all characters in the string are alphabetic and there is " "at least one character, ``False`` otherwise. Alphabetic characters are " -"those characters defined in the Unicode character database as \"Letter\", i." -"e., those with general category property being one of \"Lm\", \"Lt\", " +"those characters defined in the Unicode character database as \"Letter\", " +"i.e., those with general category property being one of \"Lm\", \"Lt\", " "\"Lu\", \"Ll\", or \"Lo\". Note that this is different from the `Alphabetic " -"property defined in the section 4.10 'Letters, Alphabetic, and Ideographic' " -"of the Unicode Standard `_." +"property defined in section 4.10 'Letters, Alphabetic, and Ideographic' of " +"the Unicode Standard `_. For example:" +msgstr "" + +msgid "" +">>> 'Letters and spaces'.isalpha()\n" +"False\n" +">>> 'LettersOnly'.isalpha()\n" +"True\n" +">>> 'µ'.isalpha() # non-ASCII characters can be considered alphabetical " +"too\n" +"True" +msgstr "" + +msgid "See :ref:`unicode-properties`." msgstr "" msgid "" "Return ``True`` if the string is empty or all characters in the string are " "ASCII, ``False`` otherwise. ASCII characters have code points in the range " -"U+0000-U+007F." +"U+0000-U+007F. For example:" +msgstr "" + +msgid "" +">>> 'ASCII characters'.isascii()\n" +"True\n" +">>> 'µ'.isascii()\n" +"False" msgstr "" msgid "" "Return ``True`` if all characters in the string are decimal characters and " "there is at least one character, ``False`` otherwise. Decimal characters are " -"those that can be used to form numbers in base 10, e.g. U+0660, ARABIC-INDIC " -"DIGIT ZERO. Formally a decimal character is a character in the Unicode " -"General Category \"Nd\"." +"those that can be used to form numbers in base 10, such as U+0660, ARABIC-" +"INDIC DIGIT ZERO. Formally a decimal character is a character in the " +"Unicode General Category \"Nd\". For example:" +msgstr "" + +msgid "" +">>> '0123456789'.isdecimal()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isdecimal() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> 'alphabetic'.isdecimal()\n" +"False" msgstr "" msgid "" @@ -2117,10 +2269,28 @@ msgid "" "least one character, ``False`` otherwise. Digits include decimal characters " "and digits that need special handling, such as the compatibility superscript " "digits. This covers digits which cannot be used to form numbers in base 10, " -"like the Kharosthi numbers. Formally, a digit is a character that has the " +"like the `Kharosthi numbers `__. Formally, a digit is a character that has the " "property value Numeric_Type=Digit or Numeric_Type=Decimal." msgstr "" +msgid "For example:" +msgstr "Na przykład::" + +msgid "" +">>> '0123456789'.isdigit()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isdigit() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> '⅕'.isdigit() # Vulgar fraction one fifth\n" +"False\n" +">>> '²'.isdecimal(), '²'.isdigit(), '²'.isnumeric()\n" +"(False, True, True)" +msgstr "" + +msgid "See also :meth:`isdecimal` and :meth:`isnumeric`." +msgstr "" + msgid "" "Return ``True`` if the string is a valid identifier according to the " "language definition, section :ref:`identifiers`." @@ -2154,12 +2324,26 @@ msgid "" "include digit characters, and all characters that have the Unicode numeric " "value property, e.g. U+2155, VULGAR FRACTION ONE FIFTH. Formally, numeric " "characters are those with the property value Numeric_Type=Digit, " -"Numeric_Type=Decimal or Numeric_Type=Numeric." +"Numeric_Type=Decimal or Numeric_Type=Numeric. For example:" msgstr "" msgid "" -"Return true if all characters in the string are printable, false if it " -"contains at least one non-printable character." +">>> '0123456789'.isnumeric()\n" +"True\n" +">>> '٠١٢٣٤٥٦٧٨٩'.isnumeric() # Arabic-Indic digits zero to nine\n" +"True\n" +">>> '⅕'.isnumeric() # Vulgar fraction one fifth\n" +"True\n" +">>> '²'.isdecimal(), '²'.isdigit(), '²'.isnumeric()\n" +"(False, True, True)" +msgstr "" + +msgid "See also :meth:`isdecimal` and :meth:`isdigit`." +msgstr "" + +msgid "" +"Return ``True`` if all characters in the string are printable, ``False`` if " +"it contains at least one non-printable character." msgstr "" msgid "" @@ -2177,15 +2361,40 @@ msgid "" "C), except the ASCII space." msgstr "" +msgid "" +">>> ''.isprintable(), ' '.isprintable()\n" +"(True, True)\n" +">>> '\\t'.isprintable(), '\\n'.isprintable()\n" +"(False, False)" +msgstr "" + +msgid "See also :meth:`isspace`." +msgstr "" + msgid "" "Return ``True`` if there are only whitespace characters in the string and " "there is at least one character, ``False`` otherwise." msgstr "" msgid "" -"A character is *whitespace* if in the Unicode character database (see :mod:" -"`unicodedata`), either its general category is ``Zs`` (\"Separator, " -"space\"), or its bidirectional class is one of ``WS``, ``B``, or ``S``." +">>> ''.isspace()\n" +"False\n" +">>> ' '.isspace()\n" +"True\n" +">>> '\\t\\n'.isspace() # TAB and BREAK LINE\n" +"True\n" +">>> '\\u3000'.isspace() # IDEOGRAPHIC SPACE\n" +"True" +msgstr "" + +msgid "" +"A character is *whitespace* if in the Unicode character database " +"(see :mod:`unicodedata`), either its general category is ``Zs`` " +"(\"Separator, space\"), or its bidirectional class is one of ``WS``, ``B``, " +"or ``S``." +msgstr "" + +msgid "See also :meth:`isprintable`." msgstr "" msgid "" @@ -2195,16 +2404,38 @@ msgid "" "otherwise." msgstr "" +msgid "" +">>> 'Spam, Spam, Spam'.istitle()\n" +"True\n" +">>> 'spam, spam, spam'.istitle()\n" +"False\n" +">>> 'SPAM, SPAM, SPAM'.istitle()\n" +"False" +msgstr "" + +msgid "See also :meth:`title`." +msgstr "" + msgid "" "Return ``True`` if all cased characters [4]_ in the string are uppercase and " "there is at least one cased character, ``False`` otherwise." msgstr "" msgid "" -"Return a string which is the concatenation of the strings in *iterable*. A :" -"exc:`TypeError` will be raised if there are any non-string values in " +"Return a string which is the concatenation of the strings in *iterable*. " +"A :exc:`TypeError` will be raised if there are any non-string values in " "*iterable*, including :class:`bytes` objects. The separator between " -"elements is the string providing this method." +"elements is the string providing this method. For example:" +msgstr "" + +msgid "" +">>> ', '.join(['spam', 'spam', 'spam'])\n" +"'spam, spam, spam'\n" +">>> '-'.join('Python')\n" +"'P-y-t-h-o-n'" +msgstr "" + +msgid "See also :meth:`split`." msgstr "" msgid "" @@ -2213,9 +2444,26 @@ msgid "" "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" +msgid "" +">>> 'Python'.ljust(10)\n" +"'Python '\n" +">>> 'Python'.ljust(10, '.')\n" +"'Python....'\n" +">>> 'Monty Python'.ljust(10, '.')\n" +"'Monty Python'" +msgstr "" + +msgid "See also :meth:`rjust`." +msgstr "" + msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " -"lowercase." +"lowercase. For example:" +msgstr "" + +msgid "" +">>> 'Lower Method Example'.lower()\n" +"'lower method example'" msgstr "" msgid "" @@ -2260,8 +2508,8 @@ msgstr "" "'three!'" msgid "" -"This static method returns a translation table usable for :meth:`str." -"translate`." +"This static method returns a translation table usable " +"for :meth:`str.translate`." msgstr "" msgid "" @@ -2273,9 +2521,9 @@ msgstr "" msgid "" "If there are two arguments, they must be strings of equal length, and in the " -"resulting dictionary, each character in x will be mapped to the character at " -"the same position in y. If there is a third argument, it must be a string, " -"whose characters will be mapped to ``None`` in the result." +"resulting dictionary, each character in *from* will be mapped to the " +"character at the same position in *to*. If there is a third argument, it " +"must be a string, whose characters will be mapped to ``None`` in the result." msgstr "" msgid "" @@ -2285,9 +2533,21 @@ msgid "" "containing the string itself, followed by two empty strings." msgstr "" +msgid "" +">>> 'Monty Python'.partition(' ')\n" +"('Monty', ' ', 'Python')\n" +">>> \"Monty Python's Flying Circus\".partition(' ')\n" +"('Monty', ' ', \"Python's Flying Circus\")\n" +">>> 'Monty Python'.partition('-')\n" +"('Monty Python', '', '')" +msgstr "" + +msgid "See also :meth:`rpartition`." +msgstr "" + msgid "" "If the string starts with the *prefix* string, return " -"``string[len(prefix):]``. Otherwise, return a copy of the original string::" +"``string[len(prefix):]``. Otherwise, return a copy of the original string:" msgstr "" msgid "" @@ -2301,10 +2561,13 @@ msgstr "" ">>> 'BaseTestCase'.removeprefix('Test')\n" "'BaseTestCase'" +msgid "See also :meth:`removesuffix` and :meth:`startswith`." +msgstr "" + msgid "" "If the string ends with the *suffix* string and that *suffix* is not empty, " "return ``string[:-len(suffix)]``. Otherwise, return a copy of the original " -"string::" +"string:" msgstr "" msgid "" @@ -2318,11 +2581,21 @@ msgstr "" ">>> 'TmpDirMixin'.removesuffix('Tests')\n" "'TmpDirMixin'" +msgid "See also :meth:`removeprefix` and :meth:`endswith`." +msgstr "" + msgid "" "Return a copy of the string with all occurrences of substring *old* replaced " "by *new*. If *count* is given, only the first *count* occurrences are " "replaced. If *count* is not specified or ``-1``, then all occurrences are " -"replaced." +"replaced. For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.replace('spam', 'eggs')\n" +"'eggs, eggs, eggs'\n" +">>> 'spam, spam, spam'.replace('spam', 'eggs', 1)\n" +"'eggs, spam, spam'" msgstr "" msgid "*count* is now supported as a keyword argument." @@ -2331,12 +2604,37 @@ msgstr "" msgid "" "Return the highest index in the string where substring *sub* is found, such " "that *sub* is contained within ``s[start:end]``. Optional arguments *start* " -"and *end* are interpreted as in slice notation. Return ``-1`` on failure." +"and *end* are interpreted as in slice notation. Return ``-1`` on failure. " +"For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.rfind('sp')\n" +"12\n" +">>> 'spam, spam, spam'.rfind('sp', 0, 10)\n" +"6" +msgstr "" + +msgid "See also :meth:`find` and :meth:`rindex`." msgstr "" msgid "" "Like :meth:`rfind` but raises :exc:`ValueError` when the substring *sub* is " -"not found." +"not found. For example:" +msgstr "" + +msgid "" +">>> 'spam, spam, spam'.rindex('spam')\n" +"12\n" +">>> 'spam, spam, spam'.rindex('eggs')\n" +"Traceback (most recent call last):\n" +" File \"\", line 1, in \n" +" 'spam, spam, spam'.rindex('eggs')\n" +" ~~~~~~~~~~~~~~~~~~~~~~~~~^^^^^^^^\n" +"ValueError: substring not found" +msgstr "" + +msgid "See also :meth:`index` and :meth:`find`." msgstr "" msgid "" @@ -2345,6 +2643,18 @@ msgid "" "original string is returned if *width* is less than or equal to ``len(s)``." msgstr "" +msgid "" +">>> 'Python'.rjust(10)\n" +"' Python'\n" +">>> 'Python'.rjust(10, '.')\n" +"'....Python'\n" +">>> 'Monty Python'.rjust(10, '.')\n" +"'Monty Python'" +msgstr "" + +msgid "See also :meth:`ljust` and :meth:`zfill`." +msgstr "" + msgid "" "Split the string at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " @@ -2352,12 +2662,25 @@ msgid "" "containing two empty strings, followed by the string itself." msgstr "" +msgid "" +">>> 'Monty Python'.rpartition(' ')\n" +"('Monty', ' ', 'Python')\n" +">>> \"Monty Python's Flying Circus\".rpartition(' ')\n" +"(\"Monty Python's Flying\", ' ', 'Circus')\n" +">>> 'Monty Python'.rpartition('-')\n" +"('', '', 'Monty Python')" +msgstr "" + +msgid "See also :meth:`partition`." +msgstr "" + msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done, the " -"*rightmost* ones. If *sep* is not specified or ``None``, any whitespace " -"string is a separator. Except for splitting from the right, :meth:`rsplit` " -"behaves like :meth:`split` which is described in detail below." +"*rightmost* ones. If *sep* is not specified or ``None``, " +"any :meth:`whitespace ` string is a separator. Except for " +"splitting from the right, :meth:`rsplit` behaves like :meth:`split` which is " +"described in detail below." msgstr "" msgid "" @@ -2365,7 +2688,7 @@ msgid "" "argument is a string specifying the set of characters to be removed. If " "omitted or ``None``, the *chars* argument defaults to removing whitespace. " "The *chars* argument is not a suffix; rather, all combinations of its values " -"are stripped::" +"are stripped. For example:" msgstr "" msgid "" @@ -2380,7 +2703,7 @@ msgstr "" "'mississ'" msgid "" -"See :meth:`str.removesuffix` for a method that will remove a single suffix " +"See :meth:`removesuffix` for a method that will remove a single suffix " "string rather than all of a set of characters. For example::" msgstr "" @@ -2395,6 +2718,9 @@ msgstr "" ">>> 'Monty Python'.removesuffix(' Python')\n" "'Monty'" +msgid "See also :meth:`strip`." +msgstr "" + msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done (thus, " @@ -2407,14 +2733,11 @@ msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " "``['1', '', '2']``). The *sep* argument may consist of multiple characters " -"as a single delimiter (to split with multiple delimiters, use :func:`re." -"split`). Splitting an empty string with a specified separator returns " -"``['']``." +"as a single delimiter (to split with multiple delimiters, " +"use :func:`re.split`). Splitting an empty string with a specified separator " +"returns ``['']``." msgstr "" -msgid "For example::" -msgstr "Dla przykładu::" - msgid "" ">>> '1,2,3'.split(',')\n" "['1', '2', '3']\n" @@ -2428,11 +2751,11 @@ msgstr "" msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " -"applied: runs of consecutive whitespace are regarded as a single separator, " -"and the result will contain no empty strings at the start or end if the " -"string has leading or trailing whitespace. Consequently, splitting an empty " -"string or a string consisting of just whitespace with a ``None`` separator " -"returns ``[]``." +"applied: runs of consecutive :meth:`whitespace ` are regarded " +"as a single separator, and the result will contain no empty strings at the " +"start or end if the string has leading or trailing whitespace. " +"Consequently, splitting an empty string or a string consisting of just " +"whitespace with a ``None`` separator returns ``[]``." msgstr "" msgid "" @@ -2444,6 +2767,23 @@ msgid "" "['1', '2', '3']" msgstr "" +msgid "" +"If *sep* is not specified or is ``None`` and *maxsplit* is ``0``, only " +"leading runs of consecutive whitespace are considered." +msgstr "" + +msgid "" +">>> \"\".split(None, 0)\n" +"[]\n" +">>> \" \".split(None, 0)\n" +"[]\n" +">>> \" foo \".split(maxsplit=0)\n" +"['foo ']" +msgstr "" + +msgid "See also :meth:`join` and :meth:`rsplit`." +msgstr "" + msgid "" "Return a list of the lines in the string, breaking at line boundaries. Line " "breaks are not included in the resulting list unless *keepends* is given and " @@ -2530,6 +2870,9 @@ msgstr "" msgid "``\\v`` and ``\\f`` added to list of line boundaries." msgstr "" +msgid "For example::" +msgstr "Dla przykładu::" + msgid "" ">>> 'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines()\n" "['ab c', '', 'de fg', 'kl']\n" @@ -2575,12 +2918,27 @@ msgid "" "*end*, stop comparing string at that position." msgstr "" +msgid "" +">>> 'Python'.startswith('Py')\n" +"True\n" +">>> 'a tuple of prefixes'.startswith(('at', 'a'))\n" +"True\n" +">>> 'Python is amazing'.startswith('is', 7)\n" +"True" +msgstr "" + +msgid "See also :meth:`endswith` and :meth:`removeprefix`." +msgstr "" + msgid "" "Return a copy of the string with the leading and trailing characters " "removed. The *chars* argument is a string specifying the set of characters " "to be removed. If omitted or ``None``, the *chars* argument defaults to " "removing whitespace. The *chars* argument is not a prefix or suffix; rather, " -"all combinations of its values are stripped::" +"all combinations of its values are stripped." +msgstr "" + +msgid "Whitespace characters are defined by :meth:`str.isspace`." msgstr "" msgid "" @@ -2598,7 +2956,7 @@ msgid "" "The outermost leading and trailing *chars* argument values are stripped from " "the string. Characters are removed from the leading end until reaching a " "string character that is not contained in the set of characters in *chars*. " -"A similar action takes place on the trailing end. For example::" +"A similar action takes place on the trailing end." msgstr "" msgid "" @@ -2607,10 +2965,30 @@ msgid "" "'Section 3.2.1 Issue #32'" msgstr "" +msgid "See also :meth:`rstrip`." +msgstr "" + msgid "" "Return a copy of the string with uppercase characters converted to lowercase " -"and vice versa. Note that it is not necessarily true that ``s.swapcase()." -"swapcase() == s``." +"and vice versa. For example:" +msgstr "" + +msgid "" +">>> 'Hello World'.swapcase()\n" +"'hELLO wORLD'" +msgstr "" + +msgid "" +"Note that it is not necessarily true that ``s.swapcase().swapcase() == s``. " +"For example:" +msgstr "" + +msgid "" +">>> 'straße'.swapcase().swapcase()\n" +"'strasse'" +msgstr "" + +msgid "See also :meth:`str.lower` and :meth:`str.upper`." msgstr "" msgid "" @@ -2660,15 +3038,18 @@ msgid "" "\"They're Bill's Friends.\"" msgstr "" +msgid "See also :meth:`istitle`." +msgstr "" + msgid "" "Return a copy of the string in which each character has been mapped through " "the given translation table. The table must be an object that implements " -"indexing via :meth:`~object.__getitem__`, typically a :term:`mapping` or :" -"term:`sequence`. When indexed by a Unicode ordinal (an integer), the table " -"object can do any of the following: return a Unicode ordinal or a string, to " -"map the character to one or more other characters; return ``None``, to " -"delete the character from the return string; or raise a :exc:`LookupError` " -"exception, to map the character to itself." +"indexing via :meth:`~object.__getitem__`, typically a :term:`mapping` " +"or :term:`sequence`. When indexed by a Unicode ordinal (an integer), the " +"table object can do any of the following: return a Unicode ordinal or a " +"string, to map the character to one or more other characters; return " +"``None``, to delete the character from the return string; or raise " +"a :exc:`LookupError` exception, to map the character to itself." msgstr "" msgid "" @@ -2802,25 +3183,22 @@ msgid "Conversion" msgstr "" msgid "``!a``" -msgstr "" +msgstr "``!a``" msgid ":func:`ascii`" msgstr ":func:`ascii`" msgid "``!r``" -msgstr "" +msgstr "``!r``" msgid ":func:`repr`" msgstr ":func:`repr`" msgid "``!s``" -msgstr "" +msgstr "``!s``" msgid ":func:`str`" -msgstr "" - -msgid "For example:" -msgstr "Na przykład::" +msgstr ":func:`str`" msgid "" ">>> from fractions import Fraction\n" @@ -3102,6 +3480,12 @@ msgstr "``'%'``" msgid "No argument is converted, results in a ``'%'`` character in the result." msgstr "" +msgid "" +"For floating-point formats, the result should be correctly rounded to a " +"given precision ``p`` of digits after the decimal point. The rounding mode " +"matches that of the :func:`round` builtin." +msgstr "" + msgid "" "The alternate form causes a leading octal specifier (``'0o'``) to be " "inserted before the first digit." @@ -3150,15 +3534,15 @@ msgid "" msgstr "" msgid "" -"Binary Sequence Types --- :class:`bytes`, :class:`bytearray`, :class:" -"`memoryview`" +"Binary Sequence Types " +"--- :class:`bytes`, :class:`bytearray`, :class:`memoryview`" msgstr "" msgid "" -"The core built-in types for manipulating binary data are :class:`bytes` and :" -"class:`bytearray`. They are supported by :class:`memoryview` which uses the :" -"ref:`buffer protocol ` to access the memory of other binary " -"objects without needing to make a copy." +"The core built-in types for manipulating binary data are :class:`bytes` " +"and :class:`bytearray`. They are supported by :class:`memoryview` which uses " +"the :ref:`buffer protocol ` to access the memory of other " +"binary objects without needing to make a copy." msgstr "" msgid "" @@ -3329,8 +3713,8 @@ msgid "" msgstr "" msgid "" -"This :class:`bytearray` class method returns bytearray object, decoding the " -"given string object. The string must contain two hexadecimal digits per " +"This :class:`bytearray` class method returns a bytearray object, decoding " +"the given string object. The string must contain two hexadecimal digits per " "byte, with ASCII whitespace being ignored." msgstr "" @@ -3480,20 +3864,20 @@ msgstr "" msgid "" "*errors* controls how decoding errors are handled. If ``'strict'`` (the " "default), a :exc:`UnicodeError` exception is raised. Other possible values " -"are ``'ignore'``, ``'replace'``, and any other name registered via :func:" -"`codecs.register_error`. See :ref:`error-handlers` for details." +"are ``'ignore'``, ``'replace'``, and any other name registered " +"via :func:`codecs.register_error`. See :ref:`error-handlers` for details." msgstr "" msgid "" "For performance reasons, the value of *errors* is not checked for validity " -"unless a decoding error actually occurs, :ref:`devmode` is enabled or a :ref:" -"`debug build ` is used." +"unless a decoding error actually occurs, :ref:`devmode` is enabled or " +"a :ref:`debug build ` is used." msgstr "" msgid "" -"Passing the *encoding* argument to :class:`str` allows decoding any :term:" -"`bytes-like object` directly, without needing to make a temporary :class:`!" -"bytes` or :class:`!bytearray` object." +"Passing the *encoding* argument to :class:`str` allows decoding " +"any :term:`bytes-like object` directly, without needing to make a " +"temporary :class:`!bytes` or :class:`!bytearray` object." msgstr "" msgid "" @@ -3515,8 +3899,8 @@ msgstr "" msgid "" "The :meth:`~bytes.find` method should be used only if you need to know the " -"position of *sub*. To check if *sub* is a substring or not, use the :" -"keyword:`in` operator::" +"position of *sub*. To check if *sub* is a substring or not, use " +"the :keyword:`in` operator::" msgstr "" msgid "" @@ -3541,10 +3925,10 @@ msgid "" msgstr "" msgid "" -"This static method returns a translation table usable for :meth:`bytes." -"translate` that will map each character in *from* into the character at the " -"same position in *to*; *from* and *to* must both be :term:`bytes-like " -"objects ` and have the same length." +"This static method returns a translation table usable " +"for :meth:`bytes.translate` that will map each character in *from* into the " +"character at the same position in *to*; *from* and *to* must both " +"be :term:`bytes-like objects ` and have the same length." msgstr "" msgid "" @@ -3649,11 +4033,10 @@ msgstr "" msgid "" "Return a copy of the sequence with specified leading bytes removed. The " -"*chars* argument is a binary sequence specifying the set of byte values to " -"be removed - the name refers to the fact this method is usually used with " -"ASCII characters. If omitted or ``None``, the *chars* argument defaults to " -"removing ASCII whitespace. The *chars* argument is not a prefix; rather, " -"all combinations of its values are stripped::" +"*bytes* argument is a binary sequence specifying the set of byte values to " +"be removed. If omitted or ``None``, the *bytes* argument defaults to " +"removing :meth:`ASCII whitespace `. The *bytes* argument is " +"not a prefix; rather, all combinations of its values are stripped::" msgstr "" msgid "" @@ -3695,18 +4078,17 @@ msgid "" "Split the binary sequence into subsequences of the same type, using *sep* as " "the delimiter string. If *maxsplit* is given, at most *maxsplit* splits are " "done, the *rightmost* ones. If *sep* is not specified or ``None``, any " -"subsequence consisting solely of ASCII whitespace is a separator. Except for " -"splitting from the right, :meth:`rsplit` behaves like :meth:`split` which is " -"described in detail below." +"subsequence consisting solely of :meth:`ASCII whitespace ` is " +"a separator. Except for splitting from the right, :meth:`rsplit` behaves " +"like :meth:`split` which is described in detail below." msgstr "" msgid "" "Return a copy of the sequence with specified trailing bytes removed. The " -"*chars* argument is a binary sequence specifying the set of byte values to " -"be removed - the name refers to the fact this method is usually used with " -"ASCII characters. If omitted or ``None``, the *chars* argument defaults to " -"removing ASCII whitespace. The *chars* argument is not a suffix; rather, " -"all combinations of its values are stripped::" +"*bytes* argument is a binary sequence specifying the set of byte values to " +"be removed. If omitted or ``None``, the *bytes* argument defaults to " +"removing :meth:`ASCII whitespace `. The *bytes* argument is " +"not a suffix; rather, all combinations of its values are stripped::" msgstr "" msgid "" @@ -3768,11 +4150,11 @@ msgstr "" msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " -"applied: runs of consecutive ASCII whitespace are regarded as a single " -"separator, and the result will contain no empty strings at the start or end " -"if the sequence has leading or trailing whitespace. Consequently, splitting " -"an empty sequence or a sequence consisting solely of ASCII whitespace " -"without a specified separator returns ``[]``." +"applied: runs of consecutive :meth:`ASCII whitespace ` are " +"regarded as a single separator, and the result will contain no empty strings " +"at the start or end if the sequence has leading or trailing whitespace. " +"Consequently, splitting an empty sequence or a sequence consisting solely of " +"ASCII whitespace without a specified separator returns ``[]``." msgstr "" msgid "" @@ -3786,11 +4168,11 @@ msgstr "" msgid "" "Return a copy of the sequence with specified leading and trailing bytes " -"removed. The *chars* argument is a binary sequence specifying the set of " -"byte values to be removed - the name refers to the fact this method is " -"usually used with ASCII characters. If omitted or ``None``, the *chars* " -"argument defaults to removing ASCII whitespace. The *chars* argument is not " -"a prefix or suffix; rather, all combinations of its values are stripped::" +"removed. The *bytes* argument is a binary sequence specifying the set of " +"byte values to be removed. If omitted or ``None``, the *bytes* argument " +"defaults to removing :meth:`ASCII whitespace `. The *bytes* " +"argument is not a prefix or suffix; rather, all combinations of its values " +"are stripped::" msgstr "" msgid "" @@ -4022,10 +4404,10 @@ msgstr "" "b'hELLO wORLD'" msgid "" -"Unlike :func:`str.swapcase`, it is always the case that ``bin.swapcase()." -"swapcase() == bin`` for the binary versions. Case conversions are " -"symmetrical in ASCII, even though that is not generally true for arbitrary " -"Unicode code points." +"Unlike :func:`str.swapcase`, it is always the case that " +"``bin.swapcase().swapcase() == bin`` for the binary versions. Case " +"conversions are symmetrical in ASCII, even though that is not generally true " +"for arbitrary Unicode code points." msgstr "" msgid "" @@ -4117,8 +4499,8 @@ msgid "" "the ``%`` operator (modulo). This is also known as the bytes *formatting* or " "*interpolation* operator. Given ``format % values`` (where *format* is a " "bytes object), ``%`` conversion specifications in *format* are replaced with " -"zero or more elements of *values*. The effect is similar to using the :c:" -"func:`sprintf` in the C language." +"zero or more elements of *values*. The effect is similar to using " +"the :c:func:`sprintf` function in the C language." msgstr "" msgid "" @@ -4135,6 +4517,9 @@ msgid "" "mapping key selects the value to be formatted from the mapping. For example:" msgstr "" +msgid "\\(8)" +msgstr "\\(8)" + msgid "Single byte (accepts integer or single byte objects)." msgstr "" @@ -4162,7 +4547,7 @@ msgid "" msgstr "" msgid "\\(7)" -msgstr "" +msgstr "\\(7)" msgid "``b'%s'`` is deprecated, but will not be removed during the 3.x series." msgstr "" @@ -4197,8 +4582,8 @@ msgstr "" msgid "" "``len(view)`` is equal to the length of :class:`~memoryview.tolist`, which " -"is the nested list representation of the view. If ``view.ndim = 1``, this is " -"equal to the number of elements in the view." +"is the nested list representation of the view. If ``view.ndim == 1``, this " +"is equal to the number of elements in the view." msgstr "" msgid "" @@ -4301,11 +4686,11 @@ msgid "" msgstr "" msgid "" -"memoryview is now registered automatically with :class:`collections.abc." -"Sequence`" +"memoryview is now registered automatically " +"with :class:`collections.abc.Sequence`" msgstr "" -msgid "memoryviews can now be indexed with tuple of integers." +msgid "memoryviews can now be indexed with a tuple of integers." msgstr "" msgid ":class:`memoryview` has several methods:" @@ -4318,8 +4703,9 @@ msgid "" msgstr "" msgid "" -"For the subset of :mod:`struct` format strings currently supported by :meth:" -"`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == w.tolist()``::" +"For the subset of :mod:`struct` format strings currently supported " +"by :meth:`tolist`, ``v`` and ``w`` are equal if ``v.tolist() == " +"w.tolist()``::" msgstr "" msgid "" @@ -4437,8 +4823,8 @@ msgid "" msgstr "" msgid "" -":meth:`tolist` now supports all single character native formats in :mod:" -"`struct` module syntax as well as multi-dimensional representations." +":meth:`tolist` now supports all single character native formats " +"in :mod:`struct` module syntax as well as multi-dimensional representations." msgstr "" msgid "" @@ -4462,8 +4848,8 @@ msgstr "" msgid "" "Release the underlying buffer exposed by the memoryview object. Many " -"objects take special actions when a view is held on them (for example, a :" -"class:`bytearray` would temporarily forbid resizing); therefore, calling " +"objects take special actions when a view is held on them (for example, " +"a :class:`bytearray` would temporarily forbid resizing); therefore, calling " "release() is handy to remove these restrictions (and free any dangling " "resources) as soon as possible." msgstr "" @@ -4508,10 +4894,10 @@ msgid "" msgstr "" msgid "" -"The destination format is restricted to a single element native format in :" -"mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' or " -"'c'). The byte length of the result must be the same as the original length. " -"Note that all byte lengths may depend on the operating system." +"The destination format is restricted to a single element native format " +"in :mod:`struct` syntax. One of the formats must be a byte format ('B', 'b' " +"or 'c'). The byte length of the result must be the same as the original " +"length. Note that all byte lengths may depend on the operating system." msgstr "" msgid "Cast 1D/long to 1D/unsigned bytes::" @@ -4726,8 +5112,8 @@ msgid "" "objects. Common uses include membership testing, removing duplicates from a " "sequence, and computing mathematical operations such as intersection, union, " "difference, and symmetric difference. (For other containers see the built-" -"in :class:`dict`, :class:`list`, and :class:`tuple` classes, and the :mod:" -"`collections` module.)" +"in :class:`dict`, :class:`list`, and :class:`tuple` classes, and " +"the :mod:`collections` module.)" msgstr "" msgid "" @@ -4738,10 +5124,10 @@ msgid "" msgstr "" msgid "" -"There are currently two built-in set types, :class:`set` and :class:" -"`frozenset`. The :class:`set` type is mutable --- the contents can be " -"changed using methods like :meth:`~set.add` and :meth:`~set.remove`. Since " -"it is mutable, it has no hash value and cannot be used as either a " +"There are currently two built-in set types, :class:`set` " +"and :class:`frozenset`. The :class:`set` type is mutable --- the contents " +"can be changed using methods like :meth:`~set.add` and :meth:`~set.remove`. " +"Since it is mutable, it has no hash value and cannot be used as either a " "dictionary key or as an element of another set. The :class:`frozenset` type " "is immutable and :term:`hashable` --- its contents cannot be altered after " "it is created; it can therefore be used as a dictionary key or as an element " @@ -4832,12 +5218,13 @@ msgid "Return a shallow copy of the set." msgstr "" msgid "" -"Note, the non-operator versions of :meth:`union`, :meth:`intersection`, :" -"meth:`difference`, :meth:`symmetric_difference`, :meth:`issubset`, and :meth:" -"`issuperset` methods will accept any iterable as an argument. In contrast, " -"their operator based counterparts require their arguments to be sets. This " -"precludes error-prone constructions like ``set('abc') & 'cbs'`` in favor of " -"the more readable ``set('abc').intersection('cbs')``." +"Note, the non-operator versions " +"of :meth:`~frozenset.union`, :meth:`~frozenset.intersection`, :meth:`~frozenset.difference`, :meth:`~frozenset.symmetric_difference`, :meth:`~frozenset.issubset`, " +"and :meth:`~frozenset.issuperset` methods will accept any iterable as an " +"argument. In contrast, their operator based counterparts require their " +"arguments to be sets. This precludes error-prone constructions like " +"``set('abc') & 'cbs'`` in favor of the more readable " +"``set('abc').intersection('cbs')``." msgstr "" msgid "" @@ -4914,16 +5301,22 @@ msgid "Remove all elements from the set." msgstr "" msgid "" -"Note, the non-operator versions of the :meth:`update`, :meth:" -"`intersection_update`, :meth:`difference_update`, and :meth:" -"`symmetric_difference_update` methods will accept any iterable as an " -"argument." +"Note, the non-operator versions of " +"the :meth:`~set.update`, :meth:`~set.intersection_update`, :meth:`~set.difference_update`, " +"and :meth:`~set.symmetric_difference_update` methods will accept any " +"iterable as an argument." +msgstr "" + +msgid "" +"Note, the *elem* argument to " +"the :meth:`~object.__contains__`, :meth:`~set.remove`, " +"and :meth:`~set.discard` methods may be a set. To support searching for an " +"equivalent frozenset, a temporary one is created from *elem*." msgstr "" msgid "" -"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*." +"Sets and frozensets are :ref:`generic ` over the type of their " +"elements." msgstr "" msgid "Mapping Types --- :class:`dict`" @@ -4932,17 +5325,18 @@ msgstr "" msgid "" "A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " "Mappings are mutable objects. There is currently only one standard mapping " -"type, the :dfn:`dictionary`. (For other containers see the built-in :class:" -"`list`, :class:`set`, and :class:`tuple` classes, and the :mod:`collections` " -"module.)" +"type, the :dfn:`dictionary`. (For other containers see the built-" +"in :class:`list`, :class:`set`, and :class:`tuple` classes, and " +"the :mod:`collections` module.)" msgstr "" msgid "" -"A dictionary's keys are *almost* arbitrary values. Values that are not :" -"term:`hashable`, that is, values containing lists, dictionaries or other " -"mutable types (that are compared by value rather than by object identity) " -"may not be used as keys. Values that compare equal (such as ``1``, ``1.0``, " -"and ``True``) can be used interchangeably to index the same dictionary entry." +"A dictionary's keys are *almost* arbitrary values. Values that are " +"not :term:`hashable`, that is, values containing lists, dictionaries or " +"other mutable types (that are compared by value rather than by object " +"identity) may not be used as keys. Values that compare equal (such as ``1``, " +"``1.0``, and ``True``) can be used interchangeably to index the same " +"dictionary entry." msgstr "" msgid "" @@ -4986,7 +5380,10 @@ msgid "" msgstr "" msgid "" -"To illustrate, the following examples all return a dictionary equal to " +"Dictionaries compare equal if and only if they have the same ``(key, " +"value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', " +"'>') raise :exc:`TypeError`. To illustrate dictionary creation and " +"equality, the following examples all return a dictionary equal to " "``{\"one\": 1, \"two\": 2, \"three\": 3}``::" msgstr "" @@ -5006,6 +5403,38 @@ msgid "" "are valid Python identifiers. Otherwise, any valid keys can be used." msgstr "" +msgid "" +"Dictionaries preserve insertion order. Note that updating a key does not " +"affect the order. Keys added after deletion are inserted at the end. ::" +msgstr "" + +msgid "" +">>> d = {\"one\": 1, \"two\": 2, \"three\": 3, \"four\": 4}\n" +">>> d\n" +"{'one': 1, 'two': 2, 'three': 3, 'four': 4}\n" +">>> list(d)\n" +"['one', 'two', 'three', 'four']\n" +">>> list(d.values())\n" +"[1, 2, 3, 4]\n" +">>> d[\"one\"] = 42\n" +">>> d\n" +"{'one': 42, 'two': 2, 'three': 3, 'four': 4}\n" +">>> del d[\"two\"]\n" +">>> d[\"two\"] = None\n" +">>> d\n" +"{'one': 42, 'three': 3, 'four': 4, 'two': None}" +msgstr "" + +msgid "" +"Dictionary order is guaranteed to be insertion order. This behavior was an " +"implementation detail of CPython from 3.6." +msgstr "" + +msgid "" +"Dictionaries are :ref:`generic ` over two types, signifying " +"(respectively) the types of the dictionary's keys and values." +msgstr "" + msgid "" "These are the operations that dictionaries support (and therefore, custom " "mapping types should support too):" @@ -5023,13 +5452,14 @@ msgid "" msgstr "" msgid "" -"If a subclass of dict defines a method :meth:`__missing__` and *key* is not " -"present, the ``d[key]`` operation calls that method with the key *key* as " -"argument. The ``d[key]`` operation then returns or raises whatever is " -"returned or raised by the ``__missing__(key)`` call. No other operations or " -"methods invoke :meth:`__missing__`. If :meth:`__missing__` is not defined, :" -"exc:`KeyError` is raised. :meth:`__missing__` must be a method; it cannot be " -"an instance variable::" +"If a subclass of dict defines a method :meth:`~object.__missing__` and *key* " +"is not present, the ``d[key]`` operation calls that method with the key " +"*key* as argument. The ``d[key]`` operation then returns or raises whatever " +"is returned or raised by the ``__missing__(key)`` call. No other operations " +"or methods invoke :meth:`~object.__missing__`. " +"If :meth:`~object.__missing__` is not defined, :exc:`KeyError` is " +"raised. :meth:`~object.__missing__` must be a method; it cannot be an " +"instance variable::" msgstr "" msgid "" @@ -5046,9 +5476,9 @@ msgid "" msgstr "" msgid "" -"The example above shows part of the implementation of :class:`collections." -"Counter`. A different ``__missing__`` method is used by :class:`collections." -"defaultdict`." +"The example above shows part of the implementation " +"of :class:`collections.Counter`. A different :meth:`!__missing__` method is " +"used by :class:`collections.defaultdict`." msgstr "" msgid "Set ``d[key]`` to *value*." @@ -5106,8 +5536,8 @@ msgstr "" msgid "" "If *key* is in the dictionary, remove it and return its value, else return " -"*default*. If *default* is not given and *key* is not in the dictionary, a :" -"exc:`KeyError` is raised." +"*default*. If *default* is not given and *key* is not in the dictionary, " +"a :exc:`KeyError` is raised." msgstr "" msgid "" @@ -5117,8 +5547,8 @@ msgstr "" msgid "" ":meth:`popitem` is useful to destructively iterate over a dictionary, as " -"often used in set algorithms. If the dictionary is empty, calling :meth:" -"`popitem` raises a :exc:`KeyError`." +"often used in set algorithms. If the dictionary is empty, " +"calling :meth:`popitem` raises a :exc:`KeyError`." msgstr "" msgid "" @@ -5137,8 +5567,8 @@ msgid "" msgstr "" msgid "" -"Update the dictionary with the key/value pairs from *other*, overwriting " -"existing keys. Return ``None``." +"Update the dictionary with the key/value pairs from *mapping* or *iterable* " +"and *kwargs*, overwriting existing keys. Return ``None``." msgstr "" msgid "" @@ -5181,39 +5611,6 @@ msgid "" "values of *other* take priority when *d* and *other* share keys." msgstr "" -msgid "" -"Dictionaries compare equal if and only if they have the same ``(key, " -"value)`` pairs (regardless of ordering). Order comparisons ('<', '<=', '>=', " -"'>') raise :exc:`TypeError`." -msgstr "" - -msgid "" -"Dictionaries preserve insertion order. Note that updating a key does not " -"affect the order. Keys added after deletion are inserted at the end. ::" -msgstr "" - -msgid "" -">>> d = {\"one\": 1, \"two\": 2, \"three\": 3, \"four\": 4}\n" -">>> d\n" -"{'one': 1, 'two': 2, 'three': 3, 'four': 4}\n" -">>> list(d)\n" -"['one', 'two', 'three', 'four']\n" -">>> list(d.values())\n" -"[1, 2, 3, 4]\n" -">>> d[\"one\"] = 42\n" -">>> d\n" -"{'one': 42, 'two': 2, 'three': 3, 'four': 4}\n" -">>> del d[\"two\"]\n" -">>> d[\"two\"] = None\n" -">>> d\n" -"{'one': 42, 'three': 3, 'four': 4, 'two': None}" -msgstr "" - -msgid "" -"Dictionary order is guaranteed to be insertion order. This behavior was an " -"implementation detail of CPython from 3.6." -msgstr "" - msgid "Dictionaries and dictionary views are reversible. ::" msgstr "" @@ -5233,18 +5630,18 @@ msgid "Dictionaries are now reversible." msgstr "" msgid "" -":class:`types.MappingProxyType` can be used to create a read-only view of a :" -"class:`dict`." +":class:`types.MappingProxyType` can be used to create a read-only view of " +"a :class:`dict`." msgstr "" msgid "Dictionary view objects" msgstr "" msgid "" -"The objects returned by :meth:`dict.keys`, :meth:`dict.values` and :meth:" -"`dict.items` are *view objects*. They provide a dynamic view on the " -"dictionary's entries, which means that when the dictionary changes, the view " -"reflects these changes." +"The objects returned by :meth:`dict.keys`, :meth:`dict.values` " +"and :meth:`dict.items` are *view objects*. They provide a dynamic view on " +"the dictionary's entries, which means that when the dictionary changes, the " +"view reflects these changes." msgstr "" msgid "" @@ -5262,9 +5659,9 @@ msgstr "" msgid "" "Keys and values are iterated over in insertion order. This allows the " -"creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = zip(d." -"values(), d.keys())``. Another way to create the same list is ``pairs = " -"[(v, k) for (k, v) in d.items()]``." +"creation of ``(value, key)`` pairs using :func:`zip`: ``pairs = " +"zip(d.values(), d.keys())``. Another way to create the same list is ``pairs " +"= [(v, k) for (k, v) in d.items()]``." msgstr "" msgid "" @@ -5368,8 +5765,9 @@ msgstr "" msgid "" "An example of a context manager that returns itself is a :term:`file " -"object`. File objects return themselves from __enter__() to allow :func:" -"`open` to be used as the context expression in a :keyword:`with` statement." +"object`. File objects return themselves from __enter__() to " +"allow :func:`open` to be used as the context expression in a :keyword:`with` " +"statement." msgstr "" msgid "" @@ -5393,18 +5791,21 @@ msgid "" "Returning a true value from this method will cause the :keyword:`with` " "statement to suppress the exception and continue execution with the " "statement immediately following the :keyword:`!with` statement. Otherwise " -"the exception continues propagating after this method has finished " -"executing. Exceptions that occur during execution of this method will " -"replace any exception that occurred in the body of the :keyword:`!with` " -"statement." +"the exception continues propagating after this method has finished executing." +msgstr "" + +msgid "" +"If this method raises an exception while handling an earlier exception from " +"the :keyword:`with` block, the new exception is raised, and the original " +"exception is stored in its :attr:`~BaseException.__context__` attribute." msgstr "" msgid "" "The exception passed in should never be reraised explicitly - instead, this " "method should return a false value to indicate that the method completed " "successfully and does not want to suppress the raised exception. This allows " -"context management code to easily detect whether or not an :meth:`~object." -"__exit__` method has actually failed." +"context management code to easily detect whether or not " +"an :meth:`~object.__exit__` method has actually failed." msgstr "" msgid "" @@ -5419,9 +5820,10 @@ msgid "" "Python's :term:`generator`\\s and the :class:`contextlib.contextmanager` " "decorator provide a convenient way to implement these protocols. If a " "generator function is decorated with the :class:`contextlib.contextmanager` " -"decorator, it will return a context manager implementing the necessary :meth:" -"`~contextmanager.__enter__` and :meth:`~contextmanager.__exit__` methods, " -"rather than the iterator produced by an undecorated generator function." +"decorator, it will return a context manager implementing the " +"necessary :meth:`~contextmanager.__enter__` " +"and :meth:`~contextmanager.__exit__` methods, rather than the iterator " +"produced by an undecorated generator function." msgstr "" msgid "" @@ -5433,13 +5835,13 @@ msgid "" msgstr "" msgid "" -"Type Annotation Types --- :ref:`Generic Alias `, :ref:" -"`Union `" +"Type Annotation Types --- :ref:`Generic Alias `, :ref:`Union `" msgstr "" msgid "" -"The core built-in types for :term:`type annotations ` are :ref:" -"`Generic Alias ` and :ref:`Union `." +"The core built-in types for :term:`type annotations ` " +"are :ref:`Generic Alias ` and :ref:`Union `." msgstr "" msgid "Generic Alias Type" @@ -5468,8 +5870,8 @@ msgid "" "For a container class, the argument(s) supplied to a :ref:`subscription " "` of the class may indicate the type(s) of the elements an " "object contains. For example, ``set[bytes]`` can be used in type annotations " -"to signify a :class:`set` in which all the elements are of type :class:" -"`bytes`." +"to signify a :class:`set` in which all the elements are of " +"type :class:`bytes`." msgstr "" msgid "" @@ -5489,16 +5891,18 @@ msgstr "" msgid "" "If ``y = re.search(b'bar', b'bar')``, (note the ``b`` for :class:`bytes`), " -"``y`` will also be an instance of ``re.Match``, but the return values of ``y." -"group(0)`` and ``y[0]`` will both be of type :class:`bytes`. In type " +"``y`` will also be an instance of ``re.Match``, but the return values of " +"``y.group(0)`` and ``y[0]`` will both be of type :class:`bytes`. In type " "annotations, we would represent this variety of :ref:`re.Match ` objects with ``re.Match[bytes]``." msgstr "" msgid "" -"``GenericAlias`` objects are instances of the class :class:`types." -"GenericAlias`, which can also be used to create ``GenericAlias`` objects " -"directly." +"``GenericAlias`` objects are instances of the " +"class :class:`types.GenericAlias`, which can also be used to create " +"``GenericAlias`` objects directly. Specializations of user-" +"defined :ref:`generic classes ` may not be instances " +"of :class:`types.GenericAlias`, but they provide similar functionality." msgstr "" msgid "" @@ -5568,6 +5972,21 @@ msgid "" "" msgstr "" +msgid "" +"Instances of ``GenericAlias`` are not classes at runtime, even though they " +"behave like classes (they can be instantiated and subclassed)::" +msgstr "" + +msgid "" +">>> import inspect\n" +">>> inspect.isclass(list[int])\n" +"False" +msgstr "" + +msgid "" +"This is true for :ref:`user-defined generics ` also." +msgstr "" + msgid "" "Calling :func:`repr` or :func:`str` on a generic shows the parameterized " "type::" @@ -5638,10 +6057,10 @@ msgid ":class:`type`" msgstr ":class:`type`" msgid ":class:`asyncio.Future`" -msgstr "" +msgstr ":class:`asyncio.Future`" msgid ":class:`asyncio.Task`" -msgstr "" +msgstr ":class:`asyncio.Task`" msgid ":class:`collections.deque`" msgstr ":class:`collections.deque`" @@ -5836,8 +6255,9 @@ msgstr "" msgid "" "A ``GenericAlias`` object with :class:`typing.ParamSpec` parameters may not " -"have correct ``__parameters__`` after substitution because :class:`typing." -"ParamSpec` is intended primarily for static type checking." +"have correct ``__parameters__`` after substitution " +"because :class:`typing.ParamSpec` is intended primarily for static type " +"checking." msgstr "" msgid "" @@ -5856,13 +6276,13 @@ msgstr "" msgid "" "Introducing the ability to natively parameterize standard-library classes, " -"provided they implement the special class method :meth:`~object." -"__class_getitem__`." +"provided they implement the special class " +"method :meth:`~object.__class_getitem__`." msgstr "" msgid "" -":ref:`Generics`, :ref:`user-defined generics ` and :" -"class:`typing.Generic`" +":ref:`Generics`, :ref:`user-defined generics ` " +"and :class:`typing.Generic`" msgstr "" msgid "" @@ -5877,15 +6297,15 @@ msgid "" "A union object holds the value of the ``|`` (bitwise or) operation on " "multiple :ref:`type objects `. These types are intended " "primarily for :term:`type annotations `. The union type " -"expression enables cleaner type hinting syntax compared to :data:`typing." -"Union`." +"expression enables cleaner type hinting syntax compared " +"to :data:`typing.Union`." msgstr "" msgid "" "Defines a union object which holds types *X*, *Y*, and so forth. ``X | Y`` " "means either X or Y. It is equivalent to ``typing.Union[X, Y]``. For " -"example, the following function expects an argument of type :class:`int` or :" -"class:`float`::" +"example, the following function expects an argument of type :class:`int` " +"or :class:`float`::" msgstr "" msgid "" @@ -5894,7 +6314,7 @@ msgid "" msgstr "" msgid "" -"The ``|`` operand cannot be used at runtime to define unions where one or " +"The ``|`` operator cannot be used at runtime to define unions where one or " "more members is a forward reference. For example, ``int | \"Foo\"``, where " "``\"Foo\"`` is a reference to a class not yet defined, will fail at runtime. " "For unions which include forward references, present the whole expression as " @@ -5962,9 +6382,9 @@ msgid "" msgstr "" msgid "" -"The user-exposed type for the union object can be accessed from :data:`types." -"UnionType` and used for :func:`isinstance` checks. An object cannot be " -"instantiated from the type::" +"The user-exposed type for the union object can be accessed " +"from :data:`types.UnionType` and used for :func:`isinstance` checks. An " +"object cannot be instantiated from the type::" msgstr "" msgid "" @@ -6014,10 +6434,10 @@ msgstr "Moduły" msgid "" "The only special operation on a module is attribute access: ``m.name``, " "where *m* is a module and *name* accesses a name defined in *m*'s symbol " -"table. Module attributes can be assigned to. (Note that the :keyword:" -"`import` statement is not, strictly speaking, an operation on a module " -"object; ``import foo`` does not require a module object named *foo* to " -"exist, rather it requires an (external) *definition* for a module named " +"table. Module attributes can be assigned to. (Note that " +"the :keyword:`import` statement is not, strictly speaking, an operation on a " +"module object; ``import foo`` does not require a module object named *foo* " +"to exist, rather it requires an (external) *definition* for a module named " "*foo* somewhere.)" msgstr "" @@ -6025,16 +6445,16 @@ msgid "" "A special attribute of every module is :attr:`~object.__dict__`. This is the " "dictionary containing the module's symbol table. Modifying this dictionary " "will actually change the module's symbol table, but direct assignment to " -"the :attr:`~object.__dict__` attribute is not possible (you can write ``m." -"__dict__['a'] = 1``, which defines ``m.a`` to be ``1``, but you can't write " -"``m.__dict__ = {}``). Modifying :attr:`~object.__dict__` directly is not " -"recommended." +"the :attr:`~object.__dict__` attribute is not possible (you can write " +"``m.__dict__['a'] = 1``, which defines ``m.a`` to be ``1``, but you can't " +"write ``m.__dict__ = {}``). Modifying :attr:`~object.__dict__` directly is " +"not recommended." msgstr "" msgid "" -"Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." +"Modules built into the interpreter are written like this: ````. If loaded from a file, they are written as ````." msgstr "" msgid "Classes and Class Instances" @@ -6066,21 +6486,21 @@ msgstr "" msgid "" "Methods are functions that are called using the attribute notation. There " -"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." +"are two flavors: :ref:`built-in methods ` (such " +"as :meth:`~list.append` on lists) and :ref:`class instance methods `. Built-in methods are described with the types that support them." msgstr "" msgid "" "If you access a method (a function defined in a class namespace) through an " -"instance, you get a special object: a :dfn:`bound method` (also called :ref:" -"`instance method `) object. When called, it will add the " -"``self`` argument to the argument list. Bound methods have two special read-" -"only attributes: :attr:`m.__self__ ` is the object on which " -"the method operates, and :attr:`m.__func__ ` is the " -"function implementing the method. Calling ``m(arg-1, arg-2, ..., arg-n)`` " -"is completely equivalent to calling ``m.__func__(m.__self__, arg-1, " -"arg-2, ..., arg-n)``." +"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 "" @@ -6119,8 +6539,8 @@ msgid "" "executable Python code such as a function body. They differ from function " "objects because they don't contain a reference to their global execution " "environment. Code objects are returned by the built-in :func:`compile` " -"function and can be extracted from function objects through their :attr:" -"`~function.__code__` attribute. See also the :mod:`code` module." +"function and can be extracted from function objects through " +"their :attr:`~function.__code__` attribute. See also the :mod:`code` module." msgstr "" msgid "" @@ -6166,23 +6586,63 @@ msgid "The Ellipsis Object" msgstr "" msgid "" -"This object is commonly used by slicing (see :ref:`slicings`). It supports " -"no special operations. There is exactly one ellipsis object, named :const:" -"`Ellipsis` (a built-in name). ``type(Ellipsis)()`` produces the :const:" -"`Ellipsis` singleton." +"This object is commonly used to indicate that something is omitted. It " +"supports no special operations. There is exactly one ellipsis object, " +"named :const:`Ellipsis` (a built-in name). ``type(Ellipsis)()`` produces " +"the :const:`Ellipsis` singleton." msgstr "" msgid "It is written as ``Ellipsis`` or ``...``." msgstr "" +msgid "" +"In typical use, ``...`` as the ``Ellipsis`` object appears in a few " +"different places, for instance:" +msgstr "" + +msgid "" +"In type annotations, such as :ref:`callable arguments ` or :ref:`tuple elements `." +msgstr "" + +msgid "" +"As the body of a function instead of a :ref:`pass statement `." +msgstr "" + +msgid "" +"In third-party libraries, such as `Numpy's slicing and striding `_." +msgstr "" + +msgid "" +"Python also uses three dots in ways that are not ``Ellipsis`` objects, for " +"instance:" +msgstr "" + +msgid "" +"Doctest's :const:`ELLIPSIS `, as a pattern for missing " +"content." +msgstr "" + +msgid "" +"The default Python prompt of the :term:`interactive` shell when partial " +"input is incomplete." +msgstr "" + +msgid "" +"Lastly, the Python documentation often uses three dots in conventional " +"English usage to mean omitted content, even in code examples that also use " +"them as the ``Ellipsis``." +msgstr "" + msgid "The NotImplemented Object" msgstr "" msgid "" "This object is returned from comparisons and binary operations when they are " "asked to operate on types they don't support. See :ref:`comparisons` for " -"more information. There is exactly one :data:`NotImplemented` object. :code:" -"`type(NotImplemented)()` produces the singleton instance." +"more information. There is exactly one :data:`NotImplemented` " +"object. :code:`type(NotImplemented)()` produces the singleton instance." msgstr "" msgid "It is written as :code:`NotImplemented`." @@ -6202,8 +6662,8 @@ msgstr "" msgid "" "The implementation adds a few special read-only attributes to several object " -"types, where they are relevant. Some of these are not reported by the :func:" -"`dir` built-in function." +"types, where they are relevant. Some of these are not reported by " +"the :func:`dir` built-in function." msgstr "" msgid "" @@ -6223,19 +6683,19 @@ msgid "" msgstr "" msgid "" -"The :ref:`type parameters ` of generic classes, functions, and :" -"ref:`type aliases `. For classes and functions that are not " -"generic, this will be an empty tuple." +"The :ref:`type parameters ` of generic classes, functions, " +"and :ref:`type aliases `. For classes and functions that are " +"not generic, this will be an empty tuple." msgstr "" msgid "Integer string conversion length limitation" msgstr "" msgid "" -"CPython has a global limit for converting between :class:`int` and :class:" -"`str` to mitigate denial of service attacks. This limit *only* applies to " -"decimal or other non-power-of-two number bases. Hexadecimal, octal, and " -"binary conversions are unlimited. The limit can be configured." +"CPython has a global limit for converting between :class:`int` " +"and :class:`str` to mitigate denial of service attacks. This limit *only* " +"applies to decimal or other non-power-of-two number bases. Hexadecimal, " +"octal, and binary conversions are unlimited. The limit can be configured." msgstr "" msgid "" @@ -6285,10 +6745,10 @@ msgid "" msgstr "" msgid "" -"The default limit is 4300 digits as provided in :data:`sys.int_info." -"default_max_str_digits `. The lowest limit that can be " -"configured is 640 digits as provided in :data:`sys.int_info." -"str_digits_check_threshold `." +"The default limit is 4300 digits as provided " +"in :data:`sys.int_info.default_max_str_digits `. The lowest " +"limit that can be configured is 640 digits as provided " +"in :data:`sys.int_info.str_digits_check_threshold `." msgstr "" msgid "Verification:" @@ -6308,8 +6768,8 @@ msgid "Affected APIs" msgstr "" msgid "" -"The limitation only applies to potentially slow conversions between :class:" -"`int` and :class:`str` or :class:`bytes`:" +"The limitation only applies to potentially slow conversions " +"between :class:`int` and :class:`str` or :class:`bytes`:" msgstr "" msgid "``int(string)`` with default base 10." @@ -6339,7 +6799,7 @@ msgid ":func:`int.from_bytes` and :func:`int.to_bytes`." msgstr "" msgid ":func:`hex`, :func:`oct`, :func:`bin`." -msgstr "" +msgstr ":func:`hex`, :func:`oct`, :func:`bin`." msgid ":ref:`formatspec` for hex, octal, and binary numbers." msgstr "" @@ -6370,16 +6830,17 @@ msgid "" msgstr "" msgid "" -":data:`sys.flags.int_max_str_digits` contains the value of :envvar:" -"`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. If both the " -"env var and the ``-X`` option are set, the ``-X`` option takes precedence. A " -"value of *-1* indicates that both were unset, thus a value of :data:`sys." -"int_info.default_max_str_digits` was used during initialization." +":data:`sys.flags.int_max_str_digits` contains the value " +"of :envvar:`PYTHONINTMAXSTRDIGITS` or :option:`-X int_max_str_digits <-X>`. " +"If both the env var and the ``-X`` option are set, the ``-X`` option takes " +"precedence. A value of *-1* indicates that both were unset, thus a value " +"of :data:`sys.int_info.default_max_str_digits` was used during " +"initialization." msgstr "" msgid "" -"From code, you can inspect the current limit and set a new one using these :" -"mod:`sys` APIs:" +"From code, you can inspect the current limit and set a new one using " +"these :mod:`sys` APIs:" msgstr "" msgid "" @@ -6389,8 +6850,8 @@ msgid "" msgstr "" msgid "" -"Information about the default and minimum can be found in :data:`sys." -"int_info`:" +"Information about the default and minimum can be found " +"in :data:`sys.int_info`:" msgstr "" msgid "" @@ -6770,12 +7231,6 @@ msgstr "" msgid "slice" msgstr "" -msgid "count() (sequence method)" -msgstr "" - -msgid "index() (sequence method)" -msgstr "" - msgid "loop" msgstr "" @@ -6815,30 +7270,6 @@ msgstr "" msgid "del" msgstr "" -msgid "append() (sequence method)" -msgstr "" - -msgid "clear() (sequence method)" -msgstr "" - -msgid "copy() (sequence method)" -msgstr "" - -msgid "extend() (sequence method)" -msgstr "" - -msgid "insert() (sequence method)" -msgstr "" - -msgid "pop() (sequence method)" -msgstr "" - -msgid "remove() (sequence method)" -msgstr "" - -msgid "reverse() (sequence method)" -msgstr "" - msgid "range" msgstr "" diff --git a/library/string.po b/library/string.po index af3d6ba2cb..3998d50abf 100644 --- a/library/string.po +++ b/library/string.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-17 18:27+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 ":mod:`!string` --- Common string operations" msgstr "" msgid "**Source code:** :source:`Lib/string.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/string.py`" msgid ":ref:`textseq`" msgstr ":ref:`textseq`" @@ -43,9 +42,9 @@ msgid "The constants defined in this module are:" msgstr "" msgid "" -"The concatenation of the :const:`ascii_lowercase` and :const:" -"`ascii_uppercase` constants described below. This value is not locale-" -"dependent." +"The concatenation of the :const:`ascii_lowercase` " +"and :const:`ascii_uppercase` constants described below. This value is not " +"locale-dependent." msgstr "" msgid "" @@ -74,14 +73,15 @@ msgstr "" msgid "" "String of ASCII characters which are considered printable by Python. This is " -"a combination of :const:`digits`, :const:`ascii_letters`, :const:" -"`punctuation`, and :const:`whitespace`." +"a combination " +"of :const:`digits`, :const:`ascii_letters`, :const:`punctuation`, " +"and :const:`whitespace`." msgstr "" msgid "" -"By design, :meth:`string.printable.isprintable() ` returns :" -"const:`False`. In particular, ``string.printable`` is not printable in the " -"POSIX sense (see :manpage:`LC_CTYPE `)." +"By design, :meth:`string.printable.isprintable() ` " +"returns :const:`False`. In particular, ``string.printable`` is not printable " +"in the POSIX sense (see :manpage:`LC_CTYPE `)." msgstr "" msgid "" @@ -90,7 +90,7 @@ msgid "" "vertical tab." msgstr "" -msgid "Custom String Formatting" +msgid "Custom string formatting" msgstr "" msgid "" @@ -107,8 +107,8 @@ msgstr "" msgid "" "The primary API method. It takes a format string and an arbitrary set of " -"positional and keyword arguments. It is just a wrapper that calls :meth:" -"`vformat`." +"positional and keyword arguments. It is just a wrapper that " +"calls :meth:`vformat`." msgstr "" msgid "" @@ -120,9 +120,10 @@ msgid "" "This function does the actual work of formatting. It is exposed as a " "separate function for cases where you want to pass in a predefined " "dictionary of arguments, rather than unpacking and repacking the dictionary " -"as individual arguments using the ``*args`` and ``**kwargs`` syntax. :meth:" -"`vformat` does the work of breaking up the format string into character data " -"and replacement fields. It calls the various methods described below." +"as individual arguments using the ``*args`` and ``**kwargs`` " +"syntax. :meth:`vformat` does the work of breaking up the format string into " +"character data and replacement fields. It calls the various methods " +"described below." msgstr "" msgid "" @@ -149,9 +150,9 @@ msgstr "" msgid "" "Given *field_name* as returned by :meth:`parse` (see above), convert it to " "an object to be formatted. Returns a tuple (obj, used_key). The default " -"version takes strings of the form defined in :pep:`3101`, such as " -"\"0[name]\" or \"label.title\". *args* and *kwargs* are as passed in to :" -"meth:`vformat`. The return value *used_key* has the same meaning as the " +"version takes strings of the form defined in :pep:`3101`, such as \"0[name]" +"\" or \"label.title\". *args* and *kwargs* are as passed in " +"to :meth:`vformat`. The return value *used_key* has the same meaning as the " "*key* parameter to :meth:`get_value`." msgstr "" @@ -163,9 +164,9 @@ msgid "" msgstr "" msgid "" -"The *args* parameter is set to the list of positional arguments to :meth:" -"`vformat`, and the *kwargs* parameter is set to the dictionary of keyword " -"arguments." +"The *args* parameter is set to the list of positional arguments " +"to :meth:`vformat`, and the *kwargs* parameter is set to the dictionary of " +"keyword arguments." msgstr "" msgid "" @@ -177,13 +178,13 @@ msgstr "" msgid "" "So for example, the field expression '0.name' would cause :meth:`get_value` " "to be called with a *key* argument of 0. The ``name`` attribute will be " -"looked up after :meth:`get_value` returns by calling the built-in :func:" -"`getattr` function." +"looked up after :meth:`get_value` returns by calling the built-" +"in :func:`getattr` function." msgstr "" msgid "" -"If the index or keyword refers to an item that does not exist, then an :exc:" -"`IndexError` or :exc:`KeyError` should be raised." +"If the index or keyword refers to an item that does not exist, then " +"an :exc:`IndexError` or :exc:`KeyError` should be raised." msgstr "" msgid "" @@ -191,8 +192,9 @@ msgid "" "function is the set of all argument keys that were actually referred to in " "the format string (integers for positional arguments, and strings for named " "arguments), and a reference to the *args* and *kwargs* that was passed to " -"vformat. The set of unused args can be calculated from these parameters. :" -"meth:`check_unused_args` is assumed to raise an exception if the check fails." +"vformat. The set of unused args can be calculated from these " +"parameters. :meth:`check_unused_args` is assumed to raise an exception if " +"the check fails." msgstr "" msgid "" @@ -206,7 +208,7 @@ msgid "" "understands 's' (str), 'r' (repr) and 'a' (ascii) conversion types." msgstr "" -msgid "Format String Syntax" +msgid "Format string syntax" msgstr "" msgid "" @@ -252,9 +254,9 @@ msgid "" "not quote-delimited, it is not possible to specify arbitrary dictionary keys " "(e.g., the strings ``'10'`` or ``':-]'``) within a format string. The " "*arg_name* can be followed by any number of index or attribute expressions. " -"An expression of the form ``'.name'`` selects the named attribute using :" -"func:`getattr`, while an expression of the form ``'[index]'`` does an index " -"lookup using :meth:`~object.__getitem__`." +"An expression of the form ``'.name'`` selects the named attribute " +"using :func:`getattr`, while an expression of the form ``'[index]'`` does an " +"index lookup using :meth:`~object.__getitem__`." msgstr "" msgid "" @@ -286,14 +288,14 @@ msgid "" "the job of formatting a value is done by the :meth:`~object.__format__` " "method of the value itself. However, in some cases it is desirable to force " "a type to be formatted as a string, overriding its own definition of " -"formatting. By converting the value to a string before calling :meth:" -"`~object.__format__`, the normal formatting logic is bypassed." +"formatting. By converting the value to a string before " +"calling :meth:`~object.__format__`, the normal formatting logic is bypassed." msgstr "" msgid "" -"Three conversion flags are currently supported: ``'!s'`` which calls :func:" -"`str` on the value, ``'!r'`` which calls :func:`repr` and ``'!a'`` which " -"calls :func:`ascii`." +"Three conversion flags are currently supported: ``'!s'`` which " +"calls :func:`str` on the value, ``'!r'`` which calls :func:`repr` and ``'!" +"a'`` which calls :func:`ascii`." msgstr "" msgid "Some examples::" @@ -329,15 +331,15 @@ msgstr "" msgid "See the :ref:`formatexamples` section for some examples." msgstr "" -msgid "Format Specification Mini-Language" +msgid "Format specification mini-language" msgstr "" msgid "" "\"Format specifications\" are used within replacement fields contained " -"within a format string to define how individual values are presented (see :" -"ref:`formatstrings` and :ref:`f-strings`). They can also be passed directly " -"to the built-in :func:`format` function. Each formattable type may define " -"how the format specification is to be interpreted." +"within a format string to define how individual values are presented " +"(see :ref:`formatstrings` and :ref:`f-strings`). They can also be passed " +"directly to the built-in :func:`format` function. Each formattable type may " +"define how the format specification is to be interpreted." msgstr "" msgid "" @@ -396,9 +398,9 @@ msgstr "``'='``" msgid "" "Forces the padding to be placed after the sign (if any) but before the " "digits. This is used for printing fields in the form '+000000120'. This " -"alignment option is only valid for numeric types, excluding :class:" -"`complex`. It becomes the default for numbers when '0' immediately precedes " -"the field width." +"alignment option is only valid for numeric types, " +"excluding :class:`complex`. It becomes the default for numbers when '0' " +"immediately precedes the field width." msgstr "" msgid "``'^'``" @@ -488,7 +490,7 @@ msgid "" msgstr "" msgid "``','``" -msgstr "" +msgstr "``','``" msgid "" "Inserts a comma every 3 digits for integer presentation type ``'d'`` and " @@ -497,7 +499,7 @@ msgid "" msgstr "" msgid "``'_'``" -msgstr "" +msgstr "``'_'``" msgid "" "Inserts an underscore every 3 digits for integer presentation type ``'d'`` " @@ -508,7 +510,9 @@ msgid "" msgstr "" msgid "" -"For a locale aware separator, use the ``'n'`` presentation type instead." +"For a locale-aware separator, use the ``'n'`` :ref:`float presentation type " +"` or :ref:`integer presentation type ` " +"instead." msgstr "" msgid "Added the ``','`` option (see also :pep:`378`)." @@ -599,7 +603,10 @@ msgstr "``'n'``" msgid "" "Number. This is the same as ``'d'``, except that it uses the current locale " -"setting to insert the appropriate digit group separators." +"setting to insert the appropriate digit group separators. Note that the " +"default locale is not the system locale. Depending on your use case, you may " +"wish to set :const:`~locale.LC_NUMERIC` with :func:`locale.setlocale` before " +"using ``'n'``." msgstr "" msgid "The same as ``'d'``." @@ -613,8 +620,8 @@ msgid "" msgstr "" msgid "" -"The available presentation types for :class:`float` and :class:`~decimal." -"Decimal` values are:" +"The available presentation types for :class:`float` " +"and :class:`~decimal.Decimal` values are:" msgstr "" msgid "``'e'``" @@ -626,9 +633,14 @@ msgid "" "exponent. The coefficient has one digit before and ``p`` digits after the " "decimal point, for a total of ``p + 1`` significant digits. With no " "precision given, uses a precision of ``6`` digits after the decimal point " -"for :class:`float`, and shows all coefficient digits for :class:`~decimal." -"Decimal`. If ``p=0``, the decimal point is omitted unless the ``#`` option " -"is used." +"for :class:`float`, and shows all coefficient digits " +"for :class:`~decimal.Decimal`. If ``p=0``, the decimal point is omitted " +"unless the ``#`` option is used." +msgstr "" + +msgid "" +"For :class:`float`, the exponent always contains at least two digits, and is " +"zero if the value is zero." msgstr "" msgid "``'E'``" @@ -682,12 +694,12 @@ msgid "" msgstr "" msgid "" -"With no precision given, uses a precision of ``6`` significant digits for :" -"class:`float`. For :class:`~decimal.Decimal`, the coefficient of the result " -"is formed from the coefficient digits of the value; scientific notation is " -"used for values smaller than ``1e-6`` in absolute value and values where the " -"place value of the least significant digit is larger than 1, and fixed-point " -"notation is used otherwise." +"With no precision given, uses a precision of ``6`` significant digits " +"for :class:`float`. For :class:`~decimal.Decimal`, the coefficient of the " +"result is formed from the coefficient digits of the value; scientific " +"notation is used for values smaller than ``1e-6`` in absolute value and " +"values where the place value of the least significant digit is larger than " +"1, and fixed-point notation is used otherwise." msgstr "" msgid "" @@ -707,7 +719,9 @@ msgstr "" msgid "" "Number. This is the same as ``'g'``, except that it uses the current locale " "setting to insert the appropriate digit group separators for the integral " -"part of a number." +"part of a number. Note that the default locale is not the system locale. " +"Depending on your use case, you may wish to set :const:`~locale.LC_NUMERIC` " +"with :func:`locale.setlocale` before using ``'n'``." msgstr "" msgid "``'%'``" @@ -862,8 +876,8 @@ msgid "" "'+3.140000; -3.140000'\n" ">>> '{: f}; {: f}'.format(3.14, -3.14) # show a space for positive numbers\n" "' 3.140000; -3.140000'\n" -">>> '{:-f}; {:-f}'.format(3.14, -3.14) # show only the minus -- same as '{:" -"f}; {:f}'\n" +">>> '{:-f}; {:-f}'.format(3.14, -3.14) # show only the minus -- same as " +"'{:f}; {:f}'\n" "'3.140000; -3.140000'" msgstr "" @@ -908,8 +922,8 @@ msgid "Using type-specific formatting::" msgstr "" msgid "" -">>> import datetime\n" -">>> d = datetime.datetime(2010, 7, 4, 12, 15, 58)\n" +">>> import datetime as dt\n" +">>> d = dt.datetime(2010, 7, 4, 12, 15, 58)\n" ">>> '{:%Y-%m-%d %H:%M:%S}'.format(d)\n" "'2010-07-04 12:15:58'" msgstr "" @@ -951,12 +965,13 @@ msgid "Template strings" msgstr "" msgid "" -"Template strings provide simpler string substitutions as described in :pep:" -"`292`. A primary use case for template strings is for internationalization " -"(i18n) since in that context, the simpler syntax and functionality makes it " -"easier to translate than other built-in string formatting facilities in " -"Python. As an example of a library built on template strings for i18n, see " -"the `flufl.i18n `_ package." +"Template strings provide simpler string substitutions as described " +"in :pep:`292`. A primary use case for template strings is for " +"internationalization (i18n) since in that context, the simpler syntax and " +"functionality makes it easier to translate than other built-in string " +"formatting facilities in Python. As an example of a library built on " +"template strings for i18n, see the `flufl.i18n `_ package." msgstr "" msgid "" @@ -983,8 +998,8 @@ msgid "" msgstr "" msgid "" -"Any other appearance of ``$`` in the string will result in a :exc:" -"`ValueError` being raised." +"Any other appearance of ``$`` in the string will result in " +"a :exc:`ValueError` being raised." msgstr "" msgid "" @@ -1021,8 +1036,8 @@ msgid "" msgstr "" msgid "" -"Returns false if the template has invalid placeholders that will cause :meth:" -"`substitute` to raise :exc:`ValueError`." +"Returns ``False`` if the template has invalid placeholders that will " +"cause :meth:`substitute` to raise :exc:`ValueError`." msgstr "" msgid "" @@ -1069,10 +1084,10 @@ msgstr "" msgid "" "*delimiter* -- This is the literal string describing a placeholder " "introducing delimiter. The default value is ``$``. Note that this should " -"*not* be a regular expression, as the implementation will call :meth:`re." -"escape` on this string as needed. Note further that you cannot change the " -"delimiter after class creation (i.e. a different delimiter must be set in " -"the subclass's class namespace)." +"*not* be a regular expression, as the implementation will " +"call :meth:`re.escape` on this string as needed. Note further that you " +"cannot change the delimiter after class creation (i.e. a different delimiter " +"must be set in the subclass's class namespace)." msgstr "" msgid "" @@ -1111,9 +1126,9 @@ msgstr "" msgid "" "Alternatively, you can provide the entire regular expression pattern by " "overriding the class attribute *pattern*. If you do this, the value must be " -"a regular expression object with four named capturing groups. The capturing " -"groups correspond to the rules given above, along with the invalid " -"placeholder rule:" +"a regular expression pattern string, or a compiled regular expression " +"object, with four named capturing groups. The capturing groups correspond " +"to the rules given above, along with the invalid placeholder rule:" msgstr "" msgid "" @@ -1146,11 +1161,11 @@ msgstr "" msgid "" "Split the argument into words using :meth:`str.split`, capitalize each word " -"using :meth:`str.capitalize`, and join the capitalized words using :meth:" -"`str.join`. If the optional second argument *sep* is absent or ``None``, " -"runs of whitespace characters are replaced by a single space and leading and " -"trailing whitespace are removed, otherwise *sep* is used to split and join " -"the words." +"using :meth:`str.capitalize`, and join the capitalized words " +"using :meth:`str.join`. If the optional second argument *sep* is absent or " +"``None``, runs of whitespace characters are replaced by a single space and " +"leading and trailing whitespace are removed, otherwise *sep* is used to " +"split and join the words." msgstr "" msgid "{} (curly brackets)" diff --git a/library/stringprep.po b/library/stringprep.po index 970e58fcfd..86ca087375 100644 --- a/library/stringprep.po +++ b/library/stringprep.po @@ -58,11 +58,11 @@ msgstr "" msgid "" "As a result, these tables are exposed as functions, not as data structures. " -"There are two kinds of tables in the RFC: sets and mappings. For a set, :mod:" -"`stringprep` provides the \"characteristic function\", i.e. a function that " -"returns ``True`` if the parameter is part of the set. For mappings, it " -"provides the mapping function: given the key, it returns the associated " -"value. Below is a list of all functions available in the module." +"There are two kinds of tables in the RFC: sets and mappings. For a " +"set, :mod:`stringprep` provides the \"characteristic function\", i.e. a " +"function that returns ``True`` if the parameter is part of the set. For " +"mappings, it provides the mapping function: given the key, it returns the " +"associated value. Below is a list of all functions available in the module." msgstr "" msgid "" diff --git a/library/struct.po b/library/struct.po index 7805c654bb..d8daec45de 100644 --- a/library/struct.po +++ b/library/struct.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,7 +27,7 @@ msgid ":mod:`!struct` --- Interpret bytes as packed binary data" msgstr "" msgid "**Source code:** :source:`Lib/struct.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/struct.py`" msgid "" "This module converts between Python values and C structs represented as " @@ -55,12 +52,12 @@ msgstr "" msgid "" "Several :mod:`struct` functions (and methods of :class:`Struct`) take a " -"*buffer* argument. This refers to objects that implement the :ref:" -"`bufferobjects` and provide either a readable or read-writable buffer. The " -"most common types used for that purpose are :class:`bytes` and :class:" -"`bytearray`, but many other types that can be viewed as an array of bytes " -"implement the buffer protocol, so that they can be read/filled without " -"additional copying from a :class:`bytes` object." +"*buffer* argument. This refers to objects that implement " +"the :ref:`bufferobjects` and provide either a readable or read-writable " +"buffer. The most common types used for that purpose are :class:`bytes` " +"and :class:`bytearray`, but many other types that can be viewed as an array " +"of bytes implement the buffer protocol, so that they can be read/filled " +"without additional copying from a :class:`bytes` object." msgstr "" msgid "Functions and Exceptions" @@ -83,7 +80,8 @@ msgstr "" msgid "" "Pack the values *v1*, *v2*, ... according to the format string *format* and " "write the packed bytes into the writable buffer *buffer* starting at " -"position *offset*. Note that *offset* is a required argument." +"position *offset*. Note that *offset* is a required argument. A negative " +"*offset* counts from the end of *buffer*." msgstr "" msgid "" @@ -97,7 +95,8 @@ msgid "" "Unpack from *buffer* starting at position *offset*, according to the format " "string *format*. The result is a tuple even if it contains exactly one " "item. The buffer's size in bytes, starting at position *offset*, must be at " -"least the size required by the format, as reflected by :func:`calcsize`." +"least the size required by the format, as reflected by :func:`calcsize`. A " +"negative *offset* counts from the end of *buffer*." msgstr "" msgid "" @@ -212,8 +211,8 @@ msgstr "" msgid "" "Native byte order is big-endian or little-endian, depending on the host " "system. For example, Intel x86, AMD64 (x86-64), and Apple M1 are little-" -"endian; IBM z and many legacy architectures are big-endian. Use :data:`sys." -"byteorder` to check the endianness of your system." +"endian; IBM z and many legacy architectures are big-endian. " +"Use :data:`sys.byteorder` to check the endianness of your system." msgstr "" msgid "" @@ -222,8 +221,8 @@ msgid "" msgstr "" msgid "" -"Standard size depends only on the format character; see the table in the :" -"ref:`format-characters` section." +"Standard size depends only on the format character; see the table in " +"the :ref:`format-characters` section." msgstr "" msgid "" @@ -297,7 +296,7 @@ msgid "no value" msgstr "" msgid "\\(7)" -msgstr "" +msgstr "\\(7)" msgid "``c``" msgstr "``c``" @@ -315,22 +314,19 @@ msgid "``b``" msgstr "``b``" msgid ":c:expr:`signed char`" -msgstr "" +msgstr ":c:expr:`signed char`" -msgid "integer" -msgstr "" +msgid "int" +msgstr "int" -msgid "\\(1), \\(2)" -msgstr "" +msgid "\\(2)" +msgstr "\\(2)" msgid "``B``" msgstr "``B``" msgid ":c:expr:`unsigned char`" -msgstr "" - -msgid "\\(2)" -msgstr "\\(2)" +msgstr ":c:expr:`unsigned char`" msgid "``?``" msgstr "``?``" @@ -357,7 +353,7 @@ msgid "``H``" msgstr "``H``" msgid ":c:expr:`unsigned short`" -msgstr "" +msgstr ":c:expr:`unsigned short`" msgid "``i``" msgstr "``i``" @@ -372,7 +368,7 @@ msgid "``I``" msgstr "``I``" msgid ":c:expr:`unsigned int`" -msgstr "" +msgstr ":c:expr:`unsigned int`" msgid "``l``" msgstr "``l``" @@ -384,13 +380,13 @@ msgid "``L``" msgstr "``L``" msgid ":c:expr:`unsigned long`" -msgstr "" +msgstr ":c:expr:`unsigned long`" msgid "``q``" msgstr "``q``" msgid ":c:expr:`long long`" -msgstr "" +msgstr ":c:expr:`long long`" msgid "8" msgstr "8" @@ -407,8 +403,8 @@ msgstr "``n``" msgid ":c:type:`ssize_t`" msgstr ":c:type:`ssize_t`" -msgid "\\(3)" -msgstr "\\(3)" +msgid "\\(2), \\(3)" +msgstr "" msgid "``N``" msgstr "``N``" @@ -419,14 +415,14 @@ msgstr ":c:type:`size_t`" msgid "``e``" msgstr "``e``" -msgid "\\(6)" +msgid ":c:expr:`_Float16`" msgstr "" msgid "float" msgstr "typ (float) zmiennoprzecinkowy pojedynczej precyzji" -msgid "\\(4)" -msgstr "\\(4)" +msgid "\\(4), \\(6)" +msgstr "" msgid "``f``" msgstr "``f``" @@ -434,6 +430,9 @@ msgstr "``f``" msgid ":c:expr:`float`" msgstr ":c:expr:`float`" +msgid "\\(4)" +msgstr "\\(4)" + msgid "``d``" msgstr "``d``" @@ -450,22 +449,22 @@ msgid "bytes" msgstr "" msgid "\\(9)" -msgstr "" +msgstr "\\(9)" msgid "``p``" msgstr "``p``" msgid "\\(8)" -msgstr "" +msgstr "\\(8)" msgid "``P``" msgstr "``P``" msgid ":c:expr:`void \\*`" -msgstr "" +msgstr ":c:expr:`void \\*`" -msgid "\\(5)" -msgstr "\\(5)" +msgid "\\(2), \\(5)" +msgstr "" msgid "Added support for the ``'n'`` and ``'N'`` formats." msgstr "" @@ -514,10 +513,12 @@ msgid "" "revision of the `IEEE 754 standard `_. It has a sign " "bit, a 5-bit exponent and 11-bit precision (with 10 bits explicitly stored), " "and can represent numbers between approximately ``6.1e-05`` and ``6.5e+04`` " -"at full precision. This type is not widely supported by C compilers: on a " -"typical machine, an unsigned short can be used for storage, but not for math " -"operations. See the Wikipedia page on the `half-precision floating-point " -"format `_ for more information." +"at full precision. This type is not widely supported by C compilers: it's " +"available as :c:expr:`_Float16` type, if the compiler supports the Annex H " +"of the C23 standard. On a typical machine, an unsigned short can be used " +"for storage, but not for math operations. See the Wikipedia page on the " +"`half-precision floating-point format `_ for more " +"information." msgstr "" msgid "When packing, ``'x'`` inserts one NUL byte." @@ -527,27 +528,30 @@ msgid "" "The ``'p'`` format character encodes a \"Pascal string\", meaning a short " "variable-length string stored in a *fixed number of bytes*, given by the " "count. The first byte stored is the length of the string, or 255, whichever " -"is smaller. The bytes of the string follow. If the string passed in to :" -"func:`pack` is too long (longer than the count minus 1), only the leading " -"``count-1`` bytes of the string are stored. If the string is shorter than " -"``count-1``, it is padded with null bytes so that exactly count bytes in all " -"are used. Note that for :func:`unpack`, the ``'p'`` format character " -"consumes ``count`` bytes, but that the string returned can never contain " -"more than 255 bytes." +"is smaller. The bytes of the string follow. If the byte string passed in " +"to :func:`pack` is too long (longer than the count minus 1), only the " +"leading ``count-1`` bytes of the string are stored. If the byte string is " +"shorter than ``count-1``, it is padded with null bytes so that exactly count " +"bytes in all are used. Note that for :func:`unpack`, the ``'p'`` format " +"character consumes ``count`` bytes, but that the :class:`!bytes` object " +"returned can never contain more than 255 bytes. When packing, arguments of " +"types :class:`bytes` and :class:`bytearray` are accepted." msgstr "" msgid "" "For the ``'s'`` format character, the count is interpreted as the length of " -"the bytes, not a repeat count like for the other format characters; for " -"example, ``'10s'`` means a single 10-byte string mapping to or from a single " -"Python byte string, while ``'10c'`` means 10 separate one byte character " -"elements (e.g., ``cccccccccc``) mapping to or from ten different Python byte " -"objects. (See :ref:`struct-examples` for a concrete demonstration of the " -"difference.) If a count is not given, it defaults to 1. For packing, the " -"string is truncated or padded with null bytes as appropriate to make it fit. " -"For unpacking, the resulting bytes object always has exactly the specified " -"number of bytes. As a special case, ``'0s'`` means a single, empty string " -"(while ``'0c'`` means 0 characters)." +"the byte string, not a repeat count like for the other format characters; " +"for example, ``'10s'`` means a single 10-byte string mapping to or from a " +"single Python byte string, while ``'10c'`` means 10 separate one byte " +"character elements (e.g., ``cccccccccc``) mapping to or from ten different " +"Python byte objects. (See :ref:`struct-examples` for a concrete " +"demonstration of the difference.) If a count is not given, it defaults to " +"1. For packing, the byte string is truncated or padded with null bytes as " +"appropriate to make it fit. For unpacking, the resulting :class:`!bytes` " +"object always has exactly the specified number of bytes. As a special case, " +"``'0s'`` means a single, empty byte string (while ``'0c'`` means 0 " +"characters). When packing, arguments of types :class:`bytes` " +"and :class:`bytearray` are accepted." msgstr "" msgid "" @@ -563,8 +567,8 @@ msgstr "" msgid "" "When packing a value ``x`` using one of the integer formats (``'b'``, " "``'B'``, ``'h'``, ``'H'``, ``'i'``, ``'I'``, ``'l'``, ``'L'``, ``'q'``, " -"``'Q'``), if ``x`` is outside the valid range for that format then :exc:" -"`struct.error` is raised." +"``'Q'``), if ``x`` is outside the valid range for that format " +"then :exc:`struct.error` is raised." msgstr "" msgid "" @@ -841,8 +845,8 @@ msgstr "" msgid "" "Identical to the :func:`unpack_from` function, using the compiled format. " -"The buffer's size in bytes, starting at position *offset*, must be at least :" -"attr:`size`." +"The buffer's size in bytes, starting at position *offset*, must be at " +"least :attr:`size`." msgstr "" msgid "" diff --git a/library/subprocess.po b/library/subprocess.po index 719dded1a6..f82436d7da 100644 --- a/library/subprocess.po +++ b/library/subprocess.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Blessing Oluronbi, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Blessing Oluronbi, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +28,7 @@ msgid ":mod:`!subprocess` --- Subprocess management" msgstr "" msgid "**Source code:** :source:`Lib/subprocess.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/subprocess.py`" msgid "" "The :mod:`subprocess` module allows you to spawn new processes, connect to " @@ -86,33 +85,35 @@ msgid "" "the internal :class:`Popen` object is automatically created with *stdout* " "and *stderr* both set to :data:`~subprocess.PIPE`. The *stdout* and *stderr* " "arguments may not be supplied at the same time as *capture_output*. If you " -"wish to capture and combine both streams into one, set *stdout* to :data:" -"`~subprocess.PIPE` and *stderr* to :data:`~subprocess.STDOUT`, instead of " -"using *capture_output*." +"wish to capture and combine both streams into one, set *stdout* " +"to :data:`~subprocess.PIPE` and *stderr* to :data:`~subprocess.STDOUT`, " +"instead of using *capture_output*." msgstr "" msgid "" -"A *timeout* may be specified in seconds, it is internally passed on to :meth:" -"`Popen.communicate`. If the timeout expires, the child process will be " -"killed and waited for. The :exc:`TimeoutExpired` exception will be re-raised " -"after the child process has terminated. The initial process creation itself " -"cannot be interrupted on many platform APIs so you are not guaranteed to see " -"a timeout exception until at least after however long process creation takes." +"A *timeout* may be specified in seconds, it is internally passed on " +"to :meth:`Popen.communicate`. If the timeout expires, the child process will " +"be killed and waited for. The :exc:`TimeoutExpired` exception will be re-" +"raised after the child process has terminated. The initial process creation " +"itself cannot be interrupted on many platform APIs so you are not guaranteed " +"to see a timeout exception until at least after however long process " +"creation takes." msgstr "" msgid "" "The *input* argument is passed to :meth:`Popen.communicate` and thus to the " "subprocess's stdin. If used it must be a byte sequence, or a string if " "*encoding* or *errors* is specified or *text* is true. When used, the " -"internal :class:`Popen` object is automatically created with *stdin* set to :" -"data:`~subprocess.PIPE`, and the *stdin* argument may not be used as well." +"internal :class:`Popen` object is automatically created with *stdin* set " +"to :data:`~subprocess.PIPE`, and the *stdin* argument may not be used as " +"well." msgstr "" msgid "" -"If *check* is true, and the process exits with a non-zero exit code, a :exc:" -"`CalledProcessError` exception will be raised. Attributes of that exception " -"hold the arguments, the exit code, and stdout and stderr if they were " -"captured." +"If *check* is true, and the process exits with a non-zero exit code, " +"a :exc:`CalledProcessError` exception will be raised. Attributes of that " +"exception hold the arguments, the exit code, and stdout and stderr if they " +"were captured." msgstr "" msgid "" @@ -128,8 +129,8 @@ msgid "" "variables for the new process; these are used instead of the default " "behavior of inheriting the current process' environment. It is passed " "directly to :class:`Popen`. This mapping can be str to str on any platform " -"or bytes to bytes on POSIX platforms much like :data:`os.environ` or :data:" -"`os.environb`." +"or bytes to bytes on POSIX platforms much like :data:`os.environ` " +"or :data:`os.environb`." msgstr "" msgid "Examples::" @@ -161,8 +162,8 @@ msgstr "" msgid "" "Changed Windows shell search order for ``shell=True``. The current directory " "and ``%PATH%`` are replaced with ``%COMSPEC%`` and ``%SystemRoot%" -"\\System32\\cmd.exe``. As a result, dropping a malicious program named ``cmd." -"exe`` into a current directory no longer works." +"\\System32\\cmd.exe``. As a result, dropping a malicious program named " +"``cmd.exe`` into a current directory no longer works." msgstr "" msgid "" @@ -184,9 +185,9 @@ msgid "" msgstr "" msgid "" -"Captured stdout from the child process. A bytes sequence, or a string if :" -"func:`run` was called with an encoding, errors, or text=True. ``None`` if " -"stdout was not captured." +"Captured stdout from the child process. A bytes sequence, or a string " +"if :func:`run` was called with an encoding, errors, or text=True. ``None`` " +"if stdout was not captured." msgstr "" msgid "" @@ -195,9 +196,9 @@ msgid "" msgstr "" msgid "" -"Captured stderr from the child process. A bytes sequence, or a string if :" -"func:`run` was called with an encoding, errors, or text=True. ``None`` if " -"stderr was not captured." +"Captured stderr from the child process. A bytes sequence, or a string " +"if :func:`run` was called with an encoding, errors, or text=True. ``None`` " +"if stderr was not captured." msgstr "" msgid "If :attr:`returncode` is non-zero, raise a :exc:`CalledProcessError`." @@ -236,10 +237,11 @@ msgid "Timeout in seconds." msgstr "" msgid "" -"Output of the child process if it was captured by :func:`run` or :func:" -"`check_output`. Otherwise, ``None``. This is always :class:`bytes` when " -"any output was captured regardless of the ``text=True`` setting. It may " -"remain ``None`` instead of ``b''`` when no output was observed." +"Output of the child process if it was captured by :func:`run` " +"or :func:`check_output`. Otherwise, ``None``. This is " +"always :class:`bytes` when any output was captured regardless of the " +"``text=True`` setting. It may remain ``None`` instead of ``b''`` when no " +"output was observed." msgstr "" msgid "Alias for output, for symmetry with :attr:`stderr`." @@ -256,19 +258,19 @@ msgid "*stdout* and *stderr* attributes added" msgstr "" msgid "" -"Subclass of :exc:`SubprocessError`, raised when a process run by :func:" -"`check_call`, :func:`check_output`, or :func:`run` (with ``check=True``) " -"returns a non-zero exit status." +"Subclass of :exc:`SubprocessError`, raised when a process run " +"by :func:`check_call`, :func:`check_output`, or :func:`run` (with " +"``check=True``) returns a non-zero exit status." msgstr "" msgid "" -"Exit status of the child process. If the process exited due to a signal, " -"this will be the negative signal number." +"Exit status of the child process, an integer. If the process exited due to " +"a signal, this will be the negative signal number." msgstr "" msgid "" -"Output of the child process if it was captured by :func:`run` or :func:" -"`check_output`. Otherwise, ``None``." +"Output of the child process if it was captured by :func:`run` " +"or :func:`check_output`. Otherwise, ``None``." msgstr "" msgid "" @@ -302,10 +304,10 @@ msgid "" "descriptor (a positive integer), and an existing :term:`file object` with a " "valid file descriptor. With the default settings of ``None``, no " "redirection will occur. :data:`PIPE` indicates that a new pipe to the child " -"should be created. :data:`DEVNULL` indicates that the special file :data:" -"`os.devnull` will be used. Additionally, *stderr* can be :data:`STDOUT`, " -"which indicates that the stderr data from the child process should be " -"captured into the same file handle as for *stdout*." +"should be created. :data:`DEVNULL` indicates that the special " +"file :data:`os.devnull` will be used. Additionally, *stderr* can " +"be :data:`STDOUT`, which indicates that the stderr data from the child " +"process should be captured into the same file handle as for *stdout*." msgstr "" msgid "" @@ -335,9 +337,9 @@ msgid "Added the *text* parameter as an alias for *universal_newlines*." msgstr "" msgid "" -"The newlines attribute of the file objects :attr:`Popen.stdin`, :attr:`Popen." -"stdout` and :attr:`Popen.stderr` are not updated by the :meth:`Popen." -"communicate` method." +"The newlines attribute of the file " +"objects :attr:`Popen.stdin`, :attr:`Popen.stdout` and :attr:`Popen.stderr` " +"are not updated by the :meth:`Popen.communicate` method." msgstr "" msgid "" @@ -347,16 +349,17 @@ msgid "" "convenient access to other shell features such as shell pipes, filename " "wildcards, environment variable expansion, and expansion of ``~`` to a " "user's home directory. However, note that Python itself offers " -"implementations of many shell-like features (in particular, :mod:`glob`, :" -"mod:`fnmatch`, :func:`os.walk`, :func:`os.path.expandvars`, :func:`os.path." -"expanduser`, and :mod:`shutil`)." +"implementations of many shell-like features (in " +"particular, :mod:`glob`, :mod:`fnmatch`, :func:`os.walk`, :func:`os.path.expandvars`, :func:`os.path.expanduser`, " +"and :mod:`shutil`)." msgstr "" msgid "" -"When *universal_newlines* is ``True``, the class uses the encoding :func:" -"`locale.getpreferredencoding(False) ` instead " -"of ``locale.getpreferredencoding()``. See the :class:`io.TextIOWrapper` " -"class for more information on this change." +"When *universal_newlines* is ``True``, the class uses the " +"encoding :func:`locale.getpreferredencoding(False) " +"` instead of " +"``locale.getpreferredencoding()``. See the :class:`io.TextIOWrapper` class " +"for more information on this change." msgstr "" msgid "" @@ -379,15 +382,15 @@ msgid "" msgstr "" msgid "" -"Execute a child program in a new process. On POSIX, the class uses :meth:" -"`os.execvpe`-like behavior to execute the child program. On Windows, the " -"class uses the Windows ``CreateProcess()`` function. The arguments to :" -"class:`Popen` are as follows." +"Execute a child program in a new process. On POSIX, the class " +"uses :meth:`os.execvpe`-like behavior to execute the child program. On " +"Windows, the class uses the Windows ``CreateProcess()`` function. The " +"arguments to :class:`Popen` are as follows." msgstr "" msgid "" -"*args* should be a sequence of program arguments or else a single string or :" -"term:`path-like object`. By default, the program to execute is the first " +"*args* should be a sequence of program arguments or else a single string " +"or :term:`path-like object`. By default, the program to execute is the first " "item in *args* if *args* is a sequence. If *args* is a string, the " "interpretation is platform-dependent and described below. See the *shell* " "and *executable* arguments for additional differences from the default " @@ -485,8 +488,8 @@ msgid "" "when typed at the shell prompt. This includes, for example, quoting or " "backslash escaping filenames with spaces in them. If *args* is a sequence, " "the first item specifies the command string, and any additional items will " -"be treated as additional arguments to the shell itself. That is to say, :" -"class:`Popen` does the equivalent of::" +"be treated as additional arguments to the shell itself. That is to " +"say, :class:`Popen` does the equivalent of::" msgstr "" msgid "Popen(['/bin/sh', '-c', args[0], args[1], ...])" @@ -519,8 +522,8 @@ msgid "any other positive value means use a buffer of approximately that size" msgstr "" msgid "" -"negative bufsize (the default) means the system default of io." -"DEFAULT_BUFFER_SIZE will be used." +"negative bufsize (the default) means the system default of " +"io.DEFAULT_BUFFER_SIZE will be used." msgstr "" msgid "" @@ -558,10 +561,10 @@ msgid "" "descriptor (a positive integer), and an existing :term:`file object` with a " "valid file descriptor. With the default settings of ``None``, no " "redirection will occur. :data:`PIPE` indicates that a new pipe to the child " -"should be created. :data:`DEVNULL` indicates that the special file :data:" -"`os.devnull` will be used. Additionally, *stderr* can be :data:`STDOUT`, " -"which indicates that the stderr data from the applications should be " -"captured into the same file handle as for *stdout*." +"should be created. :data:`DEVNULL` indicates that the special " +"file :data:`os.devnull` will be used. Additionally, *stderr* can " +"be :data:`STDOUT`, which indicates that the stderr data from the " +"applications should be captured into the same file handle as for *stdout*." msgstr "" msgid "" @@ -597,8 +600,8 @@ msgstr "" msgid "" "On Windows, if *close_fds* is true then no handles will be inherited by the " -"child process unless explicitly passed in the ``handle_list`` element of :" -"attr:`STARTUPINFO.lpAttributeList`, or by standard handle redirection." +"child process unless explicitly passed in the ``handle_list`` element " +"of :attr:`STARTUPINFO.lpAttributeList`, or by standard handle redirection." msgstr "" msgid "" @@ -607,15 +610,15 @@ msgid "" msgstr "" msgid "" -"On Windows the default for *close_fds* was changed from :const:`False` to :" -"const:`True` when redirecting the standard handles. It's now possible to set " -"*close_fds* to :const:`True` when redirecting the standard handles." +"On Windows the default for *close_fds* was changed from :const:`False` " +"to :const:`True` when redirecting the standard handles. It's now possible to " +"set *close_fds* to :const:`True` when redirecting the standard handles." msgstr "" msgid "" "*pass_fds* is an optional sequence of file descriptors to keep open between " -"the parent and child. Providing any *pass_fds* forces *close_fds* to be :" -"const:`True`. (POSIX only)" +"the parent and child. Providing any *pass_fds* forces *close_fds* to " +"be :const:`True`. (POSIX only)" msgstr "" msgid "The *pass_fds* parameter was added." @@ -623,10 +626,10 @@ msgstr "" msgid "" "If *cwd* is not ``None``, the function changes the working directory to " -"*cwd* before executing the child. *cwd* can be a string, bytes or :term:" -"`path-like ` object. On POSIX, the function looks for " -"*executable* (or for the first item in *args*) relative to *cwd* if the " -"executable path is a relative path." +"*cwd* before executing the child. *cwd* can be a string, bytes " +"or :term:`path-like ` object. On POSIX, the function " +"looks for *executable* (or for the first item in *args*) relative to *cwd* " +"if the executable path is a relative path." msgstr "" msgid "*cwd* parameter accepts a :term:`path-like object` on POSIX." @@ -688,6 +691,12 @@ msgid "" "passed verbatim. (POSIX only)" msgstr "" +msgid "" +"Specifying *user* will not drop existing supplementary group memberships! " +"The caller must also pass ``extra_groups=()`` to reduce the group membership " +"of the child process for security purposes." +msgstr "" + msgid "" "If *umask* is not negative, the umask() system call will be made in the " "child process prior to the execution of the subprocess." @@ -697,14 +706,14 @@ msgid "" "If *env* is not ``None``, it must be a mapping that defines the environment " "variables for the new process; these are used instead of the default " "behavior of inheriting the current process' environment. This mapping can be " -"str to str on any platform or bytes to bytes on POSIX platforms much like :" -"data:`os.environ` or :data:`os.environb`." +"str to str on any platform or bytes to bytes on POSIX platforms much " +"like :data:`os.environ` or :data:`os.environb`." msgstr "" msgid "" "If specified, *env* must provide any variables required for the program to " "execute. On Windows, in order to run a `side-by-side assembly`_ the " -"specified *env* **must** include a valid :envvar:`SystemRoot`." +"specified *env* **must** include a valid ``%SystemRoot%``." msgstr "" msgid "" @@ -788,14 +797,14 @@ msgid "" msgstr "" msgid "" -"Popen and the other functions in this module that use it raise an :ref:" -"`auditing event ` ``subprocess.Popen`` with arguments " +"Popen and the other functions in this module that use it raise " +"an :ref:`auditing event ` ``subprocess.Popen`` with arguments " "``executable``, ``args``, ``cwd``, and ``env``. The value for ``args`` may " "be a single string or a list of strings, depending on platform." msgstr "" msgid "Added context manager support." -msgstr "" +msgstr "Dodano obsługę menedżera kontekstu v" msgid "" "Popen destructor now emits a :exc:`ResourceWarning` warning if the child " @@ -806,8 +815,8 @@ msgid "" "Popen can use :func:`os.posix_spawn` in some cases for better performance. " "On Windows Subsystem for Linux and QEMU User Emulation, Popen constructor " "using :func:`os.posix_spawn` no longer raise an exception on errors like " -"missing program, but the child process fails with a non-zero :attr:`~Popen." -"returncode`." +"missing program, but the child process fails with a non-" +"zero :attr:`~Popen.returncode`." msgstr "" msgid "Exceptions" @@ -821,11 +830,11 @@ msgstr "" msgid "" "The most common exception raised is :exc:`OSError`. This occurs, for " "example, when trying to execute a non-existent file. Applications should " -"prepare for :exc:`OSError` exceptions. Note that, when ``shell=True``, :exc:" -"`OSError` will be raised by the child only if the selected shell itself was " -"not found. To determine if the shell failed to find the requested " -"application, it is necessary to check the return code or output from the " -"subprocess." +"prepare for :exc:`OSError` exceptions. Note that, when " +"``shell=True``, :exc:`OSError` will be raised by the child only if the " +"selected shell itself was not found. To determine if the shell failed to " +"find the requested application, it is necessary to check the return code or " +"output from the subprocess." msgstr "" msgid "" @@ -834,14 +843,15 @@ msgid "" msgstr "" msgid "" -":func:`check_call` and :func:`check_output` will raise :exc:" -"`CalledProcessError` if the called process returns a non-zero return code." +":func:`check_call` and :func:`check_output` will " +"raise :exc:`CalledProcessError` if the called process returns a non-zero " +"return code." msgstr "" msgid "" -"All of the functions and methods that accept a *timeout* parameter, such as :" -"func:`run` and :meth:`Popen.communicate` will raise :exc:`TimeoutExpired` if " -"the timeout expires before the process exits." +"All of the functions and methods that accept a *timeout* parameter, such " +"as :func:`run` and :meth:`Popen.communicate` will " +"raise :exc:`TimeoutExpired` if the timeout expires before the process exits." msgstr "" msgid "" @@ -872,8 +882,8 @@ msgid "" "this library. This could result in arguments being parsed according to shell " "rules, but without any escaping added by Python. If you are intentionally " "launching a batch file with arguments from untrusted sources, consider " -"passing ``shell=True`` to allow Python to escape special characters. See :gh:" -"`114539` for additional discussion." +"passing ``shell=True`` to allow Python to escape special characters. " +"See :gh:`114539` for additional discussion." msgstr "" msgid "Popen Objects" @@ -883,19 +893,19 @@ msgid "Instances of the :class:`Popen` class have the following methods:" msgstr "" msgid "" -"Check if child process has terminated. Set and return :attr:`~Popen." -"returncode` attribute. Otherwise, returns ``None``." +"Check if child process has terminated. Set and " +"return :attr:`~Popen.returncode` attribute. Otherwise, returns ``None``." msgstr "" msgid "" -"Wait for child process to terminate. Set and return :attr:`~Popen." -"returncode` attribute." +"Wait for child process to terminate. Set and " +"return :attr:`~Popen.returncode` attribute." msgstr "" msgid "" -"If the process does not terminate after *timeout* seconds, raise a :exc:" -"`TimeoutExpired` exception. It is safe to catch this exception and retry " -"the wait." +"If the process does not terminate after *timeout* seconds, raise " +"a :exc:`TimeoutExpired` exception. It is safe to catch this exception and " +"retry the wait." msgstr "" msgid "" @@ -908,8 +918,8 @@ msgstr "" msgid "" "When the ``timeout`` parameter is not ``None``, then (on POSIX) the function " "is implemented using a busy loop (non-blocking call and short sleeps). Use " -"the :mod:`asyncio` module for an asynchronous wait: see :class:`asyncio." -"create_subprocess_exec`." +"the :mod:`asyncio` module for an asynchronous wait: " +"see :class:`asyncio.create_subprocess_exec`." msgstr "" msgid "*timeout* was added." @@ -937,9 +947,11 @@ msgid "" msgstr "" msgid "" -"If the process does not terminate after *timeout* seconds, a :exc:" -"`TimeoutExpired` exception will be raised. Catching this exception and " -"retrying communication will not lose any output." +"If the process does not terminate after *timeout* seconds, " +"a :exc:`TimeoutExpired` exception will be raised. Catching this exception " +"and retrying communication will not lose any output. Supplying *input* to a " +"subsequent post-timeout :meth:`communicate` call is in undefined behavior " +"and may become an error in the future." msgstr "" msgid "" @@ -957,6 +969,13 @@ msgid "" " outs, errs = proc.communicate()" msgstr "" +msgid "" +"After a call to :meth:`~Popen.communicate` raises :exc:`TimeoutExpired`, do " +"not call :meth:`~Popen.wait`. Use an additional :meth:`~Popen.communicate` " +"call to finish handling pipes and populate the :attr:`~Popen.returncode` " +"attribute." +msgstr "" + msgid "" "The data read is buffered in memory, so do not use this method if the data " "size is large or unlimited." @@ -1022,10 +1041,10 @@ msgid "" msgstr "" msgid "" -"Use :meth:`~Popen.communicate` rather than :attr:`.stdin.write `, :attr:`.stdout.read ` or :attr:`.stderr.read ` to avoid deadlocks due to any of the other OS pipe buffers filling " -"up and blocking the child process." +"Use :meth:`~Popen.communicate` rather than :attr:`.stdin.write " +"`, :attr:`.stdout.read ` or :attr:`.stderr.read " +"` to avoid deadlocks due to any of the other OS pipe buffers " +"filling up and blocking the child process." msgstr "" msgid "The process ID of the child process." @@ -1047,6 +1066,13 @@ msgid "" "time of the last method call." msgstr "" +msgid "" +"When ``shell=True``, the return code reflects the exit status of the shell " +"itself (e.g. ``/bin/sh``), which may map signals to codes such as ``128+N``. " +"See the documentation of the shell (for example, the Bash manual's Exit " +"Status) for details." +msgstr "" + msgid "Windows Popen Helpers" msgstr "" @@ -1072,8 +1098,8 @@ msgstr "" msgid "" "si = subprocess.STARTUPINFO()\n" -"si.dwFlags = subprocess.STARTF_USESTDHANDLES | subprocess." -"STARTF_USESHOWWINDOW" +"si.dwFlags = subprocess.STARTF_USESTDHANDLES | " +"subprocess.STARTF_USESHOWWINDOW" msgstr "" msgid "" @@ -1103,14 +1129,14 @@ msgid "" msgstr "" msgid "" -":data:`SW_HIDE` is provided for this attribute. It is used when :class:" -"`Popen` is called with ``shell=True``." +":data:`SW_HIDE` is provided for this attribute. It is used " +"when :class:`Popen` is called with ``shell=True``." msgstr "" msgid "" "A dictionary of additional attributes for process creation as given in " -"``STARTUPINFOEX``, see `UpdateProcThreadAttribute `__." +"``STARTUPINFOEX``, see `UpdateProcThreadAttribute `__." msgstr "" msgid "Supported attributes:" @@ -1125,18 +1151,18 @@ msgid "" msgstr "" msgid "" -"The handles must be temporarily made inheritable by :func:`os." -"set_handle_inheritable` when passed to the :class:`Popen` constructor, else :" -"class:`OSError` will be raised with Windows error " +"The handles must be temporarily made inheritable " +"by :func:`os.set_handle_inheritable` when passed to the :class:`Popen` " +"constructor, else :class:`OSError` will be raised with Windows error " "``ERROR_INVALID_PARAMETER`` (87)." msgstr "" msgid "" "In a multithreaded process, use caution to avoid leaking handles that are " "marked inheritable when combining this feature with concurrent calls to " -"other process creation functions that inherit all handles such as :func:`os." -"system`. This also applies to standard handle redirection, which " -"temporarily creates inheritable handles." +"other process creation functions that inherit all handles such " +"as :func:`os.system`. This also applies to standard handle redirection, " +"which temporarily creates inheritable handles." msgstr "" msgid "Windows Constants" @@ -1164,9 +1190,9 @@ msgid "Hides the window. Another window will be activated." msgstr "" msgid "" -"Specifies that the :attr:`STARTUPINFO.hStdInput`, :attr:`STARTUPINFO." -"hStdOutput`, and :attr:`STARTUPINFO.hStdError` attributes contain additional " -"information." +"Specifies that " +"the :attr:`STARTUPINFO.hStdInput`, :attr:`STARTUPINFO.hStdOutput`, " +"and :attr:`STARTUPINFO.hStdError` attributes contain additional information." msgstr "" msgid "" @@ -1295,10 +1321,11 @@ msgstr "" msgid "" "Run command with arguments. Wait for command to complete. If the return " -"code was zero then return, otherwise raise :exc:`CalledProcessError`. The :" -"exc:`CalledProcessError` object will have the return code in the :attr:" -"`~CalledProcessError.returncode` attribute. If :func:`check_call` was unable " -"to start the process it will propagate the exception that was raised." +"code was zero then return, otherwise raise :exc:`CalledProcessError`. " +"The :exc:`CalledProcessError` object will have the return code in " +"the :attr:`~CalledProcessError.returncode` attribute. If :func:`check_call` " +"was unable to start the process it will propagate the exception that was " +"raised." msgstr "" msgid "run(..., check=True)" @@ -1308,10 +1335,10 @@ msgid "Run command with arguments and return its output." msgstr "" msgid "" -"If the return code was non-zero it raises a :exc:`CalledProcessError`. The :" -"exc:`CalledProcessError` object will have the return code in the :attr:" -"`~CalledProcessError.returncode` attribute and any output in the :attr:" -"`~CalledProcessError.output` attribute." +"If the return code was non-zero it raises a :exc:`CalledProcessError`. " +"The :exc:`CalledProcessError` object will have the return code in " +"the :attr:`~CalledProcessError.returncode` attribute and any output in " +"the :attr:`~CalledProcessError.output` attribute." msgstr "" msgid "This is equivalent to::" @@ -1323,10 +1350,10 @@ msgstr "" msgid "" "The arguments shown above are merely some common ones. The full function " "signature is largely the same as that of :func:`run` - most arguments are " -"passed directly through to that interface. One API deviation from :func:" -"`run` behavior exists: passing ``input=None`` will behave the same as " -"``input=b''`` (or ``input=''``, depending on other arguments) rather than " -"using the parent's standard input file handle." +"passed directly through to that interface. One API deviation " +"from :func:`run` behavior exists: passing ``input=None`` will behave the " +"same as ``input=b''`` (or ``input=''``, depending on other arguments) rather " +"than using the parent's standard input file handle." msgstr "" msgid "" @@ -1342,8 +1369,8 @@ msgid "" msgstr "" msgid "" -"To also capture standard error in the result, use ``stderr=subprocess." -"STDOUT``::" +"To also capture standard error in the result, use " +"``stderr=subprocess.STDOUT``::" msgstr "" msgid "" @@ -1370,15 +1397,15 @@ msgstr "" msgid "" "All \"a\" functions in this section fail (more or less) silently if the " -"executed program cannot be found; the \"b\" replacements raise :exc:" -"`OSError` instead." +"executed program cannot be found; the \"b\" replacements " +"raise :exc:`OSError` instead." msgstr "" msgid "" -"In addition, the replacements using :func:`check_output` will fail with a :" -"exc:`CalledProcessError` if the requested operation produces a non-zero " -"return code. The output is still available as the :attr:`~CalledProcessError." -"output` attribute of the raised exception." +"In addition, the replacements using :func:`check_output` will fail with " +"a :exc:`CalledProcessError` if the requested operation produces a non-zero " +"return code. The output is still available as " +"the :attr:`~CalledProcessError.output` attribute of the raised exception." msgstr "" msgid "" @@ -1440,14 +1467,14 @@ msgid "Calling the program through the shell is usually not required." msgstr "" msgid "" -"The :func:`call` return value is encoded differently to that of :func:`os." -"system`." +"The :func:`call` return value is encoded differently to that " +"of :func:`os.system`." msgstr "" msgid "" "The :func:`os.system` function ignores SIGINT and SIGQUIT signals while the " -"command is running, but the caller must do this separately when using the :" -"mod:`subprocess` module." +"command is running, but the caller must do this separately when using " +"the :mod:`subprocess` module." msgstr "" msgid "A more realistic example would look like this::" @@ -1457,8 +1484,8 @@ msgid "" "try:\n" " retcode = call(\"mycmd\" + \" myarg\", shell=True)\n" " if retcode < 0:\n" -" print(\"Child was terminated by signal\", -retcode, file=sys." -"stderr)\n" +" print(\"Child was terminated by signal\", -retcode, " +"file=sys.stderr)\n" " else:\n" " print(\"Child returned\", retcode, file=sys.stderr)\n" "except OSError as e:\n" @@ -1587,8 +1614,8 @@ msgid "" msgstr "" msgid "" -":class:`popen2.Popen3` and :class:`popen2.Popen4` basically work as :class:" -"`subprocess.Popen`, except that:" +":class:`popen2.Popen3` and :class:`popen2.Popen4` basically work " +"as :class:`subprocess.Popen`, except that:" msgstr "" msgid ":class:`Popen` raises an exception if the execution fails." @@ -1620,10 +1647,9 @@ msgid "Return ``(exitcode, output)`` of executing *cmd* in a shell." msgstr "" msgid "" -"Execute the string *cmd* in a shell with :meth:`Popen.check_output` and " -"return a 2-tuple ``(exitcode, output)``. *encoding* and *errors* are used to " -"decode output; see the notes on :ref:`frequently-used-arguments` for more " -"details." +"Execute the string *cmd* in a shell with :func:`check_output` and return a 2-" +"tuple ``(exitcode, output)``. *encoding* and *errors* are used to decode " +"output; see the notes on :ref:`frequently-used-arguments` for more details." msgstr "" msgid "" @@ -1647,8 +1673,8 @@ msgstr "" msgid "" "The function now returns (exitcode, output) instead of (status, output) as " -"it did in Python 3.3.3 and earlier. exitcode has the same value as :attr:" -"`~Popen.returncode`." +"it did in Python 3.3.3 and earlier. exitcode has the same value " +"as :attr:`~Popen.returncode`." msgstr "" msgid "Return output (stdout and stderr) of executing *cmd* in a shell." @@ -1672,6 +1698,29 @@ msgstr "" msgid "Notes" msgstr "Notatki" +msgid "Timeout Behavior" +msgstr "" + +msgid "" +"When using the ``timeout`` parameter in functions " +"like :func:`run`, :meth:`Popen.wait`, or :meth:`Popen.communicate`, users " +"should be aware of the following behaviors:" +msgstr "" + +msgid "" +"**Process Creation Delay**: The initial process creation itself cannot be " +"interrupted on many platform APIs. This means that even when specifying a " +"timeout, you are not guaranteed to see a timeout exception until at least " +"after however long process creation takes." +msgstr "" + +msgid "" +"**Extremely Small Timeout Values**: Setting very small timeout values (such " +"as a few milliseconds) may result in almost immediate :exc:`TimeoutExpired` " +"exceptions because process creation and system scheduling inherently require " +"time." +msgstr "" + msgid "Converting an argument sequence to a string on Windows" msgstr "" @@ -1725,8 +1774,8 @@ 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 :const:" -"`subprocess._USE_VFORK` attribute to a false value." +"prevent ``vfork()`` from being used by Python, you can set " +"the :const:`subprocess._USE_VFORK` attribute to a false value." msgstr "" msgid "subprocess._USE_VFORK = False # See CPython issue gh-NNNNNN." @@ -1734,9 +1783,9 @@ 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 :" -"const:`subprocess._USE_POSIX_SPAWN` attribute if you need to prevent use of " -"that." +"``vfork()`` internally within its libc implementation. There is a " +"similar :const:`subprocess._USE_POSIX_SPAWN` attribute if you need to " +"prevent use of that." msgstr "" msgid "subprocess._USE_POSIX_SPAWN = False # See CPython issue gh-NNNNNN." @@ -1756,7 +1805,7 @@ msgid "" msgstr "" msgid "``_USE_POSIX_SPAWN``" -msgstr "" +msgstr "``_USE_POSIX_SPAWN``" msgid "``_USE_VFORK``" msgstr "" diff --git a/library/symtable.po b/library/symtable.po index 5cb15d32a7..83e3afb27e 100644 --- a/library/symtable.po +++ b/library/symtable.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stefan Ocetkiewicz , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,7 +27,7 @@ msgid ":mod:`!symtable` --- Access to the compiler's symbol tables" msgstr "" msgid "**Source code:** :source:`Lib/symtable.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/symtable.py`" msgid "" "Symbol tables are generated by the compiler from AST just before bytecode is " @@ -90,8 +88,8 @@ msgid "A namespace table for a block. The constructor is not public." msgstr "" msgid "" -"Return the type of the symbol table. Possible values are members of the :" -"class:`SymbolTableType` enumeration." +"Return the type of the symbol table. Possible values are members of " +"the :class:`SymbolTableType` enumeration." msgstr "" msgid "" @@ -117,8 +115,8 @@ msgid "" "``'top'`` if the table is global (:meth:`get_type` returns ``'module'``). " "For type parameter scopes (which are used for generic classes, functions, " "and type aliases), it is the name of the underlying class, function, or type " -"alias. For type alias scopes, it is the name of the type alias. For :class:" -"`~typing.TypeVar` bound scopes, it is the name of the ``TypeVar``." +"alias. For type alias scopes, it is the name of the type alias. " +"For :class:`~typing.TypeVar` bound scopes, it is the name of the ``TypeVar``." msgstr "" msgid "Return the number of the first line in the block this table represents." @@ -136,8 +134,8 @@ msgid "" msgstr "" msgid "" -"Return a view object containing the names of symbols in the table. See the :" -"ref:`documentation of view objects `." +"Return a view object containing the names of symbols in the table. See " +"the :ref:`documentation of view objects `." msgstr "" msgid "Lookup *name* in the table and return a :class:`Symbol` instance." @@ -150,8 +148,8 @@ msgid "Return a list of the nested symbol tables." msgstr "" msgid "" -"A namespace for a function or method. This class inherits from :class:" -"`SymbolTable`." +"A namespace for a function or method. This class inherits " +"from :class:`SymbolTable`." msgstr "" msgid "Return a tuple containing names of parameters to this function." diff --git a/library/sys.monitoring.po b/library/sys.monitoring.po index f07a26de55..fd1b5ab926 100644 --- a/library/sys.monitoring.po +++ b/library/sys.monitoring.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-25 14:19+0000\n" -"PO-Revision-Date: 2023-09-08 14:16+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,9 +27,10 @@ msgid ":mod:`!sys.monitoring` --- Execution event monitoring" msgstr "" msgid "" -":mod:`sys.monitoring` is a namespace within the :mod:`sys` module, not an " -"independent module, so there is no need to ``import sys.monitoring``, simply " -"``import sys`` and then use ``sys.monitoring``." +":mod:`!sys.monitoring` is a namespace within the :mod:`sys` module, not an " +"independent module, and ``import sys.monitoring`` would fail with " +"a :exc:`ModuleNotFoundError`. Instead, simply ``import sys`` and then use " +"``sys.monitoring``." msgstr "" msgid "" @@ -169,8 +170,8 @@ msgid "" msgstr "" msgid "" -"An exception is raised, except those that cause a :monitoring-event:" -"`STOP_ITERATION` event." +"An exception is raised, except those that cause a :monitoring-" +"event:`STOP_ITERATION` event." msgstr "" msgid "" @@ -262,9 +263,9 @@ msgstr ":monitoring-event:`C_RETURN`" msgid "" "The :monitoring-event:`C_RETURN` and :monitoring-event:`C_RAISE` events are " -"controlled by the :monitoring-event:`CALL` event. :monitoring-event:" -"`C_RETURN` and :monitoring-event:`C_RAISE` events will only be seen if the " -"corresponding :monitoring-event:`CALL` event is being monitored." +"controlled by the :monitoring-event:`CALL` event. :monitoring-" +"event:`C_RETURN` and :monitoring-event:`C_RAISE` events will only be seen if " +"the corresponding :monitoring-event:`CALL` event is being monitored." msgstr "" msgid "Other events" @@ -272,7 +273,7 @@ msgstr "" msgid "" "Other events are not necessarily tied to a specific location in the program " -"and cannot be individually disabled." +"and cannot be individually disabled via :data:`DISABLE`." msgstr "" msgid "The other events that can be monitored are:" @@ -294,8 +295,8 @@ msgid "The STOP_ITERATION event" msgstr "" msgid "" -":pep:`PEP 380 <380#use-of-stopiteration-to-return-values>` specifies that a :" -"exc:`StopIteration` exception is raised when returning a value from a " +":pep:`PEP 380 <380#use-of-stopiteration-to-return-values>` specifies that " +"a :exc:`StopIteration` exception is raised when returning a value from a " "generator or coroutine. However, this is a very inefficient way to return a " "value, so some Python implementations, notably CPython 3.12+, do not raise " "an exception unless it would be visible to other code." @@ -329,8 +330,8 @@ msgid "Returns the ``int`` representing all the active events." msgstr "" msgid "" -"Activates all events which are set in *event_set*. Raises a :exc:" -"`ValueError` if *tool_id* is not in use." +"Activates all events which are set in *event_set*. Raises " +"a :exc:`ValueError` if *tool_id* is not in use." msgstr "" msgid "No events are active by default." @@ -346,12 +347,13 @@ msgid "" "(see :ref:`c-api-monitoring`)." msgstr "" -msgid "Returns all the local events for *code*" +msgid "Returns all the :ref:`local events ` for *code*" msgstr "" msgid "" -"Activates all the local events for *code* which are set in *event_set*. " -"Raises a :exc:`ValueError` if *tool_id* is not in use." +"Activates all the :ref:`local events ` for *code* " +"which are set in *event_set*. Raises a :exc:`ValueError` if *tool_id* is not " +"in use." msgstr "" msgid "" @@ -368,9 +370,10 @@ msgid "" msgstr "" msgid "" -"Local events can be disabled for a specific code location by returning :data:" -"`sys.monitoring.DISABLE` from a callback function. This does not change " -"which events are set, or any other code locations for the same event." +":ref:`Local events ` can be disabled for a specific " +"code location by returning :data:`sys.monitoring.DISABLE` from a callback " +"function. This does not change which events are set, or any other code " +"locations for the same event." msgstr "" msgid "" @@ -380,6 +383,13 @@ msgid "" "breakpoints." msgstr "" +msgid "" +"If :data:`DISABLE` is returned by a callback for a :ref:`global event " +"`, :exc:`ValueError` will be raised by the " +"interpreter in a non-specific location (that is, no traceback will be " +"provided)." +msgstr "" + msgid "" "Enable all the events that were disabled by :data:`sys.monitoring.DISABLE` " "for all tools." @@ -401,16 +411,16 @@ msgid "" msgstr "" msgid "" -"Functions can be unregistered by calling ``sys.monitoring." -"register_callback(tool_id, event, None)``." +"Raises an :ref:`auditing event ` " +"``sys.monitoring.register_callback`` with argument ``func``." msgstr "" -msgid "Callback functions can be registered and unregistered at any time." +msgid "" +"Functions can be unregistered by calling " +"``sys.monitoring.register_callback(tool_id, event, None)``." msgstr "" -msgid "" -"Registering or unregistering a callback function will generate a :func:`sys." -"audit` event." +msgid "Callback functions can be registered and unregistered at any time." msgstr "" msgid "Callback function arguments" @@ -442,8 +452,8 @@ msgid "" msgstr "" msgid "" -":monitoring-event:`CALL`, :monitoring-event:`C_RAISE` and :monitoring-event:" -"`C_RETURN`::" +":monitoring-event:`CALL`, :monitoring-event:`C_RAISE` and :monitoring-" +"event:`C_RETURN`::" msgstr "" msgid "" @@ -456,9 +466,9 @@ msgid "" msgstr "" msgid "" -":monitoring-event:`RAISE`, :monitoring-event:`RERAISE`, :monitoring-event:" -"`EXCEPTION_HANDLED`, :monitoring-event:`PY_UNWIND`, :monitoring-event:" -"`PY_THROW` and :monitoring-event:`STOP_ITERATION`::" +":monitoring-event:`RAISE`, :monitoring-event:`RERAISE`, :monitoring-" +"event:`EXCEPTION_HANDLED`, :monitoring-event:`PY_UNWIND`, :monitoring-" +"event:`PY_THROW` and :monitoring-event:`STOP_ITERATION`::" msgstr "" msgid "" diff --git a/library/sys.po b/library/sys.po index 0a76a7cf43..d458aaafd5 100644 --- a/library/sys.po +++ b/library/sys.po @@ -1,23 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# haaritsubaki, 2023 -# Wiktor Matuszewski , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-29 20:35+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,8 +67,8 @@ msgid "" "particular, malicious code can trivially disable or bypass hooks added using " "this function. At a minimum, any security-sensitive hooks must be added " "using the C API :c:func:`PySys_AddAuditHook` before initialising the " -"runtime, and any modules allowing arbitrary memory modification (such as :" -"mod:`ctypes`) should be completely removed or closely monitored." +"runtime, and any modules allowing arbitrary memory modification (such " +"as :mod:`ctypes`) should be completely removed or closely monitored." msgstr "" msgid "" @@ -146,8 +142,8 @@ msgid "" msgstr "" msgid "" -"Hooks are added using the :func:`sys.addaudithook` or :c:func:" -"`PySys_AddAuditHook` functions." +"Hooks are added using the :func:`sys.addaudithook` " +"or :c:func:`PySys_AddAuditHook` functions." msgstr "" msgid "" @@ -161,23 +157,25 @@ msgid "" msgstr "" msgid "" -"Set during Python startup, before ``site.py`` is run, to the same value as :" -"data:`exec_prefix`. If not running in a :ref:`virtual environment `, the values will stay the same; if ``site.py`` finds that a virtual " "environment is in use, the values of :data:`prefix` and :data:`exec_prefix` " -"will be changed to point to the virtual environment, whereas :data:" -"`base_prefix` and :data:`base_exec_prefix` will remain pointing to the base " -"Python installation (the one which the virtual environment was created from)." +"will be changed to point to the virtual environment, " +"whereas :data:`base_prefix` and :data:`base_exec_prefix` will remain " +"pointing to the base Python installation (the one which the virtual " +"environment was created from)." msgstr "" msgid "" -"Set during Python startup, before ``site.py`` is run, to the same value as :" -"data:`prefix`. If not running in a :ref:`virtual environment `, " -"the values will stay the same; if ``site.py`` finds that a virtual " +"Set during Python startup, before ``site.py`` is run, to the same value " +"as :data:`prefix`. If not running in a :ref:`virtual environment `, the values will stay the same; if ``site.py`` finds that a virtual " "environment is in use, the values of :data:`prefix` and :data:`exec_prefix` " -"will be changed to point to the virtual environment, whereas :data:" -"`base_prefix` and :data:`base_exec_prefix` will remain pointing to the base " -"Python installation (the one which the virtual environment was created from)." +"will be changed to point to the virtual environment, " +"whereas :data:`base_prefix` and :data:`base_exec_prefix` will remain " +"pointing to the base Python installation (the one which the virtual " +"environment was created from)." msgstr "" msgid "" @@ -202,9 +200,10 @@ msgid "" msgstr "" msgid "" -"Tracing is suspended while calling a tracing function set by :func:" -"`settrace` or :func:`setprofile` to avoid infinite recursion. :func:`!" -"call_tracing` enables explicit recursion of the tracing function." +"Tracing is suspended while calling a tracing function set " +"by :func:`settrace` or :func:`setprofile` to avoid infinite " +"recursion. :func:`!call_tracing` enables explicit recursion of the tracing " +"function." msgstr "" msgid "A string containing the copyright pertaining to the Python interpreter." @@ -284,27 +283,28 @@ msgid "" msgstr "" msgid "" -"The default implementation first consults the environment variable :envvar:" -"`PYTHONBREAKPOINT`. If that is set to ``\"0\"`` then this function returns " -"immediately; i.e. it is a no-op. If the environment variable is not set, or " -"is set to the empty string, ``pdb.set_trace()`` is called. Otherwise this " -"variable should name a function to run, using Python's dotted-import " -"nomenclature, e.g. ``package.subpackage.module.function``. In this case, " +"The default implementation first consults the environment " +"variable :envvar:`PYTHONBREAKPOINT`. If that is set to ``\"0\"`` then this " +"function returns immediately; i.e. it is a no-op. If the environment " +"variable is not set, or is set to the empty string, ``pdb.set_trace()`` is " +"called. Otherwise this variable should name a function to run, using " +"Python's dotted-import nomenclature, e.g. " +"``package.subpackage.module.function``. In this case, " "``package.subpackage.module`` would be imported and the resulting module " "must have a callable named ``function()``. This is run, passing in " -"``*args`` and ``**kws``, and whatever ``function()`` returns, ``sys." -"breakpointhook()`` returns to the built-in :func:`breakpoint` function." +"``*args`` and ``**kws``, and whatever ``function()`` returns, " +"``sys.breakpointhook()`` returns to the built-in :func:`breakpoint` function." msgstr "" msgid "" -"Note that if anything goes wrong while importing the callable named by :" -"envvar:`PYTHONBREAKPOINT`, a :exc:`RuntimeWarning` is reported and the " +"Note that if anything goes wrong while importing the callable named " +"by :envvar:`PYTHONBREAKPOINT`, a :exc:`RuntimeWarning` is reported and the " "breakpoint is ignored." msgstr "" msgid "" -"Also note that if ``sys.breakpointhook()`` is overridden programmatically, :" -"envvar:`PYTHONBREAKPOINT` is *not* consulted." +"Also note that if ``sys.breakpointhook()`` is overridden " +"programmatically, :envvar:`PYTHONBREAKPOINT` is *not* consulted." msgstr "" msgid "" @@ -327,18 +327,18 @@ msgid "Integer specifying the handle of the Python DLL." msgstr "" msgid "" -"If *value* is not ``None``, this function prints ``repr(value)`` to ``sys." -"stdout``, and saves *value* in ``builtins._``. If ``repr(value)`` is not " -"encodable to ``sys.stdout.encoding`` with ``sys.stdout.errors`` error " -"handler (which is probably ``'strict'``), encode it to ``sys.stdout." -"encoding`` with ``'backslashreplace'`` error handler." +"If *value* is not ``None``, this function prints ``repr(value)`` to " +"``sys.stdout``, and saves *value* in ``builtins._``. If ``repr(value)`` is " +"not encodable to ``sys.stdout.encoding`` with ``sys.stdout.errors`` error " +"handler (which is probably ``'strict'``), encode it to " +"``sys.stdout.encoding`` with ``'backslashreplace'`` error handler." msgstr "" msgid "" -"``sys.displayhook`` is called on the result of evaluating an :term:" -"`expression` entered in an interactive Python session. The display of these " -"values can be customized by assigning another one-argument function to ``sys." -"displayhook``." +"``sys.displayhook`` is called on the result of evaluating " +"an :term:`expression` entered in an interactive Python session. The display " +"of these values can be customized by assigning another one-argument function " +"to ``sys.displayhook``." msgstr "" msgid "Pseudo-code::" @@ -370,9 +370,9 @@ msgstr "" msgid "" "If this is true, Python won't try to write ``.pyc`` files on the import of " "source modules. This value is initially set to ``True`` or ``False`` " -"depending on the :option:`-B` command line option and the :envvar:" -"`PYTHONDONTWRITEBYTECODE` environment variable, but you can set it yourself " -"to control bytecode file generation." +"depending on the :option:`-B` command line option and " +"the :envvar:`PYTHONDONTWRITEBYTECODE` environment variable, but you can set " +"it yourself to control bytecode file generation." msgstr "" msgid "" @@ -413,9 +413,9 @@ msgstr "" msgid "" "This value is initially set based on the value of the :option:`-X` " -"``pycache_prefix=PATH`` command-line option or the :envvar:" -"`PYTHONPYCACHEPREFIX` environment variable (command-line takes precedence). " -"If neither are set, it is ``None``." +"``pycache_prefix=PATH`` command-line option or " +"the :envvar:`PYTHONPYCACHEPREFIX` environment variable (command-line takes " +"precedence). If neither are set, it is ``None``." msgstr "" msgid "" @@ -437,14 +437,14 @@ msgid "" "``type``, ``value``, ``traceback`` when an uncaught exception occurs. If no " "hook has been set, ``hook`` may be ``None``. If any hook raises an exception " "derived from :class:`RuntimeError` the call to the hook will be suppressed. " -"Otherwise, the audit hook exception will be reported as unraisable and ``sys." -"excepthook`` will be called." +"Otherwise, the audit hook exception will be reported as unraisable and " +"``sys.excepthook`` will be called." msgstr "" msgid "" "The :func:`sys.unraisablehook` function handles unraisable exceptions and " -"the :func:`threading.excepthook` function handles exception raised by :func:" -"`threading.Thread.run`." +"the :func:`threading.excepthook` function handles exception raised " +"by :func:`threading.Thread.run`." msgstr "" msgid "" @@ -474,11 +474,11 @@ msgstr "" msgid "" "This function returns the old-style representation of the handled exception. " "If an exception ``e`` is currently handled (so :func:`exception` would " -"return ``e``), :func:`exc_info` returns the tuple ``(type(e), e, e." -"__traceback__)``. That is, a tuple containing the type of the exception (a " -"subclass of :exc:`BaseException`), the exception itself, and a :ref:" -"`traceback object ` which typically encapsulates the call " -"stack at the point where the exception last occurred." +"return ``e``), :func:`exc_info` returns the tuple ``(type(e), e, " +"e.__traceback__)``. That is, a tuple containing the type of the exception (a " +"subclass of :exc:`BaseException`), the exception itself, and " +"a :ref:`traceback object ` which typically encapsulates " +"the call stack at the point where the exception last occurred." msgstr "" msgid "" @@ -489,8 +489,8 @@ msgstr "" msgid "" "The ``type`` and ``traceback`` fields are now derived from the ``value`` " "(the exception instance), so when an exception is modified while it is being " -"handled, the changes are reflected in the results of subsequent calls to :" -"func:`exc_info`." +"handled, the changes are reflected in the results of subsequent calls " +"to :func:`exc_info`." msgstr "" msgid "" @@ -498,17 +498,17 @@ msgid "" "dependent Python files are installed; by default, this is also ``'/usr/" "local'``. This can be set at build time with the ``--exec-prefix`` argument " "to the :program:`configure` script. Specifically, all configuration files " -"(e.g. the :file:`pyconfig.h` header file) are installed in the directory :" -"file:`{exec_prefix}/lib/python{X.Y}/config`, and shared library modules are " -"installed in :file:`{exec_prefix}/lib/python{X.Y}/lib-dynload`, where *X.Y* " -"is the version number of Python, for example ``3.2``." +"(e.g. the :file:`pyconfig.h` header file) are installed in the " +"directory :file:`{exec_prefix}/lib/python{X.Y}/config`, and shared library " +"modules are installed in :file:`{exec_prefix}/lib/python{X.Y}/lib-dynload`, " +"where *X.Y* is the version number of Python, for example ``3.2``." msgstr "" msgid "" "If a :ref:`virtual environment ` is in effect, this value will be " "changed in ``site.py`` to point to the virtual environment. The value for " -"the Python installation will still be available, via :data:" -"`base_exec_prefix`." +"the Python installation will still be available, " +"via :data:`base_exec_prefix`." msgstr "" msgid "" @@ -531,7 +531,7 @@ msgid "" "be in the range 0--127, and produce undefined results otherwise. Some " "systems have a convention for assigning specific meanings to specific exit " "codes, but these are generally underdeveloped; Unix programs generally use 2 " -"for command line syntax errors and 1 for all other kind of errors. If " +"for command line syntax errors and 1 for all other kinds of errors. If " "another type of object is passed, ``None`` is equivalent to passing zero, " "and any other object is printed to :data:`stderr` and results in an exit " "code of 1. In particular, ``sys.exit(\"some error message\")`` is a quick " @@ -547,9 +547,9 @@ msgid "" msgstr "" msgid "" -"If an error occurs in the cleanup after the Python interpreter has caught :" -"exc:`SystemExit` (such as an error flushing buffered data in the standard " -"streams), the exit status is changed to 120." +"If an error occurs in the cleanup after the Python interpreter has " +"caught :exc:`SystemExit` (such as an error flushing buffered data in the " +"standard streams), the exit status is changed to 120." msgstr "" msgid "" @@ -770,8 +770,8 @@ msgstr "" msgid "" "The attribute :attr:`sys.float_info.dig` needs further explanation. If " -"``s`` is any string representing a decimal number with at most :attr:`!sys." -"float_info.dig` significant digits, then converting ``s`` to a float and " +"``s`` is any string representing a decimal number with at most :attr:`!" +"sys.float_info.dig` significant digits, then converting ``s`` to a float and " "back again will recover a string representing the same decimal value::" msgstr "" @@ -808,9 +808,9 @@ msgid "" "Return the number of memory blocks currently allocated by the interpreter, " "regardless of their size. This function is mainly useful for tracking and " "debugging memory leaks. Because of the interpreter's internal caches, the " -"result can vary from call to call; you may have to call :func:" -"`_clear_internal_caches` and :func:`gc.collect` to get more predictable " -"results." +"result can vary from call to call; you may have to " +"call :func:`_clear_internal_caches` and :func:`gc.collect` to get more " +"predictable results." msgstr "" msgid "" @@ -842,8 +842,8 @@ msgid "" "Get the :term:`filesystem encoding `: " "the encoding used with the :term:`filesystem error handler ` to convert between Unicode filenames and bytes " -"filenames. The filesystem error handler is returned from :func:" -"`getfilesystemencodeerrors`." +"filenames. The filesystem error handler is returned " +"from :func:`getfilesystemencodeerrors`." msgstr "" msgid "" @@ -860,17 +860,17 @@ msgstr "" msgid "" "The :term:`filesystem encoding and error handler` are configured at Python " -"startup by the :c:func:`PyConfig_Read` function: see :c:member:`~PyConfig." -"filesystem_encoding` and :c:member:`~PyConfig.filesystem_errors` members of :" -"c:type:`PyConfig`." +"startup by the :c:func:`PyConfig_Read` function: " +"see :c:member:`~PyConfig.filesystem_encoding` " +"and :c:member:`~PyConfig.filesystem_errors` members of :c:type:`PyConfig`." msgstr "" msgid ":func:`getfilesystemencoding` result cannot be ``None`` anymore." msgstr "" msgid "" -"Windows is no longer guaranteed to return ``'mbcs'``. See :pep:`529` and :" -"func:`_enablelegacywindowsfsencoding` for more information." +"Windows is no longer guaranteed to return ``'mbcs'``. See :pep:`529` " +"and :func:`_enablelegacywindowsfsencoding` for more information." msgstr "" msgid "" @@ -881,8 +881,8 @@ msgid "" "Get the :term:`filesystem error handler `: the error handler used with the :term:`filesystem encoding " "` to convert between Unicode " -"filenames and bytes filenames. The filesystem encoding is returned from :" -"func:`getfilesystemencoding`." +"filenames and bytes filenames. The filesystem encoding is returned " +"from :func:`getfilesystemencoding`." msgstr "" msgid "" @@ -898,10 +898,10 @@ msgstr "" msgid "" "Note that the returned value may not actually reflect how many references to " -"the object are actually held. For example, some objects are :term:" -"`immortal` and have a very high refcount that does not reflect the actual " -"number of references. Consequently, do not rely on the returned value to be " -"accurate, other than a value of 0 or 1." +"the object are actually held. For example, some objects " +"are :term:`immortal` and have a very high refcount that does not reflect the " +"actual number of references. Consequently, do not rely on the returned " +"value to be accurate, other than a value of 0 or 1." msgstr "" msgid "" @@ -912,8 +912,8 @@ msgstr "" msgid "" "Return the current value of the recursion limit, the maximum depth of the " "Python interpreter stack. This limit prevents infinite recursion from " -"causing an overflow of the C stack and crashing Python. It can be set by :" -"func:`setrecursionlimit`." +"causing an overflow of the C stack and crashing Python. It can be set " +"by :func:`setrecursionlimit`." msgstr "" msgid "" @@ -946,8 +946,8 @@ msgid "" msgstr "" msgid "" -"Return the interpreter's \"thread switch interval\" in seconds; see :func:" -"`setswitchinterval`." +"Return the interpreter's \"thread switch interval\" in seconds; " +"see :func:`setswitchinterval`." msgstr "" msgid "" @@ -995,10 +995,11 @@ msgstr "" msgid "" "Objects from the list are not safe to use. Specifically, the result will " "include objects from all interpreters that share their object allocator " -"state (that is, ones created with :c:member:`PyInterpreterConfig." -"use_main_obmalloc` set to 1 or using :c:func:`Py_NewInterpreter`, and the :" -"ref:`main interpreter `). Mixing objects from " -"different interpreters may lead to crashes or other unexpected behavior." +"state (that is, ones created " +"with :c:member:`PyInterpreterConfig.use_main_obmalloc` set to 1 or " +"using :c:func:`Py_NewInterpreter`, and the :ref:`main interpreter `). Mixing objects from different interpreters may lead " +"to crashes or other unexpected behavior." msgstr "" msgid "" @@ -1028,9 +1029,9 @@ msgid "" "*service_pack_minor*, *service_pack_major*, *suite_mask*, *product_type* and " "*platform_version*. *service_pack* contains a string, *platform_version* a 3-" "tuple and all other values are integers. The components can also be accessed " -"by name, so ``sys.getwindowsversion()[0]`` is equivalent to ``sys." -"getwindowsversion().major``. For compatibility with prior versions, only the " -"first 5 elements are retrievable by indexing." +"by name, so ``sys.getwindowsversion()[0]`` is equivalent to " +"``sys.getwindowsversion().major``. For compatibility with prior versions, " +"only the first 5 elements are retrievable by indexing." msgstr "" msgid "*platform* will be ``2`` (VER_PLATFORM_WIN32_NT)." @@ -1046,19 +1047,19 @@ msgid "Meaning" msgstr "Znaczenie" msgid "``1`` (VER_NT_WORKSTATION)" -msgstr "" +msgstr "``1`` (VER_NT_WORKSTATION)" msgid "The system is a workstation." msgstr "" msgid "``2`` (VER_NT_DOMAIN_CONTROLLER)" -msgstr "" +msgstr "``2`` (VER_NT_DOMAIN_CONTROLLER)" msgid "The system is a domain controller." msgstr "" msgid "``3`` (VER_NT_SERVER)" -msgstr "" +msgstr "``3`` (VER_NT_SERVER)" msgid "The system is a server, but not a domain controller." msgstr "" @@ -1091,12 +1092,12 @@ msgid "Added *platform_version*" msgstr "" msgid "" -"Returns an *asyncgen_hooks* object, which is similar to a :class:" -"`~collections.namedtuple` of the form ``(firstiter, finalizer)``, where " -"*firstiter* and *finalizer* are expected to be either ``None`` or functions " -"which take an :term:`asynchronous generator iterator` as an argument, and " -"are used to schedule finalization of an asynchronous generator by an event " -"loop." +"Returns an *asyncgen_hooks* object, which is similar to " +"a :class:`~collections.namedtuple` of the form ``(firstiter, finalizer)``, " +"where *firstiter* and *finalizer* are expected to be either ``None`` or " +"functions which take an :term:`asynchronous generator iterator` as an " +"argument, and are used to schedule finalization of an asynchronous generator " +"by an event loop." msgstr "" msgid "See :pep:`525` for more details." @@ -1108,8 +1109,8 @@ msgid "" msgstr "" msgid "" -"Get the current coroutine origin tracking depth, as set by :func:" -"`set_coroutine_origin_tracking_depth`." +"Get the current coroutine origin tracking depth, as set " +"by :func:`set_coroutine_origin_tracking_depth`." msgstr "" msgid "" @@ -1146,7 +1147,10 @@ msgstr "" msgid "The size of the seed key of the hash algorithm" msgstr "" -msgid "Added *algorithm*, *hash_bits* and *seed_bits*" +msgid "Cutoff for small string DJBX33A optimization in range ``[1, cutoff)``." +msgstr "" + +msgid "Added *algorithm*, *hash_bits*, *seed_bits*, and *cutoff*." msgstr "" msgid "" @@ -1199,8 +1203,8 @@ msgid "" msgstr "" msgid "" -"*hexversion* is the implementation version in hexadecimal format, like :data:" -"`sys.hexversion`." +"*hexversion* is the implementation version in hexadecimal format, " +"like :data:`sys.hexversion`." msgstr "" msgid "" @@ -1214,10 +1218,10 @@ msgstr "" msgid "" ":data:`sys.implementation` may contain additional attributes specific to the " "Python implementation. These non-standard attributes must start with an " -"underscore, and are not described here. Regardless of its contents, :data:" -"`sys.implementation` will not change during a run of the interpreter, nor " -"between implementation versions. (It may change between Python language " -"versions, however.) See :pep:`421` for more information." +"underscore, and are not described here. Regardless of its " +"contents, :data:`sys.implementation` will not change during a run of the " +"interpreter, nor between implementation versions. (It may change between " +"Python language versions, however.) See :pep:`421` for more information." msgstr "" msgid "" @@ -1244,13 +1248,14 @@ msgid "" msgstr "" msgid "" -"The minimum non-zero value for :func:`sys.set_int_max_str_digits`, :envvar:" -"`PYTHONINTMAXSTRDIGITS`, or :option:`-X int_max_str_digits <-X>`." +"The minimum non-zero value " +"for :func:`sys.set_int_max_str_digits`, :envvar:`PYTHONINTMAXSTRDIGITS`, " +"or :option:`-X int_max_str_digits <-X>`." msgstr "" msgid "" -"Added :attr:`~int_info.default_max_str_digits` and :attr:`~int_info." -"str_digits_check_threshold`." +"Added :attr:`~int_info.default_max_str_digits` " +"and :attr:`~int_info.str_digits_check_threshold`." msgstr "" msgid "" @@ -1315,8 +1320,8 @@ msgstr "" msgid "" "These three variables are deprecated; use :data:`sys.last_exc` instead. They " -"hold the legacy representation of ``sys.last_exc``, as returned from :func:" -"`exc_info` above." +"hold the legacy representation of ``sys.last_exc``, as returned " +"from :func:`exc_info` above." msgstr "" msgid "" @@ -1337,23 +1342,24 @@ msgid "" msgstr "" msgid "" -"A list of :term:`meta path finder` objects that have their :meth:`~importlib." -"abc.MetaPathFinder.find_spec` methods called to see if one of the objects " -"can find the module to be imported. By default, it holds entries that " -"implement Python's default import semantics. The :meth:`~importlib.abc." -"MetaPathFinder.find_spec` method is called with at least the absolute name " -"of the module being imported. If the module to be imported is contained in a " -"package, then the parent package's :attr:`~module.__path__` attribute is " -"passed in as a second argument. The method returns a :term:`module spec`, or " -"``None`` if the module cannot be found." +"A list of :term:`meta path finder` objects that have " +"their :meth:`~importlib.abc.MetaPathFinder.find_spec` methods called to see " +"if one of the objects can find the module to be imported. By default, it " +"holds entries that implement Python's default import semantics. " +"The :meth:`~importlib.abc.MetaPathFinder.find_spec` method is called with at " +"least the absolute name of the module being imported. If the module to be " +"imported is contained in a package, then the parent " +"package's :attr:`~module.__path__` attribute is passed in as a second " +"argument. The method returns a :term:`module spec`, or ``None`` if the " +"module cannot be found." msgstr "" msgid ":class:`importlib.abc.MetaPathFinder`" msgstr ":class:`importlib.abc.MetaPathFinder`" msgid "" -"The abstract base class defining the interface of finder objects on :data:" -"`meta_path`." +"The abstract base class defining the interface of finder objects " +"on :data:`meta_path`." msgstr "" msgid ":class:`importlib.machinery.ModuleSpec`" @@ -1365,14 +1371,14 @@ msgid "" msgstr "" msgid "" -":term:`Module specs ` were introduced in Python 3.4, by :pep:" -"`451`." +":term:`Module specs ` were introduced in Python 3.4, " +"by :pep:`451`." msgstr "" msgid "" -"Removed the fallback that looked for a :meth:`!find_module` method if a :" -"data:`meta_path` entry didn't have a :meth:`~importlib.abc.MetaPathFinder." -"find_spec` method." +"Removed the fallback that looked for a :meth:`!find_module` method if " +"a :data:`meta_path` entry didn't have " +"a :meth:`~importlib.abc.MetaPathFinder.find_spec` method." msgstr "" msgid "" @@ -1436,14 +1442,14 @@ msgid "" msgstr "" msgid "" -"Module :mod:`site` This describes how to use .pth files to extend :data:`sys." -"path`." +"Module :mod:`site` This describes how to use .pth files to " +"extend :data:`sys.path`." msgstr "" msgid "" -"A list of callables that take a path argument to try to create a :term:" -"`finder` for the path. If a finder can be created, it is to be returned by " -"the callable, else raise :exc:`ImportError`." +"A list of callables that take a path argument to try to create " +"a :term:`finder` for the path. If a finder can be created, it is to be " +"returned by the callable, else raise :exc:`ImportError`." msgstr "" msgid "Originally specified in :pep:`302`." @@ -1481,7 +1487,7 @@ msgid "Emscripten" msgstr "" msgid "``'emscripten'``" -msgstr "" +msgstr "``'emscripten'``" msgid "iOS" msgstr "" @@ -1496,7 +1502,7 @@ msgid "``'linux'``" msgstr "``'linux'``" msgid "macOS" -msgstr "" +msgstr "macOS" msgid "``'darwin'``" msgstr "" @@ -1511,7 +1517,7 @@ msgid "Windows/Cygwin" msgstr "" msgid "``'cygwin'``" -msgstr "" +msgstr "``'cygwin'``" msgid "WASI" msgstr "" @@ -1564,8 +1570,8 @@ msgstr "" msgid "" "It is equal to ``\"lib\"`` on most platforms. On Fedora and SuSE, it is " -"equal to ``\"lib64\"`` on 64-bit platforms which gives the following ``sys." -"path`` paths (where ``X.Y`` is the Python ``major.minor`` version):" +"equal to ``\"lib64\"`` on 64-bit platforms which gives the following " +"``sys.path`` paths (where ``X.Y`` is the Python ``major.minor`` version):" msgstr "" msgid "" @@ -1580,8 +1586,8 @@ msgid "" msgstr "" msgid "" -"``/usr/lib/pythonX.Y/site-packages/`` (always use ``lib``, not :data:`sys." -"platlibdir`): Third-party modules" +"``/usr/lib/pythonX.Y/site-packages/`` (always use ``lib``, " +"not :data:`sys.platlibdir`): Third-party modules" msgstr "" msgid "" @@ -1618,14 +1624,14 @@ msgid "" "enable a lazy resolving of symbols when importing a module, if called as " "``sys.setdlopenflags(0)``. To share symbols across extension modules, call " "as ``sys.setdlopenflags(os.RTLD_GLOBAL)``. Symbolic names for the flag " -"values can be found in the :mod:`os` module (:samp:`RTLD_{xxx}` constants, e." -"g. :const:`os.RTLD_LAZY`)." +"values can be found in the :mod:`os` module (:samp:`RTLD_{xxx}` constants, " +"e.g. :const:`os.RTLD_LAZY`)." msgstr "" msgid "" "Set the :ref:`integer string conversion length limitation " -"` used by this interpreter. See also :func:" -"`get_int_max_str_digits`." +"` used by this interpreter. See " +"also :func:`get_int_max_str_digits`." msgstr "" msgid "" @@ -1643,9 +1649,9 @@ msgid "" msgstr "" msgid "" -"The same tracing mechanism is used for :func:`!setprofile` as :func:" -"`settrace`. To trace calls with :func:`!setprofile` inside a tracing " -"function (e.g. in a debugger breakpoint), see :func:`call_tracing`." +"The same tracing mechanism is used for :func:`!setprofile` " +"as :func:`settrace`. To trace calls with :func:`!setprofile` inside a " +"tracing function (e.g. in a debugger breakpoint), see :func:`call_tracing`." msgstr "" msgid "" @@ -1714,8 +1720,8 @@ msgid "" msgstr "" msgid "" -"If the new limit is too low at the current recursion depth, a :exc:" -"`RecursionError` exception is raised." +"If the new limit is too low at the current recursion depth, " +"a :exc:`RecursionError` exception is raised." msgstr "" msgid "" @@ -1737,15 +1743,15 @@ msgid "" "Set the system's trace function, which allows you to implement a Python " "source code debugger in Python. The function is thread-specific; for a " "debugger to support multiple threads, it must register a trace function " -"using :func:`settrace` for each thread being debugged or use :func:" -"`threading.settrace`." +"using :func:`settrace` for each thread being debugged or " +"use :func:`threading.settrace`." msgstr "" msgid "" "Trace functions should have three arguments: *frame*, *event*, and *arg*. " -"*frame* is the current stack frame. *event* is a string: ``'call'``, " -"``'line'``, ``'return'``, ``'exception'`` or ``'opcode'``. *arg* depends on " -"the event type." +"*frame* is the :ref:`current stack frame `. *event* is a " +"string: ``'call'``, ``'line'``, ``'return'``, ``'exception'`` or " +"``'opcode'``. *arg* depends on the event type." msgstr "" msgid "" @@ -1811,9 +1817,9 @@ msgid "" "The interpreter is about to execute a new opcode (see :mod:`dis` for opcode " "details). The local trace function is called; *arg* is ``None``; the return " "value specifies the new local trace function. Per-opcode events are not " -"emitted by default: they must be explicitly requested by setting :attr:" -"`~frame.f_trace_opcodes` to :const:`True` on the :ref:`frame `." +"emitted by default: they must be explicitly requested by " +"setting :attr:`~frame.f_trace_opcodes` to :const:`True` on the :ref:`frame " +"`." msgstr "" msgid "" @@ -1827,11 +1833,11 @@ msgid "" "it being set indirectly via the return value from an already installed trace " "function. This is also required for activating the trace function on the " "current frame, which :func:`settrace` doesn't do. Note that in order for " -"this to work, a global tracing function must have been installed with :func:" -"`settrace` in order to enable the runtime tracing machinery, but it doesn't " -"need to be the same tracing function (e.g. it could be a low overhead " -"tracing function that simply returns ``None`` to disable itself immediately " -"on each frame)." +"this to work, a global tracing function must have been installed " +"with :func:`settrace` in order to enable the runtime tracing machinery, but " +"it doesn't need to be the same tracing function (e.g. it could be a low " +"overhead tracing function that simply returns ``None`` to disable itself " +"immediately on each frame)." msgstr "" msgid "For more information on code and frame objects, refer to :ref:`types`." @@ -1850,26 +1856,26 @@ msgid "" msgstr "" msgid "" -"``'opcode'`` event type added; :attr:`~frame.f_trace_lines` and :attr:" -"`~frame.f_trace_opcodes` attributes added to frames" +"``'opcode'`` event type added; :attr:`~frame.f_trace_lines` " +"and :attr:`~frame.f_trace_opcodes` attributes added to frames" msgstr "" msgid "" -"Accepts two optional keyword arguments which are callables that accept an :" -"term:`asynchronous generator iterator` as an argument. The *firstiter* " +"Accepts two optional keyword arguments which are callables that accept " +"an :term:`asynchronous generator iterator` as an argument. The *firstiter* " "callable will be called when an asynchronous generator is iterated for the " "first time. The *finalizer* will be called when an asynchronous generator is " "about to be garbage collected." msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``sys." -"set_asyncgen_hooks_firstiter`` with no arguments." +"Raises an :ref:`auditing event ` " +"``sys.set_asyncgen_hooks_firstiter`` with no arguments." msgstr "" msgid "" -"Raises an :ref:`auditing event ` ``sys." -"set_asyncgen_hooks_finalizer`` with no arguments." +"Raises an :ref:`auditing event ` " +"``sys.set_asyncgen_hooks_finalizer`` with no arguments." msgstr "" msgid "" @@ -1879,8 +1885,8 @@ msgstr "" msgid "" "See :pep:`525` for more details, and for a reference example of a " -"*finalizer* method see the implementation of ``asyncio.Loop." -"shutdown_asyncgens`` in :source:`Lib/asyncio/base_events.py`" +"*finalizer* method see the implementation of " +"``asyncio.Loop.shutdown_asyncgens`` in :source:`Lib/asyncio/base_events.py`" msgstr "" msgid "" @@ -1931,8 +1937,8 @@ msgid "" msgstr "" msgid "" -"See also :func:`sys.getfilesystemencoding` and :func:`sys." -"getfilesystemencodeerrors`." +"See also :func:`sys.getfilesystemencoding` " +"and :func:`sys.getfilesystemencodeerrors`." msgstr "" msgid "" @@ -1953,8 +1959,8 @@ msgid "" msgstr "" msgid "" -"``stdin`` is used for all interactive input (including calls to :func:" -"`input`);" +"``stdin`` is used for all interactive input (including calls " +"to :func:`input`);" msgstr "" msgid "" @@ -1971,8 +1977,9 @@ msgid "" msgstr "" msgid "" -"The encoding and error handling are is initialized from :c:member:`PyConfig." -"stdio_encoding` and :c:member:`PyConfig.stdio_errors`." +"The encoding and error handling are initialized " +"from :c:member:`PyConfig.stdio_encoding` " +"and :c:member:`PyConfig.stdio_errors`." msgstr "" msgid "" @@ -1992,19 +1999,20 @@ msgid "" msgstr "" msgid "" -"Under all platforms, you can override the character encoding by setting the :" -"envvar:`PYTHONIOENCODING` environment variable before starting Python or by " -"using the new :option:`-X` ``utf8`` command line option and :envvar:" -"`PYTHONUTF8` environment variable. However, for the Windows console, this " -"only applies when :envvar:`PYTHONLEGACYWINDOWSSTDIO` is also set." +"Under all platforms, you can override the character encoding by setting " +"the :envvar:`PYTHONIOENCODING` environment variable before starting Python " +"or by using the new :option:`-X` ``utf8`` command line option " +"and :envvar:`PYTHONUTF8` environment variable. However, for the Windows " +"console, this only applies when :envvar:`PYTHONLEGACYWINDOWSSTDIO` is also " +"set." msgstr "" msgid "" "When interactive, the ``stdout`` stream is line-buffered. Otherwise, it is " "block-buffered like regular text files. The ``stderr`` stream is line-" "buffered in both cases. You can make both streams unbuffered by passing " -"the :option:`-u` command-line option or setting the :envvar:" -"`PYTHONUNBUFFERED` environment variable." +"the :option:`-u` command-line option or setting " +"the :envvar:`PYTHONUNBUFFERED` environment variable." msgstr "" msgid "" @@ -2141,8 +2149,8 @@ msgstr "" msgid "" "The default hook formats :attr:`!err_msg` and :attr:`!object` as: " -"``f'{err_msg}: {object!r}'``; use \"Exception ignored in\" error message if :" -"attr:`!err_msg` is ``None``." +"``f'{err_msg}: {object!r}'``; use \"Exception ignored in\" error message " +"if :attr:`!err_msg` is ``None``." msgstr "" msgid "" @@ -2191,8 +2199,8 @@ msgid "" "*releaselevel* are integers; the release level is ``'alpha'``, ``'beta'``, " "``'candidate'``, or ``'final'``. The ``version_info`` value corresponding " "to the Python version 2.0 is ``(2, 0, 0, 'final', 0)``. The components can " -"also be accessed by name, so ``sys.version_info[0]`` is equivalent to ``sys." -"version_info.major`` and so on." +"also be accessed by name, so ``sys.version_info[0]`` is equivalent to " +"``sys.version_info.major`` and so on." msgstr "" msgid "Added named component attributes." diff --git a/library/sys_path_init.po b/library/sys_path_init.po index 1bbe5066e2..8153503d10 100644 --- a/library/sys_path_init.po +++ b/library/sys_path_init.po @@ -34,8 +34,8 @@ msgstr "" msgid "" "The first entry in the module search path is the directory that contains the " "input script, if there is one. Otherwise, the first entry is the current " -"directory, which is the case when executing the interactive shell, a :option:" -"`-c` command, or :option:`-m` module." +"directory, which is the case when executing the interactive shell, " +"a :option:`-c` command, or :option:`-m` module." msgstr "" msgid "" @@ -71,24 +71,24 @@ msgstr "" msgid "" "Once ``home`` is determined, the ``prefix`` directory is found by first " -"looking for :file:`python{majorversion}{minorversion}.zip` (``python311." -"zip``). On Windows the zip archive is searched for in ``home`` and on Unix " -"the archive is expected to be in :file:`lib`. Note that the expected zip " -"archive location is added to the module search path even if the archive does " -"not exist. If no archive was found, Python on Windows will continue the " -"search for ``prefix`` by looking for :file:`Lib\\\\os.py`. Python on Unix " -"will look for :file:`lib/python{majorversion}.{minorversion}/os.py` (``lib/" -"python3.11/os.py``). On Windows ``prefix`` and ``exec_prefix`` are the same, " -"however on other platforms :file:`lib/python{majorversion}.{minorversion}/" -"lib-dynload` (``lib/python3.11/lib-dynload``) is searched for and used as an " -"anchor for ``exec_prefix``. On some platforms :file:`lib` may be :file:" -"`lib64` or another value, see :data:`sys.platlibdir` and :envvar:" -"`PYTHONPLATLIBDIR`." +"looking for :file:`python{majorversion}{minorversion}.zip` " +"(``python311.zip``). On Windows the zip archive is searched for in ``home`` " +"and on Unix the archive is expected to be in :file:`lib`. Note that the " +"expected zip archive location is added to the module search path even if the " +"archive does not exist. If no archive was found, Python on Windows will " +"continue the search for ``prefix`` by looking for :file:`Lib\\\\os.py`. " +"Python on Unix will look for :file:`lib/python{majorversion}.{minorversion}/" +"os.py` (``lib/python3.11/os.py``). On Windows ``prefix`` and ``exec_prefix`` " +"are the same, however on other platforms :file:`lib/python{majorversion}." +"{minorversion}/lib-dynload` (``lib/python3.11/lib-dynload``) is searched for " +"and used as an anchor for ``exec_prefix``. On some platforms :file:`lib` may " +"be :file:`lib64` or another value, see :data:`sys.platlibdir` " +"and :envvar:`PYTHONPLATLIBDIR`." msgstr "" msgid "" -"Once found, ``prefix`` and ``exec_prefix`` are available at :data:`sys." -"prefix` and :data:`sys.exec_prefix` respectively." +"Once found, ``prefix`` and ``exec_prefix`` are available " +"at :data:`sys.prefix` and :data:`sys.exec_prefix` respectively." msgstr "" msgid "" @@ -99,8 +99,9 @@ msgid "" msgstr "" msgid "" -"Certain command line options may further affect path calculations. See :" -"option:`-E`, :option:`-I`, :option:`-s` and :option:`-S` for further details." +"Certain command line options may further affect path calculations. " +"See :option:`-E`, :option:`-I`, :option:`-s` and :option:`-S` for further " +"details." msgstr "" msgid "Virtual environments" @@ -153,11 +154,12 @@ msgid "Embedded Python" msgstr "" msgid "" -"If Python is embedded within another application :c:func:" -"`Py_InitializeFromConfig` and the :c:type:`PyConfig` structure can be used " -"to initialize Python. The path specific details are described at :ref:`init-" -"path-config`. Alternatively the older :c:func:`Py_SetPath` can be used to " -"bypass the initialization of the module search path." +"If Python is embedded within another " +"application :c:func:`Py_InitializeFromConfig` and the :c:type:`PyConfig` " +"structure can be used to initialize Python. The path specific details are " +"described at :ref:`init-path-config`. Alternatively the " +"older :c:func:`Py_SetPath` can be used to bypass the initialization of the " +"module search path." msgstr "" msgid ":ref:`windows_finding_modules` for detailed Windows notes." diff --git a/library/sysconfig.po b/library/sysconfig.po index ffc4b5137c..d49203a922 100644 --- a/library/sysconfig.po +++ b/library/sysconfig.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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 +28,7 @@ msgid "" msgstr "" msgid "**Source code:** :source:`Lib/sysconfig`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/sysconfig`" msgid "" "The :mod:`sysconfig` module provides access to Python's configuration " @@ -92,10 +92,10 @@ msgstr "" msgid "" "Python uses an installation scheme that differs depending on the platform " -"and on the installation options. These schemes are stored in :mod:" -"`sysconfig` under unique identifiers based on the value returned by :const:" -"`os.name`. The schemes are used by package installers to determine where to " -"copy files to." +"and on the installation options. These schemes are stored " +"in :mod:`sysconfig` under unique identifiers based on the value returned " +"by :const:`os.name`. The schemes are used by package installers to determine " +"where to copy files to." msgstr "" msgid "Python currently supports nine schemes:" @@ -113,8 +113,8 @@ msgstr "" msgid "" "*posix_user*: scheme for POSIX platforms, when the *user* option is used. " -"This scheme defines paths located under the user's home directory (:const:" -"`site.USER_BASE`)." +"This scheme defines paths located under the user's home directory " +"(:const:`site.USER_BASE`)." msgstr "" msgid "" @@ -194,8 +194,8 @@ msgstr "" msgid "" "Files will be installed into subdirectories of :const:`site.USER_BASE` " "(written as :file:`{userbase}` hereafter). This scheme installs pure Python " -"modules and extension modules in the same location (also known as :const:" -"`site.USER_SITE`)." +"modules and extension modules in the same location (also known " +"as :const:`site.USER_SITE`)." msgstr "" msgid "``posix_user``" @@ -274,8 +274,8 @@ msgid "" "The idea behind the \"home scheme\" is that you build and maintain a " "personal stash of Python modules. This scheme's name is derived from the " "idea of a \"home\" directory on Unix, since it's not unusual for a Unix user " -"to make their home directory have a layout similar to :file:`/usr/` or :file:" -"`/usr/local/`. This scheme can be used by anyone, regardless of the " +"to make their home directory have a layout similar to :file:`/usr/` " +"or :file:`/usr/local/`. This scheme can be used by anyone, regardless of the " "operating system they are installing for." msgstr "" @@ -370,8 +370,8 @@ msgid "" msgstr "" msgid "" -"Return a tuple containing all schemes currently supported in :mod:" -"`sysconfig`." +"Return a tuple containing all schemes currently supported " +"in :mod:`sysconfig`." msgstr "" msgid "Return the default scheme name for the current platform." @@ -414,13 +414,13 @@ msgid "" msgstr "" msgid "" -"End users should not use this function, but :func:`get_default_scheme` and :" -"func:`get_preferred_scheme` instead." +"End users should not use this function, but :func:`get_default_scheme` " +"and :func:`get_preferred_scheme` instead." msgstr "" msgid "" -"Return a tuple containing all path names currently supported in :mod:" -"`sysconfig`." +"Return a tuple containing all path names currently supported " +"in :mod:`sysconfig`." msgstr "" msgid "" @@ -445,9 +445,9 @@ msgid "" msgstr "" msgid "" -"If *scheme* is provided, it must be a value from the list returned by :func:" -"`get_scheme_names`. Otherwise, the default scheme for the current platform " -"is used." +"If *scheme* is provided, it must be a value from the list returned " +"by :func:`get_scheme_names`. Otherwise, the default scheme for the current " +"platform is used." msgstr "" msgid "" @@ -482,8 +482,8 @@ msgid "If *expand* is set to false, the paths will not be expanded." msgstr "" msgid "" -"If *scheme* is not an existing scheme, :func:`get_paths` will raise a :exc:" -"`KeyError`." +"If *scheme* is not an existing scheme, :func:`get_paths` will raise " +"a :exc:`KeyError`." msgstr "" msgid "Other functions" @@ -508,16 +508,7 @@ msgstr "" msgid "Examples of returned values:" msgstr "" -msgid "linux-i586" -msgstr "" - -msgid "linux-alpha (?)" -msgstr "" - -msgid "solaris-2.6-sun4u" -msgstr "" - -msgid "Windows will return one of:" +msgid "Windows:" msgstr "" msgid "win-amd64 (64-bit Windows on AMD64, aka x86_64, Intel64, and EM64T)" @@ -529,19 +520,19 @@ msgstr "" msgid "win32 (all others - specifically, sys.platform is returned)" msgstr "" -msgid "macOS can return:" +msgid "POSIX based OS:" msgstr "" -msgid "macosx-10.6-ppc" +msgid "linux-x86_64" msgstr "" -msgid "macosx-10.4-ppc64" +msgid "macosx-15.5-arm64" msgstr "" -msgid "macosx-10.3-i386" +msgid "macosx-26.0-universal2 (macOS on Apple Silicon or Intel)" msgstr "" -msgid "macosx-10.4-fat" +msgid "android-24-arm64_v8a" msgstr "" msgid "" @@ -573,7 +564,7 @@ msgstr "" msgid "Return the path of :file:`Makefile`." msgstr "" -msgid "Using :mod:`sysconfig` as a script" +msgid "Command-line usage" msgstr "" msgid "You can use :mod:`sysconfig` as a script with Python's *-m* option:" @@ -604,9 +595,9 @@ msgid "" msgstr "" msgid "" -"This call will print in the standard output the information returned by :" -"func:`get_platform`, :func:`get_python_version`, :func:`get_path` and :func:" -"`get_config_vars`." +"This call will print in the standard output the information returned " +"by :func:`get_platform`, :func:`get_python_version`, :func:`get_path` " +"and :func:`get_config_vars`." msgstr "" msgid "configuration information" diff --git a/library/syslog.po b/library/syslog.po index 8cb24cf14e..651827a939 100644 --- a/library/syslog.po +++ b/library/syslog.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,8 +37,9 @@ msgstr "Dostępność" msgid "" "This module wraps the system ``syslog`` family of routines. A pure Python " -"library that can speak to a syslog server is available in the :mod:`logging." -"handlers` module as :class:`~logging.handlers.SysLogHandler`." +"library that can speak to a syslog server is available in " +"the :mod:`logging.handlers` module " +"as :class:`~logging.handlers.SysLogHandler`." msgstr "" msgid "The module defines the following functions:" @@ -55,8 +55,8 @@ msgid "" msgstr "" msgid "" -"If :func:`openlog` has not been called prior to the call to :func:`syslog`, :" -"func:`openlog` will be called with no arguments." +"If :func:`openlog` has not been called prior to the call " +"to :func:`syslog`, :func:`openlog` will be called with no arguments." msgstr "" msgid "" @@ -73,15 +73,15 @@ msgstr "" msgid "" "This function is restricted in subinterpreters. (Only code that runs in " "multiple interpreters is affected and the restriction is not relevant for " -"most users.) :func:`openlog` must be called in the main interpreter before :" -"func:`syslog` may be used in a subinterpreter. Otherwise it will raise :exc:" -"`RuntimeError`." +"most users.) :func:`openlog` must be called in the main interpreter " +"before :func:`syslog` may be used in a subinterpreter. Otherwise it will " +"raise :exc:`RuntimeError`." msgstr "" msgid "" -"Logging options of subsequent :func:`syslog` calls can be set by calling :" -"func:`openlog`. :func:`syslog` will call :func:`openlog` with no arguments " -"if the log is not currently open." +"Logging options of subsequent :func:`syslog` calls can be set by " +"calling :func:`openlog`. :func:`syslog` will call :func:`openlog` with no " +"arguments if the log is not currently open." msgstr "" msgid "" @@ -106,8 +106,8 @@ msgstr "" msgid "" "This function is restricted in subinterpreters. (Only code that runs in " "multiple interpreters is affected and the restriction is not relevant for " -"most users.) This may only be called in the main interpreter. It will raise :" -"exc:`RuntimeError` if called in a subinterpreter." +"most users.) This may only be called in the main interpreter. It will " +"raise :exc:`RuntimeError` if called in a subinterpreter." msgstr "" msgid "" @@ -117,8 +117,8 @@ msgstr "" msgid "" "This causes the module to behave as it does when initially imported. For " "example, :func:`openlog` will be called on the first :func:`syslog` call " -"(if :func:`openlog` hasn't already been called), and *ident* and other :func:" -"`openlog` parameters are reset to defaults." +"(if :func:`openlog` hasn't already been called), and *ident* and " +"other :func:`openlog` parameters are reset to defaults." msgstr "" msgid "" @@ -147,19 +147,19 @@ msgid "Priority levels (high to low)." msgstr "" msgid "" -"Facilities, depending on availability in ```` for :const:" -"`LOG_AUTHPRIV`, :const:`LOG_FTP`, :const:`LOG_NETINFO`, :const:" -"`LOG_REMOTEAUTH`, :const:`LOG_INSTALL` and :const:`LOG_RAS`." +"Facilities, depending on availability in ```` " +"for :const:`LOG_AUTHPRIV`, :const:`LOG_FTP`, :const:`LOG_NETINFO`, :const:`LOG_REMOTEAUTH`, :const:`LOG_INSTALL` " +"and :const:`LOG_RAS`." msgstr "" msgid "" -"Added :const:`LOG_FTP`, :const:`LOG_NETINFO`, :const:`LOG_REMOTEAUTH`, :" -"const:`LOG_INSTALL`, :const:`LOG_RAS`, and :const:`LOG_LAUNCHD`." +"Added :const:`LOG_FTP`, :const:`LOG_NETINFO`, :const:`LOG_REMOTEAUTH`, :const:`LOG_INSTALL`, :const:`LOG_RAS`, " +"and :const:`LOG_LAUNCHD`." msgstr "" msgid "" -"Log options, depending on availability in ```` for :const:" -"`LOG_ODELAY`, :const:`LOG_NOWAIT` and :const:`LOG_PERROR`." +"Log options, depending on availability in ```` " +"for :const:`LOG_ODELAY`, :const:`LOG_NOWAIT` and :const:`LOG_PERROR`." msgstr "" msgid "Examples" diff --git a/library/tabnanny.po b/library/tabnanny.po index 36872270e6..5973c11e11 100644 --- a/library/tabnanny.po +++ b/library/tabnanny.po @@ -65,8 +65,8 @@ msgid "" msgstr "" msgid "" -"This function is used by :func:`check` to process tokens generated by the :" -"mod:`tokenize` module." +"This function is used by :func:`check` to process tokens generated by " +"the :mod:`tokenize` module." msgstr "" msgid "Module :mod:`tokenize`" diff --git a/library/tarfile.po b/library/tarfile.po index b47d2c822c..ee12b9190a 100644 --- a/library/tarfile.po +++ b/library/tarfile.po @@ -1,21 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 , 2023 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -29,7 +28,7 @@ msgid ":mod:`!tarfile` --- Read and write tar archive files" msgstr "" msgid "**Source code:** :source:`Lib/tarfile.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/tarfile.py`" msgid "" "The :mod:`tarfile` module makes it possible to read and write tar archives, " @@ -92,7 +91,7 @@ msgstr "" msgid "action" msgstr "" -msgid "``'r' or 'r:*'``" +msgid "``'r'`` or ``'r:*'``" msgstr "" msgid "Open for reading with transparent compression (recommended)." @@ -123,11 +122,11 @@ msgid "Open for reading with lzma compression." msgstr "" msgid "``'x'`` or ``'x:'``" -msgstr "" +msgstr "``'x'`` or ``'x:'``" msgid "" -"Create a tarfile exclusively without compression. Raise a :exc:" -"`FileExistsError` exception if it already exists." +"Create a tarfile exclusively without compression. Raise " +"a :exc:`FileExistsError` exception if it already exists." msgstr "" msgid "``'x:gz'``" @@ -154,7 +153,7 @@ msgid "" "exception if it already exists." msgstr "" -msgid "``'a' or 'a:'``" +msgid "``'a'`` or ``'a:'``" msgstr "" msgid "" @@ -162,7 +161,7 @@ msgid "" "exist." msgstr "" -msgid "``'w' or 'w:'``" +msgid "``'w'`` or ``'w:'``" msgstr "" msgid "Open for uncompressed writing." @@ -188,9 +187,9 @@ msgstr "" msgid "" "Note that ``'a:gz'``, ``'a:bz2'`` or ``'a:xz'`` is not possible. If *mode* " -"is not suitable to open a certain (compressed) file for reading, :exc:" -"`ReadError` is raised. Use *mode* ``'r'`` to avoid this. If a compression " -"method is not supported, :exc:`CompressionError` is raised." +"is not suitable to open a certain (compressed) file for " +"reading, :exc:`ReadError` is raised. Use *mode* ``'r'`` to avoid this. If a " +"compression method is not supported, :exc:`CompressionError` is raised." msgstr "" msgid "" @@ -213,17 +212,18 @@ msgid "" "For special purposes, there is a second format for *mode*: ``'filemode|" "[compression]'``. :func:`tarfile.open` will return a :class:`TarFile` " "object that processes its data as a stream of blocks. No random seeking " -"will be done on the file. If given, *fileobj* may be any object that has a :" -"meth:`~io.RawIOBase.read` or :meth:`~io.RawIOBase.write` method (depending " -"on the *mode*) that works with bytes. *bufsize* specifies the blocksize and " -"defaults to ``20 * 512`` bytes. Use this variant in combination with e.g. " -"``sys.stdin.buffer``, a socket :term:`file object` or a tape device. " -"However, such a :class:`TarFile` object is limited in that it does not allow " -"random access, see :ref:`tar-examples`. The currently possible modes:" +"will be done on the file. If given, *fileobj* may be any object that has " +"a :meth:`~io.RawIOBase.read` or :meth:`~io.RawIOBase.write` method " +"(depending on the *mode*) that works with bytes. *bufsize* specifies the " +"blocksize and defaults to ``20 * 512`` bytes. Use this variant in " +"combination with e.g. ``sys.stdin.buffer``, a socket :term:`file object` or " +"a tape device. However, such a :class:`TarFile` object is limited in that it " +"does not allow random access, see :ref:`tar-examples`. The currently " +"possible modes:" msgstr "" msgid "Mode" -msgstr "" +msgstr "Tryb" msgid "Action" msgstr "" @@ -297,9 +297,9 @@ msgid "" 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." +"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." @@ -322,8 +322,8 @@ msgid "" msgstr "" msgid "" -"Is raised for the limitations that are typical for stream-like :class:" -"`TarFile` objects." +"Is raised for the limitations that are typical for stream-" +"like :class:`TarFile` objects." msgstr "" msgid "" @@ -339,8 +339,8 @@ msgid "" msgstr "" msgid "" -"Information about the member that the filter refused to extract, as :ref:" -"`TarInfo `." +"Information about the member that the filter refused to extract, " +"as :ref:`TarInfo `." msgstr "" msgid "Raised to refuse extracting a member with an absolute path." @@ -360,6 +360,13 @@ msgid "" "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 "" @@ -402,9 +409,9 @@ 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." +"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." @@ -417,13 +424,13 @@ msgid "POSIX.1-2001 (pax) format." msgstr "" msgid "" -"The default format for creating archives. This is currently :const:" -"`PAX_FORMAT`." +"The default format for creating archives. This is " +"currently :const:`PAX_FORMAT`." msgstr "" msgid "" -"The default format for new archives was changed to :const:`PAX_FORMAT` from :" -"const:`GNU_FORMAT`." +"The default format for new archives was changed to :const:`PAX_FORMAT` " +"from :const:`GNU_FORMAT`." msgstr "" msgid "Module :mod:`zipfile`" @@ -455,16 +462,16 @@ msgid "" "The :class:`TarFile` object provides an interface to a tar archive. A tar " "archive is a sequence of blocks. An archive member (a stored file) is made " "up of a header block followed by data blocks. It is possible to store a file " -"in a tar archive several times. Each archive member is represented by a :" -"class:`TarInfo` object, see :ref:`tarinfo-objects` for details." +"in a tar archive several times. Each archive member is represented by " +"a :class:`TarInfo` object, see :ref:`tarinfo-objects` for details." msgstr "" msgid "" -"A :class:`TarFile` object can be used as a context manager in a :keyword:" -"`with` statement. It will automatically be closed when the block is " -"completed. Please note that in the event of an exception an archive opened " -"for writing will not be finalized; only the internally used file object will " -"be closed. See the :ref:`tar-examples` section for a use case." +"A :class:`TarFile` object can be used as a context manager in " +"a :keyword:`with` statement. It will automatically be closed when the block " +"is completed. Please note that in the event of an exception an archive " +"opened for writing will not be finalized; only the internally used file " +"object will be closed. See the :ref:`tar-examples` section for a use case." msgstr "" msgid "Added support for the context management protocol." @@ -535,8 +542,8 @@ msgstr "" msgid "" "The *encoding* and *errors* arguments define the character encoding to be " "used for reading or writing the archive and how conversion errors are going " -"to be handled. The default settings will work for most users. See section :" -"ref:`tar-unicode` for in-depth information." +"to be handled. The default settings will work for most users. See " +"section :ref:`tar-unicode` for in-depth information." msgstr "" msgid "" @@ -591,9 +598,9 @@ msgid "Added the *members* parameter." msgstr "" msgid "" -"Return the next member of the archive as a :class:`TarInfo` object, when :" -"class:`TarFile` is opened for reading. Return :const:`None` if there is no " -"more available." +"Return the next member of the archive as a :class:`TarInfo` object, " +"when :class:`TarFile` is opened for reading. Return :const:`None` if there " +"is no more available." msgstr "" msgid "" @@ -650,8 +657,8 @@ msgid "" msgstr "" msgid "" -"The *numeric_owner* and *filter* arguments are the same as for :meth:" -"`extractall`." +"The *numeric_owner* and *filter* arguments are the same as " +"for :meth:`extractall`." msgstr "" msgid "" @@ -682,12 +689,12 @@ msgid "" msgstr "" msgid "" -"If *errorlevel* is ``0``, errors are ignored when using :meth:`TarFile." -"extract` and :meth:`TarFile.extractall`. Nevertheless, they appear as error " -"messages in the debug output when *debug* is greater than 0. If ``1`` (the " -"default), all *fatal* errors are raised as :exc:`OSError` or :exc:" -"`FilterError` exceptions. If ``2``, all *non-fatal* errors are raised as :" -"exc:`TarError` exceptions as well." +"If *errorlevel* is ``0``, errors are ignored when " +"using :meth:`TarFile.extract` and :meth:`TarFile.extractall`. Nevertheless, " +"they appear as error messages in the debug output when *debug* is greater " +"than 0. If ``1`` (the default), all *fatal* errors are raised " +"as :exc:`OSError` or :exc:`FilterError` exceptions. If ``2``, all *non-" +"fatal* errors are raised as :exc:`TarError` exceptions as well." msgstr "" msgid "" @@ -696,9 +703,9 @@ msgid "" msgstr "" msgid "" -"Custom :ref:`extraction filters ` should raise :" -"exc:`FilterError` for *fatal* errors and :exc:`ExtractError` for *non-fatal* " -"ones." +"Custom :ref:`extraction filters ` should " +"raise :exc:`FilterError` for *fatal* errors and :exc:`ExtractError` for *non-" +"fatal* ones." msgstr "" msgid "" @@ -708,8 +715,8 @@ msgstr "" msgid "" "The :ref:`extraction filter ` used as a default " -"for the *filter* argument of :meth:`~TarFile.extract` and :meth:`~TarFile." -"extractall`." +"for the *filter* argument of :meth:`~TarFile.extract` " +"and :meth:`~TarFile.extractall`." msgstr "" msgid "" @@ -735,19 +742,19 @@ msgid "" "default, although, since it affects all uses of *tarfile*, it is best " "practice to only do so in top-level applications or :mod:`site configuration " "`. To set a global default this way, a filter function needs to be " -"wrapped in :func:`staticmethod` to prevent injection of a ``self`` argument." +"wrapped in :deco:`staticmethod` to prevent injection of a ``self`` argument." msgstr "" msgid "" "Add the file *name* to the archive. *name* may be any type of file " "(directory, fifo, symbolic link, etc.). If given, *arcname* specifies an " "alternative name for the file in the archive. Directories are added " -"recursively by default. This can be avoided by setting *recursive* to :const:" -"`False`. Recursion adds entries in sorted order. If *filter* is given, it " -"should be a function that takes a :class:`TarInfo` object argument and " -"returns the changed :class:`TarInfo` object. If it instead returns :const:" -"`None` the :class:`TarInfo` object will be excluded from the archive. See :" -"ref:`tar-examples` for an example." +"recursively by default. This can be avoided by setting *recursive* " +"to :const:`False`. Recursion adds entries in sorted order. If *filter* is " +"given, it should be a function that takes a :class:`TarInfo` object argument " +"and returns the changed :class:`TarInfo` object. If it instead " +"returns :const:`None` the :class:`TarInfo` object will be excluded from the " +"archive. See :ref:`tar-examples` for an example." msgstr "" msgid "Recursion adds entries in sorted order." @@ -755,10 +762,10 @@ msgstr "" msgid "" "Add the :class:`TarInfo` object *tarinfo* to the archive. If *tarinfo* " -"represents a non zero-size regular file, the *fileobj* argument should be a :" -"term:`binary file`, and ``tarinfo.size`` bytes are read from it and added to " -"the archive. You can create :class:`TarInfo` objects directly, or by using :" -"meth:`gettarinfo`." +"represents a non zero-size regular file, the *fileobj* argument should be " +"a :term:`binary file`, and ``tarinfo.size`` bytes are read from it and added " +"to the archive. You can create :class:`TarInfo` objects directly, or by " +"using :meth:`gettarinfo`." msgstr "" msgid "*fileobj* must be given for non-zero-sized regular files." @@ -777,10 +784,10 @@ msgstr "" msgid "" "You can modify some of the :class:`TarInfo`’s attributes before you add it " "using :meth:`addfile`. If the file object is not an ordinary file object " -"positioned at the beginning of the file, attributes such as :attr:`~TarInfo." -"size` may need modifying. This is the case for objects such as :class:" -"`~gzip.GzipFile`. The :attr:`~TarInfo.name` may also be modified, in which " -"case *arcname* could be a dummy string." +"positioned at the beginning of the file, attributes such " +"as :attr:`~TarInfo.size` may need modifying. This is the case for objects " +"such as :class:`~gzip.GzipFile`. The :attr:`~TarInfo.name` may also be " +"modified, in which case *arcname* could be a dummy string." msgstr "" msgid "" @@ -802,17 +809,17 @@ msgid "" msgstr "" msgid "" -":class:`TarInfo` objects are returned by :class:`TarFile`'s methods :meth:" -"`~TarFile.getmember`, :meth:`~TarFile.getmembers` and :meth:`~TarFile." -"gettarinfo`." +":class:`TarInfo` objects are returned by :class:`TarFile`'s " +"methods :meth:`~TarFile.getmember`, :meth:`~TarFile.getmembers` " +"and :meth:`~TarFile.gettarinfo`." msgstr "" msgid "" -"Modifying the objects returned by :meth:`~TarFile.getmember` or :meth:" -"`~TarFile.getmembers` will affect all subsequent operations on the archive. " -"For cases where this is unwanted, you can use :mod:`copy.copy() ` or " -"call the :meth:`~TarInfo.replace` method to create a modified copy in one " -"step." +"Modifying the objects returned by :meth:`~TarFile.getmember` " +"or :meth:`~TarFile.getmembers` will affect all subsequent operations on the " +"archive. For cases where this is unwanted, you can use :mod:`copy.copy() " +"` or call the :meth:`~TarInfo.replace` method to create a modified " +"copy in one step." msgstr "" msgid "" @@ -861,24 +868,24 @@ msgid "Size in bytes." msgstr "" msgid "" -"Time of last modification in seconds since the :ref:`epoch `, as in :" -"attr:`os.stat_result.st_mtime`." +"Time of last modification in seconds since the :ref:`epoch `, as " +"in :attr:`os.stat_result.st_mtime`." msgstr "" msgid "" -"Can be set to ``None`` for :meth:`~TarFile.extract` and :meth:`~TarFile." -"extractall`, causing extraction to skip applying this attribute." +"Can be set to ``None`` for :meth:`~TarFile.extract` " +"and :meth:`~TarFile.extractall`, causing extraction to skip applying this " +"attribute." msgstr "" msgid "Permission bits, as for :func:`os.chmod`." msgstr "" msgid "" -"File type. *type* is usually one of these constants: :const:`REGTYPE`, :" -"const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, :" -"const:`FIFOTYPE`, :const:`CONTTYPE`, :const:`CHRTYPE`, :const:`BLKTYPE`, :" -"const:`GNUTYPE_SPARSE`. To determine the type of a :class:`TarInfo` object " -"more conveniently, use the ``is*()`` methods below." +"File type. *type* is usually one of these " +"constants: :const:`REGTYPE`, :const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, :const:`FIFOTYPE`, :const:`CONTTYPE`, :const:`CHRTYPE`, :const:`BLKTYPE`, :const:`GNUTYPE_SPARSE`. " +"To determine the type of a :class:`TarInfo` object more conveniently, use " +"the ``is*()`` methods below." msgstr "" msgid "" @@ -936,8 +943,8 @@ msgid "new_tarinfo = old_tarinfo.replace(gname='staff')" msgstr "" msgid "" -"By default, a deep copy is made. If *deep* is false, the copy is shallow, i." -"e. ``pax_headers`` and any custom attributes are shared with the original " +"By default, a deep copy is made. If *deep* is false, the copy is shallow, " +"i.e. ``pax_headers`` and any custom attributes are shared with the original " "``TarInfo`` object." msgstr "" @@ -997,8 +1004,8 @@ msgid "Contains further motivation and rationale behind the design." msgstr "" msgid "" -"The *filter* argument to :meth:`TarFile.extract` or :meth:`~TarFile." -"extractall` can be:" +"The *filter* argument to :meth:`TarFile.extract` " +"or :meth:`~TarFile.extractall` can be:" msgstr "" msgid "" @@ -1015,8 +1022,8 @@ msgstr "" msgid "" "the string ``'data'``: Ignore or block most features specific to UNIX-like " -"filesystems. Intended for extracting cross-platform data archives. See :func:" -"`data_filter` for details." +"filesystems. Intended for extracting cross-platform data archives. " +"See :func:`data_filter` for details." msgstr "" msgid "``None`` (default): Use :attr:`TarFile.extraction_filter`." @@ -1034,9 +1041,9 @@ msgid "" msgstr "" msgid "" -"A callable which will be called for each extracted member with a :ref:" -"`TarInfo ` describing the member and the destination path " -"to where the archive is extracted (i.e. the same path is used for all " +"A callable which will be called for each extracted member with " +"a :ref:`TarInfo ` describing the member and the destination " +"path to where the archive is extracted (i.e. the same path is used for all " "members)::" msgstr "" @@ -1057,10 +1064,10 @@ msgid "return ``None``, in which case the member will be skipped, or" msgstr "" msgid "" -"raise an exception to abort the operation or skip the member, depending on :" -"attr:`~TarFile.errorlevel`. Note that when extraction is aborted, :meth:" -"`~TarFile.extractall` may leave the archive partially extracted. It does not " -"attempt to clean up." +"raise an exception to abort the operation or skip the member, depending " +"on :attr:`~TarFile.errorlevel`. Note that when extraction is " +"aborted, :meth:`~TarFile.extractall` may leave the archive partially " +"extracted. It does not attempt to clean up." msgstr "" msgid "Default named filters" @@ -1089,6 +1096,13 @@ msgid "" "foo`` on Windows). This raises :class:`~tarfile.AbsolutePathError`." msgstr "" +msgid "" +"Normalize filenames (:attr:`TarInfo.name`) that contain ``..`` components " +"using :func:`os.path.normpath`. Note that this removes internal ``..`` " +"components, which may change the meaning of the name if it traverses " +"symbolic links." +msgstr "" + msgid "" ":ref:`Refuse ` to extract files whose absolute " "path (after following symlinks) would end up outside the destination. This " @@ -1096,25 +1110,42 @@ msgid "" msgstr "" msgid "" -"Clear high mode bits (setuid, setgid, sticky) and group/other write bits (:" -"const:`~stat.S_IWGRP` | :const:`~stat.S_IWOTH`)." +":ref:`Refuse ` to extract links (hard or soft) " +"whose name refers to the destination directory itself. This " +"raises :class:`~tarfile.OutsideDestinationError`. Note that such files are " +"refused even on platforms that do not support symbolic links." +msgstr "" + +msgid "" +"Clear high mode bits (setuid, setgid, sticky) and group/other write bits " +"(:const:`~stat.S_IWGRP` | :const:`~stat.S_IWOTH`)." msgstr "" msgid "Return the modified ``TarInfo`` member." msgstr "" +msgid "Filenames containing ``..`` components are now normalized." +msgstr "" + msgid "" "Implements the ``'data'`` filter. In addition to what ``tar_filter`` does:" msgstr "" +msgid "" +"Normalize link targets (:attr:`TarInfo.linkname`) " +"using :func:`os.path.normpath`. Note that this removes internal ``..`` " +"components, which may change the meaning of the link if the path in :attr:`!" +"TarInfo.linkname` traverses symbolic links." +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`." +"This raises :class:`~tarfile.AbsoluteLinkError` " +"or :class:`~tarfile.LinkOutsideDestinationError`." msgstr "" msgid "" @@ -1131,13 +1162,14 @@ msgid "For regular files, including hard links:" msgstr "" msgid "" -"Set the owner read and write permissions (:const:`~stat.S_IRUSR` | :const:" -"`~stat.S_IWUSR`)." +"Set the owner read and write permissions (:const:`~stat.S_IRUSR` " +"| :const:`~stat.S_IWUSR`)." msgstr "" msgid "" -"Remove the group & other executable permission (:const:`~stat.S_IXGRP` | :" -"const:`~stat.S_IXOTH`) if the owner doesn’t have it (:const:`~stat.S_IXUSR`)." +"Remove the group & other executable permission (:const:`~stat.S_IXGRP` " +"| :const:`~stat.S_IXOTH`) if the owner doesn’t have it " +"(:const:`~stat.S_IXUSR`)." msgstr "" msgid "" @@ -1150,6 +1182,9 @@ msgid "" "``None``, so that extraction methods skip setting it." msgstr "" +msgid "Link targets are now normalized." +msgstr "" + msgid "Filter errors" msgstr "" @@ -1175,9 +1210,12 @@ msgid "Here is an incomplete list of things to consider:" msgstr "" msgid "" -"Extract to a :func:`new temporary directory ` to prevent e." -"g. exploiting pre-existing links, and to make it easier to clean up after a " -"failed extraction." +"Extract to a :func:`new temporary directory ` to prevent " +"e.g. exploiting pre-existing links, and to make it easier to clean up after " +"a failed extraction." +msgstr "" + +msgid "Disallow symbolic links if you do not need the functionality." msgstr "" msgid "" @@ -1322,8 +1360,9 @@ msgid "" msgstr "" msgid "" -"If you want to create a new tar archive, specify its name after the :option:" -"`-c` option and then list the filename(s) that should be included:" +"If you want to create a new tar archive, specify its name after " +"the :option:`-c` option and then list the filename(s) that should be " +"included:" msgstr "" msgid "$ python -m tarfile -c monty.tar spam.txt eggs.txt" @@ -1336,8 +1375,8 @@ msgid "$ python -m tarfile -c monty.tar life-of-brian_1979/" msgstr "$ python -m tarfile -c monty.tar life-of-brian_1979/" msgid "" -"If you want to extract a tar archive into the current directory, use the :" -"option:`-e` option:" +"If you want to extract a tar archive into the current directory, use " +"the :option:`-e` option:" msgstr "" msgid "$ python -m tarfile -e monty.tar" @@ -1385,6 +1424,9 @@ msgstr "" msgid "Examples" msgstr "Przykłady" +msgid "Reading examples" +msgstr "" + msgid "How to extract an entire tar archive to the current working directory::" msgstr "" @@ -1414,6 +1456,29 @@ msgid "" "tar.close()" msgstr "" +msgid "" +"How to read a gzip compressed tar archive and display some member " +"information::" +msgstr "" + +msgid "" +"import tarfile\n" +"tar = tarfile.open(\"sample.tar.gz\", \"r:gz\")\n" +"for tarinfo in tar:\n" +" print(tarinfo.name, \"is\", tarinfo.size, \"bytes in size and is \", " +"end=\"\")\n" +" if tarinfo.isreg():\n" +" print(\"a regular file.\")\n" +" elif tarinfo.isdir():\n" +" print(\"a directory.\")\n" +" else:\n" +" print(\"something else.\")\n" +"tar.close()" +msgstr "" + +msgid "Writing examples" +msgstr "" + msgid "How to create an uncompressed tar archive from a list of filenames::" msgstr "" @@ -1436,23 +1501,17 @@ msgid "" msgstr "" msgid "" -"How to read a gzip compressed tar archive and display some member " -"information::" +"How to create and write an archive to stdout using :data:`sys.stdout.buffer " +"` in the *fileobj* parameter in :meth:`TarFile.add`::" msgstr "" msgid "" +"import sys\n" "import tarfile\n" -"tar = tarfile.open(\"sample.tar.gz\", \"r:gz\")\n" -"for tarinfo in tar:\n" -" print(tarinfo.name, \"is\", tarinfo.size, \"bytes in size and is \", " -"end=\"\")\n" -" if tarinfo.isreg():\n" -" print(\"a regular file.\")\n" -" elif tarinfo.isdir():\n" -" print(\"a directory.\")\n" -" else:\n" -" print(\"something else.\")\n" -"tar.close()" +"with tarfile.open(\"sample.tar.gz\", \"w|gz\", fileobj=sys.stdout.buffer) as " +"tar:\n" +" for name in [\"foo\", \"bar\", \"quux\"]:\n" +" tar.add(name)" msgstr "" msgid "" diff --git a/library/tempfile.po b/library/tempfile.po index 7c35031d60..786976d8b3 100644 --- a/library/tempfile.po +++ b/library/tempfile.po @@ -1,20 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# haaritsubaki, 2024 -# Maciej Olko , 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-10-25 19:05+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,15 +27,16 @@ msgid ":mod:`!tempfile` --- Generate temporary files and directories" msgstr "" msgid "**Source code:** :source:`Lib/tempfile.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/tempfile.py`" msgid "" "This module creates temporary files and directories. It works on all " -"supported platforms. :class:`TemporaryFile`, :class:`NamedTemporaryFile`, :" -"class:`TemporaryDirectory`, and :class:`SpooledTemporaryFile` are high-level " -"interfaces which provide automatic cleanup and can be used as :term:`context " -"managers `. :func:`mkstemp` and :func:`mkdtemp` are lower-" -"level functions which require manual cleanup." +"supported " +"platforms. :class:`TemporaryFile`, :class:`NamedTemporaryFile`, :class:`TemporaryDirectory`, " +"and :class:`SpooledTemporaryFile` are high-level interfaces which provide " +"automatic cleanup and can be used as :term:`context managers `. :func:`mkstemp` and :func:`mkdtemp` are lower-level functions " +"which require manual cleanup." msgstr "" msgid "" @@ -64,9 +64,9 @@ msgid "" msgstr "" msgid "" -"The resulting object can be used as a :term:`context manager` (see :ref:" -"`tempfile-examples`). On completion of the context or destruction of the " -"file object the temporary file will be removed from the filesystem." +"The resulting object can be used as a :term:`context manager` " +"(see :ref:`tempfile-examples`). On completion of the context or destruction " +"of the file object the temporary file will be removed from the filesystem." msgstr "" msgid "" @@ -176,10 +176,10 @@ msgstr "" msgid "" "*delete* is true but *delete_on_close* is false. Note, that in this case the " -"additional opens that do not share delete access (e.g. created via builtin :" -"func:`open`) must be closed before exiting the context manager, else the :" -"func:`os.unlink` call on context manager exit will fail with a :exc:" -"`PermissionError`." +"additional opens that do not share delete access (e.g. created via " +"builtin :func:`open`) must be closed before exiting the context manager, " +"else the :func:`os.unlink` call on context manager exit will fail with " +"a :exc:`PermissionError`." msgstr "" msgid "" @@ -203,8 +203,8 @@ msgid "" "This class operates exactly as :func:`TemporaryFile` does, except that data " "is spooled in memory until the file size exceeds *max_size*, or until the " "file's :func:`~io.IOBase.fileno` method is called, at which point the " -"contents are written to disk and operation proceeds as with :func:" -"`TemporaryFile`." +"contents are written to disk and operation proceeds as " +"with :func:`TemporaryFile`." msgstr "" msgid "" @@ -230,8 +230,8 @@ msgid "" msgstr "" msgid "" -"This class securely creates a temporary directory using the same rules as :" -"func:`mkdtemp`. The resulting object can be used as a :term:`context " +"This class securely creates a temporary directory using the same rules " +"as :func:`mkdtemp`. The resulting object can be used as a :term:`context " "manager` (see :ref:`tempfile-examples`). On completion of the context or " "destruction of the temporary directory object, the newly created temporary " "directory and all its contents are removed from the filesystem." @@ -263,6 +263,17 @@ msgid "" "based on other logic." msgstr "" +msgid "" +"Cleanup is not robust against the tree being modified while it is removed. " +"Files outside of the tree may have their permissions and file flags reset." +msgstr "" + +msgid "" +"On systems where :data:`shutil.rmtree.avoids_symlink_attacks` is false, and " +"on Android, manipulating symbolic links during cleanup may cause files " +"outside of the tree to be removed." +msgstr "" + msgid "" "Raises an :ref:`auditing event ` ``tempfile.mkdtemp`` with " "argument ``fullpath``." @@ -280,13 +291,18 @@ msgid "" "implements the :const:`os.O_EXCL` flag for :func:`os.open`. The file is " "readable and writable only by the creating user ID. If the platform uses " "permission bits to indicate whether a file is executable, the file is " -"executable by no one. The file descriptor is not inherited by child " -"processes." +"executable by no one." +msgstr "" + +msgid "" +"The file descriptor is :ref:`not inherited by child processes " +"`." msgstr "" msgid "" "Unlike :func:`TemporaryFile`, the user of :func:`mkstemp` is responsible for " -"deleting the temporary file when done with it." +"closing the file descriptor (for example, using :func:`os.close`) and " +"deleting the temporary file (for example, using :func:`os.remove`)." msgstr "" msgid "" @@ -298,8 +314,8 @@ msgstr "" msgid "" "If *prefix* is not ``None``, the file name will begin with that prefix; " -"otherwise, a default prefix is used. The default is the return value of :" -"func:`gettempprefix` or :func:`gettempprefixb`, as appropriate." +"otherwise, a default prefix is used. The default is the return value " +"of :func:`gettempprefix` or :func:`gettempprefixb`, as appropriate." msgstr "" msgid "" @@ -352,8 +368,8 @@ msgid "" msgstr "" msgid "" -"The *prefix*, *suffix*, and *dir* arguments are the same as for :func:" -"`mkstemp`." +"The *prefix*, *suffix*, and *dir* arguments are the same as " +"for :func:`mkstemp`." msgstr "" msgid ":func:`mkdtemp` returns the absolute pathname of the new directory." @@ -387,13 +403,14 @@ msgid "A platform-specific location:" msgstr "" msgid "" -"On Windows, the directories :file:`C:\\\\TEMP`, :file:`C:\\\\TMP`, :file:`\\" -"\\TEMP`, and :file:`\\\\TMP`, in that order." +"On Windows, the directories :file:`%USERPROFILE%\\\\AppData\\\\Local\\" +"\\Temp`, :file:`%SYSTEMROOT%\\\\Temp`, :file:`C:\\\\TEMP`, :file:`C:\\" +"\\TMP`, :file:`\\\\TEMP`, and :file:`\\\\TMP`, in that order." msgstr "" msgid "" -"On all other platforms, the directories :file:`/tmp`, :file:`/var/tmp`, and :" -"file:`/usr/tmp`, in that order." +"On all other platforms, the directories :file:`/tmp`, :file:`/var/tmp`, " +"and :file:`/usr/tmp`, in that order." msgstr "" msgid "As a last resort, the current working directory." @@ -443,11 +460,11 @@ msgstr "" msgid "" "Beware that if you set ``tempdir`` to a bytes value, there is a nasty side " -"effect: The global default return type of :func:`mkstemp` and :func:" -"`mkdtemp` changes to bytes when no explicit ``prefix``, ``suffix``, or " -"``dir`` arguments of type str are supplied. Please do not write code " -"expecting or depending on this. This awkward behavior is maintained for " -"compatibility with the historical implementation." +"effect: The global default return type of :func:`mkstemp` " +"and :func:`mkdtemp` changes to bytes when no explicit ``prefix``, " +"``suffix``, or ``dir`` arguments of type str are supplied. Please do not " +"write code expecting or depending on this. This awkward behavior is " +"maintained for compatibility with the historical implementation." msgstr "" msgid "Examples" diff --git a/library/termios.po b/library/termios.po index bae249eeaa..00b6490a50 100644 --- a/library/termios.po +++ b/library/termios.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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,8 +38,9 @@ msgstr "Dostępność" msgid "" "All functions in this module take a file descriptor *fd* as their first " -"argument. This can be an integer file descriptor, such as returned by ``sys." -"stdin.fileno()``, or a :term:`file object`, such as ``sys.stdin`` itself." +"argument. This can be an integer file descriptor, such as returned by " +"``sys.stdin.fileno()``, or a :term:`file object`, such as ``sys.stdin`` " +"itself." msgstr "" msgid "" @@ -102,16 +103,16 @@ msgstr "" msgid "" "Return a tuple ``(ws_row, ws_col)`` containing the tty window size for file " -"descriptor *fd*. Requires :const:`termios.TIOCGWINSZ` or :const:`termios." -"TIOCGSIZE`." +"descriptor *fd*. Requires :const:`termios.TIOCGWINSZ` " +"or :const:`termios.TIOCGSIZE`." msgstr "" msgid "" "Set the tty window size for file descriptor *fd* from *winsize*, which is a " -"two-item tuple ``(ws_row, ws_col)`` like the one returned by :func:" -"`tcgetwinsize`. Requires at least one of the pairs (:const:`termios." -"TIOCGWINSZ`, :const:`termios.TIOCSWINSZ`); (:const:`termios.TIOCGSIZE`, :" -"const:`termios.TIOCSSIZE`) to be defined." +"two-item tuple ``(ws_row, ws_col)`` like the one returned " +"by :func:`tcgetwinsize`. Requires at least one of the pairs " +"(:const:`termios.TIOCGWINSZ`, :const:`termios.TIOCSWINSZ`); " +"(:const:`termios.TIOCGSIZE`, :const:`termios.TIOCSSIZE`) to be defined." msgstr "" msgid "Module :mod:`tty`" @@ -125,9 +126,9 @@ msgstr "Przykład" msgid "" "Here's a function that prompts for a password with echoing turned off. Note " -"the technique using a separate :func:`tcgetattr` call and a :keyword:" -"`try` ... :keyword:`finally` statement to ensure that the old tty attributes " -"are restored exactly no matter what happens::" +"the technique using a separate :func:`tcgetattr` call and " +"a :keyword:`try` ... :keyword:`finally` statement to ensure that the old tty " +"attributes are restored exactly no matter what happens::" msgstr "" msgid "" diff --git a/library/test.po b/library/test.po index fe987144c3..8c125667a1 100644 --- a/library/test.po +++ b/library/test.po @@ -36,9 +36,9 @@ msgstr "" msgid "" "The :mod:`test` package contains all regression tests for Python as well as " -"the modules :mod:`test.support` and :mod:`test.regrtest`. :mod:`test." -"support` is used to enhance your tests while :mod:`test.regrtest` drives the " -"testing suite." +"the modules :mod:`test.support` " +"and :mod:`test.regrtest`. :mod:`test.support` is used to enhance your tests " +"while :mod:`test.regrtest` drives the testing suite." msgstr "" msgid "" @@ -81,9 +81,9 @@ msgid "A basic boilerplate is often used::" msgstr "" msgid "" -"This code pattern allows the testing suite to be run by :mod:`test." -"regrtest`, on its own as a script that supports the :mod:`unittest` CLI, or " -"via the ``python -m unittest`` CLI." +"This code pattern allows the testing suite to be run " +"by :mod:`test.regrtest`, on its own as a script that supports " +"the :mod:`unittest` CLI, or via the ``python -m unittest`` CLI." msgstr "" msgid "" @@ -144,10 +144,10 @@ msgid "" msgstr "" msgid "" -"When using this pattern, remember that all classes that inherit from :class:" -"`unittest.TestCase` are run as tests. The :class:`Mixin` class in the " -"example above does not have any data and so can't be run by itself, thus it " -"does not inherit from :class:`unittest.TestCase`." +"When using this pattern, remember that all classes that inherit " +"from :class:`unittest.TestCase` are run as tests. The :class:`Mixin` class " +"in the example above does not have any data and so can't be run by itself, " +"thus it does not inherit from :class:`unittest.TestCase`." msgstr "" msgid "Test Driven Development" @@ -164,14 +164,14 @@ msgid "" "test suite, thanks to the :option:`-m` option: :program:`python -m test`. " "Under the hood, it uses :mod:`test.regrtest`; the call :program:`python -m " "test.regrtest` used in previous Python versions still works. Running the " -"script by itself automatically starts running all regression tests in the :" -"mod:`test` package. It does this by finding all modules in the package whose " -"name starts with ``test_``, importing them, and executing the function :func:" -"`test_main` if present or loading the tests via unittest.TestLoader." -"loadTestsFromModule if ``test_main`` does not exist. The names of tests to " -"execute may also be passed to the script. Specifying a single regression " -"test (:program:`python -m test test_spam`) will minimize output and only " -"print whether the test passed or failed." +"script by itself automatically starts running all regression tests in " +"the :mod:`test` package. It does this by finding all modules in the package " +"whose name starts with ``test_``, importing them, and executing the " +"function :func:`test_main` if present or loading the tests via " +"unittest.TestLoader.loadTestsFromModule if ``test_main`` does not exist. " +"The names of tests to execute may also be passed to the script. Specifying a " +"single regression test (:program:`python -m test test_spam`) will minimize " +"output and only print whether the test passed or failed." msgstr "" msgid "" @@ -189,9 +189,9 @@ msgstr "" msgid "" "Some other ways to execute the regression tests depend on what platform the " "tests are being executed on. On Unix, you can run :program:`make test` at " -"the top-level directory where Python was built. On Windows, executing :" -"program:`rt.bat` from your :file:`PCbuild` directory will run all regression " -"tests." +"the top-level directory where Python was built. On Windows, " +"executing :program:`rt.bat` from your :file:`PCbuild` directory will run all " +"regression tests." msgstr "" msgid ":mod:`test.support` --- Utilities for the Python test suite" @@ -212,8 +212,8 @@ msgid "This module defines the following exceptions:" msgstr "" msgid "" -"Exception to be raised when a test fails. This is deprecated in favor of :" -"mod:`unittest`\\ -based tests and :class:`unittest.TestCase`'s assertion " +"Exception to be raised when a test fails. This is deprecated in favor " +"of :mod:`unittest`\\ -based tests and :class:`unittest.TestCase`'s assertion " "methods." msgstr "" @@ -228,8 +228,8 @@ msgstr "" msgid "" "``True`` when verbose output is enabled. Should be checked when more " -"detailed information is desired about a running test. *verbose* is set by :" -"mod:`test.regrtest`." +"detailed information is desired about a running test. *verbose* is set " +"by :mod:`test.regrtest`." msgstr "" msgid "``True`` if the running interpreter is Jython." @@ -253,9 +253,9 @@ msgid "" msgstr "" msgid "" -"The timeout should be long enough for :meth:`~socket.socket.connect`, :meth:" -"`~socket.socket.recv` and :meth:`~socket.socket.send` methods of :class:" -"`socket.socket`." +"The timeout should be long enough " +"for :meth:`~socket.socket.connect`, :meth:`~socket.socket.recv` " +"and :meth:`~socket.socket.send` methods of :class:`socket.socket`." msgstr "" msgid "Its default value is 5 seconds." @@ -274,8 +274,8 @@ msgstr "" msgid "" "Usually, a timeout using :data:`INTERNET_TIMEOUT` should not mark a test as " -"failed, but skip the test instead: see :func:`~test.support.socket_helper." -"transient_internet`." +"failed, but skip the test instead: " +"see :func:`~test.support.socket_helper.transient_internet`." msgstr "" msgid "Its default value is 1 minute." @@ -314,8 +314,8 @@ msgid "Its default value is 5 minutes." msgstr "" msgid "" -"See also :data:`LOOPBACK_TIMEOUT`, :data:`INTERNET_TIMEOUT` and :data:" -"`SHORT_TIMEOUT`." +"See also :data:`LOOPBACK_TIMEOUT`, :data:`INTERNET_TIMEOUT` " +"and :data:`SHORT_TIMEOUT`." msgstr "" msgid "Set when tests can be skipped when they are not useful for PGO." @@ -354,18 +354,18 @@ msgid "" msgstr "" msgid "" -"Set to ``True`` if Python is built without docstrings (the :c:macro:" -"`WITH_DOC_STRINGS` macro is not defined). See the :option:`configure --" -"without-doc-strings <--without-doc-strings>` option." +"Set to ``True`` if Python is built without docstrings " +"(the :c:macro:`WITH_DOC_STRINGS` macro is not defined). See " +"the :option:`configure --without-doc-strings <--without-doc-strings>` option." msgstr "" msgid "See also the :data:`HAVE_DOCSTRINGS` variable." msgstr "" msgid "" -"Set to ``True`` if function docstrings are available. See the :option:" -"`python -OO <-O>` option, which strips docstrings of functions implemented " -"in Python." +"Set to ``True`` if function docstrings are available. See " +"the :option:`python -OO <-O>` option, which strips docstrings of functions " +"implemented in Python." msgstr "" msgid "See also the :data:`MISSING_C_DOCSTRINGS` variable." @@ -445,9 +445,9 @@ msgstr "" msgid "" "It is also legal to pass strings as parameters; these should be keys in " -"``sys.modules``. Each associated module will be scanned by ``unittest." -"TestLoader.loadTestsFromModule()``. This is usually seen in the following :" -"func:`test_main` function::" +"``sys.modules``. Each associated module will be scanned by " +"``unittest.TestLoader.loadTestsFromModule()``. This is usually seen in the " +"following :func:`test_main` function::" msgstr "" msgid "This will run all tests defined in the named module." @@ -461,8 +461,8 @@ msgstr "" msgid "" "If *verbosity* is ``None``, :func:`doctest.testmod` is run with verbosity " "set to :data:`verbose`. Otherwise, it is run with verbosity set to " -"``None``. *optionflags* is passed as ``optionflags`` to :func:`doctest." -"testmod`." +"``None``. *optionflags* is passed as ``optionflags`` " +"to :func:`doctest.testmod`." msgstr "" msgid "" @@ -487,8 +487,8 @@ msgid "" msgstr "" msgid "" -"Return the original stdout set by :func:`record_original_stdout` or ``sys." -"stdout`` if it's not set." +"Return the original stdout set by :func:`record_original_stdout` or " +"``sys.stdout`` if it's not set." msgstr "" msgid "" @@ -502,8 +502,8 @@ msgid "" msgstr "" msgid "" -"A context managers that temporarily replaces the named stream with :class:" -"`io.StringIO` object." +"A context managers that temporarily replaces the named stream " +"with :class:`io.StringIO` object." msgstr "" msgid "Example use with output streams::" @@ -554,9 +554,9 @@ msgid "" msgstr "" msgid "" -"Call the ``flush()`` method on :data:`sys.stdout` and then on :data:`sys." -"stderr`. It can be used to make sure that the logs order is consistent " -"before writing into stderr." +"Call the ``flush()`` method on :data:`sys.stdout` and then " +"on :data:`sys.stderr`. It can be used to make sure that the logs order is " +"consistent before writing into stderr." msgstr "" msgid "" @@ -599,9 +599,9 @@ msgid "" msgstr "" msgid "" -"A decorator to conditionally mark tests with :func:`unittest." -"expectedFailure`. Any use of this decorator should have an associated " -"comment identifying the relevant tracker issue." +"A decorator to conditionally mark tests " +"with :func:`unittest.expectedFailure`. Any use of this decorator should have " +"an associated comment identifying the relevant tracker issue." msgstr "" msgid "" @@ -719,8 +719,8 @@ msgid "" msgstr "" msgid "" -"Context manager catching unraisable exception using :func:`sys." -"unraisablehook`." +"Context manager catching unraisable exception " +"using :func:`sys.unraisablehook`." msgstr "" msgid "" @@ -761,8 +761,8 @@ msgid "" msgstr "" msgid "" -"Run *code* in subinterpreter. Raise :exc:`unittest.SkipTest` if :mod:" -"`tracemalloc` is enabled." +"Run *code* in subinterpreter. Raise :exc:`unittest.SkipTest` " +"if :mod:`tracemalloc` is enabled." msgstr "" msgid "Assert instances of *cls* are deallocated after iterating." @@ -815,10 +815,10 @@ msgid "Assert that type *tp* cannot be instantiated using *args* and *kwds*." msgstr "" msgid "" -"This function returns a context manager that will change the global :func:" -"`sys.set_int_max_str_digits` setting for the duration of the context to " -"allow execution of test code that needs a different limit on the number of " -"digits when converting between an integer and string." +"This function returns a context manager that will change the " +"global :func:`sys.set_int_max_str_digits` setting for the duration of the " +"context to allow execution of test code that needs a different limit on the " +"number of digits when converting between an integer and string." msgstr "" msgid "The :mod:`test.support` module defines the following classes:" @@ -835,8 +835,9 @@ msgid "" msgstr "" msgid "" -"On UNIX, :func:`resource.setrlimit` is used to set :attr:`resource." -"RLIMIT_CORE`'s soft limit to 0 to prevent coredump file creation." +"On UNIX, :func:`resource.setrlimit` is used to " +"set :attr:`resource.RLIMIT_CORE`'s soft limit to 0 to prevent coredump file " +"creation." msgstr "" msgid "On both platforms, the old value is restored by :meth:`__exit__`." @@ -879,11 +880,11 @@ msgstr "" msgid "" "Returns an unused port that should be suitable for binding. This is " "achieved by creating a temporary socket with the same family and type as the " -"``sock`` parameter (default is :const:`~socket.AF_INET`, :const:`~socket." -"SOCK_STREAM`), and binding it to the specified host address (defaults to " -"``0.0.0.0``) with the port set to 0, eliciting an unused ephemeral port from " -"the OS. The temporary socket is then closed and deleted, and the ephemeral " -"port is returned." +"``sock`` parameter (default " +"is :const:`~socket.AF_INET`, :const:`~socket.SOCK_STREAM`), and binding it " +"to the specified host address (defaults to ``0.0.0.0``) with the port set to " +"0, eliciting an unused ephemeral port from the OS. The temporary socket is " +"then closed and deleted, and the ephemeral port is returned." msgstr "" msgid "" @@ -892,22 +893,23 @@ msgid "" "test. Which one to use depends on whether the calling code is creating a " "Python socket, or if an unused port needs to be provided in a constructor or " "passed to an external program (i.e. the ``-accept`` argument to openssl's " -"s_server mode). Always prefer :func:`bind_port` over :func:" -"`find_unused_port` where possible. Using a hard coded port is discouraged " -"since it can make multiple instances of the test impossible to run " -"simultaneously, which is a problem for buildbots." +"s_server mode). Always prefer :func:`bind_port` " +"over :func:`find_unused_port` where possible. Using a hard coded port is " +"discouraged since it can make multiple instances of the test impossible to " +"run simultaneously, which is a problem for buildbots." msgstr "" msgid "" "Bind the socket to a free port and return the port number. Relies on " "ephemeral ports in order to ensure we are using an unbound port. This is " "important as many tests may be running simultaneously, especially in a " -"buildbot environment. This method raises an exception if the ``sock." -"family`` is :const:`~socket.AF_INET` and ``sock.type`` is :const:`~socket." -"SOCK_STREAM`, and the socket has :const:`~socket.SO_REUSEADDR` or :const:" -"`~socket.SO_REUSEPORT` set on it. Tests should never set these socket " -"options for TCP/IP sockets. The only case for setting these options is " -"testing multicasting via multiple UDP sockets." +"buildbot environment. This method raises an exception if the " +"``sock.family`` is :const:`~socket.AF_INET` and ``sock.type`` " +"is :const:`~socket.SOCK_STREAM`, and the socket " +"has :const:`~socket.SO_REUSEADDR` or :const:`~socket.SO_REUSEPORT` set on " +"it. Tests should never set these socket options for TCP/IP sockets. The only " +"case for setting these options is testing multicasting via multiple UDP " +"sockets." msgstr "" msgid "" @@ -918,8 +920,8 @@ msgid "" msgstr "" msgid "" -"Bind a Unix socket, raising :exc:`unittest.SkipTest` if :exc:" -"`PermissionError` is raised." +"Bind a Unix socket, raising :exc:`unittest.SkipTest` " +"if :exc:`PermissionError` is raised." msgstr "" msgid "" @@ -1005,8 +1007,8 @@ msgid "Run a Python subprocess with the given arguments." msgstr "" msgid "" -"*kw* is extra keyword args to pass to :func:`subprocess.Popen`. Returns a :" -"class:`subprocess.Popen` object." +"*kw* is extra keyword args to pass to :func:`subprocess.Popen`. Returns " +"a :class:`subprocess.Popen` object." msgstr "" msgid "" @@ -1102,8 +1104,8 @@ msgid "" msgstr "" msgid "" -"Context manager catching :class:`threading.Thread` exception using :func:" -"`threading.excepthook`." +"Context manager catching :class:`threading.Thread` exception " +"using :func:`threading.excepthook`." msgstr "" msgid "Attributes set when an exception is caught:" @@ -1230,10 +1232,10 @@ msgid "" msgstr "" msgid "" -"Call :func:`shutil.rmtree` on *path* or call :func:`os.lstat` and :func:`os." -"rmdir` to remove a path and its contents. As with :func:`rmdir`, on Windows " -"platforms this is wrapped with a wait loop that checks for the existence of " -"the files." +"Call :func:`shutil.rmtree` on *path* or call :func:`os.lstat` " +"and :func:`os.rmdir` to remove a path and its contents. As " +"with :func:`rmdir`, on Windows platforms this is wrapped with a wait loop " +"that checks for the existence of the files." msgstr "" msgid "A decorator for running tests that require support for symbolic links." @@ -1250,8 +1252,8 @@ msgstr "" msgid "" "The context manager creates a temporary directory in the current directory " "with name *name* before temporarily changing the current working directory. " -"If *name* is ``None``, the temporary directory is created using :func:" -"`tempfile.mkdtemp`." +"If *name* is ``None``, the temporary directory is created " +"using :func:`tempfile.mkdtemp`." msgstr "" msgid "" @@ -1266,10 +1268,10 @@ msgid "" msgstr "" msgid "" -"If *path* is ``None``, the temporary directory is created using :func:" -"`tempfile.mkdtemp`. If *quiet* is ``False``, the context manager raises an " -"exception on error. Otherwise, if *path* is specified and cannot be " -"created, only a warning is issued." +"If *path* is ``None``, the temporary directory is created " +"using :func:`tempfile.mkdtemp`. If *quiet* is ``False``, the context " +"manager raises an exception on error. Otherwise, if *path* is specified and " +"cannot be created, only a warning is issued." msgstr "" msgid "A context manager that temporarily sets the process umask." @@ -1361,8 +1363,8 @@ msgstr "" msgid "" "A context manager to force import to return a new module reference. This is " -"useful for testing module-level behaviors, such as the emission of a :exc:" -"`DeprecationWarning` on import. Example usage::" +"useful for testing module-level behaviors, such as the emission of " +"a :exc:`DeprecationWarning` on import. Example usage::" msgstr "" msgid "A context manager to temporarily add directories to :data:`sys.path`." @@ -1389,10 +1391,11 @@ msgid "" msgstr "" msgid "" -"Suppress warnings that are instances of *category*, which must be :exc:" -"`Warning` or a subclass. Roughly equivalent to :func:`warnings." -"catch_warnings` with :meth:`warnings.simplefilter('ignore', " -"category=category) `. For example::" +"Suppress warnings that are instances of *category*, which must " +"be :exc:`Warning` or a subclass. Roughly equivalent " +"to :func:`warnings.catch_warnings` " +"with :meth:`warnings.simplefilter('ignore', category=category) " +"`. For example::" msgstr "" msgid "" @@ -1406,17 +1409,17 @@ msgid "" "Test also that the :exc:`SyntaxWarning` is emitted only once, and that it " "will be converted to a :exc:`SyntaxError` when turned into error. *testcase* " "is the :mod:`unittest` instance for the test. *errtext* is the regular " -"expression which should match the string representation of the emitted :exc:" -"`SyntaxWarning` and raised :exc:`SyntaxError`. If *lineno* is not ``None``, " -"compares to the line of the warning and exception. If *offset* is not " -"``None``, compares to the offset of the exception." +"expression which should match the string representation of the " +"emitted :exc:`SyntaxWarning` and raised :exc:`SyntaxError`. If *lineno* is " +"not ``None``, compares to the line of the warning and exception. If *offset* " +"is not ``None``, compares to the offset of the exception." msgstr "" msgid "" "A convenience wrapper for :func:`warnings.catch_warnings()` that makes it " "easier to test that a warning was correctly raised. It is approximately " -"equivalent to calling ``warnings.catch_warnings(record=True)`` with :meth:" -"`warnings.simplefilter` set to ``always`` and with the option to " +"equivalent to calling ``warnings.catch_warnings(record=True)`` " +"with :meth:`warnings.simplefilter` set to ``always`` and with the option to " "automatically validate the results that are recorded." msgstr "" @@ -1475,6 +1478,6 @@ msgid "New optional arguments *filters* and *quiet*." msgstr "" msgid "" -"Class used to record warnings for unit tests. See documentation of :func:" -"`check_warnings` above for more details." +"Class used to record warnings for unit tests. See documentation " +"of :func:`check_warnings` above for more details." msgstr "" diff --git a/library/text.po b/library/text.po index 560bd21d1e..f68de83d62 100644 --- a/library/text.po +++ b/library/text.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2021 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stefan Ocetkiewicz , 2021\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" diff --git a/library/textwrap.po b/library/textwrap.po index 41b8a5c8a1..fc3e27ec6e 100644 --- a/library/textwrap.po +++ b/library/textwrap.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2024 -# Wiktor Matuszewski , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,14 +27,14 @@ msgid ":mod:`!textwrap` --- Text wrapping and filling" msgstr "" msgid "**Source code:** :source:`Lib/textwrap.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/textwrap.py`" msgid "" -"The :mod:`textwrap` module provides some convenience functions, as well as :" -"class:`TextWrapper`, the class that does all the work. If you're just " +"The :mod:`textwrap` module provides some convenience functions, as well " +"as :class:`TextWrapper`, the class that does all the work. If you're just " "wrapping or filling one or two text strings, the convenience functions " -"should be good enough; otherwise, you should use an instance of :class:" -"`TextWrapper` for efficiency." +"should be good enough; otherwise, you should use an instance " +"of :class:`TextWrapper` for efficiency." msgstr "" msgid "" @@ -46,13 +44,13 @@ msgid "" msgstr "" msgid "" -"Optional keyword arguments correspond to the instance attributes of :class:" -"`TextWrapper`, documented below." +"Optional keyword arguments correspond to the instance attributes " +"of :class:`TextWrapper`, documented below." msgstr "" msgid "" -"See the :meth:`TextWrapper.wrap` method for additional details on how :func:" -"`wrap` behaves." +"See the :meth:`TextWrapper.wrap` method for additional details on " +"how :func:`wrap` behaves." msgstr "" msgid "" @@ -64,8 +62,8 @@ msgid "\"\\n\".join(wrap(text, ...))" msgstr "" msgid "" -"In particular, :func:`fill` accepts exactly the same keyword arguments as :" -"func:`wrap`." +"In particular, :func:`fill` accepts exactly the same keyword arguments " +"as :func:`wrap`." msgstr "" msgid "Collapse and truncate the given *text* to fit in the given *width*." @@ -88,11 +86,12 @@ msgid "" msgstr "" msgid "" -"Optional keyword arguments correspond to the instance attributes of :class:" -"`TextWrapper`, documented below. Note that the whitespace is collapsed " -"before the text is passed to the :class:`TextWrapper` :meth:`fill` function, " -"so changing the value of :attr:`.tabsize`, :attr:`.expand_tabs`, :attr:`." -"drop_whitespace`, and :attr:`.replace_whitespace` will have no effect." +"Optional keyword arguments correspond to the instance attributes " +"of :class:`TextWrapper`, documented below. Note that the whitespace is " +"collapsed before the text is passed to the :class:`TextWrapper` :meth:`fill` " +"function, so changing the value " +"of :attr:`.tabsize`, :attr:`.expand_tabs`, :attr:`.drop_whitespace`, " +"and :attr:`.replace_whitespace` will have no effect." msgstr "" msgid "Remove any common leading whitespace from every line in *text*." @@ -168,17 +167,17 @@ msgstr "" "+ world" msgid "" -":func:`wrap`, :func:`fill` and :func:`shorten` work by creating a :class:" -"`TextWrapper` instance and calling a single method on it. That instance is " -"not reused, so for applications that process many text strings using :func:" -"`wrap` and/or :func:`fill`, it may be more efficient to create your own :" -"class:`TextWrapper` object." +":func:`wrap`, :func:`fill` and :func:`shorten` work by creating " +"a :class:`TextWrapper` instance and calling a single method on it. That " +"instance is not reused, so for applications that process many text strings " +"using :func:`wrap` and/or :func:`fill`, it may be more efficient to create " +"your own :class:`TextWrapper` object." msgstr "" msgid "" "Text is preferably wrapped on whitespaces and right after the hyphens in " -"hyphenated words; only then will long words be broken if necessary, unless :" -"attr:`TextWrapper.break_long_words` is set to false." +"hyphenated words; only then will long words be broken if necessary, " +"unless :attr:`TextWrapper.break_long_words` is set to false." msgstr "" msgid "" @@ -211,9 +210,9 @@ msgstr "" msgid "" "(default: ``70``) The maximum length of wrapped lines. As long as there are " -"no individual words in the input text longer than :attr:`width`, :class:" -"`TextWrapper` guarantees that no output line will be longer than :attr:" -"`width` characters." +"no individual words in the input text longer " +"than :attr:`width`, :class:`TextWrapper` guarantees that no output line will " +"be longer than :attr:`width` characters." msgstr "" msgid "" @@ -228,8 +227,8 @@ msgid "" msgstr "" msgid "" -"(default: ``True``) If true, after tab expansion but before wrapping, the :" -"meth:`wrap` method will replace each whitespace character with a single " +"(default: ``True``) If true, after tab expansion but before wrapping, " +"the :meth:`wrap` method will replace each whitespace character with a single " "space. The whitespace characters replaced are as follows: tab, newline, " "vertical tab, formfeed, and carriage return (``'\\t\\n\\v\\f\\r'``)." msgstr "" @@ -330,11 +329,11 @@ msgid "" msgstr "" msgid "" -"Wraps the single paragraph in *text* (a string) so every line is at most :" -"attr:`width` characters long. All wrapping options are taken from instance " -"attributes of the :class:`TextWrapper` instance. Returns a list of output " -"lines, without final newlines. If the wrapped output has no content, the " -"returned list is empty." +"Wraps the single paragraph in *text* (a string) so every line is at " +"most :attr:`width` characters long. All wrapping options are taken from " +"instance attributes of the :class:`TextWrapper` instance. Returns a list of " +"output lines, without final newlines. If the wrapped output has no content, " +"the returned list is empty." msgstr "" msgid "" diff --git a/library/threading.po b/library/threading.po index acb3599b58..ce922c5f78 100644 --- a/library/threading.po +++ b/library/threading.po @@ -1,20 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2021 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -28,13 +28,72 @@ msgid ":mod:`!threading` --- Thread-based parallelism" msgstr "" msgid "**Source code:** :source:`Lib/threading.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/threading.py`" msgid "" "This module constructs higher-level threading interfaces on top of the lower " "level :mod:`_thread` module." msgstr "" +msgid "Availability" +msgstr "Dostępność" + +msgid "" +"This module does not work or is not available on WebAssembly. See :ref:`wasm-" +"availability` for more information." +msgstr "" + +msgid "Introduction" +msgstr "Wprowadzenie" + +msgid "" +"The :mod:`!threading` module provides a way to run multiple `threads " +"`_ (smaller units of a " +"process) concurrently within a single process. It allows for the creation " +"and management of threads, making it possible to execute tasks in parallel, " +"sharing memory space. Threads are particularly useful when tasks are I/O " +"bound, such as file operations or making network requests, where much of the " +"time is spent waiting for external resources." +msgstr "" + +msgid "" +"A typical use case for :mod:`!threading` includes managing a pool of worker " +"threads that can process multiple tasks concurrently. Here's a basic " +"example of creating and starting threads using :class:`~threading.Thread`::" +msgstr "" + +msgid "" +"import threading\n" +"import time\n" +"\n" +"def crawl(link, delay=3):\n" +" print(f\"crawl started for {link}\")\n" +" time.sleep(delay) # Blocking I/O (simulating a network request)\n" +" print(f\"crawl ended for {link}\")\n" +"\n" +"links = [\n" +" \"https://python.org\",\n" +" \"https://docs.python.org\",\n" +" \"https://peps.python.org\",\n" +"]\n" +"\n" +"# Start threads for each link\n" +"threads = []\n" +"for link in links:\n" +" # Using `args` to pass positional arguments and `kwargs` for keyword " +"arguments\n" +" t = threading.Thread(target=crawl, args=(link,), kwargs={\"delay\": 2})\n" +" threads.append(t)\n" +"\n" +"# Start each thread\n" +"for t in threads:\n" +" t.start()\n" +"\n" +"# Wait for all threads to finish\n" +"for t in threads:\n" +" t.join()" +msgstr "" + msgid "This module used to be optional, it is now always available." msgstr "" @@ -66,19 +125,34 @@ msgid "" "lock>`, only one thread can execute Python code at once (even though certain " "performance-oriented libraries might overcome this limitation). If you want " "your application to make better use of the computational resources of multi-" -"core machines, you are advised to use :mod:`multiprocessing` or :class:" -"`concurrent.futures.ProcessPoolExecutor`. However, threading is still an " -"appropriate model if you want to run multiple I/O-bound tasks simultaneously." +"core machines, you are advised to use :mod:`multiprocessing` " +"or :class:`concurrent.futures.ProcessPoolExecutor`. However, threading is " +"still an appropriate model if you want to run multiple I/O-bound tasks " +"simultaneously." msgstr "" -msgid "Availability" -msgstr "Dostępność" +msgid "GIL and performance considerations" +msgstr "" msgid "" -"This module does not work or is not available on WebAssembly. See :ref:`wasm-" -"availability` for more information." +"Unlike the :mod:`multiprocessing` module, which uses separate processes to " +"bypass the :term:`global interpreter lock` (GIL), the threading module " +"operates within a single process, meaning that all threads share the same " +"memory space. However, the GIL limits the performance gains of threading " +"when it comes to CPU-bound tasks, as only one thread can execute Python " +"bytecode at a time. Despite this, threads remain a useful tool for achieving " +"concurrency in many scenarios." msgstr "" +msgid "" +"As of Python 3.13, experimental :term:`free-threaded ` " +"builds can disable the GIL, enabling true parallel execution of threads, but " +"this feature is not available by default (see :pep:`703`)." +msgstr "" + +msgid "Reference" +msgstr "Dokumentacja" + msgid "This module defines the following functions:" msgstr "" @@ -93,7 +167,7 @@ msgstr "" msgid "" "Return the current :class:`Thread` object, corresponding to the caller's " "thread of control. If the caller's thread of control was not created " -"through the :mod:`threading` module, a dummy thread object with limited " +"through the :mod:`!threading` module, a dummy thread object with limited " "functionality is returned." msgstr "" @@ -174,10 +248,10 @@ msgstr "" msgid "" "Return a list of all :class:`Thread` objects currently active. The list " -"includes daemonic threads and dummy thread objects created by :func:" -"`current_thread`. It excludes terminated threads and threads that have not " -"yet been started. However, the main thread is always part of the result, " -"even when terminated." +"includes daemonic threads and dummy thread objects created " +"by :func:`current_thread`. It excludes terminated threads and threads that " +"have not yet been started. However, the main thread is always part of the " +"result, even when terminated." msgstr "" msgid "" @@ -186,13 +260,13 @@ msgid "" msgstr "" msgid "" -"Set a trace function for all threads started from the :mod:`threading` " +"Set a trace function for all threads started from the :mod:`!threading` " "module. The *func* will be passed to :func:`sys.settrace` for each thread, " "before its :meth:`~Thread.run` method is called." msgstr "" msgid "" -"Set a trace function for all threads started from the :mod:`threading` " +"Set a trace function for all threads started from the :mod:`!threading` " "module and all Python threads that are currently executing." msgstr "" @@ -205,13 +279,13 @@ msgid "Get the trace function as set by :func:`settrace`." msgstr "" msgid "" -"Set a profile function for all threads started from the :mod:`threading` " +"Set a profile function for all threads started from the :mod:`!threading` " "module. The *func* will be passed to :func:`sys.setprofile` for each " "thread, before its :meth:`~Thread.run` method is called." msgstr "" msgid "" -"Set a profile function for all threads started from the :mod:`threading` " +"Set a profile function for all threads started from the :mod:`!threading` " "module and all Python threads that are currently executing." msgstr "" @@ -228,9 +302,9 @@ msgid "" "*size* argument specifies the stack size to be used for subsequently created " "threads, and must be 0 (use platform or configured default) or a positive " "integer value of at least 32,768 (32 KiB). If *size* is not specified, 0 is " -"used. If changing the thread stack size is unsupported, a :exc:" -"`RuntimeError` is raised. If the specified stack size is invalid, a :exc:" -"`ValueError` is raised and the stack size is unmodified. 32 KiB is " +"used. If changing the thread stack size is unsupported, " +"a :exc:`RuntimeError` is raised. If the specified stack size is invalid, " +"a :exc:`ValueError` is raised and the stack size is unmodified. 32 KiB is " "currently the minimum supported stack size value to guarantee sufficient " "stack space for the interpreter itself. Note that some platforms may have " "particular restrictions on values for the stack size, such as requiring a " @@ -250,8 +324,8 @@ msgstr "" msgid "" "The maximum value allowed for the *timeout* parameter of blocking functions " "(:meth:`Lock.acquire`, :meth:`RLock.acquire`, :meth:`Condition.wait`, etc.). " -"Specifying a timeout greater than this value will raise an :exc:" -"`OverflowError`." +"Specifying a timeout greater than this value will raise " +"an :exc:`OverflowError`." msgstr "" msgid "" @@ -272,32 +346,182 @@ msgstr "" msgid "All of the methods described below are executed atomically." msgstr "" -msgid "Thread-Local Data" +msgid "Thread-local data" msgstr "" msgid "" -"Thread-local data is data whose values are thread specific. To manage " -"thread-local data, just create an instance of :class:`local` (or a subclass) " -"and store attributes on it::" +"Thread-local data is data whose values are thread specific. If you have data " +"that you want to be local to a thread, create a :class:`local` object and " +"use its attributes::" msgstr "" msgid "" -"mydata = threading.local()\n" -"mydata.x = 1" +">>> mydata = local()\n" +">>> mydata.number = 42\n" +">>> mydata.number\n" +"42" msgstr "" -msgid "The instance's values will be different for separate threads." +msgid "You can also access the :class:`local`-object's dictionary::" msgstr "" -msgid "A class that represents thread-local data." +msgid "" +">>> mydata.__dict__\n" +"{'number': 42}\n" +">>> mydata.__dict__.setdefault('widgets', [])\n" +"[]\n" +">>> mydata.widgets\n" +"[]" +msgstr "" + +msgid "If we access the data in a different thread::" msgstr "" msgid "" -"For more details and extensive examples, see the documentation string of " -"the :mod:`!_threading_local` module: :source:`Lib/_threading_local.py`." +">>> log = []\n" +">>> def f():\n" +"... items = sorted(mydata.__dict__.items())\n" +"... log.append(items)\n" +"... mydata.number = 11\n" +"... log.append(mydata.number)\n" +"\n" +">>> import threading\n" +">>> thread = threading.Thread(target=f)\n" +">>> thread.start()\n" +">>> thread.join()\n" +">>> log\n" +"[[], 11]" msgstr "" -msgid "Thread Objects" +msgid "" +"we get different data. Furthermore, changes made in the other thread don't " +"affect data seen in this thread::" +msgstr "" + +msgid "" +">>> mydata.number\n" +"42" +msgstr "" + +msgid "" +"Of course, values you get from a :class:`local` object, including " +"their :attr:`~object.__dict__` attribute, are for whatever thread was " +"current at the time the attribute was read. For that reason, you generally " +"don't want to save these values across threads, as they apply only to the " +"thread they came from." +msgstr "" + +msgid "" +"You can create custom :class:`local` objects by subclassing " +"the :class:`local` class::" +msgstr "" + +msgid "" +">>> class MyLocal(local):\n" +"... number = 2\n" +"... def __init__(self, /, **kw):\n" +"... self.__dict__.update(kw)\n" +"... def squared(self):\n" +"... return self.number ** 2" +msgstr "" + +msgid "" +"This can be useful to support default values, methods and initialization. " +"Note that if you define an :py:meth:`~object.__init__` method, it will be " +"called each time the :class:`local` object is used in a separate thread. " +"This is necessary to initialize each thread's dictionary." +msgstr "" + +msgid "Now if we create a :class:`local` object::" +msgstr "" + +msgid ">>> mydata = MyLocal(color='red')" +msgstr "" + +msgid "we have a default number::" +msgstr "" + +msgid "" +">>> mydata.number\n" +"2" +msgstr "" + +msgid "an initial color::" +msgstr "" + +msgid "" +">>> mydata.color\n" +"'red'\n" +">>> del mydata.color" +msgstr "" + +msgid "And a method that operates on the data::" +msgstr "" + +msgid "" +">>> mydata.squared()\n" +"4" +msgstr "" + +msgid "As before, we can access the data in a separate thread::" +msgstr "" + +msgid "" +">>> log = []\n" +">>> thread = threading.Thread(target=f)\n" +">>> thread.start()\n" +">>> thread.join()\n" +">>> log\n" +"[[('color', 'red')], 11]" +msgstr "" + +msgid "without affecting this thread's data::" +msgstr "" + +msgid "" +">>> mydata.number\n" +"2\n" +">>> mydata.color\n" +"Traceback (most recent call last):\n" +"...\n" +"AttributeError: 'MyLocal' object has no attribute 'color'" +msgstr "" + +msgid "" +"Note that subclasses can define :term:`__slots__`, but they are not thread " +"local. They are shared across threads::" +msgstr "" + +msgid "" +">>> class MyLocal(local):\n" +"... __slots__ = 'number'\n" +"\n" +">>> mydata = MyLocal()\n" +">>> mydata.number = 42\n" +">>> mydata.color = 'red'" +msgstr "" + +msgid "So, the separate thread::" +msgstr "" + +msgid "" +">>> thread = threading.Thread(target=f)\n" +">>> thread.start()\n" +">>> thread.join()" +msgstr "" + +msgid "affects what we see::" +msgstr "" + +msgid "" +">>> mydata.number\n" +"11" +msgstr "" + +msgid "A class that represents thread-local data." +msgstr "" + +msgid "Thread objects" msgstr "" msgid "" @@ -318,8 +542,8 @@ msgstr "" msgid "" "Once the thread's activity is started, the thread is considered 'alive'. It " "stops being alive when its :meth:`~Thread.run` method terminates -- either " -"normally, or by raising an unhandled exception. The :meth:`~Thread." -"is_alive` method tests whether the thread is alive." +"normally, or by raising an unhandled exception. " +"The :meth:`~Thread.is_alive` method tests whether the thread is alive." msgstr "" msgid "" @@ -334,9 +558,9 @@ msgid "" msgstr "" msgid "" -"If the :meth:`~Thread.run` method raises an exception, :func:`threading." -"excepthook` is called to handle it. By default, :func:`threading.excepthook` " -"ignores silently :exc:`SystemExit`." +"If the :meth:`~Thread.run` method raises an " +"exception, :func:`threading.excepthook` is called to handle it. By " +"default, :func:`threading.excepthook` ignores silently :exc:`SystemExit`." msgstr "" msgid "" @@ -375,8 +599,8 @@ msgid "" msgstr "" msgid "" -"*group* should be ``None``; reserved for future extension when a :class:`!" -"ThreadGroup` class is implemented." +"*group* must be ``None`` as it is reserved for future extension when " +"a :class:`!ThreadGroup` class is implemented." msgstr "" msgid "" @@ -444,8 +668,8 @@ msgid "" msgstr "" msgid "" -"Using list or tuple as the *args* argument which passed to the :class:" -"`Thread` could achieve the same effect." +"Using list or tuple as the *args* argument which passed to " +"the :class:`Thread` could achieve the same effect." msgstr "" msgid "Example::" @@ -473,8 +697,8 @@ msgid "" "floating-point number specifying a timeout for the operation in seconds (or " "fractions thereof). As :meth:`~Thread.join` always returns ``None``, you " "must call :meth:`~Thread.is_alive` after :meth:`~Thread.join` to decide " -"whether a timeout happened -- if the thread is still alive, the :meth:" -"`~Thread.join` call timed out." +"whether a timeout happened -- if the thread is still alive, " +"the :meth:`~Thread.join` call timed out." msgstr "" msgid "" @@ -539,8 +763,8 @@ msgid "" "or not (``False``). This must be set before :meth:`~Thread.start` is " "called, otherwise :exc:`RuntimeError` is raised. Its initial value is " "inherited from the creating thread; the main thread is not a daemon thread " -"and therefore all threads created in the main thread default to :attr:" -"`~Thread.daemon` = ``False``." +"and therefore all threads created in the main thread default " +"to :attr:`~Thread.daemon` = ``False``." msgstr "" msgid "" @@ -552,27 +776,27 @@ msgid "" "a property instead." msgstr "" -msgid "Lock Objects" +msgid "Lock objects" msgstr "" msgid "" "A primitive lock is a synchronization primitive that is not owned by a " "particular thread when locked. In Python, it is currently the lowest level " -"synchronization primitive available, implemented directly by the :mod:" -"`_thread` extension module." +"synchronization primitive available, implemented directly by " +"the :mod:`_thread` extension module." msgstr "" msgid "" "A primitive lock is in one of two states, \"locked\" or \"unlocked\". It is " -"created in the unlocked state. It has two basic methods, :meth:`~Lock." -"acquire` and :meth:`~Lock.release`. When the state is unlocked, :meth:" -"`~Lock.acquire` changes the state to locked and returns immediately. When " -"the state is locked, :meth:`~Lock.acquire` blocks until a call to :meth:" -"`~Lock.release` in another thread changes it to unlocked, then the :meth:" -"`~Lock.acquire` call resets it to locked and returns. The :meth:`~Lock." -"release` method should only be called in the locked state; it changes the " -"state to unlocked and returns immediately. If an attempt is made to release " -"an unlocked lock, a :exc:`RuntimeError` will be raised." +"created in the unlocked state. It has two basic " +"methods, :meth:`~Lock.acquire` and :meth:`~Lock.release`. When the state is " +"unlocked, :meth:`~Lock.acquire` changes the state to locked and returns " +"immediately. When the state is locked, :meth:`~Lock.acquire` blocks until a " +"call to :meth:`~Lock.release` in another thread changes it to unlocked, then " +"the :meth:`~Lock.acquire` call resets it to locked and returns. " +"The :meth:`~Lock.release` method should only be called in the locked state; " +"it changes the state to unlocked and returns immediately. If an attempt is " +"made to release an unlocked lock, a :exc:`RuntimeError` will be raised." msgstr "" msgid "Locks also support the :ref:`context management protocol `." @@ -580,9 +804,9 @@ msgstr "" msgid "" "When more than one thread is blocked in :meth:`~Lock.acquire` waiting for " -"the state to turn to unlocked, only one thread proceeds when a :meth:`~Lock." -"release` call resets the state to unlocked; which one of the waiting threads " -"proceeds is not defined, and may vary across implementations." +"the state to turn to unlocked, only one thread proceeds when " +"a :meth:`~Lock.release` call resets the state to unlocked; which one of the " +"waiting threads proceeds is not defined, and may vary across implementations." msgstr "" msgid "All methods are executed atomically." @@ -654,7 +878,7 @@ msgstr "" msgid "Return ``True`` if the lock is acquired." msgstr "" -msgid "RLock Objects" +msgid "RLock objects" msgstr "" msgid "" @@ -666,15 +890,15 @@ msgid "" msgstr "" msgid "" -"Threads call a lock's :meth:`~RLock.acquire` method to lock it, and its :" -"meth:`~Lock.release` method to unlock it." +"Threads call a lock's :meth:`~RLock.acquire` method to lock it, and " +"its :meth:`~Lock.release` method to unlock it." msgstr "" msgid "" "Reentrant locks support the :ref:`context management protocol `, " -"so it is recommended to use :keyword:`with` instead of manually calling :" -"meth:`~RLock.acquire` and :meth:`~RLock.release` to handle acquiring and " -"releasing the lock for a block of code." +"so it is recommended to use :keyword:`with` instead of manually " +"calling :meth:`~RLock.acquire` and :meth:`~RLock.release` to handle " +"acquiring and releasing the lock for a block of code." msgstr "" msgid "" @@ -764,12 +988,12 @@ msgid "" msgstr "" msgid "" -"Only call this method when the calling thread owns the lock. A :exc:" -"`RuntimeError` is raised if this method is called when the lock is not " -"acquired." +"Only call this method when the calling thread owns the lock. " +"A :exc:`RuntimeError` is raised if this method is called when the lock is " +"not acquired." msgstr "" -msgid "Condition Objects" +msgid "Condition objects" msgstr "" msgid "" @@ -782,23 +1006,24 @@ msgstr "" msgid "" "A condition variable obeys the :ref:`context management protocol `: using the ``with`` statement acquires the associated lock for the " -"duration of the enclosed block. The :meth:`~Condition.acquire` and :meth:" -"`~Condition.release` methods also call the corresponding methods of the " -"associated lock." +"duration of the enclosed block. The :meth:`~Condition.acquire` " +"and :meth:`~Condition.release` methods also call the corresponding methods " +"of the associated lock." msgstr "" msgid "" -"Other methods must be called with the associated lock held. The :meth:" -"`~Condition.wait` method releases the lock, and then blocks until another " -"thread awakens it by calling :meth:`~Condition.notify` or :meth:`~Condition." -"notify_all`. Once awakened, :meth:`~Condition.wait` re-acquires the lock " -"and returns. It is also possible to specify a timeout." +"Other methods must be called with the associated lock held. " +"The :meth:`~Condition.wait` method releases the lock, and then blocks until " +"another thread awakens it by calling :meth:`~Condition.notify` " +"or :meth:`~Condition.notify_all`. Once awakened, :meth:`~Condition.wait` re-" +"acquires the lock and returns. It is also possible to specify a timeout." msgstr "" msgid "" "The :meth:`~Condition.notify` method wakes up one of the threads waiting for " -"the condition variable, if any are waiting. The :meth:`~Condition." -"notify_all` method wakes up all threads waiting for the condition variable." +"the condition variable, if any are waiting. " +"The :meth:`~Condition.notify_all` method wakes up all threads waiting for " +"the condition variable." msgstr "" msgid "" @@ -813,11 +1038,11 @@ msgid "" "The typical programming style using condition variables uses the lock to " "synchronize access to some shared state; threads that are interested in a " "particular change of state call :meth:`~Condition.wait` repeatedly until " -"they see the desired state, while threads that modify the state call :meth:" -"`~Condition.notify` or :meth:`~Condition.notify_all` when they change the " -"state in such a way that it could possibly be a desired state for one of the " -"waiters. For example, the following code is a generic producer-consumer " -"situation with unlimited buffer capacity::" +"they see the desired state, while threads that modify the state " +"call :meth:`~Condition.notify` or :meth:`~Condition.notify_all` when they " +"change the state in such a way that it could possibly be a desired state for " +"one of the waiters. For example, the following code is a generic producer-" +"consumer situation with unlimited buffer capacity::" msgstr "" msgid "" @@ -837,8 +1062,8 @@ msgid "" "The ``while`` loop checking for the application's condition is necessary " "because :meth:`~Condition.wait` can return after an arbitrary long time, and " "the condition which prompted the :meth:`~Condition.notify` call may no " -"longer hold true. This is inherent to multi-threaded programming. The :" -"meth:`~Condition.wait_for` method can be used to automate the condition " +"longer hold true. This is inherent to multi-threaded programming. " +"The :meth:`~Condition.wait_for` method can be used to automate the condition " "checking, and eases the computation of timeouts::" msgstr "" @@ -850,11 +1075,11 @@ msgid "" msgstr "" msgid "" -"To choose between :meth:`~Condition.notify` and :meth:`~Condition." -"notify_all`, consider whether one state change can be interesting for only " -"one or several waiting threads. E.g. in a typical producer-consumer " -"situation, adding one item to the buffer only needs to wake up one consumer " -"thread." +"To choose between :meth:`~Condition.notify` " +"and :meth:`~Condition.notify_all`, consider whether one state change can be " +"interesting for only one or several waiting threads. E.g. in a typical " +"producer-consumer situation, adding one item to the buffer only needs to " +"wake up one consumer thread." msgstr "" msgid "" @@ -901,12 +1126,12 @@ msgid "" msgstr "" msgid "" -"When the underlying lock is an :class:`RLock`, it is not released using its :" -"meth:`release` method, since this may not actually unlock the lock when it " -"was acquired multiple times recursively. Instead, an internal interface of " -"the :class:`RLock` class is used, which really unlocks it even when it has " -"been recursively acquired several times. Another internal interface is then " -"used to restore the recursion level when the lock is reacquired." +"When the underlying lock is an :class:`RLock`, it is not released using " +"its :meth:`release` method, since this may not actually unlock the lock when " +"it was acquired multiple times recursively. Instead, an internal interface " +"of the :class:`RLock` class is used, which really unlocks it even when it " +"has been recursively acquired several times. Another internal interface is " +"then used to restore the recursion level when the lock is reacquired." msgstr "" msgid "" @@ -948,8 +1173,8 @@ msgstr "" msgid "" "By default, wake up one thread waiting on this condition, if any. If the " -"calling thread has not acquired the lock when this method is called, a :exc:" -"`RuntimeError` is raised." +"calling thread has not acquired the lock when this method is called, " +"a :exc:`RuntimeError` is raised." msgstr "" msgid "" @@ -971,31 +1196,31 @@ msgid "" msgstr "" msgid "" -"Wake up all threads waiting on this condition. This method acts like :meth:" -"`notify`, but wakes up all waiting threads instead of one. If the calling " -"thread has not acquired the lock when this method is called, a :exc:" -"`RuntimeError` is raised." +"Wake up all threads waiting on this condition. This method acts " +"like :meth:`notify`, but wakes up all waiting threads instead of one. If the " +"calling thread has not acquired the lock when this method is called, " +"a :exc:`RuntimeError` is raised." msgstr "" msgid "The method ``notifyAll`` is a deprecated alias for this method." msgstr "" -msgid "Semaphore Objects" +msgid "Semaphore objects" msgstr "" msgid "" "This is one of the oldest synchronization primitives in the history of " "computer science, invented by the early Dutch computer scientist Edsger W. " -"Dijkstra (he used the names ``P()`` and ``V()`` instead of :meth:`~Semaphore." -"acquire` and :meth:`~Semaphore.release`)." +"Dijkstra (he used the names ``P()`` and ``V()`` instead " +"of :meth:`~Semaphore.acquire` and :meth:`~Semaphore.release`)." msgstr "" msgid "" -"A semaphore manages an internal counter which is decremented by each :meth:" -"`~Semaphore.acquire` call and incremented by each :meth:`~Semaphore.release` " -"call. The counter can never go below zero; when :meth:`~Semaphore.acquire` " -"finds that it is zero, it blocks, waiting until some other thread calls :" -"meth:`~Semaphore.release`." +"A semaphore manages an internal counter which is decremented by " +"each :meth:`~Semaphore.acquire` call and incremented by " +"each :meth:`~Semaphore.release` call. The counter can never go below zero; " +"when :meth:`~Semaphore.acquire` finds that it is zero, it blocks, waiting " +"until some other thread calls :meth:`~Semaphore.release`." msgstr "" msgid "" @@ -1028,10 +1253,10 @@ msgid "" msgstr "" msgid "" -"If the internal counter is zero on entry, block until awoken by a call to :" -"meth:`~Semaphore.release`. Once awoken (and the counter is greater than 0), " -"decrement the counter by 1 and return ``True``. Exactly one thread will be " -"awoken by each call to :meth:`~Semaphore.release`. The order in which " +"If the internal counter is zero on entry, block until awoken by a call " +"to :meth:`~Semaphore.release`. Once awoken (and the counter is greater than " +"0), decrement the counter by 1 and return ``True``. Exactly one thread will " +"be awoken by each call to :meth:`~Semaphore.release`. The order in which " "threads are awoken should not be relied on." msgstr "" @@ -1058,13 +1283,13 @@ msgstr "" msgid "" "Class implementing bounded semaphore objects. A bounded semaphore checks to " -"make sure its current value doesn't exceed its initial value. If it does, :" -"exc:`ValueError` is raised. In most situations semaphores are used to guard " -"resources with limited capacity. If the semaphore is released too many " -"times it's a sign of a bug. If not given, *value* defaults to 1." +"make sure its current value doesn't exceed its initial value. If it " +"does, :exc:`ValueError` is raised. In most situations semaphores are used to " +"guard resources with limited capacity. If the semaphore is released too " +"many times it's a sign of a bug. If not given, *value* defaults to 1." msgstr "" -msgid ":class:`Semaphore` Example" +msgid ":class:`Semaphore` example" msgstr "" msgid "" @@ -1100,7 +1325,7 @@ msgid "" "undetected." msgstr "" -msgid "Event Objects" +msgid "Event objects" msgstr "" msgid "" @@ -1109,16 +1334,17 @@ msgid "" msgstr "" msgid "" -"An event object manages an internal flag that can be set to true with the :" -"meth:`~Event.set` method and reset to false with the :meth:`~Event.clear` " -"method. The :meth:`~Event.wait` method blocks until the flag is true." +"An event object manages an internal flag that can be set to true with " +"the :meth:`~Event.set` method and reset to false with " +"the :meth:`~Event.clear` method. The :meth:`~Event.wait` method blocks " +"until the flag is true." msgstr "" msgid "" "Class implementing event objects. An event manages a flag that can be set " -"to true with the :meth:`~Event.set` method and reset to false with the :meth:" -"`clear` method. The :meth:`wait` method blocks until the flag is true. The " -"flag is initially false." +"to true with the :meth:`~Event.set` method and reset to false with " +"the :meth:`clear` method. The :meth:`wait` method blocks until the flag is " +"true. The flag is initially false." msgstr "" msgid "Return ``True`` if and only if the internal flag is true." @@ -1153,14 +1379,14 @@ msgid "" "fractions thereof." msgstr "" -msgid "Timer Objects" +msgid "Timer objects" msgstr "" msgid "" "This class represents an action that should be run only after a certain " -"amount of time has passed --- a timer. :class:`Timer` is a subclass of :" -"class:`Thread` and as such also functions as an example of creating custom " -"threads." +"amount of time has passed --- a timer. :class:`Timer` is a subclass " +"of :class:`Thread` and as such also functions as an example of creating " +"custom threads." msgstr "" msgid "" @@ -1194,7 +1420,7 @@ msgid "" "only work if the timer is still in its waiting stage." msgstr "" -msgid "Barrier Objects" +msgid "Barrier objects" msgstr "" msgid "" @@ -1305,8 +1531,8 @@ msgid "A boolean that is ``True`` if the barrier is in the broken state." msgstr "" msgid "" -"This exception, a subclass of :exc:`RuntimeError`, is raised when the :class:" -"`Barrier` object is reset or broken." +"This exception, a subclass of :exc:`RuntimeError`, is raised when " +"the :class:`Barrier` object is reset or broken." msgstr "" msgid "" @@ -1338,9 +1564,9 @@ msgid "" msgstr "" msgid "" -"Currently, :class:`Lock`, :class:`RLock`, :class:`Condition`, :class:" -"`Semaphore`, and :class:`BoundedSemaphore` objects may be used as :keyword:" -"`with` statement context managers." +"Currently, :class:`Lock`, :class:`RLock`, :class:`Condition`, :class:`Semaphore`, " +"and :class:`BoundedSemaphore` objects may be used as :keyword:`with` " +"statement context managers." msgstr "" msgid "trace function" diff --git a/library/time.po b/library/time.po index ac8d3befc9..a9a9b149e0 100644 --- a/library/time.po +++ b/library/time.po @@ -1,22 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stefan Ocetkiewicz , 2023 -# Waldemar Stoczkowski, 2023 -# Maciej Olko , 2024 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-18 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-13 21:57+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -93,32 +90,32 @@ msgstr "" msgid "" "On the other hand, the precision of :func:`.time` and :func:`sleep` is " "better than their Unix equivalents: times are expressed as floating-point " -"numbers, :func:`.time` returns the most accurate time available (using Unix :" -"c:func:`!gettimeofday` where available), and :func:`sleep` will accept a " -"time with a nonzero fraction (Unix :c:func:`!select` is used to implement " +"numbers, :func:`.time` returns the most accurate time available (using " +"Unix :c:func:`!gettimeofday` where available), and :func:`sleep` will accept " +"a time with a nonzero fraction (Unix :c:func:`!select` is used to implement " "this, where available)." msgstr "" msgid "" -"The time value as returned by :func:`gmtime`, :func:`localtime`, and :func:" -"`strptime`, and accepted by :func:`asctime`, :func:`mktime` and :func:" -"`strftime`, is a sequence of 9 integers. The return values of :func:" -"`gmtime`, :func:`localtime`, and :func:`strptime` also offer attribute names " -"for individual fields." +"The time value as returned by :func:`gmtime`, :func:`localtime`, " +"and :func:`strptime`, and accepted by :func:`asctime`, :func:`mktime` " +"and :func:`strftime`, is a sequence of 9 integers. The return values " +"of :func:`gmtime`, :func:`localtime`, and :func:`strptime` also offer " +"attribute names for individual fields." msgstr "" msgid "See :class:`struct_time` for a description of these objects." msgstr "" msgid "" -"The :class:`struct_time` type was extended to provide the :attr:" -"`~struct_time.tm_gmtoff` and :attr:`~struct_time.tm_zone` attributes when " -"platform supports corresponding ``struct tm`` members." +"The :class:`struct_time` type was extended to provide " +"the :attr:`~struct_time.tm_gmtoff` and :attr:`~struct_time.tm_zone` " +"attributes when platform supports corresponding ``struct tm`` members." msgstr "" msgid "" -"The :class:`struct_time` attributes :attr:`~struct_time.tm_gmtoff` and :attr:" -"`~struct_time.tm_zone` are now available on all platforms." +"The :class:`struct_time` attributes :attr:`~struct_time.tm_gmtoff` " +"and :attr:`~struct_time.tm_zone` are now available on all platforms." msgstr "" msgid "Use the following functions to convert between time representations:" @@ -158,15 +155,17 @@ msgid "Functions" msgstr "Zadania" msgid "" -"Convert a tuple or :class:`struct_time` representing a time as returned by :" -"func:`gmtime` or :func:`localtime` to a string of the following form: ``'Sun " -"Jun 20 23:21:05 1993'``. The day field is two characters long and is space " -"padded if the day is a single digit, e.g.: ``'Wed Jun 9 04:26:40 1993'``." +"Convert a tuple or :class:`struct_time` representing a time as returned " +"by :func:`gmtime` or :func:`localtime` to a string of the following form: " +"``'Sun Jun 20 23:21:05 1993'``. The day field is two characters long and is " +"space padded if the day is a single digit, for example: ``'Wed Jun 9 " +"04:26:40 1993'``." msgstr "" msgid "" -"If *t* is not provided, the current time as returned by :func:`localtime` is " -"used. Locale information is not used by :func:`asctime`." +"If *time_tuple* is not provided, the current time as returned " +"by :func:`localtime` is used. Locale information is not used " +"by :func:`asctime`." msgstr "" msgid "" @@ -209,21 +208,21 @@ msgid "" msgstr "" msgid "" -"Use :func:`clock_gettime_ns` to avoid the precision loss caused by the :" -"class:`float` type." +"Use :func:`clock_gettime_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "Similar to :func:`clock_gettime` but return time as nanoseconds." msgstr "" msgid "" -"Set the time of the specified clock *clk_id*. Currently, :data:" -"`CLOCK_REALTIME` is the only accepted value for *clk_id*." +"Set the time of the specified clock *clk_id*. " +"Currently, :data:`CLOCK_REALTIME` is the only accepted value for *clk_id*." msgstr "" msgid "" -"Use :func:`clock_settime_ns` to avoid the precision loss caused by the :" -"class:`float` type." +"Use :func:`clock_settime_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "Similar to :func:`clock_settime` but set time with nanoseconds." @@ -232,15 +231,15 @@ msgstr "" msgid "" "Convert a time expressed in seconds since the epoch_ to a string of a form: " "``'Sun Jun 20 23:21:05 1993'`` representing local time. The day field is two " -"characters long and is space padded if the day is a single digit, e.g.: " -"``'Wed Jun 9 04:26:40 1993'``." +"characters long and is space padded if the day is a single digit, for " +"example: ``'Wed Jun 9 04:26:40 1993'``." msgstr "" msgid "" -"If *secs* is not provided or :const:`None`, the current time as returned by :" -"func:`.time` is used. ``ctime(secs)`` is equivalent to " -"``asctime(localtime(secs))``. Locale information is not used by :func:" -"`ctime`." +"If *seconds* is not provided or :const:`None`, the current time as returned " +"by :func:`.time` is used. ``ctime(seconds)`` is equivalent to " +"``asctime(localtime(seconds))``. Locale information is not used " +"by :func:`ctime`." msgstr "" msgid "" @@ -267,8 +266,8 @@ msgid "The result has the following attributes:" msgstr "" msgid "" -"*adjustable*: ``True`` if the clock can be changed automatically (e.g. by a " -"NTP daemon) or manually by the system administrator, ``False`` otherwise" +"*adjustable*: ``True`` if the clock can be set to jump forward or backward " +"in time, ``False`` otherwise. Does not refer to gradual NTP rate adjustments." msgstr "" msgid "" @@ -284,35 +283,35 @@ msgid "*resolution*: The resolution of the clock in seconds (:class:`float`)" msgstr "" msgid "" -"Convert a time expressed in seconds since the epoch_ to a :class:" -"`struct_time` in UTC in which the dst flag is always zero. If *secs* is not " -"provided or :const:`None`, the current time as returned by :func:`.time` is " -"used. Fractions of a second are ignored. See above for a description of " -"the :class:`struct_time` object. See :func:`calendar.timegm` for the inverse " -"of this function." +"Convert a time expressed in seconds since the epoch_ to " +"a :class:`struct_time` in UTC in which the dst flag is always zero. If " +"*seconds* is not provided or :const:`None`, the current time as returned " +"by :func:`.time` is used. Fractions of a second are ignored. See above for " +"a description of the :class:`struct_time` object. " +"See :func:`calendar.timegm` for the inverse of this function." msgstr "" msgid "" -"Like :func:`gmtime` but converts to local time. If *secs* is not provided " -"or :const:`None`, the current time as returned by :func:`.time` is used. " -"The dst flag is set to ``1`` when DST applies to the given time." +"Like :func:`gmtime` but converts to local time. If *seconds* is not provided " +"or :const:`None`, the current time as returned by :func:`.time` is used. The " +"dst flag is set to ``1`` when DST applies to the given time." msgstr "" msgid "" ":func:`localtime` may raise :exc:`OverflowError`, if the timestamp is " "outside the range of values supported by the platform C :c:func:`localtime` " -"or :c:func:`gmtime` functions, and :exc:`OSError` on :c:func:`localtime` or :" -"c:func:`gmtime` failure. It's common for this to be restricted to years " +"or :c:func:`gmtime` functions, and :exc:`OSError` on :c:func:`localtime` " +"or :c:func:`gmtime` failure. It's common for this to be restricted to years " "between 1970 and 2038." msgstr "" msgid "" -"This is the inverse function of :func:`localtime`. Its argument is the :" -"class:`struct_time` or full 9-tuple (since the dst flag is needed; use " +"This is the inverse function of :func:`localtime`. Its argument is " +"the :class:`struct_time` or full 9-tuple (since the dst flag is needed; use " "``-1`` as the dst flag if it is unknown) which expresses the time in *local* " -"time, not UTC. It returns a floating-point number, for compatibility with :" -"func:`.time`. If the input value cannot be represented as a valid time, " -"either :exc:`OverflowError` or :exc:`ValueError` will be raised (which " +"time, not UTC. It returns a floating-point number, for compatibility " +"with :func:`.time`. If the input value cannot be represented as a valid " +"time, either :exc:`OverflowError` or :exc:`ValueError` will be raised (which " "depends on whether the invalid value is caught by Python or the underlying C " "libraries). The earliest date for which it can generate a time is platform-" "dependent." @@ -346,14 +345,16 @@ msgid "Otherwise, call ``clock_gettime(CLOCK_MONOTONIC)``." msgstr "" msgid "" -"Use :func:`monotonic_ns` to avoid the precision loss caused by the :class:" -"`float` type." +"Use :func:`monotonic_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" -msgid "The function is now always available and always system-wide." +msgid "" +"The function is now always available and the clock is now the same for all " +"processes." msgstr "" -msgid "On macOS, the function is now system-wide." +msgid "On macOS, the clock is now the same for all processes." msgstr "" msgid "Similar to :func:`monotonic`, but return time as nanoseconds." @@ -362,9 +363,9 @@ msgstr "" msgid "" "Return the value (in fractional seconds) of a performance counter, i.e. a " "clock with the highest available resolution to measure a short duration. It " -"does include time elapsed during sleep and is system-wide. The reference " -"point of the returned value is undefined, so that only the difference " -"between the results of two calls is valid." +"does include time elapsed during sleep. The clock is the same for all " +"processes. The reference point of the returned value is undefined, so that " +"only the difference between the results of two calls is valid." msgstr "" msgid "" @@ -373,11 +374,11 @@ msgid "" msgstr "" msgid "" -"Use :func:`perf_counter_ns` to avoid the precision loss caused by the :class:" -"`float` type." +"Use :func:`perf_counter_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" -msgid "On Windows, the function is now system-wide." +msgid "On Windows, the clock is now the same for all processes." msgstr "" msgid "Use the same clock as :func:`time.monotonic`." @@ -395,8 +396,8 @@ msgid "" msgstr "" msgid "" -"Use :func:`process_time_ns` to avoid the precision loss caused by the :class:" -"`float` type." +"Use :func:`process_time_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "Similar to :func:`process_time` but return time as nanoseconds." @@ -422,13 +423,13 @@ msgid "Windows implementation" msgstr "" msgid "" -"On Windows, if *secs* is zero, the thread relinquishes the remainder of its " -"time slice to any other thread that is ready to run. If there are no other " -"threads ready to run, the function returns immediately, and the thread " -"continues execution. On Windows 8.1 and newer the implementation uses a " -"`high-resolution timer `_ which provides resolution of 100 " -"nanoseconds. If *secs* is zero, ``Sleep(0)`` is used." +"On Windows, if *seconds* is zero, the thread relinquishes the remainder of " +"its time slice to any other thread that is ready to run. If there are no " +"other threads ready to run, the function returns immediately, and the thread " +"continues execution. On Windows 10 and newer the implementation uses a `high-" +"resolution timer `_ which provides resolution of 100 " +"nanoseconds. If *seconds* is zero, ``Sleep(0)`` is used." msgstr "" msgid "Unix implementation" @@ -454,13 +455,13 @@ msgstr "" msgid "" "Raises an :ref:`auditing event ` ``time.sleep`` with argument " -"``secs``." +"``seconds``." msgstr "" msgid "" -"The function now sleeps at least *secs* even if the sleep is interrupted by " -"a signal, except if the signal handler raises an exception (see :pep:`475` " -"for the rationale)." +"The function now sleeps at least *seconds* even if the sleep is interrupted " +"by a signal, except if the signal handler raises an exception " +"(see :pep:`475` for the rationale)." msgstr "" msgid "" @@ -472,11 +473,12 @@ msgid "Raises an auditing event." msgstr "" msgid "" -"Convert a tuple or :class:`struct_time` representing a time as returned by :" -"func:`gmtime` or :func:`localtime` to a string as specified by the *format* " -"argument. If *t* is not provided, the current time as returned by :func:" -"`localtime` is used. *format* must be a string. :exc:`ValueError` is " -"raised if any field in *t* is outside of the allowed range." +"Convert a tuple or :class:`struct_time` representing a time as returned " +"by :func:`gmtime` or :func:`localtime` to a string as specified by the " +"*format* argument. If *time_tuple* is not provided, the current time as " +"returned by :func:`localtime` is used. *format* must be a " +"string. :exc:`ValueError` is raised if any field in *time_tuple* is outside " +"of the allowed range." msgstr "" msgid "" @@ -695,10 +697,10 @@ msgid "Notes:" msgstr "Uwagi:" msgid "" -"The ``%f`` format directive only applies to :func:`strptime`, not to :func:" -"`strftime`. However, see also :meth:`datetime.datetime.strptime` and :meth:" -"`datetime.datetime.strftime` where the ``%f`` format directive :ref:`applies " -"to microseconds `." +"The ``%f`` format directive only applies to :func:`strptime`, not " +"to :func:`strftime`. However, see also :meth:`datetime.datetime.strptime` " +"and :meth:`datetime.datetime.strftime` where the ``%f`` format " +"directive :ref:`applies to microseconds `." msgstr "" msgid "" @@ -720,7 +722,7 @@ msgstr "" msgid "" "Here is an example, a format for dates compatible with that specified in " -"the :rfc:`2822` Internet email standard. [1]_ ::" +"the :rfc:`5322` Internet email standard. [1]_ ::" msgstr "" msgid "" @@ -732,8 +734,8 @@ msgstr "" msgid "" "Additional directives may be supported on certain platforms, but only the " "ones listed here have a meaning standardized by ANSI C. To see the full set " -"of format codes supported on your platform, consult the :manpage:" -"`strftime(3)` documentation." +"of format codes supported on your platform, consult " +"the :manpage:`strftime(3)` documentation." msgstr "" msgid "" @@ -749,13 +751,13 @@ msgid "" msgstr "" msgid "" -"The *format* parameter uses the same directives as those used by :func:" -"`strftime`; it defaults to ``\"%a %b %d %H:%M:%S %Y\"`` which matches the " -"formatting returned by :func:`ctime`. If *string* cannot be parsed according " -"to *format*, or if it has excess data after parsing, :exc:`ValueError` is " -"raised. The default values used to fill in any missing data when more " -"accurate values cannot be inferred are ``(1900, 1, 1, 0, 0, 0, 0, 1, -1)``. " -"Both *string* and *format* must be strings." +"The *format* parameter uses the same directives as those used " +"by :func:`strftime`; it defaults to ``\"%a %b %d %H:%M:%S %Y\"`` which " +"matches the formatting returned by :func:`ctime`. If *string* cannot be " +"parsed according to *format*, or if it has excess data after " +"parsing, :exc:`ValueError` is raised. The default values used to fill in any " +"missing data when more accurate values cannot be inferred are ``(1900, 1, 1, " +"0, 0, 0, 0, 1, -1)``. Both *string* and *format* must be strings." msgstr "" msgid "For example:" @@ -777,14 +779,14 @@ msgid "" msgstr "" msgid "" -"The type of the time value sequence returned by :func:`gmtime`, :func:" -"`localtime`, and :func:`strptime`. It is an object with a :term:`named " -"tuple` interface: values can be accessed by index and by attribute name. " -"The following values are present:" +"The type of the time value sequence returned " +"by :func:`gmtime`, :func:`localtime`, and :func:`strptime`. It is an object " +"with a :term:`named tuple` interface: values can be accessed by index and by " +"attribute name. The following values are present:" msgstr "" msgid "Index" -msgstr "" +msgstr "Indeks" msgid "Attribute" msgstr "atrybut" @@ -835,7 +837,7 @@ msgid "range [0, 6]; Monday is 0" msgstr "" msgid "7" -msgstr "" +msgstr "7" msgid "range [1, 366]" msgstr "" @@ -868,17 +870,17 @@ msgid "" msgstr "" msgid "" -"When a tuple with an incorrect length is passed to a function expecting a :" -"class:`struct_time`, or having elements of the wrong type, a :exc:" -"`TypeError` is raised." +"When a tuple with an incorrect length is passed to a function expecting " +"a :class:`struct_time`, or having elements of the wrong type, " +"a :exc:`TypeError` is raised." msgstr "" msgid "" "Return the time in seconds since the epoch_ as a floating-point number. The " "handling of `leap seconds`_ is platform dependent. On Windows and most Unix " "systems, the leap seconds are not counted towards the time in seconds since " -"the epoch_. This is commonly referred to as `Unix time `_." +"the epoch_. This is commonly referred to as `Unix time `_." msgstr "" msgid "" @@ -891,14 +893,14 @@ msgstr "" msgid "" "The number returned by :func:`.time` may be converted into a more common " -"time format (i.e. year, month, day, hour, etc...) in UTC by passing it to :" -"func:`gmtime` function or in local time by passing it to the :func:" -"`localtime` function. In both cases a :class:`struct_time` object is " -"returned, from which the components of the calendar date may be accessed as " -"attributes." +"time format (i.e. year, month, day, hour, etc...) in UTC by passing it " +"to :func:`gmtime` function or in local time by passing it to " +"the :func:`localtime` function. In both cases a :class:`struct_time` object " +"is returned, from which the components of the calendar date may be accessed " +"as attributes." msgstr "" -msgid "On Windows, call ``GetSystemTimeAsFileTime()``." +msgid "On Windows, call ``GetSystemTimePreciseAsFileTime()``." msgstr "" msgid "Call ``clock_gettime(CLOCK_REALTIME)`` if available." @@ -912,6 +914,11 @@ msgid "" "type." msgstr "" +msgid "" +"On Windows, calls ``GetSystemTimePreciseAsFileTime()`` instead of " +"``GetSystemTimeAsFileTime()``." +msgstr "" + msgid "" "Similar to :func:`~time.time` but returns time as an integer number of " "nanoseconds since the epoch_." @@ -926,8 +933,8 @@ msgid "" msgstr "" msgid "" -"Use :func:`thread_time_ns` to avoid the precision loss caused by the :class:" -"`float` type." +"Use :func:`thread_time_ns` to avoid the precision loss caused by " +"the :class:`float` type." msgstr "" msgid "Unix systems supporting ``CLOCK_THREAD_CPUTIME_ID``." @@ -948,8 +955,8 @@ msgstr "" msgid "" "Although in many cases, changing the :envvar:`TZ` environment variable may " -"affect the output of functions like :func:`localtime` without calling :func:" -"`tzset`, this behavior should not be relied on." +"affect the output of functions like :func:`localtime` without " +"calling :func:`tzset`, this behavior should not be relied on." msgstr "" msgid "The :envvar:`TZ` environment variable should contain no whitespace." @@ -1059,8 +1066,8 @@ msgid "Clock ID Constants" msgstr "" msgid "" -"These constants are used as parameters for :func:`clock_getres` and :func:" -"`clock_gettime`." +"These constants are used as parameters for :func:`clock_getres` " +"and :func:`clock_gettime`." msgstr "" msgid "" @@ -1101,7 +1108,7 @@ msgstr "" msgid "" "`International Atomic Time `_" +"division/how-utcnist-related-coordinated-universal-time-utc-international>`_" msgstr "" msgid "" @@ -1129,13 +1136,13 @@ msgid "" msgstr "" msgid "" -"The following constant is the only parameter that can be sent to :func:" -"`clock_settime`." +"The following constant is the only parameter that can be sent " +"to :func:`clock_settime`." msgstr "" msgid "" -"System-wide real-time clock. Setting this clock requires appropriate " -"privileges." +"Real-time clock. Setting this clock requires appropriate privileges. The " +"clock is the same for all processes." msgstr "" msgid "Timezone Constants" @@ -1164,12 +1171,13 @@ msgid "" msgstr "" msgid "" -"For the above Timezone constants (:data:`altzone`, :data:`daylight`, :data:" -"`timezone`, and :data:`tzname`), the value is determined by the timezone " -"rules in effect at module load time or the last time :func:`tzset` is called " -"and may be incorrect for times in the past. It is recommended to use the :" -"attr:`~struct_time.tm_gmtoff` and :attr:`~struct_time.tm_zone` results from :" -"func:`localtime` to obtain timezone information." +"For the above Timezone constants " +"(:data:`altzone`, :data:`daylight`, :data:`timezone`, and :data:`tzname`), " +"the value is determined by the timezone rules in effect at module load time " +"or the last time :func:`tzset` is called and may be incorrect for times in " +"the past. It is recommended to use the :attr:`~struct_time.tm_gmtoff` " +"and :attr:`~struct_time.tm_zone` results from :func:`localtime` to obtain " +"timezone information." msgstr "" msgid "Module :mod:`datetime`" @@ -1183,8 +1191,8 @@ msgstr "" msgid "" "Internationalization services. The locale setting affects the " -"interpretation of many format specifiers in :func:`strftime` and :func:" -"`strptime`." +"interpretation of many format specifiers in :func:`strftime` " +"and :func:`strptime`." msgstr "" msgid "Module :mod:`calendar`" @@ -1205,7 +1213,7 @@ msgid "" "two-digit year (``%y`` rather than ``%Y``), but practice moved to 4-digit " "years long before the year 2000. After that, :rfc:`822` became obsolete and " "the 4-digit year has been first recommended by :rfc:`1123` and then mandated " -"by :rfc:`2822`." +"by :rfc:`2822`, with :rfc:`5322` continuing this requirement." msgstr "" msgid "epoch" diff --git a/library/timeit.po b/library/timeit.po index e7b5cdb1e3..3f32f62754 100644 --- a/library/timeit.po +++ b/library/timeit.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,7 +27,7 @@ msgid ":mod:`!timeit` --- Measure execution time of small code snippets" msgstr "" msgid "**Source code:** :source:`Lib/timeit.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/timeit.py`" msgid "" "This module provides a simple way to time small bits of Python code. It has " @@ -40,7 +38,7 @@ msgid "" msgstr "" msgid "Basic Examples" -msgstr "" +msgstr "Podstawowe przykłady" msgid "" "The following example shows how the :ref:`timeit-command-line-interface` can " @@ -81,8 +79,8 @@ msgstr "" msgid "" "Note however that :func:`.timeit` will automatically determine the number of " -"repetitions only when the command-line interface is used. In the :ref:" -"`timeit-examples` section you can find more advanced examples." +"repetitions only when the command-line interface is used. In " +"the :ref:`timeit-examples` section you can find more advanced examples." msgstr "" msgid "Python Interface" @@ -133,9 +131,9 @@ msgid "" msgstr "" msgid "" -"To measure the execution time of the first statement, use the :meth:`." -"timeit` method. The :meth:`.repeat` and :meth:`.autorange` methods are " -"convenience methods to call :meth:`.timeit` multiple times." +"To measure the execution time of the first statement, use " +"the :meth:`.timeit` method. The :meth:`.repeat` and :meth:`.autorange` " +"methods are convenience methods to call :meth:`.timeit` multiple times." msgstr "" msgid "" @@ -283,8 +281,8 @@ msgstr "" msgid "" ":func:`default_timer` measurements can be affected by other programs running " "on the same machine, so the best thing to do when accurate timing is " -"necessary is to repeat the timing a few times and use the best time. The :" -"option:`-r` option is good for this; the default of 5 repetitions is " +"necessary is to repeat the timing a few times and use the best time. " +"The :option:`-r` option is good for this; the default of 5 repetitions is " "probably enough in most cases. You can use :func:`time.process_time` to " "measure CPU time." msgstr "" @@ -308,8 +306,8 @@ msgid "" "$ python -m timeit -s \"text = 'sample string'; char = 'g'\" \"char in " "text\"\n" "5000000 loops, best of 5: 0.0877 usec per loop\n" -"$ python -m timeit -s \"text = 'sample string'; char = 'g'\" \"text." -"find(char)\"\n" +"$ python -m timeit -s \"text = 'sample string'; char = 'g'\" " +"\"text.find(char)\"\n" "1000000 loops, best of 5: 0.342 usec per loop" msgstr "" @@ -348,8 +346,9 @@ msgstr "" msgid "" "The following examples show how to time expressions that contain multiple " -"lines. Here we compare the cost of using :func:`hasattr` vs. :keyword:`try`/:" -"keyword:`except` to test for missing and present object attributes:" +"lines. Here we compare the cost of using :func:`hasattr` " +"vs. :keyword:`try`/:keyword:`except` to test for missing and present object " +"attributes:" msgstr "" msgid "" diff --git a/library/tk.po b/library/tk.po index 17bad3790c..393af84b2a 100644 --- a/library/tk.po +++ b/library/tk.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# rmaster1211 , 2023 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-11 14:19+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: rmaster1211 , 2023\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -23,22 +23,22 @@ 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 "Graphical User Interfaces with Tk" +msgid "Graphical user interfaces with Tk" msgstr "" msgid "" "Tk/Tcl has long been an integral part of Python. It provides a robust and " "platform independent windowing toolkit, that is available to Python " -"programmers using the :mod:`tkinter` package, and its extension, the :mod:" -"`tkinter.ttk` module." +"programmers using the :mod:`tkinter` package, and its extension, " +"the :mod:`tkinter.ttk` module." msgstr "" msgid "" "The :mod:`tkinter` package is a thin object-oriented layer on top of Tcl/Tk. " "To use :mod:`tkinter`, you don't need to write Tcl code, but you will need " -"to consult the Tk documentation, and occasionally the Tcl documentation. :" -"mod:`tkinter` is a set of wrappers that implement the Tk widgets as Python " -"classes." +"to consult the Tk documentation, and occasionally the Tcl " +"documentation. :mod:`tkinter` is a set of wrappers that implement the Tk " +"widgets as Python classes." msgstr "" msgid "" diff --git a/library/tkinter.colorchooser.po b/library/tkinter.colorchooser.po index dc9c532f1b..f09daf54bf 100644 --- a/library/tkinter.colorchooser.po +++ b/library/tkinter.colorchooser.po @@ -32,8 +32,8 @@ msgstr "" msgid "" "The :mod:`tkinter.colorchooser` module provides the :class:`Chooser` class " "as an interface to the native color picker dialog. ``Chooser`` implements a " -"modal color choosing dialog window. The ``Chooser`` class inherits from the :" -"class:`~tkinter.commondialog.Dialog` class." +"modal color choosing dialog window. The ``Chooser`` class inherits from " +"the :class:`~tkinter.commondialog.Dialog` class." msgstr "" msgid "" diff --git a/library/tkinter.dnd.po b/library/tkinter.dnd.po index c3777d4601..9453e3f824 100644 --- a/library/tkinter.dnd.po +++ b/library/tkinter.dnd.po @@ -1,19 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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:`!tkinter.dnd` --- Drag and drop support" msgstr "" msgid "**Source code:** :source:`Lib/tkinter/dnd.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/tkinter/dnd.py`" msgid "" "This is experimental and due to be deprecated when it is replaced with the " @@ -40,39 +40,40 @@ msgid "" "enable an object to be dragged, you must create an event binding for it that " "starts the drag-and-drop process. Typically, you bind a ButtonPress event to " "a callback function that you write (see :ref:`Bindings-and-Events`). The " -"function should call :func:`dnd_start`, where 'source' is the object to be " -"dragged, and 'event' is the event that invoked the call (the argument to " +"function should call :func:`dnd_start`, where *source* is the object to be " +"dragged, and *event* is the event that invoked the call (the argument to " "your callback function)." msgstr "" msgid "Selection of a target object occurs as follows:" msgstr "" -msgid "Top-down search of area under mouse for target widget" +msgid "Top-down search of the area under the mouse for a target widget:" msgstr "" -msgid "Target widget should have a callable *dnd_accept* attribute" +msgid "the target widget should have a callable *dnd_accept* attribute;" msgstr "" msgid "" -"If *dnd_accept* is not present or returns ``None``, search moves to parent " -"widget" +"if *dnd_accept* is not present or returns ``None``, the search moves to the " +"parent widget;" msgstr "" -msgid "If no target widget is found, then the target object is ``None``" +msgid "if no target widget is found, the target object is ``None``." msgstr "" -msgid "Call to *.dnd_leave(source, event)*" +msgid "Call to ``.dnd_leave(source, event)``." msgstr "" -msgid "Call to *.dnd_enter(source, event)*" +msgid "Call to ``.dnd_enter(source, event)``." msgstr "" -msgid "Call to *.dnd_commit(source, event)* to notify of drop" +msgid "Call to ``.dnd_commit(source, event)`` to notify of the drop." msgstr "" msgid "" -"Call to *.dnd_end(target, event)* to signal end of drag-and-drop" +"Call to ``.dnd_end(target, event)`` to signal the end of drag-and-" +"drop." msgstr "" msgid "" @@ -86,13 +87,16 @@ msgstr "" msgid "Execute end of drag-and-drop functions." msgstr "" -msgid "Inspect area below mouse for target objects while drag is performed." +msgid "Inspect area below mouse for target objects while a drag is performed." msgstr "" msgid "Signal end of drag when the release pattern is triggered." msgstr "" -msgid "Factory function for drag-and-drop process." +msgid "" +"Factory function for the drag-and-drop process. Return " +"the :class:`DndHandler` instance managing the drag, or ``None`` if a drag " +"could not be started." msgstr "" msgid ":ref:`Bindings-and-Events`" diff --git a/library/tkinter.po b/library/tkinter.po index 0dd08114a4..e46470449b 100644 --- a/library/tkinter.po +++ b/library/tkinter.po @@ -1,22 +1,20 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, 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 -# Stan Ulbrych, 2025 +# python-doc bot, 2026 +# Maciej Olko, 2026 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-10-19 21:31+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: Maciej Olko, 2026\n" "Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" @@ -30,7 +28,7 @@ msgid ":mod:`!tkinter` --- Python interface to Tcl/Tk" msgstr "" msgid "**Source code:** :source:`Lib/tkinter/__init__.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/tkinter/__init__.py`" msgid "" "The :mod:`tkinter` package (\"Tk interface\") is the standard Python " @@ -49,9 +47,12 @@ msgstr "" msgid "" "Tkinter supports a range of Tcl/Tk versions, built either with or without " -"thread support. The official Python binary release bundles Tcl/Tk 8.6 " -"threaded. See the source code for the :mod:`_tkinter` module for more " -"information about supported versions." +"thread support. Tcl/Tk 8.5.12 is the minimum supported version; the official " +"Python binary release bundles Tcl/Tk 8.6. See the source code for " +"the :mod:`_tkinter` module for more information about supported versions." +msgstr "" + +msgid "Support for Tcl/Tk versions older than 8.5.12 was removed." msgstr "" msgid "" @@ -63,9 +64,9 @@ msgstr "" msgid "" "Tcl/Tk 8.5 (2007) introduced a modern set of themed user interface " -"components along with a new API to use them. Both old and new APIs are still " -"available. Most documentation you will find online still uses the old API " -"and can be woefully outdated." +"components along with a new API to use them (see :mod:`tkinter.ttk`). Both " +"old and new APIs are still available. Most documentation you will find " +"online still uses the old API and can be woefully outdated." msgstr "" msgid "`TkDocs `_" @@ -88,7 +89,7 @@ msgstr "" msgid "Tcl/Tk Resources:" msgstr "" -msgid "`Tk commands `_" +msgid "`Tk commands `_" msgstr "" msgid "" @@ -167,10 +168,11 @@ msgstr "" msgid "" "Tk is a `Tcl package `_ implemented in C " -"that adds custom commands to create and manipulate GUI widgets. Each :class:" -"`Tk` object embeds its own Tcl interpreter instance with Tk loaded into it. " -"Tk's widgets are very customizable, though at the cost of a dated " -"appearance. Tk uses Tcl's event queue to generate and process GUI events." +"that adds custom commands to create and manipulate GUI widgets. " +"Each :class:`Tk` object embeds its own Tcl interpreter instance with Tk " +"loaded into it. Tk's widgets are very customizable, though at the cost of a " +"dated appearance. Tk uses Tcl's event queue to generate and process GUI " +"events." msgstr "" msgid "Ttk" @@ -184,20 +186,20 @@ msgid "" msgstr "" msgid "" -"Internally, Tk and Ttk use facilities of the underlying operating system, i." -"e., Xlib on Unix/X11, Cocoa on macOS, GDI on Windows." +"Internally, Tk and Ttk use facilities of the underlying operating system, " +"that is, Xlib on Unix/X11, Cocoa on macOS, GDI on Windows." msgstr "" msgid "" -"When your Python application uses a class in Tkinter, e.g., to create a " -"widget, the :mod:`tkinter` module first assembles a Tcl/Tk command string. " -"It passes that Tcl command string to an internal :mod:`_tkinter` binary " -"module, which then calls the Tcl interpreter to evaluate it. The Tcl " +"When your Python application uses a class in Tkinter, for example, to create " +"a widget, the :mod:`!tkinter` module first assembles a Tcl/Tk command " +"string. It passes that Tcl command string to an internal :mod:`_tkinter` " +"binary module, which then calls the Tcl interpreter to evaluate it. The Tcl " "interpreter will then call into the Tk and/or Ttk packages, which will in " "turn make calls to Xlib, Cocoa, or GDI." msgstr "" -msgid "Tkinter Modules" +msgid "Tkinter modules" msgstr "" msgid "" @@ -211,112 +213,6 @@ msgid "" "from tkinter import ttk" msgstr "" -msgid "" -"Construct a toplevel Tk widget, which is usually the main window of an " -"application, and initialize a Tcl interpreter for this widget. Each " -"instance has its own associated Tcl interpreter." -msgstr "" - -msgid "" -"The :class:`Tk` class is typically instantiated using all default values. " -"However, the following keyword arguments are currently recognized:" -msgstr "" - -msgid "*screenName*" -msgstr "" - -msgid "" -"When given (as a string), sets the :envvar:`DISPLAY` environment variable. " -"(X11 only)" -msgstr "" - -msgid "*baseName*" -msgstr "" - -msgid "" -"Name of the profile file. By default, *baseName* is derived from the " -"program name (``sys.argv[0]``)." -msgstr "" - -msgid "*className*" -msgstr "" - -msgid "" -"Name of the widget class. Used as a profile file and also as the name with " -"which Tcl is invoked (*argv0* in *interp*)." -msgstr "" - -msgid "*useTk*" -msgstr "" - -msgid "" -"If ``True``, initialize the Tk subsystem. The :func:`tkinter.Tcl() ` " -"function sets this to ``False``." -msgstr "" - -msgid "*sync*" -msgstr "" - -msgid "" -"If ``True``, execute all X server commands synchronously, so that errors are " -"reported immediately. Can be used for debugging. (X11 only)" -msgstr "" - -msgid "*use*" -msgstr "" - -msgid "" -"Specifies the *id* of the window in which to embed the application, instead " -"of it being created as an independent toplevel window. *id* must be " -"specified in the same way as the value for the -use option for toplevel " -"widgets (that is, it has a form like that returned by :meth:`winfo_id`)." -msgstr "" - -msgid "" -"Note that on some platforms this will only work correctly if *id* refers to " -"a Tk frame or toplevel that has its -container option enabled." -msgstr "" - -msgid "" -":class:`Tk` reads and interprets profile files, named :file:`.{className}." -"tcl` and :file:`.{baseName}.tcl`, into the Tcl interpreter and calls :func:" -"`exec` on the contents of :file:`.{className}.py` and :file:`.{baseName}." -"py`. The path for the profile files is the :envvar:`HOME` environment " -"variable or, if that isn't defined, then :data:`os.curdir`." -msgstr "" - -msgid "" -"The Tk application object created by instantiating :class:`Tk`. This " -"provides access to the Tcl interpreter. Each widget that is attached the " -"same instance of :class:`Tk` has the same value for its :attr:`tk` attribute." -msgstr "" - -msgid "" -"The widget object that contains this widget. For :class:`Tk`, the *master* " -"is :const:`None` because it is the main window. The terms *master* and " -"*parent* are similar and sometimes used interchangeably as argument names; " -"however, calling :meth:`winfo_parent` returns a string of the widget name " -"whereas :attr:`master` returns the object. *parent*/*child* reflects the " -"tree-like relationship while *master*/*slave* reflects the container " -"structure." -msgstr "" - -msgid "" -"The immediate descendants of this widget as a :class:`dict` with the child " -"widget names as the keys and the child instance objects as the values." -msgstr "" - -msgid "" -"The :func:`Tcl` function is a factory function which creates an object much " -"like that created by the :class:`Tk` class, except that it does not " -"initialize the Tk subsystem. This is most often useful when driving the Tcl " -"interpreter in an environment where one doesn't want to create extraneous " -"toplevel windows, or where one cannot (such as Unix/Linux systems without an " -"X server). An object created by the :func:`Tcl` object can have a Toplevel " -"window created (and the Tk subsystem initialized) by calling its :meth:" -"`loadtk` method." -msgstr "" - msgid "The modules that provide Tk support include:" msgstr "" @@ -394,17 +290,17 @@ msgid ":mod:`idlelib`" msgstr ":mod:`idlelib`" msgid "" -"Python's Integrated Development and Learning Environment (IDLE). Based on :" -"mod:`tkinter`." +"Python's Integrated Development and Learning Environment (IDLE). Based " +"on :mod:`tkinter`." msgstr "" -msgid ":mod:`tkinter.constants`" -msgstr ":mod:`tkinter.constants`" +msgid ":mod:`!tkinter.constants`" +msgstr "" msgid "" "Symbolic constants that can be used in place of strings when passing various " -"parameters to Tkinter calls. Automatically imported by the main :mod:" -"`tkinter` module." +"parameters to Tkinter calls. Automatically imported by the " +"main :mod:`tkinter` module." msgstr "" msgid ":mod:`tkinter.dnd`" @@ -421,7 +317,7 @@ msgstr ":mod:`turtle`" msgid "Turtle graphics in a Tk window." msgstr "" -msgid "Tkinter Life Preserver" +msgid "Tkinter life preserver" msgstr "" msgid "" @@ -439,7 +335,7 @@ msgid "" "reference manual." msgstr "" -msgid "A Hello World Program" +msgid "A Hello World program" msgstr "" msgid "" @@ -473,14 +369,15 @@ msgid "" msgstr "" msgid "" -"The next line creates a label widget holding a static text string. The :meth:" -"`grid` method is used to specify the relative layout (position) of the label " -"within its containing frame widget, similar to how tables in HTML work." +"The next line creates a label widget holding a static text string. " +"The :meth:`~Grid.grid` method is used to specify the relative layout " +"(position) of the label within its containing frame widget, similar to how " +"tables in HTML work." msgstr "" msgid "" "A button widget is then created, and placed to the right of the label. When " -"pressed, it will call the :meth:`destroy` method of the root window." +"pressed, it will call the :meth:`~Misc.destroy` method of the root window." msgstr "" msgid "" @@ -488,7 +385,7 @@ msgid "" "responds to user input until the program terminates." msgstr "" -msgid "Important Tk Concepts" +msgid "Important Tk concepts" msgstr "" msgid "Even this simple program illustrates the following key Tk concepts:" @@ -499,8 +396,8 @@ msgstr "" msgid "" "A Tkinter user interface is made up of individual *widgets*. Each widget is " -"represented as a Python object, instantiated from classes like :class:`ttk." -"Frame`, :class:`ttk.Label`, and :class:`ttk.Button`." +"represented as a Python object, instantiated from classes " +"like :class:`ttk.Frame`, :class:`ttk.Label`, and :class:`ttk.Button`." msgstr "" msgid "widget hierarchy" @@ -540,7 +437,7 @@ msgid "" "isn't running the event loop, your user interface won't update." msgstr "" -msgid "Understanding How Tkinter Wraps Tcl/Tk" +msgid "Understanding how Tkinter wraps Tcl/Tk" msgstr "" msgid "" @@ -566,8 +463,8 @@ msgid "" "ttk::frame .frm -padding 10\n" "grid .frm\n" "grid [ttk::label .frm.lbl -text \"Hello World!\"] -column 0 -row 0\n" -"grid [ttk::button .frm.btn -text \"Quit\" -command \"destroy .\"] -column 1 -" -"row 0" +"grid [ttk::button .frm.btn -text \"Quit\" -command \"destroy .\"] -column 1 " +"-row 0" msgstr "" msgid "" @@ -603,8 +500,8 @@ msgid "" "Operations which are implemented as separate *commands* in Tcl (like " "``grid`` or ``destroy``) are represented as *methods* on Tkinter widget " "objects. As you'll see shortly, at other times Tcl uses what appear to be " -"method calls on widget objects, which more closely mirror what would is used " -"in Tkinter." +"method calls on widget objects, which more closely mirror what is used in " +"Tkinter." msgstr "" msgid "How do I...? What option does...?" @@ -632,9 +529,9 @@ msgstr "" msgid "" "To find out what configuration options are available on any widget, call " -"its :meth:`configure` method, which returns a dictionary containing a " +"its :meth:`~Misc.configure` method, which returns a dictionary containing a " "variety of information about each object, including its default and current " -"values. Use :meth:`keys` to get just the names of each option." +"values. Use :meth:`~Misc.keys` to get just the names of each option." msgstr "" msgid "" @@ -664,12 +561,12 @@ msgid "" "print(set(dir(btn)) - set(dir(frm)))" msgstr "" -msgid "Navigating the Tcl/Tk Reference Manual" +msgid "Navigating the Tcl/Tk reference manual" msgstr "" msgid "" -"As noted, the official `Tk commands `_ reference manual (man pages) is often the most accurate " +"As noted, the official `Tk commands `_ reference manual (man pages) is often the most accurate " "description of what specific operations on widgets do. Even when you know " "the name of the option or method that you need, you may still have a few " "places to look." @@ -679,7 +576,7 @@ msgid "" "While all operations in Tkinter are implemented as method calls on widget " "objects, you've seen that many Tcl/Tk operations appear as commands that " "take a widget pathname as its first parameter, followed by optional " -"parameters, e.g." +"parameters, for example" msgstr "" msgid "" @@ -701,33 +598,34 @@ msgstr "" msgid "" "In the official Tcl/Tk reference documentation, you'll find most operations " -"that look like method calls on the man page for a specific widget (e.g., " -"you'll find the :meth:`invoke` method on the `ttk::button `_ man page), while functions that take a " -"widget as a parameter often have their own man page (e.g., `grid `_)." +"that look like method calls on the man page for a specific widget (for " +"example, you'll find the :meth:`~tkinter.ttk.Button.invoke` method on the " +"`ttk::button `_ " +"man page), while functions that take a widget as a parameter often have " +"their own man page (for example, `grid `_)." msgstr "" msgid "" -"You'll find many common options and methods in the `options `_ or `ttk::widget `_ man pages, while others are found in the man " -"page for a specific widget class." +"You'll find many common options and methods in the `options `_ or `ttk::widget `_ man pages, while others are " +"found in the man page for a specific widget class." msgstr "" msgid "" -"You'll also find that many Tkinter methods have compound names, e.g., :func:" -"`winfo_x`, :func:`winfo_height`, :func:`winfo_viewable`. You'd find " -"documentation for all of these in the `winfo `_ man page." +"You'll also find that many Tkinter methods have compound names, for " +"example, :meth:`~Misc.winfo_x`, :meth:`~Misc.winfo_height`, :meth:`~Misc.winfo_viewable`. " +"You'd find documentation for all of these in the `winfo `_ man page." msgstr "" msgid "" "Somewhat confusingly, there are also methods on all Tkinter widgets that " "don't actually operate on the widget, but operate at a global scope, " "independent of any widget. Examples are methods for accessing the clipboard " -"or the system bell. (They happen to be implemented as methods in the base :" -"class:`Widget` class that all Tkinter widgets inherit from)." +"or the system bell. (They happen to be implemented as methods in the " +"base :class:`Widget` class that all Tkinter widgets inherit from)." msgstr "" msgid "Threading model" @@ -757,14 +655,14 @@ msgstr "" msgid "" "Tcl/Tk applications are normally event-driven, meaning that after " -"initialization, the interpreter runs an event loop (i.e. :func:`Tk." -"mainloop`) and responds to events. Because it is single-threaded, event " -"handlers must respond quickly, otherwise they will block other events from " -"being processed. To avoid this, any long-running computations should not run " -"in an event handler, but are either broken into smaller pieces using timers, " -"or run in another thread. This is different from many GUI toolkits where the " -"GUI runs in a completely separate thread from all application code including " -"event handlers." +"initialization, the interpreter runs an event loop (that " +"is, :meth:`Tk.mainloop `) and responds to events. Because it " +"is single-threaded, event handlers must respond quickly, otherwise they will " +"block other events from being processed. To avoid this, any long-running " +"computations should not run in an event handler, but are either broken into " +"smaller pieces using timers, or run in another thread. This is different " +"from many GUI toolkits where the GUI runs in a completely separate thread " +"from all application code including event handlers." msgstr "" msgid "" @@ -777,16 +675,18 @@ msgid "A number of special cases exist:" msgstr "" msgid "" -"Tcl/Tk libraries can be built so they are not thread-aware. In this case, :" -"mod:`tkinter` calls the library from the originating Python thread, even if " -"this is different than the thread that created the Tcl interpreter. A global " -"lock ensures only one call occurs at a time." +"Tcl/Tk libraries built without thread support are now rare: the bundled Tcl/" +"Tk 8.6 is built with thread support, so this case only arises with some " +"older non-threaded builds. When the library is not thread-aware, :mod:`!" +"tkinter` calls the library from the originating Python thread, even if this " +"is different than the thread that created the Tcl interpreter. A global lock " +"ensures only one call occurs at a time." msgstr "" msgid "" -"While :mod:`tkinter` allows you to create more than one instance of a :class:" -"`Tk` object (with its own interpreter), all interpreters that are part of " -"the same thread share a common event queue, which gets ugly fast. In " +"While :mod:`tkinter` allows you to create more than one instance of " +"a :class:`Tk` object (with its own interpreter), all interpreters that are " +"part of the same thread share a common event queue, which gets ugly fast. In " "practice, don't create more than one instance of :class:`Tk` at a time. " "Otherwise, it's best to create them in separate threads and ensure you're " "running a thread-aware Tcl/Tk build." @@ -804,10 +704,10 @@ msgid "" "when called from the thread that created the Tcl interpreter." msgstr "" -msgid "Handy Reference" +msgid "Handy reference" msgstr "" -msgid "Setting Options" +msgid "Setting options" msgstr "" msgid "" @@ -837,6 +737,15 @@ msgstr "" msgid "fred.config(fg=\"red\", bg=\"blue\")" msgstr "" +msgid "" +"The ``fg`` and ``bg`` options used here, and other options that control a " +"widget's appearance, belong to the classic :mod:`!tkinter` widgets. The " +"themed :mod:`tkinter.ttk` widgets recommended in the introduction do not " +"accept them; style a themed widget through the :class:`ttk.Style " +"` class instead. The three ways of setting an option " +"shown above apply to both widget sets." +msgstr "" + msgid "" "For a complete explanation of a given option and its behavior, see the Tk " "man pages for the widget in question." @@ -846,8 +755,8 @@ msgid "" "Note that the man pages list \"STANDARD OPTIONS\" and \"WIDGET SPECIFIC " "OPTIONS\" for each widget. The former is a list of options that are common " "to many widgets, the latter are the options that are idiosyncratic to that " -"particular widget. The Standard Options are documented on the :manpage:" -"`options(3)` man page." +"particular widget. The Standard Options are documented on " +"the :manpage:`options(3)` man page." msgstr "" msgid "" @@ -859,22 +768,20 @@ msgstr "" msgid "" "The options supported by a given widget are listed in that widget's man " -"page, or can be queried at runtime by calling the :meth:`config` method " -"without arguments, or by calling the :meth:`keys` method on that widget. " -"The return value of these calls is a dictionary whose key is the name of the " -"option as a string (for example, ``'relief'``) and whose values are 5-tuples." +"page, or can be queried at runtime by calling the :meth:`~Misc.config` " +"method without arguments, or by calling the :meth:`~Misc.keys` method on " +"that widget. The return value of these calls is a dictionary whose key is " +"the name of the option as a string (for example, ``'relief'``) and whose " +"values are 5-tuples." msgstr "" msgid "" -"Some options, like ``bg`` are synonyms for common options with long names " -"(``bg`` is shorthand for \"background\"). Passing the ``config()`` method " -"the name of a shorthand option will return a 2-tuple, not 5-tuple. The 2-" -"tuple passed back will contain the name of the synonym and the \"real\" " -"option (such as ``('bg', 'background')``)." +"Some options, like ``bg``, are synonyms for common options with long names " +"(``bg`` is shorthand for \"background\")." msgstr "" msgid "Index" -msgstr "" +msgstr "Indeks" msgid "Meaning" msgstr "Znaczenie" @@ -939,122 +846,129 @@ msgid "" "their values. This is meant only as an example." msgstr "" -msgid "The Packer" +msgid "Geometry management" msgstr "" msgid "" -"The packer is one of Tk's geometry-management mechanisms. Geometry " -"managers are used to specify the relative positioning of widgets within " -"their container - their mutual *master*. In contrast to the more cumbersome " -"*placer* (which is used less commonly, and we do not cover here), the packer " -"takes qualitative relationship specification - *above*, *to the left of*, " -"*filling*, etc - and works everything out to determine the exact placement " -"coordinates for you." +"Creating a widget does not display it. A widget appears only after it has " +"been handed to a *geometry manager*, which works out its size and position " +"inside its container and keeps the layout up to date as the container is " +"resized or its content changes. Forgetting to call a geometry manager is a " +"common early mistake: the widget is created, but nothing shows up." msgstr "" msgid "" -"The size of any *master* widget is determined by the size of the \"slave " -"widgets\" inside. The packer is used to control where slave widgets appear " -"inside the master into which they are packed. You can pack widgets into " -"frames, and frames into other frames, in order to achieve the kind of layout " -"you desire. Additionally, the arrangement is dynamically adjusted to " -"accommodate incremental changes to the configuration, once it is packed." +"Tk provides three geometry managers. Each is inherited by every widget, so " +"any widget can be managed by any of them (but see the warning below about " +"the incompatibility of grid and pack). The choice depends on the kind of " +"layout you want." msgstr "" -msgid "" -"Note that widgets do not appear until they have had their geometry specified " -"with a geometry manager. It's a common early mistake to leave out the " -"geometry specification, and then be surprised when the widget is created but " -"nothing appears. A widget will appear only after it has had, for example, " -"the packer's :meth:`pack` method applied to it." +msgid ":meth:`grid `" msgstr "" msgid "" -"The pack() method can be called with keyword-option/value pairs that control " -"where the widget is to appear within its container, and how it is to behave " -"when the main application window is resized. Here are some examples::" +"Arranges widgets in a two-dimensional table of rows and columns. It is the " +"most flexible manager and the one to reach for by default: layouts that " +"would otherwise need several nested frames can often be expressed as a " +"single grid, and rows and columns can be told how to absorb extra space." msgstr "" msgid "" -"fred.pack() # defaults to side = \"top\"\n" -"fred.pack(side=\"left\")\n" -"fred.pack(expand=1)" +"ttk.Label(frm, text=\"Name:\").grid(column=0, row=0, sticky=\"w\")\n" +"ttk.Entry(frm).grid(column=1, row=0)\n" +"ttk.Button(frm, text=\"OK\").grid(column=1, row=1, sticky=\"e\")" msgstr "" -msgid "Packer Options" +msgid ":meth:`pack `" msgstr "" msgid "" -"For more extensive information on the packer and the options that it can " -"take, see the man pages and page 183 of John Ousterhout's book." -msgstr "" - -msgid "anchor" +"Stacks widgets against one side of their container -- ``\"top\"`` (the " +"default), ``\"bottom\"``, ``\"left\"`` or ``\"right\"`` -- and can make them " +"fill or expand into the space that is left. It is convenient for simple " +"arrangements, such as a single row or column of widgets or a content area " +"framed by a toolbar and a status bar." msgstr "" msgid "" -"Anchor type. Denotes where the packer is to place each slave in its parcel." -msgstr "" - -msgid "expand" -msgstr "" - -msgid "Boolean, ``0`` or ``1``." -msgstr "" - -msgid "fill" +"toolbar.pack(side=\"top\", fill=\"x\")\n" +"status.pack(side=\"bottom\", fill=\"x\")\n" +"body.pack(side=\"left\", expand=True, fill=\"both\")" msgstr "" -msgid "Legal values: ``'x'``, ``'y'``, ``'both'``, ``'none'``." +msgid ":meth:`place `" msgstr "" -msgid "ipadx and ipady" +msgid "" +"Positions each widget at an explicit spot, given either as absolute screen " +"distances or as a fraction of the container's size. It offers the most " +"control but the least automatic behavior, and is used the least; it suits " +"special cases such as overlapping widgets or precise custom layouts." msgstr "" msgid "" -"A distance - designating internal padding on each side of the slave widget." +"background.place(x=0, y=0, relwidth=1.0, relheight=1.0)\n" +"badge.place(relx=1.0, rely=0.0, anchor=\"ne\")" msgstr "" -msgid "padx and pady" +msgid "" +"Layouts are built up by nesting: grid or pack widgets, including frames, " +"inside a frame or toplevel. Toplevels are managed by the OS window manager. " +"Classic and themed :mod:`tkinter.ttk` widgets can be managed interchangeably." msgstr "" msgid "" -"A distance - designating external padding on each side of the slave widget." +"Do not apply :meth:`!pack` and :meth:`!grid` to two widgets that share the " +"same container. The two managers negotiate sizes in incompatible ways, and " +"the application can hang as they repeatedly resize the container against " +"each other. To combine them, keep each manager's widgets in a separate frame." msgstr "" -msgid "side" +msgid "" +"The full set of options accepted by each manager, with their values and " +"defaults, is documented " +"under :meth:`Grid.grid_configure`, :meth:`Pack.pack_configure` " +"and :meth:`Place.place_configure`; see also " +"the :manpage:`grid(3tk)`, :manpage:`pack(3tk)` and :manpage:`place(3tk)` man " +"pages." msgstr "" -msgid "Legal values are: ``'left'``, ``'right'``, ``'top'``, ``'bottom'``." +msgid "Coupling widget variables" msgstr "" -msgid "Coupling Widget Variables" +msgid "" +"Some widgets can tie their current value directly to a program variable, so " +"that the two stay in sync. Options such as ``variable``, ``textvariable``, " +"``value``, ``onvalue`` and ``offvalue`` set up this connection: when the " +"user changes the widget the variable is updated, and when the variable is " +"set the widget redraws to match." msgstr "" msgid "" -"The current-value setting of some widgets (like text entry widgets) can be " -"connected directly to application variables by using special options. These " -"options are ``variable``, ``textvariable``, ``onvalue``, ``offvalue``, and " -"``value``. This connection works both ways: if the variable changes for any " -"reason, the widget it's connected to will be updated to reflect the new " -"value." +"A widget can be linked only to a :class:`Variable` object, not to an " +"ordinary Python variable. This is not a limitation of :mod:`!tkinter` but a " +"consequence of how the two languages differ: the link relies on Tcl being " +"notified every time the value changes, and Python offers no way to react " +"when a plain variable is reassigned. A :class:`Variable` sidesteps this by " +"keeping its value inside the Tcl interpreter and exposing it through " +"explicit :meth:`~Variable.get` and :meth:`~Variable.set` methods." msgstr "" msgid "" -"Unfortunately, in the current implementation of :mod:`tkinter` it is not " -"possible to hand over an arbitrary Python variable to a widget through a " -"``variable`` or ``textvariable`` option. The only kinds of variables for " -"which this works are variables that are subclassed from a class called " -"Variable, defined in :mod:`tkinter`." +"Ready-made subclasses cover the common " +"types: :class:`StringVar`, :class:`IntVar`, :class:`DoubleVar` " +"and :class:`BooleanVar`. Pass one as a widget's ``textvariable`` (or " +"``variable``) option, then read and update it with :meth:`~Variable.get` " +"and :meth:`~Variable.set`; the widget tracks it with no further work on your " +"part." msgstr "" msgid "" -"There are many useful subclasses of Variable already defined: :class:" -"`StringVar`, :class:`IntVar`, :class:`DoubleVar`, and :class:`BooleanVar`. " -"To read the current value of such a variable, call the :meth:`get` method on " -"it, and to change its value you call the :meth:`!set` method. If you follow " -"this protocol, the widget will always track the value of the variable, with " -"no further intervention on your part." +"Keep a reference to the variable for as long as the widget uses it -- for " +"example by storing it as an attribute. A :class:`Variable` that is garbage " +"collected removes its underlying Tcl variable, breaking the connection to " +"the widget (see :class:`Variable`)." msgstr "" msgid "For example::" @@ -1062,83 +976,80 @@ msgstr "Dla przykładu::" msgid "" "import tkinter as tk\n" +"from tkinter import ttk\n" +"\n" +"root = tk.Tk()\n" "\n" -"class App(tk.Frame):\n" -" def __init__(self, master):\n" -" super().__init__(master)\n" -" self.pack()\n" +"# Create the application variable and give it an initial value.\n" +"contents = tk.StringVar(value=\"this is a variable\")\n" "\n" -" self.entrythingy = tk.Entry()\n" -" self.entrythingy.pack()\n" +"# Tell the entry widget to track the variable.\n" +"entry = ttk.Entry(root, textvariable=contents)\n" +"entry.pack()\n" "\n" -" # Create the application variable.\n" -" self.contents = tk.StringVar()\n" -" # Set it to some value.\n" -" self.contents.set(\"this is a variable\")\n" -" # Tell the entry widget to watch this variable.\n" -" self.entrythingy[\"textvariable\"] = self.contents\n" +"# Print the current value whenever the user presses Return.\n" +"def print_contents(event):\n" +" print(\"The current entry content is:\", contents.get())\n" "\n" -" # Define a callback for when the user hits return.\n" -" # It prints the current value of the variable.\n" -" self.entrythingy.bind('',\n" -" self.print_contents)\n" +"entry.bind(\"\", print_contents)\n" "\n" -" def print_contents(self, event):\n" -" print(\"Hi. The current entry content is:\",\n" -" self.contents.get())\n" +"# Setting the variable from the program updates the entry through the\n" +"# same link.\n" +"def clear():\n" +" contents.set(\"\")\n" "\n" -"root = tk.Tk()\n" -"myapp = App(root)\n" -"myapp.mainloop()" +"ttk.Button(root, text=\"Clear\", command=clear).pack()\n" +"\n" +"root.mainloop()" msgstr "" -msgid "The Window Manager" +msgid "The window manager" msgstr "" msgid "" -"In Tk, there is a utility command, ``wm``, for interacting with the window " -"manager. Options to the ``wm`` command allow you to control things like " -"titles, placement, icon bitmaps, and the like. In :mod:`tkinter`, these " -"commands have been implemented as methods on the :class:`Wm` class. " -"Toplevel widgets are subclassed from the :class:`Wm` class, and so can call " -"the :class:`Wm` methods directly." +"The *window manager* is the part of the desktop responsible for the title " +"bar, border and controls drawn around each top-level window, and for such " +"things as its title, position, size and icon. Tk gives access to these " +"through the :class:`Wm` mixin, which is inherited by the :class:`Tk` root " +"window and by every :class:`Toplevel`. You therefore call the window-manager " +"methods directly on a top-level window. Each has a short name and an " +"equivalent ``wm_``-prefixed name, for example :meth:`~Wm.title` " +"and :meth:`~Wm.wm_title`." msgstr "" msgid "" -"To get at the toplevel window that contains a given widget, you can often " -"just refer to the widget's master. Of course if the widget has been packed " -"inside of a frame, the master won't represent a toplevel window. To get at " -"the toplevel window that contains an arbitrary widget, you can call the :" -"meth:`_root` method. This method begins with an underscore to denote the " -"fact that this function is part of the implementation, and not an interface " -"to Tk functionality." -msgstr "" - -msgid "Here are some examples of typical usage::" +"These methods act on the top-level window whether its content is built from " +"the classic widgets or the themed :mod:`tkinter.ttk` widgets. To reach the " +"top-level window containing an arbitrary widget, call " +"its :meth:`~Misc.winfo_toplevel` method." msgstr "" msgid "" "import tkinter as tk\n" +"from tkinter import ttk\n" "\n" -"class App(tk.Frame):\n" -" def __init__(self, master=None):\n" -" super().__init__(master)\n" -" self.pack()\n" -"\n" -"# create the application\n" -"myapp = App()\n" +"root = tk.Tk()\n" +"root.title(\"My Application\")\n" +"root.geometry(\"640x480\")\n" +"root.minsize(320, 240)\n" "\n" -"#\n" -"# here are method calls to the window manager class\n" -"#\n" -"myapp.master.title(\"My Do-Nothing Application\")\n" -"myapp.master.maxsize(1000, 400)\n" +"ttk.Label(root, text=\"Hello\").pack(padx=20, pady=20)\n" "\n" -"# start the program\n" -"myapp.mainloop()" +"root.mainloop()" msgstr "" -msgid "Tk Option Data Types" +msgid "See :class:`Wm` for the full set of window-manager methods." +msgstr "" + +msgid "Tk option data types" +msgstr "" + +msgid "" +"Many widget options documented in the reference accept values of a small " +"number of common types, described here." +msgstr "" + +msgid "anchor" msgstr "" msgid "" @@ -1151,10 +1062,11 @@ msgid "bitmap" msgstr "" msgid "" -"There are eight built-in, named bitmaps: ``'error'``, ``'gray25'``, " -"``'gray50'``, ``'hourglass'``, ``'info'``, ``'questhead'``, ``'question'``, " -"``'warning'``. To specify an X bitmap filename, give the full path to the " -"file, preceded with an ``@``, as in ``\"@/usr/contrib/bitmap/gumby.bit\"``." +"There are ten built-in, named bitmaps: ``'error'``, ``'gray12'``, " +"``'gray25'``, ``'gray50'``, ``'gray75'``, ``'hourglass'``, ``'info'``, " +"``'questhead'``, ``'question'``, ``'warning'``. To specify an X bitmap " +"filename, give the full path to the file, preceded with an ``@``, as in " +"``\"@/usr/contrib/bitmap/gumby.bit\"``." msgstr "" msgid "boolean" @@ -1183,17 +1095,23 @@ msgid "" "strings representing RGB values in 4 bit: ``\"#RGB\"``, 8 bit: " "``\"#RRGGBB\"``, 12 bit: ``\"#RRRGGGBBB\"``, or 16 bit: " "``\"#RRRRGGGGBBBB\"`` ranges, where R,G,B here represent any legal hex " -"digit. See page 160 of Ousterhout's book for details." +"digit. See the :manpage:`colors(3tk)` man page for the list of named colors." msgstr "" msgid "cursor" msgstr "" msgid "" -"The standard X cursor names from :file:`cursorfont.h` can be used, without " -"the ``XC_`` prefix. For example to get a hand cursor (:const:`XC_hand2`), " -"use the string ``\"hand2\"``. You can also specify a bitmap and mask file " -"of your own. See page 179 of Ousterhout's book." +"The name of the mouse cursor to display while the pointer is over the " +"widget. Tk provides a portable set of cursor names available on all " +"platforms (for example ``\"arrow\"``, ``\"watch\"``, ``\"cross\"``, or " +"``\"hand2\"``); the standard X cursor names from :file:`cursorfont.h` may " +"also be used, without the ``XC_`` prefix (so ``XC_hand2`` becomes " +"``\"hand2\"``). The full list of names, including the platform-specific " +"ones, is given in the :manpage:`cursors(3tk)` manual page. You can also " +"specify a bitmap and mask file of your own. On Windows a cursor file " +"(:file:`.cur` or :file:`.ani`) may be used directly, giving its path " +"preceded with an ``@``, as in ``\"@C:/cursors/bart.ani\"``." msgstr "" msgid "distance" @@ -1211,9 +1129,11 @@ msgid "font" msgstr "" msgid "" -"Tk uses a list font name format, such as ``{courier 10 bold}``. Font sizes " -"with positive numbers are measured in points; sizes with negative numbers " -"are measured in pixels." +"Tk uses a font description such as ``{courier 10 bold}``; in :mod:`!tkinter` " +"this is most naturally passed as a tuple of ``(family, size, *styles)`` (or " +"as the equivalent string ``\"Courier 10 bold\"``). Font sizes with positive " +"numbers are measured in points; sizes with negative numbers are measured in " +"pixels." msgstr "" msgid "geometry" @@ -1229,8 +1149,8 @@ msgid "justify" msgstr "" msgid "" -"Legal values are the strings: ``\"left\"``, ``\"center\"``, ``\"right\"``, " -"and ``\"fill\"``." +"Legal values are the strings: ``\"left\"``, ``\"center\"``, and " +"``\"right\"``." msgstr "" msgid "region" @@ -1247,8 +1167,8 @@ msgstr "" msgid "" "Determines what the border style of a widget will be. Legal values are: " -"``\"raised\"``, ``\"sunken\"``, ``\"flat\"``, ``\"groove\"``, and " -"``\"ridge\"``." +"``\"raised\"``, ``\"sunken\"``, ``\"flat\"``, ``\"groove\"``, ``\"ridge\"``, " +"and ``\"solid\"``." msgstr "" msgid "scrollcommand" @@ -1265,7 +1185,7 @@ msgstr "" msgid "Must be one of: ``\"none\"``, ``\"char\"``, or ``\"word\"``." msgstr "" -msgid "Bindings and Events" +msgid "Bindings and events" msgstr "" msgid "" @@ -1284,9 +1204,11 @@ msgid "sequence" msgstr "sekwencja" msgid "" -"is a string that denotes the target kind of event. (See the :manpage:" -"`bind(3tk)` man page, and page 201 of John Ousterhout's book, :title-" -"reference:`Tcl and the Tk Toolkit (2nd edition)`, for details)." +"is a string that denotes the target kind of event. Physical events use the " +"```` form (for example ``\"\"`` or " +"``\"\"``); application-defined virtual events use double " +"angle brackets, as in ``\"<>\"``. (See the :manpage:`bind(3tk)` man " +"page for details.)" msgstr "" msgid "func" @@ -1422,7 +1344,46 @@ msgstr "%Y" msgid "y_root" msgstr "" -msgid "The index Parameter" +msgid "%#" +msgstr "" + +msgid "serial" +msgstr "" + +msgid "%b" +msgstr "" + +msgid "num" +msgstr "" + +msgid "%d" +msgstr "" + +msgid "detail" +msgstr "" + +msgid "%D" +msgstr "" + +msgid "delta" +msgstr "" + +msgid "" +"The ``add`` parameter above only affects the bindings you make yourself. " +"Every widget also inherits *class bindings* that implement its standard " +"behavior -- for example a :class:`Text` widget binds :kbd:`Control-t` to " +"transpose two characters. These are described in the bindings section of the " +"widget's Tk man page (such as :manpage:`text(3tk)` or :manpage:`entry(3tk)`)." +msgstr "" + +msgid "" +"Class bindings are processed separately from your own, so binding an event " +"yourself does not replace the default; both run. To suppress an unwanted " +"default binding, bind the event on the widget and return the string " +"``\"break\"`` from your callback." +msgstr "" + +msgid "The index parameter" msgstr "" msgid "" @@ -1435,9 +1396,40 @@ msgid "Entry widget indexes (index, view index, etc.)" msgstr "" msgid "" -"Entry widgets have options that refer to character positions in the text " -"being displayed. You can use these :mod:`tkinter` functions to access these " -"special points in text widgets:" +"Entry widgets have methods and options that refer to character positions in " +"the text being displayed. Anytime an index is needed, you may pass in:" +msgstr "" + +msgid "" +"an integer which refers to the numeric position of a character, counted from " +"the beginning of the text, starting with 0;" +msgstr "" + +msgid "" +"the string ``\"anchor\"``, which refers to the anchor point of the " +"selection, set with the widget's selection methods;" +msgstr "" + +msgid "" +"the string ``\"end\"``, which refers to the position just after the last " +"character;" +msgstr "" + +msgid "" +"the string ``\"insert\"``, which refers to the character just after the " +"insertion cursor;" +msgstr "" + +msgid "" +"the strings ``\"sel.first\"`` and ``\"sel.last\"``, which refer to the first " +"character in the selection and the position just after the last (it is an " +"error to use these if there is no selection);" +msgstr "" + +msgid "" +"a string consisting of ``@`` followed by an integer, as in ``\"@6\"``, where " +"the integer is interpreted as an x pixel coordinate in the entry's " +"coordinate system, selecting the character spanning that point." msgstr "" msgid "Text widget indexes" @@ -1470,8 +1462,9 @@ msgid "the string ``\"last\"`` which refers to the last menu item;" msgstr "" msgid "" -"An integer preceded by ``@``, as in ``@6``, where the integer is interpreted " -"as a y pixel coordinate in the menu's coordinate system;" +"a string consisting of ``@`` followed by an integer, as in ``\"@6\"``, where " +"the integer is interpreted as a y pixel coordinate in the menu's coordinate " +"system;" msgstr "" msgid "" @@ -1511,17 +1504,17 @@ msgstr "" msgid "" "Added the :class:`!PhotoImage` method :meth:`!copy_replace` to copy a region " "from one image to other image, possibly with pixel zooming and/or " -"subsampling. Add *from_coords* parameter to :class:`!PhotoImage` methods :" -"meth:`!copy`, :meth:`!zoom` and :meth:`!subsample`. Add *zoom* and " +"subsampling. Add *from_coords* parameter to :class:`!PhotoImage` " +"methods :meth:`!copy`, :meth:`!zoom` and :meth:`!subsample`. Add *zoom* and " "*subsample* parameters to :class:`!PhotoImage` method :meth:`!copy`." msgstr "" msgid "" "The image object can then be used wherever an ``image`` option is supported " -"by some widget (e.g. labels, buttons, menus). In these cases, Tk will not " -"keep a reference to the image. When the last Python reference to the image " -"object is deleted, the image data is deleted as well, and Tk will display an " -"empty box wherever the image was used." +"by some widget (for example, labels, buttons, menus). In these cases, Tk " +"will not keep a reference to the image. When the last Python reference to " +"the image object is deleted, the image data is deleted as well, and Tk will " +"display an empty box wherever the image was used." msgstr "" msgid "" @@ -1529,58 +1522,5081 @@ msgid "" "such as BMP, JPEG, TIFF, and WebP, among others." msgstr "" -msgid "File Handlers" +msgid "Reference" +msgstr "Dokumentacja" + +msgid "" +"This section documents the classes, methods, functions and constants of " +"the :mod:`!tkinter` module. Most of them wrap Tcl/Tk commands; consult the " +"official Tcl/Tk manual pages for the full list of widget options and further " +"details." msgstr "" msgid "" -"Tk allows you to register and unregister a callback function which will be " -"called from the Tk mainloop when I/O is possible on a file descriptor. Only " -"one handler may be registered per file descriptor. Example code::" +"The exception raised when a call into the Tcl interpreter fails, for example " +"when a widget is given an unknown option or an invalid value." +msgstr "" + +msgid "Base and mixin classes" msgstr "" msgid "" -"import tkinter\n" -"widget = tkinter.Tk()\n" -"mask = tkinter.READABLE | tkinter.WRITABLE\n" -"widget.tk.createfilehandler(file, mask, callback)\n" -"...\n" -"widget.tk.deletefilehandler(file)" +"The :class:`!Misc` class is a mix-in inherited by :class:`Tk` and, " +"through :class:`BaseWidget`, by every widget. It provides the large set of " +"methods common to all Tk objects: querying window information, managing " +"event bindings and the event loop, controlling the keyboard focus and " +"pointer grabs, accessing the selection, clipboard and option database, and " +"assorted utility and introspection services. Because they are inherited, " +"these methods are available on every widget and on the :class:`Tk` " +"application object, and are documented here once rather than repeated for " +"each widget." msgstr "" -msgid "This feature is not available on Windows." +msgid "" +"Return the current value of the configuration option named *key* for this " +"widget, as a string. The expression ``widget[key]`` is equivalent and may be " +"used instead." msgstr "" msgid "" -"Since you don't know how many bytes are available for reading, you may not " -"want to use the :class:`~io.BufferedIOBase` or :class:`~io.TextIOBase` :meth:" -"`~io.BufferedIOBase.read` or :meth:`~io.IOBase.readline` methods, since " -"these will insist on reading a predefined number of bytes. For sockets, the :" -"meth:`~socket.socket.recv` or :meth:`~socket.socket.recvfrom` methods will " -"work fine; for other files, use raw reads or ``os.read(file.fileno(), " -"maxbytecount)``." +"Query or modify the configuration options of the widget. With no arguments, " +"return a dictionary mapping every available option name to a tuple " +"describing it (its name, X resource name, X resource class, default value " +"and current value). If a single option name is given as a string, return the " +"tuple for just that option. If one or more keyword arguments are given, or a " +"dictionary is passed as *cnf*, set each named option to the corresponding " +"value; the expression ``widget[key] = value`` sets a single option in the " +"same way." +msgstr "" + +msgid ":meth:`config` is an alias of :meth:`!configure`." +msgstr "" + +msgid "Return a list of the names of all configuration options of this widget." msgstr "" msgid "" -"Registers the file handler callback function *func*. The *file* argument may " -"either be an object with a :meth:`~io.IOBase.fileno` method (such as a file " -"or socket object), or an integer file descriptor. The *mask* argument is an " -"ORed combination of any of the three constants below. The callback is called " -"as follows::" +"Interpret the string *s* as a Tcl boolean and return the " +"corresponding :class:`bool`. Tcl accepts values such as ``'1'``, ``'0'``, " +"``'yes'``, ``'no'``, ``'true'`` and ``'false'``. Raise :exc:`ValueError` if " +"*s* is not a valid boolean." msgstr "" -msgid "callback(file, mask)" +msgid "" +"Interpret the string *s* as a Tcl floating-point number and return it as " +"a :class:`float`. Raise :exc:`ValueError` if *s* is not a valid number." msgstr "" -msgid "Unregisters a file handler." +msgid "" +"Interpret the string *s* as a Tcl integer and return it as an :class:`int`. " +"Raise :exc:`ValueError` if *s* is not a valid integer." msgstr "" -msgid "Constants used in the *mask* arguments." +msgid "Return the value of the Tcl global variable named *name*." msgstr "" -msgid "packing (widgets)" +msgid "Set the Tcl global variable named *name* to *value*." msgstr "" -msgid "window manager (widgets)" +msgid "" +"The :meth:`!getvar` and :meth:`!setvar` methods give direct access to Tcl " +"variables. In most code you will instead use a :class:`Variable` subclass " +"such as :class:`StringVar` or :class:`IntVar`, which wraps a Tcl variable " +"and converts its value to and from a Python type." +msgstr "" + +msgid "" +"Register the Python callable *func* as a Tcl command and return the name of " +"the new command as a string. Whenever Tcl invokes that command, *func* is " +"called; if *subst* is given, it is applied to the command's arguments first. " +"This is the mechanism used internally to turn Python callbacks into the " +"command names passed to Tk options such as *command*. Unless *needcleanup* " +"is false, the command is deleted automatically when the widget is destroyed." +msgstr "" + +msgid "The arguments passed to *func* are no longer converted to strings." +msgstr "" + +msgid "" +"Delete the Tcl command named *name*, such as one previously returned " +"by :meth:`register`." +msgstr "" + +msgid "Return the widget instance corresponding to the Tk pathname *name*." +msgstr "" + +msgid "" +"Send the Tcl command *cmd*, with the given *args*, to the Tcl interpreter " +"registered under the name *interp*, and return its result. This is not " +"available on all platforms." +msgstr "" + +msgid "" +"Destroy this widget and all of its descendant widgets, and delete the Tcl " +"commands associated with them." +msgstr "" + +msgid "" +"Raise this widget in the stacking order so that it is drawn on top of its " +"siblings. If *aboveThis* is given, the widget is moved to be just above it " +"in the stacking order instead." +msgstr "" + +msgid ":meth:`lift` is an alias of :meth:`!tkraise`." +msgstr "" + +msgid "" +"Lower this widget in the stacking order so that it is drawn beneath its " +"siblings. If *belowThis* is given, the widget is moved to be just below it " +"in the stacking order instead." +msgstr "" + +msgid "" +":meth:`tkraise`/:meth:`lift` and :meth:`lower` are overridden by " +"the :class:`Canvas` widget, where they restack canvas items instead." +msgstr "" + +msgid "" +"Return the names of all images that currently exist in the Tcl interpreter." +msgstr "" + +msgid "" +"This is overridden by the :class:`Text` widget, where :meth:`!image_names` " +"returns the names of its embedded images instead." +msgstr "" + +msgid "Return the available image types, such as ``'photo'`` and ``'bitmap'``." +msgstr "" + +msgid "" +"Set the anchor that controls where the grid is placed inside this container " +"when the container is larger than the grid and no row or column has a non-" +"zero weight. *anchor* is one of the usual anchor strings, such as ``'nw'`` " +"(the default) or ``'center'``. Called with no argument, this method has no " +"effect." +msgstr "" + +msgid ":meth:`anchor` is an alias of :meth:`!grid_anchor`." +msgstr "" + +msgid "" +"Return the bounding box, in pixels, of a region of the grid laid out in this " +"container, as a 4-tuple ``(xoffset, yoffset, width, height)``. With no " +"arguments the bounding box of the whole grid is returned. If *column* and " +"*row* are given, the box spans from the cell at row and column 0 to that " +"cell; if *col2* and *row2* are also given, it spans from the cell (*column*, " +"*row*) to the cell (*col2*, *row2*)." +msgstr "" + +msgid "" +":meth:`bbox` is an alias of :meth:`!grid_bbox`, except " +"on :class:`Canvas`, :class:`Listbox`, :class:`Spinbox`, :class:`Text`, :class:`ttk.Entry " +"` and :class:`ttk.Treeview `, which " +"provide their own :meth:`!bbox` method." +msgstr "" + +msgid "" +"Query or set the properties of the column (or columns) *index* of the grid " +"managed by this container. *index* may be a column number; when setting " +"options it may also be a list of column numbers, the string ``'all'`` to " +"affect every column, or a child widget whose occupied columns are affected. " +"The supported options are:" +msgstr "" + +msgid "*minsize*" +msgstr "" + +msgid "The column's minimum size, in pixels." +msgstr "" + +msgid "*weight*" +msgstr "" + +msgid "" +"An integer setting how much of any extra space is apportioned to the column. " +"A weight of ``0`` keeps the column at its requested size, and a column of " +"weight two grows twice as fast as a column of weight one." +msgstr "" + +msgid "*uniform*" +msgstr "" + +msgid "" +"The name of a uniform group. Columns sharing a non-empty group name are kept " +"in sizes that are strictly proportional to their weights." +msgstr "" + +msgid "*pad*" +msgstr "" + +msgid "" +"Extra space, in pixels, added to the largest widget in the column when " +"computing the column's size." +msgstr "" + +msgid "" +"With a single option name, return that option's value; with no options, " +"return a dictionary of all of them." +msgstr "" + +msgid ":meth:`columnconfigure` is an alias of :meth:`!grid_columnconfigure`." +msgstr "" + +msgid "" +"Query or set the properties of the row (or rows) *index* of the grid managed " +"by this container. *index* is interpreted as " +"for :meth:`grid_columnconfigure`, and the supported options (*minsize*, " +"*weight*, *uniform* and *pad*) are the same, applied to a row instead of a " +"column." +msgstr "" + +msgid ":meth:`rowconfigure` is an alias of :meth:`!grid_rowconfigure`." +msgstr "" + +msgid "" +"Return the ``(column, row)`` of the grid cell that contains the pixel at " +"position (*x*, *y*), given in pixels relative to this container. For " +"locations above or to the left of the grid, ``-1`` is returned for the " +"corresponding coordinate." +msgstr "" + +msgid "" +"Enable or disable geometry propagation for this container when it manages " +"its children with the grid geometry manager. When *flag* is true, the " +"container resizes itself to fit the requested sizes of its children; when it " +"is false, its size is left under your control. Called with no argument, " +"return the current setting as a boolean." +msgstr "" + +msgid "" +"Return the size of the grid managed by this container as a ``(columns, " +"rows)`` tuple." +msgstr "" + +msgid "" +":meth:`size` is an alias of :meth:`!grid_size`, except on " +"the :class:`Listbox` widget, which provides its own :meth:`!size` method." +msgstr "" + +msgid "" +"Return a list of the child widgets managed in this container's grid, most " +"recently managed first. If *row* or *column* is given, only the children in " +"that row or column are returned." +msgstr "" + +msgid "" +"Enable or disable geometry propagation for this container when it manages " +"its children with the pack geometry manager. When *flag* is true, the " +"container resizes itself to fit the requested sizes of its children; when it " +"is false, its size is left under your control. Called with no argument, " +"return the current setting as a boolean." +msgstr "" + +msgid ":meth:`propagate` is an alias of :meth:`!pack_propagate`." +msgstr "" + +msgid "" +"Return a list of the child widgets managed by this container with the pack " +"geometry manager, in packing order." +msgstr "" + +msgid ":meth:`slaves` is an alias of :meth:`!pack_slaves`." +msgstr "" + +msgid "" +"Return a list of the child widgets managed by this container with the place " +"geometry manager." +msgstr "" + +msgid "" +"The methods with the ``bind`` and ``unbind`` prefixes associate event " +"patterns with callbacks and remove those associations." +msgstr "" + +msgid "" +"Bind the event pattern *sequence* on this widget to the callable *func*." +msgstr "" + +msgid "" +"*sequence* is an event pattern, such as ``''`` (a mouse click) or " +"``''``, optionally a concatenation of several such patterns that " +"must occur shortly after one another. When the event occurs, *func* is " +"called with an :class:`Event` instance describing it as its only argument; " +"if *func* returns the string ``'break'``, no further bindings for the event " +"are invoked." +msgstr "" + +msgid "" +"If *add* is true, *func* is added to any functions already bound to " +"*sequence*; otherwise it replaces them. The binding applies only to this " +"widget." +msgstr "" + +msgid "" +":meth:`!bind` returns a string identifier (a *funcid*) that can later be " +"passed to :meth:`unbind` to remove the binding without leaking the " +"associated Tcl command." +msgstr "" + +msgid "" +"If *func* is omitted, return the binding currently associated with " +"*sequence*; if *sequence* is also omitted, return a list of all the " +"sequences for which bindings exist on this widget." +msgstr "" + +msgid "" +"Like :meth:`bind`, but bind *func* to the binding tag *className* rather " +"than to a single widget, so that the binding applies to every widget having " +"that tag. *className* is usually the name of a widget class, such as " +"``'Button'``, in which case the binding affects all widgets of that class. " +"The set of binding tags for a widget can be inspected and changed " +"with :meth:`bindtags`." +msgstr "" + +msgid "The remaining arguments and the return value are as for :meth:`bind`." +msgstr "" + +msgid "" +"Like :meth:`bind`, but bind *func* to the special binding tag ``'all'``, so " +"that the binding applies to every widget in the application." +msgstr "" + +msgid "Remove bindings for the event pattern *sequence* on this widget." +msgstr "" + +msgid "" +"If *funcid* is given, only the function identified by it (a value returned " +"from a previous call to :meth:`bind`) is removed, and its associated Tcl " +"command is deleted. Otherwise all bindings for *sequence* are destroyed, " +"leaving it unbound." +msgstr "" + +msgid "" +"If *funcid* is given, only that callback is unbound; other callbacks bound " +"to *sequence* are kept." +msgstr "" + +msgid "" +"Remove all bindings for the event pattern *sequence* from the binding tag " +"*className*. See :meth:`bind_class`." +msgstr "" + +msgid "" +"Remove all bindings for the event pattern *sequence* from the special " +"binding tag ``'all'``. See :meth:`bind_all`." +msgstr "" + +msgid "" +"If *tagList* is omitted, return a tuple of the binding tags associated with " +"this widget. When an event occurs in a widget, it is applied to each of the " +"widget's binding tags in order, and for each tag the most specific matching " +"binding is executed. By default a widget has four binding tags: its own " +"pathname, its widget class, the pathname of its nearest toplevel ancestor, " +"and ``'all'``, in that order." +msgstr "" + +msgid "" +"If *tagList* is given, it must be a sequence of strings; the widget's " +"binding tags are set to its elements, which determines the order in which " +"bindings are evaluated." +msgstr "" + +msgid "" +"The methods with the ``event_`` prefix define virtual events and generate " +"events programmatically." +msgstr "" + +msgid "" +"Associate the virtual event *virtual*, whose name has the form " +"``'<>'``, with each of the physical event patterns given by " +"*sequences*, so that the virtual event triggers whenever any of them occurs. " +"If *virtual* is already defined, the new sequences are added to its existing " +"ones." +msgstr "" + +msgid "" +"Remove each of *sequences* from those associated with the virtual event " +"*virtual*. Sequences that are not currently associated with *virtual* are " +"ignored. If no *sequences* are given, all physical event sequences are " +"removed, so that *virtual* no longer triggers." +msgstr "" + +msgid "" +"Generate the event *sequence* on this widget and arrange for it to be " +"processed just as if it had come from the window system. *sequence* must be " +"a single event pattern, such as ``''`` or ``'<>'``, not a " +"concatenation of several. Keyword arguments specify additional fields of the " +"event, for example *x* and *y* for the pointer position, or *when* to " +"control when the event is processed; refer to the Tk ``event`` manual page " +"for the full list." +msgstr "" + +msgid "" +"If *virtual* is omitted, return a tuple of all the virtual events that are " +"currently defined. If *virtual* is given, return a tuple of the physical " +"event sequences currently associated with it, or an empty tuple if it is not " +"defined." +msgstr "" + +msgid "" +"The methods with the ``after`` prefix schedule callbacks to run after a " +"delay or when the application is idle." +msgstr "" + +msgid "" +"Schedule the callable *func* to be called after *ms* milliseconds, with " +"*args* passed to it as positional arguments. Return an identifier that can " +"be passed to :meth:`after_cancel` to cancel the call." +msgstr "" + +msgid "" +"If *func* is omitted, sleep for *ms* milliseconds instead, processing no " +"events during that time, and return ``None``." +msgstr "" + +msgid "*func* can now be any callable object, not only a function." +msgstr "" + +msgid "" +"Cancel a callback previously scheduled with :meth:`after` " +"or :meth:`after_idle`. *id* must be an identifier returned by one of those " +"methods; passing a value that is not such an identifier " +"raises :exc:`ValueError`. If the callback has already run or been cancelled, " +"this has no effect." +msgstr "" + +msgid "" +"Passing ``None`` (or any false value) as *id* now raises :exc:`ValueError`." +msgstr "" + +msgid "" +"Schedule the callable *func* to be called, with *args* passed to it, when " +"the Tk main loop next becomes idle, that is, when it has no other events to " +"process. Return an identifier that can be passed to :meth:`after_cancel` to " +"cancel the call." +msgstr "" + +msgid "" +"If *id* is omitted, return a tuple of the identifiers of all callbacks " +"currently scheduled with :meth:`after` and :meth:`after_idle` for this " +"interpreter." +msgstr "" + +msgid "" +"If *id* is given, it must identify a callback that has not yet run or been " +"cancelled, and the return value is a tuple ``(script, type)``, where " +"*script* refers to the function to be called and *type* is either ``'idle'`` " +"or ``'timer'``. A :exc:`TclError` is raised if *id* does not exist." +msgstr "" + +msgid "" +"Enter the Tk event loop, which processes events until all windows are " +"destroyed. This is normally called once, on the root window, to run the " +"application." +msgstr "" + +msgid "Quit the Tcl interpreter, causing :meth:`mainloop` to return." +msgstr "" + +msgid "" +"Enter the event loop until all pending events, including idle callbacks, " +"have been processed. This brings the display up to date and handles any " +"events that are already queued, then returns." +msgstr "" + +msgid "" +"Enter the event loop until all pending idle callbacks have been called. This " +"updates the display of windows, for example after geometry changes, but does " +"not process events caused by the user." +msgstr "" + +msgid "" +"Wait until the Tcl variable *name* is modified, continuing to process events " +"in the meantime so that the application stays responsive. *name* is usually " +"a :class:`Variable` instance, such as an :class:`IntVar` " +"or :class:`StringVar`." +msgstr "" + +msgid ":meth:`waitvar` is an alias of :meth:`!wait_variable`." +msgstr "" + +msgid "" +"Wait until *window* is destroyed, continuing to process events in the " +"meantime. If *window* is omitted, this widget is used. This is typically " +"used to wait for the user to finish interacting with a dialog box." +msgstr "" + +msgid "" +"Wait until the visibility state of *window* changes, for example when it " +"first appears on the screen, continuing to process events in the meantime. " +"If *window* is omitted, this widget is used. This is typically used to wait " +"for a newly created window to become visible before acting on it." +msgstr "" + +msgid "The methods with the ``focus_`` prefix manage the keyboard focus." +msgstr "" + +msgid "" +"Direct the keyboard input focus for this widget's display to this widget. If " +"the application does not currently have the input focus on this widget's " +"display, the widget is remembered as the focus window for its top level, and " +"the focus will be redirected to it the next time the window manager gives " +"the focus to the top level. :meth:`focus` is an alias of :meth:`!focus_set`, " +"except on the :class:`Canvas` and :class:`ttk.Treeview " +"` widgets, which provide their own :meth:`!focus` " +"method." +msgstr "" + +msgid "" +"Direct the keyboard input focus to this widget even if the application does " +"not currently have the input focus for the widget's display. This method " +"should be used sparingly, if at all; normally an application should wait for " +"the window manager to give it the focus rather than claiming it." +msgstr "" + +msgid "" +"Return the widget that currently has the keyboard focus in the application, " +"or ``None`` if no widget in the application has the focus. " +"Use :meth:`focus_displayof` to work correctly with several displays." +msgstr "" + +msgid "" +"Return the widget that currently has the keyboard focus on the display where " +"this widget is located, or ``None`` if no widget in the application has the " +"focus on that display." +msgstr "" + +msgid "" +"Return the most recent widget to have had the keyboard focus among all the " +"widgets in the same top level as this widget; this is the widget that will " +"receive the focus the next time the window manager gives the focus to the " +"top level. If no widget in that top level has ever had the focus, or if the " +"most recent focus widget has been deleted, the top level itself is returned." +msgstr "" + +msgid "" +"Reconfigure Tk to use an implicit focus model in which the focus is set to a " +"widget whenever the mouse pointer enters it. This cannot easily be disabled " +"once enabled." +msgstr "" + +msgid "" +"Return the next widget after this one in the keyboard traversal order, or " +"``None`` if there is none. The traversal order goes first to the next child, " +"then recursively to the children of that child, and then to the next sibling " +"higher in the stacking order. A widget is skipped if its ``takefocus`` " +"option is set to ``0``. This method is used in the default bindings for " +"the :kbd:`Tab` key." +msgstr "" + +msgid "" +"Return the previous widget before this one in the keyboard traversal order, " +"or ``None`` if there is none. See :meth:`tk_focusNext` for how the order is " +"defined. This method is used in the default bindings for the :kbd:`Shift-" +"Tab` key." +msgstr "" + +msgid "" +"The methods with the ``grab_`` prefix set and query the input grab, which " +"directs all input events to a single widget." +msgstr "" + +msgid "" +"Set a local grab on this widget. A grab confines pointer events to this " +"widget and its descendants: while the pointer is outside the widget's " +"subtree, button presses and releases and pointer motion are reported to the " +"grab widget, and windows outside the subtree become insensitive until the " +"grab is released. A local grab affects only the grabbing application. Any " +"grab previously set by this application on the widget's display is " +"automatically released. Setting a grab is the usual way to make a dialog " +"modal: while the grab is in effect the user cannot interact with the other " +"windows of the application." +msgstr "" + +msgid "" +"Set a global grab on this widget. A global grab is like the local grab set " +"by :meth:`grab_set`, but it locks out all other applications on the screen, " +"so that only this widget's subtree is sensitive to pointer events, and it " +"also grabs the keyboard. Use with caution: it is easy to render a display " +"unusable with a global grab, since other applications stop receiving events " +"until it is released." +msgstr "" + +msgid "Release the grab on this widget if there is one; otherwise do nothing." +msgstr "" + +msgid "" +"Return the widget that currently holds the grab in this application for this " +"widget's display, or ``None`` if there is no such widget." +msgstr "" + +msgid "" +"Return ``None`` if no grab is currently set on this widget, ``\"local\"`` if " +"a local grab is set, or ``\"global\"`` if a global grab is set." +msgstr "" + +msgid "" +"The methods with the ``selection_`` prefix retrieve and manage the X " +"selection." +msgstr "" + +msgid "" +"Clear the X selection, so that no window owns it anymore. The selection to " +"clear is given by the keyword argument *selection*, an atom name such as " +"``'PRIMARY'`` or ``'CLIPBOARD'``; it defaults to ``PRIMARY``. The " +"*displayof* keyword argument names a widget that determines the display on " +"which to operate, and defaults to this widget." +msgstr "" + +msgid "" +"This is overridden by the :class:`Entry`, :class:`Listbox` " +"and :class:`Spinbox` widgets, where :meth:`!selection_clear` clears the " +"widget's own selection instead." +msgstr "" + +msgid "" +"Return the contents of the current X selection. The keyword argument " +"*selection* names the selection and defaults to ``PRIMARY``. The keyword " +"argument *type* specifies the form in which the data is to be returned (the " +"desired conversion target), an atom name such as ``'STRING'`` or " +"``'FILE_NAME'``; it defaults to ``STRING``, except on X11, where " +"``UTF8_STRING`` is tried first and ``STRING`` is used as a fallback. The " +"*displayof* keyword argument names a widget that determines the display from " +"which to retrieve the selection, and defaults to this widget." +msgstr "" + +msgid "" +"Register *command* as a handler to supply the X selection owned by this " +"widget when another application requests it. When the selection is " +"retrieved, *command* is called with two arguments, the starting character " +"offset and the maximum number of characters to return, and must return at " +"most that many characters of the selection starting at that offset; for very " +"long selections it is called repeatedly with increasing offsets. The keyword " +"argument *selection* names the selection (default ``PRIMARY``) and the " +"keyword argument *type* gives the form of the selection that the handler " +"supplies (such as ``'STRING'`` or ``'FILE_NAME'``, default ``STRING``)." +msgstr "" + +msgid "" +"Make this widget the owner of the X selection on its display. The previous " +"owner, if any, is notified that it has lost the selection. The keyword " +"argument *selection* names the selection and defaults to ``PRIMARY``." +msgstr "" + +msgid "" +"Return the widget in this application that owns the X selection on the " +"display containing this widget, or ``None`` if no widget in this application " +"owns the selection. The keyword argument *selection* names the selection and " +"defaults to ``PRIMARY``. The *displayof* keyword argument names a widget " +"that determines the display to query, and defaults to this widget." +msgstr "" + +msgid "The methods with the ``clipboard_`` prefix manage the clipboard." +msgstr "" + +msgid "" +"Append *string* to the Tk clipboard and claim ownership of the clipboard on " +"this widget's display. Before appending, the clipboard should be emptied " +"with :meth:`clipboard_clear`; all appends should be completed before " +"returning to the event loop so that the clipboard is updated atomically. The " +"keyword argument *type* specifies the form of the data, an atom name such as " +"``'STRING'`` or ``'FILE_NAME'`` (default ``STRING``), and the keyword " +"argument *format* specifies the representation used to transmit it (default " +"``STRING``). The *displayof* keyword argument names a widget that determines " +"the target display, and defaults to this widget. The contents can be " +"retrieved with :meth:`clipboard_get` or :meth:`selection_get`." +msgstr "" + +msgid "" +"Claim ownership of the clipboard on this widget's display and remove any " +"previous contents. The *displayof* keyword argument names a widget that " +"determines the target display, and defaults to this widget." +msgstr "" + +msgid "" +"Retrieve data from the clipboard on this widget's display. The keyword " +"argument *type* specifies the form in which the data is to be returned, an " +"atom name such as ``'STRING'`` or ``'FILE_NAME'``; it defaults to " +"``STRING``, except on X11, where ``UTF8_STRING`` is tried first and " +"``STRING`` is used as a fallback. The *displayof* keyword argument names a " +"widget that determines the display, and defaults to the root window of the " +"application. This is equivalent to ``selection_get(selection='CLIPBOARD')``." +msgstr "" + +msgid "" +"The methods with the ``option_`` prefix query and modify the Tk option " +"database." +msgstr "" + +msgid "" +"Add an option to the Tk option database that associates *value* with " +"*pattern*. *pattern* consists of names and/or classes separated by asterisks " +"or dots, in the usual X format. *priority* is an integer between 0 and 100, " +"or one of the symbolic names ``'widgetDefault'`` (20), ``'startupFile'`` " +"(40), ``'userDefault'`` (60), or ``'interactive'`` (80); it defaults to " +"``interactive``." +msgstr "" + +msgid "" +"Clear the Tk option database. Default options from the :envvar:`!" +"RESOURCE_MANAGER` property or the :file:`.Xdefaults` file are reloaded " +"automatically the next time an option is added to or removed from the " +"database." +msgstr "" + +msgid "" +"Return the value of the option matching this widget under *name* and " +"*className* from the Tk option database, or an empty string if there is no " +"matching entry. When several entries match, the one with the highest " +"priority is returned, and among entries of equal priority the most recently " +"added one." +msgstr "" + +msgid "" +"Read the file named *fileName*, which should have the standard format for an " +"X resource database such as :file:`.Xdefaults`, and add all the options it " +"specifies to the Tk option database. *priority* is interpreted as " +"for :meth:`option_add` and defaults to ``interactive``." +msgstr "" + +msgid "" +"Ring the bell on the display for this widget, using the display's current " +"bell-related settings, and reset the screen saver for the screen. If " +"*displayof* is given as a widget, the bell is rung on that widget's display " +"instead." +msgstr "" + +msgid "" +"Set a new color scheme for all Tk widget elements. Existing widgets are " +"updated and the option database is changed so that future widgets use the " +"new colors. A single color argument is taken as the normal background color, " +"from which a complete palette is computed. Alternatively, the arguments may " +"be given as keyword *name*/*value* pairs naming individual options in the " +"option database. The recognized option names are ``activeBackground``, " +"``activeForeground``, ``background``, ``disabledForeground``, " +"``foreground``, ``highlightBackground``, ``highlightColor``, " +"``insertBackground``, ``selectColor``, ``selectBackground``, " +"``selectForeground``, and ``troughColor``; reasonable defaults are computed " +"for any that are not specified." +msgstr "" + +msgid "" +"Restore the application's colors to the light brown (bisque) color scheme " +"used in Tk 3.6 and earlier versions. Provided for backward compatibility." +msgstr "" + +msgid "" +"Query or set whether Tk's look and feel should strictly adhere to Motif. A " +"true *boolean* value enables strict Motif compliance (for example, no color " +"change when the mouse passes over a slider). Return the resulting setting." +msgstr "" + +msgid "" +"The methods with the ``busy_`` prefix manage the busy state of a window, " +"which shows a busy cursor and ignores user input." +msgstr "" + +msgid "" +"Make this widget appear busy. A transparent window is placed in front of the " +"widget, so that it and all of its descendants in the widget hierarchy are " +"blocked from pointer events and display a busy cursor. " +"Normally :meth:`update` should be called immediately afterwards to ensure " +"that the hold operation is in effect before the application starts its " +"processing." +msgstr "" + +msgid "" +"The only supported configuration option is *cursor*, the cursor to be " +"displayed while the widget is busy; it may have any of the values accepted " +"by :meth:`!configure`." +msgstr "" + +msgid "" +":meth:`busy_hold`, :meth:`busy` and :meth:`tk_busy` are aliases of :meth:`!" +"tk_busy_hold`." +msgstr "" + +msgid "" +"Query or modify the configuration options of the busy window. The widget " +"must have been previously made busy by :meth:`tk_busy_hold`. With no " +"arguments, return a dictionary describing all of the available options; if " +"*cnf* is the name of an option, return a tuple describing that one option. " +"Otherwise set the given options to the given values. Options may have any of " +"the values accepted by :meth:`tk_busy_hold`." +msgstr "" + +msgid "" +"The option database is referenced through the widget name or class. For " +"example, if a :class:`Frame` widget named ``frame`` is to be made busy, the " +"busy cursor can be specified for it by either of the calls::" +msgstr "" + +msgid "" +"w.option_add('*frame.busyCursor', 'gumby')\n" +"w.option_add('*Frame.BusyCursor', 'gumby')" +msgstr "" + +msgid "" +":meth:`busy_configure`, :meth:`busy_config` and :meth:`tk_busy_config` are " +"aliases of :meth:`!tk_busy_configure`." +msgstr "" + +msgid "" +"Return the current value of the busy configuration *option*. The widget must " +"have been previously made busy by :meth:`tk_busy_hold`, and *option* may " +"have any of the values accepted by that method." +msgstr "" + +msgid ":meth:`busy_cget` is an alias of :meth:`!tk_busy_cget`." +msgstr "" + +msgid "" +"Make this widget no longer busy, releasing the resources (including the " +"transparent window) allocated when it was made busy. User events will again " +"be received by the widget. These resources are also released when the widget " +"is destroyed." +msgstr "" + +msgid ":meth:`busy_forget` is an alias of :meth:`!tk_busy_forget`." +msgstr "" + +msgid "Return ``True`` if the widget is currently busy, ``False`` otherwise." +msgstr "" + +msgid ":meth:`busy_status` is an alias of :meth:`!tk_busy_status`." +msgstr "" + +msgid "" +"Return a list of widgets that are currently busy. If *pattern* is given, " +"only busy widgets whose path names match the pattern are returned." +msgstr "" + +msgid ":meth:`busy_current` is an alias of :meth:`!tk_busy_current`." +msgstr "" + +msgid "" +"The methods with the ``winfo_`` prefix retrieve information about windows " +"managed by Tk." +msgstr "" + +msgid "" +"Return the integer identifier for the atom whose name is *name*, creating a " +"new atom if none exists. If *displayof* is given, the atom is looked up on " +"the display of that window; otherwise it is looked up on the display of the " +"application's main window." +msgstr "" + +msgid "" +"Return the textual name for the atom whose integer identifier is *id*. This " +"is the inverse of :meth:`winfo_atom`. If *displayof* is given, the " +"identifier is looked up on the display of that window; otherwise it is " +"looked up on the display of the application's main window." +msgstr "" + +msgid "Return the number of cells in the colormap for the widget." +msgstr "" + +msgid "" +"Return a list containing the widgets that are children of the widget, in " +"stacking order from lowest to highest. Toplevel windows are returned as " +"children of their logical parents." +msgstr "" + +msgid "Return the class name of the widget." +msgstr "" + +msgid "" +"Return ``True`` if the colormap for the widget is known to be full, " +"``False`` otherwise." +msgstr "" + +msgid "" +"Return the widget containing the point given by *rootX* and *rootY*, or " +"``None`` if no window in this application contains the point. The " +"coordinates are in screen units in the coordinate system of the root window. " +"If *displayof* is given, the coordinates refer to the screen containing that " +"window; otherwise they refer to the screen of the application's main window." +msgstr "" + +msgid "Return the depth of the widget, that is, the number of bits per pixel." +msgstr "" + +msgid "Return true if the widget exists, false otherwise." +msgstr "" + +msgid "" +"Return a floating-point value giving the number of pixels in the widget " +"corresponding to the screen distance *number* (for example, ``\"2.0c\"`` or " +"``\"1i\"``). The result may be fractional; for a rounded integer value " +"use :meth:`winfo_pixels`." +msgstr "" + +msgid "" +"Return the geometry of the widget, in the form ``widthxheight+x+y``. All " +"dimensions are in pixels. An offset can be negative; " +"see :meth:`~Wm.geometry`." +msgstr "" + +msgid "" +"Return the height of the widget in pixels. When a window is first created " +"its height is 1 pixel; it is eventually changed by a geometry manager. See " +"also :meth:`winfo_reqheight`." +msgstr "" + +msgid "" +"Return a low-level platform-specific identifier for the widget. On Unix this " +"is the X window identifier, and on Windows it is the window handle." +msgstr "" + +msgid "" +"Return a tuple of the names of all Tcl interpreters currently registered for " +"a particular display. If *displayof* is given, the return value refers to " +"the display of that window; otherwise it refers to the display of the " +"application's main window." +msgstr "" + +msgid "Return true if the widget is currently mapped, false otherwise." +msgstr "" + +msgid "" +"Return the name of the geometry manager currently responsible for the " +"widget, or an empty string if it is not managed by any geometry manager." +msgstr "" + +msgid "" +"Return the widget's name within its parent, as opposed to its full path name." +msgstr "" + +msgid "" +"Return the path name of the widget's parent, or an empty string if the " +"widget is the main window of the application." +msgstr "" + +msgid "" +"Return the path name of the window whose identifier is *id*. If *displayof* " +"is given, the identifier is looked up on the display of that window; " +"otherwise it is looked up on the display of the application's main window." +msgstr "" + +msgid "" +"Return the number of pixels in the widget corresponding to the screen " +"distance *number* (for example, ``\"2.0c\"`` or ``\"1i\"``). The result is " +"rounded to the nearest integer; for a fractional result " +"use :meth:`winfo_fpixels`." +msgstr "" + +msgid "" +"Return the pointer's *x* coordinate, in pixels, relative to the screen's " +"root window (or virtual root, if one is in use). Return ``-1`` if the " +"pointer is not on the same screen as the widget." +msgstr "" + +msgid "" +"Return the pointer's coordinates as an ``(x, y)`` tuple, in pixels, relative " +"to the screen's root window (or virtual root, if one is in use). Both " +"coordinates are ``-1`` if the pointer is not on the same screen as the " +"widget." +msgstr "" + +msgid "" +"Return the pointer's *y* coordinate, in pixels, relative to the screen's " +"root window (or virtual root, if one is in use). Return ``-1`` if the " +"pointer is not on the same screen as the widget." +msgstr "" + +msgid "" +"Return the widget's requested height in pixels. This is the value used by " +"the widget's geometry manager to compute its geometry." +msgstr "" + +msgid "" +"Return the widget's requested width in pixels. This is the value used by the " +"widget's geometry manager to compute its geometry." +msgstr "" + +msgid "" +"Return an ``(r, g, b)`` tuple of the red, green, and blue intensities, in " +"the range 0 to 65535, that correspond to *color* in the widget. *color* may " +"be specified in any of the forms acceptable for a color option." +msgstr "" + +msgid "" +"Return the *x* coordinate, in the root window of the screen, of the upper-" +"left corner of the widget's border (or of the widget itself if it has no " +"border)." +msgstr "" + +msgid "" +"Return the *y* coordinate, in the root window of the screen, of the upper-" +"left corner of the widget's border (or of the widget itself if it has no " +"border)." +msgstr "" + +msgid "" +"Return the name of the screen associated with the widget, in the form " +"``displayName.screenIndex``." +msgstr "" + +msgid "" +"Return the number of cells in the default colormap for the widget's screen." +msgstr "" + +msgid "" +"Return the depth of the root window of the widget's screen, that is, the " +"number of bits per pixel." +msgstr "" + +msgid "Return the height of the widget's screen in pixels." +msgstr "" + +msgid "Return the height of the widget's screen in millimeters." +msgstr "" + +msgid "Return the width of the widget's screen in millimeters." +msgstr "" + +msgid "" +"Return the default visual class for the widget's screen, one of " +"``\"directcolor\"``, ``\"grayscale\"``, ``\"pseudocolor\"``, " +"``\"staticcolor\"``, ``\"staticgray\"``, or ``\"truecolor\"``." +msgstr "" + +msgid "Return the width of the widget's screen in pixels." +msgstr "" + +msgid "" +"Return a string containing information about the server for the widget's " +"display. The exact format of this string may vary from platform to platform." +msgstr "" + +msgid "" +"Return the top-of-hierarchy window containing the widget. In standard Tk " +"this is always a :class:`Toplevel` widget." +msgstr "" + +msgid "" +"Return true if the widget and all of its ancestors up through the nearest " +"toplevel window are mapped, false otherwise." +msgstr "" + +msgid "" +"Return the visual class for the widget, one of ``\"directcolor\"``, " +"``\"grayscale\"``, ``\"pseudocolor\"``, ``\"staticcolor\"``, " +"``\"staticgray\"``, or ``\"truecolor\"``." +msgstr "" + +msgid "Return the X identifier for the visual for the widget." +msgstr "" + +msgid "" +"Return a list describing the visuals available for the widget's screen. Each " +"item consists of a visual class (see :meth:`winfo_visual`) followed by an " +"integer depth. If *includeids* is true, the X identifier for the visual is " +"also included." +msgstr "" + +msgid "" +"Return the height of the virtual root window associated with the widget if " +"there is one; otherwise return the height of the widget's screen." +msgstr "" + +msgid "" +"Return the width of the virtual root window associated with the widget if " +"there is one; otherwise return the width of the widget's screen." +msgstr "" + +msgid "" +"Return the *x* offset of the virtual root window associated with the widget, " +"relative to the root window of its screen. This is normally zero or " +"negative, and is ``0`` if there is no virtual root window." +msgstr "" + +msgid "" +"Return the *y* offset of the virtual root window associated with the widget, " +"relative to the root window of its screen. This is normally zero or " +"negative, and is ``0`` if there is no virtual root window." +msgstr "" + +msgid "" +"Return the width of the widget in pixels. When a window is first created its " +"width is 1 pixel; it is eventually changed by a geometry manager. See " +"also :meth:`winfo_reqwidth`." +msgstr "" + +msgid "" +"Return the *x* coordinate, in the widget's parent, of the upper-left corner " +"of the widget's border (or of the widget itself if it has no border)." +msgstr "" + +msgid "" +"Return the *y* coordinate, in the widget's parent, of the upper-left corner " +"of the widget's border (or of the widget itself if it has no border)." +msgstr "" + +msgid "" +"Return the Tcl/Tk patch level as a named tuple with the same five fields " +"as :data:`sys.version_info`: *major*, *minor*, *micro*, *releaselevel* and " +"*serial*. *releaselevel* is ``'alpha'``, ``'beta'`` or ``'final'``. " +"Converting it to a string gives the version in the usual Tcl/Tk notation, " +"for example ``'9.0.3'`` for a final release or ``'9.1b2'`` for a pre-release." +msgstr "" + +msgid "" +"The :class:`!Wm` mixin provides access to the window manager, allowing an " +"application to control such things as the title, geometry and icon of a top-" +"level window, the way it is resized, and how it responds to window manager " +"protocols. It is mixed into :class:`Tk` and :class:`Toplevel`, so its " +"methods are available on every top-level window. Each method has two " +"equivalent spellings: a short name and a ``wm_``-prefixed name (for " +"example, :meth:`title` and :meth:`wm_title`). See also :ref:`tkinter-window-" +"manager`." +msgstr "" + +msgid "" +"Constrain the aspect ratio (the ratio of width to height) of the window. If " +"all four arguments are given, the window manager keeps the ratio between " +"``minNumer/minDenom`` and ``maxNumer/maxDenom``; passing empty strings " +"removes any existing restriction. With no arguments, return a tuple of the " +"four current values, or ``None`` if no aspect restriction is in " +"effect. :meth:`wm_aspect` is an alias of :meth:`!aspect`." +msgstr "" + +msgid "" +"Query or set platform-specific attributes of the window. With no arguments, " +"return the platform-specific flags and their values; pass " +"*return_python_dict* as true to get them as a dictionary. A single option " +"name such as ``'alpha'`` returns the value of that option, and options are " +"set using keyword arguments (``alpha=0.5``)." +msgstr "" + +msgid "The available attributes differ by platform. All platforms support:" +msgstr "" + +msgid "*alpha*" +msgstr "" + +msgid "" +"The window's opacity, from ``0.0`` (fully transparent) to ``1.0`` (opaque). " +"Where transparency is unsupported the value stays at ``1.0``." +msgstr "" + +msgid "*appearance*" +msgstr "" + +msgid "" +"Whether the window is rendered in dark mode on Windows and macOS: " +"``'auto'``, ``'light'`` or ``'dark'`` (this has no effect on X11)." +msgstr "" + +msgid "*fullscreen*" +msgstr "" + +msgid "Whether the window takes up the entire screen and has no borders." +msgstr "" + +msgid "*topmost*" +msgstr "" + +msgid "Whether the window is displayed above all other windows." +msgstr "" + +msgid "Windows additionally supports:" +msgstr "" + +msgid "*disabled*" +msgstr "" + +msgid "Whether the window is in a disabled state." +msgstr "" + +msgid "*toolwindow*" +msgstr "" + +msgid "Whether the window uses the tool window style." +msgstr "" + +msgid "*transparentcolor*" +msgstr "" + +msgid "The color that is made fully transparent, or an empty string for none." +msgstr "" + +msgid "macOS additionally supports:" +msgstr "" + +msgid "*class*" +msgstr "" + +msgid "" +"Whether the underlying Aqua window is an ``nswindow`` or an ``nspanel``; " +"this can only be set before the window is created." +msgstr "" + +msgid "*modified*" +msgstr "" + +msgid "" +"The modification state shown by the window's close button and proxy icon." +msgstr "" + +msgid "*notify*" +msgstr "" + +msgid "Whether the application's dock icon bounces to request attention." +msgstr "" + +msgid "*stylemask*" +msgstr "" + +msgid "" +"The style mask of the underlying Aqua window, given as a list of bit names " +"such as ``titled`` or ``resizable``." +msgstr "" + +msgid "*tabbingid*" +msgstr "" + +msgid "The identifier of the tab group that the window belongs to." +msgstr "" + +msgid "*tabbingmode*" +msgstr "" + +msgid "" +"Whether the window may be opened as a tab: ``'auto'``, ``'preferred'`` or " +"``'disallowed'``." +msgstr "" + +msgid "*titlepath*" +msgstr "" + +msgid "The path of the file represented by the window's proxy icon." +msgstr "" + +msgid "*transparent*" +msgstr "" + +msgid "" +"Whether the content area is transparent and the window shadow is turned off." +msgstr "" + +msgid "X11 additionally supports:" +msgstr "" + +msgid "*type*" +msgstr "" + +msgid "" +"The window type, or a list of types in order of preference, that the window " +"manager should use to interpret the window, such as ``'dialog'`` or " +"``'splash'``." +msgstr "" + +msgid "*zoomed*" +msgstr "" + +msgid "Whether the window is maximized." +msgstr "" + +msgid "" +"Tk 8.6 added the *type* attribute, and Tk 9.0 added the *appearance*, " +"*class*, *stylemask*, *tabbingid* and *tabbingmode* attributes." +msgstr "" + +msgid "" +"On X11 changes are applied asynchronously, so a queried value may not yet " +"reflect the most recent request. :meth:`wm_attributes` is an alias " +"of :meth:`!attributes`." +msgstr "" + +msgid "" +"A single attribute may now be queried by name without the leading ``-``, and " +"attributes may be set using keyword arguments. The *return_python_dict* " +"parameter was added." +msgstr "" + +msgid "" +"Setting an attribute by passing the option name (with a leading ``-``) and " +"its value as two positional arguments, as in ``w.attributes('-alpha', " +"0.5)``, is deprecated; use keyword arguments instead." +msgstr "" + +msgid "" +"Store *name*, which should be the name of the host on which the application " +"is running, in the window's ``WM_CLIENT_MACHINE`` property for use by the " +"window or session manager. An empty string deletes the property. With no " +"argument, return the last name set, or an empty string. :meth:`wm_client` is " +"an alias of :meth:`!client`." +msgstr "" + +msgid "" +"Manipulate the ``WM_COLORMAP_WINDOWS`` property, which tells the window " +"manager about windows that have private colormaps. If *wlist* is given, " +"overwrite the property with those windows (their order is a priority order " +"for installing colormaps). With no arguments, return the list of windows " +"currently named in the property. :meth:`wm_colormapwindows` is an alias " +"of :meth:`!colormapwindows`." +msgstr "" + +msgid "" +"Store *value* in the window's ``WM_COMMAND`` property for use by the window " +"or session manager; it should be a list giving the words of the command used " +"to invoke the application. An empty string deletes the property. With no " +"argument, return the last value set, or an empty string. :meth:`wm_command` " +"is an alias of :meth:`!command`." +msgstr "" + +msgid "" +"Display the window in normal (non-iconified) form by mapping it. If the " +"window has never been mapped, this ensures it appears de-iconified when it " +"is first mapped. On Windows the window is also raised and given the " +"focus. :meth:`wm_deiconify` is an alias of :meth:`!deiconify`." +msgstr "" + +msgid "" +"Set or query the focus model for the window. *model* is either ``'active'`` " +"(the window claims the input focus for itself or its descendants, even when " +"the focus is in another application) or ``'passive'`` (the window relies on " +"the window manager to give it the focus). With no argument, return the " +"current model. The default is ``'passive'``, which is what the :meth:`!" +"focus` command assumes. :meth:`wm_focusmodel` is an alias of :meth:`!" +"focusmodel`." +msgstr "" + +msgid "" +"Unmap *window* from the screen so that it is no longer managed by the window " +"manager. A :class:`Toplevel` is then treated like a :class:`Frame`, although " +"its ``-menu`` configuration is remembered and the menu reappears if the " +"widget is managed again. :meth:`wm_forget` is an alias of :meth:`!forget`." +msgstr "" + +msgid "Not to be confused with :meth:`Pack.forget`." +msgstr "" + +msgid "" +"Return the platform-specific window identifier for the outermost decorative " +"frame containing the window, if the window manager has reparented it into " +"such a frame; otherwise return the identifier of the window " +"itself. :meth:`wm_frame` is an alias of :meth:`!frame`." +msgstr "" + +msgid "" +"Set or query the geometry of the window. *newGeometry* has the form " +"``=widthxheight+x+y``, where any of ``=``, ``widthxheight`` and the ``+x+y`` " +"position may be omitted. *width* and *height* are in pixels (or grid units " +"for a gridded window); a position preceded by ``+`` is measured from the " +"left or top edge of the screen and one preceded by ``-`` from the right or " +"bottom edge. An offset can be negative, as in ``'200x100+-9+-8'``, when the " +"window edge is positioned beyond the corresponding screen edge. An empty " +"string cancels any user-specified geometry, letting the window revert to its " +"natural size. With no argument, return the current geometry as a string of " +"the form ``'200x200+10+10'``. :meth:`wm_geometry` is an alias of :meth:`!" +"geometry`." +msgstr "" + +msgid "" +"Manage the window as a gridded window and define the relationship between " +"grid units and pixels. *baseWidth* and *baseHeight* are the numbers of grid " +"units for the window's internally requested size, and *widthInc* and " +"*heightInc* are the pixel sizes of a horizontal and vertical grid unit. " +"Empty strings turn off gridded management. With no arguments, return a tuple " +"of the four current values, or ``None`` if the window is not " +"gridded. :meth:`wm_grid` is an alias of :meth:`!grid`." +msgstr "" + +msgid "Not to be confused with the grid geometry manager :meth:`Grid.grid`." +msgstr "" + +msgid "" +"Set or query the leader of a group of related windows. *pathName* gives the " +"path name of the group leader; the window manager may, for example, unmap " +"all windows in the group when the leader is iconified. An empty string " +"removes the window from any group. With no argument, return the path name of " +"the current group leader, or an empty string. :meth:`wm_group` is an alias " +"of :meth:`!group`." +msgstr "" + +msgid "" +"Set or query the bitmap used by the window manager for the window's icon. " +"*bitmap* names a bitmap in one of the standard forms accepted by Tk; an " +"empty string cancels the current icon bitmap. With no argument, return the " +"name of the current icon bitmap, or an empty string. On Windows the " +"*default* argument names an icon (for example an ``.ico`` file) applied to " +"all top-level windows that have no icon of their own. :meth:`wm_iconbitmap` " +"is an alias of :meth:`!iconbitmap`." +msgstr "" + +msgid "" +"Iconify the window. If the window has not yet been mapped for the first " +"time, arrange for it to appear in the iconified state when it is eventually " +"mapped. :meth:`wm_iconify` is an alias of :meth:`!iconify`." +msgstr "" + +msgid "" +"Set or query the bitmap used as a mask for the icon " +"(see :meth:`iconbitmap`). Where the mask is zero no icon is displayed; where " +"it is one, the corresponding bits of the icon bitmap are shown. An empty " +"string cancels the current mask. With no argument, return the name of the " +"current icon mask, or an empty string. :meth:`wm_iconmask` is an alias " +"of :meth:`!iconmask`." +msgstr "" + +msgid "" +"Set or query the name displayed by the window manager inside the window's " +"icon. With no argument, return the current icon name, or an empty string if " +"none has been set (in which case the window manager normally displays the " +"window's title). :meth:`wm_iconname` is an alias of :meth:`!iconname`." +msgstr "" + +msgid "" +"Set the titlebar icon for the window from one or more :class:`PhotoImage` " +"objects given in *images*. Several images of different sizes (for example " +"16x16 and 32x32) may be supplied so that the window manager can choose an " +"appropriate one. The image data is taken as a snapshot at the time of the " +"call; later changes to the images are not reflected. If *default* is true, " +"the icon is also applied to all top-level windows created in the future. On " +"macOS only the first image is used. :meth:`wm_iconphoto` is an alias " +"of :meth:`!iconphoto`." +msgstr "" + +msgid "" +"Set or query a hint to the window manager about where the window's icon " +"should be positioned. Empty strings cancel an existing hint. With no " +"arguments, return a tuple of the two current values, or ``None`` if no hint " +"is in effect. :meth:`wm_iconposition` is an alias of :meth:`!iconposition`." +msgstr "" + +msgid "" +"Set or query the window used as the icon for the window. When the window is " +"iconified, *pathName* is mapped to serve as its icon and unmapped again when " +"it is de-iconified. An empty string cancels the association. With no " +"argument, return the path name of the current icon window, or an empty " +"string. Not all window managers support icon windows, and the concept is " +"meaningless on non-X11 platforms. :meth:`wm_iconwindow` is an alias " +"of :meth:`!iconwindow`." +msgstr "" + +msgid "" +"Make *widget* a stand-alone top-level window, decorated by the window " +"manager with a title bar and so on. Only :class:`Frame`, :class:`LabelFrame` " +"and :class:`Toplevel` widgets may be used (the :mod:`tkinter.ttk` versions " +"are **not** accepted); passing any other widget type raises an " +"error. :meth:`wm_manage` is an alias of :meth:`!manage`." +msgstr "" + +msgid "" +"Set or query the maximum permissible dimensions of the window, in pixels (or " +"grid units for a gridded window). The window manager restricts the window to " +"be no larger than *width* and *height*. With no arguments, return a tuple of " +"the current maximum width and height. The maximum size defaults to the size " +"of the screen. :meth:`wm_maxsize` is an alias of :meth:`!maxsize`." +msgstr "" + +msgid "" +"Set or query the minimum permissible dimensions of the window, in pixels (or " +"grid units for a gridded window). The window manager restricts the window to " +"be no smaller than *width* and *height*. With no arguments, return a tuple " +"of the current minimum width and height. The minimum size defaults to one " +"pixel in each dimension. :meth:`wm_minsize` is an alias of :meth:`!minsize`." +msgstr "" + +msgid "" +"Set or query the override-redirect flag for the window. When this flag is " +"set, the window is ignored by the window manager: it is not reparented into " +"a decorative frame and the user cannot manipulate it through the usual " +"window manager controls. With no argument, return a boolean indicating " +"whether the flag is set, or ``None`` if it has not been set. The flag is " +"reliably honored only when the window is first mapped or remapped from the " +"withdrawn state. :meth:`wm_overrideredirect` is an alias of :meth:`!" +"overrideredirect`." +msgstr "" + +msgid "" +"Set or query the source of the window's current position. *who* is either " +"``'program'`` or ``'user'`` and indicates whether the position was requested " +"by the program or by the user; an empty string cancels the current source. " +"With no argument, return the current source, or an empty string if none has " +"been set. Tk automatically sets the source to ``'user'`` " +"when :meth:`geometry` is called, unless it has been set explicitly to " +"``'program'``. :meth:`wm_positionfrom` is an alias of :meth:`!positionfrom`." +msgstr "" + +msgid "" +"Register *func* as the handler for the window manager protocol *name*, an " +"atom such as ``'WM_DELETE_WINDOW'``, ``'WM_SAVE_YOURSELF'`` or " +"``'WM_TAKE_FOCUS'``; *func* is then called whenever the window manager sends " +"a message of that protocol. Tk installs a default ``WM_DELETE_WINDOW`` " +"handler that destroys the window, which this method can replace. If *func* " +"is an empty string, the handler is removed. With only *name*, return the " +"name of its registered handler command, or an empty string if none is set " +"(the default ``WM_DELETE_WINDOW`` handler is not reported); with no " +"arguments, return a tuple of the protocols that currently have " +"handlers. :meth:`wm_protocol` is an alias of :meth:`!protocol`." +msgstr "" + +msgid "" +"Control whether the user may interactively resize the window. *width* and " +"*height* are boolean values that determine whether the window's width and " +"height may be changed. With no arguments, return a tuple of two ``0``/``1`` " +"values indicating whether each dimension is currently resizable. By default " +"a window is resizable in both dimensions. :meth:`wm_resizable` is an alias " +"of :meth:`!resizable`." +msgstr "" + +msgid "" +"Set or query the source of the window's current size. *who* is either " +"``'program'`` or ``'user'`` and indicates whether the size was requested by " +"the program or by the user; an empty string cancels the current source. With " +"no argument, return the current source, or an empty string if none has been " +"set. :meth:`wm_sizefrom` is an alias of :meth:`!sizefrom`." +msgstr "" + +msgid "" +"Set or query the state of the window. With no argument, return the current " +"state: one of ``'normal'``, ``'iconic'``, ``'withdrawn'``, ``'icon'`` or, on " +"Windows and macOS only, ``'zoomed'``. ``'iconic'`` refers to a window that " +"has been iconified, while ``'icon'`` refers to a window serving as the icon " +"for another window (see :meth:`iconwindow`); the ``'icon'`` state cannot be " +"set. :meth:`wm_state` is an alias of :meth:`!state`." +msgstr "" + +msgid "" +"Not to be confused with :meth:`ttk.Widget.state `." +msgstr "" + +msgid "" +"Set or query the title for the window, which the window manager should " +"display in the window's title bar. With no argument, return the current " +"title. The title defaults to the window's name. :meth:`wm_title` is an alias " +"of :meth:`!title`." +msgstr "" + +msgid "" +"Mark the window as a transient window (such as a pull-down menu or dialog) " +"working on behalf of *master*, the path name of another top-level window. An " +"empty string clears the transient status. With no argument, return the path " +"name of the current master, or an empty string. A transient window mirrors " +"state changes in its master and may be decorated differently by the window " +"manager; it is an error to make a window a transient of " +"itself. :meth:`wm_transient` is an alias of :meth:`!transient`." +msgstr "" + +msgid "" +"Withdraw the window from the screen, unmapping it and causing the window " +"manager to forget about it. If the window has never been mapped, it is " +"instead mapped in the withdrawn state. It is sometimes necessary to withdraw " +"a window and then re-map it (for example with :meth:`deiconify`) to make " +"some window managers notice changes to window " +"attributes. :meth:`wm_withdraw` is an alias of :meth:`!withdraw`." +msgstr "" + +msgid "" +"Geometry manager that arranges widgets by packing them against the sides of " +"their container. The :class:`!Pack` mix-in is inherited by all widgets " +"(through :class:`Widget`) and provides the methods for managing a widget " +"with the *pack* geometry manager. See also :ref:`tkinter-geometry-" +"management`." +msgstr "" + +msgid "" +":class:`Pack`, :class:`Place` and :class:`Grid` all define the short method " +"names :meth:`!forget`, :meth:`!info`, :meth:`!slaves`, :meth:`!content` " +"and :meth:`!propagate`. On a widget the bare names resolve to the *pack* " +"manager's versions, since :class:`Pack` and :class:`Misc` " +"precede :class:`Place` and :class:`Grid` in the method resolution order, " +"whatever manager actually manages the widget; and :meth:`!configure`/:meth:`!" +"config` configure the widget's options, not its geometry. Use the explicit " +"``pack_*``, ``grid_*`` and ``place_*`` methods (and ``pack``, ``grid``, " +"``place`` for geometry configuration) to act on a specific geometry manager." +msgstr "" + +msgid "" +"Pack the widget inside its container, positioning it relative to the " +"siblings already packed there. The supported options are:" +msgstr "" + +msgid "*side*" +msgstr "" + +msgid "" +"Which side of the container to pack the widget against: ``'top'`` (the " +"default), ``'bottom'``, ``'left'`` or ``'right'``." +msgstr "" + +msgid "*fill*" +msgstr "" + +msgid "" +"Whether to stretch the widget to fill its parcel: ``'none'`` (the default), " +"``'x'``, ``'y'`` or ``'both'``." +msgstr "" + +msgid "*expand*" +msgstr "" + +msgid "" +"Whether the widget should expand to consume any extra space in its container " +"(a boolean, default false)." +msgstr "" + +msgid "*anchor*" +msgstr "" + +msgid "" +"Where to position the widget in its parcel when the parcel is larger than " +"the widget: an anchor such as ``'n'`` or ``'sw'`` (default ``'center'``)." +msgstr "" + +msgid "*ipadx*, *ipady*" +msgstr "" + +msgid "" +"Internal padding added on the left and right (*ipadx*) or top and bottom " +"(*ipady*) of the widget, as a screen distance (default ``0``)." +msgstr "" + +msgid "*padx*, *pady*" +msgstr "" + +msgid "" +"External padding left on the left and right (*padx*) or top and bottom " +"(*pady*) of the widget, as a screen distance or a pair of two distances for " +"the two sides (default ``0``)." +msgstr "" + +msgid "*after*" +msgstr "" + +msgid "" +"Pack the widget after the given widget in the packing order, using the same " +"container." +msgstr "" + +msgid "*before*" +msgstr "" + +msgid "" +"Pack the widget before the given widget in the packing order, using the same " +"container." +msgstr "" + +msgid "*in_*" +msgstr "" + +msgid "" +"The container in which to pack the widget; it defaults to the parent widget." +msgstr "" + +msgid "" +":meth:`pack`, :meth:`configure` and :meth:`config` are aliases of :meth:`!" +"pack_configure`." +msgstr "" + +msgid "" +"Unmap the widget and remove it from the packing order, forgetting its " +"packing options. It can be packed again later " +"with :meth:`pack_configure`. :meth:`forget` is an alias of :meth:`!" +"pack_forget`, except on :class:`PanedWindow`, :class:`ttk.Notebook " +"` and :class:`ttk.PanedWindow " +"`, which provide their own :meth:`!forget` method." +msgstr "" + +msgid "Not to be confused with :meth:`Wm.forget`." +msgstr "" + +msgid "" +"Return a dictionary of the widget's current packing options. :meth:`info` is " +"an alias of :meth:`!pack_info`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.pack_propagate`, treating this widget as a container: " +"enable or disable geometry propagation. :meth:`propagate` is an alias " +"of :meth:`!pack_propagate`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.pack_slaves`: return the list of widgets packed in this " +"widget. :meth:`slaves` is an alias of :meth:`!pack_slaves`." +msgstr "" + +msgid "" +"Geometry manager that places widgets at explicit positions and sizes within " +"their container. The :class:`!Place` mix-in is inherited by all widgets " +"(through :class:`Widget`). See also :ref:`tkinter-geometry-management`." +msgstr "" + +msgid "" +"Place the widget inside its container at an absolute or relative position. " +"The supported options are:" +msgstr "" + +msgid "*x*, *y*" +msgstr "" + +msgid "" +"The absolute horizontal and vertical position of the widget's anchor point, " +"as a screen distance (default ``0``)." +msgstr "" + +msgid "*relx*, *rely*" +msgstr "" + +msgid "" +"The horizontal and vertical position of the widget's anchor point as a " +"fraction of the container's width and height, where ``0.0`` is the left or " +"top edge and ``1.0`` is the right or bottom edge. If both the absolute and " +"the relative option are given, their values are summed." +msgstr "" + +msgid "" +"Which point of the widget is placed at the given position: an anchor such as " +"``'n'`` or ``'se'`` (default ``'nw'``)." +msgstr "" + +msgid "*width*, *height*" +msgstr "" + +msgid "" +"The absolute width and height of the widget, as a screen distance. By " +"default the widget's requested size is used." +msgstr "" + +msgid "*relwidth*, *relheight*" +msgstr "" + +msgid "" +"The width and height of the widget as a fraction of the container's width " +"and height. If both the absolute and the relative option are given, their " +"values are summed." +msgstr "" + +msgid "*bordermode*" +msgstr "" + +msgid "" +"How the container's border affects placement: ``'inside'`` (the default) " +"measures the area inside the border, ``'outside'`` measures the area " +"including the border, and ``'ignore'`` uses the official X area." +msgstr "" + +msgid "" +"The container relative to which the widget is placed; it must be the " +"widget's parent or a descendant of the parent, and defaults to the parent." +msgstr "" + +msgid "" +":meth:`place`, :meth:`configure` and :meth:`config` are aliases of :meth:`!" +"place_configure`." +msgstr "" + +msgid "" +"Unmap the widget and remove it from the placement, forgetting its place " +"options." +msgstr "" + +msgid "Return a dictionary of the widget's current place options." +msgstr "" + +msgid "" +"Same as :meth:`Misc.place_slaves`: return the list of widgets placed in this " +"widget." +msgstr "" + +msgid "" +"Geometry manager that arranges widgets in a two-dimensional grid of rows and " +"columns within their container. The :class:`!Grid` mix-in is inherited by " +"all widgets (through :class:`Widget`). See also :ref:`tkinter-geometry-" +"management`." +msgstr "" + +msgid "Position the widget in a cell of its container's grid." +msgstr "" + +msgid "Not to be confused with :meth:`Wm.grid`." +msgstr "" + +msgid "The supported options are:" +msgstr "" + +msgid "*row*, *column*" +msgstr "" + +msgid "" +"The row and column of the cell to place the widget in, counting from ``0``. " +"*column* defaults to the column after the previous widget placed in the " +"same :meth:`!grid_configure` call (or ``0``), and *row* defaults to the next " +"empty row." +msgstr "" + +msgid "*rowspan*, *columnspan*" +msgstr "" + +msgid "The number of rows and columns the widget should span (default ``1``)." +msgstr "" + +msgid "*sticky*" +msgstr "" + +msgid "" +"How to position or stretch the widget when its cell is larger than the " +"widget: a string containing zero or more of the characters ``'n'``, ``'s'``, " +"``'e'`` and ``'w'``, naming the cell sides the widget sticks to. Specifying " +"both ``'n'`` and ``'s'`` (or ``'e'`` and ``'w'``) stretches the widget to " +"fill the height (or width) of the cell. The default is ``''``, which centers " +"the widget at its requested size." +msgstr "" + +msgid "" +"The container in whose grid to place the widget; it defaults to the parent " +"widget." +msgstr "" + +msgid "" +":meth:`grid`, :meth:`configure` and :meth:`config` are aliases of :meth:`!" +"grid_configure`." +msgstr "" + +msgid "" +"Unmap the widget and remove it from the grid, forgetting its grid options." +msgstr "" + +msgid "" +"Unmap the widget and remove it from the grid, but remember its grid options " +"so that it is restored to the same cell if it is gridded again." +msgstr "" + +msgid "Return a dictionary of the widget's current grid options." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_bbox`. :meth:`bbox` is an alias of :meth:`!" +"grid_bbox`, except " +"on :class:`Canvas`, :class:`Listbox`, :class:`Spinbox`, :class:`Text`, :class:`ttk.Entry " +"` and :class:`ttk.Treeview `, which " +"provide their own :meth:`!bbox` method." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_columnconfigure`: query or set the options (such as " +"*weight*, *minsize*, *pad* and *uniform*) of a grid " +"column. :meth:`columnconfigure` is an alias of :meth:`!grid_columnconfigure`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_rowconfigure`: query or set the options of a grid " +"row. :meth:`rowconfigure` is an alias of :meth:`!grid_rowconfigure`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_location`: return the ``(column, row)`` of the cell " +"that covers the pixel at *x*, *y*. :meth:`location` is an alias of :meth:`!" +"grid_location`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_size`: return a ``(columns, rows)`` tuple giving " +"the size of the grid. :meth:`size` is an alias of :meth:`!grid_size`, except " +"on the :class:`Listbox` widget, which provides its own :meth:`!size` method." +msgstr "" + +msgid "Same as :meth:`Misc.grid_propagate`." +msgstr "" + +msgid "" +"Same as :meth:`Misc.grid_slaves`: return the widgets managed in the grid, " +"optionally restricted to a *row* and/or *column*." +msgstr "" + +msgid "" +"Mix-in providing the horizontal-scrolling interface shared by widgets such " +"as :class:`Entry`, :class:`Canvas`, :class:`Listbox`, :class:`Text` " +"and :class:`Spinbox`. A widget's :meth:`xview` method is registered as the " +"*command* of a horizontal :class:`Scrollbar`." +msgstr "" + +msgid "" +"Query or change the horizontal position of the view. With no arguments, " +"return a tuple ``(first, last)`` of two fractions between 0 and 1 giving the " +"portion of the document that is currently visible. Otherwise the arguments " +"are passed to the Tk ``xview`` widget command and are usually generated by a " +"scrollbar; :meth:`xview_moveto` and :meth:`xview_scroll` provide a more " +"convenient interface." +msgstr "" + +msgid "" +"Adjust the view so that *fraction* of the total width of the document is off-" +"screen to the left. *fraction* is a number between 0 and 1." +msgstr "" + +msgid "" +"Shift the view left or right by *number* units. *what* is either ``'units'`` " +"or ``'pages'``; a negative *number* scrolls left and a positive one scrolls " +"right." +msgstr "" + +msgid "" +"Mix-in providing the vertical-scrolling interface shared by widgets such " +"as :class:`Canvas`, :class:`Listbox` and :class:`Text`. A " +"widget's :meth:`yview` method is registered as the *command* of a " +"vertical :class:`Scrollbar`." +msgstr "" + +msgid "" +"Query or change the vertical position of the view. With no arguments, return " +"a tuple ``(first, last)`` of two fractions between 0 and 1 giving the " +"portion of the document that is currently visible. Otherwise the arguments " +"are passed to the Tk ``yview`` widget command, usually generated by a " +"scrollbar; :meth:`yview_moveto` and :meth:`yview_scroll` provide a more " +"convenient interface." +msgstr "" + +msgid "" +"Adjust the view so that *fraction* of the total height of the document is " +"off-screen above the top. *fraction* is a number between 0 and 1." +msgstr "" + +msgid "" +"Shift the view up or down by *number* units. *what* is either ``'units'`` or " +"``'pages'``; a negative *number* scrolls up and a positive one scrolls down." +msgstr "" + +msgid "" +"Internal base class for all widgets. It inherits from :class:`Misc` and adds " +"the machinery that creates the underlying Tk widget; application code " +"normally uses :class:`Widget` or a concrete widget class rather than " +"instantiating :class:`!BaseWidget` directly." +msgstr "" + +msgid "" +"Destroy this widget and all of its children, removing the corresponding Tk " +"widgets and deleting the associated Tcl commands." +msgstr "" + +msgid "" +"Internal base class for the standard widgets. It " +"combines :class:`BaseWidget` with the geometry-manager mix-" +"ins :class:`Pack`, :class:`Place` and :class:`Grid`, so that every widget " +"can be managed by any of the three geometry managers. The concrete widget " +"classes (:class:`Button`, :class:`Label`, and so on) derive from :class:`!" +"Widget`." +msgstr "" + +msgid "Toplevel widgets" +msgstr "" + +msgid "" +"Construct a toplevel Tk widget, which is usually the main window of an " +"application, and initialize a Tcl interpreter for this widget. Each " +"instance has its own associated Tcl interpreter. Inherits from :class:`Misc` " +"and :class:`Wm`." +msgstr "" + +msgid "" +"To create a Tcl interpreter without initializing the Tk subsystem, use " +"the :func:`Tcl` factory function instead." +msgstr "" + +msgid "" +"The :class:`Tk` class is typically instantiated using all default values. " +"However, the following keyword arguments are currently recognized:" +msgstr "" + +msgid "*screenName*" +msgstr "" + +msgid "" +"When given (as a string), sets the :envvar:`DISPLAY` environment variable. " +"(X11 only)" +msgstr "" + +msgid "*baseName*" +msgstr "" + +msgid "" +"Name of the profile file. By default, *baseName* is derived from the " +"program name (``sys.argv[0]``)." +msgstr "" + +msgid "*className*" +msgstr "" + +msgid "" +"Name of the widget class. Used as a profile file and also as the name with " +"which Tcl is invoked (*argv0* in *interp*)." +msgstr "" + +msgid "*useTk*" +msgstr "" + +msgid "" +"If ``True``, initialize the Tk subsystem. The :func:`tkinter.Tcl() ` " +"function sets this to ``False``." +msgstr "" + +msgid "*sync*" +msgstr "" + +msgid "" +"If ``True``, execute all X server commands synchronously, so that errors are " +"reported immediately. Can be used for debugging. (X11 only)" +msgstr "" + +msgid "*use*" +msgstr "" + +msgid "" +"Specifies the *id* of the window in which to embed the application, instead " +"of it being created as an independent toplevel window. *id* must be " +"specified in the same way as the value for the -use option for toplevel " +"widgets (that is, it has a form like that returned " +"by :meth:`~Misc.winfo_id`)." +msgstr "" + +msgid "" +"Note that on some platforms this will only work correctly if *id* refers to " +"a Tk frame or toplevel that has its -container option enabled." +msgstr "" + +msgid "" +":class:`Tk` reads and interprets profile files, named :file:`." +"{className}.tcl` and :file:`.{baseName}.tcl`, into the Tcl interpreter and " +"calls :func:`exec` on the contents of :file:`.{className}.py` and :file:`." +"{baseName}.py`. The path for the profile files is the :envvar:`HOME` " +"environment variable or, if that isn't defined, then :data:`os.curdir`." +msgstr "" + +msgid "" +"On Windows, creating a Tcl interpreter (by instantiating :class:`Tk` or " +"calling :func:`Tcl`) sets the :envvar:`HOME` environment variable for the " +"process, if it is not already set, to ``%HOMEDRIVE%%HOMEPATH%`` " +"(or :envvar:`USERPROFILE`, or ``c:\\``). This is done by Tcl and can affect " +"other code that reads :envvar:`HOME`." +msgstr "" + +msgid "" +"The Tk application object created by instantiating :class:`Tk`. This " +"provides access to the Tcl interpreter. Each widget that is attached the " +"same instance of :class:`Tk` has the same value for its :attr:`tk` attribute." +msgstr "" + +msgid "" +"The widget object that contains this widget. For :class:`Tk`, the :attr:`!" +"master` is :const:`None` because it is the main window. The terms *master* " +"and *parent* are similar and sometimes used interchangeably as argument " +"names; however, calling :meth:`~Misc.winfo_parent` returns a string of the " +"widget name whereas :attr:`!master` returns the object. *parent*/*child* " +"reflects the tree-like relationship while *master* (or *container*)/" +"*content* reflects the container structure." +msgstr "" + +msgid "" +"The immediate descendants of this widget as a :class:`dict` with the child " +"widget names as the keys and the child instance objects as the values." +msgstr "" + +msgid "" +"Destroy this and all descendant widgets and, for the main window, end the " +"connection to the underlying Tcl interpreter." +msgstr "" + +msgid "" +"Finish loading and initializing the Tk subsystem. This is needed only when " +"the interpreter was created without Tk (for example through :func:`Tcl`); it " +"is called automatically when *useTk* is true." +msgstr "" + +msgid "" +"Read and source the user's profile files :file:`.{className}.tcl` " +"and :file:`.{baseName}.tcl` into the Tcl interpreter, and execute the " +"corresponding :file:`.{className}.py` and :file:`.{baseName}.py` files. This " +"is called during initialization; see the description of the constructor " +"above." +msgstr "" + +msgid "" +"Report a callback exception. This is called when an exception propagates out " +"of a Tkinter callback; *exc*, *val* and *tb* are the exception type, value " +"and traceback as returned by :func:`sys.exc_info`. The default " +"implementation prints a traceback to :data:`sys.stderr`. It can be " +"overridden to customize error handling, for example to display the traceback " +"in a dialog." +msgstr "" + +msgid "" +"A :class:`!Toplevel` widget is a top-level window, similar to " +"a :class:`Frame` except that its X parent is the root window of a screen " +"rather than its logical parent. Its primary purpose is to serve as a " +"container for dialog boxes and other collections of widgets; its only " +"visible features are its background and an optional 3-D border. Notable " +"options include *menu*, which installs a :class:`Menu` as the window's " +"menubar. Inherits from :class:`BaseWidget` and :class:`Wm`, so a toplevel is " +"managed by the window manager. Refer to the Tk ``toplevel`` manual page for " +"the full list of options." +msgstr "" + +msgid "Widget classes" +msgstr "" + +msgid "" +"A :class:`!Button` widget displays a textual string, bitmap or image and " +"invokes a command when the user presses it (by clicking mouse button 1 over " +"the button or, when the button has focus, by pressing the space key). " +"Inherits from :class:`Widget`. In addition to the standard widget options, a " +"button accepts the options documented in the Tk ``button`` manual page, such " +"as *command* (the callback invoked when the button is pressed), " +"*textvariable*, *state* and *default*." +msgstr "" + +msgid "" +"Invoke the command associated with the button, if there is one, and return " +"its result, or an empty string if no command is associated with the button. " +"This is ignored if the button's state is ``disabled``." +msgstr "" + +msgid "" +"Flash the button by redisplaying it several times, alternating between the " +"active and normal colors. At the end of the flash the button is left in the " +"same normal or active state as when the method was called. This is ignored " +"if the button's state is ``disabled``." +msgstr "" + +msgid "" +"A :class:`!Canvas` widget implements structured graphics. It displays any " +"number of *items*, such as arcs, lines, ovals, polygons, rectangles, text, " +"bitmaps, images and embedded windows, which may be drawn, moved, re-colored " +"and bound to events. Inherits from :class:`Widget`, :class:`XView` " +"and :class:`YView`, so the view can be scrolled horizontally and vertically " +"with :meth:`~XView.xview` and :meth:`~YView.yview`. Refer to the Tk " +"``canvas`` manual page for the full list of widget and item options." +msgstr "" + +msgid "" +"Each item has a unique integer *id*, assigned when it is created, and zero " +"or more string *tags*. A tag is an arbitrary string that does not have the " +"form of an integer; the same tag may be shared by many items, which makes " +"tags convenient for grouping items. The special tag ``'all'`` matches every " +"item in the canvas, and ``'current'`` matches the topmost item under the " +"mouse pointer. Most methods take a *tagOrId* argument that may be an integer " +"id naming a single item, or a tag naming zero or more items; as described in " +"the Tk ``canvas`` manual page, a tag may also be a logical expression of " +"tags combined with the operators ``&&``, ``||``, ``^``, ``!`` and " +"parentheses. When a method that operates on a single item is given a " +"*tagOrId* matching several items, it normally uses the lowest matching item " +"in the display list." +msgstr "" + +msgid "" +"The items are kept in a *display list* that determines drawing order: items " +"later in the list are drawn on top of earlier ones. A newly created item is " +"placed at the top of the list; the order can be changed " +"with :meth:`tag_raise` and :meth:`tag_lower`." +msgstr "" + +msgid "" +"Create a new item of the corresponding type and return its integer id. Each " +"method is called as ``create_TYPE(coord..., **options)``: the leading " +"positional arguments give the coordinates that define the item (as separate " +"numbers, as a single sequence of numbers, or as coordinate pairs), and the " +"keyword arguments set item-specific options. Coordinates and screen " +"distances may be given as numbers (interpreted as pixels) or as strings with " +"a unit suffix (``'m'``, ``'c'``, ``'i'`` or ``'p'`` for millimetres, " +"centimetres, inches or printer's points), but are always stored and returned " +"in pixels." +msgstr "" + +msgid "" +"The item types are: ``arc`` (an arc-shaped region that is a section of an " +"oval, defined by two diagonally opposite corners ``x1, y1, x2, y2`` of the " +"enclosing rectangle); ``bitmap`` (a two-color bitmap positioned at a point " +"``x, y``); ``image`` (a Tk image positioned at a point ``x, y``); ``line`` " +"(a line or curve through the points ``x1, y1, ..., xn, yn``); ``oval`` (a " +"circle or ellipse inscribed in the rectangle ``x1, y1, x2, y2``); " +"``polygon`` (a closed polygon through the points ``x1, y1, ..., xn, yn``); " +"``rectangle`` (a rectangle with corners ``x1, y1, x2, y2``); ``text`` (a " +"string of text positioned at a point ``x, y``); and ``window`` (a child " +"widget embedded in the canvas at a point ``x, y``, specified with the " +"*window* option)." +msgstr "" + +msgid "" +"Most item types accept a common set of *standard item options*, plus a few " +"options specific to each type. Option names are passed as keyword arguments, " +"without the leading hyphen." +msgstr "" + +msgid "The standard item options are:" +msgstr "" + +msgid "" +"The color used to fill the item's interior, or to draw a *line* item or the " +"characters of a *text* item. An empty string (the default for all types " +"except *line* and *text*) leaves the item unfilled." +msgstr "" + +msgid "*outline*" +msgstr "" + +msgid "" +"The color used to draw the item's outline. An empty string draws no outline." +msgstr "" + +msgid "*width*" +msgstr "" + +msgid "" +"The width of the outline, defaulting to ``1.0``. Has no effect if *outline* " +"is empty." +msgstr "" + +msgid "*dash*" +msgstr "" + +msgid "" +"A dash pattern for the outline, given either as a sequence of segment " +"lengths in pixels or as a string of the characters ``'.'``, ``','``, " +"``'-'``, ``'_'`` and space. An empty pattern (the default) draws a solid " +"outline." +msgstr "" + +msgid "*dashoffset*" +msgstr "" + +msgid "" +"The starting offset in pixels into the *dash* pattern. Ignored if there is " +"no *dash* pattern." +msgstr "" + +msgid "*stipple*" +msgstr "" + +msgid "" +"A bitmap used as a stipple pattern when filling the item. Only well " +"supported on X11." +msgstr "" + +msgid "*outlinestipple*" +msgstr "" + +msgid "" +"A bitmap used as a stipple pattern when drawing the outline. Has no effect " +"if *outline* is empty." +msgstr "" + +msgid "*offset*, *outlineoffset*" +msgstr "" + +msgid "" +"The offset of the fill and outline stipple patterns, given as ``'x,y'`` or " +"as a side such as ``'n'``, ``'se'`` or ``'center'``. Stipple offsets are " +"only supported on X11." +msgstr "" + +msgid "*state*" +msgstr "" + +msgid "" +"Overrides the canvas state for this item; one of ``'normal'``, " +"``'disabled'`` or ``'hidden'``." +msgstr "" + +msgid "*tags*" +msgstr "" + +msgid "" +"A single tag or a sequence of tags to associate with the item, replacing any " +"existing tags." +msgstr "" + +msgid "" +"Many of these options have *active...* and *disabled...* variants (such as " +"*activefill*, *disabledfill*, *activewidth*, *disableddash*, " +"*activeoutline*, *disabledstipple*) that override the base option when the " +"item is the active item (under the mouse pointer) or is in the disabled " +"state." +msgstr "" + +msgid "The following item types support additional options." +msgstr "" + +msgid "For ``arc`` items:" +msgstr "" + +msgid "*start*" +msgstr "" + +msgid "" +"The start of the arc's angular range, in degrees measured counter-clockwise " +"from the 3-o'clock position." +msgstr "" + +msgid "*extent*" +msgstr "" + +msgid "" +"The size of the angular range, in degrees counter-clockwise from *start*." +msgstr "" + +msgid "*style*" +msgstr "" + +msgid "" +"How the arc is drawn: ``'pieslice'`` (the default), ``'chord'`` or ``'arc'``." +msgstr "" + +msgid "For ``line`` items:" +msgstr "" + +msgid "*arrow*" +msgstr "" + +msgid "" +"Where to draw arrowheads: ``'none'`` (the default), ``'first'``, ``'last'`` " +"or ``'both'``." +msgstr "" + +msgid "*arrowshape*" +msgstr "" + +msgid "A sequence of three distances describing the shape of the arrowheads." +msgstr "" + +msgid "*capstyle*" +msgstr "" + +msgid "" +"How line ends are drawn: ``'butt'`` (the default), ``'projecting'`` or " +"``'round'``." +msgstr "" + +msgid "*joinstyle*" +msgstr "" + +msgid "" +"How line vertices are drawn: ``'round'`` (the default), ``'bevel'`` or " +"``'miter'``." +msgstr "" + +msgid "*smooth*" +msgstr "" + +msgid "" +"The smoothing method: a false value (the default) for no smoothing, or " +"``'true'``/``'bezier'`` or ``'raw'`` to draw the line as a curve." +msgstr "" + +msgid "*splinesteps*" +msgstr "" + +msgid "" +"The number of line segments approximating each spline when *smooth* is " +"enabled." +msgstr "" + +msgid "For ``polygon`` items:" +msgstr "" + +msgid "*joinstyle*, *smooth*, *splinesteps*" +msgstr "" + +msgid "As for ``line`` items, applied to the polygon's outline." +msgstr "" + +msgid "For ``text`` items:" +msgstr "" + +msgid "*text*" +msgstr "" + +msgid "The string to display; newline characters start new lines." +msgstr "" + +msgid "*font*" +msgstr "" + +msgid "The font used for the text." +msgstr "" + +msgid "*justify*" +msgstr "" + +msgid "" +"How lines are justified: ``'left'`` (the default), ``'right'`` or " +"``'center'``." +msgstr "" + +msgid "" +"How the text is positioned relative to its point, defaulting to ``'center'``." +msgstr "" + +msgid "The maximum line length; if non-zero, lines are wrapped at spaces." +msgstr "" + +msgid "*angle*" +msgstr "" + +msgid "" +"How many degrees to rotate the text counter-clockwise about its positioning " +"point, from ``0.0`` to ``360.0`` (default ``0.0``)." +msgstr "" + +msgid "*underline*" +msgstr "" + +msgid "The index of a character to underline, or ``-1`` for none." +msgstr "" + +msgid "For ``bitmap`` items:" +msgstr "" + +msgid "*bitmap*" +msgstr "" + +msgid "The bitmap to display." +msgstr "" + +msgid "How the bitmap is positioned relative to its point." +msgstr "" + +msgid "*background*, *foreground*" +msgstr "" + +msgid "" +"The colors used for the bitmap's ``0`` and ``1`` pixels; an empty " +"*background* makes the ``0`` pixels transparent. Both have *active...* and " +"*disabled...* variants, and *bitmap* has *activebitmap* and *disabledbitmap* " +"variants." +msgstr "" + +msgid "For ``image`` items:" +msgstr "" + +msgid "*image*" +msgstr "" + +msgid "The Tk image to display, previously created with the image protocols." +msgstr "" + +msgid "How the image is positioned relative to its point." +msgstr "" + +msgid "" +"Both options have *active...* and *disabled...* variants (*activeimage*, " +"*disabledimage*) used in the active and disabled states." +msgstr "" + +msgid "For ``window`` items:" +msgstr "" + +msgid "*window*" +msgstr "" + +msgid "" +"The widget to embed; it must be a child of the canvas or of one of its " +"ancestors, and may not be a top-level window." +msgstr "" + +msgid "How the window is positioned relative to its point." +msgstr "" + +msgid "" +"The size to assign to the window; if zero (the default), the window is given " +"its requested size." +msgstr "" + +msgid "" +"``oval`` and ``rectangle`` items have no type-specific options; they use " +"only the standard item options." +msgstr "" + +msgid "" +"Tk 8.6 added the *angle* option and Tk 9.0 added the *underline* option for " +"``text`` items." +msgstr "" + +msgid "" +"Query or modify the coordinates of an item. With only *tagOrId*, return a " +"list of the floating-point coordinates of the item given by *tagOrId* (the " +"first matching item if it matches several). Given new coordinates, replace " +"the coordinates of that item with them; like the ``create_*`` methods, the " +"coordinates may be given as separate numbers, as a single sequence, or as " +"coordinate pairs. The returned coordinates are always in pixels, regardless " +"of the units used to specify them; for rectangles, ovals and arcs they are " +"ordered left, top, right, bottom." +msgstr "" + +msgid "" +"The arguments are now flattened: the coordinates may be given as separate " +"arguments, as a single sequence, or grouped in pairs, like the ``create_*`` " +"methods." +msgstr "" + +msgid "" +"Move each of the items given by *tagOrId* in the canvas coordinate space by " +"adding *xAmount* to every x-coordinate and *yAmount* to every y-coordinate " +"of the item." +msgstr "" + +msgid "" +"Move the items given by *tagOrId* so that the first coordinate pair (the " +"upper-left corner of the bounding box) of the lowest matching item is at " +"position (*x*, *y*). *x* or *y* may be an empty string, in which case the " +"corresponding coordinate is unchanged. All matching items keep their " +"positions relative to each other." +msgstr "" + +msgid "" +"Rescale the coordinates of all items given by *tagOrId* in canvas coordinate " +"space. Each x-coordinate is adjusted so that its distance from *xOrigin* " +"changes by a factor of *xScale*, and each y-coordinate so that its distance " +"from *yOrigin* changes by a factor of *yScale* (a factor of ``1.0`` leaves " +"the coordinate unchanged)." +msgstr "" + +msgid "Delete each of the items given by the *tagOrIds* arguments." +msgstr "" + +msgid "" +"Delete from each of the items given by *tagOrId* the characters (for text " +"items) or coordinates (for line and polygon items) in the range from *first* " +"to *last* inclusive; *last* defaults to *first*. Items that do not support " +"indexing ignore this operation." +msgstr "" + +msgid "" +"Insert *string* into each of the items given by *tagOrId* just before the " +"character or coordinate whose index is *beforeThis*. For line and polygon " +"items *string* must be a valid sequence of coordinates." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the item " +"given by *tagOrId* (the lowest matching item if it matches several). This is " +"like :meth:`~Misc.cget` but applies to an individual item." +msgstr "" + +msgid "" +"Query or modify the configuration options of the items given by *tagOrId*. " +"This mirrors :meth:`~Misc.configure`, except that it applies to individual " +"items rather than to the canvas as a whole. With no options, it returns a " +"dictionary describing the current options of the first matching item; " +"otherwise it sets the given options on every matching item. The legal " +"options are those accepted by the corresponding ``create_*`` " +"method. :meth:`itemconfig` is an alias of :meth:`!itemconfigure`." +msgstr "" + +msgid "" +"Return the type of the item given by *tagOrId* (the first matching item if " +"it matches several), such as ``'rectangle'`` or ``'text'``, or ``None`` if " +"*tagOrId* does not match any item." +msgstr "" + +msgid "" +"Return a tuple of the tags associated with the item given by *tagOrId* (the " +"first matching item in display-list order if it matches several). Return an " +"empty tuple if no item matches or the item has no tags." +msgstr "" + +msgid "" +"Remove the tag *tagToDelete* (which defaults to *tagOrId*) from each of the " +"items given by *tagOrId*. Items that do not have that tag are unaffected." +msgstr "" + +msgid "" +"Add the tag *newtag* to each item selected by the search specification " +"*searchSpec* (and any further *args*). *searchSpec* is one of ``'above'``, " +"``'all'``, ``'below'``, ``'closest'``, ``'enclosed'``, ``'overlapping'`` or " +"``'withtag'``; the ``addtag_*`` methods below are convenient wrappers that " +"supply each of these forms." +msgstr "" + +msgid "" +"Add the tag *newtag* to the item just above (after) *tagOrId* in the display " +"list." +msgstr "" + +msgid "Add the tag *newtag* to all items in the canvas." +msgstr "" + +msgid "" +"Add the tag *newtag* to the item just below (before) *tagOrId* in the " +"display list." +msgstr "" + +msgid "" +"Add the tag *newtag* to the item closest to the point (*x*, *y*). If *halo* " +"is given, any item within that distance of the point is treated as " +"overlapping it. If *start* is given (a tag or id), select the topmost " +"closest item that lies below *start* in the display list, which can be used " +"to step through all the closest items." +msgstr "" + +msgid "" +"Add the tag *newtag* to every item completely enclosed within the rectangle " +"(*x1*, *y1*, *x2*, *y2*), where *x1* <= *x2* and *y1* <= *y2*." +msgstr "" + +msgid "" +"Add the tag *newtag* to every item that overlaps or is enclosed within the " +"rectangle (*x1*, *y1*, *x2*, *y2*), where *x1* <= *x2* and *y1* <= *y2*." +msgstr "" + +msgid "Add the tag *newtag* to every item given by *tagOrId*." +msgstr "" + +msgid "" +"Return a tuple of the ids of all items selected by the search specification " +"*searchSpec* (and any further *args*), in stacking order with the lowest " +"item first. The search specification has any of the forms accepted " +"by :meth:`addtag`. The ``find_*`` methods below are more convenient wrappers " +"around it." +msgstr "" + +msgid "" +"Return a tuple containing the id of the item just above *tagOrId* in the " +"display list." +msgstr "" + +msgid "" +"Return a tuple of the ids of all items in the canvas, in stacking order." +msgstr "" + +msgid "" +"Return a tuple containing the id of the item just below *tagOrId* in the " +"display list." +msgstr "" + +msgid "" +"Return a tuple containing the id of the item closest to the point (*x*, " +"*y*). *halo* and *start* are interpreted as for :meth:`addtag_closest`." +msgstr "" + +msgid "" +"Return a tuple of the ids of all items completely enclosed within the " +"rectangle (*x1*, *y1*, *x2*, *y2*)." +msgstr "" + +msgid "" +"Return a tuple of the ids of all items that overlap or are enclosed within " +"the rectangle (*x1*, *y1*, *x2*, *y2*)." +msgstr "" + +msgid "Return a tuple of the ids of all items given by *tagOrId*." +msgstr "" + +msgid "" +"Move all items given by *tagOrId* to a new position in the display list just " +"above the item given by *aboveThis*, or to the top of the display list if " +"*aboveThis* is omitted. When several items are moved their relative order is " +"preserved. This has no effect on embedded window items, whose stacking order " +"is controlled by :meth:`Misc.tkraise` and :meth:`Misc.lower` " +"instead. :meth:`lift` and :meth:`tkraise` are aliases of :meth:`!tag_raise`." +msgstr "" + +msgid "" +"Move all items given by *tagOrId* to a new position in the display list just " +"below the item given by *belowThis*, or to the bottom of the display list if " +"*belowThis* is omitted. When several items are moved their relative order is " +"preserved. This has no effect on embedded window items. :meth:`lower` is an " +"alias of :meth:`!tag_lower`." +msgstr "" + +msgid "" +"On a :class:`Canvas`, :meth:`tkraise`/:meth:`lift` and :meth:`lower` restack " +"canvas items, shadowing the inherited :meth:`Misc.tkraise`/:meth:`Misc.lift` " +"and :meth:`Misc.lower` methods that restack the widget itself, which are " +"therefore not available." +msgstr "" + +msgid "" +"Bind the callback *func* to the event *sequence* for all items given by " +"*tagOrId*, so that *func* is invoked whenever that event occurs for one of " +"the items. This is like :meth:`Widget.bind ` but operates on " +"canvas items rather than on whole widgets; only mouse, keyboard and virtual " +"events may be bound. Mouse events are directed to the current item and " +"keyboard events to the focus item (see :meth:`focus`). If *add* is true the " +"new binding is added to any existing bindings for the same sequence, rather " +"than replacing them. Return the identifier of the bound function, which can " +"be passed to :meth:`tag_unbind`." +msgstr "" + +msgid "" +"Remove for all items given by *tagOrId* the binding for the event " +"*sequence*. If *funcid* is given, only that callback (as returned " +"by :meth:`tag_bind`) is unbound and deregistered." +msgstr "" + +msgid "If *funcid* is given, only that callback is unbound." +msgstr "" + +msgid "" +"Return a 4-tuple ``(x1, y1, x2, y2)`` giving an approximate bounding box, in " +"pixels, that encloses all the items given by *tagOrId* and any further " +"*tagOrIds*. The result may overestimate the true bounding box by a few " +"pixels. Return ``None`` if no item matches or the matching items have " +"nothing to display." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`!Misc.bbox`; use :meth:`~Misc.grid_bbox` " +"for the grid bounding box." +msgstr "" + +msgid "" +"Given a window x-coordinate *screenx*, return the canvas x-coordinate " +"displayed at that location. If *gridspacing* is given, the result is rounded " +"to the nearest multiple of *gridspacing* units." +msgstr "" + +msgid "" +"Given a window y-coordinate *screeny*, return the canvas y-coordinate " +"displayed at that location. If *gridspacing* is given, the result is rounded " +"to the nearest multiple of *gridspacing* units." +msgstr "" + +msgid "" +"With *tagOrId*, set the keyboard focus for the canvas to the first item " +"given by *tagOrId* that supports the insertion cursor; the focus is left " +"unchanged if no such item exists. If *tagOrId* is an empty string, reset the " +"focus so that no item has it. With no argument, return the id of the item " +"that currently has the focus, or an empty string if none does. An item only " +"displays the insertion cursor when both it is the focus item and its canvas " +"has the input focus." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`!Misc.focus`; use :meth:`~Misc.focus_set` " +"to focus the widget itself." +msgstr "" + +msgid "" +"Set the insertion cursor of the items given by *tagOrId* to just before the " +"character given by *index*. Items that do not support an insertion cursor " +"are unaffected. The cursor is only displayed when the item has the focus, " +"but its position may be set at any time." +msgstr "" + +msgid "" +"Return as an integer the numerical index within *tagOrId* corresponding to " +"*index*, which is a textual description of a position (for text items an " +"index into the characters, for line and polygon items an index into the " +"coordinates). If *tagOrId* matches several items, the first one that " +"supports indexing is used." +msgstr "" + +msgid "" +"Adjust the end of the selection in *tagOrId* nearest to *index* so that it " +"is at *index*, and make the other end the anchor point for " +"future :meth:`select_to` calls. If the selection is not currently in " +"*tagOrId*, this behaves like :meth:`select_to`." +msgstr "" + +msgid "Clear the selection if it is in this canvas; otherwise do nothing." +msgstr "" + +msgid "" +"Set the selection anchor point to just before the character given by *index* " +"in the item given by *tagOrId*. This does not change the selection itself; " +"it sets the fixed end for future :meth:`select_to` calls." +msgstr "" + +msgid "" +"Return the id of the item that holds the selection, or ``None`` if the " +"selection is not in this canvas. Unlike :meth:`find` and the ``find_*`` " +"methods, this returns the id as a string rather than an integer." +msgstr "" + +msgid "" +"Set the selection to the characters of *tagOrId* between the selection " +"anchor point and *index*, inclusive of *index*. The anchor point is the one " +"set by the most recent :meth:`select_adjust` or :meth:`select_from` call." +msgstr "" + +msgid "" +"Record *x*, *y* and the current view, for use with later :meth:`scan_dragto` " +"calls. This is typically bound to a mouse button press in the widget." +msgstr "" + +msgid "" +"Scroll the canvas by *gain* times the difference between *x*, *y* and the " +"coordinates passed to the last :meth:`scan_mark` call. This is typically " +"bound to mouse motion events in the widget, producing the effect of dragging " +"the canvas at high speed through its window." +msgstr "" + +msgid "" +"Generate a PostScript (Encapsulated PostScript, version 3.0) representation " +"of part or all of the canvas. If the *file* or *channel* option is given, " +"the PostScript is written there and an empty string is returned; otherwise " +"it is returned as a string. By default only the area currently visible in " +"the window is generated, so it is usually necessary either to " +"call :meth:`~Misc.update` first or to use the *width* and *height* options. " +"Supported options include *colormap*, *colormode*, *file*, *fontmap*, " +"*height*, *pageanchor*, *pageheight*, *pagewidth*, *pagex*, *pagey*, " +"*rotate*, *width*, *x* and *y*." +msgstr "" + +msgid "" +"A :class:`!Checkbutton` widget displays a textual string, bitmap or image " +"together with a square indicator, and toggles a boolean selection when " +"pressed. It has all the behavior of a simple button and, in addition, can be " +"selected: when selected the indicator is drawn with a check mark and the " +"associated variable is set to the ``onvalue``, and when deselected the " +"indicator is drawn empty and the variable is set to the ``offvalue``. " +"Inherits from :class:`Widget`. In addition to the standard widget options, a " +"checkbutton accepts the options documented in the Tk ``checkbutton`` manual " +"page, such as *variable*, *onvalue*, *offvalue* and *command*." +msgstr "" + +msgid "" +"Do just what would happen if the user pressed the checkbutton with the " +"mouse: toggle the selection state of the button and invoke the associated " +"command, if there is one. Return the result of the command, or an empty " +"string if no command is associated with the checkbutton. This is ignored if " +"the checkbutton's state is ``disabled``." +msgstr "" + +msgid "" +"Select the checkbutton and set the associated variable to its ``onvalue``." +msgstr "" + +msgid "" +"Deselect the checkbutton and set the associated variable to its ``offvalue``." +msgstr "" + +msgid "" +"Toggle the selection state of the button, redisplaying it and modifying its " +"associated variable to reflect the new state." +msgstr "" + +msgid "" +"Flash the checkbutton by redisplaying it several times, alternating between " +"the active and normal colors. At the end of the flash the checkbutton is " +"left in the same normal or active state as when the method was called. This " +"is ignored if the checkbutton's state is ``disabled``." +msgstr "" + +msgid "" +"An :class:`!Entry` widget displays a single line of text and lets the user " +"edit it. Inherits from :class:`Widget` and :class:`XView`; since entries can " +"hold strings too long to fit in the window, they support horizontal " +"scrolling through :meth:`~XView.xview`." +msgstr "" + +msgid "" +"In addition to the standard widget options, an entry accepts the options " +"documented in the Tk ``entry`` manual page. Notable ones are *textvariable* " +"(the name of a variable kept in sync with the entry's contents), *show* (if " +"set, each character is displayed as the given character rather than its true " +"value, useful for password entry), *validate* and *validatecommand* (which " +"together let a callback accept or reject edits), and *state* (one of " +"``'normal'``, ``'disabled'`` or ``'readonly'``)." +msgstr "" + +msgid "" +"Many of the methods below take an *index* argument that selects a character " +"in the entry's string. As described in the Tk ``entry`` manual page, *index* " +"may be a number (counting from 0), ``'insert'`` (the character just after " +"the insertion cursor), ``'end'`` (just after the last character), " +"``'anchor'`` (the selection anchor point), ``'sel.first'`` and " +"``'sel.last'`` (the ends of the selection), or ``@x`` (the character " +"covering pixel x-coordinate *x* in the window). Out-of-range indices are " +"rounded to the nearest legal value." +msgstr "" + +msgid "" +"Delete the characters from index *first* up to but not including index " +"*last*. If *last* is omitted, only the single character at *first* is " +"deleted." +msgstr "" + +msgid "Return the entry's current string." +msgstr "" + +msgid "Insert *string* just before the character given by *index*." +msgstr "" + +msgid "" +"Arrange for the insertion cursor to be displayed just before the character " +"given by *index*." +msgstr "" + +msgid "Return the numerical index corresponding to *index*." +msgstr "" + +msgid "" +"Locate the end of the selection nearest to the character given by *index*, " +"and adjust that end to be at *index* (including but not going beyond it); " +"the other end becomes the anchor point for future :meth:`selection_to` " +"calls. If there is no selection in the entry, a new one is created between " +"*index* and the most recent anchor point, inclusive. :meth:`select_adjust` " +"is an alias of :meth:`!selection_adjust`." +msgstr "" + +msgid "" +"Clear the selection if it is currently in this widget. If the selection is " +"not in this widget the method has no effect. :meth:`select_clear` is an " +"alias of :meth:`!selection_clear`." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`Misc.selection_clear`, which clears the X " +"selection; that method is not available on an :class:`Entry`." +msgstr "" + +msgid "" +"Set the selection anchor point to just before the character given by " +"*index*, without changing the selection. :meth:`select_from` is an alias " +"of :meth:`!selection_from`." +msgstr "" + +msgid "" +"Return ``True`` if there are characters selected in the entry, ``False`` " +"otherwise. :meth:`select_present` is an alias of :meth:`!selection_present`." +msgstr "" + +msgid "" +"Set the selection to include the characters starting with the one indexed by " +"*start* and ending with the one just before *end*. If *end* refers to the " +"same character as *start* or an earlier one, the selection is " +"cleared. :meth:`select_range` is an alias of :meth:`!selection_range`." +msgstr "" + +msgid "" +"Set the selection between the anchor point and *index*: if *index* is before " +"the anchor point, the selection runs from *index* up to but not including " +"the anchor; if *index* is after it, from the anchor up to but not including " +"*index*; if they coincide, nothing happens. The anchor point is the one set " +"by the most recent :meth:`selection_from` or :meth:`selection_adjust` call. " +"If there is no selection in the entry, a new one is created using the most " +"recent anchor point. :meth:`select_to` is an alias of :meth:`!selection_to`." +msgstr "" + +msgid "" +"Record *x* and the current view in the entry window, for use with " +"later :meth:`scan_dragto` calls. Typically associated with a mouse button " +"press in the widget." +msgstr "" + +msgid "" +"Compute the difference between *x* and the *x* given to the " +"last :meth:`scan_mark` call, and adjust the view left or right by 10 times " +"that difference. Typically associated with mouse motion events, to produce " +"the effect of dragging the entry at high speed through the window." +msgstr "" + +msgid "" +"A :class:`!Frame` widget is a simple container. Its primary purpose is to " +"act as a spacer or container for complex window layouts; its only features " +"are its background and an optional 3-D border to make the frame appear " +"raised or sunken. Inherits from :class:`Widget`. Refer to the Tk ``frame`` " +"manual page for the full list of options." +msgstr "" + +msgid "" +"A :class:`!Label` widget displays a non-interactive textual string, bitmap " +"or image. The displayed text is set with the *text* option or linked to a " +"variable through *textvariable*, and an image can be shown using the *image* " +"option. Text must all be in a single font but may occupy multiple lines, and " +"one character may be underlined with the *underline* option. Inherits " +"from :class:`Widget`. Refer to the Tk ``label`` manual page for the full " +"list of options." +msgstr "" + +msgid "" +"A :class:`!LabelFrame` widget is a container that has the features of " +"a :class:`Frame` plus the ability to display a label. The label text is set " +"with the *text* option and positioned with *labelanchor*, or an arbitrary " +"widget may be used as the label by giving it as the *labelwidget* option. " +"Inherits from :class:`Widget`. Refer to the Tk ``labelframe`` manual page " +"for the full list of options." +msgstr "" + +msgid "" +"A :class:`!Listbox` widget displays a list of single-line text items, one " +"per line, of which the user can select one or more. The way the selection " +"behaves is governed by the *selectmode* option, which is one of ``browse`` " +"(the default; at most one item, which may be dragged with the mouse), " +"``single`` (at most one item), ``multiple`` (any number of items, toggled " +"individually), or ``extended`` (any number of items, including discontiguous " +"ranges, selected by clicking and dragging). Inherits " +"from :class:`Widget`, :class:`XView` and :class:`YView`, so the view can be " +"scrolled horizontally and vertically with :meth:`~XView.xview` " +"and :meth:`~YView.yview`. Refer to the Tk ``listbox`` manual page for the " +"full list of options." +msgstr "" + +msgid "" +"Many of the methods take an *index* argument identifying a particular item. " +"As described in the Tk ``listbox`` manual page, *index* may be a numeric " +"index (counting from 0 at the top), ``'active'`` (the item with the location " +"cursor, set with :meth:`activate`), ``'anchor'`` (the selection anchor, set " +"with :meth:`selection_anchor`), ``'end'`` (the last item, or " +"for :meth:`index` and :meth:`insert` the position just after it), or " +"``@x,y`` (the item covering pixel coordinates *x*, *y* in the listbox " +"window). Arguments named *first* and *last* are indices of the same forms." +msgstr "" + +msgid "" +"Insert the given *elements* as new items just before the item given by " +"*index*. If *index* is ``'end'``, the new items are appended to the end of " +"the list." +msgstr "" + +msgid "" +"Delete the items in the range from *first* to *last* inclusive. If *last* is " +"omitted, it defaults to *first*, so that a single item is deleted." +msgstr "" + +msgid "" +"If *last* is omitted, return the contents of the item given by *first*, or " +"an empty string if *first* refers to a non-existent item. If *last* is " +"given, return a tuple of all the items in the range from *first* to *last* " +"inclusive." +msgstr "" + +msgid "Return the total number of items in the listbox." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`!Misc.size`; use :meth:`~Misc.grid_size` " +"for the grid size." +msgstr "" + +msgid "" +"Return the integer index value corresponding to *index*, or ``None`` if " +"*index* is out of range. If *index* is ``'end'``, the result is a count of " +"the number of items in the listbox (not the index of the last item)." +msgstr "" + +msgid "" +"Return a tuple ``(x, y, width, height)`` describing the bounding box, in " +"pixels relative to the widget, of the text of the item given by *index*. " +"Return ``None`` if no part of that item is visible on the screen, or if " +"*index* refers to a non-existent item; if the item is only partly visible, " +"the result still gives the full area of the item, including the parts that " +"are not visible." +msgstr "" + +msgid "" +"Given a y-coordinate within the listbox window, return the index of the " +"visible item nearest to that y-coordinate." +msgstr "" + +msgid "" +"Adjust the view so that the item given by *index* is visible. If the item is " +"already visible the method has no effect; if it is near an edge of the " +"window the listbox scrolls just enough to bring it into view at that edge, " +"otherwise the listbox scrolls to center the item." +msgstr "" + +msgid "" +"Set the active item to the one given by *index*. If *index* is outside the " +"range of items, the closest item is activated instead. The active item is " +"drawn as specified by the *activestyle* option when the widget has the input " +"focus, and its index may be retrieved with the ``'active'`` index." +msgstr "" + +msgid "" +"Return a tuple containing the numerical indices of all of the items that are " +"currently selected, or an empty tuple if no items are selected." +msgstr "" + +msgid "" +"Set the selection anchor to the item given by *index*. If *index* refers to " +"a non-existent item, the closest item is used. The selection anchor is the " +"end of the selection that is fixed while dragging out a selection with the " +"mouse, and may afterwards be referred to with the ``'anchor'`` " +"index. :meth:`select_anchor` is an alias of :meth:`!selection_anchor`." +msgstr "" + +msgid "" +"Deselect any of the items in the range from *first* to *last* inclusive that " +"are selected. The selection state of items outside this range is not " +"changed. :meth:`select_clear` is an alias of :meth:`!selection_clear`." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`Misc.selection_clear`, which clears the X " +"selection; that method is not available on a :class:`Listbox`." +msgstr "" + +msgid "" +"Return ``True`` if the item given by *index* is currently selected, " +"``False`` otherwise. :meth:`select_includes` is an alias of :meth:`!" +"selection_includes`." +msgstr "" + +msgid "" +"Select all of the items in the range from *first* to *last* inclusive, " +"without affecting the selection state of items outside that " +"range. :meth:`select_set` is an alias of :meth:`!selection_set`." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the item " +"given by *index*." +msgstr "" + +msgid "" +"Query or modify the configuration options of the item given by *index*. This " +"mirrors :meth:`~Misc.configure`, except that it applies to an individual " +"item rather than to the listbox as a whole. With no options, it returns a " +"dictionary describing the current options of the item; otherwise it sets the " +"given options. The supported item options are *background*, *foreground*, " +"*selectbackground* and *selectforeground*. :meth:`itemconfig` is an alias " +"of :meth:`!itemconfigure`." +msgstr "" + +msgid "" +"Scroll the listbox by 10 times the difference between *x*, *y* and the " +"coordinates passed to the last :meth:`scan_mark` call. This is typically " +"bound to mouse motion events in the widget, producing the effect of dragging " +"the list at high speed through the window." +msgstr "" + +msgid "" +"A :class:`!Menu` widget displays a column of entries, each of which may be a " +"command, a checkbutton, a radiobutton, a cascade (which posts an associated " +"submenu) or a separator. Menus are used as the menubar of a toplevel window, " +"as pulldown menus posted from a cascade entry or menubutton, and as popup " +"menus. Inherits from :class:`Widget`." +msgstr "" + +msgid "" +"Many of the entry methods take an *index* argument that selects which entry " +"to operate on. As described in the Tk ``menu`` manual page, *index* may be a " +"numeric index (counting from 0 at the top), ``'active'`` (the currently " +"active entry), ``'end'`` or ``'last'`` (the bottommost entry), ``'none'`` " +"(no entry at all, written ``{}`` in Tcl), ``@y`` (the entry covering pixel y-" +"coordinate *y* in the menu window), or a pattern matched against the labels " +"of the entries from the top down." +msgstr "" + +msgid "" +"Add a new entry to the bottom of the menu. *itemType* is one of " +"``'command'``, ``'cascade'``, ``'checkbutton'``, ``'radiobutton'`` or " +"``'separator'`` and determines the type of the new entry; the remaining " +"options configure it. The :meth:`!add_command`, :meth:`!" +"add_cascade`, :meth:`!add_checkbutton`, :meth:`!add_radiobutton` and :meth:`!" +"add_separator` convenience methods call this method with the corresponding " +"*itemType*." +msgstr "" + +msgid "" +"The entry is configured by the following options, although not every option " +"applies to every entry type (a separator accepts none of them):" +msgstr "" + +msgid "*label*" +msgstr "" + +msgid "The text to display in the entry." +msgstr "" + +msgid "*command*" +msgstr "" + +msgid "" +"The function to call when the entry is invoked (command, checkbutton and " +"radiobutton entries)." +msgstr "" + +msgid "*accelerator*" +msgstr "" + +msgid "" +"A string displayed at the right of the entry to advertise an accelerator " +"keystroke; it does not itself create the binding." +msgstr "" + +msgid "" +"The index of a character in the label to underline for keyboard traversal." +msgstr "" + +msgid "One of ``'normal'``, ``'active'`` or ``'disabled'``." +msgstr "" + +msgid "An image to display instead of, or together with, the text label." +msgstr "" + +msgid "*compound*" +msgstr "" + +msgid "" +"Where to show the image relative to the text: ``'none'`` (the default), " +"``'text'``, ``'image'``, ``'top'``, ``'bottom'``, ``'left'`` or ``'right'``." +msgstr "" + +msgid "A bitmap to display instead of the text label." +msgstr "" + +msgid "The font to use for the text." +msgstr "" + +msgid "" +"The entry's background and foreground colors in its normal state (ignored on " +"macOS)." +msgstr "" + +msgid "*activebackground*, *activeforeground*" +msgstr "" + +msgid "" +"The background and foreground colors used when the entry is active (ignored " +"on macOS)." +msgstr "" + +msgid "*columnbreak*" +msgstr "" + +msgid "" +"If true, the entry starts a new column instead of being placed below the " +"previous entry." +msgstr "" + +msgid "*hidemargin*" +msgstr "" + +msgid "" +"If true, the standard margin around the entry is omitted, which is useful " +"when a menu is used as a palette." +msgstr "" + +msgid "*menu*" +msgstr "" + +msgid "The submenu posted by a cascade entry; it must be a child of this menu." +msgstr "" + +msgid "*variable*" +msgstr "" + +msgid "The variable associated with a checkbutton or radiobutton entry." +msgstr "" + +msgid "*onvalue*, *offvalue*" +msgstr "" + +msgid "" +"The values stored in *variable* when a checkbutton entry is selected or " +"cleared." +msgstr "" + +msgid "*value*" +msgstr "" + +msgid "The value stored in *variable* when a radiobutton entry is selected." +msgstr "" + +msgid "*indicatoron*" +msgstr "" + +msgid "Whether to display the indicator of a checkbutton or radiobutton entry." +msgstr "" + +msgid "*selectcolor*" +msgstr "" + +msgid "" +"The color of the indicator of a checkbutton or radiobutton entry when it is " +"selected." +msgstr "" + +msgid "*selectimage*" +msgstr "" + +msgid "" +"The image displayed when a checkbutton or radiobutton entry is selected and " +"*image* is also given." +msgstr "" + +msgid "" +"Add a new cascade entry to the bottom of the menu. A cascade entry has an " +"associated submenu, given by its *menu* option, which must be a child of " +"this menu; posting the entry posts the submenu next to it." +msgstr "" + +msgid "" +"Add a new checkbutton entry to the bottom of the menu. When invoked, a " +"checkbutton entry toggles between its *onvalue* and *offvalue*, storing the " +"result in its associated *variable*, and displays an indicator showing " +"whether it is selected." +msgstr "" + +msgid "" +"Add a new command entry to the bottom of the menu. A command entry behaves " +"much like a button: when it is invoked, the callback given by its *command* " +"option is called." +msgstr "" + +msgid "" +"Add a new radiobutton entry to the bottom of the menu. Radiobutton entries " +"sharing the same *variable* form a group of which only one may be selected " +"at a time; selecting an entry stores its *value* in the variable." +msgstr "" + +msgid "" +"Add a separator to the bottom of the menu. A separator is displayed as a " +"horizontal dividing line and cannot be activated or invoked." +msgstr "" + +msgid "" +"Same as :meth:`add`, except that the new entry is inserted just before the " +"entry given by *index* instead of being appended to the end of the menu. " +"*itemType* is one of ``'command'``, ``'cascade'``, ``'checkbutton'``, " +"``'radiobutton'`` or ``'separator'``. The :meth:`!insert_command`, :meth:`!" +"insert_cascade`, :meth:`!insert_checkbutton`, :meth:`!insert_radiobutton` " +"and :meth:`!insert_separator` convenience methods call this method with the " +"corresponding *itemType*." +msgstr "" + +msgid "" +"Insert a new cascade entry before the entry given by *index* " +"(see :meth:`add_cascade`)." +msgstr "" + +msgid "" +"Insert a new checkbutton entry before the entry given by *index* " +"(see :meth:`add_checkbutton`)." +msgstr "" + +msgid "" +"Insert a new command entry before the entry given by *index* " +"(see :meth:`add_command`)." +msgstr "" + +msgid "" +"Insert a new radiobutton entry before the entry given by *index* " +"(see :meth:`add_radiobutton`)." +msgstr "" + +msgid "" +"Insert a separator before the entry given by *index* " +"(see :meth:`add_separator`)." +msgstr "" + +msgid "" +"Delete all of the menu entries between *index1* and *index2* inclusive. If " +"*index2* is omitted, it defaults to *index1*, so that a single entry is " +"deleted. Attempts to delete a tear-off entry are ignored; remove it by " +"changing the *tearoff* option instead." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the entry " +"given by *index*." +msgstr "" + +msgid "" +"Query or modify the configuration options of the entry given by *index*. " +"This mirrors :meth:`~Misc.configure`, except that it applies to an " +"individual entry rather than to the menu as a whole. With no options, it " +"returns a dictionary describing the current options of the entry; otherwise " +"it sets the given options. The supported options are those accepted " +"by :meth:`add` for the entry's type. :meth:`entryconfig` is an alias " +"of :meth:`!entryconfigure`." +msgstr "" + +msgid "" +"Return the numerical index corresponding to *index*, or ``None`` if *index* " +"selects no entry." +msgstr "" + +msgid "" +"Return the type of the entry given by *index*: one of ``'command'``, " +"``'cascade'``, ``'checkbutton'``, ``'radiobutton'``, ``'separator'`` or " +"``'tearoff'`` (for the tear-off entry)." +msgstr "" + +msgid "" +"Make the entry given by *index* the active entry, redisplaying it with its " +"active colors, and deactivate any previously active entry. If *index* " +"selects no entry, or the selected entry is disabled, the menu ends up with " +"no active entry." +msgstr "" + +msgid "" +"Invoke the action of the entry given by *index*, as if it had been clicked. " +"Nothing happens if the entry is disabled. If the entry has a *command* " +"associated with it, the result of that command is returned; otherwise the " +"result is an empty string." +msgstr "" + +msgid "" +"Display the menu on the screen at the root-window coordinates *x* and *y*, " +"adjusting them if necessary so that the whole menu is visible. If the " +"*postcommand* option has been specified, it is evaluated before the menu is " +"posted." +msgstr "" + +msgid "" +"Post the menu as a popup at the root-window coordinates *x* and *y*. If " +"*entry* is given, the menu is positioned so that this entry is displayed " +"under the pointer." +msgstr "" + +msgid "" +"Unmap the menu so that it is no longer displayed, also unposting any posted " +"lower-level cascaded submenu. This has no effect on Windows and macOS, which " +"manage the unposting of menus themselves." +msgstr "" + +msgid "" +"Return the x-coordinate, within the menu window, of the leftmost pixel of " +"the entry given by *index*." +msgstr "" + +msgid "" +"Return the y-coordinate, within the menu window, of the topmost pixel of the " +"entry given by *index*." +msgstr "" + +msgid "" +"A :class:`!Menubutton` widget displays a textual string, bitmap or image and " +"posts an associated :class:`Menu`, given by its *menu* option, when the user " +"presses it. Like a :class:`Label` it can show *text*, a *textvariable*, or " +"an *image*, and the *direction* option controls where the menu appears " +"relative to the button. Inherits from :class:`Widget`. Refer to the Tk " +"``menubutton`` manual page for the full list of options." +msgstr "" + +msgid "" +"A :class:`!Message` widget displays a non-interactive textual string, given " +"by the *text* option or linked to a variable through *textvariable*. Unlike " +"a :class:`Label`, it breaks the string into multiple lines in order to " +"produce a given aspect ratio, choosing line breaks at word boundaries, and " +"it can justify the text left, centered or right. Inherits " +"from :class:`Widget`. Refer to the Tk ``message`` manual page for the full " +"list of options." +msgstr "" + +msgid "" +"A helper subclass of :class:`Menubutton` that displays a pop-up menu of " +"mutually exclusive choices. *variable* is a :class:`Variable` kept in sync " +"with the selection, *value* is the initial choice, and *values* are the " +"remaining menu entries. The keyword argument *command* may be given a " +"callback that is invoked with the selected value." +msgstr "" + +msgid "Destroy the widget, also cleaning up the associated pop-up menu." +msgstr "" + +msgid "" +"A :class:`!PanedWindow` is a geometry-manager widget that arranges any " +"number of child *panes* in a row (when *orient* is ``'horizontal'``) or a " +"column (when *orient* is ``'vertical'``). Each pane holds one widget, and " +"each pair of adjacent panes is separated by a movable *sash* that the user " +"can drag with the mouse to resize the widgets on either side of it. Inherits " +"from :class:`Widget`." +msgstr "" + +msgid "" +"The *orient* option selects the layout direction, *sashwidth* sets the width " +"of each sash and *sashrelief* its relief. When *showhandle* is true a small " +"handle is drawn on each sash that the user can grab to drag it. Refer to the " +"Tk ``panedwindow`` manual page for the full list of options." +msgstr "" + +msgid "" +"Add *child* to the panedwindow as a new pane, placed after any existing " +"panes. The keyword arguments specify per-pane management options for " +"*child*; they may be any of the options accepted by :meth:`paneconfigure`." +msgstr "" + +msgid "" +"Remove the pane containing *child* from the panedwindow. All geometry " +"management options for *child* are forgotten. :meth:`forget` is an alias " +"of :meth:`!remove`. This shadows the inherited geometry-manager :meth:`!" +"forget`; use :meth:`~Pack.pack_forget`, :meth:`~Grid.grid_forget` " +"or :meth:`~Place.place_forget` to remove the widget itself from its manager." +msgstr "" + +msgid "" +"Return a tuple of the widgets managed by the panedwindow, one per pane, in " +"order." +msgstr "" + +msgid "" +"Return the current value of the management option *option* for the pane " +"containing *child*. *option* may be any value allowed " +"by :meth:`paneconfigure`." +msgstr "" + +msgid "" +"Query or modify the management options of the pane containing the widget " +"*tagOrId*. With no options, it returns a dictionary describing all of the " +"available options for the pane; given a single option name as a string, it " +"returns a description of that one option; otherwise it sets the given " +"options. The supported options include *after* and *before* (insert the pane " +"after or before another managed window), *height* and *width* (the outer " +"dimensions of the window, including any border), *minsize* (the minimum size " +"in the paned dimension), *padx* and *pady* (extra space to leave on each " +"side of the window), *sticky* (position or stretch the window within an " +"oversized pane, using a string of the characters ``n``, ``s``, ``e`` and " +"``w``), *hide* (hide the pane while keeping it in the list of panes) and " +"*stretch* (how extra space is allocated to the pane: one of ``'always'``, " +"``'first'``, ``'last'``, ``'middle'`` or ``'never'``). :meth:`paneconfig` is " +"an alias of :meth:`!paneconfigure`." +msgstr "" + +msgid "" +"Identify the panedwindow component underneath the point given by *x* and " +"*y*, in window coordinates. If the point is over a sash or a sash handle, " +"the result is a two-element tuple containing the index of the sash or handle " +"and a word indicating whether it is over a sash or a handle, such as ``(0, " +"'sash')`` or ``(2, 'handle')``. If the point is over any other part of the " +"panedwindow, the result is an empty string." +msgstr "" + +msgid "" +"Query or change the position of the sashes in the panedwindow. This is a " +"thin wrapper around the Tk ``sash`` subcommand; the convenience " +"methods :meth:`sash_coord`, :meth:`sash_mark` and :meth:`sash_place` should " +"normally be used instead." +msgstr "" + +msgid "" +"Return the current x and y coordinate pair for the sash given by *index*, " +"which must be an integer between 0 and one less than the number of panes in " +"the panedwindow. The coordinates returned are those of the top left corner " +"of the region containing the sash." +msgstr "" + +msgid "" +"Record the current mouse position for the sash given by *index*, for use " +"together with later sash-drag operations to move the sash." +msgstr "" + +msgid "Place the sash given by *index* at the coordinates *x* and *y*." +msgstr "" + +msgid "" +"Query or change the position of the sash proxy, the \"ghost\" sash shown " +"while a sash is being dragged with non-opaque resizing. This is a thin " +"wrapper around the Tk ``proxy`` subcommand; the convenience " +"methods :meth:`proxy_coord`, :meth:`proxy_forget` and :meth:`proxy_place` " +"should normally be used instead." +msgstr "" + +msgid "" +"Return a tuple containing the x and y coordinates of the most recent proxy " +"location." +msgstr "" + +msgid "Remove the proxy from the display." +msgstr "" + +msgid "Place the proxy at the coordinates *x* and *y*." +msgstr "" + +msgid "" +"A :class:`!Radiobutton` widget displays a textual string, bitmap or image " +"together with a diamond or circular indicator, and selects one choice out of " +"several. It has all the behavior of a simple button and, in addition, can be " +"selected: typically several radiobuttons share a single *variable*, and " +"selecting one sets that variable to the radiobutton's *value*; each " +"radiobutton also monitors the variable and automatically selects or " +"deselects itself when the variable changes. Inherits from :class:`Widget`. " +"In addition to the standard widget options, a radiobutton accepts the " +"options documented in the Tk ``radiobutton`` manual page, such as " +"*variable*, *value* and *command*." +msgstr "" + +msgid "" +"Do just what would happen if the user pressed the radiobutton with the " +"mouse: select the button and invoke the associated command, if there is one. " +"Return the result of the command, or an empty string if no command is " +"associated with the radiobutton. This is ignored if the radiobutton's state " +"is ``disabled``." +msgstr "" + +msgid "" +"Select the radiobutton and set the associated variable to the value " +"corresponding to this widget." +msgstr "" + +msgid "" +"Deselect the radiobutton and set the associated variable to an empty string. " +"If this radiobutton was not currently selected, this has no effect." +msgstr "" + +msgid "" +"Flash the radiobutton by redisplaying it several times, alternating between " +"the active and normal colors. At the end of the flash the radiobutton is " +"left in the same normal or active state as when the method was called. This " +"is ignored if the radiobutton's state is ``disabled``." +msgstr "" + +msgid "" +"A :class:`!Scale` widget lets the user select a numerical value by moving a " +"slider along a trough. It can be oriented vertically or horizontally and can " +"optionally display a label and the current value. Inherits " +"from :class:`Widget`." +msgstr "" + +msgid "" +"In addition to the standard widget options, a scale accepts the options " +"documented in the Tk ``scale`` manual page, such as *from_*, *to*, " +"*resolution*, *orient*, *tickinterval*, *variable* and *command*. As " +"elsewhere in :mod:`!tkinter`, the leading ``-`` of the Tk option name is " +"dropped; *from* is spelled ``from_`` because :keyword:`from` is a Python " +"keyword." +msgstr "" + +msgid "" +"With a non-integer *resolution*, see :ref:`numeric values and the locale " +"`." +msgstr "" + +msgid "" +"Return the current value of the scale. The result is an integer if the " +"scale's *resolution* yields whole numbers, and a float otherwise." +msgstr "" + +msgid "" +"Set the scale to *value*, moving the slider accordingly. This has no effect " +"if the scale is disabled." +msgstr "" + +msgid "" +"Return a tuple ``(x, y)`` giving the pixel coordinates, relative to the " +"widget, of the point on the centerline of the trough that corresponds to " +"*value*. If *value* is omitted, the scale's current value is used." +msgstr "" + +msgid "" +"Return a string describing the part of the scale at the pixel coordinates " +"*x*, *y*: ``'slider'``, ``'trough1'`` (the part of the trough above or to " +"the left of the slider), ``'trough2'`` (below or to the right of the " +"slider), or an empty string if the point is not over any of these elements." +msgstr "" + +msgid "" +"A :class:`!Scrollbar` widget displays a slider and two arrows that let the " +"user scroll an associated widget, such as " +"a :class:`Listbox`, :class:`Text`, :class:`Canvas` or :class:`Entry`. It is " +"connected to the scrolled widget by setting that widget's *xscrollcommand* " +"or *yscrollcommand* option to the scrollbar's :meth:`set` method, and the " +"scrollbar's *command* option to the scrolled widget's :meth:`~XView.xview` " +"or :meth:`~YView.yview` method. Inherits from :class:`Widget`." +msgstr "" + +msgid "" +"Return the current scrollbar settings as a tuple ``(first, last)`` of two " +"fractions between 0 and 1, describing the portion of the document that is " +"currently visible, as last passed to :meth:`set`." +msgstr "" + +msgid "" +"Set the scrollbar. *first* and *last* are fractions between 0 and 1 giving " +"the positions of the start and end of the visible portion of the associated " +"document. This method is normally registered as the scrolled widget's " +"*xscrollcommand* or *yscrollcommand* and called by that widget." +msgstr "" + +msgid "" +"Mark the element *index* (one of ``'arrow1'``, ``'slider'`` or ``'arrow2'``) " +"as active, displaying it according to the *activebackground* and " +"*activerelief* options. If *index* is omitted, return the name of the " +"currently active element, or ``None`` if no element is active." +msgstr "" + +msgid "The *index* argument is now optional." +msgstr "" + +msgid "" +"Return a float indicating the fractional change in the scrollbar setting " +"that corresponds to moving the slider by *deltax* pixels horizontally (for " +"horizontal scrollbars) or *deltay* pixels vertically (for vertical " +"scrollbars)." +msgstr "" + +msgid "" +"Return a float between 0 and 1 indicating where the point at pixel " +"coordinates *x*, *y* lies in the trough: 0 corresponds to the top or left of " +"the trough and 1 to the bottom or right." +msgstr "" + +msgid "" +"Return the name of the element under the pixel coordinates *x*, *y* (such as " +"``'arrow1'``), or an empty string if the point does not lie in any element " +"of the scrollbar." +msgstr "" + +msgid "" +"A :class:`!Spinbox` widget is an :class:`Entry`-like widget with a pair of " +"up/down arrow buttons that let the user step through a range of values in " +"addition to editing the value directly. The set of values may be a numeric " +"range given by the *from_*, *to* and *increment* options, or an explicit " +"list of strings given by the *values* option (which takes precedence over " +"the range). Each time an arrow is invoked the *command* callback, if any, is " +"called; the *wrap* option controls whether stepping past either end of the " +"range wraps around to the other end; the *format* option specifies how " +"numeric values are formatted; and the *validate* option enables validation " +"of the entered text. Inherits from :class:`Widget` and :class:`XView`." +msgstr "" + +msgid "" +"With a non-integer *increment*, see :ref:`numeric values and the locale " +"`." +msgstr "" + +msgid "" +"Many of the methods take an *index* argument identifying a character in the " +"spinbox's string. As described in the Tk ``spinbox`` manual page, *index* " +"may be a numeric index (counting from 0), ``'anchor'`` (the selection anchor " +"point), ``'end'`` (just after the last character), ``'insert'`` (the " +"character just after the insertion cursor), ``'sel.first'`` or " +"``'sel.last'`` (the ends of the selection), or ``@x`` (the character " +"covering pixel x-coordinate *x* in the window)." +msgstr "" + +msgid "Return the spinbox's string." +msgstr "" + +msgid "" +"Insert the characters of the string *s* just before the character given by " +"*index*." +msgstr "" + +msgid "" +"Delete one or more characters of the spinbox. *first* is the index of the " +"first character to delete, and *last* is the index of the character just " +"after the last one to delete. If *last* is omitted, a single character at " +"*first* is deleted." +msgstr "" + +msgid "Return the numerical index corresponding to *index*, as a string." +msgstr "" + +msgid "" +"Return a tuple of four integers ``(x, y, width, height)`` describing the " +"bounding box of the character given by *index*. *x* and *y* are the pixel " +"coordinates of the upper-left corner of the character relative to the " +"widget, and *width* and *height* are its size in pixels. The bounding box " +"may refer to a region outside the visible area of the window." +msgstr "" + +msgid "" +"Return the name of the window element at the pixel coordinates *x*, *y*: one " +"of ``'buttondown'``, ``'buttonup'``, ``'entry'`` or ``'none'``." +msgstr "" + +msgid "" +"Invoke the spin button given by *element*, either ``'buttonup'`` or " +"``'buttondown'``, triggering the action associated with it." +msgstr "" + +msgid "" +"A thin wrapper around the Tk ``scan`` widget subcommand, used to implement " +"fast dragging of the view: ``scan('mark', x)`` records *x* and the current " +"view, and ``scan('dragto', x)`` adjusts the view relative to that mark. " +"The :meth:`scan_mark` and :meth:`scan_dragto` methods wrap the two forms." +msgstr "" + +msgid "" +"Record *x* and the current view in the spinbox window, for use with a " +"later :meth:`scan_dragto` call. This is typically associated with a mouse " +"button press in the widget." +msgstr "" + +msgid "" +"Adjust the view by 10 times the difference between *x* and the *x* passed to " +"the last :meth:`scan_mark` call. This is typically associated with mouse " +"motion events, producing the effect of dragging the spinbox at high speed " +"through the window." +msgstr "" + +msgid "" +"A thin wrapper around the Tk ``selection`` widget subcommand, used to adjust " +"the selection within the spinbox. It has several forms depending on the " +"first argument, such as ``selection('adjust', index)``, " +"``selection('clear')``, ``selection('element', ?elem?)``, " +"``selection('from', index)``, ``selection('present')``, ``selection('range', " +"start, end)`` and ``selection('to', index)``. " +"The :meth:`selection_adjust`, :meth:`selection_clear`, :meth:`selection_element`, :meth:`selection_from`, :meth:`selection_present`, :meth:`selection_range` " +"and :meth:`selection_to` methods wrap these forms." +msgstr "" + +msgid "" +"Locate the end of the selection nearest to the character given by *index* " +"and adjust that end of the selection to be at *index* (including but not " +"going beyond *index*). The other end becomes the anchor point for " +"future :meth:`selection_to` calls. If the selection is not currently in the " +"spinbox, a new selection is created to include the characters between " +"*index* and the most recent anchor point, inclusive." +msgstr "" + +msgid "" +"Clear the selection if it is currently in this widget. If the selection is " +"not in this widget, the method has no effect." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`Misc.selection_clear`, which clears the X " +"selection; that method is not available on a :class:`Spinbox`." +msgstr "" + +msgid "" +"Set or get the currently selected element. If *element* (one of " +"``'buttonup'``, ``'buttondown'`` or ``'none'``) is given, that spin button " +"is selected and displayed depressed; otherwise the name of the currently " +"selected element is returned." +msgstr "" + +msgid "" +"Set the selection anchor point to just before the character given by " +"*index*, without changing the selection itself." +msgstr "" + +msgid "" +"Return ``True`` if there are characters selected in the spinbox, ``False`` " +"otherwise." +msgstr "" + +msgid "" +"Set the selection to include the characters starting with the one indexed by " +"*start* and ending with the one just before *end*. If *end* refers to the " +"same character as *start* or an earlier one, the selection is cleared." +msgstr "" + +msgid "" +"Set the selection between *index* and the anchor point. If *index* is before " +"the anchor point, the selection runs from *index* up to but not including " +"the anchor point; if it is after, the selection runs from the anchor point " +"up to but not including *index*; if it is the same, nothing happens. The " +"anchor point is the one set by the most recent :meth:`selection_from` " +"or :meth:`selection_adjust` call. If the selection is not in this widget, a " +"new selection is created using the most recent anchor point." +msgstr "" + +msgid "" +"A :class:`!Text` widget displays and edits multi-line text. Portions of the " +"text may be styled with **tags**, particular positions may be annotated with " +"floating **marks**, and arbitrary images and other widgets may be embedded " +"in the text. The widget also provides an unlimited undo/redo mechanism and " +"supports peer widgets that share the same underlying data. Inherits " +"from :class:`Widget`, :class:`XView` and :class:`YView`, so the view can be " +"scrolled horizontally and vertically with :meth:`~XView.xview` " +"and :meth:`~YView.yview`. Refer to the Tk ``text`` manual page for the full " +"list of options." +msgstr "" + +msgid "" +"Most of the methods take one or more *index* arguments that identify a " +"position within the text. As described in the Tk ``text`` manual page, an " +"index is a string consisting of a base, optionally followed by one or more " +"modifiers. The base may be ``'line.char'`` (line *line*, character *char*, " +"where lines are counted from 1 and characters within a line from 0; " +"``'line.end'`` refers to the newline ending the line), ``'end'`` (the " +"position just after the last newline), the name of a mark, ``'tag.first'`` " +"or ``'tag.last'`` (the first character tagged with *tag*, or the position " +"just after the last such character), the name of an embedded image or " +"window, or ``@x,y`` (the character covering pixel coordinates *x*, *y* in " +"the widget). A modifier such as ``'+5 chars'``, ``'-3 lines'``, " +"``'linestart'``, ``'lineend'``, ``'wordstart'`` or ``'wordend'`` adjusts the " +"index relative to its base; several modifiers may be combined and are " +"applied from left to right, for example ``'insert wordstart - 1 c'``." +msgstr "" + +msgid "" +"Insert the string *chars* just before the character at *index* (if *index* " +"is ``'end'``, just before the final newline). By default the new text " +"inherits any tags present on both sides of the insertion point. If *args* is " +"given, it consists of alternating *tagList*, *chars* values: the preceding " +"*chars* receives exactly the tags listed (a tag list may be a single tag " +"name or a sequence of names), overriding the surrounding tags." +msgstr "" + +msgid "" +"Delete the range of characters from *index1* up to but not including " +"*index2*. If *index2* is omitted, the single character at *index1* is " +"deleted. The widget always keeps a newline as its last character, so a " +"deletion that would remove it is adjusted accordingly." +msgstr "" + +msgid "" +"Replace the range of characters from *index1* up to but not including " +"*index2* with *chars*. This is equivalent to a :meth:`delete` followed by " +"an :meth:`insert` at *index1*; *args* is interpreted as for :meth:`insert`." +msgstr "" + +msgid "" +"Return the text from *index1* up to but not including *index2* as a string. " +"If *index2* is omitted, return the single character at *index1*. Embedded " +"images and windows are omitted from the result." +msgstr "" + +msgid "" +"Return the position corresponding to *index* in the canonical " +"``'line.char'`` form." +msgstr "" + +msgid "" +"Compare the positions of *index1* and *index2* using the relational operator " +"*op*, which must be one of ``'<'``, ``'<='``, ``'=='``, ``'>='``, ``'>'`` or " +"``'!='``, and return the boolean result." +msgstr "" + +msgid "" +"Count the number of items of the requested kinds between *index1* and " +"*index2*; the count is negative if *index1* is after *index2*. Each of " +"*options* names a kind of item to count: ``'chars'``, ``'displaychars'``, " +"``'displayindices'``, ``'displaylines'``, ``'indices'``, ``'lines'``, " +"``'xpixels'`` or ``'ypixels'`` (the default, used when no option is given, " +"is ``'indices'``). The pseudo-option ``'update'`` forces any out-of-date " +"layout information to be recalculated before the following options are " +"evaluated. When *return_ints* is true and a single counting option is given, " +"return a plain integer; otherwise return a tuple with one integer per " +"counting option (or ``None`` if the result is empty)." +msgstr "" + +msgid "Added the *return_ints* parameter." +msgstr "" + +msgid "" +"Adjust the view so that the character given by *index* is visible. If it is " +"already visible the method has no effect; if it is a short distance out of " +"view the widget scrolls just enough to bring it to the nearest edge, " +"otherwise it scrolls to center *index* in the window." +msgstr "" + +msgid "" +"Return a tuple ``(x, y, width, height)`` giving the bounding box, in pixels, " +"of the visible part of the character at *index*, or ``None`` if that " +"character is not visible on the screen." +msgstr "" + +msgid "" +"Return a tuple ``(x, y, width, height, baseline)`` describing the display " +"line that contains *index*: the first four values give the bounding box of " +"the line in pixels and *baseline* gives the offset of the baseline measured " +"down from the top of the area. Return ``None`` if that display line is not " +"visible on the screen." +msgstr "" + +msgid "" +"Set the mark named *markName* to the position just before the character at " +"*index*, creating the mark if it does not already exist. A mark created this " +"way has right gravity by default." +msgstr "" + +msgid "" +"Remove each of the marks named in *markNames*. The special ``insert`` and " +"``current`` marks may not be removed." +msgstr "" + +msgid "Return a tuple of the names of all marks currently set in the widget." +msgstr "" + +msgid "" +"If *direction* is omitted, return the gravity of mark *markName*, either " +"``'left'`` or ``'right'``. Otherwise set its gravity to *direction*. The " +"gravity determines on which side of the mark text inserted at the mark's " +"position appears: a mark with right gravity (the default) stays to the right " +"of such text." +msgstr "" + +msgid "" +"Return the name of the first mark at or after *index*, or ``None`` if there " +"is none. When *index* is the name of a mark, the search starts just after " +"that mark." +msgstr "" + +msgid "" +"Return the name of the last mark at or before *index*, or ``None`` if there " +"is none. When *index* is the name of a mark, the search starts just before " +"that mark." +msgstr "" + +msgid "" +"Add the tag *tagName* to the range of characters from *index1* up to but not " +"including the next index in *args*. Further pairs of indices may follow in " +"*args* to tag additional ranges; a trailing single index tags just the " +"character at that index." +msgstr "" + +msgid "" +"Remove the tag *tagName* from the characters from *index1* up to but not " +"including *index2* (or from the single character at *index1* if *index2* is " +"omitted). The tag itself continues to exist even if no characters carry it." +msgstr "" + +msgid "" +"Delete each of the tags named in *tagNames*, removing them from all " +"characters and discarding their options and bindings." +msgstr "" + +msgid "" +"Query or modify the configuration options of the tag *tagName*. This " +"mirrors :meth:`~Misc.configure`, except that it applies to a tag rather than " +"to the widget as a whole: with no options it returns a dictionary describing " +"the current options, otherwise it sets the given options. Defining a tag " +"this way also gives it a priority higher than any existing tag." +msgstr "" + +msgid "" +"The supported tag options, all controlling the appearance of the tagged " +"text, are:" +msgstr "" + +msgid "*foreground*" +msgstr "" + +msgid "The color to use for the text." +msgstr "" + +msgid "*background*" +msgstr "" + +msgid "The color to use for the area behind the text." +msgstr "" + +msgid "*fgstipple*, *bgstipple*" +msgstr "" + +msgid "" +"Bitmaps used to stipple the foreground (text) and the background; only well " +"supported on X11." +msgstr "" + +msgid "*borderwidth*" +msgstr "" + +msgid "" +"The width of the border drawn around the text according to *relief* (default " +"``0``)." +msgstr "" + +msgid "*relief*" +msgstr "" + +msgid "" +"The 3-D appearance of the text's border: ``'flat'`` (the default), " +"``'raised'``, ``'sunken'``, ``'ridge'``, ``'groove'`` or ``'solid'``." +msgstr "" + +msgid "*offset*" +msgstr "" + +msgid "" +"How far the text is raised above (or, if negative, lowered below) the " +"baseline, for superscripts and subscripts." +msgstr "" + +msgid "Whether to underline the text." +msgstr "" + +msgid "*underlinefg*" +msgstr "" + +msgid "The color of the underline; it defaults to the text color." +msgstr "" + +msgid "*overstrike*" +msgstr "" + +msgid "Whether to draw a line through the middle of the text." +msgstr "" + +msgid "*overstrikefg*" +msgstr "" + +msgid "The color of the overstrike line; it defaults to the text color." +msgstr "" + +msgid "*elide*" +msgstr "" + +msgid "Whether the text is elided (hidden)." +msgstr "" + +msgid "" +"How to justify the first character of a display line: ``'left'`` (the " +"default), ``'right'`` or ``'center'``." +msgstr "" + +msgid "*wrap*" +msgstr "" + +msgid "" +"How to wrap lines that are too long: ``'char'``, ``'word'`` or ``'none'``." +msgstr "" + +msgid "*lmargin1*, *lmargin2*" +msgstr "" + +msgid "" +"The indentation, in pixels, of the first display line of a logical line and " +"of the remaining display lines." +msgstr "" + +msgid "*lmargincolor*" +msgstr "" + +msgid "The color of the left margin area." +msgstr "" + +msgid "*rmargin*" +msgstr "" + +msgid "The right-hand margin, in pixels." +msgstr "" + +msgid "*rmargincolor*" +msgstr "" + +msgid "The color of the right margin area." +msgstr "" + +msgid "*spacing1*, *spacing2*, *spacing3*" +msgstr "" + +msgid "" +"Extra space, in pixels, above the first display line of a logical line, " +"between its display lines, and below its last display line." +msgstr "" + +msgid "*tabs*" +msgstr "" + +msgid "The set of tab stops, in the same form as the widget's *tabs* option." +msgstr "" + +msgid "*tabstyle*" +msgstr "" + +msgid "How tab stops are interpreted: ``'tabular'`` or ``'wordprocessor'``." +msgstr "" + +msgid "*selectbackground*, *selectforeground*" +msgstr "" + +msgid "" +"The background and foreground colors used for the text while it is selected." +msgstr "" + +msgid "" +"Tk 8.6 added the *lmargincolor*, *overstrikefg*, *rmargincolor*, " +"*selectbackground*, *selectforeground* and *underlinefg* options." +msgstr "" + +msgid ":meth:`tag_config` is an alias of :meth:`!tag_configure`." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the tag " +"*tagName*." +msgstr "" + +msgid "" +"If *index* is omitted, return a tuple of the names of all tags defined in " +"the widget; otherwise return only the names of the tags applied to the " +"character at *index*. The names are ordered from lowest to highest priority." +msgstr "" + +msgid "" +"Return a tuple of indices describing all ranges of text tagged with " +"*tagName*. The result alternates start and end indices, so that elements " +"``2*i`` and ``2*i+1`` bound the *i*-th range." +msgstr "" + +msgid "" +"Search forward from *index1* (up to *index2* if given) for the first range " +"of characters tagged with *tagName*, and return a two-element tuple of its " +"start and end indices, or an empty tuple if there is no such range." +msgstr "" + +msgid "" +"Search backward from *index1* (down to *index2* if given) for the nearest " +"preceding range of characters tagged with *tagName*, and return a two-" +"element tuple of its start and end indices, or an empty tuple if there is no " +"such range." +msgstr "" + +msgid "" +"Raise the priority of tag *tagName* so that it is just above the priority of " +"*aboveThis*, or to the highest priority of all tags if *aboveThis* is " +"omitted. When the display options of overlapping tags conflict, the higher-" +"priority tag wins." +msgstr "" + +msgid "" +"Lower the priority of tag *tagName* so that it is just below the priority of " +"*belowThis*, or to the lowest priority of all tags if *belowThis* is omitted." +msgstr "" + +msgid "" +"Bind the event *sequence* on characters tagged with *tagName* to the " +"callback *func*, so that *func* is invoked when that event occurs over such " +"a character. If *add* is true the binding is added alongside any existing " +"bindings for *sequence*, otherwise it replaces them. Works " +"like :meth:`~Misc.bind` and returns the identifier of the new binding." +msgstr "" + +msgid "" +"Remove the bindings of the event *sequence* on characters tagged with " +"*tagName*. If *funcid* is given, only that binding (as returned " +"by :meth:`tag_bind`) is removed and its callback is unregistered." +msgstr "" + +msgid "" +"Embed an image at *index* and return the name assigned to this image " +"instance, which may then be used as an index or passed to the other " +"``image_*`` methods. The options, given in *cnf* and *kw*, include *image* " +"(the Tk image to display), *name* (a base name for the instance), *align*, " +"*padx* and *pady*." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the " +"embedded image at *index*." +msgstr "" + +msgid "" +"Query or modify the configuration options of the embedded image at *index*, " +"like :meth:`~Misc.configure` but applied to that image." +msgstr "" + +msgid "Return a tuple of the names of all images embedded in the widget." +msgstr "" + +msgid "" +"This shadows the inherited :meth:`Misc.image_names`, which returns the names " +"of all images in the Tcl interpreter; that method is not available on " +"a :class:`Text`." +msgstr "" + +msgid "" +"Embed a window (any widget) at *index*. The options, given in *cnf* and " +"*kw*, include *window* (the widget to embed), *create* (a callback that " +"creates the widget on demand), *align*, *stretch*, *padx* and *pady*. The " +"embedded widget must be a descendant of the text widget's parent." +msgstr "" + +msgid "" +"Return the current value of the configuration option *option* for the " +"embedded window at *index*." +msgstr "" + +msgid "" +"Query or modify the configuration options of the embedded window at *index*, " +"like :meth:`~Misc.configure` but applied to that window." +msgstr "" + +msgid ":meth:`window_config` is an alias of :meth:`!window_configure`." +msgstr "" + +msgid "Return a tuple of the names of all windows embedded in the widget." +msgstr "" + +msgid "" +"Low-level wrapper around the Tk ``edit`` widget command that controls the " +"undo/redo mechanism and the modified flag; *args* is the ``edit`` subcommand " +"and its arguments. The :meth:`!edit_\\*` methods below are thin wrappers " +"around it and are usually more convenient." +msgstr "" + +msgid "" +"If *arg* is omitted, return the current state of the modified flag as true " +"or false; the flag is set automatically whenever the text is inserted or " +"deleted. Otherwise set the flag to the boolean *arg*." +msgstr "" + +msgid "" +"Undo the most recent edit action, that is, all the inserts and deletes " +"recorded on the undo stack since the previous separator, and move it to the " +"redo stack. Raises :exc:`TclError` if the undo stack is empty. Has no effect " +"unless the *undo* option is true. Since Tk 9.0, returns a tuple of indices " +"delimiting the ranges of text that were changed." +msgstr "" + +msgid "" +"Reapply the most recently undone edit action, provided no further edits have " +"been made since, and move it back to the undo stack. Raises :exc:`TclError` " +"if the redo stack is empty. Has no effect unless the *undo* option is true. " +"Since Tk 9.0, returns a tuple of indices delimiting the ranges of text that " +"were changed." +msgstr "" + +msgid "Clear the undo and redo stacks." +msgstr "" + +msgid "" +"Push a separator onto the undo stack, marking a boundary between edit " +"actions for undo and redo. Has no effect unless the *undo* option is true. " +"Separators are inserted automatically when the *autoseparators* option is " +"true." +msgstr "" + +msgid "" +"Search for *pattern* starting at *index* and return the index of the first " +"character of the first match, or an empty string if there is no match. " +"Searching stops at *stopindex* if given; otherwise it wraps around the ends " +"of the text until the starting position is reached again. The following " +"boolean keyword flags control the search: *forwards* or *backwards* select " +"the direction (forward is the default); *exact* (the default) or *regexp* " +"select literal or regular-expression matching; *nocase* makes the match case-" +"insensitive; and *elide* causes hidden text to be searched as well. If " +"*count* is a :class:`Variable`, the number of index positions in the match " +"is stored in it." +msgstr "" + +msgid "" +"Scroll the widget by 10 times the difference between *x*, *y* and the " +"coordinates passed to the last :meth:`scan_mark` call. This is typically " +"bound to mouse motion events, producing the effect of dragging the text at " +"high speed through the window." +msgstr "" + +msgid "" +"If *boolean* is omitted, return whether internal consistency checks of the B-" +"tree data structure are enabled. Otherwise enable or disable them. The " +"setting is shared by all text widgets and may noticeably slow down widgets " +"holding large amounts of text." +msgstr "" + +msgid "" +"Return the contents of the widget from *index1* up to but not including " +"*index2* (or just the segment at *index1* if *index2* is omitted), including " +"text and information about marks, tags, images and windows. The result is a " +"list of ``(key, value, index)`` triples, where *key* is one of ``'text'``, " +"``'mark'``, ``'tagon'``, ``'tagoff'``, ``'image'`` or ``'window'``. By " +"default all kinds are reported; passing any of the keyword arguments *all*, " +"*text*, *mark*, *tag*, *image* or *window* as true restricts the dump to the " +"selected kinds. If *command* is given, it is called once per triple with the " +"three values as arguments and nothing is returned." +msgstr "" + +msgid "" +"Create a peer text widget with the path name *newPathName* that shares this " +"widget's underlying data (text, marks, tags, images and the undo stack). " +"Changes made through any peer are reflected in all of them. By default the " +"peer covers the same lines as this widget; standard text options, including " +"*startline* and *endline*, may be given to override this." +msgstr "" + +msgid "" +"Return a tuple of the path names of this widget's peers, not including the " +"widget itself." +msgstr "" + +msgid "" +"Adjust the view so that the location given by *what* is visible. This is an " +"obsolete equivalent of :meth:`see`, which should be used instead." +msgstr "" + +msgid "Variable classes" +msgstr "" + +msgid "" +"The base class for the Tk variable wrappers. A Tk variable is a value stored " +"in the Tcl interpreter that can be linked to widgets through their " +"*variable* or *textvariable* options (see :ref:`coupling-widget-variables`), " +"so that changes propagate both ways: updating the variable updates every " +"widget bound to it, and a user editing such a widget updates the variable." +msgstr "" + +msgid "" +"*master* is the widget whose Tcl interpreter owns the variable; if omitted, " +"the default root window is used. *value* is the initial value; if omitted, a " +"type-specific default is used. *name* is the name of the variable in the Tcl " +"interpreter; if omitted, a unique name of the form ``'PY_VARnum'`` is " +"generated. If *name* matches an existing variable and *value* is omitted, " +"the existing value is retained." +msgstr "" + +msgid "" +"In most cases you should use one of the typed subclasses below " +"-- :class:`StringVar`, :class:`IntVar`, :class:`DoubleVar` " +"or :class:`BooleanVar` -- rather than :class:`!Variable` directly." +msgstr "" + +msgid "" +"When a :class:`!Variable` is garbage collected, its Tcl variable is unset. " +"Keep a reference to it for as long as a widget is linked to it, for example " +"by storing it as an attribute rather than in a local variable. Otherwise Tk " +"recreates the Tcl variable to keep the widget working, but it is never unset " +"again, leaking one Tcl variable per dropped wrapper." +msgstr "" + +msgid "" +"Two variables now compare equal (``==``) only when they have the same name, " +"are of the same class, and belong to the same Tcl interpreter." +msgstr "" + +msgid "" +"Return the current value of the variable. For the base class the value is " +"returned as a string; the typed subclasses convert it to the appropriate " +"Python type." +msgstr "" + +msgid "" +"Set the variable to *value*. :meth:`initialize` is an alias of :meth:`!set`." +msgstr "" + +msgid "The *initialize* spelling." +msgstr "" + +msgid "" +"Register *callback* to be called when the variable is accessed according to " +"*mode*. *mode* is one of the strings ``'array'``, ``'read'``, ``'write'`` or " +"``'unset'``, or a list or tuple of such strings." +msgstr "" + +msgid "" +"When triggered, *callback* is called with three arguments: the name of the " +"Tcl variable, an index (or an empty string if the variable is not an element " +"of an array), and the *mode* that triggered the call." +msgstr "" + +msgid "" +"Return the internal name of the registered callback, which can be passed " +"to :meth:`trace_remove`." +msgstr "" + +msgid "" +"Remove a trace callback from the variable. *mode* must match the *mode* that " +"was passed to :meth:`trace_add`, and *cbname* is the callback name returned " +"by :meth:`trace_add`." +msgstr "" + +msgid "" +"Return a list of ``(modes, cbname)`` pairs describing all traces currently " +"set on the variable, where *modes* is a tuple of mode strings and *cbname* " +"is the internal callback name." +msgstr "" + +msgid "" +"Register *callback* to be called when the variable is accessed according to " +"*mode*. *mode* is one of the strings ``'r'``, ``'w'`` or ``'u'``, for read, " +"write or unset. Return the internal name of the registered " +"callback. :meth:`trace` is an alias of :meth:`!trace_variable`." +msgstr "" + +msgid "" +"Use :meth:`trace_add` instead. This method wraps a Tcl feature that was " +"removed in Tcl 9.0." +msgstr "" + +msgid "" +"Remove the trace callback named *cbname* registered for *mode* " +"with :meth:`trace_variable`." +msgstr "" + +msgid "" +"Use :meth:`trace_remove` instead. This method wraps a Tcl feature that was " +"removed in Tcl 9.0." +msgstr "" + +msgid "" +"Return a list of ``(mode, cbname)`` pairs for all traces set on the variable " +"with :meth:`trace_variable`." +msgstr "" + +msgid "" +"Use :meth:`trace_info` instead. This method wraps a Tcl feature that was " +"removed in Tcl 9.0." +msgstr "" + +msgid "" +"A :class:`Variable` subclass that holds a string. The default value is " +"``''``." +msgstr "" + +msgid "Return the value of the variable as a :class:`str`." +msgstr "" + +msgid "" +"A :class:`Variable` subclass that holds an integer. The default value is " +"``0``." +msgstr "" + +msgid "Return the value of the variable as an :class:`int`." +msgstr "" + +msgid "" +"A :class:`Variable` subclass that holds a float. The default value is " +"``0.0``." +msgstr "" + +msgid "Return the value of the variable as a :class:`float`." +msgstr "" + +msgid "" +"A floating-point value is always parsed with a period (``.``) as the decimal " +"separator, but :class:`Spinbox`, :class:`Scale` and :class:`ttk.Spinbox " +"` format it according to the ``LC_NUMERIC`` locale. " +"Under a locale that uses a comma they produce a value that :meth:`get` " +"cannot read, raising :exc:`TclError`. Set ``LC_NUMERIC`` to a locale that " +"uses a period (such as ``'C'``) to avoid this." +msgstr "" + +msgid "" +"A :class:`Variable` subclass that holds a boolean. The default value is " +"``False``." +msgstr "" + +msgid "" +"Return the value of the variable as a :class:`bool`. Raise " +"a :exc:`ValueError` if the value cannot be interpreted as a boolean." +msgstr "" + +msgid "" +"Set the variable to *value*, converting it to a boolean. :meth:`initialize` " +"is an alias of :meth:`!set`." +msgstr "" + +msgid "Image classes" +msgstr "" + +msgid "" +"Base class for Tk images. *imgtype* is the Tk image type, one of ``'photo'`` " +"or ``'bitmap'``. An image is a named object that can be displayed by widgets " +"through their *image* option; deleting all references to the :class:`!Image` " +"object deletes the underlying Tk image. Usually you create " +"a :class:`PhotoImage` or :class:`BitmapImage` rather than an :class:`!Image` " +"directly." +msgstr "" + +msgid "" +"The image's configuration options are given by *cnf* and *kw* and may be " +"queried and changed later with the mapping protocol (using ``image[key]``) " +"or with the :meth:`configure` method." +msgstr "" + +msgid "" +"Modify one or more configuration options of the image. The valid options " +"depend on the image type; see :class:`PhotoImage` " +"and :class:`BitmapImage`. :meth:`config` is an alias of :meth:`!configure`." +msgstr "" + +msgid "Return the height of the image, in pixels." +msgstr "" + +msgid "Return the width of the image, in pixels." +msgstr "" + +msgid "" +"Return the type of the image, that is the value of *imgtype* with which it " +"was created (for example ``'photo'`` or ``'bitmap'``)." +msgstr "" + +msgid "" +"A full-color image (the Tk ``photo`` image type), stored internally with a " +"varying degree of transparency per pixel. It can read and write GIF, PPM/PGM " +"and (in Tk 8.6 and later) PNG files, read SVG files (in Tk 9.0 and later), " +"and be drawn in widgets. Inherits from :class:`Image`." +msgstr "" + +msgid "" +"The configuration options include *data* (the image contents as a string), " +"*file* (the name of a file to read the contents from), *format* (the name of " +"the file format handler), *width* and *height* (the size of the image, used " +"when building it up piece by piece), *gamma* and *palette*." +msgstr "" + +msgid "" +"Blank the image; that is, set the entire image to have no data, so that it " +"is displayed as transparent and the background of whatever window it is " +"displayed in shows through." +msgstr "" + +msgid "Return the current value of the configuration option *option*." +msgstr "" + +msgid "Return a new :class:`PhotoImage` with a copy of this image." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular sub-region of the source image to be " +"copied. It must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, " +"y2)``. ``(x1, y1)`` and ``(x2, y2)`` specify diagonally opposite corners of " +"the rectangle. If *x2* and *y2* are not specified, they default to the " +"bottom-right corner of the source image. The pixels copied include the left " +"and top edges of the rectangle but not the bottom or right edges. If " +"*from_coords* is not given, the whole source image is copied." +msgstr "" + +msgid "" +"If *zoom* or *subsample* are specified, the image is transformed as in " +"the :meth:`zoom` or :meth:`subsample` methods. The value must be a single " +"integer or a pair of integers." +msgstr "" + +msgid "Added the *from_coords*, *zoom* and *subsample* parameters." +msgstr "" + +msgid "" +"Copy a region from *sourceImage* (which must be a :class:`PhotoImage`) into " +"this image, possibly with pixel zooming and/or subsampling. If no options " +"are specified, the whole of *sourceImage* is copied into this image, " +"starting at coordinates ``(0, 0)``." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular sub-region of the source image to be " +"copied, as in the :meth:`copy` method." +msgstr "" + +msgid "" +"*to* specifies a rectangular sub-region of the destination image to be " +"affected. It must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, " +"y2)``. If *x2* and *y2* are not specified, they default to ``(x1, y1)`` plus " +"the size of the source region (after subsampling and zooming, if specified). " +"If *x2* and *y2* are specified, the source region is replicated if necessary " +"to fill the destination region in a tiled fashion." +msgstr "" + +msgid "" +"If *shrink* is true, the size of the destination image is reduced, if " +"necessary, so that the region being copied into is at the bottom-right " +"corner of the image." +msgstr "" + +msgid "" +"*compositingrule* specifies how transparent pixels in the source image are " +"combined with the destination image. With ``'overlay'`` (the default), the " +"old contents of the destination image remain visible, as if the source image " +"were printed on a piece of transparent film and placed over the top of the " +"destination. With ``'set'``, the old contents of the destination image are " +"discarded and the source image is used as-is." +msgstr "" + +msgid "Return the image data." +msgstr "" + +msgid "" +"*format* specifies the name of the image file format handler to use. If it " +"is not given, the data is returned as a tuple (one element per row) of " +"strings containing space-separated (one element per pixel/column) colors in " +"``#RRGGBB`` format." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular region of the image to be returned. It " +"must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, y2)``. If only " +"*x1* and *y1* are specified, the region extends from ``(x1, y1)`` to the " +"bottom-right corner of the image. If all four coordinates are given, they " +"specify diagonally opposite corners of the region, including ``(x1, y1)`` " +"and excluding ``(x2, y2)``. If *from_coords* is not given, the whole image " +"is returned." +msgstr "" + +msgid "" +"If *background* is specified, the data does not contain any transparency " +"information; in all transparent pixels the color is replaced by the " +"specified color." +msgstr "" + +msgid "" +"If *grayscale* is true, the data does not contain color information; all " +"pixel data is transformed into grayscale." +msgstr "" + +msgid "" +"Return the color of the pixel at coordinates (*x*, *y*) as an ``(r, g, b)`` " +"tuple of three integers between 0 and 255, representing the red, green and " +"blue components respectively." +msgstr "" + +msgid "" +"Set pixels of the image to the colors given in *data*, which must be a " +"string or a nested sequence of horizontal rows of pixel colors (for example " +"``\"{red green} {blue yellow}\"``)." +msgstr "" + +msgid "" +"*to* specifies the coordinates of the region of the image into which the " +"data are copied. It must be a tuple or a list of 2 or 4 integers ``(x1, " +"y1)`` or ``(x1, y1, x2, y2)`` giving the top-left corner, and optionally the " +"bottom-right corner, of the region. The default position is ``(0, 0)``." +msgstr "" + +msgid "Read image data from the file named *filename* into the image." +msgstr "" + +msgid "*format* specifies the format of the image data in the file." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular sub-region of the image file data to " +"be copied to the destination image. It must be a tuple or a list of 1 to 4 " +"integers ``(x1, y1, x2, y2)``. If only *x1* and *y1* are specified, the " +"region extends from ``(x1, y1)`` to the bottom-right corner of the image in " +"the file. If all four coordinates are given, they specify diagonally " +"opposite corners of the region. If *from_coords* is not given, the whole of " +"the image in the file is read." +msgstr "" + +msgid "" +"*to* specifies the coordinates of the top-left corner of the region of the " +"image into which the data are read. The default is ``(0, 0)``." +msgstr "" + +msgid "" +"If *shrink* is true, the size of the image is reduced, if necessary, so that " +"the region into which the file data are read is at the bottom-right corner " +"of the image." +msgstr "" + +msgid "" +"Return a new :class:`PhotoImage` based on this image but using only every " +"*x*-th pixel in the X direction and every *y*-th pixel in the Y direction. " +"If *y* is not given, it defaults to the same value as *x*." +msgstr "" + +msgid "Added the *from_coords* parameter." +msgstr "" + +msgid "" +"Return ``True`` if the pixel at coordinates (*x*, *y*) is fully transparent, " +"``False`` otherwise." +msgstr "" + +msgid "" +"Make the pixel at coordinates (*x*, *y*) fully transparent if *boolean* is " +"true, fully opaque otherwise." +msgstr "" + +msgid "Write image data from the image to the file named *filename*." +msgstr "" + +msgid "" +"*format* specifies the name of the image file format handler to use. If it " +"is not given, the format is guessed from the file extension." +msgstr "" + +msgid "" +"*from_coords* specifies a rectangular region of the image to be written. It " +"must be a tuple or a list of 1 to 4 integers ``(x1, y1, x2, y2)``. If only " +"*x1* and *y1* are specified, the region extends from ``(x1, y1)`` to the " +"bottom-right corner of the image. If all four coordinates are given, they " +"specify diagonally opposite corners of the region. If *from_coords* is not " +"given, the whole image is written." +msgstr "" + +msgid "Added the *background* and *grayscale* parameters." +msgstr "" + +msgid "" +"Return a new :class:`PhotoImage` with this image magnified by a factor of " +"*x* in the X direction and *y* in the Y direction. If *y* is not given, it " +"defaults to the same value as *x*." +msgstr "" + +msgid "" +"A two-color image (the Tk ``bitmap`` image type) created from an X11 bitmap. " +"Each pixel displays a foreground color, a background color, or nothing " +"(producing a transparent effect). Inherits from :class:`Image`." +msgstr "" + +msgid "" +"The configuration options are *data* or *file* (the source bitmap, given as " +"a string in X11 bitmap format or as the name of a file in that format), " +"*maskdata* or *maskfile* (the mask bitmap, in the same forms), and " +"*foreground* and *background* (the two colors). For pixels where the mask is " +"zero the image displays nothing; for other pixels it displays the foreground " +"color where the source is one and the background color where the source is " +"zero. If *background* is set to an empty string, the background pixels are " +"transparent." +msgstr "" + +msgid "" +":class:`!BitmapImage` has no methods of its own beyond those inherited " +"from :class:`Image`." +msgstr "" + +msgid "Other classes" +msgstr "" + +msgid "" +"A container for the attributes of an event passed to a callback bound " +"with :meth:`Misc.bind`. An :class:`!Event` instance has the following " +"attributes, each corresponding to a field of the underlying Tk event; " +"depending on the event type, some attributes may be set to the string " +"``'??'`` to indicate that they are not meaningful. See :ref:`bindings-and-" +"events`." +msgstr "" + +msgid "The serial number of the event." +msgstr "" + +msgid "The mouse button that was pressed or released (for button events)." +msgstr "" + +msgid "Whether the window has the focus (for ``Enter`` and ``Leave`` events)." +msgstr "" + +msgid "" +"The new height and width of the window (for ``Configure`` and ``Expose`` " +"events)." +msgstr "" + +msgid "The keycode of the key that was pressed or released." +msgstr "" + +msgid "" +"The state of the event, as a number (for most events) or a string (for " +"``Visibility`` events)." +msgstr "" + +msgid "The timestamp of the event, in milliseconds." +msgstr "" + +msgid "The pointer position relative to the widget, in pixels." +msgstr "" + +msgid "" +"The pointer position relative to the top-left corner of the screen, in " +"pixels." +msgstr "" + +msgid "The character typed, as a string (for key events)." +msgstr "" + +msgid "``True`` if the event was sent by another application." +msgstr "" + +msgid "The symbolic name of the key that was pressed or released." +msgstr "" + +msgid "The numeric value of :attr:`keysym`." +msgstr "" + +msgid "The :class:`EventType` of the event." +msgstr "" + +msgid "The widget on which the event occurred." +msgstr "" + +msgid "The amount the mouse wheel was rotated (for ``MouseWheel`` events)." +msgstr "" + +msgid "" +"An :class:`enum.StrEnum` enumerating the Tk event types, used as the value " +"of :attr:`Event.type`. Its members include, among others, ``KeyPress``, " +"``KeyRelease``, ``ButtonPress``, ``ButtonRelease``, ``Motion``, ``Enter``, " +"``Leave``, ``FocusIn``, ``FocusOut``, ``Configure``, ``Map``, ``Unmap``, " +"``Expose``, ``Destroy`` and ``MouseWheel``." +msgstr "" + +msgid "" +"Internal helper that wraps a Python callback so that it can be invoked from " +"Tcl. *func* is the Python function, *subst* is an optional function that pre-" +"processes the Tcl arguments, and *widget* is the widget used for error " +"reporting. Instances are created automatically by :meth:`Misc.register`; " +"this class is not normally used directly." +msgstr "" + +msgid "Module-level functions" +msgstr "" + +msgid "" +"The :func:`Tcl` function is a factory function which creates an object much " +"like that created by the :class:`Tk` class, except that it does not " +"initialize the Tk subsystem. This is most often useful when driving the Tcl " +"interpreter in an environment where one doesn't want to create extraneous " +"toplevel windows, or where one cannot (such as Unix/Linux systems without an " +"X server). An object created by the :func:`Tcl` object can have a Toplevel " +"window created (and the Tk subsystem initialized) by calling " +"its :meth:`~Tk.loadtk` method." +msgstr "" + +msgid "" +"Inhibit the creation of an implicit default root window. Afterwards :mod:`!" +"tkinter` no longer creates a shared default root automatically, and " +"operations that rely on one --- such as constructing a widget without an " +"explicit *master* --- raise a :exc:`RuntimeError`. Call this early in larger " +"applications to make the root window explicit." +msgstr "" + +msgid "" +"Run the Tk main event loop on the default root window until all windows are " +"destroyed. Equivalent to calling :meth:`Misc.mainloop` on the default root." +msgstr "" + +msgid "" +"Convert the Tcl boolean string *s* (one of ``'1'``, ``'true'``, ``'yes'``, " +"``'on'`` and similar, or their false counterparts) to a " +"Python :class:`bool`. Raise :exc:`TclError` for an invalid value." +msgstr "" + +msgid "" +"Convert *s* to a floating-point number. This is the built-in :class:`float`." +msgstr "" + +msgid "Convert *s* to an integer. This is the built-in :class:`int`." +msgstr "" + +msgid "" +"Return the names of all existing images in the default root's interpreter." +msgstr "" + +msgid "" +"Return the available image types (such as ``'photo'`` and ``'bitmap'``) in " +"the default root's interpreter." +msgstr "" + +msgid "File handlers" +msgstr "" + +msgid "" +"Tk allows you to register and unregister a callback function which will be " +"called from the Tk mainloop when I/O is possible on a file descriptor. Only " +"one handler may be registered per file descriptor. Example code::" +msgstr "" + +msgid "" +"import tkinter\n" +"widget = tkinter.Tk()\n" +"mask = tkinter.READABLE | tkinter.WRITABLE\n" +"widget.tk.createfilehandler(file, mask, callback)\n" +"...\n" +"widget.tk.deletefilehandler(file)" +msgstr "" + +msgid "This feature is not available on Windows." +msgstr "" + +msgid "" +"Since you don't know how many bytes are available for reading, you may not " +"want to use the :class:`~io.BufferedIOBase` " +"or :class:`~io.TextIOBase` :meth:`~io.BufferedIOBase.read` " +"or :meth:`~io.IOBase.readline` methods, since these will insist on reading a " +"predefined number of bytes. For sockets, the :meth:`~socket.socket.recv` " +"or :meth:`~socket.socket.recvfrom` methods will work fine; for other files, " +"use raw reads or ``os.read(file.fileno(), maxbytecount)``." +msgstr "" + +msgid "" +"Registers the file handler callback function *func*. The *file* argument may " +"either be an object with a :meth:`~io.IOBase.fileno` method (such as a file " +"or socket object), or an integer file descriptor. The *mask* argument is an " +"ORed combination of any of the three constants below. The callback is called " +"as follows::" +msgstr "" + +msgid "callback(file, mask)" +msgstr "" + +msgid "Unregisters a file handler." +msgstr "" + +msgid "Constants used in the *mask* arguments." +msgstr "" + +msgid "Constants" +msgstr "Stały" + +msgid "" +"The following symbolic constants are available in both the :mod:`!tkinter` " +"and :mod:`!tkinter.constants` namespaces." +msgstr "" + +msgid "Truthy values, all equal to the integer ``1``." +msgstr "" + +msgid "Falsy values, all equal to the integer ``0``." +msgstr "" + +msgid "" +"Compass directions (``'n'``, ``'s'``, ``'e'``, ``'w'`` and the diagonals and " +"edges) plus ``CENTER`` (``'center'``), used as values for the *anchor* and " +"*sticky* options and by methods such as :meth:`Misc.grid_anchor`." +msgstr "" + +msgid "" +"Sides for the *side* option of the packer (see :meth:`Pack.pack_configure`)." +msgstr "" + +msgid "" +"Values for the *fill* option of the packer: ``'x'``, ``'y'``, ``'both'`` or " +"``'none'``." +msgstr "" + +msgid "Values for the *relief* option, which controls a widget's 3-D border." +msgstr "" + +msgid "" +"Values for the *orient* option of widgets such " +"as :class:`Scale`, :class:`Scrollbar` and :class:`PanedWindow`." +msgstr "" + +msgid "" +"Values for the *wrap* option of the :class:`Text` widget, selecting line " +"wrapping on character or word boundaries." +msgstr "" + +msgid "The text-alignment value ``'baseline'``." +msgstr "" + +msgid "" +"Values for the *bordermode* option of the placer " +"(see :meth:`Place.place_configure`)." +msgstr "" + +msgid "" +"Symbolic indices used by the :class:`Text`, :class:`Entry`, :class:`Listbox` " +"and :class:`Canvas` widgets, such as ``'insert'`` (the insertion cursor), " +"``'current'``, ``'end'``, ``'anchor'`` and the bounds of the selection " +"(``'sel.first'`` and ``'sel.last'``)." +msgstr "" + +msgid "" +"The special tag ``'all'``, which matches every item of a :class:`Canvas` or " +"every character of a :class:`Text` (for example ``canvas.delete(ALL)``)." +msgstr "" + +msgid "Values for the *state* option of various widgets and items." +msgstr "" + +msgid "" +"Menu entry types, used as the *itemType* argument of :meth:`Menu.add` " +"and :meth:`Menu.insert`." +msgstr "" + +msgid "Values for the *selectmode* option of the :class:`Listbox` widget." +msgstr "" + +msgid "Values for the *style* option of :class:`Canvas` arc items." +msgstr "" + +msgid "" +"Values for the *capstyle* (``'butt'``, ``'projecting'``, ``'round'``) and " +"*joinstyle* (``'round'``, ``'bevel'``, ``'miter'``) options " +"of :class:`Canvas` line items." +msgstr "" + +msgid "" +"Values for the *arrow* option of :class:`Canvas` line items, indicating " +"which ends have arrowheads." +msgstr "" + +msgid "" +"The first argument passed by a :class:`Scrollbar` to the :meth:`XView.xview` " +"or :meth:`YView.yview` method of the scrolled widget." +msgstr "" + +msgid "" +"Values for the *what* argument of :meth:`XView.xview_scroll` " +"and :meth:`YView.yview_scroll`." +msgstr "" + +msgid "Other option values: ``'underline'``, ``'numeric'`` and ``'dotbox'``." +msgstr "" + +msgid "geometry management (widgets)" +msgstr "" + +msgid "packing (widgets)" +msgstr "" + +msgid "window manager (widgets)" +msgstr "" + +msgid "Tk Option Data Types" msgstr "" msgid "bind (widgets)" diff --git a/library/tkinter.scrolledtext.po b/library/tkinter.scrolledtext.po index 8a7e82d999..9c626017f6 100644 --- a/library/tkinter.scrolledtext.po +++ b/library/tkinter.scrolledtext.po @@ -39,9 +39,9 @@ msgstr "" msgid "" "The text widget and scrollbar are packed together in a :class:`Frame`, and " "the methods of the :class:`Grid` and :class:`Pack` geometry managers are " -"acquired from the :class:`Frame` object. This allows the :class:" -"`ScrolledText` widget to be used directly to achieve most normal geometry " -"management behavior." +"acquired from the :class:`Frame` object. This allows " +"the :class:`ScrolledText` widget to be used directly to achieve most normal " +"geometry management behavior." msgstr "" msgid "" diff --git a/library/tkinter.ttk.po b/library/tkinter.ttk.po index 3bf0f03e51..0a3c3cc0f8 100644 --- a/library/tkinter.ttk.po +++ b/library/tkinter.ttk.po @@ -1,21 +1,19 @@ # SOME DESCRIPTIVE TITLE. -# Copyright (C) 2001-2025, Python Software Foundation +# Copyright (C) 2001-2026, Python Software Foundation # This file is distributed under the same license as the Python package. # FIRST AUTHOR , YEAR. # # Translators: -# Maciej Olko , 2023 -# haaritsubaki, 2023 -# Stan Ulbrych, 2024 +# python-doc bot, 2025 # #, fuzzy msgid "" msgstr "" "Project-Id-Version: Python 3.13\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2025-04-04 14:18+0000\n" -"PO-Revision-Date: 2021-06-28 01:15+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-10-21 20:14+0000\n" +"PO-Revision-Date: 2025-09-15 01:04+0000\n" +"Last-Translator: python-doc bot, 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" @@ -29,13 +27,13 @@ msgid ":mod:`!tkinter.ttk` --- Tk themed widgets" msgstr "" msgid "**Source code:** :source:`Lib/tkinter/ttk.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/tkinter/ttk.py`" msgid "" -"The :mod:`tkinter.ttk` module provides access to the Tk themed widget set, " -"introduced in Tk 8.5. It provides additional benefits including anti-aliased " -"font rendering under X11 and window transparency (requiring a composition " -"window manager on X11)." +"The :mod:`!tkinter.ttk` module provides access to the Tk themed widget set, " +"introduced in Tk 8.5. Its widgets adapt their appearance to the platform's " +"native theme, giving an application a better and more consistent look and " +"feel than the classic :mod:`tkinter` widgets, whose appearance is fixed." msgstr "" msgid "" @@ -45,10 +43,19 @@ msgid "" msgstr "" msgid "" -"`Tk Widget Styling Support `_" +"Ttk widgets are used just like the classic :mod:`tkinter` widgets and share " +"the same machinery: the widget hierarchy, the geometry managers, variable " +"coupling and event binding. Those foundational concepts are covered in " +"the :mod:`tkinter` documentation and are not repeated here." +msgstr "" + +msgid "" +"`Tk Widget Styling Support (TIP #48) `_" msgstr "" -msgid "A document introducing theming support for Tk" +msgid "" +"The Tcl Improvement Proposal that introduced the themed widget styling " +"engine." msgstr "" msgid "Using Ttk" @@ -70,43 +77,36 @@ msgid "" msgstr "" msgid "" -"That code causes several :mod:`tkinter.ttk` widgets (:class:`Button`, :class:" -"`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:`Label`, :class:" -"`LabelFrame`, :class:`Menubutton`, :class:`PanedWindow`, :class:" -"`Radiobutton`, :class:`Scale` and :class:`Scrollbar`) to automatically " -"replace the Tk widgets." +"That code causes several :mod:`tkinter.ttk` widgets " +"(:class:`Button`, :class:`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:`Label`, :class:`LabelFrame`, :class:`Menubutton`, :class:`OptionMenu`, :class:`PanedWindow`, :class:`Radiobutton`, :class:`Scale`, :class:`Scrollbar` " +"and :class:`Spinbox`) to automatically replace the Tk widgets." +msgstr "" + +msgid "" +"Overriding the classic widgets with ``from tkinter.ttk import *`` is " +"convenient for adapting existing code, but new code is usually clearer if it " +"imports the module as ``from tkinter import ttk`` and refers to the themed " +"widgets explicitly, such as ``ttk.Button``." msgstr "" msgid "" "This has the direct benefit of using the new widgets which gives a better " "look and feel across platforms; however, the replacement widgets are not " "completely compatible. The main difference is that widget options such as " -"\"fg\", \"bg\" and others related to widget styling are no longer present in " -"Ttk widgets. Instead, use the :class:`ttk.Style` class for improved " +"``fg``, ``bg`` and others related to widget styling are no longer present in " +"Ttk widgets. Instead, use the :class:`ttk.Style