Your Friendly Guide to Type Checking in Python

Written by - Deepak Prasad

Introduction to Type Checking in Python

Python is renowned for being a dynamically typed language. This means that the type of a variable is determined at runtime, not in advance. Unlike statically typed languages like Java or C++, where you declare the type of a variable upfront, Python variables can hold data of any type, and this type can change over the life of the variable.

Explanation of Dynamic Typing in Python and its Implications

Let's consider an example to understand dynamic typing:

x = 10  # Initially, x is an integer
print(type(x))  # Output: <class 'int'>

x = "Hello, World!"  # Now, x is a string
print(type(x))  # Output: <class 'str'>

In this example, x initially holds an integer value, but later it holds a string. Python allows this flexibility without any explicit type declaration.


Overview of Python Data Types

Python offers a variety of basic data types that are used to define the kind of value that variables can hold. Here's an overview of these data types in a tabular format:

Data Type Description Example Mutable
int Integer type; whole numbers without a decimal x = 5 No
float Floating point number; numbers with a decimal y = 3.14 No
str String; sequence of Unicode characters name = "Alice" No
bool Boolean; represents True or False is_valid = True No
list Ordered, mutable sequence of elements nums = [1, 2, 3] Yes
tuple Ordered, immutable sequence of elements coords = (0, 0) No
dict Collection of key-value pairs person = {"name": "Alice", "age": 25} Yes
set Unordered collection of unique elements items = {1, 2, 3} Yes


Using the type() Function in Python

The type() function in Python is a built-in utility that plays a crucial role in understanding and managing the dynamic nature of Python's type system. It allows developers to determine the type of an object at runtime, thereby offering insights into how variables are being handled in the code.

The primary purpose of the type() function is to return the type of the specified object. This functionality is particularly useful in a dynamically typed language like Python, where the type of a variable can change over its lifespan.

Syntax and Basic Usage Examples

The basic syntax of the type() function is straightforward:


Here, object is the variable or value whose type you want to determine. For example:

x = 123
print(type(x))  # Output: <class 'int'>

y = "Hello"
print(type(y))  # Output: <class 'str'>

Practical Examples with Different Data Types

Let's see how type() can be used with various data types like lists, strings, tuples, and dictionaries:

# For a list
my_list = [1, 2, 3]
print(type(my_list))  # Output: <class 'list'>

# For a string
my_string = "Python"
print(type(my_string))  # Output: <class 'str'>

# For a tuple
my_tuple = (1, 2, 3)
print(type(my_tuple))  # Output: <class 'tuple'>

# For a dictionary
my_dict = {"name": "John", "age": 30}
print(type(my_dict))  # Output: <class 'dict'>

Checking if a Variable is of a Specific Type Using type()

You can use the type() function to check if a variable is of a specific type. This is done by comparing the output of type() with a type object. For example:

x = [1, 2, 3]

# Check if 'x' is a list
if type(x) is list:
    print("x is a list")
    print("x is not a list")

In this example, type(x) returns <class 'list'>, and the conditional check verifies whether x is indeed a list.


Using the isinstance() Function in Python

Python's isinstance() function is an integral tool for type checking, offering a more nuanced approach compared to the type() function. It checks if an object is an instance of a particular class or a tuple of classes.

Explanation of isinstance() and How It Differs from type()

While type() is used to get the exact type of an object, isinstance() checks for class inheritance, making it more versatile and suitable for object-oriented scenarios. The key differences are:

  • Inheritance Awareness: isinstance() considers the inheritance hierarchy, meaning it will return True if the object is an instance of a subclass of the specified class.
  • Flexibility with Tuples: It allows checking against a tuple of types, providing greater flexibility.
  • Use Case: isinstance() is preferable when you need to ensure that an object adheres to a certain interface or hierarchy, rather than being of a specific type.

Syntax and Usage Examples

The syntax of isinstance() is:

isinstance(object, classinfo)

Where object is the object to be checked, and classinfo is a class, type, or a tuple of classes and types. Examples include:

x = 10
print(isinstance(x, int))  # Output: True

y = "Hello"
print(isinstance(y, str))  # Output: True

z = [1, 2, 3]
print(isinstance(z, (list, tuple)))  # Output: True

Practical Scenarios Where isinstance() Is Preferable over type()

Working with Inheritance: In object-oriented programming, where inheritance is common, isinstance() can check an object’s compatibility with a parent class.

class Vehicle:

class Car(Vehicle):

my_car = Car()
print(isinstance(my_car, Vehicle))  # Output: True

Type Checking in Functions: When writing functions that can accept multiple types, isinstance() allows for more flexible type checking.

def process(data):
    if isinstance(data, (list, tuple)):
        # Handle list or tuple data

