Skip to content

Auto class diagrams in the drunc docs#897

Draft
emmuhamm wants to merge 5 commits intodevelopfrom
emmuhamm/auto-class-uml
Draft

Auto class diagrams in the drunc docs#897
emmuhamm wants to merge 5 commits intodevelopfrom
emmuhamm/auto-class-uml

Conversation

@emmuhamm
Copy link
Copy Markdown
Contributor

@emmuhamm emmuhamm commented Apr 29, 2026

Description

Fixes issue #663

Add auto class diagram construction and expose to the public.

DUNE-DAQ/daqpytools#66 needs to have been merged before this can go in

The above merge request adds in the nice feature of daqpytools-generate-uml, which allows us to generate any uml diagram for any python repository !

This one implements this in drunc. This generates a whole lot of files, but we also want to expose this. Because of this, its not a good idea to have a github action that saves the pngs in the repository itself.

What can work, however, is by injecting this into the mkdocs website!

This PR adds the ability to have galleries in the MKDocs page, as well as use the daqpytools cli tool to generate the required images.

The name of the 'gallery' will still have to be decided though

Type of change

  • Documentation

List of required branches from other repositories

DUNE-DAQ/daqpytools#66

Suggested manual testing checklist

Read the website

Developer checklist

Prior to marking this as "Ready for Review"

Tests ran on: WHAT HOSTNAME from release RELEASE_NAME

Unit tests - some tests can't be ran on the CI. This is documented. If this PR checks a feature that can't be tested with CI, this has been marked appropriately.

Integration tests - the daqsystemtest_integtest_bundle requires a lot of resources, and connections to the EHN1 infrastructure. Check the cross referenced list if you can't run these. The developer needs to run at least the .

  • Unit tests (pytest --marker) passed
    • With relevant marker
    • Without marker
  • Integration tests passed
    • Only daqsystemtest_integtest_bundle.sh -k minimal_system_quick_test.py
    • Full daqsystemtest_integtest_bundle.sh
  • Testing skipped as there are no core code changes in this PR, this only relates to documentation/CI workflows

Final checklist prior to marking this as "Ready for Review"

  • Code is clearly commented.
  • New unit tests have been added, or is documented in # ISSUE NUMBER
  • A suitable reviewer has been chosen from this list.

Reviewer checklist

  • This branch has been rebased with develop prior to testing.
  • Suggested manual tests show changes.
  • CI workflows fails documented (if present)
  • Integration tests passed
    • Only concern yourself if failures related to drunc are in the log files
    • If non-drunc failure appears:
      • Validate failure in fresh working area
      • Contact Pawel if unsure

Once the features are validated and both the unit and integration tests pass, the PRs is ready to be merged.

Prior to merging

Choose one of the following an complete all substeps
  • Changes only affect the Run Control, are in a single repository, and do not affect the end user.
    • Changes are documented in docstrings and code comments
    • Wiki has been updated if architectural or endpoint changes
  • Otherwise
    • Workflow changes demonstrated in the Change Log (if necessary)
    • Wiki has been updated (if necessary)
    • #daq-sw-librarians Slack channel notified (see below)

Once completed, the reviewer can merge the PR.

Notification message for a Slack channel

Note - this should be to #dunedaq-integration for general workflow that isn't during a release candidate period, and to #daq-release-prep otherwise.

For an single merge that changes the user workflow

The CCM WG has an isolated PR ready to merge that affects user workflows. The PR is:

_URL_

I will leave time for any comments, otherwise will merge these at the end of the work day _Insert your time zone_.

For co-ordinated merge

The CCM WG has a set of co-ordinated merges ready to merge. The PRs are:

_URL_

_URL_


I will leave time for any comments, otherwise will merge these at the end of the day.

@emmuhamm emmuhamm self-assigned this Apr 29, 2026
@emmuhamm emmuhamm linked an issue Apr 29, 2026 that may be closed by this pull request
@emmuhamm emmuhamm changed the title Emmuhamm/auto class uml Auto class diagrams in the drunc docs Apr 29, 2026
@emmuhamm
Copy link
Copy Markdown
Contributor Author

Screenshot 2026-04-29 at 14 59 04

@emmuhamm
Copy link
Copy Markdown
Contributor Author

now you need to refactor context_settings from generate_uml from logging...

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.

[Feature]: Automated class inheritance UMLs

2 participants