IMP  2.3.1
The Integrative Modeling Platform
isd_config.h
1 /*
2  * \file IMP/isd/isd_config.h
3  * \brief Provide macros to mark functions and classes as exported
4  * from a DLL/.so, and to set up namespaces
5  *
6  * When building the module, IMPISD_EXPORTS should be defined, and when
7  * using the module externally, it should not be. Classes and functions
8  * declared in the module's headers should then be marked with
9  * IMPISDEXPORT if they are intended to be part of the API and
10  * they are not defined entirely in a header.
11  *
12  * The Windows build environment requires applications to mark exports in
13  * this way; we use the same markings to set the visibility of ELF symbols
14  * if we have compiler support.
15  *
16  * All code in this module should live in the IMP::isd namespace.
17  * This is simply achieved by wrapping things with the
18  * IMPISD_BEGIN_NAMESPACE and IMPISD_END_NAMESPACE macros.
19  * There are similar macros for module code that is designed to be for
20  * internal use only.
21  *
22  * This header is auto-generated by tools/build/setup_module.py;
23  * it should not be edited manually.
24  *
25  * Copyright 2007-2014 IMP Inventors. All rights reserved.
26  *
27  */
28 
29 #ifndef IMPISD_CONFIG_H
30 #define IMPISD_CONFIG_H
31 
32 #include <IMP/base/base_config.h>
33 #include <string>
34 
35 #ifdef _MSC_VER
36 
37 #ifdef IMPISD_EXPORTS
38 #define IMPISDEXPORT __declspec(dllexport)
39 #else // EXPORTS
40 #define IMPISDEXPORT __declspec(dllimport)
41 #endif // EXPORTS
42 
43 #else // _MSC_VER
44 
45 #ifdef GCC_VISIBILITY
46 #define IMPISDEXPORT __attribute__((visibility("default")))
47 #else // GCC_VISIBILITY
48 #define IMPISDEXPORT
49 #endif // GCC_VISIBILITY
50 
51 #endif // _MSC_VER
52 
53 #if defined(_MSC_VER) && !defined(SWIG)
54 #ifdef IMPISD_EXPORTS
55 
56 #define IMPISD_EXPORT_TEMPLATE(name) \
57  template class __declspec(dllexport) name
58 
59 #else //EXPORTS
60 
61 #define IMPISD_EXPORT_TEMPLATE(name) \
62  template class __declspec(dllimport) name
63 
64 #endif // EXPORTS
65 
66 #else // MSC and SWIG
67 #define IMPISD_EXPORT_TEMPLATE(name) IMP_REQUIRE_SEMICOLON_NAMESPACE
68 
69 #endif // MSC and SWIG
70 
71 #if !defined(SWIG) && !defined(IMP_DOXYGEN)
72 
73 #define IMPISD_BEGIN_NAMESPACE \
74  IMP_COMPILER_ENABLE_WARNINGS namespace IMP{namespace isd {
75 
76 #define IMPISD_END_NAMESPACE } } \
77 IMP_COMPILER_DISABLE_WARNINGS
78 
79 #define IMPISD_BEGIN_INTERNAL_NAMESPACE IMPISD_BEGIN_NAMESPACE \
80  namespace internal {
81 
82 #define IMPISD_END_INTERNAL_NAMESPACE } IMPISD_END_NAMESPACE
83 
84 #else // SWIG and DOXYGEN
85 #define IMPISD_BEGIN_NAMESPACE namespace IMP{namespace isd {
86 
87 #define IMPISD_END_NAMESPACE } }
88 
89 #define IMPISD_BEGIN_INTERNAL_NAMESPACE IMPISD_BEGIN_NAMESPACE\
90  namespace internal {
91 
92 #define IMPISD_END_INTERNAL_NAMESPACE } IMPISD_END_NAMESPACE
93 
94 #endif // SWIG AND DOXYGEN
95 
96 #define IMP_ISD_USE_IMP_BASE
97 #define IMP_ISD_HAS_IMP_BASE 1
98 #define IMP_ISD_USE_IMP_CGAL
99 #define IMP_ISD_HAS_IMP_CGAL 1
100 #define IMP_ISD_USE_IMP_DISPLAY
101 #define IMP_ISD_HAS_IMP_DISPLAY 1
102 #define IMP_ISD_USE_IMP_SCORE_FUNCTOR
103 #define IMP_ISD_HAS_IMP_SCORE_FUNCTOR 1
104 #define IMP_ISD_USE_BOOST_FILESYSTEM
105 #define IMP_ISD_HAS_BOOST_FILESYSTEM 1
106 #define IMP_ISD_USE_BOOST_PROGRAMOPTIONS
107 #define IMP_ISD_HAS_BOOST_PROGRAMOPTIONS 1
108 #define IMP_ISD_USE_BOOST_RANDOM
109 #define IMP_ISD_HAS_BOOST_RANDOM 1
110 #define IMP_ISD_USE_BOOST_REGEX
111 #define IMP_ISD_HAS_BOOST_REGEX 1
112 #define IMP_ISD_USE_BOOST_SYSTEM
113 #define IMP_ISD_HAS_BOOST_SYSTEM 1
114 #define IMP_ISD_USE_CGAL
115 #define IMP_ISD_HAS_CGAL 1
116 #define IMP_ISD_USE_HDF5
117 #define IMP_ISD_HAS_HDF5 1
118 
119 // functions are defined explicitly for SWIG
120 namespace IMP {
121  namespace isd {
122 /** \name Standard module functions
123  All \imp modules have a set of standard functions to help get information
124  about the module and about files associated with the module.
125  @{
126  */
127 #if !defined(SWIG)
128  IMPISDEXPORT std::string get_module_version();
129 #endif
130 
131 #if !defined(SWIG)
132  // SWIG will whine about duplicate definitions of function
133  inline std::string get_module_name() { return "IMP::isd"; }
134 #endif
135 
136  //! Return the full path to installed data
137  /** Each module has its own data directory, so be sure to use
138  the version of this function in the correct module. To read
139  the data file "data_library" that was placed in the \c data
140  directory of module "mymodule", do something like
141  \code
142  std::ifstream in(IMP::mymodule::get_data_path("data_library"));
143  \endcode
144  This will ensure that the code works when \imp is installed or
145  used via the \c setup_environment.sh script.
146  */
147 #if !defined(SWIG)
148  IMPISDEXPORT std::string get_data_path(std::string file_name);
149 #endif
150 
151  //! Return the path to installed example data for this module
152  /** Each module has its own example directory, so be sure to use
153  the version of this function in the correct module. For example
154  to read the file \c example_protein.pdb located in the
155  \c examples directory of the IMP::atom module, do
156  \code
157  IMP::atom::read_pdb(IMP::atom::get_example_path("example_protein.pdb",
158  model));
159  \endcode
160  This will ensure that the code works when \imp is installed or
161  used via the \c setup_environment.sh script.
162  */
163 #if !defined(SWIG)
164  IMPISDEXPORT std::string get_example_path(std::string file_name);
165 #endif
166  /** @} */
167 
168 
169  }
170 } //namespace
171 
172 #if !defined(IMP_DOXYGEN) && !defined(SWIG)
173 
174 #include <IMP/base/Showable.h>
175 #include <IMP/base/hash.h>
176 
177 namespace IMP { namespace isd {
178 using ::IMP::base::Showable;
179 using ::IMP::base::operator<<;
180 using ::IMP::base::hash_value;
181 } } // namespace
182 namespace IMP { namespace isd { namespace internal {
183 using ::IMP::base::Showable;
184 using ::IMP::base::operator<<;
185 using ::IMP::base::hash_value;
186 } } } // namespace
187 
188 #endif // !defined(SWIG) && !defined(IMP_DOXYGEN)
189 
190 
192 
193 #endif /* IMPISD_CONFIG_H */
194 
195 // Here so it is always parsed
196 
197 #ifdef IMPISD_DEPRECATED_HEADER
198 #undef IMPISD_DEPRECATED_HEADER
199 #undef IMPISD_DEPRECATED_VALUE_DEF
200 #undef IMPISD_DEPRECATED_VALUE_DECL
201 #undef IMPISD_DEPRECATED_OBJECT_DEF
202 #undef IMPISD_DEPRECATED_OBJECT_DECL
203 #undef IMPISD_DEPRECATED_FUNCTION_DEF
204 #undef IMPISD_DEPRECATED_FUNCTION_DECL
205 #undef IMPISD_DEPRECATED_METHOD_DEF
206 #undef IMPISD_DEPRECATED_METHOD_DECL
207 #undef IMPISD_DEPRECATED_MACRO
208 #undef IMPISD_SHOW_WARNINGS
209 #endif
210 
211 // the central modules we can update easily, so don't warn in them
212 #if defined( IMPISD_COMPILATION) \
213  || defined(SWIG) || defined(IMP_SWIG_WRAPPER) \
214  || defined( IMPISD_ALL) || defined(IMP_DOXYGEN) \
215  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION) \
216  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION) \
217  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
218  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
219  || defined(IMPSCOREFUNCTOR_COMPILATION) || defined(IMPRMF_COMPILATION) \
220  || defined(IMPGSL_COMPILATION)
221 #define IMPISD_SHOW_WARNINGS 0
222 #else
223 #define IMPISD_SHOW_WARNINGS 1
224 #endif
225 
226 // suppress header warnings with all header, SWIG wrapper and in the module
227 #if IMPISD_SHOW_WARNINGS
228 #define IMPISD_DEPRECATED_HEADER(version, help_message) \
229  IMP_PRAGMA(message(__FILE__ " is deprecated: " help_message))
230 #define IMPISD_DEPRECATED_VALUE_DECL(version) \
231  IMP_DEPRECATED_ATTRIBUTE
232 #define IMPISD_DEPRECATED_OBJECT_DECL(version) \
233  IMP_DEPRECATED_ATTRIBUTE
234 #define IMPISD_DEPRECATED_FUNCTION_DECL(version) \
235  IMP_DEPRECATED_ATTRIBUTE
236 #define IMPISD_DEPRECATED_METHOD_DECL(version) \
237  IMP_DEPRECATED_ATTRIBUTE
238 
239 #else //IMPISD_SHOW_WARNINGS
240 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
241 #define IMPISD_DEPRECATED_HEADER(version, help_message) \
242 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
243 #define IMPISD_DEPRECATED_VALUE_DECL(version)
244 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
245 #define IMPISD_DEPRECATED_OBJECT_DECL(version)
246 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
247 #define IMPISD_DEPRECATED_FUNCTION_DECL(version)
248 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
249 #define IMPISD_DEPRECATED_METHOD_DECL(version)
250 
251 #endif // IMPISD_SHOW_WARNINGS
252 
253 // only warn about it in the all inclusion to cut down on copies
254 #if !defined(IMP_ALL) || defined(SWIG) || defined(IMP_DOXYGEN) \
255  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION) \
256  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION) \
257  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
258  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
259  || defined(IMPSCOREFUNCTOR_COMPILATION)
260 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
261 #define IMPISD_DEPRECATED_MACRO(version, message)
262 
263 #else
264 #define IMPISD_DEPRECATED_MACRO(version, message) \
265  IMP_DEPRECATED_MACRO(version, message)
266 #endif
267 
268 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
269 #define IMPISD_DEPRECATED_VALUE_DEF(version, message) \
270  IMP_DEPRECATED_VALUE_RUNTIME_WARNING(version, message)
271 
272 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
273 #define IMPISD_DEPRECATED_OBJECT_DEF(version, message) \
274  IMP_DEPRECATED_OBJECT_RUNTIME_WARNING(version, message)
275 
276 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
277 #define IMPISD_DEPRECATED_FUNCTION_DEF(version, message) \
278  IMP_DEPRECATED_FUNCTION_RUNTIME_WARNING(version, message)
279 
280 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
281 #define IMPISD_DEPRECATED_METHOD_DEF(version, message) \
282  IMP_DEPRECATED_METHOD_RUNTIME_WARNING(version, message)
283 
284 
286 
287 #if defined(IMP_EXECUTABLE) && !defined(IMP_EXECUTABLE_WARNINGS)
288 IMP_COMPILER_ENABLE_WARNINGS
289 #define IMP_EXECUTABLE_WARNINGS
290 #endif
IO support.
IO support.
std::string get_example_path(std::string file_name)
Return the path to installed example data for this module.
std::string get_data_path(std::string file_name)
Return the full path to installed data.
Various compiler workarounds.