MacOS Feedback Thread

[NukaCody]

I wanted to give this a whirl on a friday night with my MacOS. Understandably, i notice y'all are working on the docs. But here's my "user journey", I hope it helps. This is coming from someone closer to ansible.

1. The installation method on MacOS is via github, was looking for something similiar to powershell for example: brew install powershell/tap/dsc. Although since ./dsc v3 is not dependent on powershell, it may be confusing to put it under that name?

2. I was able to get it up and running (barring a few terminal color issues with the built-in mac terminal on a brand-new factory resetted mac)

$schema: https://raw.githubusercontent.com/PowerShell/DSC/refs/heads/main/schemas/v3/config/document.json
resources:
  - name: Install VSCode
    type: DSC.PackageManagement/Brew
    properties:
      packageName: visual-studio-code

  - name: Install Neovim
    type: DSC.PackageManagement/Brew
    properties:
      packageName: neovim

  - name: Install PowerShell
    type: DSC.PackageManagement/Brew
    properties:
      packageName: powershell/tap/powershell

./dsc config set -f dev-tools.dsc.yaml

3. I followed the getting started and listed out resources

./dsc resource list

Type                                        Kind      Version  Capabilities  RequireAdapter  Description                                                            
--------------------------------------------------------------------------------------------------------------------------------------------------------------------
DSC.PackageManagement/Brew                  Resource  0.1.0    gs----e-                      DSC resource to manage Homebrew packages                               
Microsoft.DSC.Debug/Echo                    Resource  1.0.0    gs--t---                                                                                             
Microsoft.DSC.Transitional/RunCommandOnSet  Resource  0.1.0    gs------                      Takes a single-command line to execute on DSC set operation            
Microsoft.DSC/Assertion                     Group     0.1.0    gs--t---                      `test` will be invoked for all resources in the supplied configuration.
Microsoft.DSC/Group                         Group     0.1.0    gs--t---                      All resources in the supplied configuration is treated as a group.     
Microsoft.DSC/Include                       Importer  0.1.0    gs--t---                      Allows including a configuration file with optional parameter file.    
Microsoft.DSC/PowerShell                    Adapter   0.1.0    gs--t-e-                      Resource adapter to classic DSC Powershell resources.                  
Microsoft/OSInfo                            Resource  0.1.0    g-----e-                      Returns information about the operating system.      

4. I wanted to start configuring powershell as my default shell and start writing some config files and that's probably where I got lost as in the getting started page, we reference WindowsPowershell but when listing the cross Platform Powershell

x@xs-MacBook-Pro DSC % ./dsc resource list --adapter Microsoft.DSC/Powershell

Type  Kind  Version  Capabilities  RequireAdapter  Description
--------------------------------------------------------------

I think the expectation is the same as in the getting started page linked for DSC v3.

dsc resource list --adapter Microsoft.Windows/WindowsPowerShell

Partial listing

Type                                                   Kind      Version  Caps      RequireAdapter
----------------------------------------------------------------------------------------------------
PSDesiredStateConfiguration/Archive                    Resource  1.1      gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/Environment                Resource  1.1      gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/File                       Resource  1.0.0    gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/Group                      Resource  1.1      gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/GroupSet                   Resource  1.1      gs--t---  Microsoft.Windo…
PSDesiredStateConfiguration/Log                        Resource  1.1      gs--t---  Microsoft.Windo…

I know you can send arbritrary commands with

./dsc resource schema --resource Microsoft.DSC.Transitional/RunCommandOnSet
$schema: http://json-schema.org/draft-07/schema#
title: RunCommandOnSet
type: object
required:
- executable
properties:
  arguments:
    title: The argument(s), if any, to pass to the executable that runs on set
    type: array
  executable:
    title: The executable to run on set
    type: string
  exitCode:
    title: The expected exit code to indicate success, if non-zero. Default is zero for success.
    type: integer
additionalProperties: false

I can always go down this path, but want to make sure I'm not missing anything