require 'common/plugin'
+require 'common/user'
+# Code that all Roundcube plugins ({RoundcubePrune}, {RoundcubeRm},
+# {RoundcubeMv}) share.
+#
module RoundcubePlugin
- # Code that all Roundcube plugins (Prune, Rm, Mv...) will share.
- # That is, we implement the Plugin interface.
- include Plugin
- def initialize()
- cfg = Configuration.new()
- @db_host = cfg.roundcube_dbhost
- @db_port = cfg.roundcube_dbport
- @db_opts = cfg.roundcube_dbopts
- @db_tty = cfg.roundcube_dbtty
- @db_name = cfg.roundcube_dbname
- @db_user = cfg.roundcube_dbuser
- @db_pass = cfg.roundcube_dbpass
- end
+ # We implement the Plugin "interface."
+ include Plugin
- def describe_domain(domain)
- # Roundcube doesn't have a concept of domains.
- return domain
+ # Initialize this Roundcube {Plugin} with values in *cfg*.
+ #
+ # @param cfg [Configuration] the configuration for this plugin.
+ #
+ def initialize(cfg)
+ @db_hash = {
+ :host => cfg.roundcube_dbhost,
+ :port => cfg.roundcube_dbport,
+ :options => cfg.roundcube_dbopts,
+ :tty => cfg.roundcube_dbtty,
+ :dbname => cfg.roundcube_dbname,
+ :user => cfg.roundcube_dbuser,
+ :password => cfg.roundcube_dbpass }
end
- def describe_account(account)
- user_id = self.get_user_id(account)
- if user_id.nil?
- return 'User not found'
- else
- return "User ID: #{user_id}"
- end
+ # Describe the given Roundcube *user*.
+ #
+ # @param user [User] the user whose description we want.
+ #
+ # @return [String] a string containing the Roundcube "User ID"
+ # associated with *user*.
+ #
+ def describe_user(user)
+ user_id = self.get_user_id(user)
+ return "User ID: #{user_id}"
end
- protected;
+ # Return a list of Roundcube users.
+ #
+ # @return [Array<User>] a list of users contained in the
+ # Roundcube database.
+ #
+ def list_users()
+ usernames = []
- def get_user_id(account)
- user_id = nil
+ connection = PG::Connection.connect(@db_hash)
- begin
- connection = PGconn.connect(@db_host,
- @db_port,
- @db_opts,
- @db_tty,
- @db_name,
- @db_user,
- @db_pass)
+ sql_query = 'SELECT username FROM users;'
- sql_query = "SELECT user_id FROM users WHERE username = $1;"
-
- connection.query(sql_query, [account]) do |result|
- if result.num_tuples > 0
- user_id = result[0]['user_id']
- end
+ begin
+ connection.query(sql_query) do |result|
+ usernames = result.field_values('username')
end
-
+ ensure
+ # Make sure the connection gets closed even if the query explodes.
connection.close()
-
- rescue PGError => e
- # Pretend like we're database-agnostic in case we ever are.
- raise DatabaseError.new(e)
end
- return user_id
+ return usernames.map{ |u| User.new(u) }
end
+ protected;
- # Used in both prune/rm.
- def list_users()
- usernames = []
- # Just assume PostgreSQL for now.
+ # Find the Roundcube "User ID" associated with the given *user*.
+ #
+ # @param user [User] the user whose Roundcube "User ID" we want.
+ #
+ # @return [Fixnum] the Roundcube "User ID" for *user*.
+ #
+ def get_user_id(user)
+ user_id = nil
+
+ connection = PG::Connection.new(@db_hash)
+ sql_query = 'SELECT user_id FROM users WHERE username = $1;'
+
begin
- connection = PGconn.connect(@db_host,
- @db_port,
- @db_opts,
- @db_tty,
- @db_name,
- @db_user,
- @db_pass)
-
- sql_query = "SELECT username FROM users;"
- connection.query(sql_query) do |result|
- usernames = result.field_values('username')
+ connection.query(sql_query, [user.to_s()]) do |result|
+ if result.num_tuples > 0
+ user_id = result[0]['user_id']
+ end
end
-
+ ensure
+ # Make sure the connection gets closed even if the query explodes.
connection.close()
- rescue PGError => e
- # Pretend like we're database-agnostic in case we ever are.
- raise DatabaseError.new(e)
end
- return usernames
+ return user_id
end
+
end