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..29eee70ced 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,7 @@ 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:c-api--abstract] file_filter = c-api/abstract.po source_file = gettext/c-api/abstract.pot type = PO @@ -28,7 +28,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 +37,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 +46,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 +55,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 +64,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 +73,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 +82,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 +91,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 +100,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 +109,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 +118,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 +127,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 +136,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 +145,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 +154,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 +163,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 +172,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 +181,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 +199,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 +208,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 +217,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 +226,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 +235,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 +244,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 +253,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 +262,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 +271,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 +280,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 +289,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 +298,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 +307,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 +316,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 +325,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 +334,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 +343,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 +352,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 +361,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 +370,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 +379,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 +388,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 +397,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 +406,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 +415,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 +424,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 +433,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 +442,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 +451,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 +460,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 +469,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 +478,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 +496,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 +505,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 +514,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 +523,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 +532,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 +541,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 +550,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 +559,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 +568,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 +577,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 +586,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 +595,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 +604,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 +613,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 +622,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 +631,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 +640,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 +649,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 +658,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 +667,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 +676,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 +694,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 +703,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 +712,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 +721,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 +730,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 +739,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 +766,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 +775,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 +784,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 +793,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 +802,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 +811,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 +820,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 +829,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 +838,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 +847,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 +856,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 +865,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 +874,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 +883,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 +892,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 +901,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 +910,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 +919,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 +928,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 +946,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 +955,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 +964,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 +973,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 +982,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 +991,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 +1000,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 +1009,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 +1018,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 +1027,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 +1036,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 +1045,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 +1054,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 +1063,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 +1072,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 +1081,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 +1090,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 +1099,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 +1108,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 +1117,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 +1126,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 +1135,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 +1144,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 +1153,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 +1162,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 +1171,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 +1180,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 +1189,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 +1198,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 +1207,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 +1216,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 +1225,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 +1234,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 +1243,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 +1252,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 +1261,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 +1270,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 +1279,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 +1288,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 +1297,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 +1306,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 +1315,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 +1324,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 +1333,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 +1342,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 +1351,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 +1360,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 +1369,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 +1378,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 +1387,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 +1396,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 +1405,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 +1414,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 +1423,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 +1432,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 +1441,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 +1450,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 +1459,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 +1468,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 +1477,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 +1486,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 +1495,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 +1504,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 +1513,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 +1522,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 +1531,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 +1540,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 +1549,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 +1558,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 +1567,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 +1576,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 +1585,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 +1594,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 +1603,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 +1612,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 +1621,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 +1630,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 +1639,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 +1648,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 +1657,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 +1666,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 +1675,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 +1684,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 +1693,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 +1702,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,7 +1711,7 @@ resource_name = library--configparser replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--constants] +[o:python-doc:p:python-313:r:library--constants] file_filter = library/constants.po source_file = gettext/library/constants.pot type = PO @@ -1666,7 +1720,7 @@ 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 +1729,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 +1738,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 +1747,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 +1756,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 +1765,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 +1774,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 +1783,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 +1792,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 +1801,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 +1810,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 +1819,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 +1828,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 +1837,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 +1846,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 +1855,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 +1864,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 +1873,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 +1882,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 +1891,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 +1900,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 +1909,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 +1918,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 +1927,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 +1936,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 +1945,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 +1954,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 +1963,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 +1972,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 +1981,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 +1990,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 +1999,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 +2008,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 +2017,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 +2026,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 +2035,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 +2044,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 +2053,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 +2062,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 +2071,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 +2080,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 +2089,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 +2098,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 +2107,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 +2116,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,7 +2125,7 @@ resource_name = library--errno replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--exceptions] +[o:python-doc:p:python-313:r:library--exceptions] file_filter = library/exceptions.po source_file = gettext/library/exceptions.pot type = PO @@ -2080,7 +2134,7 @@ 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 +2143,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 +2152,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 +2161,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 +2170,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 +2179,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 +2188,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 +2197,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 +2206,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 +2215,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 +2224,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,7 +2233,7 @@ resource_name = library--functional replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--functions] +[o:python-doc:p:python-313:r:library--functions] file_filter = library/functions.po source_file = gettext/library/functions.pot type = PO @@ -2188,7 +2242,7 @@ 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 +2251,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 +2260,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 +2269,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 +2278,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 +2287,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 +2296,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 +2305,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 +2314,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 +2323,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 +2332,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 +2341,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 +2350,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 +2359,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 +2368,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 +2377,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 +2386,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 +2395,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 +2404,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 +2413,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 +2422,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 +2431,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 +2440,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 +2449,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 +2458,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 +2467,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 +2476,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 +2485,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 +2494,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 +2503,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 +2512,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 +2521,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 +2530,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 +2539,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 +2548,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 +2557,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 +2566,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 +2575,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 +2584,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 +2593,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 +2602,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 +2611,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 +2620,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 +2629,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 +2638,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 +2647,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 +2656,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 +2665,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 +2674,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 +2683,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 +2692,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 +2701,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 +2710,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 +2719,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 +2728,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 +2737,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 +2746,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 +2755,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 +2764,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 +2773,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 +2782,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 +2791,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 +2800,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 +2809,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 +2818,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 +2827,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 +2836,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 +2845,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 +2854,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 +2863,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 +2872,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 +2881,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 +2890,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 +2899,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 +2908,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 +2917,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 +2926,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 +2935,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 +2944,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 +2953,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 +2962,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 +2971,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 +2980,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 +2989,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 +2998,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 +3007,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 +3016,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 +3025,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 +3034,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 +3043,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 +3052,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 +3061,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 +3070,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 +3079,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 +3088,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 +3097,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 +3106,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 +3115,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 +3124,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 +3133,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 +3142,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 +3151,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 +3160,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 +3169,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 +3178,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 +3187,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 +3196,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 +3205,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 +3214,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 +3223,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 +3232,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 +3241,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 +3250,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 +3259,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 +3268,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 +3277,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 +3286,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 +3295,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 +3304,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 +3313,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 +3322,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,7 +3331,7 @@ resource_name = library--statistics replace_edited_strings = false keep_translations = false -[o:python-doc:p:python-newest:r:library--stdtypes] +[o:python-doc:p:python-313:r:library--stdtypes] file_filter = library/stdtypes.po source_file = gettext/library/stdtypes.pot type = PO @@ -3286,7 +3340,7 @@ 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 +3349,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 +3358,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 +3367,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 +3376,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 +3385,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 +3394,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 +3403,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 +3412,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 +3421,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 +3430,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 +3439,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 +3448,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 +3457,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 +3466,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 +3475,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 +3484,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 +3493,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 +3502,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 +3511,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 +3520,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 +3529,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 +3538,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 +3547,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 +3556,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 +3565,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 +3574,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 +3583,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 +3592,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 +3601,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 +3610,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 +3619,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 +3628,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 +3637,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 +3646,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 +3655,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 +3664,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 +3673,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 +3682,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 +3691,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 +3700,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 +3709,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 +3718,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 +3727,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 +3736,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 +3745,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 +3754,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 +3763,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 +3772,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 +3781,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 +3790,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 +3799,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 +3808,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 +3817,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 +3826,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 +3835,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 +3844,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 +3853,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 +3862,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 +3871,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 +3880,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 +3889,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 +3898,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 +3907,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 +3916,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 +3925,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 +3934,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 +3943,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 +3952,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 +3961,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 +3970,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 +3979,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 +3988,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 +3997,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 +4006,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 +4015,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 +4024,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 +4033,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 +4042,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 +4051,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 +4060,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 +4069,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 +4078,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 +4087,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 +4096,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 +4105,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 +4114,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 +4123,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 +4132,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 +4141,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 +4150,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 +4159,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 +4168,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 +4177,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 +4186,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 +4195,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 +4204,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 +4213,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 +4222,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 +4231,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 +4240,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 +4249,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 +4258,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 +4267,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 +4276,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 +4285,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 +4294,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 +4303,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 +4312,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 +4321,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 +4330,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 +4339,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 +4348,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 +4357,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 +4366,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 +4375,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 +4384,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 +4393,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 +4402,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 +4411,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 +4420,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 +4429,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 +4438,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 +4447,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 +4456,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 +4465,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 +4474,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 +4483,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 +4492,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 +4501,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 +4510,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 +4519,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 +4528,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 +4537,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 +4546,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 +4555,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 +4564,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 +4573,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 +4582,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 +4591,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 +4600,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 +4609,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 +4618,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..908170b724 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.803%25-0.svg) +![6 Translators](https://img.shields.io/badge/Translators-6-0.svg) *Przeczytaj to w innym języku: [polski](README.md)* diff --git a/README.md b/README.md index 92543db9f6..2f3ae0b977 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.803%25-0.svg) +![6 tłumaczy](https://img.shields.io/badge/tłumaczy-6-0.svg) *Read this in another language: [English](README.en.md)* diff --git a/about.po b/about.po index 7d538f733c..7cc8f25913 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-07-11 16:22+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..35a9a59ba9 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-07-11 16:22+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,8 +39,8 @@ 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:" @@ -51,14 +51,24 @@ 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/c-api/abstract.po b/c-api/abstract.po index 3c41817d25..cf3192215d 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-07-11 16:22+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/allocation.po b/c-api/allocation.po index 36375a8c3d..72c9b65490 100644 --- a/c-api/allocation.po +++ b/c-api/allocation.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 -# 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 00:47+0000\n" -"Last-Translator: Waldemar Stoczkowski, 2023\n" +"POT-Creation-Date: 2026-07-05 16:47+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,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 "Allocating Objects on the Heap" -msgstr "Przydzielanie obiektów na stercie" +msgid "Allocating objects on the heap" +msgstr "" msgid "" "Initialize a newly allocated object *op* with its type and initial " @@ -73,14 +72,6 @@ msgid "" "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." -msgstr "" - msgid "" "Object which is visible in Python as ``None``. This should only be accessed " "using the :c:macro:`Py_None` macro, which evaluates to a pointer to this " @@ -90,8 +81,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..6a8f62edb2 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-07-11 16:22+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/arg.po b/c-api/arg.po index adc19b5a50..dd990d62f6 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-07-11 16:22+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" @@ -271,7 +269,7 @@ 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:" +"The buffer may contain embedded null bytes. The caller has to call :c:func:" "`PyBuffer_Release` when it is done with the buffer." msgstr "" diff --git a/c-api/bool.po b/c-api/bool.po index e317bc7893..77a3d119a9 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-07-11 16:22+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/buffer.po b/c-api/buffer.po index 42fe8d7203..caa7052afe 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-07-11 16:22+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,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 "" @@ -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 "" @@ -311,6 +316,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``." diff --git a/c-api/bytearray.po b/c-api/bytearray.po index 3fe2512fbc..a8c190aa12 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-07-11 16:22+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/bytes.po b/c-api/bytes.po index ee3ad6e346..285eda40c8 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-07-03 17:26+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,7 +134,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 "" @@ -249,10 +247,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 +271,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..3f228de19f 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-07-11 16:22+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" @@ -430,6 +428,14 @@ msgid "" "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 "" "Call *callable* with positional arguments passed exactly as in the " "vectorcall_ protocol, but with keyword arguments passed as a dictionary " diff --git a/c-api/capsule.po b/c-api/capsule.po index 1a4ae7dc27..56f55012fa 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-07-11 16:22+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 "" @@ -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..9e23f3a081 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-07-11 16:22+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" @@ -186,7 +186,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 "" @@ -221,6 +221,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 +323,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 "" @@ -301,15 +388,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/complex.po b/c-api/complex.po index ebf255047f..31a55a682d 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-07-11 16:22+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/concrete.po b/c-api/concrete.po index 6759741071..2fc7df81dc 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-07-11 16:22+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..f82fba138e 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-07-11 16:22+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/conversion.po b/c-api/conversion.po index f980a8955b..c668469073 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-07-11 16:22+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)`." 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)`." 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,107 @@ 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 +175,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." 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 +197,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 +217,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 +233,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 +279,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 "" -"Case insensitive comparison of strings. The function works almost " -"identically to :c:func:`strncmp` except that it ignores the case." +"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 "" +"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..4f628bb252 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-07-11 16:22+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 +30,45 @@ 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 " +"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 " +"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." msgstr "" @@ -66,7 +99,7 @@ msgid "" msgstr "" msgid "" -"This instance of :c:type:`PyTypeObject` represents Python type for the " +"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 "" @@ -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..f91f908b7b 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-07-03 17:26+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,11 +60,20 @@ 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 "" @@ -85,8 +90,8 @@ 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*." +"on success or ``-1`` on failure. This function *does not* \":term:`steal`\" " +"a reference to *val*." msgstr "" msgid "" @@ -121,7 +126,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." @@ -197,7 +203,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 +216,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." +"exc:`KeyError` if the key is missing." msgstr "" msgid "" @@ -239,6 +248,9 @@ 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 " @@ -421,6 +433,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..ef4902e138 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-07-19 16:20+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" @@ -299,6 +297,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 +319,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 "" @@ -371,11 +390,17 @@ msgid "" msgstr "" msgid "" -"Function similar to :c:func:`PyErr_WarnEx`, but use :c:func:" +"Function similar to :c:func:`PyErr_WarnEx`, but uses :c:func:" "`PyUnicode_FromFormat` to format the warning message. *format* is an ASCII-" "encoded string." msgstr "" +msgid "" +"Similar to :c:func:`PyErr_WarnExplicit`, but uses :c:func:" +"`PyUnicode_FromFormat` to format the warning message. *format* is an ASCII-" +"encoded string." +msgstr "" + msgid "" "Function similar to :c:func:`PyErr_WarnFormat`, but *category* is :exc:" "`ResourceWarning` and it passes *source* to :class:`!warnings." @@ -446,10 +471,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." @@ -572,10 +601,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 +617,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 "" @@ -703,9 +752,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 +792,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 +805,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 "" @@ -894,349 +960,207 @@ msgid "" "c:func:`Py_ReprEnter` that returns zero." msgstr "" -msgid "Standard Exceptions" -msgstr "Sztandarowe Sytuacje Wyjątkowe" +msgid "" +"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 "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`" @@ -1257,339 +1181,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_BaseExceptionGroup`." +msgstr ":c:data:`PyExc_BaseExceptionGroup`." -msgid ":c:data:`!PyExc_EnvironmentError`" -msgstr ":c:data:`!PyExc_EnvironmentError`" - -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 "strerror (C function)" -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 ":c:data:`PyExc_EncodingWarning`." +msgstr ":c:data:`PyExc_EncodingWarning`." -msgid "PyExc_ModuleNotFoundError (C var)" +msgid "Tracebacks" 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..d915525b4f 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-07-11 16:22+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" @@ -116,11 +115,38 @@ 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..800da9402f 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-07-11 16:22+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" @@ -86,6 +86,97 @@ 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 "" diff --git a/c-api/frame.po b/c-api/frame.po index 48e09b2dc6..fa883d671b 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-07-19 16:20+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." @@ -54,6 +54,12 @@ 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 "" @@ -66,10 +72,11 @@ 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,181 @@ 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 "" +"However, Python's C API lacks a function to read the executable kind from a " +"frame. Instead, use this recipe:" +msgstr "" + +msgid "" +"int\n" +"get_executable_kind(PyFrameObject *frame)\n" +"{\n" +" _PyInterpreterFrame *f = frame->f_frame;\n" +" PyObject *exec = PyStackRef_AsPyObjectBorrow(f->f_executable);\n" +"\n" +" if (PyCode_Check(exec)) {\n" +" return PyUnstable_EXECUTABLE_KIND_PY_FUNCTION;\n" +" }\n" +" if (PyMethod_Check(exec)) {\n" +" return PyUnstable_EXECUTABLE_KIND_BUILTIN_FUNCTION;\n" +" }\n" +" if (Py_IS_TYPE(exec, &PyMethodDescr_Type)) {\n" +" return PyUnstable_EXECUTABLE_KIND_METHOD_DESCRIPTOR;\n" +" }\n" +"\n" +" return PyUnstable_EXECUTABLE_KIND_SKIP;\n" +"}" +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..5ede3abed1 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-07-11 16:22+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" @@ -105,6 +103,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 +138,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 " @@ -143,19 +162,19 @@ 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 "" @@ -174,7 +193,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. " diff --git a/c-api/gcsupport.po b/c-api/gcsupport.po index edcde1cd8c..860c06cca7 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-07-11 16:22+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" @@ -216,6 +216,12 @@ msgid "" "returned immediately." msgstr "" +msgid "" +"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:" @@ -224,9 +230,10 @@ msgid "" 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 "" diff --git a/c-api/import.po b/c-api/import.po index c29b375f9e..2eb5b381ea 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-07-11 16:22+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" @@ -327,6 +325,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..a72189700a 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-07-11 16:22+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/init.po b/c-api/init.po index f51c6e3246..2771194797 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-07-11 16:22+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" @@ -547,7 +546,11 @@ 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 "" @@ -590,18 +593,8 @@ 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 "" @@ -646,9 +639,8 @@ 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,16 +649,12 @@ 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 "" @@ -1157,6 +1145,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 +1202,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 +1249,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 +1282,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,6 +1295,17 @@ 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 " @@ -1393,11 +1440,11 @@ 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 "" @@ -1453,7 +1500,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 +1523,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." @@ -1800,7 +1852,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 "" @@ -1930,6 +1982,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 "" @@ -2017,7 +2092,7 @@ 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 "" @@ -2136,7 +2211,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." @@ -2375,13 +2450,22 @@ 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 "" @@ -2470,6 +2554,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..3e1174d652 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-07-11 16:22+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,7 +25,7 @@ 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:" @@ -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 "" @@ -587,7 +591,7 @@ 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 " +"`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 "" diff --git a/c-api/intro.po b/c-api/intro.po index bd0e671f35..d6c4903ca5 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-07-03 17:26+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" @@ -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." @@ -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 "" @@ -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,7 +443,7 @@ msgid "" msgstr "" msgid "" -"A use for ``Py_UNREACHABLE()`` is following a call a function that never " +"A use for ``Py_UNREACHABLE()`` is following a call to a function that never " "returns but that is not declared :c:macro:`_Py_NO_RETURN`." msgstr "" @@ -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ń" @@ -502,15 +714,15 @@ 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:" @@ -1013,6 +1225,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-07-03 17:26+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" @@ -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 "" @@ -104,9 +103,9 @@ msgid "" 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..aa3f4301a1 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-07-05 16:47+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" @@ -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 "" @@ -150,6 +148,14 @@ 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__` " @@ -171,12 +177,8 @@ 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 "" @@ -325,6 +327,15 @@ 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 +351,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 "" diff --git a/c-api/mapping.po b/c-api/mapping.po index d8dd6474e5..b4ba22a127 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-07-11 16:22+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" @@ -104,8 +103,8 @@ msgid "" msgstr "" msgid "" -"Exceptions which occur when this calls :meth:`~object.__getitem__` method " -"are silently ignored. For proper error handling, use :c:func:" +"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 "" @@ -117,9 +116,9 @@ msgid "" 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:" +"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 "" diff --git a/c-api/memory.po b/c-api/memory.po index 1d823a8221..490d11a4e2 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-07-01 18: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" @@ -122,8 +120,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 +144,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 "" @@ -220,9 +218,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 "" @@ -349,36 +347,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 ":c:macro:`PyMem_Resize`" +msgstr "" -msgid "``PyMem_DEL(ptr)``" -msgstr "``PyMem_DEL(ptr)``" +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 "" @@ -585,15 +587,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`" @@ -860,6 +856,12 @@ msgid "" "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" msgstr "" diff --git a/c-api/memoryview.po b/c-api/memoryview.po index ac83d71139..34d5be0dbd 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-07-11 16:22+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 " diff --git a/c-api/method.po b/c-api/method.po index 895c628633..0e0373b000 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-07-11 16:22+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/module.po b/c-api/module.po index 688da7eb9d..118d0264c9 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-07-03 17:26+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 "" @@ -76,6 +76,11 @@ msgid "" "__dict__`." msgstr "" +msgid "" +"The returned reference is borrowed from the module; it is valid until the " +"module is destroyed." +msgstr "" + msgid "" "Return *module*'s :attr:`~module.__name__` value. If the module does not " "provide one, or if it is not a string, :exc:`SystemError` is raised and " @@ -87,6 +92,12 @@ 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:" @@ -98,6 +109,12 @@ msgid "" "was created, or ``NULL`` if the module wasn't created from a definition." msgstr "" +msgid "" +"On error, return ``NULL`` with an exception set. Use :c:func:" +"`PyErr_Occurred` to tell this case apart from a missing :c:type:`!" +"PyModuleDef`." +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 " @@ -110,6 +127,11 @@ 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." @@ -226,6 +248,9 @@ msgid "" "not needed." msgstr "" +msgid "The type of ``PyModuleDef`` objects." +msgstr "" + msgid "Single-phase initialization" msgstr "" @@ -259,33 +284,53 @@ msgid "" 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 "" @@ -466,6 +511,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 +525,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 "" @@ -550,10 +603,10 @@ msgid "" 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 +616,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 "" @@ -596,9 +649,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 " diff --git a/c-api/monitoring.po b/c-api/monitoring.po index b82aaae41d..444b0fc5b2 100644 --- a/c-api/monitoring.po +++ b/c-api/monitoring.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: 2024-05-11 01:07+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-07-05 16:47+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" @@ -143,7 +142,7 @@ 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 "" @@ -243,6 +242,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..47c028ae26 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-07-11 16:22+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..b5731f86e4 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-07-11 16:22+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/object.po b/c-api/object.po index 90a823269f..abfcc034b0 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-07-11 16:22+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,7 +134,7 @@ 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`." +"functions use the :func:`str` of the object instead of the :func:`repr`." msgstr "" msgid "" @@ -369,6 +367,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." @@ -397,6 +398,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``." @@ -606,6 +611,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 +623,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..3b894e1ad4 --- /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-07-19 16:20+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..6150c7c505 --- /dev/null +++ b/c-api/picklebuffer.po @@ -0,0 +1,91 @@ +# 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-07-11 16:22+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..35b064db98 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-07-11 16:22+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" @@ -230,7 +230,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/sequence.po b/c-api/sequence.po index 151ab007d8..81b97ebf7b 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-07-03 17:26+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,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 "" diff --git a/c-api/set.po b/c-api/set.po index 783192cc12..ed7e5e56f9 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-07-11 16:22+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" @@ -153,9 +152,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 "" diff --git a/c-api/stable.po b/c-api/stable.po index de1348b3ed..36fb8b566e 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 +# 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: Maciej Olko , 2024\n" +"POT-Creation-Date: 2026-07-11 16:22+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/structures.po b/c-api/structures.po index 9e804ee9ff..7b896fabd5 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-07-11 16:22+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" @@ -372,14 +370,10 @@ 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 " @@ -415,6 +409,21 @@ msgid "" "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 "" "Turn *ml* into a Python :term:`callable` object. The caller must ensure that " "*ml* outlives the :term:`callable`. Typically, *ml* is defined as a static " @@ -441,12 +450,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 "" @@ -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/time.po b/c-api/time.po index ea90c067ff..7ad85f853f 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-07-11 16:22+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/tuple.po b/c-api/tuple.po index aab1fce529..11d320f4f1 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-07-03 17:26+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." @@ -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 "" @@ -113,9 +113,9 @@ msgid "" 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 "" @@ -219,7 +219,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..81758ec326 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-07-01 18: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" @@ -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`." @@ -222,6 +248,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``." @@ -273,6 +305,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 "" @@ -415,7 +458,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 "" diff --git a/c-api/typeobj.po b/c-api/typeobj.po index 771b9cc10f..471a09722b 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-07-01 18:05+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`." 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:" 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,7 +980,7 @@ msgid "" msgstr "" msgid "PyObject Slots" -msgstr "" +msgstr "Sloty PyObject" msgid "" "The type object structure extends the :c:type:`PyVarObject` structure. The :" @@ -951,6 +990,12 @@ msgid "" "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 " @@ -962,10 +1007,10 @@ msgid "" 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,9 +1022,18 @@ 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:" @@ -987,18 +1041,26 @@ msgid "" "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:" @@ -1006,7 +1068,7 @@ msgid "" msgstr "" msgid "PyTypeObject Slots" -msgstr "" +msgstr "Sloty PyTypeObject" msgid "" "Each slot has a section describing inheritance. If :c:func:`PyType_Ready` " @@ -1014,6 +1076,11 @@ msgid "" "\"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 " @@ -1025,12 +1092,23 @@ msgid "" "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,6 +1116,10 @@ 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 " @@ -1047,16 +1129,26 @@ msgid "" "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`)." 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 :" @@ -1066,6 +1158,9 @@ msgid "" "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:" @@ -1073,21 +1168,25 @@ msgid "" "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." 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 " @@ -1097,11 +1196,20 @@ msgid "" "`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." 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`` " @@ -1110,6 +1218,11 @@ msgid "" "`!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 " @@ -1118,6 +1231,11 @@ msgid "" "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 " @@ -1674,8 +1792,9 @@ msgid "" 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." @@ -1721,12 +1840,13 @@ msgid "This flag is inherited." msgstr "" msgid "" -"These flags are used by functions such as :c:func:`PyLong_Check` to quickly " -"determine if a type is a subclass of a built-in type; such specific checks " -"are faster than a generic check, like :c:func:`PyObject_IsInstance`. Custom " -"types that inherit from built-ins should have their :c:member:`~PyTypeObject." -"tp_flags` set appropriately, or the code that interacts with such types will " -"behave differently depending on what kind of check is used." +"Functions such as :c:func:`PyLong_Check` will call :c:func:" +"`PyType_FastSubclass` with one of these flags to quickly determine if a type " +"is a subclass of a built-in type; such specific checks are faster than a " +"generic check, like :c:func:`PyObject_IsInstance`. Custom types that inherit " +"from built-ins should have their :c:member:`~PyTypeObject.tp_flags` set " +"appropriately, or the code that interacts with such types will behave " +"differently depending on what kind of check is used." msgstr "" msgid "" @@ -1749,6 +1869,14 @@ msgid "" "This bit is inherited if :c:member:`~PyTypeObject.tp_call` is also inherited." msgstr "" +msgid "as ``_Py_TPFLAGS_HAVE_VECTORCALL``" +msgstr "" + +msgid "" +"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." @@ -1840,6 +1968,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 " @@ -1935,6 +2096,12 @@ msgid "" "it, as they are allowed to be removed even if the instance is still alive)." msgstr "" +msgid "" +"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 " @@ -2020,7 +2187,7 @@ 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:" +"`~PyTypeObject.tp_flags` field, the clear function must call :c:func:" "`PyObject_ClearManagedDict` like this::" msgstr "" @@ -2627,7 +2794,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);" @@ -2937,8 +3106,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 +3116,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 +3128,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 "" @@ -3018,7 +3186,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 "" diff --git a/c-api/unicode.po b/c-api/unicode.po index 581caa8af8..4a9e96c506 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-07-11 16:22+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:" @@ -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" @@ -515,7 +529,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 " @@ -683,6 +697,14 @@ msgid "" "for decref'ing the returned objects." msgstr "" +msgid "" +"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`." @@ -717,7 +739,7 @@ msgid "" msgstr "" msgid "" -"Return the number of written character, or return ``-1`` and raise an " +"Return the number of written characters, or return ``-1`` and raise an " "exception on error." msgstr "" @@ -1078,7 +1100,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 `." @@ -1390,9 +1412,6 @@ msgid "" "c:macro:`!CP_ACP` code page to get the MBCS encoder." msgstr "" -msgid "Methods & Slots" -msgstr "" - msgid "Methods and Slot Functions" msgstr "" @@ -1618,6 +1637,3 @@ msgid "" "prefer calling :c:func:`PyUnicode_FromString` and :c:func:" "`PyUnicode_InternInPlace` directly." msgstr "" - -msgid "Strings interned this way are made :term:`immortal`." -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/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..555d950369 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-07-11 16:22+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..412e4b10e9 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-07-11 16:22+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..e7421440b4 --- /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-07-11 16:22+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..848ce115cc --- /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-07-11 16:22+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..cd586bb917 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-07-01 18:05+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" @@ -87,10 +87,9 @@ 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 "" @@ -171,11 +170,6 @@ msgid "" "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." -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:" @@ -230,17 +224,6 @@ 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`:" @@ -259,7 +242,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 +254,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 "" @@ -296,6 +279,14 @@ msgid "" "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 " "deprecated since Python 3.13. After eight years in the :mod:`typing` module, " @@ -381,6 +372,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 +445,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 " @@ -591,7 +636,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 " @@ -675,28 +720,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." 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 "" @@ -788,9 +841,6 @@ msgid "" "c:func:`Py_PreInitialize`)" msgstr "" -msgid "The bundled copy of ``libmpdecimal``." -msgstr "" - msgid "" "The :c:func:`PyImport_ImportModuleNoBlock`: Use :c:func:" "`PyImport_ImportModule` instead." @@ -874,6 +924,8 @@ 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 +934,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..811e0cdc31 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-07-11 16:22+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..c7b19d465b 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-07-11 16:22+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" @@ -83,10 +83,9 @@ 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 "" @@ -167,11 +166,6 @@ msgid "" "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." -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:" diff --git a/deprecations/pending-removal-in-3.15.po b/deprecations/pending-removal-in-3.15.po index 18f94a2a4e..7f6b29ec57 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-07-01 18: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" @@ -71,17 +71,6 @@ 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`:" @@ -100,7 +89,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 +101,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 "" @@ -137,6 +126,14 @@ msgid "" "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 " "deprecated since Python 3.13. After eight years in the :mod:`typing` module, " diff --git a/deprecations/pending-removal-in-3.16.po b/deprecations/pending-removal-in-3.16.po index d37609fe2c..3ac6654023 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-07-11 16:22+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/pending-removal-in-3.17.po b/deprecations/pending-removal-in-3.17.po new file mode 100644 index 0000000000..d7ddf3d6a0 --- /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-07-11 16:22+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..db512c56c7 --- /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-07-11 16:22+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..3c43345bdc 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-07-11 16:22+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 " @@ -239,7 +233,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 " diff --git a/distributing/index.po b/distributing/index.po index d9f9de665b..d56a78468e 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-07-11 16:22+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/embedding.po b/extending/embedding.po index dccffb8f54..e7a2bd98df 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-07-11 16:22+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" @@ -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 "" diff --git a/extending/extending.po b/extending/extending.po index b49d15b468..a6d87e17f7 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-07-13 18:00+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" @@ -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 "" @@ -312,39 +365,68 @@ msgid "" 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 +447,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." @@ -469,7 +558,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" @@ -507,13 +596,10 @@ 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 "" @@ -528,7 +614,7 @@ msgid "" "PyMODINIT_FUNC\n" "PyInit_spam(void)\n" "{\n" -" return PyModule_Create(&spammodule);\n" +" return PyModuleDef_Init(&spam_module);\n" "}" msgstr "" @@ -539,16 +625,11 @@ 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 "" @@ -611,28 +692,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" @@ -711,18 +785,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 " @@ -1059,18 +1125,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 "" @@ -1195,7 +1260,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 " @@ -1409,7 +1474,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,13 +1523,13 @@ 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 " -"using :c:macro:`Py_END_ALLOW_THREADS`. This is common around blocking I/O " -"calls, to let other threads use the processor while waiting for the I/O to " -"complete. Obviously, the following function has the same problem as the " -"previous one::" +"each other's way, because there is a :term:`global lock ` protecting Python's entire object space. However, it is possible to " +"temporarily release this lock using the macro :c:macro:" +"`Py_BEGIN_ALLOW_THREADS`, and to re-acquire it using :c:macro:" +"`Py_END_ALLOW_THREADS`. This is common around blocking I/O calls, to let " +"other threads use the processor while waiting for the I/O to complete. " +"Obviously, the following function has the same problem as the previous one::" msgstr "" msgid "" @@ -1732,27 +1804,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 +1824,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 "" @@ -1835,22 +1897,18 @@ 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::" +"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 "" diff --git a/extending/index.po b/extending/index.po index c67d77576a..c545e4e618 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-07-11 16:22+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" @@ -70,34 +68,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-07-11 16:22+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/newtypes_tutorial.po b/extending/newtypes_tutorial.po index 39a20724fc..3957ede72f 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-07-11 16:22+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" @@ -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::" @@ -294,12 +305,13 @@ msgstr "" msgid "" "Everything else in the file should be familiar, except for some code in :c:" -"func:`!PyInit_custom`::" +"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,8 +322,7 @@ msgstr "" msgid "" "if (PyModule_AddObjectRef(m, \"Custom\", (PyObject *) &CustomType) < 0) {\n" -" Py_DECREF(m);\n" -" return NULL;\n" +" return -1;\n" "}" msgstr "" @@ -485,31 +496,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 "" @@ -1057,31 +1077,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 "" @@ -1442,31 +1471,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 "" @@ -1667,7 +1705,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 +1715,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 "" @@ -1759,30 +1806,24 @@ 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::" +"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 "" diff --git a/extending/windows.po b/extending/windows.po index ed79cc8ca0..b70a46bdaa 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-07-11 16:22+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/design.po b/faq/design.po index 2ec36af26d..790462ef79 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-07-01 18: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" @@ -276,6 +272,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" @@ -412,8 +410,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 "" @@ -845,9 +845,9 @@ 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 "" diff --git a/faq/extending.po b/faq/extending.po index ad0a363f7b..1cc2cfab77 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-07-11 16:22+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" @@ -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?" diff --git a/faq/general.po b/faq/general.po index 4ae84c0ea2..b1c0700a28 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-07-11 16:22+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" @@ -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 "" diff --git a/faq/gui.po b/faq/gui.po index 9ae850813f..bb91afa583 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-07-11 16:22+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/index.po b/faq/index.po index 978bbe1739..db710abdc2 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-07-11 16:22+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..e2db57e02a 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-07-11 16:22+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..0f67dd2409 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-07-11 16:22+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/programming.po b/faq/programming.po index cd94cf447b..1a5861ee48 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-07-11 16:22+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,15 +30,14 @@ 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" @@ -50,6 +46,8 @@ msgid "" "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`, :" +"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?" @@ -568,7 +706,7 @@ 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,19 +810,28 @@ 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 " +"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, " +"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 "" @@ -698,8 +847,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::" @@ -978,8 +1127,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 "" @@ -1179,9 +1328,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 +1353,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 +1376,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 "" @@ -1450,8 +1599,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 "" @@ -1553,7 +1702,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 +1717,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 +1801,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 +1813,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 +1850,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,7 +1936,7 @@ 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 :" +"To call a method or function and accumulate the return values in a list, a :" "term:`list comprehension` is an elegant solution::" msgstr "" @@ -1906,8 +2055,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 +2133,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" @@ -2067,17 +2194,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 " "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 +2277,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 " @@ -2244,8 +2372,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 +2460,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 +2487,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 "" @@ -2427,16 +2555,16 @@ msgid "" 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 +2661,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 +2673,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 "" @@ -2638,9 +2755,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" @@ -2684,8 +2801,8 @@ msgid "" 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 +2814,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,13 +2854,13 @@ 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." +"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 "" @@ -2796,13 +2913,13 @@ 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 ``." +"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 " @@ -2831,7 +2948,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 "" @@ -2999,7 +3116,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..3f9292bd6b 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-07-11 16:22+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/glossary.po b/glossary.po index b9ac9390a8..1eb85c5fa7 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-07-03 17:26+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" @@ -71,6 +74,17 @@ msgid "" "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" @@ -153,16 +167,21 @@ 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,7 +192,7 @@ 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 "" @@ -211,6 +230,18 @@ msgid "" "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" msgstr "atrybut" @@ -417,6 +448,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" @@ -522,6 +576,35 @@ msgid "" "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" msgstr "dekorator" @@ -628,6 +711,15 @@ msgid "" "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" msgstr "EAFP" @@ -849,29 +941,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" @@ -952,6 +1057,17 @@ 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 "" @@ -1016,7 +1132,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" @@ -1137,8 +1255,9 @@ 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." +"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" @@ -1159,8 +1278,8 @@ 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` " +"`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 " @@ -1193,11 +1312,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,6 +1346,37 @@ 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" @@ -1368,8 +1519,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" @@ -1443,6 +1597,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 "" @@ -1465,6 +1630,18 @@ msgid "" "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" msgstr "obiekt" @@ -1498,6 +1675,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 "" @@ -1568,6 +1758,19 @@ msgid "" "`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" msgstr "" @@ -1768,6 +1971,20 @@ 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,6 +1998,12 @@ 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 "" @@ -1792,6 +2015,33 @@ 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" @@ -1828,11 +2078,11 @@ 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 `." +"`~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" @@ -1892,6 +2142,22 @@ msgid "" "`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" msgstr "instrukcja" @@ -1910,6 +2176,25 @@ msgid "" "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" msgstr "" @@ -1930,6 +2215,22 @@ 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" @@ -1973,6 +2274,22 @@ msgid "" "`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" msgstr "" @@ -2122,6 +2439,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 +2457,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..8edac769bb --- /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-07-15 17:01+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..cfc2f4af8e 100644 --- a/howto/annotations.po +++ b/howto/annotations.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 -# 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-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-07-11 16:22+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 +24,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" diff --git a/howto/argparse.po b/howto/argparse.po index 8315f0595c..bba3ab06f3 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-07-11 16:22+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/clinic.po b/howto/clinic.po index f978490fa8..1c302f3d7e 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-07-11 16:22+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..6723ec1597 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-07-19 16:20+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" diff --git a/howto/descriptor.po b/howto/descriptor.po index 84a7366af4..d0b23567c6 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-07-11 16:22+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" @@ -523,7 +520,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!" @@ -1559,7 +1556,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..c1d38ca0f7 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-07-11 16:22+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 "" @@ -1316,102 +1315,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" @@ -2060,8 +1969,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" diff --git a/howto/free-threading-extensions.po b/howto/free-threading-extensions.po index 5cc72e4664..70e5d43627 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-07-11 16:22+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 "" @@ -202,6 +209,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`" @@ -347,8 +357,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..eca8189433 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-07-11 16:22+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 "" diff --git a/howto/functional.po b/howto/functional.po index 28b3ad5f31..a7132113c9 100644 --- a/howto/functional.po +++ b/howto/functional.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-07-19 16:20+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,7 +29,7 @@ msgstr "" msgid "Author" msgstr "Autor" -msgid "A. M. Kuchling" +msgid "\\A. M. Kuchling" msgstr "" msgid "Release" @@ -726,7 +724,7 @@ 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 " @@ -1276,7 +1274,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" @@ -1526,7 +1524,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..1cc409eefc 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-07-11 16:22+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" @@ -425,6 +424,43 @@ msgid "" "(gdb) py-down\n" "Unable to find a newer python frame" msgstr "" +"(gdb) py-down\n" +"#37 Frame 0x9420b04, for file /usr/lib/python2.6/site-packages/gnome_sudoku/" +"main.py, line 906, in start_game ()\n" +" u = UI()\n" +"(gdb) py-down\n" +"#34 (unable to read python frame information)\n" +"(gdb) py-down\n" +"#23 (unable to read python frame information)\n" +"(gdb) py-down\n" +"#19 (unable to read python frame information)\n" +"(gdb) py-down\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=, 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 "" @@ -504,6 +540,39 @@ msgid "" "0xb771b7f4>)\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 " @@ -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 # #, 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-07-11 16:22+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" @@ -37,6 +36,9 @@ msgstr "" msgid "General:" msgstr "" +msgid ":ref:`a-conceptual-overview-of-asyncio`" +msgstr "" + msgid ":ref:`annotations-howto`" msgstr ":ref:`annotations-howto`" diff --git a/howto/instrumentation.po b/howto/instrumentation.po index 5cad64c008..a4a6109314 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-07-11 16:22+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" @@ -430,6 +428,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 "" diff --git a/howto/ipaddress.po b/howto/ipaddress.po index d8d1230ce8..bd4e5f486b 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-07-11 16:22+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/isolating-extensions.po b/howto/isolating-extensions.po index 959270e836..0abb1b1fdf 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-07-11 16:22+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" @@ -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" @@ -286,21 +286,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 "" @@ -561,7 +576,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 "" @@ -764,9 +779,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..3342ad92a4 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-07-19 16:20+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" @@ -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" @@ -744,7 +742,7 @@ 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" @@ -1775,6 +1773,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 +1920,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 " @@ -2300,7 +2392,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" @@ -4156,7 +4248,6 @@ msgid "" msgstr "" msgid "" -"import datetime\n" "import logging\n" "import random\n" "import sys\n" @@ -4412,7 +4503,7 @@ 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 " +"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 "" @@ -4424,7 +4515,7 @@ msgid "" msgstr "" msgid "" -"import datetime\n" +"import datetime as dt\n" "import logging.handlers\n" "import re\n" "import socket\n" @@ -4442,8 +4533,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" @@ -4679,6 +4769,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..dd1e073f36 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-07-11 16:22+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 "" @@ -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 "" diff --git a/howto/mro.po b/howto/mro.po index 45e22a4fa6..f57b483741 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-07-19 16:20+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" diff --git a/howto/perf_profiling.po b/howto/perf_profiling.po index 563f3c397b..742662bfaf 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-07-11 16:22+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/pyporting.po b/howto/pyporting.po index 7ade12272f..5d2ba434e4 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-07-11 16:22+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/regex.po b/howto/regex.po index e2b98e2025..9a6e152dd0 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-07-11 16:22+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 "" @@ -241,7 +237,7 @@ msgid "" "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 "" @@ -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 "" @@ -520,8 +519,8 @@ 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 " +"`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 "" @@ -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,14 +576,14 @@ 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:" +"Find all substrings where the RE matches, and return them as an :term:" "`iterator`." msgstr "" @@ -748,8 +747,8 @@ 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 "" @@ -771,7 +770,7 @@ msgid "" "(29, 31)" msgstr "" -msgid "Module-Level Functions" +msgid "Module-level functions" msgstr "" msgid "" @@ -804,7 +803,7 @@ msgid "" "not much difference thanks to the internal cache." msgstr "" -msgid "Compilation Flags" +msgid "Compilation flags" 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 "" @@ -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 " @@ -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 " @@ -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 " @@ -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])$``" @@ -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,8 +1830,8 @@ 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 " @@ -1873,7 +1925,7 @@ msgid "" "Use :func:`re.search` instead." msgstr "" -msgid "Greedy versus Non-Greedy" +msgid "Greedy versus non-greedy" msgstr "" msgid "" @@ -1893,6 +1945,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 +2027,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..852db2e589 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-07-15 17:01+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 " diff --git a/howto/sorting.po b/howto/sorting.po index 218e41345d..a44048aef2 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-07-11 16:22+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/timerfd.po b/howto/timerfd.po index 7fb1ca0ca1..1b33faa125 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-07-11 16:22+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/unicode.po b/howto/unicode.po index 40e70b9970..739c54be16 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-07-11 16:22+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/urllib2.po b/howto/urllib2.po index 6b568ce5b3..6730cc6568 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-07-11 16:22+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,7 +42,7 @@ msgstr "" msgid "" "`Basic Authentication `_" +"voidspace.org.uk/python/articles/authentication.shtml>`__" msgstr "" msgid "A tutorial on *Basic Authentication*, with examples in Python." @@ -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 "" diff --git a/installing/index.po b/installing/index.po index b3eda29991..b9a26ef63f 100644 --- a/installing/index.po +++ b/installing/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 Wierzbicki , 2021 -# Stan Ulbrych, 2025 -# Maciej Olko , 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-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-07-11 16:22+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" @@ -25,24 +23,14 @@ 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 " -"siebie oprogramowanie innym deweloperom Pythona w ramach licencji open " -"source." msgid "" "This allows Python users to share and collaborate effectively, benefiting " @@ -79,11 +67,9 @@ 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." msgid "" "A *virtual environment* is a semi-isolated Python environment that allows " @@ -94,61 +80,27 @@ 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." 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." +"``virtualenv`` is a third-party alternative (and predecessor) to ``venv``." 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." 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." 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 " "issue trackers on `GitHub `__." msgstr "" -"`Python Packaging Authority `__ to grupa programistów " -"i autorów dokumentacji odpowiedzialnych za utrzymanie i ewolucję " -"standardowych narzędzi do pakowania oraz powiązanych metadanych i standardów " -"formatu plików. Utrzymują oni różne narzędzia, dokumentację i repozytoria " -"zgłoszeń na `GitHub `__." - -msgid "" -"``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." @@ -173,7 +125,7 @@ msgstr "" msgid "" "The following command will install the latest version of a module and its " -"dependencies from the Python Package Index::" +"dependencies from PyPI::" msgstr "" msgid "python -m pip install SomePackage" @@ -214,8 +166,9 @@ 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 "" msgid "" @@ -235,21 +188,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?" @@ -263,10 +201,10 @@ msgstr "" 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 "" msgid "" @@ -279,30 +217,26 @@ msgstr "" 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 "" 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 "" -msgid "Appropriately versioned ``pip`` commands may also be available." +msgid "Appropriately versioned :program:`pip` commands may also be available." msgstr "" 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 "" 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 "" msgid "Common installation issues" @@ -316,53 +250,52 @@ msgid "" "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 "" 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 "" 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 "" msgid "python -m ensurepip --default-pip" msgstr "" msgid "" -"There are also additional resources for `installing pip. `__" +"and-wheel-are-up-to-date>`__." 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 "" 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 "" 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." +"python.org/science/>`__ 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 "" msgid "" diff --git a/library/__future__.po b/library/__future__.po index b08c68e955..a6b5ac5575 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-07-11 16:22+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" @@ -87,9 +85,6 @@ msgstr "obowiązkowe w" msgid "effect" msgstr "" -msgid "nested_scopes" -msgstr "nested_scopes" - msgid "2.1.0b1" msgstr "2.1.0b1" @@ -99,9 +94,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 +103,6 @@ msgstr "2.3" msgid ":pep:`255`: *Simple Generators*" msgstr "" -msgid "division" -msgstr "podział" - msgid "2.2.0a2" msgstr "2.2.0a2" @@ -123,42 +112,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 +142,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 "" diff --git a/library/__main__.po b/library/__main__.po index f984453a5f..b7e16a9413 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-07-11 16:22+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/_thread.po b/library/_thread.po index 4436a20e5a..473b3e623e 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-07-13 18:00+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). " @@ -163,6 +159,9 @@ msgid "" "raise an :exc:`OverflowError`." msgstr "" +msgid "This is the type of lock objects." +msgstr "" + msgid "Lock objects have the following methods:" msgstr "" diff --git a/library/abc.po b/library/abc.po index 031ceb05c6..9608a75475 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-07-11 16:22+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/argparse.po b/library/argparse.po index 101d9463e7..a5bfc60289 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-07-19 16:20+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" @@ -527,7 +526,7 @@ msgid "" msgstr "" msgid "" -"Arguments read from a file must by default be one per line (but see also :" +"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', " @@ -535,6 +534,11 @@ msgid "" "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." @@ -770,6 +774,9 @@ 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 "" @@ -849,9 +856,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 +870,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 +902,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 +919,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 "" @@ -954,31 +959,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 +1087,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 "" @@ -1146,8 +1134,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 "" @@ -1221,6 +1209,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 " @@ -1298,7 +1292,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 "" @@ -1351,12 +1357,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 +1367,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 " @@ -1591,6 +1603,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 "" @@ -1681,6 +1701,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 "" @@ -1953,7 +1993,7 @@ msgstr "" msgid "Other utilities" msgstr "" -msgid "Sub-commands" +msgid "Subcommands" msgstr "" msgid "" @@ -1985,7 +2025,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 +2041,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 +2092,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 " @@ -2238,7 +2285,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" @@ -2308,6 +2355,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 " @@ -2407,7 +2459,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 "" @@ -2485,13 +2540,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 "" @@ -2536,6 +2595,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 "" @@ -2652,7 +2716,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..a5f68b924f 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-07-13 18:00+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'``" @@ -202,12 +204,15 @@ 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 " -"cases, :exc:`TypeError` is raised. Array objects also implement the buffer " -"interface, and may be used wherever :term:`bytes-like objects ` are supported." +"Array objects support the ordinary :ref:`mutable ` :term:" +"`sequence` operations of indexing, slicing, concatenation, and " +"multiplication. When using slice assignment, the assigned value must be an " +"array object with the same type code; in all other cases, :exc:`TypeError` " +"is raised. Array objects also implement the buffer interface, and may be " +"used wherever :term:`bytes-like objects ` are supported." +msgstr "" + +msgid "Arrays are :ref:`generic ` over the type of their contents." msgstr "" msgid "" @@ -223,8 +228,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 " @@ -262,8 +267,8 @@ msgstr "" "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 " @@ -310,20 +315,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 +337,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 "" diff --git a/library/ast.po b/library/ast.po index e8ad2216f5..b0f987d50d 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-07-21 17:15+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" @@ -337,6 +336,14 @@ msgid "" "represented as tuples." msgstr "" +msgid "" +"AST node constructors were changed to provide sensible defaults for omitted " +"fields: optional fields now default to ``None``, list fields default to an " +"empty list, and fields of type :class:`!ast.expr_context` default to :class:" +"`Load() `. Previously, omitted attributes would not exist on " +"constructed nodes (accessing them raised :exc:`AttributeError`)." +msgstr "" + msgid "" "Old classes :class:`!ast.Num`, :class:`!ast.Str`, :class:`!ast.Bytes`, :" "class:`!ast.NameConstant` and :class:`!ast.Ellipsis` are still available, " @@ -479,9 +486,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 "" @@ -1530,7 +1552,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 "" @@ -1986,6 +2008,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 "" @@ -2668,8 +2728,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." diff --git a/library/asyncio-api-index.po b/library/asyncio-api-index.po index 3a74be50bf..63ac93bb31 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-07-11 16:22+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..b9e821d4c3 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-07-11 16:22+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" @@ -79,12 +79,6 @@ msgstr "" msgid "When the debug mode is enabled:" msgstr "" -msgid "" -"asyncio checks for :ref:`coroutines that were not awaited ` and logs them; this mitigates the \"forgotten await\" " -"pitfall." -msgstr "" - msgid "" "Many non-threadsafe asyncio APIs (such as :meth:`loop.call_soon` and :meth:" "`loop.call_at` methods) raise an exception if they are called from a wrong " @@ -322,3 +316,263 @@ 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) # immitate 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..582a40e368 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-07-15 17: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" @@ -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 "" @@ -143,7 +140,7 @@ 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:" @@ -353,8 +350,8 @@ 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 "" @@ -363,6 +360,12 @@ msgid "" "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 "" "In Python 3.7 and earlier with the default event loop implementation, the " "*delay* could not exceed one day. This has been fixed in Python 3.8." @@ -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." @@ -418,6 +427,13 @@ msgid "" "`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 "" "If the *name* argument is provided and not ``None``, it is set as the name " "of the task using :meth:`Task.set_name`." @@ -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 "" @@ -656,6 +691,11 @@ msgid "" "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 "" "*remote_addr*, if given, is a ``(remote_host, remote_port)`` tuple used to " "connect the socket to a remote address. The *remote_host* and *remote_port* " @@ -964,7 +1004,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." @@ -1026,7 +1066,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 "" @@ -1131,10 +1172,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 "" @@ -1216,7 +1270,9 @@ 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 "" @@ -1233,15 +1289,50 @@ msgstr "" msgid "Register the write end of *pipe* in the event loop." msgstr "" -msgid "*pipe* is :term:`file-like object `." -msgstr "" - msgid "" "Return pair ``(transport, protocol)``, where *transport* supports :class:" "`WriteTransport` interface and *protocol* is an object instantiated by the " "*protocol_factory*." msgstr "" +msgid "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 "" +"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 "" ":class:`SelectorEventLoop` does not support the above methods on Windows. " "Use :class:`ProactorEventLoop` instead for Windows." @@ -1254,7 +1345,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 +1380,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 "" @@ -1373,7 +1468,7 @@ msgid "" "ThreadPoolExecutor`." msgstr "" -msgid "Error Handling API" +msgid "Error handling API" msgstr "" msgid "Allows customizing how exceptions are handled in the event loop." @@ -1500,7 +1595,7 @@ msgstr "" msgid "The :ref:`debug mode of asyncio `." msgstr "" -msgid "Running Subprocesses" +msgid "Running subprocesses" msgstr "" msgid "" @@ -1618,6 +1713,11 @@ msgid "" "object instantiated by the *protocol_factory*." msgstr "" +msgid "" +"If the transport is closed or is garbage collected, the child process is " +"killed if it is still running." +msgstr "" + msgid "" "Create a subprocess from *cmd*, which can be a :class:`str` or a :class:" "`bytes` string encoded to the :ref:`filesystem encoding , 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-07-11 16:22+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-future.po b/library/asyncio-future.po index 262c087f7d..5ceedcb45c 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-07-13 18:00+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" @@ -130,6 +130,9 @@ msgid "" "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." msgstr "" @@ -242,6 +245,11 @@ 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 "" diff --git a/library/asyncio-llapi-index.po b/library/asyncio-llapi-index.po index 3339834ce9..a19aa36a83 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-07-15 17:01+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 "" @@ -741,14 +740,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." diff --git a/library/asyncio-platforms.po b/library/asyncio-platforms.po index 6d0c9ab2c1..14d2906068 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-07-15 17: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" @@ -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" @@ -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 " @@ -120,7 +132,7 @@ msgid "" msgstr "" msgid "macOS" -msgstr "" +msgstr "macOS" msgid "Modern macOS versions are fully supported." msgstr "" diff --git a/library/asyncio-policy.po b/library/asyncio-policy.po index f766280f9e..aeeaaf7cbc 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-07-11 16:22+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-protocol.po b/library/asyncio-protocol.po index 8ce2a75a2a..74c869f25b 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-07-11 16:22+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" @@ -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" @@ -444,17 +441,17 @@ msgid "" msgstr "" msgid "" -"``0``: readable streaming transport of the standard input (*stdin*), or :" +"``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 :" +"``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 :" +"``2``: readable streaming transport of the standard error (*stderr*), or :" "const:`None` if the subprocess was not created with ``stderr=PIPE``" msgstr "" @@ -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..fc9457232e 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-07-11 16:22+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,6 +94,10 @@ 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 "" @@ -124,22 +126,43 @@ 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 +180,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 +218,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..9b4e52b837 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-07-11 16:22+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." diff --git a/library/asyncio-stream.po b/library/asyncio-stream.po index 3511d19df7..a96014c01b 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-07-11 16:22+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" @@ -167,6 +166,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,6 +180,9 @@ msgid "" "parameter can now be a :term:`path-like object`." msgstr "" +msgid "Added the *cleanup_socket* parameter." +msgstr "" + msgid "StreamReader" msgstr "" @@ -285,6 +293,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 "" diff --git a/library/asyncio-subprocess.po b/library/asyncio-subprocess.po index 32502929e4..7d2fd2bbc4 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-07-11 16:22+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,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 "" @@ -354,10 +357,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 "" @@ -414,7 +425,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..aae855dbb0 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-07-11 16:22+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" @@ -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." diff --git a/library/asyncio-task.po b/library/asyncio-task.po index e4881dc7b5..97aa654960 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-07-13 18:00+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 "" @@ -300,7 +299,7 @@ msgid "" "`loop.run_in_executor`." msgstr "" -msgid "Creating Tasks" +msgid "Creating tasks" msgstr "" msgid "**Source code:** :source:`Lib/asyncio/tasks.py`" @@ -362,7 +361,7 @@ msgstr "" msgid "Added the *context* parameter." msgstr "" -msgid "Task Cancellation" +msgid "Task cancellation" msgstr "" msgid "" @@ -388,7 +387,7 @@ msgid "" "``uncancel()`` to completely remove the cancellation state." msgstr "" -msgid "Task Groups" +msgid "Task groups" msgstr "" msgid "" @@ -496,7 +495,7 @@ msgid "" "correct preservation of cancellation counts." msgstr "" -msgid "Terminating a Task Group" +msgid "Terminating a task group" msgstr "" msgid "" @@ -573,13 +572,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 +592,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 +641,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,7 +701,7 @@ msgid "" "event loop." msgstr "" -msgid "Eager Task Factory" +msgid "Eager task factory" msgstr "" msgid "A task factory for eager task execution." @@ -748,7 +747,7 @@ msgid "" "set_task_factory>`)." msgstr "" -msgid "Shielding From Cancellation" +msgid "Shielding from cancellation" msgstr "" msgid "" @@ -874,6 +873,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:" @@ -991,7 +995,7 @@ msgstr "" msgid "Raises :exc:`TimeoutError` instead of :exc:`asyncio.TimeoutError`." msgstr "" -msgid "Waiting Primitives" +msgid "Waiting primitives" msgstr "" msgid "" @@ -1051,6 +1055,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 "" @@ -1116,6 +1125,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 +1141,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 +1206,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 +1284,7 @@ msgstr "" msgid "Return ``True`` if *obj* is a coroutine object." msgstr "" -msgid "Task Object" +msgid "Task object" msgstr "" msgid "" @@ -1330,6 +1345,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 "" diff --git a/library/asyncio.po b/library/asyncio.po index f107010000..b685ff97dd 100644 --- a/library/asyncio.po +++ b/library/asyncio.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 +# Rafael Fontenelle , 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-07-11 16:22+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" @@ -24,19 +25,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 +49,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 "" + +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 "" @@ -134,6 +159,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." diff --git a/library/audit_events.po b/library/audit_events.po index 255e57f735..1da61aa302 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-07-11 16:22+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,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..0f49db47e0 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-07-11 16:22+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,17 +31,11 @@ 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 "" @@ -54,12 +47,12 @@ msgid "" 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 +66,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 " @@ -207,6 +206,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 +260,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 +270,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 +291,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 +312,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 " @@ -350,6 +405,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..c27feb8bad 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" diff --git a/library/binascii.po b/library/binascii.po index 1b6450d8d8..bb5bad64a8 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-07-11 16:22+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/bisect.po b/library/bisect.po index beea4e7590..76b815ddec 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-07-19 16:20+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,6 +46,15 @@ msgid "" "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:" msgstr "W module znajdują się następujące funkcje:" @@ -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" @@ -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..82a903ed6e 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-07-11 16:22+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/bz2.po b/library/bz2.po index c6510e7557..35c7bb6b5a 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-07-11 16:22+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/calendar.po b/library/calendar.po index 032fa65dd5..0fdaf87c31 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-07-19 16:20+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` " @@ -61,13 +61,34 @@ 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. " +"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:" -"`firstweekday` property." +"`~Calendar.firstweekday` property." msgstr "" msgid "" @@ -88,7 +109,7 @@ 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." +"weekday number." msgstr "" msgid "" @@ -145,6 +166,31 @@ 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 " @@ -153,6 +199,13 @@ msgid "" "`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`." msgstr "" @@ -193,6 +246,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 +260,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 "" @@ -242,9 +309,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 +335,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." @@ -272,6 +351,11 @@ msgid "" "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." msgstr "" @@ -293,12 +377,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 "" @@ -313,7 +397,7 @@ msgstr "" msgid "" "Returns a month's calendar in a multi-line string using the :meth:" -"`formatmonth` of the :class:`TextCalendar` class." +"`~TextCalendar.formatmonth` of the :class:`TextCalendar` class." msgstr "" msgid "" @@ -322,42 +406,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 +501,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..a86eab77b6 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-07-11 16:22+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 "" @@ -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 "" diff --git a/library/cmd.po b/library/cmd.po index d51d0d3a03..ef7c81cbdd 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-07-11 16:22+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/cmdline.po b/library/cmdline.po index d173bf2f16..4f3b01c4bb 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-07-11 16:22+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..6c1cb8df9b 100644 --- a/library/cmdlinelibs.po +++ b/library/cmdlinelibs.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-12-27 14:18+0000\n" -"Last-Translator: Stan Ulbrych, 2024\n" +"POT-Creation-Date: 2026-07-11 16:22+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,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 "Command Line Interface Libraries" -msgstr "Biblioteki interfejsu wiersza poleceń" +msgid "Command-line interface libraries" +msgstr "" msgid "" "The modules described in this chapter assist with implementing command line " diff --git a/library/code.po b/library/code.po index 2f09124563..6d9474044a 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-07-11 16:22+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,6 +44,13 @@ 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 " diff --git a/library/codecs.po b/library/codecs.po index dac1714641..0b1f4fb534 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-07-13 18:00+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" @@ -69,6 +68,14 @@ msgid "" "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 "" @@ -244,9 +251,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,9 +264,9 @@ 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 "" @@ -269,6 +276,20 @@ msgid "" "`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 "" "The module also provides the following constants which are useful for " "reading and writing to platform dependent files:" @@ -400,7 +421,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``) " @@ -1005,27 +1026,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 +1076,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 +1120,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 +1149,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 +1202,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 " @@ -1851,7 +1890,7 @@ msgid "" msgstr "" msgid "idna" -msgstr "" +msgstr "idna" msgid "" "Implement :rfc:`3490`, see also :mod:`encodings.idna`. Only " @@ -1859,37 +1898,42 @@ msgid "" msgstr "" msgid "mbcs" -msgstr "" +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 +1943,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 +1976,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 +1991,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 +2031,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,6 +2063,36 @@ 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 "" @@ -2026,10 +2103,10 @@ msgid "" 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 +2117,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 "" @@ -2185,13 +2311,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..e26d776bd7 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-07-11 16:22+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/collections.abc.po b/library/collections.abc.po index 1abcb465b2..f10c5894ec 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-07-19 16:20+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" @@ -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__``" @@ -465,21 +464,51 @@ msgstr "" msgid "" "Implementation note: Some of the mixin methods, such as :meth:`~container." -"__iter__`, :meth:`~object.__reversed__` and :meth:`index`, make repeated " -"calls to the underlying :meth:`~object.__getitem__` method. Consequently, " -"if :meth:`~object.__getitem__` is implemented with constant access speed, " -"the mixin methods will have linear performance; however, if the underlying " -"method is linear (as it would be with a linked list), the mixins will have " -"quadratic performance and will likely need to be overridden." +"__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 `." @@ -505,10 +534,10 @@ 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 "" @@ -521,10 +550,10 @@ 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 "" @@ -631,7 +660,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..081df112e3 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-07-17 17: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" @@ -583,13 +584,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 +602,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,12 +617,12 @@ 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 "" @@ -832,6 +836,11 @@ msgid "" "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 "" ":class:`defaultdict` objects support the following method in addition to the " "standard :class:`dict` operations:" @@ -870,9 +879,9 @@ 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 "" @@ -890,10 +899,10 @@ 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 " +"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 " +"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 "" @@ -995,7 +1004,7 @@ msgid "" msgstr "" msgid "Added the *module* parameter." -msgstr "" +msgstr "Dodany parametr *module*." msgid "Removed the *verbose* parameter and the :attr:`!_source` attribute." msgstr "" @@ -1371,7 +1380,7 @@ 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 +1395,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" @@ -1445,14 +1454,13 @@ 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." +"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 "" diff --git a/library/colorsys.po b/library/colorsys.po index 51ac0013b0..31b9318123 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-07-11 16:22+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/compileall.po b/library/compileall.po index b6545358bc..e66ed4e9f0 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-07-11 16:22+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 "" diff --git a/library/concurrent.futures.po b/library/concurrent.futures.po index e071d2d87a..ab0bb00c51 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-07-03 17: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" @@ -44,6 +43,13 @@ msgid "" "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" msgstr "Dostępność" @@ -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 "" @@ -312,6 +321,13 @@ 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 " @@ -382,6 +398,12 @@ msgid "" "`os.cpu_count`." msgstr "" +msgid "" +"Fixed a deadlock (:gh:`115634`) where the executor could hang after a worker " +"process exited upon reaching its *max_tasks_per_child* limit while tasks " +"remained queued." +msgstr "" + msgid "ProcessPoolExecutor Example" msgstr "" diff --git a/library/configparser.po b/library/configparser.po index 96537a9a2f..e86e4a6a05 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-07-11 16:22+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 " diff --git a/library/constants.po b/library/constants.po index 6d07bd505f..d7463798f3 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-07-13 18:00+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,12 +47,8 @@ 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." @@ -61,17 +57,9 @@ msgid "" "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:" +"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 " @@ -110,15 +98,11 @@ 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. " @@ -153,17 +137,15 @@ msgstr "" 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..d82f977b30 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-07-11 16:22+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 +28,7 @@ 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:" @@ -44,32 +43,33 @@ 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." +"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``" +"closing``." msgstr "" msgid "" @@ -77,9 +77,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 " @@ -122,19 +142,52 @@ 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 "" +"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 :func:`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 " @@ -152,25 +205,73 @@ 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 +280,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 +351,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." @@ -231,9 +405,15 @@ 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::" +"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 +421,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 " @@ -275,9 +466,10 @@ 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 "" @@ -288,16 +480,59 @@ 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 +543,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 +568,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 +614,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 +656,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 +671,26 @@ 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 +725,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 " @@ -448,12 +749,13 @@ msgid "" 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,19 +764,28 @@ 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`::" 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" msgstr "" @@ -495,6 +806,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,11 +826,23 @@ 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 "" @@ -528,7 +861,7 @@ 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." +"meth:`~object.__enter__` implementation fail." msgstr "" msgid "" @@ -537,6 +870,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 +917,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 +941,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,12 +960,41 @@ 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::" 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 "" "Due to the way the decorator protocol works, a callback function declared " "this way cannot take any parameters. Instead, any resources to be released " @@ -597,17 +1017,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." +"`~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" @@ -646,6 +1096,28 @@ msgid "" "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 +1134,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 " @@ -699,6 +1188,34 @@ msgid "" "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 "" "As the output from the example shows, reusing a single stack object across " "multiple with statements works correctly, but attempting to nest them will " @@ -710,3 +1227,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..7b961e7f7f 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-07-13 18:00+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" @@ -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 "" @@ -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 "" diff --git a/library/copy.po b/library/copy.po index 29880dd437..95334a23be 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-07-11 16:22+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 " @@ -108,9 +107,13 @@ msgid "" 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 "" diff --git a/library/copyreg.po b/library/copyreg.po index 727285372c..fecb40b695 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-07-11 16:22+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 " diff --git a/library/csv.po b/library/csv.po index fa41ffd9fe..0de548b06d 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-07-13 18:00+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,6 +103,14 @@ 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 " @@ -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 " @@ -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 " @@ -248,6 +267,16 @@ 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 " @@ -314,8 +343,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 "" @@ -342,23 +371,32 @@ 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*." 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 "" +"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* 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." +"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 "" @@ -429,11 +467,25 @@ msgid "" 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." +"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 reading, the *escapechar* removes any special meaning from the following " +"character. It defaults to :const:`None`, which disables escaping." msgstr "" msgid "An empty *escapechar* is not allowed." @@ -452,8 +504,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 +516,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 "" @@ -637,7 +693,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,9 +712,9 @@ 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:" +"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 "" diff --git a/library/ctypes.po b/library/ctypes.po index 94fb85af86..ff2ca0ff3a 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-07-13 18:00+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 "" @@ -258,10 +265,8 @@ 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 "" @@ -331,7 +336,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 +348,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 +356,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 +420,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 +471,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 +495,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 "" @@ -1806,6 +1859,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 " @@ -2481,16 +2539,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 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 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 *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 +2592,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 +2620,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, " @@ -2852,7 +2935,7 @@ msgid "" msgstr "" msgid "" -"Represents the C 8-bit :c:expr:`signed int` datatype. Usually an alias for :" +"Represents the C 8-bit :c:expr:`signed int` datatype. It is an alias for :" "class:`c_byte`." msgstr "" @@ -2908,8 +2991,8 @@ msgid "" msgstr "" msgid "" -"Represents the C 8-bit :c:expr:`unsigned int` datatype. Usually an alias " -"for :class:`c_ubyte`." +"Represents the C 8-bit :c:expr:`unsigned int` datatype. It is an alias for :" +"class:`c_ubyte`." msgstr "" msgid "" @@ -3147,6 +3230,9 @@ msgid "" "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:" diff --git a/library/curses.ascii.po b/library/curses.ascii.po index 960f9cd433..af4c221f0a 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-07-09 17:11+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 "" @@ -209,7 +209,9 @@ msgid "" "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)." diff --git a/library/curses.panel.po b/library/curses.panel.po index 1f93878465..4992465a86 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-07-15 17:01+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..9edf6fb8c6 100644 --- a/library/curses.po +++ b/library/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: -# 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-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-07-19 16:20+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:`!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-" @@ -138,7 +136,7 @@ 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 "" @@ -177,7 +175,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 "" @@ -207,12 +205,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 "" @@ -252,9 +250,10 @@ msgid "" msgstr "" msgid "" -"Read window related data stored in the file by an earlier :func:`window." +"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." +"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 +264,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 +324,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 +359,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 +382,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." @@ -400,7 +413,7 @@ msgid "" "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* " +"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 "" @@ -421,6 +434,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 "" @@ -465,6 +481,9 @@ msgid "" "`putp` always goes to standard output." msgstr "" +msgid ":func:`setupterm` (or :func:`initscr`) must be called first." +msgstr "" + msgid "" "If *flag* is ``False``, the effect is the same as calling :func:`noqiflush`. " "If *flag* is ``True``, or no argument is provided, the queues will be " @@ -542,6 +561,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 " @@ -591,9 +622,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 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 "" @@ -669,7 +701,7 @@ msgid "" "echo, and disables the terminal keypad." msgstr "" -msgid "Window Objects" +msgid "Window objects" msgstr "" msgid "" @@ -685,7 +717,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 +733,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 +752,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 +912,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 "" @@ -923,7 +957,9 @@ 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 "" @@ -956,7 +992,9 @@ msgid "" msgstr "" msgid "" -"Read a bytes object from the user, with primitive line editing capacity." +"Read a bytes object from the user, with primitive line editing capacity. At " +"most *n* characters are read (1023 by default). The maximum value for *n* is " +"1023." msgstr "" msgid "" @@ -966,7 +1004,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 +1029,17 @@ 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`." 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 "" @@ -1030,9 +1074,10 @@ msgstr "" msgid "" "Return a bytes object of characters, extracted from the window starting at " -"the current cursor position, or at *y*, *x* if specified. Attributes are " -"stripped from the characters. If *n* is specified, :meth:`instr` returns a " -"string at most *n* characters long (exclusive of the trailing NUL)." +"the current cursor position, or at *y*, *x* if specified, and stopping at " +"the end of the line. Attributes and color information are stripped from the " +"characters. If *n* is specified, :meth:`instr` returns a string at most *n* " +"characters long (exclusive of the trailing NUL)." msgstr "" msgid "" @@ -1054,8 +1099,7 @@ 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 +1119,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 +1141,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, " @@ -1141,17 +1196,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 +1216,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 +1245,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 "" @@ -1283,13 +1349,13 @@ msgid "" msgstr "" msgid "" -"The width of the screen, i.e., the number of columns. It is defined only " +"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 " +"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 "" @@ -1735,7 +1801,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 +1813,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 +1852,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 +1891,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 +1900,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 +1921,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 +1958,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 +2009,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 "" @@ -1957,9 +2026,11 @@ 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 " -"instance's :attr:`stripspaces` flag is initially on." +"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 "" msgid ":class:`Textbox` objects have the following methods:" @@ -1968,16 +2039,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 +2103,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..7d1f210887 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,9 +31,9 @@ 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 "" @@ -42,12 +42,33 @@ msgid "" 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" @@ -55,14 +76,14 @@ msgstr "" msgid "" "This function is a :term:`decorator` that is used to add generated :term:" -"`special method`\\s to classes, as described below." +"`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 +92,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 +100,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 +143,146 @@ 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:" +"*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." +"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." +"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:`~object.__hash__` method. Setting the " -"class attribute ``__hash__ = None`` has a specific meaning to Python, as " -"described in the :meth:`~object.__hash__` documentation." +"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 " -"a :exc:`TypeError`." +"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 " +"*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, " -"then :exc:`TypeError` is raised." +"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 +291,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 +315,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 +335,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 +381,70 @@ msgid "" msgstr "" msgid "" -"``compare``: If true (the default), this field is included in the generated " +"*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 +452,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 +468,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 +515,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:" +"@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 "" +"Dataclass instances are also supported by generic function :func:`copy." +"replace`." msgstr "" msgid "" -"Return ``True`` if its parameter is a dataclass or an instance of one, " -"otherwise return ``False``." +"Return ``True`` if its parameter is a dataclass (including subclasses of a " +"dataclass) or an instance of one, otherwise return ``False``." msgstr "" msgid "" @@ -477,15 +622,20 @@ 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 :" +"``_`` 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 "" @@ -495,9 +645,20 @@ 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 "" @@ -510,13 +671,12 @@ 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,17 +685,41 @@ 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 "" -"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." +"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:`!__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 "" @@ -548,27 +732,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 +762,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,8 +785,8 @@ 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." +"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 "" @@ -595,33 +794,50 @@ 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__`." +"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 +848,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 "" +"@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 "" -"The generated :meth:`~object.__init__` method for ``D`` will look like::" +"def __init__(self, x: Any = 15.0, z: int = 10, *, y: int = 0, w: int = 1, t: " +"int = 0):" msgstr "" msgid "" @@ -648,22 +883,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 +915,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 +976,17 @@ 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 +998,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..c311e73511 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-07-11 16:22+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/datetime.po b/library/datetime.po index 9d3ed279c5..179b5a64a6 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-07-11 16:22+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 " @@ -108,7 +105,7 @@ 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 " +"`!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 "" @@ -306,8 +303,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 +318,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 " @@ -340,12 +344,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 "" @@ -384,8 +406,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" @@ -561,9 +583,9 @@ 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." +"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 +618,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 +632,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" @@ -718,12 +740,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 "" @@ -830,7 +852,7 @@ msgid "" msgstr "" msgid "" -"Order comparison between a :class:`!date` object that is not also a :class:`." +"Order comparison between a :class:`date` object that is not also a :class:`." "datetime` instance and a :class:`!datetime` object raises :exc:`TypeError`." msgstr "" @@ -855,8 +877,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 "" @@ -927,10 +949,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 +964,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 +976,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 "" @@ -996,13 +1015,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 +1036,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 +1089,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 "" @@ -1267,7 +1286,7 @@ 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 :" +"*date* argument is a :class:`!datetime` object, its time components and :" "attr:`.tzinfo` attributes are ignored." msgstr "" @@ -1294,25 +1313,25 @@ 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" +">>> dt.datetime.fromisoformat('2011-11-04 00:05:23.283+00:00')\n" "datetime.datetime(2011, 11, 4, 0, 5, 23, 283000, tzinfo=datetime.timezone." "utc)\n" -">>> datetime.fromisoformat('2011-11-04T00:05:23+04:00')\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 "" @@ -1360,9 +1379,9 @@ msgid "" 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'" @@ -1457,7 +1476,7 @@ 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 "" @@ -1482,7 +1501,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 +1510,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 "" @@ -1684,7 +1703,7 @@ 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 " +"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." @@ -1758,10 +1777,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 +1790,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 +1840,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 "" @@ -1841,8 +1860,8 @@ 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 "" @@ -1877,28 +1896,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" +">>> 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 +1933,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 +1942,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" +"format(my_datetime, \"day\", \"month\", \"time\")\n" "'The day is 21, the month is November, the time is 04:30PM.'" msgstr "" @@ -1936,47 +1956,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 +2008,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" @@ -2099,23 +2119,23 @@ 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" +">>> dt.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: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 "" @@ -2127,7 +2147,7 @@ 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 "" @@ -2159,14 +2179,14 @@ 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)." +">>> 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 "" @@ -2211,18 +2231,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,17 +2269,17 @@ 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 " +"`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 "" @@ -2334,11 +2354,11 @@ 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 " +"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 " +"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." @@ -2350,24 +2370,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 "" @@ -2383,7 +2407,7 @@ msgid "" "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 " +"specific value of *dt* passed, especially if the :class:`!tzinfo` class is " "accounting for daylight time." msgstr "" @@ -2394,10 +2418,10 @@ 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,10 +2434,10 @@ msgid "" msgstr "" msgid "" -"When a :class:`.datetime` object is passed in response to a :class:`." +"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 " +"`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 "" @@ -2451,20 +2475,22 @@ 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 "" @@ -2473,71 +2499,73 @@ msgid "" 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" +"ZERO = dt.timedelta(0)\n" +"HOUR = dt.timedelta(hours=1)\n" +"SECOND = dt.timedelta(seconds=1)\n" "\n" -"STDOFFSET = timedelta(seconds = -_time.timezone)\n" -"if _time.daylight:\n" -" DSTOFFSET = timedelta(seconds = -_time.altzone)\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 +2578,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 +2605,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 +2623,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" @@ -2678,9 +2707,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 +2736,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" @@ -2728,7 +2759,7 @@ 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 " +"`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 "" @@ -2845,7 +2876,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 +2922,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 +2990,7 @@ msgid "01, 02, ..., 31" msgstr "" msgid "\\(9)" -msgstr "" +msgstr "\\(9)" msgid "``%b``" msgstr "``%b``" @@ -3083,7 +3115,7 @@ msgid "(empty), +0000, -0400, +1030, +063415, -030712.345216" msgstr "" msgid "\\(6)" -msgstr "" +msgstr "\\(6)" msgid "``%Z``" msgstr "``%Z``" @@ -3189,7 +3221,7 @@ msgid "" msgstr "" msgid "\\(8)" -msgstr "" +msgstr "\\(8)" msgid "``%u``" msgstr "``%u``" @@ -3260,7 +3292,32 @@ 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::" @@ -3418,13 +3475,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 +3495,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 +3512,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..0b7c6c56d2 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-07-11 16:22+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 "" @@ -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 "" @@ -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,7 +204,7 @@ 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 " @@ -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 " @@ -260,6 +273,11 @@ msgid "" "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." msgstr "" @@ -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 "" @@ -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 " @@ -389,26 +410,25 @@ 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 :" @@ -432,10 +452,7 @@ msgid "" "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 "" @@ -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..d2f013d40b 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-07-11 16:22+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..914b92a656 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-07-11 16:22+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:`!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 " @@ -38,11 +36,11 @@ msgid "" 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 "" @@ -136,7 +134,7 @@ msgid "" "Arithmetic Specification `_." msgstr "" -msgid "Quick-start Tutorial" +msgid "Quick-start tutorial" msgstr "" msgid "" @@ -268,6 +266,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,7 +305,7 @@ 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:" +"the :meth:`Context` constructor. To make an alternate active, use the :func:" "`setcontext` function." msgstr "" @@ -1184,43 +1204,40 @@ 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 " -"exponent reduced and a corresponding number of zeros added to its " -"coefficient, in order to fit the exponent constraints; this preserves the " -"value of the number but loses information about significant trailing zeros. " -"For example::" +"Either ``0`` (the default) or ``1``. If set to ``1``, the exponent ``e`` of " +"a :class:`Decimal` instance representable in this context is strictly " +"limited to the range ``Emin - prec + 1 <= e <= Emax - prec + 1``. If *clamp* " +"is ``0`` then a weaker condition holds: the adjusted exponent of the :class:" +"`Decimal` instance is at most :attr:`~Context.Emax`. When *clamp* is ``1``, " +"a large normal number will, where possible, have its exponent reduced and a " +"corresponding number of zeros added to its coefficient, in order to fit the " +"exponent constraints; this preserves the value of the number but loses " +"information about significant trailing zeros. For example::" msgstr "" msgid "" @@ -1557,10 +1574,10 @@ msgid "" msgstr "" msgid "32-bit" -msgstr "" +msgstr "32-bit" msgid "64-bit" -msgstr "" +msgstr "64-bit" msgid "``425000000``" msgstr "``425000000``" @@ -1765,7 +1782,7 @@ msgid "" " FloatOperation(DecimalException, exceptions.TypeError)" msgstr "" -msgid "Floating-Point Notes" +msgid "Floating-point notes" msgstr "" msgid "Mitigating round-off error with increased precision" @@ -2098,32 +2115,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 +2152,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 +2189,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 +2206,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 +2223,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 " @@ -2258,11 +2275,11 @@ msgid "" "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 " +"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 " diff --git a/library/devmode.po b/library/devmode.po index 682321da08..0e46f14f70 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-07-11 16:22+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/difflib.po b/library/difflib.po index 8dafb276b5..8afbada728 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, 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-07-19 16:20+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:`!difflib` --- Helpers for computing deltas" msgstr "" msgid "**Source code:** :source:`Lib/difflib.py`" -msgstr "" +msgstr "**Kod źródłowy:** :source:`Lib/difflib.py`" msgid "" "This module provides classes and functions for comparing sequences. It can " @@ -129,6 +128,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 "" @@ -270,7 +274,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." @@ -351,17 +355,16 @@ msgid "" msgstr "" msgid "" -"`Pattern Matching: The Gestalt Approach `_" +"`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." +"This was published in Dr. Dobb's Journal in July, 1988." msgstr "" -msgid "SequenceMatcher Objects" +msgid "SequenceMatcher objects" msgstr "" msgid "The :class:`SequenceMatcher` class has this constructor:" @@ -601,7 +604,7 @@ msgid "" "ratio`:" msgstr "" -msgid "SequenceMatcher Examples" +msgid "SequenceMatcher examples" msgstr "" msgid "This example compares two strings, considering blanks to be \"junk\":" @@ -641,7 +644,7 @@ msgid "" "`SequenceMatcher`." msgstr "" -msgid "Differ Objects" +msgid "Differ objects" msgstr "" msgid "" @@ -696,7 +699,7 @@ msgid "" "IOBase.writelines` method of a file-like object." msgstr "" -msgid "Differ Example" +msgid "Differ example" msgstr "" msgid "" @@ -732,7 +735,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 +746,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" diff --git a/library/dis.po b/library/dis.po index 7ba948f713..e028b7f272 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-07-11 16:22+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 " @@ -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 "" @@ -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 "" diff --git a/library/doctest.po b/library/doctest.po index 13a25818d2..12a72f381d 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-07-11 16:22+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 " @@ -222,8 +220,8 @@ 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 " +"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 "" @@ -294,7 +292,7 @@ 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`." +"func:`!testmod`." msgstr "" msgid "" @@ -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 "" @@ -664,7 +672,7 @@ msgid "" "The interactive shell omits the traceback header line for some :exc:" "`SyntaxError`\\ s. But doctest uses the traceback header line to " "distinguish exceptions from non-exceptions. So in the rare case where you " -"need to test a :exc:`SyntaxError` that omits the traceback header, you will " +"need to test a :exc:`!SyntaxError` that omits the traceback header, you will " "need to manually add the traceback header line to your test example." msgstr "" @@ -1017,17 +1025,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 +1128,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 +1138,8 @@ 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 "" @@ -1265,8 +1273,8 @@ 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 " +"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." @@ -1311,15 +1319,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 "" @@ -1345,11 +1354,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 +1368,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 +1386,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 +1398,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 " @@ -1405,17 +1415,17 @@ 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." +"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 "" @@ -1432,12 +1442,12 @@ msgid "" "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 " +"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." +"`!doctest`'s :mod:`!unittest` reporting flags are ignored." msgstr "" msgid "" @@ -1545,7 +1555,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 "" @@ -1691,10 +1701,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" @@ -1715,7 +1725,7 @@ msgstr "" msgid "" "*globs*, *name*, *filename*, and *lineno* are attributes for the new :class:" -"`DocTest` object. See the documentation for :class:`DocTest` for more " +"`!DocTest` object. See the documentation for :class:`DocTest` for more " "information." msgstr "" @@ -1729,7 +1739,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 "" @@ -1758,7 +1768,7 @@ msgid "" "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 " +"customized by passing a subclass of :class:`!OutputChecker` to the " "constructor." msgstr "" @@ -1810,7 +1820,7 @@ 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:" +"containing *example*. *out* is the output function that was passed to :meth:" "`DocTestRunner.run`." msgstr "" @@ -2244,8 +2254,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.contentmanager.po b/library/email.contentmanager.po index 72d62b36e6..79612da46a 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-07-11 16:22+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 " diff --git a/library/email.encoders.po b/library/email.encoders.po index 0411469ece..ac731f4e9f 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-07-11 16:22+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.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 " diff --git a/library/email.examples.po b/library/email.examples.po index e3bd8290a1..c27c0db8cf 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-07-11 16:22+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/email.generator.po b/library/email.generator.po index 28ce9dd576..bb6649e0c3 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-07-11 16:22+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.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 " diff --git a/library/email.header.po b/library/email.header.po index 2b1624a3d5..fad27a22f7 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-07-11 16:22+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 " @@ -237,24 +237,38 @@ 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 :" @@ -272,3 +286,8 @@ msgid "" "`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..c3086b812b 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-07-13 18:00+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 +27,10 @@ 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 " @@ -123,12 +122,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 unicode). ``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 "" @@ -397,7 +397,7 @@ msgid "resent-cc" msgstr "" msgid "bcc" -msgstr "" +msgstr "bcc" msgid "resent-bcc" msgstr "" diff --git a/library/email.message.po b/library/email.message.po index 06f067e878..1e3a26ed71 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-07-11 16:22+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` " @@ -85,7 +85,7 @@ msgid "" "`~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." +"`~email.policy` documentation. [2]_" msgstr "" msgid "" @@ -774,3 +774,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..2ff7914b5e 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-07-11 16:22+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 " @@ -138,7 +138,7 @@ 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:" diff --git a/library/email.parser.po b/library/email.parser.po index be98cfbb25..63a7afb7a4 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-07-11 16:22+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 " @@ -150,7 +150,7 @@ 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 " +"contain only ASCII text or, if :attr:`~email.policy.EmailPolicy.utf8` is " "``True``, no binary attachments." msgstr "" @@ -187,16 +187,16 @@ 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." +"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:" +"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 "" @@ -290,10 +290,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 "" diff --git a/library/email.po b/library/email.po index 840a868319..fbb5608040 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-07-11 16:22+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`." +"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 " @@ -56,6 +59,16 @@ msgid "" "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` " @@ -67,6 +80,14 @@ msgid "" "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:" @@ -164,12 +185,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 +192,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..8291ffad4b 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-07-11 16:22+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 " @@ -444,7 +443,7 @@ msgid "" msgstr "" msgid "[1]_" -msgstr "" +msgstr "[1]_" msgid "" "If ``False``, follow :rfc:`5322`, supporting non-ASCII characters in headers " @@ -691,6 +690,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..36728f4445 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-07-11 16:22+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` " diff --git a/library/ensurepip.po b/library/ensurepip.po index 531f99b1fa..b7dbcbf140 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-07-11 16:22+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 "" diff --git a/library/enum.po b/library/enum.po index b7c6254acf..b27e13a8a5 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-07-11 16:22+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`" @@ -176,7 +175,7 @@ msgid "" msgstr "" msgid ":class:`EnumDict`" -msgstr "" +msgstr ":class:`EnumDict`" msgid "A subclass of :class:`dict` for use when subclassing :class:`EnumType`." msgstr "" @@ -241,6 +240,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 +260,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 " @@ -268,6 +276,11 @@ msgid "" "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:" msgstr "" @@ -381,7 +394,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 +417,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 +467,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." @@ -486,7 +509,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 +521,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', " @@ -527,11 +551,24 @@ msgstr "" msgid "" "A *staticmethod* that is used to determine the next value returned by :class:" -"`auto`::" +"`auto`." +msgstr "" + +msgid "" +"For standard :class:`Enum` classes the next value chosen is the highest " +"value seen incremented by one." msgstr "" msgid "" -">>> from enum import auto\n" +"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 +580,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 +605,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 +644,7 @@ msgid "" msgstr "" msgid "" +">>> from enum import auto, Enum\n" ">>> class OtherStyle(Enum):\n" "... ALTERNATE = auto()\n" "... OTHER = auto()\n" @@ -622,6 +664,7 @@ msgid "" msgstr "" msgid "" +">>> from enum import auto, Enum\n" ">>> class OtherStyle(Enum):\n" "... ALTERNATE = auto()\n" "... OTHER = auto()\n" @@ -640,6 +683,7 @@ msgid "" msgstr "" msgid "" +">>> from enum import auto, Enum\n" ">>> class OtherStyle(Enum):\n" "... ALTERNATE = auto()\n" "... OTHER = auto()\n" @@ -660,6 +704,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 +754,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 "" @@ -1066,23 +1141,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 "" @@ -1111,13 +1177,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,7 +1204,7 @@ msgstr "``_ignore_``" msgid "``_add_alias_``, ``_add_value_alias_``, ``_repr_*``" msgstr "" -msgid "Utilities and Decorators" +msgid "Utilities and decorators" msgstr "" msgid "" @@ -1152,7 +1218,8 @@ msgid "" 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 +1231,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 "" diff --git a/library/exceptions.po b/library/exceptions.po index ca886a5e92..545cf6a53b 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-07-13 18:00+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" @@ -225,10 +224,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,8 +239,8 @@ 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." @@ -319,10 +322,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." @@ -387,8 +390,8 @@ 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 "" @@ -401,8 +404,8 @@ 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." +"error`, :exc:`select.error` and :exc:`!mmap.error` have been merged into :" +"exc:`OSError`, and the constructor may return a subclass." msgstr "" msgid "" @@ -591,7 +594,7 @@ msgid "" "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 " +"(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 "" @@ -718,8 +721,8 @@ 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 "" @@ -869,6 +872,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 "" @@ -925,6 +933,17 @@ msgid "" "`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 "" @@ -1021,7 +1040,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 "" diff --git a/library/faulthandler.po b/library/faulthandler.po index ea7976a244..663de2ed76 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-07-11 16:22+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/fcntl.po b/library/fcntl.po index 445875c3d2..22757c6aa4 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-07-11 16:22+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/fnmatch.po b/library/fnmatch.po index 6d75b82838..e72c19113a 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-07-11 16:22+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* " diff --git a/library/fractions.po b/library/fractions.po index b402aec807..682388e830 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,13 +41,13 @@ 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 " +"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 " +"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 " @@ -55,6 +55,9 @@ msgid "" "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 " @@ -65,6 +68,33 @@ msgid "" "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 " @@ -80,7 +110,7 @@ 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 "" @@ -94,6 +124,21 @@ msgid "" "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." msgstr "" @@ -101,8 +146,11 @@ 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 "" @@ -153,6 +201,54 @@ msgid "" "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`" msgstr "" diff --git a/library/ftplib.po b/library/ftplib.po index 1f8f987f0b..bac6e0828f 100644 --- a/library/ftplib.po +++ b/library/ftplib.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:06+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-07-11 16:22+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:`!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 :" diff --git a/library/functional.po b/library/functional.po index e075c6473c..ca41c42ef4 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-07-11 16:22+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..c4c82dd56e 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-07-19 16:20+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" @@ -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." @@ -597,21 +599,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ą." @@ -773,11 +775,11 @@ 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." @@ -974,11 +976,10 @@ 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 :" @@ -1143,44 +1144,30 @@ 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." +"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 danymi wejściowymi " -"dostarczonymi przez użytkownika może prowadzić do luk w zabezpieczeniach." +"Ta funkcja wykonuje dowolny kod. Wywołanie go z niezaufanymi danymi " +"wejściowymi dostarczonymi przez użytkownika 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. " +"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 *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` )." msgid "Example:" msgstr "Przykład:" @@ -1217,11 +1204,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 " @@ -1298,15 +1285,15 @@ 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` 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 " @@ -1497,12 +1484,12 @@ 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:" @@ -1619,13 +1606,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 " @@ -1885,29 +1872,29 @@ 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 " -"its :meth:`~iterator.__next__` method; if the value returned is equal to " -"*sentinel*, :exc:`StopIteration` will be raised, otherwise the value will be " -"returned." +"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`." @@ -2189,14 +2176,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 " @@ -2653,16 +2640,27 @@ msgstr "" 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 "" -"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 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 "" -"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 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 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 +2674,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 " @@ -2688,8 +2686,8 @@ msgid "" "`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. " @@ -3000,15 +2998,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 " @@ -3059,12 +3057,12 @@ 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`, :" @@ -3198,7 +3196,7 @@ 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 " diff --git a/library/functools.po b/library/functools.po index 4de93e6f29..02d2153335 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-07-11 16:22+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 " @@ -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 "" @@ -235,7 +232,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,13 +246,13 @@ 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 "" @@ -350,9 +347,9 @@ 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 "" @@ -433,7 +430,7 @@ msgstr "" msgid "" "When *func* is a descriptor (such as a normal Python function, :func:" -"`classmethod`, :func:`staticmethod`, :func:`abstractmethod` or another " +"`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." @@ -522,7 +519,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 +599,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 +615,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 "" @@ -713,12 +711,14 @@ 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 "" @@ -728,8 +728,8 @@ 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 "" @@ -750,10 +750,10 @@ 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::" +"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 +775,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 "" @@ -866,8 +865,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" diff --git a/library/getopt.po b/library/getopt.po index 655cf83721..9aa677e172 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` " +"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 "" @@ -54,11 +63,11 @@ msgid "" "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)." +"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 "" @@ -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::" +"`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..3186bbd2b9 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-07-11 16:22+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ść" diff --git a/library/gettext.po b/library/gettext.po index 07ec6f6a75..4b5322d6ef 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-07-11 16:22+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 " diff --git a/library/glob.po b/library/glob.po index c78bb67b55..def5a557d3 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-07-07 18:08+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,7 +54,7 @@ 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 "" @@ -69,7 +71,7 @@ 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 " +"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,8 +136,8 @@ 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 "" diff --git a/library/graphlib.po b/library/graphlib.po index 3b1795eef2..f0b3454ff1 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-07-11 16:22+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` " diff --git a/library/grp.po b/library/grp.po index d4e576f8c4..ed6fd10e6b 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-07-11 16:22+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 "" @@ -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..3485ec4446 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-07-11 16:22+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" @@ -326,8 +327,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 +343,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..7fa20e7b2b 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-07-11 16:22+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. " @@ -111,7 +109,7 @@ msgid "" msgstr "" msgid "Usage" -msgstr "" +msgstr "Użytek" msgid "" "To obtain the digest of the byte string ``b\"Nobody inspects the spammish " @@ -130,6 +128,16 @@ msgid "" ">>> 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 "" @@ -288,8 +296,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 +365,7 @@ msgid "" msgstr "" msgid "BLAKE2" -msgstr "" +msgstr "BLAKE2" msgid "" "BLAKE2_ is a cryptographic hash function defined in :rfc:`7693` that comes " @@ -428,28 +436,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" @@ -736,6 +744,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 +898,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..0b6e2f3678 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-07-11 16:22+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,9 +92,6 @@ 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:" @@ -173,7 +174,7 @@ msgid "" 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/html.entities.po b/library/html.entities.po index 66ebf36f9a..0784a6ca12 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-07-11 16:22+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:`!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:" diff --git a/library/html.parser.po b/library/html.parser.po index aa0ec65cdd..4c56d1af3d 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-07-11 16:22+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::" +"encountered:" msgstr "" msgid "" @@ -160,7 +168,8 @@ 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 "" @@ -191,21 +200,21 @@ 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,7 +312,7 @@ msgid "" "parser = MyHTMLParser()" msgstr "" -msgid "Parsing a doctype::" +msgid "Parsing a doctype:" msgstr "" msgid "" @@ -313,7 +322,7 @@ msgid "" "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``)::" +"`~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/http.client.po b/library/http.client.po index e51675a78d..c3a8b96874 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-07-11 16:22+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.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 " @@ -155,7 +154,7 @@ 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 "" @@ -308,6 +307,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 "" @@ -323,17 +328,18 @@ msgid "" "server. Returns an :class:`HTTPResponse` instance." msgstr "" -msgid "" -"Note that you must have read the whole response before you can send a new " -"request to the server." -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." msgstr "" +msgid "" +"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 "" "Set the debugging level. The default debug level is ``0``, meaning no " "debugging output is printed. Any value greater than ``0`` will cause all " diff --git a/library/http.cookiejar.po b/library/http.cookiejar.po index 8ee16060e0..0bb8035cf9 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-07-05 16:47+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:`!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 "" @@ -52,9 +51,9 @@ 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:" +"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 "" @@ -112,8 +111,8 @@ 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:" @@ -122,21 +121,21 @@ 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." +"`Cookie` instances. Instead, if necessary, call :meth:`~CookieJar." +"make_cookies` on a :class:`CookieJar` instance." msgstr "" msgid "Module :mod:`urllib.request`" @@ -186,7 +185,7 @@ msgstr "" msgid ":rfc:`2964` - Use of HTTP State Management" msgstr "" -msgid "CookieJar and FileCookieJar Objects" +msgid "CookieJar and FileCookieJar objects" msgstr "" msgid "" @@ -201,23 +200,27 @@ 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 "" @@ -234,16 +237,18 @@ msgstr "" msgid "" "The *response* object (usually the result of a call to :meth:`urllib.request." -"urlopen`, or similar) should support an :meth:`info` method, which returns " -"an :class:`email.message.Message` instance." +"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 +289,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 +314,9 @@ 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 "" @@ -404,7 +409,7 @@ msgid "" "file." msgstr "" -msgid "CookiePolicy Objects" +msgid "CookiePolicy objects" msgstr "" msgid "" @@ -495,7 +500,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 +541,10 @@ 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 "" @@ -569,10 +574,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,10 +593,10 @@ 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:" +"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 "" @@ -636,22 +641,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 +668,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 +695,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 " diff --git a/library/http.cookies.po b/library/http.cookies.po index 431e281c65..93654ba98d 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-07-11 16:22+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 " @@ -161,9 +161,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 ``''``." @@ -266,9 +269,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..a7782165d5 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-07-11 16:22+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 " @@ -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..221484f502 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-07-05 16:47+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:`!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 "" @@ -63,7 +63,14 @@ 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 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 "" @@ -124,9 +131,9 @@ 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 "" @@ -173,7 +180,7 @@ 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 "" @@ -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 "" @@ -270,14 +277,20 @@ msgid "" "`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." 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 "" @@ -309,7 +322,7 @@ 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 " +"`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 "" @@ -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,8 +438,7 @@ 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 "" @@ -431,10 +449,35 @@ 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,7 +519,8 @@ msgid "" msgstr "" msgid "" -"The :func:`do_GET` and :func:`do_HEAD` functions are modified to run CGI " +"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 "" @@ -512,12 +556,12 @@ msgid "" 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,7 +611,7 @@ 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" @@ -589,10 +633,17 @@ 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 :" diff --git a/library/idle.po b/library/idle.po index 3ffd7b95ff..504a52d368 100644 --- a/library/idle.po +++ b/library/idle.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-07-11 16:22+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 "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 +61,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 +150,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.)" @@ -266,7 +274,7 @@ msgstr "" msgid "" "Open a scrollable list allowing selection of existing names. See :ref:" -"`Completions ` in the Editing and navigation section below." +"`Completions ` in the Editing and Navigation section below." msgstr "" msgid "Expand Word" @@ -283,7 +291,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 +307,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 +364,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 "" @@ -828,6 +836,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 "" @@ -950,7 +971,7 @@ msgid "" "importing functions to be used from IDLE's Python shell." msgstr "" -msgid "Command line usage" +msgid "Command-line usage" msgstr "" msgid "" @@ -1372,7 +1393,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..c708f659ce 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-07-05 16:47+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:`!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 " +"`3501`. It is backward compatible with IMAP4 (:rfc:`1730`) servers, but note " "that the ``STATUS`` command is not supported in IMAP4." msgstr "" @@ -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 " @@ -145,9 +151,9 @@ 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 +161,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 "" @@ -203,7 +212,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 +240,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 "" @@ -333,6 +351,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 "" @@ -497,7 +518,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 +535,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 "" @@ -611,6 +632,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..d4508da010 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-07-11 16:22+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 " diff --git a/library/importlib.po b/library/importlib.po index 156f554ebc..78c1d622af 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-07-11 16:22+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" @@ -306,11 +304,17 @@ msgid "" "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 " @@ -846,7 +850,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 " @@ -1216,8 +1220,8 @@ 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." +"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 " @@ -1268,7 +1272,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 " diff --git a/library/index.po b/library/index.po index 3399ca932d..37e685e906 100644 --- a/library/index.po +++ b/library/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-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-07-11 16:22+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/inspect.po b/library/inspect.po index c8ba7880b4..dcfffd3d2f 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-07-19 16:20+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 " @@ -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 "" @@ -609,6 +636,11 @@ msgid "" "wrapped function is an :term:`asynchronous generator` function." 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." @@ -647,8 +679,7 @@ 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." +"`isclass`, :func:`ismethod` or :func:`isfunction` is true." msgstr "" msgid "" @@ -660,10 +691,11 @@ 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 "" @@ -673,17 +705,36 @@ msgid "" "descriptors)." msgstr "" -msgid "Return ``True`` if the object is a data descriptor." +msgid "" +"Return ``True`` if the object is a data descriptor, but not if :func:" +"`isclass`, :func:`ismethod` or :func:`isfunction` is true." +msgstr "" + +msgid "" +"Data descriptors always have a :meth:`~object.__set__` method and/or a :meth:" +"`~object.__delete__` method. Optionally, they may also have a :meth:" +"`~object.__get__` method." +msgstr "" + +msgid "" +"Examples of data descriptors are :func:`properties `, getsets and " +"member descriptors. Note that for the latter two (defined only in C " +"extension modules), more specific tests are available: :func:" +"`isgetsetdescriptor` and :func:`ismemberdescriptor`, respectively." +msgstr "" + +msgid "" +"While data descriptors may also have :attr:`~definition.__name__` and :attr:" +"`!__doc__` attributes (as properties, getsets and member descriptors do), " +"this is not necessarily the case in general." msgstr "" msgid "" -"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." @@ -1261,7 +1312,7 @@ 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." +"code migrating away from the legacy :func:`!getargspec` API." msgstr "" msgid "" @@ -1622,7 +1673,7 @@ msgstr "" msgid "" "For cases where you want passive introspection, like documentation tools, " -"this can be inconvenient. :func:`getattr_static` has the same signature as :" +"this can be inconvenient. :func:`getattr_static` has a similar signature as :" "func:`getattr` but avoids executing code when it fetches attributes." msgstr "" @@ -1849,8 +1900,8 @@ 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..6c3a9b83f8 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-07-11 16:22+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/intro.po b/library/intro.po index ddf8947aa5..32ce4876e5 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-07-11 16:22+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/io.po b/library/io.po index 292855d279..41e8a65ae6 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-07-15 17:01+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" @@ -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 "" @@ -604,9 +611,14 @@ 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 +636,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." +"`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,6 +664,14 @@ 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`." @@ -649,15 +680,14 @@ 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." +"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 "" @@ -695,34 +725,37 @@ 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 "" @@ -736,6 +769,11 @@ 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." @@ -767,7 +805,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 +838,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 +854,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 "" @@ -917,20 +961,18 @@ 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 "" @@ -977,14 +1019,15 @@ 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 "" @@ -1048,9 +1091,9 @@ 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 "" @@ -1124,7 +1167,8 @@ 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 "" diff --git a/library/ipaddress.po b/library/ipaddress.po index c4e825e516..5dc739fbb2 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-07-11 16:22+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 " @@ -263,7 +263,22 @@ msgid "" "`2373` (for IPv6)." msgstr "" -msgid "``True`` if the address is otherwise IETF reserved." +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 "" +"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 "" @@ -350,9 +365,9 @@ msgid "" 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 "" diff --git a/library/itertools.po b/library/itertools.po index 8f6cd6e0c1..6e2eb0d4de 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-07-11 16:22+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 "" @@ -1144,7 +1143,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 +1154,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 +1239,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..df43188a3d 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-07-11 16:22+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:`!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:" @@ -42,6 +38,12 @@ msgid "" "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 "" "Be cautious when parsing JSON data from untrusted sources. A malicious JSON " "string may cause the decoder to consume considerable CPU and memory " @@ -49,7 +51,7 @@ msgid "" msgstr "" msgid "" -":mod:`json` exposes an API familiar to users of the standard library :mod:" +"This module exposes an API familiar to users of the standard library :mod:" "`marshal` and :mod:`pickle` modules." msgstr "" @@ -96,7 +98,7 @@ msgid "" "}" msgstr "" -msgid "Specializing JSON object encoding::" +msgid "Customizing JSON object encoding::" msgstr "" msgid "" @@ -126,7 +128,7 @@ msgid "" "['streaming API']" msgstr "" -msgid "Specializing JSON object decoding::" +msgid "Customizing JSON object decoding::" msgstr "" msgid "" @@ -226,8 +228,10 @@ 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 "" @@ -315,7 +319,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 (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 +327,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* " @@ -406,7 +410,7 @@ msgid "JSON" msgstr "" msgid "Python" -msgstr "" +msgstr "Python" msgid "object" msgstr "obiekt" @@ -569,8 +573,10 @@ 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 "" @@ -724,7 +730,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 "" @@ -855,7 +861,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 " diff --git a/library/linecache.po b/library/linecache.po index af49ed3d6a..18c9103c2e 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-07-11 16:22+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:`!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 " diff --git a/library/locale.po b/library/locale.po index 1ae96f70a2..e927d0fec1 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-07-01 18: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,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,12 +52,17 @@ 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 " -"exception :exc:`Error` is raised. If successful, the new locale setting is " -"returned." +"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 "" @@ -66,9 +70,24 @@ msgid "" "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 "" @@ -416,15 +435,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 "" @@ -575,8 +596,8 @@ 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 "" @@ -627,21 +648,6 @@ msgid "" "`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" -msgstr "" - msgid "Background, details, hints, tips and caveats" msgstr "" @@ -694,6 +700,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 "" diff --git a/library/logging.config.po b/library/logging.config.po index d65f9c8796..445bc54575 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-07-11 16:22+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" @@ -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 "" @@ -712,7 +711,7 @@ 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`` " diff --git a/library/logging.handlers.po b/library/logging.handlers.po index 059d75fa24..aec439c46c 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-07-11 16:22+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" @@ -363,9 +362,14 @@ 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 " @@ -512,6 +516,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 "" @@ -774,7 +783,7 @@ msgid "``alert``" msgstr "" msgid "LOG_ALERT" -msgstr "" +msgstr "LOG_ALERT" msgid "``crit`` or ``critical``" msgstr "" @@ -786,19 +795,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 +819,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 +834,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 +876,7 @@ msgid "``mail``" msgstr "``mail``" msgid "LOG_MAIL" -msgstr "" +msgstr "LOG_MAIL" msgid "``news``" msgstr "``news``" @@ -879,19 +888,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 +912,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 +936,7 @@ msgid "``local5``" msgstr "``local5``" msgid "LOG_LOCAL5" -msgstr "" +msgstr "LOG_LOCAL5" msgid "``local6``" msgstr "``local6``" @@ -939,7 +948,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 " @@ -1011,7 +1020,7 @@ msgid "" msgstr "" msgid "SMTPHandler" -msgstr "" +msgstr "SMTPHandler" msgid "" "The :class:`SMTPHandler` class, located in the :mod:`logging.handlers` " @@ -1123,7 +1132,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` " @@ -1202,6 +1211,15 @@ msgid "" "`~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." diff --git a/library/logging.po b/library/logging.po index 7ed86b24cf..1ba801ceef 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-07-11 16:22+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 " @@ -756,19 +755,18 @@ msgid "" 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 "" @@ -1142,6 +1140,14 @@ 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 "" @@ -1332,11 +1338,12 @@ 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 "" @@ -1375,7 +1382,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 +1393,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." diff --git a/library/lzma.po b/library/lzma.po index 52768cfe32..eccb12e101 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, 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, 2024\n" +"POT-Creation-Date: 2026-07-11 16:22+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:`!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 " diff --git a/library/mailbox.po b/library/mailbox.po index 65e9be0c62..7d24194131 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-07-11 16:22+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:`!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 " @@ -880,7 +878,7 @@ msgid "" "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 " +"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 "" @@ -1030,7 +1028,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 "" @@ -1224,7 +1222,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." msgstr "" @@ -1498,7 +1496,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 +1514,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..ef362518f0 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-07-11 16:22+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/math.po b/library/math.po index 7908b8cf93..c361e5a537 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-07-11 16:22+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 `_, 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 "" diff --git a/library/mimetypes.po b/library/mimetypes.po index 7f9f7b3cd4..33929651b0 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-07-19 16:20+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 " @@ -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 "" diff --git a/library/mmap.po b/library/mmap.po index c349b092b3..4c9f786c9f 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-07-11 16:22+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" @@ -319,7 +319,7 @@ 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` " +"created with *trackfd* set to ``False``, will raise a :exc:`ValueError` " "exception." 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..c3b1fe5a10 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-07-11 16:22+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 "" @@ -89,10 +92,16 @@ msgid "" msgstr "" msgid "" -"Create a C runtime file descriptor from the file handle *handle*. The " +"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." +"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 "" +"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..fa9b4a2d11 100644 --- a/library/multiprocessing.po +++ b/library/multiprocessing.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 , 2024 -# Stefan Ocetkiewicz , 2024 -# 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-07-11 16:22+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:`!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,9 +51,8 @@ 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 " +"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 " @@ -83,6 +78,13 @@ 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 " @@ -144,6 +146,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 "" @@ -291,8 +300,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 "" @@ -628,6 +641,23 @@ msgid "" "`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 "" +"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 "" @@ -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 "" @@ -1018,6 +1088,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 +1100,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 "" @@ -1092,11 +1168,18 @@ msgid "" "class:`queue.Queue`. These methods are usually unnecessary for most code:" msgstr "" +msgid "Close the queue: release internal resources." +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." +"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 "" +"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 "" @@ -1138,9 +1221,6 @@ 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." @@ -1218,7 +1298,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 +1321,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,10 +1347,10 @@ 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 "" @@ -1286,19 +1366,21 @@ msgid "" 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 +1397,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'))" @@ -1428,8 +1510,8 @@ 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 " +"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 "" @@ -1452,16 +1534,16 @@ msgid "" 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 "" @@ -1766,11 +1848,14 @@ 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 "" @@ -1787,7 +1872,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" @@ -1855,6 +1943,15 @@ msgid "" "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 "" "The same as :func:`RawValue` except that depending on the value of *lock* a " "process-safe synchronization wrapper may be returned instead of a raw ctypes " @@ -2033,11 +2130,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 " @@ -2593,7 +2685,9 @@ 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." +"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 "" @@ -2630,9 +2724,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 "" @@ -3113,6 +3207,18 @@ msgid "" "urandom`." msgstr "" +msgid "" +"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" @@ -3455,10 +3561,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" diff --git a/library/multiprocessing.shared_memory.po b/library/multiprocessing.shared_memory.po index 562cf8488e..f4e129f8e6 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-07-11 16:22+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/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 " diff --git a/library/numeric.po b/library/numeric.po index 8e91420f18..165fc3783a 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-07-11 16:22+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/operator.po b/library/operator.po index 961c3f0010..86d9055cef 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-07-19 16:20+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:`!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 " @@ -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 "" @@ -325,7 +321,7 @@ msgid "Concatenation" msgstr "" msgid "``seq1 + seq2``" -msgstr "" +msgstr "``seq1 + seq2``" msgid "``concat(seq1, seq2)``" msgstr "``concat(seq1, seq2)``" @@ -334,7 +330,7 @@ msgid "Containment Test" msgstr "" msgid "``obj in seq``" -msgstr "" +msgstr "``obj in seq``" msgid "``contains(seq, obj)``" msgstr "``contains(seq, obj)``" @@ -354,7 +350,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 +359,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 +368,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 +377,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..ed96f11d3e 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-07-11 16:22+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 "" diff --git a/library/os.path.po b/library/os.path.po index 2db0d0e5ee..ab65686b39 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-07-11 16:22+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" @@ -66,10 +64,10 @@ msgid "" "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 "" @@ -81,8 +79,11 @@ 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 ":func:`os.path.join` and :func:`os.path.normpath`." msgstr "" msgid "Accepts a :term:`path-like object`." @@ -110,14 +111,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 "" @@ -230,6 +233,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 +272,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,15 +328,37 @@ 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. " +"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`." @@ -369,9 +399,33 @@ msgid "" msgstr "" msgid "" -"If a path doesn't exist or a symlink loop is encountered, and *strict* is " -"``True``, :exc:`OSError` is raised. If *strict* is ``False`` these errors " -"are ignored, and so the result might be missing or otherwise inaccessible." +"By default, the path is evaluated up to the first component that does not " +"exist, is a symlink loop, or whose evaluation raises :exc:`OSError`. All " +"such components are appended unchanged to the existing part of the path." +msgstr "" + +msgid "" +"Some errors that are handled this way include \"access denied\", \"not a " +"directory\", or \"bad argument to internal function\". Thus, the resulting " +"path may be missing or inaccessible, may still contain links or loops, and " +"may traverse non-directories." +msgstr "" + +msgid "This behavior can be modified by keyword arguments:" +msgstr "" + +msgid "" +"If *strict* is ``True``, the first error encountered when evaluating the " +"path is re-raised. In particular, :exc:`FileNotFoundError` is raised if " +"*path* does not exist, or another :exc:`OSError` if it is otherwise " +"inaccessible." +msgstr "" + +msgid "" +"If *strict* is :py:data:`os.path.ALLOW_MISSING`, errors other than :exc:" +"`FileNotFoundError` are re-raised (as with ``strict=True``). Thus, the " +"returned path will not contain any symbolic links, but the named file and " +"some of its parent directories may be missing." msgstr "" msgid "" @@ -391,6 +445,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 " @@ -434,8 +496,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..7045140c3f 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-07-07 18:08+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:`!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 " @@ -497,9 +495,9 @@ 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 "" @@ -660,46 +658,53 @@ msgstr "" msgid "" "Returns information identifying the current operating system. The return " -"value is an object with five attributes:" -msgstr "" - -msgid ":attr:`sysname` - operating system name" +"value is a :class:`uname_result`." msgstr "" -msgid ":attr:`nodename` - name of machine on network (implementation-defined)" +msgid "" +"On macOS, iOS and Android, this returns the *kernel* name and 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." 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 "" @@ -916,9 +921,6 @@ msgid "" "of metadata." msgstr "" -msgid "This function is not available on MacOS." -msgstr "Ta funkcja nie jest dostępna w macOS." - msgid "" "Return system configuration information relevant to an open file. *name* " "specifies the configuration value to retrieve; it may be a string which is " @@ -952,8 +954,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 "" @@ -1140,8 +1142,8 @@ 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`." +"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." @@ -1391,8 +1393,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 "" @@ -1526,7 +1528,7 @@ msgid "" "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." +"its :meth:`~io.TextIOBase.write` method." msgstr "" msgid "" @@ -1584,7 +1586,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,9 +1630,8 @@ 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 "" @@ -1647,7 +1650,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 +1666,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 "" @@ -1758,6 +1761,11 @@ 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 "" @@ -2508,6 +2516,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 "" @@ -2522,12 +2535,17 @@ msgid "" msgstr "" msgid "" -"The entry's full path name: equivalent to ``os.path.join(scandir_path, entry." -"name)`` where *scandir_path* is the :func:`scandir` *path* argument. The " -"path is only absolute if the :func:`scandir` *path* argument was absolute. " -"If the :func:`scandir` *path* argument was a :ref:`file descriptor " -"`, the :attr:`path` attribute is the same as the :attr:`name` " -"attribute." +"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 "" @@ -2964,44 +2982,97 @@ 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 "The :const:`ST_RDONLY` and :const:`ST_NOSUID` constants were added." +msgid "Number of free blocks for unprivileged users." +msgstr "" + +msgid "Number of file entries, inodes, the filesystem can contain." +msgstr "" + +msgid "Number of free files entries." +msgstr "" + +msgid "Number of free file entries for unprivileged users." msgstr "" msgid "" -"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 "" @@ -3096,6 +3167,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 " @@ -3335,9 +3411,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" @@ -3437,7 +3513,7 @@ 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" @@ -3542,7 +3618,7 @@ 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 "" @@ -3580,7 +3656,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 "" @@ -3663,8 +3739,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 "" @@ -3855,7 +3931,7 @@ 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." +"files, you should flush them using :func:`~io.IOBase.flush` or :func:`os." "fsync` before calling an :func:`exec\\* ` function." msgstr "" @@ -5052,7 +5128,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 "" @@ -5074,7 +5150,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." diff --git a/library/pathlib.po b/library/pathlib.po index 92c6159596..12a828f6c6 100644 --- a/library/pathlib.po +++ b/library/pathlib.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: -# Rafael Fontenelle , 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-07-11 16:22+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:`!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 " @@ -472,7 +470,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::" @@ -1678,6 +1676,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 +1694,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``." @@ -2083,13 +2092,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 +2134,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." @@ -2297,13 +2312,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 +2330,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 +2402,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 +2441,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`" diff --git a/library/pdb.po b/library/pdb.po index 7a001f6796..9390db90e0 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-07-11 16:22+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 " @@ -113,6 +112,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::" @@ -299,7 +301,7 @@ msgstr "" msgid "See the documentation for the functions explained above." msgstr "" -msgid "Debugger Commands" +msgid "Debugger commands" msgstr "" msgid "" diff --git a/library/pickle.po b/library/pickle.po index cd85dbd84d..8eff6a4e86 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-07-11 16:22+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:`!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-" @@ -79,29 +77,11 @@ 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 "" @@ -603,7 +583,7 @@ msgid "classes accessible from the top level of a module;" msgstr "" msgid "" -"instances of such classes whose the result of calling :meth:`~object." +"instances of such classes for which the result of calling :meth:`~object." "__getstate__` is picklable (see section :ref:`pickle-inst` for details)." msgstr "" @@ -689,7 +669,7 @@ msgid "" msgstr "" msgid "" -"In protocols 2 and newer, classes that implements the :meth:" +"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 " @@ -812,7 +792,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 "" @@ -843,10 +826,10 @@ msgid "" "These items will be appended to the object either using ``obj.append(item)`` " "or, in batch, using ``obj.extend(list_of_items)``. This is primarily used " "for list subclasses, but may be used by other classes as long as they have :" -"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.)" +"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 "" diff --git a/library/pickletools.po b/library/pickletools.po index 774bc79b29..0d0d4dc31a 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-07-11 16:22+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:`!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 " diff --git a/library/pkgutil.po b/library/pkgutil.po index 58cd770bf5..e7dfade091 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-07-11 16:22+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 " @@ -127,9 +127,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 "" @@ -198,8 +199,7 @@ msgid "" "ResourceLoader.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 ``/``)." +"separator." msgstr "" msgid "" @@ -207,6 +207,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,6 +223,26 @@ 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 `." msgstr "" +msgid "" +"The :mod:`importlib.resources` module provides structured access to module " +"resources." +msgstr "" + msgid "Resolve a name to an object." msgstr "" diff --git a/library/platform.po b/library/platform.po index b1a0b83556..63f3d7f9f0 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-07-11 16:22+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." @@ -201,7 +206,7 @@ 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`." +"`os.uname`, where they are named :attr:`!sysname` and :attr:`!nodename`." msgstr "" msgid "Entries which cannot be determined are set to ``''``." @@ -213,7 +218,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 +236,7 @@ msgid "" "support." msgstr "" -msgid "Windows Platform" +msgid "Windows platform" msgstr "" msgid "" @@ -262,7 +267,7 @@ msgid "" "recognized as an IoT edition." msgstr "" -msgid "macOS Platform" +msgid "macOS platform" msgstr "" msgid "" @@ -276,7 +281,7 @@ msgid "" "strings." msgstr "" -msgid "iOS Platform" +msgid "iOS platform" msgstr "" msgid "" @@ -305,7 +310,7 @@ msgid "" "parameters." msgstr "" -msgid "Unix Platforms" +msgid "Unix platforms" msgstr "" msgid "" @@ -324,7 +329,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 +373,7 @@ msgid "" " return ids" msgstr "" -msgid "Android Platform" +msgid "Android platform" msgstr "" msgid "" @@ -410,3 +415,34 @@ msgid "" "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..e91af82cfd 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-07-11 16:22+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 " @@ -210,7 +209,7 @@ msgid "Generating a plist::" msgstr "" msgid "" -"import datetime\n" +"import datetime as dt\n" "import plistlib\n" "\n" "pl = dict(\n" @@ -226,7 +225,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..27fb707da5 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-07-11 16:22+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:`!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 " diff --git a/library/posix.po b/library/posix.po index 44b7740e29..1b9d9356d7 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-07-11 16:22+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/pprint.po b/library/pprint.po index c51156b9f4..135fbd0ec5 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-07-11 16:22+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 "" diff --git a/library/profile.po b/library/profile.po index 2f7a83b834..c4cb6cfcfc 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-07-11 16:22+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 "" @@ -325,7 +325,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 +341,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 +394,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 "" @@ -683,7 +683,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 +785,7 @@ msgid "" msgstr "" msgid "Limitations" -msgstr "" +msgstr "Ograniczenia" msgid "" "One limitation has to do with accuracy of timing information. There is a " @@ -880,7 +880,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 " diff --git a/library/pty.po b/library/pty.po index e71c89a197..2b1dafad05 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-07-11 16:22+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..775afe9bb5 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-07-11 16:22+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..67d8834c96 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-07-11 16:22+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 " diff --git a/library/pyclbr.po b/library/pyclbr.po index 6a142a526d..b01f75cb70 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-07-11 16:22+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..d291c236db 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-07-11 16:22+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 " @@ -103,6 +103,11 @@ msgid "" "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 "" ":program:`python -m pydoc -n ` will start the server listening at " "the given hostname. By default the hostname is 'localhost' but if you want " diff --git a/library/pyexpat.po b/library/pyexpat.po index 252b3aba21..8a91440e52 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-07-19 16:20+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,9 +27,8 @@ 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 "" @@ -77,6 +75,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-" @@ -238,6 +243,109 @@ 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 "" @@ -345,8 +453,8 @@ 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. This requires " +"Expat version 1.2 or newer." msgstr "" msgid "" @@ -472,6 +580,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 " diff --git a/library/queue.po b/library/queue.po index 483edd9b56..d5ed3d446f 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-07-13 18:00+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,11 +96,32 @@ 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 "" +"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." @@ -111,6 +132,11 @@ msgid "" "put_nowait`) is called on a :class:`Queue` object which is full." msgstr "" +msgid "" +"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 "" @@ -149,6 +175,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 "" @@ -170,6 +199,11 @@ msgid "" "`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)``." msgstr "" @@ -206,9 +240,83 @@ msgid "" "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 "" diff --git a/library/random.po b/library/random.po index b85dedf616..cd464a5f0d 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-07-11 16:22+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 " @@ -116,7 +115,7 @@ 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 "" @@ -501,6 +500,11 @@ msgid "" "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 "" "Class that uses the :func:`os.urandom` function for generating random " "numbers from sources provided by the operating system. Not available on all " @@ -714,9 +718,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" @@ -740,7 +746,22 @@ msgid "" " 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 "" diff --git a/library/re.po b/library/re.po index ac7e44fb99..9967c618d3 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-07-05 16:47+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 " @@ -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 "" @@ -1129,8 +1127,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 "" @@ -1229,9 +1227,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 +1258,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 +1364,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`." @@ -1504,6 +1510,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 +1534,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 "" @@ -2136,7 +2147,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 +2319,7 @@ msgid "\\A" msgstr "" msgid "\\b" -msgstr "" +msgstr "\\b" msgid "\\B" msgstr "" @@ -2335,34 +2346,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..3ff6187733 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-07-11 16:22+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" @@ -381,3 +381,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..2efe5de625 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-07-11 16:22+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 " diff --git a/library/resource.po b/library/resource.po index 836bdaf822..5b6902bd44 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-07-11 16:22+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,14 +81,14 @@ 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 " +"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 " @@ -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 "" @@ -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 "" @@ -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,7 +279,7 @@ 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:" @@ -286,7 +288,7 @@ msgid "" 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 "" diff --git a/library/rlcompleter.po b/library/rlcompleter.po index bfe14b54f5..f2477d3f54 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-07-11 16:22+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 " diff --git a/library/runpy.po b/library/runpy.po index e23cd750ab..0d013c8158 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-07-11 16:22+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 " diff --git a/library/sched.po b/library/sched.po index 0b5034a8a4..01196f9e0b 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-07-11 16:22+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..ab40a0e696 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-07-21 17:15+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..0affeb1ec4 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,7 +24,7 @@ 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 "" @@ -34,9 +34,6 @@ msgid "" "rfc:`4648`" msgstr "" -msgid ":mod:`cgi`: :ref:`CGI security considerations `" -msgstr "" - msgid "" ":mod:`hashlib`: :ref:`all constructors take a \"usedforsecurity\" keyword-" "only argument disabling known insecure and blocked algorithms `" msgstr "" -msgid ":mod:`xml`: :ref:`XML vulnerabilities `" +msgid ":mod:`xml`: :ref:`XML security `" msgstr "" msgid "" diff --git a/library/select.po b/library/select.po index c719bbab67..3c358b9ab0 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-07-11 16:22+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" @@ -62,9 +61,8 @@ 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 "" @@ -81,8 +79,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 "" @@ -123,20 +121,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 +158,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 "" @@ -198,13 +195,13 @@ 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." +"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 "" @@ -236,7 +233,7 @@ msgstr "" msgid "" "*eventmask* is an optional bitmask describing the type of events you want to " -"check for. The constants are the same that with :c:func:`!poll` object. The " +"check for. The constants are the same as with :c:func:`!poll` object. The " "default value is a combination of the constants :const:`POLLIN`, :const:" "`POLLPRI`, and :const:`POLLOUT`." msgstr "" @@ -249,7 +246,7 @@ 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 "" @@ -276,13 +273,13 @@ msgid "" "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 +291,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 +329,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 +337,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 +362,7 @@ msgstr "" msgid ":const:`EPOLLWRNORM`" msgstr ":const:`EPOLLWRNORM`" -msgid "Equivalent to :const:`EPOLLOUT`" +msgid "Equivalent to :const:`EPOLLOUT`." msgstr "" msgid ":const:`EPOLLWRBAND`" @@ -397,10 +394,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 +409,7 @@ msgstr "" msgid "Wait for events. timeout in seconds (float)" msgstr "" -msgid "Polling Objects" +msgid "Polling objects" msgstr "" msgid "" @@ -436,44 +433,45 @@ 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 "" @@ -506,7 +504,7 @@ msgid "" "`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 +530,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 +549,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 +603,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 +648,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 +666,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 +675,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 +720,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 +747,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 +768,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..4339a86bc9 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-07-11 16:22+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" @@ -95,7 +92,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" diff --git a/library/shelve.po b/library/shelve.po index 7635d25796..c246a544d3 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-07-11 16:22+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 " @@ -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,7 +182,7 @@ 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`, :" diff --git a/library/shutil.po b/library/shutil.po index 3a8718c4b2..4f673b550f 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-07-19 16:20+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 " @@ -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." @@ -361,6 +365,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``." @@ -411,10 +420,17 @@ 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 "" @@ -497,6 +513,12 @@ msgid "" "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 "" "On Windows, the current directory is prepended to the *path* if *mode* does " "not include ``os.X_OK``. When the *mode* does include ``os.X_OK``, the " @@ -578,7 +600,7 @@ 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:" +"file then shutil will silently fall back to less efficient :func:" "`copyfileobj` function internally." msgstr "" @@ -750,7 +772,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*, " @@ -814,8 +836,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*." @@ -944,7 +966,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:" diff --git a/library/signal.po b/library/signal.po index d4bd741804..8ab427c874 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-07-11 16:22+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 "" @@ -65,7 +64,7 @@ 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 "" @@ -107,6 +106,11 @@ 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 "" @@ -128,12 +132,12 @@ 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:" +":class:`enum.IntEnum` collection of the constants :const:`SIG_BLOCK`, :const:" "`SIG_UNBLOCK` and :const:`SIG_SETMASK`." msgstr "" @@ -214,9 +218,18 @@ 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." @@ -236,15 +249,21 @@ 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:" +"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 "" @@ -609,10 +628,9 @@ msgid "" 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." diff --git a/library/site.po b/library/site.po index de9a6546e9..08ee132a1b 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-07-11 16:22+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 " @@ -165,8 +163,8 @@ msgid "" "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 " +"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." @@ -182,7 +180,7 @@ msgid "" "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 " +"`~ImportError.name` attribute equals ``'usercustomize'``, it is silently " "ignored." msgstr "" @@ -199,7 +197,7 @@ 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:`~/." +"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:" @@ -274,8 +272,8 @@ msgid "" "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 " diff --git a/library/smtplib.po b/library/smtplib.po index 809ce2d7b5..1ce4de74dd 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-07-11 16:22+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 " @@ -107,14 +106,14 @@ 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." +"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." @@ -139,10 +138,10 @@ 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 '/'." +"`~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,8 +173,13 @@ 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 "" @@ -184,10 +188,12 @@ msgid "" "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." @@ -462,7 +468,7 @@ msgid "SSL/TLS support is not available to your Python interpreter." msgstr "" msgid "" -"The method now supports hostname check with :attr:`SSLContext." +"The method now supports hostname check with :attr:`ssl.SSLContext." "check_hostname` and *Server Name Indicator* (see :const:`~ssl.HAS_SNI`)." msgstr "" @@ -475,12 +481,14 @@ 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 +532,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`" @@ -613,6 +617,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 "" diff --git a/library/socket.po b/library/socket.po index c958581c76..6fe5868dff 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-07-01 18: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 " @@ -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 "" @@ -687,76 +683,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 `." @@ -858,7 +794,7 @@ 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 " +"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 +802,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 +821,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 "" @@ -1318,12 +1255,76 @@ msgid "" "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." msgstr "" msgid "Socket Objects" 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 "" +"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." @@ -1352,8 +1353,9 @@ msgid "" 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 "" @@ -1377,7 +1379,7 @@ msgstr "" msgid "" ":exc:`OSError` is now raised if an error occurs when the underlying :c:func:" -"`close` call is made." +"`!close` call is made." msgstr "" msgid "" @@ -1387,13 +1389,13 @@ 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 " @@ -1414,7 +1416,7 @@ 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,15 +1451,15 @@ 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 "" @@ -1485,12 +1487,6 @@ msgid "" "`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 `). The value can be an integer, " -"``None`` or a :term:`bytes-like object` representing a buffer. In the later " +"``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 call :c:func:`setsockopt` " -"C function with ``optval=NULL`` and ``optlen=optlen``." +"*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." @@ -1858,7 +1855,7 @@ msgid "" msgstr "" msgid "" -"Note that there are no methods :meth:`read` or :meth:`write`; use :meth:" +"Note that there are no methods :meth:`!read` or :meth:`!write`; use :meth:" "`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." msgstr "" @@ -1876,6 +1873,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 "" diff --git a/library/socketserver.po b/library/socketserver.po index 440bf345ab..b979097fef 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-07-11 16:22+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 " @@ -544,11 +543,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 "" diff --git a/library/sqlite3.po b/library/sqlite3.po index 7b0188ef77..df7ebe5c11 100644 --- a/library/sqlite3.po +++ b/library/sqlite3.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: -# Igor Zubrycki , 2021 -# Stefan Ocetkiewicz , 2023 -# Waldemar Stoczkowski, 2023 -# 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:13+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-07-13 18:00+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" @@ -31,7 +28,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 " @@ -107,6 +104,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 " @@ -329,7 +328,7 @@ msgid "" "` 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 " +"`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 "" @@ -708,7 +707,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 "" @@ -1010,6 +1009,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 "" @@ -1468,6 +1484,9 @@ 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 +1496,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." @@ -1629,6 +1651,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` " @@ -1653,6 +1678,9 @@ msgid "" "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:" @@ -2005,7 +2033,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 " @@ -2262,7 +2290,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 +2299,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" diff --git a/library/ssl.po b/library/ssl.po index e613c644d2..b7f6b2b1a7 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-07-13 18:00+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 " @@ -102,7 +99,7 @@ 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" @@ -380,7 +377,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 +387,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`)." @@ -962,7 +959,7 @@ msgid "" "`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,10 +984,10 @@ 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:" @@ -1048,7 +1045,7 @@ msgid "" msgstr "" msgid "" -":class:`SSLSocket` instances must to created with :meth:`~SSLContext." +":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 "" @@ -1088,8 +1085,8 @@ 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 "" @@ -1104,7 +1101,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`." @@ -1127,7 +1124,13 @@ msgid "Perform the SSL setup handshake." msgstr "" msgid "" -"The handshake method also performs :func:`match_hostname` when the :attr:" +"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 "" @@ -1139,7 +1142,7 @@ 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 " +"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 "" @@ -1365,7 +1368,7 @@ msgid "" "`~SSLSocket.do_handshake` has been called to reuse a session." msgstr "" -msgid "SSL Contexts" +msgid "SSL contexts" msgstr "" msgid "" @@ -1887,8 +1890,8 @@ 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`." +"`SSLSocket`. The attribute can be assigned to on instances of :class:" +"`SSLContext` in order to return a custom subclass of :class:`SSLSocket`." msgstr "" msgid "" @@ -1982,7 +1985,7 @@ 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:" +"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 "" @@ -2624,7 +2627,7 @@ msgid "" "well." msgstr "" -msgid "Memory BIO Support" +msgid "Memory BIO support" msgstr "" msgid "" @@ -2900,7 +2903,7 @@ msgstr "" msgid "" "Hostname matchings is now performed by OpenSSL. Python no longer uses :func:" -"`match_hostname`." +"`!match_hostname`." msgstr "" msgid "" @@ -2923,15 +2926,12 @@ 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 " +"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." @@ -3023,7 +3023,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 +3031,7 @@ msgid "" "Certificate Revocation List (CRL) Profile <5280>`" msgstr "" -msgid "D. Cooper" +msgid "David Cooper et al." msgstr "" msgid "" @@ -3039,13 +3039,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..f00aa24c4c 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-07-11 16:22+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 " diff --git a/library/statistics.po b/library/statistics.po index 195799f1ea..e58b620658 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-07-11 16:22+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 " diff --git a/library/stdtypes.po b/library/stdtypes.po index 7e5dbbaf5e..5b92b84339 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-07-01 18: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" @@ -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 "" @@ -394,7 +387,7 @@ msgid "" msgstr "" msgid "\\(6)" -msgstr "" +msgstr "\\(6)" msgid ":func:`complex`" msgstr ":func:`complex`" @@ -476,13 +469,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 +483,7 @@ msgid "" msgstr "" msgid ":func:`math.floor(\\ x) `" -msgstr "" +msgstr ":func:`math.floor(\\ x) `" msgid "the greatest :class:`~numbers.Integral` <= *x*" msgstr "" @@ -1121,7 +1114,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 +1149,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 +1188,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 " @@ -1284,10 +1263,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 "" @@ -1334,13 +1325,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" @@ -1385,9 +1396,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 +1412,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 +1428,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 +1442,67 @@ 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 removes 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 +1545,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 " @@ -1663,6 +1666,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 " @@ -1943,7 +1952,14 @@ msgid "" "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\"``." +"`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 +1971,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 +1991,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`." @@ -1988,7 +2026,15 @@ 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." +"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." @@ -2003,7 +2049,22 @@ 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,13 +2079,34 @@ 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 "" @@ -2046,7 +2128,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 "" @@ -2077,14 +2168,39 @@ 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()``." +"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 "" @@ -2095,21 +2211,50 @@ msgid "" "\"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 `_." +"pdf>`_. 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 +2262,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 +2317,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 "" +">>> '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." +"Return ``True`` if all characters in the string are printable, ``False`` if " +"it contains at least one non-printable character." msgstr "" msgid "" @@ -2177,17 +2354,41 @@ 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 "" +">>> ''.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 " @@ -2195,6 +2396,18 @@ 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." @@ -2204,7 +2417,17 @@ 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." +"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 +2436,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 "" @@ -2273,9 +2513,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 +2525,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 +2553,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 +2573,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 +2596,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 +2635,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,6 +2654,18 @@ 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 " @@ -2365,7 +2679,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 +2694,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 +2709,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, " @@ -2412,9 +2729,6 @@ msgid "" "``['']``." msgstr "" -msgid "For example::" -msgstr "Dla przykładu::" - msgid "" ">>> '1,2,3'.split(',')\n" "['1', '2', '3']\n" @@ -2444,6 +2758,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 +2861,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 +2909,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 +2947,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 +2956,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,6 +3029,9 @@ 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 " @@ -2802,25 +3174,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 +3471,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." @@ -3649,10 +4024,9 @@ 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, " +"*bytes* argument is a binary sequence specifying the set of byte values to " +"be removed. If omitted or ``None``, the *bytes* argument defaults to " +"removing ASCII whitespace. The *bytes* argument is not a prefix; rather, " "all combinations of its values are stripped::" msgstr "" @@ -3702,10 +4076,9 @@ 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, " +"*bytes* argument is a binary sequence specifying the set of byte values to " +"be removed. If omitted or ``None``, the *bytes* argument defaults to " +"removing ASCII whitespace. The *bytes* argument is not a suffix; rather, " "all combinations of its values are stripped::" msgstr "" @@ -3786,11 +4159,10 @@ 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 ASCII whitespace. The *bytes* argument is not a prefix " +"or suffix; rather, all combinations of its values are stripped::" msgstr "" msgid "" @@ -4135,6 +4507,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 +4537,7 @@ msgid "" msgstr "" msgid "\\(7)" -msgstr "" +msgstr "\\(7)" msgid "``b'%s'`` is deprecated, but will not be removed during the 3.x series." msgstr "" @@ -4832,9 +5207,10 @@ 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, " +"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')``." @@ -4914,16 +5290,21 @@ 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:" -"`remove`, and :meth:`discard` methods may be a set. To support searching " -"for an equivalent frozenset, a temporary one is created from *elem*." +"Note, the *elem* argument to the :meth:`~object.__contains__`, :meth:`~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`" @@ -4986,7 +5367,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 +5390,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 +5439,13 @@ 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 "" @@ -5047,8 +5463,8 @@ msgstr "" msgid "" "The example above shows part of the implementation of :class:`collections." -"Counter`. A different ``__missing__`` method is used by :class:`collections." -"defaultdict`." +"Counter`. A different :meth:`!__missing__` method is used by :class:" +"`collections.defaultdict`." msgstr "" msgid "Set ``d[key]`` to *value*." @@ -5137,8 +5553,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 +5597,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 "" @@ -5393,10 +5776,13 @@ 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 "" @@ -5498,7 +5884,9 @@ msgstr "" msgid "" "``GenericAlias`` objects are instances of the class :class:`types." "GenericAlias`, which can also be used to create ``GenericAlias`` objects " -"directly." +"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 +5956,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 +6041,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`" @@ -6067,8 +6470,8 @@ 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." +"`~list.append` on lists) and :ref:`class instance method `. Built-in methods are described with the types that support them." msgstr "" msgid "" @@ -6166,15 +6569,55 @@ 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 "" @@ -6339,7 +6782,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 "" @@ -6770,12 +7213,6 @@ msgstr "" msgid "slice" msgstr "" -msgid "count() (sequence method)" -msgstr "" - -msgid "index() (sequence method)" -msgstr "" - msgid "loop" msgstr "" @@ -6815,30 +7252,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..e808168698 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-07-11 16:22+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`" @@ -90,7 +89,7 @@ msgid "" "vertical tab." msgstr "" -msgid "Custom String Formatting" +msgid "Custom string formatting" msgstr "" msgid "" @@ -206,7 +205,7 @@ msgid "" "understands 's' (str), 'r' (repr) and 'a' (ascii) conversion types." msgstr "" -msgid "Format String Syntax" +msgid "Format string syntax" msgstr "" msgid "" @@ -329,7 +328,7 @@ msgstr "" msgid "See the :ref:`formatexamples` section for some examples." msgstr "" -msgid "Format Specification Mini-Language" +msgid "Format specification mini-language" msgstr "" msgid "" @@ -488,7 +487,7 @@ msgid "" msgstr "" msgid "``','``" -msgstr "" +msgstr "``','``" msgid "" "Inserts a comma every 3 digits for integer presentation type ``'d'`` and " @@ -497,7 +496,7 @@ msgid "" msgstr "" msgid "``'_'``" -msgstr "" +msgstr "``'_'``" msgid "" "Inserts an underscore every 3 digits for integer presentation type ``'d'`` " @@ -508,7 +507,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 +600,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'``." @@ -631,6 +635,11 @@ msgid "" "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'``" msgstr "``'E'``" @@ -707,7 +716,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 "``'%'``" @@ -908,8 +919,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 "" @@ -1021,8 +1032,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 "" @@ -1111,9 +1122,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 "" diff --git a/library/struct.po b/library/struct.po index 7805c654bb..45408ff705 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-07-15 17:01+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 " @@ -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 "" @@ -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 "" diff --git a/library/subprocess.po b/library/subprocess.po index 719dded1a6..1b1bfb4290 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-07-11 16:22+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 " @@ -688,6 +687,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." @@ -704,7 +709,7 @@ 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 "" @@ -795,7 +800,7 @@ msgid "" 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 " @@ -939,7 +944,9 @@ 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." +"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 +964,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." @@ -1047,6 +1061,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 "" @@ -1620,10 +1641,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 "" @@ -1672,6 +1692,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 "" @@ -1756,7 +1799,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..3c5eb22b8e 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-07-11 16:22+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 " diff --git a/library/sys.monitoring.po b/library/sys.monitoring.po index f07a26de55..b9dd44c68c 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-07-11 16:22+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 "" @@ -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:" @@ -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." @@ -400,6 +410,11 @@ msgid "" "``None``." msgstr "" +msgid "" +"Raises an :ref:`auditing event ` ``sys.monitoring." +"register_callback`` with argument ``func``." +msgstr "" + msgid "" "Functions can be unregistered by calling ``sys.monitoring." "register_callback(tool_id, event, None)``." @@ -408,11 +423,6 @@ msgstr "" msgid "Callback functions can be registered and unregistered at any time." msgstr "" -msgid "" -"Registering or unregistering a callback function will generate a :func:`sys." -"audit` event." -msgstr "" - msgid "Callback function arguments" msgstr "" diff --git a/library/sys.po b/library/sys.po index 0a76a7cf43..d9d3672a09 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-07-21 17:15+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" @@ -531,7 +527,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 " @@ -1046,19 +1042,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 "" @@ -1146,7 +1142,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 "" @@ -1481,7 +1480,7 @@ msgid "Emscripten" msgstr "" msgid "``'emscripten'``" -msgstr "" +msgstr "``'emscripten'``" msgid "iOS" msgstr "" @@ -1496,7 +1495,7 @@ msgid "``'linux'``" msgstr "``'linux'``" msgid "macOS" -msgstr "" +msgstr "macOS" msgid "``'darwin'``" msgstr "" @@ -1511,7 +1510,7 @@ msgid "Windows/Cygwin" msgstr "" msgid "``'cygwin'``" -msgstr "" +msgstr "``'cygwin'``" msgid "WASI" msgstr "" @@ -1743,9 +1742,9 @@ 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 "" @@ -1971,7 +1970,7 @@ msgid "" msgstr "" msgid "" -"The encoding and error handling are is initialized from :c:member:`PyConfig." +"The encoding and error handling are initialized from :c:member:`PyConfig." "stdio_encoding` and :c:member:`PyConfig.stdio_errors`." msgstr "" diff --git a/library/sysconfig.po b/library/sysconfig.po index ffc4b5137c..34b094693b 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-07-11 16:22+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 " @@ -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:" diff --git a/library/syslog.po b/library/syslog.po index 8cb24cf14e..627d1028c9 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-07-11 16:22+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/tarfile.po b/library/tarfile.po index b47d2c822c..a37bacc978 100644 --- a/library/tarfile.po +++ b/library/tarfile.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 , 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:14+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-07-11 16:22+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:`!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 +90,7 @@ msgstr "" msgid "action" msgstr "" -msgid "``'r' or 'r:*'``" +msgid "``'r'`` or ``'r:*'``" msgstr "" msgid "Open for reading with transparent compression (recommended)." @@ -123,7 +121,7 @@ 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:" @@ -154,7 +152,7 @@ msgid "" "exception if it already exists." msgstr "" -msgid "``'a' or 'a:'``" +msgid "``'a'`` or ``'a:'``" msgstr "" msgid "" @@ -162,7 +160,7 @@ msgid "" "exist." msgstr "" -msgid "``'w' or 'w:'``" +msgid "``'w'`` or ``'w:'``" msgstr "" msgid "Open for uncompressed writing." @@ -360,6 +358,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 "" @@ -1107,6 +1112,13 @@ 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." @@ -1150,6 +1162,9 @@ msgid "" "``None``, so that extraction methods skip setting it." msgstr "" +msgid "Link targets are now normalized." +msgstr "" + msgid "Filter errors" msgstr "" @@ -1180,6 +1195,9 @@ msgid "" "failed extraction." msgstr "" +msgid "Disallow symbolic links if you do not need the functionality." +msgstr "" + msgid "" "When working with untrusted data, use external (e.g. OS-level) limits on " "disk, memory and CPU usage." @@ -1385,6 +1403,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 +1435,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 +1480,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..0a6c58d121 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-07-11 16:22+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:`!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 " @@ -280,8 +279,12 @@ 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 "" diff --git a/library/termios.po b/library/termios.po index bae249eeaa..04c2d72770 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-07-11 16:22+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/text.po b/library/text.po index 560bd21d1e..96749bf88f 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-07-11 16:22+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..44b0fa8663 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-07-11 16:22+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:`!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 :" diff --git a/library/threading.po b/library/threading.po index acb3599b58..7efd06589e 100644 --- a/library/threading.po +++ b/library/threading.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:15+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-07-11 16:22+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,13 +27,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 "" @@ -71,12 +129,26 @@ msgid "" "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 "" msgid "This module defines the following functions:" @@ -93,7 +165,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 "" @@ -186,13 +258,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 +277,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 "" @@ -272,32 +344,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 "" +">>> 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 "" +"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 "" -"For more details and extensive examples, see the documentation string of " -"the :mod:`!_threading_local` module: :source:`Lib/_threading_local.py`." +">>> 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" +msgid "Thread objects" msgstr "" msgid "" @@ -375,8 +597,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 "" @@ -552,7 +774,7 @@ msgid "" "a property instead." msgstr "" -msgid "Lock Objects" +msgid "Lock objects" msgstr "" msgid "" @@ -654,7 +876,7 @@ msgstr "" msgid "Return ``True`` if the lock is acquired." msgstr "" -msgid "RLock Objects" +msgid "RLock objects" msgstr "" msgid "" @@ -769,7 +991,7 @@ msgid "" "acquired." msgstr "" -msgid "Condition Objects" +msgid "Condition objects" msgstr "" msgid "" @@ -980,7 +1202,7 @@ msgstr "" msgid "The method ``notifyAll`` is a deprecated alias for this method." msgstr "" -msgid "Semaphore Objects" +msgid "Semaphore objects" msgstr "" msgid "" @@ -1064,7 +1286,7 @@ msgid "" "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 +1322,7 @@ msgid "" "undetected." msgstr "" -msgid "Event Objects" +msgid "Event objects" msgstr "" msgid "" @@ -1153,7 +1375,7 @@ msgid "" "fractions thereof." msgstr "" -msgid "Timer Objects" +msgid "Timer objects" msgstr "" msgid "" @@ -1194,7 +1416,7 @@ msgid "" "only work if the timer is still in its waiting stage." msgstr "" -msgid "Barrier Objects" +msgid "Barrier objects" msgstr "" msgid "" diff --git a/library/time.po b/library/time.po index ac8d3befc9..8068b81637 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-07-11 16:22+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" @@ -267,8 +264,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 "" @@ -350,10 +347,12 @@ msgid "" "`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 +361,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 "" @@ -377,7 +376,7 @@ msgid "" "`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`." @@ -425,10 +424,10 @@ 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." +"continues execution. On Windows 10 and newer the implementation uses a " +"`high-resolution timer `_ which provides resolution of " +"100 nanoseconds. If *secs* is zero, ``Sleep(0)`` is used." msgstr "" msgid "Unix implementation" @@ -720,7 +719,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 "" @@ -784,7 +783,7 @@ msgid "" msgstr "" msgid "Index" -msgstr "" +msgstr "Indeks" msgid "Attribute" msgstr "atrybut" @@ -835,7 +834,7 @@ msgid "range [0, 6]; Monday is 0" msgstr "" msgid "7" -msgstr "" +msgstr "7" msgid "range [1, 366]" msgstr "" @@ -898,7 +897,7 @@ msgid "" "attributes." msgstr "" -msgid "On Windows, call ``GetSystemTimeAsFileTime()``." +msgid "On Windows, call ``GetSystemTimePreciseAsFileTime()``." msgstr "" msgid "Call ``clock_gettime(CLOCK_REALTIME)`` if available." @@ -912,6 +911,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_." @@ -1101,7 +1105,7 @@ msgstr "" msgid "" "`International Atomic Time `_" +"division/how-utcnist-related-coordinated-universal-time-utc-international>`_" msgstr "" msgid "" @@ -1134,8 +1138,8 @@ msgid "" 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" @@ -1205,7 +1209,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..5903ccf0de 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-07-11 16:22+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 " diff --git a/library/tk.po b/library/tk.po index 17bad3790c..5e792bdd7f 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-07-11 16:22+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,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 "Graphical User Interfaces with Tk" +msgid "Graphical user interfaces with Tk" msgstr "" msgid "" diff --git a/library/tkinter.dnd.po b/library/tkinter.dnd.po index c3777d4601..21c6b483b2 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-07-15 17:01+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..e65e74f5ca 100644 --- a/library/tkinter.po +++ b/library/tkinter.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 -# 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 01:15+0000\n" -"Last-Translator: Stan Ulbrych, 2025\n" +"POT-Creation-Date: 2026-07-15 17:01+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:`!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 +46,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 +63,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 +88,7 @@ msgstr "" msgid "Tcl/Tk Resources:" msgstr "" -msgid "`Tk commands `_" +msgid "`Tk commands `_" msgstr "" msgid "" @@ -184,20 +184,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 +211,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 "" @@ -398,8 +292,8 @@ msgid "" "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 " @@ -421,7 +315,7 @@ msgstr ":mod:`turtle`" msgid "Turtle graphics in a Tk window." msgstr "" -msgid "Tkinter Life Preserver" +msgid "Tkinter life preserver" msgstr "" msgid "" @@ -439,7 +333,7 @@ msgid "" "reference manual." msgstr "" -msgid "A Hello World Program" +msgid "A Hello World program" msgstr "" msgid "" @@ -474,13 +368,13 @@ 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." +"`~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 +382,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:" @@ -540,7 +434,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 "" @@ -603,8 +497,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 +526,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 +558,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 +573,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,25 +595,26 @@ 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 "" @@ -757,14 +652,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,10 +672,12 @@ 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 "" @@ -804,10 +701,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 +734,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." @@ -859,22 +765,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 +843,126 @@ 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 +970,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 +1056,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 +1089,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 +1123,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 +1143,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 +1161,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 +1179,7 @@ msgstr "" msgid "Must be one of: ``\"none\"``, ``\"char\"``, or ``\"word\"``." msgstr "" -msgid "Bindings and Events" +msgid "Bindings and events" msgstr "" msgid "" @@ -1284,9 +1198,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 +1338,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 +1390,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 +1456,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 "" @@ -1518,10 +1505,10 @@ 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 +1516,5070 @@ msgid "" "such as BMP, JPEG, TIFF, and WebP, among others." msgstr "" -msgid "File Handlers" +msgid "Reference" 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::" +"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 "" -"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 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 "This feature is not available on Windows." +msgid "Base and mixin classes" 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)``." +"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 "" -"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::" +"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 "callback(file, mask)" +msgid "" +"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 "Unregisters a file handler." +msgid ":meth:`config` is an alias of :meth:`!configure`." msgstr "" -msgid "Constants used in the *mask* arguments." +msgid "Return a list of the names of all configuration options of this widget." msgstr "" -msgid "packing (widgets)" +msgid "" +"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 "window manager (widgets)" +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 "" +"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 "Return the value of the Tcl global variable named *name*." +msgstr "" + +msgid "Set the Tcl global variable named *name* to *value*." +msgstr "" + +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.ttk.po b/library/tkinter.ttk.po index 3bf0f03e51..6b157d64cd 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-07-15 17:01+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" @@ -72,31 +79,28 @@ 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." +"`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