python-docs-pl/library/asyncio-stream.po at 3.15 · python/python-docs-pl

Repository navigation

History

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

323

324

325

326

327

328

329

330

331

332

333

334

335

336

337

338

339

340

341

342

343

344

345

346

347

348

349

350

351

352

353

354

355

356

357

358

359

360

361

362

363

364

365

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

382

383

384

385

386

387

388

389

390

391

392

393

394

395

396

397

398

399

400

401

402

403

404

405

406

407

408

409

410

411

412

413

414

415

416

417

418

419

420

421

422

423

424

425

426

427

428

429

430

431

432

433

434

435

436

437

438

439

440

441

442

443

444

445

446

447

448

449

450

451

452

453

454

455

456

457

458

459

460

461

462

463

464

465

466

467

468

469

470

471

472

473

474

475

476

477

478

479

480

481

482

483

484

485

486

487

488

489

490

491

492

493

494

495

496

497

498

499

500

501

502

503

504

505

506

507

508

509

510

511

512

513

514

515

516

517

518

519

520

521

522

523

524

525

526

527

528

529

530

531

532

533

534

535

536

537

538

539

540

541

542

543

544

545

546

547

548

549

550

551

552

553

554

555

556

557

558

559

560

561

562

563

564

565

566

567

568

569

570

571

572

573

574

575

576

577

578

579

580

581

582

583

584

# SOME DESCRIPTIVE TITLE.

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

# Translators:

# python-doc bot, 2025

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.15\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-10-21 18:18+0000\n"

"PO-Revision-Date: 2025-09-16 00:00+0000\n"

"Last-Translator: python-doc bot, 2025\n"

"Language-Team: 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 "Streams"

msgstr ""

msgid "**Source code:** :source:`Lib/asyncio/streams.py`"

msgstr "**Kod źródłowy:** :source:`Lib/asyncio/streams.py`"

msgid ""

"Streams are high-level async/await-ready primitives to work with network "

"connections. Streams allow sending and receiving data without using "

"callbacks or low-level protocols and transports."

msgstr ""

msgid "Here is an example of a TCP echo client written using asyncio streams::"

msgstr ""

msgid ""

"import asyncio\n"

"\n"

"async def tcp_echo_client(message):\n"

" reader, writer = await asyncio.open_connection(\n"

" '127.0.0.1', 8888)\n"

"\n"

" print(f'Send: {message!r}')\n"

" writer.write(message.encode())\n"

" await writer.drain()\n"

"\n"

" data = await reader.read(100)\n"

" print(f'Received: {data.decode()!r}')\n"

"\n"

" print('Close the connection')\n"

" writer.close()\n"

" await writer.wait_closed()\n"

"\n"

"asyncio.run(tcp_echo_client('Hello World!'))"

msgstr ""

msgid "See also the `Examples`_ section below."

msgstr ""

msgid "Stream Functions"

msgstr ""

msgid ""

"The following top-level asyncio functions can be used to create and work "

"with streams:"

msgstr ""

msgid ""

"Establish a network connection and return a pair of ``(reader, writer)`` "

"objects."

msgstr ""

msgid ""

"The returned *reader* and *writer* objects are instances "

"of :class:`StreamReader` and :class:`StreamWriter` classes."

msgstr ""

msgid ""

"*limit* determines the buffer size limit used by the "

"returned :class:`StreamReader` instance. By default the *limit* is set to "

"64 KiB."

msgstr ""

msgid ""

"The rest of the arguments are passed directly "

"to :meth:`loop.create_connection`."

msgstr ""

msgid ""

"The *sock* argument transfers ownership of the socket to "

"the :class:`StreamWriter` created. To close the socket, call "

"its :meth:`~asyncio.StreamWriter.close` method."

msgstr ""

msgid "Added the *ssl_handshake_timeout* parameter."

msgstr ""

msgid "Added the *happy_eyeballs_delay* and *interleave* parameters."

msgstr ""

msgid "Removed the *loop* parameter."

msgstr ""

msgid "Added the *ssl_shutdown_timeout* parameter."

msgstr ""

msgid "Start a socket server."

msgstr ""

msgid ""

"The *client_connected_cb* callback is called whenever a new client "

"connection is established. It receives a ``(reader, writer)`` pair as two "

"arguments, instances of the :class:`StreamReader` and :class:`StreamWriter` "

"classes."

