# File lib/mues/user.rb, line 121
        def self::getAttributeQuestionnaire(user, attribute)
            question = CreateUserQuestions.find {|question|
                question[:name] == attribute
            }
            raise RuntimeError,
                "Can't build a questionnaire for '%s': No question with that name." %
                attribute if question.nil?

            question[:question] =
                ("Currently: %s\n" % user.send(attribute.intern)) + question[:question]
            qnaire = Questionnaire::new( "Change #{attribute}", question ) {|qnaire|
                MUES::ServerFunctions::unregisterUser( user )
                user.send("#{attribute}=", qnaire.answers[attribute.intern])
                MUES::ServerFunctions::registerUser( user )
                qnaire.message "Changed '%s' for %s to '%s'\n\n" %
                    [ attribute, user.login.capitalize, user.send(attribute.intern) ]
            }

            qnaire.debugLevel = 5
            return qnaire
        end

# File lib/mues/user.rb, line 78
        def self::getCreationQuestionnaire
            qnaire = Questionnaire::new( "Create User", *CreateUserQuestions ) {|qnaire|
                user = MUES::User::new( qnaire.answers )
                MUES::ServerFunctions::registerUser( user )

                qnaire.message( "\nUser '%s' created.\n" % user.login.capitalize )
            }
            qnaire.debugLevel = 5
            return qnaire
        end

# File lib/mues/user.rb, line 92
        def self::getPasswordQuestionnaire( user, isOther )
            questions = nil

            # If we're changing another user's password, don't prompt for the
            # old password
            if isOther
                questions = ChangePasswordQuestions[1..-1]
            else
                questions = ChangePasswordQuestions
            end

            name = "Changing %s's password" % user.login.capitalize
            qnaire = Questionnaire::new( name, *questions ) {|qnaire|
                user.password = qnaire.answers[:newPassword]
                qnaire.message( "Password changed.\n\n" )
            }

            # Add the user to the support data so the questionnaire's validators
            # can get at it
            qnaire.debugLevel = 5
            qnaire.supportData[:user] = user

            return qnaire
        end

# File lib/mues/user.rb, line 163
        def initialize( attributes={} )
            checkResponse( attributes, '[]', '[]=', 'has_key?' )
            super()

            @remoteHost          = nil
            @stream              = nil
            @activated           = false

            @username            = attributes[:username]      || 'guest'
            @realname            = attributes[:realname]      || 'Guest User'
            @emailAddress        = attributes[:emailAddress] || 'guestAccount@localhost'
            @lastLoginDate       = attributes[:lastLoginDate]
            @lastHost            = attributes[:lastHost]

            @timeCreated     = Time.now
            @firstLoginTick      = 0

            @flags               = 0
            @preferences     = {}

            @cryptedPass     = '*'
            self.password        = attributes[:password] if attributes.has_key?( :password )
        end

# File lib/mues/user.rb, line 259
        def <=>( otherUser )
            @username <=> otherUser.username
        end

# File lib/mues/user.rb, line 280
        def activate( stream )
            # Set the stream
            @stream = stream
            @stream.unpause
            @activated = true

            self.log.debug "Activating %p" % self

            registerHandlerForEvents( self, MUES::OutputEvent ) #MUES::TickEvent )
            return []
        end

# File lib/mues/user.rb, line 234
        def activated? 
            @activated
        end

# File lib/mues/user.rb, line 294
        def deactivate
            results = []

            # Unregister all our handlers
            unregisterHandlerForEvents( self )

            # Shut down the IO event stream
            @activated = false
            results.replace @stream.shutdown if @stream
            results.flatten!
            
            # Return any events that need dispatching
            debugMsg 1, "Returning %d result events from deactivation." %
                results.length
            return results
        end

# File lib/mues/user.rb, line 341
        def lull!( objStore )
            @remoteHost          = nil
            @stream              = nil
            @activated           = false

            # :FIXME: This should probably be 'super' instead. Needs
            # investigation, though.
            return true
        end

# File lib/mues/user.rb, line 266
        def password=( newPassword )
            newPassword = newPassword.to_s
            @cryptedPass = Digest::MD5::hexdigest( newPassword )
        end

# File lib/mues/user.rb, line 273
        def passwordMatches?( pass )
            return Digest::MD5::hexdigest( pass ) == @cryptedPass
        end

# File lib/mues/user.rb, line 313
        def reconnect( stream )
            checkType( stream, MUES::IOEventStream )

            results = []

            stream.pause
            newFilter = stream.removeFiltersOfType( MUES::OutputFilter )[0]
            raise RuntimeError, "Cannot reconnect from a stream with no OutputFilter" unless newFilter
            newFilter.puts( "Reconnecting..." )
            stream.unpause

            # Get the current stream's socket output filter/s and flush 'em
            # before closing it and replacing it with the new one.
            @stream.pause
            results.replace @stream.stopFiltersOfType( MUES::OutputFilter ) {|filter|
                filter.puts( "[Reconnect from #{newFilter.remoteHost}]" )
                newFilter.sortPosition = filter.sortPosition
            }
            
            @stream.addFilters( newFilter )
            @stream.addEvents( MUES::InputEvent.new("") )
            @stream.unpause

            return results
        end

# File lib/mues/user.rb, line 241
        def remoteHost=( newIp )
            checkType( newIp, ::String )

            @remoteHost = @lastHost = newIp
        end

# File lib/mues/user.rb, line 249
        def to_s 
            "%s - %s <%s>" % [
                @realname,
                @username.capitalize,
                @emailAddress
            ]
        end

# File lib/mues/user.rb, line 359
        def handleIOEvent( event )
            @stream.addEvents( event )
        end