Implementing Polymorphism: In situations requiring polymorphic behavior, isinstance() can be used to invoke specific methods based on the object’s class.

class Animal:
    def make_sound(self):

class Dog(Animal):
    def make_sound(self):
        return "Bark!"

def animal_sound(animal):
    if isinstance(animal, Animal):

my_dog = Dog()
animal_sound(my_dog)  # Output: Bark!


Type Hinting and Static Type Checking in Python

Type hints are a formal solution to statically indicate the type of a variable. Unlike traditional type checking done at runtime, type hints allow the developer to explicitly annotate the expected type of variables, function arguments, and return values. These annotations are not enforced at runtime, but they can be used by third-party tools and IDEs for static analysis.

Basic Examples of Type Hinting in Functions and Variables

Here's how type hints can be used in Python:

Type Hints in Variables:

age: int = 25
name: str = "Alice"

Type Hints in Functions:

For function arguments:

def greet(name: str) -> None:
    print(f"Hello, {name}")

For the return type:

def add(x: int, y: int) -> int:
    return x + y

These examples show how type hints make the function's purpose and requirements more explicit.

Overview of the mypy Tool for Static Type Checking and Its Usage

mypy is a popular static type checker for Python that leverages type hints. It reads the type annotations and checks the code for type errors, providing feedback before the code is run. This can significantly reduce runtime errors related to type issues.

Installing mypy: You can install mypy using pip:

pip install mypy

Using mypy: To use mypy, run it against a Python script:


mypy will analyze the script and report any type inconsistencies or errors based on the provided type hints.


Advanced Topics in Type Checking in Python

Delving into advanced aspects of type checking in Python not only enhances code quality but also aligns with best practices in software development. These advanced topics provide deeper insights and broader applications of type checking in Python.


1. Type Annotations vs Type Comments

Type Annotations:

  • Definition: Introduced in Python 3.5, type annotations are a syntax for adding type hints directly in Python code.
  • Usage: They are used before variable assignments and with function definitions.
def add(x: int, y: int) -> int:
    return x + y

Type Comments:

  • Definition: For versions prior to Python 3.5 or for stylistic reasons, type comments can be used to specify types.
  • Usage: Placed at the end of the line, conveying the same information as annotations.
def add(x, y):
    # type: (int, int) -> int
    return x + y


2. Using Type Aliases for Readability and Maintainability

Definition: Type aliases are custom names given to types, enhancing readability and simplifying complex type definitions.

Vector = List[float]
def scale(vector: Vector, factor: float) -> Vector:
    return [x * factor for x in vector]


3. Understanding and Using the 'Any' Type

  • The 'Any' Type: Represents any type and is the most flexible type in type hinting.
  • Usage: Useful in scenarios where the type of a variable is unknown or can be of several types.
from typing import Any
def parse(data: Any) -> None:
    # Implementation here


4. Subtypes, Covariance, Contravariance, and Invariance

  • Subtypes: These are types that are derived from a base type, maintaining a "is-a" relationship.
  • Covariance and Contravariance: Refer to how subtypes relate to their base types, especially in generic types.
    • Covariant: Preserving the ordering of types (e.g., List[Cat] is a subtype of List[Animal] if Cat is a subtype of Animal).
    • Contravariant: Reversing this ordering.
  • Invariance: Neither covariant nor contravariant; the types must match exactly.


5. Implementing and Using Duck Types and Protocols

  • Duck Typing: A style where an object's suitability is determined by the presence of certain methods and properties, rather than the actual type.
  • Protocols: Introduced in Python 3.8, allowing for formal duck typing.
from typing import Protocol
class Flyer(Protocol):
    def fly(self) -> None:

def take_off(entity: Flyer) -> None:


6. The Role of Classes as Types and Handling *args and **kwargs in Type Hinting

  • Classes as Types: Classes can be used as types in type hints, indicating that an argument should be an instance of that class.
  • Handling *args and **kwargs: Type hints can be applied to *args and **kwargs to specify the expected types of variable arguments.
def concat(*args: str, sep: str = " ") -> str:
    return sep.join(args)


Practical Examples on Python Type Checking

Understanding the application of type checking in practical scenarios is crucial for Python developers. It not only helps in writing bug-free code but also enhances the overall code quality. Here, we explore how type checking can be effectively used with common data structures and in real-world scenarios.

1. Sequences (e.g., Lists and Tuples):

  • Example: A function that calculates the average of a list of numbers.
  • Type Checking: Ensuring the input is a list of numbers.
from typing import List

def average(numbers: List[float]) -> float:
    return sum(numbers) / len(numbers)

# Type checking prevents passing a non-list or list of non-floats.

