IMP  2.1.0
The Integrative Modeling Platform
example_config.h
1 /*
2  * \file IMP/example/example_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, IMPEXAMPLE_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  * IMPEXAMPLEEXPORT 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::example namespace.
17  * This is simply achieved by wrapping things with the
18  * IMPEXAMPLE_BEGIN_NAMESPACE and IMPEXAMPLE_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-2013 IMP Inventors. All rights reserved.
26  *
27  */
28 
29 #ifndef IMPEXAMPLE_CONFIG_H
30 #define IMPEXAMPLE_CONFIG_H
31 
32 #include <IMP/base/base_config.h>
33 #include <string>
34 
35 #ifdef _MSC_VER
36 
37 #ifdef IMPEXAMPLE_EXPORTS
38 #define IMPEXAMPLEEXPORT __declspec(dllexport)
39 #else // EXPORTS
40 #define IMPEXAMPLEEXPORT __declspec(dllimport)
41 #endif // EXPORTS
42 
43 #else // _MSC_VER
44 
45 #ifdef GCC_VISIBILITY
46 #define IMPEXAMPLEEXPORT __attribute__((visibility("default")))
47 #else // GCC_VISIBILITY
48 #define IMPEXAMPLEEXPORT
49 #endif // GCC_VISIBILITY
50 
51 #endif // _MSC_VER
52 
53 #if defined(_MSC_VER) && !defined(SWIG)
54 #ifdef IMPEXAMPLE_EXPORTS
55 
56 #define IMPEXAMPLE_EXPORT_TEMPLATE(name) \
57  template class __declspec(dllexport) name
58 
59 #else //EXPORTS
60 
61 #define IMPEXAMPLE_EXPORT_TEMPLATE(name) \
62  template class __declspec(dllimport) name
63 
64 #endif // EXPORTS
65 
66 #else // MSC and SWIG
67 #define IMPEXAMPLE_EXPORT_TEMPLATE(name) IMP_REQUIRE_SEMICOLON_NAMESPACE
68 
69 #endif // MSC and SWIG
70 
71 #if !defined(SWIG) && !defined(IMP_DOXYGEN)
72 
73 #define IMPEXAMPLE_BEGIN_NAMESPACE \
74  IMP_COMPILER_ENABLE_WARNINGS namespace IMP{namespace example {
75 
76 #define IMPEXAMPLE_END_NAMESPACE } } \
77 IMP_COMPILER_DISABLE_WARNINGS
78 
79 #define IMPEXAMPLE_BEGIN_INTERNAL_NAMESPACE IMPEXAMPLE_BEGIN_NAMESPACE \
80  namespace internal {
81 
82 #define IMPEXAMPLE_END_INTERNAL_NAMESPACE } IMPEXAMPLE_END_NAMESPACE
83 
84 #else // SWIG and DOXYGEN
85 #define IMPEXAMPLE_BEGIN_NAMESPACE namespace IMP{namespace example {
86 
87 #define IMPEXAMPLE_END_NAMESPACE } }
88 
89 #define IMPEXAMPLE_BEGIN_INTERNAL_NAMESPACE IMPEXAMPLE_BEGIN_NAMESPACE\
90  namespace internal {
91 
92 #define IMPEXAMPLE_END_INTERNAL_NAMESPACE } IMPEXAMPLE_END_NAMESPACE
93 
94 #endif // SWIG AND DOXYGEN
95 
96 #define IMP_EXAMPLE_USE_IMP_ALGEBRA
97 #define IMP_EXAMPLE_HAS_IMP_ALGEBRA 1
98 #define IMP_EXAMPLE_USE_IMP_BASE
99 #define IMP_EXAMPLE_HAS_IMP_BASE 1
100 #define IMP_EXAMPLE_USE_IMP_CGAL
101 #define IMP_EXAMPLE_HAS_IMP_CGAL 1
102 #define IMP_EXAMPLE_USE_IMP_DISPLAY
103 #define IMP_EXAMPLE_HAS_IMP_DISPLAY 1
104 #define IMP_EXAMPLE_USE_IMP_KERNEL
105 #define IMP_EXAMPLE_HAS_IMP_KERNEL 1
106 #define IMP_EXAMPLE_USE_IMP_RMF
107 #define IMP_EXAMPLE_HAS_IMP_RMF 1
108 #define IMP_EXAMPLE_USE_IMP_SCORE_FUNCTOR
109 #define IMP_EXAMPLE_HAS_IMP_SCORE_FUNCTOR 1
110 #define IMP_EXAMPLE_USE_IMP_STATISTICS
111 #define IMP_EXAMPLE_HAS_IMP_STATISTICS 1
112 #define IMP_EXAMPLE_USE_BOOST_FILESYSTEM
113 #define IMP_EXAMPLE_HAS_BOOST_FILESYSTEM 1
114 #define IMP_EXAMPLE_USE_BOOST_GRAPH
115 #define IMP_EXAMPLE_HAS_BOOST_GRAPH 1
116 #define IMP_EXAMPLE_USE_BOOST_PROGRAMOPTIONS
117 #define IMP_EXAMPLE_HAS_BOOST_PROGRAMOPTIONS 1
118 #define IMP_EXAMPLE_USE_BOOST_RANDOM
119 #define IMP_EXAMPLE_HAS_BOOST_RANDOM 1
120 #define IMP_EXAMPLE_USE_BOOST_REGEX
121 #define IMP_EXAMPLE_HAS_BOOST_REGEX 1
122 #define IMP_EXAMPLE_USE_BOOST_SYSTEM
123 #define IMP_EXAMPLE_HAS_BOOST_SYSTEM 1
124 #define IMP_EXAMPLE_USE_CGAL
125 #define IMP_EXAMPLE_HAS_CGAL 1
126 #define IMP_EXAMPLE_USE_HDF5
127 #define IMP_EXAMPLE_HAS_HDF5 1
128 #define IMP_EXAMPLE_USE_RMF
129 #define IMP_EXAMPLE_HAS_RMF 1
130 #define IMP_EXAMPLE_NO_EXAMPLEDEPENDENCY
131 #define IMP_EXAMPLE_HAS_EXAMPLEDEPENDENCY 0
132 
133  // functions are defined explicitly for SWIG
134  namespace IMP {
135  namespace example {
136 /** \name Standard module methods
137  All \imp modules have a set of standard methods to help get information
138  about the module and about files associated with the module.
139  @{
140  */
141 #if !defined(SWIG)
142  IMPEXAMPLEEXPORT std::string get_module_version();
143 #endif
144 
145 #if !defined(SWIG)
146  // SWIG will whine about duplicate definitions of function
147  inline std::string get_module_name() { return "IMP::example"; }
148 #endif
149 
150  }
151 } //namespace
152 
153 #if !defined(IMP_DOXYGEN) && !defined(SWIG)
154 
155 #include <IMP/base/Showable.h>
156 #include <IMP/base/hash.h>
157 
158 namespace IMP { namespace example {
159 using ::IMP::base::Showable;
160 using ::IMP::base::operator<<;
161 using ::IMP::base::hash_value;
162 } } // namespace
163 namespace IMP { namespace example { namespace internal {
164 using ::IMP::base::Showable;
165 using ::IMP::base::operator<<;
166 using ::IMP::base::hash_value;
167 } } } // namespace
168 
169 #endif // !defined(SWIG) && !defined(IMP_DOXYGEN)
170 
171 
172 #if !defined(SWIG)
173  namespace IMP {
174  namespace example {
175 
176  //! Return the full path to installed data
177  /** Each module has its own data directory, so be sure to use
178  the version of this function in the correct module. To read
179  the data file "data_library" that was placed in the \c data
180  directory of module "mymodule", do something like
181  \code
182  std::ifstream in(IMP::mymodule::get_data_path("data_library"));
183  \endcode
184  This will ensure that the code works when \imp is installed or
185  used via the \c setup_environment.sh script.
186  */
187  IMPEXAMPLEEXPORT std::string get_data_path(std::string file_name);
188 
189  //! Return the path to installed example data for this module
190  /** Each module has its own example directory, so be sure to use
191  the version of this function in the correct module. For example
192  to read the file \c example_protein.pdb located in the
193  \c examples directory of the IMP::atom module, do
194  \code
195  IMP::atom::read_pdb(IMP::atom::get_example_path("example_protein.pdb",
196  model));
197  \endcode
198  This will ensure that the code works when \imp is installed or
199  used via the \c setup_environment.sh script.
200  */
201  IMPEXAMPLEEXPORT std::string get_example_path(std::string file_name);
202  /** @} */
203 
204  }
205 } // namespace
206 
207 #endif // SWIG
208 
210 
211 #ifdef IMP_DOXYGEN
212 /** \namespace IMP::example
213  \brief See [IMP.example](\ref impexample) for more information.
214  */
215 #endif
216 
217 #endif /* IMPEXAMPLE_CONFIG_H */
218 
219 // Here so it is always parsed
220 
221 #ifdef IMPEXAMPLE_DEPRECATED_HEADER
222 #undef IMPEXAMPLE_DEPRECATED_HEADER
223 #undef IMPEXAMPLE_DEPRECATED_VALUE_DEF
224 #undef IMPEXAMPLE_DEPRECATED_VALUE_DECL
225 #undef IMPEXAMPLE_DEPRECATED_OBJECT_DEF
226 #undef IMPEXAMPLE_DEPRECATED_OBJECT_DECL
227 #undef IMPEXAMPLE_DEPRECATED_FUNCTION_DEF
228 #undef IMPEXAMPLE_DEPRECATED_FUNCTION_DECL
229 #undef IMPEXAMPLE_DEPRECATED_METHOD_DEF
230 #undef IMPEXAMPLE_DEPRECATED_METHOD_DECL
231 #undef IMPEXAMPLE_DEPRECATED_MACRO
232 #undef IMPEXAMPLE_SHOW_WARNINGS
233 #endif
234 
235 // the central modules we can update easily, so don't warn in them
236 #if defined( IMPEXAMPLE_COMPILATION) \
237  || defined(SWIG) || defined(IMP_SWIG_WRAPPER) \
238  || defined( IMPEXAMPLE_ALL) || defined(IMP_DOXYGEN) \
239  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION) \
240  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION) \
241  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
242  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
243  || defined(IMPSCOREFUNCTOR_COMPILATION) || defined(IMPRMF_COMPILATION) \
244  || defined(IMPGSL_COMPILATION)
245 #define IMPEXAMPLE_SHOW_WARNINGS 0
246 #else
247 #define IMPEXAMPLE_SHOW_WARNINGS 1
248 #endif
249 
250 // suppress header warnings with all header, SWIG wrapper and in the module
251 #if IMPEXAMPLE_SHOW_WARNINGS
252 #define IMPEXAMPLE_DEPRECATED_HEADER(version, help_message) \
253  IMP_PRAGMA(message(__FILE__ " is deprecated: " help_message))
254 #define IMPEXAMPLE_DEPRECATED_VALUE_DECL(version) \
255  IMP_DEPRECATED_ATTRIBUTE
256 #define IMPEXAMPLE_DEPRECATED_OBJECT_DECL(version) \
257  IMP_DEPRECATED_ATTRIBUTE
258 #define IMPEXAMPLE_DEPRECATED_FUNCTION_DECL(version) \
259  IMP_DEPRECATED_ATTRIBUTE
260 #define IMPEXAMPLE_DEPRECATED_METHOD_DECL(version) \
261  IMP_DEPRECATED_ATTRIBUTE
262 
263 #else //IMPEXAMPLE_SHOW_WARNINGS
264 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
265 #define IMPEXAMPLE_DEPRECATED_HEADER(version, help_message) \
266 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
267 #define IMPEXAMPLE_DEPRECATED_VALUE_DECL(version)
268 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
269 #define IMPEXAMPLE_DEPRECATED_OBJECT_DECL(version)
270 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
271 #define IMPEXAMPLE_DEPRECATED_FUNCTION_DECL(version)
272 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
273 #define IMPEXAMPLE_DEPRECATED_METHOD_DECL(version)
274 
275 #endif // IMPEXAMPLE_SHOW_WARNINGS
276 
277 // only warn about it in the all inclusion to cut down on copies
278 #if !defined(IMP_ALL) || defined(SWIG) || defined(IMP_DOXYGEN) \
279  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION) \
280  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION) \
281  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
282  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
283  || defined(IMPSCOREFUNCTOR_COMPILATION)
284 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
285 #define IMPEXAMPLE_DEPRECATED_MACRO(version, message)
286 
287 #else
288 #define IMPEXAMPLE_DEPRECATED_MACRO(version, message) \
289  IMP_DEPRECATED_MACRO(version, message)
290 #endif
291 
292 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
293 #define IMPEXAMPLE_DEPRECATED_VALUE_DEF(version, message) \
294  IMP_DEPRECATED_VALUE_RUNTIME_WARNING(version, message)
295 
296 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
297 #define IMPEXAMPLE_DEPRECATED_OBJECT_DEF(version, message) \
298  IMP_DEPRECATED_OBJECT_RUNTIME_WARNING(version, message)
299 
300 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
301 #define IMPEXAMPLE_DEPRECATED_FUNCTION_DEF(version, message) \
302  IMP_DEPRECATED_FUNCTION_RUNTIME_WARNING(version, message)
303 
304 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
305 #define IMPEXAMPLE_DEPRECATED_METHOD_DEF(version, message) \
306  IMP_DEPRECATED_METHOD_RUNTIME_WARNING(version, message)
307 
308 
310 
311 #if defined(IMP_EXECUTABLE) && !defined(IMP_EXECUTABLE_WARNINGS)
312 IMP_COMPILER_ENABLE_WARNINGS
313 #define IMP_EXECUTABLE_WARNINGS
314 #endif
Various compiler workarounds.
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.