Merge pull request #54 from dataplat/unification-api-and-tokens

Unification api and tokens

Author: NowinskiK

.github/copilot-commit-message-instructions.md

@@ -3,6 +3,6 @@ Capitalize the subject/description line
 Do not end the subject line with a period
 Separate the subject from the body with a blank line
 Use the imperative mood in the subject line
-The subject line should be a single sentence with an action word and target with some reasoning add "for Pester Help Tests"
+The subject line should be a single sentence with an action word and a target with some reasoning for the change
 Use the body to explain what and why in a friendly kind manner
 Say thank you at the end of the message

.github/workflows/pr.yml

@@ -67,7 +67,7 @@ jobs:
       if: success() || failure()
   Test_Stage_test_windows_core:
     name: Windows (PowerShell)
-    runs-on: windows-2019
+    runs-on: windows-latest
     needs:
     - Build_Stage_Package_Module
     steps:
@@ -94,7 +94,7 @@ jobs:
       if: success() || failure()
   Test_Stage_test_windows_ps:
     name: Windows (Windows PowerShell)
-    runs-on: windows-2019
+    runs-on: windows-latest
     needs:
     - Build_Stage_Package_Module
     steps:

.vscode/settings.json

@@ -20,18 +20,19 @@
         "*.ps1xml": "xml"
     },
     "cSpell.words": [
-        "COMPANYNAME",
-        "ICONURI",
-        "LICENSEURI",
-        "PROJECTURI",
-        "RELEASENOTES",
+        "Balabuch",
         "buildhelpers",
+        "COMPANYNAME",
         "endregion",
         "gitversion",
         "icontains",
+        "ICONURI",
         "keepachangelog",
+        "LICENSEURI",
         "notin",
+        "PROJECTURI",
         "pscmdlet",
+        "RELEASENOTES",
         "steppable"
     ],
     "[markdown]": {

CHANGELOG.md

@@ -42,6 +42,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Removed unnecessary or duplicate functions (e.g., `Get-AllFabricDatasetRefreshes`, `Get-AllFabricCapacities`).
 - Removed obsolete scripts and commented-out configuration paths.
+- Removed `Invoke-FabricAPIRequest` and replaced it by `Invoke-FabricRestMethodExtended`
+- Removed `Confirm-FabricAuthToken` 
+- Renamed `Test-TokenExpired` to `Confirm-TokenState` and extended it using `EnableTokenRefresh` Feature Flag
+- Removed `Set-FabricApiHeaders` and merged the entire logic to `Connect-FabricAccount`
 
 ### Security
 

CONTRIBUTING.md

@@ -32,9 +32,9 @@ The workflow for using this and developing the code is shown below.
    Install-Module Microsoft.PowerShell.PSResourceGet -Force
    ```
 
-3. Develop your updates in the source directory
+3. Start a fresh new PowerShell session to avoid anythjing from your current working sessions to interfere with the module development and building. Develop your updates in the source directory.
 
-   You should also resolve all dependencies before you start developing. This will ensure that you have all the required modules installed and loaded into your session.
+You should also resolve all dependencies before you start developing. This will ensure that you have all the required modules, and only them, installed and loaded into your session.
 
    ```PowerShell
    .\build.ps1 -ResolveDependency -Tasks noop -UsePSResourceGet
@@ -83,7 +83,11 @@ The workflow for using this and developing the code is shown below.
    ```PowerShell
    ./build.ps1 -Tasks build,test
    ```
-8. Once you are ready to submit your changes for review please ensure that you update the `CHANGELOG.md` file with a summary of your changes. This is important as it helps us keep track of what has changed in the module and makes it easier for users to see what has been added or changed.
+   This will run all the tests in the `tests` folder and output the results to the console. If there are any issues with the code, they will be reported here.
+   
+8. It is always a good idea to develop in a brand new clean session and also once you have finished your changes, you should open a new session, build the module and run a few commands to ensure that everything is working as expected. This will help you catch any issues that may have been introduced during development and also make sure that you have not missed any dependancies.
+
+9. Once you are ready to submit your changes for review please ensure that you update the `CHANGELOG.md` file with a summary of your changes. This is important as it helps us keep track of what has changed in the module and makes it easier for users to see what has been added or changed.
 
    You can use the [Keep a Changelog](https://keepachangelog.com/en/1.0.0/) format for this.
 

README.md

@@ -66,12 +66,12 @@ Refer to the individual function documentation for detailed usage instructions.
 
 Every now and again the authentication token might time out. Run this to get a new one:
 ```powershell
-Set-FabricAuthToken
+Update-FabricToken
 ```
 
 If you want to change user context run this:
 ```powershell
-Set-FabricAuthToken -reset
+Connect-FabricAccount
 ```
 
 
@@ -89,10 +89,14 @@ Contributions to FabricTools are welcome.
 Please read [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to develop, test and the process for submitting pull requests to us.
 
 ## Authors
+_(in alphabetical order)_
 
+- **Tiago Balabuch** - *Huge contribution (90% functions)* - [tiagobalabuch](https://github.com/tiagobalabuch)
 - **Ioana Bouariu** - *Initial work* - [Jojobit](https://github.com/Jojobit)
 - **Frank Geisler** - *Author of RTI functions* - [Frank Geisler](https://github.com/Frank-Geisler)
 - **Kamil Nowinski** - *Refactoring, unification, further commands* - [NowinskiK](https://github.com/NowinskiK)
+- **Jess Pomfret** - *Automation, great experience with PowerShell* - [jpomfret](https://github.com/jpomfret)
+- **Rob Sewell** - *Automation/DevOps, Governance and experience brought from dbatools* - [SQLDBAWithABeard](https://github.com/SQLDBAWithABeard)
 
 See also the list of [contributors](https://github.com/dataplat/FabricTools/contributors) who participated in this project.
 
@@ -103,4 +107,5 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 ## Acknowledgments
 
 - GitHub Copilot and ChatGPT for helping with the documentation
-- [**Rui Romano**](https://github.com/RuiRomano) - His work on a [Fabric PowerShell module](https://github.com/RuiRomano/fabricps-pbip) has been included into this module with his permission. Thanks, Rui!
+- [**Rui Romano**](https://github.com/RuiRomano) - His work on a [Fabric PowerShell module](https://github.com/microsoft/Analysis-Services/tree/master/pbidevmode/fabricps-pbip) has been included into this module with his permission. Thanks, Rui!
+- [**Tiago Balabuch**](https://github.com/tiagobalabuch) and his phenomenal huge work that make this module more robust and very well organised.

RequiredModules.psd1

@@ -21,7 +21,7 @@
     'Sampler.GitHubTasks'       = 'latest'
     MarkdownLinkCheck           = 'latest'
     PSFramework                = 'latest'
-    'Az.Accounts'           = '4.2.0'
-    'Az.Resources'          = '6.15.1'
-    'MicrosoftPowerBIMgmt' = '1.2.1111'
+    'Az.Accounts'              = '5.0.0'
+    'Az.Resources'             = '6.15.1'
+    'MicrosoftPowerBIMgmt'     = '1.2.1111'
 }

build.yaml

@@ -104,7 +104,7 @@ Pester:
   #  - FunctionalQuality
   #  - TestQuality
   Tag:
-  CodeCoverageThreshold: 0.35 # 85 # Set to 0 to bypass
+  CodeCoverageThreshold: 0.30 # 85 # Set to 0 to bypass
   #CodeCoverageOutputFile: JaCoCo_$OsShortName.xml
   #CodeCoverageOutputFileEncoding: ascii
   # Use this if code coverage should be merged from several pipeline test jobs.
@@ -157,4 +157,3 @@ ChangelogConfig:
 GitConfig:
   UserName: Automation Bot
   UserEmail: [email protected]
-

helper/GetFunctionList.ps1

@@ -1,12 +1,25 @@
-$path = ".\FabricTools\public"
+$path = ".\source\public"
 $op = Get-ChildItem -Path $path -Recurse -Filter *.ps1 | Select-Object -ExpandProperty Name | Sort-Object
 #$op = $op | ForEach-Object { "        ""$_""," }
 $op | Out-File '.\Output\FunctionList-main-public.txt'
 
-$path = ".\FabricTools\tiago\public"
-$tp = Get-ChildItem -Path $path -Recurse -Filter *.ps1 | Select-Object -ExpandProperty Name | Sort-Object
-$tp | Out-File '.\Output\FunctionList-tiago-public.txt'
+# Author Table
+# This script generates a table of PowerShell script authors from the specified directory.
+$authorTable = @{}
+$op | ForEach-Object {
+    $file = $_.FullName
+    $name = $_.Name
+    $content = Get-Content $file
+    $authorLine = $content | Where-Object { $_ -match 'Author:\s*(.+)' } | Select-Object -First 1
+    if ($authorLine -match 'Author:\s*(.+)') {
+        $author = $matches[1].Trim()
+        $authorTable[$name] = $author
+    } else {
+        $authorTable[$name] = $null
+    }
+}
+$authorTable
 
-$common = Compare-Object -ReferenceObject $op -DifferenceObject $tp -IncludeEqual -ExcludeDifferent | Select-Object -ExpandProperty InputObject
-$common
-$common | Out-File '.\Output\FunctionList-public-collision.txt'
+## Not a singular name option for functions (#26)
+Get-Command -Module FabricTools |where Name -like '*s'
+Get-Command -Module FabricTools|ForEach-Object { $name = $_.Name; $_.Parameters.Values | Where Name -like '*s' | Select @{N='FunctionName';E={$Name}},Name}

source/FabricTools.psd1

@@ -18,13 +18,12 @@ ModuleVersion = '0.0.1'
 # CompatiblePSEditions = @()
 
 # ID used to uniquely identify this module
-GUID = '0ba3e49a-b47e-4beb-8434-5a34ad41ae72'
+GUID              = 'f2a0f9e6-fab6-41fc-9e1c-0c94ff38f794'
 
 # Author of this module
 Author            = 'The FabricTools Team'
 
-# Company or vendor of this module
- CompanyName       = 'fabrictools.io'
+CompanyName       = 'fabrictools.io'
 
 # Copyright statement for this module
 Copyright         = 'Copyright (c) 2025 by FabricTools Team'
@@ -56,7 +55,7 @@ PowerShellVersion = '5.1'
 
 # Modules that must be imported into the global environment prior to importing this module
 RequiredModules = @(
-    @{ ModuleName = 'Az.Accounts' ; ModuleVersion = '4.2.0' },
+    @{ ModuleName = 'Az.Accounts' ; ModuleVersion = '5.0.0' },
     @{ ModuleName = 'MicrosoftPowerBIMgmt.Profile' ; ModuleVersion = '1.2.1111' },
     @{ ModuleName = 'Az.Resources' ; ModuleVersion = '6.15.1' }
 )
@@ -131,10 +130,9 @@ PrivateData = @{
 } # End of PrivateData hashtable
 
 # HelpInfo URI of this module
-# HelpInfoURI = ''
+HelpInfoURI = 'https://www.github.com/dataplat/FabricTools'
 
 # Default prefix for commands exported from this module. Override the default prefix using Import-Module -Prefix.
 # DefaultCommandPrefix = ''
 
 }
-