require 'common/plugin'
+require 'common/user'
+# Code that all Agendav plugins ({AgendavPrune}, {AgendavRm},
+# {AgendavMv}) share.
module AgendavPlugin
- # Code that all Agendav plugins (Prune, Rm, Mv...) will
- # share. That is, we implement the Plugin interface.
+
+ # We implement the Plugin "interface."
include Plugin
+ # Initialize this Agendav {Plugin} with values in *cfg*.
+ #
+ # @param cfg [Configuration] the configuration for this plugin.
+ #
def initialize(cfg)
- @db_host = cfg.agendav_dbhost
- @db_port = cfg.agendav_dbport
- @db_opts = cfg.agendav_dbopts
- @db_tty = cfg.agendav_dbtty
- @db_name = cfg.agendav_dbname
- @db_user = cfg.agendav_dbuser
- @db_pass = cfg.agendav_dbpass
- end
-
-
- def describe_domain(domain)
- # AgenDAV doesn't have a concept of domains.
- return domain
+ @db_hash = {
+ :host => cfg.agendav_dbhost,
+ :port => cfg.agendav_dbport,
+ :options => cfg.agendav_dbopts,
+ :tty => cfg.agendav_dbtty,
+ :dbname => cfg.agendav_dbname,
+ :user => cfg.agendav_dbuser,
+ :password => cfg.agendav_dbpass }
end
- def describe_user(user)
- if self.user_exists(user)
- return "Username: #{user}"
- else
- return 'User not found'
- end
- end
-
-
- protected;
-
-
+ # Return a list of Agendav users.
+ #
+ # @return [Array<User>] a list of users contained in the
+ # Agendav database.
+ #
def list_users()
- usernames = []
+ users = []
- # Just assume PostgreSQL for now.
- begin
- connection = PGconn.connect(@db_host,
- @db_port,
- @db_opts,
- @db_tty,
- @db_name,
- @db_user,
- @db_pass)
+ connection = PG::Connection.new(@db_hash)
- sql_query = '(SELECT username FROM prefs)'
- sql_query += 'UNION'
- sql_query += '(SELECT user_from FROM shared);'
+ # There are also "owner" and "with" fields in the "shares" table,
+ # but they contains principal URLs and not a bare username. Thus
+ # their format depends on the CalDAV server configuration, and
+ # isn't predictable.
+ sql_query = 'SELECT username FROM prefs;'
+ begin
connection.query(sql_query) do |result|
- usernames = result.field_values('username')
+ users = 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 usernames
+ return users.map{ |u| User.new(u) }
end
end