Fix direct links to plugin sources

Author: simonrob

plugins/README.md

@@ -5,57 +5,57 @@ See the [sample configuration file](../emailproxy.config#L42) for further applic
 
 
 ## Sample plugins
-- [`Echo`](plugins/Echo.py): An example plugin that does nothing except call `log_debug` with all received messages.
+- [`Echo`](Echo.py): An example plugin that does nothing except call `log_debug` with all received messages.
 As a result, it is not specific to IMAP, POP or SMTP, and can be used with any type of server.
 
-- [`IMAPCapabilityModifier`](plugins/IMAPCapabilityModifier.py): An example plugin that intercepts a single IMAP `CAPABILITY` response and modifies it to remove support for `LITERAL+` (chosen only as a common example for demonstration purposes; this is not a useful plugin).
+- [`IMAPCapabilityModifier`](IMAPCapabilityModifier.py): An example plugin that intercepts a single IMAP `CAPABILITY` response and modifies it to remove support for `LITERAL+` (chosen only as a common example for demonstration purposes; this is not a useful plugin).
 
-- [`IMAPCleanO365ATPLinks`](plugins/IMAPCleanO365ATPLinks.py): An example IMAP plugin that looks for Office 365 Advanced Threat Protection links (also known as Safe Links in Microsoft Defender for Office 365) and replaces them with their original values (i.e., removing the redirect).
+- [`IMAPCleanO365ATPLinks`](IMAPCleanO365ATPLinks.py): An example IMAP plugin that looks for Office 365 Advanced Threat Protection links (also known as Safe Links in Microsoft Defender for Office 365) and replaces them with their original values (i.e., removing the redirect).
 As with most of the proxy's plugins, it would be more efficient to handle this on the server side (i.e., by disabling link modification), but this is not always possible.
 
-- [`IMAPLinkDestinationRevealer`](plugins/IMAPLinkDestinationRevealer.py): An example IMAP plugin that looks for links that appear to show a URL, but whose text doesn't match the link's actual destination (its `href`), and makes this more visible by replacing the original link destination with the text, and displaying the original destination alongside.
+- [`IMAPLinkDestinationRevealer`](IMAPLinkDestinationRevealer.py): An example IMAP plugin that looks for links that appear to show a URL, but whose text doesn't match the link's actual destination (its `href`), and makes this more visible by replacing the original link destination with the text, and displaying the original destination alongside.
 If using with the IMAPCleanO365ATPLinks plugin, place that plugin later in the list (so it will be executed first on messages received from the server).
 
-- [`IMAPDecodeDeflateCompression`](plugins/IMAPDecodeDeflateCompression.py): An example IMAP plugin that looks for client requests to enable compression (RFC 1951 and 4978) and, unlike [`IMAPDisableDeflateCompression`](plugins/IMAPDisableDeflateCompression.py), permits compression but decompresses messages within the plugin.
+- [`IMAPDecodeDeflateCompression`](IMAPDecodeDeflateCompression.py): An example IMAP plugin that looks for client requests to enable compression (RFC 1951 and 4978) and, unlike [`IMAPDisableDeflateCompression`](IMAPDisableDeflateCompression.py), permits compression but decompresses messages within the plugin.
 This allows monitoring and editing of compressed incoming and outgoing communication, but only within this plugin, not any others (and as a result only other deflate-aware plugins can be chained).
-An alternative option and further improvement can be found in [`IMAPDeflateCompressionRemoteEnabler`](plugins/IMAPDeflateCompressionRemoteEnabler.py).
+An alternative option and further improvement can be found in [`IMAPDeflateCompressionRemoteEnabler`](IMAPDeflateCompressionRemoteEnabler.py).
 
-- [`IMAPDeflateCompressionRemoteEnabler`](plugins/IMAPDeflateCompressionRemoteEnabler.py): An example Email OAuth 2.0 Proxy IMAP plugin that looks for `COMPRESS=DEFLATE` in server capability responses (RFC 1951
-and 4978) and, unlike [`IMAPDecodeDeflateCompression`](plugins/IMAPDecodeDeflateCompression.py), handles this entirely within the plugin, keeping an uncompressed channel to the client, but enabling compressed communication with the server.
+- [`IMAPDeflateCompressionRemoteEnabler`](IMAPDeflateCompressionRemoteEnabler.py): An example Email OAuth 2.0 Proxy IMAP plugin that looks for `COMPRESS=DEFLATE` in server capability responses (RFC 1951
+and 4978) and, unlike [`IMAPDecodeDeflateCompression`](IMAPDecodeDeflateCompression.py), handles this entirely within the plugin, keeping an uncompressed channel to the client, but enabling compressed communication with the server.
 Place this plugin at the end of the chain in the proxy's configuration file.
 
-- [`IMAPDisableDeflateCompression`](plugins/IMAPDisableDeflateCompression.py): An example IMAP plugin that looks for client requests to enable compression (RFC 1951 and 4978) and responds with `NO` every time, so that other plugins can continue to intercept requests.
+- [`IMAPDisableDeflateCompression`](IMAPDisableDeflateCompression.py): An example IMAP plugin that looks for client requests to enable compression (RFC 1951 and 4978) and responds with `NO` every time, so that other plugins can continue to intercept requests.
 Place this plugin before any others if you use a client that automatically tries to enable compression when it finds `COMPRESS=DEFLATE` in a `CAPABILITY` response.
-An alternative option here if you do not need to actually edit messages is to keep compression enabled, but decompress within the plugin – see [`IMAPDecodeDeflateCompression`](plugins/IMAPDecodeDeflateCompression.py).
+An alternative option here if you do not need to actually edit messages is to keep compression enabled, but decompress within the plugin – see [`IMAPDecodeDeflateCompression`](IMAPDecodeDeflateCompression.py).
 
-- [`IMAPFixO365SearchQuirks`](plugins/IMAPFixO365SearchQuirks.py): An example IMAP plugin that modifies search strings to fix O365's inability to handle uppercase characters in searches.
+- [`IMAPFixO365SearchQuirks`](IMAPFixO365SearchQuirks.py): An example IMAP plugin that modifies search strings to fix O365's inability to handle uppercase characters in searches.
 The plugin also changes `BODY` searches to `TEXT` to prompt O365 to return flags in the results.
 Note that no detection of whether the remote server is actually O365 takes place.
 
-- [`IMAPIgnoreSentMessageUpload`](plugins/IMAPIgnoreSentMessageUpload.py): An example IMAP plugin that accepts client requests to upload sent messages to an IMAP mailbox, but silently discards them without sending to the server.
+- [`IMAPIgnoreSentMessageUpload`](IMAPIgnoreSentMessageUpload.py): An example IMAP plugin that accepts client requests to upload sent messages to an IMAP mailbox, but silently discards them without sending to the server.
 This plugin helps avoid message duplication for servers that automatically place messages sent via SMTP into the relevant IMAP mailbox.
 Note that many clients are aware of this behaviour and provide an option to not upload sent messages – if this is available it is a much more efficient solution than adding a proxy plugin.
 
-- [`IMAPRegexContentReplacer`](plugins/IMAPRegexContentReplacer.py): An example IMAP plugin that performs regular expression searches and substitutions on the content of received messages.
+- [`IMAPRegexContentReplacer`](IMAPRegexContentReplacer.py): An example IMAP plugin that performs regular expression searches and substitutions on the content of received messages.
 Please note that this is a relatively simplistic example of how such a plugin could work, and if you try to confuse or break it you will likely succeed.
 
-- [`SMTPBlackHole`](plugins/SMTPBlackHole.py): An example SMTP plugin that accepts incoming email messages but silently discards them without passing to the remote server.
+- [`SMTPBlackHole`](SMTPBlackHole.py): An example SMTP plugin that accepts incoming email messages but silently discards them without passing to the remote server.
 Useful for testing email sending tools with no risk of actually delivering messages.
 
-- [`SMTPDisableO365Reactions`](plugins/SMTPDisableO365Reactions.py): An example SMTP plugin that adds the [`x-ms-reactions: disallow`](https://techcommunity.microsoft.com/t5/outlook-blog/reactions-in-outlook-public-usability-update-september-2023/ba-p/3928103) header to outgoing messages to disable Outlook reactions.
+- [`SMTPDisableO365Reactions`](SMTPDisableO365Reactions.py): An example SMTP plugin that adds the [`x-ms-reactions: disallow`](https://techcommunity.microsoft.com/t5/outlook-blog/reactions-in-outlook-public-usability-update-september-2023/ba-p/3928103) header to outgoing messages to disable Outlook reactions.
 An optional `domain_whitelist` parameter allows specific domains to be whitelisted (such as your own internal domain(s)).
 
-- [`SMTPRemoveClientIdentifiers`](plugins/SMTPRemoveClientIdentifiers.py): An example SMTP plugin that demonstrates removing the headers `User-Agent`, `X-Mailer` and `X-Originating-IP` from outgoing messages.
+- [`SMTPRemoveClientIdentifiers`](SMTPRemoveClientIdentifiers.py): An example SMTP plugin that demonstrates removing the headers `User-Agent`, `X-Mailer` and `X-Originating-IP` from outgoing messages.
 
-- [`SMTPSimpleMailingList`](plugins/SMTPSimpleMailingList.py): An example SMTP plugin that replaces specified recipient addresses in outgoing emails with one or more different recipients.
+- [`SMTPSimpleMailingList`](SMTPSimpleMailingList.py): An example SMTP plugin that replaces specified recipient addresses in outgoing emails with one or more different recipients.
 Please note that this is a relatively simplistic example of how such a plugin could work, and if you try to confuse or break it you will likely succeed (please use a real mailing list if you need to handle this).
 However, this approach works well for basic cases - for example, when you often find yourself sending an email to the same addresses, you can consolidate the group into a single address and never forget any recipients.
 Recipients themselves only ever see the real addresses, not your list, so there is no danger of replying to an address that does not exist.
-It recommended to chain with [`SMTPBlackHole`](plugins/SMTPBlackHole.py) and enable debug mode in the proxy at first use to check intended behaviour.
+It recommended to chain with [`SMTPBlackHole`](SMTPBlackHole.py) and enable debug mode in the proxy at first use to check intended behaviour.
 
 
 ## Creating your own plugins
-Extend [`BasePlugin`](plugins/BasePlugin.py) to create your own plugins that customise IMAP/POP/SMTP client/server behaviour.
+Extend [`BasePlugin`](BasePlugin.py) to create your own plugins that customise IMAP/POP/SMTP client/server behaviour.
 The two overridable methods `receive_from_client` and `receive_from_server` give access to raw IMAP/POP/SMTP messages/commands as they are received.
 The return values from these overridden methods, and the two sender methods `send_to_server` and `send_to_client` allow you to send messages/commands to the client/server (and other chained plugins) in response.
 The `log_debug`, `log_info` and `log_error` methods allow you to post messages to the proxy's main log.
@@ -64,9 +64,9 @@ See the method documentation and the sample plugins above for further guidance.
 Please note that for security reasons, plugins on the client side are inserted after authentication has finished – you will not receive anything from the client until that process is complete.
 
 ### Supporting tools
-The discussion, methods and variables in [`BasePlugin`](plugins/BasePlugin.py) contain pointers and suggestions about how to develop your own plugins.
+The discussion, methods and variables in [`BasePlugin`](BasePlugin.py) contain pointers and suggestions about how to develop your own plugins.
 In addition, extending the following helpers may help you get started:
 
-- [`IMAPMessageEditor`](plugins/IMAPMessageEditor.py): An example IMAP plugin helper that can be extended to create other IMAP plugins that modify the content of received messages.
+- [`IMAPMessageEditor`](IMAPMessageEditor.py): An example IMAP plugin helper that can be extended to create other IMAP plugins that modify the content of received messages.
 This plugin abstracts away the potentially error-prone message decoding process and instead provides a single method that is called whenever an email is loaded.
-See [`IMAPRegexContentReplacer`](plugins/IMAPRegexContentReplacer.py) for an example of this helper in use.
+See [`IMAPRegexContentReplacer`](IMAPRegexContentReplacer.py) for an example of this helper in use.