langchain

mirror of https://github.com/hwchase17/langchain.git synced 2026-03-18 11:07:36 +00:00

Files

Aman Gupta 50c5bb5607 refactor(core): improve docstrings for HTML link extraction utilities (#34550 )

# refactor(core): improve docstrings for HTML link extraction utilities

## Description
This PR updates and clarifies the docstrings for `find_all_links` and
`extract_sub_links` in
`libs/core/langchain_core/utils/html.py`.

The previous return-value descriptions were vague (e.g., "all links",
"sub links"). They have now been revised to clearly describe the
behavior and output of each function:

- **find_all_links** → “A list of all links found in the HTML.”
- **extract_sub_links** → “A list of absolute paths to sub links.”

These improvements make the utilities more understandable and
developer-friendly without altering functionality.

## Verification
- `ruff check libs/core/langchain_core/utils/html.py`: **Passed**  
- `pytest libs/core/tests/unit_tests/utils/test_html.py`: **Passed**

## Checklists
- PR title follows the required format: `TYPE(SCOPE): DESCRIPTION`  
- Changes are limited to the `langchain-core` package  
- `make format`, `make lint`, and `make test` pass

2026-01-08 10:21:17 -05:00

__init__.py

style: more work for refs (#33508 )

2025-10-15 18:46:55 -04:00

_merge.py

test(core): add tests for formatting utils and merge functions (#34511 )

2026-01-05 14:20:11 -05:00

aiter.py

chore(core): fix some ruff preview rules (#34425 )

2025-12-19 14:33:42 -06:00

env.py

style(core): fix mypy no-any-return violations (#34204 )