langchain-ai/langchain

core: docstrings shouldn't inherit from parents

Open

#32.066 geöffnet am 16. Juli 2025

Auf GitHub ansehen
 (3 Kommentare) (0 Reaktionen) (1 zugewiesene Person)Python (136.758 Stars) (22.617 Forks)batch import
corehelp wantedinternalv1

Beschreibung

from langchain_core.tools import tool
from pydantic import BaseModel


class MyTool(BaseModel):
    """Parent Tool"""
    foo: str

@tool
class ChildTool(MyTool):
    bar: str

For 0.4 release we could consider updating the behavior so that doc-strings are not inherited from their parents. It's fairly odd that doc-strings are inherited for BaseModels as in general the descriptions need to be different

Originally posted by @eyurtsev in #31606

Contributor Guide

Tech Stack
python
Domain
documentation
Issue Type
feature
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
3
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-2 days
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
active
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
clear
Voraussetzungen
PythonPydanticlangchain core basics
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
50
Research-Richtung
The issue requests that the @tool decorator should not inherit docstrings from parent Pydantic models. Examine the current implementation in langchain core/tools/base.py, specifically how the decorator handles doc attributes. Refer to the original discussion in issue #31606 for context. Discuss with the assignee any design decisions and then implement a change that prevents docstring inheritance, ensuring compatibility with the upcoming 0.4 release.