Is there an existing issue for this?

• I have searched the existing issues

Current Behavior

Environment variable sourcing uses the current working directory to look for .env files.

Desired Behavior

It would be nicer to use the codebase root as the starting point to look for the files

Anything else?

It might be better to have a separate(?) config format - .nskitconf that can be put at the root?

Add some example/useful mkdocs templating to the package recipes.
Based on the nskit documentation approach, implement a simple mkdocs.yml, docs/source and stub files + mike
Update nox to include mike handling (for on and off CI)

Is there an existing issue for this?

• I have searched the existing issues

Current Behavior

Unexpected validation errors on codebase creation.

With a .env configured, get

ValidationError: 6 validation errors for Codebase
settings.vcs_provider
  Value error, None is not a valid ProviderEnum [type=value_error, input_value=None, input_type=NoneType]
    For further information visit https://errors.pydantic.dev/2.6/v/value_error
settings.nskit_codebase_vcs_provider
  Extra inputs are not permitted [type=extra_forbidden, input_value='****', input_type=str]
    For further information visit https://errors.pydantic.dev/2.6/v/extra_forbidden
settings.github_organisation
  Extra inputs are not permitted [type=extra_forbidden, input_value='*****', input_type=str]
    For further information visit https://errors.pydantic.dev/2.6/v/extra_forbidden
settings.github_token
  Extra inputs are not permitted [type=extra_forbidden, input_value='****', input_type=str]
    For further information visit https://errors.pydantic.dev/2.6/v/extra_forbidden
settings.github_interactive
  Extra inputs are not permitted [type=extra_forbidden, input_value='****', input_type=str]
    For further information visit https://errors.pydantic.dev/2.6/v/extra_forbidden
namespace_validation_repo
  Value error, 'NoneType' object has no attribute 'namespace_validation_repo' [type=value_error, input_value=None, input_type=NoneType]
    For further information visit https://errors.pydantic.dev/2.6/v/value_error

Expected Behavior

It should ignore extras from the env file when creating

Steps To Reproduce

With version 0.1.1, try to create a codebase with a .env file configured with unexpected variables

Environment

- OS: Mac OS
- Python: 3.11
- library version: 0.1.1

Anything else?

No response

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update dependency pydantic-settings to >=2.3.0, <2.4.0
• Update dependabot/fetch-metadata action to v2
• Update tj-actions/changed-files action to v44
• Click on this checkbox to rebase all open PRs at once

Detected dependencies

• Check this box to trigger a request for Renovate to run again on this repository

The Jinja2 environment is currently implemented specifically for nskit.mixer. It would be great to add in custom extensions for templates etc.

Suggested Implementation

Define an entrypoint for adding extensions to the entrypoint - https://jinja.palletsprojects.com/en/3.0.x/extensions/#adding-extensions

Although there are a lot of Environment options:

      block_start_string
      block_end_string
      variable_start_string
      variable_end_string
      comment_start_string
      comment_end_string
      line_statement_prefix
      line_comment_prefix
      trim_blocks
      lstrip_blocks
      newline_sequence
      keep_trailing_newline
      extensions
      optimized
      undefined
      finalize
      autoescape
      loader
      cache_size
      auto_reload
      bytecode_cache
      enable_as

There are not any that will need customizing by specific implementations, but to keep the extensibility/reusability, we will also create a mechanism to define the Environment externally and provide it into the mixer methods (separate to the extensions part)

nskit.mixer.environment.extensions

Entrypoint to define specific extensions to be loaded (as strings). Providing library needs to make sure they are installed as dependencies.

Process the extensions and reduce them to a set of unique extensions.

nskit.mixer.environment.factory

Environment creator method that provides customisable environment creation. Set through NSKIT_MIXER_ENVIRONMENT_FACTORY environment variable, and run at first use of the environment object.