Permission update

[Nazim-crim]

• Add optional key field and regex to be used in the sync_permissions section found in the config.
  This allows to sync permissions using a field other than resource_full_name when creating the name:type
  from the segment ex.: /field1::type1/field2::type2. Adds support to use resource_display_name.
• The regex is used to extract the desired information from the nametype_path. It should be used to do an
  exact match. This new search overrides the default way of matching each segment with the nametype_path.
  In the case where a regex is found in the target segment, the data will be formed using the same resource_type
  for every match in the same segment. Similary, as using - name: "**" in the config to match multiple segment,
  it is possible to use a regex to match multiple resources in the same segment with regex: '(?<=:).*\/?(?=\/)'

[github-actions]

Thanks for submitting a PR. Make sure you have looked at the contribution guidelines. Also, look for quick check/tests operations that you can run locally for early verification of errors. Travis will be happier if it doesn't need to run too many times with problematic code.

[fmigneault]

Make sure that all tests and checks pass in the CI.

Also, add at least 1 test that demonstrates and validates the new feature, so we can get a better understanding of what is expected, and to make sure that future updates don't break it either.

An example in https://github.com/Ouranosinc/cowbird/blob/master/config/config.example.yml (with a few comments for each step/new field) would be needed to indicate and explain this new capability.

[ChaamC]

Along with the changes required by @fmigneault (tests and config example update), the doc found in configuration.rst might be needing an update too.

[codecov]

Codecov Report

Attention: 1 lines in your changes are missing coverage. Please review.

Comparison is base (4a5e77d) 87.57% compared to head (9d25376) 87.76%.
Report is 12 commits behind head on master.

Files	Patch %	Lines
cowbird/permissions_synchronizer.py	97.67%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master      #46      +/-   ##
==========================================
+ Coverage   87.57%   87.76%   +0.19%     
==========================================
  Files          40       40              
  Lines        3211     3245      +34     
  Branches      471      480       +9     
==========================================
+ Hits         2812     2848      +36     
+ Misses        278      276       -2     
  Partials      121      121              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[ChaamC]

Good for me, nice job!