iricigor / easyazurefunction

creates local files for easy start with Azure Functions

Hi there 👋 I'm Igor 👋 Welcome to my GitHub pages!

• 🇷🇸 I was born in Prijepolje, Serbia

• 🇨🇿 I live in the Prague, Czechia

• 💬 Ask me about PowerShell (I ❤️ PowerShell !)

See also some of my other pages

My GitHub Skylines

• 2021
• 2020
• 2019
• 2018

easyazurefunction's Issues

suppres PSAvoidUsingConvertToSecureStringWithPlainText during code generation

PR below just updated generated file, to avoid error reports from PS Gallery. If regenrated, file will again throw an error. Internal function Convert-ParametersToRunner should be updated

Add example Set-ExecutionPolicy - for DropDowns

Add Verbose output to Get-Parameter

Implement better parsing of URL encoding parameters

The current solution is not good because any name gets converted to a variable.

Diagnostics only if AppVeyor

PSCredentials in one or two rows switch

It should be added to private function

Multiple commands on one page

Add switch to include CommonParams to Get-Parameter

It requires also update of docs and external help

Add dropdown for enum classes

It's already started in Get-Parameter function. After that, it should propagate to the private function.

Add -PostScript parameter

Add more examples to Get-Parameter

implement support for -ScriptName parameter in Get-Parameter

It can be an alias for existing parameter and processing can be done inside, i.e. if script ends with .ps1 do new logic.

Re-arrange readme file

Move text about Azure functions to separate document, include there animation

Also, move there text from the first paragraph that links Microsoft pages.

implement PSScriptAnalyzer suggestions, add PSCodeCode health report to GitHub

In total there are about 40 warnings, and more than half should be easy to remove.

Invoke-ScriptAnalyzer -path . -Recurse  | group message | Select Count, Name | Sort Count -Descending

Count Name
----- ----
   10 '%' is an alias of 'ForEach-Object'. Alias can introduce possible problems and make scripts hard to maintain. Please consider changing alias to its full content.
    8 'cd' is an alias of 'Set-Location'. Alias can introduce possible problems and make scripts hard to maintain. Please consider changing alias to its full content.
    7 File 'EasyAzureFunction.psm1' uses Write-Host. Avoid using Write-Host because it might not work in all hosts, does not work when there is no host, and (prior to PS 5.0) cannot be suppressed, captured, or redirected. Instead, use Write-Output, Write-Verbose, or ...
    6 'Select' is an alias of 'Select-Object'. Alias can introduce possible problems and make scripts hard to maintain. Please consider changing alias to its full content.
    4 '?' is an alias of 'Where-Object'. Alias can introduce possible problems and make scripts hard to maintain. Please consider changing alias to its full content.
    1 Function 'New-AzureFunctionCode' has verb that could change system state. Therefore, the function has to support 'ShouldProcess'.
    1 File 'EasyAzureFunction.Module.Tests.ps1' uses Write-Host. Avoid using Write-Host because it might not work in all hosts, does not work when there is no host, and (prior to PS 5.0) cannot be suppressed, captured, or redirected. Instead, use Write-Output, Write-...
    1 Do not use wildcard or $null in this field. Explicitly specify a list for AliasesToExport.
    1 Invoke-Expression is used. Please remove Invoke-Expression from script and find other options instead.
    1 Do not use wildcard or $null in this field. Explicitly specify a list for FunctionsToExport.

Invoke-ScriptAnalyzer -path . -Recurse  | group scriptname | Select Count, Name | Sort Count -Descending

Count Name
----- ----
   16 run.ps1
    7 EasyAzureFunction.psm1
    3 Convert-ParametersToHTML.ps1
    3 Get-Parameter.ps1
    2 New-AzureFunctionCode.Tests.ps1
    2 Get-Parameter.Tests.ps1
    2 EasyAzureFunction.psd1
    2 Convert-ParametersToRunner.ps1
    1 EasyAzureFunction.Module.Tests.ps1
    1 CreateExamples.ps1
    1 New-AzureFunctionCode.ps1

Temporary disable PowerShell Core tests

Module inside of Azure function with arbitrary function

Not sure if this can be done...
New-AzFC should be executed inside of AzF and generated code displayed.

Investigate usage of HTML templates

For example strathbone/SimpleTemplates

Add Classes to separate folder

It requires module file .psm1 to be updated

Publish module with two digits version

Currently, it requires the module to have 3 digits in version, like 0.4.0 instead of 0.4. The issue is caused by nuget version 3.5, in version 2.8 issue is not there. I have downloaded proper version, just need to use it.

Add/find images how to create Azure Function

add links from readme to published commands

Add good example for PSCredentials

The function is working, but I am missing nice example. Command should have PSCredential object and it should connect to something. Optionally, I can run some commands before/after but this code will be fixed. User should enter some demo credentials and do something nice.

Investigate usage of other installed tools during build

Namely PowerShell Core and NuGet 2.8.6 should be used. They are already installed.

Review marking of mandatory parameters in HTML page

Currently, it displays only * for a mandatory parameter. It can be customizable, or it can be an image with an alt tag.

Rename tests to unique values

Combination Describe + It should be always unique, briefly rename add Describe to include function name

bump AppVeyor version after successful publishing

Currently, version is fixed in settings as 0.6.{build}. After successful publishing, script should update it to match new module settings

Move examples to dedicated page

#13

build order, image

Swap build order, first Linux, then Windows
Add image via online button generator (like imagefu.com, dabuttonfactory.com)

proper documentation test is not checking external help

Add support for complex objects, namely PSCredentials in Private functions

For example, PSCredentials can be parsed as username + password fields in index.html and in run.ps1 it will build PSCredentials from these two input values

remove trailing spaces from the code

prevent Publish fails on Linux host

use if $IsLinux to exit before that