https://github.com/mxcl/chuzzlekit
A chuzzled object is nil if it is falsy, otherwise it has its falsy parts removed.
https://github.com/mxcl/chuzzlekit
Last synced: over 1 year ago
JSON representation
A chuzzled object is nil if it is falsy, otherwise it has its falsy parts removed.
- Host: GitHub
- URL: https://github.com/mxcl/chuzzlekit
- Owner: mxcl
- License: mit
- Created: 2014-03-17T17:49:52.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2024-12-16T22:06:31.000Z (over 1 year ago)
- Last Synced: 2025-04-09T16:19:32.131Z (over 1 year ago)
- Language: Objective-C
- Homepage:
- Size: 32.2 KB
- Stars: 48
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.markdown
- License: LICENSE
Awesome Lists containing this project
README
# ChuzzleKit [](https://travis-ci.org/mxcl/ChuzzleKit)
A chuzzled object is nil if it is *falsy*, otherwise it has its *falsy* parts
removed.
For example:
* `@"".chuzzle` is `nil`
* Also `@" ".chuzzle` is `nil`
* And `@"\r\t".chuzzle` is `nil`
* `@" 2 ".chuzzle` is `@"2"`
* `@[].chuzzle` is `nil`
* `@[@"", @1].chuzzle` is `@[@1]`
* `[NSNull null].chuzzle` is `nil`
* `@{}.chuzzle` is `nil`
* `@{@1: @""}.chuzzle` is `nil`
* `@{@1: @"", @2: @" 2 "}.chuzzle` is `@{@2: @"2"}`
> Note that: `@" 2 3 "` chuzzles to: `@"2 3"`, that is, it only trims the string, it doesn’t eat the internal whitespace. This is because the “falsy” whitespace is just the trailing whitespace, not the internal whitespace. This is probably what you expected.
Mutable Chuzzling
=================
We removed mutable chuzzling. There are issues with adding category methods to mutable variants in Cocoa, which led to us having to enact hacks. However there were unexpected issues, eg: https://github.com/mxcl/ChuzzleKit/issues/3
Custom Chuzzling
================
All our `chuzzle` methods on container classes will call `chuzzle` on the objects they contain, if it is implemented.
So if you want to support recursive chuzzling on your own objects, simply implement a `chuzzle` method.
Making JSON PLIST-Compliant
===========================
Since `NSNull` cannot be encoded into a PLIST, a convenient (but by **no means** the primary) usage of ChuzzleKit is to make saving JSON to a plist not crash (eg. via `writeToFile:atomically`).
Stripping Strings
=================
`-chuzzle` can be a less enormous alternative to `-stringByTrimmingCharactersInSet:`, just don’t forget to expect `nil` in the response.