langchain-ai/langchain

core: docstrings shouldn't inherit from parents

Open

#32 066 ouverte le 16 juil. 2025

Voir sur GitHub
 (3 commentaires) (0 réactions) (1 assigné)Python (136 758 stars) (22 617 forks)batch import
corehelp wantedinternalv1

Description

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

Guide contributeur

Stack technique
python
Domaine
documentation
Type d'issue
feature
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
3
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-2 days
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
clear
Prérequis
PythonPydanticlangchain core basics
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
50
Direction de recherche
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.