Viewing: github-redirect.dependabot.com

Repository navigation

More items

Blame

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

585

586

587

588

589

590

591

592

593

594

595

596

597

598

599

600

601

602

603

604

605

606

607

608

609

610

611

612

613

614

615

616

617

618

619

620

621

622

623

624

625

626

627

628

629

630

631

632

633

634

# SOME DESCRIPTIVE TITLE.

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

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

# Translators:

# Ciarbin Ciarbin <mrciarbin@gmail.com>, 2021

# Maciej Olko <maciej.olko@gmail.com>, 2022

#, fuzzy

msgid ""

msgstr ""

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

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

"POT-Creation-Date: 2021-01-01 05:02+0000\n"

"PO-Revision-Date: 2017-02-16 23:41+0000\n"

"Last-Translator: Maciej Olko <maciej.olko@gmail.com>, 2022\n"

"Language-Team: Polish (https://www.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 "Modules"

msgstr "Moduy"

msgid ""

"If you quit from the Python interpreter and enter it again, the definitions "

"you have made (functions and variables) are lost. Therefore, if you want to "

"write a somewhat longer program, you are better off using a text editor to "

"prepare the input for the interpreter and running it with that file as input "

"instead. This is known as creating a *script*. As your program gets "

"longer, you may want to split it into several files for easier maintenance. "

"You may also want to use a handy function that you've written in several "

"programs without copying its definition into each program."

msgstr ""

"Jeli wyjdziesz z interpretera Pythona i wejdziesz do niego z powrotem, "

"zauwaysz, e stracie(-a) definicje, ktre zrobie(-a) (funkcje i "

"zmienne). Z tego powodu, jeli chcesz napisa nieco duszy program, lepiej "

"bdzie uy edytora tekstu, aby przygotowa wejcie dla interpretera i "

"uruchomi go z tym plikiem jako wejciem. Znane jest to jako tworzenie "

"skryptu. Kiedy twj program staje si duszy, moesz podzieli go na "

"kilka plikw dla atwiejszego utrzymania. Moesz chcie te uy przydatnej "

"funkcji, ktr napisae, w kilku programach, bez kopiowania jej definicji "

"do kadego programu."

msgid ""

"To support this, Python has a way to put definitions in a file and use them "

"in a script or in an interactive instance of the interpreter. Such a file is "

"called a *module*; definitions from a module can be *imported* into other "

"modules or into the *main* module (the collection of variables that you have "

"access to in a script executed at the top level and in calculator mode)."

msgstr ""

"By to zapewni, Python ma moliwo umieszczania definicji w pliku i "

"uywania ich w skrypcie lub w interaktywnej instancji interpretera. Taki "

"plik nazywa si *moduem*; definicje z moduu mog by *importowane* do "

"innych moduw lub do moduu *main* (zbir zmiennych, do ktrych masz dostp "

"w skrypcie wykonywanym na najwyszym poziomie i w trybie kalkulatora)."

msgid ""

"A module is a file containing Python definitions and statements. The file "

"name is the module name with the suffix :file:`.py` appended. Within a "

"module, the module's name (as a string) is available as the value of the "

"global variable ``__name__``. For instance, use your favorite text editor "

"to create a file called :file:`fibo.py` in the current directory with the "

"following contents::"

msgstr ""

"Modu to plik zawierajcy definicje i instrukcje Pythona. Nazw pliku jest "

"nazwa moduu z dodanym sufiksem :file:`.py`. Wewntrz moduu, jego nazwa "

"(jako cig znakw) jest dostpna jako wartozmiennej globalnej "

"``__name__``. Na przykad uyj swojego ulubionego edytora tekstu, by "

"stworzy plik o nazwie :file:`fibo.py` w biecym katalogu, z nastpujc "

"zawartoci::"

msgid ""

"Now enter the Python interpreter and import this module with the following "

"command::"

msgstr ""

"Wejd w interpreter Pythona i zaimportuj ten modu nastpujc komend::"

msgid ""

"This does not enter the names of the functions defined in ``fibo`` directly "

