Add zsh completion, fix #4058

CMakeLists.txt

@@ -961,6 +961,8 @@ if(INSTALL_CONFIGS)
  DESTINATION ${CMAKE_INSTALL_PREFIX}/share/tessdata/configs)
  install(FILES ${TESSERACT_TESSCONFIGS}
  DESTINATION ${CMAKE_INSTALL_PREFIX}/share/tessdata/tessconfigs)
+ install(FILES contrib/completions/zsh/_tesseract
+ DESTINATION ${CMAKE_INSTALL_PREFIX}/share/zsh/site-functions)
 endif()
 
 # ##############################################################################

Makefile.am

@@ -5,7 +5,7 @@ ACLOCAL_AMFLAGS = -I m4
 
 CLEANFILES =
 
-SUBDIRS = . tessdata
+SUBDIRS = . tessdata contrib
 
 EXTRA_DIST = README.md LICENSE
 EXTRA_DIST += aclocal.m4 config configure.ac autogen.sh

contrib/Makefile.am

@@ -0,0 +1,4 @@
+zshcompletiondir = @datadir@/zsh/site-functions
+zshcompletion_DATA = completions/zsh/_tesseract
+
+EXTRA_DIST = $(zshcompletion_DATA)

contrib/completions/zsh/_tesseract

@@ -0,0 +1,45 @@
+#compdef tesseract
+
+local psm=(
+ '0\:Orientation\ and\ script\ detection\ \(OSD\)\ only'
+ '1\:Automatic\ page\ segmentation\ with\ OSD'
+ '2\:Automatic\ page\ segmentation,\ but\ no\ OSD,\ or\ OCR\ \(not\ implemented\)'
+ '3\:Fully\ automatic\ page\ segmentation,\ but\ no\ OSD\ \(Default\)'
+ '4\:Assume\ a\ single\ column\ of\ text\ of\ variable\ sizes'
+ '5\:Assume\ a\ single\ uniform\ block\ of\ vertically\ aligned\ text'
+ '6\:Assume\ a\ single\ uniform\ block\ of\ text'
+ '7\:Treat\ the\ image\ as\ a\ single\ text\ line'
+ '8\:Treat\ the\ image\ as\ a\ single\ word'
+ '9\:Treat\ the\ image\ as\ a\ single\ word\ in\ a\ circle'
+ '10\:Treat\ the\ image\ as\ a\ single\ character'
+ '11\:Sparse\ text.\ Find\ as\ much\ text\ as\ possible\ in\ no\ particular\ order'
+ '12\:Sparse\ text\ with\ OSD'
+ '13\:Raw\ line.\ Treat\ the\ image\ as\ a\ single\ text\ line,\ bypassing\ hacks\ that\ are\ Tesseract-specific'
+)
+local oem=(
+ '0\:Legacy\ engine\ only'
+ '1\:Neural\ nets\ LSTM\ engine\ only'
+ '2\:Legacy\ +\ LSTM\ engines'
+ '3\:Default,\ based\ on\ what\ is\ available'
+)
+local options=(
+ "(- : *)"{-h,--help}"[Show minimal help message]"
+ "(- : *)"--help-extra"[Show extra help for advanced users]"
+ "(- : *)"--help-psm"[Show page segmentation modes]"
+ "(- : *)"--help-oem"[Show OCR Engine modes]"
+ "(- : *)"{-v,--version}"[Show version information]"
+ "(- : *)"--list-langs"[List available languages for tesseract engine]"
+ "(- : *)"--print-fonts-table"[Print tesseract fonts table]"
+ "(- : *)"--print-parameters"[Print tesseract parameters]"
+ --tessdata-dir"[Specify the location of tessdata path]: :_dirs"
+ --user-words"[Specify the location of user words file]: :_files"
+ --user-patterns"[Specify the location of user patterns file]: :_files"
+ --dpi"[Specify DPI for input image]:VALUE"
+ --loglevel"[Specify logging level]:LEVEL:(ALL TRACE DEBUG INFO WARN ERROR FATAL OFF)"
+ -l"[Specify language(s) used for OCR]:LANG:($(tesseract --list-langs | tail -n+2))"
+ '*'-c"[Set value for config variables]:VAR=VALUE"
+ --psm"[Specify page segmentation mode]:Page segmentation mode:(($psm))"
+ --oem"[Specify OCR Engine mode]:OCR Engine mode:(($oem))"
+)
+
+_arguments -s -S $options ':imagename:_files' ':outputbase:_files' '*:config:_files'