msgstr ""

msgid ""

"*client_connected_cb* can be a plain callable or a :ref:`coroutine function "

"<coroutine>`; if it is a coroutine function, it will be automatically "

"scheduled as a :class:`Task`."

msgstr ""

msgid ""

"The rest of the arguments are passed directly to :meth:`loop.create_server`."

msgstr ""

msgid ""

"The *sock* argument transfers ownership of the socket to the server created. "

"To close the socket, call the server's :meth:`~asyncio.Server.close` method."

msgstr ""

msgid "Added the *ssl_handshake_timeout* and *start_serving* parameters."

msgstr ""

msgid "Added the *keep_alive* parameter."

msgstr ""

msgid "Unix Sockets"

msgstr ""

msgid ""

"Establish a Unix socket connection and return a pair of ``(reader, writer)``."

msgstr ""

msgid "Similar to :func:`open_connection` but operates on Unix sockets."

msgstr ""

msgid "See also the documentation of :meth:`loop.create_unix_connection`."

msgstr ""

msgid "Availability"

msgstr "Dostępność"

msgid ""

"Added the *ssl_handshake_timeout* parameter. The *path* parameter can now be "

"a :term:`path-like object`"

msgstr ""

msgid "Start a Unix socket server."

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 ""

msgid ""

"Added the *ssl_handshake_timeout* and *start_serving* parameters. The *path* "

"parameter can now be a :term:`path-like object`."

msgstr ""

msgid "Added the *cleanup_socket* parameter."

msgstr ""

msgid "StreamReader"

msgstr ""

msgid ""

"Represents a reader object that provides APIs to read data from the IO "

"stream. As an :term:`asynchronous iterable`, the object supports "

"the :keyword:`async for` statement."

msgstr ""

msgid ""

"It is not recommended to instantiate *StreamReader* objects directly; "

"use :func:`open_connection` and :func:`start_server` instead."

msgstr ""

msgid "Acknowledge the EOF."

msgstr ""

msgid "Read up to *n* bytes from the stream."

msgstr ""

msgid ""

"If *n* is not provided or set to ``-1``, read until EOF, then return all "

"read :class:`bytes`. If EOF was received and the internal buffer is empty, "

"return an empty ``bytes`` object."

msgstr ""

msgid "If *n* is ``0``, return an empty ``bytes`` object immediately."

msgstr ""

msgid ""

"If *n* is positive, return at most *n* available ``bytes`` as soon as at "

"least 1 byte is available in the internal buffer. If EOF is received before "

"any byte is read, return an empty ``bytes`` object."

msgstr ""

msgid ""

"Read one line, where \"line\" is a sequence of bytes ending with ``\\n``."

msgstr ""

msgid ""

"If EOF is received and ``\\n`` was not found, the method returns partially "

"read data."

msgstr ""

msgid ""

"If EOF is received and the internal buffer is empty, return an empty "

"``bytes`` object."

msgstr ""

msgid "Read exactly *n* bytes."

msgstr ""

msgid ""

"Raise an :exc:`IncompleteReadError` if EOF is reached before *n* can be "

"read. Use the :attr:`IncompleteReadError.partial` attribute to get the "

"partially read data."

msgstr ""

msgid "Read data from the stream until *separator* is found."

msgstr ""

msgid ""

"On success, the data and separator will be removed from the internal buffer "

"(consumed). Returned data will include the separator at the end."

msgstr ""

msgid ""

"If the amount of data read exceeds the configured stream limit, "

"a :exc:`LimitOverrunError` exception is raised, and the data is left in the "

"internal buffer and can be read again."

msgstr ""

msgid ""

"If EOF is reached before the complete separator is found, "

"an :exc:`IncompleteReadError` exception is raised, and the internal buffer "

"is reset. The :attr:`IncompleteReadError.partial` attribute may contain a "

"portion of the separator."

msgstr ""

msgid ""

"The *separator* may also be a tuple of separators. In this case the return "

"value will be the shortest possible that has any separator as the suffix. "

"For the purposes of :exc:`LimitOverrunError`, the shortest possible "

"separator is considered to be the one that matched."

msgstr ""

msgid "The *separator* parameter may now be a :class:`tuple` of separators."

msgstr ""

msgid "Return ``True`` if the buffer is empty and :meth:`feed_eof` was called."

msgstr ""

msgid "StreamWriter"

