कॉमन एक्सप्रेशन लैंग्वेज (सीईएल) एपीआई का रेफ़रंस

यह दस्तावेज़, कॉमन एक्सप्रेशन लैंग्वेज (सीईएल) के लिए, यूनिफ़ाइड एपीआई दस्तावेज़ के रेफ़रंस के तौर पर काम करता है. इसमें सभी मैक्रो, ऑपरेटर, और स्टैंडर्ड फ़ंक्शन की सूची दी गई है. साथ ही, आधिकारिक CEL स्टैक में उनके सिग्नेचर, व्यवहार, और सहायता की स्थिति के बारे में बताया गया है.

भाषा के व्यवहार और स्पेसिफ़िकेशन के बारे में ज़्यादा जानने के लिए, CEL भाषा की परिभाषा देखें.

स्टैक किए गए वर्शन

यह रेफ़रंस दस्तावेज़, CEL स्टैक के इन वर्शन पर आधारित है:

  • CEL Go: v0.32.0 (और इसके बाद के वर्शन)
  • CEL C++: v0.16.1
  • CEL Java: v0.14.0
  • CEL Python: v0.1.3
  • CEL C: डेवलपमेंट स्नैपशॉट (अभी रिलीज़ नहीं हुआ है)

GitHub Mirrors

CEL के आधिकारिक वर्शन, GitHub पर cel-expr संगठन के तहत उपलब्ध हैं:

1. कोर मैक्रो

ये बिल्ट-इन मैक्रो हैं, जिन्हें कंपाइल करने के समय बढ़ाया जाता है.

मैक्रो जानकारी ऐप पर जाएं C++ Java Python C
has(container.field) इस फ़ंक्शन से यह पता चलता है कि मैसेज में कोई फ़ील्ड मौजूद है या मैप में कोई कुंजी मौजूद है.

सिग्नेचर:
has(container.field) -> bool

उदाहरण:
has(request.auth.claims.email)		 ✓ ✓ ✓ ✓ ✓
list.all(var, predicate) यह फ़ंक्शन, यह जांच करता है कि किसी सूची में मौजूद सभी एलिमेंट, किसी शर्त को पूरा करते हैं या नहीं.

सिग्नेचर:
list.all(var, predicate) -> bool

उदाहरण:
[1, 2, 3].all(x, x > 0) // true		 ✓ ✓ ✓ ✓ ✓¹
list.exists(var, predicate) इस फ़ंक्शन से यह पता चलता है कि सूची में मौजूद कम से कम एक एलिमेंट, शर्त को पूरा करता है या नहीं.

सिग्नेचर:
list.exists(var, predicate) -> bool

उदाहरण:
[1, 2, 3].exists(x, x > 2) // true		 ✓ ✓ ✓ ✓ ✓¹
list.exists_one(var, predicate) यह फ़ंक्शन जांच करता है कि सूची में मौजूद सिर्फ़ एक एलिमेंट, शर्त को पूरा करता है या नहीं.

सिग्नेचर:
list.exists_one(var, predicate) -> bool

उदाहरण:
[1, 2, 3].exists_one(x, x == 2) // true		 ✓ ✓ ✓ ✓ ✓¹
list.filter(var, predicate) यह फ़ंक्शन, किसी शर्त के आधार पर सूची के एलिमेंट फ़िल्टर करता है.

सिग्नेचर:
list.filter(var, predicate) -> list

उदाहरण:
[1, 2, 3].filter(x, x > 1) // [2, 3]		 ✓ ✓ ✓ ✓ ✓¹
list.map(var, transform) यह फ़ंक्शन, एक्सप्रेशन का इस्तेमाल करके सूची के हर एलिमेंट में बदलाव करता है.

सिग्नेचर:
list.map(var, transform) -> list

उदाहरण:
[1, 2, 3].map(x, x * 2) // [2, 4, 6]		 ✓ ✓ ✓ ✓ ✓¹
list.map(var, filter, transform) यह फ़िल्टर प्रेडिकेट की शर्त पूरी करने वाले, सूची के एलिमेंट को बदलता है.

सिग्नेचर:
list.map(var, filter, transform) -> list

उदाहरण:
[1, 2, 3].map(x, x > 1, x * 2) // [4, 6]		 ✓ ✓ ✓ ✓ ✓¹

¹ C रनटाइम में काम करता है, क्योंकि होस्ट कंपाइलर, कंपाइलेशन के दौरान मैक्रो को कंप्रीहेंशन में बदल देता है.

2. कोर ऑपरेटर

ऑपरेटर जानकारी ऐप पर जाएं C++ Java Python C
अंकगणित (+, -, *, /, %) स्टैंडर्ड अंकगणितीय ऑपरेशनों के लिए. निषेध (-x) और पहचान (+x). सूची संयोजन (list + list) Go, C++, Java और Python में समर्थित है.

हस्ताक्षर:
T + T -> T
T - T -> T
T * T -> T
T / T -> T
T % T -> T
-T -> T
+T -> T
list + list -> list

उदाहरण:
1 + 2 * 3 // 7
[1] + [2] // [1, 2]		 ✓ ✓ ✓ ✓ ✓²
तुलना (==, !=, <, <=, >, >=) स्टैंडर्ड कंपैरिज़न. संख्याओं की तुलना अलग-अलग तरह से की जाती है. जैसे, 1 == 1.0.

सिग्नेचर:
T == T -> bool
T != T -> bool
T < T -> bool
T <= T -> bool
T > T -> bool
T >= T -> bool

उदाहरण:
x < 42.0
1 == 1.0 // true		 ✓ ✓ ✓ ✓ ✓
लॉजिकल (!, &&, ||, ? :) तार्किक NOT, AND, OR और त्रिपक्षीय सशर्त कथन. और/या शॉर्ट-सर्किट मूल्यांकन का उपयोग करें.

हस्ताक्षर:
!bool -> bool
bool && bool -> bool
bool || bool -> bool
bool ? T : T -> T

उदाहरण:
x > 0 ? "positive" : "non-positive"		 ✓ ✓ ✓ ✓ ✓
अनुक्रमण ([]) सूची के तत्व को इंडेक्स द्वारा एक्सेस करें, या मैप में लुकअप कुंजी का उपयोग करें.

हस्ताक्षर:
list[int] -> T
map[K] -> V

उदाहरण:
tags[0]
users['john']		 ✓ ✓ ✓ ✓ ✓
सदस्यता (in) जांचें कि तत्व किसी सूची में है या कुंजी किसी मानचित्र में है.

हस्ताक्षर:
T in list -> bool
K in map -> bool

उदाहरण:
'admin' in roles		 ✓ ✓ ✓ ✓ ✓

² सूची संयोजन (list + list) सी रनटाइम में समर्थित नहीं है, हालांकि अन्य अंकगणितीय ऑपरेटर समर्थित हैं.

3. मुख्य फ़ंक्शन

सामान्य और स्ट्रिंग फ़ंक्शन

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
size यह फ़ंक्शन, स्ट्रिंग (वर्ण), बाइट, सूची या मैप का साइज़ दिखाता है.

सिग्नेचर:
size(T) -> int (जहां T, string, bytes, list या map है)

उदाहरण:
size("hello") // 5		 ✓ ✓ ✓ ✓ ✓
contains यह फ़ंक्शन बताता है कि स्ट्रिंग में सबस्ट्रिंग शामिल है या नहीं.

सिग्नेचर:
string.contains(string) -> bool

