Update 3rd lib

Author: rexzhang

Update3rdLib.sh

@@ -1,2 +1,2 @@
-pip install -U --target=. Alfred-Workflow
-pip install -U --target=. arrow==0.17
+pip install -U --target=. ualfred
+pip install -U --target=. arrow

arrow/__init__.py

@@ -1,4 +1,3 @@
-# -*- coding: utf-8 -*-
 from ._version import __version__
 from .api import get, now, utcnow
 from .arrow import Arrow
@@ -16,3 +15,25 @@
     FORMAT_W3C,
 )
 from .parser import ParserError
+
+# https://mypy.readthedocs.io/en/stable/command_line.html#cmdoption-mypy-no-implicit-reexport
+# Mypy with --strict or --no-implicit-reexport requires an explicit reexport.
+__all__ = [
+    "__version__",
+    "get",
+    "now",
+    "utcnow",
+    "Arrow",
+    "ArrowFactory",
+    "FORMAT_ATOM",
+    "FORMAT_COOKIE",
+    "FORMAT_RFC822",
+    "FORMAT_RFC850",
+    "FORMAT_RFC1036",
+    "FORMAT_RFC1123",
+    "FORMAT_RFC2822",
+    "FORMAT_RFC3339",
+    "FORMAT_RSS",
+    "FORMAT_W3C",
+    "ParserError",
+]

arrow/_version.py

@@ -1 +1 @@
-__version__ = "0.17.0"
+__version__ = "1.2.3"

arrow/api.py

@@ -1,19 +1,91 @@
-# -*- coding: utf-8 -*-
 """
 Provides the default implementation of :class:`ArrowFactory <arrow.factory.ArrowFactory>`
 methods for use as a module API.
 
 """
 
-from __future__ import absolute_import
+from datetime import date, datetime
+from datetime import tzinfo as dt_tzinfo
+from time import struct_time
+from typing import Any, List, Optional, Tuple, Type, Union, overload
 
+from arrow.arrow import TZ_EXPR, Arrow
+from arrow.constants import DEFAULT_LOCALE
 from arrow.factory import ArrowFactory
 
 # internal default factory.
 _factory = ArrowFactory()
 
-
-def get(*args, **kwargs):
+# TODO: Use Positional Only Argument (https://www.python.org/dev/peps/pep-0570/)
+#  after Python 3.7 deprecation
+
+
+@overload
+def get(
+    *,
+    locale: str = DEFAULT_LOCALE,
+    tzinfo: Optional[TZ_EXPR] = None,
+    normalize_whitespace: bool = False,
+) -> Arrow:
+    ...  # pragma: no cover
+
+
+@overload
+def get(
+    *args: int,
+    locale: str = DEFAULT_LOCALE,
+    tzinfo: Optional[TZ_EXPR] = None,
+    normalize_whitespace: bool = False,
+) -> Arrow:
+    ...  # pragma: no cover
+
+
+@overload
+def get(
+    __obj: Union[
+        Arrow,
+        datetime,
+        date,
+        struct_time,
+        dt_tzinfo,
+        int,
+        float,
+        str,
+        Tuple[int, int, int],
+    ],
+    *,
+    locale: str = DEFAULT_LOCALE,
+    tzinfo: Optional[TZ_EXPR] = None,
+    normalize_whitespace: bool = False,
+) -> Arrow:
+    ...  # pragma: no cover
+
+
+@overload
+def get(
+    __arg1: Union[datetime, date],
+    __arg2: TZ_EXPR,
+    *,
+    locale: str = DEFAULT_LOCALE,
+    tzinfo: Optional[TZ_EXPR] = None,
+    normalize_whitespace: bool = False,
+) -> Arrow:
+    ...  # pragma: no cover
+
+
+@overload
+def get(
+    __arg1: str,
+    __arg2: Union[str, List[str]],
+    *,
+    locale: str = DEFAULT_LOCALE,
+    tzinfo: Optional[TZ_EXPR] = None,
+    normalize_whitespace: bool = False,
+) -> Arrow:
+    ...  # pragma: no cover
+
+
+def get(*args: Any, **kwargs: Any) -> Arrow:
     """Calls the default :class:`ArrowFactory <arrow.factory.ArrowFactory>` ``get`` method."""
 
     return _factory.get(*args, **kwargs)
@@ -22,7 +94,7 @@ def get(*args, **kwargs):
 get.__doc__ = _factory.get.__doc__
 
 
-def utcnow():
+def utcnow() -> Arrow:
     """Calls the default :class:`ArrowFactory <arrow.factory.ArrowFactory>` ``utcnow`` method."""
 
     return _factory.utcnow()
@@ -31,7 +103,7 @@ def utcnow():
 utcnow.__doc__ = _factory.utcnow.__doc__
 
 
-def now(tz=None):
+def now(tz: Optional[TZ_EXPR] = None) -> Arrow:
     """Calls the default :class:`ArrowFactory <arrow.factory.ArrowFactory>` ``now`` method."""
 
     return _factory.now(tz)
@@ -40,7 +112,7 @@ def now(tz=None):
 now.__doc__ = _factory.now.__doc__
 
 
-def factory(type):
+def factory(type: Type[Arrow]) -> ArrowFactory:
     """Returns an :class:`.ArrowFactory` for the specified :class:`Arrow <arrow.arrow.Arrow>`
     or derived type.