nsj-rest-lib2 0.0.36__tar.gz → 0.0.37__tar.gz

nsj_rest_lib2-0.0.37/PKG-INFO

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: nsj_rest_lib2
+Version: 0.0.37
+Summary: Biblioteca para permitir a distribuição de rotas dinâmicas numa API, configuradas por meio de EDLs declarativos (em formato JSON).
+Home-page: https://github.com/Nasajon/nsj_rest_lib2
+Author: Nasajon Sistemas
+Author-email: contact.dev@nasajon.com.br
+Project-URL: Source, https://github.com/Nasajon/nsj_rest_lib2
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.4
+Description-Content-Type: text/markdown
+Requires-Dist: nsj-rest-lib<7.0.0,>=5.1.3
+Requires-Dist: redis<7.0.0,>=6.4.0
+Requires-Dist: nsj-multi-database-lib<3.0.0,>=2.0.1
+Requires-Dist: pydantic<3.0.0,>=2.11.9
+Requires-Dist: black<26.0.0,>=25.1.0
+Requires-Dist: pyyaml<7.0.0,>=6.0.3
+
+# RestLib2
+
+O RestLib2 é uma plataforma que tem por objetivo o fornecimento de APIs para os clientes, a partir da descrição da entidades envolvidas, e sem a necessidade de programação imperativa tradicional.
+
+Em resumo, a partir da declaração em JSON das entidades que compõe um negócio, bem como dos relacionamentos entre estas, as APIs já estarão disponíveis em produção.
+
+O objetivo final é permitir que o desenvolvimento de APIs se torne rápido e simples, acessível àqueles que tratam diretamente com o negócio (incluindo implantadores, e, no limite, o próprio cliente).
+
+## Links
+
+[Guia do EDL](docs/README.md)
+[ESPECIFICAÇÃO DO MODELO DE ENTIDADES](docs/especificacao.md)
+
+## Rota das APIs geradas
+
+A rota para acesso a uma API gerada por variar de acordo com o modo de configuração escolhido pela aplicação que usar o RestLib2. Mas, via de regra, sugere-se o padrão aplicado na API de DadosMestre:
+
+```http
+#############################
+# List Prod
+#############################
+GET https://api.nasajon.app/dados-mestre/edl1/clientes?tenant=47&grupo_empresarial=NASAJON HTTP/1.1
+Authorization: Bearer *****
+Accept: application/json
+```
+
+* Note que, na API de Dados Mestre, todas as APIs do RestLib2 ficarão debaixo da rota: ```https://api.nasajon.app/dados-mestre/edl1/```
+* O endpoint em si, varia a cada JSON, e fica configurado no nó ```api.resource``` do JSON de EDL em questão.
+
+## Fluxo básico de uso
+
+Há dois modos básicos de publicar novas APIs a partir de um JSON gerado, para uma aplicação previamente configurada para uso da plataforma:
+
+### Fluxo por meio de código versionado
+1. Criar o JSON de descrição da entidade desejada, gravando-o no diretório "@schemas/entities" da aplicação em questão (tome [como exemplo o "dados-mestre"](https://github.com/Nasajon/dados-mestre-api/tree/production/%40schemas)).
+2. Fazer push das alterações.
+3. Aguardar o build da aplicação (pode ser útil conferir os logs do job de atualização dos JSON, na aplicação em questão, e também os logs do [worker de compilação](https://ci.nasajon.in/applications/restlib2?view=pods&conditions=false), no Argo).
+4. Testar as APIs compiladas.
+   
+### Fluxo de deploy direto pela API
+1. Criar o JSON de descrição da entidade desejada.
+2. Registrá-lo diretamente, por meio da API de controle do RestLib2. segue exemplo de chamada abaixo:
+
+```http
+###############################
+# Post dinâmico
+###############################
+POST https://api.nasajon.app/restlib2/entities HTTP/1.1
+Authorization: Bearer ******
+Content-Type: application/json
+
+{
+  "id": "{UUID}",
+  "escopo": "{escopo}",
+  "tenant": 0,
+  "grupo_empresarial": "00000000-0000-0000-0000-000000000000",
+  "codigo": "{codigo da entidade}",
+  "descricao": "{descrição da entidade}",
+  "json_schema": {
+    "edl_version": "1.0",
+    "escopo": "{escopo}",
+    "description": "{descrição da entidade}",
+    "id": "cliente",
+    "version": "0.0.1",
+    ...
+  }
+}
+```
+
+Observações:
+* Note que, acima há placeholders a alterar.
+* Note também que o JSON não está completo, e, o correto é deguir a documentação do EDL.
+* Os valores tenant=0 e grupo_empresarial=00000000-0000-0000-0000-000000000000, indicam que a entidade é padrão, e serve para todos os tenants e grupos.
+
+3. Essa rota irá retornar algo semelhante a:
+
+```http
+HTTP/1.1 202 ACCEPTED
+Location: https://api.nasajon.app/restlib2/entity-compilations/status/{UUID do processo de compilação}
+```
+
+E, se você fizer uma chamada à rota retornada, poderá acompanhar o status da compilação, incluindo eventuais erros que venham a ocorrer.
+
+4. Testar a API compilada.
+
+## Como rodar a compilação de EDLs localmente?
+
+Você pode testar a compilação de seus EDLs localmente, incluindo a execução de diversas validações sobre os mesmos, desde que todos estejam dispostos num mesmo diertório.
+
+Para isso, considere os passos a seguir:
+
+1. Crie um diretório, e coloque todos os seus EDLs lá (garantindo que EDLs relacionados estejam no mesmo).
+2. Instale, no seu ambiente pyhton de teste, a biblioteca `nsj-rest-lib2`:
+   
+```sh
+pip install nsj-rest-lib2
+```
+
+3. Rode o comando abaixo (adaptado para seu diretório):
+```sh
+python3 -m nsj_rest_lib2.compiler.compiler -d $(shell pwd)/{diretorio_com_os_edls_json}
+```
+
+O resultado da compilação será impresso no console (erros, ou código total gerado).
+
+## Como configurar uma aplicação para expôr rotas de acordo com o padrão do RestLib2?
+
+Para que uma aplicação exponha as rotas no padrão do RestLib2, não são necessários muitos passos. Antes basta:
+
+1. Instalar, em sua aplicação, a dependência para o projeto nsj-rest-lib2
+
+```sh
+pip install nsj-rest-lib2
+```
+
+Não esqueça de fixar a versão usada (como sendo a última), no arquivo requirements.txt.
+
+2. Adicione a variável de ambiente abaixo em sua aplciação
+
+```env
+ESCOPO_RESTLIB2: "{COLOQUE O IDENTIFICADOR DE ESCOPO QUE DESEJAR PARA SUA APLICAÇÃO (UMA SIMPLES STRING SEM ESPAÇO)}"
+```
+
+* Esse identificador de escopo deve se único para sua aplicação.
+* É importante nota que sua aplicação só irá expôr JSONs de EDL configurados para o mesmo escopo definido aqui.
+
+3. Instale, como dependência a biblioteca, nsj-rest-lib2:
+
+```sh
+pip install nsj-rest-lib2
+```
+
+Não esqueça de fixar a versão usada (como sendo a última), no arquivo requirements.txt.
+
+4. Adicione a linha abaixo no arquivo wsgi.py (de inicilização de sua aplicação):
+
+```python
+from nsj_rest_lib2.controller.dynamic_controller import setup_dynamic_routes
+from nasajon.injector_factory_multibanco import InjectorFactoryMultibanco
+
+setup_dynamic_routes(application, injector_factory=InjectorFactoryMultibanco)
+```
+
+* No exemplo acima, a rota é multibanco, mas, não é obrigatório.
+* Os parâmetros de setup são:
+  * flask_app: Variável obrigatório, que aponte para sua aplicação Flask.
+  * multidb: Flag (padrão True)
+  * dynamic_root_path: URL padrão base de todos os endpoints do RestLib2 (padrão: "edl1")
+  * injector_factory: Classe de injeção de depndência usada (normalmente necessária para aplicações multibanco; o principal uso é justamente manipular a criação da conexão com o BD).
+
+## Carregando EDLs direto do disco
+
+Também é possível carregar EDLs diretamente do disco, sem depender exclusivamente do Redis. Para isso, use o parâmetro opcional `edls_path` em `setup_dynamic_routes`, apontando para um caminho relativo ao workdir da aplicação (ou absoluto), contendo arquivos `.json`, `.yml` ou `.yaml` com os EDLs.
+
+Exemplo:
+
+```python
+from nsj_rest_lib2.controller.dynamic_controller import setup_dynamic_routes
+
+setup_dynamic_routes(
+    application,
+    injector_factory=InjectorFactoryMultibanco,
+    edls_path="@schemas/entities",
+)
+```
+
+Observações:
+* Os EDLs são carregados e compilados uma vez, ficando em cache em memória. Chamadas seguintes reutilizam o cache.
+* A resolução das entidades ocorre primeiro pelo cache local; se não encontrar, o Redis é consultado (quando habilitado).
+
+Para desabilitar o Redis e usar somente EDLs do disco, defina a variável de ambiente abaixo:
+
+```env
+EDLS_FROM_REDIS=false
+```
+
+O valor padrão de `EDLS_FROM_REDIS` é `true`.
+
+
+**Pronto, isso deve bastar para expôr os EDLs configurados para o mesmo escopo da aplicação.**
+
+**OBSERVAÇÃO GERAL: Isso só funciona para aplicações Flask.**

nsj_rest_lib2-0.0.37/README.md

@@ -0,0 +1,182 @@
+# RestLib2
+
+O RestLib2 é uma plataforma que tem por objetivo o fornecimento de APIs para os clientes, a partir da descrição da entidades envolvidas, e sem a necessidade de programação imperativa tradicional.
+
+Em resumo, a partir da declaração em JSON das entidades que compõe um negócio, bem como dos relacionamentos entre estas, as APIs já estarão disponíveis em produção.
+
+O objetivo final é permitir que o desenvolvimento de APIs se torne rápido e simples, acessível àqueles que tratam diretamente com o negócio (incluindo implantadores, e, no limite, o próprio cliente).
+
+## Links
+
+[Guia do EDL](docs/README.md)
+[ESPECIFICAÇÃO DO MODELO DE ENTIDADES](docs/especificacao.md)
+
+## Rota das APIs geradas
+
+A rota para acesso a uma API gerada por variar de acordo com o modo de configuração escolhido pela aplicação que usar o RestLib2. Mas, via de regra, sugere-se o padrão aplicado na API de DadosMestre:
+
+```http
+#############################
+# List Prod
+#############################
+GET https://api.nasajon.app/dados-mestre/edl1/clientes?tenant=47&grupo_empresarial=NASAJON HTTP/1.1
+Authorization: Bearer *****
+Accept: application/json
+```
+
+* Note que, na API de Dados Mestre, todas as APIs do RestLib2 ficarão debaixo da rota: ```https://api.nasajon.app/dados-mestre/edl1/```
+* O endpoint em si, varia a cada JSON, e fica configurado no nó ```api.resource``` do JSON de EDL em questão.
+
+## Fluxo básico de uso
+
+Há dois modos básicos de publicar novas APIs a partir de um JSON gerado, para uma aplicação previamente configurada para uso da plataforma:
+
+### Fluxo por meio de código versionado
+1. Criar o JSON de descrição da entidade desejada, gravando-o no diretório "@schemas/entities" da aplicação em questão (tome [como exemplo o "dados-mestre"](https://github.com/Nasajon/dados-mestre-api/tree/production/%40schemas)).
+2. Fazer push das alterações.
+3. Aguardar o build da aplicação (pode ser útil conferir os logs do job de atualização dos JSON, na aplicação em questão, e também os logs do [worker de compilação](https://ci.nasajon.in/applications/restlib2?view=pods&conditions=false), no Argo).
+4. Testar as APIs compiladas.
+   
+### Fluxo de deploy direto pela API
+1. Criar o JSON de descrição da entidade desejada.
+2. Registrá-lo diretamente, por meio da API de controle do RestLib2. segue exemplo de chamada abaixo:
+
+```http
+###############################
+# Post dinâmico
+###############################
+POST https://api.nasajon.app/restlib2/entities HTTP/1.1
+Authorization: Bearer ******
+Content-Type: application/json
+
+{
+  "id": "{UUID}",
+  "escopo": "{escopo}",
+  "tenant": 0,
+  "grupo_empresarial": "00000000-0000-0000-0000-000000000000",
+  "codigo": "{codigo da entidade}",
+  "descricao": "{descrição da entidade}",
+  "json_schema": {
+    "edl_version": "1.0",
+    "escopo": "{escopo}",
+    "description": "{descrição da entidade}",
+    "id": "cliente",
+    "version": "0.0.1",
+    ...
+  }
+}
+```
+
+Observações:
+* Note que, acima há placeholders a alterar.
+* Note também que o JSON não está completo, e, o correto é deguir a documentação do EDL.
+* Os valores tenant=0 e grupo_empresarial=00000000-0000-0000-0000-000000000000, indicam que a entidade é padrão, e serve para todos os tenants e grupos.
+
+3. Essa rota irá retornar algo semelhante a:
+
+```http
+HTTP/1.1 202 ACCEPTED
+Location: https://api.nasajon.app/restlib2/entity-compilations/status/{UUID do processo de compilação}
+```
+
+E, se você fizer uma chamada à rota retornada, poderá acompanhar o status da compilação, incluindo eventuais erros que venham a ocorrer.
+
+4. Testar a API compilada.
+
+## Como rodar a compilação de EDLs localmente?
+
+Você pode testar a compilação de seus EDLs localmente, incluindo a execução de diversas validações sobre os mesmos, desde que todos estejam dispostos num mesmo diertório.
+
+Para isso, considere os passos a seguir:
+
+1. Crie um diretório, e coloque todos os seus EDLs lá (garantindo que EDLs relacionados estejam no mesmo).
+2. Instale, no seu ambiente pyhton de teste, a biblioteca `nsj-rest-lib2`:
+   
+```sh
+pip install nsj-rest-lib2
+```
+
+3. Rode o comando abaixo (adaptado para seu diretório):
+```sh
+python3 -m nsj_rest_lib2.compiler.compiler -d $(shell pwd)/{diretorio_com_os_edls_json}
+```
+
+O resultado da compilação será impresso no console (erros, ou código total gerado).
+
+## Como configurar uma aplicação para expôr rotas de acordo com o padrão do RestLib2?
+
+Para que uma aplicação exponha as rotas no padrão do RestLib2, não são necessários muitos passos. Antes basta:
+
+1. Instalar, em sua aplicação, a dependência para o projeto nsj-rest-lib2
+
+```sh
+pip install nsj-rest-lib2
+```
+
+Não esqueça de fixar a versão usada (como sendo a última), no arquivo requirements.txt.
+
+2. Adicione a variável de ambiente abaixo em sua aplciação
+
+```env
+ESCOPO_RESTLIB2: "{COLOQUE O IDENTIFICADOR DE ESCOPO QUE DESEJAR PARA SUA APLICAÇÃO (UMA SIMPLES STRING SEM ESPAÇO)}"
+```
+
+* Esse identificador de escopo deve se único para sua aplicação.
+* É importante nota que sua aplicação só irá expôr JSONs de EDL configurados para o mesmo escopo definido aqui.
+
+3. Instale, como dependência a biblioteca, nsj-rest-lib2:
+
+```sh
+pip install nsj-rest-lib2
+```
+
+Não esqueça de fixar a versão usada (como sendo a última), no arquivo requirements.txt.
+
+4. Adicione a linha abaixo no arquivo wsgi.py (de inicilização de sua aplicação):
+
+```python
+from nsj_rest_lib2.controller.dynamic_controller import setup_dynamic_routes
+from nasajon.injector_factory_multibanco import InjectorFactoryMultibanco
+
+setup_dynamic_routes(application, injector_factory=InjectorFactoryMultibanco)
+```
+
+* No exemplo acima, a rota é multibanco, mas, não é obrigatório.
+* Os parâmetros de setup são:
+  * flask_app: Variável obrigatório, que aponte para sua aplicação Flask.
+  * multidb: Flag (padrão True)
+  * dynamic_root_path: URL padrão base de todos os endpoints do RestLib2 (padrão: "edl1")
+  * injector_factory: Classe de injeção de depndência usada (normalmente necessária para aplicações multibanco; o principal uso é justamente manipular a criação da conexão com o BD).
+
+## Carregando EDLs direto do disco
+
+Também é possível carregar EDLs diretamente do disco, sem depender exclusivamente do Redis. Para isso, use o parâmetro opcional `edls_path` em `setup_dynamic_routes`, apontando para um caminho relativo ao workdir da aplicação (ou absoluto), contendo arquivos `.json`, `.yml` ou `.yaml` com os EDLs.
+
+Exemplo:
+
+```python
+from nsj_rest_lib2.controller.dynamic_controller import setup_dynamic_routes
+
+setup_dynamic_routes(
+    application,
+    injector_factory=InjectorFactoryMultibanco,
+    edls_path="@schemas/entities",
+)
+```
+
+Observações:
+* Os EDLs são carregados e compilados uma vez, ficando em cache em memória. Chamadas seguintes reutilizam o cache.
+* A resolução das entidades ocorre primeiro pelo cache local; se não encontrar, o Redis é consultado (quando habilitado).
+
+Para desabilitar o Redis e usar somente EDLs do disco, defina a variável de ambiente abaixo:
+
+```env
+EDLS_FROM_REDIS=false
+```
+
+O valor padrão de `EDLS_FROM_REDIS` é `true`.
+
+
+**Pronto, isso deve bastar para expôr os EDLs configurados para o mesmo escopo da aplicação.**
+
+**OBSERVAÇÃO GERAL: Isso só funciona para aplicações Flask.**

{nsj_rest_lib2-0.0.36 → nsj_rest_lib2-0.0.37}/nsj_rest_lib2/compiler/util/type_naming_util.py

@@ -1,6 +1,8 @@
+import hashlib
 import uuid
-from typing import Iterable
+from typing import Iterable, Iterator, Optional
 
+from nsj_rest_lib2.compiler.model import CompilerResult
 from nsj_rest_lib2.compiler.util.str_util import CompilerStrUtil
 
 
@@ -14,6 +16,67 @@ def compile_namespace_keys(
     return (grupo_key, tenant_key, default_key)
 
 
+def resolve_namespace_key(
+    tenant: str | int | None, grupo_empresarial: str | uuid.UUID | None
+) -> str:
+    grupo_key, tenant_key, default_key = compile_namespace_keys(
+        tenant,
+        grupo_empresarial,
+    )
+
+    if (
+        tenant
+        and tenant != 0
+        and grupo_empresarial
+        and str(grupo_empresarial) != "00000000-0000-0000-0000-000000000000"
+    ):
+        return grupo_key
+    if tenant and tenant != 0:
+        return tenant_key
+    return default_key
+
+
+def build_entity_hash(compiler_result: CompilerResult) -> str:
+    hasher = hashlib.sha256()
+
+    for content in _iter_hash_chunks(
+        compiler_result.dto_code,
+        compiler_result.entity_code,
+        compiler_result.insert_function_name,
+        compiler_result.update_function_name,
+        compiler_result.get_function_name,
+        compiler_result.list_function_name,
+        compiler_result.delete_function_name,
+        compiler_result.source_insert_function,
+        compiler_result.source_update_function,
+        compiler_result.source_get_function_type,
+        compiler_result.source_list_function_type,
+        compiler_result.source_delete_function_type,
+        compiler_result.post_response_dto_class_name,
+        compiler_result.put_response_dto_class_name,
+        compiler_result.patch_response_dto_class_name,
+        str(compiler_result.retrieve_after_insert),
+        str(compiler_result.retrieve_after_update),
+        str(compiler_result.retrieve_after_partial_update),
+        str(compiler_result.custom_json_post_response),
+        str(compiler_result.custom_json_put_response),
+        str(compiler_result.custom_json_patch_response),
+        str(compiler_result.custom_json_get_response),
+        str(compiler_result.custom_json_list_response),
+        str(compiler_result.custom_json_delete_response),
+        compiler_result.service_account,
+    ):
+        hasher.update(content)
+
+    return hasher.hexdigest()
+
+
+def _iter_hash_chunks(*chunks: Optional[str]) -> Iterator[bytes]:
+    for chunk in chunks:
+        if chunk:
+            yield chunk.encode("utf-8")
+
+
 def compile_dto_class_name(entity_id: str, prefx_class_name: str = "") -> str:
     return f"{CompilerStrUtil.to_pascal_case(prefx_class_name)}{CompilerStrUtil.to_pascal_case(entity_id)}DTO"
 

{nsj_rest_lib2-0.0.36 → nsj_rest_lib2-0.0.37}/nsj_rest_lib2/controller/dynamic_controller.py

@@ -55,6 +55,7 @@ def setup_dynamic_routes(
     dynamic_root_path: str = "edl1",
     injector_factory: Any = None,
     escopo_in_url: bool = False,
+    edls_path: str | None = None,
 ) -> None:
 
     if not escopo_in_url:
@@ -68,6 +69,8 @@ def setup_dynamic_routes(
             f"/{APP_NAME}/{dynamic_root_path}/<entity_escopo>/<entity_resource>/<id>"
         )
 
+    entity_loader = EntityLoader(edls_path=edls_path)
+
     def _dynamic_route_wrapper(
         route_builder: Callable[[tuple[Any, ...]], Callable[..., Any]],
         endpoint_suffix: str | None = None,
@@ -83,7 +86,6 @@ def setup_dynamic_routes(
             tenant, grupo_empresarial, force_reload = _get_query_args()
 
             try:
-                entity_loader = EntityLoader()
                 entity_config = entity_loader.load_entity_source(
                     entity_resource,
                     tenant,

{nsj_rest_lib2-0.0.36 → nsj_rest_lib2-0.0.37}/nsj_rest_lib2/service/entity_config_writer.py

@@ -1,13 +1,15 @@
 from __future__ import annotations
 
-import hashlib
 import json
-from typing import Any, Dict, Iterator, Optional
+from typing import Any, Dict
 
 from nsj_rest_lib2.compiler.edl_model.entity_model import EntityModel
 from nsj_rest_lib2.compiler.edl_model.entity_model_base import EntityModelBase
 from nsj_rest_lib2.compiler.model import CompilerResult
-from nsj_rest_lib2.compiler.util.type_naming_util import compile_namespace_keys
+from nsj_rest_lib2.compiler.util.type_naming_util import (
+    build_entity_hash,
+    resolve_namespace_key,
+)
 from nsj_rest_lib2.redis_config import set_redis
 from nsj_rest_lib2.settings import ESCOPO_RESTLIB2
 
@@ -113,21 +115,7 @@ class EntityConfigWriter:
         tenant = getattr(entity_model, "tenant", None)
         grupo_empresarial = getattr(entity_model, "grupo_empresarial", None)
 
-        grupo_key, tenant_key, default_key = compile_namespace_keys(
-            tenant,
-            grupo_empresarial,
-        )
-
-        if (
-            tenant
-            and tenant != 0
-            and grupo_empresarial
-            and str(grupo_empresarial) != "00000000-0000-0000-0000-000000000000"
-        ):
-            return grupo_key
-        if tenant and tenant != 0:
-            return tenant_key
-        return default_key
+        return resolve_namespace_key(tenant, grupo_empresarial)
 
     def _resolve_resource(self, entity_model: EntityModelBase) -> str:
         if not isinstance(entity_model, EntityModel) or not entity_model.api:
@@ -139,41 +127,4 @@ class EntityConfigWriter:
         return entity_model.api.resource
 
     def _build_entity_hash(self, compiler_result: CompilerResult) -> str:
-        hasher = hashlib.sha256()
-
-        for content in self._iter_hash_chunks(
-            compiler_result.dto_code,
-            compiler_result.entity_code,
-            compiler_result.insert_function_name,
-            compiler_result.update_function_name,
-            compiler_result.get_function_name,
-            compiler_result.list_function_name,
-            compiler_result.delete_function_name,
-            compiler_result.source_insert_function,
-            compiler_result.source_update_function,
-            compiler_result.source_get_function_type,
-            compiler_result.source_list_function_type,
-            compiler_result.source_delete_function_type,
-            compiler_result.post_response_dto_class_name,
-            compiler_result.put_response_dto_class_name,
-            compiler_result.patch_response_dto_class_name,
-            str(compiler_result.retrieve_after_insert),
-            str(compiler_result.retrieve_after_update),
-            str(compiler_result.retrieve_after_partial_update),
-            str(compiler_result.custom_json_post_response),
-            str(compiler_result.custom_json_put_response),
-            str(compiler_result.custom_json_patch_response),
-            str(compiler_result.custom_json_get_response),
-            str(compiler_result.custom_json_list_response),
-            str(compiler_result.custom_json_delete_response),
-            compiler_result.service_account,
-        ):
-            hasher.update(content)
-
-        return hasher.hexdigest()
-
-    @staticmethod
-    def _iter_hash_chunks(*chunks: Optional[str]) -> Iterator[bytes]:
-        for chunk in chunks:
-            if chunk:
-                yield chunk.encode("utf-8")
+        return build_entity_hash(compiler_result)