From c41c645b1ac45a76e4b7605c5ecfff219434bc52 Mon Sep 17 00:00:00 2001 From: tusharmath Date: Thu, 7 Mar 2024 14:29:45 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20tailcall?= =?UTF-8?q?hq/tailcallhq.github.io@36c3c852d2b0bd6236fd85b2894401210df3377?= =?UTF-8?q?f=20=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 404.html | 4 +- about/index.html | 4 +- ...5d423.3155134e.js => 4fa5d423.f6586cbc.js} | 2 +- assets/js/5f02ec4e.36bf06f2.js | 1 + assets/js/5f02ec4e.d08048ed.js | 1 - assets/js/8a1acdb9.68c042ce.js | 1 + assets/js/935f2afb.814386d8.js | 1 - assets/js/935f2afb.e434a45a.js | 1 + ...fd696.7a7c1b50.js => 9fcfd696.1458644d.js} | 2 +- assets/js/main.216ecc15.js | 2 - assets/js/main.5faf0f57.js | 2 + ...CENSE.txt => main.5faf0f57.js.LICENSE.txt} | 0 assets/js/runtime~main.5c14d47f.js | 1 - assets/js/runtime~main.84f33384.js | 1 + blog/archive/index.html | 4 +- blog/first-blog-post/index.html | 4 +- blog/index.html | 4 +- blog/long-blog-post/index.html | 4 +- blog/mdx-blog-post/index.html | 4 +- blog/tags/docusaurus/index.html | 4 +- blog/tags/facebook/index.html | 4 +- blog/tags/hello/index.html | 4 +- blog/tags/hola/index.html | 4 +- blog/tags/index.html | 4 +- blog/welcome/index.html | 4 +- contact/index.html | 4 +- docs/getting_started/configuration/index.html | 6 +-- docs/getting_started/execute/index.html | 6 +-- docs/getting_started/index.html | 6 +-- docs/getting_started/launch/index.html | 6 +-- docs/guides/cli/index.html | 6 +-- docs/guides/client-tuning/index.html | 6 +-- docs/guides/context/index.html | 6 +-- docs/guides/environment-variables/index.html | 6 +-- docs/guides/grpc/index.html | 6 +-- docs/guides/http-cache/index.html | 6 +-- docs/guides/http-filters/index.html | 6 +-- docs/guides/logging/index.html | 6 +-- docs/guides/n+1/index.html | 6 +-- docs/guides/watch-mode/index.html | 6 +-- docs/index.html | 6 +-- docs/operators/add-field/index.html | 6 +-- docs/operators/cache/index.html | 8 ++-- docs/operators/call/index.html | 42 +++++++++++++++++++ docs/operators/const/index.html | 8 ++-- docs/operators/graphql/index.html | 6 +-- docs/operators/grpc/index.html | 6 +-- docs/operators/http/index.html | 6 +-- docs/operators/index.html | 8 ++-- docs/operators/link/index.html | 6 +-- docs/operators/modify/index.html | 6 +-- docs/operators/omit/index.html | 6 +-- docs/operators/server/index.html | 6 +-- docs/operators/upstream/index.html | 6 +-- enterprise/index.html | 4 +- index.html | 4 +- lunr-index-1709715443474.json | 1 - lunr-index-1709821749431.json | 1 + lunr-index.json | 2 +- search-doc-1709715443474.json | 1 - search-doc-1709821749431.json | 1 + search-doc.json | 2 +- 62 files changed, 170 insertions(+), 127 deletions(-) rename assets/js/{4fa5d423.3155134e.js => 4fa5d423.f6586cbc.js} (84%) create mode 100644 assets/js/5f02ec4e.36bf06f2.js delete mode 100644 assets/js/5f02ec4e.d08048ed.js create mode 100644 assets/js/8a1acdb9.68c042ce.js delete mode 100644 assets/js/935f2afb.814386d8.js create mode 100644 assets/js/935f2afb.e434a45a.js rename assets/js/{9fcfd696.7a7c1b50.js => 9fcfd696.1458644d.js} (97%) delete mode 100644 assets/js/main.216ecc15.js create mode 100644 assets/js/main.5faf0f57.js rename assets/js/{main.216ecc15.js.LICENSE.txt => main.5faf0f57.js.LICENSE.txt} (100%) delete mode 100644 assets/js/runtime~main.5c14d47f.js create mode 100644 assets/js/runtime~main.84f33384.js create mode 100644 docs/operators/call/index.html delete mode 100644 lunr-index-1709715443474.json create mode 100644 lunr-index-1709821749431.json delete mode 100644 search-doc-1709715443474.json create mode 100644 search-doc-1709821749431.json diff --git a/404.html b/404.html index 5c7acff1f0..38c3f23f57 100644 --- a/404.html +++ b/404.html @@ -16,8 +16,8 @@ - - + +
Skip to main content

Watch Mode

Developers often find themselves in situations where they need to run a server in watch mode to streamline the development process. This guide will introduce you to entr, a versatile file-watcher tool, and how to run your server in watch mode with it. We'll also touch on the installation process and suggest some best practices to optimize your workflow.

Use case​

Running a server in watch mode offers a lot of key benefits:

\ No newline at end of file diff --git a/docs/operators/graphql/index.html b/docs/operators/graphql/index.html index 38084e3665..0d4a23f5f1 100644 --- a/docs/operators/graphql/index.html +++ b/docs/operators/graphql/index.html @@ -16,14 +16,14 @@ - - + +

@graphQL

