activerecord-transactionable 3.0.3 → 3.0.4
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.
- checksums.yaml +4 -4
- checksums.yaml.gz.sig +0 -0
- data/CHANGELOG.md +133 -0
- data/LICENSE.md +11 -0
- data/README.md +394 -246
- data/lib/activerecord/transactionable/result.rb +2 -2
- data/lib/activerecord/transactionable/version.rb +5 -1
- data/lib/activerecord/transactionable.rb +9 -9
- data/sig/activerecord/transactionable.rbs +8 -0
- data.tar.gz.sig +0 -0
- metadata +231 -60
- metadata.gz.sig +0 -0
- data/CODE_OF_CONDUCT.md +0 -84
- data/CONTRIBUTING.md +0 -47
- data/LICENSE.txt +0 -21
- data/SECURITY.md +0 -16
data/README.md
CHANGED
|
@@ -1,132 +1,120 @@
|
|
|
1
|
-
|
|
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
|
-
|
|
3
|
+
# 💱 Activerecord::Transactionable
|
|
4
4
|
|
|
5
|
-
[![CI
|
|
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
|
-
[
|
|
11
|
-
[🚎dl-cwfi]: https://github.com/pboling/activerecord-transactionable/actions/workflows/current.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
|
-
|
|
9
|
+
---
|
|
14
10
|
|
|
15
|
-
|
|
16
|
-
[🔑cc-mnti]: https://api.codeclimate.com/v1/badges/41fa99881cfe6d45e7e5/maintainability
|
|
17
|
-
[🔑cc-cov]: https://codeclimate.com/github/pboling/activerecord-transactionable/test_coverage
|
|
18
|
-
[🔑cc-covi]: https://api.codeclimate.com/v1/badges/41fa99881cfe6d45e7e5/test_coverage
|
|
19
|
-
[🔑depfu]: https://depfu.com/github/pboling/activerecord-transactionable?project_id=2653
|
|
20
|
-
[🔑depfui]: https://badges.depfu.com/badges/d570491bac0ad3b0b65deb3c82028327/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
|
-
|
|
25
|
-
|
|
26
|
-
<span class="badge-buymeacoffee">
|
|
27
|
-
<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>
|
|
28
|
-
</span>
|
|
29
|
-
<span class="badge-patreon">
|
|
30
|
-
<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>
|
|
31
|
-
</span>
|
|
15
|
+
<details markdown="1">
|
|
16
|
+
<summary>👣 How will this project approach the September 2025 hostile takeover of RubyGems? 🚑️</summary>
|
|
32
17
|
|
|
33
|
-
|
|
18
|
+
I've summarized my thoughts in [this blog post](https://dev.to/galtzo/hostile-takeover-of-rubygems-my-thoughts-5hlo).
|
|
34
19
|
|
|
35
|
-
|
|
36
|
-
[⛳liberapay]: https://liberapay.com/pboling/donate
|
|
37
|
-
[🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
|
|
38
|
-
[🖇sponsor]: https://github.com/sponsors/pboling
|
|
20
|
+
</details>
|
|
39
21
|
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
| Project | Activerecord::Transactionable |
|
|
43
|
-
|-----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
44
|
-
| install | `bundle add activerecord-transactionable` |
|
|
45
|
-
| compatibility | Ruby >= 2.5 |
|
|
46
|
-
| license | [](https://opensource.org/licenses/MIT) |
|
|
47
|
-
| download rank | [](https://github.com/pboling/activerecord-transactionable) |
|
|
48
|
-
| version | [](https://rubygems.org/gems/activerecord-transactionable) |
|
|
49
|
-
| code triage | [](https://www.codetriage.com/pboling/activerecord-transactionable) |
|
|
50
|
-
| documentation | [on RDoc.info][documentation] |
|
|
51
|
-
| live chat | [](https://matrix.to/#/#pboling_activerecord-transactionable:gitter.im?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) |
|
|
52
|
-
| expert support | [](https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github) |
|
|
53
|
-
| Spread ~♡ⓛⓞⓥⓔ♡~ | [🌏](https://about.me/peter.boling), [👼](https://angel.co/peter-boling), [![Liberapay Patrons][⛳liberapay-img]][⛳liberapay] [![Follow Me on LinkedIn][🖇linkedin-img]][🖇linkedin] [![Find Me on WellFound:][✌️wellfound-img]][✌️wellfound] [![My Blog][🚎blog-img]][🚎blog] [![Follow Me on Twitter][🐦twitter-img]][🐦twitter] |
|
|
54
|
-
|
|
55
|
-
[documentation]: https://rubydoc.info/github/pboling/activerecord-transactionable
|
|
56
|
-
[🖇linkedin]: http://www.linkedin.com/in/peterboling
|
|
57
|
-
[🖇linkedin-img]: https://img.shields.io/badge/PeterBoling-blue?style=plastic&logo=linkedin
|
|
58
|
-
[✌️wellfound]: https://angel.co/u/peter-boling
|
|
59
|
-
[✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=plastic&logo=angellist
|
|
60
|
-
[🐦twitter]: http://twitter.com/intent/user?screen_name=galtzo
|
|
61
|
-
[🐦twitter-img]: https://img.shields.io/twitter/follow/galtzo.svg?style=social&label=Follow%20@galtzo
|
|
62
|
-
[🚎blog]: http://www.railsbling.com/tags/oauth2/
|
|
63
|
-
[🚎blog-img]: https://img.shields.io/badge/blog-railsbling-brightgreen.svg?style=flat
|
|
64
|
-
[my🧪lab]: https://gitlab.com/pboling
|
|
65
|
-
[my🧊berg]: https://codeberg.org/pboling
|
|
66
|
-
[my🛖hut]: https://sr.ht/~galtzo/
|
|
67
|
-
|
|
68
|
-
Useful as an example of correct behavior for wrapping transactions.
|
|
69
|
-
|
|
70
|
-
NOTE: Rails' transactions are per-database connection, not per-model, nor per-instance,
|
|
71
|
-
see: http://api.rubyonrails.org/classes/ActiveRecord/Transactions/ClassMethods.html
|
|
72
|
-
|
|
73
|
-
## Upgrading to Version 2
|
|
74
|
-
|
|
75
|
-
In version 1 the `transaction_wrapper` returned `true` or `false`. In version 2 it returns an instance of `Activerecord::Transactionable::Result`, which has a `value`, and three methods:
|
|
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>
|
|
76
23
|
|
|
77
|
-
|
|
24
|
+
Activerecord::Transactionable wraps ActiveRecord work in transactions while
|
|
25
|
+
handling retries, nested transactions, optional row locking, and useful result
|
|
26
|
+
objects for callers that need to inspect success or failure.
|
|
78
27
|
|
|
79
|
-
|
|
80
|
-
result = transaction_wrapper(**args) do
|
|
81
|
-
# some code that might fail here
|
|
82
|
-
end
|
|
83
|
-
result.fail?
|
|
84
|
-
result.success?
|
|
85
|
-
result.to_h # => a hash with diagnostic information, particularly useful when things go wrong
|
|
86
|
-
```
|
|
87
|
-
Where you used to have:
|
|
88
|
-
```ruby
|
|
89
|
-
if result
|
|
90
|
-
# ...
|
|
91
|
-
end
|
|
92
|
-
```
|
|
93
|
-
You must update to:
|
|
94
|
-
```ruby
|
|
95
|
-
if result.success?
|
|
96
|
-
# ...
|
|
97
|
-
end
|
|
98
|
-
```
|
|
28
|
+
## 💡 Info you can shake a stick at
|
|
99
29
|
|
|
100
|
-
|
|
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.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]|
|
|
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] |
|
|
101
44
|
|
|
102
|
-
|
|
45
|
+
### Compatibility
|
|
103
46
|
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
47
|
+
The gem's declared runtime compatibility floor is MRI Ruby 2.5.0+, with concordant releases of JRuby and TruffleRuby.
|
|
48
|
+
CI workflows and Appraisals are generated for MRI Ruby 2.5.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.
|
|
53
|
+
|
|
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>
|
|
55
|
+
|
|
56
|
+
The _amazing_ test matrix is powered by the kettle-dev stack.
|
|
107
57
|
|
|
108
|
-
|
|
58
|
+
<details markdown="1">
|
|
59
|
+
<summary>How kettle-dev manages complexity in tests</summary>
|
|
109
60
|
|
|
110
|
-
|
|
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 | [](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 | [](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 | [](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 | [](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 | [](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 | [](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 | [](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 | [](https://clickgems.clickhouse.com/dashboard/turbo_tests2) |
|
|
111
71
|
|
|
112
|
-
|
|
72
|
+
</details>
|
|
113
73
|
|
|
114
|
-
|
|
74
|
+
### Federated DVCS
|
|
115
75
|
|
|
116
|
-
|
|
76
|
+
<details markdown="1">
|
|
77
|
+
<summary>Find this repo on federated forges (Coming soon!)</summary>
|
|
117
78
|
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
The
|
|
79
|
+
| Federated [DVCS][💎d-in-dvcs] Repository | Status | Issues | PRs | Wiki | CI |
|
|
80
|
+
|-------------------------------------------------|-------------------------------------------|-------------------|------------------|-----------------|----------------|
|
|
81
|
+
| 🧪 [galtzo-floss/activerecord-transactionable on GitLab][📜src-gl] | The Truth | [💚][🤝gl-issues] | [💚][🤝gl-pulls] | [💚][📜gl-wiki] | 🐭 Tiny Matrix |
|
|
82
|
+
| 🧊 [galtzo-floss/activerecord-transactionable on CodeBerg][📜src-cb] | An Ethical Mirror ([Donate][🤝cb-donate]) | [💚][🤝cb-issues] | [💚][🤝cb-pulls] | ➖ | ⭕️ No Matrix |
|
|
83
|
+
| 🐙 [galtzo-floss/activerecord-transactionable on GitHub][📜src-gh] | Another Mirror | [💚][🤝gh-issues] | [💚][🤝gh-pulls] | [💚][📜gh-wiki] | 💯 Full Matrix |
|
|
121
84
|
|
|
122
|
-
|
|
123
|
-
|--------------------|--------------------|----------------------------------------|-------------------------------|
|
|
124
|
-
| 3.0.x | `master` | 2.6, 2.7, 3.0, 3.1, 3.2, 3.3 | 2.5 |
|
|
125
|
-
| 2.0.x | `v2-maintenance` | 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 2.7, 3.0 | |
|
|
85
|
+
</details>
|
|
126
86
|
|
|
127
|
-
|
|
87
|
+
### Enterprise Support
|
|
128
88
|
|
|
129
|
-
|
|
89
|
+
For enterprise support from the maintainer, use [Upwork][👨🏼🏫expsup-upwork] or [CodeMentor][👨🏼🏫expsup-codementor].
|
|
90
|
+
|
|
91
|
+
Other support channels:
|
|
92
|
+
|
|
93
|
+
- [![Ruby Users Forum][✉️ruby-forum-img]][✉️ruby-forum]
|
|
94
|
+
- [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
|
|
95
|
+
|
|
96
|
+
## ✨ Installation
|
|
97
|
+
|
|
98
|
+
Install the gem and add to the application's Gemfile by executing:
|
|
99
|
+
|
|
100
|
+
```console
|
|
101
|
+
bundle add activerecord-transactionable
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
If bundler is not being used to manage dependencies, install the gem by executing:
|
|
105
|
+
|
|
106
|
+
```console
|
|
107
|
+
gem install activerecord-transactionable
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
## ⚙️ Configuration
|
|
111
|
+
|
|
112
|
+
Include `Activerecord::Transactionable` in the model or service object that owns
|
|
113
|
+
the operation. Configure a call with `transaction_wrapper` options such as
|
|
114
|
+
`lock: true`, `requires_new: true`, retry settings, and the error-handling
|
|
115
|
+
options supported by the wrapper. There is no global initializer.
|
|
116
|
+
|
|
117
|
+
## 🔧 Basic Usage
|
|
130
118
|
|
|
131
119
|
```ruby
|
|
132
120
|
class Car < ActiveRecord::Base
|
|
@@ -185,154 +173,109 @@ result # => an instance of Activerecord::Transactionable::Result
|
|
|
185
173
|
result.success? # => true or false
|
|
186
174
|
```
|
|
187
175
|
|
|
188
|
-
##
|
|
176
|
+
## 🦷 FLOSS Funding
|
|
189
177
|
|
|
190
|
-
|
|
191
|
-
|
|
192
|
-
transaction_result = @client.transaction_wrapper(lock: true) do
|
|
193
|
-
@client.assign_attributes(client_params)
|
|
194
|
-
@client.save!
|
|
195
|
-
end
|
|
196
|
-
if transaction_result.success?
|
|
197
|
-
render :show, locals: {client: @client}, status: :ok
|
|
198
|
-
else
|
|
199
|
-
# Something prevented update, transaction_result.to_h will have all the available details
|
|
200
|
-
render json: {record_errors: @client.errors, transaction_result: transaction_result.to_h}, status: :unprocessable_entity
|
|
201
|
-
end
|
|
202
|
-
```
|
|
178
|
+
While galtzo-floss tools are free software and will always be, the project would benefit immensely from some funding.
|
|
179
|
+
Raising a monthly budget of... "dollars" would make the project more sustainable.
|
|
203
180
|
|
|
204
|
-
|
|
181
|
+
We welcome both individual and corporate sponsors! We also offer a
|
|
182
|
+
wide array of funding channels to account for your preferences.
|
|
183
|
+
Currently, [Open Collective][🖇osc] is our preferred funding platform.
|
|
205
184
|
|
|
206
|
-
|
|
207
|
-
The block will never be retried more than once.
|
|
185
|
+
### Corporate Sponsorship
|
|
208
186
|
|
|
209
|
-
|
|
210
|
-
|
|
211
|
-
# is_retry will be falsey on first attempt, thereafter will be the integer number of the attempt
|
|
212
|
-
if is_retry
|
|
213
|
-
Car.create!(vin: vin)
|
|
214
|
-
else
|
|
215
|
-
Car.find_by!(vin: vin)
|
|
216
|
-
end
|
|
217
|
-
end
|
|
218
|
-
```
|
|
187
|
+
**If you're working in a company that's making significant use of galtzo-floss tools we'd
|
|
188
|
+
appreciate it if you suggest to your company to become a galtzo-floss sponsor.**
|
|
219
189
|
|
|
220
|
-
|
|
190
|
+
### Individual Support
|
|
221
191
|
|
|
222
|
-
|
|
223
|
-
|
|
192
|
+
You can support the development of galtzo-floss tools via
|
|
193
|
+
[GitHub Sponsors][🖇sponsor],
|
|
194
|
+
[Liberapay][⛳liberapay],
|
|
195
|
+
[Open Collective][🖇osc],
|
|
196
|
+
and [PayPal][🖇paypal].
|
|
224
197
|
|
|
225
|
-
|
|
226
|
-
Car.transaction_wrapper(outside_retriable_errors: ActivRecord::RecordNotUnique) do |is_retry|
|
|
227
|
-
# is_retry will be falsey on first attempt, thereafter will be the integer number of the attempt
|
|
228
|
-
if is_retry
|
|
229
|
-
Car.find_by!(vin: vin)
|
|
230
|
-
else
|
|
231
|
-
Car.create!(vin: vin)
|
|
232
|
-
end
|
|
233
|
-
end
|
|
234
|
-
```
|
|
198
|
+
### Open Collective for Individuals
|
|
235
199
|
|
|
236
|
-
|
|
200
|
+
Support us with a monthly donation and help us continue our activities. [[Become a backer](https://opencollective.com/galtzo-floss#backer)]
|
|
237
201
|
|
|
238
|
-
|
|
202
|
+
NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
|
|
239
203
|
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
super
|
|
244
|
-
if args[:error]
|
|
245
|
-
begin
|
|
246
|
-
Raygun.track_exception(args[:error])
|
|
247
|
-
Rails.logger.debug("Sent Error to Raygun: #{args[:error].class}: #{args[:error].message}")
|
|
248
|
-
rescue StandardError => e
|
|
249
|
-
Rails.logger.error("Sending Error #{args[:error].class}: #{args[:error].message} to Raygun Failed with: #{e.class}: #{e.message}")
|
|
250
|
-
end
|
|
251
|
-
end
|
|
252
|
-
end
|
|
253
|
-
end
|
|
204
|
+
<!-- OPENCOLLECTIVE-INDIVIDUALS:START -->
|
|
205
|
+
No backers yet. Be the first!
|
|
206
|
+
<!-- OPENCOLLECTIVE-INDIVIDUALS:END -->
|
|
254
207
|
|
|
255
|
-
|
|
256
|
-
prepend SendToRaygun
|
|
257
|
-
end
|
|
258
|
-
```
|
|
259
|
-
|
|
260
|
-
## 🪇 Code of Conduct
|
|
208
|
+
### Open Collective for Organizations
|
|
261
209
|
|
|
262
|
-
|
|
263
|
-
chat rooms and mailing lists is expected to follow the [code of conduct][🪇conduct].
|
|
210
|
+
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)]
|
|
264
211
|
|
|
265
|
-
[
|
|
212
|
+
NOTE: [kettle-readme-backers][kettle-readme-backers] updates this list every day, automatically.
|
|
266
213
|
|
|
267
|
-
|
|
214
|
+
<!-- OPENCOLLECTIVE-ORGANIZATIONS:START -->
|
|
215
|
+
No sponsors yet. Be the first!
|
|
216
|
+
<!-- OPENCOLLECTIVE-ORGANIZATIONS:END -->
|
|
268
217
|
|
|
269
|
-
|
|
218
|
+
[kettle-readme-backers]: https://github.com/galtzo-floss/activerecord-transactionable/blob/main/bin/kettle-readme-backers
|
|
270
219
|
|
|
271
|
-
|
|
220
|
+
### Another way to support open-source
|
|
272
221
|
|
|
273
|
-
|
|
222
|
+
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).
|
|
274
223
|
|
|
275
|
-
|
|
276
|
-
so it abides the principles of ["Distributed Version Control Systems"][💎d-in-dvcs]
|
|
224
|
+
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`.
|
|
277
225
|
|
|
278
|
-
|
|
226
|
+
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.
|
|
279
227
|
|
|
280
|
-
|
|
281
|
-
|----------------|------------------|----------------|----------------|
|
|
282
|
-
| [🐙hub][🐙hub] | [🧊berg][🧊berg] | [🛖hut][🛖hut] | [🧪lab][🧪lab] |
|
|
228
|
+
**[Floss-Funding.dev][🖇floss-funding.dev]: 👉️ No network calls. 👉️ No tracking. 👉️ No oversight. 👉️ Minimal crypto hashing. 💡 Easily disabled nags**
|
|
283
229
|
|
|
284
|
-
[
|
|
230
|
+
[![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]
|
|
285
231
|
|
|
286
|
-
|
|
232
|
+
## 🔐 Security
|
|
287
233
|
|
|
288
|
-
[
|
|
289
|
-
[🐙hub]: https://gitlab.com/pboling/activerecord-transactionable
|
|
290
|
-
[🛖hut]: https://sr.ht/~galtzo/pboling/activerecord-transactionable
|
|
291
|
-
[🧪lab]: https://gitlab.com/pboling/activerecord-transactionable
|
|
234
|
+
See [SECURITY.md][🔐security].
|
|
292
235
|
|
|
293
236
|
## 🤝 Contributing
|
|
294
237
|
|
|
295
|
-
|
|
238
|
+
If you need some ideas of where to help, you could work on adding more code coverage,
|
|
239
|
+
check [issues][🤝gh-issues] or [PRs][🤝gh-pulls], or use the gem and think about how it could be better.
|
|
296
240
|
|
|
297
|
-
[
|
|
241
|
+
We [![Keep A Changelog][📗keep-changelog-img]][📗keep-changelog] so if you make changes, remember to update it.
|
|
298
242
|
|
|
299
|
-
|
|
243
|
+
See [CONTRIBUTING.md][🤝contributing] for more detailed instructions.
|
|
300
244
|
|
|
301
|
-
|
|
245
|
+
### 🚀 Release Instructions
|
|
302
246
|
|
|
303
|
-
|
|
247
|
+
See [CONTRIBUTING.md][🤝contributing].
|
|
304
248
|
|
|
305
|
-
|
|
249
|
+
### Code Coverage
|
|
306
250
|
|
|
307
|
-
|
|
308
|
-
|
|
309
|
-
| [🐙hub contributors][🐙hub-contrib] | [🧊berg contributors][🧊berg-contrib] | [🛖hut contributors][🛖hut-contrib] | [🧪lab contributors][🧪lab-contrib] |
|
|
251
|
+
<details markdown="1">
|
|
252
|
+
<summary>Coverage service badges</summary>
|
|
310
253
|
|
|
311
|
-
[
|
|
254
|
+
[![Coverage Graph][🏀codecov-g]][🏀codecov]
|
|
312
255
|
|
|
313
|
-
[
|
|
314
|
-
[🌈contrib-rocks-img]: https://contrib.rocks/image?repo=pboling/activerecord-transactionable
|
|
256
|
+
[![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls]
|
|
315
257
|
|
|
316
|
-
[
|
|
317
|
-
[🐙hub-contrib]: https://github.com/pboling/activerecord-transactionable/graphs/contributors
|
|
318
|
-
[🛖hut-contrib]: https://git.sr.ht/~galtzo/activerecord-transactionable/log/
|
|
319
|
-
[🧪lab-contrib]: https://gitlab.com/pboling/activerecord-transactionable/-/graphs/main?ref_type=heads
|
|
258
|
+
[![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov]
|
|
320
259
|
|
|
321
|
-
|
|
260
|
+
</details>
|
|
322
261
|
|
|
323
|
-
|
|
324
|
-
Violations of this scheme should be reported as bugs.
|
|
325
|
-
Specifically, if a minor or patch version is released that breaks backward compatibility,
|
|
326
|
-
a new version should be immediately released that restores compatibility.
|
|
327
|
-
Breaking changes to the public API will only be introduced with new major versions.
|
|
262
|
+
### 🪇 Code of Conduct
|
|
328
263
|
|
|
329
|
-
|
|
330
|
-
|
|
264
|
+
Everyone interacting with this project's codebases, issue trackers,
|
|
265
|
+
chat rooms and mailing lists agrees to follow the [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct].
|
|
331
266
|
|
|
332
|
-
|
|
267
|
+
## 🌈 Contributors
|
|
268
|
+
|
|
269
|
+
[![Contributors][🖐contributors-img]][🖐contributors]
|
|
333
270
|
|
|
334
|
-
|
|
335
|
-
|
|
271
|
+
Made with [contributors-img][🖐contrib-rocks].
|
|
272
|
+
|
|
273
|
+
Also see GitLab Contributors: [https://gitlab.com/galtzo-floss/activerecord-transactionable/-/graphs/main][🚎contributors-gl]
|
|
274
|
+
|
|
275
|
+
## 📌 Versioning
|
|
276
|
+
|
|
277
|
+
This library follows [![Semantic Versioning 2.0.0][📌semver-img]][📌semver] for its public API where practical.
|
|
278
|
+
For most applications, prefer the [Pessimistic Version Constraint][📌pvc] with two digits of precision.
|
|
336
279
|
|
|
337
280
|
For example:
|
|
338
281
|
|
|
@@ -340,53 +283,258 @@ For example:
|
|
|
340
283
|
spec.add_dependency("activerecord-transactionable", "~> 3.0")
|
|
341
284
|
```
|
|
342
285
|
|
|
343
|
-
|
|
344
|
-
|
|
345
|
-
[📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
|
|
346
|
-
[📌semver]: http://semver.org/
|
|
347
|
-
[📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
|
|
286
|
+
<details markdown="1">
|
|
287
|
+
<summary>📌 Is "Platform Support" part of the public API? More details inside.</summary>
|
|
348
288
|
|
|
349
|
-
|
|
289
|
+
Dropping support for a platform can be a breaking change for affected users.
|
|
290
|
+
If a release changes supported platforms, it should be called out clearly in the changelog and versioned with that impact in mind.
|
|
350
291
|
|
|
351
|
-
|
|
292
|
+
To get a better understanding of how SemVer is intended to work over a project's lifetime,
|
|
293
|
+
read this article from the creator of SemVer:
|
|
352
294
|
|
|
353
|
-
|
|
295
|
+
- ["Major Version Numbers are Not Sacred"][📌major-versions-not-sacred]
|
|
354
296
|
|
|
355
|
-
|
|
297
|
+
</details>
|
|
356
298
|
|
|
357
|
-
[
|
|
358
|
-
[gh_discussions]: https://github.com/pboling/activerecord-transactionable/discussions
|
|
359
|
-
[gh_sponsors]: https://github.com/sponsors/pboling
|
|
299
|
+
See [CHANGELOG.md][📌changelog] for a list of releases.
|
|
360
300
|
|
|
361
301
|
## 📄 License
|
|
362
302
|
|
|
363
303
|
The gem is available as open source under the terms of
|
|
364
|
-
the [MIT
|
|
365
|
-
See [LICENSE.txt][📄license] for the official [Copyright Notice][📄copyright-notice-explainer].
|
|
304
|
+
the [MIT](https://github.com/galtzo-floss/activerecord-transactionable/blob/main/MIT.md) [![License: MIT][📄license-img]][📄license-ref].
|
|
366
305
|
|
|
367
|
-
|
|
306
|
+
### © Copyright
|
|
368
307
|
|
|
369
|
-
[📄copyright
|
|
370
|
-
[📄license]: LICENSE.txt
|
|
371
|
-
[📄license-ref]: https://opensource.org/licenses/MIT
|
|
372
|
-
[📄license-img]: https://img.shields.io/badge/License-MIT-green.svg
|
|
308
|
+
See [LICENSE.md][📄license] for the official copyright notice.
|
|
373
309
|
|
|
374
|
-
|
|
310
|
+
<details markdown="1">
|
|
311
|
+
<summary>Copyright holders</summary>
|
|
375
312
|
|
|
376
|
-
|
|
313
|
+
- Copyright (c) 2016-2018, 2021, 2024, 2026 Peter H. Boling
|
|
314
|
+
- Copyright (c) 2024-2025 Annibelle Boling
|
|
377
315
|
|
|
378
|
-
|
|
316
|
+
</details>
|
|
379
317
|
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
318
|
+
## 🤑 A request for help
|
|
319
|
+
|
|
320
|
+
Maintainers have teeth and need to pay their dentists.
|
|
321
|
+
After getting laid off in an RIF in March, and encountering difficulty finding a new one,
|
|
322
|
+
I began spending most of my time building open source tools.
|
|
323
|
+
I'm hoping to be able to pay for my kids' health insurance this month,
|
|
324
|
+
so if you value the work I am doing, I need your support.
|
|
325
|
+
Please consider sponsoring me or the project.
|
|
326
|
+
|
|
327
|
+
To join the community or get help, use the RubyForum or Discord.
|
|
328
|
+
|
|
329
|
+
[![Ruby Users Forum][✉️ruby-forum-img]][✉️ruby-forum]
|
|
330
|
+
[![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite]
|
|
331
|
+
|
|
332
|
+
To say "thanks!" ☝️ Join the community or 👇️ send money.
|
|
333
|
+
|
|
334
|
+
[![Sponsor galtzo-floss/activerecord-transactionable 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]
|
|
335
|
+
|
|
336
|
+
### Please give the project a star ⭐ ♥.
|
|
387
337
|
|
|
388
|
-
[
|
|
338
|
+
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.
|
|
339
|
+
|
|
340
|
+
Thanks for RTFM. ☺️
|
|
341
|
+
|
|
342
|
+
[⛳liberapay-img]: https://img.shields.io/liberapay/goal/pboling.svg?logo=liberapay&color=a51611&style=flat
|
|
343
|
+
[⛳liberapay-bottom-img]: https://img.shields.io/liberapay/goal/pboling.svg?style=for-the-badge&logo=liberapay&color=a51611
|
|
344
|
+
[⛳liberapay]: https://liberapay.com/pboling/donate
|
|
345
|
+
[🖇osc-all-img]: https://img.shields.io/opencollective/all/galtzo-floss
|
|
346
|
+
[🖇osc-sponsors-img]: https://img.shields.io/opencollective/sponsors/galtzo-floss
|
|
347
|
+
[🖇osc-backers-img]: https://img.shields.io/opencollective/backers/galtzo-floss
|
|
348
|
+
[🖇osc-backers]: https://opencollective.com/galtzo-floss#backer
|
|
349
|
+
[🖇osc-backers-i]: https://opencollective.com/galtzo-floss/backers/badge.svg?style=flat
|
|
350
|
+
[🖇osc-sponsors]: https://opencollective.com/galtzo-floss#sponsor
|
|
351
|
+
[🖇osc-sponsors-i]: https://opencollective.com/galtzo-floss/sponsors/badge.svg?style=flat
|
|
352
|
+
[🖇osc-all-bottom-img]: https://img.shields.io/opencollective/all/galtzo-floss?style=for-the-badge
|
|
353
|
+
[🖇osc-sponsors-bottom-img]: https://img.shields.io/opencollective/sponsors/galtzo-floss?style=for-the-badge
|
|
354
|
+
[🖇osc-backers-bottom-img]: https://img.shields.io/opencollective/backers/galtzo-floss?style=for-the-badge
|
|
355
|
+
[🖇osc]: https://opencollective.com/galtzo-floss
|
|
356
|
+
[🖇sponsor-img]: https://img.shields.io/badge/Sponsor_Me!-pboling.svg?style=social&logo=github
|
|
357
|
+
[🖇sponsor-bottom-img]: https://img.shields.io/badge/Sponsor_Me!-pboling-blue?style=for-the-badge&logo=github
|
|
358
|
+
[🖇sponsor]: https://github.com/sponsors/pboling
|
|
359
|
+
[🖇kofi-img]: https://img.shields.io/badge/ko--fi-%E2%9C%93-a51611.svg?style=flat
|
|
360
|
+
[🖇kofi]: https://ko-fi.com/pboling
|
|
361
|
+
[🖇buyme-small-img]: https://img.shields.io/badge/buy_me_a_coffee-%E2%9C%93-a51611.svg?style=flat
|
|
362
|
+
[🖇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
|
|
363
|
+
[🖇buyme]: https://www.buymeacoffee.com/pboling
|
|
364
|
+
[🖇paypal-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=flat&logo=paypal
|
|
365
|
+
[🖇paypal-bottom-img]: https://img.shields.io/badge/donate-paypal-a51611.svg?style=for-the-badge&logo=paypal&color=0A0A0A
|
|
366
|
+
[🖇paypal]: https://www.paypal.com/paypalme/peterboling
|
|
367
|
+
[🖇floss-funding.dev]: https://floss-funding.dev
|
|
368
|
+
[🖇floss-funding-gem]: https://github.com/galtzo-floss/floss_funding
|
|
369
|
+
[✉️discord-invite]: https://discord.gg/3qme4XHNKN
|
|
370
|
+
[✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge&logo=discord
|
|
371
|
+
[✉️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
|
|
372
|
+
[✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends
|
|
373
|
+
[✉️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
|
|
374
|
+
[✉️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
|
|
375
|
+
[✉️ruby-forum]: https://www.rubyforum.org/tag/galtzo-floss
|
|
376
|
+
|
|
377
|
+
[✇bundle-group-pattern]: https://gist.github.com/pboling/4564780
|
|
378
|
+
[⛳️gem-namespace]: https://github.com/galtzo-floss/activerecord-transactionable
|
|
379
|
+
[⛳️namespace-img]: https://img.shields.io/badge/namespace-Activerecord::Transactionable-3C2D2D.svg?style=square&logo=ruby&logoColor=white
|
|
380
|
+
[⛳️gem-name]: https://clickgems.clickhouse.com/dashboard/activerecord-transactionable
|
|
381
|
+
[⛳️name-img]: https://img.shields.io/badge/name-activerecord--transactionable-3C2D2D.svg?style=square&logo=rubygems&logoColor=red
|
|
382
|
+
[⛳️tag-img]: https://img.shields.io/github/tag/galtzo-floss/activerecord-transactionable.svg
|
|
383
|
+
[⛳️tag]: https://github.com/galtzo-floss/activerecord-transactionable/releases
|
|
384
|
+
[🚂maint-blog]: http://www.railsbling.com/tags/activerecord-transactionable
|
|
385
|
+
[🚂maint-blog-img]: https://img.shields.io/badge/blog-railsbling-0093D0.svg?style=for-the-badge&logo=rubyonrails&logoColor=orange
|
|
386
|
+
[🚂maint-contact]: http://www.railsbling.com/contact
|
|
387
|
+
[🚂maint-contact-img]: https://img.shields.io/badge/Contact-Maintainer-0093D0.svg?style=flat&logo=rubyonrails&logoColor=red
|
|
388
|
+
[💖🖇linkedin]: http://www.linkedin.com/in/peterboling
|
|
389
|
+
[💖🖇linkedin-img]: https://img.shields.io/badge/LinkedIn-Profile-0B66C2?style=flat&logo=newjapanprowrestling
|
|
390
|
+
[💖✌️wellfound]: https://wellfound.com/u/peter-boling
|
|
391
|
+
[💖✌️wellfound-img]: https://img.shields.io/badge/peter--boling-orange?style=flat&logo=wellfound
|
|
392
|
+
[💖💲crunchbase]: https://www.crunchbase.com/person/peter-boling
|
|
393
|
+
[💖💲crunchbase-img]: https://img.shields.io/badge/peter--boling-purple?style=flat&logo=crunchbase
|
|
394
|
+
[💖🐘ruby-mast]: https://ruby.social/@galtzo
|
|
395
|
+
[💖🐘ruby-mast-img]: https://img.shields.io/mastodon/follow/109447111526622197?domain=https://ruby.social&style=flat&logo=mastodon&label=Ruby%20@galtzo
|
|
396
|
+
[💖🦋bluesky]: https://bsky.app/profile/galtzo.com
|
|
397
|
+
[💖🦋bluesky-img]: https://img.shields.io/badge/@galtzo.com-0285FF?style=flat&logo=bluesky&logoColor=white
|
|
398
|
+
[💖🌳linktree]: https://linktr.ee/galtzo
|
|
399
|
+
[💖🌳linktree-img]: https://img.shields.io/badge/galtzo-purple?style=flat&logo=linktree
|
|
400
|
+
[💖💁🏼♂️devto]: https://dev.to/galtzo
|
|
401
|
+
[💖💁🏼♂️devto-img]: https://img.shields.io/badge/dev.to-0A0A0A?style=flat&logo=devdotto&logoColor=white
|
|
402
|
+
[💖💁🏼♂️aboutme]: https://about.me/peter.boling
|
|
403
|
+
[💖💁🏼♂️aboutme-img]: https://img.shields.io/badge/about.me-0A0A0A?style=flat&logo=aboutme&logoColor=white
|
|
404
|
+
[💖🧊berg]: https://codeberg.org/pboling
|
|
405
|
+
[💖🐙hub]: https://github.org/pboling
|
|
406
|
+
[💖🛖hut]: https://sr.ht/~galtzo/
|
|
407
|
+
[💖🧪lab]: https://gitlab.com/pboling
|
|
408
|
+
[👨🏼🏫expsup-upwork]: https://www.upwork.com/freelancers/~014942e9b056abdf86?mp_source=share
|
|
409
|
+
[👨🏼🏫expsup-upwork-img]: https://img.shields.io/badge/UpWork-13544E?style=for-the-badge&logo=Upwork&logoColor=white
|
|
410
|
+
[👨🏼🏫expsup-codementor]: https://www.codementor.io/peterboling?utm_source=github&utm_medium=button&utm_term=peterboling&utm_campaign=github
|
|
411
|
+
[👨🏼🏫expsup-codementor-img]: https://img.shields.io/badge/CodeMentor-Get_Help-1abc9c?style=for-the-badge&logo=CodeMentor&logoColor=white
|
|
412
|
+
[💁🏼♂️peterboling]: http://www.peterboling.com
|
|
413
|
+
[🚂railsbling]: http://www.railsbling.com
|
|
414
|
+
[📜src-gl-img]: https://img.shields.io/badge/GitLab-FBA326?style=for-the-badge&logo=Gitlab&logoColor=orange
|
|
415
|
+
[📜src-gl]: https://gitlab.com/galtzo-floss/activerecord-transactionable
|
|
416
|
+
[📜src-cb-img]: https://img.shields.io/badge/CodeBerg-4893CC?style=for-the-badge&logo=CodeBerg&logoColor=blue
|
|
417
|
+
[📜src-cb]: https://codeberg.org/galtzo-floss/activerecord-transactionable
|
|
418
|
+
[📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=GitHub&logoColor=green
|
|
419
|
+
[📜src-gh]: https://github.com/galtzo-floss/activerecord-transactionable
|
|
420
|
+
[📜docs-cr-rd-img]: https://img.shields.io/badge/RubyDoc-Current_Release-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
|
|
421
|
+
[📜docs-head-rd-img]: https://img.shields.io/badge/YARD_on_Galtzo.com-HEAD-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
|
|
422
|
+
[📜gl-wiki]: https://gitlab.com/galtzo-floss/activerecord-transactionable/-/wikis/home
|
|
423
|
+
[📜gh-wiki]: https://github.com/galtzo-floss/activerecord-transactionable/wiki
|
|
424
|
+
[📜gl-wiki-img]: https://img.shields.io/badge/wiki-gitlab-943CD2.svg?style=for-the-badge&logo=gitlab&logoColor=white
|
|
425
|
+
[📜gh-wiki-img]: https://img.shields.io/badge/wiki-github-943CD2.svg?style=for-the-badge&logo=github&logoColor=white
|
|
426
|
+
[👽dl-rank]: https://clickgems.clickhouse.com/dashboard/activerecord-transactionable
|
|
427
|
+
[👽dl-ranki]: https://img.shields.io/gem/dt/activerecord-transactionable.svg
|
|
428
|
+
[👽version]: https://clickgems.clickhouse.com/dashboard/activerecord-transactionable
|
|
429
|
+
[👽versioni]: https://img.shields.io/gem/v/activerecord-transactionable.svg
|
|
430
|
+
[🏀qlty-mnt]: https://qlty.sh/gh/galtzo-floss/projects/activerecord-transactionable
|
|
431
|
+
[🏀qlty-mnti]: https://qlty.sh/gh/galtzo-floss/projects/activerecord-transactionable/maintainability.svg
|
|
432
|
+
[🏀qlty-cov]: https://qlty.sh/gh/galtzo-floss/projects/activerecord-transactionable/metrics/code?sort=coverageRating
|
|
433
|
+
[🏀qlty-covi]: https://qlty.sh/gh/galtzo-floss/projects/activerecord-transactionable/coverage.svg
|
|
434
|
+
[🏀codecov]: https://codecov.io/gh/galtzo-floss/activerecord-transactionable
|
|
435
|
+
[🏀codecovi]: https://codecov.io/gh/galtzo-floss/activerecord-transactionable/graph/badge.svg
|
|
436
|
+
[🏀coveralls]: https://coveralls.io/github/galtzo-floss/activerecord-transactionable?branch=main
|
|
437
|
+
[🏀coveralls-img]: https://coveralls.io/repos/github/galtzo-floss/activerecord-transactionable/badge.svg?branch=main
|
|
438
|
+
[🚎ruby-2.5-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/ruby-2.5.yml
|
|
439
|
+
[🚎ruby-2.6-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/ruby-2.6.yml
|
|
440
|
+
[🚎ruby-2.7-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/ruby-2.7.yml
|
|
441
|
+
[🚎ruby-3.0-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/ruby-3.0.yml
|
|
442
|
+
[🚎ruby-3.1-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/ruby-3.1.yml
|
|
443
|
+
[🚎ruby-3.2-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/ruby-3.2.yml
|
|
444
|
+
[🚎ruby-3.3-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/ruby-3.3.yml
|
|
445
|
+
[🚎ruby-3.4-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/ruby-3.4.yml
|
|
446
|
+
[🚎jruby-10.0-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/jruby-10.0.yml
|
|
447
|
+
[🚎truby-33.0-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/truffleruby-33.0.yml
|
|
448
|
+
[🚎2-cov-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/coverage.yml
|
|
449
|
+
[🚎2-cov-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/coverage.yml/badge.svg
|
|
450
|
+
[🚎3-hd-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/heads.yml
|
|
451
|
+
[🚎3-hd-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/heads.yml/badge.svg
|
|
452
|
+
[🚎5-st-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/style.yml
|
|
453
|
+
[🚎5-st-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/style.yml/badge.svg
|
|
454
|
+
[🚎9-t-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/truffle.yml
|
|
455
|
+
[🚎9-t-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/truffle.yml/badge.svg
|
|
456
|
+
[🚎10-j-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/jruby.yml
|
|
457
|
+
[🚎10-j-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/jruby.yml/badge.svg
|
|
458
|
+
[🚎11-c-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/current.yml
|
|
459
|
+
[🚎11-c-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/current.yml/badge.svg
|
|
460
|
+
[🚎12-crh-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/dep-heads.yml
|
|
461
|
+
[🚎12-crh-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/dep-heads.yml/badge.svg
|
|
462
|
+
[🚎13-🔒️-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/locked_deps.yml
|
|
463
|
+
[🚎13-🔒️-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/locked_deps.yml/badge.svg
|
|
464
|
+
[🚎14-🔓️-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/unlocked_deps.yml
|
|
465
|
+
[🚎14-🔓️-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/unlocked_deps.yml/badge.svg
|
|
466
|
+
[🚎15-🪪-wf]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/license-eye.yml
|
|
467
|
+
[🚎15-🪪-wfi]: https://github.com/galtzo-floss/activerecord-transactionable/actions/workflows/license-eye.yml/badge.svg
|
|
468
|
+
[💎ruby-2.5i]: https://img.shields.io/badge/Ruby-2.5-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
|
|
469
|
+
[💎ruby-2.6i]: https://img.shields.io/badge/Ruby-2.6-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
|
|
470
|
+
[💎ruby-2.7i]: https://img.shields.io/badge/Ruby-2.7-DF00CA?style=for-the-badge&logo=ruby&logoColor=white
|
|
471
|
+
[💎ruby-3.0i]: https://img.shields.io/badge/Ruby-3.0-CC342D?style=for-the-badge&logo=ruby&logoColor=white
|
|
472
|
+
[💎ruby-3.1i]: https://img.shields.io/badge/Ruby-3.1-CC342D?style=for-the-badge&logo=ruby&logoColor=white
|
|
473
|
+
[💎ruby-3.2i]: https://img.shields.io/badge/Ruby-3.2-CC342D?style=for-the-badge&logo=ruby&logoColor=white
|
|
474
|
+
[💎ruby-3.3i]: https://img.shields.io/badge/Ruby-3.3-CC342D?style=for-the-badge&logo=ruby&logoColor=white
|
|
475
|
+
[💎ruby-3.4i]: https://img.shields.io/badge/Ruby-3.4-CC342D?style=for-the-badge&logo=ruby&logoColor=white
|
|
476
|
+
[💎ruby-c-i]: https://img.shields.io/badge/Ruby-current-CC342D?style=for-the-badge&logo=ruby&logoColor=green
|
|
477
|
+
[💎ruby-headi]: https://img.shields.io/badge/Ruby-HEAD-CC342D?style=for-the-badge&logo=ruby&logoColor=blue
|
|
478
|
+
[💎truby-33.0i]: https://img.shields.io/badge/Truffle_Ruby-33.0-34BCB1?style=for-the-badge&logo=ruby&logoColor=pink
|
|
479
|
+
[💎truby-c-i]: https://img.shields.io/badge/Truffle_Ruby-current-34BCB1?style=for-the-badge&logo=ruby&logoColor=green
|
|
480
|
+
[💎jruby-10.0i]: https://img.shields.io/badge/JRuby-10.0-FBE742?style=for-the-badge&logo=ruby&logoColor=red
|
|
481
|
+
[💎jruby-c-i]: https://img.shields.io/badge/JRuby-current-FBE742?style=for-the-badge&logo=ruby&logoColor=green
|
|
482
|
+
[💎jruby-headi]: https://img.shields.io/badge/JRuby-HEAD-FBE742?style=for-the-badge&logo=ruby&logoColor=blue
|
|
483
|
+
[🤝gh-issues]: https://github.com/galtzo-floss/activerecord-transactionable/issues
|
|
484
|
+
[🤝gh-pulls]: https://github.com/galtzo-floss/activerecord-transactionable/pulls
|
|
485
|
+
[🤝gl-issues]: https://gitlab.com/galtzo-floss/activerecord-transactionable/-/issues
|
|
486
|
+
[🤝gl-pulls]: https://gitlab.com/galtzo-floss/activerecord-transactionable/-/merge_requests
|
|
487
|
+
[🤝cb-issues]: https://codeberg.org/galtzo-floss/activerecord-transactionable/issues
|
|
488
|
+
[🤝cb-pulls]: https://codeberg.org/galtzo-floss/activerecord-transactionable/pulls
|
|
489
|
+
[🤝cb-donate]: https://donate.codeberg.org/
|
|
490
|
+
[🤝contributing]: https://github.com/galtzo-floss/activerecord-transactionable/blob/main/CONTRIBUTING.md
|
|
491
|
+
[🏀codecov-g]: https://codecov.io/gh/galtzo-floss/activerecord-transactionable/graph/badge.svg
|
|
492
|
+
[🖐contrib-rocks]: https://contrib.rocks
|
|
493
|
+
[🖐contributors]: https://github.com/galtzo-floss/activerecord-transactionable/graphs/contributors
|
|
494
|
+
[🖐contributors-img]: https://contrib.rocks/image?repo=galtzo-floss/activerecord-transactionable
|
|
495
|
+
[🚎contributors-gl]: https://gitlab.com/galtzo-floss/activerecord-transactionable/-/graphs/main
|
|
496
|
+
[🪇conduct]: https://github.com/galtzo-floss/activerecord-transactionable/blob/main/CODE_OF_CONDUCT.md
|
|
497
|
+
[🪇conduct-img]: https://img.shields.io/badge/Contributor_Covenant-2.1-259D6C.svg
|
|
498
|
+
[📌pvc]: http://guides.rubygems.org/patterns/#pessimistic-version-constraint
|
|
499
|
+
[📌semver]: https://semver.org/spec/v2.0.0.html
|
|
500
|
+
[📌semver-img]: https://img.shields.io/badge/semver-2.0.0-259D6C.svg?style=flat
|
|
501
|
+
[📌semver-breaking]: https://github.com/semver/semver/issues/716#issuecomment-869336139
|
|
502
|
+
[📌major-versions-not-sacred]: https://tom.preston-werner.com/2022/05/23/major-version-numbers-are-not-sacred.html
|
|
503
|
+
[📌changelog]: https://github.com/galtzo-floss/activerecord-transactionable/blob/main/CHANGELOG.md
|
|
504
|
+
[📗keep-changelog]: https://keepachangelog.com/en/1.0.0/
|
|
505
|
+
[📗keep-changelog-img]: https://img.shields.io/badge/keep--a--changelog-1.0.0-34495e.svg?style=flat
|
|
506
|
+
[📌gitmoji]: https://gitmoji.dev
|
|
507
|
+
[📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
|
|
508
|
+
[🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
|
|
509
|
+
[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.145-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
|
|
510
|
+
[🔐security]: https://github.com/galtzo-floss/activerecord-transactionable/blob/main/SECURITY.md
|
|
511
|
+
[🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
|
|
512
|
+
[📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
|
|
513
|
+
[📄license]: LICENSE.md
|
|
514
|
+
[📄license-ref]: https://github.com/galtzo-floss/activerecord-transactionable/blob/main/MIT.md
|
|
515
|
+
[📄license-img]: https://img.shields.io/badge/License-MIT-259D6C.svg
|
|
516
|
+
[📄license-compat]: https://www.apache.org/legal/resolved.html#category-a
|
|
517
|
+
[📄license-compat-img]: https://img.shields.io/badge/Apache_Compatible:_Category_A-%E2%9C%93-259D6C.svg?style=flat&logo=Apache
|
|
518
|
+
|
|
519
|
+
[📄ilo-declaration]: https://www.ilo.org/declaration/lang--en/index.htm
|
|
520
|
+
[📄ilo-declaration-img]: https://img.shields.io/badge/ILO_Fundamental_Principles-✓-259D6C.svg?style=flat
|
|
521
|
+
[🚎yard-current]: http://rubydoc.info/gems/activerecord-transactionable
|
|
522
|
+
[🚎yard-head]: https://activerecord-transactionable.galtzo.com
|
|
523
|
+
[💎stone_checksums]: https://github.com/galtzo-floss/stone_checksums
|
|
524
|
+
[💎SHA_checksums]: https://gitlab.com/galtzo-floss/activerecord-transactionable/-/tree/main/checksums
|
|
525
|
+
[💎rlts]: https://github.com/rubocop-lts/rubocop-lts
|
|
526
|
+
[💎rlts-img]: https://img.shields.io/badge/code_style_&_linting-rubocop--lts-34495e.svg?plastic&logo=ruby&logoColor=white
|
|
527
|
+
[💎appraisal2]: https://github.com/appraisal-rb/appraisal2
|
|
528
|
+
[💎appraisal2-img]: https://img.shields.io/badge/appraised_by-appraisal2-34495e.svg?plastic&logo=ruby&logoColor=white
|
|
529
|
+
[💎d-in-dvcs]: https://railsbling.com/posts/dvcs/put_the_d_in_dvcs/
|
|
389
530
|
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
531
|
+
<!-- kettle-jem:metadata:start -->
|
|
532
|
+
| Field | Value |
|
|
533
|
+
|---|---|
|
|
534
|
+
| Package | activerecord-transactionable |
|
|
535
|
+
| Description | 💱 Getting transactions right is hard, and this gem makes it easier. |
|
|
536
|
+
| Homepage | https://github.com/galtzo-floss/activerecord-transactionable |
|
|
537
|
+
| Source | https://github.com/galtzo-floss/activerecord-transactionable |
|
|
538
|
+
| License | `MIT` |
|
|
539
|
+
| Funding | https://github.com/sponsors/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/galtzo-floss, https://thanks.dev/gh/pboling, https://www.buymeacoffee.com/pboling |
|
|
540
|
+
<!-- kettle-jem:metadata:end -->
|