feat: Filter would be exported entries based on JSONPath filter expression

[davidandreoletti]

Here is an example, for imported entries with a 'tags' field, one can only export entries with tag value containing 'Defaults'.

This filter is independent of the input file format used as it runs prior to exporting entries to the target password manager.

pass-import --force --verbose --filter
'$.entries[*].tags[?@="Defaults"]' csv 1password /tmp/1Password.1pif/data.1pif --out /tmp/data.csv

Tested on:

• 1password 1PIF format manually
• generic password manager automatically (see unit test)

Documentation:

• --help documentation updated. The helper function seems not to support a long form description. The doc is added to the help field instead.
• README --help updated too.

[roddhjav]

Thanks. Nice feature.

Can you make jsonpath_ng an optional requirement. As it is only supported in 1password, I don't want to require it as a strict deps.

[davidandreoletti]

It was tested on 1Password but the logic is password manager independent.

See unit test.

With this filter feature, people can filter on anything data field exported.

I filtered on tags and used 1Password as it is my use case.

Let me know if your POV changed.

[roddhjav]

I would rather keep it optional for now (I am the one getting the issue regarding missing deps...)

[davidandreoletti]

Got it. There it is fixed.

[roddhjav]

Thanks. Merged

Edit: I was a bit fast to merge, now that I have fixed the CI, your PR seems to have some edge case: https://github.com/roddhjav/pass-import/actions/runs/7641446941/job/20818786230

[davidandreoletti]

Will look into it today and address the changes is #209