summaryrefslogtreecommitdiffstats
path: root/xbmc/interfaces/legacy/wsgi/WsgiErrorStream.h
blob: e9e769439ea8ba2eee8c6f549e9ee6f3017bce84 (plain)
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
/*
 *  Copyright (C) 2015-2018 Team Kodi
 *  This file is part of Kodi - https://kodi.tv
 *
 *  SPDX-License-Identifier: GPL-2.0-or-later
 *  See LICENSES/README.md for more information.
 */

#pragma once

#include "interfaces/legacy/AddonClass.h"

#include <vector>

struct HTTPPythonRequest;

namespace XBMCAddon
{
  namespace xbmcwsgi
  {

    /// \defgroup python_xbmcwsgi_WsgiErrorStream WsgiErrorStream
    /// \ingroup python_xbmcwsgi
    /// @{
    /// @brief **Represents the wsgi.errors stream to write error messages.**
    ///
    /// \python_class{ WsgiErrorStream() }
    ///
    /// This implementation writes the error messages to the application's log
    /// file.
    ///
    ///-------------------------------------------------------------------------
    ///
    class WsgiErrorStream : public AddonClass
    {
    public:
      WsgiErrorStream();
      ~WsgiErrorStream() override;

#ifdef DOXYGEN_SHOULD_USE_THIS
      ///
      /// \ingroup python_xbmcwsgi_WsgiErrorStream
      /// \python_func{ flush() }
      /// Since nothing is buffered this is a no-op.
      ///
      ///
      flush();
#else
      inline void flush() { }
#endif

#ifdef DOXYGEN_SHOULD_USE_THIS
      ///
      /// \ingroup python_xbmcwsgi_WsgiErrorStream
      /// \python_func{ write(str) }
      /// Writes the given error message to the application's log file.
      ///
      /// @param str      A string to save in log file
      ///
      /// @note A trailing `\n` is removed.
      ///
      write(...);
#else
      void write(const String& str);
#endif

#ifdef DOXYGEN_SHOULD_USE_THIS
      ///
      /// \ingroup python_xbmcwsgi_WsgiErrorStream
      /// \python_func{ writelines(seq) }
      /// Joins the given list of error messages (without any separator) into
      /// a single error message which is written to the application's log file.
      ///
      /// @param seq      A list of strings which will be logged.
      ///
      writelines(...);
#else
      void writelines(const std::vector<String>& seq);
#endif

#ifndef SWIG
      /**
       * Sets the given request.
       */
      void SetRequest(HTTPPythonRequest* request);

      HTTPPythonRequest* m_request;
#endif
    };
    /// @}
  }
}