base_config.h

/*
 * \file IMP/base/base_config.h
 * \brief Provide macros to mark functions and classes as exported
 *        from a DLL/.so, and to set up namespaces
 *
 * When building the module, IMPBASE_EXPORTS should be defined, and when
 * using the module externally, it should not be. Classes and functions
 * declared in the module's headers should then be marked with
 * IMPBASEEXPORT if they are intended to be part of the API and
 * they are not defined entirely in a header.
 *
 * The Windows build environment requires applications to mark exports in
 * this way; we use the same markings to set the visibility of ELF symbols
 * if we have compiler support.
 *
 * All code in this module should live in the IMP::base namespace.
 * This is simply achieved by wrapping things with the
 * IMPBASE_BEGIN_NAMESPACE and IMPBASE_END_NAMESPACE macros.
 * There are similar macros for module code that is designed to be for
 * internal use only.
 *
 * This header is auto-generated by tools/build/setup_module.py;
 * it should not be edited manually.
 *
 * Copyright 2007-2013 IMP Inventors. All rights reserved.
 *
 */

#ifndef IMPBASE_CONFIG_H
#define IMPBASE_CONFIG_H

#include <IMP/base/base_config.h>
#include <string>

#ifdef _MSC_VER

#ifdef IMPBASE_EXPORTS
#define IMPBASEEXPORT __declspec(dllexport)
#else  // EXPORTS
#define IMPBASEEXPORT __declspec(dllimport)
#endif  // EXPORTS

#else  // _MSC_VER

#ifdef GCC_VISIBILITY
#define IMPBASEEXPORT __attribute__((visibility("default")))
#else  // GCC_VISIBILITY
#define IMPBASEEXPORT
#endif  // GCC_VISIBILITY

#endif  // _MSC_VER

#if defined(_MSC_VER) && !defined(SWIG)
#ifdef IMPBASE_EXPORTS

#define IMPBASE_EXPORT_TEMPLATE(name)     \
  template class __declspec(dllexport) name

#else  //EXPORTS

#define IMPBASE_EXPORT_TEMPLATE(name)     \
  template class __declspec(dllimport) name

#endif  // EXPORTS

#else  // MSC and SWIG
#define IMPBASE_EXPORT_TEMPLATE(name) IMP_REQUIRE_SEMICOLON_NAMESPACE

#endif  // MSC and SWIG

#if !defined(SWIG) && !defined(IMP_DOXYGEN)