उदाहरण:
"hello".contains("ell") // true		 ✓ ✓ ✓ ✓ ✓
startsWith यह फ़ंक्शन बताता है कि स्ट्रिंग, प्रीफ़िक्स से शुरू होती है या नहीं.

सिग्नेचर:
string.startsWith(string) -> bool

उदाहरण:
"hello".startsWith("he") // true		 ✓ ✓ ✓ ✓ ✓
endsWith यह फ़ंक्शन बताता है कि स्ट्रिंग, प्रत्यय से खत्म होती है या नहीं.

सिग्नेचर:
string.endsWith(string) -> bool

उदाहरण:
"hello".endsWith("lo") // true		 ✓ ✓ ✓ ✓ ✓
matches यह फ़ंक्शन बताता है कि स्ट्रिंग, RE2 रेगुलर एक्सप्रेशन से मेल खाती है या नहीं.

सिग्नेचर:
string.matches(string) -> bool

उदाहरण:
"123".matches(r"^\d+$") // true		 ✓ ✓ ✓ ✓ ✓

तारीख और समय चुनने वाले फ़ंक्शन

ये फ़ंक्शन, google.protobuf.Timestamp या google.protobuf.Duration से कॉम्पोनेंट निकालते हैं.

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
getFullYear इससे साल की जानकारी चार अंकों में मिलती है.

सिग्नेचर:
timestamp.getFullYear([tz]) -> int

उदाहरण:
timestamp("2026-07-23T00:00:00Z").getFullYear() // 2026		 ✓ ✓ ✓ ✓ ✗
getMonth महीना (0-11) दिखाता है.

सिग्नेचर:
timestamp.getMonth([tz]) -> int

उदाहरण:
timestamp("2026-07-23T00:00:00Z").getMonth() // 6		 ✓ ✓ ✓ ✓ ✗
getDayOfMonth महीने का दिन (1-31) दिखाता है.

सिग्नेचर:
timestamp.getDayOfMonth([tz]) -> int

उदाहरण:
timestamp("2026-07-23T00:00:00Z").getDayOfMonth() // 23		 ✓ ✓ ✓ ✓ ✗
getDayOfWeek इसमें हफ़्ते का दिन (0 = रविवार) दिखता है.

सिग्नेचर:
timestamp.getDayOfWeek([tz]) -> int

उदाहरण:
timestamp("2026-07-23T00:00:00Z").getDayOfWeek() // 4		 ✓ ✓ ✓ ✓ ✗
getDayOfYear इसमें साल का दिन (0 से 365) दिखता है.

सिग्नेचर:
timestamp.getDayOfYear([tz]) -> int

उदाहरण:
timestamp("2026-07-23T00:00:00Z").getDayOfYear() // 203		 ✓ ✓ ✓ ✓ ✗
getHours यह फ़ंक्शन, घंटे (0-23) दिखाता है.

सिग्नेचर:
timestamp.getHours([tz]) -> int
duration.getHours() -> int

उदाहरण:
duration("1h30m").getHours() // 1		 ✓ ✓ ✓ ✓ ✗
getMinutes यह फ़ंक्शन, मिनट (0-59) दिखाता है.

सिग्नेचर:
timestamp.getMinutes([tz]) -> int
duration.getMinutes() -> int

उदाहरण:
duration("1h30m").getMinutes() // 30		 ✓ ✓ ✓ ✓ ✗
getSeconds यह फ़ंक्शन, सेकंड (0 से 59) दिखाता है.

सिग्नेचर:
timestamp.getSeconds([tz]) -> int
duration.getSeconds() -> int

उदाहरण:
duration("1h30m45s").getSeconds() // 45		 ✓ ✓ ✓ ✓ ✗
getMilliseconds यह फ़ंक्शन, मिलीसेकंड (0-999) दिखाता है.

सिग्नेचर:
timestamp.getMilliseconds([tz]) -> int
duration.getMilliseconds() -> int

उदाहरण:
duration("1.5s").getMilliseconds() // 500		 ✓ ✓ ✓ ✓ ✗

टाइप कन्वर्ज़न

लक्ष्य प्रकार जानकारी ऐप पर जाएं C++ Java Python C
bool बूलियन में बदलता है.

सिग्नेचर:
bool(bool) -> bool
bool(string) -> bool

उदाहरण:
bool("true") // true		 ✓ ✓ ✓ ✓ ✓
bytes बाइट में बदलता है.

हस्ताक्षर:
bytes(bytes) -> bytes
bytes(string) -> bytes

उदाहरण:
bytes("hello") // b"hello"		 ✓ ✓ ✓ ✓ ✓
double डबल-प्रिसिशन फ़्लोट में बदलता है.

सिग्नेचर:
double(double) -> double
double(int) -> double
double(uint) -> double
double(string) -> double

उदाहरण:
double(1) // 1.0		 ✓ ✓ ✓ ✓ ✓
duration इस फ़ंक्शन का इस्तेमाल करके, किसी वैल्यू को अवधि में बदला जा सकता है.

सिग्नेचर:
duration(duration) -> duration
duration(string) -> duration

उदाहरण:
duration("1.5s") // 1.5s duration		 ✓ ✓ ✓ ✓ ✓
int यह फ़ंक्शन, 64-बिट के पॉज़िटिव/नेगेटिव रेंज वाले इंटिजर में बदलता है.

सिग्नेचर:
int(int) -> int
int(uint) -> int
int(double) -> int (शून्य पर राउंड करता है)
int(string) -> int
int(timestamp) -> int (epoch के बाद के सेकंड)

उदाहरण:
int(1.5) // 1		 ✓ ✓ ✓ ✓ ✓
string यह फ़ंक्शन, वैल्यू को स्ट्रिंग में बदलता है.

सिग्नेचर:
string(T) -> string (bool, int, uint, double, bytes, timestamp, duration के साथ काम करता है)

उदाहरण:
string(1.5) // "1.5"		 ✓ ✓ ✓ ✓ ✓
timestamp टाइमस्टैंप में बदलता है.

हस्ताक्षर:
timestamp(timestamp) -> timestamp
timestamp(string) -> timestamp (RFC3339)

उदाहरण:
timestamp("2026-07-23T00:00:00Z")		 ✓ ✓ ✓ ✓ ✓
uint यह फ़ंक्शन, वैल्यू को 64-बिट के पॉज़िटिव इंटिजर में बदलता है.

सिग्नेचर:
uint(uint) -> uint
uint(int) -> uint
uint(double) -> uint
uint(string) -> uint

उदाहरण:
uint(1) // 1u		 ✓ ✓ ✓ ✓ ✓
dyn यह वैल्यू को टाइप-चेक करने के लिए डाइनैमिक टाइप में बदलता है.

सिग्नेचर:
dyn(T) -> dyn

उदाहरण:
dyn([1, "two"])		 ✓ ✓ ✓ ✓ ✗
type यह फ़ंक्शन, वैल्यू का टाइप दिखाता है.

सिग्नेचर:
type(T) -> type

उदाहरण:
type(1) // int		 ✓ ✓ ✓ ✓ ✗

4. एक्सटेंशन (लाइब्रेरी)

Bindings Library

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
cel.bind यह फ़ंक्शन, डुप्लीकेट आकलन से बचने के लिए लोकल वैरिएबल को बाइंड करता है.

सिग्नेचर:
cel.bind(varName, initExpr, resultExpr) -> T

