from abc import abstractmethod
from typing import List, Optional


from geniusweb.actions.Action import Action
from geniusweb.inform.Agreements import Agreements
from geniusweb.progress.Progress import Progress
from geniusweb.protocol.NegoState import NegoState
from geniusweb.protocol.session.SessionResult import SessionResult
from geniusweb.protocol.session.SessionSettings import SessionSettings


class SessionState(NegoState):
	'''
	The current state of the session. E.g. typically contains the actions so far
	and the parties currently connected. <br>
	The state checks if transitions (Actions from the party) are following the
	protocol, and thus implement most of the protocol . <br>
	
	If protocol errors occur, these should be stored in the state and the state
	should become {@link #isFinal(long)}. Throwing should happen only in case of
	a bug.<br>
	
	Implementations should be immutable (to ensure thread safety, testability
	etc).
	
	States must be serializable so that listeners can follow what is going on in
	the protocol. As uaual, mark non-serializable fields as transient.
	'''
	@abstractmethod
	def getSettings(self)->SessionSettings:
		'''
		@return the SessionSettings
		'''
	
	@abstractmethod
	def getActions(self)->List[Action]: 
		'''
		@return unmodifyable list of actions done so far, in the order in which
		they arrived. List of list allows implementations to add some
		extra structure to the actions, eg one list per phase
		'''
	
	@abstractmethod
	def getProgress(self) -> Optional[Progress]:
		'''
		@return the progress of the session. Can return null if the session did
		        not even start yet. Notice that the protocol determines when a
		        session officially starts (eg, in SAOP it starts after all
		        parties were connected succesfully).
		'''
	
	@abstractmethod
	def getAgreements(self)->Agreements :
		'''
		@return the current standing agreements
		    An agreement does not necessarily mean {@link #isFinal(long)}.
		'''
	
	@abstractmethod
	def getResult(self)->Optional[SessionResult]:
		'''
		@return the {@link SessionResult} which is a short report of the final
		        outcome. Assumes {@link #isFinal(long)}. result may be undefined
		        if not.
		'''