From d33fc4e59eca3c992c10ee91c4777136189ba552 Mon Sep 17 00:00:00 2001 From: Reza Date: Fri, 11 Sep 2026 18:19:52 +0200 Subject: [PATCH] Prepare 2.0.0 release candidate publishing --- .github/workflows/build-and-release.yml | 84 ++++++++++++++++- LICENSE | 2 +- README.md | 68 +++++++++++--- docs/PSDataverse-2-plan.md | 6 +- docs/releases/2.0.0-rc.1.md | 116 ++++++++++++++++++++++++ media/PSDataverse-GalleryIcon.png | Bin 0 -> 6746 bytes src/Module/PSDataverse.psd1 | 22 +++-- tests/PSDataverse.Module.Tests.ps1 | 50 ++++++++++ 8 files changed, 323 insertions(+), 25 deletions(-) create mode 100644 docs/releases/2.0.0-rc.1.md create mode 100644 media/PSDataverse-GalleryIcon.png diff --git a/.github/workflows/build-and-release.yml b/.github/workflows/build-and-release.yml index 0eabc16..e9f757d 100644 --- a/.github/workflows/build-and-release.yml +++ b/.github/workflows/build-and-release.yml @@ -4,7 +4,7 @@ on: workflow_dispatch: inputs: publish: - description: Publish the verified release candidate to PowerShell Gallery + description: Publish to PowerShell Gallery and create a tagged GitHub prerelease required: true type: boolean default: false @@ -16,8 +16,8 @@ jobs: verify-release-candidate: uses: ./.github/workflows/verify-package.yml - publish: - name: Publish the verified artifact + publish-gallery: + name: Publish the verified artifact to PowerShell Gallery if: ${{ inputs.publish && github.ref == 'refs/heads/main' }} needs: verify-release-candidate runs-on: ubuntu-latest @@ -45,6 +45,9 @@ jobs: env: POWERSHELL_GALLERY_API_KEY: ${{ secrets.POWERSHELL_GALLERY_API_KEY }} run: | + if ([string]::IsNullOrWhiteSpace($env:POWERSHELL_GALLERY_API_KEY)) { + throw 'POWERSHELL_GALLERY_API_KEY is not configured in the PowerShell Gallery environment.' + } $package = @(Get-ChildItem ./output/packages -Filter '*.nupkg' -File) $checksum = @(Get-ChildItem ./output/packages -Filter '*.sha256' -File) if ($package.Count -ne 1 -or $checksum.Count -ne 1) { @@ -60,3 +63,78 @@ jobs: -Force Publish-PSResource -NupkgPath $package[0].FullName ` -Repository PSGallery -ApiKey $env:POWERSHELL_GALLERY_API_KEY + + publish-github-release: + name: Create the GitHub prerelease + if: ${{ inputs.publish && github.ref == 'refs/heads/main' }} + needs: publish-gallery + runs-on: ubuntu-latest + permissions: + contents: write + + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Download validated package + uses: actions/download-artifact@v4 + with: + name: PSDataverse-2-rc + path: output/packages + + - name: Read release identity + id: release + shell: pwsh + run: | + $package = @(Get-ChildItem ./output/packages -Filter '*.nupkg' -File) + $checksum = @(Get-ChildItem ./output/packages -Filter '*.sha256' -File) + if ($package.Count -ne 1 -or $checksum.Count -ne 1) { + throw 'The validated artifact must contain one package and one checksum.' + } + $expectedHash = ((Get-Content $checksum[0].FullName -Raw) -split '\s+')[0] + $actualHash = (Get-FileHash $package[0].FullName -Algorithm SHA256).Hash + if ($actualHash -ne $expectedHash) { + throw "Package checksum mismatch: expected $expectedHash; got $actualHash." + } + + $archive = [IO.Compression.ZipFile]::OpenRead($package[0].FullName) + try { + $nuspecEntry = @($archive.Entries | Where-Object FullName -Like '*.nuspec') + if ($nuspecEntry.Count -ne 1) { + throw "Expected one nuspec; found $($nuspecEntry.Count)." + } + $reader = [IO.StreamReader]::new($nuspecEntry[0].Open()) + try { [xml]$nuspec = $reader.ReadToEnd() } finally { $reader.Dispose() } + } + finally { + $archive.Dispose() + } + + $name = [string]$nuspec.package.metadata.id + $version = [string]$nuspec.package.metadata.version + if ($name -ne 'PSDataverse' -or $version -notmatch '-') { + throw "Expected a PSDataverse prerelease package; found '$name' '$version'." + } + $notesPath = "docs/releases/$version.md" + if (!(Test-Path -LiteralPath $notesPath -PathType Leaf)) { + throw "Release notes '$notesPath' were not found." + } + + "version=$version" >> $env:GITHUB_OUTPUT + "tag=v$version" >> $env:GITHUB_OUTPUT + "package=$($package[0].FullName)" >> $env:GITHUB_OUTPUT + "checksum=$($checksum[0].FullName)" >> $env:GITHUB_OUTPUT + "notes=$notesPath" >> $env:GITHUB_OUTPUT + + - name: Create tagged GitHub prerelease + shell: pwsh + env: + GH_TOKEN: ${{ github.token }} + run: | + gh release create '${{ steps.release.outputs.tag }}' ` + '${{ steps.release.outputs.package }}' ` + '${{ steps.release.outputs.checksum }}' ` + --title 'PSDataverse ${{ steps.release.outputs.version }}' ` + --notes-file '${{ steps.release.outputs.notes }}' ` + --target '${{ github.sha }}' ` + --prerelease diff --git a/LICENSE b/LICENSE index f627ad5..4c227ab 100644 --- a/LICENSE +++ b/LICENSE @@ -1,6 +1,6 @@ MIT License -Copyright (c) 2022 Reza Niroomand +Copyright (c) 2022-2026 Reza Niroomand Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/README.md b/README.md index fed04b7..c3bede2 100644 --- a/README.md +++ b/README.md @@ -1,4 +1,24 @@ -# Table of Contents +# PSDataverse + +![PSDataverse logo](media/PSDataverse-Logo.png) + +[![PowerShell Gallery](https://img.shields.io/powershellgallery/v/PSDataverse?include_prereleases&label=PowerShell%20Gallery)](https://www.powershellgallery.com/packages/PSDataverse) +[![Downloads](https://img.shields.io/powershellgallery/dt/PSDataverse)](https://www.powershellgallery.com/packages/PSDataverse) +[![Build and test](https://github.com/rezanid/PSDataverse/actions/workflows/build-and-test.yml/badge.svg?branch=main)](https://github.com/rezanid/PSDataverse/actions/workflows/build-and-test.yml) +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) + +High-performance, pipeline-friendly PowerShell access to Microsoft Dataverse. + +> [!IMPORTANT] +> PSDataverse `2.0.0-rc.1` 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 +[complete command reference](docs/reference/README.md), and the +[measured write-transport guide](docs/guides/choosing-a-write-transport.md). + +## Table of Contents * [What is PSDataverse](#what-is-psdataverse) * [Features](#features) * [How to install](#how-to-install) @@ -7,26 +27,46 @@ * [Sending operations to Dataverse](#sending-operations-to-dataverse) # What is PSDataverse? -PSDataverse is a PowerShell module that brings Dataverse's Web API to PowerShell 7+ with features like piping, batching and more. It is designed with ease-of-use and performance in mind and follows the patterns of native PowerShell cmdlets to play nicely with other modules. - -> [!IMPORTANT] -> PSDataverse 2 modernization is in progress. See the [implementation plan](docs/PSDataverse-2-plan.md) and [0.x migration guide](MIGRATION.md). The current development build requires PowerShell 7.6 or later. +PSDataverse brings Microsoft Dataverse's Web API to PowerShell with secure +authentication, first-class connection objects, controlled concurrency, batching, +bulk operations, and commands designed for composition in PowerShell pipelines. The [command reference](docs/reference/README.md) is the source for the detailed help packaged with the module and lists its syntax, examples, pipeline support, and aliases. For write-heavy workloads, see [choosing a write transport](docs/guides/choosing-a-write-transport.md). # Features -* Securely connect to Dataverse. -* Supports batching. -* Supports parallelism. -* Automatically reconnects when authentication token is about to expire. -* Enhanced pipeline support (accepts different data types as input and emits responses to the pipeline). -* Automatic wait-and-retry for transient errors by default. -* Respects throttling data sent by Dataverse. -* Does not hide the response sent back by Dataverse. +* Authenticate with WAM, system browser, device code, IWA, client secrets, + certificates, access tokens, token providers, or compatible connection strings. +* Keep named Dataverse connections and choose an explicit default connection. +* Run individual requests through a bounded, cancellation-aware parallel scheduler. +* Send concurrent `$batch` envelopes or CreateMultiple, UpdateMultiple, and + UpsertMultiple workloads with explicit chunking and degree of parallelism. +* Use pipeline-friendly CRUD, metadata, action/function, import, and export commands. +* Honor Dataverse concurrency hints and transient retry guidance while avoiding + unsafe automatic replay of ambiguous writes. +* Diagnose failed batch and multiple-operation rows without hiding Dataverse's + original response. +* Run the same verified package on Windows, Linux, and macOS. # How to install -You can install the [PSDataverse module directly from PowerShell Gallery](https://www.powershellgallery.com/packages/PSDataverse) using the following command + +Install the PSDataverse 2 release candidate from +[PowerShell Gallery](https://www.powershellgallery.com/packages/PSDataverse) with +PSResourceGet: + +```powershell +Install-PSResource -Name PSDataverse -Version 2.0.0-rc.1 -Prerelease +``` + +Or use PowerShellGet: + +```powershell +Install-Module -Name PSDataverse -RequiredVersion 2.0.0-rc.1 -AllowPrerelease +``` + +The following command continues to install the latest stable 0.x release until +PSDataverse 2 reaches general availability: + ```powershell Install-Module -Name PSDataverse ``` diff --git a/docs/PSDataverse-2-plan.md b/docs/PSDataverse-2-plan.md index 5917df6..962731e 100644 --- a/docs/PSDataverse-2-plan.md +++ b/docs/PSDataverse-2-plan.md @@ -83,7 +83,7 @@ The read-only and disposable-table write results are recorded in `docs/benchmark - [x] Detect and report whether a table supports each multiple-operation message before sending a large workload. - [x] Complete command help, measured transport recommendations, and the 0.x-to-2.x migration guide. - [x] Produce and verify deterministic prerelease packages, including installation from a local PowerShell repository. -- [ ] Run the release-candidate package on Windows, Linux, and macOS with PowerShell 7.6. +- [x] Run the release-candidate package on Windows, Linux, and macOS with PowerShell 7.6. Milestone 4 is complete when the .NET 10 package passes unit, packaged-module, integration, vulnerability, deterministic-build, and cross-platform PowerShell 7.6 @@ -137,6 +137,10 @@ PSResourceGet repository into an isolated module path and smoke-tested with PowerShell 7.6. The manual release workflow uploads this verified artifact and can publish only that same file through an explicit workflow input. +The release-candidate workflow passed on Windows, Linux, and macOS in both pull +request verification and the post-merge `main` run on September 11, 2026. This +completed Milestone 4. + ## Compatibility policy - Preserve concepts and common scripts where doing so does not retain a defect or insecure behavior. diff --git a/docs/releases/2.0.0-rc.1.md b/docs/releases/2.0.0-rc.1.md new file mode 100644 index 0000000..46f6bd7 --- /dev/null +++ b/docs/releases/2.0.0-rc.1.md @@ -0,0 +1,116 @@ +# PSDataverse 2.0.0-rc.1 + +PSDataverse 2 is a substantial modernization of the high-performance PowerShell +module for Microsoft Dataverse. This release candidate keeps the recognizable +low-level Web API model while adding safer authentication, first-class connections, +bounded concurrency, structured diagnostics, and a broad PowerShell-native command +surface. + +This is a public prerelease. Please test important automation in a non-production +environment and report feedback through +[GitHub Issues](https://github.com/rezanid/PSDataverse/issues). + +## Install + +PSDataverse 2 requires PowerShell 7.6 or later. + +```powershell +Install-PSResource -Name PSDataverse -Version 2.0.0-rc.1 -Prerelease +``` + +PowerShellGet users can install it with: + +```powershell +Install-Module -Name PSDataverse -RequiredVersion 2.0.0-rc.1 -AllowPrerelease +``` + +Review the [0.x migration guide](https://github.com/rezanid/PSDataverse/blob/main/MIGRATION.md) +before upgrading existing automation. + +## Highlights + +### Authentication and connections + +- Interactive authentication uses Windows Web Account Manager where available and + the system browser elsewhere, including passwordless and passkey experiences + offered by the identity platform. +- Device code, Integrated Windows Authentication, client secret, certificate, + supplied access token, token provider, and compatible legacy connection-string + flows are supported. +- Connections are first-class objects. Scripts can create, inspect, select, switch, + refresh, and dispose named connections without relying on undocumented globals. +- Concurrent requests coalesce token refresh instead of acquiring duplicate tokens. + +### Performance without hidden semantics + +- A bounded `System.Threading.Channels` scheduler replaces polling-based task + coordination and provides backpressure, cancellation, response-order controls, + and explicit degrees of parallelism. +- Individual requests, concurrent `$batch` envelopes, and CreateMultiple, + UpdateMultiple, and UpsertMultiple remain explicit choices because they have + different ordering, transaction, and failure semantics. +- Dataverse `x-ms-dop-hint` and `Retry-After` guidance are respected. +- Ambiguous writes are not silently replayed. +- Multiple-operation capability checks are cached per connection and avoid sending + large unsupported workloads. + +In the disposable test environment, five concurrent 20-operation batch envelopes +reached a median 165.52 POST operations/second, versus 57.76 for individual requests +at DOP 20. Two concurrent 50-row bulk envelopes reached a median 131.85 PATCH +operations/second, versus 51.12 for individual requests at DOP 20. These measurements +are workload-specific starting points, not universal defaults. See the +[benchmark and methodology](https://github.com/rezanid/PSDataverse/blob/main/docs/benchmarks/2026-09-org8848d2a1.md) +and [transport-selection guide](https://github.com/rezanid/PSDataverse/blob/main/docs/guides/choosing-a-write-transport.md). + +### PowerShell-native commands + +- `Invoke-DataverseRequest` is the preferred low-level command; + `Send-DataverseOperation` remains as a compatibility alias. +- New commands cover connection inspection, WhoAmI testing, row CRUD, table + metadata and provisioning, actions and functions, CSV/JSON import and export, + and Dataverse multiple-operation messages. +- Every exported command ships with generated, schema-validated external help, + examples, pipeline metadata, and an online Markdown reference. + +### Actionable failures and safer behavior + +- Batch responses are parsed deterministically, including malformed proxy bodies, + mixed line endings, duplicate headers, throttling responses, and failed content + IDs. +- Multiple-operation failures identify the failed chunk, source row range, retained + input objects, failed content IDs, and successful sibling chunks without exposing + row contents in the displayed error message. +- Cancellation flows through requests, pagination, batches, retry delays, and + scheduler waits. +- Successful non-200 responses retain their bodies and content headers. +- Long-standing defects in change-set removal, row counts, option-set export, and + connection isolation are corrected. + +## Runtime and release quality + +- Targets .NET 10 and requires PowerShell 7.6. +- Supports Windows, Linux, and macOS; Integrated Windows Authentication remains + available for compatible federated identities, while WAM is recommended for + managed Entra identities on Windows. +- Removes the unused Scriban/Humanizer feature and dependencies. +- Builds twice from clean Release directories and requires matching module-file and + canonical package hashes. +- Installs the generated package through an isolated local repository and smoke-tests + it outside the source tree. +- Passes .NET tests, packaged Pester tests, static analysis, dependency vulnerability + auditing, guarded live Dataverse integration tests, and PowerShell 7.6 package + installation on Windows, Linux, and macOS. + +## Breaking changes + +- PowerShell 5.1 and PowerShell 7.4 are not supported by the PSDataverse 2 binary. +- Scripts should retain and pass the connection returned by `Connect-Dataverse` + instead of reading undocumented global variables. +- New scripts should choose an explicit authentication flow. +- Write replay, output ordering, and concurrency are more explicit to avoid hidden + correctness risks. +- The unexported experimental `Connect-DataverseNew` and unused Scriban-based + `ConvertTo-CustomText` implementation were removed. + +The complete compatibility table and runnable replacements are in the +[migration guide](https://github.com/rezanid/PSDataverse/blob/main/MIGRATION.md). diff --git a/media/PSDataverse-GalleryIcon.png b/media/PSDataverse-GalleryIcon.png new file mode 100644 index 0000000000000000000000000000000000000000..bb87a619efa0e42a67110e7340f104efe017fe79 GIT binary patch literal 6746 zcmYjWbyO5UwrIr??J6x7#X(XgWx>H2DyK^b&?q=z3k&=*Zlw662-*?`5 z?~j?e_nbKs_ul!l&gWT4Nj=Dz}X@mvdBmFPV;$SzQ@6jIeB z<-xOpW+|y8iG)-ei+yj5{;Xp<%IUfwA>sA?E676*C1yxS_g>I09 zd%#m#$Rx4**XO6po-(5cqoeUn?t)kD-XFy@vt4KLKRGTxT~1p~EiACq)8NF#T)`}g z#{VZe<=);|Hkzxsee#ynoD;DE~8eNH%#^7HaBQ@fsUExTHxV#WSqeVZ~EOy{iH zI1Y9=A4y%`tdG>bxGVZ3aC3!!yEPiyaz3GQ`+LR6@#4_U*X?TY36tZq2bK2Yop9A& zx!MeXw5ZVo>oaHh4FSSypSjA)iKW!Ov=w#Za?i+gu!4-+%8`p03%wA^l9ioJzW#<(OB?*kAB~JmyQQ_Yw@*5JxMb7w;k?}n)lp&1Q)7Q0MsKum z%k3xMzAk_Q#=y8dc)+1NKH02bs-v=GO#6JZ*Mq67tXxxj+BbQUnfv&q4R%sIJtIB9 z?l!lvQu#Wo`#1eImf-QRtsD8RwiII`yvg6ckv&x;%jVyv+9^kU~u4b7aExT>FMoVG1j5?1PhFH zMlH`iMXS*&BPLrQ@bLlRgc=u*8X?6PDg_FROvK@cSuKFK(jR*)uh;LHz5fZufs&gk zL*-72;+6%acbS97@5FDr$98I(o29LE1V$;o%(gW}OKIm9l+-c6NO}@Fl53hyO&w{t zx#EEkQ0Tk?a=V1bCH5bgGb@Kn`DSb&+oqg2IyAjf!p3 zNs<2S?e8I7;%Z9Sp8(dQdc*F_UysQr3<2N9XUXIcrZ)Och`xUk!lhj?p>>IqVm!HD z4SRg}ySdbY#;fYD=VqBRoxIOnVymYZIKO=`Rr@I8Nt3O5!mP9enMlg02p~2+&wquC zA8h80lrw$~&PAif`RgiT;-3`}pNjtb^3`Lb*h}vFSs9$a-gNIDdC|q@q;zg*ML7K` z{$BRND@5kkQ0+B&!2pBsn5{$Mv(lq8li_Ku@3{c{e(dB{&@^i=nabqW3o?#^pe>w% zFcWzuMLdZ`9DljGzK`u5yf5X+M=fbZU(3z!vBqp_GtnP+5;NcQWUv$23N_*eij2BzEBdYoS!xUOaugDxX{Avu`cDV%pbA?;wA~Oymc5cdQ9@g zD;^0^B1z&seId-Y9s^tfY^>3MsM$R_6(Ju=_jjm<)&UiC1UdAQd&+oSe;KHEqBA%r z#>d~hL=chO?ckz1tk0~jxoj{aURxu0;bZ!quw})8Ou_8h)BU0p% zS%63mIo4eOw{0Aq6P3&%Bx?IEfqqL$D8EYi{q*1~IlJuWluy_08kgX_4#~jTemjGo@+VZHjxGU{VcdoO zV-8tBPwcEt6V?uQfL=HvXzo{0I6#z#w5sd$JuC8Sm14!*U`C{1%}Uc}JAu`%vOC{Z z_LQW}*qXn8qR|-D0ejZ{E)J~t8!<=L|M21MNGxVu9{3G{KmHU0A|(2aNu9M}Wt_&< z;3r4Y-cw!Q`8X?mn#ia;YQP>7%{?6LH2&5E1r9*m{RVn6Vn{5n*JKuqTK4T`msl^X zwrVbIakw&otO#W_t6SxZYDzl!+!ko2QR1Jy}G#&k)ck_^?5 zqn2V0&yrb!=qqf;y8RY|Ky=6lxjz1_d>cdwdeFDS;6w)ZX!MHPk~eYfHt7|jNW`a>E@U0qOVo2 zHF$=ddN<-vzlGva!lP7{F^h+=4^$Zu(%*BBwD0ntdg5P}*bkm$f|47jlS^6*_3vF} z6W{yo-jg(i^>F4->siI#25{xl5nR&@-sSIQ5oD_hStk&BnK9x)=Qx%_snD}z41o|c zx=8nrE;H_f#rbwWbQ*B0iR}j5uaqm=?%vw+#|-|`4Ke6VY~9?iwRn~IZktEitJe~j z{Qg1*%}6m6>OdqR+Z_oI#DgmWGDX`p3Bzr_iPexaOy8)3@F;@c#O{Js=fiI-z7&U$npszBpe)p&3YI^M} z;P#~sTK1br$vq|sK|a;Rduv9BtT^s+Gbm&BAGASEIz2S5ZhkaGiLq22j7`(q(~Mj5 zl12PVpC%j;Fw#-N584^Mws?|Je&t;qIoP(&ZwemaK#e~kZaN3#x@f|cKRR{PJnj63toQqJTzoj;XK{46br1ZM@5i;Snqer-yomnF-yU+u70 z*X4KDlr5<5%WDvm+OTO{Wr%lmxl1p8i&M44Cv&AZ8k=x*-SRz)G^@aGo1#X+?#xJd zJL>N*CPL=23IQunH zQHs4o7$8D@;AAf%0u?NEjb8uxGsn)f%w}e_5Sr6Qrq784!vX1;!1~{&Fwkv-m1od2n0T ziRd$di?6m%Q+zlO-(@$sB45wFrrJVwc^wo5;0*yzV5H2Ue1xDT85)71>f(Nw!XS^= zVZ;{O^4Y_UI+Hqq=0)YT4X*Eg%WFF&Rl=RGK%U16UzZZxOYis3o{T{+t!d8sG_HjQ zG4#ab1J}ceTS9O@x`9X@oG?c!_BqRJb=h1Qgs{p#czj<&e=i#wQpx@tj8Gr27d-3z zgHu<2Tp^<8@T}LiGErQO(ai~vFgZEcGfn4HQRA;1A2$ zeD{6tOy|--S3j0QUv5ht>P`MO(q*%Tg*4VOw8_#&SzsGuONV;7wEsr^hlbYB0k7xT zs|k{aNobSP_C{@DiJ7ebLjlPH!$M89&CEQN@Ey00w6_c2Z{e}?OUH!6^2G1t23`pm za2sU+kauV?QNEt}M#)J>y9t?9!7KiRC^~|TK0d3T!CWDJWVmmuPTx$EV_^MrHhy`Q zqev;$Md`tZ${2XhuaWa7nrO^pnplB&IO2n!?^H~nvoYF{ighZr-A%{!2SSY}$c%q^ z2W<++Z*z8oB36VO6zu7&;DFe=gdE8=Ck52_vJ^`Djb@k|3RIAWnmoqp>ZsQmPJ^2w zx6Oak38rVsnZ$!Iu*d4+KQvQvpQ-el{`pEfgBSLcN`=>Mzzw)BDNuyT^9Q{j_=~UpQrd$+jVVDPqZR?Xt_ulzv(kYxH8JjZh7x|y^$=WCqM=g&c1G)Z&2J1Nau-C~)zdI3O+v0&H z_sMXmnj3f7VD6Tte5?Y!)K&5d6UsuVCqr?={%+t5-)yy?}2rd0xf*38ky&BJ+C3THB(L8E>8?!$A)*Ax#ueNgk1zRO7TTz*Ko>LqeU01?^;1uTY^I!1p(B(0DrYYT~W-ilUUt|Lv$ z?ki{zYrn%S>%^#7?@-syJuHMmNMKCKWFFLP2_43QBe^6SFQDNh@m!e)7Pkl#Cub-@N1e$_ zDE>VV&-24rEf7Z_9c5>7Ca#_NM?`mEpePDTpsL0~&}>^fIH*cysB(0$Tm31X+l>)1 zt0+&iU=fCq>5jE?AV(UwcGA*NEdfaB+W^8 zQ(ScKpn^=!_7f&-w&U>Q-{@gN2{@6ioFZbDTpm|6!Z<2+uaKuq!z)H8lD`EPdH@M? zl8Sx>(kvRD7s%cv)xK=dR?gi0506=H;vYLar7@E$=~X7Sd35ixugPO08EvP&Fx;OU z1@(Q_G&(lrMC(C#i3i!n4*bBL<2u@|i38NDfZyNv(d04JT}Rryy(R(+_!nW3M?? z7^|A3-+Qlu-Db}2_Q@*BSpx}c!13M-$tJE>rwV9|>C(mz%@S$fyx?pzs1`gAt&Owqo>|qq*Hxig zOGq-%Xmgk{4d;a%orq@)Bm9>qmVVCFf;mg&<;v3a(8^h^tZaSpmbcT%oRm@i*VEXt z=WDDBfiV7+Io%-4=iQI@MYaqkQUG*zjl7Y<*Ha-;L;>hs<|(=eXCYC)u2d;B>6wvf zIf)6d?c)+)!mWB&AJ(qY!Z)wz{U$76VTpT!`Xn=9X-v<)NACJ zj^gPkixqOi2i{57l-6JJ{}z3|YkqzBVq)(fwaF`ENk+_(SxlX{{uL}of+xqRlI1a- zNb2-^^+r_9sW%-~YSpq$;DMj0xNRH0;{thWRJ-M-vgHD9Ml?Kg<$`Z6h_hwHSc7#- zUY0OHnc@V-H?J*FR(~plP$)r?t138lrV{z0qoQKa?dVuayV{lieZ(v_*q7QPhr~vO zWLIANEzs#c+{41WN`Al1O(bMIj&zwug%i1O;>YUW8Wy z48USD5lw8-=lOGeJ6pt;w%#%er9ad=jn2?&Z=MJ{N53RH_~oXv0P=6{6Vya8*W|#- zTzk1HtNDAJ4X1x3M|DZ0LlV_&w}Oiq5j@RcqlF#^jDPFa?*%*BN3JQfwlx$ebYQ3v znoX0deFk`UIyJIejwrl#LM@R}YR+jMm8Degl6J;=cKaw6|&l6${z&wZ7 zAzyt@6yrqV`99u_7zpN~48Tjy@zx`KV*&`_#f7Qq`izzTvsv0#yl z0XX0MnsA6aFPockH{5VvP!Y2=k=R+7MV}F^_e51>HHNA0r1B}DpMQ&n32#vPGaKPs z?<{io!_&d{H}re`(mn|7s+FKNzPy?`Zi#35QL<1|VKq;jg*YZ!0eN;mYEU1(FvCLk zmSv%ZTz-}HZ5J@r>Bs#7?2UX7#dTlBpf{aRCEP|{TxD)~qY!k|KH?~vMI-fwDQ@H? zjW99((u~Y7UcYn`Gs^FeD)vEVW}M>q?cmW#JnF1Y3I5+H(AVmT3<%?`zXydV5?|nILwhy)nQU-#AaMk<19OTD+}xj1 z|0m=t_EkVbSLw^L)ZiC%&l4vA4&r5o-J?Q|&tP%*7eTANcL7Ty(y1{W9UT|d`L98U zseb^PUna~`@|4D9jdi3FgyBu&x}H>z1La3Ypto!tIO1PMLGy{@Vc5}PA zsZHXXzR_y?jlAufMV>8=6a3#X>PiD?GvA;rHGCW{#*j|o2Gm(m4@-;CYPUI313HzT zzK@1}L8vctKvsP0wRmGl+lZ)klrqLHi{4%q58Cf}nKcBa_x{1hz6u1U)}@Woyl!<< zwfM9np4aV504PGxqOo&O1P*k^rS-~JIOhEjZ@>MW9~@G)xIH}^VPlXq1X zGLbzerGiiLuCk@`>Ac<6{ID97thdjjA{u<+gIDKp&cf^j#ePHm6@R_WXMVdHL3{FM7HH z9ZY|m#~*`0eosVx_=)H3>5n+mUNiZGYjEPXyu{?{mK&8f$^q9grAMbp_gc_Rkn832 z^V^|@rOf6rrhk^-^Fd87(&6)c;9vLpGyjJ_PFF%*4|nS=pUWv_HQ8;w&fXyD6}7AB z-B|Hwkw;R0W