alpha-python 0.6.0__tar.gz → 0.6.1__tar.gz

alpha_python-0.6.1/PKG-INFO

@@ -0,0 +1,210 @@
+Metadata-Version: 2.4
+Name: alpha-python
+Version: 0.6.1
+Summary: Alpha is intended to be the first dependency you need to add to your Python application. It is a Python library which contains standard building blocks that can be used in applications that are used as APIs and/or make use of database interaction.
+Author-email: Bart Reijling <bart@reijling.eu>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/breijling/alpha
+Project-URL: Issues, https://github.com/breijling/alpha/issues
+Project-URL: Documentation, https://alpha-python.readthedocs.io/en/latest/
+Project-URL: Changelog, https://alpha-python.readthedocs.io/en/latest/changelog/
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: <3.15,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: attrs>=25.4.0
+Requires-Dist: gunicorn>=23.0.0
+Requires-Dist: jsonpatch>=1.33
+Requires-Dist: numpy>=2.3.5
+Requires-Dist: pandas>=1.13
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: pyjwt>=2.10.1
+Requires-Dist: six>=1.17.0
+Requires-Dist: sqlalchemy>=2.0.44
+Requires-Dist: requests>=2.28.1
+Requires-Dist: dependency-injector[yaml]!=4.48.3,<5.0.0,>=4.42.0
+Requires-Dist: argon2-cffi>=25.1.0
+Requires-Dist: httpx
+Requires-Dist: cryptography
+Provides-Extra: api-generator
+Requires-Dist: openapi-generator-cli==7.14.0; extra == "api-generator"
+Requires-Dist: jdk4py; extra == "api-generator"
+Provides-Extra: flask
+Requires-Dist: connexion[swagger-ui]<3,>=2.14.2; extra == "flask"
+Requires-Dist: swagger-ui-bundle>=0.0.2; extra == "flask"
+Requires-Dist: python_dateutil>=2.6.0; extra == "flask"
+Requires-Dist: itsdangerous==1.1.0; extra == "flask"
+Requires-Dist: MarkupSafe<2.0.2; extra == "flask"
+Requires-Dist: Jinja2==2.11.2; extra == "flask"
+Requires-Dist: Flask<2,>=1.1.2; extra == "flask"
+Requires-Dist: Werkzeug<2.1.0,>=1.0.1; extra == "flask"
+Requires-Dist: flask-cors>=3.0.10; extra == "flask"
+Requires-Dist: Flask-Compress>=1.13; extra == "flask"
+Provides-Extra: mysql
+Requires-Dist: pymysql>=1.1.2; extra == "mysql"
+Provides-Extra: postgresql
+Requires-Dist: psycopg2-binary>=2.9.11; extra == "postgresql"
+Provides-Extra: ldap
+Requires-Dist: ldap3>=2.9.1; extra == "ldap"
+Dynamic: license-file
+
+# Alpha
+
+Alpha is intended to be the first dependency you need to add to your Python application. It is a Python library which contains standard building blocks that can be used in applications that are used as APIs and/or make use of database interaction.
+
+## Badges
+
+[![PyPI version](https://badge.fury.io/py/alpha-python.svg?icon=si%3Apython)](https://badge.fury.io/py/alpha-python)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/alpha-python.svg?label=PyPI%20downloads)](https://pypistats.org/packages/alpha-python)
+[![Build Status](https://github.com/breijling/alpha/actions/workflows/python-app.yml/badge.svg?branch=main)](https://github.com/breijling/alpha/actions/workflows/python-app.yml)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/alpha-python.svg?color=%2334D058)](https://pypi.org/project/alpha-python)
+[![Coverage Status](https://coveralls.io/repos/github/BReijling/alpha/badge.svg?branch=main)](https://coveralls.io/github/BReijling/alpha?branch=main)
+[![uv](https://img.shields.io/badge/package%20manager-uv-5C4EE5)](https://docs.astral.sh/uv/)
+[![mypy](https://img.shields.io/badge/type%20check-mypy-2A6DB2)](https://mypy-lang.org/)
+[![Pytest](https://img.shields.io/badge/testing-pytest-0A9EDC)](https://docs.pytest.org/)
+[![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Documentation Status](https://readthedocs.org/projects/alpha-python/badge/?version=latest)](https://alpha-python.readthedocs.io/en/latest/)
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
+[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-pink?logo=github)](https://github.com/sponsors/BReijling)
+
+## TL;DR
+
+Alpha provides a comprehensive set of tools for building Python applications that interact with APIs and databases, including API code generation, authentication and authorization, database access layers, error handling, logging, and more. It is designed to be the first dependency you add to your project, providing a solid foundation for your application's architecture.
+
+## Documentation
+
+Full documentation is available at [alpha-python.readthedocs.io](https://alpha-python.readthedocs.io/).
+
+## Installation
+
+The library is still in development, but you can already install it using pip:
+
+```shell
+pip install alpha-python
+```
+
+If you want to use the alpha cli for generating API code, you can install it using pip as well:
+
+```shell
+pip install alpha-python[api-generator]
+```
+
+If you want to add the library to your API project, you can add it to your pyproject.toml file:
+
+```shell
+# Poetry example
+poetry add alpha-python --extras "flask, postgresql"
+poetry add --dev alpha-python --extras "api-generator"
+
+# UV example
+uv add alpha-python --extra flask --extra postgresql
+uv add --dev alpha-python --extra api-generator
+```
+
+## Features
+
+- API code generation
+- Authentication and authorization
+- Database interaction
+- Logging
+- Error handling
+- And much more!
+
+## Usage
+
+The library contains many components. Below are a few practical examples that map to the guides in the documentation.
+
+### 1) API code generation using OpenAPI spec
+
+```shell
+alpha api gen --spec-file specification/openapi.yaml --service-package my_app
+
+alpha api run --port 8080
+```
+
+### 2) Authenticate with Keycloak (OIDC)
+
+```python
+from alpha import KeyCloakOIDCConnector, KeyCloakProvider, PasswordCredentials
+
+keycloak_connector = KeyCloakOIDCConnector(
+	base_url="https://keycloak.example.com",
+	realm="myrealm",
+	client_id="myclient",
+	client_secret="myclientsecret",
+)
+
+keycloak_provider = KeyCloakProvider(connector=keycloak_connector)
+
+credentials = PasswordCredentials(username="user1", password="user1_password")
+identity = keycloak_provider.authenticate(credentials)
+```
+
+### 3) Query data using SqlAlchemyDatabase + SqlAlchemyRepository
+
+```python
+from alpha import SqlAlchemyDatabase, SqlAlchemyRepository
+from my_app import User
+
+db = SqlAlchemyDatabase(conn_str="postgresql://user:password@localhost:5432/mydatabase")
+
+with db.get_session() as session:
+	users = SqlAlchemyRepository[User](session=session, default_model=User)
+	user = users.get_by_id(1)
+```
+
+### 4) Use Unit of Work for transactional operations
+
+```python
+from alpha import (
+	RepositoryModel,
+	SqlAlchemyDatabase,
+	SqlAlchemyRepository,
+	SqlAlchemyUnitOfWork,
+)
+from my_app import User, OrmMapper
+
+db = SqlAlchemyDatabase(..., mapper=OrmMapper)
+repositories = [
+	RepositoryModel(
+		name="users",
+		repository=SqlAlchemyRepository[User],
+		default_model=User,
+	)
+]
+
+uow = SqlAlchemyUnitOfWork(db=db, repos=repositories)
+
+with uow:
+	user = uow.users.get_by_id(1)
+```
+
+See also:
+
+- Design principles and patterns: https://alpha-python.readthedocs.io/en/latest/concepts/design-principles/
+- Dependency injection concept: https://alpha-python.readthedocs.io/en/latest/concepts/dependency-injection/
+- API code generation guide: https://alpha-python.readthedocs.io/en/latest/guides/api-generation/
+- Authentication guide: https://alpha-python.readthedocs.io/en/latest/guides/authentication/
+- Database interaction guide: https://alpha-python.readthedocs.io/en/latest/guides/database-interaction/
+
+## Contributing
+
+If you want to contribute to the development of this library, you can fork the repository and create a pull request with your changes.
+
+## Support
+
+If Alpha saves you time in production, consider supporting development by buying me a coffee! Your support helps me to continue improving the library and adding new features. Thank you!
+
+<a href="https://www.buymeacoffee.com/breijling"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=breijling&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" /></a>
+
+## License
+
+This library is licensed under the MIT License. See the LICENSE file for more information.

alpha_python-0.6.1/README.md

@@ -0,0 +1,153 @@
+# Alpha
+
+Alpha is intended to be the first dependency you need to add to your Python application. It is a Python library which contains standard building blocks that can be used in applications that are used as APIs and/or make use of database interaction.
+
+## Badges
+
+[![PyPI version](https://badge.fury.io/py/alpha-python.svg?icon=si%3Apython)](https://badge.fury.io/py/alpha-python)
+[![PyPI Downloads](https://img.shields.io/pypi/dm/alpha-python.svg?label=PyPI%20downloads)](https://pypistats.org/packages/alpha-python)
+[![Build Status](https://github.com/breijling/alpha/actions/workflows/python-app.yml/badge.svg?branch=main)](https://github.com/breijling/alpha/actions/workflows/python-app.yml)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/alpha-python.svg?color=%2334D058)](https://pypi.org/project/alpha-python)
+[![Coverage Status](https://coveralls.io/repos/github/BReijling/alpha/badge.svg?branch=main)](https://coveralls.io/github/BReijling/alpha?branch=main)
+[![uv](https://img.shields.io/badge/package%20manager-uv-5C4EE5)](https://docs.astral.sh/uv/)
+[![mypy](https://img.shields.io/badge/type%20check-mypy-2A6DB2)](https://mypy-lang.org/)
+[![Pytest](https://img.shields.io/badge/testing-pytest-0A9EDC)](https://docs.pytest.org/)
+[![PEP8](https://img.shields.io/badge/code%20style-pep8-orange.svg)](https://www.python.org/dev/peps/pep-0008/)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+[![Documentation Status](https://readthedocs.org/projects/alpha-python/badge/?version=latest)](https://alpha-python.readthedocs.io/en/latest/)
+[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](https://choosealicense.com/licenses/mit/)
+[![Sponsor](https://img.shields.io/badge/Sponsor-GitHub-pink?logo=github)](https://github.com/sponsors/BReijling)
+
+## TL;DR
+
+Alpha provides a comprehensive set of tools for building Python applications that interact with APIs and databases, including API code generation, authentication and authorization, database access layers, error handling, logging, and more. It is designed to be the first dependency you add to your project, providing a solid foundation for your application's architecture.
+
+## Documentation
+
+Full documentation is available at [alpha-python.readthedocs.io](https://alpha-python.readthedocs.io/).
+
+## Installation
+
+The library is still in development, but you can already install it using pip:
+
+```shell
+pip install alpha-python
+```
+
+If you want to use the alpha cli for generating API code, you can install it using pip as well:
+
+```shell
+pip install alpha-python[api-generator]
+```
+
+If you want to add the library to your API project, you can add it to your pyproject.toml file:
+
+```shell
+# Poetry example
+poetry add alpha-python --extras "flask, postgresql"
+poetry add --dev alpha-python --extras "api-generator"
+
+# UV example
+uv add alpha-python --extra flask --extra postgresql
+uv add --dev alpha-python --extra api-generator
+```
+
+## Features
+
+- API code generation
+- Authentication and authorization
+- Database interaction
+- Logging
+- Error handling
+- And much more!
+
+## Usage
+
+The library contains many components. Below are a few practical examples that map to the guides in the documentation.
+
+### 1) API code generation using OpenAPI spec
+
+```shell
+alpha api gen --spec-file specification/openapi.yaml --service-package my_app
+
+alpha api run --port 8080
+```
+
+### 2) Authenticate with Keycloak (OIDC)
+
+```python
+from alpha import KeyCloakOIDCConnector, KeyCloakProvider, PasswordCredentials
+
+keycloak_connector = KeyCloakOIDCConnector(
+	base_url="https://keycloak.example.com",
+	realm="myrealm",
+	client_id="myclient",
+	client_secret="myclientsecret",
+)
+
+keycloak_provider = KeyCloakProvider(connector=keycloak_connector)
+
+credentials = PasswordCredentials(username="user1", password="user1_password")
+identity = keycloak_provider.authenticate(credentials)
+```
+
+### 3) Query data using SqlAlchemyDatabase + SqlAlchemyRepository
+
+```python
+from alpha import SqlAlchemyDatabase, SqlAlchemyRepository
+from my_app import User
+
+db = SqlAlchemyDatabase(conn_str="postgresql://user:password@localhost:5432/mydatabase")
+
+with db.get_session() as session:
+	users = SqlAlchemyRepository[User](session=session, default_model=User)
+	user = users.get_by_id(1)
+```
+
+### 4) Use Unit of Work for transactional operations
+
+```python
+from alpha import (
+	RepositoryModel,
+	SqlAlchemyDatabase,
+	SqlAlchemyRepository,
+	SqlAlchemyUnitOfWork,
+)
+from my_app import User, OrmMapper
+
+db = SqlAlchemyDatabase(..., mapper=OrmMapper)
+repositories = [
+	RepositoryModel(
+		name="users",
+		repository=SqlAlchemyRepository[User],
+		default_model=User,
+	)
+]
+
+uow = SqlAlchemyUnitOfWork(db=db, repos=repositories)
+
+with uow:
+	user = uow.users.get_by_id(1)
+```
+
+See also:
+
+- Design principles and patterns: https://alpha-python.readthedocs.io/en/latest/concepts/design-principles/
+- Dependency injection concept: https://alpha-python.readthedocs.io/en/latest/concepts/dependency-injection/
+- API code generation guide: https://alpha-python.readthedocs.io/en/latest/guides/api-generation/
+- Authentication guide: https://alpha-python.readthedocs.io/en/latest/guides/authentication/
+- Database interaction guide: https://alpha-python.readthedocs.io/en/latest/guides/database-interaction/
+
+## Contributing
+
+If you want to contribute to the development of this library, you can fork the repository and create a pull request with your changes.
+
+## Support
+
+If Alpha saves you time in production, consider supporting development by buying me a coffee! Your support helps me to continue improving the library and adding new features. Thank you!
+
+<a href="https://www.buymeacoffee.com/breijling"><img src="https://img.buymeacoffee.com/button-api/?text=Buy me a coffee&emoji=&slug=breijling&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff" /></a>
+
+## License
+
+This library is licensed under the MIT License. See the LICENSE file for more information.

{alpha_python-0.6.0 → alpha_python-0.6.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "alpha-python"
-version = "0.6.0"
+version = "0.6.1"
 description = "Alpha is intended to be the first dependency you need to add to your Python application. It is a Python library which contains standard building blocks that can be used in applications that are used as APIs and/or make use of database interaction."
 readme = "README.md"
 authors = [
@@ -80,7 +80,10 @@ dev = [
     "ipykernel>=7.2.0",
     "flask<2",
     "httpx>=0.28.1",
-    "tox>=4.53.0",
+    "tox>=4.0.0",
+    "types-ldap3",
+    "types-requests",
+    "pandas-stubs",
 ]
 # docs = [
 #     "mkdocs-material>=9.5",
@@ -156,7 +159,8 @@ source = ["src"]
 omit = [
     "tests/*",
     "__init__.py",
-    "_http_codes.py"
+    "_http_codes.py",
+    "src/alpha/utils/openapi_test/*"
 ]
 
 [tool.black]
@@ -172,10 +176,13 @@ force_grid_wrap = 0
 
 [tool.mypy]
 python_version = "3.11"
-exclude = ['^tests/']
+exclude = ["^tests/", "src/alpha/utils/openapi_test"]
 
 [[tool.mypy.overrides]]
-module = ["flask", "flask.*"]
+module = [
+    "flask", 
+    "flask.*", 
+]
 ignore_missing_imports = true
 
 [tool.ruff]

{alpha_python-0.6.0 → alpha_python-0.6.1}/src/alpha/cli.py

@@ -20,18 +20,18 @@ def main(sections: list[Section] = Provide[Container.sections]) -> None:
 
     # Create the main parser
     parser = argparse.ArgumentParser(
-        description='Alpha command line interface.',
+        description="Alpha command line interface.",
         formatter_class=argparse.ArgumentDefaultsHelpFormatter,
     )
     subparsers = parser.add_subparsers(
-        title='Use one of the sub categories to run commands on',
-        dest='section',
+        title="Use one of the sub categories to run commands on",
+        dest="section",
     )
 
     # Parser dict to store in all parsers to match later on when finding a
     # handler.
-    section_parsers = {}
-    command_parsers = {}
+    section_parsers: dict[str, argparse.ArgumentParser] = {}
+    command_parsers: dict[str, dict[str, argparse.ArgumentParser]] = {}
 
     # Create all sections
     for section in sections:
@@ -43,7 +43,7 @@ def main(sections: list[Section] = Provide[Container.sections]) -> None:
             formatter_class=argparse.ArgumentDefaultsHelpFormatter,
         )
         section_subparser = section_parsers[section.name].add_subparsers(
-            dest='command'
+            dest="command"
         )
 
         # Create all commands per section
@@ -88,8 +88,8 @@ def main(sections: list[Section] = Provide[Container.sections]) -> None:
     # Get all arguments and remove the section and command so they can be
     # 'kwarged' into the Handler set_arguments function.
     handler_args = vars(args)
-    del handler_args['section']
-    del handler_args['command']
+    del handler_args["section"]
+    del handler_args["command"]
 
     # Find the right handler
     for section in sections:
@@ -102,7 +102,7 @@ def main(sections: list[Section] = Provide[Container.sections]) -> None:
                 command.handler.handle_command()
                 return
 
-    print('No handler found, you should never read this')
+    print("No handler found, you should never read this")
     return
 
 
@@ -118,53 +118,57 @@ def _guess_current_package_name() -> str:
     """
 
     cwd = os.getcwd()
-    pyproject_path = os.path.join(cwd, 'pyproject.toml')
+    pyproject_path = os.path.join(cwd, "pyproject.toml")
 
     # look for pyproject.toml file in subfolders
     if not os.path.isfile(pyproject_path):
         for entry in os.scandir(cwd):
             if not entry.is_dir():
                 continue
-            possible_path = os.path.join(entry.path, 'pyproject.toml')
+            possible_path = os.path.join(entry.path, "pyproject.toml")
             if os.path.isfile(possible_path):
                 pyproject_path = possible_path
                 break
 
     if os.path.isfile(pyproject_path):
         try:
-            with open(pyproject_path, 'rb') as f:
+            with open(pyproject_path, "rb") as f:
                 pyproject_data = tomllib.load(f)
                 name = None
                 try:
-                    if 'project' in pyproject_data:
-                        name = pyproject_data['project']['name']
-                    elif 'tool' in pyproject_data and 'poetry' in pyproject_data['tool']:
-                        name = pyproject_data['tool']['poetry']['name']
+                    if "project" in pyproject_data:
+                        name = pyproject_data["project"]["name"]
+                    elif (
+                        "tool" in pyproject_data
+                        and "poetry" in pyproject_data["tool"]
+                    ):
+                        name = pyproject_data["tool"]["poetry"]["name"]
                     if name is not None:
-                        return name.replace('-', '_')
+                        return name.replace("-", "_")
                 except KeyError:
-                    print('Could not find project name in pyproject.toml')
+                    print("Could not find project name in pyproject.toml")
         except Exception:
             pass
     else:
-        print('Could not find pyproject.toml')
+        print("Could not find pyproject.toml")
 
     # Fallback to use the current folder name
-    print('Guessing package name from folder')
+    print("Guessing package name from folder")
     return os.path.basename(cwd)
 
+
 def init() -> None:
     """Init the container and wire it to the main function."""
     container = Container()
     guessed_name = _guess_current_package_name()
     if guessed_name:
-        container.config.api_package_name.from_value(f'{guessed_name}_api')
+        container.config.api_package_name.from_value(f"{guessed_name}_api")
         container.config.service_package_name.from_value(guessed_name)
         container.config.container_import.from_value(
-            f'from {guessed_name}.containers.container import Container'
+            f"from {guessed_name}.containers.container import Container"
         )
         container.config.init_container_from.from_value(guessed_name)
-        container.config.init_container_function.from_value('init_container')
+        container.config.init_container_function.from_value("init_container")
     container.wire(modules=[sys.modules[__name__]])
 
     main()

{alpha_python-0.6.0 → alpha_python-0.6.1}/src/alpha/encoder.py

@@ -10,9 +10,10 @@ from json import encoder
 from typing import Any
 from uuid import UUID
 
-import numpy as np
-import pandas as pd
-import six
+import numpy as np  # type: ignore[import-untyped]
+import pandas as pd  # type: ignore[import-untyped]
+import six  # type: ignore[import-untyped]
+
 
 from alpha.interfaces.openapi_model import OpenAPIModel
 

{alpha_python-0.6.0 → alpha_python-0.6.1}/src/alpha/factories/jwt_factory.py

@@ -34,7 +34,10 @@ class JWTFactory:
         Parameters
         ----------
         secret
-            The secret key used to sign the JWT.
+            The secret key used to sign the JWT. A secret value should be a
+            minimum of 32 characters for security reasons. This value should be
+            kept confidential and not exposed in the source code or version
+            control system.
         lifetime_hours
             The lifetime of the JWT in hours, by default None. This parameter
             is ignored if lifetime_seconds is provided. The parameter is
@@ -71,13 +74,13 @@ class JWTFactory:
                 stacklevel=2,
             )
 
-        if lifetime_seconds is None and lifetime_hours is None:
-            lifetime_seconds = (
-                900  # Default to 15 minutes if no lifetime is provided
-            )
-        elif lifetime_seconds is None and lifetime_hours is not None:
+        if lifetime_seconds is None and lifetime_hours is not None:
             lifetime_seconds = 3600 * int(lifetime_hours)
 
+        lifetime_seconds = (
+            900 if lifetime_seconds is None else lifetime_seconds
+        )  # Default to 15 minutes if no lifetime is provided
+
         self.JWT_SECRET: str = secret
         self.JWT_ISSUER = issuer
         self.JWT_ALGORITHM = jwt_algorithm
@@ -113,7 +116,7 @@ class JWTFactory:
             The generated JWT token as a string.
         """
         now = datetime.now(tz=timezone.utc)
-        exp = now + timedelta(seconds=self.JWT_LIFETIME_SECONDS)
+        exp = now + timedelta(seconds=float(self.JWT_LIFETIME_SECONDS))
 
         token_payload: dict[str, Any] = {
             "sub": subject,

{alpha_python-0.6.0 → alpha_python-0.6.1}/src/alpha/factories/password_factory.py

@@ -11,6 +11,11 @@ from alpha import exceptions
 class PasswordFactory:
     """This class provides methods for hashing and verifying passwords using
     the argon2 library.
+
+    Keep in mind that changing the password hasher in a production environment
+    may lead to issues with existing password hashes, so it is recommended to
+    use the default hasher unless you have specific requirements. Or configure
+    the password hasher before you deploy your application to production.
     """
 
     def __init__(
@@ -22,7 +27,9 @@ class PasswordFactory:
         ----------
         password_hasher
             An optional password hasher instance. If not provided, a default
-            argon2.PasswordHasher with a salt length of 16 will be used.
+            argon2.PasswordHasher with a salt length of 16 will be used. This
+            allows for flexibility in case you want to use a custom password
+            hasher.
         """
         self._password_hasher = password_hasher or argon2.PasswordHasher(
             salt_len=16

{alpha_python-0.6.0 → alpha_python-0.6.1}/src/alpha/handlers/api_generate_handler.py

@@ -187,6 +187,11 @@ class ApiGenerateHandler(BaseHandler):
         """Copy mustache templates to the templates folder in the working
         directory
         """
+        if self.generator_name is None:
+            raise InvalidArgumentsException(
+                "Generator name is required to copy templates."
+            )
+
         shutil.rmtree(self.project_templates_folder, ignore_errors=True)
         shutil.copytree(
             src=os.path.join(