6257ddba78
The big change is that the GeoJSON package has been completely rewritten to fix a few of geometry calculation bugs, increase performance, and to better follow the GeoJSON spec RFC 7946. GeoJSON updates - A LineString now requires at least two points. - All json members, even foreign, now persist with the object. - The bbox member persists too but is no longer used for geometry calculations. This is change in behavior. Previously Tile38 would treat the bbox as the object's physical rectangle. - Corrections to geometry intersects and within calculations. Faster spatial queries - The performance of Point-in-polygon and object intersect operations are greatly improved for complex polygons and line strings. It went from O(n) to roughly O(log n). - The same for all collection types with many children, including FeatureCollection, GeometryCollection, MultiPoint, MultiLineString, and MultiPolygon. Codebase changes - The pkg directory has been renamed to internal - The GeoJSON internal package has been moved to a seperate repo at https://github.com/tidwall/geojson. It's now vendored. Please look out for higher memory usage for datasets using complex shapes. A complex shape is one that has 64 or more points. For these shapes it's expected that there will be increase of least 54 bytes per point.
125 lines
3.1 KiB
Markdown
125 lines
3.1 KiB
Markdown
# Pretty
|
|
[](https://travis-ci.org/tidwall/prettty)
|
|
[](http://gocover.io/github.com/tidwall/pretty)
|
|
[](https://godoc.org/github.com/tidwall/pretty)
|
|
|
|
|
|
Pretty is a Go package that provides [fast](#performance) methods for formatting JSON for human readability, or to compact JSON for smaller payloads.
|
|
|
|
Getting Started
|
|
===============
|
|
|
|
## Installing
|
|
|
|
To start using Pretty, install Go and run `go get`:
|
|
|
|
```sh
|
|
$ go get -u github.com/tidwall/pretty
|
|
```
|
|
|
|
This will retrieve the library.
|
|
|
|
## Pretty
|
|
|
|
Using this example:
|
|
|
|
```json
|
|
{"name": {"first":"Tom","last":"Anderson"}, "age":37,
|
|
"children": ["Sara","Alex","Jack"],
|
|
"fav.movie": "Deer Hunter", "friends": [
|
|
{"first": "Janet", "last": "Murphy", "age": 44}
|
|
]}
|
|
```
|
|
|
|
The following code:
|
|
```go
|
|
result = pretty.Pretty(example)
|
|
```
|
|
|
|
Will format the json to:
|
|
|
|
```json
|
|
{
|
|
"name": {
|
|
"first": "Tom",
|
|
"last": "Anderson"
|
|
},
|
|
"age": 37,
|
|
"children": ["Sara", "Alex", "Jack"],
|
|
"fav.movie": "Deer Hunter",
|
|
"friends": [
|
|
{
|
|
"first": "Janet",
|
|
"last": "Murphy",
|
|
"age": 44
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
## Color
|
|
|
|
Color will colorize the json for outputing to the screen.
|
|
|
|
```json
|
|
result = pretty.Color(json, nil)
|
|
```
|
|
|
|
Will add color to the result for printing to the terminal.
|
|
The second param is used for a customizing the style, and passing nil will use the default `pretty.TerminalStyle`.
|
|
|
|
## Ugly
|
|
|
|
The following code:
|
|
```go
|
|
result = pretty.Ugly(example)
|
|
```
|
|
|
|
Will format the json to:
|
|
|
|
```json
|
|
{"name":{"first":"Tom","last":"Anderson"},"age":37,"children":["Sara","Alex","Jack"],"fav.movie":"Deer Hunter","friends":[{"first":"Janet","last":"Murphy","age":44}]}```
|
|
```
|
|
|
|
|
|
## Customized output
|
|
|
|
There's a `PrettyOptions(json, opts)` function which allows for customizing the output with the following options:
|
|
|
|
```go
|
|
type Options struct {
|
|
// Width is an max column width for single line arrays
|
|
// Default is 80
|
|
Width int
|
|
// Prefix is a prefix for all lines
|
|
// Default is an empty string
|
|
Prefix string
|
|
// Indent is the nested indentation
|
|
// Default is two spaces
|
|
Indent string
|
|
// SortKeys will sort the keys alphabetically
|
|
// Default is false
|
|
SortKeys bool
|
|
}
|
|
```
|
|
## Performance
|
|
|
|
Benchmarks of Pretty alongside the builtin `encoding/json` Indent/Compact methods.
|
|
```
|
|
BenchmarkPretty-8 1000000 1283 ns/op 720 B/op 2 allocs/op
|
|
BenchmarkUgly-8 3000000 426 ns/op 240 B/op 1 allocs/op
|
|
BenchmarkUglyInPlace-8 5000000 340 ns/op 0 B/op 0 allocs/op
|
|
BenchmarkJSONIndent-8 300000 4628 ns/op 1069 B/op 4 allocs/op
|
|
BenchmarkJSONCompact-8 1000000 2469 ns/op 758 B/op 4 allocs/op
|
|
```
|
|
|
|
*These benchmarks were run on a MacBook Pro 15" 2.8 GHz Intel Core i7 using Go 1.7.*
|
|
|
|
## Contact
|
|
Josh Baker [@tidwall](http://twitter.com/tidwall)
|
|
|
|
## License
|
|
|
|
Pretty source code is available under the MIT [License](/LICENSE).
|
|
|