https://github.com/google/importlab

A library that automatically infers dependencies for Python files
https://github.com/google/importlab

Last synced: about 2 months ago
JSON representation

A library that automatically infers dependencies for Python files

• Host: GitHub
• URL: https://github.com/google/importlab
• Owner: google
• License: apache-2.0
• Created: 2018-02-28T18:40:33.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2024-05-03T08:56:10.000Z (5 months ago)
• Last Synced: 2024-07-20T00:58:00.700Z (2 months ago)
• Language: Python
• Homepage:
• Size: 198 KB
• Stars: 167
• Watchers: 14
• Forks: 24
• Open Issues: 11
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-python-code-formatters - importlab
• awesome-python-testing - importlab - A library that automatically infers dependencies for Python files. Importlab's main use case is to work with static analysis tools that process one file at a time, ensuring that a file's dependencies are analysed before it is. (Tools)

README

        
importlab

---------

Importlab is a library for Python that automatically infers dependencies

and calculates a dependency graph. It can perform dependency ordering of

a set of files, including cycle detection.

Importlab's main use case is to work with static analysis tools that

process one file at a time, ensuring that a file's dependencies are

analysed before it is.

(This is not an official Google product.)

License

-------

Apache 2.0

Installation

------------

Importlab can be installed from pip

::

    pip install importlab

To check out and install the latest source code

::

    git clone https://github.com/google/importlab.git

    cd importlab

    python setup.py install

Usage

-----

Importlab is primarily intended to be used as a library. It takes one or

more python files as arguments, and generates an import graph, typically

used to process files in dependency order.

It is currently integrated into

`pytype `__

Command-line tool

-----------------

Importlab ships with a small command-line tool, also called

``importlab``, which can display some information about a project's

import graph.

::

    usage: importlab [-h] [--tree] [--unresolved] [filename [filename ...]]

    positional arguments:

      filename              input file(s)

    optional arguments:

      -h, --help            show this help message and exit

      --tree                Display import tree.

      --unresolved          Display unresolved dependencies.

Roadmap

-------

-  ``Makefile`` generation, to take advantage of ``make``'s incremental

   update and parallel execution features

-  Integration with other static analysis tools