python/py3compat.h

   1 /*
   2    Unix SMB/CIFS implementation.
   3    Python 3 compatibility macros
   4    Copyright (C) Petr Viktorin <pviktori@redhat.com> 2015
   5
   6    This program is free software; you can redistribute it and/or modify
   7    it under the terms of the GNU General Public License as published by
   8    the Free Software Foundation; either version 3 of the License, or
   9    (at your option) any later version.
  10
  11    This program is distributed in the hope that it will be useful,
  12    but WITHOUT ANY WARRANTY; without even the implied warranty of
  13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14    GNU General Public License for more details.
  15
  16    You should have received a copy of the GNU General Public License
  17    along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18 */
  19
  20 #ifndef _SAMBA_PY3COMPAT_H_
  21 #define _SAMBA_PY3COMPAT_H_
  22 #include <Python.h>
  23
  24 /* Quick docs:
  25  *
  26  * "PyStr_*" works like PyUnicode_* on Python 3, but uses bytestrings (str)
  27  * under Python 2.
  28  *
  29  * "PyBytes_*" work like in Python 3; on Python 2 they are aliased to their
  30  * PyString_* names.
  31  *
  32  * Syntax for module initialization is as in Python 3, except the entrypoint
  33  * function definition and declaration:
  34  *     PyMODINIT_FUNC PyInit_modulename(void);
  35  *     PyMODINIT_FUNC PyInit_modulename(void)
  36  *     {
  37  *         ...
  38  *     }
  39  * is replaced by:
  40  *     MODULE_INIT_FUNC(modulename)
  41  *     {
  42  *         ...
  43  *     }
  44  *
  45  * In the entrypoint, create a module using PyModule_Create and PyModuleDef,
  46  * and return it. See Python 3 documentation for details.
  47  * For Python 2 compatibility, always set PyModuleDef.m_size to -1.
  48  *
  49  */
  50
  51 /***** Python 3 *****/
  52
  53 /* Strings */
  54
  55 /* description of bytes objects */
  56 #define PY_DESC_PY3_BYTES "bytes"
  57
  58 /* Module init */
  59
  60 #define MODULE_INIT_FUNC(name) \
  61     PyMODINIT_FUNC PyInit_ ## name(void); \
  62     PyMODINIT_FUNC PyInit_ ## name(void)
  63
  64 /* PyArg_ParseTuple/Py_BuildValue argument */
  65
  66 #define PYARG_BYTES_LEN "y#"
  67 #define PYARG_STR_UNI "es"
  68
  69 #endif