"in the current symbol table; it only enters the module name ``fibo`` there. "

"Using the module name you can access the functions::"

msgstr ""

"Ta komenda nie umieszcza nazw funkcji okrelonych w ``fibo`` bezporednio w "

"biecej tabeli symboli; umieszcza ona tam tylko nazw moduu ``fibo``. "

"Uywajc nazwy moduu moesz uy funkcji::"

msgid ""

"If you intend to use a function often you can assign it to a local name::"

msgstr ""

"Jeli zamierzasz uywa funkcji czsto, moesz przypisa j do lokalnej "

"nazwy::"

msgid "More on Modules"

msgstr "Wicej o moduach"

msgid ""

"A module can contain executable statements as well as function definitions. "

"These statements are intended to initialize the module. They are executed "

"only the *first* time the module name is encountered in an import statement. "

"[#]_ (They are also run if the file is executed as a script.)"

msgstr ""

"Modu moe zawiera zarwno wykonywalne instrukcje jak i definicje funkcji. "

"Instrukcje maj inicjalizowa modu. S wykonywane tylko za *pierwszym* "

"razem, gdy nazwa moduu zostanie napotkana w instrukcji importu. [#]_ (S "

"one rwnie wykonywane, jeli plik jest wykonywany jako skrypt.)"

msgid ""

"Each module has its own private symbol table, which is used as the global "

"symbol table by all functions defined in the module. Thus, the author of a "

"module can use global variables in the module without worrying about "

"accidental clashes with a user's global variables. On the other hand, if you "

"know what you are doing you can touch a module's global variables with the "

"same notation used to refer to its functions, ``modname.itemname``."

msgstr ""

"Kady modu ma swoj wasn tablic symboli, ktra jest uywana jako "

"globalna tablica symboli przez wszystkie funkcje zdefiniowane w tym module. "

"Tak wic autor moduu moe uywa globalnych zmiennych nie martwic si o "

"przypadkowe konflikty z globalnymi zmiennymi uytkownika. Z drugiej strony, "

"jeli wiesz co robisz, moesz odnosi si do globalnych zmiennych moduu t "

"sam notacj, ktr uywa si do odniesie do jego funkcji, ``nazwamoduu."

"nazwalementu``."

msgid ""

"Modules can import other modules. It is customary but not required to place "

"all :keyword:`import` statements at the beginning of a module (or script, "

"for that matter). The imported module names are placed in the importing "

"module's global symbol table."

msgstr ""

"Moduy mog importowa inne moduy. Zwyczajowo (nieobowizkowo) umieszcza "

"si wszystkie instrukcje :keyword:`import` na pocztku moduu (lub skryptu). "

"Zaimportowane nazwy moduw s umieszczane w globalnej tablicy symboli "

"moduu importujcego."

msgid ""

"There is a variant of the :keyword:`import` statement that imports names "

"from a module directly into the importing module's symbol table. For "

"example::"

msgstr ""

"Istnieje wariant instrukcji :keyword:`import`, ktry importuje nazwy z "

"moduu bezporednio do tablicy symboli moduu importujcego. Na przykad::"

msgid ""

"This does not introduce the module name from which the imports are taken in "

"the local symbol table (so in the example, ``fibo`` is not defined)."

msgstr ""

"Nie wprowadza to nazwy moduu, z ktrego wzite s importy do lokalnej "

"tablicy symboli (wic w przykadzie ``fibo`` nie jest zdefiniowane)."

msgid "There is even a variant to import all names that a module defines::"

msgstr ""

"Jest rwnie wariant importujcy wszystkie nazwy definiowane przez modu::"

msgid ""

"This imports all names except those beginning with an underscore (``_``). In "

"most cases Python programmers do not use this facility since it introduces "

"an unknown set of names into the interpreter, possibly hiding some things "

"you have already defined."

msgstr ""

"Importuje to wszystkie nazwy z wyjtkiem tych zaczynajcych si od "

"podkrelenia (``_``). W wikszoci przypadkw programici Pythona nie "

