Skip to content

Commit eb5ae22

Browse files
gkatevgkatev
committed
[New] External Tools: Launch system tools, like terminal or file manager
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.
1 parent a8f26ab commit eb5ae22

14 files changed

+864
-0
lines changed

‎MAINTAINERS

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,13 @@ M: Pavel Roschin <rpg89(at)post(dot)ru>
6161
W: http://plugins.geany.org/defineformat.html
6262
S: Maintained
6363

64+
externaltools
65+
P: George Katevenis <george_kate(at)hotmail(dot)com>
66+
g: @gkatev
67+
M: George Katevenis <george_kate(at)hotmail(dot)com>
68+
W: http://plugins.geany.org/externaltools.html
69+
S: Maintained
70+
6471
geanyctags
6572
P: Jiří Techet <[email protected]>
6673
g: @techee

‎Makefile.am

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,10 @@ if ENABLE_DEFINEFORMAT
3737
SUBDIRS += defineformat
3838
endif
3939

40+
if ENABLE_EXTERNALTOOLS
41+
SUBDIRS += externaltools
42+
endif
43+
4044
if ENABLE_GEANYCTAGS
4145
SUBDIRS += geanyctags
4246
endif

‎README

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -53,6 +53,7 @@ Available plugins are:
5353
* ``commander`` -- the Commander plugin
5454
* ``debugger`` -- the Debugger plugin
5555
* ``defineformat`` -- the Defineformat plugin
56+
* ``externaltools`` -- the ExternalTools plugin
5657
* ``geanyctags`` -- the GeanyCtags plugin
5758
* ``geanydoc`` -- the GeanyDoc plugin
5859
* ``geanyextrasel`` -- the GeanyExtraSel plugin

‎build/externaltools.m4

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
AC_DEFUN([GP_CHECK_EXTERNALTOOLS],
2+
[
3+
GP_ARG_DISABLE([ExternalTools], [auto])
4+
GP_COMMIT_PLUGIN_STATUS([ExternalTools])
5+
AC_CONFIG_FILES([
6+
externaltools/Makefile
7+
externaltools/src/Makefile
8+
])
9+
])

‎configure.ac

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,7 @@ GP_CHECK_CODENAV
3737
GP_CHECK_COMMANDER
3838
GP_CHECK_DEBUGGER
3939
GP_CHECK_DEFINEFORMAT
40+
GP_CHECK_EXTERNALTOOLS
4041
GP_CHECK_GEANYCTAGS
4142
GP_CHECK_GEANYDOC
4243
GP_CHECK_GEANYEXTRASEL

‎externaltools/AUTHORS

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
George Katevenis <george_kate(at)hotmail(dot)com>

‎externaltools/COPYING

Lines changed: 340 additions & 0 deletions
Large diffs are not rendered by default.

‎externaltools/ChangeLog

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
2024-04-14 Version 0.1
2+
3+
* Initial plugin release, with support for
4+
'Open Terminal' and 'Open Directory'.

‎externaltools/Makefile.am

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
include $(top_srcdir)/build/vars.auxfiles.mk
2+
3+
SUBDIRS = src
4+
plugin = externaltools

‎externaltools/NEWS

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
See "ChangeLog"

‎externaltools/README

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
External Tools
2+
==============
3+
4+
About
5+
-----
6+
This plugin provides a way to quickly launch external tools (i.e. non-geany
7+
tools) in the same context as a document. For example, this may include
8+
starting a terminal or a file manager in the same directory as the current
9+
file.
10+
11+
Supported tools
12+
---------------
13+
The tools currently supported include:
14+
15+
1. Open Terminal: This option launches a terminal in the same directory as the
16+
current document.
17+
18+
2. Open Directory: Launches a file manager, in the same directory as the
19+
current document.
20+
21+
They may be launched from the *Tools* menu, or via a shortcut.
22+
23+
Configuration
24+
-------------
25+
In the plugin's preferences you can adjust the command used to spawn each
26+
tool. Occurrences of `%f` in the provided commands are substituted with the
27+
path to the current file, while `%d` is substituted with the path to the
28+
directory in which the file resides.
29+
30+
If the current document is *untitled*, %d is replaced with the home directory,
31+
while %f is effectively erased.
32+
33+
**Tip:** Some file managers support opening a window at a directory *and*
34+
placing focus on a specific file. Examples: `nemo %f`, `nautilus %f`, `dolphin
35+
--select %f`.
36+
37+
Adding new tools
38+
----------------
39+
At the moment, adding new tools requires modifying the plugin's source, though
40+
the code is structured in a way to easily accommodate this.
41+
42+
Bug reports, suggestions, patches
43+
---------------------------------
44+
You can report bugs, or suggest new tools or other improvements at the
45+
geany-plugins project on GitHub: https://github.com/geany/geany-plugins. You
46+
may page the developer using `@gkatev`.
47+
48+
License
49+
-------
50+
The External Tools plugin is distributed under the terms of the GNU General
51+
Public License as published by the Free Software Foundation; either version 2
52+
of the License, or (at your option) any later version. A copy of this license
53+
can be found in the file COPYING included with the source code of this program.
54+
55+
Contact
56+
-------
57+
George Katevenis <george_kate(at)hotmail(dot)com>

‎externaltools/src/Makefile.am

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
include $(top_srcdir)/build/vars.build.mk
2+
plugin = externaltools
3+
4+
geanyplugins_LTLIBRARIES = externaltools.la
5+
6+
externaltools_la_SOURCES = externaltools.c
7+
8+
externaltools_la_CPPFLAGS = $(AM_CPPFLAGS) -DG_LOG_DOMAIN=\"ExternalTools\"
9+
externaltools_la_LIBADD = $(COMMONLIBS)
10+
11+
include $(top_srcdir)/build/cppcheck.mk

0 commit comments

Comments
 (0)