Intellisense does not show module-private functions

[leoniDEV]

Inside of my script modules I don't use the naming convention "verb-noun" for the functions which are private and are used only inside the modules and therefore I don't expose. Tipically I put these functions in a nested module.

Intellisense is unable to suggest these functions if I try to call them from the parent module or others nested modules, also Peek Definition and Find All Reference don't give me any results.
Instead Peek Definition and Fin All Reference work properly if I'm in the module where the function is defined, while Intellisens works partially, it suggest me the funtion but don't show the extendend information.

If the functions follow the "verb-noun" naming convention Intellisense, Peek Definition and Find All Reference work fine, no matter where they are defined and where I try to call them

[daviwil]

Hey @leoniDEV,

Not sure why "verb-noun" functions are working, I was under the impression that functions from nested modules weren't working at this point. I'd definitely like to make this work, though!

Could you do me a favor and try this in the PowerShell ISE and see if it works for you? Also, would you mind giving me a simple example that I can use to reproduce this on my side? You can either paste some simple code files here into the issue or use https://gist.github.com/ and create a Gist with multiple files (use the Add File) button on that page.

Thanks!

[leoniDEV]

In the ISE all work fine.
I've made a very simple module with some comments to explain how you can reproduce what i'm describing:
https://gist.github.com/leoniDEV/cbcc87ba7c374ad7c4e1

After some more investigation i've found that the problem could be in the FunctionsToExport property of the module manifest, usually I assign to that property the string "-" so the module export only the functions with a dash in the name which are the ones that follow the naming convention.

If I export all the functions (using "*" instead of "-") and restart VSCode (exiting and reopening the module in VSCode) it seems that everything works properly also for the functions that haven't a dash in the name (except for the syntax highlighting which still doens't works).

[daviwil]

Thanks for the example, that is helpful! The FunctionsToExport property may be part of the puzzle. I'll look into this and see if I can figure out what's going on.

[KirkMunro]

@leoniDEV This issue aside, as a best practice you should explicitly list your function names in your manifest, and avoid wildcard in FunctionsToExport, AliasesToExport, CmdletsToExport, etc. attributes. Explicitly identifying command names in a module manifest is more reliable and it improves performance by eliminating unnecessary inspection work that PowerShell needs to do when wildcards are used in the "ToExport" attributes.

[leoniDEV]

Good to know but sometimes, when there are many functions to export it is more practical to use wildcards, or when the module isn't complete and the functions and their names may vary often

[KirkMunro]

Maybe when you're developing the module, but even then a relatively simple script could easily pull out the names of the functions you want to export and automatically update your psd1 file so that it has explicitly defined exports before you publish it. Even without that in place, it is so little effort to maintain as you develop the module (add/rename/remove a function you want exported, modify the manifest), that even when there are many functions, that there really isn't any good excuse for not doing it imho. You just need to be diciplined enough to get it done.

[daviwil]

Hmmm, seems like some nice editor should have an "Export function from module" command which can automatically detect which psd1 file to which the function under the cursor should be added and then add it ;) I definitely want to add some module creation utilities to Editor Services.

[leoniDEV]

@KirkMunro I always try to follow the best practice in a very strict way (sometimes too strict) when I do something, and if I need to use my module in a real production environment or I want to make public my modules I definitely would try to apply all the best practices (at least the ones I know).
But I want to point out that I'm not an IT PRO or a developer, I'm only a "nerd" passonate to informatic so I'm not aware of many things.
I made some modules for fun or for manage my personal staff or for my little office (with 5 client and a file server+domain controller which require a very very little effort to manage) so I never made my modules public or used in a real production environment.
So every time I made or update a module I try to learn something new and try to do my staff in a little more professional ways, so thanks for the suggestion.

@daviwil Every utilities which can help the development are well accepted

Anyways even if it is OT, I want to take the opportunity to ask what is the best channel to report a bug about Powershell, connect.microsoft.com, UserVoice, Githhub or what? Because I have an issue with Powershell (which is not related with the issue reported here) and I like to know if it is a bug or is the intended behavior or it can be addressed in some way.

[KirkMunro]

UserVoice is the go to place for PowerShell bugs/suggestions now. Here's a link:
https://windowsserver.uservoice.com/forums/301869-powershell

[daviwil]

Yep, Kirk's right, UserVoice is the place to file feedback now.

[leoniDEV]

Well, many thanks

[TylerLeonhardt]

Reading over the comments here, I don't think I quite understand the issue. Can I have a little bit more context?