python-docs-pl/library/ftplib.po at 3.11 · python/python-docs-pl

492 lines (395 loc) · 15.9 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2026, 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.11\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-04-11 16:45+0000\n"
"PO-Revision-Date: 2025-09-22 16:50+0000\n"
"Last-Translator: python-doc bot, 2025\n"
"Language-Team: Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: pl\n"
"Plural-Forms: nplurals=4; plural=(n==1 ? 0 : (n%10>=2 && n%10<=4) && "
"(n%100<12 || n%100>14) ? 1 : n!=1 && (n%10>=0 && n%10<=1) || (n%10>=5 && "
"n%10<=9) || (n%100>=12 && n%100<=14) ? 2 : 3);\n"
msgid ":mod:`ftplib` --- FTP protocol client"
msgid "**Source code:** :source:`Lib/ftplib.py`"
msgstr "**Kod źródłowy:** :source:`Lib/ftplib.py`"
"This module defines the class :class:`FTP` and a few related items. The :"
"class:`FTP` class implements the client side of the FTP protocol.  You can "
"use this to write Python programs that perform a variety of automated FTP "
"jobs, such as mirroring other FTP servers.  It is also used by the module :"
"mod:`urllib.request` to handle URLs that use FTP.  For more information on "
"FTP (File Transfer Protocol), see internet :rfc:`959`."
msgid "The default encoding is UTF-8, following :rfc:`2640`."
msgid ":ref:`Availability <availability>`: not Emscripten, not WASI."
"This module does not work or is not available on WebAssembly platforms "
"``wasm32-emscripten`` and ``wasm32-wasi``. See :ref:`wasm-availability` for "
"more information."
msgid "Here's a sample session using the :mod:`ftplib` module::"
msgid "Reference"
msgid "FTP objects"
msgid "Return a new instance of the :class:`FTP` class."
msgid "Parameters"
msgstr "parametry"
"The hostname to connect to. If given, :code:`connect(host)` is implicitly "
"called by the constructor."
"|param_doc_user| If given, :code:`login(host, passwd, acct)` is implicitly "
"called by the constructor."
msgid "|param_doc_passwd|"
msgid "|param_doc_acct|"
"A timeout in seconds for blocking operations like :meth:`connect` (default: "
"the global default timeout setting)."
msgid "|param_doc_source_address|"
msgstr "|param_doc_source_address|"
msgid "|param_doc_encoding|"
msgid "The :class:`FTP` class supports the :keyword:`with` statement, e.g.:"
msgid "Support for the :keyword:`with` statement was added."
msgid "*source_address* parameter was added."
"If the *timeout* parameter is set to be zero, it will raise a :class:"
"`ValueError` to prevent the creation of a non-blocking socket. The "
"*encoding* parameter was added, and the default was changed from Latin-1 to "
"UTF-8 to follow :rfc:`2640`."
"Several :class:`!FTP` methods are available in two flavors: one for handling "
"text files and another for binary files. The methods are named for the "
"command which is used followed by ``lines`` for the text version or "
"``binary`` for the binary version."
msgid ":class:`FTP` instances have the following methods:"
"Set the instance's debugging level as an :class:`int`. This controls the "
"amount of debugging output printed. The debug levels are:"
msgid "``0`` (default): No debug output."
"``1``: Produce a moderate amount of debug output, generally a single line "
"per request."
"``2`` or higher: Produce the maximum amount of debugging output, logging "
"each line sent and received on the control connection."
"Connect to the given host and port. This function should be called only once "
"for each instance; it should not be called if a *host* argument was given "
"when the :class:`FTP` instance was created. All other :class:`!FTP` methods "
"can only be called after a connection has successfully been made."
msgid "The host to connect to."
"The TCP port to connect to (default: ``21``, as specified by the FTP "
"protocol specification). It is rarely needed to specify a different port "
"A timeout in seconds for the connection attempt (default: the global default "
"timeout setting)."
"Raises an :ref:`auditing event <auditing>` ``ftplib.connect`` with arguments "
"``self``, ``host``, ``port``."
"Return the welcome message sent by the server in reply to the initial "
"connection.  (This message sometimes contains disclaimers or help "
"information that may be relevant to the user.)"
"Log on to the connected FTP server. This function should be called only once "
"for each instance, after a connection has been established; it should not be "
"called if the *host* and *user* arguments were given when the :class:`FTP` "
"instance was created. Most FTP commands are only allowed after the client "
"has logged in."
msgid "|param_doc_user|"
"Abort a file transfer that is in progress.  Using this does not always work, "
"but it's worth a try."
"Send a simple command string to the server and return the response string."
"Raises an :ref:`auditing event <auditing>` ``ftplib.sendcmd`` with arguments "
"``self``, ``cmd``."
"Send a simple command string to the server and handle the response.  Return "
"the response string if the response code corresponds to success (codes in "
"the range 200--299).  Raise :exc:`error_reply` otherwise."
msgid "Retrieve a file in binary transfer mode."
msgid "An appropriate ``STOR`` command: :samp:`\"STOR {filename}\"`."
"A single parameter callable that is called for each block of data received, "
"with its single argument being the data as :class:`bytes`."
"The maximum chunk size to read on the low-level :class:`~socket.socket` "
"object created to do the actual transfer. This also corresponds to the "
"largest size of data that will be passed to *callback*. Defaults to ``8192``."
"A ``REST`` command to be sent to the server. See the documentation for the "
"*rest* parameter of the :meth:`transfercmd` method."
"Retrieve a file or directory listing in the encoding specified by the "
"*encoding* parameter at initialization. *cmd* should be an appropriate "
"``RETR`` command (see :meth:`retrbinary`) or a command such as ``LIST`` or "
"``NLST`` (usually just the string ``'LIST'``). ``LIST`` retrieves a list of "
"files and information about those files. ``NLST`` retrieves a list of file "
"names. The *callback* function is called for each line with a string "
"argument containing the line with the trailing CRLF stripped.  The default "
"*callback* prints the line to :data:`sys.stdout`."
"Enable \"passive\" mode if *val* is true, otherwise disable passive mode. "
"Passive mode is on by default."
msgid "Store a file in binary transfer mode."
"A file object (opened in binary mode) which is read until EOF, using its :"
"meth:`~io.RawIOBase.read` method in blocks of size *blocksize* to provide "
"the data to be stored."
msgid "The read block size. Defaults to ``8192``."
"A single parameter callable that is called for each block of data sent, with "
"its single argument being the data as :class:`bytes`."
msgid "The *rest* parameter was added."
"Store a file in line mode.  *cmd* should be an appropriate ``STOR`` command "
"(see :meth:`storbinary`).  Lines are read until EOF from the :term:`file "
"object` *fp* (opened in binary mode) using its :meth:`~io.IOBase.readline` "
"method to provide the data to be stored.  *callback* is an optional single "
"parameter callable that is called on each line after it is sent."
"Initiate a transfer over the data connection.  If the transfer is active, "
"send an ``EPRT`` or  ``PORT`` command and the transfer command specified by "
"*cmd*, and accept the connection.  If the server is passive, send an "
"``EPSV`` or ``PASV`` command, connect to it, and start the transfer "
"command.  Either way, return the socket for the connection."
"If optional *rest* is given, a ``REST`` command is sent to the server, "
"passing *rest* as an argument.  *rest* is usually a byte offset into the "
"requested file, telling the server to restart sending the file's bytes at "
"the requested offset, skipping over the initial bytes.  Note however that "
"the :meth:`transfercmd` method converts *rest* to a string with the "
"*encoding* parameter specified at initialization, but no check is performed "
"on the string's contents.  If the server does not recognize the ``REST`` "
"command, an :exc:`error_reply` exception will be raised.  If this happens, "
"simply call :meth:`transfercmd` without a *rest* argument."
"Like :meth:`transfercmd`, but returns a tuple of the data connection and the "
"expected size of the data.  If the expected size could not be computed, "
"``None`` will be returned as the expected size.  *cmd* and *rest* means the "
"same thing as in :meth:`transfercmd`."
"List a directory in a standardized format by using ``MLSD`` command (:rfc:"
"`3659`).  If *path* is omitted the current directory is assumed. *facts* is "
"a list of strings representing the type of information desired (e.g. "
"``[\"type\", \"size\", \"perm\"]``).  Return a generator object yielding a "
"tuple of two elements for every file found in path.  First element is the "
"file name, the second one is a dictionary containing facts about the file "
"name.  Content of this dictionary might be limited by the *facts* argument "
"but server is not guaranteed to return all requested facts."
"Return a list of file names as returned by the ``NLST`` command.  The "
"optional *argument* is a directory to list (default is the current server "
"directory).  Multiple arguments can be used to pass non-standard options to "
"the ``NLST`` command."
msgid "If your server supports the command, :meth:`mlsd` offers a better API."
"Produce a directory listing as returned by the ``LIST`` command, printing it "
"to standard output.  The optional *argument* is a directory to list (default "
"is the current server directory).  Multiple arguments can be used to pass "
"non-standard options to the ``LIST`` command.  If the last argument is a "
"function, it is used as a *callback* function as for :meth:`retrlines`; the "
"default prints to :data:`sys.stdout`.  This method returns ``None``."
msgid "Rename file *fromname* on the server to *toname*."
"Remove the file named *filename* from the server.  If successful, returns "
"the text of the response, otherwise raises :exc:`error_perm` on permission "
"errors or :exc:`error_reply` on other errors."
msgid "Set the current directory on the server."
msgid "Create a new directory on the server."
msgid "Return the pathname of the current directory on the server."
msgid "Remove the directory named *dirname* on the server."
"Request the size of the file named *filename* on the server.  On success, "
"the size of the file is returned as an integer, otherwise ``None`` is "
"returned. Note that the ``SIZE`` command is not  standardized, but is "
"supported by many common server implementations."
"Send a ``QUIT`` command to the server and close the connection. This is the "
"\"polite\" way to close a connection, but it may raise an exception if the "
"server responds with an error to the ``QUIT`` command.  This implies a call "
"to the :meth:`close` method which renders the :class:`FTP` instance useless "
"for subsequent calls (see below)."
"Close the connection unilaterally.  This should not be applied to an already "
"closed connection such as after a successful call to :meth:`~FTP.quit`. "
"After this call the :class:`FTP` instance should not be used any more (after "
"a call to :meth:`close` or :meth:`~FTP.quit` you cannot reopen the "
"connection by issuing another :meth:`login` method)."
msgid "FTP_TLS objects"
"An :class:`FTP` subclass which adds TLS support to FTP as described in :rfc:"
"`4217`. Connect to port 21 implicitly securing the FTP control connection "
"before authenticating."
"The user must explicitly secure the data connection by calling the :meth:"
"`prot_p` method."
"An SSL context object which allows bundling SSL configuration options, "
"certificates and private keys into a single, potentially long-lived, "
"structure. Please read :ref:`ssl-security` for best practices."
"A timeout in seconds for blocking operations like :meth:`~FTP.connect` "
"(default: the global default timeout setting)."
"*keyfile* and *certfile* are a legacy alternative to *context* -- they can "
"point to PEM-formatted private key and certificate chain files "
"(respectively) for the SSL connection."
msgid "Added the *source_address* parameter."
"The class now supports hostname check with :attr:`ssl.SSLContext."
"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)."
"*keyfile* and *certfile* are deprecated in favor of *context*. Please use :"
"meth:`ssl.SSLContext.load_cert_chain` instead, or let :func:`ssl."
"create_default_context` select the system's trusted CA certificates for you."
msgid "Here's a sample session using the :class:`FTP_TLS` class::"
":class:`!FTP_TLS` class inherits from :class:`FTP`, defining these "
"additional methods and attributes:"
msgid "The SSL version to use (defaults to :data:`ssl.PROTOCOL_SSLv23`)."
"Set up a secure control connection by using TLS or SSL, depending on what is "
"specified in the :attr:`ssl_version` attribute."
"The method now supports hostname check with :attr:`ssl.SSLContext."
"check_hostname` and *Server Name Indication* (see :const:`ssl.HAS_SNI`)."
"Revert control channel back to plaintext.  This can be useful to take "
"advantage of firewalls that know how to handle NAT with non-secure FTP "
"without opening fixed ports."
msgid "Set up secure data connection."
msgid "Set up clear text data connection."
msgid "Module variables"
msgid "Exception raised when an unexpected reply is received from the server."
"Exception raised when an error code signifying a temporary error (response "
"codes in the range 400--499) is received."
"Exception raised when an error code signifying a permanent error (response "
"codes in the range 500--599) is received."
"Exception raised when a reply is received from the server that does not fit "
"the response specifications of the File Transfer Protocol, i.e. begin with a "
"digit in the range 1--5."
"The set of all exceptions (as a tuple) that methods of :class:`FTP` "
"instances may raise as a result of problems with the FTP connection (as "
"opposed to programming errors made by the caller).  This set includes the "
"four exceptions listed above as well as :exc:`OSError` and :exc:`EOFError`."
msgid "Module :mod:`netrc`"
"Parser for the :file:`.netrc` file format.  The file :file:`.netrc` is "
"typically used by FTP clients to load user authentication information before "
"prompting the user."
msgid "FTP"
msgid "protocol"
msgid "ftplib (standard module)"
Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

ftplib.po

Latest commit

History

ftplib.po

File metadata and controls
