mirror of
https://github.com/Grace-Solutions/PSMinIO.git
synced 2026-07-26 14:58:13 +00:00
PSMinIO Developer
3e4a7e0810
� PERMANENT THREADING KNOWLEDGE BASE:
✅ CREATED COMPREHENSIVE DOCUMENTATION:
• docs/POWERSHELL-THREADING-RULES.md - Complete threading guide
• Enhanced ThreadSafeProgressCollector with usage examples
• Added to project structure documentation
• Saved to AI memory for future reference
� CRITICAL RULES DOCUMENTED:
• PowerShell cmdlets can ONLY call Write-* methods from main thread
• Background threads must QUEUE updates, never call Write-* directly
• ProcessQueuedUpdates() must ONLY be called from main thread
• Common mistakes and error symptoms clearly identified
� DESIGN PATTERNS PROVIDED:
• Periodic processing pattern (every 1 second)
• Completion-based processing pattern
• Manual processing points pattern
• Correct Task.WaitAll usage with timeouts
� IMPLEMENTATION CHECKLIST:
• Pre-implementation checklist for new cmdlets
• Debugging tips and error identification
• Code examples for correct and incorrect patterns
• Testing guidelines for threading compliance
� PREVENTS FUTURE REGRESSIONS:
• Clear documentation of the 'golden rule'
• Examples of common threading violations
• Patterns for all background operation types
• Reference for all future PowerShell module development
This ensures we never repeat the same threading mistakes!
72 lines
2.7 KiB
PowerShell
72 lines
2.7 KiB
PowerShell
# PSMinIO Basic Operations Example
|
|
# This script demonstrates fundamental MinIO operations using PSMinIO
|
|
|
|
# Import the module
|
|
Import-Module ..\..\Module\PSMinIO\PSMinIO.psd1
|
|
|
|
# Example connection details (replace with your actual values)
|
|
$endpoint = "https://minio.example.com"
|
|
$accessKey = "your-access-key"
|
|
$secretKey = "your-secret-key"
|
|
|
|
try {
|
|
# Connect to MinIO server
|
|
$connection = Connect-MinIO -Endpoint $endpoint -AccessKey $accessKey -SecretKey $secretKey
|
|
"Connected to MinIO server: $endpoint"
|
|
|
|
# List all buckets
|
|
"Listing all buckets..."
|
|
$buckets = Get-MinIOBucket
|
|
$buckets | Format-Table Name, CreationDate, @{Name="Objects";Expression={"N/A"}}
|
|
|
|
# Create a new bucket
|
|
$bucketName = "example-bucket-$(Get-Date -Format 'yyyyMMdd-HHmmss')"
|
|
"Creating bucket: $bucketName"
|
|
New-MinIOBucket -BucketName $bucketName
|
|
|
|
# Verify bucket creation
|
|
if (Test-MinIOBucketExists -BucketName $bucketName) {
|
|
"✅ Bucket '$bucketName' created successfully"
|
|
}
|
|
|
|
# Create a sample file for upload
|
|
$sampleFile = "sample-document.txt"
|
|
"This is a sample document created on $(Get-Date)" | Out-File -FilePath $sampleFile -Encoding UTF8
|
|
|
|
# Upload the file
|
|
"Uploading file: $sampleFile"
|
|
$uploadResult = New-MinIOObject -BucketName $bucketName -Files $sampleFile
|
|
$uploadResult | Format-Table Name, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
|
|
|
|
# List objects in the bucket
|
|
"Listing objects in bucket '$bucketName':"
|
|
$objects = Get-MinIOObject -BucketName $bucketName
|
|
$objects | Format-Table Name, @{Name="Size";Expression={"$($_.Size) bytes"}}, LastModified
|
|
|
|
# Download the file
|
|
$downloadPath = "downloaded-$sampleFile"
|
|
"Downloading file to: $downloadPath"
|
|
$downloadResult = Get-MinIOObjectContent -BucketName $bucketName -ObjectName $sampleFile -FilePath $downloadPath
|
|
$downloadResult | Format-Table @{Name="LocalFile";Expression={$_.FilePath.Name}}, @{Name="Duration";Expression={$_.Duration}}, @{Name="Speed";Expression={$_.AverageSpeedFormatted}}
|
|
|
|
# Verify download
|
|
if (Test-Path $downloadPath) {
|
|
"✅ File downloaded successfully"
|
|
"Content: $(Get-Content $downloadPath)"
|
|
}
|
|
|
|
# Clean up
|
|
"Cleaning up..."
|
|
Remove-MinIOObject -BucketName $bucketName -ObjectName $sampleFile -Force
|
|
Remove-MinIOBucket -BucketName $bucketName -Force
|
|
Remove-Item $sampleFile, $downloadPath -Force -ErrorAction SilentlyContinue
|
|
|
|
"✅ Basic operations completed successfully"
|
|
|
|
} catch {
|
|
"❌ Error: $($_.Exception.Message)"
|
|
} finally {
|
|
# Clean up any remaining files
|
|
Remove-Item "sample-document.txt", "downloaded-sample-document.txt" -Force -ErrorAction SilentlyContinue
|
|
}
|