*/
-class UpdateChecker
+/** @file src/lib/update.h
+ * @brief UpdateChecker class.
+ */
+
+#include <curl/curl.h>
+#include <boost/signals2.hpp>
+#include <boost/thread/mutex.hpp>
+#include <boost/thread/condition.hpp>
+#include <boost/thread.hpp>
+
+struct update_checker_test;
+
+/** Class to check for the existance of an update for DCP-o-matic on a remote server */
+class UpdateChecker : public boost::noncopyable
{
public:
UpdateChecker ();
~UpdateChecker ();
- enum Result {
- YES,
- MAYBE,
- NO
+ void run ();
+
+ enum State {
+ YES, ///< there is an update
+ FAILED, ///< the check failed, so we don't know
+ NO, ///< there is no update
+ NOT_RUN ///< the check has not been run (yet)
};
- Result run ();
+ /** @return state of the checker */
+ State state () {
+ boost::mutex::scoped_lock lm (_data_mutex);
+ return _state;
+ }
+
+ /** @return new stable version, if there is one */
+ boost::optional<std::string> stable () {
+ boost::mutex::scoped_lock lm (_data_mutex);
+ return _stable;
+ }
+
+ /** @return new test version, if there is one and Config is set to look for it */
+ boost::optional<std::string> test () {
+ boost::mutex::scoped_lock lm (_data_mutex);
+ return _test;
+ }
+
+ /** @return true if the last signal emission was the first */
+ bool last_emit_was_first () const {
+ boost::mutex::scoped_lock lm (_data_mutex);
+ return _emits == 1;
+ }
size_t write_callback (void *, size_t, size_t);
-private:
+ boost::signals2::signal<void (void)> StateChanged;
+
+ static UpdateChecker* instance ();
+
+private:
+ friend struct update_checker_test;
+
+ static UpdateChecker* _instance;
+
+ static bool version_less_than (std::string const & a, std::string const & b);
+
+ void set_state (State);
+ void thread ();
+
char* _buffer;
int _offset;
+ CURL* _curl;
+
+ /** mutex to protect _state, _stable, _test and _emits */
+ mutable boost::mutex _data_mutex;
+ State _state;
+ boost::optional<std::string> _stable;
+ boost::optional<std::string> _test;
+ int _emits;
+
+ boost::thread* _thread;
+ boost::mutex _process_mutex;
+ boost::condition _condition;
+ int _to_do;
};