Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion MIGRATION.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ Test important automation in a disposable environment, especially scripts that
submit writes concurrently. PowerShell can keep the 0.x and 2.x module versions
installed side by side while you validate the migration.

The PSDataverse 2 release-candidate package is version `2.0.0-rc.1`. Because it is a
The PSDataverse 2 release-candidate package is version `2.0.0-rc1`. Because it is a
prerelease, include `-Prerelease` when discovering or acquiring it from a PowerShell
repository. Use `Import-Module PSDataverse -RequiredVersion 2.0.0` to make test
scripts select the 2.x base version explicitly.
Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,11 @@
High-performance, pipeline-friendly PowerShell access to Microsoft Dataverse.

> [!IMPORTANT]
> PSDataverse `2.0.0-rc.1` is a public release candidate requiring PowerShell
> PSDataverse `2.0.0-rc1` is a public release candidate requiring PowerShell
> 7.6 or later. It contains intentional breaking changes from 0.x; review the
> [migration guide](MIGRATION.md) before upgrading production automation.

See [what is new in PSDataverse 2.0.0-rc.1](docs/releases/2.0.0-rc.1.md), the
See [what is new in PSDataverse 2.0.0-rc1](docs/releases/2.0.0-rc1.md), the
[complete command reference](docs/reference/README.md), and the
[measured write-transport guide](docs/guides/choosing-a-write-transport.md).

Expand Down Expand Up @@ -55,13 +55,13 @@ Install the PSDataverse 2 release candidate from
PSResourceGet:

```powershell
Install-PSResource -Name PSDataverse -Version 2.0.0-rc.1 -Prerelease
Install-PSResource -Name PSDataverse -Version 2.0.0-rc1 -Prerelease
```

Or use PowerShellGet:

```powershell
Install-Module -Name PSDataverse -RequiredVersion 2.0.0-rc.1 -AllowPrerelease
Install-Module -Name PSDataverse -RequiredVersion 2.0.0-rc1 -AllowPrerelease
```

The following command continues to install the latest stable 0.x release until
Expand Down Expand Up @@ -131,7 +131,7 @@ To repeat only the repository acquisition and package smoke test:

