Implementation of CLI interface

[ggbaro]

Is your feature request related to a problem? Please describe.
As showed in the README concept, we shall make the CLI interface.

Describe the solution you'd like
I usually adopt click, a modern and elegant CLI interface library.

Describe alternatives you've considered

• click - my favourite
• Argparse - the built-in python command parser
• Typer - based on Click (see above), takes it to the next level with modern typed python

Additional context

[ggbaro]

@LFK01 let's work together on this! What do you think?

[LFK01]

Yes, I'm happy to help on this issue. I'll work on this after we have completed the modelling of the matching problem.

In the meantime, I already have some doubts for the future.
How does python modules work when invoked from the CLI?
I'm used to have a main.py file or a file with the if name == 'main' wrapper called to be executed. How will the code of the python module be called?
I have little to no experience in python packaging so I will be satisfied with a partial quick answer and any reference to python documentation. Thank you in advance for the help :)

I asked ChatGPT for help. It suggested to specify an entry point in pyproject.toml or setup.py. I asked also for alternatives and it suggested flit among other third party libraries. Do we have any preference among these possible solutions?

[LFK01]

I've drafted the first version of the CLI in commit b193299 and ba96597. I'd like to receive any comments about the implemented functionalities and its correctness before creating a pull-request.

The command execution requires the package installation can be obtained with the following command inside the cloned repository directory:
pip install -e .
The -e flag allows the developer to change the code and observe the changes without reinstalling the package.
. is the cloned repository directory where pip will search for the pyproject.toml file.

I've tried it locally with the command inside the project folder:
swapanything tests/unit_test/data/faker_availabilities.csv output.csv --headers --index-col --subject-col "Nome e Cognome" --slot-col "Availabilities"

And it should print the selected matches in the file output.csv. Remember to delete or to exclude the file output.csv when committing to the branch or change its path to another position.

Thanks for any help or suggestion :)