1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
/**************************************************************************
* *
* Regina - A Normal Surface Theory Calculator *
* Python Interface *
* *
* Copyright (c) 1999-2025, Ben Burton *
* For further details contact Ben Burton (bab@debian.org). *
* *
* This program is free software; you can redistribute it and/or *
* modify it under the terms of the GNU General Public License as *
* published by the Free Software Foundation; either version 2 of the *
* License, or (at your option) any later version. *
* *
* As an exception, when this program is distributed through (i) the *
* App Store by Apple Inc.; (ii) the Mac App Store by Apple Inc.; or *
* (iii) Google Play by Google Inc., then that store may impose any *
* digital rights management, device limits and/or redistribution *
* restrictions that are required by its terms of service. *
* *
* 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 *
* General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License *
* along with this program. If not, see <https://www.gnu.org/licenses/>. *
* *
**************************************************************************/
/*! \file python/helpers.h
* \brief Various tools to assist with Python bindings for Regina.
*
* This file automatically includes the most commonly-used headers from
* python/helpers/, but not all of the headers in python/helpers/.
* Specifically, it excludes those headers that introduce non-trivial
* complexity to the code and whose use is not widespread across Regina's
* Python bindings.
*/
#ifndef __HELPERS_H
#ifndef __DOXYGEN
#define __HELPERS_H
#endif
/**
* On some systems we get warnings about Regina's helper classes having
* greater visibility than the pybind11 code that they use. The macro
* MATCH_PYBIND11_VISIBILITY allows us to fix this by setting the same
* visibility attributes on our classes also.
*/
#ifdef __GNUG__
#define MATCH_PYBIND11_VISIBILITY __attribute__((visibility("hidden")))
#else
#define MATCH_PYBIND11_VISIBILITY
#endif
// Include the core pybind11 headers, and make sure we're finding our own
// patched versions and not some other system installation of pybind11.
#include <pybind11/pybind11.h>
#if !defined(REGINA_PYBIND11)
#error "A system installation of pybind11 is being included instead of Regina's own patched version."
#endif
#include "helpers/docstrings.h"
#include "helpers/equality.h"
// #include "helpers/flags.h"
#include "helpers/gil.h"
#include "helpers/globals.h"
#include "helpers/output.h"
#include "helpers/listview.h"
#include "helpers/packet.h"
// #include "helpers/tableview.h"
#include "helpers/tightencoding.h"
#endif
|
