https://github.com/mrufsvold/expandnesteddata.jl

Unpacking nested data structures into Tables
https://github.com/mrufsvold/expandnesteddata.jl

Last synced: 4 months ago
JSON representation

Unpacking nested data structures into Tables

• Host: GitHub
• URL: https://github.com/mrufsvold/expandnesteddata.jl
• Owner: mrufsvold
• License: other
• Created: 2022-11-13T19:49:59.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2025-02-28T04:51:58.000Z (5 months ago)
• Last Synced: 2025-03-02T16:41:47.337Z (5 months ago)
• Language: Julia
• Homepage: https://mrufsvold.github.io/ExpandNestedData.jl/
• Size: 422 KB
• Stars: 13
• Watchers: 1
• Forks: 0
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# ExpandNestedData.jl

[![codecov](https://codecov.io/gh/mrufsvold/ExpandNestedData.jl/branch/main/graph/badge.svg?token=LQPXGYX4VC)](https://codecov.io/gh/mrufsvold/ExpandNestedData.jl)

### Documenation

[![Stable](https://img.shields.io/badge/docs-stable-blue.svg)](https://mrufsvold.github.io/ExpandNestedData.jl/stable)

[![Dev](https://img.shields.io/badge/docs-dev-blue.svg)](https://mrufsvold.github.io/ExpandNestedData.jl/dev)

#### Tl;Dr

```julia

using ExpandNestedData 

using JSON3

using DataFrames

message = JSON3.read("""

    {

        "a" : [

            {"b" : 1, "c" : 2},

            {"b" : 2},

            {"b" : [3, 4], "c" : 1},

            {"b" : []}

        ],

        "d" : 4

    }

    """

)

expand(message) |> DataFrame

```

#### Using Column Definitions

Use ColumnDefinitions to tightly control what gets added to the table and how it gets added.

```julia

column_defs = [

    ColumnDefinition([:d]; column_name = :ColumnD),

    ColumnDefinition([:a, :b]; flatten_arrays=true),

    ColumnDefinition([:e, :f]; column_name = :MissingColumn, default_value="Missing branch")

]

expand(message, column_defs) |> DataFrame

```

## Roadmap

- [x] Return a custom Table that allows nested and flattened access to columns

- [ ] Support for AbstractTree.jl input (This would enable composability with Gumbo.jl and others)

- [ ] Use custom Table as input for compressing tabular data to nested data

- [ ] Widen arrays so column names match XPath expressions

- [ ] Parse Xpath to ColumnDefinitions

- [ ] Dispatch on user-defined `get_keys` and `get_values` functions to traverse arbitrary custom types