उदाहरण:
cel.bind(x, a + b, x * x)		 ✓ (v0.15.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗

चालू करने का तरीका

  • जाओ: ext.Bindings() को cel.NewEnv() पर पास करो.
  • C++: CompilerBuilder में BindingsCompilerLibrary() जोड़ें. (रनटाइम अपने-आप मैनेज होता है).
  • Java: CelCompiler और CelRuntime बिल्डर में CelExtensions.bindings() जोड़ें.
  • Python: cel_expr_python.ext.ext_bindings को इंपोर्ट करें और cel.NewEnv(extensions=[...]) में ExtBindings() का इस्तेमाल करें.

Encoders Library

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
base64.encode यह फ़ंक्शन, बाइट को base64 स्ट्रिंग में बदलता है.

हस्ताक्षर:
base64.encode(bytes) -> string

उदाहरण:
base64.encode(b"hello") // "aGVsbG8="		 ✓ (v0.6.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
base64.decode यह फ़ंक्शन, base64 स्ट्रिंग को बाइट में डिकोड करता है. गलत इनपुट देने पर गड़बड़ी का मैसेज दिखाता है.

हस्ताक्षर:
base64.decode(string) -> bytes

उदाहरण:
base64.decode("aGVsbG8=") // b"hello"		 ✓ (v0.6.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
json.encode यह फ़ंक्शन, CEL वैल्यू को JSON स्ट्रिंग में बदलता है.

हस्ताक्षर:
json.encode(dyn) -> string

उदाहरण:
json.encode([1, 2]) // "[1,2]"		 ✓ (v0.29.0) ✗ ✗ ✗ ✗

चालू करने का तरीका

  • जाओ: ext.Encoders() को cel.NewEnv() पर पास करो.
  • C++:
  • Java: CelCompiler और CelRuntime बिल्डर में CelExtensions.encoders() जोड़ें.
  • Python: cel_expr_python.ext.ext_encoders को इंपोर्ट करें और cel.NewEnv(extensions=[...]) में ExtEncoders() का इस्तेमाल करें.

गणित लाइब्रेरी

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
math.greatest यह फ़ंक्शन, संख्या वाले आर्ग्युमेंट (या संख्याओं की सूची) में से सबसे बड़ी संख्या दिखाता है.

सिग्नेचर:
math.greatest(arg, ...) -> T

उदाहरण:
math.greatest(1, 3, 2) // 3		 ✓ (v0.13.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
math.least यह फ़ंक्शन, संख्या वाले आर्ग्युमेंट (या संख्याओं की सूची) में से सबसे छोटी वैल्यू दिखाता है.

सिग्नेचर:
math.least(arg, ...) -> T

उदाहरण:
math.least([1, 3, 2]) // 1		 ✓ (v0.13.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
math.abs ऐब्सलूट वैल्यू.

सिग्नेचर:
math.abs(T) -> T (int, uint, double के साथ काम करता है)

उदाहरण:
math.abs(-1) // 1		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.sqrt वर्गमूल.

हस्ताक्षर:
math.sqrt(T) -> double (int, uint, double के साथ काम करता है)

उदाहरण:
math.sqrt(9) // 3.0		 ✓ (v0.25.1) ✓ (v0.12.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
math.bitAnd बिटवाइज़ AND.

हस्ताक्षर:
math.bitAnd(T, T) -> T (int, uint के साथ काम करता है)

उदाहरण:
math.bitAnd(5, 3) // 1		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.bitOr बिट के हिसाब से OR.

हस्ताक्षर:
math.bitOr(T, T) -> T (int, uint के साथ काम करता है)

उदाहरण:
math.bitOr(5, 3) // 7		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.bitXor बिटवाइज़ XOR.

सिग्नेचर:
math.bitXor(T, T) -> T (int, uint के साथ काम करता है)

उदाहरण:
math.bitXor(5, 3) // 6		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.bitNot बिटवाइज़ NOT.

सिग्नेचर:
math.bitNot(T) -> T (int, uint के साथ काम करता है)

उदाहरण:
math.bitNot(1) // -2		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.bitShiftLeft बाइटवाइज़ तरीके से बाईं ओर शिफ्ट करता है.

सिग्नेचर:
math.bitShiftLeft(T, int) -> T (int, uint के साथ काम करता है)

उदाहरण:
math.bitShiftLeft(1, 2) // 4		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.bitShiftRight बिटवाइज़ राइट शिफ़्ट.

सिग्नेचर:
math.bitShiftRight(T, int) -> T (int और uint के साथ काम करता है)

उदाहरण:
math.bitShiftRight(4, 2) // 1		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.ceil सीलिंग राउंडिंग.

सिग्नेचर:
math.ceil(double) -> double

उदाहरण:
math.ceil(1.2) // 2.0		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.floor फ़्लोर राउंडिंग.

सिग्नेचर:
math.floor(double) -> double

उदाहरण:
math.floor(1.8) // 1.0		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.round सबसे नज़दीकी पूर्णांक में बदलना.

सिग्नेचर:
math.round(double) -> double

उदाहरण:
math.round(1.5) // 2.0		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.trunc शून्य की ओर पूर्णांक बनाना.

हस्ताक्षर:
math.trunc(double) -> double

उदाहरण:
math.trunc(-1.8) // -1.0		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.isInf यह फ़ंक्शन, यह जांच करता है कि डबल वैल्यू पॉज़िटिव या नेगेटिव इनफ़िनिटी है या नहीं.

सिग्नेचर:
math.isInf(double) -> bool

उदाहरण:
math.isInf(1.0/0.0) // true		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.isNaN इस फ़ंक्शन से यह पता चलता है कि double, NaN है या नहीं.

सिग्नेचर:
math.isNaN(double) -> bool

उदाहरण:
math.isNaN(0.0/0.0) // true		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.isFinite यह जांच करता है कि डबल फ़ाइनिट है या नहीं.

सिग्नेचर:
math.isFinite(double) -> bool

उदाहरण:
math.isFinite(1.2) // true		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
math.sign यह फ़ंक्शन, वैल्यू का साइन (-1, 0 या 1) दिखाता है.

सिग्नेचर:
math.sign(T) -> T (int, uint, double के साथ काम करता है)

उदाहरण:
math.sign(-42) // -1		 ✓ (v0.21.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗

चालू करने का तरीका

  • जाओ: ext.Math() को cel.NewEnv() पर पास करो.
  • C++:
  • Java: CelCompiler और CelRuntime बिल्डर में CelExtensions.math() जोड़ें.
  • Python: cel_expr_python.ext.ext_math को इंपोर्ट करें और cel.NewEnv(extensions=[...]) में ExtMath() का इस्तेमाल करें.

Protos Library

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
proto.getExt proto2 एक्सटेंशन फ़ील्ड या डिफ़ॉल्ट वैल्यू को वापस लाता है.

हस्ताक्षर:
proto.getExt(msg, extName) -> T

उदाहरण:
proto.getExt(msg, google.api.expr.test.int32_ext)		 ✓ (v0.13.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
proto.hasExt यह फ़ंक्शन, यह जांच करता है कि proto2 एक्सटेंशन फ़ील्ड सेट है या नहीं.

सिग्नेचर:
proto.hasExt(msg, extName) -> bool

उदाहरण:
proto.hasExt(msg, google.api.expr.test.int32_ext)		 ✓ (v0.13.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗

चालू करने का तरीका

  • जाओ: ext.Protos() को cel.NewEnv() पर पास करो.
  • C++: CompilerBuilder में ProtoExtCompilerLibrary() जोड़ें. (रनटाइम अपने-आप मैनेज होता है).
  • Java: CelCompiler और CelRuntime बिल्डर में CelExtensions.protos() जोड़ें.
  • Python: cel_expr_python.ext.ext_proto को इंपोर्ट करें और cel.NewEnv(extensions=[...]) में ExtProto() का इस्तेमाल करें.

सूचियों की लाइब्रेरी

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
distinct यह फ़ंक्शन, अलग-अलग एलिमेंट दिखाता है.

सिग्नेचर:
list.distinct() -> list

उदाहरण:
[1, 2, 2].distinct() // [1, 2]		 ✓ (v0.22.0) ✓ (v0.11.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
flatten यह फ़ंक्शन, नेस्ट की गई सूचियों को फ़्लैट करता है.

सिग्नेचर:
list.flatten([depth]) -> list

उदाहरण:
[[1], [2, 3]].flatten() // [1, 2, 3]		 ✓ (v0.22.0) ✓ (v0.11.0) ✓ (v0.7.1) ✓ (v0.1.1) ✗
lists.range पूर्णांकों की सूची दिखाता है [0, ..., n-1].

सिग्नेचर:
lists.range(int) -> list(int)

उदाहरण:
lists.range(3) // [0, 1, 2]		 ✓ (v0.22.0) ✓ (v0.11.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
reverse इससे सूची का क्रम उलट जाता है.

सिग्नेचर:
list.reverse() -> list

उदाहरण:
[1, 2].reverse() // [2, 1]		 ✓ (v0.22.0) ✓ (v0.11.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
slice यह सब-लिस्ट दिखाता है. इसमें शुरू होने वाला इंडेक्स शामिल होता है, लेकिन खत्म होने वाला इंडेक्स शामिल नहीं होता.

हस्ताक्षर:
list.slice(start, end) -> list

उदाहरण:
[1, 2, 3].slice(1, 3) // [2, 3]		 ✓ (v0.17.0) ✓ (v0.11.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
sort तुलना किए जा सकने वाले एलिमेंट की सूची को क्रम से लगाता है.

सिग्नेचर:
list.sort() -> list

उदाहरण:
[3, 1, 2].sort() // [1, 2, 3]		 ✓ (v0.22.0) ✓ (v0.11.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
sortBy यह फ़ंक्शन, एक्सप्रेशन से तय की गई कुंजी के हिसाब से सूची को क्रम से लगाता है.

सिग्नेचर:
list.sortBy(var, expr) -> list

उदाहरण:
[{"val": 2}, {"val": 1}].sortBy(x, x.val) // [{"val": 1}, {"val": 2}]		 ✓ (v0.22.0) ✓ (v0.11.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
first पहले एलिमेंट को 'ज़रूरी नहीं है' के तौर पर दिखाता है. इसके लिए, Optional एक्सटेंशन की ज़रूरत होती है.

हस्ताक्षर:
list.first() -> optional

उदाहरण:
[1, 2].first() // optional(1)		 ✓ (v0.23.0) ✓ (v0.15.0) ✓ (v0.11.0) ✓ (v0.1.2) ✗
last आखिरी एलिमेंट को वैकल्पिक के तौर पर दिखाता है. इसके लिए, Optional एक्सटेंशन की ज़रूरत होती है.

हस्ताक्षर:
list.last() -> optional

उदाहरण:
[1, 2].last() // optional(2)		 ✓ (v0.23.0) ✓ (v0.15.0) ✓ (v0.11.0) ✓ (v0.1.2) ✗

चालू करने का तरीका

  • जाओ: ext.Lists() को cel.NewEnv() पर पास करो.
  • C++:
  • Java: CelCompiler और CelRuntime बिल्डर में CelExtensions.lists() जोड़ें.
  • Python: extensions सूची में lists जोड़कर, cel.EnvConfig के ज़रिए इसे चालू करें.

सेट की लाइब्रेरी

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
sets.contains यह फ़ंक्शन, यह पता लगाता है कि list1 में list2 के सभी एलिमेंट शामिल हैं या नहीं.

सिग्नेचर:
sets.contains(list1, list2) -> bool

उदाहरण:
sets.contains([1, 2], [1]) // true		 ✓ (v0.15.0) ✓ (v0.10.0) ✓ (v0.6.0) ✓ (v0.1.1) ✗
sets.equivalent यह फ़ंक्शन, यह पता लगाता है कि सूचियां सेट के हिसाब से बराबर हैं या नहीं. इसका मतलब है कि उनमें एक जैसे यूनीक एलिमेंट शामिल हैं या नहीं.

सिग्नेचर:
sets.equivalent(list1, list2) -> bool

उदाहरण:
sets.equivalent([1, 2], [2, 1, 1]) // true		 ✓ (v0.15.0) ✓ (v0.10.0) ✓ (v0.6.0) ✓ (v0.1.1) ✗
sets.intersects यह फ़ंक्शन, यह पता लगाता है कि सूचियों में कम से कम एक एलिमेंट शेयर किया गया है या नहीं.

सिग्नेचर:
sets.intersects(list1, list2) -> bool

उदाहरण:
sets.intersects([1, 2], [2, 3]) // true		 ✓ (v0.15.0) ✓ (v0.10.0) ✓ (v0.6.0) ✓ (v0.1.1) ✗

चालू करने का तरीका

  • जाओ: ext.Sets() को cel.NewEnv() पर पास करो.
  • C++:
  • Java: CelCompiler और CelRuntime बिल्डर में CelExtensions.sets() जोड़ें.
  • Python: extensions सूची में sets जोड़कर, cel.EnvConfig के ज़रिए इसे चालू करें.

स्ट्रिंग लाइब्रेरी

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
charAt यह फ़ंक्शन, इंडेक्स में मौजूद वर्ण दिखाता है.

सिग्नेचर:
string.charAt(int) -> string

उदाहरण:
"hello".charAt(1) // "e"		 ✓ (v0.4.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
indexOf सबस्ट्रिंग की पहली एंट्री का इंडेक्स दिखाता है या -1.

सिग्नेचर:
string.indexOf(substr, [start]) -> int

उदाहरण:
"hello".indexOf("l") // 2		 ✓ (v0.4.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
lastIndexOf यह सबस्ट्रिंग के आखिरी बार दिखने का इंडेक्स या -1 दिखाता है.

सिग्नेचर:
string.lastIndexOf(substr, [end]) -> int

उदाहरण:
"hello".lastIndexOf("l") // 3		 ✓ (v0.4.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
join यह फ़ंक्शन, स्ट्रिंग को एक साथ जोड़ता है.

सिग्नेचर:
list(string).join([separator]) -> string

उदाहरण:
["a", "b"].join("-") // "a-b"		 ✓ (v0.10.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
split यह फ़ंक्शन, स्ट्रिंग को सेपरेटर के हिसाब से बांटता है.

सिग्नेचर:
string.split(separator, [limit]) -> list(string)

उदाहरण:
"a-b".split("-") // ["a", "b"]		 ✓ (v0.4.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
substring यह फ़ंक्शन, सबस्ट्रिंग दिखाता है. इसमें शुरू होने की जगह शामिल होती है, लेकिन खत्म होने की जगह शामिल नहीं होती.

सिग्नेचर:
string.substring(start, [end]) -> string

उदाहरण:
"hello".substring(1, 3) // "el"		 ✓ (v0.4.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
trim यूनिकोड व्हाइटस्पेस को ट्रिम करता है.

हस्ताक्षर:
string.trim() -> string

उदाहरण:
" hello ".trim() // "hello"		 ✓ (v0.4.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
replace यह फ़ंक्शन, old को new से बदलता है.

सिग्नेचर:
string.replace(old, new, [limit]) -> string

उदाहरण:
"hello".replace("l", "w") // "hewwo"		 ✓ (v0.4.0) ✓ (v0.10.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
reverse यूनिकोड कोड पॉइंट को उलट देता है.

सिग्नेचर:
string.reverse() -> string

उदाहरण:
"abc".reverse() // "cba"		 ✓ (v0.18.0) ✓ (v0.14.0) ✓ (v0.13.0) ✓ (v0.1.1) ✗
lowerAscii यह ASCII वर्णों को अंग्रेज़ी के छोटे अक्षरों में बदलता है.

सिग्नेचर:
string.lowerAscii() -> string

उदाहरण:
"Hello".lowerAscii() // "hello"		 ✓ (v0.6.0) ✓ (v0.11.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
upperAscii ASCII वर्णों को कैपिटल लेटर में बदलता है.

सिग्नेचर:
string.upperAscii() -> string

उदाहरण:
"Hello".upperAscii() // "HELLO"		 ✓ (v0.6.0) ✓ (v0.11.0) ✓ (v0.2.0) ✓ (v0.1.1) ✗
quote सुरक्षित तरीके से प्रिंट करने के लिए, स्ट्रिंग को एस्केप करता है.

हस्ताक्षर:
strings.quote(string) -> string

उदाहरण:
strings.quote("a\tb") // "\"a\\tb\""		 ✓ (v0.14.0) ✓ (v0.14.0) ✓ (v0.13.0) ✓ (v0.1.1) ✗
format यह फ़ंक्शन, printf-स्टाइल वाले प्लेसहोल्डर का इस्तेमाल करके स्ट्रिंग को फ़ॉर्मैट करता है.

सिग्नेचर:
string.format(list) -> string

उदाहरण:
"str: %s, int: %d".format(["a", 1]) // "str: a, int: 1"		 ✓ (v0.14.0) ✓ (v0.11.0) ✗ ✓ (v0.1.1) ✗

चालू करने का तरीका

  • जाओ: ext.Strings() को cel.NewEnv() पर पास करो.
  • C++:
  • Java: CelCompiler और CelRuntime बिल्डर में CelExtensions.strings() जोड़ें.
  • Python: cel_expr_python.ext.ext_strings को इंपोर्ट करें और cel.NewEnv(extensions=[...]) में ExtStrings() का इस्तेमाल करें.

रेगुलर एक्सप्रेशन लाइब्रेरी

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
regex.replace यह फ़ंक्शन, मैच किए गए टेक्स्ट को रिप्लेसमेंट स्ट्रिंग से बदलता है. इसमें बैकरेफ़रंस का इस्तेमाल किया जा सकता है.

सिग्नेचर:
regex.replace(target, pat, repl, [limit]) -> string

उदाहरण:
regex.replace("123-456", r"(\d+)-(\d+)", r"\2-\1") // "456-123"		 ✓ (v0.25.1) ✓ (v0.13.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
regex.extract पैटर्न से मैच करने वाली पहली वैल्यू दिखाता है. इसमें एक कैप्चर ग्रुप होना चाहिए.

सिग्नेचर:
regex.extract(target, pat) -> optional(string)

उदाहरण:
regex.extract("a123b", r"(\d+)") // optional("123")		 ✓ (v0.25.1) ✓ (v0.13.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗
regex.extractAll पैटर्न से मैच होने वाली सभी वैल्यू दिखाता है. इसमें एक कैप्चर ग्रुप होना चाहिए.

सिग्नेचर:
regex.extractAll(target, pat) -> list(string)

उदाहरण:
regex.extractAll("a1b2", r"(\d+)") // ["1", "2"]		 ✓ (v0.25.1) ✓ (v0.13.0) ✓ (v0.10.1) ✓ (v0.1.1) ✗

चालू करने का तरीका

  • जाओ: ext.Regex() को cel.NewEnv() पर पास करो.
  • C++:
  • Java: CelCompiler और CelRuntime बिल्डर में CelExtensions.regex() जोड़ें.
  • Python: cel.EnvConfig के ज़रिए इसे चालू करें. इसके लिए, extensions सूची में regex और optional जोड़ें.

दो वैरिएबल वाले कंप्रीहेंशन

मैक्रो जानकारी ऐप पर जाएं C++ Java Python C
all की/इंडेक्स और वैल्यू के लिए, लॉजिकल AND को शॉर्ट-सर्किट करना.

सिग्नेचर:
list.all(i, v, pred) -> bool
map.all(k, v, pred) -> bool

उदाहरण:
[1, 2].all(i, v, v > 0) // true		 ✓ (v0.22.0) ✓ (v0.14.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
exists की/इंडेक्स और वैल्यू पर लॉजिकल OR को शॉर्ट-सर्किट करना.

सिग्नेचर:
list.exists(i, v, pred) -> bool
map.exists(k, v, pred) -> bool

उदाहरण:
[1, 2].exists(i, v, v == 2) // true		 ✓ (v0.22.0) ✓ (v0.14.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
existsOne यह फ़ंक्शन जांच करता है कि क्या सिर्फ़ एक जोड़ी, प्रेडिकेट को पूरा करती है.

सिग्नेचर:
list.existsOne(i, v, pred) -> bool
map.existsOne(k, v, pred) -> bool

उदाहरण:
[1, 2].existsOne(i, v, v == 2) // true		 ✓ (v0.22.0) ✓ (v0.14.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
transformList यह फ़ंक्शन, सूची/मैप को सूची में बदलता है या फ़िल्टर करता है.

सिग्नेचर:
list.transformList(i, v, [filter], transform) -> list
map.transformList(k, v, [filter], transform) -> list

उदाहरण:
[1, 2].transformList(i, v, v * 2) // [2, 4]		 ✓ (v0.22.0) ✓ (v0.14.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
transformMap यह फ़ंक्शन, सूची/मैप की वैल्यू को मैप में बदलता है (कुंजियां एक जैसी रहती हैं).

सिग्नेचर:
list.transformMap(i, v, [filter], transform) -> map
map.transformMap(k, v, [filter], transform) -> map

उदाहरण:
[1, 2].transformMap(i, v, v * 2) // {0: 2, 1: 4}		 ✓ (v0.22.0) ✓ (v0.14.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗
transformMapEntry मैप में बदल जाता है.

सिग्नेचर:
list.transformMapEntry(i, v, [filter], transform_entry) -> map
map.transformMapEntry(k, v, [filter], transform_entry) -> map

उदाहरण:
[1, 2].transformMapEntry(i, v, {string(v): v * 2}) // {"1": 2, "2": 4}		 ✓ (v0.22.0) ✓ (v0.14.0) ✓ (v0.11.0) ✓ (v0.1.1) ✗

चालू करने का तरीका

नेटिव टाइप लाइब्रेरी

सुविधा जानकारी ऐप पर जाएं C++ Java Python C
नेटिव स्ट्रक्चर CEL में होस्ट नेटिव टाइप (Go स्ट्रक्चर / Java POJO) रजिस्टर करना और इंस्टैंटिएट करना.

उदाहरण:
Account{id: 123} (CEL में इंस्टेंस किया गया Java POJO)		 ✓ (v0.13.0) ✗ ✓ (v0.13.0) ✗ ✗

चालू करने का तरीका

  • जाएं: cel.NativeTypes(...) या ext.NativeTypes(...) (रिफ़्लेक्ट टाइप उपलब्ध कराएं) को cel.NewEnv() पर पास करें.
  • C++: इसका इस्तेमाल नहीं किया जा सकता.
  • Java: CelCompiler और CelRuntime बिल्डर में CelExtensions.nativeTypes() (Java क्लास उपलब्ध कराता है) जोड़ें.
  • Python: इसका इस्तेमाल नहीं किया जा सकता.

नेटवर्क लाइब्रेरी

नेटवर्क लाइब्रेरी आईपी पते और सीआईडीआर ब्लॉक को पार्स करने, मान्य करने और उनमें हेरफेर करने के लिए फ़ंक्शन प्रदान करती है.

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
ip एक स्ट्रिंग को आईपी पते में पार्स करता है, या सीआईडीआर से आईपी निकालता है.

हस्ताक्षर:
ip(string) -> IP
CIDR.ip() -> IP

उदाहरण:
ip("192.168.0.1")
cidr("192.168.0.0/24").ip()		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
isIP जाँच करता है कि क्या कोई स्ट्रिंग एक वैध आईपी पता है.

हस्ताक्षर:
isIP(string) -> bool

उदाहरण:
isIP("192.168.0.1") // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
ip.isCanonical यह फ़ंक्शन, यह जांच करता है कि आईपी पते की स्ट्रिंग, कैननिकल फ़ॉर्मैट में है या नहीं.

हस्ताक्षर:
ip.isCanonical(string) -> bool

उदाहरण:
ip.isCanonical("192.168.0.1") // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
cidr यह फ़ंक्शन, किसी स्ट्रिंग को सीआईडीआर ब्लॉक में पार्स करता है.

सिग्नेचर:
cidr(string) -> CIDR

उदाहरण:
cidr("192.168.0.0/24")		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
isCIDR जाँच करता है कि क्या कोई स्ट्रिंग एक वैध CIDR ब्लॉक है.

हस्ताक्षर:
isCIDR(string) -> bool

उदाहरण:
isCIDR("192.168.0.0/24") // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
containsIP जाँच करता है कि क्या CIDR ब्लॉक में IP पता है.

हस्ताक्षर:
CIDR.containsIP(IP) -> bool
CIDR.containsIP(string) -> bool

उदाहरण:
cidr("192.168.0.0/24").containsIP(ip("192.168.0.1")) // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
containsCIDR इस फ़ंक्शन से यह पता चलता है कि किसी सीआईडीआर ब्लॉक में कोई दूसरा सीआईडीआर ब्लॉक शामिल है या नहीं.

सिग्नेचर:
CIDR.containsCIDR(CIDR) -> bool
CIDR.containsCIDR(string) -> bool

उदाहरण:
cidr("192.168.0.0/16").containsCIDR(cidr("192.168.1.0/24")) // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
family यह आईपी परिवार लौटाता है (आईपीवी4 के लिए 4, आईपीवी6 के लिए 6).

हस्ताक्षर:
IP.family() -> int

उदाहरण:
ip("192.168.0.1").family() // 4		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
isGlobalUnicast जाँच करता है कि क्या आईपी एक वैश्विक यूनिकास्ट पता है.

हस्ताक्षर:
IP.isGlobalUnicast() -> bool

उदाहरण:
ip("192.168.0.1").isGlobalUnicast() // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
isLinkLocalMulticast यह फ़ंक्शन, यह जांच करता है कि आईपी पता लिंक-लोकल मल्टीकास्ट पता है या नहीं.

सिग्नेचर:
IP.isLinkLocalMulticast() -> bool

उदाहरण:
ip("224.0.0.1").isLinkLocalMulticast() // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
isLinkLocalUnicast जाँच करता है कि क्या आईपी एक लिंक-लोकल यूनिकास्ट पता है.

हस्ताक्षर:
IP.isLinkLocalUnicast() -> bool

उदाहरण:
ip("169.254.0.1").isLinkLocalUnicast() // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
isLoopback जाँच करता है कि क्या आईपी एक लूपबैक पता है.

हस्ताक्षर:
IP.isLoopback() -> bool

उदाहरण:
ip("127.0.0.1").isLoopback() // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
isMask यह फ़ंक्शन, यह जांच करता है कि सीआईडीआर (CIDR) एक मान्य सबनेट मास्क है या नहीं.

सिग्नेचर:
CIDR.isMask() -> bool

उदाहरण:
cidr("255.255.255.0/24").isMask() // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
isUnspecified जाँच करता है कि क्या आईपी एक अनिर्दिष्ट पता है (उदाहरण के लिए 0.0.0.0).

हस्ताक्षर:
IP.isUnspecified() -> bool

उदाहरण:
ip("0.0.0.0").isUnspecified() // true		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
masked यह फ़ंक्शन, मास्क किए गए सीआईडीआर ब्लॉक को दिखाता है.

सिग्नेचर:
CIDR.masked() -> CIDR

उदाहरण:
cidr("192.168.0.1/24").masked() // 192.168.0.0/24		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
prefixLength यह फ़ंक्शन, सीआईडीआर ब्लॉक के प्रीफ़िक्स की लंबाई दिखाता है.

सिग्नेचर:
CIDR.prefixLength() -> int

उदाहरण:
cidr("192.168.0.0/24").prefixLength() // 24		 ✓ (v0.29.0) ✗ ✗ ✗ ✗
string यह फ़ंक्शन, आईपी या सीआईडीआर को स्ट्रिंग में बदलता है.

सिग्नेचर:
string(IP) -> string
string(CIDR) -> string

उदाहरण:
string(ip("192.168.0.1")) // "192.168.0.1"		 ✓ (v0.29.0) ✗ ✗ ✗ ✗

चालू करने का तरीका

  • जाओ: ext.Network() को cel.NewEnv() पर पास करो.
  • C++: इसका इस्तेमाल नहीं किया जा सकता.
  • Java: काम नहीं करता है.
  • Python: इसका इस्तेमाल नहीं किया जा सकता.

JWT लाइब्रेरी

JWT लाइब्रेरी, JSON वेब टोकन (JWT) को पार्स करने के लिए डेटा टाइप और हेल्पर फ़ंक्शन उपलब्ध कराती है. साथ ही, स्टैंडर्ड और कस्टम दावों की जांच करने की सुविधा देती है.

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
jwt.parse यह फ़ंक्शन, रॉ टोकन स्ट्रिंग को स्ट्रक्चर्ड jwt.Token में पार्स करता है, जिसे वैकल्पिक में रैप किया जाता है.

हस्ताक्षर:
jwt.parse(string) -> optional(jwt.Token)

उदाहरण:
jwt.parse(token_string).hasValue()		 ✓ (v0.32.0) ✗ ✗ ✗ ✗
claim यह फ़ंक्शन, टोकन के पेलोड से कुंजी के नाम के हिसाब से कस्टम दावे की वैल्यू के बारे में क्वेरी करता है.

हस्ताक्षर:
jwt.Token.claim(string) -> optional(dyn)
optional(jwt.Token).claim(string) -> optional(dyn)

उदाहरण:
jwt.parse(token).claim("tenant").orValue("")		 ✓ (v0.32.0) ✗ ✗ ✗ ✗
presentedBy यह पुष्टि करता है कि टोकन जारी करने वाले और ऑडियंस की वैल्यू, अनुमानित वैल्यू से मेल खाती हैं.

हस्ताक्षर:
jwt.Token.presentedBy(string, string) -> bool
optional(jwt.Token).presentedBy(string, string) -> bool

उदाहरण:
jwt.parse(token).presentedBy("https://auth.example.com", "https://api.example.com")		 ✓ (v0.32.0) ✗ ✗ ✗ ✗

चालू करने का तरीका

  • Go: cel.dev/cel-go/ext/security/jwt को इंपोर्ट करें और cel.NewEnv() को jwt.Library() पास करें.
  • C++: इसका इस्तेमाल नहीं किया जा सकता.
  • Java: काम नहीं करता है.
  • Python: इसका इस्तेमाल नहीं किया जा सकता.

एचएमएसी लाइब्रेरी

एचएमएसी लाइब्रेरी, क्रिप्टोग्राफ़िक फ़ंक्शन उपलब्ध कराती है. इनका इस्तेमाल, स्ट्रिंग और बाइट सीक्वेंस पर हैश पर आधारित मैसेज ऑथेंटिकेशन कोड (एचएमएसी) को कंप्यूट और पुष्टि करने के लिए किया जाता है.

फ़ंक्शन जानकारी ऐप पर जाएं C++ Java Python C
hmac.compute यह फ़ंक्शन, तय किए गए एल्गोरिदम और सीक्रेट पासकोड का इस्तेमाल करके, एचएमएसी के रॉ सिग्नेचर बाइट का हिसाब लगाता है.

सिग्नेचर:
hmac.compute(string, string|bytes, string|bytes) -> bytes

उदाहरण:
hmac.compute(hmac.SHA256, "secret", "message")		 ✓ (v0.32.0) ✗ ✗ ✗ ✗
hmac.verify इस फ़ंक्शन से यह पुष्टि की जाती है कि एचएमएसी हस्ताक्षर, अनुमानित डाइजेस्ट से मेल खाता है या नहीं.

हस्ताक्षर:
hmac.verify(string, string|bytes, string|bytes, string|bytes) -> bool

उदाहरण:
hmac.verify(hmac.SHA256, secret, msg, expected_sig) // true		 ✓ (v0.32.0) ✗ ✗ ✗ ✗

चालू करने का तरीका

  • Go: cel.dev/cel-go/ext/security/hmac को इंपोर्ट करें और cel.NewEnv() को hmac.Library() पास करें.
  • C++: इसका इस्तेमाल नहीं किया जा सकता.
  • Java: काम नहीं करता है.
  • Python: इसका इस्तेमाल नहीं किया जा सकता.

5. बेहतर सुविधाएं

ऐडवांस सुविधाओं के बारे में खास जानकारी

सुविधा जानकारी ऐप पर जाएं C++ Java Python C
आंशिक तौर पर आकलन करना इनपुट मौजूद न होने पर, यह फ़ंक्शन वैल्यू का अनुमान लगाता है. यह 'UNKNOWN' वैल्यू या आसान एक्सप्रेशन दिखाता है. ✓³ ✓⁴ ✓⁴ ✗ ✗
एसिंक मूल्यांकन एक्सटेंशन फ़ंक्शन को एक साथ बिना किसी रुकावट के लागू किया जा सकता है. ✓⁵ ✗ ✓⁶ ✗ ✗
एएसटी वैलिडेटर स्टैटिक विश्लेषण, टाइप की जांच के बाद Checked AST की जांच करता है. ✓ ✓ ✓ ✗ ✗
AST ऑप्टिमाइज़र परफ़ॉर्मेंस को बेहतर बनाने के लिए, एएसटी को फिर से लिखा जाता है. जैसे, कॉन्स्टेंट फ़ोल्डिंग, इनलाइनिंग, और सीएसई. ✓ ✓ ✓ ✗ ✗
CEL Policy Compiler यह YAML पर आधारित नीति के स्ट्रक्चर को स्टैंडर्ड CEL AST में कंपाइल करता है. ✓ ✓ ✓ ✗ ✗
औपचारिक पुष्टि यह सुरक्षा के सिद्धांतों, संतुष्टि, वैधता, और एएसटी की समानता को साबित करता है. ✗ ✗ ✓ (v0.14.0) ✗ ✗

³ Go, रेज़िडुअल एएसटी (प्रून किया गया एएसटी) जनरेट करने की सुविधा के साथ काम करता है. ⁴ C++ और Java के साथ काम करता है. रनटाइम के दौरान UnknownSet / CelUnknownSet दिखाता है, लेकिन बचे हुए एएसटी जनरेशन के लिए सार्वजनिक एपीआई उपलब्ध नहीं कराता. ⁵ Go, AsyncBinding / AsyncOp रिटर्निंग चैनल का इस्तेमाल करता है. ⁶ Java, CelAsyncRuntime का इस्तेमाल करता है और ListenableFuture दिखाता है.

आंशिक तौर पर आकलन किया गया (अज्ञात)

आंशिक आकलन की मदद से, किसी एक्सप्रेशन का आकलन तब किया जा सकता है, जब सिर्फ़ इनपुट वैरिएबल (आर्ग्युमेंट) का सबसेट पता हो. जांच में फ़ेल होने के बजाय, यह पता चलता है कि क्या मौजूद नहीं है या कोई आसान एक्सप्रेशन.

  • Go: पूरी तरह से काम करता है. इसकी मदद से, ऐसे पैटर्न वाले PartialActivation को तय किया जा सकता है जिनमें अज्ञात एट्रिब्यूट शामिल हों. आकलन करने पर types.Unknown वैल्यू मिलती है. Go, रेज़िडुअल एएसटी (Env.ResidualAst) जनरेट करने की सुविधा देता है. यह एक छोटा और आसान एएसटी होता है. इसमें एक्सप्रेशन के सिर्फ़ वे हिस्से शामिल होते हैं जिनका आकलन नहीं किया जा सका.
  • C++: इसमें Unknown वैल्यू इस्तेमाल की जा सकती हैं. Activation::set_unknown_attribute_patterns के ज़रिए, एट्रिब्यूट के ऐसे पैटर्न कॉन्फ़िगर किए जाते हैं जिनकी जानकारी मौजूद नहीं है. Evaluation returns an UnknownSet. फ़िलहाल, सार्वजनिक एपीआई, रीज़िडुअल एएसटी जनरेशन को एक्सपोज़ नहीं करता है.
  • Java: Program.eval() को पास किए गए PartialVars के ज़रिए, कुछ हद तक आकलन करने की सुविधा उपलब्ध है. इवैलुएशन से CelUnknownSet मिलता है. फ़िलहाल, सार्वजनिक एपीआई में एएसटी जनरेट करने की सुविधा उपलब्ध नहीं है.
  • Python / C: नेटिव तौर पर काम नहीं करता.

एसिंक्रोनस तरीके से आकलन करना

एसिंक तरीके से आकलन करने की सुविधा की मदद से, CEL एक्सप्रेशन ऐसे फ़ंक्शन कॉल कर सकते हैं जो एसिंक तरीके से काम करते हैं. जैसे, आरपीसी या डेटाबेस क्वेरी करना. साथ ही, जब तक नतीजे उपलब्ध नहीं हो जाते, तब तक आकलन को ब्लॉक कर सकते हैं. हालांकि, इससे मुख्य एक्ज़ीक्यूशन थ्रेड ब्लॉक नहीं होती.

  • Go: यह AsyncBinding और AsyncOp के ज़रिए, एसिंक्रोनस फ़ंक्शन ओवरलोड का इस्तेमाल करने की सुविधा देता है. एसिंक फ़ंक्शन, Go चैनल (<-chan ref.Val) लौटाते हैं. साथ ही, इंटरप्रेटर एक साथ कई फ़ंक्शन को चलाने और उन्हें सिंक करने की प्रोसेस को मैनेज करता है.
  • Java: CelAsyncRuntime और AsyncProgram के ज़रिए, एसिंक जांच की सुविधा उपलब्ध है. यह ListenableFuture का इस्तेमाल करके, प्रोसेस की जा रही वैल्यू दिखाता है. साथ ही, फ़्यूचर के पूरे होने पर, अपने-आप इवैल्यूएशन पूरा कर देता है.
  • C++ / Python / C: इसमें कोई बिल्ट-इन सपोर्ट नहीं होता.

एएसटी वैलिडेटर

टाइप की जांच करने के बाद, वैलिडेटर, Checked AST पर स्टैटिक विश्लेषण करते हैं. इससे प्रोग्राम को एक्ज़ीक्यूट करने से पहले, डोमेन से जुड़ी पाबंदियां लागू की जा सकती हैं.

  • Go: इसमें ASTValidator इंटरफ़ेस काम करता है. कैननिकल पुष्टि करने वालों में cel.validator.duration, cel.validator.timestamp, cel.validator.matches (रेगुलर एक्सप्रेशन), cel.validator.homogeneous_literals, और cel.validator.comprehension_nesting_limit शामिल हैं.
  • C++: इसमें cel::Validator का इस्तेमाल किया जा सकता है. कैननिकल पुष्टि में AstDepthValidator, ComprehensionNestingLimitValidator, DurationLiteralValidator, HomogeneousLiteralValidator, MatchesValidator, और TimestampLiteralValidator शामिल हैं.
  • Java: CelValidator और CelAstValidator के साथ काम करता है. कैननिकल यूआरएल की पुष्टि करने वाले टूल में AstDepthLimitValidator, ComprehensionNestingLimitValidator, DurationLiteralValidator, HomogeneousLiteralValidator, RegexLiteralValidator, और TimestampLiteralValidator शामिल हैं.
  • Python / C: सीधे तौर पर काम नहीं करता.

एएसटी ऑप्टिमाइज़र

ऑप्टिमाइज़र, AST को फिर से लिखते हैं, ताकि बेहतर तरीके से कोड को लागू किया जा सके. ऑप्टिमाइज़र दो कैटगरी में आते हैं: स्टैटिक और रनटाइम ऑप्टिमाइज़र. C++, Java, और Go में रनटाइम ऑप्टिमाइज़ेशन की सुविधा उपलब्ध है. CEL Java और Go, स्टैटिक ऑप्टिमाइज़र के साथ भी काम करते हैं.

सामान्य ऑप्टिमाइज़ेशन में, कॉन्स्टेंट फ़ोल्डिंग (कॉन्स्टेंट इनपुट के साथ सब-एक्सप्रेशन का पहले से आकलन करना) और कॉमन सबएक्सप्रेशन एलिमिनेशन (सीएसई) शामिल है.

  • Go: यह कंपाइलेशन/प्लानिंग के दौरान एएसटी फ़ोल्डिंग की सुविधा देता है.
  • C++: यह प्लान के समय cel::extensions::EnableConstantFolding एक्सटेंशन के ज़रिए कॉन्स्टेंट फ़ोल्डिंग की सुविधा देता है.
  • Java: CelOptimizer इंटरफ़ेस के साथ काम करता है. कैननिकल ऑप्टिमाइज़र में ये शामिल हैं ConstantFoldingOptimizer (जो प्री-ऑर्डर ट्रैवर्सल, Protobuf मैसेज कॉन्स्टेंट फ़ोल्डिंग, और एग्रीगेट या वैकल्पिक प्रूनिंग के साथ काम करता है), InliningOptimizer, और SubexpressionOptimizer (सीएसई).
  • Python / C: सीधे तौर पर काम नहीं करता.

CEL Policy Compiler

CEL नीति, YAML पर आधारित फ़ॉर्मैट है. इसका इस्तेमाल, कई CEL एक्सप्रेशन को एक साथ कंपोज़ करने के लिए किया जाता है. इसमें वैरिएबल, मैच ब्लॉक, शर्तों के हिसाब से आउटपुट, और नेस्ट किए गए नियम शामिल होते हैं. इसे जटिल नीति इंजन (जैसे कि Kubernetes Admission Control) के लिए डिज़ाइन किया गया है. यहां सिंगल CEL एक्सप्रेशन को पढ़ा नहीं जा सकता.

भाषा की औपचारिक परिभाषा, सिंटैक्स, और कंफ़ॉर्मेंस सुइट के लिए, सीईएल की नीति से जुड़ी खास जानकारी देखें.

नीति कंपाइलर, इन YAML नीतियों को एक स्टैंडर्ड CEL AST में कंपाइल करता है. इसका मतलब है कि ये स्टैंडर्ड CEL रनटाइम के साथ पूरी तरह से काम करती हैं. साथ ही, परफ़ॉर्मेंस और सुरक्षा से जुड़ी सभी गारंटी को इनहेरिट करती हैं.

  • Go: Go नीति के ज़रिए काम करता है. इसमें एग्रीगेट नियम के आकलन के सिमैंटिक भी शामिल हैं.
  • C++: C++ नीति के तहत काम करता है.
  • Java: Java की नीति के ज़रिए काम करता है. इसमें नीति के कॉन्फ़िगरेशन में, एग्रीगेट नियम के आकलन के सिमैंटिक और शॉर्टहैंड टाइप स्पेसिफ़ायर शामिल हैं.
  • Python / C: सीधे तौर पर काम नहीं करता.

पुष्टि करने का फ़ॉर्मल फ़्रेमवर्क

फ़ॉर्मल वेरिफ़िकेशन फ़्रेमवर्क की मदद से, उपयोगकर्ता गणित के सिद्धांतों का इस्तेमाल करके यह साबित कर सकते हैं कि सीईएल एक्सप्रेशन और स्ट्रक्चर्ड सीईएल नीतियों में सुरक्षा से जुड़े सिद्धांत, तार्किक समानता, संतुष्टि, और वैधता मौजूद है.

  • Java: यह CEL Java Verifier के ज़रिए काम करता है (dev.cel:verifier और dev.cel:verifier-cli). इसमें ये सुविधाएं शामिल हैं: गवाह के इनपुट जनरेशन के साथ संतुष्टि (isSatisfiable), काउंटर उदाहरण जनरेशन के साथ वैधता (isAlwaysTrue), कंप्रीहेंशन के लिए बाउंडेड मॉडल चेकिंग (बीएमसी), एएसटी में लॉजिकल इक्विवेलेंस के सबूत, और कस्टम assume/assert नीति इनवेरिएंट की पुष्टि.
  • Go / C++ / Python / C: ये Java कमांड लाइन टूल चेन के ज़रिए, परोक्ष रूप से काम करती हैं.

इसके बारे में ज़्यादा जानने और असल दुनिया के उदाहरण देखने के लिए, Google Open Source ब्लॉग पोस्ट पढ़ें: Securing the agentic era: Introducing formal verification for CEL.