langchain-ai/langchain

core: docstrings shouldn't inherit from parents

Open

#32.066 aberto em 16 de jul. de 2025

Ver no GitHub
 (3 comments) (0 reactions) (1 assignee)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

Guia do colaborador

Pilha de tecnologia
python
Domain
documentation
Tipo Issue
feature
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-2 days
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
active
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
clear
Prerequisites
PythonPydanticlangchain core basics
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
50
Direção de pesquisa
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.