add publish to pypi github actions and documentation

[pksol]

Description

Added publish to pypi github actions and documentation.

The action was tested successfully on two of my projects which were created using this template:

https://github.com/pksol/pytest-fastapi-deps

https://github.com/pksol/pytest-mock-generator

I also updated the documentation to match the new functionality.

Type of Change

• [x] 📚 Examples / docs / tutorials / dependencies update
• [ ] 🔧 Bug fix (non-breaking change which fixes an issue)
• [ ] 🥂 Improvement (non-breaking change which improves an existing feature)
• [x] 🚀 New feature (non-breaking change which adds functionality)
• [ ] 💥 Breaking change (fix or feature that would cause existing functionality to change)
• [ ] 🔐 Security fix

Checklist

• [x] I've read the CODE_OF_CONDUCT.md document.
• [x] I've read the CONTRIBUTING.md guide.
• [x] I've updated the code style using make codestyle.
• [x] I've written tests for all new methods and classes that I created.
• [x] I've written the docstring in Google format for all the methods and classes that I used.

[pksol]

@TezRomacH , had you had a chance to review this code to enable publishing to PyPI?

I think that it will be a great addition to the library.