msgstr ""

msgid ""

"Represents a writer object that provides APIs to write data to the IO stream."

msgstr ""

msgid ""

"It is not recommended to instantiate *StreamWriter* objects directly; "

"use :func:`open_connection` and :func:`start_server` instead."

msgstr ""

msgid ""

"The method attempts to write the *data* to the underlying socket "

"immediately. If that fails, the data is queued in an internal write buffer "

"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 ""

msgid ""

"stream.write(data)\n"

"await stream.drain()"

msgstr ""

msgid ""

"The method writes a list (or any iterable) of bytes to the underlying socket "

"immediately. If that fails, the data is queued in an internal write buffer "

"until it can be sent."

msgstr ""

msgid ""

"stream.writelines(lines)\n"

"await stream.drain()"

msgstr ""

msgid "The method closes the stream and the underlying socket."

msgstr ""

msgid ""

"The method should be used, though not mandatory, along with the "

"``wait_closed()`` method::"

msgstr ""

msgid ""

"stream.close()\n"

"await stream.wait_closed()"

msgstr ""

msgid ""

"Return ``True`` if the underlying transport supports the :meth:`write_eof` "

"method, ``False`` otherwise."

msgstr ""

msgid ""

"Close the write end of the stream after the buffered write data is flushed."

msgstr ""

msgid "Return the underlying asyncio transport."

msgstr ""

msgid ""

"Access optional transport information; "

"see :meth:`BaseTransport.get_extra_info` for details."

msgstr ""

msgid "Wait until it is appropriate to resume writing to the stream. Example::"

msgstr ""

msgid ""

"writer.write(data)\n"

"await writer.drain()"

msgstr ""

msgid ""

"This is a flow control method that interacts with the underlying IO write "

"buffer. When the size of the buffer reaches the high watermark, *drain()* "

"blocks until the size of the buffer is drained down to the low watermark and "

"writing can be resumed. When there is nothing to wait for, "

"the :meth:`drain` returns immediately."

msgstr ""

msgid ""

"When the write buffer is below the high watermark, :meth:`drain` returns "

"immediately without yielding to the event loop. As a result, code which "

"repeatedly calls ``write()`` followed by ``await drain()`` may prevent other "

"tasks from running. To prevent blocking behavior, yield to the event loop "

"explicitly with ``await asyncio.sleep(0)`` (see :func:`asyncio.sleep`)."

msgstr ""

msgid "Upgrade an existing stream-based connection to TLS."

msgstr ""

msgid "Parameters:"

msgstr ""

msgid "*sslcontext*: a configured instance of :class:`~ssl.SSLContext`."

msgstr ""

msgid ""

"*server_hostname*: sets or overrides the host name that the target server's "

"certificate will be matched against."

msgstr ""

msgid ""

"*ssl_handshake_timeout* is the time in seconds to wait for the TLS handshake "

"to complete before aborting the connection. ``60.0`` seconds if ``None`` "

"(default)."

msgstr ""

msgid ""

"*ssl_shutdown_timeout* is the time in seconds to wait for the SSL shutdown "

"to complete before aborting the connection. ``30.0`` seconds if ``None`` "

"(default)."

msgstr ""

msgid ""

"Raises a ``ValueError`` if ``sslcontext.check_hostname`` is ``True`` and "

"``server_hostname`` is not supplied."

msgstr ""

msgid ""

"Return ``True`` if the stream is closed or in the process of being closed."

msgstr ""

msgid "Wait until the stream is closed."

msgstr ""

msgid ""

"Should be called after :meth:`close` to wait until the underlying connection "

"is closed, ensuring that all data has been flushed before e.g. exiting the "

"program."

msgstr ""

msgid "Examples"

msgstr "Przykłady"

msgid "TCP echo client using streams"

msgstr ""

msgid "TCP echo client using the :func:`asyncio.open_connection` function::"

msgstr ""

msgid ""

"The :ref:`TCP echo client protocol "

"<asyncio_example_tcp_echo_client_protocol>` example uses the low-"

"level :meth:`loop.create_connection` method."

msgstr ""

msgid "TCP echo server using streams"

msgstr ""

msgid "TCP echo server using the :func:`asyncio.start_server` function::"

msgstr ""

msgid ""

"import asyncio\n"

"\n"

"async def handle_echo(reader, writer):\n"

" data = await reader.read(100)\n"

