[BUG] Custom post processors are completely ignored by docfx

[Lulalaby]

Hello there!

I'm in need of help for custom post processors.

I'm switching to the latest release rn and none of the post processors can be loaded anymore.

Can't import: CustomMemberIndexer, System.Composition.Hosting.CompositionFailedException: No export was found for the contract 'IPostProcessor "CustomMemberIndexer"'.
   at System.Composition.CompositionContext.GetExport(CompositionContract contract)
   at System.Composition.CompositionContext.GetExport(Type exportType, String contractName)
   at Microsoft.DocAsCode.Common.CompositionContainer.GetExport(CompositionHost container, Type type, String name) in /_/src/Microsoft.DocAsCode.Build.Engine/CompositionContainer.cs:line 50
Can't find the post processor: CustomMemberIndexer

Plugin Repo: https://github.com/Aiko-IT-Systems/DisCatSharp.DocFx.CustomMemberIndexer
Target Repo: https://github.com/Aiko-IT-Systems/DisCatSharp/tree/prep/release/10.4.0/DisCatSharp.Docs

What changed since the last releases (before the net6 upgrade).

I can't find any useful information in the releases, issues and docs.

Does the plugin needs to have a special name when generated?

I would be happy about any info pointing me in the right direction.

Regards Lala ❤️

debug.log

Note: It seems like it can find it when it's copied to the dotnet tools folder .dotnet/tools/.store/docfx/2.67.0/docfx/2.67.0/tools/net7.0/any/

[InFTord]

Yes, local postprocessors currently don't work. I can try to fix it, but no promises.

[Lulalaby]

Thank you! I'm going to look into it as well a bit, at least I try.

[Lulalaby]

Ya it seems like the plugins for template folders are ignored completely.
Dunno how to fix tho

[Lulalaby]

The issue seems to be here:

docfx/src/Microsoft.DocAsCode.App/Helpers/DocumentBuilderWrapper.cs

Lines 22 to 23 in d5606f5

	private static readonly Assembly[] s_pluginAssemblies = LoadPluginAssemblies(AppContext.BaseDirectory).ToArray();

[AB0272C]

Same issue. After I saw this in console
Searching custom plugins in directory C:\.....myProject....\bin\Debug\net6.0\...
I tried to add my post processor files to root folder and set <CopyToOutputDirectory>Always</CopyToOutputDirectory> for those files.
And it worked. So it searches files in bin/... folders, not in root

[filzrev]

Current implementation seems DLL plugins are loaded from .exe exists directory only.

Additionary, LoadPluginAssemblies` methods loads unnecessary DLLs everytimes.

docfx/src/Microsoft.DocAsCode.App/Helpers/DocumentBuilderWrapper.cs

Line 51 in d5606f5

private static IEnumerable<Assembly> LoadPluginAssemblies(string pluginDirectory)

This behavihor can be confirms with following command.

docfx build --logLevel Verbose

In my environment, DLLs processing wasted about 500ms on every startup. (On Release build)

---

Related documents needs to fixed.

https://dotnet.github.io/docfx/tutorial/howto_build_your_own_type_of_documentation_with_custom_plug-in.html#enable-plug-in
https://dotnet.github.io/docfx/tutorial/howto_add_a_customized_post_processor.html#step4-build-your-project-and-copy-the-output-dll-files-to
https://dotnet.github.io/docfx/tutorial/advanced_support_hyperlink.html#test-and-verify