Support flag option for OFT blocks

[keurfonluu]

• Fixed: removal of duplicate connection outputs.
• Added: support for option flag in FOFT, COFT, and GOFT.

Reminders:

• Run invoke format to make sure the code follows the style guide,
• Add tests for new features or tests that would have caught the bug that you're fixing,
• Write detailed docstrings for all functions, classes and/or methods,
• If adding new functionality, unit test it and add it to the documentation.

[codecov]

Codecov Report

Attention: Patch coverage is 95.65217% with 1 line in your changes missing coverage. Please review.

Project coverage is 90.24%. Comparing base (636014e) to head (321e9b1).
Report is 24 commits behind head on master.

Files	Patch %	Lines
toughio/_io/output/_common.py	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           master     #171      +/-   ##
==========================================
+ Coverage   90.20%   90.24%   +0.03%     
==========================================
  Files          97       97              
  Lines        6433     6437       +4     
==========================================
+ Hits         5803     5809       +6     
+ Misses        630      628       -2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[geowomen]

Thanks, man! I hope there will be a Python script as an example to showcase all these new features.

[keurfonluu]

Thanks, man! I hope there will be a Python script as an example to showcase all these new features.

Basically, it used to be, for instance for "element_history" (FOFT):

parameters["element_history"] = [
    "AAA00",
    "AAA01",
    "AAA02",
]

Now, you can define it as a list of dictionary, so:

parameters["element_history"] = [
    {"label": "AAA00", "flag": -1},
    {"label": "AAA01", "flag": -1},
    {"label": "AAA02", "flag": -1},
]

Same for "connection_history" (COFT) and "generator_history" (GOFT).

Note that the old way is still valid (i.e., list of labels).