Skip to content

Documentation#173

Merged
nim65s merged 22 commits into
humanoid-path-planner:develfrom
DiegoP-G:doc
Jul 24, 2026
Merged

Documentation#173
nim65s merged 22 commits into
humanoid-path-planner:develfrom
DiegoP-G:doc

Conversation

@DiegoP-G

Copy link
Copy Markdown
Contributor

Add documentation to all pyhpp modules and handle class documentation

Add a stub generation script that fixes .pyi files to include all
function signatures and docstrings.

Add a script that generates a Markdown API reference from the pyhpp
stubs, for use in the hpp-python mdBook.

DiegoP-G added 16 commits July 2, 2026 16:54
…dings

- core: document PathPlanner.maxIterations/timeOut, TrapezoidalTimeParameterization
  properties, ConfigProjector.lineSearchType/maxIterations/errorThreshold,
  Node.connectedComponent setter, SteeringMethod.constraints getter
- constraints: document DifferentiableFunction call/properties, Implicit.comparisonType
  getter/setter (const char* to avoid kwargs mismatch), ExplicitConstraintSet.errorSize,
  HierarchicalIterative and BySubstitution errorThreshold/maxIterations/rightHandSide*
- manipulation: document Problem.constraintGraph, TransitionPlanner.innerPlanner/
  checkFeasibilityOnly/nRandomConfig/nDiscreteSteps, Handle properties,
  EndEffectorTrajectorySteeringMethod, Cartesian steering method
- All getter/setter pairs with /// on both sides use const char* constants instead of
  DocClassMethod to avoid Boost.Python more_keywords_than_function_arguments static_assert
- Add doc/core_doc_todo.md, doc/constraints_doc_todo.md, doc/manipulation_doc_todo.md
  with full status tables for all binding files
…ndings

All ⚠️ and ❌ entries in core, constraints and manipulation that had
writable docstrings are now ✅. MD files reflect the current state.
…ttern

 Veuillez saisir le message de validation pour vos modifications. Les lignes
… collisions (path validation and path projector)
Comment thread doc/fix_stubs.py Outdated
Comment thread doc/gen_api_md.py Outdated
Comment on lines +4 to +8
Vs gen_api_md.py v1:
- Full Python type annotations with clickable type links, embedded directly in
the code display (HTML <pre> block) — no separate parameter table needed
- Per-method sub-headings (### / ####) for sidebar navigation
- Docstrings shown as blockquotes under each signature

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I can't see anything about v1. was it ever published ?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

They were only internal labels. I had several versions while trying different markdown themes, and I forgot to clean up the file.

Comment thread src/CMakeLists.txt
Comment thread README.md Outdated
Comment thread README.md Outdated
DiegoP-G and others added 6 commits July 21, 2026 18:51
Co-authored-by: Guilhem Saurel <guilhem.saurel@laas.fr>
Co-authored-by: Guilhem Saurel <guilhem.saurel@laas.fr>
…ries

pybind11-stubgen now writes to stubs_raw/, fix_stubs reads from there
and writes fixed stubs to stubs/ via --output-dir. CMake can now track
each step independently with BYPRODUCTS and install().
@nim65s
nim65s merged commit 382e764 into humanoid-path-planner:devel Jul 24, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants