Refactor, add {file} template

[HO-COOH]

Fix/Feature/Other

Fix

• Link to issue.
  This closes Option to template filename in file.customTag #191

Feature

Add {file} template, so it can be used in custom tag of both file comments and generic comments.

Other

• Description
  I extracted some functionalities (mainly those protected implementation detail functions in CppDocGen.ts) to dedicated files to better reuse them, because they are not language dependent at the first place, as I am planning to add a backend that uses the language server.

I also tried to add documentation to those functions but they may not be accurate. Some function names are quite ambiguous to be honest.

[HO-COOH]

The backend I am talking about mainly uses executeHoverProvider. The hover result still needs to be parsed but will be simplified by language server. For example, macros will be replaced, types will be deduced etc.

[HO-COOH]

Don't know why the tests process get killed. It's passing all tests and works on my machine

[cschlosser]

Don't know why the tests process get killed. It's passing all tests and works on my machine

The CI uses VS Code 1.56.0 now. Are you using 1.55.X locally by any chance?

I also tried to add documentation to those functions but they may not be accurate. Some function names are quite ambiguous to be honest.

Thank you, yes I agree with you. But util isn't the most expressive name either 😉

Ad language server:
What LS do you want to support? Does the C++ VSCode LS support this now reasonably?

I will review your changes in the upcomming days.

[HO-COOH]

What LS do you want to support? Does the C++ VSCode LS support this now reasonably?

No it hasn't changed much. You either run another language server along side what the user already uses, which would be stupid or use vscode built-in command to query the user's language server, like executeHoverProvider I talked about, and then parse the result.

[cschlosser]

The CI uses VS Code 1.56.0 now. Are you using 1.55.X locally by any chance?

Did you take a look at this?

[HO-COOH]

I don't think that's the issue, and indeed I am using 1.56.
The CI is failing at network connection this time.

[codecov]

Codecov Report

Merging #221 (a0b440d) into master (be07386) will decrease coverage by 0.06%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##           master     #221      +/-   ##
==========================================
- Coverage   93.42%   93.36%   -0.07%     
==========================================
  Files           5        5              
  Lines         852      814      -38     
  Branches      247      242       -5     
==========================================
- Hits          796      760      -36     
+ Misses         56       54       -2     

Impacted Files	Coverage Δ
src/Lang/Cpp/CppDocGen.ts	99.60% <100.00%> (+0.63%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update be07386...a0b440d. Read the comment docs.

[cschlosser]

Please add a test for your changes.
Will merge it afterwards. CI is fine now too.