Fix/issue#186 path like support

[PProfizi]

#186
Add support for pathlib.Path and other os.PathLike objects as inputs for file paths.

• using in conftest.py:

from pathlib import Path
@pytest.fixture(params=[str, Path])
def allkindofcomplexity(request):
    """Resolve the path of the "allKindOfComplexity.rst" result file."""
    return request.param(examples.download_all_kinds_of_complexity())

to detect where tests fail due to a Path object being given instead of a string.

• modifying for them all to pass
• reverting the conftest and adding several selected tests where a Path is indeed given as input

[cbellot000]

@PProfizi could you please download the built doc out of the github actions and make sure that the API documentation of what you changed looks good? Because I'm afraid the "or" will not, since we always use ","

[PProfizi]

@cbellot000
Ok I'll change that. I started using "or" because a lot of times there was already "str, optional" and adding a coma seemed more confusing to me (like: "str, os.PathLike, optional").

[PProfizi]

@cbellot000 I found an example of docstring similar to what I did here:

fields_container (ansys.grpc.dpf.collection_pb2.Collection or FieldsContainer, optional)

in

class ansys.dpf.core.custom_fields_container.ElShapeFieldsContainer(fields_container=None, server=None)

[cbellot000]

you can make it simpler with:

if isinstance(a, (str, Path)) and len(str(a)) > 0:
    parts.append(str(a))

[PProfizi]

The thing is for an empty Path, its str representation is "." which is not of length==0, thus my choice of doing a separate test. If I understood correctly, this is to check the path is not empty (so an empty string OR an empty Path then?).

[PProfizi]

sorry, didnt ping you when replying @cbellot000

[jfthuong]

or we could do:

if isinstance(a, (str, Path)) and Path(a) != Path(""):
    ...

[PProfizi]

@jfthuong works for me! Modifying now.