I occurred to me after sleeping on it that making the `:root` suffix the 
default, and having another one like `;all` to toggle returning all 
sub-paths would be much more "backwards compatible" to exiting tiddlywiki 
markup/macros/etc.

I will me making that change as the 2.1.1 release.

Best,
Joshua F

On Monday, March 16, 2020 at 7:35:54 PM UTC-7, Joshua Fontany wrote:
>
> Hi everyone,
>
> I've worked a few bugs out and introduced a more flexible `indexes[]` 
> filter. Hopefully this will make jsonmangler robust enought for some really 
> cool projects.
>
> Looking forward to what people do with these new capabilities. I have 
> included a standard documentation tiddler for the new functions:
>
> https://joshuafontany.github.io/TW5-JsonMangler/#indexes%20Operator
>
> purpose select all data properties of the input titles (see output)
>> input <http://127.0.0.1:8080/JsonMangler#Filter%20Syntax> a selection of 
>> titles <http://127.0.0.1:8080/JsonMangler#Title%20Selection>
>> suffix <http://127.0.0.1:8080/JsonMangler#Filter%20Step> the indexes 
>> operator 
>> uses a rich suffix, see below for details
>> parameter <http://127.0.0.1:8080/JsonMangler#Filter%20Parameter> (optional) 
>> an index-path to a property in the data tiddler
>> output the property names or indices found at the tiddler or path 
>> location provided (only immediate properties are returned if the ":root" 
>> suffix is used)
>>
>> Each input title is processed in turn, and is ignored if it does not 
>> denote a data tiddler <http://127.0.0.1:8080/JsonMangler#DataTiddlers>. 
>> The list of property names is retrieved from the data tiddler (in no 
>> particular order) and then dominantly appended 
>> <http://127.0.0.1:8080/JsonMangler#Dominant%20Append> to the operator's 
>> output.
>>
>> Where a tiddler's content is JSON 
>> <http://127.0.0.1:8080/JsonMangler#JSONTiddlers>, the indexes operator 
>> uses an extended syntax:
>>
>> [indexes:root[<path>]]
>>
>>
>>    - root: a flag to only retrieve the immediate ("root") indexes from 
>>    the tiddler or path location
>>    - path: a slash-delimited index path (see the Read Me 
>>    
>> <http://127.0.0.1:8080/JsonMangler#%24%3A%2Fplugins%2Fjoshuafontany%2Fjsonmangler%2Freadme>
>>    )
>>
>> Examples 
>> <http://127.0.0.1:8080/JsonMangler#indexes%20Operator%20(Examples)>
>>
>
> There are Examples in the new demo wiki as well.
>
> Download the source or *.zip over on GitHub:
>
> https://github.com/joshuafontany/TW5-JsonMangler
>
> Best,
> Joshua Fontany
>

-- 
You received this message because you are subscribed to the Google Groups 
"TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to tiddlywiki+unsubscr...@googlegroups.com.
To view this discussion on the web visit 
https://groups.google.com/d/msgid/tiddlywiki/e90d8412-9e5d-46de-94e8-72c5d0545104%40googlegroups.com.

Reply via email to