active_security 1.0.1 → 1.0.2

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 CHANGED
@@ -1,425 +1,250 @@
1
- # ActiveSecurity
1
+ <a href="https://github.com/galtzo-floss"><img alt="galtzo-floss Logo by GitHub" src="https://github.com/galtzo-floss.png?size=192" width="14%" align="right"/></a>
2
2
 
3
- <div id="badges">
3
+ # 🔒 ActiveSecurity
4
4
 
5
- [![CI Build][🚎dl-cwfi]][🚎dl-cwf]
6
- [![Test Coverage][🔑cc-covi]][🔑cc-cov]
7
- [![Maintainability][🔑cc-mnti]][🔑cc-mnt]
8
- [![Depfu][🔑depfui]][🔑depfu]
5
+ [![Version][👽versioni]][👽version] [![Ruby Users Forum][✉️ruby-forum-top-img]][✉️ruby-forum] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: MIT][📄license-img]][📄license] [![Total downloads][👽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]
9
6
 
10
- [🚎dl-cwf]: https://github.com/pboling/active_security/actions/workflows/supported.yml
11
- [🚎dl-cwfi]: https://github.com/pboling/active_security/actions/workflows/supported.yml/badge.svg
7
+ `if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know on Discord][✉️discord-invite] or [RubyForum][✉️ruby-forum], as I may have missed the notification.
12
8
 
13
- [comment]: <> ( 🔑 KEYED LINKS )
9
+ ---
14
10
 
15
- [🔑cc-mnt]: https://codeclimate.com/github/pboling/active_security/maintainability
16
- [🔑cc-mnti]: https://api.codeclimate.com/v1/badges/a6280f7e5533aed38d05/maintainability
17
- [🔑cc-cov]: https://codeclimate.com/github/pboling/active_security/test_coverage
18
- [🔑cc-covi]: https://api.codeclimate.com/v1/badges/a6280f7e5533aed38d05/test_coverage
19
- [🔑depfu]: https://depfu.com/github/pboling/active_security?project_id=41757
20
- [🔑depfui]: https://badges.depfu.com/badges/88e0dac6be89feaa9bd6bb0dd12b3e3a/count.svg
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.
21
12
 
22
- -----
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 at ko-fi.com][🖇kofi-img]][🖇kofi]
23
14
 
24
- [![Liberapay Patrons][⛳liberapay-img]][⛳liberapay]
25
- [![Sponsor Me on Github][🖇sponsor-img]][🖇sponsor]
15
+ <details markdown="1">
16
+ <summary>👣 How will this project approach the September 2025 hostile takeover of RubyGems? 🚑️</summary>
26
17
 
27
- <span class="badge-buymeacoffee">
28
- <a href="https://ko-fi.com/O5O86SNP4" target='_blank' title="Donate to my FLOSS or refugee efforts at ko-fi.com"><img src="https://img.shields.io/badge/buy%20me%20coffee-donate-yellow.svg" alt="Buy me coffee donation button" /></a>
29
- </span>
30
- <span class="badge-patreon">
31
- <a href="https://patreon.com/galtzo" title="Donate to my FLOSS or refugee efforts using Patreon"><img src="https://img.shields.io/badge/patreon-donate-yellow.svg" alt="Patreon donate button" /></a>
32
- </span>
18
+ I've summarized my thoughts in [this blog post](https://dev.to/galtzo/hostile-takeover-of-rubygems-my-thoughts-5hlo).
33
19
 
34
- </div>
20
+ </details>
35
21
 
36
- [⛳liberapay-img]: https://img.shields.io/liberapay/patrons/pboling.svg?logo=liberapay
37
- [⛳liberapay]: https://liberapay.com/pboling/donate
38
- [🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
39
- [🖇sponsor]: https://github.com/sponsors/pboling
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>
40
23
 
41
- ## Compatibility
42
-
43
- * ⚙️ Ruby >= 2.7, plus JRuby and Truffleruby, but only non-EOL Rubies are officially supported
44
- * ⚙️ Rails >= 7.0 (actually, it only requires `activerecord`)
45
-
46
- <!--
47
- Numbering rows and badges in each row as a visual "database" lookup,
48
- as the table is extremely dense, and it can be very difficult to find anything
49
- Putting one on each row here, to document the emoji that should be used, and for ease of copy/paste.
50
-
51
- row #s:
52
- 1️⃣
53
- 2️⃣
54
- 3️⃣
55
- 4️⃣
56
- 5️⃣
57
- 6️⃣
58
- 7️⃣
59
-
60
- badge #s:
61
- ⛳️
62
- 🖇
63
- 🏘
64
- 🚎
65
- 🖐
66
- 🧮
67
- 📗
68
-
69
- appended indicators:
70
- ♻️ / 🔑 - Tagged URLs need to be updated from SAAS integration. Find / Replace is insufficient.
71
- -->
72
-
73
- | | Project | bundle add active_security |
74
- |:----|--------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
75
- | 1️⃣ | name, license, docs, standards | [![RubyGems.org][⛳️name-img]][⛳️gem] [![License: MIT][🖇src-license-img]][🖇src-license] [![RubyDoc.info][🚎yard-img]][🚎yard] [![YARD Documentation](http://inch-ci.org/github/pboling/active_security.svg)][🚎yard] [![SemVer 2.0.0][🧮semver-img]][🧮semver] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog] |
76
- | 2️⃣ | version & activity | [![Gem Version][⛳️version-img]][⛳️gem] [![Total Downloads][🖇DL-total-img]][⛳️gem] [![Download Rank][🏘DL-rank-img]][⛳️gem] [![Source Code][🚎src-main-img]][🚎src-main] [![Open PRs][🖐prs-o-img]][🖐prs-o] [![Closed PRs][🧮prs-c-img]][🧮prs-c] |
77
- | 3️⃣ | maintenance & linting | [![Maintainability][🔑cc-mnti]][🔑cc-mnt] [![Helpers][🖇triage-help-img]][🖇triage-help] [![Depfu][🔑depfui]][🔑depfu] [![Contributors][🚎contributors-img]][🚎contributors] [![Style][🖐style-wf-img]][🖐style-wf] |
78
- | 4️⃣ | testing | [![Supported][🏘sup-wf-img]][🏘sup-wf] [![Heads][🚎heads-wf-img]][🚎heads-wf] [![Unsupported][🖐uns-wf-img]][🖐uns-wf] |
79
- | 5️⃣ | coverage & security | [![CodeClimate][🔑cc-covi]][🔑cc-cov] [![CodeCov][🖇codecov-img♻️]][🖇codecov] [![Coveralls][🏘coveralls-img]][🏘coveralls] [![Security Policy][🚎sec-pol-img]][🚎sec-pol] [![CodeQL][🖐codeQL-img]][🖐codeQL] [![Code Coverage][🧮cov-wf-img]][🧮cov-wf] |
80
- | 6️⃣ | resources | [![Get help on Codementor][🖇codementor-img]][🖇codementor] [![Blog][🚎blog-img]][🚎blog] [![Wiki][🖐wiki-img]][🖐wiki] |
81
- | 7️⃣ | `...` 💖 | [![Liberapay Patrons][⛳liberapay-img]][⛳liberapay] [![Sponsor Me][🖇sponsor-img]][🖇sponsor] [![Follow Me on LinkedIn][🖇linkedin-img]][🖇linkedin] [![Find Me on WellFound:][✌️wellfound-img]][✌️wellfound] [![Find Me on CrunchBase][💲crunchbase-img]][💲crunchbase] [![My LinkTree][🌳linktree-img]][🌳linktree] [![Follow Me on Ruby.Social][🐘ruby-mast-img]][🐘ruby-mast] [![Tweet @ Peter][🐦tweet-img]][🐦tweet] [💻][coderme] [🌏][aboutme] |
82
-
83
- <!--
84
- The link tokens in the following sections should be kept ordered by the row and badge numbering scheme
85
- -->
86
-
87
- <!-- 1️⃣ name, license, docs -->
88
- [⛳️gem]: https://rubygems.org/gems/active_security
89
- [⛳️name-img]: https://img.shields.io/badge/name-sanitize__email-brightgreen.svg?style=flat
90
- [🖇src-license]: https://opensource.org/licenses/MIT
91
- [🖇src-license-img]: https://img.shields.io/badge/License-MIT-green.svg
92
- [🚎yard]: https://www.rubydoc.info/gems/active_security
93
- [🚎yard-img]: https://img.shields.io/badge/documentation-rubydoc-brightgreen.svg?style=flat
94
- [🧮semver]: http://semver.org/
95
- [🧮semver-img]: https://img.shields.io/badge/semver-2.0.0-FFDD67.svg?style=flat
96
- [📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
97
- [📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-FFDD67.svg?style=flat
98
-
99
- <!-- 2️⃣ version & activity -->
100
- [⛳️version-img]: http://img.shields.io/gem/v/active_security.svg
101
- [🖇DL-total-img]: https://img.shields.io/gem/dt/active_security.svg
102
- [🏘DL-rank-img]: https://img.shields.io/gem/rt/active_security.svg
103
- [🚎src-main]: https://gitlab.com/pboling/active_security
104
- [🚎src-main-img]: https://img.shields.io/badge/source-gitlab-brightgreen.svg?style=flat
105
- [🖐prs-o]: https://gitlab.com/pboling/active_security/-/merge_requests
106
- [🖐prs-o-img]: https://img.shields.io/github/issues-pr/pboling/active_security
107
- [🧮prs-c]: https://github.com/pboling/active_security/pulls?q=is%3Apr+is%3Aclosed
108
- [🧮prs-c-img]: https://img.shields.io/github/issues-pr-closed/pboling/active_security
109
-
110
- <!-- 3️⃣ maintenance & linting -->
111
- [🖇triage-help]: https://www.codetriage.com/pboling/active_security
112
- [🖇triage-help-img]: https://www.codetriage.com/pboling/active_security/badges/users.svg
113
- [🚎contributors]: https://gitlab.com/pboling/active_security/-/graphs/main
114
- [🚎contributors-img]: https://img.shields.io/github/contributors-anon/pboling/active_security
115
- [🖐style-wf]: https://github.com/pboling/active_security/actions/workflows/style.yml
116
- [🖐style-wf-img]: https://github.com/pboling/active_security/actions/workflows/style.yml/badge.svg
117
- <!-- TODO: tokei/lines shields badge is broken -->
118
- [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
119
- [🧮kloc-img]: https://img.shields.io/tokei/lines/github.com/pboling/active_security
120
-
121
- <!-- 4️⃣ testing -->
122
- [🏘sup-wf]: https://github.com/pboling/active_security/actions/workflows/supported.yml
123
- [🏘sup-wf-img]: https://github.com/pboling/active_security/actions/workflows/supported.yml/badge.svg
124
- [🚎heads-wf]: https://github.com/pboling/active_security/actions/workflows/heads.yml
125
- [🚎heads-wf-img]: https://github.com/pboling/active_security/actions/workflows/heads.yml/badge.svg
126
- [🖐uns-wf]: https://github.com/pboling/active_security/actions/workflows/unsupported.yml
127
- [🖐uns-wf-img]: https://github.com/pboling/active_security/actions/workflows/unsupported.yml/badge.svg
128
-
129
- <!-- 5️⃣ coverage & security -->
130
- [🖇codecov-img♻️]: https://codecov.io/gh/pboling/active_security/graph/badge.svg?token=Joire8DbSW
131
- [🖇codecov]: https://codecov.io/gh/pboling/active_security
132
- [🏘coveralls]: https://coveralls.io/github/pboling/active_security?branch=main
133
- [🏘coveralls-img]: https://coveralls.io/repos/github/pboling/active_security/badge.svg?branch=main
134
- [🚎sec-pol]: https://gitlab.com/pboling/active_security/-/blob/main/SECURITY.md
135
- [🚎sec-pol-img]: https://img.shields.io/badge/security-policy-brightgreen.svg?style=flat
136
- [🖐codeQL]: https://github.com/pboling/active_security/security/code-scanning
137
- [🖐codeQL-img]: https://github.com/pboling/active_security/actions/workflows/codeql-analysis.yml/badge.svg
138
- [🧮cov-wf]: https://github.com/pboling/active_security/actions/workflows/coverage.yml
139
- [🧮cov-wf-img]: https://github.com/pboling/active_security/actions/workflows/coverage.yml/badge.svg
140
-
141
- <!-- 6️⃣ resources -->
142
- [🖇codementor]: https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github
143
- [🖇codementor-img]: https://cdn.codementor.io/badges/get_help_github.svg
144
- [🚎blog]: http://www.railsbling.com/tags/active_security/
145
- [🚎blog-img]: https://img.shields.io/badge/blog-railsbling-brightgreen.svg?style=flat
146
- [🖐wiki]: https://gitlab.com/pboling/active_security/-/wikis/home
147
- [🖐wiki-img]: https://img.shields.io/badge/wiki-examples-brightgreen.svg?style=flat
148
-
149
- <!-- 7️⃣ spread 💖 -->
150
- [🐦tweet-img]: https://img.shields.io/twitter/follow/galtzo.svg?style=social&label=Follow%20%40galtzo
151
- [🐦tweet]: http://twitter.com/galtzo
152
- [🚎blog]: http://www.railsbling.com/tags/debug_logging/
153
- [🚎blog-img]: https://img.shields.io/badge/blog-railsbling-brightgreen.svg?style=flat
154
- [🖇linkedin]: http://www.linkedin.com/in/peterboling
155
- [🖇linkedin-img]: https://img.shields.io/badge/PeterBoling-blue?style=plastic&logo=linkedin
156
- [✌️wellfound]: https://angel.co/u/peter-boling
157
- [✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=plastic&logo=wellfound
158
- [💲crunchbase]: https://www.crunchbase.com/person/peter-boling
159
- [💲crunchbase-img]: https://img.shields.io/badge/peter--boling-purple?style=plastic&logo=crunchbase
160
- [🐘ruby-mast]: https://ruby.social/@galtzo
161
- [🐘ruby-mast-img]: https://img.shields.io/mastodon/follow/109447111526622197?domain=https%3A%2F%2Fruby.social&style=plastic&logo=mastodon&label=Ruby%20%40galtzo
162
- [🐘floss-mast]: https://floss.social/@galtzo
163
- [🐘floss-mast-img]: https://img.shields.io/mastodon/follow/110304921404405715?domain=https%3A%2F%2Ffloss.social&style=plastic&logo=mastodon&label=FLOSS%20%40galtzo
164
- [🐘mast]: https://mastodon.social/@galtzo
165
- [🐘mast-img]: https://img.shields.io/mastodon/follow/000924127?domain=https%3A%2F%2Fmastodon.social&style=plastic&logo=mastodon&label=Mastodon%20%40galtzo
166
- [🌳linktree]: https://linktr.ee/galtzo
167
- [🌳linktree-img]: https://img.shields.io/badge/galtzo-purple?style=plastic&logo=linktree
168
-
169
- <!-- Maintainer Contact Links -->
170
- [aboutme]: https://about.me/peter.boling
171
- [coderme]: https://coderwall.com/Peter%20Boling
172
-
173
- ## Installation
24
+ ActiveSecurity extends ActiveRecord models with configurable protections against
25
+ unscoped finds and unhandled query predicates. It can also enforce that records
26
+ are reached through an owning scope, such as a tenant or account association.
174
27
 
175
- Install the gem and add to the application's Gemfile by executing:
28
+ ## 💡 Info you can shake a stick at
176
29
 
177
- $ bundle add active_security
30
+ | Tokens to Remember | [![Gem name][⛳️name-img]][⛳️gem-name] [![Gem namespace][⛳️namespace-img]][⛳️gem-namespace] |
31
+ |-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
32
+ | Works with JRuby | [![JRuby 10.0 Compat][💎jruby-10.0i]][🚎jruby-10.0-wf] [![JRuby current Compat][💎jruby-c-i]][🚎10-j-wf] [![JRuby HEAD Compat][💎jruby-headi]][🚎3-hd-wf]|
33
+ | Works with Truffle Ruby | [![Truffle Ruby 33.0 Compat][💎truby-33.0i]][🚎truby-33.0-wf] [![Truffle Ruby current Compat][💎truby-c-i]][🚎9-t-wf]|
34
+ | Works with MRI Ruby 4 | [![Ruby current Compat][💎ruby-c-i]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf]|
35
+ | 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]|
36
+ | Works with MRI Ruby 2 | [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎ruby-2.7-wf]|
37
+ | Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Get help from RubyForum][✉️ruby-forum-img]][✉️ruby-forum] [![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] |
38
+ | 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] |
39
+ | 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] |
40
+ | 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] |
41
+ | 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] |
42
+ | 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] |
43
+ | `...` 💖 | [![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] |
178
44
 
179
- If bundler is not being used to manage dependencies, install the gem by executing:
45
+ ### Compatibility
180
46
 
181
- $ gem install active_security
47
+ The gem's declared runtime compatibility floor is MRI Ruby 2.7.0+, with concordant releases of JRuby and TruffleRuby.
48
+ CI workflows and Appraisals are generated for MRI Ruby 2.7.0+.
49
+ The current MRI CI lane runs on Linux and macOS.
50
+ The test floor is configured by `ruby.test_minimum` in `.kettle-jem.yml`.
51
+ When it is higher than the runtime floor, older runtime-compatible Rubies are
52
+ not covered by the generated CI or Appraisal matrix.
182
53
 
183
- ## Documentation
54
+ <a href="https://github.com/kettle-dev"><img alt="kettle-dev Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/kettle-dev/avatar-128px.svg" width="14%" align="right"/></a>
184
55
 
185
- All documentation is in the source so check there if the following is not enough.
56
+ The _amazing_ test matrix is powered by the kettle-dev stack.
186
57
 
187
- ### Setting Up ActiveSecurity in Your Model
58
+ <details markdown="1">
59
+ <summary>How kettle-dev manages complexity in tests</summary>
188
60
 
189
- To use ActiveSecurity in your ActiveRecord models, you must first either extend or
190
- include the ActiveSecurity module (it makes no difference), then invoke the
191
- {ActiveSecurity::Base#active_security active_security} method to configure your desired
192
- options:
61
+ | Gem | Source | Role | Total downloads |
62
+ |-----|--------|------|---------------------|
63
+ | [appraisal2](https://clickgems.clickhouse.com/dashboard/appraisal2) | [GitHub](https://github.com/appraisal-rb/appraisal2) | multi-dependency Appraisal matrix generation | [![Total downloads for appraisal2](https://img.shields.io/gem/dt/appraisal2.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/appraisal2) |
64
+ | [appraisal2-rubocop](https://clickgems.clickhouse.com/dashboard/appraisal2-rubocop) | [GitHub](https://github.com/appraisal-rb/appraisal2-rubocop) | RuboCop Appraisal generator integration | [![Total downloads for appraisal2-rubocop](https://img.shields.io/gem/dt/appraisal2-rubocop.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/appraisal2-rubocop) |
65
+ | [kettle-dev](https://clickgems.clickhouse.com/dashboard/kettle-dev) | [GitHub](https://github.com/kettle-dev/kettle-dev) | development, release, and CI workflow tooling | [![Total downloads for kettle-dev](https://img.shields.io/gem/dt/kettle-dev.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-dev) |
66
+ | [kettle-jem](https://clickgems.clickhouse.com/dashboard/kettle-jem) | [GitHub](https://github.com/kettle-dev/kettle-jem) | Appraisals & CI workflow templates | [![Total downloads for kettle-jem](https://img.shields.io/gem/dt/kettle-jem.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-jem) |
67
+ | [kettle-soup-cover](https://clickgems.clickhouse.com/dashboard/kettle-soup-cover) | [GitHub](https://github.com/kettle-dev/kettle-soup-cover) | SimpleCov coverage policy and reporting | [![Total downloads for kettle-soup-cover](https://img.shields.io/gem/dt/kettle-soup-cover.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-soup-cover) |
68
+ | [kettle-test](https://clickgems.clickhouse.com/dashboard/kettle-test) | [GitHub](https://github.com/kettle-dev/kettle-test) | standard test runner and coverage harness | [![Total downloads for kettle-test](https://img.shields.io/gem/dt/kettle-test.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/kettle-test) |
69
+ | [rubocop-lts](https://clickgems.clickhouse.com/dashboard/rubocop-lts) | [GitHub](https://github.com/rubocop-lts/rubocop-lts) | Ruby-version-aware linting | [![Total downloads for rubocop-lts](https://img.shields.io/gem/dt/rubocop-lts.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/rubocop-lts) |
70
+ | [turbo_tests2](https://clickgems.clickhouse.com/dashboard/turbo_tests2) | [GitHub](https://github.com/galtzo-floss/turbo_tests2) | parallel test execution | [![Total downloads for turbo_tests2](https://img.shields.io/gem/dt/turbo_tests2.svg?style=flat-square)](https://clickgems.clickhouse.com/dashboard/turbo_tests2) |
193
71
 
194
- ```ruby
195
- class Foo < ActiveRecord::Base
196
- include ActiveSecurity
197
- active_security :use => {finders: {default_finders: :restricted}, scoped: {scope: :bar_id}}
198
- end
199
- ```
72
+ </details>
200
73
 
201
- The most important option is `:use`, which you use to tell ActiveSecurity which
202
- addons it should use. See the documentation for {ActiveSecurity::Base#active_security} for a list of all
203
- available addons, or skim through the rest of the docs to get a high-level
204
- overview.
74
+ ### Federated DVCS
205
75
 
206
- *A note about single table inheritance (STI): you must extend ActiveSecurity in*
207
- *all classes that participate in STI, both your parent classes and their*
208
- *children.*
76
+ <details markdown="1">
77
+ <summary>Find this repo on federated forges (Coming soon!)</summary>
209
78
 
210
- #### The Basic Setup: Simple Models
79
+ | Federated [DVCS][💎d-in-dvcs] Repository | Status | Issues | PRs | Wiki | CI |
80
+ |-------------------------------------------------|-------------------------------------------|-------------------|------------------|-----------------|----------------|
81
+ | 🧪 [galtzo-floss/active_security on GitLab][📜src-gl] | The Truth | [💚][🤝gl-issues] | [💚][🤝gl-pulls] | [💚][📜gl-wiki] | 🐭 Tiny Matrix |
82
+ | 🧊 [galtzo-floss/active_security on CodeBerg][📜src-cb] | An Ethical Mirror ([Donate][🤝cb-donate]) | [💚][🤝cb-issues] | [💚][🤝cb-pulls] | ➖ | ⭕️ No Matrix |
83
+ | 🐙 [galtzo-floss/active_security on GitHub][📜src-gh] | Another Mirror | [💚][🤝gh-issues] | [💚][🤝gh-pulls] | [💚][📜gh-wiki] | 💯 Full Matrix |
211
84
 
212
- By default the `:restricted` plugin is the only one configured, and the `restricted`
213
- scope must be explicitly added to every query.
214
- This is the simplest way to use ActiveSecurity. But it is messy, and laborious.
215
- It will ensure that finds are executed within a `where` scope:
85
+ </details>
216
86
 
217
- ```ruby
218
- class User < ActiveRecord::Base
219
- extend ActiveSecurity
220
- end
87
+ ### Enterprise Support
221
88
 
222
- User.restricted.find(1) # blows up, because no scope
223
- User.where(name: "Bart").restricted.find(1) # returns the user
224
- ```
89
+ For enterprise support from the maintainer, use [Upwork][👨🏼‍🏫expsup-upwork] or [CodeMentor][👨🏼‍🏫expsup-codementor].
225
90
 
226
- #### The Strict Setup: Magic Finders
91
+ Other support channels:
227
92
 
228
- The problem with the above approach is that a naked find (`User.find(1)`)
229
- still works, and is just as insecure as before. The `:finders` plugin fixes
230
- this problem, so you don't need to add `restricted` everywhere.
93
+ - [![Ruby Users Forum][✉️ruby-forum-img]][✉️ruby-forum]
94
+ - [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
231
95
 
232
- ```ruby
233
- class User < ActiveRecord::Base
234
- extend ActiveSecurity
235
- active_security use: {finders: {default_finders: :restricted}}
236
- end
96
+ ## ✨ Installation
237
97
 
238
- User.find(1) # blows up, because no scope
239
- User.where(name: "Bart").find(1) # returns the user
240
- User.where(name: "Bart").restricted.find(1) # also returns the user
241
- ```
98
+ Install the gem and add to the application's Gemfile by executing:
242
99
 
243
- ### Configuration: ActiveSecurity's behavior in a model
100
+ ```console
101
+ bundle add active_security
102
+ ```
244
103
 
245
- Here's a basic config.
104
+ If bundler is not being used to manage dependencies, install the gem by executing:
246
105
 
247
- ```ruby
248
- class Post < ActiveRecord::Base
249
- extend ActiveSecurity
250
- active_security use: :finders
251
- end
106
+ ```console
107
+ gem install active_security
252
108
  ```
253
109
 
254
- Now let's get crazy secure!
110
+ ## ⚙️ Configuration
255
111
 
256
- When given the optional block, this method will yield the class's instance
257
- of {ActiveSecurity::Configuration} to the block before evaluating other
258
- arguments, so configuration values set in the block may be overwritten by
259
- the arguments. This order was chosen to allow passing the same proc to
260
- multiple models, while being able to override the values it sets. Here is
261
- a contrived example:
112
+ ActiveSecurity is configured per model with `active_security`. The default is the
113
+ `:restricted` feature; additional features include `:privileged`, `:finders`, and
114
+ `:scoped`. Use `ActiveSecurity.defaults` to establish defaults for every model,
115
+ then override them on individual models when necessary.
262
116
 
263
- ```ruby
264
- $active_security_config_proc = Proc.new do |config|
265
- config.use :finders
266
- end
117
+ ## 🔧 Basic Usage
267
118
 
268
- class Foo < ActiveRecord::Base
119
+ Include the module in an ActiveRecord model and select the protections it needs:
120
+
121
+ ```ruby
122
+ class Restaurant < ActiveRecord::Base
269
123
  extend ActiveSecurity
270
- active_security &$active_security_config_proc
124
+ belongs_to :city
125
+
126
+ active_security use: :scoped, scope: :city
271
127
  end
272
128
 
273
- class Bar < ActiveRecord::Base
274
- extend ActiveSecurity
275
- active_security &$active_security_config_proc
129
+ class City < ActiveRecord::Base
130
+ has_many :restaurants
276
131
  end
132
+
133
+ city.restaurants.restricted.find(params[:id])
277
134
  ```
278
135
 
279
- However, it's usually better to use {ActiveSecurity.defaults} for this:
136
+ For applications that want the finder protections on every model, configure the
137
+ defaults once during application boot:
280
138
 
281
139
  ```ruby
282
140
  ActiveSecurity.defaults do |config|
283
- config.use :finders, default_finders: :restricted
141
+ config.use :restricted, :finders
284
142
  end
143
+ ```
285
144
 
286
- class Foo < ActiveRecord::Base
287
- extend ActiveSecurity
288
- end
145
+ ## 🦷 FLOSS Funding
289
146
 
290
- class Bar < ActiveRecord::Base
291
- extend ActiveSecurity
292
- end
293
- ```
147
+ While galtzo-floss tools are free software and will always be, the project would benefit immensely from some funding.
148
+ Raising a monthly budget of... "dollars" would make the project more sustainable.
294
149
 
295
- In general you should use the block syntax either because of your personal
296
- aesthetic preference, or because you need to share some functionality
297
- between multiple models that can't be well encapsulated by
298
- {ActiveSecurity.defaults}.
150
+ We welcome both individual and corporate sponsors! We also offer a
151
+ wide array of funding channels to account for your preferences.
152
+ Currently, [Open Collective][🖇osc] is our preferred funding platform.
299
153
 
300
- ### Order Method Calls in a Block vs Ordering Options
154
+ ### Corporate Sponsorship
301
155
 
302
- When calling this method without a block, you may set the hash options in
303
- any order, so long as they either have no dependencies, or are coupled with
304
- their respective module.
156
+ **If you're working in a company that's making significant use of galtzo-floss tools we'd
157
+ appreciate it if you suggest to your company to become a galtzo-floss sponsor.**
305
158
 
306
- Here's an example that configures every plugin:
307
- ```ruby
308
- class Person < ActiveRecord::Base
309
- active_security use: {
310
- finders: {default_finders: :restricted},
311
- scoped: {scope: :name},
312
- privileged: {}
313
- }
314
- end
159
+ ### Individual Support
315
160
 
316
- Person.find(1) # blows up, because no scope
317
- Person.where(name: "Bart").find(1) # returns the person
318
- Person.where(age: 29).find(1) # blows up, because name scope wasn't used
319
- Person.where(age: 29).privileged.find(1) # returns the person, because privileged
320
- Person.where(name: "Bart").restricted.find(1) # also returns the person, because name scope used
321
- ```
161
+ You can support the development of galtzo-floss tools via
162
+ [GitHub Sponsors][🖇sponsor],
163
+ [Liberapay][⛳liberapay],
164
+ [Open Collective][🖇osc],
165
+ and [PayPal][🖇paypal].
322
166
 
323
- However, when using block-style invocation, be sure to call
324
- ActiveSecurity::Configuration's {ActiveSecurity::Configuration#use use} method
325
- *prior* to the associated configuration options, because it will include
326
- modules into your class, and these modules in turn may add required
327
- configuration options to the `@active_security_configuration`'s class:
167
+ ### Open Collective for Individuals
328
168
 
329
- ```ruby
330
- class Person < ActiveRecord::Base
331
- active_security do |config|
332
- # This will work
333
- config.use :scoped
334
- config.scope = "family_id"
335
- end
336
- end
169
+ Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/galtzo-floss#backer)]
337
170
 
338
- class Person < ActiveRecord::Base
339
- active_security do |config|
340
- # This will fail
341
- config.scope = "family_id"
342
- config.use :scoped
343
- end
344
- end
345
- ```
171
+ NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
346
172
 
347
- ### Including Your Own Modules
173
+ <!-- OPENCOLLECTIVE-INDIVIDUALS:START -->
174
+ No backers yet. Be the first!
175
+ <!-- OPENCOLLECTIVE-INDIVIDUALS:END -->
348
176
 
349
- Because :use can accept a name or a Module, {ActiveSecurity.defaults defaults}
350
- can be a convenient place to set up behavior common to all classes using
351
- ActiveSecurity. You can include any module, or more conveniently, define one
352
- on-the-fly. For example, let's say you want to globally override the error
353
- that is raised when no scope is used:
177
+ ### Open Collective for Organizations
354
178
 
355
- ```ruby
356
- ActiveSecurity.defaults do |config|
357
- config.use :finders
358
- config.use Module.new {
359
- def self.setup(model_class)
360
- model_class.instance_eval do
361
- relation.class.send(:prepend, RaiseOverride)
362
- model_class.singleton_class.send(:prepend, RaiseOverride)
363
- end
364
-
365
- association_relation_delegate_class = model_class.relation_delegate_class(::ActiveRecord::AssociationRelation)
366
- association_relation_delegate_class.send(:prepend, RaiseOverride)
367
- end
368
-
369
- module RaiseOverride
370
- def raise_if_not_scoped
371
- puts "My errors are better than yours"
372
- raise StandardError, "Calm Down"
373
- end
374
- end
375
- }
376
- end
377
- ```
179
+ Become a sponsor and get your logo on our README on GitHub with a link to your site. [[Become a sponsor](https://opencollective.com/galtzo-floss#sponsor)]
378
180
 
379
- ## Running Specs
181
+ NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
380
182
 
381
- The basic compatibility matrix:
382
- ```sh
383
- appraisal install
384
- appraisal rake test
385
- ```
183
+ <!-- OPENCOLLECTIVE-ORGANIZATIONS:START -->
184
+ No sponsors yet. Be the first!
185
+ <!-- OPENCOLLECTIVE-ORGANIZATIONS:END -->
386
186
 
387
- Sometimes also:
388
- ```sh
389
- BUNDLE_GEMFILE=gemfiles/vanilla.gemfile appraisal update
390
- ```
187
+ [kettle-readme-backers]: https://github.com/galtzo-floss/active_security/blob/main/bin/kettle-readme-backers
188
+
189
+ ### Another way to support open-source
391
190
 
392
- NOTE: This results in bad paths to the gemspec.
393
- `gemspec path: "../../"` needs to be replaced with `gemspec path: "../"` in each Appraisal gemfile.
191
+ 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).
192
+
193
+ 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`.
194
+
195
+ 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.
196
+
197
+ **[Floss-Funding.dev][🖇floss-funding.dev]: 👉️ No network calls. 👉️ No tracking. 👉️ No oversight. 👉️ Minimal crypto hashing. 💡 Easily disabled nags**
198
+
199
+ [![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 to my FLOSS efforts at ko-fi.com][🖇kofi-img]][🖇kofi]
200
+
201
+ ## 🔐 Security
202
+
203
+ See [SECURITY.md][🔐security].
204
+
205
+ ## 🤝 Contributing
206
+
207
+ If you need some ideas of where to help, you could work on adding more code coverage,
208
+ check [issues][🤝gh-issues] or [PRs][🤝gh-pulls], or use the gem and think about how it could be better.
209
+
210
+ We [![Keep A Changelog][📗keep-changelog-img]][📗keep-changelog] so if you make changes, remember to update it.
211
+
212
+ See [CONTRIBUTING.md][🤝contributing] for more detailed instructions.
213
+
214
+ ### 🚀 Release Instructions
215
+
216
+ See [CONTRIBUTING.md][🤝contributing].
394
217
 
395
218
  ### Code Coverage
396
219
 
397
- [![Coverage Graph][🔑codecov-g]][🖇codecov]
220
+ <details markdown="1">
221
+ <summary>Coverage service badges</summary>
398
222
 
399
- [🔑codecov-g]: https://codecov.io/gh/pboling/active_security/graphs/tree.svg?token=hk0IktRjVc
223
+ [![Coverage Graph][🏀codecov-g]][🏀codecov]
400
224
 
401
- ## 🪇 Code of Conduct
225
+ [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls]
402
226
 
403
- Everyone interacting in this project's codebases, issue trackers,
404
- chat rooms and mailing lists is expected to follow the [code of conduct][🪇conduct].
227
+ [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov]
405
228
 
406
- [🪇conduct]: CODE_OF_CONDUCT.md
229
+ </details>
407
230
 
408
- ## 📌 Versioning
231
+ ### 🪇 Code of Conduct
409
232
 
410
- This Library adheres to [Semantic Versioning 2.0.0][📌semver].
411
- Violations of this scheme should be reported as bugs.
412
- Specifically, if a minor or patch version is released that breaks backward compatibility,
413
- a new version should be immediately released that restores compatibility.
414
- Breaking changes to the public API will only be introduced with new major versions.
233
+ Everyone interacting with this project's codebases, issue trackers,
234
+ chat rooms and mailing lists agrees to follow the [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct].
415
235
 
416
- To get a better understanding of how SemVer is intended to work over a project's lifetime,
417
- read this article from the creator of SemVer:
236
+ ## 🌈 Contributors
418
237
 
419
- - ["Major Version Numbers are Not Sacred"][📌major-versions-not-sacred]
238
+ [![Contributors][🖐contributors-img]][🖐contributors]
239
+
240
+ Made with [contributors-img][🖐contrib-rocks].
241
+
242
+ Also see GitLab Contributors: [https://gitlab.com/galtzo-floss/active_security/-/graphs/main][🚎contributors-gl]
243
+
244
+ ## 📌 Versioning
420
245
 
421
- As a result of this policy, you can (and should) specify a dependency on these libraries using
422
- the [Pessimistic Version Constraint][📌pvc] with two digits of precision.
246
+ This library follows [![Semantic Versioning 2.0.0][📌semver-img]][📌semver] for its public API where practical.
247
+ For most applications, prefer the [Pessimistic Version Constraint][📌pvc] with two digits of precision.
423
248
 
424
249
  For example:
425
250
 
@@ -427,28 +252,254 @@ For example:
427
252
  spec.add_dependency("active_security", "~> 1.0")
428
253
  ```
429
254
 
430
- [comment]: <> ( 📌 VERSIONING LINKS )
255
+ <details markdown="1">
256
+ <summary>📌 Is "Platform Support" part of the public API? More details inside.</summary>
431
257
 
432
- [📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
433
- [📌semver]: http://semver.org/
434
- [📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
258
+ Dropping support for a platform can be a breaking change for affected users.
259
+ If a release changes supported platforms, it should be called out clearly in the changelog and versioned with that impact in mind.
260
+
261
+ To get a better understanding of how SemVer is intended to work over a project's lifetime,
262
+ read this article from the creator of SemVer:
263
+
264
+ - ["Major Version Numbers are Not Sacred"][📌major-versions-not-sacred]
265
+
266
+ </details>
267
+
268
+ See [CHANGELOG.md][📌changelog] for a list of releases.
435
269
 
436
270
  ## 📄 License
437
271
 
438
272
  The gem is available as open source under the terms of
439
- the [MIT License][📄license] [![License: MIT][📄license-img]][📄license-ref].
440
- See [LICENSE.txt][📄license] for the official [Copyright Notice][📄copyright-notice-explainer].
273
+ the [MIT](https://github.com/galtzo-floss/active_security/blob/main/MIT.md) [![License: MIT][📄license-img]][📄license-ref].
441
274
 
442
- [comment]: <> ( 📄 LEGAL LINKS )
275
+ ### © Copyright
443
276
 
444
- [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
445
- [📄license]: LICENSE.txt
446
- [📄license-ref]: https://opensource.org/licenses/MIT
447
- [📄license-img]: https://img.shields.io/badge/License-MIT-green.svg
277
+ See [LICENSE.md][📄license] for the official copyright notice.
448
278
 
449
- ### © Copyright
279
+ <details markdown="1">
280
+ <summary>Copyright holders</summary>
281
+
282
+ - Copyright (c) 2024, 2026 Peter H. Boling
283
+ - Copyright (c) 2025 Annibelle Boling
284
+
285
+ </details>
286
+
287
+ ## 🤑 A request for help
288
+
289
+ Maintainers have teeth and need to pay their dentists.
290
+ After getting laid off in an RIF in March, and encountering difficulty finding a new one,
291
+ I began spending most of my time building open source tools.
292
+ I'm hoping to be able to pay for my kids' health insurance this month,
293
+ so if you value the work I am doing, I need your support.
294
+ Please consider sponsoring me or the project.
295
+
296
+ To join the community or get help, use the RubyForum or Discord.
297
+
298
+ [![Ruby Users Forum][✉️ruby-forum-img]][✉️ruby-forum]
299
+ [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
450
300
 
451
- * Copyright (c) 2024 [Peter H. Boling][peterboling] of [Rails Bling][railsbling]
301
+ To say "thanks!" ☝️ Join the community or 👇️ send money.
452
302
 
453
- [railsbling]: http://www.railsbling.com
454
- [peterboling]: http://www.peterboling.com
303
+ [![Sponsor galtzo-floss/active_security 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]
304
+
305
+ ### Please give the project a star ⭐ ♥.
306
+
307
+ 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.
308
+
309
+ Thanks for RTFM. ☺️
310
+
311
+ [⛳liberapay-img]: https://img.shields.io/liberapay/goal/pboling.svg?logo=liberapay&color=a51611&style=flat
312
+ [⛳liberapay-bottom-img]: https://img.shields.io/liberapay/goal/pboling.svg?style=for-the-badge&logo=liberapay&color=a51611
313
+ [⛳liberapay]: https://liberapay.com/pboling/donate
314
+ [🖇osc-all-img]: https://img.shields.io/opencollective/all/galtzo-floss
315
+ [🖇osc-sponsors-img]: https://img.shields.io/opencollective/sponsors/galtzo-floss
316
+ [🖇osc-backers-img]: https://img.shields.io/opencollective/backers/galtzo-floss
317
+ [🖇osc-backers]: https://opencollective.com/galtzo-floss#backer
318
+ [🖇osc-backers-i]: https://opencollective.com/galtzo-floss/backers/badge.svg?style=flat
319
+ [🖇osc-sponsors]: https://opencollective.com/galtzo-floss#sponsor
320
+ [🖇osc-sponsors-i]: https://opencollective.com/galtzo-floss/sponsors/badge.svg?style=flat
321
+ [🖇osc-all-bottom-img]: https://img.shields.io/opencollective/all/galtzo-floss?style=for-the-badge
322
+ [🖇osc-sponsors-bottom-img]: https://img.shields.io/opencollective/sponsors/galtzo-floss?style=for-the-badge
323
+ [🖇osc-backers-bottom-img]: https://img.shields.io/opencollective/backers/galtzo-floss?style=for-the-badge
324
+ [🖇osc]: https://opencollective.com/galtzo-floss
325
+ [🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
326
+ [🖇sponsor-bottom-img]: https://img.shields.io/badge/Sponsor_Me!-pboling-blue?style=for-the-badge&logo=github
327
+ [🖇sponsor]: https://github.com/sponsors/pboling
328
+ [🖇kofi-img]: https://img.shields.io/badge/ko--fi-%E2%9C%93-a51611.svg?style=flat
329
+ [🖇kofi]: https://ko-fi.com/pboling
330
+ [🖇buyme-small-img]: https://img.shields.io/badge/buy_me_a_coffee-%E2%9C%93-a51611.svg?style=flat
331
+ [🖇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
332
+ [🖇buyme]: https://www.buymeacoffee.com/pboling
333
+ [🖇paypal-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=flat&logo=paypal
334
+ [🖇paypal-bottom-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=for-the-badge&logo=paypal&color=0A0A0A
335
+ [🖇paypal]: https://www.paypal.com/paypalme/peterboling
336
+ [🖇floss-funding.dev]: https://floss-funding.dev
337
+ [🖇floss-funding-gem]: https://github.com/galtzo-floss/floss_funding
338
+ [✉️discord-invite]: https://discord.gg/3qme4XHNKN
339
+ [✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge&logo=discord
340
+ [✉️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
341
+ [✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends
342
+ [✉️ruby-forum-top-img]: https://img.shields.io/discourse/topics?server=https%3A%2F%2Fwww.rubyforum.org&style=flat&logo=discourse&label=Ruby%20Users%20Forum
343
+ [✉️ruby-forum-img]: https://img.shields.io/discourse/topics?server=https%3A%2F%2Fwww.rubyforum.org&style=for-the-badge&logo=discourse&label=Ruby%20Users%20Forum
344
+ [✉️ruby-forum]: https://www.rubyforum.org/tag/galtzo-floss
345
+
346
+ [✇bundle-group-pattern]: https://gist.github.com/pboling/4564780
347
+ [⛳️gem-namespace]: https://github.com/galtzo-floss/active_security
348
+ [⛳️namespace-img]: https://img.shields.io/badge/namespace-ActiveSecurity-3C2D2D.svg?style=square&logo=ruby&logoColor=white
349
+ [⛳️gem-name]: https://clickgems.clickhouse.com/dashboard/active_security
350
+ [⛳️name-img]: https://img.shields.io/badge/name-active__security-3C2D2D.svg?style=square&logo=rubygems&logoColor=red
351
+ [⛳️tag-img]: https://img.shields.io/github/tag/galtzo-floss/active_security.svg
352
+ [⛳️tag]: https://github.com/galtzo-floss/active_security/releases
353
+ [🚂maint-blog]: http://www.railsbling.com/tags/active_security
354
+ [🚂maint-blog-img]: https://img.shields.io/badge/blog-railsbling-0093D0.svg?style=for-the-badge&logo=rubyonrails&logoColor=orange
355
+ [🚂maint-contact]: http://www.railsbling.com/contact
356
+ [🚂maint-contact-img]: https://img.shields.io/badge/Contact-Maintainer-0093D0.svg?style=flat&logo=rubyonrails&logoColor=red
357
+ [💖🖇linkedin]: http://www.linkedin.com/in/peterboling
358
+ [💖🖇linkedin-img]: https://img.shields.io/badge/LinkedIn-Profile-0B66C2?style=flat&logo=newjapanprowrestling
359
+ [💖✌️wellfound]: https://wellfound.com/u/peter-boling
360
+ [💖✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=flat&logo=wellfound
361
+ [💖💲crunchbase]: https://www.crunchbase.com/person/peter-boling
362
+ [💖💲crunchbase-img]: https://img.shields.io/badge/peter--boling-purple?style=flat&logo=crunchbase
363
+ [💖🐘ruby-mast]: https://ruby.social/@galtzo
364
+ [💖🐘ruby-mast-img]: https://img.shields.io/mastodon/follow/109447111526622197?domain=https://ruby.social&style=flat&logo=mastodon&label=Ruby%20@galtzo
365
+ [💖🦋bluesky]: https://bsky.app/profile/galtzo.com
366
+ [💖🦋bluesky-img]: https://img.shields.io/badge/@galtzo.com-0285FF?style=flat&logo=bluesky&logoColor=white
367
+ [💖🌳linktree]: https://linktr.ee/galtzo
368
+ [💖🌳linktree-img]: https://img.shields.io/badge/galtzo-purple?style=flat&logo=linktree
369
+ [💖💁🏼‍♂️devto]: https://dev.to/galtzo
370
+ [💖💁🏼‍♂️devto-img]: https://img.shields.io/badge/dev.to-0A0A0A?style=flat&logo=devdotto&logoColor=white
371
+ [💖💁🏼‍♂️aboutme]: https://about.me/peter.boling
372
+ [💖💁🏼‍♂️aboutme-img]: https://img.shields.io/badge/about.me-0A0A0A?style=flat&logo=aboutme&logoColor=white
373
+ [💖🧊berg]: https://codeberg.org/pboling
374
+ [💖🐙hub]: https://github.org/pboling
375
+ [💖🛖hut]: https://sr.ht/~galtzo/
376
+ [💖🧪lab]: https://gitlab.com/pboling
377
+ [👨🏼‍🏫expsup-upwork]: https://www.upwork.com/freelancers/~014942e9b056abdf86?mp_source=share
378
+ [👨🏼‍🏫expsup-upwork-img]: https://img.shields.io/badge/UpWork-13544E?style=for-the-badge&logo=Upwork&logoColor=white
379
+ [👨🏼‍🏫expsup-codementor]: https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github
380
+ [👨🏼‍🏫expsup-codementor-img]: https://img.shields.io/badge/CodeMentor-Get_Help-1abc9c?style=for-the-badge&logo=CodeMentor&logoColor=white
381
+ [💁🏼‍♂️peterboling]: http://www.peterboling.com
382
+ [🚂railsbling]: http://www.railsbling.com
383
+ [📜src-gl-img]: https://img.shields.io/badge/GitLab-FBA326?style=for-the-badge&logo=Gitlab&logoColor=orange
384
+ [📜src-gl]: https://gitlab.com/galtzo-floss/active_security
385
+ [📜src-cb-img]: https://img.shields.io/badge/CodeBerg-4893CC?style=for-the-badge&logo=CodeBerg&logoColor=blue
386
+ [📜src-cb]: https://codeberg.org/galtzo-floss/active_security
387
+ [📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=GitHub&logoColor=green
388
+ [📜src-gh]: https://github.com/galtzo-floss/active_security
389
+ [📜docs-cr-rd-img]: https://img.shields.io/badge/RubyDoc-Current_Release-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
390
+ [📜docs-head-rd-img]: https://img.shields.io/badge/YARD_on_Galtzo.com-HEAD-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
391
+ [📜gl-wiki]: https://gitlab.com/galtzo-floss/active_security/-/wikis/home
392
+ [📜gh-wiki]: https://github.com/galtzo-floss/active_security/wiki
393
+ [📜gl-wiki-img]: https://img.shields.io/badge/wiki-gitlab-943CD2.svg?style=for-the-badge&logo=gitlab&logoColor=white
394
+ [📜gh-wiki-img]: https://img.shields.io/badge/wiki-github-943CD2.svg?style=for-the-badge&logo=github&logoColor=white
395
+ [👽dl-rank]: https://clickgems.clickhouse.com/dashboard/active_security
396
+ [👽dl-ranki]: https://img.shields.io/gem/dt/active_security.svg
397
+ [👽version]: https://clickgems.clickhouse.com/dashboard/active_security
398
+ [👽versioni]: https://img.shields.io/gem/v/active_security.svg
399
+ [🏀qlty-mnt]: https://qlty.sh/gh/galtzo-floss/projects/active_security
400
+ [🏀qlty-mnti]: https://qlty.sh/gh/galtzo-floss/projects/active_security/maintainability.svg
401
+ [🏀qlty-cov]: https://qlty.sh/gh/galtzo-floss/projects/active_security/metrics/code?sort=coverageRating
402
+ [🏀qlty-covi]: https://qlty.sh/gh/galtzo-floss/projects/active_security/coverage.svg
403
+ [🏀codecov]: https://codecov.io/gh/galtzo-floss/active_security
404
+ [🏀codecovi]: https://codecov.io/gh/galtzo-floss/active_security/graph/badge.svg
405
+ [🏀coveralls]: https://coveralls.io/github/galtzo-floss/active_security?branch=main
406
+ [🏀coveralls-img]: https://coveralls.io/repos/github/galtzo-floss/active_security/badge.svg?branch=main
407
+ [🚎ruby-2.7-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/ruby-2.7.yml
408
+ [🚎ruby-3.0-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/ruby-3.0.yml
409
+ [🚎ruby-3.1-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/ruby-3.1.yml
410
+ [🚎ruby-3.2-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/ruby-3.2.yml
411
+ [🚎ruby-3.3-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/ruby-3.3.yml
412
+ [🚎ruby-3.4-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/ruby-3.4.yml
413
+ [🚎jruby-10.0-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/jruby-10.0.yml
414
+ [🚎truby-33.0-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/truffleruby-33.0.yml
415
+ [🚎2-cov-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/coverage.yml
416
+ [🚎2-cov-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/coverage.yml/badge.svg
417
+ [🚎3-hd-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/heads.yml
418
+ [🚎3-hd-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/heads.yml/badge.svg
419
+ [🚎5-st-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/style.yml
420
+ [🚎5-st-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/style.yml/badge.svg
421
+ [🚎9-t-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/truffle.yml
422
+ [🚎9-t-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/truffle.yml/badge.svg
423
+ [🚎10-j-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/jruby.yml
424
+ [🚎10-j-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/jruby.yml/badge.svg
425
+ [🚎11-c-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/current.yml
426
+ [🚎11-c-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/current.yml/badge.svg
427
+ [🚎12-crh-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/dep-heads.yml
428
+ [🚎12-crh-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/dep-heads.yml/badge.svg
429
+ [🚎13-🔒️-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/locked_deps.yml
430
+ [🚎13-🔒️-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/locked_deps.yml/badge.svg
431
+ [🚎14-🔓️-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/unlocked_deps.yml
432
+ [🚎14-🔓️-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/unlocked_deps.yml/badge.svg
433
+ [🚎15-🪪-wf]: https://github.com/galtzo-floss/active_security/actions/workflows/license-eye.yml
434
+ [🚎15-🪪-wfi]: https://github.com/galtzo-floss/active_security/actions/workflows/license-eye.yml/badge.svg
435
+ [💎ruby-2.7i]: https://img.shields.io/badge/Ruby-2.7-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
436
+ [💎ruby-3.0i]: https://img.shields.io/badge/Ruby-3.0-CC342D?style=for-the-badge&logo=ruby&logoColor=white
437
+ [💎ruby-3.1i]: https://img.shields.io/badge/Ruby-3.1-CC342D?style=for-the-badge&logo=ruby&logoColor=white
438
+ [💎ruby-3.2i]: https://img.shields.io/badge/Ruby-3.2-CC342D?style=for-the-badge&logo=ruby&logoColor=white
439
+ [💎ruby-3.3i]: https://img.shields.io/badge/Ruby-3.3-CC342D?style=for-the-badge&logo=ruby&logoColor=white
440
+ [💎ruby-3.4i]: https://img.shields.io/badge/Ruby-3.4-CC342D?style=for-the-badge&logo=ruby&logoColor=white
441
+ [💎ruby-c-i]: https://img.shields.io/badge/Ruby-current-CC342D?style=for-the-badge&logo=ruby&logoColor=green
442
+ [💎ruby-headi]: https://img.shields.io/badge/Ruby-HEAD-CC342D?style=for-the-badge&logo=ruby&logoColor=blue
443
+ [💎truby-33.0i]: https://img.shields.io/badge/Truffle_Ruby-33.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
444
+ [💎truby-c-i]: https://img.shields.io/badge/Truffle_Ruby-current-34BCB1?style=for-the-badge&logo=ruby&logoColor=green
445
+ [💎jruby-10.0i]: https://img.shields.io/badge/JRuby-10.0-FBE742?style=for-the-badge&logo=ruby&logoColor=red
446
+ [💎jruby-c-i]: https://img.shields.io/badge/JRuby-current-FBE742?style=for-the-badge&logo=ruby&logoColor=green
447
+ [💎jruby-headi]: https://img.shields.io/badge/JRuby-HEAD-FBE742?style=for-the-badge&logo=ruby&logoColor=blue
448
+ [🤝gh-issues]: https://github.com/galtzo-floss/active_security/issues
449
+ [🤝gh-pulls]: https://github.com/galtzo-floss/active_security/pulls
450
+ [🤝gl-issues]: https://gitlab.com/galtzo-floss/active_security/-/issues
451
+ [🤝gl-pulls]: https://gitlab.com/galtzo-floss/active_security/-/merge_requests
452
+ [🤝cb-issues]: https://codeberg.org/galtzo-floss/active_security/issues
453
+ [🤝cb-pulls]: https://codeberg.org/galtzo-floss/active_security/pulls
454
+ [🤝cb-donate]: https://donate.codeberg.org/
455
+ [🤝contributing]: https://github.com/galtzo-floss/active_security/blob/main/CONTRIBUTING.md
456
+ [🏀codecov-g]: https://codecov.io/gh/galtzo-floss/active_security/graph/badge.svg
457
+ [🖐contrib-rocks]: https://contrib.rocks
458
+ [🖐contributors]: https://github.com/galtzo-floss/active_security/graphs/contributors
459
+ [🖐contributors-img]: https://contrib.rocks/image?repo=galtzo-floss/active_security
460
+ [🚎contributors-gl]: https://gitlab.com/galtzo-floss/active_security/-/graphs/main
461
+ [🪇conduct]: https://github.com/galtzo-floss/active_security/blob/main/CODE_OF_CONDUCT.md
462
+ [🪇conduct-img]: https://img.shields.io/badge/Contributor_Covenant-2.1-259D6C.svg
463
+ [📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
464
+ [📌semver]: https://semver.org/spec/v2.0.0.html
465
+ [📌semver-img]: https://img.shields.io/badge/semver-2.0.0-259D6C.svg?style=flat
466
+ [📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139
467
+ [📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
468
+ [📌changelog]: https://github.com/galtzo-floss/active_security/blob/main/CHANGELOG.md
469
+ [📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
470
+ [📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat
471
+ [📌gitmoji]: https://gitmoji.dev
472
+ [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
473
+ [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
474
+ [🧮kloc-img]: https://img.shields.io/badge/KLOC-0.232-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
475
+ [🔐security]: https://github.com/galtzo-floss/active_security/blob/main/SECURITY.md
476
+ [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
477
+ [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
478
+ [📄license]: LICENSE.md
479
+ [📄license-ref]: https://github.com/galtzo-floss/active_security/blob/main/MIT.md
480
+ [📄license-img]: https://img.shields.io/badge/License-MIT-259D6C.svg
481
+ [📄license-compat]: https://www.apache.org/legal/resolved.html#category-a
482
+ [📄license-compat-img]: https://img.shields.io/badge/Apache_Compatible:_Category_A-%E2%9C%93-259D6C.svg?style=flat&logo=Apache
483
+
484
+ [📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm
485
+ [📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat
486
+ [🚎yard-current]: http://rubydoc.info/gems/active_security
487
+ [🚎yard-head]: https://active-security.galtzo.com
488
+ [💎stone_checksums]: https://github.com/galtzo-floss/stone_checksums
489
+ [💎SHA_checksums]: https://gitlab.com/galtzo-floss/active_security/-/tree/main/checksums
490
+ [💎rlts]: https://github.com/rubocop-lts/rubocop-lts
491
+ [💎rlts-img]: https://img.shields.io/badge/code_style_&_linting-rubocop--lts-34495e.svg?plastic&logo=ruby&logoColor=white
492
+ [💎appraisal2]: https://github.com/appraisal-rb/appraisal2
493
+ [💎appraisal2-img]: https://img.shields.io/badge/appraised_by-appraisal2-34495e.svg?plastic&logo=ruby&logoColor=white
494
+ [💎d-in-dvcs]: https://railsbling.com/posts/dvcs/put_the_d_in_dvcs/
495
+
496
+ <!-- kettle-jem:metadata:start -->
497
+ | Field | Value |
498
+ |---|---|
499
+ | Package | active_security |
500
+ | Description | 🔒 Disallow insecure, unscoped, finds |
501
+ | Homepage | https://github.com/galtzo-floss/active_security |
502
+ | Source | https://github.com/galtzo-floss/active_security |
503
+ | License | `MIT` |
504
+ | Funding | https://github.com/sponsors/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/galtzo-floss, https://thanks.dev/u/gh/pboling, https://www.buymeacoffee.com/pboling |
505
+ <!-- kettle-jem:metadata:end -->