text: /* -*- Mode: C; c-basic-offset: 4 -*-
   * pyglib - Python bindings for GLib toolkit.
   * Copyright (C) 1998-2003  James Henstridge
   *               2004-2008  Johan Dahlin
   *
   * This library is free software; you can redistribute it and/or
   * modify it under the terms of the GNU Lesser General Public
   * License as published by the Free Software Foundation; either
   * version 2.1 of the License, or (at your option) any later version.
   *
   * This library 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
   * Lesser General Public License for more details.
   *
   * You should have received a copy of the GNU Lesser General Public
   * License along with this library; if not, write to the Free Software
   * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301
   * USA
   */
  
  #ifndef __PYGLIB_H__
  #define __PYGLIB_H__
  
  #include <Python.h>
  
  #include <glib.h>
  
  G_BEGIN_DECLS
  
  typedef void (*PyGLibThreadsEnabledFunc) (void);
  typedef void (*PyGLibThreadBlockFunc) (void);
  
  void pyglib_init(void);
  void pyglib_init_internal(PyObject *api);
  PyGILState_STATE pyglib_gil_state_ensure(void);
  void pyglib_gil_state_release(PyGILState_STATE state);
  int pyglib_enable_threads(void);
  gboolean pyglib_error_check(GError **error);
  gboolean pyglib_gerror_exception_check(GError **error);
  PyObject *pyglib_register_exception_for_domain(gchar *name,
  					       gint error_domain);
  gboolean pyglib_threads_enabled(void);
  PyObject * pyglib_main_context_new(GMainContext *context);
  void pyglib_set_thread_block_funcs(PyGLibThreadBlockFunc block_threads_func,
  				   PyGLibThreadBlockFunc unblock_threads_func);
  void pyglib_block_threads(void);
  void pyglib_unblock_threads(void);
  PyObject * pyglib_option_context_new(GOptionContext *context);
  PyObject * pyglib_option_group_new(GOptionGroup *group);
  GOptionGroup * pyglib_option_group_transfer_group(PyObject *self);
  PyObject * pyglib_float_from_timeval(GTimeVal timeval);
  
  /* Private: for gobject <-> glib interaction only. */
  void _pyglib_notify_on_enabling_threads(PyGLibThreadsEnabledFunc callback);
  PyObject* _pyglib_generic_ptr_richcompare(void* a, void *b, int op);
  PyObject* _pyglib_generic_long_richcompare(long a, long b, int op);
  
  #define pyglib_begin_allow_threads		\
      G_STMT_START {                              \
          PyThreadState *_save = NULL;            \
          if (pyglib_threads_enabled())		\
              _save = PyEval_SaveThread();
  
  #define pyglib_end_allow_threads                \
          if (pyglib_threads_enabled())           \
              PyEval_RestoreThread(_save);        \
      } G_STMT_END
  
  #define PYGLIB_REGISTER_TYPE(d, type, name)	        \
      if (!type.tp_alloc)                                 \
  	type.tp_alloc = PyType_GenericAlloc;            \
      if (!type.tp_new)                                   \
  	type.tp_new = PyType_GenericNew;                \
      if (PyType_Ready(&type))                            \
  	return;                                         \
      PyDict_SetItemString(d, name, (PyObject *)&type);
  
  
  G_END_DECLS
  
  #endif /* __PYGLIB_H__ */
  
  