Aggrega Catalog (MappingLibrary) şeması
Üretilmiş başvuru. Elle düzenlemeyin; yayımlanmış JSON Schema’dan yeniden üretin.
Şema kimliği: https://aggrega.ai/schemas/mappinglibrary-v1beta1.schema.json
Recipes ve FeatureRecipes’in işleme zamanında valuesMapping: { $import: ... } aracılığıyla kullandığı, yeniden kullanılabilir Go şablon parçalarından oluşan bir koleksiyon. Katman 3 — Recipe’ler arası eşleme yeniden kullanımına ihtiyaç duyan kataloglar için isteğe bağlıdır. Tek yazım modu: yalnızca Go şablonları.
MappingLibrary varlıklarının yazımına ilişkin açıklamalı rehberlik için MappingLibrary yazım başvurusuna bakın; bu sayfa, o başvurunun tanımladığı yapısal şemayı belgeler.
Üst düzey tür: object
Özellikler
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | evet | Sabit: "aggrega.ai/v1beta1" |
kind | const “MappingLibrary” | evet | Sabit: "MappingLibrary" |
metadata | object | evet | |
spec | object | evet | MappingLibrary’nin içeriği. spec.mappings zorunludur ve en az bir girdi bildirmelidir. spec, additionalProperties: false taşır — zarf düzeyinde hiçbir paralel yazım modu kabul edilmez. Tek yazım modu yaklaşımı, Recipe işlemesini tekdüze tutar (baştan sona Go şablonu) ve içe aktarılan parçalar kullanılırken yazarları işleme ortasında değerlendirme modeli değiştirmeye zorlamaktan kaçınır. |
Ek özelliklere izin verilmez.
mappinglibrary.metadata
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
name | string | evet | Kütüphane için PascalCase tanımlayıcı. Yalın ad kimlik başvurusu ^[A-Z][A-Za-z0-9]*$. |
version | string | evet | Kütüphanenin katı Semantic Versioning sürümü (ör. 1.0.0). Bir tüketici bunu, yalın ad başvurusunda (:<version> asgari sürüm tabanı olarak öne sürebilir; çözümlenen sürüm Release başına kilit dosyasına aittir. Desen: ^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | hayır | Kütüphanenin neyi kapsadığına dair kısa bir özet. |
labels | string eşlemi | hayır | Yazar tarafından bildirilen etiketler. Derleyici içeriğe karşı tarafsızdır ve etiket değerlerini yorumlamaz: bunlar, kütüphaneyi okuyan herhangi bir şeyin eşleştirme yapabilmesi için taşınan opak meta verilerdir. |
annotations | string eşlemi | hayır | Yazar tarafından bildirilen ek açıklamalar. Etiketlerle aynı opak meta veri yaklaşımı. |
Ek özelliklere izin verilmez.
mappinglibrary.spec
MappingLibrary’nin içeriği. spec.mappings zorunludur ve en az bir girdi bildirmelidir. spec, additionalProperties: false taşır — zarf düzeyinde hiçbir paralel yazım modu kabul edilmez. Tek yazım modu yaklaşımı, Recipe işlemesini tekdüze tutar (baştan sona Go şablonu) ve içe aktarılan parçalar kullanılırken yazarları işleme ortasında değerlendirme modeli değiştirmeye zorlamaktan kaçınır.
| Özellik | Tür | Zorunlu | Açıklama |
|---|---|---|---|
mappings | string eşlemi | evet | Yeniden kullanılabilir Go şablon parçalarından oluşan adlandırılmış eşlem. Her girdinin gövdesi zarf doğrulaması için opaktır — içerik anlamı, kullanım zamanında Go şablon ayrıştırıcısı tarafından ele alınır. Anahtarlar: PascalCase tanımlayıcı. Girdi anahtarları standart başvuru URL’lerinde (#/mappings/<name>) görünür; zarf düzeyindeki kısıt, PascalCase olmayan anahtarların katalog ekosisteminde yayılmasını önler. Desen: ^[A-Z][A-Za-z0-9]*$. En az 1 girdi. |
Ek özelliklere izin verilmez.