Skip to content

Commit 24d22d9

Browse files
committed
Update the instructions about registering on PyPI
As the process is complicated and complex, and will definitely take a lot of time, it seems more appropriate and less error-prone to only go through this on the test PyPI instance. The students can get back to the materials to learn how to update their configurations for the real PyPI; it's just skipped in the main lesson body.
1 parent 74c4273 commit 24d22d9

File tree

1 file changed

+34
-16
lines changed

1 file changed

+34
-16
lines changed

lessons/intro/distribution/index.md

Lines changed: 34 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -401,28 +401,25 @@ Balíček jde zaregistrovat a nahrát na PyPI. Použijeme pro to program `twine`
401401
(instalovatelný přes pip).
402402

403403
Budete si potřebovat zařídit
404-
[účet na PyPI](https://pypi.org/account/register/),
405-
[účet na testovací PyPI](https://test.pypi.org/account/register/)
406-
a vytvořit konfigurační soubor `~/.pypirc`:
404+
[účet na testovací PyPI](https://test.pypi.org/account/register/).
405+
Od roku 2023 proces registrace zahrnuje nastavení dvoufaktorové autentikace
406+
pro práci s PyPI.
407+
Budete pro to potřebovat TOTP aplikaci - pokud jste ji zatím nepoužívali,
408+
podívejte se na [doporučení od administrátorů PyPI](https://pypi.org/help/#totp).
409+
Poté, co si nastavíte dvoufaktorový přístup na účet, budete moci vytvořit API
410+
token pro nahrávání balíčků.
411+
Vytvořte nový token a vložte jeho hodnotu do konfiguračního souboru `~/.pypirc`:
407412

408413
```ini
409414
[distutils]
410415
index-servers=
411-
pypi
412416
testpypi
413417

414-
[pypi]
415-
username = <your user name goes here>
416-
password = <your password goes here>
417-
418418
[testpypi]
419-
repository = https://test.pypi.org/legacy/
420-
username = <your user name goes here>
421-
password = <your password goes here>
419+
username = __token__
420+
password = <TestPyPI token>
422421
```
423422

424-
Hesla můžete vynechat, pokud je budete chtít pokaždé zadávat.
425-
426423
Používáte-li Windows, je potřeba nastavit proměnnou prostředí `HOME` na adresář
427424
se souborem `.pypirc`, např:
428425

@@ -448,9 +445,30 @@ než ta, co už na PyPI je. Nejde tedy jednou nahraný balíček přepsat.
448445

449446
Svůj balíček najdete na `https://test.pypi.org/project/<název_balíčku>/`.
450447

451-
Pro nahrání na opravdovou PyPI stačí vynechat `-r testpypi`.
452-
Zabírat jména na opravdové PyPI jen tak není hezké vůči ostatním Pythonistům;
453-
registrujte tedy prosím jen balíčky, které budou nějak pro ostatní užitečné.
448+
> [note]
449+
> Až budete chtít nahrávat opravdové balíčky na PyPI, vytvořte si
450+
> [účet na PyPI](https://pypi.org/account/register/).
451+
> Všechny kroky budou třeba provést znovu, včetně nastavení
452+
> dvoufaktorové autentikace a vygenerování nového tokenu.
453+
> Pak aktualizujte konfigurační soubor `~/.pypirc`:
454+
>
455+
> ```ini
456+
> [distutils]
457+
> index-servers=
458+
> pypi
459+
> testpypi
460+
>
461+
> [pypi]
462+
> username = __token__
463+
> password = <PyPI token>
464+
>
465+
> [testpypi]
466+
> username = __token__
467+
> password = <TestPyPI token>
468+
> ```
469+
> Pro nahrání na opravdovou PyPI stačí vynechat `-r testpypi`.
470+
> Zabírat jména na opravdové PyPI jen tak není hezké vůči ostatním Pythonistům;
471+
> registrujte tedy prosím jen balíčky, které budou nějak pro ostatní užitečné.
454472
455473
456474
Instalace pomocí pip

0 commit comments

Comments
 (0)