"uywaj tego udogodnienia, poniewa wprowadza ono nieznany zestaw nazw do "

"interpretera, by moe ukrywajc niektre ju zdefiniowane rzeczy."

msgid ""

"Note that in general the practice of importing ``*`` from a module or "

"package is frowned upon, since it often causes poorly readable code. "

"However, it is okay to use it to save typing in interactive sessions."

msgstr ""

"Zauwa, e oglnie praktyka importowania ``*`` z moduu lub pakietu jest "

"niemile widziana, poniewa czsto powoduje, e kod jest mao czytelny. Mona "

"jej jednak uywa do oszczdzania pisania w sesjach interaktywnych."

msgid ""

"If the module name is followed by :keyword:`!as`, then the name following :"

"keyword:`!as` is bound directly to the imported module."

msgstr ""

"Jeeli po nazwie moduu nastpuje :keyword:`!as`, to nazwa nastpujca po :"

"keyword:`!as` jest powizana bezporednio z importowanym moduem."

msgid ""

"This is effectively importing the module in the same way that ``import "

"fibo`` will do, with the only difference of it being available as ``fib``."

msgstr ""

"W praktyce jest to importowanie moduu w taki sam sposb, jak robi to "

"``import fibo``, z t rnic, e jest on dostpny jako ``fib``."

msgid ""

"It can also be used when utilising :keyword:`from` with similar effects::"

msgstr "Mona go rwnie uy przy uyciu :keyword:`from` z podobnym efektem::"

msgid ""

"For efficiency reasons, each module is only imported once per interpreter "

"session. Therefore, if you change your modules, you must restart the "

"interpreter -- or, if it's just one module you want to test interactively, "

"use :func:`importlib.reload`, e.g. ``import importlib; importlib."

"reload(modulename)``."

msgstr ""

"Ze wzgldw wydajnociowych kady modu jest importowany tylko raz dla sesji "

"interpretera. W zwizku z tym jeli zmienisz swoje moduy, musisz "

"zrestartowa interpreter lub, jeli to tylko jeden modu, ktry chcesz "

"testowa interaktywnie, uyj :func:`importlib.reload`, na przykad ``import "

"importlib; importlib.reload(modulename)``."

msgid "Executing modules as scripts"

msgstr "Wykonywanie moduw jako skryptw"

msgid "When you run a Python module with ::"

msgstr "Kiedy uruchamiasz modu Pythona::"

msgid ""

"the code in the module will be executed, just as if you imported it, but "

"with the ``__name__`` set to ``\"__main__\"``. That means that by adding "

"this code at the end of your module::"

msgstr ""

"kod w module zostanie wykonany, tak jakby go zaimportowa, ale z "

"``__name__`` ustawionym na ``\"__main__\"``. To oznacza, e dodajc ten kod "

"na kocu swojego moduu::"

msgid ""

"you can make the file usable as a script as well as an importable module, "

"because the code that parses the command line only runs if the module is "

"executed as the \"main\" file:"

msgstr ""

"moesz uczyni plik uywalnym zarwno jako skrypt oraz jako importowalny "

"modu, poniewa kod, ktry parsuje lini komend uruchamia si tylko jeli "

"modu jest wykonywany jako plik gwny:"

msgid "If the module is imported, the code is not run::"

msgstr "Jeli modu jest zaimportowany, kod nie jest uruchamiany::"

msgid ""

"This is often used either to provide a convenient user interface to a "

"module, or for testing purposes (running the module as a script executes a "

"test suite)."

msgstr ""

"Czsto si z tego korzysta, aby doda wygodny interfejs uytkownika do "

"moduu lub na potrzeby testw (uruchomienie moduu jako skryptu wykonuje "

"zestaw testw)."

msgid "The Module Search Path"

msgstr "cieka wyszukiwania moduw"

msgid ""

"When a module named :mod:`spam` is imported, the interpreter first searches "

"for a built-in module with that name. If not found, it then searches for a "

"file named :file:`spam.py` in a list of directories given by the variable :"

