Added Country value to json files (issue #3)

Added code to generate output by location
Added IconUrl value to json files (issue #2)
Renamed 'Group Name' to Name in json files (Issue #10)
Archived previous json file versions
Updated README.md
Updated Build.ps1

Author: jdhitsolutions

New-LocationMarkdown.ps1

@@ -0,0 +1,70 @@
+#requires -version 5.0
+# generate a version of the user groups as a list in Markdown
+# grouped by country and state
+
+<#
+This script will create a markdown version of PowerShell user groups
+based on the json entries in the Data folder.
+#>
+
+[cmdletbinding(SupportsShouldProcess)]
+Param(
+    [ValidateNotNullOrEmpty()]
+    [ValidatePattern("\.md$")]    
+    [string]$OutputFile = "PowerShellGroupsbyLocation.md",
+    #the path to the folder with json data files
+    [string]$Path = ".\data",
+    [switch]$Passthru
+)
+
+$grouped = &$PSScriptRoot\get-uglist.ps1 -Path $path | 
+    Sort-Object -property Country, State, Name | 
+    Group-object -Property Country
+
+$md = @"
+# PowerShell Groups by Location
+
+"@
+
+foreach ($item in $Grouped) {
+    #strip off {} for country values with multiple entries like Australia,New Zealand
+    $name = $item.name -replace "{|}", ""
+    Write-Verbose "Processing $name" 
+    $md += "`n## $name`n"
+    
+    #group each user group by state
+    $states = $item.group | Group-Object -Property State
+    
+    foreach ($state in $states) {
+
+        if ($state.name -match "\w+") {
+            write-Verbose "Adding $($state.name)" 
+            $md += "`n### $($state.name)`n"
+        }
+        foreach ($group in $state.group) {
+            write-Verbose $group.name 
+
+            $group.psobject.properties.name | 
+                foreach-object { 
+                if ($group.$_ -is [array]) {
+                    $group.$_ = $group.$_ -join ","
+                }
+            }
+            $details = ($group | Select-Object -property Name, Owner, Location, WebSiteURL, Twitter, Email | Out-String).trim() -split "`n" 
+            foreach ($detail in $details) {
+  
+                $md += "`n$($detail.trim())  "
+            }
+            $md += "`n"
+        } #foreach state group
+    } #foreach group
+}
+
+$utc = &$PSScriptRoot\get-utc.ps1
+$md += "`n_Generated $($utc)_"
+
+$md | Out-File "$PSScriptRoot\$OutputFile" -Encoding utf8 -Width 80
+
+if ($Passthru) {
+    Get-Item -Path "$psscriptroot\$OutputFile"
+}

New-MarkdownList.ps1

@@ -21,23 +21,27 @@ $md = @"
 
 "@
 
-&$PSScriptRoot\get-uglist.ps1 -path $path| Sort-object -Property "Group Name" |
-foreach-object {
-    $md+= "`n## $($_.'Group Name'.trim())`n"
+&$PSScriptRoot\get-uglist.ps1 -path $path| Sort-object -Property Name |
+    foreach-object {
+    $md += "`n## $($_.Name.trim())`n"
     #define a variable for the processed group to make it easier to track
     $group = $_
     #test each property to see if the value is an array
     #and if so update the object with a comma separated string
     $group.psobject.properties.name | foreach-object { if ($group.$_ -is [array]) {$group.$_ = $group.$_ -join ","}}
-    $details = ($group | select-object -property * -exclude group*| out-string).trim() -split "`n" 
+    $details = ($group | select-object -property * -exclude Name | out-string).trim() -split "`n" 
     foreach ($detail in $details) {
 
-        $md+= "`n$($detail.trim())  "
+        $md += "`n$($detail.trim())  "
     }
-    $md+="`n"
+    $md += "`n"
 }
 
 $utc = &$PSScriptRoot\get-utc.ps1
-$md+="`n_Generated $($utc)_"
+$md += "`n_Generated $($utc)_"
 
-$md | Out-File "$PSScriptRoot\$OutputFile" -Encoding utf8
+$md | Out-File "$PSScriptRoot\$OutputFile" -Encoding utf8 -Width 80
+
+if ($Passthru) {
+    Get-Item -Path "$psscriptroot\$OutputFile"
+}

New-UserGroupEntry.ps1

@@ -24,17 +24,28 @@ Param(
     [alias("websiteURL")]
     [string[]]$URL,
     [Parameter(HelpMessage = "Enter the Twitter account(s) for the user group. Markdown is allowed", ValueFromPipelineByPropertyName)]
-    [string[]]$Twitter
+    [string[]]$Twitter,
+    [Parameter(HelpMessage = "Enter the Country for the user group.", ValueFromPipelineByPropertyName)]
+    [string]$Country = "USA",
+    [Parameter(HelpMessage = "Enter the postal code abbreviation for your state if in the USA.", ValueFromPipelineByPropertyName)]
+    [string]$State = "",
+    [Parameter(HelpMessage = "Enter url to an icon file or graphic for your group. It may be resized.", ValueFromPipelineByPropertyName)]
+    [string]$IconUrl = ""
+    
+
 )
 
 Process {
     [pscustomobject]@{
-        'Group Name' = $Name
-        Owner        = $owner
-        Location     = $Location
-        WebsiteURL   = $Url
-        Twitter      = $Twitter
-        Email        = $email
+        Name       = $Name
+        Owner      = $owner
+        Location   = $Location
+        WebsiteURL = $Url
+        Twitter    = $Twitter
+        Email      = $email
+        Country    = $Country
+        State      = $state
+        Icon       = $IconUrl
     } | Convertto-Json
 }
 

New-UserGroupMarkdown.ps1

@@ -18,21 +18,21 @@ Param(
 $md = @"
 # PowerShell User Groups
 
-|Group Name|Owner|Location|WebsiteURL|Twitter|Email|
-|----------|-----|--------|----------|-------|-----|
+|Name|Owner|Location|WebsiteURL|Twitter|Email|
+|----|-----|--------|----------|-------|-----|
 
 "@
 
 &$PSScriptRoot\get-uglist.ps1 -Path $path | 
     Sort-Object "Group Name" |
     foreach-object {
-    $md += "|{0}|{1}|{2}|{3}|{4}|{5}|`n" -f $_."Group Name", $($_.Owner -join ","), $_.location, ($_.WebSiteURL -join ","), $($_.Twitter -join ","), $($_.Email -join ",")
+    $md += "|{0}|{1}|{2}|{3}|{4}|{5}|`n" -f $_.Name, $($_.Owner -join ","), $_.location, ($_.WebSiteURL -join ","), $($_.Twitter -join ","), $($_.Email -join ",")
 }
 
 $md += 
 "`nList generated _$((Get-Date).toUniversaltime().DateTime) UTC_"
 
-$md | Out-file -FilePath "$psscriptroot\$OutputFile" -Encoding utf8
+$md | Out-file -FilePath "$psscriptroot\$OutputFile" -Encoding utf8 -Width 80
 
 if ($Passthru) {
     Get-Item -Path "$psscriptroot\$OutputFile"