summaryrefslogtreecommitdiff
path: root/src/lib/job.h
diff options
context:
space:
mode:
authorCarl Hetherington <cth@carlh.net>2012-07-15 00:14:28 +0100
committerCarl Hetherington <cth@carlh.net>2012-07-15 00:14:28 +0100
commitbb767c7e338414beee132af3e96829c1448e214b (patch)
treebec2858dcc7225a9bcc2acd8170c25508f6df6cb /src/lib/job.h
parent66c9be6bdb1361e5681e094a0c8170d268aa9518 (diff)
Move things round a bit.
Diffstat (limited to 'src/lib/job.h')
-rw-r--r--src/lib/job.h115
1 files changed, 115 insertions, 0 deletions
diff --git a/src/lib/job.h b/src/lib/job.h
new file mode 100644
index 000000000..2a77f78f7
--- /dev/null
+++ b/src/lib/job.h
@@ -0,0 +1,115 @@
+/*
+ Copyright (C) 2012 Carl Hetherington <cth@carlh.net>
+
+ This program is free software; you can redistribute it and/or modify
+ it under the terms of the GNU General Public License as published by
+ the Free Software Foundation; either version 2 of the License, or
+ (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ GNU General Public License for more details.
+
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+
+*/
+
+/** @file src/job.h
+ * @brief A parent class to represent long-running tasks which are run in their own thread.
+ */
+
+#ifndef DVDOMATIC_JOB_H
+#define DVDOMATIC_JOB_H
+
+#include <string>
+#include <boost/thread/mutex.hpp>
+#include <sigc++/sigc++.h>
+
+class Log;
+class FilmState;
+class Options;
+
+/** @class Job
+ * @brief A parent class to represent long-running tasks which are run in their own thread.
+ */
+class Job
+{
+public:
+ Job (boost::shared_ptr<const FilmState> s, boost::shared_ptr<const Options> o, Log* l);
+
+ /** @return user-readable name of this job */
+ virtual std::string name () const = 0;
+ /** Run this job in the current thread. */
+ virtual void run () = 0;
+
+ void start ();
+
+ bool running () const;
+ bool finished () const;
+ bool finished_ok () const;
+ bool finished_in_error () const;
+
+ std::string error () const;
+
+ int elapsed_time () const;
+ virtual std::string status () const;
+
+ void set_progress_unknown ();
+ void set_progress (float);
+ void ascend ();
+ void descend (float);
+ float overall_progress () const;
+
+ void emit_finished ();
+
+ /** Emitted from the GUI thread */
+ sigc::signal0<void> Finished;
+
+protected:
+
+ enum State {
+ NEW, ///< the job hasn't been started yet
+ RUNNING, ///< the job is running
+ FINISHED_OK, ///< the job has finished successfully
+ FINISHED_ERROR ///< the job has finished in error
+ };
+
+ void set_state (State);
+ void set_error (std::string e);
+
+ boost::shared_ptr<const FilmState> _fs;
+ boost::shared_ptr<const Options> _opt;
+
+ /** A log that this job can write to */
+ Log* _log;
+
+private:
+
+ void run_wrapper ();
+
+ /** mutex for _state and _error */
+ mutable boost::mutex _state_mutex;
+ State _state;
+ std::string _error;
+
+ time_t _start_time;
+
+ mutable boost::mutex _progress_mutex;
+
+ struct Level {
+ Level (float a) : allocation (a), normalised (0) {}
+
+ float allocation;
+ float normalised;
+ };
+
+ std::list<Level> _stack;
+
+ /** true if this job's progress will always be unknown */
+ bool _progress_unknown;
+};
+
+#endif