Metadata-Version: 2.1
Name: pymondis
Version: 1.0.0b2.post2
Summary: Nieoficjalny wrapper Quatromondis API
Home-page: https://github.com/Asapros/pymondis
Author: Asapros
License: MIT
Project-URL: Tracker, https://github.com/Asapros/pymondis/issues
Project-URL: Source, https://github.com/Asapros/pymondis
Keywords: quatromondis,yorck,API,HTTP,async,hugo
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Natural Language :: Polish
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE

# PYMONDIS
<img src="banner.png" alt="(Banner pymondis)" style="width: 100%;"/>

Nieoficjalny wrapper api [Quatromondis](https://quatromondis.pl/) w pythonie

## Fajne rzeczy
- Wszystkie zapytania są asynchroniczne z użyciem `httpx`
- Moduł ``shell`` udostępnia prosty interfejs do używania biblioteki bez konieczności tworzenia asynchronicznej funckji
- Fajnie obiekty z użyciem `attrs` (nawet *repr()* działa!)
- Ponawianie nieudanych zapytań
- Epicka składnia pythona 3.10 (dlatego na razie można korzystać tylko z 3.10)
- Cache'owanie zdjęć
- Type hinty

## Co możesz zrobić
- Dostać listę wszystkich aktualnych obozów
- Dostać listę wszystkich aktualnych galerii
- Dostać listę wszystkich zamków z aktywną fotorelacją
- Dostać listę wszystkich psorów z opisami (bez biura i HY)
- Dostać listę wszystkich kandydatów plebiscytów od 2019
- Zagłosować w plebiscycie
- Pobrać wszystkie zdjęcia z [aktualnych](#old-galeries-deleted) galerii 
- Męczyć się debugowaniem przez 5 godzin, bo zapomniałeś dać *await* ;)

## Czego już nie możesz zrobić ;(
<a name="old-galeries-deleted"></a>
- Do początku 2022 można było zobaczyć fotorelację nawet z 2019 roku, ale już bloby zaczęły znikać.
To była główna funkcjonalność biblioteki — pobieranie starych niedostępnych na stronie zdjęć,
ale informatycy pożałowali miejscem na dysku i je usunęli. Przepraszam wszystkich którzy przyszli tutaj z nadzieją
odtworzenia swoich dawnych wspomnień. Polecam pobierać całe galerie, póki jeszcze nie zostały usunięte, na szczęście
zdążyłem pobrać zdjęcia ze swoich wszystkich starych turnusów.

## Co prawdopodobnie możesz zrobić
- Zarezerwować miejsce w inauguracji
- Zamówić książkę
- Zarezerwować miejsce na obozie
- ~~Dostać informacje o rezerwacji obozu~~
- ~~Zgłosić się o pracę~~

## Instalacja
Aktualna *chyba* działająca wersja
```shell
pip install pymondis
```
Aktualna wersja
```shell
pip install git+https://github.com/Asapros/pymondis.git
```

## api/Camps/Freshness
  Podejrzewam że endpoint podaje, kiedy ostatnio była aktualizowana lista obozów (I tak ta lista jest wysyłana razem ze stroną, więc po co to? Nawet cache to nic nie da, chyba że *server-side*).
To bardzo zastanawiające rozwiązanie, podkreślając ile HTTP ma standardowych sposobów cache'owania, które nie wymagają wykonywania dwóch zapytań (ETag, Last-Modified, ...).
  Jeśli chodzi o Content-Type, to dziwne jest podawanie daty jako application/json. Niby tekst jest prawidłowym obiektem, ale no... istnieje coś takiego jak text/plain, bez potrzeby dodawania cudzysłowia.

[dla google bo sobie dalej nie radzi z indeksowaniem :/]: # (quatromondis api quatromondis python api wrapper nieoficjalny)


