view CodeAnalysis/Class.mustache @ 213:f8dc8dd2da76

documented orthanc.RegisterIncomingCStoreInstanceFilter() and orthanc.RegisterReceivedInstanceCallback()
author Sebastien Jodogne <s.jodogne@gmail.com>
date Wed, 03 Jul 2024 14:56:51 +0200
parents 66cd20e970d8
children 3678a028f1f6
line wrap: on
line source

/**
 * Python plugin for Orthanc
 * Copyright (C) 2020-2023 Osimis S.A., Belgium
 * Copyright (C) 2024-2024 Orthanc Team SRL, Belgium
 * Copyright (C) 2021-2024 Sebastien Jodogne, ICTEAM UCLouvain, Belgium
 *
 * 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 or 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 <http://www.gnu.org/licenses/>.
 **/


// WARNING: Auto-generated file. Do not modify it by hand.


// Forward declaration of the autogenerated methods
{{#methods}}
static PyObject *sdk_{{class_name}}_{{c_function}}(
  sdk_{{class_name}}_Object* self, PyObject *args);
{{/methods}}
// End of forward declarations


// Forward declaration of the custom methods
{{#custom_methods}}
extern PyObject *{{implementation}}(sdk_{{class_name}}_Object* self, PyObject *args);
{{/custom_methods}}
// End of forward declarations


static PyMethodDef sdk_{{class_name}}_Methods[] = {
{{#methods}}
  { "{{short_name}}",
    (PyCFunction) sdk_{{class_name}}_{{c_function}}, METH_VARARGS,
    "Generated from C function {{c_function}}()" },
{{/methods}}
{{#custom_methods}}
  { "{{short_name}}",
    (PyCFunction) {{implementation}}, METH_VARARGS,
    "Implemented in C++ function {{implementation}}()" },
{{/custom_methods}}
  { NULL }  /* Sentinel */
};


static int sdk_{{class_name}}_Constructor(
  sdk_{{class_name}}_Object *self, PyObject *args, PyObject *kwds)
{
  PythonLock::LogCall("Creating Python object of class {{class_name}}");

  self->object_ = NULL;
  self->borrowed_ = false;
  
  long long object = 0;
  unsigned char borrowed = false;
  
  if (PyArg_ParseTuple(args, "Lb", &object, &borrowed))
  {
    self->object_ = reinterpret_cast<{{class_name}}*>(static_cast<intptr_t>(object));
    self->borrowed_ = borrowed;
    return 0;
  }
  else
  {
    PyErr_SetString(PyExc_ValueError, "Expected a pair (pointer, borrowed) in the constructor");
    return -1;
  }
}


/**
 * Static global structure => the fields that are beyond the last
 * initialized field are set to zero.
 * https://stackoverflow.com/a/11152199/881731
 **/
static PyTypeObject sdk_{{class_name}}_Type = {
  PyVarObject_HEAD_INIT(NULL, 0)
  "orthanc.{{short_name}}",    /* tp_name */
  sizeof(sdk_{{class_name}}_Object), /* tp_basicsize */
};


{{#destructor}}
static void sdk_{{class_name}}_Destructor(PyObject *self)
{
  PythonLock::LogCall("Destroying Python object of class {{class_name}}");

  sdk_{{class_name}}_Object& tmp = *((sdk_{{class_name}}_Object*) self);
  
  if (tmp.object_ != NULL &&
      !tmp.borrowed_)
  {
    {{destructor}}(OrthancPlugins::GetGlobalContext(), tmp.object_);
    tmp.object_ = NULL;
  }
  
  Py_TYPE(self)->tp_free((PyObject *)self);
}
{{/destructor}}


static void Register{{class_name}}Class(PyObject* module)
{
  sdk_{{class_name}}_Type.tp_new = PyType_GenericNew;
  sdk_{{class_name}}_Type.tp_flags = Py_TPFLAGS_DEFAULT;
  sdk_{{class_name}}_Type.tp_doc = "Generated from Orthanc C class: {{class_name}}";
  sdk_{{class_name}}_Type.tp_methods = sdk_{{class_name}}_Methods;
  sdk_{{class_name}}_Type.tp_init = (initproc) sdk_{{class_name}}_Constructor;

{{#destructor}}
  /**
   * "tp_dealloc is called when the reference count of the object goes
   * down to zero. This is where you destroy the object and its
   * members. It should then free the memory occupied by the object by
   * calling tp_free."
   * https://stackoverflow.com/a/24863227/881731
   **/
  sdk_{{class_name}}_Type.tp_dealloc = sdk_{{class_name}}_Destructor;
{{/destructor}}
  
  if (PyType_Ready(&sdk_{{class_name}}_Type) < 0)
  {
    ORTHANC_PLUGINS_LOG_ERROR("Cannot register Python class: {{class_name}}");
    ORTHANC_PLUGINS_THROW_EXCEPTION(InternalError);
  }

  Py_INCREF(&sdk_{{class_name}}_Type);
  if (PyModule_AddObject(module, "{{short_name}}", (PyObject *)&sdk_{{class_name}}_Type) < 0)
  {
    ORTHANC_PLUGINS_LOG_ERROR("Cannot register Python class: {{class_name}}");
    Py_DECREF(&sdk_{{class_name}}_Type);
    ORTHANC_PLUGINS_THROW_EXCEPTION(InternalError);
  }
}


PyTypeObject* Get{{class_name}}Type()
{
  return &sdk_{{class_name}}_Type;
}