nested_objects 0.1.16 → 0.1.17
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
- data/.release-please-manifest.json +1 -1
- data/CHANGELOG.md +7 -0
- data/README.md +31 -46
- data/lib/nested_objects/version.rb +1 -1
- metadata +3 -3
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 83ade50105b58330d52486368bf31c36396ad6f12e135418bfb04be50b863764
|
4
|
+
data.tar.gz: e0fbfb421c4a4370cca8ff5660913baec9e8338b0a2a74d9a52b9c19003fa77e
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 620c0900e01d2244c73159559e769a9f133dfba49b9caadb7bb306d7b18a13275ff150bdf28551592e62fb517796ec1c5f71907f6a5edb7e32a06779d6cc82e7
|
7
|
+
data.tar.gz: 8c0d7bc25ddf9fdef17def566c8fa850a7842ee7505590a3372525fc73ab9b901886d66d52338f4f4c53221cb6e6df06a2d76bc027f799e735ccf193a35dae78
|
data/CHANGELOG.md
CHANGED
@@ -1,5 +1,12 @@
|
|
1
1
|
# Changelog
|
2
2
|
|
3
|
+
## [0.1.17](https://github.com/main-branch/nested_objects/compare/v0.1.16...v0.1.17) (2025-04-27)
|
4
|
+
|
5
|
+
|
6
|
+
### Other Changes
|
7
|
+
|
8
|
+
* Update online yardoc links and simplify readme ([5777d3e](https://github.com/main-branch/nested_objects/commit/5777d3e6a643d3d14c05b1b699a20b0f9fdebebd))
|
9
|
+
|
3
10
|
## [0.1.16](https://github.com/main-branch/nested_objects/compare/v0.1.15...v0.1.16) (2025-04-27)
|
4
11
|
|
5
12
|
|
data/README.md
CHANGED
@@ -2,72 +2,57 @@
|
|
2
2
|
|
3
3
|
[](https://badge.fury.io/rb/nested_objects)
|
4
4
|
[](https://github.com/main-branch/nested_objects/actions/workflows/continuous_integration.yml)
|
5
|
-
[](https://
|
5
|
+
[](https://gemdocs.org/gems/nested_objects)
|
6
6
|
[](https://rubydoc.info/gems/nested_objects/file/CHANGELOG.md)
|
7
7
|
[](https://main-branch.slack.com/archives/C01CHR7TMM2)
|
8
8
|
|
9
|
-
The `NestedObjects` module provides module
|
9
|
+
The `NestedObjects` module provides module methods to safely navigate and
|
10
10
|
manage a heirarchy of Ruby POROs nested using Hashes or Arrays. Think of these
|
11
11
|
nested data objects like what you would get after reading in a JSON file.
|
12
12
|
|
13
|
-
|
13
|
+
## Usage
|
14
14
|
|
15
|
-
|
16
|
-
values and array elements
|
17
|
-
* `NestedObjects.dig(data, path)` - returns the value at the given path
|
18
|
-
* `NestedObjects.bury(data, path, value)` - sets a value within the data structure at
|
19
|
-
the given path
|
20
|
-
* `NestedObjects.delete(data, path)` - deletes the Hash key or Array index at the
|
21
|
-
given path
|
22
|
-
* `NestedObjects.path?(data, path)` - returns true if the path exists in the given
|
23
|
-
data structure
|
15
|
+
### Module Methods
|
24
16
|
|
25
|
-
These methods
|
26
|
-
`
|
17
|
+
These methods are exposted on the `NestedObjects` module. The key methods are:
|
18
|
+
`deep_copy`, `dig`, `bury`, `delete`, and `path?`.
|
27
19
|
|
28
|
-
|
29
|
-
Object.include NestedObjects::Mixin
|
20
|
+
Here is an example of using the `dig` method:
|
30
21
|
|
31
|
-
|
22
|
+
```Ruby
|
23
|
+
require 'nested_objects'
|
32
24
|
|
33
|
-
data
|
25
|
+
data = { 'people' => [{ 'name' => 'John'}, { 'name', 'Jane' }] }
|
26
|
+
path = 'people/0/name'.split('/')
|
27
|
+
NestedObjects.dig(data, path) #=> 'John'
|
34
28
|
```
|
35
29
|
|
36
|
-
|
37
|
-
|
38
|
-
## Development
|
39
|
-
|
40
|
-
After checking out the repo, run `bin/setup` to install dependencies. Then, run
|
41
|
-
`bundle exec rake` to run tests, static analysis, and build the gem.
|
42
|
-
|
43
|
-
For experimentation, you can also run `bin/console` for an interactive (IRB) prompt that
|
44
|
-
automatically requires nested_objects.
|
30
|
+
See documentation and examples of the full API in
|
31
|
+
[the gem's YARD documentation](https://gemdocs.org/gems/nested_objects/).
|
45
32
|
|
46
|
-
|
47
|
-
|
48
|
-
Bug reports and pull requests are welcome on GitHub at <https://github.com/main-branch/nested_objects>.
|
33
|
+
### Object Mixin
|
49
34
|
|
50
|
-
|
35
|
+
As a convenience, these methods can be mixed into other classes by including the `NestedObjects::Mixin` module.
|
51
36
|
|
52
|
-
|
53
|
-
standard](https://www.conventionalcommits.org/en/v1.0.0/). This helps us maintain a
|
54
|
-
clear and structured commit history, automate versioning, and generate changelogs
|
55
|
-
effectively.
|
37
|
+
In order to reduce the possibility of method name conflicts, all methods are prefixed with `nested_`.
|
56
38
|
|
57
|
-
|
39
|
+
```Ruby
|
40
|
+
Object.include NestedObjects::Mixin
|
58
41
|
|
59
|
-
|
42
|
+
data = { 'people' => [{ 'name' => 'John'}, { 'name', 'Jane' }] }
|
43
|
+
path = 'people/0/name'.split('/')
|
44
|
+
data.nested_dig(path) #=> 'John'
|
45
|
+
```
|
60
46
|
|
61
|
-
|
47
|
+
## Development
|
62
48
|
|
63
|
-
|
64
|
-
|
49
|
+
After checking out the repo, run `bin/setup` to install dependencies. Then, run
|
50
|
+
`bundle exec rake` to run tests, static analysis, and build the gem.
|
65
51
|
|
66
|
-
|
67
|
-
|
52
|
+
For experimentation, you can also run `bin/console` for an interactive (IRB) prompt
|
53
|
+
that automatically requires nested_objects.
|
68
54
|
|
69
|
-
|
55
|
+
## Contributing
|
70
56
|
|
71
|
-
|
72
|
-
|
73
|
-
history clean and meaningful.
|
57
|
+
See [the contributing guildlines](CONTRIBUTING.md) for guidance on how to contriute
|
58
|
+
to this project.
|
metadata
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: nested_objects
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.1.
|
4
|
+
version: 0.1.17
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- James Couball
|
@@ -218,8 +218,8 @@ metadata:
|
|
218
218
|
allowed_push_host: https://rubygems.org
|
219
219
|
homepage_uri: https://github.com/main-branch/nested_objects
|
220
220
|
source_code_uri: https://github.com/main-branch/nested_objects
|
221
|
-
documentation_uri: https://
|
222
|
-
changelog_uri: https://
|
221
|
+
documentation_uri: https://gemdocs.org/nested_objects/0.1.17
|
222
|
+
changelog_uri: https://gemdocs.org/nested_objects/0.1.17/file.CHANGELOG.md
|
223
223
|
rubygems_mfa_required: 'true'
|
224
224
|
rdoc_options: []
|
225
225
|
require_paths:
|