feat: allow passing strings to the converter from the terminal

[germa89]

Description

As the title, so we can do:

This example demonstrates the main use of this tool:

$ pymapdl convert -f mapdl.dat -o python.py

If you omit the output argument, the converted code is shown on the screen.

You can use any option from ansys.mapdl.core.convert.convert_apdl_block function:

$ pymapdl convert -f mapdl.dat --auto-exit False
\"\"\"Script generated by ansys-mapdl-core version 0.69.dev0\"\"\"

from ansys.mapdl.core import launch_mapdl
mapdl = launch_mapdl(loglevel="WARNING", print_com=True, check_parameter_names=False)
mapdl.prep7()

mapdl.exit()

You can skip the imports, and the launching and exit calls if the option --only-code (-oc)
is given.

$ pymapdl convert -f mapdl.dat -oc
mapdl.prep7()

You can also pipe content from files o command line into the converter.

$ echo -ne "/prep7" | pymapdl convert -oc
mapdl.prep7()

$ echo -ne "/prep7" > my_file.inp
$ pymapdl convert -oc < my_file.inp
mapdl.prep7()

Issue linked

NA

Checklist

• I have visited and read Develop PyMAPDL.
• I have tested my changes locally
• I have added necessary documentation or updated existing documentation.
• I have followed the PyMAPDL coding style guidelines.
• I have added appropriate unit tests that also ensure the minimal coverage criteria.
• I have reviewed my changes before submitting this pull request.
• I have linked the issue or issues that are solved to the PR if any.
• I have assigned this PR to myself.
• I have marked this PR as draft if it is not ready to be reviewed yet.
• I have made sure that the title of my PR follows Commit naming conventions (e.g. feat: adding new MAPDL command)

[ansys-reviewer-bot]

Thanks for opening a Pull Request. If you want to perform a review write a comment saying:

@ansys-reviewer-bot review

[germa89]

by the way, the pymapdl convert is veeeery slow.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 88.13%. Comparing base (a2f91e6) to head (9c4e138).
Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3679      +/-   ##
==========================================
+ Coverage   87.88%   88.13%   +0.24%     
==========================================
  Files         187      187              
  Lines       14710    14697      -13     
==========================================
+ Hits        12928    12953      +25     
+ Misses       1782     1744      -38     

[germa89]

Some timing:

on main

 hyperfine --warmup 3 --runs 5 'pytest -k pipe'
Benchmark 1: pytest -k pipe
  Time (mean ± σ):      5.864 s ±  0.123 s    [User: 2.532 s, System: 0.885 s]
  Range (min … max):    5.708 s …  5.986 s    5 runs

now

$ hyperfine --warmup 3 --runs 5 'pytest -k pipe'
Benchmark 1: pytest -k pipe
  Time (mean ± σ):      7.719 s ±  0.304 s    [User: 3.396 s, System: 1.164 s]
  Range (min … max):    7.314 s …  8.135 s    5 runs

the time difference is because now we do two tests instead of 1. Each one takes 2s, whereas in main it takes 1.95 aprox.

[germa89]

@pyansys-ci-bot LGTM.

[pyansys-ci-bot]

✅ Approving this PR because germa89 said so in here 😬