https://github.com/pyfunc/free-on-pypi
sprawdza wszystkie dwuliterowe kombinacje nazw na PyPI z opóźnieniem 100 ms między zapytaniami, aby uniknąć przeciążenia sieci lub limitów:
https://github.com/pyfunc/free-on-pypi
Last synced: 9 months ago
JSON representation
sprawdza wszystkie dwuliterowe kombinacje nazw na PyPI z opóźnieniem 100 ms między zapytaniami, aby uniknąć przeciążenia sieci lub limitów:
- Host: GitHub
- URL: https://github.com/pyfunc/free-on-pypi
- Owner: pyfunc
- License: apache-2.0
- Created: 2025-06-21T14:00:42.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-06-21T17:07:32.000Z (9 months ago)
- Last Synced: 2025-06-21T18:22:56.135Z (9 months ago)
- Language: Python
- Size: 21.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# free-on-pypi
## Opis
Narzędzie do sprawdzania dostępności nazw pakietów na PyPI i GitHub. Dostarcza trzy tryby pracy:
1. Tryb pliku - sprawdza listę nazw z pliku tekstowego
2. Tryb generatora - sprawdza wszystkie kombinacje "aba" (gdzie a i b to małe litery alfabetu)
3. Tryb GitHub - sprawdza dostępność nazw na GitHub (użytkownicy i organizacje)
## Instalacja
```bash
pip install requests
```
## Użycie
### Przykłady użycia
#### 1. Sprawdzanie listy nazw z pliku
```bash
# Sprawdzenie nazw z pliku names.txt na PyPI
python pypi.py from_file
# Sprawdzenie nazw z pliku names.txt na GitHub
python github.py from_file
```
#### 2. Sprawdzanie wszystkich kombinacji "ab"
```bash
# Sprawdzenie wszystkich kombinacji "ab" na PyPI
python pypi.py generator
```
#### 3. Używanie niestandardowych plików
```python
# PyPI z niestandardowymi plikami
from_file(
INPUT_FILE="my_names.txt",
FREE_FILE="available_packages.txt",
BUSY_FILE="taken_packages.txt",
DELAY=0.2
)
# GitHub z niestandardowymi plikami
from_file(
INPUT_FILE="usernames.txt",
FREE_FILE="available_users.txt",
BUSY_FILE="taken_users.txt",
DELAY=0.5
)
```
#### 4. Wznowienie przerwanego sprawdzania
```bash
# Generator automatycznie wznowi sprawdzanie od ostatniego miejsca
python pypi.py generator
```
#### 5. Sprawdzanie nazw z walidacją
```python
# Przykład wyniku dla nazwy nieprawidłowej dla PyPI
# Zostanie zapisana do pliku busy.txt jako:
"beta (Nazwa jest zarezerwowana)"
# Przykład wyniku dla nazwy zajętej
# Zostanie zapisana do pliku busy.txt jako:
"numpy"
# Przykład wyniku dla nazwy wolnej
# Zostanie zapisana do pliku free.txt jako:
"mycoolpackage"
```
#### 6. Przykład zawartości pliku names.txt
```
myproject
cooltool
awesomeapp
pythonlib
```
#### 7. Przykład zawartości pliku usernames.txt
```
johnsmith
devopsuser
githubuser
```
#### 8. Opcje zaawansowane
```python
# Zwiększenie opóźnienia dla większej liczby nazw
from_file(INPUT_FILE="big_list.txt", DELAY=0.5)
# Używanie generatora z innym plikiem postępu
generator(PROGRESS_FILE="my_progress.txt", DELAY=0.15)
```
## Funkcje
### PyPI Checking (pypi.py)
- Sprawdza dostępność nazw na PyPI używając wielu metod
- Waliduje nazwy według zasad PyPI
- Zapisuje wyniki do plików wyjściowych
- Domyślnie używa opóźnienia 100ms
### GitHub Checking (github.py)
- Sprawdza dostępność nazw na GitHub (użytkownicy i organizacje)
- Zapisuje wyniki do plików wyjściowych
- Domyślnie używa opóźnienia 500ms
## Walidacja nazw na PyPI
Nazwy na PyPI muszą spełniać następujące warunki:
1. Długość: co najmniej 2 znaki
2. Znaki: małe litery, cyfry, podkreślenia i myślniki
3. Nie może zaczynać się od podkreślenia
4. Nie może zawierać spacji
5. Nie może być zarezerwowana (np. 'python', 'pypi', 'github' itp.)
Lista zarezerwowanych słów:
- host, python, py, pip, conda, anaconda
- pypi, github, git, npm, node, javascript
- java, ruby, rust, go, c, cpp, c++
- typescript, php, sql, nosql, mongodb, mysql
- postgresql, oracle, microsoft, google, amazon
- aws, azure, gcp, docker, kubernetes, k8s
- terraform, ansible, jenkins, circleci, githubactions
- gitlabci, travisci, bitbucket
- i wiele innych...
## Wyjście
- Nazwy wolne: zapisywane do pliku `free.txt`
- Nazwy zajęte: zapisywane do pliku `busy.txt`
- Postęp (tylko dla generatora): zapisywany do pliku `progress.txt`
## Uwagi
- Narzędzie używa opóźnienia między zapytaniami, aby uniknąć przeciążenia serwerów
- Wszystkie nazwy są sprawdzane w formie małych liter
- Pliki wynikowe są zapisywane w trybie append (dodawanie) dla generatora
- Generator może być wznowiony z poprzedniego miejsca dzięki plikowi postępu
- Nazwy nieprawidłowe dla PyPI zostają zapisane w pliku busy.txt z powodem odrzucenia