instant-python 0.20.0__py3-none-any.whl

instant_python/templates/project_structure/domain_driven_design/layers/bounded_context.yml

@@ -0,0 +1,17 @@
+- name: {{ template.bounded_context }}
+  type: directory
+  python: True
+  children:
+    - name: {{ template.aggregate_name }}
+      type: directory
+      python: True
+      children:
+        - name: application
+          type: directory
+          python: True
+        - name: domain
+          type: directory
+          python: True
+        - name: infrastructure
+          type: directory
+          python: True

instant_python/templates/project_structure/domain_driven_design/layers/delivery.yml

@@ -0,0 +1,8 @@
+{% import "macros.j2" as macros with context %}
+{%- set delivery_features = [
+  {"feature": "fastapi_application", "template": "fastapi/fastapi_app.yml"}
+] %}
+- name: delivery
+  type: directory
+  python: True
+{{ macros.render_children_for(delivery_features, 2) }}

instant_python/templates/project_structure/domain_driven_design/layers/shared.yml

@@ -0,0 +1,18 @@
+{% import "macros.j2" as macros with context %}
+{%- set domain_related_features = ["value_objects", "event_bus", "fastapi_application"] %}
+{%- set infra_related_features = ["event_bus", "logger", "async_sqlalchemy", "async_alembic", "fastapi_application"] %}
+{%- set has_domain = domain_related_features | is_in(template.built_in_features) -%}
+{%- set has_infra = infra_related_features | is_in(template.built_in_features) -%}
+- name: shared
+  type: directory
+  python: True
+{% if has_domain or has_infra %}
+  children:
+{% if has_domain %}
+{{ macros.include_block("domain_driven_design/layers/shared_domain.yml", 4) }}
+{% endif %}
+{% if has_infra %}
+{{ macros.include_block("domain_driven_design/layers/shared_infra.yml", 4) }}
+{% endif %}
+{% endif %}
+

instant_python/templates/project_structure/domain_driven_design/layers/shared_domain.yml

@@ -0,0 +1,10 @@
+{% import "macros.j2" as macros with context %}
+{%- set domain_features = [
+  {"feature": "value_objects", "template": "errors.yml"},
+  {"feature": "event_bus", "template": "events/event_bus_domain.yml"},
+  {"feature": "fastapi_application", "template": "fastapi/fastapi_domain.yml"}
+] %}
+- name: domain
+  type: directory
+  python: True
+{{ macros.render_children_for(domain_features, 2) }}

instant_python/templates/project_structure/domain_driven_design/layers/shared_infra.yml

@@ -0,0 +1,12 @@
+{% import "macros.j2" as macros with context %}
+{%- set infra_features = [
+  {"feature": "event_bus", "template": "events/event_bus_infra.yml"},
+  {"feature": "logger", "template": "logger.yml"},
+  {"feature": "async_sqlalchemy", "template": "persistence/async_sqlalchemy.yml"},
+  {"feature": "async_alembic", "template": "persistence/alembic_migrator.yml"},
+  {"feature": "fastapi_application", "template": "fastapi/fastapi_infra.yml"}
+] %}
+- name: infra
+  type: directory
+  python: True
+{{ macros.render_children_for(infra_features, 2) }}

instant_python/templates/project_structure/domain_driven_design/layers/test_shared.yml

@@ -0,0 +1,8 @@
+{% import "macros.j2" as macros with context %}
+- name: shared
+  type: directory
+  python: True
+  children:
+{{ macros.include_block("domain_driven_design/layers/test_shared_delivery.yml", 4) }}
+{{ macros.include_block("domain_driven_design/layers/test_shared_domain.yml", 4) }}
+{{ macros.include_block("domain_driven_design/layers/test_shared_infra.yml", 4) }}

instant_python/templates/project_structure/domain_driven_design/layers/test_shared_delivery.yml

@@ -0,0 +1,3 @@
+- name: delivery
+  type: directory
+  python: True

instant_python/templates/project_structure/domain_driven_design/layers/test_shared_domain.yml