2. Mappings (e.g., Dictionaries):

  • Example: A function that processes user data stored in a dictionary.
  • Type Checking: Verifying that the input dictionary has specific key-value pairs.
from typing import Dict

def process_user_data(user_data: Dict[str, str]) -> None:
    # Assuming user_data should have 'name' and 'age' keys
    name = user_data['name']
    age = user_data['age']
    # Further processing...

# Type hints aid in understanding the expected structure of user_data.

3. Functions (Function Arguments and Return Types):

  • Example: A higher-order function that takes another function as an argument.
  • Type Checking: Ensuring the argument function has the correct signature.
from typing import Callable

def execute_function(func: Callable[[int], str], value: int) -> str:
    return func(value)

# This ensures that func is a function that takes an int and returns a string.


Frequently Asked Questions on Python Type Checking

What is type checking and why is it important in Python?

Type checking in Python involves verifying the type of an object at runtime or statically annotating types to ensure code correctness. It's important because Python is dynamically typed, meaning variables can hold values of any type, and this can lead to runtime errors if not managed properly. Type checking enhances code readability, makes debugging easier, and helps catch errors early in the development process.

How do I use the type() function in Python?

The type() function is used to determine the type of a given object. For instance, type(123) returns <class 'int'>, indicating that the object is an integer. You can use it to check the type of variables, objects, or values within your code.

What are the differences between type() and isinstance()?

type() returns the exact type of an object, whereas isinstance() checks if an object is an instance of a specified class or a subclass thereof. For example, isinstance("hello", str) returns True because "hello" is an instance of the str class. isinstance() is generally preferable for type checking due to its support for class inheritance and polymorphism.

How do type hints improve Python code?

Type hints, introduced in Python 3.5, are annotations that specify the expected data types of function arguments, return values, and variables. They don't affect runtime behavior but are useful for static analysis. Type hints improve code readability, make the code self-documenting, and assist in catching type-related errors during development, especially when used with tools like mypy.

Can you provide an example of using type hints in a function?

Sure. In a function definition, you can annotate the types of arguments and the return type. For example, a function def add(x: int, y: int) -> int: indicates that both x and y should be integers, and the function returns an integer.

What is mypy and how is it used in Python?

mypy is a static type checker for Python. It uses type hints to analyze your code for type consistency before it's run. To use mypy, first install it using pip install mypy, then run mypy on your Python script. It will report any type inconsistencies found based on the provided type hints.

What are type aliases in Python, and when should they be used?

Type aliases are custom names assigned to types. They are used to simplify complex type definitions and enhance code readability. For example, you can define Vector = List[float] as a type alias, and then use Vector in your code instead of List[float], making the code more readable.

What is the significance of the 'Any' type in Python type hints?

The Any type is a special type that can represent any type in Python. It's used in type hints when the exact type is unknown or can be varied. While it offers flexibility, using Any can also reduce the benefits of type checking, as it bypasses most type constraints.

How do subtypes and polymorphism relate to type checking in Python?

Subtypes and polymorphism are concepts from object-oriented programming. In type checking, they are important for understanding how types relate in a hierarchy. Python's isinstance() function, which respects inheritance, helps in implementing polymorphic behavior, allowing functions to work with objects of different classes that share the same

What is duck typing and how does it relate to type checking?

Duck typing is a concept in Python where the type or class of an object is less important than the methods and attributes it possesses. It relates to type checking in the sense that it focuses on the suitability of an object's behavior (what it can do) rather than its type. This concept is often summarized by the phrase, "If it walks like a duck and quacks like a duck, then it is a duck."


Conclusion: When to Use type() vs isinstance()

  • Use type() when you need to know the exact type of an object, without considering inheritance. It's straightforward and suitable for debugging or simple type checking.
  • Use isinstance() when working with class hierarchies, as it checks for an object's compatibility with a class or a tuple of classes. It is the preferred method in object-oriented programming and when implementing polymorphism.

Official Documentation Links

These best practices and resources can help you effectively implement type checking in your Python projects, leading to more robust and maintainable code.


Deepak Prasad

He is the founder of GoLinuxCloud and brings over a decade of expertise in Linux, Python, Go, Laravel, DevOps, Kubernetes, Git, Shell scripting, OpenShift, AWS, Networking, and Security. With extensive experience, he excels in various domains, from development to DevOps, Networking, and Security, ensuring robust and efficient solutions for diverse projects. You can reach out to him on his LinkedIn profile or join on Facebook page.

Can't find what you're searching for? Let us assist you.

Enter your query below, and we'll provide instant results tailored to your needs.

If my articles on GoLinuxCloud has helped you, kindly consider buying me a coffee as a token of appreciation.

Buy GoLinuxCloud a Coffee

For any other feedbacks or questions you can send mail to

Thank You for your support!!

Leave a Comment