π Dataclasses
A dataclass is a special type of class used mainly for storing data.
It automatically generates common methods like __init__(), __repr__(), and __eq__() for us.
πΉ Without Dataclass
Normally, we would write:
class Student:
def __init__(self, name, age):
self.name = name
self.age = age
student = Student("Codeveda", 23)
print(student.name)β¨ Using @dataclass
from dataclasses import dataclass
@dataclass
class Student:
name: str
age: int
student = Student("Alice", 23)
print(student) #Student(name='Alice', age=23)Python automatically creates the __init__() and __repr__() methods.
π·οΈ Default Values
You can provide default values:
from dataclasses import dataclass
@dataclass
class Student:
name: str
age: int = 18
student = Student("Alice")
print(student) #Student(name='Alice', age=18)β Why Use Dataclasses?
They are useful when a class mainly holds data.

<div class="infographic-pydataclass">
<style>
.infographic-pydataclass {
--ink: #1a1a1a;
--ink-soft: #5c5c5c;
--paper: #ffffff;
--paper-alt: #f0ece4;
--accent: #2563eb;
--accent-soft:#e3ebfd;
--line: #ddd6c9;
--err: #c0392b; --err-soft: #fbe9e7;
--ok: #1f9d55; --ok-soft: #e3f5ec;
--mono-font: 'IBM Plex Mono', 'SFMono-Regular', Menlo, monospace;
--display-font: 'Fraunces', Georgia, serif;
--body-font: 'Inter', system-ui, sans-serif;
box-sizing: border-box;
max-width: 740px;
margin: 0 auto;
font-family: var(--body-font);
color: var(--ink);
background: var(--paper);
}
.infographic-pydataclass[data-theme="dark"] {
--ink: #e8e6e1;
--ink-soft: #9a968c;
--paper: #121212;
--paper-alt: #1e1e26;
--accent: #5b8def;
--accent-soft:#202942;
--line: #2c313d;
--err: #e57373; --err-soft: #3a2222;
--ok: #6fdc8c; --ok-soft: #16342a;
}
.infographic-pydataclass *, .infographic-pydataclass *::before, .infographic-pydataclass *::after { box-sizing: border-box; }
.infographic-pydataclass .dc-wrap { padding: 0 clamp(1rem, 4vw, 2rem) 1.5rem; }
.infographic-pydataclass h1 {
font-family: var(--display-font); font-weight: 600;
font-size: clamp(1.4rem, 5vw, 1.9rem); text-align: center; margin: 1.5rem 0 0.25rem; letter-spacing: -0.01em;
}
.infographic-pydataclass .dc-sub { text-align: center; color: var(--ink-soft); font-size: 0.85rem; margin: 0 0 1.3rem; }
.infographic-pydataclass .dc-tabs { display: flex; justify-content: center; gap: 0.35rem; margin-bottom: 1.4rem; border-bottom: 1px solid var(--line); flex-wrap: wrap; }
.infographic-pydataclass .dc-tab-btn {
font: inherit; font-family: var(--mono-font); font-size: 0.78rem; font-weight: 700;
background: none; border: none; border-bottom: 2.5px solid transparent; color: var(--ink-soft);
padding: 0.55rem 0.75rem; cursor: pointer; margin-bottom: -1px;
}
.infographic-pydataclass .dc-tab-btn.is-active { color: var(--accent); border-bottom-color: var(--accent); }
.infographic-pydataclass .dc-panel.is-hidden-tab { display: none; }
.infographic-pydataclass .code-cols { display: grid; grid-template-columns: 1fr 1fr; gap: 0.7rem; margin-bottom: 1.1rem; }
@media (max-width: 560px) { .infographic-pydataclass .code-cols { grid-template-columns: 1fr; } }
.infographic-pydataclass .code-block {
font-family: var(--mono-font); font-size: 0.7rem; line-height: 1.6; white-space: pre;
background: var(--paper-alt); border: 1px solid var(--line); border-radius: 8px;
padding: 0.7rem 0.75rem; margin-bottom: 1.1rem;
}
.infographic-pydataclass .code-cols .code-block { margin-bottom: 0; }
.infographic-pydataclass .code-block .kw { color: var(--accent); font-weight: 700; }
.infographic-pydataclass .code-block .deco { color: var(--ok); font-weight: 700; }
.infographic-pydataclass .col-label { text-align: center; font-family: var(--mono-font); font-size: 0.7rem; font-weight: 700; color: var(--ink-soft); margin-bottom: 0.4rem; }
.infographic-pydataclass .row { display: flex; justify-content: center; gap: 0.5rem; margin-bottom: 0.8rem; flex-wrap: wrap; align-items: center; }
.infographic-pydataclass .row input {
font-family: var(--mono-font); font-size: 0.82rem; padding: 0.4rem 0.55rem;
border: 1.5px solid var(--line); border-radius: 5px; background: var(--paper-alt); color: var(--ink); width: 70px;
text-align: center;
}
.infographic-pydataclass .row input:focus { outline: none; border-color: var(--accent); }
.infographic-pydataclass .row span { font-family: var(--mono-font); font-size: 0.78rem; color: var(--ink-soft); }
.infographic-pydataclass .btn {
font: inherit; font-family: var(--mono-font); font-size: 0.78rem; font-weight: 700;
background: var(--accent); color: #fff; border: none; border-radius: 999px;
padding: 0.42rem 0.85rem; cursor: pointer; min-width: 190px;
}
.infographic-pydataclass .toggle-btn {
font: inherit; font-family: var(--mono-font); font-size: 0.8rem; font-weight: 700;
background: var(--paper-alt); border: 1.5px solid var(--line); color: var(--ink-soft);
padding: 0.4rem 0.75rem; cursor: pointer; border-radius: 6px;
}
.infographic-pydataclass .toggle-btn.is-selected { border-color: var(--accent); color: var(--accent); background: var(--accent-soft); }
.infographic-pydataclass .try-row { display: flex; justify-content: center; gap: 0.4rem; margin-bottom: 1rem; flex-wrap: wrap; }
.infographic-pydataclass .try-btn {
font: inherit; font-family: var(--mono-font); font-size: 0.78rem; font-weight: 700;
background: var(--paper-alt); border: 1.5px solid var(--line); color: var(--ink);
padding: 0.4rem 0.7rem; cursor: pointer; border-radius: 6px;
}
.infographic-pydataclass .device {
--ed-bg: #1e1e1e; --ed-bar: #2d2d2d; --ed-text: #d4d4d4; --ed-soft: #8a8a8a; --ed-ok: #6fdc8c; --ed-err: #ff6b6b;
background: var(--ed-bg); border: 1px solid var(--line); border-radius: 8px; overflow: hidden;
}
.infographic-pydataclass .device-bar {
display: flex; align-items: center; gap: 0.4rem;
background: var(--ed-bar); padding: 0.5rem 0.7rem; border-bottom: 1px solid #3a3a3a;
font-size: 0.72rem; color: var(--ed-soft); font-weight: 600;
}
.infographic-pydataclass .device-bar .dot { width: 9px; height: 9px; border-radius: 50%; background: #5a5a5a; }
.infographic-pydataclass .device-bar .dot:nth-child(1) { background: #ff5f56; }
.infographic-pydataclass .device-body { padding: 0.75rem 0.9rem; font-family: var(--mono-font); font-size: 0.78rem; color: var(--ed-text); min-height: 60px; max-height: 190px; overflow-y: auto; }
.infographic-pydataclass .log-line { display: flex; gap: 0.5rem; line-height: 1.7; opacity: 0; animation: dc-fadein 0.25s ease forwards; flex-wrap: wrap; }
@keyframes dc-fadein { from { opacity: 0; transform: translateY(3px); } to { opacity: 1; transform: translateY(0); } }
.infographic-pydataclass .log-line .p { color: var(--ed-ok); font-weight: 700; }
.infographic-pydataclass .log-line.err .out { color: var(--ed-err); font-weight: 700; }
.infographic-pydataclass .log-line.ok .out { color: var(--ed-ok); font-weight: 700; }
.infographic-pydataclass .log-line .out { color: #fff; }
.infographic-pydataclass .log-empty { color: var(--ed-soft); }
.infographic-pydataclass .dc-caption { text-align: center; font-size: 0.85rem; color: var(--ink-soft); margin-top: 0.9rem; }
@media (prefers-reduced-motion: reduce) {
.infographic-pydataclass *, .infographic-pydataclass *::before, .infographic-pydataclass *::after {
animation-duration: 0.001ms !important; transition-duration: 0.001ms !important;
}
}
</style>
<div class="dc-wrap">
<div class="dc-tabs">
<button class="dc-tab-btn is-active" data-tab="compare">The Boilerplate It Saves</button>
<button class="dc-tab-btn" data-tab="frozen">frozen=True</button>
</div>
<!-- COMPARE -->
<div class="dc-panel" id="tabCompare">
<div class="code-cols">
<div>
<div class="col-label">without @dataclass</div>
<div class="code-block"><span class="kw">class</span> Point:
<span class="kw">def</span> __init__(self, x, y):
self.x = x
self.y = y
<span class="kw">def</span> __repr__(self):
<span class="kw">return</span> f"Point(x={self.x}, y={self.y})"
<span class="kw">def</span> __eq__(self, other):
<span class="kw">return</span> (self.x, self.y) == (other.x, other.y)</div>
</div>
<div>
<div class="col-label">with @dataclass</div>
<div class="code-block"><span class="kw">from</span> dataclasses <span class="kw">import</span> dataclass
<span class="deco">@dataclass</span>
<span class="kw">class</span> Point:
x: int
y: int</div>
</div>
</div>
<div class="row">
<span>p1 = Point(</span><input id="p1x" type="text" value="3" /><span>,</span><input id="p1y" type="text" value="4" /><span>)</span>
</div>
<div class="row">
<span>p2 = Point(</span><input id="p2x" type="text" value="3" /><span>,</span><input id="p2y" type="text" value="4" /><span>)</span>
</div>
<div class="try-row">
<button class="try-btn" id="printBtn">print(p1)</button>
<button class="try-btn" id="eqBtn">p1 == p2</button>
</div>
<div class="device">
<div class="device-bar"><span class="dot"></span><span class="dot"></span><span class="dot"></span> Terminal</div>
<div class="device-body" id="compareLog"><div class="log-empty">Set p1 and p2, then try printing or comparing them.</div></div>
</div>
<p class="dc-caption">Both versions behave identically β @dataclass just wrote the second column's methods for you.</p>
</div>
<!-- FROZEN -->
<div class="dc-panel is-hidden-tab" id="tabFrozen">
<div class="code-block" id="frozenCode"><span class="deco">@dataclass</span>
<span class="kw">class</span> Point:
x: int
y: int</div>
<div class="row">
<button class="toggle-btn is-selected" data-frozen="false">frozen=False (default)</button>
<button class="toggle-btn" data-frozen="true">frozen=True</button>
</div>
<div class="row">
<span>p = Point(</span><input id="fx" type="text" value="3" /><span>,</span><input id="fy" type="text" value="4" /><span>)</span>
</div>
<div class="try-row">
<button class="btn" id="mutateBtn">Run: p.x = 99</button>
</div>
<div class="device">
<div class="device-bar"><span class="dot"></span><span class="dot"></span><span class="dot"></span> Terminal</div>
<div class="device-body" id="frozenLog"><div class="log-empty">Pick a mode, then try mutating p.x.</div></div>
</div>
<p class="dc-caption">frozen=True makes every field read-only after creation β like a namedtuple, but with type hints.</p>
</div>
</div>
<script>
(function () {
var root = document.currentScript.closest('.infographic-pydataclass')
|| document.querySelector('.infographic-pydataclass');
var bodyAttr = document.body.getAttribute('data-darkmode');
var dark;
if (bodyAttr === 'true') { dark = true; }
else if (bodyAttr === 'false') { dark = false; }
else {
var match = document.cookie.match(/(?:^|;\s*)darkMode=([^;]+)/);
dark = match ? match[1] === 'true' : false;
}
if (dark) root.setAttribute('data-theme', 'dark');
/* ---------------- tabs ---------------- */
var tabBtns = root.querySelectorAll('.dc-tab-btn');
var panels = { compare: root.querySelector('#tabCompare'), frozen: root.querySelector('#tabFrozen') };
tabBtns.forEach(function (btn) {
btn.addEventListener('click', function () {
tabBtns.forEach(function (b) { b.classList.toggle('is-active', b === btn); });
var target = btn.dataset.tab;
Object.keys(panels).forEach(function (key) {
panels[key].classList.toggle('is-hidden-tab', key !== target);
});
});
});
/* ---------------- COMPARE ---------------- */
var p1x = root.querySelector('#p1x'), p1y = root.querySelector('#p1y');
var p2x = root.querySelector('#p2x'), p2y = root.querySelector('#p2y');
var printBtn = root.querySelector('#printBtn');
var eqBtn = root.querySelector('#eqBtn');
var compareLog = root.querySelector('#compareLog');
var firstCompareLog = true;
function logCompare(text, cls) {
if (firstCompareLog) { compareLog.innerHTML = ''; firstCompareLog = false; }
var line = document.createElement('div');
line.className = 'log-line' + (cls ? ' ' + cls : '');
line.innerHTML = '<span class="p">>>></span><span class="out">' + text + '</span>';
compareLog.appendChild(line);
compareLog.scrollTop = compareLog.scrollHeight;
}
printBtn.addEventListener('click', function () {
logCompare('print(p1)');
logCompare('Point(x=' + p1x.value + ', y=' + p1y.value + ')', 'ok');
});
eqBtn.addEventListener('click', function () {
var eq = p1x.value === p2x.value && p1y.value === p2y.value;
logCompare('p1 == p2');
logCompare('β ' + (eq ? 'True' : 'False'), eq ? 'ok' : 'err');
});
/* ---------------- FROZEN ---------------- */
var frozenToggles = root.querySelectorAll('#tabFrozen .toggle-btn');
var frozenCode = root.querySelector('#frozenCode');
var fx = root.querySelector('#fx'), fy = root.querySelector('#fy');
var mutateBtn = root.querySelector('#mutateBtn');
var frozenLog = root.querySelector('#frozenLog');
var firstFrozenLog = true;
var isFrozen = false;
function logFrozen(text, cls) {
if (firstFrozenLog) { frozenLog.innerHTML = ''; firstFrozenLog = false; }
var line = document.createElement('div');
line.className = 'log-line' + (cls ? ' ' + cls : '');
line.innerHTML = '<span class="p">>>></span><span class="out">' + text + '</span>';
frozenLog.appendChild(line);
frozenLog.scrollTop = frozenLog.scrollHeight;
}
frozenToggles.forEach(function (btn) {
btn.addEventListener('click', function () {
frozenToggles.forEach(function (b) { b.classList.toggle('is-selected', b === btn); });
isFrozen = btn.dataset.frozen === 'true';
frozenCode.innerHTML = isFrozen
? '<span class="deco">@dataclass(frozen=True)</span>\n<span class="kw">class</span> Point:\n x: int\n y: int'
: '<span class="deco">@dataclass</span>\n<span class="kw">class</span> Point:\n x: int\n y: int';
});
});
mutateBtn.addEventListener('click', function () {
logFrozen('p.x = 99');
if (isFrozen) {
logFrozen('β dataclasses.FrozenInstanceError: cannot assign to field \'x\'', 'err');
} else {
fx.value = 99;
logFrozen('β p is now Point(x=99, y=' + fy.value + ')', 'ok');
}
});
})();
</script>
</div>π§ Remember
Dataclass = A convenient way to create classes that mainly store data.
@dataclass
class Student:
name: str
age: intPython handles much of the repetitive class code for you.