"data:`sys.path`. :data:`sys.path` is initialized from these locations:"

msgstr ""

"Kiedy importowany jest modu o nazwie :mod:`spam`, interpreter najpierw "

"szuka wbudowanego moduu o takiej nazwie. Jeli nie znajdzie, wtedy szuka "

"pliku o nazwie :file:`spam.py` na licie katalogw danych w zmiennej :data:"

"`sys.path`. :data:`sys.path` jest inicjalizowane z tych lokalizacji:"

msgid ""

"The directory containing the input script (or the current directory when no "

"file is specified)."

msgstr ""

"Katalog zawierajcy skrypt wejciowy (lub biecy katalog, jeli plik nie "

"jest okrelony)."

msgid ""

":envvar:`PYTHONPATH` (a list of directory names, with the same syntax as the "

"shell variable :envvar:`PATH`)."

msgstr ""

":envvar:`PYTHONPATH` (lista nazw katalogw o takiej samej skadni jak "

"zmienna shell :envvar:`PATH`)."

msgid "The installation-dependent default."

msgstr ""

msgid ""

"On file systems which support symlinks, the directory containing the input "

"script is calculated after the symlink is followed. In other words the "

"directory containing the symlink is **not** added to the module search path."

msgstr ""

"W systemach plikw wspierajcych dowizania symboliczne, katalog zawierajcy "

"skrypt wejciowy jest wyliczany po rozwizaniu dowizania symbolicznego. "

"Innymi sowy katalog zawierajcy dowizanie symboliczne **nie** jest dodany "

"do cieki wyszukiwania moduw."

msgid ""

"After initialization, Python programs can modify :data:`sys.path`. The "

"directory containing the script being run is placed at the beginning of the "

"search path, ahead of the standard library path. This means that scripts in "

"that directory will be loaded instead of modules of the same name in the "

"library directory. This is an error unless the replacement is intended. See "

"section :ref:`tut-standardmodules` for more information."

msgstr ""

"Po inicjalizacji programy pythonowe mog modyfikowa :data:`sys.path`. "

"Katalog zwierajcy uruchamiany skrypt jest umieszczony na pocztku cieki "

"wyszukiwania, przed ciek biblioteki standardowej. To znaczy, e skrypty w "

"tym katalogu zostan zaadowane zamiast moduw o tej samej nazwie w "

"katalogu biblioteki. Jest to bd, o ile taka zamiana jest zamierzona. Patrz "

"sekcja :ref:`tut-standardmodules` po wicej informacji."

msgid "\"Compiled\" Python files"

msgstr "Skompilowane pliki Pythona"

msgid ""

"To speed up loading modules, Python caches the compiled version of each "

"module in the ``__pycache__`` directory under the name :file:`module."

"{version}.pyc`, where the version encodes the format of the compiled file; "

"it generally contains the Python version number. For example, in CPython "

"release 3.3 the compiled version of spam.py would be cached as ``__pycache__/"

"spam.cpython-33.pyc``. This naming convention allows compiled modules from "

"different releases and different versions of Python to coexist."

msgstr ""

"Aby przyspieszy adowanie moduw, Python cache'uje skompilowan wersj "

"kadego moduu w katalogu ``__pycache__`` pod nazw :file:`module.{wersja}."

"pyc`, gdzie wersja koduje format skompilowanego pliku; zazwyczaj zawiera "

"numer wersji Pythona. Na przykad w wydaniu CPythona 3.3 skompilowana wersja "

"spam.py zostaaby zcache'owana jako ``__pycache__/spam.cpython-33.pyc``. Ta "

"konwencja nazw pozwala na wspistnienie skompilowanych moduw z rnych "

"wyda i wersji Pythona."

msgid ""

"Python checks the modification date of the source against the compiled "

"version to see if it's out of date and needs to be recompiled. This is a "

"completely automatic process. Also, the compiled modules are platform-"

"independent, so the same library can be shared among systems with different "

"architectures."

msgstr ""

