Przejdź do treści

KRET LANGUAGE ACADEMY · DOKUMENTACJA ZE ŹRÓDEŁ

KretConfig — referencja składni

KretConfig — referencja składni

Status 1.0: `PROVISIONAL_VERSIONED` — zdefiniowane i przetestowane, za mało dowodów na stabilne 1.0; własna ścieżka rozwoju. Gramatyka/wersja: kconfig-1.0. Status języka nie nadaje uprawnień KCS ani prawa do działania w Production.

Opisane są wyłącznie konstrukcje potwierdzone implementacją SDK (i, gdzie zaznaczono, testami tej rundy).

schema / setting

Definicje ustawień.

schema {
    setting refresh.interval {
        type Duration
        default 5s
        min 1s
        max 1h
        hotReload true
    }
    setting api.token {
        type String
        secret true
    }
}
Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

  1. schema {Początek nazwanego bloku; jego pola odczytaj w powiązanej referencji.
  2. setting refresh.interval {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  3. type DurationOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  4. default 5sOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  5. min 1sOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  6. max 1hOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  7. hotReload trueOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  8. }Zamknięcie struktury otwartej we wcześniejszych liniach.
  9. setting api.token {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  10. type StringOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  11. secret trueOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  12. }Zamknięcie struktury otwartej we wcześniejszych liniach.
  13. }Zamknięcie struktury otwartej we wcześniejszych liniach.
CechaWartość
Parametry / typytype default min max allowed secret hotReload description
Wynik—
Wymaganiadefault wymagane (poza tajnymi, które go nie mogą mieć)
Ograniczeniasecret tylko String
Możliwe błędyKCS-CFG-0001…0005
Wprowadzonokconfig 1.0

profile / extends / vault

Profile z dziedziczeniem; sekret jako odwołanie do Vault.

profile default {
    refresh.interval 10s
    api.token vault "nazwa-wpisu"
}
profile gaming extends default {
    mode "performance"
}
Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

  1. profile default {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  2. refresh.interval 10sOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  3. api.token vault "nazwa-wpisu"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  4. }Zamknięcie struktury otwartej we wcześniejszych liniach.
  5. profile gaming extends default {Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  6. mode "performance"Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  7. }Zamknięcie struktury otwartej we wcześniejszych liniach.
CechaWartość
Parametry / typy—
Wynik—
Wymagania—
Ograniczeniacykl/nieznany profil bazowy = błąd
Możliwe błędyKCS-CFG-0007, 0201, 0202
Wprowadzonokconfig 1.0

policy

Ograniczenia hosta; zawsze wygrywają.

policy {
    lock telemetry.enabled false
    max fan.target 90%
    min refresh.interval 2s
}
Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

  1. policy {Początek nazwanego bloku; jego pola odczytaj w powiązanej referencji.
  2. lock telemetry.enabled falseOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  3. max fan.target 90%Odczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  4. min refresh.interval 2sOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  5. }Zamknięcie struktury otwartej we wcześniejszych liniach.
CechaWartość
Parametry / typylock, max, min
Wynik—
Wymaganiatylko w policy.kconfig hosta
Ograniczenia—
Możliwe błędyKCS-CFG-0203, 0204, 0006
Wprowadzonokconfig 1.0

config.get* (KretS)

Odczyt złożonej konfiguracji przez brokera.

use Kret.Config as config
let ms = config.getInt("refresh.interval")
Czytanie kodu linia po linii

Objaśnienia struktury nie są walidacją semantyczną. Szczegółowy kontrakt opisują referencje i README przykładu.

  1. use Kret.Config as configOdczytaj tę linię w kontekście otaczającego bloku i objaśnień autora poniżej.
  2. let ms = config.getInt("refresh.interval")Wiązanie wartości; typ i możliwość zmiany zależą od użytej deklaracji.
CechaWartość
Parametry / typyklucz
WynikString/Int/Float/Bool (Duration w ms)
Wymaganiabrak uprawnień; sekret zawsze odmowa
Ograniczenia—
Możliwe błędyKCS-CFG-0007
Wprowadzonokconfig 1.0

Źródło i wersja

Zweryfikowany import PUBLIC_CANDIDATE. Identyfikatory źródeł odnoszą się do eksportu i nie dają dostępu do plików serwera.

01_LANGUAGES/KretConfig/Documentation/SYNTAX_REFERENCE.md
SHA-256 37DAD20930D47D17DBE64774922CA26E9795E24CA8FB560289103E945DD2AE66

Zaloguj się na konto użytkownika, aby zapisywać postęp i zakładki. Konta obsługi mogą czytać bez zapisu postępu. Logowanie →

Wybierz, co możemy zapamiętać w tej przeglądarce. Możesz zmienić decyzję w każdej chwili.

Polityka prywatności