The @graphQL operator allows to specify GraphQL API server request to fetch data from.

+ Star

@graphQL

The @graphQL operator allows to specify GraphQL API server request to fetch data from.

type Query {
  users: [User] @graphQL(name: "userList")
}

The @graphQL operator facilitates fetching a list of users from the GraphQL API upstream. The name argument specifies the root field's name on the upstream server. The upcoming request to the Tailcall server determines the User type's inner fields for the request. Depending on the operation type within which one finds the @graphQL operator, the Tailcall config determines the query's operation type.

For the next request with the config above:

diff --git a/docs/operators/grpc/index.html b/docs/operators/grpc/index.html index 8a80a60f00..234f75674f 100644 --- a/docs/operators/grpc/index.html +++ b/docs/operators/grpc/index.html @@ -16,14 +16,14 @@ - - + +

@grpc

The @grpc directive enables the resolution of GraphQL fields via gRPC services. Below is an illustrative example of how to apply this directive within a GraphQL schema:

+ Star

@grpc

The @grpc directive enables the resolution of GraphQL fields via gRPC services. Below is an illustrative example of how to apply this directive within a GraphQL schema:

schema @link(src: "./users.proto", type: Protobuf) {
  query: Query
}

type Query {
  users: [User] @grpc(method: "users.UserService.ListUsers")
}

This schema snippet demonstrates the directive's application, where a query for users triggers a gRPC request to the UserService's ListUsers method, thereby fetching the user data.

The .proto file delineates the structure and methods of the gRPC service. A simplified example of such a file is as follows:

diff --git a/docs/operators/http/index.html b/docs/operators/http/index.html index d87f631a2f..2dcbea8416 100644 --- a/docs/operators/http/index.html +++ b/docs/operators/http/index.html @@ -16,14 +16,14 @@ - - + +

@http

The @http operator indicates a field or node relies on a REST API. For example:

+ Star

@http

The @http operator indicates a field or node relies on a REST API. For example:

type Query {
  users: [User] @http(path: "/users")
}

In this example, adding the @http operator to the users field of the Query type indicates reliance on a REST API for the users field. The path argument specifies the REST API's path, which is /users in this scenario.Querying the users field prompts the GraphQL server to issue a GET request to https://jsonplaceholder.typicode.com/users.

baseURL​

diff --git a/docs/operators/index.html b/docs/operators/index.html index fc961e833e..54d98de748 100644 --- a/docs/operators/index.html +++ b/docs/operators/index.html @@ -16,16 +16,16 @@ - - + +

Operators

Tailcall DSL builds on your existing GraphQL knowledge by allowing the addition of some custom operators. These operators provide powerful compile time guarantees to ensure your API composition is tight and robust. The system automatically generates highly optimized resolver logic for your types using the operator information.

+ Star

Operators

Tailcall DSL builds on your existing GraphQL knowledge by allowing the addition of some custom operators. These operators provide powerful compile time guarantees to ensure your API composition is tight and robust. The system automatically generates highly optimized resolver logic for your types using the operator information.

Here is a list of all the custom operators supported by Tailcall:

Certainly! Here's the table with hyperlinks added back to the operator names:

-
OperatorDescription
@addFieldSimplifies data structures and queries by adding, inlining, or flattening fields or nodes within the schema.
@cacheEnables caching for the query, field or type applied to.
@constAllows embedding of a constant response within the schema.
@graphQLResolves a field or node by a GraphQL API.
@grpcResolves a field or node by a gRPC API.
@httpResolves a field or node by a REST API.
@linkImports external resources such as config files, certs, protobufs, etc in the schema.
@modifyEnables changes to attributes of fields or nodes in the schema.
@omitExcludes fields or nodes from the generated schema, making them inaccessible through the GraphQL API.
@serverProvides server configurations for behavior tuning and tailcall optimization in specific use-cases.
@upstreamControls aspects of the upstream server connection, including timeouts and keep-alive settings.
+
OperatorDescription
@addFieldSimplifies data structures and queries by adding, inlining, or flattening fields or nodes within the schema.
@cacheEnables caching for the query, field or type applied to.
@callInvokes a query or mutation from another query or mutation field.
@constAllows embedding of a constant response within the schema.
@graphQLResolves a field or node by a GraphQL API.
@grpcResolves a field or node by a gRPC API.
@httpResolves a field or node by a REST API.
@linkImports external resources such as config files, certs, protobufs, etc in the schema.
@modifyEnables changes to attributes of fields or nodes in the schema.
@omitExcludes fields or nodes from the generated schema, making them inaccessible through the GraphQL API.
@serverProvides server configurations for behavior tuning and tailcall optimization in specific use-cases.
@upstreamControls aspects of the upstream server connection, including timeouts and keep-alive settings.
\ No newline at end of file diff --git a/docs/operators/link/index.html b/docs/operators/link/index.html index 5597eeeb6e..4b736c3963 100644 --- a/docs/operators/link/index.html +++ b/docs/operators/link/index.html @@ -16,14 +16,14 @@ - - + +

@link

The @link operator is used for bringing external resources into your GraphQL schema. It makes it easier to include configurations, .proto files for gRPC services, and other files into your schema. With this operator, external resources are either merged with or used effectively in the importing configuration.

+ Star

@link

The @link operator is used for bringing external resources into your GraphQL schema. It makes it easier to include configurations, .proto files for gRPC services, and other files into your schema. With this operator, external resources are either merged with or used effectively in the importing configuration.

How it Works​

The @link directive requires specifying a source src, the resource's type type, and an optional identifier id.