Configuration File
Configuration File
Essential
Bedakan packaged initialization source milik Custy dari editable configuration milik project Anda.
Command
custy initCategory
Configuration
Quick Command
custy init [--mode config] [--ask | --force]Ringkasan
Custy menyertakan app/templates/config.toml di dalam application package.
Saat initialization, Custy menyalin isinya ke .config/custy/config.toml.
Pengguna mengedit project copy tersebut dan tidak memerlukan akses ke installed
source file.
Ownership
Properties
| Property | Type | Description | Default | Required |
|---|---|---|---|---|
app/templates/config.toml | Application source | Dikemas bersama Custy dan digunakan untuk membuat project configuration baru. Application upgrade dapat menggantinya. | - | No |
.config/custy/config.toml | Project-owned copy | Dimuat oleh commands dan ditujukan untuk team-specific edits, review, serta version control. | - | No |
app/templates/changelog/changelog.j2 | Application source | Packaged source untuk default changelog layout. | - | No |
.config/custy/templates/changelog/changelog.j2 | Project-owned copy | Editable Jinja template yang dimuat melalui configured path. | - | No |
Packaged dan generated configuration saat ini memiliki logical TOML content yang sama. Byte hash dapat berbeda karena line-ending conversion.
Write Behavior
Workflow Timeline
1
Resource belum ada
Custy membuatnya dari packaged source.
2
Resource sudah ada, normal mode
Custy mempertahankan project copy dan melewati replacement.
3
Resource sudah ada dengan --ask
Custy meminta konfirmasi sebelum mengganti setiap file.
4
Resource sudah ada dengan --force
Custy mengganti selected resources tanpa prompt.
TOML Root dan Loading
Required namespace shape
toml[tool.custy]
[tool.custy.project]
project_source = "auto"
[tool.custy.cli.execution]
dry_run = false- Central loader menyediakan values di bawah
[tool.custy]. - Missing configuration diperlakukan sebagai project yang belum diinisialisasi
dan memuat empty mapping. Gunakan
custy initketika project-owned defaults diperlukan. - Invalid TOML menghasilkan configuration error.
- Relative paths umumnya dievaluasi dari current working directory.
- Custy process baru memuat ulang perubahan pada file.
- Jangan simpan secret values di project configuration. Credential policy dan external token filenames boleh dikonfigurasikan di sana, tetapi isi token harus berada di external credential directory atau environment variable.