"Python porwnuje dat modyfikacji rda ze skompilowan wersj, aby "

"ustali, czy jest przeterminowana i powinna zosta zrekompilowana. To "

"cakowicie automatyczny proces. Skompilowane moduy s niezalene od "

"platformy, wic ta sama biblioteka moe by wspdzielona pomidzy systemami "

"z innymi architekturami."

msgid ""

"Python does not check the cache in two circumstances. First, it always "

"recompiles and does not store the result for the module that's loaded "

"directly from the command line. Second, it does not check the cache if "

"there is no source module. To support a non-source (compiled only) "

"distribution, the compiled module must be in the source directory, and there "

"must not be a source module."

msgstr ""

"Python nie sprawdza cache'u w dwch przypadkach. Po pierwsze zawsze "

"rekompiluje i nie zapisuje wyniku dla moduu zaadowanego bezporednio z "

"linii komend. Po drugie nie sprawdza cache'u, kiedy nie ma moduu "

"rdowego. Dla wsparcia dystrybucji bez rda (tylko kompilowany), "

"skompilowany modu musi by w katalogu rdowym i nie moe by moduu "

"rdowego."

msgid "Some tips for experts:"

msgstr "Wskazwki dla ekspertw:"

msgid ""

"You can use the :option:`-O` or :option:`-OO` switches on the Python command "

"to reduce the size of a compiled module. The ``-O`` switch removes assert "

"statements, the ``-OO`` switch removes both assert statements and __doc__ "

"strings. Since some programs may rely on having these available, you should "

"only use this option if you know what you're doing. \"Optimized\" modules "

"have an ``opt-`` tag and are usually smaller. Future releases may change "

"the effects of optimization."

msgstr ""

"Moesz uy przecznikw :option:`-O` lub :option:`-OO` na komendzie "

"``python``, aby zmniejszy rozmiar skompilowanego moduu. Przecznik ``-O`` "

"usuwa instrukcje assert. Przecznik ``-OO`` usuwa zarwno instrukcje assert "

"jak i docstringi. Jako e niektre programy mog polega na dostpnoci "

"powyszych, powiniene(-nna) uywa tylko jeli wiesz, co robisz. "

"Zoptymalizowane moduy maj tag ``opt-`` i zazwyczaj s mniejsze. Przysze "

"wydania mog zmieni efekty optymalizacji."

msgid ""

"A program doesn't run any faster when it is read from a ``.pyc`` file than "

"when it is read from a ``.py`` file; the only thing that's faster about ``."

"pyc`` files is the speed with which they are loaded."

msgstr ""

"Program nie wykonuje si ani chwili szybciej, gdy jest czytany z pliku ``."

"pyc`` ni gdy jest czytany z pliku ``.py``. Jedyna rzecz, ktra jest szybsza "

"w plikach ``.pyc`` to szybko, w jakiej s one adowane."

msgid ""

"The module :mod:`compileall` can create .pyc files for all modules in a "

"directory."

msgstr ""

msgid ""

"There is more detail on this process, including a flow chart of the "

"decisions, in :pep:`3147`."

msgstr ""

msgid "Standard Modules"

msgstr "Moduy standardowe"

msgid ""

"Python comes with a library of standard modules, described in a separate "

"document, the Python Library Reference (\"Library Reference\" hereafter). "

"Some modules are built into the interpreter; these provide access to "

"operations that are not part of the core of the language but are "

"nevertheless built in, either for efficiency or to provide access to "

"operating system primitives such as system calls. The set of such modules "

"is a configuration option which also depends on the underlying platform. "

"For example, the :mod:`winreg` module is only provided on Windows systems. "

"One particular module deserves some attention: :mod:`sys`, which is built "

"into every Python interpreter. The variables ``sys.ps1`` and ``sys.ps2`` "

"define the strings used as primary and secondary prompts::"

msgstr ""

msgid ""

"These two variables are only defined if the interpreter is in interactive "

"mode."

msgstr ""

msgid ""

"The variable ``sys.path`` is a list of strings that determines the "

