[Nexthop] NOS-6649..NOS-6656: fboss2 config/delete protocol bgp policy community-list

Adds `config protocol bgp policy community-list <name> [community <name>]
[<attribute> <value> ...]` and `delete protocol bgp policy community-list
<name>` — the second BGP policy object-type command family, beneath the
`policy` grouping node alongside as-path-list.

- community-list dispatcher with a two-level key (list name + inline
  community member name) writing bgp_policy.BgpPolicies.community_lists[]
  through the typed ConfigSession; boolean-operator maps to
  routing_policy.BooleanOperator, exact-match to the optional bool, and
  the member attributes (description/type/value) set the CommunityRefType
  union's inline Community arm, keyed by Community.name.
- new boolAttr factory in the shared BgpCliAttrHandlers.h (generalizing
  the neighbor dispatcher's), reused by upcoming prefix-list.
- fix a latent dangling-string_view in the shared enumAttr factory: the
  lambda captured a string_view over the caller's fmt::format temporary,
  so every invalid-enum-value rejection printed garbage after
  "expected". valueDesc is now taken (and captured) by value; the
  as-path-list and community-list rejection tests pin the full message.
- unit tests (19) + commit-path integration tests mirroring
  ConfigBgpPolicyAsPathListTest (not yet run on a DUT).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: hillol-nexthop

cmake/CliFboss2.cmake

@@ -889,6 +889,9 @@ add_library(fboss2_config_lib
   fboss/cli/fboss2/commands/config/protocol/bgp/policy/as-path-list/CmdConfigProtocolBgpPolicyAsPathList.h
   fboss/cli/fboss2/commands/config/protocol/bgp/policy/as-path-list/entry/CmdConfigProtocolBgpPolicyAsPathListEntry.cpp
   fboss/cli/fboss2/commands/config/protocol/bgp/policy/as-path-list/entry/CmdConfigProtocolBgpPolicyAsPathListEntry.h
+  fboss/cli/fboss2/commands/config/protocol/bgp/policy/community-list/BgpCommunityListCliUtils.h
+  fboss/cli/fboss2/commands/config/protocol/bgp/policy/community-list/CmdConfigProtocolBgpPolicyCommunityList.cpp
+  fboss/cli/fboss2/commands/config/protocol/bgp/policy/community-list/CmdConfigProtocolBgpPolicyCommunityList.h
   fboss/cli/fboss2/commands/config/ptp/CmdConfigPtp.cpp
   fboss/cli/fboss2/commands/config/ptp/CmdConfigPtp.h
   fboss/cli/fboss2/commands/config/ptp/transparent_clock/CmdConfigPtpTransparentClock.cpp
@@ -1001,6 +1004,8 @@ add_library(fboss2_config_lib
   fboss/cli/fboss2/commands/delete/protocol/bgp/policy/CmdDeleteProtocolBgpPolicy.h
   fboss/cli/fboss2/commands/delete/protocol/bgp/policy/as-path-list/CmdDeleteProtocolBgpPolicyAsPathList.cpp
   fboss/cli/fboss2/commands/delete/protocol/bgp/policy/as-path-list/CmdDeleteProtocolBgpPolicyAsPathList.h
+  fboss/cli/fboss2/commands/delete/protocol/bgp/policy/community-list/CmdDeleteProtocolBgpPolicyCommunityList.cpp
+  fboss/cli/fboss2/commands/delete/protocol/bgp/policy/community-list/CmdDeleteProtocolBgpPolicyCommunityList.h
   fboss/cli/fboss2/commands/delete/protocol/CmdDeleteProtocol.h
   fboss/cli/fboss2/commands/delete/protocol/static/CmdDeleteProtocolStatic.cpp
   fboss/cli/fboss2/commands/delete/protocol/static/CmdDeleteProtocolStatic.h

cmake/CliFboss2TestConfig.cmake

@@ -12,6 +12,8 @@ add_executable(fboss2_cmd_config_test
   fboss/cli/fboss2/test/config/CmdConfigIcmpV4UnavailableSrcAddrTest.cpp
   fboss/cli/fboss2/test/config/CmdConfigBgpNeighborTest.cpp
   fboss/cli/fboss2/test/config/CmdConfigBgpPeerGroupTest.cpp
+  fboss/cli/fboss2/test/config/CmdConfigBgpPolicyAsPathListTest.cpp
+  fboss/cli/fboss2/test/config/CmdConfigBgpPolicyCommunityListTest.cpp
   fboss/cli/fboss2/test/config/CmdConfigCoppTest.cpp
   fboss/cli/fboss2/test/config/CmdConfigDhcpTest.cpp
   fboss/cli/fboss2/test/config/CmdConfigHostnameTest.cpp
@@ -44,6 +46,8 @@ add_executable(fboss2_cmd_config_test
   fboss/cli/fboss2/test/config/CmdDeleteArpTest.cpp
   fboss/cli/fboss2/test/config/CmdDeleteBgpNeighborTest.cpp
   fboss/cli/fboss2/test/config/CmdDeleteBgpPeerGroupTest.cpp
+  fboss/cli/fboss2/test/config/CmdDeleteBgpPolicyAsPathListTest.cpp
+  fboss/cli/fboss2/test/config/CmdDeleteBgpPolicyCommunityListTest.cpp
   fboss/cli/fboss2/test/config/CmdDeleteConfigInterfaceTest.cpp
   fboss/cli/fboss2/test/config/CmdDeleteDhcpTest.cpp
   fboss/cli/fboss2/test/config/CmdDeleteInterfaceIpv6NdpTest.cpp

cmake/CliFboss2TestIntegrationTest.cmake

@@ -14,6 +14,7 @@ add_executable(fboss2_integration_test
   fboss/cli/fboss2/test/integration_test/ConfigBgpGlobalTest.cpp
   fboss/cli/fboss2/test/integration_test/ConfigBgpNeighborTest.cpp
   fboss/cli/fboss2/test/integration_test/ConfigBgpPeerGroupTest.cpp
+  fboss/cli/fboss2/test/integration_test/ConfigBgpPolicyCommunityListTest.cpp
   fboss/cli/fboss2/test/integration_test/ConfigBgpSessionTest.cpp
   fboss/cli/fboss2/test/integration_test/ConfigConcurrentSessionsTest.cpp
   fboss/cli/fboss2/test/integration_test/ConfigHostnameTest.cpp

fboss/cli/fboss2/BUCK

@@ -1111,6 +1111,7 @@ cpp_library(
         "commands/config/protocol/bgp/policy/CmdConfigProtocolBgpPolicy.cpp",
         "commands/config/protocol/bgp/policy/as-path-list/CmdConfigProtocolBgpPolicyAsPathList.cpp",
         "commands/config/protocol/bgp/policy/as-path-list/entry/CmdConfigProtocolBgpPolicyAsPathListEntry.cpp",
+        "commands/config/protocol/bgp/policy/community-list/CmdConfigProtocolBgpPolicyCommunityList.cpp",
         "commands/config/protocol/static/CmdConfigProtocolStatic.cpp",
         "commands/config/protocol/static/route/add/CmdConfigProtocolStaticRouteAdd.cpp",
         "commands/config/ptp/CmdConfigPtp.cpp",
@@ -1167,6 +1168,7 @@ cpp_library(
         "commands/delete/protocol/bgp/peer-group/CmdDeleteProtocolBgpPeerGroup.cpp",
         "commands/delete/protocol/bgp/policy/CmdDeleteProtocolBgpPolicy.cpp",
         "commands/delete/protocol/bgp/policy/as-path-list/CmdDeleteProtocolBgpPolicyAsPathList.cpp",
+        "commands/delete/protocol/bgp/policy/community-list/CmdDeleteProtocolBgpPolicyCommunityList.cpp",
         "commands/delete/protocol/static/CmdDeleteProtocolStatic.cpp",
         "commands/delete/protocol/static/route/CmdDeleteProtocolStaticRoute.cpp",
         "commands/delete/qos/CmdDeleteQos.cpp",
@@ -1231,6 +1233,8 @@ cpp_library(
         "commands/config/protocol/bgp/policy/as-path-list/BgpAsPathListCliUtils.h",
         "commands/config/protocol/bgp/policy/as-path-list/CmdConfigProtocolBgpPolicyAsPathList.h",
         "commands/config/protocol/bgp/policy/as-path-list/entry/CmdConfigProtocolBgpPolicyAsPathListEntry.h",
+        "commands/config/protocol/bgp/policy/community-list/BgpCommunityListCliUtils.h",
+        "commands/config/protocol/bgp/policy/community-list/CmdConfigProtocolBgpPolicyCommunityList.h",
         "commands/config/protocol/static/CmdConfigProtocolStatic.h",
         "commands/config/protocol/static/route/StaticRouteUtils.h",
         "commands/config/protocol/static/route/add/CmdConfigProtocolStaticRouteAdd.h",
@@ -1288,6 +1292,7 @@ cpp_library(
         "commands/delete/protocol/bgp/peer-group/CmdDeleteProtocolBgpPeerGroup.h",
         "commands/delete/protocol/bgp/policy/CmdDeleteProtocolBgpPolicy.h",
         "commands/delete/protocol/bgp/policy/as-path-list/CmdDeleteProtocolBgpPolicyAsPathList.h",
+        "commands/delete/protocol/bgp/policy/community-list/CmdDeleteProtocolBgpPolicyCommunityList.h",
         "commands/delete/protocol/static/CmdDeleteProtocolStatic.h",
         "commands/delete/protocol/static/route/CmdDeleteProtocolStaticRoute.h",
         "commands/delete/qos/CmdDeleteQos.h",

fboss/cli/fboss2/CmdListConfig.cpp

@@ -43,6 +43,7 @@
 #include "fboss/cli/fboss2/commands/config/protocol/bgp/policy/CmdConfigProtocolBgpPolicy.h"
 #include "fboss/cli/fboss2/commands/config/protocol/bgp/policy/as-path-list/CmdConfigProtocolBgpPolicyAsPathList.h"
 #include "fboss/cli/fboss2/commands/config/protocol/bgp/policy/as-path-list/entry/CmdConfigProtocolBgpPolicyAsPathListEntry.h"
+#include "fboss/cli/fboss2/commands/config/protocol/bgp/policy/community-list/CmdConfigProtocolBgpPolicyCommunityList.h"
 #include "fboss/cli/fboss2/commands/config/protocol/static/CmdConfigProtocolStatic.h"
 #include "fboss/cli/fboss2/commands/config/protocol/static/route/add/CmdConfigProtocolStaticRouteAdd.h"
 #include "fboss/cli/fboss2/commands/config/ptp/CmdConfigPtp.h"
@@ -95,6 +96,7 @@
 #include "fboss/cli/fboss2/commands/delete/protocol/bgp/peer-group/CmdDeleteProtocolBgpPeerGroup.h"
 #include "fboss/cli/fboss2/commands/delete/protocol/bgp/policy/CmdDeleteProtocolBgpPolicy.h"
 #include "fboss/cli/fboss2/commands/delete/protocol/bgp/policy/as-path-list/CmdDeleteProtocolBgpPolicyAsPathList.h"
+#include "fboss/cli/fboss2/commands/delete/protocol/bgp/policy/community-list/CmdDeleteProtocolBgpPolicyCommunityList.h"
 #include "fboss/cli/fboss2/commands/delete/protocol/static/CmdDeleteProtocolStatic.h"
 #include "fboss/cli/fboss2/commands/delete/protocol/static/route/CmdDeleteProtocolStaticRoute.h"
 #include "fboss/cli/fboss2/commands/delete/qos/CmdDeleteQos.h"
@@ -394,24 +396,34 @@ const CommandTree& kConfigCommandTree() {
                           commandHandler<CmdConfigProtocolBgpPolicy>,
                           argRegistrar<CmdConfigProtocolBgpPolicyTraits>,
                           {{
-                              "as-path-list",
-                              "Configure BGP AS-path list: <name> "
-                              "[<attribute> <value> ...] (description)",
-                              commandHandler<
-                                  CmdConfigProtocolBgpPolicyAsPathList>,
-                              argRegistrar<
-                                  CmdConfigProtocolBgpPolicyAsPathListTraits>,
-                              {{
-                                  "entry",
-                                  "Configure an AS-path list entry: "
-                                  "<seq-num> [<attribute> <value> ...] "
-                                  "(asn-regexp, description, match-logic)",
-                                  commandHandler<
-                                      CmdConfigProtocolBgpPolicyAsPathListEntry>,
-                                  argRegistrar<
-                                      CmdConfigProtocolBgpPolicyAsPathListEntryTraits>,
-                              }},
-                          }},
+                               "as-path-list",
+                               "Configure BGP AS-path list: <name> "
+                               "[<attribute> <value> ...] (description)",
+                               commandHandler<
+                                   CmdConfigProtocolBgpPolicyAsPathList>,
+                               argRegistrar<
+                                   CmdConfigProtocolBgpPolicyAsPathListTraits>,
+                               {{
+                                   "entry",
+                                   "Configure an AS-path list entry: "
+                                   "<seq-num> [<attribute> <value> ...] "
+                                   "(asn-regexp, description, match-logic)",
+                                   commandHandler<
+                                       CmdConfigProtocolBgpPolicyAsPathListEntry>,
+                                   argRegistrar<
+                                       CmdConfigProtocolBgpPolicyAsPathListEntryTraits>,
+                               }},
+                           },
+                           {
+                               "community-list",
+                               "Configure BGP community-list: <name> "
+                               "[<attribute> <value> ...] "
+                               "(boolean-operator, description, exact-match)",
+                               commandHandler<
+                                   CmdConfigProtocolBgpPolicyCommunityList>,
+                               argRegistrar<
+                                   CmdConfigProtocolBgpPolicyCommunityListTraits>,
+                           }},
                       },
                   },
               },
@@ -748,12 +760,20 @@ const CommandTree& kConfigCommandTree() {
                     commandHandler<CmdDeleteProtocolBgpPolicy>,
                     argTypeHandler<CmdDeleteProtocolBgpPolicyTraits>,
                     {{
-                        "as-path-list",
-                        "Delete a BGP AS-path list: <name>",
-                        commandHandler<CmdDeleteProtocolBgpPolicyAsPathList>,
-                        argRegistrar<
-                            CmdDeleteProtocolBgpPolicyAsPathListTraits>,
-                    }},
+                         "as-path-list",
+                         "Delete a BGP AS-path list: <name>",
+                         commandHandler<CmdDeleteProtocolBgpPolicyAsPathList>,
+                         argRegistrar<
+                             CmdDeleteProtocolBgpPolicyAsPathListTraits>,
+                     },
+                     {
+                         "community-list",
+                         "Delete a BGP community-list: <name>",
+                         commandHandler<
+                             CmdDeleteProtocolBgpPolicyCommunityList>,
+                         argRegistrar<
+                             CmdDeleteProtocolBgpPolicyCommunityListTraits>,
+                     }},
                 }},
            },
            {

fboss/cli/fboss2/commands/config/protocol/bgp/BgpCliValueParsers.h

@@ -10,13 +10,18 @@
 
 #pragma once
 
+#include <fmt/format.h>
 #include <folly/Conv.h>
+#include <cstddef>
 #include <cstdint>
 #include <exception>
 #include <limits>
 #include <optional>
+#include <stdexcept>
 #include <string>
+#include <string_view>
 #include <utility>
+#include <vector>
 
 /**
  * Value parsing helpers shared by the BGP config dispatchers
@@ -93,4 +98,51 @@ inline std::optional<int64_t> parseAsn4Byte(const std::string& value) {
   return static_cast<int64_t>(*parsed);
 }
 
+// ---- constructor-time token parsing ----------------------------------------
+// Unlike the value parsers above, this runs while constructing a command's
+// ObjectArgType, where throwing std::invalid_argument IS the framework's
+// error channel — the message is surfaced to the user as the parse error.
+
+// The `<list-name> [<keyword> <member-name>]` prefix shared by the policy
+// list commands (config and delete): the list name, the optional named
+// member selected by `keyword`, and where any remaining tokens begin.
+struct ListMemberSelector {
+  std::string listName;
+  std::optional<std::string> memberName;
+  // Index of the first token after the parsed prefix (== tokens.size() when
+  // nothing follows). The config dispatcher reads an <attribute> <value>...
+  // tail from here; the delete dispatcher rejects any tail.
+  size_t restStart;
+};
+
+// Parse the shared prefix. `objectName` is the list flavor for messages
+// (e.g. "community-list"), `memberKeyword` selects the nested member (e.g.
+// `community`), and `usage` is the whole-command usage line thrown when no
+// tokens were given. A second token other than `memberKeyword` is left to
+// the caller (restStart == 1): the config grammar treats it as a list-level
+// attribute, delete as an unexpected token.
+inline ListMemberSelector parseListMemberSelector(
+    const std::vector<std::string>& tokens,
+    std::string_view objectName,
+    std::string_view memberKeyword,
+    std::string_view usage) {
+  if (tokens.empty()) {
+    throw std::invalid_argument(std::string(usage));
+  }
+  if (tokens[0].empty()) {
+    throw std::invalid_argument(
+        fmt::format("Error: {} name must not be empty", objectName));
+  }
+  ListMemberSelector selector{tokens[0], std::nullopt, 1};
+  if (tokens.size() > 1 && tokens[1] == memberKeyword) {
+    if (tokens.size() < 3 || tokens[2].empty()) {
+      throw std::invalid_argument(
+          fmt::format("Error: `{}` requires a <name>", memberKeyword));
+    }
+    selector.memberName = tokens[2];
+    selector.restStart = 3;
+  }
+  return selector;
+}
+
 } // namespace facebook::fboss::bgpcli

fboss/cli/fboss2/commands/config/protocol/bgp/policy/CmdConfigProtocolBgpPolicy.h

@@ -10,15 +10,18 @@
 
 #pragma once
 
+#include <string>
+#include <variant>
 #include "fboss/cli/fboss2/CmdHandler.h"
 #include "fboss/cli/fboss2/commands/config/protocol/bgp/CmdConfigProtocolBgp.h"
+#include "fboss/cli/fboss2/utils/HostInfo.h"
 
 namespace facebook::fboss {
 
 // Grouping node for `config protocol bgp policy <object-type> ...`. Holds no
-// state of its own; the per-object-type dispatchers (as-path-list, and later
-// community-list/prefix-list/routing-policy) are its subcommands. Mirrors
-// CmdConfigProtocolBgp.
+// state of its own; the per-object-type dispatchers (as-path-list,
+// community-list, and later prefix-list/routing-policy) are its subcommands.
+// Mirrors CmdConfigProtocolBgp.
 struct CmdConfigProtocolBgpPolicyTraits : public WriteCommandTraits {
   using ParentCmd = CmdConfigProtocolBgp;
   using ObjectArgType = std::monostate;

fboss/cli/fboss2/commands/config/protocol/bgp/policy/community-list/BgpCommunityListCliUtils.h

@@ -0,0 +1,90 @@
+/*
+ *  Copyright (c) 2004-present, Facebook, Inc.
+ *  All rights reserved.
+ *
+ *  This source code is licensed under the BSD-style license found in the
+ *  LICENSE file in the root directory of this source tree. An additional grant
+ *  of patent rights can be found in the PATENTS file in the same directory.
+ *
+ */
+
+#pragma once
+
+#include <neteng/fboss/bgp/public_tld/configerator/structs/neteng/fboss/bgp/gen-cpp2/bgp_config_types.h>
+#include <algorithm>
+#include <string>
+#include "configerator/structs/neteng/bgp_policy/thrift/gen-cpp2/bgp_policy_types.h"
+
+/**
+ * Lookup/create helpers for the community-list CLI family, shared between the
+ * list-level dispatcher (CmdConfigProtocolBgpPolicyCommunityList), the
+ * community subcommand (CmdConfigProtocolBgpPolicyCommunityListCommunity), and
+ * the delete counterparts. A CommunityList is keyed by name; the inline
+ * Community members it holds are keyed by their own name.
+ */
+namespace facebook::fboss::bgpcli {
+
+inline bool communityListExists(
+    const bgp::thrift::BgpConfig& cfg,
+    const std::string& name) {
+  if (!cfg.policies().has_value()) {
+    return false;
+  }
+  const auto& lists = *cfg.policies()->community_lists();
+  return std::any_of(lists.begin(), lists.end(), [&](const auto& list) {
+    return *list.name() == name;
+  });
+}
+
+// Find the community-list keyed by name, creating it if absent. Setting an
+// attribute on a not-yet-created list implicitly creates it, so command
+// ordering stays forgiving; a bare `community-list <name>` creates one
+// explicitly. CommunityList's only key field is `name`.
+inline bgp::bgp_policy::CommunityList& findOrCreateCommunityList(
+    bgp::thrift::BgpConfig& cfg,
+    const std::string& name) {
+  auto& lists = *cfg.policies().ensure().community_lists();
+  for (auto& list : lists) {
+    if (*list.name() == name) {
+      return list;
+    }
+  }
+  lists.emplace_back();
+  auto& list = lists.back();
+  list.name() = name;
+  return list;
+}
+
+inline bool communityMemberExists(
+    const bgp::bgp_policy::CommunityList& list,
+    const std::string& name) {
+  if (!list.members().has_value()) {
+    return false;
+  }
+  const auto& members = *list.members();
+  return std::any_of(members.begin(), members.end(), [&](const auto& member) {
+    return member.community_ref().has_value() &&
+        *member.community_ref()->name() == name;
+  });
+}
+
+// Find the inline Community member keyed by name within a list, creating it
+// if absent. The CLI always defines members inline (the CommunityRefType
+// union's `community` arm); the member's name is its identity.
+inline bgp::bgp_policy::Community& findOrCreateCommunityMember(
+    bgp::bgp_policy::CommunityList& list,
+    const std::string& name) {
+  auto& members = list.members().ensure();
+  for (auto& member : members) {
+    if (member.community_ref().has_value() &&
+        *member.community_ref()->name() == name) {
+      return *member.community_ref();
+    }
+  }
+  members.emplace_back();
+  auto& community = members.back().set_community();
+  community.name() = name;
+  return community;
+}
+
+} // namespace facebook::fboss::bgpcli