python-docs-tr/tutorial/modules.html at gh-pages · python-docs-tr/python-docs-tr

History

722 lines (680 loc) · 70.7 KB

Raw

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

635

636

637

638

639

640

641

642

643

644

645

646

647

648

649

650

651

652

653

654

655

656

657

658

659

660

661

662

663

664

665

666

667

668

669

670

671

672

673

674

675

676

677

678

679

680

681

682

683

684

685

686

687

688

689

690

691

692

693

694

695

696

697

698

699

700

701

702

703

704

705

706

707

708

709

710

711

712

713

714

715

716

717

718

719

720

721

722

<!DOCTYPE html>

<head>

<title>6. Modüller — Python 3.11.5 belgelendirmesi</title><meta name="viewport" content="width=device-width, initial-scale=1.0">

title="Python 3.11.5 belgelendirmesi içinde ara"

href="../_static/opensearch.xml"/>

<style>

@media only screen {

table.full-width-table {

width: 100%;

}

</style>

</head>

<body>

<input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"

aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />

</label>

</a>

</svg>

</form>

</nav>

Theme

<option value="light">Light</option>

</select>

</label>

<div>

<h3><a href="../contents.html">İçindekiler</a></h3>

<ul>

<li><a class="reference internal" href="#">6. Modüller</a><ul>

<li><a class="reference internal" href="#more-on-modules">6.1. Modüller hakkında daha fazla</a><ul>

<li><a class="reference internal" href="#executing-modules-as-scripts">6.1.1. Modülleri komut dosyası olarak yürütme</a></li>

<li><a class="reference internal" href="#the-module-search-path">6.1.2. Modül Arama Yolu</a></li>

<li><a class="reference internal" href="#compiled-python-files">6.1.3. “Derlenmiş” Python dosyaları</a></li>

</ul>

</li>

<li><a class="reference internal" href="#standard-modules">6.2. Standart modüller</a></li>

<li><a class="reference internal" href="#the-dir-function">6.3. <code class="xref py py-func docutils literal notranslate">dir()</code> Fonksiyonu</a></li>

<li><a class="reference internal" href="#packages">6.4. Paketler</a><ul>

<li><a class="reference internal" href="#importing-from-a-package">6.4.1. Bir Paketten * İçe Aktarma</a></li>

<li><a class="reference internal" href="#intra-package-references">6.4.2. Paket İçi Referanslar</a></li>

<li><a class="reference internal" href="#packages-in-multiple-directories">6.4.3. Birden Çok Dizindeki Paketler</a></li>

</ul>

</li>

</ul>

</li>

</ul>

</div>

<div>

<h4>Önceki konu</h4>

<a href="datastructures.html"

title="önceki bölüm">5. Veri Yapıları</a>

</div>

<div>

<h4>Sonraki konu</h4>

<a href="inputoutput.html"

title="sonraki bölüm">7. Girdi ve Çıktı</a>

</div>

<h3>Bu Sayfa</h3>

<li><a href="../bugs.html">Hata Bildir</a></li>

<li>

<a href="https://github.com/python/cpython/blob/3.11/Doc/tutorial/modules.rst"

rel="nofollow">Kaynağı Göster

</a>

</li>

</ul>

</div>

</nav>

</div>

<h3>Gezinti</h3>

<ul>

<a href="../genindex.html" title="Genel Endeks"

accesskey="I">dizin</a></li>

<a href="../py-modindex.html" title="Python Modül Dizini"

>modülleri</a> |</li>

<a href="inputoutput.html" title="7. Girdi ve Çıktı"

accesskey="N">sonraki</a> |</li>

<a href="datastructures.html" title="5. Veri Yapıları"

accesskey="P">önceki</a> |</li>

<li><a href="https://www.python.org/">Python</a> »</li>

</li>

<li>

</li>

<a href="../index.html">3.11.5 Documentation</a> »

</li>

<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Python Öğreticisi</a> »</li>

<li class="nav-item nav-item-this"><a href="">6. Modüller</a></li>

</form>

</div>

</li>

Theme

<option value="light">Light</option>

</select>

</label> |</li>

</ul>

</div>

<h1>6. Modüller<a class="headerlink" href="#modules" title="Permalink to this heading">¶</a></h1>

Python yorumlayıcısından çıkıp tekrar girerseniz, yaptığınız tanımlar (fonksiyonlar ve değişkenler) kaybolur. Bu nedenle, daha uzun bir program yazmak istiyorsanız, girdiyi yorumlayıcıya hazırlarken bir metin düzenleyicisi kullanmak ve o dosyayla girdi olarak çalıştırmak daha iyidir. Bu bir script oluşturma olarak bilinir. Programınız uzadıkça, daha kolay bakım için birkaç dosyaya bölmek isteyebilirsiniz. Ayrıca, tanımını her programa kopyalamadan, birkaç programda yazdığınız kullanışlı bir fonksiyonu kullanmak isteyebilirsiniz.

Bunu desteklemek için Python, tanımları bir dosyaya koymanın ve bunları bir komut dosyasında veya yorumlayıcının etkileşimli bir örneğinde kullanmanın bir yolunu sağlar. Böyle bir dosyaya module denir; bir modülden alınan tanımlar diğer modüllere veya main modülüne (en üst düzeyde ve hesap makinesi modunda yürütülen bir komut dosyasında erişiminiz olan değişkenlerin derlenmesi) aktarılabilir.

Modül, Python tanımlarını ve ifadelerini içeren bir dosyadır. Dosya adı, <code class="file docutils literal notranslate">.py</code> son ekini içeren modül adıdır. Bir modül içinde, modülün adı (dize olarak) <code class="docutils literal notranslate">__name__</code> genel değişkeninin değeri olarak kullanılabilir. Örneğin, geçerli dizinde aşağıdaki içeriklerle <code class="file docutils literal notranslate">fibo.py</code> adlı bir dosya oluşturmak için en sevdiğiniz metin düzenleyicisini kullanın:

<div class="highlight-python3 notranslate"><div class="highlight"><pre># Fibonacci numbers module

def fib(n): # write Fibonacci series up to n

a, b = 0, 1

while a < n:

print(a, end=' ')

a, b = b, a+b

print()

def fib2(n): # return Fibonacci series up to n

result = []

a, b = 0, 1

while a < n:

result.append(a)

return result

</pre></div>

</div>

Şimdi Python yorumlayıcısına girin ve bu modülü aşağıdaki komutla içe aktarın:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> import fibo

</pre></div>

</div>

Bu, <code class="docutils literal notranslate">fibo</code> ‘da tanımlanan işlevlerin adlarını doğrudan geçerli <a class="reference internal" href="../glossary.html#term-namespace">namespace</a> ‘e eklemez (daha fazla ayrıntı için bkz. <a class="reference internal" href="classes.html#tut-scopes">Python Etki Alanları ve Ad Alanları</a>); oraya sadece <code class="docutils literal notranslate">fibo</code> modül adını ekler. Modül adını kullanarak şu işlevlere erişebilirsiniz:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> fibo.fib(1000)

0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987

>>> fibo.fib2(100)

[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]

>>> fibo.__name__

'fibo'

</pre></div>

</div>

Bir işlevi sık sık kullanmayı düşünüyorsanız, işlevi yerel bir ada atayabilirsiniz:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> fib = fibo.fib

>>> fib(500)

0 1 1 2 3 5 8 13 21 34 55 89 144 233 377

</pre></div>

</div>

<h2>6.1. Modüller hakkında daha fazla<a class="headerlink" href="#more-on-modules" title="Permalink to this heading">¶</a></h2>

Bir modül, işlev tanımlarının yanı sıra çalıştırılabilir ifadeler de içerebilir. Bu ifadeler modülü başlatmayı amaçlamaktadır. Yalnızca bir import ifadesinde modül adıyla karşılaşıldığında ilk kez yürütülürler. <a class="footnote-reference brackets" href="#id3" id="id1" role="doc-noteref">[1]</a> (Dosya komut dosyası olarak yürütülürse de çalıştırılırlar.)

Her modülün, modülde tanımlanan tüm işlevler tarafından genel ad alanı olarak kullanılan kendi özel ad alanı vardır. Böylece, bir modülün yazarı, bir kullanıcının genel değişkenleriyle yanlışlıkla çakışma endişesi duymadan, modüldeki genel değişkenleri kullanabilir. Öte yandan, ne yaptığınızı biliyorsanız, bir modülün global değişkenlerine, işlevlerine atıfta bulunmak için kullanılan <code class="docutils literal notranslate">modname.itemname</code> notasyonuyla dokunabilirsiniz.

Modüller diğer modülleri içe aktarabilir. Tüm <a class="reference internal" href="../reference/simple_stmts.html#import"><code class="xref std std-keyword docutils literal notranslate">import</code></a> ifadelerinin bir modülün (veya bu konuda betiğin) başına yerleştirilmesi alışılmış bir durumdur ancak gerekli değildir. İçe aktarılan modül adları, bir modülün en üst düzeyine yerleştirilirse (herhangi bir işlev veya sınıfın dışında), modülün genel ad alanına eklenir.

<a class="reference internal" href="../reference/simple_stmts.html#import"><code class="xref std std-keyword docutils literal notranslate">import</code></a> ifadesinin, bir modülden adları doğrudan içe aktaran modülün ad alanına aktaran bir çeşidi vardır. Örneğin:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> from fibo import fib, fib2

>>> fib(500)

0 1 1 2 3 5 8 13 21 34 55 89 144 233 377

</pre></div>

</div>

Bu, içe aktarmaların yerel ad alanında alındığı modül adını tanıtmaz(bu nedenle örnekte <code class="docutils literal notranslate">fibo</code> tanımlanmamıştır).

Bir modülün tanımladığı tüm adları içe aktarmak için bir varyant bile vardır:

>>> fib(500)

0 1 1 2 3 5 8 13 21 34 55 89 144 233 377

</pre></div>

</div>

Bu, alt çizgiyle başlayanlar (<code class="docutils literal notranslate">_</code>) dışındaki tüm isimleri alır. Çoğu durumda Python programcıları bu özelliği kullanmaz, çünkü yorumlayıcıya bilinmeyen bir ad kümesi ekler ve muhtemelen önceden tanımladığınız bazı şeyleri gizler.

Genel olarak, bir modülden veya paketten <code class="docutils literal notranslate">*</code> içeri aktarma uygulamasının, genellikle okunamayan koda neden olduğundan hoş karşılanmadığına dikkat edin. Ancak, etkileşimli oturumlarda yazmayı kaydetmek için kullanmak sorun değildir.

Modül adının ardından <code class="xref std std-keyword docutils literal notranslate">as</code> geliyorsa, <code class="xref std std-keyword docutils literal notranslate">as</code> ‘den sonraki ad doğrudan içe aktarılan modüle bağlanır.

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> import fibo as fib

>>> fib.fib(500)

0 1 1 2 3 5 8 13 21 34 55 89 144 233 377

</pre></div>

</div>

Bu, modülün <code class="docutils literal notranslate">import fibo</code> ‘nun yapacağı şekilde etkin bir şekilde içe aktarılmasıdır, tek farkı <code class="docutils literal notranslate">fib</code> olarak mevcut olmasıdır.

Benzer efektlere sahip <a class="reference internal" href="../reference/simple_stmts.html#from"><code class="xref std std-keyword docutils literal notranslate">from</code></a> kullanılırken de kullanılabilir:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> from fibo import fib as fibonacci

>>> fibonacci(500)

0 1 1 2 3 5 8 13 21 34 55 89 144 233 377

</pre></div>

</div>

Not

Verimlilik nedeniyle, her modül yorumlayıcı oturumu başına yalnızca bir kez içe aktarılır. Bu nedenle, modüllerinizi değiştirirseniz, yorumlayıcıyı yeniden başlatmanız gerekir - veya etkileşimli olarak test etmek istediğiniz tek bir modülse, <a class="reference internal" href="../library/importlib.html#importlib.reload" title="importlib.reload"><code class="xref py py-func docutils literal notranslate">importlib.reload()</code></a>, örneğin <code class="docutils literal notranslate">importlib; importlib.reload(modulename)</code>.

</div>

<h3>6.1.1. Modülleri komut dosyası olarak yürütme<a class="headerlink" href="#executing-modules-as-scripts" title="Permalink to this heading">¶</a></h3>

Bir Python modülünü :: ile çalıştırdığınızda:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>python fibo.py <arguments>

</pre></div>

</div>

modüldeki kod, içe aktardığınız gibi yürütülür, ancak <code class="docutils literal notranslate">__name__</code> <code class="docutils literal notranslate">"__main__"</code> olarak ayarlanır. Bu, modülünüzün sonuna bu kodu ekleyerek:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>if __name__ == "__main__":

import sys

fib(int(sys.argv[1]))

</pre></div>

</div>

dosyayı bir komut dosyası ve içe aktarılabilir bir modül olarak kullanılabilir hale getirebilirsiniz, çünkü komut satırını ayrıştıran kod yalnızca modül “main” dosya olarak yürütülürse çalışır:

<div class="highlight-shell-session notranslate"><div class="highlight"><pre>$ python fibo.py 50

0 1 1 2 3 5 8 13 21 34

</pre></div>

</div>

Modül içe aktarılırsa kod çalıştırılmaz:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> import fibo

>>>

</pre></div>

</div>

Bu genellikle bir modüle uygun bir kullanıcı arabirimi sağlamak veya test amacıyla kullanılır (modülü komut dosyası olarak çalıştırmak bir test paketi yürütür).

</section>

<h3>6.1.2. Modül Arama Yolu<a class="headerlink" href="#the-module-search-path" title="Permalink to this heading">¶</a></h3>

When a module named <code class="xref py py-mod docutils literal notranslate">spam</code> is imported, the interpreter first searches for

a built-in module with that name. These module names are listed in

<a class="reference internal" href="../library/sys.html#sys.builtin_module_names" title="sys.builtin_module_names"><code class="xref py py-data docutils literal notranslate">sys.builtin_module_names</code></a>. If not found, it then searches for a file

named <code class="file docutils literal notranslate">spam.py</code> in a list of directories given by the variable

<a class="reference internal" href="../library/sys.html#sys.path" title="sys.path"><code class="xref py py-data docutils literal notranslate">sys.path</code></a>. <a class="reference internal" href="../library/sys.html#sys.path" title="sys.path"><code class="xref py py-data docutils literal notranslate">sys.path</code></a> is initialized from these locations:

<li>Girdi komut dosyasını içeren dizin (veya dosya belirtilmediğinde geçerli dizin).</li>

<li><a class="reference internal" href="../using/cmdline.html#envvar-PYTHONPATH"><code class="xref std std-envvar docutils literal notranslate">PYTHONPATH</code></a> (kabuk değişkeni <code class="xref std std-envvar docutils literal notranslate">PATH</code> ile aynı sözdizimine sahip dizin adlarının listesi).</li>

<li>Kuruluma bağlı varsayılan (kural olarak, <a class="reference internal" href="../library/site.html#module-site" title="site: Module responsible for site-specific configuration."><code class="xref py py-mod docutils literal notranslate">site</code></a> modülü tarafından işlenen bir “site-packages” dizini dahil).</li>

</ul>

Daha fazla ayrıntı <a class="reference internal" href="../library/sys_path_init.html#sys-path-init">The initialization of the sys.path module search path</a> adresindedir.

Not

Symlink’leri destekleyen dosya sistemlerinde, symlink izlendikten sonra girdi komut dosyasını içeren dizin hesaplanır. Başka bir deyişle, symlink içeren dizin modül arama yoluna not eklenir.

</div>

Başlatıldıktan sonra Python programları <a class="reference internal" href="../library/sys.html#sys.path" title="sys.path"><code class="xref py py-data docutils literal notranslate">sys.path</code></a> değiştirebilir. Çalıştırılmakta olan komut dosyasını içeren dizin, arama yolunun başına, standart kitaplık yolunun önüne yerleştirilir. Bu, kitaplık dizininde aynı ada sahip modüller yerine bu dizindeki komut dosyalarının yüklanacağı anlamına gelir. Değiştirme amaçlanmadığı sürece bu bir hatadır. Daha fazla bilgi için <a class="reference internal" href="#tut-standardmodules">Standart modüller</a> bölümüne bakın.

</section>

<h3>6.1.3. “Derlenmiş” Python dosyaları<a class="headerlink" href="#compiled-python-files" title="Permalink to this heading">¶</a></h3>

Modüllerin yüklenmesini hızlandırmak için Python, her modülün derlenmiş sürümünü <code class="docutils literal notranslate">__pycache__</code> dizininde <code class="file docutils literal notranslate">module.version.pyc</code> adı altında önbelleğe alır; burada sürüm, derlenen dosyanın biçimini kodlar; genellikle Python sürüm numarasını içerir. Örneğin, CPython 3.3 sürümünde spam.py’nin derlenmiş sürümü <code class="docutils literal notranslate">__pycache__/spam.cpython-33.pyc</code> olarak önbelleğe alınacaktır. Bu adlandırma kuralı, farklı sürümlerden ve Python’un farklı sürümlerinden derlenmiş modüllerin bir arada var olmasına izin verir.

Python, eski olup olmadığını ve yeniden derlenmesi gerekip gerekmediğini görmek için kaynağın değişiklik tarihini derlenmiş sürümle karşılaştırır. Bu tamamen otomatik bir işlemdir. Ayrıca, derlenen modüller platformdan bağımsızdır, bu nedenle aynı kitaplık farklı mimarilere sahip sistemler arasında paylaşılabilir.

Python iki durumda önbelleği kontrol etmez. İlk olarak, doğrudan komut satırından yüklenen modülün sonucunu her zaman yeniden derler ve saklamaz. İkincisi, kaynak modül yoksa önbelleği kontrol etmez. Kaynak olmayan (yalnızca derlenmiş) bir dağıtımı desteklemek için, derlenen modül kaynak dizinde olmalı ve bir kaynak modül olmamalıdır.

Uzmanlar için bazı ipuçları:

<li>Derlenmiş bir modülün boyutunu küçültmek için Python komutundaki <a class="reference internal" href="../using/cmdline.html#cmdoption-O"><code class="xref std std-option docutils literal notranslate">-O</code></a> veya <a class="reference internal" href="../using/cmdline.html#cmdoption-OO"><code class="xref std std-option docutils literal notranslate">-OO</code></a> anahtarlarını kullanabilirsiniz. <code class="docutils literal notranslate">-O</code> anahtarı, onaylama ifadelerini kaldırır, <code class="docutils literal notranslate">-OO</code> anahtarı, hem assert ifadelerini hem de __doc__ dizelerini kaldırır. Bazı programlar bunların kullanılabilir olmasına güvenebileceğinden, bu seçeneği yalnızca ne yaptığınızı biliyorsanız kullanmalısınız. “Optimize edilmiş” modüller bir “opt-” etiketine sahiptir ve genellikle daha küçüktür. Gelecekteki sürümler, optimizasyonun etkilerini değiştirebilir.</li>

<li>Bir program <code class="docutils literal notranslate">.pyc</code> dosyasından okunduğunda, <code class="docutils literal notranslate">.py</code> dosyasından okunduğundan daha hızlı çalışmaz; <code class="docutils literal notranslate">.pyc</code> dosyaları hakkında daha hızlı olan tek şey, yüklenme hızlarıdır.</li>

<li><a class="reference internal" href="../library/compileall.html#module-compileall" title="compileall: Tools for byte-compiling all Python source files in a directory tree."><code class="xref py py-mod docutils literal notranslate">compileall</code></a> modülü, bir dizindeki tüm modüller için .pyc dosyaları oluşturabilir.</li>

<li><a class="pep reference external" href="https://peps.python.org/pep-3147/">PEP 3147</a> ‘de, kararların bir akış şeması da dahil olmak üzere, bu süreç hakkında daha fazla ayrıntı bulunmaktadır.</li>

</ul>

</section>

<h2>6.2. Standart modüller<a class="headerlink" href="#standard-modules" title="Permalink to this heading">¶</a></h2>

Python, ayrı bir belge olan Python Kütüphanesi Referansında (bundan sonra “Kütüphane Referansı”) açıklanan standart modüllerden oluşan bir kütüphane ile birlikte gelir. Bazı modüller yorumlayıcıya yerleştirilmiştir; bunlar, dilin çekirdeğinin bir parçası olmayan, ancak yine de verimlilik için veya sistem çağrıları gibi işletim sistemi ilkellerine erişim sağlamak için yerleşik olan işlemlere erişim sağlar. Bu tür modüller seti, aynı zamanda temel platforma da bağlı olan bir yapılandırma seçeneğidir. Örneğin, <a class="reference internal" href="../library/winreg.html#module-winreg" title="winreg: Routines and objects for manipulating the Windows registry. (Windows)"><code class="xref py py-mod docutils literal notranslate">winreg</code></a> modülü yalnızca Windows sistemlerinde sağlanır. Belirli bir modül biraz ilgiyi hak ediyor: Her Python yorumlayıcısında yerleşik olan <a class="reference internal" href="../library/sys.html#module-sys" title="sys: Access system-specific parameters and functions."><code class="xref py py-mod docutils literal notranslate">sys</code></a>. <code class="docutils literal notranslate">sys.ps1</code> ve <code class="docutils literal notranslate">sys.ps2</code> değişkenleri, birincil ve ikincil bilgi istemleri olarak kullanılan dizeleri tanımlar:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> import sys

>>> sys.ps1

'>>> '

>>> sys.ps2

'... '

>>> sys.ps1 = 'C> '

C> print('Yuck!')

Yuck!

C>

</pre></div>

</div>

Bu iki değişken yalnızca yorumlayıcı etkileşimli moddaysa tanımlanır.

<code class="docutils literal notranslate">sys.path</code> değişkeni, yorumlayıcının modüller için arama yolunu belirleyen bir dizeler listesidir. <a class="reference internal" href="../using/cmdline.html#envvar-PYTHONPATH"><code class="xref std std-envvar docutils literal notranslate">PYTHONPATH</code></a> ortam değişkeninden veya <a class="reference internal" href="../using/cmdline.html#envvar-PYTHONPATH"><code class="xref std std-envvar docutils literal notranslate">PYTHONPATH</code></a> ayarlanmamışsa yerleşik bir varsayılan değerden alınan varsayılan bir yola başlatılır. Standart liste işlemlerini kullanarak değiştirebilirsiniz:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> import sys

>>> sys.path.append('/ufs/guido/lib/python')

</pre></div>

</div>

</section>

<h2>6.3. <a class="reference internal" href="../library/functions.html#dir" title="dir"><code class="xref py py-func docutils literal notranslate">dir()</code></a> Fonksiyonu<a class="headerlink" href="#the-dir-function" title="Permalink to this heading">¶</a></h2>

Yerleşik fonksiyon <a class="reference internal" href="../library/functions.html#dir" title="dir"><code class="xref py py-func docutils literal notranslate">dir()</code></a>, bir modülün hangi adları tanımladığını bulmak için kullanılır. Sıralanmış bir dize listesi döndürür:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> import fibo, sys

>>> dir(fibo)

['__name__', 'fib', 'fib2']

>>> dir(sys)

['__breakpointhook__', '__displayhook__', '__doc__', '__excepthook__',

'__interactivehook__', '__loader__', '__name__', '__package__', '__spec__',

'__stderr__', '__stdin__', '__stdout__', '__unraisablehook__',

'_clear_type_cache', '_current_frames', '_debugmallocstats', '_framework',

'_getframe', '_git', '_home', '_xoptions', 'abiflags', 'addaudithook',

'api_version', 'argv', 'audit', 'base_exec_prefix', 'base_prefix',

'breakpointhook', 'builtin_module_names', 'byteorder', 'call_tracing',

'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', 'exc_info',

'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info',

'float_repr_style', 'get_asyncgen_hooks', 'get_coroutine_origin_tracking_depth',

'getallocatedblocks', 'getdefaultencoding', 'getdlopenflags',

'getfilesystemencodeerrors', 'getfilesystemencoding', 'getprofile',

'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval',

'gettrace', 'hash_info', 'hexversion', 'implementation', 'int_info',

'intern', 'is_finalizing', 'last_traceback', 'last_type', 'last_value',

'maxsize', 'maxunicode', 'meta_path', 'modules', 'path', 'path_hooks',

'path_importer_cache', 'platform', 'prefix', 'ps1', 'ps2', 'pycache_prefix',

'set_asyncgen_hooks', 'set_coroutine_origin_tracking_depth', 'setdlopenflags',

'setprofile', 'setrecursionlimit', 'setswitchinterval', 'settrace', 'stderr',

'stdin', 'stdout', 'thread_info', 'unraisablehook', 'version', 'version_info',

'warnoptions']

</pre></div>

</div>

Argümanlar olmadan, <a class="reference internal" href="../library/functions.html#dir" title="dir"><code class="xref py py-func docutils literal notranslate">dir()</code></a>, şu anda tanımladığınız adları listeler:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> a = [1, 2, 3, 4, 5]

>>> import fibo

>>> fib = fibo.fib

>>> dir()

['__builtins__', '__name__', 'a', 'fib', 'fibo', 'sys']

</pre></div>

</div>

Her tür adın listelendiğini unutmayın: değişkenler, modüller, fonksiyonlar vb.

<a class="reference internal" href="../library/functions.html#dir" title="dir"><code class="xref py py-func docutils literal notranslate">dir()</code></a> yerleşik fonksiyonlarun ve değişkenlerin adlarını listelemez. Bunların bir listesini istiyorsanız, standart modül <a class="reference internal" href="../library/builtins.html#module-builtins" title="builtins: The module that provides the built-in namespace."><code class="xref py py-mod docutils literal notranslate">builtins</code></a> ‘de tanımlanırlar:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> import builtins

>>> dir(builtins)

['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException',

'BlockingIOError', 'BrokenPipeError', 'BufferError', 'BytesWarning',

'ChildProcessError', 'ConnectionAbortedError', 'ConnectionError',

'ConnectionRefusedError', 'ConnectionResetError', 'DeprecationWarning',

'EOFError', 'Ellipsis', 'EnvironmentError', 'Exception', 'False',

'FileExistsError', 'FileNotFoundError', 'FloatingPointError',

'FutureWarning', 'GeneratorExit', 'IOError', 'ImportError',

'ImportWarning', 'IndentationError', 'IndexError', 'InterruptedError',

'IsADirectoryError', 'KeyError', 'KeyboardInterrupt', 'LookupError',

'MemoryError', 'NameError', 'None', 'NotADirectoryError', 'NotImplemented',

'NotImplementedError', 'OSError', 'OverflowError',

'PendingDeprecationWarning', 'PermissionError', 'ProcessLookupError',

'ReferenceError', 'ResourceWarning', 'RuntimeError', 'RuntimeWarning',

'StopIteration', 'SyntaxError', 'SyntaxWarning', 'SystemError',

'SystemExit', 'TabError', 'TimeoutError', 'True', 'TypeError',

'UnboundLocalError', 'UnicodeDecodeError', 'UnicodeEncodeError',

'UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserWarning',

'ValueError', 'Warning', 'ZeroDivisionError', '_', '__build_class__',

'__debug__', '__doc__', '__import__', '__name__', '__package__', 'abs',

'all', 'any', 'ascii', 'bin', 'bool', 'bytearray', 'bytes', 'callable',

'chr', 'classmethod', 'compile', 'complex', 'copyright', 'credits',

'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval', 'exec', 'exit',

'filter', 'float', 'format', 'frozenset', 'getattr', 'globals', 'hasattr',

'hash', 'help', 'hex', 'id', 'input', 'int', 'isinstance', 'issubclass',

'iter', 'len', 'license', 'list', 'locals', 'map', 'max', 'memoryview',

'min', 'next', 'object', 'oct', 'open', 'ord', 'pow', 'print', 'property',

'quit', 'range', 'repr', 'reversed', 'round', 'set', 'setattr', 'slice',

'sorted', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type', 'vars',

'zip']

</pre></div>

</div>

</section>

<h2>6.4. Paketler<a class="headerlink" href="#packages" title="Permalink to this heading">¶</a></h2>

Packages are a way of structuring Python’s module namespace by using “dotted

module names”. For example, the module name <code class="xref py py-mod docutils literal notranslate">A.B</code> designates a submodule

named <code class="docutils literal notranslate">B</code> in a package named <code class="docutils literal notranslate">A</code>. 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.

Ses dosyalarının ve ses verilerinin tek tip işlenmesi için bir modül koleksiyonu (“paket”) tasarlamak istediğinizi varsayalım. Birçok farklı ses dosyası biçimi vardır (genellikle uzantılarıyla tanınır, örneğin: <code class="file docutils literal notranslate">.wav</code>, <code class="file docutils literal notranslate">.aiff</code>, <code class="file docutils literal notranslate">.au</code>) bu nedenle, çeşitli dosya biçimleri arasında dönüşüm için büyüyen bir modül koleksiyonu oluşturmanız ve sürdürmeniz gerekebilir. Ses verileri üzerinde gerçekleştirmek isteyebileceğiniz birçok farklı işlem de vardır (karıştırma, eko ekleme, ekolayzır işlevi uygulama, yapay bir stereo efekti oluşturma gibi) bu nedenle ek olarak, bu işlemleri gerçekleştirmek için hiç bitmeyen bir modül akışı yazıyor olacaksınız. İşte paketiniz için olası bir yapı (hiyerarşik bir dosya sistemi cinsinden ifade edilir):

<div class="highlight-text notranslate"><div class="highlight"><pre>sound/ Top-level package

__init__.py Initialize the sound package

formats/ Subpackage for file format conversions

__init__.py

wavread.py

wavwrite.py

aiffread.py

aiffwrite.py

auread.py

auwrite.py

...

effects/ Subpackage for sound effects

__init__.py

echo.py

surround.py

reverse.py

...

filters/ Subpackage for filters

__init__.py

equalizer.py

vocoder.py

karaoke.py

...

</pre></div>

</div>

Paketi içe aktarırken Python, paket alt dizinini arayan <code class="docutils literal notranslate">sys.path</code> üzerindeki dizinleri arar.

The <code class="file docutils literal notranslate">__init__.py</code> files are required to make Python treat directories

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

such as <code class="docutils literal notranslate">string</code>, from unintentionally hiding valid modules that occur later

on the module search path. In the simplest case, <code class="file docutils literal notranslate">__init__.py</code> can just be

an empty file, but it can also execute initialization code for the package or

set the <code class="docutils literal notranslate">__all__</code> variable, described later.

Paketin kullanıcıları, paketin içindeki ayrı modülleri içe aktarabilir, örneğin:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>import sound.effects.echo

</pre></div>

</div>

This loads the submodule <code class="xref py py-mod docutils literal notranslate">sound.effects.echo</code>. It must be referenced with

its full name.

<div class="highlight-python3 notranslate"><div class="highlight"><pre>sound.effects.echo.echofilter(input, output, delay=0.7, atten=4)

</pre></div>

</div>

Alt modülü içe aktarmanın alternatif bir yolu:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>from sound.effects import echo

</pre></div>

</div>

This also loads the submodule <code class="xref py py-mod docutils literal notranslate">echo</code>, and makes it available without its

package prefix, so it can be used as follows:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>echo.echofilter(input, output, delay=0.7, atten=4)

</pre></div>

</div>

Yine başka bir varyasyon, istenen işlevi veya değişkeni doğrudan içe aktarmaktır:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>from sound.effects.echo import echofilter

</pre></div>

</div>

Again, this loads the submodule <code class="xref py py-mod docutils literal notranslate">echo</code>, but this makes its function

<code class="xref py py-func docutils literal notranslate">echofilter()</code> directly available:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>echofilter(input, output, delay=0.7, atten=4)

</pre></div>

</div>

<code class="docutils literal notranslate">from package import item</code> kullanırken, öğenin paketin bir alt modülü (veya alt paketi) veya pakette tanımlanmış bir fonksiyon, sınıf veya değişken gibi başka bir ad olabileceğini unutmayın. <code class="docutils literal notranslate">import</code> ifadesi önce öğenin pakette tanımlanıp tanımlanmadığını test eder; değilse modül olduğunu varsayar ve yüklemeye çalışır. Onu bulamazsa, bir <a class="reference internal" href="../library/exceptions.html#ImportError" title="ImportError"><code class="xref py py-exc docutils literal notranslate">ImportError</code></a> istisnası ortaya çıkar.

Aksine, <code class="docutils literal notranslate">import item.subitem.subsubitem</code> gibi bir sözdizimi kullanırken, sonuncusu hariç her öğe bir paket olmalıdır; son öğe bir modül veya paket olabilir, ancak önceki öğede tanımlanan bir sınıf, fonksiyon veya değişken olamaz.

<h3>6.4.1. Bir Paketten * İçe Aktarma<a class="headerlink" href="#importing-from-a-package" title="Permalink to this heading">¶</a></h3>

Şimdi, kullanıcı <code class="docutils literal notranslate">from sound.effects import *</code> yazdığında ne olur? İdeal olarak, bunun bir şekilde dosya sistemine gitmesi, pakette hangi alt modüllerin bulunduğunu bulması ve hepsini içe aktarması umulur. Bu uzun zaman alabilir ve alt modüllerin içe aktarılması, yalnızca alt modül açıkça içe aktarıldığında gerçekleşmesi gereken istenmeyen yan etkilere neden olabilir.

Tek çözüm, paket yazarının paketin açık bir dizinini sağlamasıdır. <a class="reference internal" href="../reference/simple_stmts.html#import"><code class="xref std std-keyword docutils literal notranslate">import</code></a> ifadesi aşağıdaki kuralı kullanır: eğer bir paketin <code class="file docutils literal notranslate">__init__.py</code> kodu <code class="docutils literal notranslate">__all__</code> adlı bir liste tanımlarsa, <code class="docutils literal notranslate">from package import *</code> ile karşılaşıldığında alınması gereken modül adlarının listesi olarak alınır. Paketin yeni bir sürümü yayınlandığında bu listeyi güncel tutmak paket yazarının sorumluluğundadır. Paket yazarları, paketlerinden * içe aktarmak için bir kullanım görmezlerse, onu desteklememeye de karar verebilirler. Örneğin, <code class="file docutils literal notranslate">sound/effects/__init__.py</code> dosyası şu kodu içerebilir:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>__all__ = ["echo", "surround", "reverse"]

</pre></div>

</div>

This would mean that <code class="docutils literal notranslate">from sound.effects import *</code> would import the three

named submodules of the <code class="xref py py-mod docutils literal notranslate">sound.effects</code> package.

Be aware that submodules might become shadowed by locally defined names. For

example, if you added a <code class="docutils literal notranslate">reverse</code> function to the

<code class="file docutils literal notranslate">sound/effects/__init__.py</code> file, the <code class="docutils literal notranslate">from sound.effects import *</code>

would only import the two submodules <code class="docutils literal notranslate">echo</code> and <code class="docutils literal notranslate">surround</code>, but not the

<code class="docutils literal notranslate">reverse</code> submodule, because it is shadowed by the locally defined

<code class="docutils literal notranslate">reverse</code> function:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>__all__ = [

"echo", # refers to the 'echo.py' file

"surround", # refers to the 'surround.py' file

"reverse", # !!! refers to the 'reverse' function now !!!

]

def reverse(msg: str): # <-- this name shadows the 'reverse.py' submodule

return msg[::-1] # in the case of a 'from sound.effects import *'

</pre></div>

</div>

If <code class="docutils literal notranslate">__all__</code> is not defined, the statement <code class="docutils literal notranslate">from sound.effects import *</code>

does not import all submodules from the package <code class="xref py py-mod docutils literal notranslate">sound.effects</code> into the

current namespace; it only ensures that the package <code class="xref py py-mod docutils literal notranslate">sound.effects</code> has

been imported (possibly running any initialization code in <code class="file docutils literal notranslate">__init__.py</code>)

and then imports whatever names are defined in the package. This includes any

names defined (and submodules explicitly loaded) by <code class="file docutils literal notranslate">__init__.py</code>. It

also includes any submodules of the package that were explicitly loaded by

previous <a class="reference internal" href="../reference/simple_stmts.html#import"><code class="xref std std-keyword docutils literal notranslate">import</code></a> statements. Consider this code:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>import sound.effects.echo

import sound.effects.surround

from sound.effects import *

</pre></div>

</div>

In this example, the <code class="xref py py-mod docutils literal notranslate">echo</code> and <code class="xref py py-mod docutils literal notranslate">surround</code> modules are imported in the

current namespace because they are defined in the <code class="xref py py-mod docutils literal notranslate">sound.effects</code> package

when the <code class="docutils literal notranslate">from...import</code> statement is executed. (This also works when

<code class="docutils literal notranslate">__all__</code> is defined.)

Bazı modüller, <code class="docutils literal notranslate">import *</code> kullandığınızda yalnızca belirli kalıpları takip eden adları dışa aktarmak üzere tasarlanmış olsa da, üretim kodunda yine de kötü uygulama olarak kabul edilir.

Unutmayın, <code class="docutils literal notranslate">from package import specific_submodule</code> kullanmanın yanlış bir tarafı yok! Aslında, içe aktarma modülünün farklı paketlerden aynı ada sahip alt modülleri kullanması gerekmedikçe, önerilen gösterim budur.

</section>

<h3>6.4.2. Paket İçi Referanslar<a class="headerlink" href="#intra-package-references" title="Permalink to this heading">¶</a></h3>

When packages are structured into subpackages (as with the <code class="xref py py-mod docutils literal notranslate">sound</code> package

in the example), you can use absolute imports to refer to submodules of siblings

packages. For example, if the module <code class="xref py py-mod docutils literal notranslate">sound.filters.vocoder</code> needs to use

the <code class="xref py py-mod docutils literal notranslate">echo</code> module in the <code class="xref py py-mod docutils literal notranslate">sound.effects</code> package, it can use <code class="docutils literal notranslate">from

sound.effects import echo</code>.

You can also write relative imports, with the <code class="docutils literal notranslate">from module import name</code> form

of import statement. These imports use leading dots to indicate the current and

parent packages involved in the relative import. From the <code class="xref py py-mod docutils literal notranslate">surround</code>

module for example, you might use:

<div class="highlight-python3 notranslate"><div class="highlight"><pre>from . import echo

from .. import formats

from ..filters import equalizer

</pre></div>

</div>

Göreceli içe aktarmaların geçerli modülün adını temel aldığını unutmayın. Ana modülün adı her zaman <code class="docutils literal notranslate">"__main__"</code> olduğundan, Python uygulamasının ana modülü olarak kullanılması amaçlanan modüller her zaman mutlak içe aktarma kullanmalıdır.

</section>

<h3>6.4.3. Birden Çok Dizindeki Paketler<a class="headerlink" href="#packages-in-multiple-directories" title="Permalink to this heading">¶</a></h3>

Paketler bir özel özelliği daha destekler, <a class="reference internal" href="../reference/import.html#path__" title="__path__"><code class="xref py py-attr docutils literal notranslate">__path__</code></a>. Bu, o dosyadaki kod yürütülmeden önce paketin <code class="file docutils literal notranslate">__init__.py</code> dosyasını tutan dizinin adını içeren bir liste olacak şekilde başlatılır. Bu değişken değiştirilebilir; bunu yapmak, pakette bulunan modüller ve alt paketler için gelecekteki aramaları etkiler.

Bu özelliğe sıklıkla ihtiyaç duyulmasa da, bir pakette bulunan modül dizisini genişletmek için kullanılabilir.

Dipnotlar

[<a role="doc-backlink" href="#id1">1</a>]

Aslında işlev tanımları aynı zamanda ‘çalıştırılan’ ‘ifadelerdir’; modül düzeyinde bir işlev tanımının çalıştırılması, işlev adını modülün genel ad alanına ekler.

</aside>

</section>

</div>

<div>

<h3><a href="../contents.html">İçindekiler</a></h3>

<ul>

<li><a class="reference internal" href="#">6. Modüller</a><ul>

<li><a class="reference internal" href="#more-on-modules">6.1. Modüller hakkında daha fazla</a><ul>

<li><a class="reference internal" href="#executing-modules-as-scripts">6.1.1. Modülleri komut dosyası olarak yürütme</a></li>

<li><a class="reference internal" href="#the-module-search-path">6.1.2. Modül Arama Yolu</a></li>

<li><a class="reference internal" href="#compiled-python-files">6.1.3. “Derlenmiş” Python dosyaları</a></li>

</ul>

</li>

<li><a class="reference internal" href="#standard-modules">6.2. Standart modüller</a></li>

<li><a class="reference internal" href="#the-dir-function">6.3. <code class="xref py py-func docutils literal notranslate">dir()</code> Fonksiyonu</a></li>

<li><a class="reference internal" href="#packages">6.4. Paketler</a><ul>

<li><a class="reference internal" href="#importing-from-a-package">6.4.1. Bir Paketten * İçe Aktarma</a></li>

<li><a class="reference internal" href="#intra-package-references">6.4.2. Paket İçi Referanslar</a></li>

<li><a class="reference internal" href="#packages-in-multiple-directories">6.4.3. Birden Çok Dizindeki Paketler</a></li>

</ul>

</li>

</ul>

</li>

</ul>

</div>

<div>

<h4>Önceki konu</h4>

<a href="datastructures.html"

title="önceki bölüm">5. Veri Yapıları</a>

</div>

<div>

<h4>Sonraki konu</h4>

<a href="inputoutput.html"

title="sonraki bölüm">7. Girdi ve Çıktı</a>

</div>

<h3>Bu Sayfa</h3>

<li><a href="../bugs.html">Hata Bildir</a></li>

<li>

<a href="https://github.com/python/cpython/blob/3.11/Doc/tutorial/modules.rst"

rel="nofollow">Kaynağı Göster

</a>

</li>

</ul>

</div>

«

</div>

</div>

<h3>Gezinti</h3>

<ul>

<a href="../genindex.html" title="Genel Endeks"

>dizin</a></li>

<a href="../py-modindex.html" title="Python Modül Dizini"

>modülleri</a> |</li>

<a href="inputoutput.html" title="7. Girdi ve Çıktı"

>sonraki</a> |</li>

<a href="datastructures.html" title="5. Veri Yapıları"

>önceki</a> |</li>

<li><a href="https://www.python.org/">Python</a> »</li>

</li>

<li>

</li>

<a href="../index.html">3.11.5 Documentation</a> »

</li>

<li class="nav-item nav-item-1"><a href="index.html" >Python Öğreticisi</a> »</li>

<li class="nav-item nav-item-this"><a href="">6. Modüller</a></li>

</form>

</div>

</li>

Theme

<option value="light">Light</option>

</select>

</label> |</li>

</ul>

</div>

This page is licensed under the Python Software Foundation License Version 2.

Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.

See <a href="/license.html">History and License</a> for more information.

The Python Software Foundation is a non-profit corporation.

<a href="https://www.python.org/psf/donations/">Please donate.</a>

Son güncelleme: Ara 01, 2023.

<a href="/bugs.html">Found a bug</a>?

Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 6.2.1.

</div>

</body>

</html>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

FilesExpand file tree

modules.html

Latest commit

History

modules.html

File metadata and controls