add new API command: setSslCrt

This replaces updateSslCrt to better align with the HAProxy API command.

Author: fraenki

CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+### Added
+* New API command: setSslCrt
+
+### Deprecated
+* Deprecate API command: updateSslCrt
+
 ## [v0.6.1] - 2023-12-05
 
 ### Changed

haproxy/cmds.py

@@ -259,13 +259,20 @@ class newSslCrt(Cmd):
     helpTxt = "Create a new certificate file to be used in a crt-list or a directory."
 
 
-class updateSslCrt(Cmd):
+class setSslCrt(Cmd):
     """" Begin a transaction to upload the certificate into a slot in HAProxy’s memory """
     cmdTxt = "set ssl cert %(certfile)s <<\n%(payload)s\r\n"
     req_args = ['certfile', 'payload']
     helpTxt = "Replace a certificate file."
 
 
+class updateSslCrt(Cmd):
+    """" DEPRECATED. Begin a transaction to upload the certificate into a slot in HAProxy’s memory """
+    cmdTxt = "set ssl cert %(certfile)s <<\n%(payload)s\r\n"
+    req_args = ['certfile', 'payload']
+    helpTxt = "DEPRECATED. Alias for setSslCrt. Kept for compatibility reasons."
+
+
 class delSslCrt(Cmd):
     """" Begin a transaction to remove the certificate from a slot in HAProxy’s memory """
     cmdTxt = "del ssl cert %(certfile)s\r\n"

haproxy/tests/test_cmds.py

@@ -152,6 +152,7 @@ def setUp(self):
             "del-from-crt-list": ("del ssl crt-list /tmp/haproxy/ssl/601a7392cc9984.99301413.certlist"
                                   " /tmp/haproxy/ssl/601a70e4844b0.pem"),
             "new-ssl-cert": "new ssl cert /tmp/haproxy/ssl/601a70e4844b0.pem",
+            "set-ssl-cert": "set ssl cert /tmp/haproxy/ssl/601a70e4844b0.pem <<\n%s" % self.pem_cert_content,
             "update-ssl-cert": "set ssl cert /tmp/haproxy/ssl/601a70e4844b0.pem <<\n%s" % self.pem_cert_content,
             "del-ssl-cert": "del ssl cert /tmp/haproxy/ssl/601a70e4844b0.pem",
             "commit-ssl-cert": "commit ssl cert /tmp/haproxy/ssl/601a70e4844b0.pem",
@@ -258,6 +259,15 @@ def test_newSslCrt(self):
         cmdOutput = cmds.newSslCrt(**args).getCmd()
         self.assertEqual(cmdOutput, self.Resp["new-ssl-cert"])
 
+    def test_setSslCrt(self):
+        """Test 'set ssl cert <certfile> <payload>' command"""
+        args = {
+            "certfile": "/tmp/haproxy/ssl/601a70e4844b0.pem",
+            "payload": "%s" % self.pem_cert_content
+        }
+        cmdOutput = cmds.setSslCrt(**args).getCmd()
+        self.assertEqual(cmdOutput, self.Resp["set-ssl-cert"])
+
     def test_updateSslCrt(self):
         """Test 'set ssl cert <certfile> <payload>' command"""
         args = {