" message = data.decode()\n"

" addr = writer.get_extra_info('peername')\n"

"\n"

" print(f\"Received {message!r} from {addr!r}\")\n"

"\n"

" print(f\"Send: {message!r}\")\n"

" writer.write(data)\n"

" await writer.drain()\n"

"\n"

" print(\"Close the connection\")\n"

" writer.close()\n"

" await writer.wait_closed()\n"

"\n"

"async def main():\n"

" server = await asyncio.start_server(\n"

" handle_echo, '127.0.0.1', 8888)\n"

"\n"

" addrs = ', '.join(str(sock.getsockname()) for sock in server.sockets)\n"

" print(f'Serving on {addrs}')\n"

"\n"

" async with server:\n"

" await server.serve_forever()\n"

"\n"

"asyncio.run(main())"

msgstr ""

msgid ""

"The :ref:`TCP echo server protocol "

"<asyncio_example_tcp_echo_server_protocol>` example uses "

"the :meth:`loop.create_server` method."

msgstr ""

msgid "Get HTTP headers"

msgstr ""

msgid ""

"Simple example querying HTTP headers of the URL passed on the command line::"

msgstr ""

msgid ""

"import asyncio\n"

"import urllib.parse\n"

"import sys\n"

"\n"

"async def print_http_headers(url):\n"

" url = urllib.parse.urlsplit(url)\n"

" if url.scheme == 'https':\n"

" reader, writer = await asyncio.open_connection(\n"

" url.hostname, 443, ssl=True)\n"

" else:\n"

" reader, writer = await asyncio.open_connection(\n"

" url.hostname, 80)\n"

"\n"

" query = (\n"

" f\"HEAD {url.path or '/'} HTTP/1.0\\r\\n\"\n"

" f\"Host: {url.hostname}\\r\\n\"\n"

" f\"\\r\\n\"\n"

" )\n"

"\n"

" writer.write(query.encode('latin-1'))\n"

" while True:\n"

" line = await reader.readline()\n"

" if not line:\n"

" break\n"

"\n"

" line = line.decode('latin1').rstrip()\n"

" if line:\n"

" print(f'HTTP header> {line}')\n"

"\n"

" # Ignore the body, close the socket\n"

" writer.close()\n"

" await writer.wait_closed()\n"

"\n"

"url = sys.argv[1]\n"

"asyncio.run(print_http_headers(url))"

msgstr ""

msgid "Usage::"

msgstr ""

msgid "python example.py http://example.com/path/page.html"

msgstr ""

msgid "or with HTTPS::"

msgstr ""

msgid "python example.py https://example.com/path/page.html"

msgstr ""

msgid "Register an open socket to wait for data using streams"

msgstr ""

msgid ""

"Coroutine waiting until a socket receives data using "

"the :func:`open_connection` function::"

msgstr ""

msgid ""

"import asyncio\n"

"import socket\n"

"\n"

"async def wait_for_data():\n"

" # Get a reference to the current event loop because\n"

" # we want to access low-level APIs.\n"

" loop = asyncio.get_running_loop()\n"

"\n"

" # Create a pair of connected sockets.\n"

" rsock, wsock = socket.socketpair()\n"

"\n"

" # Register the open socket to wait for data.\n"

" reader, writer = await asyncio.open_connection(sock=rsock)\n"

"\n"

" # Simulate the reception of data from the network\n"

" loop.call_soon(wsock.send, 'abc'.encode())\n"

"\n"

" # Wait for data\n"

" data = await reader.read(100)\n"

"\n"

" # Got data, we are done: close the socket\n"

" print(\"Received:\", data.decode())\n"

" writer.close()\n"

" await writer.wait_closed()\n"

"\n"

" # Close the second socket\n"

" wsock.close()\n"

"\n"

"asyncio.run(wait_for_data())"

msgstr ""

msgid ""

"The :ref:`register an open socket to wait for data using a protocol "

"<asyncio_example_create_connection>` example uses a low-level protocol and "

"the :meth:`loop.create_connection` method."

msgstr ""

msgid ""

"The :ref:`watch a file descriptor for read events "

"<asyncio_example_watch_fd>` example uses the low-"

"level :meth:`loop.add_reader` method to watch a file descriptor."

msgstr ""

FilesExpand file tree

asyncio-stream.po

Latest commit

History

asyncio-stream.po

File metadata and controls