amps-python-client 5.3.4.1__zip

amps-python-client-5.3.4.1/src/memorybookmarkstore_docs.h

@@ -0,0 +1,39 @@
+////////////////////////////////////////////////////////////////////////////
+//
+// Copyright (c) 2010-2023 60East Technologies Inc., All Rights Reserved.
+//
+// This computer software is owned by 60East Technologies Inc. and is
+// protected by U.S. copyright laws and other laws and by international
+// treaties.  This computer software is furnished by 60East Technologies
+// Inc. pursuant to a written license agreement and may be used, copied,
+// transmitted, and stored only in accordance with the terms of such
+// license agreement and with the inclusion of the above copyright notice.
+// This computer software or any other copies thereof may not be provided
+// or otherwise made available to any other person.
+//
+// U.S. Government Restricted Rights.  This computer software: (a) was
+// developed at private expense and is in all respects the proprietary
+// information of 60East Technologies Inc.; (b) was not developed with
+// government funds; (c) is a trade secret of 60East Technologies Inc.
+// for all purposes of the Freedom of Information Act; and (d) is a
+// commercial item and thus, pursuant to Section 12.212 of the Federal
+// Acquisition Regulations (FAR) and DFAR Supplement Section 227.7202,
+// Government's use, duplication or disclosure of the computer software
+// is subject to the restrictions set forth by 60East Technologies Inc..
+//
+////////////////////////////////////////////////////////////////////////////
+static const char* memorybookmarkstore_class_doc = "\n"
+                                                   "  A bookmark store that maintains information about the recovery"
+                                                   " point for bookmark subscriptions in memory.\n\n"
+                                                   " When the bookmark store is set on a Client or HAClient, "
+                                                   " the AMPS client library manages adding subscriptions to the "
+                                                   " store and tracking bookmarks as they arrive. The AMPS HAClient "
+                                                   " uses the bookmark store on failover to recover bookmark subscriptions "
+                                                   " at the appropriate point.\n\n"
+                                                   " For a bookmark subscription, an application must discard() messages "
+                                                   " when they have been processed. The other methods on this class "
+                                                   " are not typically called by the application during normal use."
+                                                   " \n\nA RecoveryPointAdapter may optionally be specified when created "
+                                                   " to add something such as storage in a SOW using SOWRecoveryPointAdapter "
+                                                   " to prevent any message loss if the client application dies."
+                                                   " \n\n";

amps-python-client-5.3.4.1/src/memorypublishstore.cpp

