{"id":13481027,"url":"https://github.com/google/cel-spec","last_synced_at":"2025-03-27T11:31:34.395Z","repository":{"id":38455177,"uuid":"102390943","full_name":"google/cel-spec","owner":"google","description":"Common Expression Language -- specification and binary representation","archived":false,"fork":false,"pushed_at":"2024-10-23T20:44:16.000Z","size":1112,"stargazers_count":2864,"open_issues_count":55,"forks_count":226,"subscribers_count":43,"default_branch":"master","last_synced_at":"2024-10-24T08:28:02.544Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://cel.dev","language":"Starlark","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/google.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-04T18:33:35.000Z","updated_at":"2024-10-24T08:18:53.000Z","dependencies_parsed_at":"2023-10-14T14:07:24.872Z","dependency_job_id":"8140eefb-1b1a-45c9-b6ac-0f658681b22c","html_url":"https://github.com/google/cel-spec","commit_stats":{"total_commits":231,"total_committers":37,"mean_commits":6.243243243243243,"dds":0.7532467532467533,"last_synced_commit":"3cdaf9bc892fd2d695860b557c798ef8335e3f68"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fcel-spec","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fcel-spec/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fcel-spec/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/google%2Fcel-spec/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/google","download_url":"https://codeload.github.com/google/cel-spec/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222239499,"owners_count":16953961,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-07-31T17:00:47.840Z","updated_at":"2025-03-27T11:31:34.390Z","avatar_url":"https://github.com/google.png","language":"Starlark","readme":"# Common Expression Language\n\nThe Common Expression Language (CEL) implements common semantics for expression\nevaluation, enabling different applications to more easily interoperate.\n\nKey Applications\n\n*   Security policy: organizations have complex infrastructure and need common\n    tooling to reason about the system as a whole\n*   Protocols: expressions are a useful data type and require interoperability\n    across programming languages and platforms.\n\n\nGuiding philosophy:\n\n1.  Keep it small \u0026 fast.\n    *   CEL evaluates in linear time, is mutation free, and not Turing-complete.\n        This limitation is a feature of the language design, which allows the\n        implementation to evaluate orders of magnitude faster than equivalently\n        sandboxed JavaScript.\n2.  Make it extensible.\n    *   CEL is designed to be embedded in applications, and allows for\n        extensibility via its context which allows for functions and data to be\n        provided by the software that embeds it.\n3.  Developer-friendly.\n    *   The language is approachable to developers. The initial spec was based\n        on the experience of developing Firebase Rules and usability testing\n        many prior iterations.\n    *   The library itself and accompanying toolings should be easy to adopt by\n        teams that seek to integrate CEL into their platforms.\n\nThe required components of a system that supports CEL are:\n\n*   The textual representation of an expression as written by a developer. It is\n    of similar syntax to expressions in C/C++/Java/JavaScript\n*   A representation of the program's abstract syntax tree (AST).\n*   A compiler library that converts the textual representation to the binary\n    representation. This can be done ahead of time (in the control plane) or\n    just before evaluation (in the data plane).\n*   A context containing one or more typed variables, often protobuf messages.\n    Most use-cases will use `attribute_context.proto`\n*   An evaluator library that takes the binary format in the context and\n    produces a result, usually a Boolean.\n\nFor use cases which require persistence or cross-process communcation, it is\nhighly recommended to serialize the type-checked expression as a protocol\nbuffer. The CEL team will maintains canonical protocol buffers for ASTs and\nwill keep these versions identical and wire-compatible in perpetuity:\n\n*  [CEL canonical](https://github.com/google/cel-spec/tree/master/proto/cel/expr)\n*  [CEL v1alpha1](https://github.com/googleapis/googleapis/tree/master/google/api/expr/v1alpha1)\n\n\nExample of boolean conditions and object construction:\n\n``` c\n// Condition\naccount.balance \u003e= transaction.withdrawal\n    || (account.overdraftProtection\n    \u0026\u0026 account.overdraftLimit \u003e= transaction.withdrawal  - account.balance)\n\n// Object construction\ncommon.GeoPoint{ latitude: 10.0, longitude: -5.5 }\n```\n\nFor more detail, see:\n\n*   [Introduction](doc/intro.md)\n*   [Language Definition](doc/langdef.md)\n\nReleased under the [Apache License](LICENSE).\n","funding_links":[],"categories":["Starlark","Uncategorized","others","Table of Contents","Go","\u003ca name=\"Starlark\"\u003e\u003c/a\u003eStarlark"],"sub_categories":["Uncategorized","Resources"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle%2Fcel-spec","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgoogle%2Fcel-spec","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgoogle%2Fcel-spec/lists"}