Data Classes vs typing.NamedTuple primary use cases Data Classes vs typing.NamedTuple primary use cases python python

Data Classes vs typing.NamedTuple primary use cases


It depends on your needs. Each of them has own benefits.

Here is a good explanation of Dataclasses on PyCon 2018 Raymond Hettinger - Dataclasses: The code generator to end all code generators

In Dataclass all implementation is written in Python, whereas in NamedTuple, all of these behaviors come for free because NamedTuple inherits from tuple. And because the tuple structure is written in C, standard methods are faster in NamedTuple (hash, comparing and etc).

Note also that Dataclass is based on dict whereas NamedTuple is based on tuple. Thus, you have advantages and disadvantages of using these structures. For example, space usage is less with a NamedTuple, but time access is faster with a Dataclass.

Please, see my experiment:

In [33]: a = PageDimensionsDC(width=10, height=10)In [34]: sys.getsizeof(a) + sys.getsizeof(vars(a))Out[34]: 168In [35]: %timeit a.width43.2 ns ± 1.05 ns per loop (mean ± std. dev. of 7 runs, 10000000 loops each)In [36]: a = PageDimensionsNT(width=10, height=10)In [37]: sys.getsizeof(a)Out[37]: 64In [38]: %timeit a.width63.6 ns ± 1.33 ns per loop (mean ± std. dev. of 7 runs, 10000000 loops each)

But with increasing the number of attributes of NamedTuple access time remains the same small, because for each attribute it creates a property with the name of the attribute. For example, for our case the part of the namespace of the new class will look like:

from operator import itemgetterclass_namespace = {...    'width': property(itemgetter(0, doc="Alias for field number 0")),    'height': property(itemgetter(0, doc="Alias for field number 1"))**}

In which cases namedtuple is still a better choice?

When your data structure needs to/can be immutable, hashable, iterable, unpackable, comparable then you can use NamedTuple. If you need something more complicated, for example, a possibility of inheritance for your data structure then use Dataclass.


In programming in general, anything that CAN be immutable SHOULD be immutable. We gain two things:

  1. Easier to read the program- we don't need to worry about values changing, once it's instantiated, it'll never change (namedtuple)
  2. Less chance for weird bugs

That's why, if the data is immutable, you should use a named tuple instead of a dataclass

I wrote it in the comment, but I'll mention it here:You're definitely right that there is an overlap, especially with frozen=True in dataclasses- but there are still features such as unpacking belonging to namedtuples, and it always being immutable- I doubt they'll remove namedtuples as such


I had this same question, so ran a few tests and documented them here:

https://shayallenhill.com/python-struct-options/

The gist is that namedtuple is better for unpacking, exploding, and size. Dataclass is faster and more flexible.

Namedtuple is also great for soft typing when you'd like to be able to pass a tuple instead. Define a type

class CircleArg(NamedTuple):    x: float    y: float    radius: float

Then unpack it inside your functions. Don't use the .attributes, and you'll have a nice "type hint" without any PITA for the caller.

*focus, radius = circle_arg_instance (or tuple)

The differences aren't tremendous, and I wouldn't refactor stable code to move from one to another.