Fix undefined symbol error in Python pjsua modules by commenting out deprecated pjsua_transport_set_enable (#4486)

Author: Copilot

pjsip-apps/src/py_pjsua/py_pjsua.c

@@ -1259,7 +1259,10 @@ static PyObject *py_pjsua_transport_get_info(PyObject *pSelf, PyObject *pArgs)
 
 /*
  * py_pjsua_transport_set_enable
+ * NOTE: This function is commented out because pjsua_transport_set_enable
+ * has been deprecated and is no longer available in the PJSUA API.
  */
+/*
 static PyObject *py_pjsua_transport_set_enable
 (PyObject *pSelf, PyObject *pArgs)
 {
@@ -1277,6 +1280,7 @@ static PyObject *py_pjsua_transport_set_enable
     
     return Py_BuildValue("i",status);
 }
+*/
 
 /*
  * py_pjsua_transport_close
@@ -1312,6 +1316,11 @@ static char pjsua_transport_get_info_doc[] =
     "void py_pjsua.transport_get_info "
     "(py_pjsua.Transport_ID id, py_pjsua.Transport_Info info) "
     "Get information about transports.";
+/*
+ * NOTE: pjsua_transport_set_enable_doc is commented out because the
+ * corresponding function has been deprecated and is no longer available.
+ */
+/*
 static char pjsua_transport_set_enable_doc[] =
     "void py_pjsua.transport_set_enable "
     "(py_pjsua.Transport_ID id, int enabled) "
@@ -1320,6 +1329,7 @@ static char pjsua_transport_set_enable_doc[] =
     "Disabling a transport does not necessarily close the socket, "
     "it will only discard incoming messages and prevent the transport "
     "from being used to send outgoing messages.";
+*/
 static char pjsua_transport_close_doc[] =
     "void py_pjsua.transport_close (py_pjsua.Transport_ID id, int force) "
     "Close the transport. If transport is forcefully closed, "
@@ -5266,10 +5276,16 @@ static PyMethodDef py_pjsua_methods[] =
         "transport_get_info", py_pjsua_transport_get_info, METH_VARARGS,
         pjsua_transport_get_info_doc
     },
+    /*
+     * NOTE: transport_set_enable is commented out because the underlying
+     * pjsua_transport_set_enable function has been deprecated.
+     */
+    /*
     {
         "transport_set_enable", py_pjsua_transport_set_enable, METH_VARARGS,
         pjsua_transport_set_enable_doc
     },
+    */
     {
        "transport_close", py_pjsua_transport_close, METH_VARARGS,
         pjsua_transport_close_doc

pjsip-apps/src/python/DEPRECATED.txt

@@ -0,0 +1,7 @@
+This Python pjsua module is now deprecated. Please use PJSUA2 SWIG binding instead.
+
+For more information on building and using the PJSUA2 Python module, please see:
+https://docs.pjsip.org/en/latest/pjsua2/building.html#building-python-swig-module
+
+The PJSUA2 Python module provides a more modern and actively maintained Python API
+for PJSIP functionality.

pjsip-apps/src/python/_pjsua.c

@@ -1247,7 +1247,10 @@ static PyObject *py_pjsua_transport_get_info(PyObject *pSelf, PyObject *pArgs)
 
 /*
  * py_pjsua_transport_set_enable
+ * NOTE: This function is commented out because pjsua_transport_set_enable
+ * has been deprecated and is no longer available in the PJSUA API.
  */
+/*
 static PyObject *py_pjsua_transport_set_enable(PyObject *pSelf, 
                                                PyObject *pArgs)
 {
@@ -1264,6 +1267,7 @@ static PyObject *py_pjsua_transport_set_enable(PyObject *pSelf,
 
     return Py_BuildValue("i", status);
 }
+*/
 
 /*
  * py_pjsua_transport_close
@@ -1298,6 +1302,11 @@ static char pjsua_transport_get_info_doc[] =
     "void _pjsua.transport_get_info "
     "(_pjsua.Transport_ID id, _pjsua.Transport_Info info) "
     "Get information about transports.";
+/*
+ * NOTE: pjsua_transport_set_enable_doc is commented out because the
+ * corresponding function has been deprecated and is no longer available.
+ */
+/*
 static char pjsua_transport_set_enable_doc[] =
     "void _pjsua.transport_set_enable "
     "(_pjsua.Transport_ID id, int enabled) "
@@ -1306,6 +1315,7 @@ static char pjsua_transport_set_enable_doc[] =
     "Disabling a transport does not necessarily close the socket, "
     "it will only discard incoming messages and prevent the transport "
     "from being used to send outgoing messages.";
+*/
 static char pjsua_transport_close_doc[] =
     "void _pjsua.transport_close (_pjsua.Transport_ID id, int force) "
     "Close the transport. If transport is forcefully closed, "
@@ -4061,10 +4071,16 @@ static PyMethodDef py_pjsua_methods[] =
         "transport_get_info", py_pjsua_transport_get_info, METH_VARARGS,
         pjsua_transport_get_info_doc
     },
+    /*
+     * NOTE: transport_set_enable is commented out because the underlying
+     * pjsua_transport_set_enable function has been deprecated.
+     */
+    /*
     {
         "transport_set_enable", py_pjsua_transport_set_enable, METH_VARARGS,
         pjsua_transport_set_enable_doc
     },
+    */
     {
        "transport_close", py_pjsua_transport_close, METH_VARARGS,
         pjsua_transport_close_doc

pjsip-apps/src/python/pjsua.py

@@ -604,17 +604,22 @@ def info(self):
             self._lib._err_check("info()", self, -1, "Invalid transport")
         return TransportInfo(ti)
 
+    # NOTE: enable() and disable() methods are commented out because the underlying
+    # pjsua_transport_set_enable function has been deprecated and is no longer available.
+    # Please use PJSUA2 SWIG binding for modern transport management functionality.
+    """
     def enable(self):
-        """Enable this transport."""
+        \"\"\"Enable this transport.\"\"\"
         lck = self._lib.auto_lock()
         err = _pjsua.transport_set_enable(self._id, True)
         self._lib._err_check("enable()", self, err)
 
     def disable(self):
-        """Disable this transport."""
+        \"\"\"Disable this transport.\"\"\"
         lck = self._lib.auto_lock()
         err = _pjsua.transport_set_enable(self._id, 0)
         self._lib._err_check("disable()", self, err)
+    """
 
     def close(self, force=False):
         """Close and destroy this transport.