fix: guard module-level state with RLock (closes #4) - #27

Merged
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races
May 13, 2026
Merged

fix: guard module-level state with RLock (closes #4)#27
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races

Conversation

@AndresL230

Copy link
Copy Markdown
Contributor

Summary

Closes#4.

Adds two module-level RLocks to guard the singleton state shared
across SDK lifecycle calls:

  • _install_lock in recost/_interceptor.py — protects
    install() / uninstall() / is_installed() so the patched-method
    state cannot drift away from the _installed flag.
  • _init_lock in recost/_init.py — protects init() and
    RecostHandle.dispose() so concurrent callers cannot orphan
    previously-installed handles.

The two locks are independent. init() / dispose() always acquire
_init_lock first, then _install_lock via the transitive
install() / uninstall() call. There is no inverted ordering, so
no deadlock potential.

Tests

  • tests/test_interceptor.py::TestInstallUninstallRace — 4 threads ×
    200 install/uninstall cycles, with sys.setswitchinterval(0.000001)
    to force GIL yields. Pre-fix this reliably leaves a recost wrapper
    on urllib3.HTTPConnectionPool.urlopen after the race; post-fix
    the original is restored.
  • tests/test_init.py::TestInitDisposeRace — 4 threads × 20 init
    cycles with RecostConfig(enabled=False) so the test exercises the
    _handle race without paying for real transport/timer setup. Pre-fix
    this reliably orphans handles (a typical run leaves 17 of 80 handles
    undisposed); post-fix exactly one handle is active at any time.

Notes

  • Public API unchanged.
  • No new dependencies.
  • Builds on the same sys.setswitchinterval test discipline introduced
    by PR fix(aggregator): make Aggregator thread-safe (closes #1) #25 (issue Aggregator is not thread-safe — flush vs. ingest race #1).
  • Plan deviation: the plan's test bodies used RecostConfig(enabled=True)
    but the plan's own comment said "Disabled config avoids actually
    starting transport / timer threads so the test stays fast and
    isolated." With enabled=True each init/dispose pair takes ~3s, so 80
    pairs exceeded the 30s per-thread join timeout and the test failed
    for the wrong reason. Flipped to enabled=False to match the comment's
    stated intent — test runs in 0.02s and still reproduces the race.

🤖 Generated with Claude Code

Two threads racing install() could both observe _installed=False and
both run the patch path, with the second wrapping the first. A later
uninstall() would unwrap only one layer, leaving a recost wrapper in
place even though _installed=False.
Add a module-level RLock around install/uninstall/is_installed so the
patched-method state cannot drift away from the _installed flag.
Adds a regression test that reliably reproduced the wrapper-leak on
the unfixed code.
Refs #4
Two threads racing init() could both observe _handle=None and both
proceed past the dispose-previous guard, with the first thread's
handle orphaned (its timer thread + transport leak) once the second
overwrites _handle.
Add a module-level RLock around init() and RecostHandle.dispose() so
_handle mutation and the install/uninstall calls they make stay
atomic against each other.
The lock nests safely with the interceptor's _install_lock — _init_lock
is always acquired first, then _install_lock via the transitive
install()/uninstall() call.
Adds a regression test that reliably reproduced the orphan-handle leak
on the unfixed code (17 of 80 handles orphaned in a typical run).
Tests use RecostConfig(enabled=False) so init/dispose pairs do not
spin up transport/timer threads — the lock invariant under test does
not depend on those resources being live, and avoiding them keeps the
test under one second instead of four minutes.
Refs #4
Move `sys` / `threading` imports introduced by the new race-test
classes to the top of their files (ruff E402) and rewrite the
`config_factory` lambda as a `def` (ruff E731). No behavior change.
Refs #4
@coderabbitai

Copy link
Copy Markdown

Warning

Rate limit exceeded

@AndresL230 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 1 minute and 19 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d538ecf6-8908-4610-a565-f7e239a18c68

📥 Commits

Reviewing files that changed from the base of the PR and between 39dc6af and 77125f0.

📒 Files selected for processing (4)
  • recost/_init.py
  • recost/_interceptor.py
  • tests/test_init.py
  • tests/test_interceptor.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/module-level-state-races

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@AndresL230
AndresL230 merged commit 6992c21 into mainMay 13, 2026
1 check passed
@AndresL230
AndresL230 deleted the fix/module-level-state-races branch May 21, 2026 04:17
Sign up for freeto 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.

Module-level state races: _handle, install/uninstall, init-vs-dispose

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

fix: guard module-level state with RLock (closes #4) - #27

Merged
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races
May 13, 2026
Merged

fix: guard module-level state with RLock (closes #4)#27
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races

Conversation

@AndresL230

Copy link
Copy Markdown
Contributor

Summary

Closes#4.

Adds two module-level RLocks to guard the singleton state shared
across SDK lifecycle calls:

  • _install_lock in recost/_interceptor.py — protects
    install() / uninstall() / is_installed() so the patched-method
    state cannot drift away from the _installed flag.
  • _init_lock in recost/_init.py — protects init() and
    RecostHandle.dispose() so concurrent callers cannot orphan
    previously-installed handles.

The two locks are independent. init() / dispose() always acquire
_init_lock first, then _install_lock via the transitive
install() / uninstall() call. There is no inverted ordering, so
no deadlock potential.

Tests

  • tests/test_interceptor.py::TestInstallUninstallRace — 4 threads ×
    200 install/uninstall cycles, with sys.setswitchinterval(0.000001)
    to force GIL yields. Pre-fix this reliably leaves a recost wrapper
    on urllib3.HTTPConnectionPool.urlopen after the race; post-fix
    the original is restored.
  • tests/test_init.py::TestInitDisposeRace — 4 threads × 20 init
    cycles with RecostConfig(enabled=False) so the test exercises the
    _handle race without paying for real transport/timer setup. Pre-fix
    this reliably orphans handles (a typical run leaves 17 of 80 handles
    undisposed); post-fix exactly one handle is active at any time.

Notes

  • Public API unchanged.
  • No new dependencies.
  • Builds on the same sys.setswitchinterval test discipline introduced
    by PR fix(aggregator): make Aggregator thread-safe (closes #1) #25 (issue Aggregator is not thread-safe — flush vs. ingest race #1).
  • Plan deviation: the plan's test bodies used RecostConfig(enabled=True)
    but the plan's own comment said "Disabled config avoids actually
    starting transport / timer threads so the test stays fast and
    isolated." With enabled=True each init/dispose pair takes ~3s, so 80
    pairs exceeded the 30s per-thread join timeout and the test failed
    for the wrong reason. Flipped to enabled=False to match the comment's
    stated intent — test runs in 0.02s and still reproduces the race.

🤖 Generated with Claude Code

Two threads racing install() could both observe _installed=False and
both run the patch path, with the second wrapping the first. A later
uninstall() would unwrap only one layer, leaving a recost wrapper in
place even though _installed=False.
Add a module-level RLock around install/uninstall/is_installed so the
patched-method state cannot drift away from the _installed flag.
Adds a regression test that reliably reproduced the wrapper-leak on
the unfixed code.
Refs #4
Two threads racing init() could both observe _handle=None and both
proceed past the dispose-previous guard, with the first thread's
handle orphaned (its timer thread + transport leak) once the second
overwrites _handle.
Add a module-level RLock around init() and RecostHandle.dispose() so
_handle mutation and the install/uninstall calls they make stay
atomic against each other.
The lock nests safely with the interceptor's _install_lock — _init_lock
is always acquired first, then _install_lock via the transitive
install()/uninstall() call.
Adds a regression test that reliably reproduced the orphan-handle leak
on the unfixed code (17 of 80 handles orphaned in a typical run).
Tests use RecostConfig(enabled=False) so init/dispose pairs do not
spin up transport/timer threads — the lock invariant under test does
not depend on those resources being live, and avoiding them keeps the
test under one second instead of four minutes.
Refs #4
Move `sys` / `threading` imports introduced by the new race-test
classes to the top of their files (ruff E402) and rewrite the
`config_factory` lambda as a `def` (ruff E731). No behavior change.
Refs #4
@coderabbitai

Copy link
Copy Markdown

Warning

Rate limit exceeded

@AndresL230 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 1 minute and 19 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d538ecf6-8908-4610-a565-f7e239a18c68

📥 Commits

Reviewing files that changed from the base of the PR and between 39dc6af and 77125f0.

📒 Files selected for processing (4)
  • recost/_init.py
  • recost/_interceptor.py
  • tests/test_init.py
  • tests/test_interceptor.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/module-level-state-races

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@AndresL230
AndresL230 merged commit 6992c21 into mainMay 13, 2026
1 check passed
@AndresL230
AndresL230 deleted the fix/module-level-state-races branch May 21, 2026 04:17
Sign up for freeto 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.

Module-level state races: _handle, install/uninstall, init-vs-dispose

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix: guard module-level state with RLock (closes #4) - #27

Merged
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races
May 13, 2026
Merged

fix: guard module-level state with RLock (closes #4)#27
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races

Conversation

@AndresL230

Copy link
Copy Markdown
Contributor

Summary

Closes#4.

Adds two module-level RLocks to guard the singleton state shared
across SDK lifecycle calls:

  • _install_lock in recost/_interceptor.py — protects
    install() / uninstall() / is_installed() so the patched-method
    state cannot drift away from the _installed flag.
  • _init_lock in recost/_init.py — protects init() and
    RecostHandle.dispose() so concurrent callers cannot orphan
    previously-installed handles.

The two locks are independent. init() / dispose() always acquire
_init_lock first, then _install_lock via the transitive
install() / uninstall() call. There is no inverted ordering, so
no deadlock potential.

Tests

  • tests/test_interceptor.py::TestInstallUninstallRace — 4 threads ×
    200 install/uninstall cycles, with sys.setswitchinterval(0.000001)
    to force GIL yields. Pre-fix this reliably leaves a recost wrapper
    on urllib3.HTTPConnectionPool.urlopen after the race; post-fix
    the original is restored.
  • tests/test_init.py::TestInitDisposeRace — 4 threads × 20 init
    cycles with RecostConfig(enabled=False) so the test exercises the
    _handle race without paying for real transport/timer setup. Pre-fix
    this reliably orphans handles (a typical run leaves 17 of 80 handles
    undisposed); post-fix exactly one handle is active at any time.

Notes

  • Public API unchanged.
  • No new dependencies.
  • Builds on the same sys.setswitchinterval test discipline introduced
    by PR fix(aggregator): make Aggregator thread-safe (closes #1) #25 (issue Aggregator is not thread-safe — flush vs. ingest race #1).
  • Plan deviation: the plan's test bodies used RecostConfig(enabled=True)
    but the plan's own comment said "Disabled config avoids actually
    starting transport / timer threads so the test stays fast and
    isolated." With enabled=True each init/dispose pair takes ~3s, so 80
    pairs exceeded the 30s per-thread join timeout and the test failed
    for the wrong reason. Flipped to enabled=False to match the comment's
    stated intent — test runs in 0.02s and still reproduces the race.

🤖 Generated with Claude Code

Two threads racing install() could both observe _installed=False and
both run the patch path, with the second wrapping the first. A later
uninstall() would unwrap only one layer, leaving a recost wrapper in
place even though _installed=False.
Add a module-level RLock around install/uninstall/is_installed so the
patched-method state cannot drift away from the _installed flag.
Adds a regression test that reliably reproduced the wrapper-leak on
the unfixed code.
Refs #4
Two threads racing init() could both observe _handle=None and both
proceed past the dispose-previous guard, with the first thread's
handle orphaned (its timer thread + transport leak) once the second
overwrites _handle.
Add a module-level RLock around init() and RecostHandle.dispose() so
_handle mutation and the install/uninstall calls they make stay
atomic against each other.
The lock nests safely with the interceptor's _install_lock — _init_lock
is always acquired first, then _install_lock via the transitive
install()/uninstall() call.
Adds a regression test that reliably reproduced the orphan-handle leak
on the unfixed code (17 of 80 handles orphaned in a typical run).
Tests use RecostConfig(enabled=False) so init/dispose pairs do not
spin up transport/timer threads — the lock invariant under test does
not depend on those resources being live, and avoiding them keeps the
test under one second instead of four minutes.
Refs #4
Move `sys` / `threading` imports introduced by the new race-test
classes to the top of their files (ruff E402) and rewrite the
`config_factory` lambda as a `def` (ruff E731). No behavior change.
Refs #4
@coderabbitai

Copy link
Copy Markdown

Warning

Rate limit exceeded

@AndresL230 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 1 minute and 19 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d538ecf6-8908-4610-a565-f7e239a18c68

📥 Commits

Reviewing files that changed from the base of the PR and between 39dc6af and 77125f0.

📒 Files selected for processing (4)
  • recost/_init.py
  • recost/_interceptor.py
  • tests/test_init.py
  • tests/test_interceptor.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/module-level-state-races

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@AndresL230
AndresL230 merged commit 6992c21 into mainMay 13, 2026
1 check passed
@AndresL230
AndresL230 deleted the fix/module-level-state-races branch May 21, 2026 04:17
Sign up for freeto 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.

Module-level state races: _handle, install/uninstall, init-vs-dispose

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix: guard module-level state with RLock (closes #4) - #27

Merged
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races
May 13, 2026
Merged

fix: guard module-level state with RLock (closes #4)#27
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races

Conversation

@AndresL230

Copy link
Copy Markdown
Contributor

Summary

Closes#4.

Adds two module-level RLocks to guard the singleton state shared
across SDK lifecycle calls:

  • _install_lock in recost/_interceptor.py — protects
    install() / uninstall() / is_installed() so the patched-method
    state cannot drift away from the _installed flag.
  • _init_lock in recost/_init.py — protects init() and
    RecostHandle.dispose() so concurrent callers cannot orphan
    previously-installed handles.

The two locks are independent. init() / dispose() always acquire
_init_lock first, then _install_lock via the transitive
install() / uninstall() call. There is no inverted ordering, so
no deadlock potential.

Tests

  • tests/test_interceptor.py::TestInstallUninstallRace — 4 threads ×
    200 install/uninstall cycles, with sys.setswitchinterval(0.000001)
    to force GIL yields. Pre-fix this reliably leaves a recost wrapper
    on urllib3.HTTPConnectionPool.urlopen after the race; post-fix
    the original is restored.
  • tests/test_init.py::TestInitDisposeRace — 4 threads × 20 init
    cycles with RecostConfig(enabled=False) so the test exercises the
    _handle race without paying for real transport/timer setup. Pre-fix
    this reliably orphans handles (a typical run leaves 17 of 80 handles
    undisposed); post-fix exactly one handle is active at any time.

Notes

  • Public API unchanged.
  • No new dependencies.
  • Builds on the same sys.setswitchinterval test discipline introduced
    by PR fix(aggregator): make Aggregator thread-safe (closes #1) #25 (issue Aggregator is not thread-safe — flush vs. ingest race #1).
  • Plan deviation: the plan's test bodies used RecostConfig(enabled=True)
    but the plan's own comment said "Disabled config avoids actually
    starting transport / timer threads so the test stays fast and
    isolated." With enabled=True each init/dispose pair takes ~3s, so 80
    pairs exceeded the 30s per-thread join timeout and the test failed
    for the wrong reason. Flipped to enabled=False to match the comment's
    stated intent — test runs in 0.02s and still reproduces the race.

🤖 Generated with Claude Code

Two threads racing install() could both observe _installed=False and
both run the patch path, with the second wrapping the first. A later
uninstall() would unwrap only one layer, leaving a recost wrapper in
place even though _installed=False.
Add a module-level RLock around install/uninstall/is_installed so the
patched-method state cannot drift away from the _installed flag.
Adds a regression test that reliably reproduced the wrapper-leak on
the unfixed code.
Refs #4
Two threads racing init() could both observe _handle=None and both
proceed past the dispose-previous guard, with the first thread's
handle orphaned (its timer thread + transport leak) once the second
overwrites _handle.
Add a module-level RLock around init() and RecostHandle.dispose() so
_handle mutation and the install/uninstall calls they make stay
atomic against each other.
The lock nests safely with the interceptor's _install_lock — _init_lock
is always acquired first, then _install_lock via the transitive
install()/uninstall() call.
Adds a regression test that reliably reproduced the orphan-handle leak
on the unfixed code (17 of 80 handles orphaned in a typical run).
Tests use RecostConfig(enabled=False) so init/dispose pairs do not
spin up transport/timer threads — the lock invariant under test does
not depend on those resources being live, and avoiding them keeps the
test under one second instead of four minutes.
Refs #4
Move `sys` / `threading` imports introduced by the new race-test
classes to the top of their files (ruff E402) and rewrite the
`config_factory` lambda as a `def` (ruff E731). No behavior change.
Refs #4
@coderabbitai

Copy link
Copy Markdown

Warning

Rate limit exceeded

@AndresL230 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 1 minute and 19 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d538ecf6-8908-4610-a565-f7e239a18c68

📥 Commits

Reviewing files that changed from the base of the PR and between 39dc6af and 77125f0.

📒 Files selected for processing (4)
  • recost/_init.py
  • recost/_interceptor.py
  • tests/test_init.py
  • tests/test_interceptor.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/module-level-state-races

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@AndresL230
AndresL230 merged commit 6992c21 into mainMay 13, 2026
1 check passed
@AndresL230
AndresL230 deleted the fix/module-level-state-races branch May 21, 2026 04:17
Sign up for freeto 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.

Module-level state races: _handle, install/uninstall, init-vs-dispose

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

fix: guard module-level state with RLock (closes #4) - #27

Merged
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races
May 13, 2026
Merged

fix: guard module-level state with RLock (closes #4)#27
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races

Conversation

@AndresL230

Copy link
Copy Markdown
Contributor

Summary

Closes#4.

Adds two module-level RLocks to guard the singleton state shared
across SDK lifecycle calls:

  • _install_lock in recost/_interceptor.py — protects
    install() / uninstall() / is_installed() so the patched-method
    state cannot drift away from the _installed flag.
  • _init_lock in recost/_init.py — protects init() and
    RecostHandle.dispose() so concurrent callers cannot orphan
    previously-installed handles.

The two locks are independent. init() / dispose() always acquire
_init_lock first, then _install_lock via the transitive
install() / uninstall() call. There is no inverted ordering, so
no deadlock potential.

Tests

  • tests/test_interceptor.py::TestInstallUninstallRace — 4 threads ×
    200 install/uninstall cycles, with sys.setswitchinterval(0.000001)
    to force GIL yields. Pre-fix this reliably leaves a recost wrapper
    on urllib3.HTTPConnectionPool.urlopen after the race; post-fix
    the original is restored.
  • tests/test_init.py::TestInitDisposeRace — 4 threads × 20 init
    cycles with RecostConfig(enabled=False) so the test exercises the
    _handle race without paying for real transport/timer setup. Pre-fix
    this reliably orphans handles (a typical run leaves 17 of 80 handles
    undisposed); post-fix exactly one handle is active at any time.

Notes

  • Public API unchanged.
  • No new dependencies.
  • Builds on the same sys.setswitchinterval test discipline introduced
    by PR fix(aggregator): make Aggregator thread-safe (closes #1) #25 (issue Aggregator is not thread-safe — flush vs. ingest race #1).
  • Plan deviation: the plan's test bodies used RecostConfig(enabled=True)
    but the plan's own comment said "Disabled config avoids actually
    starting transport / timer threads so the test stays fast and
    isolated." With enabled=True each init/dispose pair takes ~3s, so 80
    pairs exceeded the 30s per-thread join timeout and the test failed
    for the wrong reason. Flipped to enabled=False to match the comment's
    stated intent — test runs in 0.02s and still reproduces the race.

🤖 Generated with Claude Code

Two threads racing install() could both observe _installed=False and
both run the patch path, with the second wrapping the first. A later
uninstall() would unwrap only one layer, leaving a recost wrapper in
place even though _installed=False.
Add a module-level RLock around install/uninstall/is_installed so the
patched-method state cannot drift away from the _installed flag.
Adds a regression test that reliably reproduced the wrapper-leak on
the unfixed code.
Refs #4
Two threads racing init() could both observe _handle=None and both
proceed past the dispose-previous guard, with the first thread's
handle orphaned (its timer thread + transport leak) once the second
overwrites _handle.
Add a module-level RLock around init() and RecostHandle.dispose() so
_handle mutation and the install/uninstall calls they make stay
atomic against each other.
The lock nests safely with the interceptor's _install_lock — _init_lock
is always acquired first, then _install_lock via the transitive
install()/uninstall() call.
Adds a regression test that reliably reproduced the orphan-handle leak
on the unfixed code (17 of 80 handles orphaned in a typical run).
Tests use RecostConfig(enabled=False) so init/dispose pairs do not
spin up transport/timer threads — the lock invariant under test does
not depend on those resources being live, and avoiding them keeps the
test under one second instead of four minutes.
Refs #4
Move `sys` / `threading` imports introduced by the new race-test
classes to the top of their files (ruff E402) and rewrite the
`config_factory` lambda as a `def` (ruff E731). No behavior change.
Refs #4
@coderabbitai

Copy link
Copy Markdown

Warning

Rate limit exceeded

@AndresL230 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 1 minute and 19 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d538ecf6-8908-4610-a565-f7e239a18c68

📥 Commits

Reviewing files that changed from the base of the PR and between 39dc6af and 77125f0.

📒 Files selected for processing (4)
  • recost/_init.py
  • recost/_interceptor.py
  • tests/test_init.py
  • tests/test_interceptor.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/module-level-state-races

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@AndresL230
AndresL230 merged commit 6992c21 into mainMay 13, 2026
1 check passed
@AndresL230
AndresL230 deleted the fix/module-level-state-races branch May 21, 2026 04:17
Sign up for freeto 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.

Module-level state races: _handle, install/uninstall, init-vs-dispose

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix: guard module-level state with RLock (closes #4) - #27

Merged
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races
May 13, 2026
Merged

fix: guard module-level state with RLock (closes #4)#27
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races

Conversation

@AndresL230

Copy link
Copy Markdown
Contributor

Summary

Closes#4.

Adds two module-level RLocks to guard the singleton state shared
across SDK lifecycle calls:

  • _install_lock in recost/_interceptor.py — protects
    install() / uninstall() / is_installed() so the patched-method
    state cannot drift away from the _installed flag.
  • _init_lock in recost/_init.py — protects init() and
    RecostHandle.dispose() so concurrent callers cannot orphan
    previously-installed handles.

The two locks are independent. init() / dispose() always acquire
_init_lock first, then _install_lock via the transitive
install() / uninstall() call. There is no inverted ordering, so
no deadlock potential.

Tests

  • tests/test_interceptor.py::TestInstallUninstallRace — 4 threads ×
    200 install/uninstall cycles, with sys.setswitchinterval(0.000001)
    to force GIL yields. Pre-fix this reliably leaves a recost wrapper
    on urllib3.HTTPConnectionPool.urlopen after the race; post-fix
    the original is restored.
  • tests/test_init.py::TestInitDisposeRace — 4 threads × 20 init
    cycles with RecostConfig(enabled=False) so the test exercises the
    _handle race without paying for real transport/timer setup. Pre-fix
    this reliably orphans handles (a typical run leaves 17 of 80 handles
    undisposed); post-fix exactly one handle is active at any time.

Notes

  • Public API unchanged.
  • No new dependencies.
  • Builds on the same sys.setswitchinterval test discipline introduced
    by PR fix(aggregator): make Aggregator thread-safe (closes #1) #25 (issue Aggregator is not thread-safe — flush vs. ingest race #1).
  • Plan deviation: the plan's test bodies used RecostConfig(enabled=True)
    but the plan's own comment said "Disabled config avoids actually
    starting transport / timer threads so the test stays fast and
    isolated." With enabled=True each init/dispose pair takes ~3s, so 80
    pairs exceeded the 30s per-thread join timeout and the test failed
    for the wrong reason. Flipped to enabled=False to match the comment's
    stated intent — test runs in 0.02s and still reproduces the race.

🤖 Generated with Claude Code

Two threads racing install() could both observe _installed=False and
both run the patch path, with the second wrapping the first. A later
uninstall() would unwrap only one layer, leaving a recost wrapper in
place even though _installed=False.
Add a module-level RLock around install/uninstall/is_installed so the
patched-method state cannot drift away from the _installed flag.
Adds a regression test that reliably reproduced the wrapper-leak on
the unfixed code.
Refs #4
Two threads racing init() could both observe _handle=None and both
proceed past the dispose-previous guard, with the first thread's
handle orphaned (its timer thread + transport leak) once the second
overwrites _handle.
Add a module-level RLock around init() and RecostHandle.dispose() so
_handle mutation and the install/uninstall calls they make stay
atomic against each other.
The lock nests safely with the interceptor's _install_lock — _init_lock
is always acquired first, then _install_lock via the transitive
install()/uninstall() call.
Adds a regression test that reliably reproduced the orphan-handle leak
on the unfixed code (17 of 80 handles orphaned in a typical run).
Tests use RecostConfig(enabled=False) so init/dispose pairs do not
spin up transport/timer threads — the lock invariant under test does
not depend on those resources being live, and avoiding them keeps the
test under one second instead of four minutes.
Refs #4
Move `sys` / `threading` imports introduced by the new race-test
classes to the top of their files (ruff E402) and rewrite the
`config_factory` lambda as a `def` (ruff E731). No behavior change.
Refs #4
@coderabbitai

Copy link
Copy Markdown

Warning

Rate limit exceeded

@AndresL230 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 1 minute and 19 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d538ecf6-8908-4610-a565-f7e239a18c68

📥 Commits

Reviewing files that changed from the base of the PR and between 39dc6af and 77125f0.

📒 Files selected for processing (4)
  • recost/_init.py
  • recost/_interceptor.py
  • tests/test_init.py
  • tests/test_interceptor.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/module-level-state-races

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@AndresL230
AndresL230 merged commit 6992c21 into mainMay 13, 2026
1 check passed
@AndresL230
AndresL230 deleted the fix/module-level-state-races branch May 21, 2026 04:17
Sign up for freeto 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.

Module-level state races: _handle, install/uninstall, init-vs-dispose

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

fix: guard module-level state with RLock (closes #4) - #27

Merged
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races
May 13, 2026
Merged

fix: guard module-level state with RLock (closes #4)#27
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races

Conversation

@AndresL230

Copy link
Copy Markdown
Contributor

Summary

Closes#4.

Adds two module-level RLocks to guard the singleton state shared
across SDK lifecycle calls:

  • _install_lock in recost/_interceptor.py — protects
    install() / uninstall() / is_installed() so the patched-method
    state cannot drift away from the _installed flag.
  • _init_lock in recost/_init.py — protects init() and
    RecostHandle.dispose() so concurrent callers cannot orphan
    previously-installed handles.

The two locks are independent. init() / dispose() always acquire
_init_lock first, then _install_lock via the transitive
install() / uninstall() call. There is no inverted ordering, so
no deadlock potential.

Tests

  • tests/test_interceptor.py::TestInstallUninstallRace — 4 threads ×
    200 install/uninstall cycles, with sys.setswitchinterval(0.000001)
    to force GIL yields. Pre-fix this reliably leaves a recost wrapper
    on urllib3.HTTPConnectionPool.urlopen after the race; post-fix
    the original is restored.
  • tests/test_init.py::TestInitDisposeRace — 4 threads × 20 init
    cycles with RecostConfig(enabled=False) so the test exercises the
    _handle race without paying for real transport/timer setup. Pre-fix
    this reliably orphans handles (a typical run leaves 17 of 80 handles
    undisposed); post-fix exactly one handle is active at any time.

Notes

  • Public API unchanged.
  • No new dependencies.
  • Builds on the same sys.setswitchinterval test discipline introduced
    by PR fix(aggregator): make Aggregator thread-safe (closes #1) #25 (issue Aggregator is not thread-safe — flush vs. ingest race #1).
  • Plan deviation: the plan's test bodies used RecostConfig(enabled=True)
    but the plan's own comment said "Disabled config avoids actually
    starting transport / timer threads so the test stays fast and
    isolated." With enabled=True each init/dispose pair takes ~3s, so 80
    pairs exceeded the 30s per-thread join timeout and the test failed
    for the wrong reason. Flipped to enabled=False to match the comment's
    stated intent — test runs in 0.02s and still reproduces the race.

🤖 Generated with Claude Code

Two threads racing install() could both observe _installed=False and
both run the patch path, with the second wrapping the first. A later
uninstall() would unwrap only one layer, leaving a recost wrapper in
place even though _installed=False.
Add a module-level RLock around install/uninstall/is_installed so the
patched-method state cannot drift away from the _installed flag.
Adds a regression test that reliably reproduced the wrapper-leak on
the unfixed code.
Refs #4
Two threads racing init() could both observe _handle=None and both
proceed past the dispose-previous guard, with the first thread's
handle orphaned (its timer thread + transport leak) once the second
overwrites _handle.
Add a module-level RLock around init() and RecostHandle.dispose() so
_handle mutation and the install/uninstall calls they make stay
atomic against each other.
The lock nests safely with the interceptor's _install_lock — _init_lock
is always acquired first, then _install_lock via the transitive
install()/uninstall() call.
Adds a regression test that reliably reproduced the orphan-handle leak
on the unfixed code (17 of 80 handles orphaned in a typical run).
Tests use RecostConfig(enabled=False) so init/dispose pairs do not
spin up transport/timer threads — the lock invariant under test does
not depend on those resources being live, and avoiding them keeps the
test under one second instead of four minutes.
Refs #4
Move `sys` / `threading` imports introduced by the new race-test
classes to the top of their files (ruff E402) and rewrite the
`config_factory` lambda as a `def` (ruff E731). No behavior change.
Refs #4
@coderabbitai

Copy link
Copy Markdown

Warning

Rate limit exceeded

@AndresL230 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 1 minute and 19 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d538ecf6-8908-4610-a565-f7e239a18c68

📥 Commits

Reviewing files that changed from the base of the PR and between 39dc6af and 77125f0.

📒 Files selected for processing (4)
  • recost/_init.py
  • recost/_interceptor.py
  • tests/test_init.py
  • tests/test_interceptor.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/module-level-state-races

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@AndresL230
AndresL230 merged commit 6992c21 into mainMay 13, 2026
1 check passed
@AndresL230
AndresL230 deleted the fix/module-level-state-races branch May 21, 2026 04:17
Sign up for freeto 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.

Module-level state races: _handle, install/uninstall, init-vs-dispose

1 participant

@AndresL230
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

fix: guard module-level state with RLock (closes #4) - #27

Merged
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races
May 13, 2026
Merged

fix: guard module-level state with RLock (closes #4)#27
AndresL230 merged 3 commits into
mainfrom
fix/module-level-state-races

Conversation

@AndresL230

Copy link
Copy Markdown
Contributor

Summary

Closes#4.

Adds two module-level RLocks to guard the singleton state shared
across SDK lifecycle calls:

  • _install_lock in recost/_interceptor.py — protects
    install() / uninstall() / is_installed() so the patched-method
    state cannot drift away from the _installed flag.
  • _init_lock in recost/_init.py — protects init() and
    RecostHandle.dispose() so concurrent callers cannot orphan
    previously-installed handles.

The two locks are independent. init() / dispose() always acquire
_init_lock first, then _install_lock via the transitive
install() / uninstall() call. There is no inverted ordering, so
no deadlock potential.

Tests

  • tests/test_interceptor.py::TestInstallUninstallRace — 4 threads ×
    200 install/uninstall cycles, with sys.setswitchinterval(0.000001)
    to force GIL yields. Pre-fix this reliably leaves a recost wrapper
    on urllib3.HTTPConnectionPool.urlopen after the race; post-fix
    the original is restored.
  • tests/test_init.py::TestInitDisposeRace — 4 threads × 20 init
    cycles with RecostConfig(enabled=False) so the test exercises the
    _handle race without paying for real transport/timer setup. Pre-fix
    this reliably orphans handles (a typical run leaves 17 of 80 handles
    undisposed); post-fix exactly one handle is active at any time.

Notes

  • Public API unchanged.
  • No new dependencies.
  • Builds on the same sys.setswitchinterval test discipline introduced
    by PR fix(aggregator): make Aggregator thread-safe (closes #1) #25 (issue Aggregator is not thread-safe — flush vs. ingest race #1).
  • Plan deviation: the plan's test bodies used RecostConfig(enabled=True)
    but the plan's own comment said "Disabled config avoids actually
    starting transport / timer threads so the test stays fast and
    isolated." With enabled=True each init/dispose pair takes ~3s, so 80
    pairs exceeded the 30s per-thread join timeout and the test failed
    for the wrong reason. Flipped to enabled=False to match the comment's
    stated intent — test runs in 0.02s and still reproduces the race.

🤖 Generated with Claude Code

Two threads racing install() could both observe _installed=False and
both run the patch path, with the second wrapping the first. A later
uninstall() would unwrap only one layer, leaving a recost wrapper in
place even though _installed=False.
Add a module-level RLock around install/uninstall/is_installed so the
patched-method state cannot drift away from the _installed flag.
Adds a regression test that reliably reproduced the wrapper-leak on
the unfixed code.
Refs #4
Two threads racing init() could both observe _handle=None and both
proceed past the dispose-previous guard, with the first thread's
handle orphaned (its timer thread + transport leak) once the second
overwrites _handle.
Add a module-level RLock around init() and RecostHandle.dispose() so
_handle mutation and the install/uninstall calls they make stay
atomic against each other.
The lock nests safely with the interceptor's _install_lock — _init_lock
is always acquired first, then _install_lock via the transitive
install()/uninstall() call.
Adds a regression test that reliably reproduced the orphan-handle leak
on the unfixed code (17 of 80 handles orphaned in a typical run).
Tests use RecostConfig(enabled=False) so init/dispose pairs do not
spin up transport/timer threads — the lock invariant under test does
not depend on those resources being live, and avoiding them keeps the
test under one second instead of four minutes.
Refs #4
Move `sys` / `threading` imports introduced by the new race-test
classes to the top of their files (ruff E402) and rewrite the
`config_factory` lambda as a `def` (ruff E731). No behavior change.
Refs #4
@coderabbitai

Copy link
Copy Markdown

Warning

Rate limit exceeded

@AndresL230 has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 1 minute and 19 seconds before requesting another review.

You’ve run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: d538ecf6-8908-4610-a565-f7e239a18c68

📥 Commits

Reviewing files that changed from the base of the PR and between 39dc6af and 77125f0.

📒 Files selected for processing (4)
  • recost/_init.py
  • recost/_interceptor.py
  • tests/test_init.py
  • tests/test_interceptor.py
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/module-level-state-races

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@AndresL230
AndresL230 merged commit 6992c21 into mainMay 13, 2026
1 check passed
@AndresL230
AndresL230 deleted the fix/module-level-state-races branch May 21, 2026 04:17
Sign up for freeto 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.

Module-level state races: _handle, install/uninstall, init-vs-dispose

1 participant

@AndresL230