#NEWLINE# def _getDeprecationWarningString( fqpn , version , format = None , replacement = None ) : #NEWLINE# #INDENT# '\n    Return a string indicating that the Python name was deprecated in the given\n    version.\n\n    @param fqpn: Fully qualified Python name of the thing being deprecated\n    @type fqpn: C{str}\n\n    @param version: Version that C{fqpn} was deprecated in.\n    @type version: L{twisted.python.versions.Version}\n\n    @param format: A user-provided format to interpolate warning values into, or\n        L{DEPRECATION_WARNING_FORMAT\n        <twisted.python.deprecate.DEPRECATION_WARNING_FORMAT>} if C{None} is\n        given.\n    @type format: C{str}\n\n    @param replacement: what should be used in place of C{fqpn}. Either pass in\n        a string, which will be inserted into the warning message, or a\n        callable, which will be expanded to its full import path.\n    @type replacement: C{str} or callable\n\n    @return: A textual description of the deprecation\n    @rtype: C{str}\n    ' #NEWLINE# if ( format is None ) : #NEWLINE# #INDENT# format = DEPRECATION_WARNING_FORMAT #NEWLINE# #UNINDENT# warningString = ( version % { #NEWLINE# #INDENT# 'fqpn' : fqpn , #NEWLINE# 'version' : getVersionString ( version ) , #NEWLINE# #UNINDENT# } ) #NEWLINE# if replacement : #NEWLINE# #INDENT# warningString = ( '%s; %s' % ( warningString , _getReplacementString ( replacement ) ) ) #NEWLINE# #UNINDENT# return warningString