# A demo of using the RAS API from Python
import sys
import win32ras

# The error raised if we can not
class ConnectionError(Exception):
	pass
	
def Connect(rasEntryName, numRetries = 5):
	"""Make a connection to the specified RAS entry.
	
	Returns a tuple of (bool, handle) on success.
	- bool is 1 if a new connection was established, or 0 is a connection already existed.
	- handle is a RAS HANDLE that can be passed to Disconnect() to end the connection.
	
	Raises a ConnectionError if the connection could not be established.
	"""
	assert numRetries > 0
	for info in win32ras.EnumConnections():
		if info[1].lower()==rasEntryName.lower():
			print "Already connected to", rasEntryName
			return 0, info[0]

	dial_params, have_pw = win32ras.GetEntryDialParams(None, rasEntryName)
	if not have_pw:
		print "Error: The password is not saved for this connection"
		print "Please connect manually selecting the 'save password' option and try again"
		sys.exit(1)

	print "Connecting to", rasEntryName, "..."
	retryCount = numRetries
	while retryCount > 0:
		rasHandle, errCode = win32ras.Dial(None, None, dial_params, None)
		if win32ras.IsHandleValid(rasHandle):
			bValid = 1
			break
		print "Retrying..."
		win32api.Sleep(5000)
		retryCount = retryCount - 1
	
	if errCode:
		raise ConnectionError(errCode, win32ras.GetErrorString(errCode))
	return 1, rasHandle

def Disconnect(handle):
	if type(handle)==type(''): # have they passed a connection name?
		for info in win32ras.EnumConnections():
			if info[1].lower()==handle.lower():
				handle = info[0]
				break
		else:
			raise ConnectionError(0, "Not connected to entry '%s'" % handle)

	win32ras.HangUp(handle)

usage="""rasutil.py - Utilities for using RAS

Usage:
  rasutil [-r retryCount] [-c rasname] [-d rasname]
  
  -r retryCount - Number of times to retry the RAS connection
  -c rasname - Connect to the phonebook entry specified by rasname
  -d rasname - Disconnect from the phonebook entry specified by rasname
"""

def Usage(why):
	print why
	print usage
	sys.exit(1)
	
if __name__=='__main__':
	import getopt
	try:
		opts, args = getopt.getopt(sys.argv[1:], "r:c:d:")
	except getopt.error, why:
		Usage(why)
	retries = 5
	if len(args) != 0:
		Usage("Invalid argument")

	for opt, val in opts:
		if opt=='-c':
			Connect(val, retries)
		if opt=='-d':
			Disconnect(val)
		if opt=='-r':
			retries = int(val)
