anonymous_loader 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
data/README.md ADDED
@@ -0,0 +1,562 @@
1
+ <a href="https://github.com/ruby-oauth"><img alt="ruby-oauth Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/ruby-oauth/avatar-128px.svg" width="14%" align="right"/></a>
2
+
3
+ # 💎 AnonymousLoader
4
+
5
+ [![Version][👽versioni]][👽version] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: MIT][📄license-img]][📄license] [![Downloads Rank][👽dl-ranki]][👽dl-rank] [![CodeCov Test Coverage][🏀codecovi]][🏀codecov] [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls] [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov] [![QLTY Maintainability][🏀qlty-mnti]][🏀qlty-mnt] [![CI Heads][🚎3-hd-wfi]][🚎3-hd-wf] [![CI Runtime Dependencies @ HEAD][🚎12-crh-wfi]][🚎12-crh-wf] [![CI Current][🚎11-c-wfi]][🚎11-c-wf] [![CI Truffle Ruby][🚎9-t-wfi]][🚎9-t-wf] [![CI JRuby][🚎10-j-wfi]][🚎10-j-wf] [![Deps Locked][🚎13-🔒️-wfi]][🚎13-🔒️-wf] [![Deps Unlocked][🚎14-🔓️-wfi]][🚎14-🔓️-wf] [![CI Test Coverage][🚎2-cov-wfi]][🚎2-cov-wf] [![CI Style][🚎5-st-wfi]][🚎5-st-wf] [![Apache SkyWalking Eyes License Compatibility Check][🚎15-🪪-wfi]][🚎15-🪪-wf]
6
+
7
+ `if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know][✉️discord-invite], as I may have missed the [discord notification][✉️discord-invite].
8
+
9
+ ---
10
+
11
+ `if ci_badges.map(&:color).all? { it == "green"}` 👇️ send money so I can do more of this. FLOSS maintenance is now my full-time job.
12
+
13
+ [![OpenCollective Backers][🖇osc-backers-i]][🖇osc-backers] [![OpenCollective Sponsors][🖇osc-sponsors-i]][🖇osc-sponsors] [![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor] [![Liberapay Goal Progress][⛳liberapay-img]][⛳liberapay] [![Donate on PayPal][🖇paypal-img]][🖇paypal] [![Buy me a coffee][🖇buyme-small-img]][🖇buyme] [![Donate on Polar][🖇polar-img]][🖇polar] [![Donate at ko-fi.com][🖇kofi-img]][🖇kofi]
14
+
15
+ <details>
16
+ <summary>👣 How will this project approach the September 2025 hostile takeover of RubyGems? 🚑️</summary>
17
+
18
+ I've summarized my thoughts in [this blog post](https://dev.to/galtzo/hostile-takeover-of-rubygems-my-thoughts-5hlo).
19
+
20
+ </details>
21
+
22
+ ## 🌻 Synopsis <a href="https://discord.gg/3qme4XHNKN"><img alt="Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/galtzo-floss/avatar-128px.svg" width="8%" align="right"/></a> <a href="https://ruby-toolbox.com"><img alt="ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5" src="https://logos.galtzo.com/assets/images/ruby-lang/avatar-128px.svg" width="8%" align="right"/></a>
23
+
24
+ AnonymousLoader evaluates Ruby source files inside fresh anonymous modules.
25
+ It is useful when a tool needs to inspect or reuse code that declares constants
26
+ whose top-level names may collide with the host process.
27
+
28
+ The loaded source keeps its normal constant nesting, but that nesting starts
29
+ inside the returned anonymous namespace. For example, source that declares
30
+ `Auth::Sanitizer` becomes `namespace::Auth::Sanitizer`, and does not create
31
+ `Object::Auth`.
32
+
33
+ AnonymousLoader can load explicitly named files, or resolve a file using
34
+ RubyGems metadata with a `$LOAD_PATH` fallback. The fallback is intended for
35
+ Bundler standalone and similar environments where code is loadable but a gem is
36
+ not visible through `Gem.loaded_specs` or the normal RubyGems index.
37
+
38
+ ## 💡 Info you can shake a stick at
39
+
40
+ | Tokens to Remember | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace] |
41
+ |-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
42
+ | Works with JRuby | [![JRuby 9.2 Compat][💎jruby-9.2i]][🚎jruby-9.2-wf] [![JRuby 9.3 Compat][💎jruby-9.3i]][🚎jruby-9.3-wf] <br/> [![JRuby 9.4 Compat][💎jruby-9.4i]][🚎jruby-9.4-wf] [![JRuby current Compat][💎jruby-c-i]][🚎10-j-wf] [![JRuby HEAD Compat][💎jruby-headi]][🚎3-hd-wf]|
43
+ | Works with Truffle Ruby | [![Truffle Ruby 22.3 Compat][💎truby-22.3i]][🚎truby-22.3-wf] [![Truffle Ruby 23.0 Compat][💎truby-23.0i]][🚎truby-23.0-wf] [![Truffle Ruby 23.1 Compat][💎truby-23.1i]][🚎truby-23.1-wf] <br/> [![Truffle Ruby 24.2 Compat][💎truby-24.2i]][🚎truby-24.2-wf] [![Truffle Ruby 25.0 Compat][💎truby-25.0i]][🚎truby-25.0-wf] [![Truffle Ruby current Compat][💎truby-c-i]][🚎9-t-wf]|
44
+ | Works with MRI Ruby 4 | [![Ruby 4.0 Compat][💎ruby-4.0i]][🚎11-c-wf] [![Ruby current Compat][💎ruby-c-i]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf]|
45
+ | Works with MRI Ruby 3 | [![Ruby 3.0 Compat][💎ruby-3.0i]][🚎ruby-3.0-wf] [![Ruby 3.1 Compat][💎ruby-3.1i]][🚎ruby-3.1-wf] [![Ruby 3.2 Compat][💎ruby-3.2i]][🚎ruby-3.2-wf] [![Ruby 3.3 Compat][💎ruby-3.3i]][🚎ruby-3.3-wf] [![Ruby 3.4 Compat][💎ruby-3.4i]][🚎ruby-3.4-wf]|
46
+ | Works with MRI Ruby 2 | ![Ruby 2.2 Compat][💎ruby-2.2i] ![Ruby 2.3 Compat][💎ruby-2.3i] <br/> [![Ruby 2.4 Compat][💎ruby-2.4i]][🚎ruby-2.4-wf] [![Ruby 2.5 Compat][💎ruby-2.5i]][🚎ruby-2.5-wf] [![Ruby 2.6 Compat][💎ruby-2.6i]][🚎ruby-2.6-wf] [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎ruby-2.7-wf]|
47
+ | Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork] [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor] |
48
+ | Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on Github.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc] |
49
+ | Documentation | [![Current release on RubyDoc.info][📜docs-cr-rd-img]][🚎yard-current] [![YARD on Galtzo.com][📜docs-head-rd-img]][🚎yard-head] [![Maintainer Blog][🚂maint-blog-img]][🚂maint-blog] [![GitLab Wiki][📜gl-wiki-img]][📜gl-wiki] [![GitHub Wiki][📜gh-wiki-img]][📜gh-wiki] |
50
+ | Compliance | [![License: MIT][📄license-img]][📄license] [![Apache license compatibility: Category A][📄license-compat-img]][📄license-compat] [![📄ilo-declaration-img]][📄ilo-declaration] [![Security Policy][🔐security-img]][🔐security] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] |
51
+ | Style | [![Enforced Code Style Linter][💎rlts-img]][💎rlts] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog] [![Gitmoji Commits][📌gitmoji-img]][📌gitmoji] [![Compatibility appraised by: appraisal2][💎appraisal2-img]][💎appraisal2] |
52
+ | Maintainer 🎖️ | [![Follow Me on LinkedIn][💖🖇linkedin-img]][💖🖇linkedin] [![Follow Me on Ruby.Social][💖🐘ruby-mast-img]][💖🐘ruby-mast] [![Follow Me on Bluesky][💖🦋bluesky-img]][💖🦋bluesky] [![Contact Maintainer][🚂maint-contact-img]][🚂maint-contact] [![My technical writing][💖💁🏼‍♂️devto-img]][💖💁🏼‍♂️devto] |
53
+ | `...` 💖 | [![Find Me on WellFound:][💖✌️wellfound-img]][💖✌️wellfound] [![Find Me on CrunchBase][💖💲crunchbase-img]][💖💲crunchbase] [![My LinkTree][💖🌳linktree-img]][💖🌳linktree] [![More About Me][💖💁🏼‍♂️aboutme-img]][💖💁🏼‍♂️aboutme] [🧊][💖🧊berg] [🐙][💖🐙hub] [🛖][💖🛖hut] [🧪][💖🧪lab] |
54
+
55
+ ### Compatibility
56
+
57
+ Compatible with MRI Ruby 2.2.0+, and concordant releases of JRuby, and TruffleRuby.
58
+ CI workflows and Appraisals are generated for MRI Ruby 2.4+.
59
+ This test floor is configured by `ruby.test_minimum` in `.kettle-jem.yml` and
60
+ may be higher than the gem's runtime compatibility floor when legacy Rubies are
61
+ not practical for the current toolchain.
62
+
63
+ | 🚚 _Amazing_ test matrix was brought to you by | 🔎 appraisal2 🔎 and the color 💚 green 💚 |
64
+ |------------------------------------------------|--------------------------------------------------------|
65
+ | 👟 Check it out! | ✨ [github.com/appraisal-rb/appraisal2][💎appraisal2] ✨ |
66
+
67
+ ### Federated DVCS
68
+
69
+ <details markdown="1">
70
+ <summary>Find this repo on federated forges (Coming soon!)</summary>
71
+
72
+ | Federated [DVCS][💎d-in-dvcs] Repository | Status | Issues | PRs | Wiki | CI | Discussions |
73
+ |-------------------------------------------------|-----------------------------------------------------------------------|---------------------------|--------------------------|---------------------------|--------------------------|------------------------------|
74
+ | 🧪 [ruby-oauth/anonymous_loader on GitLab][📜src-gl] | The Truth | [💚][🤝gl-issues] | [💚][🤝gl-pulls] | [💚][📜gl-wiki] | 🐭 Tiny Matrix | ➖ |
75
+ | 🧊 [ruby-oauth/anonymous_loader on CodeBerg][📜src-cb] | An Ethical Mirror ([Donate][🤝cb-donate]) | [💚][🤝cb-issues] | [💚][🤝cb-pulls] | ➖ | ⭕️ No Matrix | ➖ |
76
+ | 🐙 [ruby-oauth/anonymous_loader on GitHub][📜src-gh] | Another Mirror | [💚][🤝gh-issues] | [💚][🤝gh-pulls] | [💚][📜gh-wiki] | 💯 Full Matrix | [💚][gh-discussions] |
77
+ | 🎮️ [Discord Server][✉️discord-invite] | [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] | [Let's][✉️discord-invite] | [talk][✉️discord-invite] | [about][✉️discord-invite] | [this][✉️discord-invite] | [library!][✉️discord-invite] |
78
+
79
+ </details>
80
+
81
+ [gh-discussions]: https://github.com/ruby-oauth/anonymous_loader/discussions
82
+
83
+ ### Enterprise Support [![Tidelift](https://tidelift.com/badges/package/rubygems/anonymous_loader)](https://tidelift.com/subscription/pkg/rubygems-anonymous_loader?utm_source=rubygems-anonymous_loader&utm_medium=referral&utm_campaign=readme)
84
+
85
+ Available as part of the Tidelift Subscription.
86
+
87
+ <details markdown="1">
88
+ <summary>Need enterprise-level guarantees?</summary>
89
+
90
+ The maintainers of this and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source packages you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact packages you use.
91
+
92
+ [![Get help from me on Tidelift][🏙️entsup-tidelift-img]][🏙️entsup-tidelift]
93
+
94
+ - 💡Subscribe for support guarantees covering _all_ your FLOSS dependencies
95
+ - 💡Tidelift is part of [Sonar][🏙️entsup-tidelift-sonar]
96
+ - 💡Tidelift pays maintainers to maintain the software you depend on!<br/>📊`@`Pointy Haired Boss: An [enterprise support][🏙️entsup-tidelift] subscription is "[never gonna let you down][🧮kloc]", and *supports* open source maintainers
97
+
98
+ Alternatively:
99
+
100
+ - [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
101
+ - [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork]
102
+ - [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor]
103
+
104
+ </details>
105
+
106
+ ## ✨ Installation
107
+
108
+ Install the gem and add to the application's Gemfile by executing:
109
+
110
+ ```console
111
+ bundle add anonymous_loader
112
+ ```
113
+
114
+ If bundler is not being used to manage dependencies, install the gem by executing:
115
+
116
+ ```console
117
+ gem install anonymous_loader
118
+ ```
119
+
120
+ ## ⚙️ Configuration
121
+
122
+ AnonymousLoader has no global configuration. Each call is configured with
123
+ keyword arguments, so callers can choose the resolution strategy per load.
124
+
125
+ Resolution order:
126
+
127
+ 1. `path:` loads an explicit file path.
128
+ 2. `gem_name:` plus `require_path:` resolves through RubyGems metadata when the
129
+ gem is loaded or installed.
130
+ 3. `require_path:` falls back to `$LOAD_PATH` via RubyGems file discovery.
131
+
132
+ When using the `$LOAD_PATH` fallback with `version_requirement:`, pass
133
+ `version_file:` so AnonymousLoader can validate the nearby library version
134
+ before evaluating the target file. If a file is present but the discovered
135
+ version is outside the requested range, `AnonymousLoader::VersionMismatchError`
136
+ is raised. If no candidate can be resolved, `AnonymousLoader::FileNotFoundError`
137
+ is raised.
138
+
139
+ ## 🔧 Basic Usage
140
+
141
+ ```ruby
142
+ namespace = AnonymousLoader.load(files: "path/to/library.rb")
143
+ isolated = namespace.const_get(:Auth).const_get(:Sanitizer)
144
+ ```
145
+
146
+ The source's natural nesting is preserved under the anonymous namespace. A file
147
+ that declares `Auth::Sanitizer` becomes `namespace::Auth::Sanitizer`, while
148
+ `Object::Auth` remains undefined.
149
+
150
+ Files can be resolved from RubyGems metadata or from `$LOAD_PATH`:
151
+
152
+ ```ruby
153
+ namespace = AnonymousLoader.load_path(
154
+ gem_name: "auth-sanitizer",
155
+ require_path: "auth_sanitizer/loader.rb",
156
+ version_requirement: "~> 0.2",
157
+ version_file: "auth/sanitizer/version.rb"
158
+ )
159
+ ```
160
+
161
+ The `$LOAD_PATH` fallback supports Bundler standalone setups where a dependency
162
+ is loadable but absent from `Gem.loaded_specs` and `GEM_PATH`.
163
+
164
+ ## 🦷 FLOSS Funding
165
+
166
+ While ruby-oauth tools are free software and will always be, the project would benefit immensely from some funding.
167
+ Raising a monthly budget of... "dollars" would make the project more sustainable.
168
+
169
+ We welcome both individual and corporate sponsors! We also offer a
170
+ wide array of funding channels to account for your preferences.
171
+ Currently, [Open Collective][🖇osc] is our preferred funding platform.
172
+
173
+ **If you're working in a company that's making significant use of ruby-oauth tools we'd
174
+ appreciate it if you suggest to your company to become a ruby-oauth sponsor.**
175
+
176
+ You can support the development of ruby-oauth tools via
177
+ [GitHub Sponsors][🖇sponsor],
178
+ [Liberapay][⛳liberapay],
179
+ [PayPal][🖇paypal],
180
+ [Open Collective][🖇osc]
181
+ and [Tidelift][🏙️entsup-tidelift].
182
+
183
+ | 📍 NOTE |
184
+ |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
185
+ | If doing a sponsorship in the form of donation is problematic for your company <br/> from an accounting standpoint, we'd recommend the use of Tidelift, <br/> where you can get a support-like subscription instead. |
186
+
187
+ ### Open Collective for Individuals
188
+
189
+ Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/ruby-oauth#backer)]
190
+
191
+ NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
192
+
193
+ <!-- OPENCOLLECTIVE-INDIVIDUALS:START -->
194
+ No backers yet. Be the first!
195
+ <!-- OPENCOLLECTIVE-INDIVIDUALS:END -->
196
+
197
+ ### Open Collective for Organizations
198
+
199
+ Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/ruby-oauth#sponsor)]
200
+
201
+ NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
202
+
203
+ <!-- OPENCOLLECTIVE-ORGANIZATIONS:START -->
204
+ No sponsors yet. Be the first!
205
+ <!-- OPENCOLLECTIVE-ORGANIZATIONS:END -->
206
+
207
+ [kettle-readme-backers]: https://github.com/ruby-oauth/anonymous_loader/blob/main/exe/kettle-readme-backers
208
+
209
+ ### Another way to support open-source
210
+
211
+ I’m driven by a passion to foster a thriving open-source community – a space where people can tackle complex problems, no matter how small. Revitalizing libraries that have fallen into disrepair, and building new libraries focused on solving real-world challenges, are my passions. I was recently affected by layoffs, and the tech jobs market is unwelcoming. I’m reaching out here because your support would significantly aid my efforts to provide for my family, and my farm (11 🐔 chickens, 2 🐶 dogs, 3 🐰 rabbits, 8 🐈‍ cats).
212
+
213
+ If you work at a company that uses my work, please encourage them to support me as a corporate sponsor. My work on gems you use might show up in `bundle fund`.
214
+
215
+ I’m developing a new library, [floss_funding][🖇floss-funding-gem], designed to empower open-source developers like myself to get paid for the work we do, in a sustainable way. Please give it a look.
216
+
217
+ **[Floss-Funding.dev][🖇floss-funding.dev]: 👉️ No network calls. 👉️ No tracking. 👉️ No oversight. 👉️ Minimal crypto hashing. 💡 Easily disabled nags**
218
+
219
+ [![OpenCollective Backers][🖇osc-backers-i]][🖇osc-backers] [![OpenCollective Sponsors][🖇osc-sponsors-i]][🖇osc-sponsors] [![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor] [![Liberapay Goal Progress][⛳liberapay-img]][⛳liberapay] [![Donate on PayPal][🖇paypal-img]][🖇paypal] [![Buy me a coffee][🖇buyme-small-img]][🖇buyme] [![Donate on Polar][🖇polar-img]][🖇polar] [![Donate to my FLOSS efforts at ko-fi.com][🖇kofi-img]][🖇kofi] [![Donate to my FLOSS efforts using Patreon][🖇patreon-img]][🖇patreon]
220
+
221
+ ## 🔐 Security
222
+
223
+ See [SECURITY.md][🔐security].
224
+
225
+ ## 🤝 Contributing
226
+
227
+ If you need some ideas of where to help, you could work on adding more code coverage,
228
+ or if it is already 💯 (see [below](#code-coverage)) check [issues][🤝gh-issues] or [PRs][🤝gh-pulls],
229
+ or use the gem and think about how it could be better.
230
+
231
+ We [![Keep A Changelog][📗keep-changelog-img]][📗keep-changelog] so if you make changes, remember to update it.
232
+
233
+ See [CONTRIBUTING.md][🤝contributing] for more detailed instructions.
234
+
235
+ ### 🚀 Release Instructions
236
+
237
+ See [CONTRIBUTING.md][🤝contributing].
238
+
239
+ ### Code Coverage
240
+
241
+ <details markdown="1">
242
+ <summary>Coverage service badges</summary>
243
+
244
+ [![Coverage Graph][🏀codecov-g]][🏀codecov]
245
+
246
+ [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls]
247
+
248
+ [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov]
249
+
250
+ </details>
251
+
252
+ ### 🪇 Code of Conduct
253
+
254
+ Everyone interacting with this project's codebases, issue trackers,
255
+ chat rooms and mailing lists agrees to follow the [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct].
256
+
257
+ ## 🌈 Contributors
258
+
259
+ [![Contributors][🖐contributors-img]][🖐contributors]
260
+
261
+ Made with [contributors-img][🖐contrib-rocks].
262
+
263
+ Also see GitLab Contributors: [https://gitlab.com/ruby-oauth/anonymous_loader/-/graphs/main][🚎contributors-gl]
264
+
265
+ <details>
266
+ <summary>⭐️ Star History</summary>
267
+
268
+ <a href="https://star-history.com/ruby-oauth/anonymous_loader&Date">
269
+ <picture>
270
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=ruby-oauth/anonymous_loader&type=Date&theme=dark" />
271
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=ruby-oauth/anonymous_loader&type=Date" />
272
+ <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=ruby-oauth/anonymous_loader&type=Date" />
273
+ </picture>
274
+ </a>
275
+
276
+ </details>
277
+
278
+ ## 📌 Versioning
279
+
280
+ This library follows [![Semantic Versioning 2.0.0][📌semver-img]][📌semver] for its public API where practical.
281
+ For most applications, prefer the [Pessimistic Version Constraint][📌pvc] with two digits of precision.
282
+
283
+ For example:
284
+
285
+ ```ruby
286
+ spec.add_dependency("anonymous_loader", "~> 0.0")
287
+ ```
288
+
289
+ <details markdown="1">
290
+ <summary>📌 Is "Platform Support" part of the public API? More details inside.</summary>
291
+
292
+ Dropping support for a platform can be a breaking change for affected users.
293
+ If a release changes supported platforms, it should be called out clearly in the changelog and versioned with that impact in mind.
294
+
295
+ To get a better understanding of how SemVer is intended to work over a project's lifetime,
296
+ read this article from the creator of SemVer:
297
+
298
+ - ["Major Version Numbers are Not Sacred"][📌major-versions-not-sacred]
299
+
300
+ </details>
301
+
302
+ See [CHANGELOG.md][📌changelog] for a list of releases.
303
+
304
+ ## 📄 License
305
+
306
+ The gem is available as open source under the terms of
307
+ the [MIT](MIT.md) [![License: MIT][📄license-img]][📄license-ref].
308
+
309
+ ### © Copyright
310
+
311
+ See [LICENSE.md][📄license] for the official copyright notice.
312
+
313
+ <details markdown="1">
314
+ <summary>Copyright holders</summary>
315
+
316
+ - Copyright (c) 2026 Peter H. Boling
317
+
318
+ </details>
319
+
320
+ ## 🤑 A request for help
321
+
322
+ Maintainers have teeth and need to pay their dentists.
323
+ After getting laid off in an RIF in March, and encountering difficulty finding a new one,
324
+ I began spending most of my time building open source tools.
325
+ I'm hoping to be able to pay for my kids' health insurance this month,
326
+ so if you value the work I am doing, I need your support.
327
+ Please consider sponsoring me or the project.
328
+
329
+ To join the community or get help 👇️ Join the Discord.
330
+
331
+ [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
332
+
333
+ To say "thanks!" ☝️ Join the Discord or 👇️ send money.
334
+
335
+ [![Sponsor ruby-oauth/anonymous_loader on Open Source Collective][🖇osc-all-bottom-img]][🖇osc] 💌 [![Sponsor me on GitHub Sponsors][🖇sponsor-bottom-img]][🖇sponsor] 💌 [![Sponsor me on Liberapay][⛳liberapay-bottom-img]][⛳liberapay] 💌 [![Donate on PayPal][🖇paypal-bottom-img]][🖇paypal]
336
+
337
+ ### Please give the project a star ⭐ ♥.
338
+
339
+ Many parts of this project are actively managed by a [kettle-jem](https://github.com/structuredmerge/structuredmerge-ruby/tree/main/gems/kettle-jem) smart template utilizing [StructuredMerge.org](https://structuredmerge.org) merge contracts.
340
+
341
+ Thanks for RTFM. ☺️
342
+
343
+ [⛳liberapay-img]: https://img.shields.io/liberapay/goal/pboling.svg?logo=liberapay&color=a51611&style=flat
344
+ [⛳liberapay-bottom-img]: https://img.shields.io/liberapay/goal/pboling.svg?style=for-the-badge&logo=liberapay&color=a51611
345
+ [⛳liberapay]: https://liberapay.com/pboling/donate
346
+ [🖇osc-all-img]: https://img.shields.io/opencollective/all/ruby-oauth
347
+ [🖇osc-sponsors-img]: https://img.shields.io/opencollective/sponsors/ruby-oauth
348
+ [🖇osc-backers-img]: https://img.shields.io/opencollective/backers/ruby-oauth
349
+ [🖇osc-backers]: https://opencollective.com/ruby-oauth#backer
350
+ [🖇osc-backers-i]: https://opencollective.com/ruby-oauth/backers/badge.svg?style=flat
351
+ [🖇osc-sponsors]: https://opencollective.com/ruby-oauth#sponsor
352
+ [🖇osc-sponsors-i]: https://opencollective.com/ruby-oauth/sponsors/badge.svg?style=flat
353
+ [🖇osc-all-bottom-img]: https://img.shields.io/opencollective/all/ruby-oauth?style=for-the-badge
354
+ [🖇osc-sponsors-bottom-img]: https://img.shields.io/opencollective/sponsors/ruby-oauth?style=for-the-badge
355
+ [🖇osc-backers-bottom-img]: https://img.shields.io/opencollective/backers/ruby-oauth?style=for-the-badge
356
+ [🖇osc]: https://opencollective.com/ruby-oauth
357
+ [🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
358
+ [🖇sponsor-bottom-img]: https://img.shields.io/badge/Sponsor_Me!-pboling-blue?style=for-the-badge&logo=github
359
+ [🖇sponsor]: https://github.com/sponsors/pboling
360
+ [🖇polar-img]: https://img.shields.io/badge/polar-donate-a51611.svg?style=flat
361
+ [🖇polar]: https://polar.sh/pboling
362
+ [🖇kofi-img]: https://img.shields.io/badge/ko--fi-%E2%9C%93-a51611.svg?style=flat
363
+ [🖇kofi]: https://ko-fi.com/pboling
364
+ [🖇patreon-img]: https://img.shields.io/badge/patreon-donate-a51611.svg?style=flat
365
+ [🖇patreon]: https://patreon.com/galtzo
366
+ [🖇buyme-small-img]: https://img.shields.io/badge/buy_me_a_coffee-%E2%9C%93-a51611.svg?style=flat
367
+ [🖇buyme-img]: https://img.buymeacoffee.com/button-api/?text=Buy%20me%20a%20latte&emoji=&slug=pboling&button_colour=FFDD00&font_colour=000000&font_family=Cookie&outline_colour=000000&coffee_colour=ffffff
368
+ [🖇buyme]: https://www.buymeacoffee.com/pboling
369
+ [🖇paypal-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=flat&logo=paypal
370
+ [🖇paypal-bottom-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=for-the-badge&logo=paypal&color=0A0A0A
371
+ [🖇paypal]: https://www.paypal.com/paypalme/peterboling
372
+ [🖇floss-funding.dev]: https://floss-funding.dev
373
+ [🖇floss-funding-gem]: https://github.com/galtzo-floss/floss_funding
374
+ [✉️discord-invite]: https://discord.gg/3qme4XHNKN
375
+ [✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge&logo=discord
376
+ [✉️ruby-friends-img]: https://img.shields.io/badge/daily.dev-%F0%9F%92%8E_Ruby_Friends-0A0A0A?style=for-the-badge&logo=dailydotdev&logoColor=white
377
+ [✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends
378
+
379
+ [✇bundle-group-pattern]: https://gist.github.com/pboling/4564780
380
+ [⛳️gem-namespace]: https://github.com/ruby-oauth/anonymous_loader
381
+ [⛳️namespace-img]: https://img.shields.io/badge/namespace-AnonymousLoader-3C2D2D.svg?style=square&logo=ruby&logoColor=white
382
+ [⛳️gem-name]: https://bestgems.org/gems/anonymous_loader
383
+ [⛳️name-img]: https://img.shields.io/badge/name-anonymous__loader-3C2D2D.svg?style=square&logo=rubygems&logoColor=red
384
+ [⛳️tag-img]: https://img.shields.io/github/tag/ruby-oauth/anonymous_loader.svg
385
+ [⛳️tag]: https://github.com/ruby-oauth/anonymous_loader/releases
386
+ [🚂maint-blog]: http://www.railsbling.com/tags/anonymous_loader
387
+ [🚂maint-blog-img]: https://img.shields.io/badge/blog-railsbling-0093D0.svg?style=for-the-badge&logo=rubyonrails&logoColor=orange
388
+ [🚂maint-contact]: http://www.railsbling.com/contact
389
+ [🚂maint-contact-img]: https://img.shields.io/badge/Contact-Maintainer-0093D0.svg?style=flat&logo=rubyonrails&logoColor=red
390
+ [💖🖇linkedin]: http://www.linkedin.com/in/peterboling
391
+ [💖🖇linkedin-img]: https://img.shields.io/badge/LinkedIn-Profile-0B66C2?style=flat&logo=newjapanprowrestling
392
+ [💖✌️wellfound]: https://wellfound.com/u/peter-boling
393
+ [💖✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=flat&logo=wellfound
394
+ [💖💲crunchbase]: https://www.crunchbase.com/person/peter-boling
395
+ [💖💲crunchbase-img]: https://img.shields.io/badge/peter--boling-purple?style=flat&logo=crunchbase
396
+ [💖🐘ruby-mast]: https://ruby.social/@galtzo
397
+ [💖🐘ruby-mast-img]: https://img.shields.io/mastodon/follow/109447111526622197?domain=https://ruby.social&style=flat&logo=mastodon&label=Ruby%20@galtzo
398
+ [💖🦋bluesky]: https://bsky.app/profile/galtzo.com
399
+ [💖🦋bluesky-img]: https://img.shields.io/badge/@galtzo.com-0285FF?style=flat&logo=bluesky&logoColor=white
400
+ [💖🌳linktree]: https://linktr.ee/galtzo
401
+ [💖🌳linktree-img]: https://img.shields.io/badge/galtzo-purple?style=flat&logo=linktree
402
+ [💖💁🏼‍♂️devto]: https://dev.to/galtzo
403
+ [💖💁🏼‍♂️devto-img]: https://img.shields.io/badge/dev.to-0A0A0A?style=flat&logo=devdotto&logoColor=white
404
+ [💖💁🏼‍♂️aboutme]: https://about.me/peter.boling
405
+ [💖💁🏼‍♂️aboutme-img]: https://img.shields.io/badge/about.me-0A0A0A?style=flat&logo=aboutme&logoColor=white
406
+ [💖🧊berg]: https://codeberg.org/pboling
407
+ [💖🐙hub]: https://github.org/pboling
408
+ [💖🛖hut]: https://sr.ht/~galtzo/
409
+ [💖🧪lab]: https://gitlab.com/pboling
410
+ [👨🏼‍🏫expsup-upwork]: https://www.upwork.com/freelancers/~014942e9b056abdf86?mp_source=share
411
+ [👨🏼‍🏫expsup-upwork-img]: https://img.shields.io/badge/UpWork-13544E?style=for-the-badge&logo=Upwork&logoColor=white
412
+ [👨🏼‍🏫expsup-codementor]: https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github
413
+ [👨🏼‍🏫expsup-codementor-img]: https://img.shields.io/badge/CodeMentor-Get_Help-1abc9c?style=for-the-badge&logo=CodeMentor&logoColor=white
414
+ [🏙️entsup-tidelift]: https://tidelift.com/subscription/pkg/rubygems-anonymous_loader?utm_source=rubygems-anonymous_loader&utm_medium=referral&utm_campaign=readme
415
+ [🏙️entsup-tidelift-img]: https://img.shields.io/badge/Tidelift_and_Sonar-Enterprise_Support-FD3456?style=for-the-badge&logo=sonar&logoColor=white
416
+ [🏙️entsup-tidelift-sonar]: https://blog.tidelift.com/tidelift-joins-sonar
417
+ [💁🏼‍♂️peterboling]: http://www.peterboling.com
418
+ [🚂railsbling]: http://www.railsbling.com
419
+ [📜src-gl-img]: https://img.shields.io/badge/GitLab-FBA326?style=for-the-badge&logo=Gitlab&logoColor=orange
420
+ [📜src-gl]: https://gitlab.com/ruby-oauth/anonymous_loader
421
+ [📜src-cb-img]: https://img.shields.io/badge/CodeBerg-4893CC?style=for-the-badge&logo=CodeBerg&logoColor=blue
422
+ [📜src-cb]: https://codeberg.org/ruby-oauth/anonymous_loader
423
+ [📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=Github&logoColor=green
424
+ [📜src-gh]: https://github.com/ruby-oauth/anonymous_loader
425
+ [📜docs-cr-rd-img]: https://img.shields.io/badge/RubyDoc-Current_Release-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
426
+ [📜docs-head-rd-img]: https://img.shields.io/badge/YARD_on_Galtzo.com-HEAD-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
427
+ [📜gl-wiki]: https://gitlab.com/ruby-oauth/anonymous_loader/-/wikis/home
428
+ [📜gh-wiki]: https://github.com/ruby-oauth/anonymous_loader/wiki
429
+ [📜gl-wiki-img]: https://img.shields.io/badge/wiki-gitlab-943CD2.svg?style=for-the-badge&logo=gitlab&logoColor=white
430
+ [📜gh-wiki-img]: https://img.shields.io/badge/wiki-github-943CD2.svg?style=for-the-badge&logo=github&logoColor=white
431
+ [👽dl-rank]: https://bestgems.org/gems/anonymous_loader
432
+ [👽dl-ranki]: https://img.shields.io/gem/rd/anonymous_loader.svg
433
+ [👽version]: https://bestgems.org/gems/anonymous_loader
434
+ [👽versioni]: https://img.shields.io/gem/v/anonymous_loader.svg
435
+ [🏀qlty-mnt]: https://qlty.sh/gh/ruby-oauth/projects/anonymous_loader
436
+ [🏀qlty-mnti]: https://qlty.sh/gh/ruby-oauth/projects/anonymous_loader/maintainability.svg
437
+ [🏀qlty-cov]: https://qlty.sh/gh/ruby-oauth/projects/anonymous_loader/metrics/code?sort=coverageRating
438
+ [🏀qlty-covi]: https://qlty.sh/gh/ruby-oauth/projects/anonymous_loader/coverage.svg
439
+ [🏀codecov]: https://codecov.io/gh/ruby-oauth/anonymous_loader
440
+ [🏀codecovi]: https://codecov.io/gh/ruby-oauth/anonymous_loader/graph/badge.svg
441
+ [🏀coveralls]: https://coveralls.io/github/ruby-oauth/anonymous_loader?branch=main
442
+ [🏀coveralls-img]: https://coveralls.io/repos/github/ruby-oauth/anonymous_loader/badge.svg?branch=main
443
+ [🚎ruby-2.4-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/ruby-2.4.yml
444
+ [🚎ruby-2.5-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/ruby-2.5.yml
445
+ [🚎ruby-2.6-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/ruby-2.6.yml
446
+ [🚎ruby-2.7-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/ruby-2.7.yml
447
+ [🚎ruby-3.0-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/ruby-3.0.yml
448
+ [🚎ruby-3.1-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/ruby-3.1.yml
449
+ [🚎ruby-3.2-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/ruby-3.2.yml
450
+ [🚎ruby-3.3-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/ruby-3.3.yml
451
+ [🚎ruby-3.4-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/ruby-3.4.yml
452
+ [🚎jruby-9.2-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/jruby-9.2.yml
453
+ [🚎jruby-9.3-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/jruby-9.3.yml
454
+ [🚎jruby-9.4-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/jruby-9.4.yml
455
+ [🚎truby-22.3-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/truffleruby-22.3.yml
456
+ [🚎truby-23.0-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/truffleruby-23.0.yml
457
+ [🚎truby-23.1-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/truffleruby-23.1.yml
458
+ [🚎truby-24.2-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/truffleruby-24.2.yml
459
+ [🚎truby-25.0-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/truffleruby-25.0.yml
460
+ [🚎2-cov-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/coverage.yml
461
+ [🚎2-cov-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/coverage.yml/badge.svg
462
+ [🚎3-hd-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/heads.yml
463
+ [🚎3-hd-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/heads.yml/badge.svg
464
+ [🚎5-st-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/style.yml
465
+ [🚎5-st-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/style.yml/badge.svg
466
+ [🚎9-t-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/truffle.yml
467
+ [🚎9-t-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/truffle.yml/badge.svg
468
+ [🚎10-j-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/jruby.yml
469
+ [🚎10-j-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/jruby.yml/badge.svg
470
+ [🚎11-c-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/current.yml
471
+ [🚎11-c-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/current.yml/badge.svg
472
+ [🚎12-crh-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/dep-heads.yml
473
+ [🚎12-crh-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/dep-heads.yml/badge.svg
474
+ [🚎13-🔒️-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/locked_deps.yml
475
+ [🚎13-🔒️-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/locked_deps.yml/badge.svg
476
+ [🚎14-🔓️-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/unlocked_deps.yml
477
+ [🚎14-🔓️-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/unlocked_deps.yml/badge.svg
478
+ [🚎15-🪪-wf]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/license-eye.yml
479
+ [🚎15-🪪-wfi]: https://github.com/ruby-oauth/anonymous_loader/actions/workflows/license-eye.yml/badge.svg
480
+ [💎ruby-2.2i]: https://img.shields.io/badge/Ruby-2.2_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge&logo=ruby&logoColor=white
481
+ [💎ruby-2.3i]: https://img.shields.io/badge/Ruby-2.3_(%F0%9F%9A%ABCI)-AABBCC?style=for-the-badge&logo=ruby&logoColor=white
482
+ [💎ruby-2.4i]: https://img.shields.io/badge/Ruby-2.4-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
483
+ [💎ruby-2.5i]: https://img.shields.io/badge/Ruby-2.5-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
484
+ [💎ruby-2.6i]: https://img.shields.io/badge/Ruby-2.6-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
485
+ [💎ruby-2.7i]: https://img.shields.io/badge/Ruby-2.7-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
486
+ [💎ruby-3.0i]: https://img.shields.io/badge/Ruby-3.0-CC342D?style=for-the-badge&logo=ruby&logoColor=white
487
+ [💎ruby-3.1i]: https://img.shields.io/badge/Ruby-3.1-CC342D?style=for-the-badge&logo=ruby&logoColor=white
488
+ [💎ruby-3.2i]: https://img.shields.io/badge/Ruby-3.2-CC342D?style=for-the-badge&logo=ruby&logoColor=white
489
+ [💎ruby-3.3i]: https://img.shields.io/badge/Ruby-3.3-CC342D?style=for-the-badge&logo=ruby&logoColor=white
490
+ [💎ruby-3.4i]: https://img.shields.io/badge/Ruby-3.4-CC342D?style=for-the-badge&logo=ruby&logoColor=white
491
+ [💎ruby-4.0i]: https://img.shields.io/badge/Ruby-4.0-CC342D?style=for-the-badge&logo=ruby&logoColor=white
492
+ [💎ruby-c-i]: https://img.shields.io/badge/Ruby-current-CC342D?style=for-the-badge&logo=ruby&logoColor=green
493
+ [💎ruby-headi]: https://img.shields.io/badge/Ruby-HEAD-CC342D?style=for-the-badge&logo=ruby&logoColor=blue
494
+ [💎truby-22.3i]: https://img.shields.io/badge/Truffle_Ruby-22.3-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
495
+ [💎truby-23.0i]: https://img.shields.io/badge/Truffle_Ruby-23.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
496
+ [💎truby-23.1i]: https://img.shields.io/badge/Truffle_Ruby-23.1-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
497
+ [💎truby-24.2i]: https://img.shields.io/badge/Truffle_Ruby-24.2-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
498
+ [💎truby-25.0i]: https://img.shields.io/badge/Truffle_Ruby-25.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
499
+ [💎truby-c-i]: https://img.shields.io/badge/Truffle_Ruby-current-34BCB1?style=for-the-badge&logo=ruby&logoColor=green
500
+ [💎jruby-9.2i]: https://img.shields.io/badge/JRuby-9.2-FBE742?style=for-the-badge&logo=ruby&logoColor=red
501
+ [💎jruby-9.3i]: https://img.shields.io/badge/JRuby-9.3-FBE742?style=for-the-badge&logo=ruby&logoColor=red
502
+ [💎jruby-9.4i]: https://img.shields.io/badge/JRuby-9.4-FBE742?style=for-the-badge&logo=ruby&logoColor=red
503
+ [💎jruby-c-i]: https://img.shields.io/badge/JRuby-current-FBE742?style=for-the-badge&logo=ruby&logoColor=green
504
+ [💎jruby-headi]: https://img.shields.io/badge/JRuby-HEAD-FBE742?style=for-the-badge&logo=ruby&logoColor=blue
505
+ [🤝gh-issues]: https://github.com/ruby-oauth/anonymous_loader/issues
506
+ [🤝gh-pulls]: https://github.com/ruby-oauth/anonymous_loader/pulls
507
+ [🤝gl-issues]: https://gitlab.com/ruby-oauth/anonymous_loader/-/issues
508
+ [🤝gl-pulls]: https://gitlab.com/ruby-oauth/anonymous_loader/-/merge_requests
509
+ [🤝cb-issues]: https://codeberg.org/ruby-oauth/anonymous_loader/issues
510
+ [🤝cb-pulls]: https://codeberg.org/ruby-oauth/anonymous_loader/pulls
511
+ [🤝cb-donate]: https://donate.codeberg.org/
512
+ [🤝contributing]: https://github.com/ruby-oauth/anonymous_loader/blob/main/CONTRIBUTING.md
513
+ [🏀codecov-g]: https://codecov.io/gh/ruby-oauth/anonymous_loader/graph/badge.svg
514
+ [🖐contrib-rocks]: https://contrib.rocks
515
+ [🖐contributors]: https://github.com/ruby-oauth/anonymous_loader/graphs/contributors
516
+ [🖐contributors-img]: https://contrib.rocks/image?repo=ruby-oauth/anonymous_loader
517
+ [🚎contributors-gl]: https://gitlab.com/ruby-oauth/anonymous_loader/-/graphs/main
518
+ [🪇conduct]: https://github.com/ruby-oauth/anonymous_loader/blob/main/CODE_OF_CONDUCT.md
519
+ [🪇conduct-img]: https://img.shields.io/badge/Contributor_Covenant-2.1-259D6C.svg
520
+ [📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
521
+ [📌semver]: https://semver.org/spec/v2.0.0.html
522
+ [📌semver-img]: https://img.shields.io/badge/semver-2.0.0-259D6C.svg?style=flat
523
+ [📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139
524
+ [📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
525
+ [📌changelog]: https://github.com/ruby-oauth/anonymous_loader/blob/main/CHANGELOG.md
526
+ [📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
527
+ [📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat
528
+ [📌gitmoji]: https://gitmoji.dev
529
+ [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
530
+ [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
531
+ [🧮kloc-img]: https://img.shields.io/badge/KLOC-0.109-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
532
+ [🔐security]: https://github.com/ruby-oauth/anonymous_loader/blob/main/SECURITY.md
533
+ [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
534
+ [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
535
+ [📄license]: LICENSE.md
536
+ [📄license-ref]: MIT.md
537
+ [📄license-img]: https://img.shields.io/badge/License-MIT-259D6C.svg
538
+ [📄license-compat]: https://www.apache.org/legal/resolved.html#category-a
539
+ [📄license-compat-img]: https://img.shields.io/badge/Apache_Compatible:_Category_A-%E2%9C%93-259D6C.svg?style=flat&logo=Apache
540
+
541
+ [📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm
542
+ [📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat
543
+ [🚎yard-current]: http://rubydoc.info/gems/anonymous_loader
544
+ [🚎yard-head]: https://anonymous-loader.galtzo.com
545
+ [💎stone_checksums]: https://github.com/galtzo-floss/stone_checksums
546
+ [💎SHA_checksums]: https://gitlab.com/ruby-oauth/anonymous_loader/-/tree/main/checksums
547
+ [💎rlts]: https://github.com/rubocop-lts/rubocop-lts
548
+ [💎rlts-img]: https://img.shields.io/badge/code_style_&_linting-rubocop--lts-34495e.svg?plastic&logo=ruby&logoColor=white
549
+ [💎appraisal2]: https://github.com/appraisal-rb/appraisal2
550
+ [💎appraisal2-img]: https://img.shields.io/badge/appraised_by-appraisal2-34495e.svg?plastic&logo=ruby&logoColor=white
551
+ [💎d-in-dvcs]: https://railsbling.com/posts/dvcs/put_the_d_in_dvcs/
552
+
553
+ <!-- kettle-jem:metadata:start -->
554
+ | Field | Value |
555
+ |---|---|
556
+ | Package | anonymous_loader |
557
+ | Description | 💎 AnonymousLoader resolves Ruby files from paths, gem metadata, or $LOAD_PATH and evaluates them inside anonymous modules to avoid top-level namespace collisions. |
558
+ | Homepage | https://github.com/ruby-oauth/anonymous_loader |
559
+ | Source | https://github.com/ruby-oauth/anonymous_loader |
560
+ | License | `MIT` |
561
+ | Funding | https://github.com/sponsors/pboling, https://issuehunt.io/u/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/ruby-oauth, https://patreon.com/galtzo, https://polar.sh/pboling, https://thanks.dev/u/gh/pboling, https://tidelift.com/funding/github/rubygems/anonymous_loader, https://www.buymeacoffee.com/pboling |
562
+ <!-- kettle-jem:metadata:end -->
data/RUBOCOP.md ADDED
@@ -0,0 +1,71 @@
1
+ # RuboCop Usage Guide
2
+
3
+ ## Overview
4
+
5
+ A tale of two RuboCop plugin gems.
6
+
7
+ ### RuboCop Gradual
8
+
9
+ This project uses `rubocop_gradual` instead of vanilla RuboCop for code style checking. The `rubocop_gradual` tool allows for gradual adoption of RuboCop rules by tracking violations in a lock file.
10
+
11
+ ### RuboCop LTS
12
+
13
+ This project uses `rubocop-lts` to ensure, on a best-effort basis, compatibility with Ruby >= 1.9.2.
14
+ RuboCop rules are meticulously configured by the `rubocop-lts` family of gems to ensure that a project is compatible with a specific version of Ruby. See: https://rubocop-lts.gitlab.io for more.
15
+
16
+ ## Checking RuboCop Violations
17
+
18
+ To check for RuboCop violations in this project, always use:
19
+
20
+ ```bash
21
+ bundle exec rake rubocop_gradual:check
22
+ ```
23
+
24
+ **Do not use** the standard RuboCop commands like:
25
+ - `bundle exec rubocop`
26
+ - `rubocop`
27
+
28
+ ## Understanding the Lock File
29
+
30
+ The `.rubocop_gradual.lock` file tracks all current RuboCop violations in the project. This allows the team to:
31
+
32
+ 1. Prevent new violations while gradually fixing existing ones
33
+ 2. Track progress on code style improvements
34
+ 3. Ensure CI builds don't fail due to pre-existing violations
35
+
36
+ ## Common Commands
37
+
38
+ - **Check violations**
39
+ - `bundle exec rake rubocop_gradual`
40
+ - `bundle exec rake rubocop_gradual:check`
41
+ - **(Safe) Autocorrect violations, and update lockfile if no new violations**
42
+ - `bundle exec rake rubocop_gradual:autocorrect`
43
+ - **Force update the lock file (w/o autocorrect) to match violations present in code**
44
+ - `bundle exec rake rubocop_gradual:force_update`
45
+
46
+ ## Workflow
47
+
48
+ 1. Before submitting a PR, run `bundle exec rake rubocop_gradual:autocorrect`
49
+ a. or just the default `bundle exec rake`, as autocorrection is a pre-requisite of the default task.
50
+ 2. If there are new violations, either:
51
+ - Fix them in your code
52
+ - Run `bundle exec rake rubocop_gradual:force_update` to update the lock file (only for violations you can't fix immediately)
53
+ 3. Commit the updated `.rubocop_gradual.lock` file along with your changes
54
+
55
+ ## Never add inline RuboCop disables
56
+
57
+ Do not add inline `rubocop:disable` / `rubocop:enable` comments anywhere in the codebase (including specs, except when following the few existing `rubocop:disable` patterns for a rule already being disabled elsewhere in the code). We handle exceptions in two supported ways:
58
+
59
+ - Permanent/structural exceptions: prefer adjusting the RuboCop configuration (e.g., in `.rubocop.yml`) to exclude a rule for a path or file pattern when it makes sense project-wide.
60
+ - Temporary exceptions while improving code: record the current violations in `.rubocop_gradual.lock` via the gradual workflow:
61
+ - `bundle exec rake rubocop_gradual:autocorrect` (preferred; will autocorrect what it can and update the lock only if no new violations were introduced)
62
+ - If needed, `bundle exec rake rubocop_gradual:force_update` (as a last resort when you cannot fix the newly reported violations immediately)
63
+
64
+ In general, treat the rules as guidance to follow; fix violations rather than ignore them. For example, RSpec conventions in this project expect `described_class` to be used in specs that target a specific class under test.
65
+
66
+ ## Benefits of rubocop_gradual
67
+
68
+ - Allows incremental adoption of code style rules
69
+ - Prevents CI failures due to pre-existing violations
70
+ - Provides a clear record of code style debt
71
+ - Enables focused efforts on improving code quality over time