utilize pathlib.Path instead of os.path.join()

[doc-sheet]

SUMMARY

Call pathlib.Path() instead of os.path.join() from path_join filter because of better handle of subdirectories.

It is now possible to call {{ path1~'/'~path2 | path_join }} to merge multiple path fragments without need to sanitize occasion slash characters.

Result converted to posix path to keep compatibility and old behavior.
e.g.

{{ ('c:', 'fsff') | path_join  }} -> c:/fsff

ISSUE TYPE

• Feature Pull Request

ADDITIONAL INFORMATION

Currently to merge multiple path fragments with a nice single delimiter we need to do something like this:

{{ ('/opt', app, subpath | string | trim('/')) | path_join }}

Assuming app = 'myapp' and subpath anything good to be a path.
For example /var/lib/myapp/data

After this change it is safe to write

{{ '/opt/'~app~'/'~subpath | path_join }}
# or
{{ ('/opt', app~'/'~subpath) | path_join }}

# simple concatenation of strings ('/opt/'~app~'/'~subpath)
/opt/myapp//var/lib/myapp/data

# old path_join with trim or just new path_join
/opt/myapp/var/lib/myapp/data

[doc-sheet]

ready_for_review

[doc-sheet]

ready_for_review

[mattclay]

@doc-sheet It looks like what you want is the normpath filter:

    - debug:
        msg: "{{ 'path/with//extra///slashes////' | normpath }}"

ok: [localhost] => {
    "msg": "path/with/extra/slashes"
}

[doc-sheet]

Not quite, I don't want to mutate original string more then just clear double slashes

>>> os.path.normpath('asdasd/../fdsfs')
'fdsfs'

>>> Path('asdasd/../fdsfs').as_posix()
'asdasd/../fdsfs'

But I'll try normpath too, thanks for reminder!