[New] External Tools: Launch system tools, like terminal or file manager

gkatev · gkatev · commit eb5ae22ec5b8 · 2024-04-15T11:20:42.000+03:00
This plugin serves to quickly launch external tools in the context
of the current document, i.e. in the same directory, or with focus
on the file. The current implementation includes a Terminal and a
File Manager.

The commands to execute are configurable in the Plugin preferences.
The tools may be launched from the Tools menu, or via keybinds.

The code is modular to support easy addition of extra tools, though
in the feature it would be really nice to support such additions
directly in the preferences without code modification.
diff --git a/MAINTAINERS b/MAINTAINERS
@@ -61,6 +61,13 @@ M: Pavel Roschin <rpg89(at)post(dot)ru>
 W: http://plugins.geany.org/defineformat.html
 S: Maintained
 
+externaltools
+P: George Katevenis <george_kate(at)hotmail(dot)com>
+g: @gkatev
+M: George Katevenis <george_kate(at)hotmail(dot)com>
+W: http://plugins.geany.org/externaltools.html
+S: Maintained
+
 geanyctags
 P: Jiří Techet <techet@gmail.com>
 g: @techee
diff --git a/Makefile.am b/Makefile.am
@@ -37,6 +37,10 @@ if ENABLE_DEFINEFORMAT
 SUBDIRS += defineformat
 endif
 
+if ENABLE_EXTERNALTOOLS
+SUBDIRS += externaltools
+endif
+
 if ENABLE_GEANYCTAGS
 SUBDIRS += geanyctags
 endif
diff --git a/README b/README
@@ -53,6 +53,7 @@ Available plugins are:
 * ``commander`` -- the Commander plugin
 * ``debugger`` -- the Debugger plugin
 * ``defineformat`` -- the Defineformat plugin
+* ``externaltools`` -- the ExternalTools plugin
 * ``geanyctags`` -- the GeanyCtags plugin
 * ``geanydoc`` -- the GeanyDoc plugin
 * ``geanyextrasel`` -- the GeanyExtraSel plugin
diff --git a/build/externaltools.m4 b/build/externaltools.m4
@@ -0,0 +1,9 @@
+AC_DEFUN([GP_CHECK_EXTERNALTOOLS],
+[
+    GP_ARG_DISABLE([ExternalTools], [auto])
+    GP_COMMIT_PLUGIN_STATUS([ExternalTools])
+    AC_CONFIG_FILES([
+        externaltools/Makefile
+        externaltools/src/Makefile
+    ])
+])
diff --git a/configure.ac b/configure.ac
@@ -37,6 +37,7 @@ GP_CHECK_CODENAV
 GP_CHECK_COMMANDER
 GP_CHECK_DEBUGGER
 GP_CHECK_DEFINEFORMAT
+GP_CHECK_EXTERNALTOOLS
 GP_CHECK_GEANYCTAGS
 GP_CHECK_GEANYDOC
 GP_CHECK_GEANYEXTRASEL
diff --git a/externaltools/AUTHORS b/externaltools/AUTHORS
@@ -0,0 +1 @@
+George Katevenis <george_kate(at)hotmail(dot)com>
diff --git a/externaltools/COPYING b/externaltools/COPYING
diff --git a/externaltools/ChangeLog b/externaltools/ChangeLog
@@ -0,0 +1,4 @@
+2024-04-14  Version 0.1
+
+	* Initial plugin release, with support for
+	  'Open Terminal' and 'Open Directory'.
diff --git a/externaltools/Makefile.am b/externaltools/Makefile.am
@@ -0,0 +1,4 @@
+include $(top_srcdir)/build/vars.auxfiles.mk
+
+SUBDIRS = src
+plugin = externaltools
diff --git a/externaltools/NEWS b/externaltools/NEWS
@@ -0,0 +1 @@
+See "ChangeLog"
diff --git a/externaltools/README b/externaltools/README
@@ -0,0 +1,57 @@
+External Tools
+==============
+
+About
+-----
+This plugin provides a way to quickly launch external tools (i.e. non-geany
+tools) in the same context as a document. For example, this may include
+starting a terminal or a file manager in the same directory as the current
+file.
+
+Supported tools
+---------------
+The tools currently supported include:
+
+1. Open Terminal: This option launches a terminal in the same directory as the
+current document.
+
+2. Open Directory: Launches a file manager, in the same directory as the
+current document.
+
+They may be launched from the *Tools* menu, or via a shortcut.
+
+Configuration
+-------------
+In the plugin's preferences you can adjust the command used to spawn each
+tool. Occurrences of `%f` in the provided commands are substituted with the
+path to the current file, while `%d` is substituted with the path to the
+directory in which the file resides.
+
+If the current document is *untitled*, %d is replaced with the home directory,
+while %f is effectively erased.
+
+**Tip:** Some file managers support opening a window at a directory *and*
+placing focus on a specific file. Examples: `nemo %f`, `nautilus %f`, `dolphin
+--select %f`.
+
+Adding new tools
+----------------
+At the moment, adding new tools requires modifying the plugin's source, though
+the code is structured in a way to easily accommodate this.
+
+Bug reports, suggestions, patches
+---------------------------------
+You can report bugs, or suggest new tools or other improvements at the
+geany-plugins project on GitHub: https://github.com/geany/geany-plugins. You
+may page the developer using `@gkatev`.
+
+License
+-------
+The External Tools plugin is distributed under the terms of the GNU General
+Public License as published by the Free Software Foundation; either version 2
+of the License, or (at your option) any later version. A copy of this license
+can be found in the file COPYING included with the source code of this program.
+
+Contact
+-------
+George Katevenis <george_kate(at)hotmail(dot)com>
diff --git a/externaltools/src/Makefile.am b/externaltools/src/Makefile.am
@@ -0,0 +1,11 @@
+include $(top_srcdir)/build/vars.build.mk
+plugin = externaltools
+
+geanyplugins_LTLIBRARIES = externaltools.la
+
+externaltools_la_SOURCES = externaltools.c
+
+externaltools_la_CPPFLAGS = $(AM_CPPFLAGS) -DG_LOG_DOMAIN=\"ExternalTools\"
+externaltools_la_LIBADD = $(COMMONLIBS)
+
+include $(top_srcdir)/build/cppcheck.mk
diff --git a/externaltools/src/externaltools.c b/externaltools/src/externaltools.c
diff --git a/po/POTFILES.in b/po/POTFILES.in

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+George Katevenis <george_kate(at)hotmail(dot)com>`