As with most ML tasks, we need to find a set of relevant features in order to predict type annotations. Here, we consider features as type hints. Specifically, we extract three kinds of type hints, namely, identifiers, code context, and visible type hints (VTHs).To learn from the extracted sequences, first, we apply common NL pre-processing techniques tokenization (by <a href="https://en.wikipedia.org/wiki/Snake_case" rel="noopener noreferrer" target="_blank">snake case </a>), stop word removal and lemmatization. Then, we employ the famous Word2Vec model to generate word embeddings of the extracted sequences in order to train the Type4Py model, which is described next.

Feature Extraction

We have two different environments for development and production as it is common in software development. In the development env., we test, debug, and profile Type4Py’s server-side components before releasing new features/fixes into the production code. Also, whenever we train a new Type4Py neural model, we test it against its evaluation metrics (see <a href="https://arxiv.org/abs/2101.04470" rel="noopener noreferrer" target="_blank">its paper </a>) and run integration tests to ensure that it produces expected predctions for given Python source files. Finally, the VSCode extension uses the development env. when testing new featues/fixes before releasing a new extension version.

Releasing

To extract type hints, we first extract Abstract Syntax Trees (ASTs) and perform light-weight static analysis using our <a href="https://github.com/saltudelft/libsa4py" rel="noopener noreferrer" target="_blank">LibSA4Py </a>package. NLP tasks are applied using NLTK. To train the Word2Vec model, we use the <a href="https://radimrehurek.com/gensim/" rel="noopener noreferrer" target="_blank">gensim </a>package.For the Type4Py model, we use bidirectional LSTMs in PyTorch to implement the two RNNs. To avoid overfitting, we apply the Dropout regularization to the input sequences. To minimize the value of the Triplet loss function, we employ the Adam optimizer. Also, to speed up the training process, we use the data parallelism feature of PyTorch. For fast KNN search, we use Annoy

Implementation

So far, I have described the current state of Type4Py. For future work, here is our roadmap: <ul><li>Enabling the type-checking process for the Type4Py’s predictions using <a dir="ltr" href="https://github.com/python/mypy">mypy </a>, preferably at the client-side. </li><li>Releasing a local version of the Type4Py model and its pipeline that can be queried on users’ machines. </li><li>Fine-tuning the (pre-trained) Type4Py model on users’ projects to learn project-specific types. </li><li>Releasing a plugin for JetBrains PyCharm and a GitHub action or bot for adding type annotations to Python projects </li> </ul>

Roadmap

For an ML model to learn and generalize, there is a need for a large and high-quality dataset. Therefore, we created the <a dir="ltr" href="https://zenodo.org/record/4719447">ManyTypes4Py </a>dataset which contains 5.2K Python projects and 4.2M type annotations. To avoid data leakage from the training set to the test set, we used our <a dir="ltr" href="https://github.com/saltudelft/CD4Py">CD4Py </a>tool to perform code de-duplication in the dataset. To know more about how we created the dataset, check out <a dir="ltr" href="https://arxiv.org/abs/2104.04706">its paper </a>.

Dataset

The basic idea is that two RNN captures different aspects of input sequences from both identifiers and code context. Next, the output of two RNNs is concatenated into a single vector, which is passed through a fully-connected linear layer. The final linear layer maps the learned type annotation into a high-dimensional feature space, called Type Clusters. In order to create Type Clusters, we need to formulate the type prediction task as a similarity learning problem, rather than a classification problem.

Model Architecture & Training

Dynamic programming languages like Python and TypeScript allows developers to optionally define type annotations and benefit from the advantages of static typing such as better code completion, early bug detection.However, retrofitting types is a cumbersome and error-prone process. To address this, we propose Type4Py , an ML-based type auto-completion for Python. It assists developers to gradually add type annotations to their codebases. In the following, I describe Type4Py’s pipeline, model, deployments, and the development of its VSCode extension and more.

Development and Release of Type4Py: Machine Learning-based Type Auto-completion for Python

To deploy the Type4Py model for the production environment, we convert the pre-trained PyTorch model to an <a href="https://www.onnxruntime.ai/" rel="noopener noreferrer" target="_blank">ONNX </a>model which allows us to query the model on both GPUs and CPUs with very fast inference speed and lower VRAM consumption. Thanks to Annoy, Type Clusters are memory-mapped into RAM from disk, which consumes less memory.To handle concurrent type prediction requests from users, we employ <a href="https://gunicorn.org/" rel="noopener noreferrer" target="_blank">Gunicorn </a>‘s HTTP server with Nginx as a proxy. This allows us to have quite a number of asynchronous workers that have an instance of Type4Py’s ONNX model plus Type Clusters each.

Deployment

The Type4Py’s VSCode extension is small and simple.Type slots are functions parameters, return types, and variables, which are located based on the line and column numbers. Currently, type prediction can be triggered via Command Pallete or by enabling the AutoInfer setting, which predicts types whenever a Python source file is opened or selected. Finally, the extension gathers telemetry data from users based on their consent. The Type4Py’s VSCode extension can be installed from the VS Marketplace <a href="https://marketplace.visualstudio.com/items?itemName=saltud.type4py" rel="noopener noreferrer" target="_blank">here </a>.

VSCode Extension

Before going into the detail of the Type4Py’s model and its implementation, it would be helpful to see the overview of Type4Py. In general, there is a VSCode extension at the client-side (developers) and the Type4Py model and its pipeline are deployed on our servers. Simply, the extension sends a Python file to the server and a JSON response containing type predictions for the given file is returned. In the following subsection, I describe each component.

Overview