Restore 0.1.5 version from stash

2025-12-08 19:56:24 +08:00
parent de189e938d
commit 8db3f4e32d
8578 changed files with 2703426 additions and 217 deletions
@@ -0,0 +1,134 @@
+from typing import Any
+from typing import List
+from typing import Union
+from typing import Callable
+from typing import Optional
+from typing import Text
+
+from pypinyin.constants import Style
+
+
+TStyle = Style
+TErrors = Union[Callable[[Text], Text], Text]
+TPinyinResult = List[List[Text]]
+TErrorResult = Union[Text, List[Text], None]
+TNoPinyinResult = Union[TPinyinResult, List[Text], Text, None]
+
+
+class Converter(object):
+    def convert(self, words: Text, style: TStyle, heteronym: bool,
+                errors: TErrors, strict: bool = ...,
+                **kwargs: Any) -> TPinyinResult: ...
+
+
+class DefaultConverter(Converter):
+    def __init__(self, **kwargs: Any) -> None: ...
+
+    def convert(self, words: Text, style: TStyle, heteronym: bool,
+                errors: TErrors, strict: bool = ...,
+                **kwargs: Any) -> TPinyinResult: ...
+
+    def pre_convert_style(self, han: Text, orig_pinyin: Text, style: TStyle,
+                          strict: bool, **kwargs: Any) -> Optional[Text]: ...
+
+    def convert_style(self, han: Text, orig_pinyin: Text, style: TStyle,
+                      strict: bool, **kwargs: Any) -> Text: ...
+
+    def post_convert_style(self, han: Text, orig_pinyin: Text,
+                           converted_pinyin: Text, style: TStyle,
+                           strict: bool, **kwargs: Any) -> Optional[Text]: ...
+
+    def pre_handle_nopinyin(self, chars: Text, style: TStyle, heteronym: bool,
+                            errors: TErrors, strict: bool
+                            ) -> TNoPinyinResult: ...
+
+    def handle_nopinyin(self, chars: Text, style: TStyle, heteronym: bool,
+                        errors: TErrors, strict: bool, **kwargs: Any
+                        ) -> TPinyinResult: ...
+
+    def post_handle_nopinyin(self, chars: Text, style: Style, heteronym: bool,
+                             errors: TErrors, strict: bool,
+                             pinyin: TNoPinyinResult, **kwargs: Any
+                             ) -> TNoPinyinResult: ...
+
+    def post_pinyin(self, han: Text, heteronym: bool,
+                    pinyin: TPinyinResult,
+                    **kwargs: Any) -> Union[TPinyinResult, None]: ...
+
+    def convert_styles(self, pinyin_list: TPinyinResult,
+                       phrase: Text, style: TStyle, heteronym: bool,
+                       errors: TErrors, strict: bool, **kwargs: Any,
+                       ) -> TPinyinResult: ...
+
+    def _phrase_pinyin(self, phrase: Text, style: TStyle, heteronym: bool,
+                       errors: TErrors, strict: bool
+                       ) -> TPinyinResult: ...
+
+    def _single_pinyin(self, han: Text, style: TStyle, heteronym: bool,
+                       errors: TErrors, strict: bool
+                       ) -> TPinyinResult: ...
+
+    def _convert_style(self, han: Text, pinyin: Text, style: TStyle,
+                       strict: bool, default: Text, **kwargs: Any
+                       ) -> Text: ...
+
+    def _convert_nopinyin_chars(self, chars: Text, style: TStyle,
+                                heteronym: bool, errors: TErrors,
+                                strict: bool
+                                ) -> TNoPinyinResult: ...
+
+
+class UltimateConverter(DefaultConverter):
+    def __init__(self, **kwargs: Any) -> None:
+        self._tone_sandhi = ...
+        self._neutral_tone_with_five = ...
+        self._v_to_u = ...
+        ...
+
+    def convert(self, words: Text, style: TStyle, heteronym: bool,
+                errors: TErrors, strict: bool = ...,
+                **kwargs: Any) -> TPinyinResult: ...
+
+    def pre_convert_style(self, han: Text, orig_pinyin: Text, style: TStyle,
+                          strict: bool, **kwargs: Any) -> Optional[Text]: ...
+
+    def convert_style(self, han: Text, orig_pinyin: Text, style: TStyle,
+                      strict: bool, **kwargs: Any) -> Text: ...
+
+    def post_convert_style(self, han: Text, orig_pinyin: Text,
+                           converted_pinyin: Text, style: TStyle,
+                           strict: bool, **kwargs: Any) -> Optional[Text]: ...
+
+    def pre_handle_nopinyin(self, chars: Text, style: TStyle, heteronym: bool,
+                            errors: TErrors, strict: bool
+                            ) -> TNoPinyinResult: ...
+
+    def handle_nopinyin(self, chars: Text, style: TStyle, heteronym: bool,
+                        errors: TErrors, strict: bool, **kwargs: Any
+                        ) -> TPinyinResult: ...
+
+    def post_handle_nopinyin(self, chars: Text, style: Style, heteronym: bool,
+                             errors: TErrors, strict: bool,
+                             pinyin: TNoPinyinResult, **kwargs: Any
+                             ) -> TNoPinyinResult: ...
+
+    def post_pinyin(self, han: Text, heteronym: bool,
+                    pinyin: TPinyinResult,
+                    **kwargs: Any) -> Union[TPinyinResult, None]: ...
+
+    def _phrase_pinyin(self, phrase: Text, style: TStyle, heteronym: bool,
+                       errors: TErrors, strict: bool
+                       ) -> TPinyinResult: ...
+
+    def _single_pinyin(self, han: Text, style: TStyle, heteronym: bool,
+                       errors: TErrors, strict: bool
+                       ) -> TPinyinResult: ...
+
+    def _convert_style(self, han: Text, pinyin: Text, style: TStyle,
+                       strict: bool, default: Text, **kwargs: Any
+                       ) -> Text: ...
+
+    def _convert_nopinyin_chars(self, chars: Text, style: TStyle,
+                                heteronym: bool, errors: TErrors,
+                                strict: bool
+                                ) -> TNoPinyinResult: ...