IMP  2.2.0
The Integrative Modeling Platform
saxs_config.h
1 /*
2  * \file IMP/saxs/saxs_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, IMPSAXS_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  * IMPSAXSEXPORT 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::saxs namespace.
17  * This is simply achieved by wrapping things with the
18  * IMPSAXS_BEGIN_NAMESPACE and IMPSAXS_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 IMPSAXS_CONFIG_H
30 #define IMPSAXS_CONFIG_H
31 
32 #include <IMP/base/base_config.h>
33 #include <string>
34 
35 #ifdef _MSC_VER
36 
37 #ifdef IMPSAXS_EXPORTS
38 #define IMPSAXSEXPORT __declspec(dllexport)
39 #else // EXPORTS
40 #define IMPSAXSEXPORT __declspec(dllimport)
41 #endif // EXPORTS
42 
43 #else // _MSC_VER
44 
45 #ifdef GCC_VISIBILITY
46 #define IMPSAXSEXPORT __attribute__((visibility("default")))
47 #else // GCC_VISIBILITY
48 #define IMPSAXSEXPORT
49 #endif // GCC_VISIBILITY
50 
51 #endif // _MSC_VER
52 
53 #if defined(_MSC_VER) && !defined(SWIG)
54 #ifdef IMPSAXS_EXPORTS
55 
56 #define IMPSAXS_EXPORT_TEMPLATE(name) \
57  template class __declspec(dllexport) name
58 
59 #else //EXPORTS
60 
61 #define IMPSAXS_EXPORT_TEMPLATE(name) \
62  template class __declspec(dllimport) name
63 
64 #endif // EXPORTS
65 
66 #else // MSC and SWIG
67 #define IMPSAXS_EXPORT_TEMPLATE(name) IMP_REQUIRE_SEMICOLON_NAMESPACE
68 
69 #endif // MSC and SWIG
70 
71 #if !defined(SWIG) && !defined(IMP_DOXYGEN)
72 
73 #define IMPSAXS_BEGIN_NAMESPACE \
74  IMP_COMPILER_ENABLE_WARNINGS namespace IMP{namespace saxs {
75 
76 #define IMPSAXS_END_NAMESPACE } } \
77 IMP_COMPILER_DISABLE_WARNINGS
78 
79 #define IMPSAXS_BEGIN_INTERNAL_NAMESPACE IMPSAXS_BEGIN_NAMESPACE \
80  namespace internal {
81 
82 #define IMPSAXS_END_INTERNAL_NAMESPACE } IMPSAXS_END_NAMESPACE
83 
84 #else // SWIG and DOXYGEN
85 #define IMPSAXS_BEGIN_NAMESPACE namespace IMP{namespace saxs {
86 
87 #define IMPSAXS_END_NAMESPACE } }
88 
89 #define IMPSAXS_BEGIN_INTERNAL_NAMESPACE IMPSAXS_BEGIN_NAMESPACE\
90  namespace internal {
91 
92 #define IMPSAXS_END_INTERNAL_NAMESPACE } IMPSAXS_END_NAMESPACE
93 
94 #endif // SWIG AND DOXYGEN
95 
96 #define IMP_SAXS_USE_IMP_BASE
97 #define IMP_SAXS_HAS_IMP_BASE 1
98 #define IMP_SAXS_USE_IMP_CGAL
99 #define IMP_SAXS_HAS_IMP_CGAL 1
100 #define IMP_SAXS_USE_IMP_CONTAINER
101 #define IMP_SAXS_HAS_IMP_CONTAINER 1
102 #define IMP_SAXS_USE_IMP_DISPLAY
103 #define IMP_SAXS_HAS_IMP_DISPLAY 1
104 #define IMP_SAXS_USE_IMP_KERNEL
105 #define IMP_SAXS_HAS_IMP_KERNEL 1
106 #define IMP_SAXS_USE_IMP_SCORE_FUNCTOR
107 #define IMP_SAXS_HAS_IMP_SCORE_FUNCTOR 1
108 #define IMP_SAXS_USE_BOOST_FILESYSTEM
109 #define IMP_SAXS_HAS_BOOST_FILESYSTEM 1
110 #define IMP_SAXS_USE_BOOST_PROGRAMOPTIONS
111 #define IMP_SAXS_HAS_BOOST_PROGRAMOPTIONS 1
112 #define IMP_SAXS_USE_BOOST_RANDOM
113 #define IMP_SAXS_HAS_BOOST_RANDOM 1
114 #define IMP_SAXS_USE_BOOST_REGEX
115 #define IMP_SAXS_HAS_BOOST_REGEX 1
116 #define IMP_SAXS_USE_BOOST_SYSTEM
117 #define IMP_SAXS_HAS_BOOST_SYSTEM 1
118 #define IMP_SAXS_USE_CGAL
119 #define IMP_SAXS_HAS_CGAL 1
120 #define IMP_SAXS_USE_HDF5
121 #define IMP_SAXS_HAS_HDF5 1
122 
123  // functions are defined explicitly for SWIG
124  namespace IMP {
125  namespace saxs {
126 /** \name Standard module methods
127  All \imp modules have a set of standard methods to help get information
128  about the module and about files associated with the module.
129  @{
130  */
131 #if !defined(SWIG)
132  IMPSAXSEXPORT std::string get_module_version();
133 #endif
134 
135 #if !defined(SWIG)
136  // SWIG will whine about duplicate definitions of function
137  inline std::string get_module_name() { return "IMP::saxs"; }
138 #endif
139 
140  }
141 } //namespace
142 
143 #if !defined(IMP_DOXYGEN) && !defined(SWIG)
144 
145 #include <IMP/base/Showable.h>
146 #include <IMP/base/hash.h>
147 
148 namespace IMP { namespace saxs {
149 using ::IMP::base::Showable;
150 using ::IMP::base::operator<<;
151 using ::IMP::base::hash_value;
152 } } // namespace
153 namespace IMP { namespace saxs { namespace internal {
154 using ::IMP::base::Showable;
155 using ::IMP::base::operator<<;
156 using ::IMP::base::hash_value;
157 } } } // namespace
158 
159 #endif // !defined(SWIG) && !defined(IMP_DOXYGEN)
160 
161 
162 #if !defined(SWIG)
163  namespace IMP {
164  namespace saxs {
165 
166  //! Return the full path to installed data
167  /** Each module has its own data directory, so be sure to use
168  the version of this function in the correct module. To read
169  the data file "data_library" that was placed in the \c data
170  directory of module "mymodule", do something like
171  \code
172  std::ifstream in(IMP::mymodule::get_data_path("data_library"));
173  \endcode
174  This will ensure that the code works when \imp is installed or
175  used via the \c setup_environment.sh script.
176  */
177  IMPSAXSEXPORT std::string get_data_path(std::string file_name);
178 
179  //! Return the path to installed example data for this module
180  /** Each module has its own example directory, so be sure to use
181  the version of this function in the correct module. For example
182  to read the file \c example_protein.pdb located in the
183  \c examples directory of the IMP::atom module, do
184  \code
185  IMP::atom::read_pdb(IMP::atom::get_example_path("example_protein.pdb",
186  model));
187  \endcode
188  This will ensure that the code works when \imp is installed or
189  used via the \c setup_environment.sh script.
190  */
191  IMPSAXSEXPORT std::string get_example_path(std::string file_name);
192  /** @} */
193 
194  }
195 } // namespace
196 
197 #endif // SWIG
198 
200 
201 #ifdef IMP_DOXYGEN
202 /** \namespace IMP::saxs
203  \brief See [IMP.saxs](\ref impsaxs) for more information.
204  */
205 #endif
206 
207 #endif /* IMPSAXS_CONFIG_H */
208 
209 // Here so it is always parsed
210 
211 #ifdef IMPSAXS_DEPRECATED_HEADER
212 #undef IMPSAXS_DEPRECATED_HEADER
213 #undef IMPSAXS_DEPRECATED_VALUE_DEF
214 #undef IMPSAXS_DEPRECATED_VALUE_DECL
215 #undef IMPSAXS_DEPRECATED_OBJECT_DEF
216 #undef IMPSAXS_DEPRECATED_OBJECT_DECL
217 #undef IMPSAXS_DEPRECATED_FUNCTION_DEF
218 #undef IMPSAXS_DEPRECATED_FUNCTION_DECL
219 #undef IMPSAXS_DEPRECATED_METHOD_DEF
220 #undef IMPSAXS_DEPRECATED_METHOD_DECL
221 #undef IMPSAXS_DEPRECATED_MACRO
222 #undef IMPSAXS_SHOW_WARNINGS
223 #endif
224 
225 // the central modules we can update easily, so don't warn in them
226 #if defined( IMPSAXS_COMPILATION) \
227  || defined(SWIG) || defined(IMP_SWIG_WRAPPER) \
228  || defined( IMPSAXS_ALL) || defined(IMP_DOXYGEN) \
229  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION) \
230  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION) \
231  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
232  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
233  || defined(IMPSCOREFUNCTOR_COMPILATION) || defined(IMPRMF_COMPILATION) \
234  || defined(IMPGSL_COMPILATION)
235 #define IMPSAXS_SHOW_WARNINGS 0
236 #else
237 #define IMPSAXS_SHOW_WARNINGS 1
238 #endif
239 
240 // suppress header warnings with all header, SWIG wrapper and in the module
241 #if IMPSAXS_SHOW_WARNINGS
242 #define IMPSAXS_DEPRECATED_HEADER(version, help_message) \
243  IMP_PRAGMA(message(__FILE__ " is deprecated: " help_message))
244 #define IMPSAXS_DEPRECATED_VALUE_DECL(version) \
245  IMP_DEPRECATED_ATTRIBUTE
246 #define IMPSAXS_DEPRECATED_OBJECT_DECL(version) \
247  IMP_DEPRECATED_ATTRIBUTE
248 #define IMPSAXS_DEPRECATED_FUNCTION_DECL(version) \
249  IMP_DEPRECATED_ATTRIBUTE
250 #define IMPSAXS_DEPRECATED_METHOD_DECL(version) \
251  IMP_DEPRECATED_ATTRIBUTE
252 
253 #else //IMPSAXS_SHOW_WARNINGS
254 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
255 #define IMPSAXS_DEPRECATED_HEADER(version, help_message) \
256 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
257 #define IMPSAXS_DEPRECATED_VALUE_DECL(version)
258 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
259 #define IMPSAXS_DEPRECATED_OBJECT_DECL(version)
260 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
261 #define IMPSAXS_DEPRECATED_FUNCTION_DECL(version)
262 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
263 #define IMPSAXS_DEPRECATED_METHOD_DECL(version)
264 
265 #endif // IMPSAXS_SHOW_WARNINGS
266 
267 // only warn about it in the all inclusion to cut down on copies
268 #if !defined(IMP_ALL) || defined(SWIG) || defined(IMP_DOXYGEN) \
269  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION) \
270  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION) \
271  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
272  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
273  || defined(IMPSCOREFUNCTOR_COMPILATION)
274 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
275 #define IMPSAXS_DEPRECATED_MACRO(version, message)
276 
277 #else
278 #define IMPSAXS_DEPRECATED_MACRO(version, message) \
279  IMP_DEPRECATED_MACRO(version, message)
280 #endif
281 
282 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
283 #define IMPSAXS_DEPRECATED_VALUE_DEF(version, message) \
284  IMP_DEPRECATED_VALUE_RUNTIME_WARNING(version, message)
285 
286 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
287 #define IMPSAXS_DEPRECATED_OBJECT_DEF(version, message) \
288  IMP_DEPRECATED_OBJECT_RUNTIME_WARNING(version, message)
289 
290 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
291 #define IMPSAXS_DEPRECATED_FUNCTION_DEF(version, message) \
292  IMP_DEPRECATED_FUNCTION_RUNTIME_WARNING(version, message)
293 
294 /** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
295 #define IMPSAXS_DEPRECATED_METHOD_DEF(version, message) \
296  IMP_DEPRECATED_METHOD_RUNTIME_WARNING(version, message)
297 
298 
300 
301 #if defined(IMP_EXECUTABLE) && !defined(IMP_EXECUTABLE_WARNINGS)
302 IMP_COMPILER_ENABLE_WARNINGS
303 #define IMP_EXECUTABLE_WARNINGS
304 #endif
std::string get_data_path(std::string file_name)
Return the full path to installed data.
Various compiler workarounds.
IO support.
std::string get_example_path(std::string file_name)
Return the path to installed example data for this module.
IO support.