source:
    type: minio # valid values are "s3" or "minio"
    bucket: mytest
    prefix: object-prefix1 # 'PREFIX' is optional
    # If your source is the 'local' alias specified to 'mc batch start', then the 'endpoint' and 'credentials' fields are optional and can be omitted
    # Either the 'source' or 'remote' *must* be the "local" deployment
#    endpoint: "http://127.0.0.1:9000"

@REM
@REM   JAVA_HOME           (Optional) Points to a Java installation.
@REM   MAVEN_BATCH_ECHO    (Optional) Set to 'on' to enable the echoing of the batch commands.
@REM   MAVEN_BATCH_PAUSE   (Optional) set to 'on' to wait for a key stroke before ending.
@REM   MAVEN_OPTS          (Optional) Java runtime options used when Maven is executed.
@REM   MAVEN_SKIP_RC       (Optional) Flag to disable loading of mavenrc files.

     * @param active Should the profile be activated?
     * @param optional Can the build continue if the profile does not exist?
     */
    public void addProfileActivation(String id, boolean active, boolean optional) {
        final ActivationSettings settings = ActivationSettings.of(active, optional);
        this.activations.put(id, settings);
    }

Voici un conseil issu de mon point de vue très subjectif :

- 🚨 Évitez d'utiliser `Optional[SomeType]`
- À la place ✨ **utilisez `Union[SomeType, None]`** ✨.

        when(options.all()).thenReturn(Optional.ofNullable(all));
        when(options.infer()).thenReturn(Optional.ofNullable(infer));
        when(options.model()).thenReturn(Optional.ofNullable(model));
        when(options.plugins()).thenReturn(Optional.ofNullable(plugins));
        when(options.modelVersion()).thenReturn(Optional.ofNullable(modelVersion));
        return options;
    }

    /**

    /**
     * Performs a lookup for optional typed component.
     *
     * @param type The component type.
     * @return Optional carrying component or empty optional if no such component.
     * @param <T> The component type.
     * @throws LookupException if there is some provisioning related issue.
     */
    @Nonnull
    <T> Optional<T> lookupOptional(Class<T> type);

    /**

    }

    @Override
    public Optional<Path> rootDirectory() {
        return Optional.ofNullable(rootDirectory);
    }

    @Override
    public Optional<List<CoreExtensions>> coreExtensions() {
        return Optional.ofNullable(coreExtensions);
    }

    @Override
    public Optional<CIInfo> ciInfo() {
        return Optional.ofNullable(ciInfo);
    }

`typing`에는 `None`이 될 수 있음을 선언하는 축약형으로 `Optional`도 있습니다.

아주 개인적인 관점에서의 팁입니다:

- 🚨 `Optional[SomeType]` 사용은 피하세요
- 대신 ✨ **`Union[SomeType, None]`를 사용하세요** ✨.

둘은 동등하며 내부적으로도 같습니다. 하지만 단어 "optional"은 값이 선택 사항이라는 인상을 주는 반면, 실제 의미는 "값이 `None`이 될 수 있다"는 뜻입니다. 값이 선택 사항이 아니라 여전히 필수인 경우에도 그렇습니다.

`Union[SomeType, None]`가 의미를 더 명확하게 드러낸다고 생각합니다.

이는 단지 단어와 명칭의 문제입니다. 하지만 이런 단어가 여러분과 팀원이 코드를 어떻게 생각하는지에 영향을 줄 수 있습니다.

예를 들어, 다음 함수를 보세요:

```python

        return of(active, optional, true);
    }

    static ActivationSettings of(final boolean active, final boolean optional, final boolean recursive) {
        return new ActivationSettings(active, optional, recursive);
    }

    static ActivationSettings activated() {
        return new ActivationSettings(true, false, true);
    }

    static ActivationSettings activatedOpt() {

两者是等价的，底层其实也是一样的。但我更推荐使用 `Union` 而不是 `Optional`，因为单词“optional”（可选）看起来会暗示该值是可选的，而它真正的含义是“它可以是 `None`”，即使它并不是可选的，仍然是必填的。

我认为 `Union[SomeType, None]` 更能明确表达其含义。

这只是关于词语和命名的问题，但这些词语会影响你和你的队友如何看待代码。

举个例子，看这段函数：

```python
from typing import Optional


def say_hi(name: Optional[str]):
    print(f"Hey {name}!")
```

参数 `name` 被定义为 `Optional[str]`，但它并不是“可选”的，你不能不传这个参数就调用函数：

```Python