*/
    // POST /api/admin/searchlist/doc
    @Execute
    public JsonResponse<ApiResult> post$doc(final CreateBody body) {
        validateApi(body, messages -> {});
        if (body.doc == null) {
            throwValidationErrorApi(messages -> messages.addErrorsCrudFailedToCreateCrudTable(GLOBAL, "doc is required"));
        }
        validateFields(body.doc, this::throwValidationErrorApi);

            task.from(project.zipTree(groovyPackageListConf.map(Configuration::getSingleFile)));
            // See https://docs.oracle.com/en/java/javase/21/docs/specs/man/javadoc.html#option-linkoffline
            task.include("package-list", "element-list");
            task.into(layout.getBuildDirectory().dir("groovyPackageList"));
        });

        if (logger.isDebugEnabled()) {
            logger.debug("Doc JSON import started: fileName={}", fileName);
        }

        try (final InputStream in = new FileInputStream(tempFile); final OutputStream out = Files.newOutputStream(getDocJsonPath())) {
            CopyUtil.copy(in, out);

            if (logger.isInfoEnabled()) {
                logger.info("Doc JSON import completed successfully: fileName={}", fileName);

 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package gradlebuild.docs.dsl.source.model

import spock.lang.Specification

class ParameterMetaDataTest extends Specification {
    def "formats signature"() {
        MethodMetaData method = Mock()

例如，您可以有一个名为 `main.py` 的文件，其中包含以下内容：

```Python hl_lines="3"
import os

name = os.getenv("MY_NAME", "World")
print(f"Hello {name} from Python")
```

/// tip

<a href="https://docs.python.org/3.8/library/os.html#os.getenv" class="external-link" target="_blank">`os.getenv()`</a> 的第二个参数是要返回的默认值。

如果没有提供默认值，默认为 `None`，此处我们提供了 `"World"` 作为要使用的默认值。

///

然后，您可以调用该 Python 程序：

<div class="termy">

    void testGetFilename() throws SMBProtocolDecodingException {
        // Prepare test data
        String expectedFilename = "longfilename.docx";
        byte[] buffer = createValidBuffer(expectedFilename, "LONGFI~1.DOC", true);

        // Decode
        fileBothDirectoryInfo.decode(buffer, 0, buffer.length);

        // Verify

        ],
        "parallelizationMethod": {
          "name": "TestDistributionAlpine"
        }
      },
      {
        "subprojects": [
          "daemon-protocol",
          "docs",
          "docs-asciidoctor-extensions-base",
          "file-temp",
          "files",
          "functional",
          "gradle-cli",
          "hashing",
          "isolated-action-services",

- 路徑 `/items/{item_id}` 有一個 `int` 型別的 `item_id` 參數。
- 路徑 `/items/{item_id}` 有一個 `str` 型別的查詢參數 `q`。

### 互動式 API 文件

使用瀏覽器開啟 <a href="http://127.0.0.1:8000/docs" class="external-link" target="_blank">http://127.0.0.1:8000/docs</a>。

你會看到自動生成的互動式 API 文件（由 <a href="https://github.com/swagger-api/swagger-ui" class="external-link" target="_blank">Swagger UI</a> 生成）：

[Extending the Kubernetes API with the aggregation layer](https://kubernetes.io/docs/concepts/api-extension/apiserver-aggregation/), [Configure the aggregation layer](https://kubernetes.io/docs/tasks/access-kubernetes-api/configure-aggregation-layer/), and [Setup an extension API server](https://kubernetes.io/docs/tasks/access-kubernetes-api/setup-extension-api-server/).

* [alpha] Adding admissionregistration API group which enables dynamic registration of initializers and external admission...

## Caveat { #caveat }

If you need to perform heavy background computation and you don't necessarily need it to be run by the same process (for example, you don't need to share memory, variables, etc), you might benefit from using other bigger tools like <a href="https://docs.celeryq.dev" class="external-link" target="_blank">Celery</a>.