Skip to content

Commit 25821d4

Browse files
befelemehroncok
andauthored
Apply suggestions from code review
Co-authored-by: Miro Hrončok <[email protected]>
1 parent 9453450 commit 25821d4

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

lessons/intro/distribution/index.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ Anglické pojmy v závorce jsou převzaty z oficiálního [glosáře](https://pa
3737
* **balíček** (_Distribution Package_) je instalovatelný archiv obsahující
3838
_importovatelné moduly_ pro Python a další potřebné soubory, může být i rozbalený;
3939
* **zdrojový balíček** (_Source Distribution_, `sdist`) je varianta zabaleného _balíčku_ ve zdrojové formě;
40-
* **binární balíček** (_Binary Distribution_, `bdist`, `wheel`) je varianta zabaleného _balíčku_ v nezdrojové (např. zkompilované) formě;
40+
* **binární balíček** (_Binary Distribution_, `bdist`) je varianta zabaleného _balíčku_ v nezdrojové (např. zkompilované) formě, nejčastější podoba toho balíčku se jmenuje `wheel`;
4141
* **projekt** (_Project_) je knihovna, framework, skript, plugin, aplikace apod. (či jejich kombinace), které balíme do _balíčků_.
4242

4343

@@ -46,11 +46,12 @@ pyproject.toml
4646
--------------
4747

4848
Základním stavebním kamenem Python balíčku je soubor `pyproject.toml`, který
49-
obsahuje všechna potřebná metadata pro vytvoření zdrojového a binárního balíčku.
50-
TOML je datový formát, který se dobře píše člověkem a čte počítačem.
51-
Jehož plnou specifikaci můžete najít v oficiální [dokumentaci](https://toml.io/en/).
49+
obsahuje všechna potřebná metadata pro vytvoření zdrojového i binárního balíčku.
50+
Soubor používá jazyk TOML, což je datový formát, který se dobře píše člověkem a čte počítačem.
51+
Plnou specifikaci TOMLu můžete najít v oficiální [dokumentaci tohoto jazyka](https://toml.io/en/).
5252

53-
Pojďme vytvořit jeho minimální variantu. Použijeme balíček `setuptools` jako tzv. _build backend_,
53+
Pojďme vytvořit minimální variantu souboru `pyproject.toml`.
54+
Použijeme balíček `setuptools` jako tzv. _build backend_,
5455
tedy program, který náš balíček vytvoří. Existují také jiné _build backendy_ s jinými vlastnostmi -
5556
jaké to jsou a jak je použít, se dozvíte z oficiálního [tutoriálu, jak tvořit Python balíčky](https://packaging.python.org/en/latest/tutorials/packaging-projects/).
5657

@@ -131,8 +132,8 @@ Můžete je rozbalit pomocí systémových nástrojů a podívat se dovnitř.
131132

132133
> [note]
133134
> `whl` je ve skutečnosti stejný formát jako `zip`,
134-
> takže pokud vaše systémové nástroje ho neumí detekovat,
135-
> stačí přejmenovat rozšíření souboru na `.zip`.
135+
> takže pokud ho vaše systémové nástroje neumí otevřít,
136+
> stačí před otevřením změnit příponu souboru na `.zip`.
136137
137138
Můžete také vytvořit pouze zdrojový nebo pouze binární balíček pomocí přepínačů `--sdist`, resp. `--wheel`.
138139

@@ -252,7 +253,7 @@ Vytvoříme modul ve formě složky. V našem případě soubor
252253
Soubor `__init__.py` jednak značí, že adresář `isholiday` je importovatelný modul,
253254
a také obsahuje kód, který se spustí při importu modulu `isholiday`.
254255

255-
`build` bude této změně automaticky rozumět, což si můžete vyzkoušet vytvořením a prozkoumáním balíčku.
256+
`setuptools` bude této změně automaticky rozumět, což si můžete vyzkoušet vytvořením a prozkoumáním balíčku.
256257

257258
Momentálně máme všechen kód přímo v `__init__.py`, což sice funguje,
258259
ale ideální to není. Dobré je mít kód v samostatných souborech a v `__init__.py`
@@ -525,7 +526,7 @@ Wheel: Binární balíčky
525526
----------------------
526527

527528
Zatím jsme se zabývali jen zdrojovými balíčky (`sdist`).
528-
Existují ale i balíčky „zkompilované” – binární (`wheel`).
529+
Existují ale i balíčky „zkompilované” – binární (`bdist`, nejčastěji `wheel`).
529530
Když se instaluje zdrojový balíček, pip prvně vytvoří `wheel`, a následně ho rozbalí
530531
na patříčné místo. Binární balíček se už jen rozbalí.
531532

0 commit comments

Comments
 (0)