```powershell
./tools/Test-PSDataversePackage.ps1 `
-PackagePath ./output/packages/PSDataverse.2.0.0-rc.1.nupkg
-PackagePath ./output/packages/PSDataverse.2.0.0-rc1.nupkg
```

The scripts use pinned build dependencies and do not install PSDataverse into the
Expand Down
6 changes: 3 additions & 3 deletions docs/releases/2.0.0-rc.1.md → docs/releases/2.0.0-rc1.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# PSDataverse 2.0.0-rc.1
# PSDataverse 2.0.0-rc1

PSDataverse 2 is a substantial modernization of the high-performance PowerShell
module for Microsoft Dataverse. This release candidate keeps the recognizable
Expand All @@ -15,13 +15,13 @@ environment and report feedback through
PSDataverse 2 requires PowerShell 7.6 or later.

```powershell
Install-PSResource -Name PSDataverse -Version 2.0.0-rc.1 -Prerelease
Install-PSResource -Name PSDataverse -Version 2.0.0-rc1 -Prerelease
```

PowerShellGet users can install it with:

```powershell
Install-Module -Name PSDataverse -RequiredVersion 2.0.0-rc.1 -AllowPrerelease
Install-Module -Name PSDataverse -RequiredVersion 2.0.0-rc1 -AllowPrerelease
```

Review the [0.x migration guide](https://github.com/rezanid/PSDataverse/blob/main/MIGRATION.md)
Expand Down
4 changes: 2 additions & 2 deletions src/Module/PSDataverse.psd1
Original file line number Diff line number Diff line change
Expand Up @@ -124,10 +124,10 @@ PrivateData = @{
IconUri = 'https://raw.githubusercontent.com/rezanid/PSDataverse/main/media/PSDataverse-GalleryIcon.png'

# ReleaseNotes of this module
ReleaseNotes = 'PSDataverse 2.0.0-rc.1 modernizes the module with PowerShell 7.6 and .NET 10, secure WAM/browser/device/IWA/application authentication, named connections, a bounded high-performance request engine, concurrent batch and multiple-operation APIs, convenient CRUD/metadata/import/export commands, structured errors, complete help, and cross-platform package verification. Migration guide: https://github.com/rezanid/PSDataverse/blob/main/MIGRATION.md. Full notes: https://github.com/rezanid/PSDataverse/releases/tag/v2.0.0-rc.1'
ReleaseNotes = 'PSDataverse 2.0.0-rc1 modernizes the module with PowerShell 7.6 and .NET 10, secure WAM/browser/device/IWA/application authentication, named connections, a bounded high-performance request engine, concurrent batch and multiple-operation APIs, convenient CRUD/metadata/import/export commands, structured errors, complete help, and cross-platform package verification. Migration guide: https://github.com/rezanid/PSDataverse/blob/main/MIGRATION.md. Full notes: https://github.com/rezanid/PSDataverse/releases/tag/v2.0.0-rc1'

# Prerelease string of this module
Prerelease = 'rc.1'
Prerelease = 'rc1'

# Flag to indicate whether the module requires explicit user acceptance for install/update/save
RequireLicenseAcceptance = $false
Expand Down
16 changes: 9 additions & 7 deletions tests/PSDataverse.Module.Tests.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,9 @@ Describe 'PSDataverse packaged module contract' {
$manifest = Test-ModuleManifest -Path $ModulePath
$manifest.PowerShellVersion | Should -Be ([version]'7.6')
$manifest.Version | Should -Be ([version]'2.0.0')
$manifest.PrivateData.PSData.Prerelease | Should -Be 'rc.1'
$manifest.PrivateData.PSData.Prerelease | Should -Be 'rc1'
$manifest.PrivateData.PSData.Prerelease |
Should -Match '^[A-Za-z][0-9A-Za-z]*$'
$manifest.PrivateData.PSData.Keys | Should -Not -Contain 'IsPrerelease'
Split-Path (Get-Module PSDataverse).Path -Parent |
Should -Be (Split-Path (Resolve-Path $ModulePath).Path -Parent)
Expand All @@ -65,9 +67,9 @@ Describe 'PSDataverse packaged module contract' {
$metadata.LicenseUri | Should -Match '^https://'
$metadata.IconUri | Should -Be `
'https://raw.githubusercontent.com/rezanid/PSDataverse/main/media/PSDataverse-GalleryIcon.png'
$metadata.ReleaseNotes | Should -Match '2\.0\.0-rc\.1'
$metadata.ReleaseNotes | Should -Match '2\.0\.0-rc1'
$metadata.ReleaseNotes | Should -Match '/MIGRATION\.md'
$metadata.ReleaseNotes | Should -Match '/releases/tag/v2\.0\.0-rc\.1'
$metadata.ReleaseNotes | Should -Match '/releases/tag/v2\.0\.0-rc1'
foreach ($tag in @(
'PSEdition_Core', 'Windows', 'Linux', 'macOS', 'Dataverse',
'PowerPlatform', 'Dynamics365', 'WebAPI', 'OAuth')) {
Expand All @@ -78,7 +80,7 @@ Describe 'PSDataverse packaged module contract' {
It 'keeps public release assets synchronized with the package version' {
$repositoryRoot = [IO.Path]::GetFullPath((Join-Path $PSScriptRoot '..'))
$iconPath = Join-Path $repositoryRoot 'media/PSDataverse-GalleryIcon.png'
$notesPath = Join-Path $repositoryRoot 'docs/releases/2.0.0-rc.1.md'
$notesPath = Join-Path $repositoryRoot 'docs/releases/2.0.0-rc1.md'
$readmePath = Join-Path $repositoryRoot 'README.md'

$iconPath | Should -Exist
Expand All @@ -94,12 +96,12 @@ Describe 'PSDataverse packaged module contract' {

$notesPath | Should -Exist
(Get-Content -LiteralPath $notesPath -Raw) |
Should -Match 'PSDataverse 2\.0\.0-rc\.1'
Should -Match 'PSDataverse 2\.0\.0-rc1'
$readme = Get-Content -LiteralPath $readmePath -Raw
$readme | Should -Match `
'Install-PSResource -Name PSDataverse -Version 2\.0\.0-rc\.1 -Prerelease'
'Install-PSResource -Name PSDataverse -Version 2\.0\.0-rc1 -Prerelease'
$readme | Should -Match `
'Install-Module -Name PSDataverse -RequiredVersion 2\.0\.0-rc\.1 -AllowPrerelease'
'Install-Module -Name PSDataverse -RequiredVersion 2\.0\.0-rc1 -AllowPrerelease'
}

It 'exports exactly the documented command surface' {
Expand Down
3 changes: 3 additions & 0 deletions tools/New-PSDataversePackage.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -46,6 +46,9 @@ $prerelease = [string]$manifest.PrivateData.PSData.Prerelease
if ([string]::IsNullOrWhiteSpace($prerelease)) {
throw 'The PSDataverse 2 package must have explicit prerelease metadata.'
}
if ($prerelease -notmatch '^[A-Za-z][0-9A-Za-z]*$') {
throw "Prerelease '$prerelease' is not supported by PowerShell Gallery. Use an ASCII letter followed only by ASCII letters or digits (for example, 'rc1'); periods and plus signs are not supported."
}
$packageVersion = "$($manifest.Version)-$prerelease"
$packageFileName = "PSDataverse.$packageVersion.nupkg"

Expand Down
Loading