Configuration

Configuration Files

pyproject.toml

Primary configuration file for VCL projects.

[project]
name = "my-project"
version = "0.1.0"
dependencies = [
    "fastapi>=0.68.0",
    "uvicorn>=0.15.0",
]

[project.optional-dependencies]
dev = [
    "pytest>=6.0.0",
    "black>=21.0.0",
]

[tool.vcl]
python-version = "3.12"
template = "api"

.vclrc

User-specific configuration file.

default_template: api
python_version: 3.12
git_init: true
cache_dir: ~/.vcl/cache

Template Configuration

Custom Templates

Create custom project templates:

templates/
├── my-template/
│   ├── template.yaml
│   ├── {{project_name}}/
│   │   ├── __init__.py
│   │   └── main.py
│   └── README.md

Template Schema

name: my-template
description: Custom project template
variables:
  project_name:
    type: string
    description: Name of the project
  python_version:
    type: string
    default: "3.12"

Environment Variables

• VCL_HOME - VCL installation directory
• VCL_CACHE_DIR - Cache directory location
• VCL_TEMPLATE_PATH - Custom template directory
• VCL_CONFIG - Custom config file location

TODO & Updates Needed

• Document all configuration options
• Add template development guide
• Include advanced configuration examples
• Document CI/CD integration
• Add migration guide for configuration changes