Metadata-Version: 2.1
Name: generator_zadan
Version: 0.2.0
Summary: Generuje losowo roznego typu zadania
License: MIT
Author: Adam Bohonos
Requires-Python: >=3.11,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: babel (>=2.16.0,<3.0.0)
Requires-Dist: jupyter (>=1.0.0,<2.0.0)
Requires-Dist: matplotlib (<=3.7)
Requires-Dist: numpy (>=1.26.1,<2.0.0)
Requires-Dist: pandas (>=2.1.1,<3.0.0)
Requires-Dist: scipy (>=1.11.3,<2.0.0)
Requires-Dist: sympy (>=1.12,<2.0)
Requires-Dist: sympy-plot-backends (>=3.0.1,<4.0.0)
Requires-Dist: tqdm (>=4.65.0,<5.0.0)
Description-Content-Type: text/markdown

# generator_zadan

Na użytek własny. 

Generuje losowo różnego typu zadania (z rozwiązaniami) dla pierwszego roku studiów na uczelni technicznej.
Zadania mają mieć ***przyjazne*** dane i wyniki.
Powoli pewnie będzie typów zadań przybywać. 
W plikach modułów generatorów jest więcej typów zadań niż w plikach dokumentacji.
Prace dokumentacyjne trwają. 

Przy każdym generowaniu są inne zadania.

Generator był przygotowany do pliku TeX-owego i funkcje generujące nie są przystosowane do formatu Markdown.
Dlatego pliki ipynb w dokumentacji mają taką dziwną strukturę w sekcji prezentującej przykładowe zadania.
Na razie nie zamierzam tego zmieniać.  

Głównym celem jest format pdf tworzony z plików TeX.
Do tego są pliki: *generuj_analiza.py* i *generuj_algebra.py*.
Tam jest więcej zadań.

Funkcje na chwilę obecną nie są w żaden sposób udokumentowane. 
To było tworzone na użytek własny.
Jak ktoś chce korzystać to proszę bardzo.
Licencja poniżej. 

## Installation

```bash
pip install generator_zadan
```
lub (nawet lepsze, bo od razu można generować zestawy)

```bash
# Tworzymy niezależne środowisko pythona
python -m venv venv_generator_zadan
# Aktywujemy środowisko
source venv_generator_zadan/Scripts/activate
# Klonujemy pakiet
git clone https://github.com/DyonOylloug/generator_zadan
# Instalujemy pakiet
cd generator_zadan
pip install .
```
```bash
# Teraz możemy generować duże zestawy
cd src/generator_zadan
python generuj_algebra
python generuj_analiza
cd wygenerowane
pdflatex Algebra.tex
pdflatex Algebra.tex
pdflatex Analiza.tex
pdflatex Analiza.tex
# Tak - to ma być po dwa razy
# Pliki Algebra.pdf i Analiza.pdf są gotowe
# Oczywiście muszą być zainstalowane odpowiednie pakiety TeX-a
# U mnie działa
```

## Usage

-  Dokumentacja na stronie [readthedocs.](https://generator-zadan.readthedocs.io/en/latest/index.html)

## Contributing

Interested in contributing? Check out the contributing guidelines. Please note that this project is released with a Code of Conduct. By contributing to this project, you agree to abide by its terms.

## License

`generator_zadan` was created by Adam Bohonos. It is licensed under the terms of the MIT license.

## Credits

`generator_zadan` was created with [`cookiecutter`](https://cookiecutter.readthedocs.io/en/latest/) and the `py-pkgs-cookiecutter` [template](https://github.com/py-pkgs/py-pkgs-cookiecutter).