@@ -0,0 +1,160 @@
+////////////////////////////////////////////////////////////////////////////
+//
+// Copyright (c) 2010-2023 60East Technologies Inc., All Rights Reserved.
+//
+// This computer software is owned by 60East Technologies Inc. and is
+// protected by U.S. copyright laws and other laws and by international
+// treaties.  This computer software is furnished by 60East Technologies
+// Inc. pursuant to a written license agreement and may be used, copied,
+// transmitted, and stored only in accordance with the terms of such
+// license agreement and with the inclusion of the above copyright notice.
+// This computer software or any other copies thereof may not be provided
+// or otherwise made available to any other person.
+//
+// U.S. Government Restricted Rights.  This computer software: (a) was
+// developed at private expense and is in all respects the proprietary
+// information of 60East Technologies Inc.; (b) was not developed with
+// government funds; (c) is a trade secret of 60East Technologies Inc.
+// for all purposes of the Freedom of Information Act; and (d) is a
+// commercial item and thus, pursuant to Section 12.212 of the Federal
+// Acquisition Regulations (FAR) and DFAR Supplement Section 227.7202,
+// Government's use, duplication or disclosure of the computer software
+// is subject to the restrictions set forth by 60East Technologies Inc..
+//
+////////////////////////////////////////////////////////////////////////////
+
+#define PY_SSIZE_T_CLEAN 1
+#include <Python.h>
+#include <amps/ampsplusplus.hpp>
+#include <ampspy_types.hpp>
+#include <ampspy_defs.hpp>
+#include "memorypublishstore_docs.h"
+
+using namespace AMPS;
+namespace ampspy
+{
+  namespace memorypublishstore
+  {
+//    def __init__(self, name):
+    static int _ctor(obj* self, PyObject* args, PyObject* kwds)
+    {
+      int numBlocks = -1;
+      PyObject* value = NULL;
+      if (!PyArg_ParseTuple(args, "|IO!", &numBlocks, &PyBool_Type, &value))
+      {
+        return -1;
+      }
+      if (numBlocks <=0 )
+      {
+        numBlocks = 10000;
+      }
+      bool errorOnPublishGap = value && value == Py_True;
+      self->impl = new Store(new MemoryPublishStore(numBlocks, errorOnPublishGap));
+      return 0;
+    }
+
+    static void _dtor(obj* self)
+    {
+      {
+        UNLOCKGIL;
+        delete self->impl;
+      }
+      Py_XDECREF(self->resizeHandler);
+      shims::free(self);
+    }
+
+    static PyObject* get_unpersisted_count(obj* self, PyObject* args)
+    {
+      return PyInt_FromSize_t( self->impl->unpersistedCount() );
+    }
+
+    bool
+    call_resize_handler(StoreImpl* store, size_t size, void* vp)
+    {
+      LOCKGIL;
+      obj* s = (obj*)vp;
+#if defined(_WIN32) && !defined(_WIN64)
+      PyObject* args = Py_BuildValue("(Oi)", s, size);
+#else
+      PyObject* args = Py_BuildValue("(Ol)", s, size);
+#endif
+      PyObject* pyRet = PyObject_Call(s->resizeHandler, args, (PyObject*)NULL);
+      Py_DECREF(args);
+      if (pyRet == NULL || PyErr_Occurred())
+      {
+        Py_XDECREF(pyRet);
+        if (PyErr_ExceptionMatches(PyExc_SystemExit))
+        {
+          ampspy::unhandled_exception();
+        }
+        throw StoreException("The resize handler threw an exception");
+      }
+      bool ret = (PyObject_IsTrue(pyRet) != 0);
+      Py_DECREF(pyRet);
+      return ret;
+    }
+
+    static PyObject* set_resize_handler(obj* self, PyObject* args)
+    {
+      PyObject* callable;
+      if (!PyArg_ParseTuple(args, "O", &callable))
+      {
+        return NULL;
+      }
+      if (!PyCallable_Check(callable))
+      {
+        PyErr_SetString(PyExc_TypeError, "argument must be callable.");
+        return NULL;
+      }
+      Py_INCREF(callable);
+      if (self->resizeHandler)
+      {
+        Py_DECREF(self->resizeHandler);
+      }
+      self->resizeHandler = callable;
+      CALL_RETURN_NONE(self->impl->setResizeHandler((AMPS::PublishStoreResizeHandler)call_resize_handler, self));
+    }
+
+    static PyObject* get_error_on_publish_gap(obj* self, PyObject* args)
+    {
+      CALL_RETURN_BOOL(self->impl->getErrorOnPublishGap());
+    }
+
+    static PyObject* set_error_on_publish_gap(obj* self, PyObject* args)
+    {
+      PyObject* value = NULL;
+      if (!PyArg_ParseTuple(args, "O!", &PyBool_Type, &value))
+      {
+        return NULL;
+      }
+      CALL_RETURN_NONE(self->impl->setErrorOnPublishGap(value == Py_True));
+    }
+
+    AMPSDLL ampspy::ampspy_type_object memorypublishstore_type;
+
+    void add_types(PyObject* module_)
+    {
+      memorypublishstore_type.setName("AMPS.MemoryPublishStore")
+      .setBasicSize(sizeof(obj))
+      .setDestructorFunction(_dtor)
+      .setConstructorFunction(_ctor)
+      .setDoc(memorypublishstore_class_doc)
+      .setBaseType()
+      .notCopyable()
+      .addMethod("get_unpersisted_count", get_unpersisted_count, "get_unpersisted_count()\n\nReturns the number of messages published which have not been ACK'ed by the server.\n")
+      .addMethod("set_resize_handler", set_resize_handler, "set_resize_handler()\n\nSets the object to call when the store needs to resize.\n")
+      .addMethod("get_error_on_publish_gap", get_error_on_publish_gap, "get_error_on_publish_gap()\n\nReturns If true, PublishStoreGapException can be thrown\n"
+                                                  "           by the client publish store if the client logs onto a server that\n"
+                                                  "           appears to be missing messages no longer held in the store.\n")
+      .addMethod("set_error_on_publish_gap", set_error_on_publish_gap, "set_error_on_publish_gap()\n\nCalled to enable or disable throwing PublishStoreGapException.\n\n"
+                                                  ":param error_on_publish_gap: If true, PublishStoreGapException can be thrown\n"
+                                                  "           by the client publish store if the client logs onto a server that\n"
+                                                  "           appears to be missing messages no longer held in the store.\n"
+                                                  ":type error_on_publish_gap: Boolean\n")
+      .createType()
+      .registerType("MemoryPublishStore", module_);
+
+    }
+
+  } // namespace memorypublishstore
+} // namespace ampspy

amps-python-client-5.3.4.1/src/memorypublishstore_docs.h

@@ -0,0 +1,32 @@
+////////////////////////////////////////////////////////////////////////////
+//
+// Copyright (c) 2010-2023 60East Technologies Inc., All Rights Reserved.
+//
+// This computer software is owned by 60East Technologies Inc. and is
+// protected by U.S. copyright laws and other laws and by international
+// treaties.  This computer software is furnished by 60East Technologies
+// Inc. pursuant to a written license agreement and may be used, copied,
+// transmitted, and stored only in accordance with the terms of such
+// license agreement and with the inclusion of the above copyright notice.
+// This computer software or any other copies thereof may not be provided
+// or otherwise made available to any other person.
+//
+// U.S. Government Restricted Rights.  This computer software: (a) was
+// developed at private expense and is in all respects the proprietary
+// information of 60East Technologies Inc.; (b) was not developed with
+// government funds; (c) is a trade secret of 60East Technologies Inc.
+// for all purposes of the Freedom of Information Act; and (d) is a
+// commercial item and thus, pursuant to Section 12.212 of the Federal
+// Acquisition Regulations (FAR) and DFAR Supplement Section 227.7202,
+// Government's use, duplication or disclosure of the computer software
+// is subject to the restrictions set forth by 60East Technologies Inc..
+//
+////////////////////////////////////////////////////////////////////////////
+static const char* memorypublishstore_class_doc = "\n"
+                                                  "  A publish store that keeps messages in memory. This class is the default "
+                                                  "publish store for a python HAClient. The HAClient manages storing "
+                                                  "messages in the publish store, replaying messages to the server after "
+                                                  "failover, and removing messages from the store.  With this publish "
+                                                  "store, an application typically checks to be sure that the "
+                                                  "publish store is empty (that is, all messages have been persisted "
+                                                  "in the AMPS server) before exiting.\n\n";