FarNet.JsonKit 0.3.1

Prefix Reserved 
dotnet add package FarNet.JsonKit --version 0.3.1                

                    
                

            
NuGet\Install-Package FarNet.JsonKit -Version 0.3.1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="FarNet.JsonKit" Version="0.3.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add FarNet.JsonKit --version 0.3.1                

                    
                

            
#r "nuget: FarNet.JsonKit, 0.3.1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
// Install FarNet.JsonKit as a Cake Addin
#addin nuget:?package=FarNet.JsonKit&version=0.3.1

// Install FarNet.JsonKit as a Cake Tool
#tool nuget:?package=FarNet.JsonKit&version=0.3.1

FarNet.JsonKit

Far Manager JSON helpers

About

JsonKit is the FarNet module for JSON operations in Far Manager.

Project FarNet

Credits

Install

How to install and update FarNet and modules
https://github.com/nightroman/FarNet#readme

Commands

JsonKit commands start with jk:. Commands are invoked in the command line or using F11 / FarNet / Invoke or defined in the user menu and file associations. Command parameters are key=value pairs using the connection string format

jk:command key=value; ...

Commands

jk:open

Opens JSON in Array panel or Object panel.

Syntax

jk:open file=<string>; select=<string>

Parameters

  • file=<string> (optional)

    Specifies the JSON source file. Environment variables are expanded.

    If the parameter is omitted:

    • in file panels the panel cursor file is used
    • in JSON panels the panel JSON node is used for select

  • select=<string> (optional)

    Specifies the JSON path expression for selecting nodes. Selected nodes are shown in array or object panels.

    JSON path features: https://docs.json-everything.net/path/basics

Notes

Input files may have several JSON values separated by spaces, tabs, new lines. Such values are opened as an array without source, you cannot save changes.

Panels

Panels used for browsing and editing JSON

Array panel

Shows array values.

Keys and actions

  • Enter

    For arrays and objects, opens their panels.

  • F4

    Opens the cursor value editor.

  • Del, F8

    Removes selected items.

  • ShiftDel, ShiftF8

    Sets nulls to selected items.

  • CtrlS

    Saves JSON to the source file.

Object panel

Shows object property names and values.

Keys and actions

  • Enter

    For arrays and objects, opens their panels.

  • F4

    Opens the cursor value editor.

  • Del, F8

    Removes selected items.

  • ShiftDel, ShiftF8

    Sets nulls to selected items.

  • CtrlS

    Saves JSON to the source file.

Editing

In array and object panels, use the following keys for editing

  • F4 to edit the cursor item in the editor
  • Del, F8 to remove selected items
  • ShiftDel, ShiftF8 to set nulls

String values are opened in the editor as plain text. Strings cannot be changed to other JSON types in the editor. But you can set a string to null (ShiftDel, ShiftF8) in a panel and then edit this null.

Other nodes are opened in the editor as formatted JSON. This includes null, true, false, number, array, and object. Change this JSON to any valid JSON, same type or not.

Saving in the editor updates nodes in panels but does not yet save the file. You may have several nodes edited before saving the file.

Use CtrlS in panels in order to save the file. If you do not save manually then you are prompted to save when the root panel is about to close and JSON contains not saved changes.

Notes

Editors are not modal, you may have several nodes edited at the same time. You may keep editors after closing source panels. But if you plan saving changes in editors then do so before closing source panels, because JSON files are saved from panels.

Removing items in array and object panels detaches opened editors from the source. Saving changes in these editors is not possible.

  • Open from clipboard

    Opens JSON text or a file path like ".json" pasted from the clipboard.

  • Help

    Shows JsonKit help.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
0.3.1 40 12/18/2024
0.3.0 84 12/16/2024
0.2.4 76 12/15/2024
0.2.3 70 12/15/2024
0.2.2 72 12/14/2024
0.2.1 70 12/14/2024
0.2.0 79 12/13/2024
0.1.2 77 12/11/2024
0.1.1 68 12/10/2024
0.1.0 67 12/10/2024
0.0.2 85 12/8/2024
0.0.1 80 12/5/2024

https://github.com/nightroman/FarNet/blob/main/JsonKit/History.txt