@@ -0,0 +1,3 @@
+- name: domain
+  type: directory
+  python: True

instant_python/templates/project_structure/domain_driven_design/layers/test_shared_infra.yml

@@ -0,0 +1,9 @@
+{% import "macros.j2" as macros with context %}
+{%- set infra_features = [
+  {"feature": "event_bus", "template": "events/mock_event_bus.yml"},
+  {"feature": "async_sqlalchemy", "template": "persistence/async_engine_conftest.yml"},
+] %}
+- name: infra
+  type: directory
+  python: True
+{{ macros.render_children_for(infra_features, 2) }}

instant_python/templates/project_structure/domain_driven_design/main_structure.yml

@@ -0,0 +1,38 @@
+{% import "macros.j2" as macros with context %}
+{# === Core Project Structure === #}
+{{ macros.include_block("domain_driven_design/source.yml", 0) }}
+{{ macros.include_block("domain_driven_design/test.yml", 0) }}
+{# === Base Configuration Files === #}
+{{ macros.include_block("config_files/pyproject.yml", 0) }}
+{{ macros.include_block("config_files/python_version.yml", 0) }}
+{{ macros.include_block("documentation/license.yml", 0) }}
+{# === CI/CD and Automation Features === #}
+{% set ci_cd_features = [
+    {"feature": "github_actions", "template": "github/github_action.yml"},
+    {"feature": "github_actions", "template": "github/makefile.yml"},
+    {"feature": "github_issues_template", "template": "github/github_issues_template.yml"},
+    {"feature": "makefile", "template": "github/makefile.yml"},
+    {"feature": "precommit_hook", "template": "github/precommit_hook.yml"},
+    {"feature": "precommit_hook", "template": "github/makefile.yml"}
+] %}
+{{ macros.render_features(ci_cd_features, 0) }}
+{# === Git Features === #}
+{% if git.initialize %}
+{{ macros.include_block("config_files/gitignore.yml", 0) }}
+{{ macros.include_block("documentation/readme.yml", 0) }}
+{% endif %}
+{# === Testing and Type Checking === #}
+{% if dependencies | has_dependency("pytest") %}
+{{ macros.include_block("config_files/pytest.yml", 0) }}
+{% endif %}
+{% if dependencies | has_dependency("mypy") %}
+{{ macros.include_block("config_files/mypy.yml", 0) }}
+{% endif %}
+{# === Database Migration === #}
+{{ macros.render_feature_if_enabled("async_alembic", "persistence/async_alembic.yml", 0) }}
+{# === Documentation and Metadata === #}
+{% set doc_features = [
+    {"feature": "citation_file", "template": "documentation/citation.yml"},
+    {"feature": "security_file", "template": "documentation/security.yml"}
+] %}
+{{ macros.render_features(doc_features, 0) }}

instant_python/templates/project_structure/domain_driven_design/source.yml

@@ -0,0 +1,10 @@
+{% import "macros.j2" as macros with context %}
+- name: {{ general.source_name }}
+  type: directory
+  python: True
+  children:
+{{ macros.include_block("domain_driven_design/layers/delivery.yml", 4) }}
+{{ macros.include_block("domain_driven_design/layers/shared.yml", 4) }}
+{%- if template.specify_bounded_context %}
+{{ macros.include_block("domain_driven_design/layers/bounded_context.yml", 4) }}
+{%- endif %}

instant_python/templates/project_structure/domain_driven_design/test.yml

@@ -0,0 +1,9 @@
+{% import "macros.j2" as macros with context %}
+- name: test
+  type: directory
+  python: True
+  children:
+{{ macros.include_block("domain_driven_design/layers/test_shared.yml", 4) }}
+{%- if template.specify_bounded_context %}
+{{ macros.include_block("domain_driven_design/layers/bounded_context.yml", 4) }}
+{%- endif %}

instant_python/templates/project_structure/errors.yml

@@ -0,0 +1,12 @@
+- name: errors
+  type: directory
+  python: True
+  children:
+    - name: base_error
+      type: file
+      extension: .py
+      template: exceptions/base_error.py
+    - name: domain_error
+      type: file
+      extension: .py
+      template: exceptions/domain_error.py

instant_python/templates/project_structure/events/event_bus_domain.yml

@@ -0,0 +1,48 @@
+- name: event
+  type: directory
+  python: True
+  children:
+    - name: domain_event
+      type: file
+      extension: .py
+      template: event_bus/domain_event.py
+    - name: domain_event_subscriber
+      type: file
+      extension: .py
+      template: event_bus/domain_event_subscriber.py
+    - name: event_bus
+      type: file
+      extension: .py
+      template: event_bus/event_bus.py
+    - name: exchange_type
+      type: file
+      extension: .py
+      template: event_bus/exchange_type.py
+- name: errors
+  type: directory
+  python: True
+  children:
+    - name: base_error
+      type: file
+      extension: .py
+      template: exceptions/base_error.py
+    - name: domain_error
+      type: file
+      extension: .py
+      template: exceptions/domain_error.py
+    - name: domain_event_type_not_found_error
+      type: file
+      extension: .py
+      template: exceptions/domain_event_type_not_found_error.py
+    - name: rabbit_mq_connection_not_established_error
+      type: file
+      extension: .py
+      template: exceptions/rabbit_mq_connection_not_established_error.py
+- name: value_objects
+  type: directory
+  python: True
+  children:
+    - name: event_aggregate
+      type: file
+      extension: .py
+      template: event_bus/event_aggregate.py

instant_python/templates/project_structure/events/event_bus_infra.yml

@@ -0,0 +1,40 @@
+- name: event
+  type: directory
+  python: True
+  children:
+    - name: domain_event_json_deserializer
+      type: file
+      extension: .py
+      template: event_bus/domain_event_json_deserializer.py
+    - name: domain_event_json_serializer
+      type: file
+      extension: .py
+      template: event_bus/domain_event_json_serializer.py
+    - name: rabbit_mq
+      type: directory
+      python: True
+      children:
+        - name: rabbit_mq_configurer
+          type: file
+          extension: .py
+          template: event_bus/rabbit_mq_configurer.py
+        - name: rabbit_mq_connection
+          type: file
+          extension: .py
+          template: event_bus/rabbit_mq_connection.py
+        - name: rabbit_mq_consumer
+          type: file
+          extension: .py
+          template: event_bus/rabbit_mq_consumer.py
+        - name: rabbit_mq_event_bus
+          type: file
+          extension: .py
+          template: event_bus/rabbit_mq_event_bus.py
+        - name: rabbit_mq_queue_formatter
+          type: file
+          extension: .py
+          template: event_bus/rabbit_mq_queue_formatter.py
+        - name: rabbit_mq_settings
+          type: file
+          extension: .py
+          template: event_bus/rabbit_mq_settings.py

instant_python/templates/project_structure/events/mock_event_bus.yml

@@ -0,0 +1,4 @@
+- name: mock_event_bus
+  type: file
+  extension: .py
+  template: event_bus/mock_event_bus.py

instant_python/templates/project_structure/fastapi/fastapi_app.yml

@@ -0,0 +1,32 @@
+- name: api
+  type: directory
+  python: True
+  children:
+    - name: application
+      type: file
+      extension: .py
+      template: fastapi/application.py
+    - name: handlers
+      type: directory
+      python: True
+      children:
+        - name: error_handlers
+          type: file
+          extension: .py
+          template: fastapi/error_handlers.py
+    {% if "async_alembic" in template.built_in_features %}
+    - name: lifespan
+      type: file
+      extension: .py
+      template: fastapi/lifespan.py
+    {% endif %}
+    {%  if "logger" in template.built_in_features %}
+    - name: middleware
+      type: directory
+      python: True
+      children:
+        - name: fastapi_log_middleware
+          type: file
+          extension: .py
+          template: fastapi/fastapi_log_middleware.py
+    {% endif %}

instant_python/templates/project_structure/fastapi/fastapi_domain.yml

@@ -0,0 +1,12 @@
+- name: errors
+  type: directory
+  python: True
+  children:
+    - name: domain_error
+      type: file
+      extension: .py
+      template: exceptions/domain_error.py
+    - name: base_error
+      type: file
+      extension: .py
+      template: exceptions/base_error.py

instant_python/templates/project_structure/fastapi/fastapi_infra.yml

@@ -0,0 +1,12 @@
+- name: http
+  type: directory
+  python: True
+  children:
+    - name: error_response
+      type: file
+      extension: .py
+      template: fastapi/error_response.py
+    - name: success_response
+      type: file
+      extension: .py
+      template: fastapi/success_response.py

instant_python/templates/project_structure/github/github_action.yml

@@ -0,0 +1,24 @@
+- name: .github
+  type: directory
+  children:
+    - name: actions
+      type: directory
+      children:
+        - name: python_setup
+          type: directory
+          children:
+            - name: action
+              type: file
+              extension: .yml
+              template: github/action.yml
+    - name: workflows
+      type: directory
+      children:
+        - name: ci
+          type: file
+          extension: .yml
+          template: github/ci.yml
+        - name: release
+          type: file
+          extension: .yml
+          template: github/release.yml

instant_python/templates/project_structure/github/github_issues_template.yml

@@ -0,0 +1,14 @@
+- name: .github
+  type: directory
+  children:
+    - name: ISSUE_TEMPLATE
+      type: directory
+      children:
+        - name: bug_report
+          type: file
+          extension: .yml
+          template: github/bug_report.yml
+        - name: feature_request
+          type: file
+          extension: .yml
+          template: github/feature_request.yml

instant_python/templates/project_structure/github/makefile.yml

@@ -0,0 +1,3 @@
+- name: makefile
+  type: file
+  template: scripts/makefile

instant_python/templates/project_structure/github/precommit_hook.yml

@@ -0,0 +1,4 @@
+- name: .pre-commit-config
+  type: file
+  extension: .yml
+  template: .pre-commit-config.yml

instant_python/templates/project_structure/logger.yml

@@ -0,0 +1,16 @@
+- name: logger
+  type: directory
+  python: True
+  children:
+    - name: json_formatter
+      type: file
+      extension: .py
+      template: logger/json_formatter.py
+    - name: file_logger
+      type: file
+      extension: .py
+      template: logger/file_logger.py
+    - name: file_rotating_handler
+      type: file
+      extension: .py
+      template: logger/file_rotating_handler.py

instant_python/templates/project_structure/macros.j2

@@ -0,0 +1,73 @@
+{#
+  Macro to include a template and indent its content
+
+  Args:
+    template_name: Name of the template file to include
+    indent: Number of spaces to indent the content
+#}
+{%- macro include_block(template_name, indent) -%}
+{%- set content -%}
+{%- include template_name -%}
+{%- endset -%}
+{{ content | indent(indent, true) }}
+{%- endmacro -%}
+
+{#
+  Renders a specific feature if it's enabled in template.built_in_features
+
+  Args:
+    feature_name: Name of the feature to check
+    template_path: Path to the template file to include
+    indent_level: Number of spaces to indent the content
+#}
+{%- macro render_feature_if_enabled(feature_name, template_path, indent=0) -%}
+{%- if feature_name in template.built_in_features -%}
+{{ include_block(template_path, indent) }}
+{%- endif -%}
+{%- endmacro -%}
+
+{#
+  Renders multiple features from a list
+
+  Args:
+    features: List of dicts with 'feature' and 'template' keys
+    indent_level: Number of spaces to indent the content
+
+  Example:
+    {% set features = [
+      {"feature": "event_bus", "template": "event_bus_domain.yml"},
+      {"feature": "value_objects", "template": "errors.yml"}
+    ] %}
+    {{ render_features(features, 8) }}
+#}
+{%- macro render_features(features, indent=0) -%}
+{%- set rendered_templates = [] -%}
+{%- for item in features -%}
+{%- if item.feature in template.built_in_features and item.template not in rendered_templates -%}
+{{ include_block(item.template, indent) }}
+{% set _ = rendered_templates.append(item.template) -%}
+{%- endif -%}
+{%- endfor -%}
+{%- endmacro -%}
+
+{#
+  Conditional wrapper for children nodes
+  Only renders the "children:" key and content if there are active features
+
+  Args:
+    features: List of features to check
+    indent_level: Base indentation for the children key
+#}
+{%- macro render_children_for(features, indent=0) -%}
+{%- set active_features = [] -%}
+{%- for item in features -%}
+{%- if item.feature in template.built_in_features -%}
+{%- set _ = active_features.append(item) -%}
+{%- endif -%}
+{%- endfor -%}
+{%- if active_features | length > 0 %}
+{{ "children:" | indent(indent, true) }}
+{{ render_features(active_features, indent + 2) }}
+{%- endif -%}
+{%- endmacro -%}
+

instant_python/templates/project_structure/persistence/alembic_migrator.yml

@@ -0,0 +1,6 @@
+{% import "macros.j2" as macros with context %}
+{{ macros.include_block("persistence/persistence.yml", 0) }}
+- name: alembic_migrator
+  type: file
+  extension: .py
+  template: persistence/alembic_migrator.py

instant_python/templates/project_structure/persistence/async_alembic.yml

@@ -0,0 +1,27 @@
+- name: alembic
+  type: file
+  extension: .ini
+  template: persistence/async/alembic.ini
+- name: migrations
+  type: directory
+  children:
+    - name: versions
+      type: directory
+    - name: README
+      type: file
+      extension: .md
+      template: persistence/async/README.md
+    - name: env
+      type: file
+      extension: .py
+      template: persistence/async/env.py
+    {% if "async_sqlalchemy" in template.built_in_features %}
+    - name: models_metadata
+      type: file
+      extension: .py
+      template: persistence/async/models_metadata.py
+    {% endif %}
+    - name: script
+      type: file
+      extension: .py.mako
+      template: persistence/async/script.py.mako

instant_python/templates/project_structure/persistence/async_engine_conftest.yml

@@ -0,0 +1,4 @@
+- name: conftest
+  type: file
+  extension: .py
+  template: persistence/async/async_engine_fixture.py

instant_python/templates/project_structure/persistence/async_sqlalchemy.yml

@@ -0,0 +1,14 @@
+{% import "macros.j2" as macros with context %}
+{{ macros.include_block("persistence/persistence.yml", 0) }}
+    - name: sqlalchemy
+      type: directory
+      python: True
+      children:
+        - name: base
+          type: file
+          extension: .py
+          template: persistence/base.py
+        - name: async_session
+          type: file
+          extension: .py
+          template: persistence/async/async_session.py

instant_python/templates/project_structure/persistence/persistence.yml

@@ -0,0 +1,8 @@
+- name: persistence
+  type: directory
+  python: True
+  children:
+    - name: postgres_settings
+      type: file
+      extension: .py
+      template: persistence/async/postgres_settings.py

instant_python/templates/project_structure/persistence/synchronous_sqlalchemy.yml

@@ -0,0 +1,20 @@
+- name: persistence
+  type: directory
+  python: True
+  children:
+    - name: sqlalchemy
+      type: directory
+      python: True
+      children:
+        - name: base
+          type: file
+          extension: .py
+          template: persistence/base.py
+        - name: session_maker
+          type: file
+          extension: .py
+          template: persistence/synchronous/session_maker.py
+        - name: sqlalchemy_repository
+          type: file
+          extension: .py
+          template: persistence/synchronous/sqlalchemy_repository.py

instant_python/templates/project_structure/standard_project/layers/source_features.yml

@@ -0,0 +1,13 @@
+{% import "macros.j2" as macros with context %}
+{%- set source_features = [
+  {"feature": "value_objects", "template": "errors.yml"},
+  {"feature": "event_bus", "template": "events/event_bus_domain.yml"},
+  {"feature": "event_bus", "template": "events/event_bus_infra.yml"},
+  {"feature": "logger", "template": "logger.yml"},
+  {"feature": "async_sqlalchemy", "template": "persistence/async_sqlalchemy.yml"},
+  {"feature": "async_alembic", "template": "persistence/alembic_migrator.yml"},
+  {"feature": "fastapi_application", "template": "fastapi/fastapi_app.yml"},
+  {"feature": "fastapi_application", "template": "fastapi/fastapi_infra.yml"},
+  {"feature": "fastapi_application", "template": "fastapi/fastapi_domain.yml"}
+] %}
+{{ macros.render_children_for(source_features, 2) }}

instant_python/templates/project_structure/standard_project/layers/test_event_bus.yml

@@ -0,0 +1,6 @@
+{% import "macros.j2" as macros with context %}
+- name: event
+  type: directory
+  python: True
+  children:
+{{ macros.include_block("events/mock_event_bus.yml", 4) }}

instant_python/templates/project_structure/standard_project/layers/test_features.yml

@@ -0,0 +1,6 @@
+{% import "macros.j2" as macros with context %}
+{%- set test_features = [
+  {"feature": "async_sqlalchemy", "template": "persistence/async_engine_conftest.yml"},
+  {"feature": "event_bus", "template": "standard_project/layers/test_event_bus.yml"}
+] %}
+{{ macros.render_children_for(test_features, 2) }}

instant_python/templates/project_structure/standard_project/main_structure.yml

@@ -0,0 +1,38 @@
+{% import "macros.j2" as macros with context %}
+{# === Core Project Structure === #}
+{{ macros.include_block("standard_project/source.yml", 0) }}
+{{ macros.include_block("standard_project/test.yml", 0) }}
+{# === Base Configuration Files === #}
+{{ macros.include_block("config_files/pyproject.yml", 0) }}
+{{ macros.include_block("config_files/python_version.yml", 0) }}
+{{ macros.include_block("documentation/license.yml", 0) }}
+{# === CI/CD and Automation Features === #}
+{% set ci_cd_features = [
+    {"feature": "github_actions", "template": "github/github_action.yml"},
+    {"feature": "github_actions", "template": "github/makefile.yml"},
+    {"feature": "github_issues_template", "template": "github/github_issues_template.yml"},
+    {"feature": "makefile", "template": "github/makefile.yml"},
+    {"feature": "precommit_hook", "template": "github/precommit_hook.yml"},
+    {"feature": "precommit_hook", "template": "github/makefile.yml"}
+] %}
+{{ macros.render_features(ci_cd_features, 0) }}
+{# === Git Features === #}
+{% if git.initialize %}
+{{ macros.include_block("config_files/gitignore.yml", 0) }}
+{{ macros.include_block("documentation/readme.yml", 0) }}
+{% endif %}
+{# === Testing and Type Checking === #}
+{% if dependencies | has_dependency("pytest") %}
+{{ macros.include_block("config_files/pytest.yml", 0) }}
+{% endif %}
+{% if dependencies | has_dependency("mypy") %}
+{{ macros.include_block("config_files/mypy.yml", 0) }}
+{% endif %}
+{# === Database Migration === #}
+{{ macros.render_feature_if_enabled("async_alembic", "persistence/async_alembic.yml", 0) }}
+{# === Documentation and Metadata === #}
+{% set doc_features = [
+    {"feature": "citation_file", "template": "documentation/citation.yml"},
+    {"feature": "security_file", "template": "documentation/security.yml"}
+] %}
+{{ macros.render_features(doc_features, 0) }}

instant_python/templates/project_structure/standard_project/source.yml

@@ -0,0 +1,5 @@
+{% import "macros.j2" as macros with context %}
+- name: {{ general.source_name }}
+  type: directory
+  python: True
+{{ macros.include_block("standard_project/layers/source_features.yml", 0) }}

instant_python/templates/project_structure/standard_project/test.yml

@@ -0,0 +1,5 @@
+{% import "macros.j2" as macros with context %}
+- name: test
+  type: directory
+  python: True
+{{ macros.include_block("standard_project/layers/test_features.yml", 0) }}