"interpreter's search path for modules. It is initialized to a default path "

"taken from the environment variable :envvar:`PYTHONPATH`, or from a built-in "

"default if :envvar:`PYTHONPATH` is not set. You can modify it using "

"standard list operations::"

msgstr ""

msgid "The :func:`dir` Function"

msgstr ""

msgid ""

"The built-in function :func:`dir` is used to find out which names a module "

"defines. It returns a sorted list of strings::"

msgstr ""

msgid ""

"Without arguments, :func:`dir` lists the names you have defined currently::"

msgstr ""

msgid ""

"Note that it lists all types of names: variables, modules, functions, etc."

msgstr ""

msgid ""

":func:`dir` does not list the names of built-in functions and variables. If "

"you want a list of those, they are defined in the standard module :mod:"

"`builtins`::"

msgstr ""

msgid "Packages"

msgstr ""

msgid ""

"Packages are a way of structuring Python's module namespace by using "

"\"dotted module names\". For example, the module name :mod:`A.B` designates "

"a submodule named ``B`` in a package named ``A``. Just like the use of "

"modules saves the authors of different modules from having to worry about "

"each other's global variable names, the use of dotted module names saves the "

"authors of multi-module packages like NumPy or Pillow from having to worry "

"about each other's module names."

msgstr ""

msgid ""

"Suppose you want to design a collection of modules (a \"package\") for the "

"uniform handling of sound files and sound data. There are many different "

"sound file formats (usually recognized by their extension, for example: :"

"file:`.wav`, :file:`.aiff`, :file:`.au`), so you may need to create and "

"maintain a growing collection of modules for the conversion between the "

"various file formats. There are also many different operations you might "

"want to perform on sound data (such as mixing, adding echo, applying an "

"equalizer function, creating an artificial stereo effect), so in addition "

"you will be writing a never-ending stream of modules to perform these "

"operations. Here's a possible structure for your package (expressed in "

"terms of a hierarchical filesystem):"

msgstr ""

msgid ""

"When importing the package, Python searches through the directories on ``sys."

"path`` looking for the package subdirectory."

msgstr ""

msgid ""

"The :file:`__init__.py` files are required to make Python treat directories "

"containing the file as packages. This prevents directories with a common "

"name, such as ``string``, unintentionally hiding valid modules that occur "

"later on the module search path. In the simplest case, :file:`__init__.py` "

"can just be an empty file, but it can also execute initialization code for "

"the package or set the ``__all__`` variable, described later."

msgstr ""

msgid ""

"Users of the package can import individual modules from the package, for "

"example::"

msgstr ""

msgid ""

"This loads the submodule :mod:`sound.effects.echo`. It must be referenced "

"with its full name. ::"

msgstr ""

msgid "An alternative way of importing the submodule is::"

msgstr ""

msgid ""

"This also loads the submodule :mod:`echo`, and makes it available without "

"its package prefix, so it can be used as follows::"

msgstr ""

msgid ""

"Yet another variation is to import the desired function or variable "

"directly::"

msgstr ""

msgid ""

"Again, this loads the submodule :mod:`echo`, but this makes its function :"

"func:`echofilter` directly available::"

msgstr ""

msgid ""

"Note that when using ``from package import item``, the item can be either a "

"submodule (or subpackage) of the package, or some other name defined in the "

"package, like a function, class or variable. The ``import`` statement first "

"tests whether the item is defined in the package; if not, it assumes it is a "

"module and attempts to load it. If it fails to find it, an :exc:"

"`ImportError` exception is raised."

msgstr ""

msgid ""

"Contrarily, when using syntax like ``import item.subitem.subsubitem``, each "

"item except for the last must be a package; the last item can be a module or "

"a package but can't be a class or function or variable defined in the "

"previous item."

msgstr ""

msgid "Importing \\* From a Package"

msgstr ""

msgid ""

"Now what happens when the user writes ``from sound.effects import *``? "

"Ideally, one would hope that this somehow goes out to the filesystem, finds "

"which submodules are present in the package, and imports them all. This "

