Troubleshooting Python Package Installation Errors

Python Installation Errors — Designed using Canva Team

Introduction:
Installing Python packages is a common task for developers, but sometimes it can be accompanied by unexpected errors. In this article, we’ll explore two common errors encountered during the installation of the ‘diagrams’ package in Python and provide step-by-step solutions to resolve them.

Error Details:
Error 1: Building Wheel for Typed-ast

• When attempting to install the ‘diagrams’ package using pip, users may encounter an error related to building the wheel for the ‘typed-ast’ dependency.
• The error message typically indicates a requirement for Microsoft Visual C++ 14.0 or greater, directing users to install the Microsoft C++ Build Tools.

Error 2: ExecutableNotFound for Graphviz

• After successfully installing the ‘diagrams’ package, users may encounter an ‘ExecutableNotFound’ exception related to Graphviz executables, particularly ‘dot’.
• This error occurs when the Graphviz executables are not added to the system’s PATH environment variable.

Solution:
Error 1: Building Wheel for Typed-ast

• Ensure that Microsoft Visual C++ 14.0 or greater is installed by selecting the appropriate workload (Desktop development with C++) during Visual Studio installation.
• After installation, close existing terminals and open a new one before retrying the 'pip install diagrams' command.

Error 2: ExecutableNotFound for Graphviz
Locate the Graphviz installation folder (e.g., C:\Program Files\Graphviz).

• Add Graphviz to the PATH environment variable:
• Right-click on “This PC” or “My Computer” → Properties → Advanced system settings → Environment Variables.
• Under System Variables, find the “Path” variable, and click “Edit”.
• Add the path to the Graphviz bin directory (e.g., C:\Program Files\Graphviz\bin).
• Click “OK” on all windows to save changes.
• Verify the installation by opening a new command prompt and typing ‘dot -V’.

By following these step-by-step solutions, you can overcome common installation errors encountered while working with Python packages like ‘diagrams’. Ensuring the availability of necessary dependencies and configuring system settings appropriately enhances the development experience. For more troubleshooting tips and Python-related content, stay tuned to our blog!