mirror of
				https://github.com/notepad-plus-plus/notepad-plus-plus.git
				synced 2025-10-31 03:24:04 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			71 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
			
		
		
	
	
			71 lines
		
	
	
		
			2.4 KiB
		
	
	
	
		
			Plaintext
		
	
	
	
	
	
| What is the URL detection test
 | |
| ------------------------------
 | |
| 
 | |
| The URL detection test is designed to check,
 | |
| whether the clickable detection works as expected or not.
 | |
| 
 | |
| It uses text files as input. These text files contain a pair of
 | |
| lines for each URL to test. The first line contains the URL, the
 | |
| second line contains a sequence of characters, which are a mask,
 | |
| consisting of '0' or '1' characters, describing whether this
 | |
| position in the line should be detected as URL.
 | |
| 
 | |
| Example:
 | |
| 
 | |
| u http://dot.com u
 | |
| m 11111111111111 m
 | |
| 
 | |
| As can be seen, the URL is enclosed in "u " and " u", the mask
 | |
| is enclosed in "m " and " m". The mask line must follow the URL
 | |
| line immediately. A '1' in the mask line says, that this position
 | |
| should be detected as URL, a '0' says the opposite.
 | |
| 
 | |
| It is possible, to put arbitrary text between the pairs of test
 | |
| lines, to comment the test cases. Obviously, none of the comment
 | |
| lines should start and end with a single 'u' or 'm' character.
 | |
| 
 | |
| The test files can also be regarded as living document about what
 | |
| is currently detected as URL and what not.
 | |
| 
 | |
| 
 | |
| 
 | |
| How to conduct the URL detection test
 | |
| -------------------------------------
 | |
| 
 | |
| Since the URL detection only takes place in the visible part of
 | |
| the edit windows, the test can only be run from inside an opened
 | |
| Notepad++ with a visible edit window.
 | |
| 
 | |
| Since the test script is written in Lua, a prerequisite to conduct
 | |
| the test is, that the Lua plugin is installed. The plugin can be found
 | |
| at https://github.com/dail8859/LuaScript/releases.
 | |
| 
 | |
| To conduct the test:
 | |
| 
 | |
| 1. Open the verifyUrlDetection.lua with Notepad++.
 | |
| 2. Display the Lua console window (Plugins --> LuaScript --> Show Console)
 | |
| 3. Execute the opened script file (Plugins --> LuaScript --> Execute Current File)
 | |
| 
 | |
| The test results will be displayed in the Lua console window.
 | |
| 
 | |
| !!! Please be aware, that there should NO keyboard or mouse or whatever
 | |
|     input be applied to Notepad++ while this test is running.
 | |
| 
 | |
| 
 | |
| 
 | |
| 
 | |
| How to extend the URL detection test
 | |
| ------------------------------------
 | |
| 
 | |
| It is possible to add test files to the URL detection test
 | |
| by copying the new files into this directory and include the filenames
 | |
| in the testFiles list at the beginning of verifyUrlDetection.lua.
 | |
| 
 | |
| 
 | |
| 
 | |
| Automated version of the URL detection test
 | |
| -------------------------------------------
 | |
| 
 | |
| An automated version of the test can be conducted by running verifyUrlDetection.ps1.
 | |
| This is mainly to run the test in Appveyor.
 |