print(f"Hi {name}!")
```

`typing` 也提供了一个声明“可能为 `None`”的快捷方式：`Optional`。

从我非常主观的角度给个小建议：

- 🚨 避免使用 `Optional[SomeType]`
- 改用 ✨`Union[SomeType, None]`✨。

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

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

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

举个例子，看这段函数：

```python
from typing import Optional

        setupViewHelperWithFacetGroups(createFacetQueryView("filetype", "HTML", "filetype:HTML", "WORD", "filetype:WORD"),
                createFacetQueryView("timestamp", "1month", "timestamp:[now-1M TO *]"));
        final MockHttpServletRequest request = new MockHttpServletRequest();
        // Send timestamp first, then filetype — result should follow FacetQueryView order, not request order

        int pipeType = 1;
        SmbPipeResource mockPipe = mock(SmbPipeResource.class);
        when(mockContext.getPipe(url, pipeType)).thenReturn(mockPipe);

        // When
        SmbPipeResource pipe = mockContext.getPipe(url, pipeType);

        // Then
        assertEquals(mockPipe, pipe);
        verify(mockContext).getPipe(url, pipeType);
    }

    @Test

			Key:   config.Enable,
			Value: config.EnableOn,
		},
		config.KV{
			Key:   Extensions,
			Value: strings.Join(cfg.Extensions, config.ValueSeparator),
		},
		config.KV{
			Key:   MimeTypes,
			Value: strings.Join(cfg.MimeTypes, config.ValueSeparator),
		},
	}

    }

    @Test
    void testGetPipe_MalformedURLException() {
        // Test getPipe(String url, int pipeType) with a malformed URL
        String malformedUrl = "invalid-pipe-url";
        int pipeType = 1;
        CIFSException thrown = assertThrows(CIFSException.class, () -> {
            cifsContextWrapper.getPipe(malformedUrl, pipeType);
        });

```

`typing` には、`None` を取り得ることを宣言するための短縮形として `Optional` もあります。

ここからは私のとても主観的な提案です:

- 🚨 `Optional[SomeType]` の使用は避けましょう
- 代わりに ✨ **`Union[SomeType, None]` を使いましょう** ✨。

どちらも等価で内部的には同一ですが、「optional（任意）」という語が値が任意だと誤解させやすく、実際の意味は「`None` を取り得る」であり、任意ではなく依然として必須である場合でもそうです。そのため `Optional` より `Union` を勧めます。

`Union[SomeType, None]` の方が意味がより明確だと思います。

これは用語や名前付けの話に過ぎませんが、その言葉があなたやチームメイトのコードの捉え方に影響します。

例として次の関数を見てみましょう:

        final String k = "filetype";
        assertEquals("", getAsQuery(Collections.singletonMap(k, new String[] { "" })));
        assertEquals("filetype:\"pdf\"", getAsQuery(Collections.singletonMap(k, new String[] { "pdf" })));
        assertEquals("filetype:\"doc\"", getAsQuery(Collections.singletonMap(k, new String[] { " doc " })));

```

В `typing` также есть сокращение, чтобы объявить, что значение может быть `None`, — `Optional`.

Вот совет с моей очень субъективной точки зрения:

- 🚨 Избегайте использования `Optional[SomeType]`
- Вместо этого ✨ используйте **`Union[SomeType, None]`** ✨.

            final String[] fileTypes = ComponentUtil.getFileTypeHelper().getTypes();
            for (final String fileType : fileTypes) {
                final String value = filetypeField + ":" + fileType;
                if (!values.contains(value)) {
                    final String key = "labels.facet_filetype_" + fileType;
                    if (resources.containsKey(key)) {
                        queryMap.put(key, value);

Benim oldukça öznel bakış açıma göre küçük bir ipucu:

- 🚨 `Optional[SomeType]` kullanmaktan kaçının
- Bunun yerine ✨ **`Union[SomeType, None]` kullanın** ✨.

İkisi de eşdeğer ve temelde aynıdır; ancak "**optional**" kelimesi değerin isteğe bağlı olduğunu ima eder. Oysa aslında " `None` olabilir" demektir; değer isteğe bağlı olmasa ve hâlâ zorunlu olsa bile.

Bence `Union[SomeType, None]` ne demek istediğini daha açık anlatır.