#define IMPBASE_BEGIN_NAMESPACE \
  IMP_COMPILER_ENABLE_WARNINGS namespace IMP{namespace base {

#define IMPBASE_END_NAMESPACE } } \
IMP_COMPILER_DISABLE_WARNINGS

#define IMPBASE_BEGIN_INTERNAL_NAMESPACE IMPBASE_BEGIN_NAMESPACE \
  namespace internal {

#define IMPBASE_END_INTERNAL_NAMESPACE } IMPBASE_END_NAMESPACE

#else  // SWIG and DOXYGEN
#define IMPBASE_BEGIN_NAMESPACE namespace IMP{namespace base {

#define IMPBASE_END_NAMESPACE } }

#define IMPBASE_BEGIN_INTERNAL_NAMESPACE IMPBASE_BEGIN_NAMESPACE\
  namespace internal {

#define IMPBASE_END_INTERNAL_NAMESPACE } IMPBASE_END_NAMESPACE

#endif  // SWIG AND DOXYGEN

#define IMP_BUILD IMP_RELEASE
#define IMP_HAS_LOG IMP_VERBOSE
#define IMP_HAS_CHECKS IMP_INTERNAL
#define IMP_DEBUG 0
#define IMP_RELEASE 1
#define IMP_SILENT 0
#define IMP_PROGRESS 2
#define IMP_TERSE 3
#define IMP_VERBOSE 4
#define IMP_MEMORY 5
#define IMP_NONE 0
#define IMP_USAGE 1
#define IMP_INTERNAL 2
#define IMP_BASE_HAS_LOG4CXX 0
#define IMP_COMPILER_HAS_AUTO 0
#define IMP_COMPILER_HAS_DEBUG_VECTOR 1
#define IMP_BASE_USE_BOOST_RANDOM
#define IMP_BASE_HAS_BOOST_RANDOM 1
#define IMP_BASE_NO_GPERFTOOLS
#define IMP_BASE_HAS_GPERFTOOLS 0
#define IMP_BASE_NO_TCMALLOC_HEAPCHECKER
#define IMP_BASE_HAS_TCMALLOC_HEAPCHECKER 0
#define IMP_BASE_NO_TCMALLOC_HEAPPROFILER
#define IMP_BASE_HAS_TCMALLOC_HEAPPROFILER 0

    //  functions are defined explicitly for SWIG
    namespace IMP {
  namespace base {
/** \name Standard module methods
  All \imp modules have a set of standard methods to help get information
  about the module and about files associated with the module.
  @{
  */
#if !defined(SWIG)
    IMPBASEEXPORT std::string get_module_version();
#endif

#if !defined(SWIG)
    // SWIG will whine about duplicate definitions of function
    inline std::string get_module_name() { return "IMP::base"; }
#endif

  }
}  //namespace



#if !defined(SWIG)
    namespace IMP {
  namespace base {

    //! Return the full path to installed data
    /** Each module has its own data directory, so be sure to use
        the version of this function in the correct module. To read
        the data file "data_library" that was placed in the \c data
        directory of module "mymodule", do something like
        \code
        std::ifstream in(IMP::mymodule::get_data_path("data_library"));
        \endcode
        This will ensure that the code works when \imp is installed or
        used via the \c setup_environment.sh script.
    */
    IMPBASEEXPORT std::string get_data_path(std::string file_name);

    //! Return the path to installed example data for this module
    /** Each module has its own example directory, so be sure to use
        the version of this function in the correct module.  For example
        to read the file \c example_protein.pdb located in the
        \c examples directory of the IMP::atom module, do
        \code
        IMP::atom::read_pdb(IMP::atom::get_example_path("example_protein.pdb",
       model));
        \endcode
        This will ensure that the code works when \imp is installed or
        used via the \c setup_environment.sh script.
    */
    IMPBASEEXPORT std::string get_example_path(std::string file_name);
    /** @} */

  }
}  // namespace

#endif  // SWIG

#include <IMP/base/compiler_macros.h>

#ifdef IMP_DOXYGEN
/** \namespace IMP::base
    \brief See [IMP.base](\ref impbase) for more information.
    */
#endif

#endif /* IMPBASE_CONFIG_H */

// Here so it is always parsed

#ifdef IMPBASE_DEPRECATED_HEADER
#undef IMPBASE_DEPRECATED_HEADER
#undef IMPBASE_DEPRECATED_VALUE_DEF
#undef IMPBASE_DEPRECATED_VALUE_DECL
#undef IMPBASE_DEPRECATED_OBJECT_DEF
#undef IMPBASE_DEPRECATED_OBJECT_DECL
#undef IMPBASE_DEPRECATED_FUNCTION_DEF
#undef IMPBASE_DEPRECATED_FUNCTION_DECL
#undef IMPBASE_DEPRECATED_METHOD_DEF
#undef IMPBASE_DEPRECATED_METHOD_DECL
#undef IMPBASE_DEPRECATED_MACRO
#undef IMPBASE_SHOW_WARNINGS
#endif

// the central modules we can update easily, so don't warn in them
#if defined( IMPBASE_COMPILATION)                                 \
  || defined(SWIG) || defined(IMP_SWIG_WRAPPER)                         \
  || defined( IMPBASE_ALL) || defined(IMP_DOXYGEN)                \
  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION)     \
  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION)       \
  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
  || defined(IMPSCOREFUNCTOR_COMPILATION) || defined(IMPRMF_COMPILATION) \
  || defined(IMPGSL_COMPILATION)
#define IMPBASE_SHOW_WARNINGS 0
#else
#define IMPBASE_SHOW_WARNINGS 1
#endif

// suppress header warnings with all header, SWIG wrapper and in the module
#if IMPBASE_SHOW_WARNINGS
#define IMPBASE_DEPRECATED_HEADER(version, help_message)          \
    IMP_PRAGMA(message(__FILE__ " is deprecated: " help_message))
#define IMPBASE_DEPRECATED_VALUE_DECL(version)    \
  IMP_DEPRECATED_ATTRIBUTE
#define IMPBASE_DEPRECATED_OBJECT_DECL(version)    \
  IMP_DEPRECATED_ATTRIBUTE
#define IMPBASE_DEPRECATED_FUNCTION_DECL(version) \
  IMP_DEPRECATED_ATTRIBUTE
#define IMPBASE_DEPRECATED_METHOD_DECL(version) \
  IMP_DEPRECATED_ATTRIBUTE

#else //IMPBASE_SHOW_WARNINGS
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_HEADER(version, help_message) \
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_VALUE_DECL(version)
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_OBJECT_DECL(version)
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_FUNCTION_DECL(version)
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_METHOD_DECL(version)

#endif // IMPBASE_SHOW_WARNINGS

// only warn about it in the all inclusion to cut down on copies
#if !defined(IMP_ALL) || defined(SWIG) || defined(IMP_DOXYGEN)          \
  || defined(IMPBASE_COMPILATION) || defined(IMPKERNEL_COMPILATION)     \
  || defined(IMPCORE_COMPILATION) || defined(IMPATOM_COMPILATION)       \
  || defined(IMPSTATISTICS_COMPILATION) || defined(IMPDOMINO_COMPILATION) \
  || defined(IMPCONTAINER_COMPILATION) || defined(IMPDISPLAY_COMPILATION) \
  || defined(IMPSCOREFUNCTOR_COMPILATION)
/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_MACRO(version, message)

#else
#define IMPBASE_DEPRECATED_MACRO(version, message)        \
  IMP_DEPRECATED_MACRO(version, message)
#endif

/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_VALUE_DEF(version, message) \
  IMP_DEPRECATED_VALUE_RUNTIME_WARNING(version, message)

/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_OBJECT_DEF(version, message) \
  IMP_DEPRECATED_OBJECT_RUNTIME_WARNING(version, message)

/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_FUNCTION_DEF(version, message) \
  IMP_DEPRECATED_FUNCTION_RUNTIME_WARNING(version, message)

/** See [deprecation support](https://github.com/salilab/imp/wiki/Deprecation). */
#define IMPBASE_DEPRECATED_METHOD_DEF(version, message) \
  IMP_DEPRECATED_METHOD_RUNTIME_WARNING(version, message)


#include <IMP/base/compiler_macros.h>

#if defined(IMP_EXECUTABLE) && !defined(IMP_EXECUTABLE_WARNINGS)
IMP_COMPILER_ENABLE_WARNINGS
#define IMP_EXECUTABLE_WARNINGS
#endif