SF.net SVN: fclient: [125] trunk/sandbox/fcp/fcp2_0_types.py
Status: Pre-Alpha
Brought to you by:
jurner
From: <ju...@us...> - 2008-02-03 13:13:51
|
Revision: 125 http://fclient.svn.sourceforge.net/fclient/?rev=125&view=rev Author: jurner Date: 2008-02-03 05:13:56 -0800 (Sun, 03 Feb 2008) Log Message: ----------- beautifications Modified Paths: -------------- trunk/sandbox/fcp/fcp2_0_types.py Modified: trunk/sandbox/fcp/fcp2_0_types.py =================================================================== --- trunk/sandbox/fcp/fcp2_0_types.py 2008-02-03 13:13:25 UTC (rev 124) +++ trunk/sandbox/fcp/fcp2_0_types.py 2008-02-03 13:13:56 UTC (rev 125) @@ -186,10 +186,10 @@ # #*************************************************************************************** class ConfigMessageParams(object): - - ComponentsSep = '.' + """Parameter --> FcpType mapping for config related messages""" - + ComponentSep = '.' + # first component of a config message param is always the param class ParamClassCurrent = 'current' @@ -208,9 +208,7 @@ ParamClassShortDescription, ParamClassLongDescription, ) - - - + # all known config keys (param class stripped) Params = { @@ -220,8 +218,7 @@ 'console.enabled': FcpTypeBool, 'console.port': FcpTypeIPort, 'console.ssl': FcpTypeBool, - - + 'fcp.allowedHosts': FcpTypeIPList, 'fcp.allowedHostsFullAccess': FcpTypeIPList, 'fcp.assumeDownloadDDAIsAllowed': FcpTypeBool, @@ -233,8 +230,7 @@ 'fcp.persistentDownloadsInterval': FcpTypeIntWithBounds(0, None), 'fcp.port': FcpTypeIPort, 'fcp.ssl': FcpTypeBool, - - + 'fproxy.CSSOverride': FcpTypeBool, 'fproxy.advancedModeEnabled': FcpTypeBool, 'fproxy.allowedHosts': FcpTypeIPList, @@ -247,18 +243,16 @@ 'fproxy.port': FcpTypeIPort, 'fproxy.showPanicButton': FcpTypeBool, 'fproxy.ssl': FcpTypeBool, - - + 'logger.dirname': FcpTypeDirname, 'logger.enabled': FcpTypeBool, 'logger.interval': FcpType, # ??? 1HOUR ?? 'logger.maxCachedBytes': FcpTypeNumBytes, - 'logger.maxCachedLines': FcpTypeNumBytes, # ??? + 'logger.maxCachedLines': FcpTypeNumBytes, # ??? 'logger.maxZippedLogsSize': FcpTypeNumBytes, # ??? 'logger.priority': FcpTypeChoiceLoggerPriority, 'logger.priorityDetail': FcpType, # ???? is it Detailed priority thresholds ??? - - + 'node.alwaysAllowLocalAddresses': FcpTypeBool, 'node.assumeNATed': FcpTypeBool, 'node.bindTo': FcpTypeIP, @@ -290,11 +284,9 @@ 'node.tempIPAddressHint': FcpTypeIP, # ??? 'node.testingDropPacketsEvery': FcpTypeIntWithBounds(0, None), 'node.uploadAllowedDirs': FcpTypeChoiceNodeDownloadAllowedDirs, - - - 'node.testnet.enabled': FcpTypeBool, - + 'node.testnet.enabled': FcpTypeBool, + 'node.load.aggressiveGC': FcpType, # ??? 'node.load.freeHeapBytesThreshold': FcpTypeNumBytes, 'node.load.freeHeapPercentThreshold': FcpTypePercent, @@ -302,7 +294,6 @@ 'node.load.nodeThrottleFile': FcpTypeFilename, 'node.load.threadLimit': FcpTypeIntWithBounds(0, None), - 'node.opennet.acceptSeedConnections': FcpTypeBool, 'node.opennet.alwaysAllowLocalAddresses': FcpTypeBool, 'node.opennet.assumeNATed': FcpTypeBool, @@ -324,11 +315,9 @@ 'node.updater.extURI': FcpTypeUri, 'node.updater.revocationURI': FcpTypeUri, - 'pluginmanager.loadplugin': FcpTypeStringList, 'pluginmanager2.loadedPlugins': FcpTypeStringList, - - + 'ssl.sslEnable': FcpTypeBool, 'ssl.sslKeyPass': FcpTypeString, 'ssl.sslKeyStore': FcpTypeFilename, @@ -336,22 +325,32 @@ 'ssl.sslVersion': FcpTypeChoiceSSLVersion, 'toadletsymlinker.symlinks': FcpTypeStringList, - } - def __init__(self): pass - def splitAll(self, paramName): - return paramName.split(self.ComponentsSep) + """Splits a parameter name into its components + @param (str) paramName: parameter name to split + @return: (list) components + """ + return paramName.split(self.ComponentSep) + def splitParamClass(self, paramName): - return paramName.split(self.ComponentsSep, 1) + """Splits the parameter class from a parameter name + @param (str) paramName: parameter name to split + @return: (tuple) paramClass, tail + """ + return paramName.split(self.ComponentSep, 1) def get(self, paramName, default=None): + """Returns the type of a parameter or default + @param paramName: (str) name of the parameter to retuen the type for + @return: (FcpType) + """ try: return self[paramName] except KeyError: @@ -359,6 +358,10 @@ def __getitem__(self, paramName): + """Returns the type of a parameter + @param paramName: (str) name of the parameter to retuen the type for + @return: (FcpType) + """ paramClass, paramKey = self.splitParamClass(paramName) if paramClass == self.ParamClassCurrent: return self.Params[paramKey] @@ -387,8 +390,7 @@ PeerMessageParams = { 'ark.number': FcpTypeInt, 'auth.negTypes': FcpTypeInt, - - + 'location': FcpTypeFloat, 'opennet': FcpTypeBool, 'testnet': FcpTypeBool, @@ -440,8 +442,7 @@ 'location': FcpTypeFloat, 'opennet': FcpTypeBool, 'testnet': FcpTypeBool, - - + 'volatile.allocatedJavaMemory': FcpTypeInt, 'volatile.availableCPUs': FcpTypeInt, 'volatile.averagePingTime': FcpTypeFloat, @@ -527,14 +528,14 @@ >>all other NodeData message params here.... >> >> physical.udp=000.000.000.000:00000 ->> dsaPubKey.y=GgrpsNUK9m................................................. +>> dsaPubKey.y=GarpsNUKe................................................. >> version=Fred,0.7,1.0,1107 >> myName=whatever >> ark.pubURI=SSK@............... >> dsaGroup.q=ALFDNoq..... >> dsaGroup.p=AIYIrE9VNhM3............. ->> volatile.avgConnectedPeersPerNode=15.35................ +>> volatile.avgConnectedPeersPerNode=00.00................ >> dsaGroup.g=UaRa............. >> dsaPrivKey.x=Pwam.................. >> ark.privURI=SSK@................. @@ -553,93 +554,111 @@ MessageParamTypes = { # client messages - + # + #'AddPeer': # added later as PeerMessageParams + 'ClientGet': { + 'BinaryBlob': FcpTypeBool, + 'Global': FcpTypeBool, + 'IgnoreDS': FcpTypeBool, + 'DSOnly': FcpTypeBool, + 'MaxSize': FcpTypeInt, + 'MaxTempSize': FcpTypeInt, + 'Verbosity': FcpTypeInt, + }, + 'ClientPut': { + 'BinaryBlob': FcpTypeBool, + 'DontCompress': FcpTypeBool, + 'EarlyEncode': FcpTypeBool, + 'GetCHKOnly': FcpTypeBool, + 'Global': FcpTypeBool, + 'MaxRetries': FcpTypeInt, + 'Verbosity': FcpTypeInt, + }, + 'GetConfig': { + 'WithCurrent': FcpTypeBool, + 'WithDefaults': FcpTypeBool, + 'WithSortOrder': FcpTypeBool, + 'WithExpertFlag': FcpTypeBool, + 'WithForceWriteFlag': FcpTypeBool, + 'WithShortDescription': FcpTypeBool, + 'WithLongDescription': FcpTypeBool, + }, + 'GetNode': { + 'GiveOpennetRef': FcpTypeBool, + 'WithPrivate': FcpTypeBool, + 'WithVolatile': FcpTypeBool, + }, + 'GetPluginInfo': { + 'Detailed': FcpTypeBool, + }, + 'GetRequestStatus': { + 'Global': FcpTypeBool, + 'OnlyData': FcpTypeBool, + }, 'ListPeer': { 'WithMetadata': FcpTypeBool, 'WithVolantile': FcpTypeBool, }, - 'ListPeers': { 'WithMetadata': FcpTypeBool, 'WithVolantile': FcpTypeBool, }, - - #'AddPeer': # added later as PeerMessageParams - 'ModifyPeer': { 'AllowLocalAddresses': FcpTypeBool, 'IsDisabled': FcpTypeBool, 'ListenOnly': FcpTypeBool, }, - + #'ModifyConfig': # added later as ConfigMessageParams() 'ModifyPeerNote': { 'NoteText': FcpTypeBase64EncodedString, }, - - 'GetNode': { - 'GiveOpennetRef': FcpTypeBool, - 'WithPrivate': FcpTypeBool, - 'WithVolatile': FcpTypeBool, + 'ModifyPersistentRequest': { + 'Global': FcpTypeBool, }, - 'GetConfig': { - 'WithCurrent': FcpTypeBool, - 'WithDefaults': FcpTypeBool, - 'WithSortOrder': FcpTypeBool, - 'WithExpertFlag': FcpTypeBool, - 'WithForceWriteFlag': FcpTypeBool, - 'WithShortDescription': FcpTypeBool, - 'WithLongDescription': FcpTypeBool, - }, - - #'ModifyConfig': # added later as ConfigMessageParams() - - 'TestDDARequest': { - 'WantReadDirectory': FcpTypeBool, - 'WantWriteDirectory': FcpTypeBool, - }, - 'ClientPut': { - 'BinaryBlob': FcpTypeBool, - 'DontCompress': FcpTypeBool, - 'EarlyEncode': FcpTypeBool, - 'GetCHKOnly': FcpTypeBool, + 'RemopvePersistentRequest': { 'Global': FcpTypeBool, - 'MaxRetries': FcpTypeInt, - 'Verbosity': FcpTypeInt, }, - 'ClientGet': { - 'BinaryBlob': FcpTypeBool, - 'Global': FcpTypeBool, - 'IgnoreDS': FcpTypeBool, - 'DSOnly': FcpTypeBool, - 'MaxSize': FcpTypeInt, - 'MaxTempSize': FcpTypeInt, - 'Verbosity': FcpTypeInt, - }, 'SubscribeUSK': { 'DontPoll': FcpTypeBool, }, + 'TestDDARequest': { + 'WantReadDirectory': FcpTypeBool, + 'WantWriteDirectory': FcpTypeBool, + }, 'WatchGlobal': { 'Enabled': FcpTypeBool, 'VerbosityMask': FcpTypeInt, }, - 'GetRequestStatus': { + + # node messages + # + 'AllData': { 'Global': FcpTypeBool, - 'OnlyData': FcpTypeBool, + #NOTE: we ignore startup and completion time here as long as it is not passed in all related messages }, - 'RemopvePersistentRequest': { + #'ConfigData': # added later as ConfigMessageParams() + 'DataFound': { 'Global': FcpTypeBool, + 'DataLength': FcpTypeInt, }, - 'ModifyPersistentRequest': { - 'Global': FcpTypeBool, + 'FinishedCompression': { + 'OriginalSize': FcpTypeInt, + 'CompressedSize': FcpTypeInt, }, + 'GetFailed': { + 'Code': FcpTypeInt, + 'ExpectedDataLength': FcpTypeInt_GetFailed_ExpectedDataLenght, + 'Fatal': FcpTypeBool, + 'FinalizedExpected': FcpTypeBool, + 'Global': FcpTypeBool, + }, 'GetPluginInfo': { - 'Detailed': FcpTypeBool, + 'Started': FcpTypeBool, }, - - - - # node messages - + 'IdentifierCollision': { + 'Global': FcpTypeBool, + }, + #'NodeData': # added later as NodeMessageParams 'NodeHello': { 'Build': FcpTypeInt, 'CompressionCodecs': FcpTypeInt, @@ -648,37 +667,27 @@ 'FcpVersion': FcpTypeFloat, 'Testnet': FcpTypeBool, }, - #'Peer': # added later as PeerMessageParams - 'PeerNote': { 'NoteText': FcpTypeBase64EncodedString, }, - - - #'NodeData': # added later as NodeMessageParams - #'ConfigData': # added later as ConfigMessageParams() - - 'TestDDAComplete': { - 'ReadDirectoryAllowed': FcpTypeBool, - 'WriteDirectoryAllowed': FcpTypeBool, - }, - 'PutFetchable': { + 'PersistentRequestModified': { 'Global': FcpTypeBool, - }, - 'DataFound': { + }, + 'PersistentRequestRemoved': { 'Global': FcpTypeBool, - 'DataLength': FcpTypeInt, }, - 'AllData': { + 'ProtocolError': { + 'Code': FcpTypeInt, 'Global': FcpTypeBool, - #NOTE: we ignore startup and completion time here as long as it is not passed in all related messages - + }, + 'PutFailed': { + 'Global': FcpTypeBool, + 'Code': FcpTypeInt, + }, + 'PutFetchable': { + 'Global': FcpTypeBool, }, - 'FinishedCompression': { - 'OriginalSize': FcpTypeInt, - 'CompressedSize': FcpTypeInt, - }, 'SimpleProgress': { 'Total': FcpTypeInt, 'Required': FcpTypeInt, @@ -687,38 +696,13 @@ 'Succeeded': FcpTypeInt, 'Finalized': FcpTypeBool, }, - 'PersistentRequestRemoved': { - 'Global': FcpTypeBool, - }, - 'PersistentRequestModified': { - 'Global': FcpTypeBool, - }, - 'PutFailed': { - 'Global': FcpTypeBool, - 'Code': FcpTypeInt, - }, - 'GetFailed': { - 'Code': FcpTypeInt, - 'ExpectedDataLength': FcpTypeInt_GetFailed_ExpectedDataLenght, - 'Fatal': FcpTypeBool, - 'FinalizedExpected': FcpTypeBool, - 'Global': FcpTypeBool, - }, - 'ProtocolError': { - 'Code': FcpTypeInt, - 'Global': FcpTypeBool, - }, - - 'IdentifierCollision': { - 'Global': FcpTypeBool, - }, 'SubscribedUSKUpdate': { 'Edition': FcpTypeInt, }, - 'GetPluginInfo': { - 'Started': FcpTypeBool, + 'TestDDAComplete': { + 'ReadDirectoryAllowed': FcpTypeBool, + 'WriteDirectoryAllowed': FcpTypeBool, }, - } MessageParamTypes['ClientPutDiskDir'] = MessageParamTypes['ClientPut'] @@ -728,9 +712,7 @@ MessageParamTypes['PersistentGet'] = MessageParamTypes['ClientGet'] MessageParamTypes['PersistentPut'] = MessageParamTypes['ClientPut'] - MessageParamTypes['ModifyConfig'] = MessageParamTypes['ConfigData'] = ConfigMessageParams() - MessageParamTypes['Peer'] = MessageParamTypes['AddPeer'] = PeerMessageParams This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |