Add a utility class to help map ports to interfaces. (#755)

Summary:
**Pre-submission checklist**
- [x] I've ran the linters locally and fixed lint errors related to the files I modified in this PR. You can install the linters by running `pip install -r requirements-dev.txt && pre-commit install`
- [x] `pre-commit run`

This is a small helper class used to lookup ports and interfaces in a consistent fashion in CLI commands.

Note: this change is part of a series, the previous one is #754, the next one is #756.

Pull Request resolved: #755

Test Plan: Unit tests.

Reviewed By: KevinYakar

Differential Revision: D89903145

Pulled By: joseph5wu

fbshipit-source-id: e36f8198ed19bb4141285b56da93632f8d660a06

Author: benoit-nexthop

cmake/CliFboss2.cmake

@@ -476,6 +476,7 @@ add_library(fboss2_lib
   fboss/cli/fboss2/utils/CLIParserUtils.cpp
   fboss/cli/fboss2/utils/CmdClientUtils.cpp
   fboss/cli/fboss2/utils/CmdUtilsCommon.cpp
+  fboss/cli/fboss2/utils/PortMap.cpp
   fboss/cli/fboss2/utils/Table.cpp
   fboss/cli/fboss2/utils/HostInfo.h
   fboss/cli/fboss2/utils/FilterOp.h

cmake/CliFboss2Test.cmake

@@ -37,6 +37,7 @@ add_executable(fboss2_cmd_test
   # fboss/cli/fboss2/test/CmdShowTransceiverTest.cpp - excluded (depends on configerator bgp namespace)
   fboss/cli/fboss2/test/CmdStartPcapTest.cpp
   fboss/cli/fboss2/test/CmdStopPcapTest.cpp
+  fboss/cli/fboss2/test/PortMapTest.cpp
 )
 
 target_link_libraries(fboss2_cmd_test

fboss/cli/fboss2/BUCK

@@ -313,6 +313,7 @@ cpp_library(
         "utils/CmdClientUtils.cpp",
         "utils/CmdUtils.cpp",
         "utils/NetwhoamiUtils.cpp",
+        "utils/PortMap.cpp",
         "utils/PrbsUtils.cpp",
         "utils/TeFlowUtils.cpp",
         "utils/clients/BmcClient.cpp",
@@ -524,6 +525,8 @@ cpp_library(
         "//employee/if:thrift-cpp2-types",
         "//fastcli:utils-cpp",
         "//fboss/agent:address_utils",
+        "//fboss/agent:agent_config-cpp2-types",
+        "//fboss/agent:fboss-types",
         "//fboss/agent/hw:hardware_stats-cpp2-types",
         "//fboss/agent/if:common-cpp2-types",
         "//fboss/agent/if:ctrl-cpp2-clients",
@@ -667,6 +670,7 @@ cpp_library(
         "//fboss/qsfp_service/if:qsfp-cpp2-services",
         "//fboss/qsfp_service/if:transceiver-cpp2-types",
         "//folly:conv",
+        "//folly:cpp_attributes",
         "//folly:format",
         "//folly:network_address",
         "//folly:range",
@@ -693,7 +697,7 @@ cpp_library(
         "//neteng/netwhoami/lib/cpp:recover",
         "//neteng/routing/policy/if:policy_thrift-cpp2-types",
         "//nettools/bgplib:bgp_structs",
-        "//nettools/bgplib:bgplib",
+        "//nettools/bgplib:bgplib_util",
         "//nettools/bgplib/if:bgp-structs-cpp2-types",
         "//nettools/skynet/if:query-cpp2-types",
         "//nettools/skynet/if:skynet_structs-cpp2-types",
@@ -720,6 +724,7 @@ cpp_library(
         "//thrift/lib/cpp2/protocol:protocol",
     ],
     exported_external_deps = [
+        "glog",
         ("boost", None, "boost_algorithm"),
     ],
 )
@@ -774,6 +779,7 @@ cpp_library(
     exported_deps = [
         ":cmd-handler",
         ":fboss2-lib",
+        "//fboss/agent/if:ctrl-cpp2-types",
         "//folly:conv",
     ],
 )
@@ -843,7 +849,7 @@ cpp_binary(
         "//neteng/fboss/bgp/if:bgp_thrift-cpp2-types",
         "//neteng/routing/policy/if:policy_thrift-cpp2-types",
         "//nettools/bgplib:bgp_structs",
-        "//nettools/bgplib:bgplib",
+        "//nettools/bgplib:bgplib_util",
         "//nettools/bgplib/if:bgp-structs-cpp2-types",
         "//nettools/skynet/if:query-cpp2-types",
         "//nettools/skynet/if:skynet_structs-cpp2-types",

fboss/cli/fboss2/test/BUCK

@@ -87,7 +87,15 @@ cpp_unittest(
         "CmdShowTransceiverTest.cpp",
         "CmdStartPcapTest.cpp",
         "CmdStopPcapTest.cpp",
+        "PortMapTest.cpp",
     ],
+    # Config files for PortMapTest parameterized tests
+    resources = [
+        "//fboss/oss/link_test_configs:link_test_configs",
+    ],
+    # Required for parameterized tests (TEST_P) - static listing doesn't support them
+    # See: https://fburl.com/parameterized-test-not-supported
+    supports_static_listing = False,
     deps = [
         "fbsource//third-party/googletest:gmock",
         ":cmd_test_utils",
@@ -121,9 +129,11 @@ cpp_unittest(
         "//fboss/cli/fboss2/commands/show/route:model-cpp2-types",
         "//fboss/cli/fboss2/commands/show/teflow:model-cpp2-types",
         "//fboss/cli/fboss2/commands/show/transceiver:model-cpp2-types",
+        "//folly:file_util",
         "//folly:network_address",
         "//folly/json:dynamic",
         "//neteng/fboss/bgp/if:bgp_thrift-cpp2-services",
+        "//thrift/lib/cpp2/protocol:protocol",
         "//thrift/lib/cpp2/reflection:testing",
     ],
     external_deps = [("boost", None, "boost_algorithm")],