Metadata-Version: 2.3
Name: poetry102
Version: 0.1.2
Summary: 
Author: hyw208
Author-email: hyw208@gmail.com
Requires-Python: >=3.12
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: fastapi[standard] (>=0.115.6,<0.116.0)
Description-Content-Type: text/markdown


# Installation and running
1. make test
2. cd test
3. python -m venv venv
4. source ./venv/bin/activate
5. pip install poetry102
6. uvicorn poetry102.main:app
   
# Repo
https://github.com/hyw208/poetry102

# TODO
1. add tox, ruff, formating  
2. experiment with black flake8 isort mypy pylint

# Installation for dev 
1. pyenv
2. poetry 
3. poetry plugin add poetry-plugin-shell

# References 
1. pyenv: https://opensource.com/article/20/4/pyenv 
2. poetry intro: https://realpython.com/dependency-management-python-poetry/
3. poetry doc: https://python-poetry.org/docs/cli/
4. poetry and pytest and coverage: https://dev.to/iamibi/add-coverage-report-with-pytest-and-gitlab-ci-3e9p
5. pytest conf: https://docs.pytest.org/en/stable/reference/reference.html#ini-options-ref
6. coverage conf: https://coverage.readthedocs.io/en/6.4.3/cmd.html#cmd
7. make: https://github.com/mapsa/makefile-examples (or use poetry shell)

# Commands
1. poetry new <folder> --src (or poetry new <folder>)
2. poetry env remove --all (delete virtual env)
3. poetry install (or 'poetry install --sync' to create virtual env & sync deps)
4. poetry env list
5. poetry env info --path
6. poetry env activate (and source the output) 
7. source "$(poetry env info --path)/bin/activate"
8. deactivate
9. poetry config --list
10. poetry add requests (or requests==2.25.1 "beautifulsoup4<4.10")
11. poetry add pytest coverage --dev
12. poetry remove requests
13. poetry lock (or poetry lock --no-update if no updating deps to latest versions)
14. poetry show --latest --top-level (or poetry show --tree)
15. poetry export --output requirements.txt
16. poetry run which python
17. poetry run xyz2 (run script defined in toml, need to do 'poetry install' first)
18. poetry run uvicorn --factory poetry102.main:app (xxxxxx not working all of a sudden)
19. poetry run fastapi src/poetry102/main.py
20. poetry publish -u __token__ -p <token>



