Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/muhammadmuzzammil1998/jsonc
JSON with comments for Go!
https://github.com/muhammadmuzzammil1998/jsonc
golang gopkg json jsonc
Last synced: 1 day ago
JSON representation
JSON with comments for Go!
- Host: GitHub
- URL: https://github.com/muhammadmuzzammil1998/jsonc
- Owner: muhammadmuzzammil1998
- License: mit
- Created: 2019-09-01T15:18:25.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2024-02-09T21:02:46.000Z (11 months ago)
- Last Synced: 2024-12-15T12:04:35.354Z (9 days ago)
- Topics: golang, gopkg, json, jsonc
- Language: Go
- Size: 1 MB
- Stars: 199
- Watchers: 5
- Forks: 21
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
#
![jsonc](.github/images/jsonc.png)
JSONC is a superset of JSON which supports comments. JSON formatted files are readable to humans but the lack of comments decreases readability. With JSONC, you can use block (`/* */`) and single line (`//` of `#`) comments to describe the functionality. Microsoft VS Code also uses this format in their configuration files like `settings.json`, `keybindings.json`, `launch.json`, etc.
![jsonc](.github/images/carbon.png)
## What this package offers
**JSONC for Go** offers ability to convert and unmarshal JSONC to pure JSON. It also provides functionality to read JSONC file from disk and return JSONC and corresponding JSON encoding to operate on. However, it only provides a one way conversion. That is, you can not generate JSONC from JSON. Read [documentation](.github/DOCUMENTATION.md) for detailed examples.
## Usage
### `go get` it
Run `go get` command to install the package.
```sh
$ go get muzzammil.xyz/jsonc
```### Import jsonc
Import `muzzammil.xyz/jsonc` to your source file.
```go
package mainimport (
"fmt""muzzammil.xyz/jsonc"
)
```### Test it
Now test it!
```go
func main() {
j := []byte(`{"foo": /*comment*/ "bar"}`)
jc := jsonc.ToJSON(j) // Calling jsonc.ToJSON() to convert JSONC to JSON
if jsonc.Valid(jc) {
fmt.Println(string(jc))
} else {
fmt.Println("Invalid JSONC")
}
}
``````sh
$ go run app.go
{"foo":"bar"}
```## Contributions
Contributions are welcome but kindly follow the Code of Conduct and guidelines. Please don't make Pull Requests for typographical errors, grammatical mistakes, "sane way" of doing it, etc. Open an issue for it. Thanks!
### Contributors