Recursively strip empty/null/zero values from JSON-like structures

json

clean

strip

null

recursive

Download zip

Author

0xA672

Version

0.1.2

License

Apache-2.0

Repository

codeberg.org/0xA672/strip

Last updated

4 months ago

Downloads

#0xA672/strip

A MoonBit library for recursively stripping empty, null, and zero values from JSON-like data structures.

#Installation

Add to your moon.mod.json:

{
  "deps": {
    "0xA672/strip": "main"
  }
}

Then run:

moon update

#Quick example

First, add to your moon.pkg:

import {
  "0xA672/strip" @strip
}

Then in your .mbt source:

///|
import {
  "moonbitlang/core/debug"
}

fn main {
  let input : @strip.Js = @strip.Ob(Map[String, Js]::of([
    ("name", @strip.St("Alice")),
    ("age", @strip.Nu(0.0)),
    ("address", @strip.Nl),
    ("hobbies", @strip.Ar([])),
    ("meta", @strip.Ob(Map[String, Js]::of([
      ("active", @strip.Bl(false)),
      ("score", @strip.Nu(0.0))
    ])))
  ]))

  let cleaned = @strip.strip(input, true)
  debug_inspect(cleaned)
  // Output: Ob({name: St("Alice"), meta: Ob({active: Bl(false)})})
}

💡 Note: The Js enum derives Debug (not Show) because standard library container types (Array, Map) have deprecated Show implementations. Use debug_inspect() or @debug.to_string() for output.

#API

#strip(v : Js, oz : Bool) -> Js

Recursively remove empty/null/zero elements. oz=true strips 0.0, false keeps it. Returns cleaned Js. Empty result defaults to Ob(Map([], capacity=0)).

#strip_null(v : Js) -> Js

Only removes Nl (null). Keeps "", 0.0, false, and empty containers.

#strip_empty(v : Js) -> Js

Removes Nl, "", and empty arrays/objects. Keeps 0.0 and false.

#What is considered "empty"?

Type	Stripped when
Nl	always
Ar([])	always or all children stripped
Ob({})	no fields left after cleaning
Nu(0.0)	oz == true in strip()
St("")	always in strip() / strip_empty()
Bl(_)	never

#Behavior details

Depth limit: Recursion capped at 1000
Immutable: Input is never mutated
Empty fallback: Fully cleaned tree returns Ob(Map([], capacity=0))

#Building & testing

moon build
moon test
moon fmt

#License

Apache-2.0

Js

source

pub(all) enum Js {
  Nl
  Bl(Bool)
  Nu(Double)
  St(String)
  Ar(Array[Js])
  Ob(Map[String, Js])
} derive(@moonbitlang/core/debug.Debug
Debug)

strip

source

fn strip(v : Js, oz : Bool) -> Js

strip_empty

source

fn strip_empty(v : Js) -> Js

strip_null

source

fn strip_null(v : Js) -> Js

Source Files

strip.mbt

Site source Report issue Packages Build queue Skills Statistics

strip

#0xA672/strip

#Installation

#Quick example

#API

#strip(v : Js, oz : Bool) -> Js

#strip_null(v : Js) -> Js

#strip_empty(v : Js) -> Js

#What is considered "empty"?

#Behavior details

#Building & testing

#License

#Js

#strip

#strip_empty

#strip_null

Source Files

Js

strip

strip_empty

strip_null