Merge branch 'master' into watcher

Author: Borda

.github/scripts/requirements.txt

@@ -1,10 +1,13 @@
-setuptools <65.7.0
-pip <23.0
+setuptools <65.7.0 ; python_version == '2.7'
+setuptools <=69.1.1 ; python_version >= '3.8'
+pip <23.0 ; python_version == '2.7'
+pip ; python_version >= '3.5'
 pylint <2.15.10
 pytest <=7.2.1
 pytest-pylint <=1.1.2
 pytest-runner <6.0.0
 termcolor <2.2.0
 hypothesis <6.62.0
-python-Levenshtein <0.20.9
-mock <5.0.0
+python-Levenshtein <0.20.9 ; python_version == '2.7'
+levenshtein <=0.25.0 ; python_version >= '3.5'
+mock <5.0.0

.github/workflows/build.yml

@@ -7,7 +7,7 @@ jobs:
     runs-on: ubuntu-20.04
     strategy:
       matrix:
-        python-version: ["2.7", "3.5", "3.7", "3.8", "3.9", "3.10"]
+        python-version: ["3.5", "3.7", "3.8", "3.9", "3.10", "3.11", "3.12"]
 
     steps:
      # Checkout the repo.

fire/__init__.py

@@ -21,4 +21,4 @@
 from fire.core import Fire
 
 __all__ = ['Fire']
-__version__ = '0.5.0'
+__version__ = '0.6.0'

fire/__main__.py

@@ -80,7 +80,7 @@ def import_from_file_path(path):
     spec.loader.exec_module(module)  # pytype: disable=attribute-error
 
   else:
-    import imp  # pylint: disable=g-import-not-at-top,import-outside-toplevel,deprecated-module
+    import imp  # pylint: disable=g-import-not-at-top,import-outside-toplevel,deprecated-module,import-error
     module = imp.load_source(module_name, path)
 
   return module, module_name

fire/completion.py

@@ -104,7 +104,7 @@ def _BashScript(name, commands, default_options=None):
 option_already_entered()
 {{
   local opt
-  for opt in ${{COMP_WORDS[@]:0:COMP_CWORD}}
+  for opt in ${{COMP_WORDS[@]:0:$COMP_CWORD}}
   do
     if [ $1 == $opt ]; then
       return 0

fire/console/console_attr.py

@@ -268,7 +268,7 @@ def __init__(self, encoding=None, suppress_output=False):
 
     # ANSI "standard" attributes.
     if self.SupportsAnsi():
-      # Select Graphic Rendition paramaters from
+      # Select Graphic Rendition parameters from
       # http://en.wikipedia.org/wiki/ANSI_escape_code#graphics
       # Italic '3' would be nice here but its not widely supported.
       self._csi = '\x1b['
@@ -394,7 +394,7 @@ def GetControlSequenceIndicator(self):
     """Returns the control sequence indicator string.
 
     Returns:
-      The conrol sequence indicator string or None if control sequences are not
+      The control sequence indicator string or None if control sequences are not
       supported.
     """
     return self._csi
@@ -408,7 +408,7 @@ def GetControlSequenceLen(self, buf):
       buf: The string to check for a control sequence.
 
     Returns:
-      The conrol sequence length at the beginning of buf or 0 if buf does not
+      The control sequence length at the beginning of buf or 0 if buf does not
       start with a control sequence.
     """
     if not self._csi or not buf.startswith(self._csi):

fire/console/console_attr_os.py

@@ -123,7 +123,7 @@ def _GetTermSizeEnvironment():
 
 
 def _GetTermSizeTput():
-  """Returns the terminal x and y dimemsions from tput(1)."""
+  """Returns the terminal x and y dimensions from tput(1)."""
   import subprocess  # pylint: disable=g-import-not-at-top
   output = encoding.Decode(subprocess.check_output(['tput', 'cols'],
                                                    stderr=subprocess.STDOUT))

fire/console/console_pager.py

@@ -94,7 +94,7 @@ def __init__(self, contents, out=None, prompt=None):
     Args:
       contents: The entire contents of the text lines to page.
       out: The output stream, log.out (effectively) if None.
-      prompt: The page break prompt, a defalt prompt is used if None..
+      prompt: The page break prompt, a default prompt is used if None..
     """
     self._contents = contents
     self._out = out or sys.stdout

fire/console/encoding.py

@@ -86,15 +86,15 @@ def Decode(data, encoding=None):
 
   try:
     # Just return the string if its pure ASCII.
-    return string.decode('ascii')
+    return string.decode('ascii')  # pytype: disable=attribute-error
   except UnicodeError:
     # The string is not ASCII encoded.
     pass
 
   # Try the suggested encoding if specified.
   if encoding:
     try:
-      return string.decode(encoding)
+      return string.decode(encoding)  # pytype: disable=attribute-error
     except UnicodeError:
       # Bad suggestion.
       pass
@@ -103,21 +103,21 @@ def Decode(data, encoding=None):
   # be exceptional if a valid extended ascii encoding with extended chars
   # were also a valid UITF-8 encoding.
   try:
-    return string.decode('utf8')
+    return string.decode('utf8')  # pytype: disable=attribute-error
   except UnicodeError:
     # Not a UTF-8 encoding.
     pass
 
   # Try the filesystem encoding.
   try:
-    return string.decode(sys.getfilesystemencoding())
+    return string.decode(sys.getfilesystemencoding())  # pytype: disable=attribute-error
   except UnicodeError:
     # string is not encoded for filesystem paths.
     pass
 
   # Try the system default encoding.
   try:
-    return string.decode(sys.getdefaultencoding())
+    return string.decode(sys.getdefaultencoding())  # pytype: disable=attribute-error
   except UnicodeError:
     # string is not encoded using the default encoding.
     pass
@@ -137,7 +137,7 @@ def Decode(data, encoding=None):
   #   string = '\xdc'
   #   string = string.decode('iso-8859-1')
   #   string = string.encode('ascii', 'backslashreplace')
-  return string.decode('iso-8859-1')
+  return string.decode('iso-8859-1')  # pytype: disable=attribute-error
 
 
 def GetEncodedValue(env, name, default=None):

fire/core.py

@@ -94,6 +94,8 @@ def Fire(component=None, command=None, name=None, serialize=None):
         a string or a list of strings; a list of strings is preferred.
     name: Optional. The name of the command as entered at the command line.
         Used in interactive mode and for generating the completion script.
+    serialize: Optional. If supplied, all objects are serialized to text via
+        the provided callable.
   Returns:
     The result of executing the Fire command. Execution begins with the initial
     target component. The component is updated by using the command arguments