active_outbox 0.0.2 → 0.0.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +98 -0
- data/bin/outbox +1 -0
- data/lib/active_outbox/adapter_helper.rb +17 -0
- data/lib/active_outbox/configuration.rb +2 -0
- data/lib/active_outbox/errors.rb +10 -11
- data/lib/active_outbox/generators/{outbox_generator.rb → active_outbox_generator.rb} +6 -15
- data/lib/active_outbox/generators/templates/migration.rb +2 -0
- data/lib/active_outbox/outboxable.rb +46 -41
- data/lib/active_outbox/railtie.rb +3 -1
- data/lib/active_outbox.rb +4 -1
- metadata +13 -110
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: f366197388646246ec6d819c6877f846fd732a3f0df79673c23e7d5883057d78
|
4
|
+
data.tar.gz: 72a2af511d588e32622444068d1e26cc57114debd08cade8b88399cf3ad297e8
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: c3da7a34231c3161e4f65291aa78b304d94213d06cdefa7f0e5cfa0318772db56906ee27391610be9bcd18e640db4481c00eee40b9341f183b5877063c3d1120
|
7
|
+
data.tar.gz: b6d2e214d3dcaef57c7f774a934a814dca2c4d8a355d79721a0cfcc3d8f377bec36f7f1dd289d36a06fbcc6a695a09c6f61027fa6177d0e39419abda0c688492
|
data/README.md
CHANGED
@@ -1,2 +1,100 @@
|
|
1
1
|
# Active Outbox
|
2
2
|
A Transactional Outbox implementation for ActiveRecord
|
3
|
+
|
4
|
+
![transactional outbox pattern](./docs/images/transactional_outbox.png)
|
5
|
+
|
6
|
+
This gem aims to implement the event persistance side of the pattern, focusing only on providing a seamless way to store Outbox records whenever a change occurs on a given model (#1 in the diagram).
|
7
|
+
We do not provide an event publisher, nor a consumer as a part of this gem since the idea is to keep it as light weight as possible.
|
8
|
+
|
9
|
+
## Motivation
|
10
|
+
If you find yourself repeatedly defining a transaction block every time you need to persist an event, it might be a sign that something needs improvement. We believe that adopting a pattern should enhance your workflow, not hinder it. Creating, updating or destroying a record should remain a familiar and smooth process.
|
11
|
+
|
12
|
+
Our primary objective is to ensure a seamless experience without imposing our own opinions or previous experiences. That's why this gem exclusively focuses on persisting records. We leave the other aspects of the pattern entirely open for your customization. You can emit these events using Sidekiq jobs, or explore more sophisticated solutions like Kafka Connect.
|
13
|
+
|
14
|
+
## Why active_outbox?
|
15
|
+
- Seamless integration with ActiveRecord
|
16
|
+
- CRUD events out of the box
|
17
|
+
- Ability to set custom events
|
18
|
+
- Test helpers to easily check Outbox records are being created correctly
|
19
|
+
- Customizable
|
20
|
+
|
21
|
+
## Installation
|
22
|
+
|
23
|
+
Add this line to your application's Gemfile:
|
24
|
+
|
25
|
+
```ruby
|
26
|
+
gem 'active_outbox'
|
27
|
+
```
|
28
|
+
|
29
|
+
And then execute:
|
30
|
+
```bash
|
31
|
+
bundle install
|
32
|
+
```
|
33
|
+
Or install it yourself as:
|
34
|
+
```bash
|
35
|
+
gem install active_outbox
|
36
|
+
```
|
37
|
+
|
38
|
+
## Usage
|
39
|
+
### Setup
|
40
|
+
Create an `Outbox` table using the provided generator and corresponding model.
|
41
|
+
```bash
|
42
|
+
rails g active_outbox outbox
|
43
|
+
```
|
44
|
+
After running the migration, create an initializer under `config/initializers/active_outbox.rb` and setup the default outbox class to the new `Outbox` model you just created.
|
45
|
+
```ruby
|
46
|
+
# frozen_string_literal: true
|
47
|
+
|
48
|
+
Rails.application.reloader.to_prepare do
|
49
|
+
ActiveOutbox.configure do |config|
|
50
|
+
config.outbox_mapping = {
|
51
|
+
'default' => 'Outbox'
|
52
|
+
}
|
53
|
+
end
|
54
|
+
end
|
55
|
+
```
|
56
|
+
|
57
|
+
To allow models to store Outbox records on changes, you will have to include the `Outboxable` concern.
|
58
|
+
```ruby
|
59
|
+
# app/models/user.rb
|
60
|
+
|
61
|
+
class User < ApplicationRecord
|
62
|
+
include ActiveOutbox::Outboxable
|
63
|
+
end
|
64
|
+
```
|
65
|
+
### Base Events
|
66
|
+
Using the User model as an example, the default event names provided are:
|
67
|
+
- USER_CREATED
|
68
|
+
- USER_UPDATED
|
69
|
+
- USER_DESTROYED
|
70
|
+
|
71
|
+
### Custom Events
|
72
|
+
If you want to persist a custom event other than the provided base events, you can do so.
|
73
|
+
```ruby
|
74
|
+
user.save(outbox_event: 'YOUR_CUSTOM_EVENT')
|
75
|
+
```
|
76
|
+
## Advanced Usage
|
77
|
+
If more granularity is desired multiple `Outbox` classes can be configured. After creating the needed `Outbox` classes for each module you can specify multiple mappings in the initializer.
|
78
|
+
```ruby
|
79
|
+
# frozen_string_literal: true
|
80
|
+
|
81
|
+
Rails.application.reloader.to_prepare do
|
82
|
+
ActiveOutbox.configure do |config|
|
83
|
+
config.outbox_mapping = {
|
84
|
+
'Member' => 'Member::Outbox',
|
85
|
+
'UserAccess' => 'UserAccess::Outbox'
|
86
|
+
}
|
87
|
+
end
|
88
|
+
end
|
89
|
+
```
|
90
|
+
## Contributing
|
91
|
+
|
92
|
+
Bug reports and pull requests are welcome on GitHub at https://github.com/rootstrap/active_outbox. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/rootstrap/active_outbox/blob/main/CODE_OF_CONDUCT.md).
|
93
|
+
|
94
|
+
## License
|
95
|
+
|
96
|
+
The gem is available as open source under the terms of the [MIT License](https://opensource.org/license/mit/).
|
97
|
+
|
98
|
+
## Code of Conduct
|
99
|
+
|
100
|
+
Everyone interacting in the ActiveOutbox project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/rootstrap/active_outbox/blob/main/CODE_OF_CONDUCT.md).
|
data/bin/outbox
CHANGED
@@ -0,0 +1,17 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
module ActiveOutbox
|
4
|
+
module AdapterHelper
|
5
|
+
def self.uuid_type
|
6
|
+
postgres? ? 'uuid' : 'string'
|
7
|
+
end
|
8
|
+
|
9
|
+
def self.json_type
|
10
|
+
postgres? ? 'jsonb' : 'string'
|
11
|
+
end
|
12
|
+
|
13
|
+
def self.postgres?
|
14
|
+
ActiveRecord::Base.connection.adapter_name.downcase == 'postgresql'
|
15
|
+
end
|
16
|
+
end
|
17
|
+
end
|
data/lib/active_outbox/errors.rb
CHANGED
@@ -2,21 +2,20 @@
|
|
2
2
|
|
3
3
|
module ActiveOutbox
|
4
4
|
class OutboxConfigurationError < StandardError; end
|
5
|
+
|
5
6
|
class OutboxClassNotFoundError < OutboxConfigurationError
|
6
7
|
def message
|
7
8
|
<<~MESSAGE
|
8
|
-
Missing Outbox class definition
|
9
|
-
Define default class in `config/initializers/active_outbox.rb`:
|
9
|
+
Missing Outbox class definition. Configure mapping in `config/initializers/active_outbox.rb`:
|
10
10
|
|
11
|
-
Rails.application.reloader.to_prepare do
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
MESSAGE
|
11
|
+
Rails.application.reloader.to_prepare do
|
12
|
+
ActiveOutbox.configure do |config|
|
13
|
+
config.outbox_mapping = {
|
14
|
+
'default' => <outbox model name>
|
15
|
+
}
|
16
|
+
end
|
17
|
+
end
|
18
|
+
MESSAGE
|
20
19
|
end
|
21
20
|
end
|
22
21
|
end
|
@@ -1,16 +1,19 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
1
3
|
require 'rails'
|
2
4
|
require 'rails/generators'
|
3
5
|
require 'rails/generators/active_record'
|
4
6
|
|
5
|
-
class
|
6
|
-
|
7
|
+
class ActiveOutboxGenerator < ActiveRecord::Generators::Base
|
8
|
+
include ActiveOutbox::AdapterHelper
|
9
|
+
source_root File.expand_path('templates', __dir__)
|
7
10
|
|
8
11
|
class_option :root_components_path, type: :string, default: Rails.root
|
9
12
|
|
10
13
|
def create_migration_files
|
11
14
|
migration_path = "#{options['root_components_path']}/db/migrate"
|
12
15
|
migration_template(
|
13
|
-
|
16
|
+
'migration.rb',
|
14
17
|
"#{migration_path}/outbox_create_#{table_name}.rb",
|
15
18
|
migration_version: migration_version
|
16
19
|
)
|
@@ -23,16 +26,4 @@ class OutboxGenerator < ActiveRecord::Generators::Base
|
|
23
26
|
def table_name
|
24
27
|
"#{name}_outboxes"
|
25
28
|
end
|
26
|
-
|
27
|
-
def uuid_type
|
28
|
-
postgres? ? 'uuid' : 'string'
|
29
|
-
end
|
30
|
-
|
31
|
-
def json_type
|
32
|
-
postgres? ? 'jsonb' : 'string'
|
33
|
-
end
|
34
|
-
|
35
|
-
def postgres?
|
36
|
-
ActiveRecord::Base.connection.adapter_name.downcase == 'postgresql'
|
37
|
-
end
|
38
29
|
end
|
@@ -24,36 +24,23 @@ module ActiveOutbox
|
|
24
24
|
end
|
25
25
|
|
26
26
|
def save(**options, &block)
|
27
|
-
|
28
|
-
@outbox_event = options[:outbox_event].underscore.upcase
|
29
|
-
end
|
30
|
-
|
27
|
+
assign_outbox_event(options)
|
31
28
|
super(**options, &block)
|
32
29
|
end
|
33
30
|
|
34
31
|
def save!(**options, &block)
|
35
|
-
|
36
|
-
@outbox_event = options[:outbox_event].underscore.upcase
|
37
|
-
end
|
38
|
-
|
32
|
+
assign_outbox_event(options)
|
39
33
|
super(**options, &block)
|
40
34
|
end
|
41
35
|
|
42
36
|
private
|
43
37
|
|
38
|
+
def assign_outbox_event(options)
|
39
|
+
@outbox_event = options[:outbox_event].underscore.upcase if options[:outbox_event].present?
|
40
|
+
end
|
41
|
+
|
44
42
|
def create_outbox!(action, event_name)
|
45
|
-
|
46
|
-
*namespace, klass = self.class.name.underscore.upcase.split('/')
|
47
|
-
namespace = namespace.reverse.join('.')
|
48
|
-
outbox_model_name = ActiveOutbox.configuration.outbox_mapping[self.class.module_parent.name.underscore] ||
|
49
|
-
ActiveOutbox.configuration.outbox_mapping['default']
|
50
|
-
raise OutboxClassNotFoundError if outbox_model_name.nil?
|
51
|
-
|
52
|
-
outbox_model = outbox_model_name.safe_constantize
|
53
|
-
self.class.module_parent.const_set('OUTBOX_MODEL', outbox_model)
|
54
|
-
end
|
55
|
-
|
56
|
-
outbox = self.class.module_parent.const_get('OUTBOX_MODEL').new(
|
43
|
+
outbox = outbox_model.new(
|
57
44
|
aggregate: self.class.name,
|
58
45
|
aggregate_identifier: try(:identifier) || id,
|
59
46
|
event: @outbox_event || event_name,
|
@@ -62,41 +49,59 @@ module ActiveOutbox
|
|
62
49
|
)
|
63
50
|
@outbox_event = nil
|
64
51
|
|
65
|
-
if outbox.invalid?
|
66
|
-
|
67
|
-
|
68
|
-
|
52
|
+
handle_outbox_errors(outbox) if outbox.invalid?
|
53
|
+
outbox.save!
|
54
|
+
end
|
55
|
+
|
56
|
+
def outbox_model
|
57
|
+
module_parent = self.class.module_parent
|
58
|
+
|
59
|
+
unless module_parent.const_defined?('OUTBOX_MODEL')
|
60
|
+
outbox_model = outbox_model_name!.safe_constantize
|
61
|
+
module_parent.const_set('OUTBOX_MODEL', outbox_model)
|
69
62
|
end
|
70
63
|
|
71
|
-
|
64
|
+
module_parent.const_get('OUTBOX_MODEL')
|
72
65
|
end
|
73
66
|
|
74
|
-
def
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
67
|
+
def outbox_model_name!
|
68
|
+
namespace_outbox_mapping || default_outbox_mapping || raise(OutboxClassNotFoundError)
|
69
|
+
end
|
70
|
+
|
71
|
+
def namespace_outbox_mapping
|
72
|
+
namespace = self.class.name.split('/').first
|
73
|
+
|
74
|
+
ActiveOutbox.configuration.outbox_mapping[namespace&.underscore]
|
75
|
+
end
|
76
|
+
|
77
|
+
def default_outbox_mapping
|
78
|
+
ActiveOutbox.configuration.outbox_mapping['default']
|
79
|
+
end
|
80
|
+
|
81
|
+
def handle_outbox_errors(outbox)
|
82
|
+
outbox.errors.each do |error|
|
83
|
+
errors.import(error, attribute: "outbox.#{error.attribute}")
|
81
84
|
end
|
82
85
|
end
|
83
86
|
|
84
|
-
def
|
85
|
-
payload =
|
87
|
+
def formatted_payload(action)
|
88
|
+
payload = construct_payload(action)
|
89
|
+
AdapterHelper.postgres? ? payload : payload.to_json
|
90
|
+
end
|
91
|
+
|
92
|
+
def construct_payload(action)
|
86
93
|
case action
|
87
94
|
when :create
|
88
|
-
|
95
|
+
{ before: nil, after: as_json }
|
89
96
|
when :update
|
90
|
-
# previous_changes => { 'name' => ['bob', 'robert'] }
|
91
97
|
changes = previous_changes.transform_values(&:first)
|
92
|
-
|
93
|
-
payload[:after] = as_json
|
98
|
+
{ before: as_json.merge(changes), after: as_json }
|
94
99
|
when :destroy
|
95
|
-
|
100
|
+
{ before: as_json, after: nil }
|
96
101
|
else
|
97
|
-
raise ActiveRecord::RecordNotSaved.new("Failed to create Outbox payload for #{self.class.name}: #{identifier}",
|
102
|
+
raise ActiveRecord::RecordNotSaved.new("Failed to create Outbox payload for #{self.class.name}: #{identifier}",
|
103
|
+
self)
|
98
104
|
end
|
99
|
-
payload
|
100
105
|
end
|
101
106
|
end
|
102
107
|
end
|
data/lib/active_outbox.rb
CHANGED
@@ -1,5 +1,8 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
require 'active_outbox/adapter_helper'
|
1
4
|
require 'active_outbox/configuration'
|
2
5
|
require 'active_outbox/errors'
|
6
|
+
require 'active_outbox/generators/active_outbox_generator'
|
3
7
|
require 'active_outbox/outboxable'
|
4
|
-
require 'active_outbox/generators/outbox_generator'
|
5
8
|
require 'active_outbox/railtie' if defined?(Rails::Railtie)
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: active_outbox
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.0.
|
4
|
+
version: 0.0.3
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Guillermo Aguirre
|
8
|
-
autorequire:
|
8
|
+
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2023-
|
11
|
+
date: 2023-10-20 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: rails
|
@@ -16,113 +16,15 @@ dependencies:
|
|
16
16
|
requirements:
|
17
17
|
- - "~>"
|
18
18
|
- !ruby/object:Gem::Version
|
19
|
-
version: '
|
19
|
+
version: '6.1'
|
20
20
|
type: :runtime
|
21
21
|
prerelease: false
|
22
22
|
version_requirements: !ruby/object:Gem::Requirement
|
23
23
|
requirements:
|
24
24
|
- - "~>"
|
25
25
|
- !ruby/object:Gem::Version
|
26
|
-
version: '
|
27
|
-
|
28
|
-
name: pry-rails
|
29
|
-
requirement: !ruby/object:Gem::Requirement
|
30
|
-
requirements:
|
31
|
-
- - "~>"
|
32
|
-
- !ruby/object:Gem::Version
|
33
|
-
version: 0.3.6
|
34
|
-
type: :development
|
35
|
-
prerelease: false
|
36
|
-
version_requirements: !ruby/object:Gem::Requirement
|
37
|
-
requirements:
|
38
|
-
- - "~>"
|
39
|
-
- !ruby/object:Gem::Version
|
40
|
-
version: 0.3.6
|
41
|
-
- !ruby/object:Gem::Dependency
|
42
|
-
name: reek
|
43
|
-
requirement: !ruby/object:Gem::Requirement
|
44
|
-
requirements:
|
45
|
-
- - "~>"
|
46
|
-
- !ruby/object:Gem::Version
|
47
|
-
version: 6.0.6
|
48
|
-
type: :development
|
49
|
-
prerelease: false
|
50
|
-
version_requirements: !ruby/object:Gem::Requirement
|
51
|
-
requirements:
|
52
|
-
- - "~>"
|
53
|
-
- !ruby/object:Gem::Version
|
54
|
-
version: 6.0.6
|
55
|
-
- !ruby/object:Gem::Dependency
|
56
|
-
name: rspec-rails
|
57
|
-
requirement: !ruby/object:Gem::Requirement
|
58
|
-
requirements:
|
59
|
-
- - "~>"
|
60
|
-
- !ruby/object:Gem::Version
|
61
|
-
version: 3.8.0
|
62
|
-
type: :development
|
63
|
-
prerelease: false
|
64
|
-
version_requirements: !ruby/object:Gem::Requirement
|
65
|
-
requirements:
|
66
|
-
- - "~>"
|
67
|
-
- !ruby/object:Gem::Version
|
68
|
-
version: 3.8.0
|
69
|
-
- !ruby/object:Gem::Dependency
|
70
|
-
name: rubocop
|
71
|
-
requirement: !ruby/object:Gem::Requirement
|
72
|
-
requirements:
|
73
|
-
- - "~>"
|
74
|
-
- !ruby/object:Gem::Version
|
75
|
-
version: 1.22.0
|
76
|
-
type: :development
|
77
|
-
prerelease: false
|
78
|
-
version_requirements: !ruby/object:Gem::Requirement
|
79
|
-
requirements:
|
80
|
-
- - "~>"
|
81
|
-
- !ruby/object:Gem::Version
|
82
|
-
version: 1.22.0
|
83
|
-
- !ruby/object:Gem::Dependency
|
84
|
-
name: simplecov
|
85
|
-
requirement: !ruby/object:Gem::Requirement
|
86
|
-
requirements:
|
87
|
-
- - "~>"
|
88
|
-
- !ruby/object:Gem::Version
|
89
|
-
version: 0.17.1
|
90
|
-
type: :development
|
91
|
-
prerelease: false
|
92
|
-
version_requirements: !ruby/object:Gem::Requirement
|
93
|
-
requirements:
|
94
|
-
- - "~>"
|
95
|
-
- !ruby/object:Gem::Version
|
96
|
-
version: 0.17.1
|
97
|
-
- !ruby/object:Gem::Dependency
|
98
|
-
name: sqlite3
|
99
|
-
requirement: !ruby/object:Gem::Requirement
|
100
|
-
requirements:
|
101
|
-
- - '='
|
102
|
-
- !ruby/object:Gem::Version
|
103
|
-
version: 1.4.2
|
104
|
-
type: :development
|
105
|
-
prerelease: false
|
106
|
-
version_requirements: !ruby/object:Gem::Requirement
|
107
|
-
requirements:
|
108
|
-
- - '='
|
109
|
-
- !ruby/object:Gem::Version
|
110
|
-
version: 1.4.2
|
111
|
-
- !ruby/object:Gem::Dependency
|
112
|
-
name: byebug
|
113
|
-
requirement: !ruby/object:Gem::Requirement
|
114
|
-
requirements:
|
115
|
-
- - "~>"
|
116
|
-
- !ruby/object:Gem::Version
|
117
|
-
version: 11.1.3
|
118
|
-
type: :development
|
119
|
-
prerelease: false
|
120
|
-
version_requirements: !ruby/object:Gem::Requirement
|
121
|
-
requirements:
|
122
|
-
- - "~>"
|
123
|
-
- !ruby/object:Gem::Version
|
124
|
-
version: 11.1.3
|
125
|
-
description: A Transactional Outbox implementation for ActiveRecord
|
26
|
+
version: '6.1'
|
27
|
+
description:
|
126
28
|
email: guillermoaguirre1@gmail.com
|
127
29
|
executables:
|
128
30
|
- outbox
|
@@ -132,9 +34,10 @@ files:
|
|
132
34
|
- README.md
|
133
35
|
- bin/outbox
|
134
36
|
- lib/active_outbox.rb
|
37
|
+
- lib/active_outbox/adapter_helper.rb
|
135
38
|
- lib/active_outbox/configuration.rb
|
136
39
|
- lib/active_outbox/errors.rb
|
137
|
-
- lib/active_outbox/generators/
|
40
|
+
- lib/active_outbox/generators/active_outbox_generator.rb
|
138
41
|
- lib/active_outbox/generators/templates/migration.rb
|
139
42
|
- lib/active_outbox/outboxable.rb
|
140
43
|
- lib/active_outbox/railtie.rb
|
@@ -142,7 +45,7 @@ homepage: https://rubygems.org/gems/active_outbox
|
|
142
45
|
licenses:
|
143
46
|
- MIT
|
144
47
|
metadata: {}
|
145
|
-
post_install_message:
|
48
|
+
post_install_message:
|
146
49
|
rdoc_options: []
|
147
50
|
require_paths:
|
148
51
|
- lib
|
@@ -150,15 +53,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
|
|
150
53
|
requirements:
|
151
54
|
- - ">="
|
152
55
|
- !ruby/object:Gem::Version
|
153
|
-
version: '0'
|
56
|
+
version: '3.0'
|
154
57
|
required_rubygems_version: !ruby/object:Gem::Requirement
|
155
58
|
requirements:
|
156
59
|
- - ">="
|
157
60
|
- !ruby/object:Gem::Version
|
158
61
|
version: '0'
|
159
62
|
requirements: []
|
160
|
-
rubygems_version: 3.
|
161
|
-
signing_key:
|
63
|
+
rubygems_version: 3.4.10
|
64
|
+
signing_key:
|
162
65
|
specification_version: 4
|
163
|
-
summary:
|
66
|
+
summary: A Transactional Outbox implementation for ActiveRecord
|
164
67
|
test_files: []
|