mirror of
				https://github.com/python/cpython.git
				synced 2025-11-04 07:31:38 +00:00 
			
		
		
		
	
		
			
	
	
		
			42 lines
		
	
	
	
		
			775 B
		
	
	
	
		
			Python
		
	
	
	
	
	
		
		
			
		
	
	
			42 lines
		
	
	
	
		
			775 B
		
	
	
	
		
			Python
		
	
	
	
	
	
| 
								 | 
							
								# Test docstring extraction
							 | 
						||
| 
								 | 
							
								from gettext import gettext as _
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Empty docstring
							 | 
						||
| 
								 | 
							
								def test(x):
							 | 
						||
| 
								 | 
							
								    """"""
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Leading empty line
							 | 
						||
| 
								 | 
							
								def test2(x):
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								    """docstring"""  # XXX This should be extracted but isn't.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# XXX Multiline docstrings should be cleaned with `inspect.cleandoc`.
							 | 
						||
| 
								 | 
							
								def test3(x):
							 | 
						||
| 
								 | 
							
								    """multiline
							 | 
						||
| 
								 | 
							
								    docstring
							 | 
						||
| 
								 | 
							
								    """
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Multiple docstrings - only the first should be extracted
							 | 
						||
| 
								 | 
							
								def test4(x):
							 | 
						||
| 
								 | 
							
								    """docstring1"""
							 | 
						||
| 
								 | 
							
								    """docstring2"""
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								def test5(x):
							 | 
						||
| 
								 | 
							
								    """Hello, {}!""".format("world!")  # XXX This should not be extracted.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								# Nested docstrings
							 | 
						||
| 
								 | 
							
								def test6(x):
							 | 
						||
| 
								 | 
							
								    def inner(y):
							 | 
						||
| 
								 | 
							
								        """nested docstring"""  # XXX This should be extracted but isn't.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								class Outer:
							 | 
						||
| 
								 | 
							
								    class Inner:
							 | 
						||
| 
								 | 
							
								        "nested class docstring"  # XXX This should be extracted but isn't.
							 |