sgpemv2/plugins/pyloader/src/sgpem.i

%module sgpem
%{
#include "policy.hh"
#include "policy_parameters.hh"
#include "static_schedulable.hh"
#include "schedulable_queue.hh"
#include "dynamic_schedulable.hh"
#include "scheduler.hh"
%}

/* NOTE : passing Unicode strings to C++ methods calling them 
 * from Python results in a SIGSEGV. You've been warned!
 * (Investigate if this can be fixed, else please report it in 
 * the sgpem user manual)
 */

/** Due to the relatively new support for namespaces in SWIG,
 * make sure to include the full visibility signature when
 * returning / passing parameters from / to functions with
 * objects different to the one you're declaring.
 */

namespace std {
    class exception {
    public:
	virtual const char* what() const throw();
    private:
	exception();
    };

    class runtime_error : public std::exception {
    public:
	virtual const char* what() const throw();
    private:
	runtime_error();
    };
}

namespace sgpem {

    /** Don't get worried, order is not important! */
    enum policy_sorts_type { policy_sorts_threads, policy_sorts_processes };

    class Policy {
    public:
	virtual ~Policy() = 0;
	sgpem::PolicyParameters& get_parameters();
    };

    // --------------------------------------------
    class PolicyParametersException : public std::runtime_error {
    public:
	PolicyParametersException(char* msg);
	%rename (__str__) what;
	virtual const char* what();
    }; //~ class PolicyParametersException
  
    // --------------------------------------------
    class PolicyParameters 
    {
    public:
	//methods to CREATE PARAMETERS
	// (rewrapped correctly for SWIG usage)
	%ignore register_int(const Glib::ustring&, const int&,
			     const int&, const bool&, const int&);
	%ignore register_float(const Glib::ustring&, const float&,
			       const float&, const bool&, const float&);
	%ignore register_string(const Glib::ustring&, const bool&, 
				const char*);
	
	%extend {
	    void register_int(const char* name,
			      const int& lower_bound, 
			      const int& upper_bound, 
			      const bool& required, 
			      const int& default_value = 0) 
		{ 
		    self->register_int(name, lower_bound, upper_bound,
				       required, default_value); 
		}

	    void register_float(const char* name,
				const float& lower_bound, 
				const float& upper_bound, 
				const bool& required, 
				const float& default_value = 0.0f)
		{ 
		    self->register_float(name, lower_bound, upper_bound,
					 required, default_value); 
		}
	    
	    void register_string(const char* name, 
				 const bool& required, 
				 const char* default_value = "")
		{ 
		    self->register_string(name, required, default_value);
		}
	}
    
	//methods to SET the VALUE of PARAMETERS
	// (rewrapped correctly for SWIG usage)
	%ignore set_int(const Glib::ustring&, const int&);
	%ignore set_float(const Glib::ustring&, const float&);
	%ignore set_string(const Glib::ustring&, const Glib::ustring&);

	%extend {
	    bool set_int(const char* name, const int& value)
		{ return self->set_int(name, value); }
	    bool set_float(const char* name, const float& value)
		{ return self->set_float(name, value); }
	    bool set_string(const char* name, const char* value)
		{ return self->set_string(name, value); }
	}
	
	//methods to GET the VALUE of PARAMETERS
	// (rewrapped correctly for SWIG usage)
	%ignore get_int(const Glib::ustring&) const;
	%ignore get_float(const Glib::ustring&) const;
	%ignore get_string(const Glib::ustring&) const;

	%extend {
	    int get_int(const char* name) const 
		{ return self->get_int(name); }
	    float get_float(const char* name) const 
		{ return self->get_float(name); }
	    const char* get_string(const char* name) const
		{ return self->get_string(name).c_str(); }
	}

    }; //~ class PolicyParameters
  	
    // --------------------------------------------
    class Schedulable
    {
    public:
			virtual ~Schedulable() = 0;
			
			enum state
				{
					state_running    = 1<<0,
					state_ready      = 1<<1,
					state_blocked    = 1<<2,
					state_future     = 1<<3,
					state_terminated = 1<<4
				};
	
			virtual unsigned int  get_arrival_time() const = 0;
			virtual unsigned int  get_remaining_time() const = 0;
			virtual int           get_base_priority() const = 0;
			virtual int           get_current_priority() const = 0;
			virtual unsigned int  get_total_cpu_time() const = 0;
			virtual state         get_state() const = 0;

			%ignore Schedulable::get_name() const;
			%extend {
				const char* get_name() const 
	      { return self->get_name().c_str(); }
			}
    }; //~ class Schedulable


    // --------------------------------------------
    class SchedulableQueue 
    {
    public:
	unsigned int size() const;
	const sgpem::Schedulable* get_item_at(const unsigned int&) const;
	void swap(unsigned int positionA, unsigned int positionB) throw();
	
    private:
	// Avoid instantiation and copy
	SchedulableQueue();
	SchedulableQueue(const SchedulableQueue&);
	SchedulableQueue& operator=(const SchedulableQueue&);
	~SchedulableQueue();
    }; //~ class Schedulable

	// ---------------------------------------------
	class Scheduler {
	public:
		sgpem::Policy&             get_policy();
		static sgpem::Scheduler&   get_instance();
		sgpem::SchedulableQueue*   get_ready_queue();
	private:
		Scheduler();
		~Scheduler();
	};

} //~ namespace sgpem