Go to file
TheSecEng 6470be6750
fix: jq query selection clear
2020-04-17 14:42:28 -04:00
.github/workflows implement: travis → github actions 2020-04-16 08:49:10 -04:00
lib/simplejson remove: simplejson tool.py 2020-04-15 19:24:37 -04:00
tests implement: travis → github actions 2020-04-16 08:49:10 -04:00
.gitattributes implement: travis → github actions 2020-04-16 08:49:10 -04:00
.gitignore update settings and .gitignore 2020-04-14 16:58:03 -04:00
.python-version implement: type hinting 2020-04-15 19:09:43 -04:00
Default (Linux).sublime-keymap implement: jq live filtering 2020-04-17 14:37:05 -04:00
Default (OSX).sublime-keymap implement: jq live filtering 2020-04-17 14:37:05 -04:00
Default (Windows).sublime-keymap implement: jq live filtering 2020-04-17 14:37:05 -04:00
Default.sublime-commands implement: jq live filtering 2020-04-17 14:37:05 -04:00
LICENSE #52 ~ adding MIT license https://tldrlegal.com/license/mit-license 2016-07-14 17:12:24 +02:00
Main.sublime-menu fix: remove mnemonic caption overrides of Package Control 2020-04-15 19:28:59 -04:00
Pretty JSON.sublime-settings implement: jq live filtering 2020-04-17 14:37:05 -04:00
PrettyJson.py fix: jq query selection clear 2020-04-17 14:42:28 -04:00
PrettyJsonListeners.py implement: type hinting 2020-04-15 19:09:43 -04:00
README.md Added another way to reindent, based in the current line indentation. Added docs about how to configure the reindent_block setting 2017-11-20 18:03:11 -06:00
phantom.css implement: travis → github actions 2020-04-16 08:49:10 -04:00
pyproject.toml fix: double quote to single quote 2020-04-15 16:06:58 -04:00

README.md

Build Status

Prettify/Minify/Query/Goto/Validate/Lint JSON plugin for Sublime Text 2 & 3

Installation

Install this sublime text 2/3 package via Package Control search for package: "Pretty JSON"

or manually install

  • cd <Packages directory> (for example on Mac it is ~/Library/Application\ Support/Sublime\ Text\ 2/Packages or ~/Library/Application\ Support/Sublime\ Text\ 3/Packages)
  • git clone https://github.com/dzhibas/SublimePrettyJson.git

Usage

To prettify JSON, make selection of json (or else it will try to use full view buffer) and press keys:

  • Linux: ctrl+alt+j
  • Windows: ctrl+alt+j
  • OS X: cmd+ctrl+j

or through Command Palette Ctrl+Shift+P find "Pretty JSON: Format (Pretty Print) JSON" (you can search for part of it like 'pretty format')

If selection is empty and configuration entry use_entire_file_if_no_selection is true, tries to prettify whole file

If JSON is not valid it will be displayed in status bar of Sublime Text

Validate JSON

Using Command Palette Ctrl+Shift+P find "Pretty JSON: Validate" (you can search for partial string 'validate') this will validate selection or full file and will show in dialog if it's valid or invalid. In case of found errors view will jump to error and will highlight it

Compress / Minify JSON

Using Command Palette Ctrl+Shift+P find "Pretty JSON: Minify (compress) JSON" (you can search for part of it like 'json minify') this will make selection or full buffer as single line JSON which later you can use in command lines (curl/httpie) or somewhere else...

To map a key combination like Ctrl+Alt+M to the Minify command, you can add a setting like this to your .sublime-keymap file (eg: Packages/User/Default (Windows).sublime-keymap):

  { "keys": [ "ctrl+alt+m" ], "command": "un_pretty_json" }

Convert JSON to XML

Using Command Palette Ctrl+Shift+P search fo "Pretty JSON: JSON 2 XML" (you can search for part of it like '2XML') this will convert your selected JSON of full buffer to XML and replace syntax and buffer to XML output

./jQ query/filter usage

Demo:

Demo

If on your machine "./jq" tool is available with ctrl+atl+shift+j you can run against your json. output will be opened in new view so you can once again apply jq on new buffer

You can find instructions of tool here:

http://stedolan.github.io/jq/

Default configuration

use_entire_file_if_no_selection - true

indent - 2

int used for how many spaces to use for indent, replace it with value "\t" and tabs will be used instead

sort_keys - false

ensure_ascii - false

line_separator - ","

value_separator - ": "

value separator in config, so if you need to get rid of extra space you can remove it with this param

keep_arrays_single_line - false

if we need to re-structure arrays and make them single-line

max_arrays_line_length - 120

if array for example '["a", "b", 123213, ....]' length will reach max it will be kept multi-line (for beauty)

pretty_on_save - false

do we need to automatically Pretty JSON on save

validate_on_save - true

do we need validate JSON files on each save

reindent_block - false

if we are formatting a selection, if we need to reindent the
resulting block to follow the flow of the source document
the posible values are 'minimal' and 'start'

using `minimal`, the resulting json lines are indented as much
spaces as the line where the selection starts. e.g

    yaml_container:
      yaml_key: { "json": "value" }

gets formatted as:

    yaml_container:
        yaml_key: {
          "json": "value"
        }

using `start`, the resulting json lines are indented a number
of spaces equal to the column number of the start of the selection

with `start` the previous example gets formatted as:

    yaml_container:
        yaml_key: {
                    "json": "value"
                  }

Using tabs for indentation

You can change configuration key indent to string value "\t" or any other string

"indent" : "\t",

Be sure "Indent Using Spaces" is unchecked otherwise you will not see effect and ST2/3 will convert it back to spaces

Thanks

Others

If you YAMLing then maybe you interested in this plugin: https://github.com/aukaost/SublimePrettyYAML