"could take a long time and importing sub-modules might have unwanted side-"

"effects that should only happen when the sub-module is explicitly imported."

msgstr ""

msgid ""

"The only solution is for the package author to provide an explicit index of "

"the package. The :keyword:`import` statement uses the following convention: "

"if a package's :file:`__init__.py` code defines a list named ``__all__``, it "

"is taken to be the list of module names that should be imported when ``from "

"package import *`` is encountered. It is up to the package author to keep "

"this list up-to-date when a new version of the package is released. Package "

"authors may also decide not to support it, if they don't see a use for "

"importing \\* from their package. For example, the file :file:`sound/"

"effects/__init__.py` could contain the following code::"

msgstr ""

msgid ""

"This would mean that ``from sound.effects import *`` would import the three "

"named submodules of the :mod:`sound` package."

msgstr ""

msgid ""

"If ``__all__`` is not defined, the statement ``from sound.effects import *`` "

"does *not* import all submodules from the package :mod:`sound.effects` into "

"the current namespace; it only ensures that the package :mod:`sound.effects` "

"has been imported (possibly running any initialization code in :file:"

"`__init__.py`) and then imports whatever names are defined in the package. "

"This includes any names defined (and submodules explicitly loaded) by :file:"

"`__init__.py`. It also includes any submodules of the package that were "

"explicitly loaded by previous :keyword:`import` statements. Consider this "

"code::"

msgstr ""

msgid ""

"In this example, the :mod:`echo` and :mod:`surround` modules are imported in "

"the current namespace because they are defined in the :mod:`sound.effects` "

"package when the ``from...import`` statement is executed. (This also works "

"when ``__all__`` is defined.)"

msgstr ""

msgid ""

"Although certain modules are designed to export only names that follow "

"certain patterns when you use ``import *``, it is still considered bad "

"practice in production code."

msgstr ""

msgid ""

"Remember, there is nothing wrong with using ``from package import "

"specific_submodule``! In fact, this is the recommended notation unless the "

"importing module needs to use submodules with the same name from different "

"packages."

msgstr ""

msgid "Intra-package References"

msgstr ""

msgid ""

"When packages are structured into subpackages (as with the :mod:`sound` "

"package in the example), you can use absolute imports to refer to submodules "

"of siblings packages. For example, if the module :mod:`sound.filters."

"vocoder` needs to use the :mod:`echo` module in the :mod:`sound.effects` "

"package, it can use ``from sound.effects import echo``."

msgstr ""

msgid ""

"You can also write relative imports, with the ``from module import name`` "

"form of import statement. These imports use leading dots to indicate the "

"current and parent packages involved in the relative import. From the :mod:"

"`surround` module for example, you might use::"

msgstr ""

msgid ""

"Note that relative imports are based on the name of the current module. "

"Since the name of the main module is always ``\"__main__\"``, modules "

"intended for use as the main module of a Python application must always use "

"absolute imports."

msgstr ""

msgid "Packages in Multiple Directories"

msgstr ""

msgid ""

"Packages support one more special attribute, :attr:`__path__`. This is "

"initialized to be a list containing the name of the directory holding the "

"package's :file:`__init__.py` before the code in that file is executed. "

"This variable can be modified; doing so affects future searches for modules "

"and subpackages contained in the package."

msgstr ""

msgid ""

"While this feature is not often needed, it can be used to extend the set of "

"modules found in a package."

msgstr ""

msgid "Footnotes"

msgstr "Przypisy"

msgid ""

"In fact function definitions are also 'statements' that are 'executed'; the "

"execution of a module-level function definition enters the function name in "

"the module's global symbol table."

msgstr ""

Terms
Privacy
Security
Status
Community
Docs
Contact
Manage cookies
Do not share my personal information

Navigation Menu

Repository navigation

Files

modules.po

modules.po

Navigation Menu

Repository navigation

FilesExpand file tree

Breadcrumbs

modules.po

Latest commit

History

Breadcrumbs

modules.po

File metadata and controls

Footer

Footer navigation

Files