Lewati ke konten utama

Pemecahan Masalah Konfigurasi

Configuration Troubleshooting

Project-owned

Pastikan file, table, key, type, path, dan precedence sesuai consumer runtime.

Command.config/custy/config.toml

Category

Pemecahan Masalah

Quick Command

locate -> parse -> resolve -> verify consumer

Configuration file tidak ditemukan​

Jalankan dari project root. File .config/custy/config.toml yang belum ada merupakan kondisi project yang belum diinisialisasi, bukan startup crash. Gunakan custy init; gunakan --force hanya setelah memahami file yang akan diganti.

TOML gagal diparse​

Periksa table header, quote, array, duplicate key, dan tipe nilai pada area yang disebut error. Bandingkan dengan generated template dan property reference tanpa mengganti customization lain.

Nilai efektif tidak sesuai​

Periksa CLI option terlebih dahulu, kemudian project config dan built-in fallback. Restart process setelah mengubah file karena loader melakukan cache per process.

Project tanpa directory app​

Generated configuration menggunakan automatic layout detection:

Path configuration yang direkomendasikan
toml
[tool.custy.project]
project_source = "auto"

[tool.custy.cli.paths]
version_file = "auto"

Mode auto mendukung layout Python, Node.js, mixed, dan generic, lalu menggunakan project root jika src/ atau app/ tidak tersedia. Jika configuration lama masih berisi project_source = "app" atau version_file = "app/__version__.py", nilai tersebut merupakan path eksplisit dan tetap strict. Ubah ke auto jika project memang tidak memiliki path itu.

Version target tidak ditemukan​

Path tool.custy.cli.paths.version_file yang eksplisit harus tersedia dan berupa file. Gunakan auto untuk mendeteksi Python __version__.py, static version dalam pyproject.toml, atau version dalam package.json. Project tanpa metadata yang didukung tetap valid dan dapat menggunakan Git-tag-only versioning.

Panduan terkait

Related Commands

Commands commonly used together with this command.