10.1 Python interoperability

Not only does Mojo use a Pythonic syntax, our plan is to provide full compatibility with the Python ecosystem. There are two types of compatibility (or interoperability) that we support:

• Calling Python from Mojo:

  You can import existing Python modules and use them in a Mojo program. This is 100% compatible because we use the CPython runtime without modification for full compatibility with existing Python libraries. You can construct Python objects and call Python functions directly from Mojo, using the CPython interpreter as a dynamic library (shown as libpython.dylib in figure 1).

• Calling Mojo from Python:

  You can extend your Python code with high-performance Mojo code (or incrementally migrate Python code to Mojo). Because Mojo is a compiled language, we can't directly "evaluate" Mojo code from Python. Instead, you must declare which Mojo functions and types are available to be called from Python (declare the "bindings"), and then you can import them in your Python code (shown as mojo_module in figure 1) just like any other module—there's no extra compilation step.

By embracing both directions of language interoperability, you can choose how to use Mojo with Python in a way that works best for your use case.

To learn more about bridging Python ↔ Mojo, continue reading:

• Calling Python from Mojo — How to import Python modules and use them in Mojo code
• Calling Mojo from Python — How to import Mojo modules and use them in Python code

Adapted from the Mojo Manual, part of the Modular Platform repository (github.com/modular/modular), Copyright (c) Modular Inc., licensed under the Apache License v2.0 with LLVM Exceptions. Changes were made: reformatted as an accessible XYZ web edition with build-verified example outputs. Mojo is a trademark of Modular Inc.; this edition is not affiliated with or endorsed by Modular. License: Apache-2.0 WITH LLVM-exception.