Codestin Search App

633 lines (539 loc) · 23.7 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# python-doc bot, 2025
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-02-03 14:40+0000\n"
"PO-Revision-Date: 2025-09-16 00:02+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: 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 "Using Python on macOS"
"This document aims to give an overview of macOS-specific behavior you should "
"know about to get started with Python on Mac computers. Python on a Mac "
"running macOS is very similar to Python on other Unix-derived platforms, but "
"there are some differences in installation and some features."
"There are various ways to obtain and install Python for macOS. Pre-built "
"versions of the most recent versions of Python are available from a number "
"of distributors. Much of this document describes use of the Pythons provided "
"by the CPython release team for download from the `python.org website "
"<https://www.python.org/downloads/>`_. See :ref:`alternative_bundles` for "
"some other options."
msgid "Using Python for macOS from ``python.org``"
msgid "Installation steps"
"For `current Python versions <https://www.python.org/downloads/>`_ (other "
"than those in ``security`` status), the release team produces a **Python for "
"macOS** installer package for each new release. A list of available "
"installers is available `here <https://www.python.org/downloads/macos/>`_. "
"We recommend using the most recent supported Python version where possible. "
"Current installers provide a `universal2 binary <https://en.wikipedia.org/"
"wiki/Universal_binary>`_ build of Python which runs natively on all Macs "
"(Apple Silicon and Intel) that are supported by a wide range of macOS "
"versions, currently typically from at least **macOS 10.15 Catalina** on."
"The downloaded file is a standard macOS installer package file (``.pkg``). "
"File integrity information (checksum, size, sigstore signature, etc) for "
"each file is included on the release download page. Installer packages and "
"their contents are signed and notarized with ``Python Software Foundation`` "
"Apple Developer ID certificates to meet `macOS Gatekeeper requirements "
"<https://support.apple.com/en-us/102445>`_."
"For a default installation, double-click on the downloaded installer package "
"file. This should launch the standard macOS Installer app and display the "
"first of several installer windows steps."
"Clicking on the **Continue** button brings up the **Read Me** for this "
"installer. Besides other important information, the **Read Me** documents "
"which Python version is going to be installed and on what versions of macOS "
"it is supported. You may need to scroll through to read the whole file. By "
"default, this **Read Me** will also be installed in |"
"applications_python_version_literal| and available to read anytime."
"Clicking on **Continue** proceeds to display the license for Python and for "
"other included software. You will then need to **Agree** to the license "
"terms before proceeding to the next step. This license file will also be "
"installed and available to be read later."
"After the license terms are accepted, the next step is the **Installation "
"Type** display. For most uses, the standard set of installation operations "
"is appropriate."
"By pressing the **Customize** button, you can choose to omit or select "
"certain package components of the installer. Click on each package name to "
"see a description of what it installs. To also install support for the "
"optional free-threaded feature, see :ref:`install-freethreaded-macos`."
"In either case, clicking **Install** will begin the install process by "
"asking permission to install new software. A macOS user name with "
"``Administrator`` privilege is needed as the installed Python will be "
"available to all users of the Mac."
msgid "When the installation is complete, the **Summary** window will appear."
"Double-click on the :command:`Install Certificates.command` icon or file in "
"the |applications_python_version_literal| window to complete the "
"installation."
"This will open a temporary :program:`Terminal` shell window that will use "
"the new Python to download and install SSL root certificates for its use."
"If ``Successfully installed certifi`` and ``update complete`` appears in the "
"terminal window, the installation is complete. Close this terminal window "
"and the installer window."
msgid "A default install will include:"
"A |python_version_literal| folder in your :file:`Applications` folder. In "
"here you find :program:`IDLE`, the development environment that is a "
"standard part of official Python distributions; and :program:`Python "
"Launcher`, which handles double-clicking Python scripts from the macOS "
"`Finder <https://support.apple.com/en-us/HT201732>`_."
"A framework :file:`/Library/Frameworks/Python.framework`, which includes the "
"Python executable and libraries. The installer adds this location to your "
"shell path. To uninstall Python, you can remove these three things. Symlinks "
"to the Python executable are placed in :file:`/usr/local/bin/`."
"Recent versions of macOS include a :command:`python3` command in :file:`/usr/"
"bin/python3` that links to a usually older and incomplete version of Python "
"provided by and for use by the Apple development tools, :program:`Xcode` or "
"the :program:`Command Line Tools for Xcode`. You should never modify or "
"attempt to delete this installation, as it is Apple-controlled and is used "
"by Apple-provided or third-party software.  If you choose to install a newer "
"Python version from ``python.org``, you will have two different but "
"functional Python installations on your computer that can co-exist. The "
"default installer options should ensure that its :command:`python3` will be "
"used instead of the system :command:`python3`."
msgid "How to run a Python script"
"There are two ways to invoke the Python interpreter. If you are familiar "
"with using a Unix shell in a terminal window, you can invoke |"
"python_x_dot_y_literal| or ``python3`` optionally followed by one or more "
"command line options (described in :ref:`using-on-general`). The Python "
"tutorial also has a useful section on :ref:`using Python interactively from "
"a shell <tut-interac>`."
"You can also invoke the interpreter through an integrated development "
"environment. :ref:`idle` is a basic editor and interpreter environment which "
"is included with the standard distribution of Python. :program:`IDLE` "
"includes a Help menu that allows you to access Python documentation. If you "
"are completely new to Python, you can read the tutorial introduction in that "
"document."
"There are many other editors and IDEs available, see :ref:`editors` for more "
"information."
"To run a Python script file from the terminal window, you can invoke the "
"interpreter with the name of the script file:"
msgid "|python_x_dot_y_literal| ``myscript.py``"
msgstr "|python_x_dot_y_literal| ``myscript.py``"
msgid "To run your script from the Finder, you can either:"
msgid "Drag it to :program:`Python Launcher`."
"Select :program:`Python Launcher` as the default application to open your "
"script (or any ``.py`` script) through the Finder Info window and double-"
"click it. :program:`Python Launcher` has various preferences to control how "
"your script is launched. Option-dragging allows you to change these for one "
"invocation, or use its ``Preferences`` menu to change things globally."
"Be aware that running the script directly from the macOS Finder might "
"produce different results than when running from a terminal window as the "
"script will not be run in the usual shell environment including any setting "
"of environment variables in shell profiles. And, as with any other script or "
"program, be certain of what you are about to run."
msgid "Alternative Distributions"
"Besides the standard ``python.org`` for macOS installer, there are third-"
"party distributions for macOS that may include additional functionality. "
"Some popular distributions and their key features:"
msgid "`ActivePython <https://www.activestate.com/products/python/>`_"
msgstr "`ActivePython <https://www.activestate.com/products/python/>`_"
msgid "Installer with multi-platform compatibility, documentation"
msgid "`Anaconda <https://www.anaconda.com/download/>`_"
msgstr "`Anaconda <https://www.anaconda.com/download/>`_"
"Popular scientific modules (such as numpy, scipy, and pandas) and the "
"``conda`` package manager."
msgid "`Homebrew <https://brew.sh>`_"
msgstr "`Homebrew <https://brew.sh>`_"
"Package manager for macOS including multiple versions of Python and many "
"third-party Python-based packages (including numpy, scipy, and pandas)."
msgid "`MacPorts <https://www.macports.org>`_"
msgstr "`MacPorts <https://www.macports.org>`_"
"Another package manager for macOS including multiple versions of Python and "
"many third-party Python-based packages. May include pre-built versions of "
"Python and many packages for older versions of macOS."
"Note that distributions might not include the latest versions of Python or "
"other libraries, and are not maintained or supported by the core Python team."
msgid "Installing Additional Python Packages"
msgid "Refer to the `Python Packaging User Guide`_ for more information."
msgid "GUI Programming"
"There are several options for building GUI applications on the Mac with "
"The standard Python GUI toolkit is :mod:`tkinter`, based on the cross-"
"platform Tk toolkit (https://www.tcl.tk). A macOS-native version of Tk is "
"included with the installer."
"*PyObjC* is a Python binding to Apple's Objective-C/Cocoa framework. "
"Information on PyObjC is available from :pypi:`pyobjc`."
msgid "A number of alternative macOS GUI toolkits are available including:"
"`PySide <https://www.qt.io/qt-for-python>`_: Official Python bindings to the "
"`Qt GUI toolkit <https://wiki.qt.io/Qt_for_Python>`_."
"`PyQt <https://riverbankcomputing.com/software/pyqt/>`_: Alternative Python "
"bindings to Qt."
"`Kivy <https://kivy.org>`_: A cross-platform GUI toolkit that supports "
"desktop and mobile platforms."
"`Toga <https://toga.readthedocs.io>`_: Part of the `BeeWare Project <https://"
"beeware.org>`_; supports desktop, mobile, web and console apps."
"`wxPython <https://wxpython.org>`_: A cross-platform toolkit that supports "
"desktop operating systems."
msgid "Advanced Topics"
msgid "Installing Free-threaded Binaries"
"The ``python.org`` :ref:`Python for macOS <getting-and-installing-"
"macpython>` installer package can optionally install an additional build of "
"Python |version| that supports :pep:`703`, the free-threading feature "
"(running with the :term:`global interpreter lock` disabled). Check the "
"release page on ``python.org`` for possible updated information."
"The free-threaded mode is working and continues to be improved, but there is "
"some additional overhead in single-threaded workloads compared to the "
"regular build. Additionally, third-party packages, in particular ones with "
"an :term:`extension module`, may not be ready for use in a free-threaded "
"build, and will re-enable the :term:`GIL`. Therefore, the support for free-"
"threading is not installed by default. It is packaged as a separate install "
"option, available by clicking the **Customize** button on the **Installation "
"Type** step of the installer as described above."
"If the box next to the **Free-threaded Python** package name is checked, a "
"separate :file:`PythonT.framework` will also be installed alongside the "
"normal :file:`Python.framework` in :file:`/Library/Frameworks`. This "
"configuration allows a free-threaded Python |version| build to co-exist on "
"your system with a traditional (GIL only) Python |version| build with "
"minimal risk while installing or testing. This installation layout may "
"change in future releases."
msgid "Known cautions and limitations:"
"The **UNIX command-line tools** package, which is selected by default, will "
"install links in :file:`/usr/local/bin` for |python_x_dot_y_t_literal|, the "
"free-threaded interpreter, and |python_x_dot_y_t_literal_config|, a "
"configuration utility which may be useful for package builders. Since :file:"
"`/usr/local/bin` is typically included in your shell ``PATH``, in most cases "
"no changes to your ``PATH`` environment variables should be needed to use |"
"python_x_dot_y_t_literal|."
"For this release, the **Shell profile updater** package and the :file:"
"`Update Shell Profile.command` in |applications_python_version_literal| do "
"not support the free-threaded package."
"The free-threaded build and the traditional build have separate search paths "
"and separate :file:`site-packages` directories so, by default, if you need a "
"package available in both builds, it may need to be installed in both. The "
"free-threaded package will install a separate instance of :program:`pip` for "
"use with |python_x_dot_y_t_literal|."
msgid "To install a package using :command:`pip` without a :command:`venv`:"
msgid "python\\ |version|\\ t -m pip install <package_name>"
msgstr "python\\ |version|\\ t -m pip install <package_name>"
"When working with multiple Python environments, it is usually safest and "
"easiest to :ref:`create and use virtual environments <tut-venv>`. This can "
"avoid possible command name conflicts and confusion about which Python is in "
msgid "python\\ |version|\\ t -m venv <venv_name>"
msgstr "python\\ |version|\\ t -m venv <venv_name>"
msgid "then :command:`activate`."
msgid "To run a free-threaded version of IDLE:"
msgid "python\\ |version|\\ t -m idlelib"
msgstr "python\\ |version|\\ t -m idlelib"
"The interpreters in both builds respond to the same :ref:`PYTHON environment "
"variables <using-on-envvars>` which may have unexpected results, for "
"example, if you have ``PYTHONPATH`` set in a shell profile. If necessary, "
"there are :ref:`command line options <using-on-interface-options>` like ``-"
"E`` to ignore these environment variables."
"The free-threaded build links to the third-party shared libraries, such as "
"``OpenSSL`` and ``Tk``, installed in the traditional framework. This means "
"that both builds also share one set of trust certificates as installed by "
"the :command:`Install Certificates.command` script, thus it only needs to be "
"run once."
"If you cannot depend on the link in ``/usr/local/bin`` pointing to the "
"``python.org`` free-threaded |python_x_dot_y_t_literal| (for example, if you "
"want to install your own version there or some other distribution does), you "
"can explicitly set your shell ``PATH`` environment variable to include the "
"``PythonT`` framework ``bin`` directory:"
"export PATH=\"/Library/Frameworks/PythonT.framework/Versions/\\ |version|\\ /"
"bin\":\"$PATH\""
"export PATH=\"/Library/Frameworks/PythonT.framework/Versions/\\ |version|\\ /"
"bin\":\"$PATH\""
"The traditional framework installation by default does something similar, "
"except for :file:`Python.framework`. Be aware that having both framework "
"``bin`` directories in ``PATH`` can lead to confusion if there are duplicate "
"names like |python_x_dot_y_literal| in both; which one is actually used "
"depends on the order they appear in ``PATH``. The ``which python3.x`` or "
"``which python3.xt`` commands can show which path is being used. Using "
"virtual environments can help avoid such ambiguities. Another option might "
"be to create a shell :command:`alias` to the desired interpreter, like:"
"alias py\\ |version|\\ =\"/Library/Frameworks/Python.framework/Versions/\\ |"
"version|\\ /bin/python\\ |version|\\ \"\n"
"alias py\\ |version|\\ t=\"/Library/Frameworks/PythonT.framework/Versions/\\ "
"|version|\\ /bin/python\\ |version|\\ t\""
"alias py\\ |version|\\ =\"/Library/Frameworks/Python.framework/Versions/\\ |"
"version|\\ /bin/python\\ |version|\\ \"\n"
"alias py\\ |version|\\ t=\"/Library/Frameworks/PythonT.framework/Versions/\\ "
"|version|\\ /bin/python\\ |version|\\ t\""
msgid "Installing using the command line"
"If you want to use automation to install the ``python.org`` installer "
"package (rather than by using the familiar macOS :program:`Installer` GUI "
"app), the macOS command line :command:`installer` utility lets you select "
"non-default options, too. If you are not familiar with :command:`installer`, "
"it can be somewhat cryptic (see :command:`man installer` for more "
"information). As an example, the following shell snippet shows one way to do "
"it, using the |x_dot_y_b2_literal| release and selecting the free-threaded "
"interpreter option:"
"RELEASE=\"python-\\ |version|\\ 0b2-macos11.pkg\"\n"
"# download installer pkg\n"
"curl -O \\https://www.python.org/ftp/python/\\ |version|\\ .0/${RELEASE}\n"
"# create installer choicechanges to customize the install:\n"
"#    enable the PythonTFramework-\\ |version|\\  package\n"
"#    while accepting the other defaults (install all other packages)\n"
"cat > ./choicechanges.plist <<EOF\n"
"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
"<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"\\http://www.apple."
"com/DTDs/PropertyList-1.0.dtd\">\n"
"<plist version=\"1.0\">\n"
"<array>\n"
"        <dict>\n"
"                <key>attributeSetting</key>\n"
"                <integer>1</integer>\n"
"                <key>choiceAttribute</key>\n"
"                <string>selected</string>\n"
"                <key>choiceIdentifier</key>\n"
"                <string>org.python.Python.PythonTFramework-\\ |version|\\ </"
"string>\n"
"        </dict>\n"
"</array>\n"
"</plist>\n"
"sudo installer -pkg ./${RELEASE} -applyChoiceChangesXML ./choicechanges."
"plist -target /"
"RELEASE=\"python-\\ |version|\\ 0b2-macos11.pkg\"\n"
"# download installer pkg\n"
"curl -O \\https://www.python.org/ftp/python/\\ |version|\\ .0/${RELEASE}\n"
"# create installer choicechanges to customize the install:\n"
"#    enable the PythonTFramework-\\ |version|\\  package\n"
"#    while accepting the other defaults (install all other packages)\n"
"cat > ./choicechanges.plist <<EOF\n"
"<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n"
"<!DOCTYPE plist PUBLIC \"-//Apple//DTD PLIST 1.0//EN\" \"\\http://www.apple."
"com/DTDs/PropertyList-1.0.dtd\">\n"
"<plist version=\"1.0\">\n"
"<array>\n"
"        <dict>\n"
"                <key>attributeSetting</key>\n"
"                <integer>1</integer>\n"
"                <key>choiceAttribute</key>\n"
"                <string>selected</string>\n"
"                <key>choiceIdentifier</key>\n"
"                <string>org.python.Python.PythonTFramework-\\ |version|\\ </"
"string>\n"
"        </dict>\n"
"</array>\n"
"</plist>\n"
"sudo installer -pkg ./${RELEASE} -applyChoiceChangesXML ./choicechanges."
"plist -target /"
"You can then test that both installer builds are now available with "
"something like:"
"$ # test that the free-threaded interpreter was installed if the Unix "
"Command Tools package was enabled\n"
"$ /usr/local/bin/python\\ |version|\\ t -VV\n"
"Python \\ |version|\\ .0b2 free-threading build (v\\ |version|"
"\\ .0b2:3a83b172af, Jun  5 2024, 12:57:31) [Clang 15.0.0 "
"(clang-1500.3.9.4)]\n"
"$ #    and the traditional interpreter\n"
"$ /usr/local/bin/python\\ |version|\\  -VV\n"
"Python \\ |version|\\ .0b2 (v\\ |version|\\ .0b2:3a83b172af, Jun  5 2024, "
"12:50:24) [Clang 15.0.0 (clang-1500.3.9.4)]\n"
"$ # test that they are also available without the prefix if /usr/local/bin "
"is on $PATH\n"
"$ python\\ |version|\\ t -VV\n"
"Python \\ |version|\\ .0b2 free-threading build (v\\ |version|"
"\\ .0b2:3a83b172af, Jun  5 2024, 12:57:31) [Clang 15.0.0 "
"(clang-1500.3.9.4)]\n"
"$ python\\ |version|\\  -VV\n"
"Python \\ |version|\\ .0b2 (v\\ |version|\\ .0b2:3a83b172af, Jun  5 2024, "
"12:50:24) [Clang 15.0.0 (clang-1500.3.9.4)]"
"Current ``python.org`` installers only install to fixed locations like :file:"
"`/Library/Frameworks/`, :file:`/Applications`, and :file:`/usr/local/bin`. "
"You cannot use the :command:`installer` ``-domain`` option to install to "
"other locations."
msgid "Distributing Python Applications"
"A range of tools exist for converting your Python code into a standalone "
"distributable application:"
":pypi:`py2app`: Supports creating macOS ``.app`` bundles from a Python "
"`Briefcase <https://briefcase.readthedocs.io>`_: Part of the `BeeWare "
"Project <https://beeware.org>`_; a cross-platform packaging tool that "
"supports creation of ``.app`` bundles on macOS, as well as managing signing "
"and notarization."
"`PyInstaller <https://pyinstaller.org/>`_: A cross-platform packaging tool "
"that creates a single file or folder as a distributable artifact."
msgid "App Store Compliance"
"Apps submitted for distribution through the macOS App Store must pass "
"Apple's app review process. This process includes a set of automated "
"validation rules that inspect the submitted application bundle for "
"problematic code."
"The Python standard library contains some code that is known to violate "
"these automated rules. While these violations appear to be false positives, "
"Apple's review rules cannot be challenged. Therefore, it is necessary to "
"modify the Python standard library for an app to pass App Store review."
"The Python source tree contains :source:`a patch file <Mac/Resources/app-"
"store-compliance.patch>` that will remove all code that is known to cause "
"issues with the App Store review process. This patch is applied "
"automatically when CPython is configured with the :option:`--with-app-store-"
"compliance` option."
"This patch is not normally required to use CPython on a Mac; nor is it "
"required if you are distributing an app *outside* the macOS App Store. It is "
"*only* required if you are using the macOS App Store as a distribution "
msgid "Other Resources"
"The `python.org Help page <https://www.python.org/about/help/>`_ has links "
"to many useful resources. The `Pythonmac-SIG mailing list <https://www."
"python.org/community/sigs/current/pythonmac-sig/>`_ is another support "
"resource specifically for Python users and developers on the Mac."
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

mac.po

Latest commit

History

mac.po

File metadata and controls
