You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: lessons/intro/distribution/index.md
+10-9Lines changed: 10 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,7 +37,7 @@ Anglické pojmy v závorce jsou převzaty z oficiálního [glosáře](https://pa
37
37
***balíček** (_Distribution Package_) je instalovatelný archiv obsahující
38
38
_importovatelné moduly_ pro Python a další potřebné soubory, může být i rozbalený;
39
39
***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`;
41
41
***projekt** (_Project_) je knihovna, framework, skript, plugin, aplikace apod. (či jejich kombinace), které balíme do _balíčků_.
42
42
43
43
@@ -46,11 +46,12 @@ pyproject.toml
46
46
--------------
47
47
48
48
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/).
52
52
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_,
54
55
tedy program, který náš balíček vytvoří. Existují také jiné _build backendy_ s jinými vlastnostmi -
55
56
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/).
56
57
@@ -131,8 +132,8 @@ Můžete je rozbalit pomocí systémových nástrojů a podívat se dovnitř.
131
132
132
133
> [note]
133
134
> `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`.
136
137
137
138
Můžete také vytvořit pouze zdrojový nebo pouze binární balíček pomocí přepínačů `--sdist`, resp. `--wheel`.
138
139
@@ -252,7 +253,7 @@ Vytvoříme modul ve formě složky. V našem případě soubor
252
253
Soubor `__init__.py` jednak značí, že adresář `isholiday` je importovatelný modul,
253
254
a také obsahuje kód, který se spustí při importu modulu `isholiday`.
254
255
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.
256
257
257
258
Momentálně máme všechen kód přímo v `__init__.py`, což sice funguje,
258
259
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
525
526
----------------------
526
527
527
528
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`).
529
530
Když se instaluje zdrojový balíček, pip prvně vytvoří `wheel`, a následně ho rozbalí
530
531
na patříčné místo. Binární balíček se už jen rozbalí.
0 commit comments