Skip to content

Only call loadPlugins once in constructors.#469

Merged
luciansmith merged 6 commits intodevelopmentfrom
only-call-loadPlugins-once
Mar 12, 2026
Merged

Only call loadPlugins once in constructors.#469
luciansmith merged 6 commits intodevelopmentfrom
only-call-loadPlugins-once

Conversation

@luciansmith
Copy link
Member

@luciansmith luciansmith commented Feb 11, 2026

I have memory leaks from loadPlugins functions from somewhere, and my working theory was that this is because some constructors call it multiple times: once in the base class, then again in the derived class. This change removes all calls of loadPlugins for all derived classes where the base class also calls loadPlugins.

I'm not sure why we don't call loadPlugins in the SBase constructor directly, but changing that would be a fairly significant design change, so no need to try it now.

I believe that we cannot do the same thing with 'connectToChild', because it becomes important when it's the derived class that overrides the base definition for it, and I think that a base class constructor would not call the derived class version. If I'm wrong, we can revisit, but it's also true that connectToChild doesn't leak memory, so it's not dangerous to call it multiple times.

'setElementNamespace' also only needs to be called once, but this is sort of incidental to the other cleanups.

The change didn't end up fixing the leak, but it's still more efficient.

libsbml is leaking memory in the loadPlugins functions, and my working theory is that this is because some constructors call it multiple times: once in the base class, then again in the derived class.  This change removes *all* calls of loadPlugins for all derived classes where the base class also calls loadPlugins.

I'm not sure why we don't call loadPlugins in the SBase constructor directly, but changing that would be a fairly significant design change, so no need to try it now.

I believe that we cannot do the same thing with 'connectToChild', because it becomes important when it's the derived class that overrides the base definition for it, and I *think* that a base class constructor would not call the derived class version.  If I'm wrong, we can revisit, but it's also true that connectToChild doesn't leak memory, so it's not dangerous to call it multiple times.

'setElementNamespace' also only needs to be called once, but this is sort of incidental to the other cleanups.

I have not yet tested whether this change actually fixes the leak--needed to check this in from my development machine so I could check it out on my valgrind-enabled machine.
@luciansmith
Copy link
Member Author

OK, I went through the changes, fixed a bug, and I think it's ready to go. There are probably similar fixes that could be made in other packages, but this is good for now!

The basic idea is that we don't need to call setElementNamespace or loadPlugins in constructors where those functions are already called in their base classes, but you do still want to call connectToChild(), since that functions on sub-class elements.

@luciansmith luciansmith reopened this Mar 11, 2026
(Actually mostly an excuse to get a new push in, so the test-on-push works again.)
@luciansmith
Copy link
Member Author

OK, this is working!

@fbergmann : This is not a critical update, but it would be nice. It calls functions less frequently, and is more robust about calling 'connectToChild'.

Copy link
Member

@fbergmann fbergmann left a comment

Choose a reason for hiding this comment

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

works for me, but for distrib ...w e are now calling connectToChild in distribbase (even though there is a loadplugins call as well, and while we are at it ... if calling connectToChild there, should it not be called after loading the plugins?

been too long that i looked into this !

@luciansmith
Copy link
Member Author

connectToChild sets the parent object of all the object's children, but not plugins. So I believe that you can call it before or after loading any plugins; those objects' parents are set separately?

@luciansmith luciansmith merged commit 6594cac into development Mar 12, 2026
35 checks passed
@luciansmith luciansmith deleted the only-call-loadPlugins-once branch March 12, 2026 17:13
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