Metadata-Version: 1.1
Name: MonkeyType
Version: 17.12.1
Summary: Generating type annotations from sampled production types
Home-page: https://github.com/instagram/MonkeyType
Author: Matt Page
Author-email: mpage@instagram.com
License: BSD
Description-Content-Type: UNKNOWN
Description: MonkeyType
        ==========
        
        MonkeyType collects runtime types of function arguments and return values, and
        can automatically generate stub files or even add draft type annotations
        directly to your Python code based on the types collected at runtime.
        
        Examples
        --------
        
        Run a script under call-trace logging::
        
          $ monkeytype run myscript.py
        
        Or enable call-trace logging for a block of code::
        
          import monkeytype
        
          with monkeytype.trace():
              ...
        
        By default this will dump call traces into a sqlite database in the file
        ``monkeytype.sqlite3`` in the current working directory. You can then use the
        ``monkeytype`` command to generate a stub file for a module, or apply the type
        annotations directly to your code::
        
          $ monkeytype stub some.module
          $ monkeytype apply some.module
        
        Requirements
        ------------
        
        MonkeyType requires Python 3.6+ and the `retype`_ library (for applying type
        stubs to code files). It generates only Python 3 type annotations (no type
        comments).
        
        Installing
        ----------
        
        Install MonkeyType with `pip`_::
        
          pip install MonkeyType
        
        How MonkeyType works
        --------------------
        
        MonkeyType uses the `sys.setprofile`_ hook provided by Python to interpose on
        function calls, function returns, and generator yields, and record the types of
        arguments / return values / yield values.
        
        It generates `stub files`_ based on that data, and can use `retype`_ to apply those
        stub files directly to your code.
        
        .. _pip: https://pip.pypa.io/en/stable/
        .. _retype: https://pypi.python.org/pypi/retype
        .. _sys.setprofile: https://docs.python.org/3/library/sys.html#sys.setprofile
        .. _stub files: http://mypy.readthedocs.io/en/latest/basics.html#library-stubs-and-the-typeshed-repo
        
        .. end-here
        
        See `the full documentation`_ for details.
        
        .. _the full documentation: http://monkeytype.readthedocs.io/en/latest/
        
        LICENSE
        -------
        
        MonkeyType is BSD licensed. We also provide an additional patent grant.
        
        
        Changelog
        =========
        
        17.12.0
        -------
        
        * Initial public version.
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
