Merge pull request #1 from sqlcollaborative/master

Syncing master branch for my fork

.gitattributes

@@ -93,3 +93,11 @@ GNUmakefile       text
 *.PDF   diff=astextplain
 *.rtf   diff=astextplain
 *.RTF   diff=astextplain
+
+
+# linguist overrides
+*.cs linguist-language=C#
+*.ps1 linguist-language=Powershell
+*.psd1 linguist-language=Powershell
+*.psm1 linguist-language=Powershell
+*.sql linguist-language=TSQL

.github/FUNDING.yml

@@ -0,0 +1,6 @@
+# These are supported funding model platforms
+
+github: [potatoqualitee, wsmelton, Stuart-Moore, sanderstad]
+patreon: potatoqualitee
+open_collective: dbatools
+custom: paypal.me/potatoqualitee

.github/ISSUE_TEMPLATE/Bug_Report.md

@@ -0,0 +1,83 @@
+---
+name: "\U0001F41B Bug report"
+about: Found errors or unexpected behavior using dbatools module
+title: "[Bug]"
+labels: bugs_life
+assignees: ''
+
+---
+
+<!--
+🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨
+The core team may close bug reports that do not follow our provided template.
+
+The information we ask for helps to better troubleshoot the report. We release frequently and often, this information helps to resolve the issue more efficiently.
+-->
+
+### Report
+
+<!--
+Things to consider/verify:
+- Errors received are not related to permissions?
+- Have you tried the command using `powershell.exe`?
+- If `Copy-DbaDatabase`, can you replicate the problem with `Backup-DbaDatabase` and `Restore-DbaDatabase`?
+- `Copy-DbaDatabase` will not work in every environment and every situation.
+-->
+
+#### Host used
+
+- [ ] powershell.exe
+- [ ] ISE
+- [ ] VS Code
+- [ ] Other (please specify)
+
+#### Errors Received
+<!--
+🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨
+Run the command and paste the output of `$error[0] | select *` below
+-->
+
+```
+replace THIS text WITH the OUTPUT of -- $ERROR[0] | SELECT *
+```
+
+#### Steps to Reproduce
+
+<!--
+Provide a list of steps to reproduce and any code required. Sanitize code if needed.
+-->
+
+#### Expected Behavior
+
+<!--
+What did you expect to happen?
+-->
+
+#### Actual Behavior
+
+<!--
+What happened?
+-->
+
+### Environmental information
+
+🚨🚨🚨🚨🚨🚨🚨🚨🚨🚨
+Please provide the output of the below script
+
+```powershell
+[pscustomobject]@{
+'PowerShell Version' = $PSVersionTable.PSVersion.ToString()
+'dbatools latest installed' = (Get-InstalledModule -Name dbatools).Version
+'Culture of OS' = (Get-Culture)
+} | fl -force
+```
+
+#### SQL Server:
+
+```sql
+/* REPLACE WITH output of @@VERSION */
+```
+
+```sql
+/* REPLACE WITH output of @@LANGUAGE */
+```

.github/ISSUE_TEMPLATE/Feature_request.md

@@ -0,0 +1,26 @@
+---
+name: "\U0001F64B Feature request"
+about: Suggest an idea for this project
+title: ''
+labels: Feature
+assignees: ''
+
+---
+
+---
+name: Feature request/idea :bomb:
+about: Suggest a new feature or enhancement
+
+---
+
+### Summary of new feature
+
+* Clear/concise description of what the problem is that the new feature can solve.
+
+### Proposed technical details (if applicable)
+
+* e.g. Blog post reference that shows example code or functionality
+
+### Latest version of dbatools as of writing
+
+* Please provide the latest released version of dbatools module.

.github/ISSUE_TEMPLATE/Support_Question.md

@@ -0,0 +1,14 @@
+---
+name: "❓ Support Question"
+about: If you have a question you may try asking on StackExchange network or dbatools
+  channel in sqlcommunity.slack.com
+title: ''
+labels: Question
+assignees: ''
+
+---
+
+- Slack Community Channel: https://sqlcommunity.slack.com/messages/C1M2WEASG/ (get an invite: https://dbatools.io/slack/)
+- Documentation within the module: `Get-Help <command>`
+- Database Administrator on Stack Exchange network, dbatools tag: https://dba.stackexchange.com/questions/tagged/dbatools
+- StackOverflow dbatools tag: https://stackoverflow.com/questions/tagged/dbatools

.github/ISSUE_TEMPLATE/Thanks.md

@@ -0,0 +1,25 @@
+---
+name: "❤️ Say thank you"
+about: Tell us how you use dbatools & support our efforts in maintaining dbatools
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+# ❤️ I'm using dbatools
+
+If you (or your company) are using dbatools - please let us know. We'd love to hear from you!
+
+dbatools is a community driven project, which means it's not maintained by a company. If you would like to help dbatools - any of the following is greatly appreciated.
+
+- [ ] Give the repository a star ⭐️
+- [ ] Help out with issues
+- [ ] Review pull requests
+- [ ] Blog about dbatools
+- [ ] Make tutorials
+- [ ] Give talks
+- [ ] Support us on [https://opencollective.com/dbatools](https://opencollective.com/dbatools)
+- [ ] [Sponsor one of our developers](https://github.com/sqlcollaborative/dbatools?sponsor=1)
+
+Thank you! 💐

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,11 +1,17 @@
 <!-- Below information IS REQUIRED with every PR -->
 ## Type of Change
 <!-- What type of change does your code introduce -->
- - [ ] Bug fix (non-breaking change, fixes #<enter issue number>)
- - [ ] New feature (non-breaking change, adds functionality)
- - [ ] Breaking change (effects multiple commands or functionality)
+ - [ ] Bug fix (non-breaking change, fixes #<!--issue number--> )
+ - [ ] New feature (non-breaking change, adds functionality, fixes #<!--issue number--> )
+ - [ ] Breaking change (effects multiple commands or functionality, fixes #<!--issue number--> )
  - [ ] Ran manual Pester test and has passed (`.\tests\manual.pester.ps1)
+ - [ ] Adding code coverage to existing functionality
  - [ ] Pester test is included
+ - [ ] If new file reference added for test, has is been added to github.com/sqlcollaborative/appveyor-lab ?
+ - [ ] Nunit test is included
+ - [ ] Documentation
+ - [ ] Build system
+
 <!-- Below this line you can erase anything that is not applicable -->
 ### Purpose
 <!-- What is the purpose or goal of this PR? (doesn't have to be an essay) --> 
@@ -14,7 +20,7 @@
 <!-- How does this change solve that purpose -->
 
 ### Commands to test
-<!-- if these are the examples in the help just not it as such -->
+<!-- if these are the examples in the help just note it as such -->
 
 ### Screenshots
 <!-- pictures say a thousand words without typing any of it -->

.github/workflows/ci.yml

@@ -0,0 +1,17 @@
+name: CI
+on: [pull_request]
+
+jobs:
+  build:
+    name: Module imports on all platforms
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macOS-latest]
+
+    steps:
+    - uses: actions/checkout@v1
+    - name: Perform the import
+      shell: pwsh
+      run: Import-Module ./dbatools.psd1 -ErrorAction Stop; (Get-DbaManagementObject).LoadTemplate -ne $null

.github/workflows/stale.yml

@@ -0,0 +1,29 @@
+name: Mark stale issues
+
+on:
+  schedule:
+  - cron: "0 6 * * *"
+
+jobs:
+  stale:
+
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/stale@v3.0.9
+      with:
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        stale-issue-message: >
+          🚧🚨
+          This issue is being marked as stale due to 90 days of inactivity.
+          If you would like this issue to remain open:
+            * Verify the issue/bug is reproduced in the latest version of the module
+            * Verify the environmental info provided is still accurate
+            * Add any additional steps you followed to reproduce if necessary
+          🚨🚧
+          
+          ⌛️ This issue will be closed in 30 days ⌛️
+        stale-issue-label: stale
+        exempt-issue-labels: 'Feature,Documentation,Question,Confirmed,solution-provided'
+        days-before-stale: 90
+        days-before-close: -1

.gitignore

@@ -1,4 +1,4 @@
-dbatools-startmigration-transcript.txt
+dbatools-startmigration-transcript.txt
 dbatools-exceptions.txt
 *TempPoint*
 *.pssproj
@@ -8,13 +8,29 @@ dbatools-exceptions.txt
 *.psproj
 dbatools.psprojs
 
-# ignore library
-bin/dbatools.dll
-bin/dbatools.xml
-bin/dbatools.pdb
+# ignore the settings folder and files for Visual Studio
+.vs/*
 
 # VIM backup files
 *~
 
-# msbuild log file
-msbuild.log
+# msbuild log file and structured binary log file
+msbuild.log
+msbuild.binlog
+
+# Local constant file
+tests/constants.local.ps1
+
+# For those that want to use Docker images for testing
+# Integration with Docker requires the docker compose file to exist within the project folder
+docker-compose.yml
+
+### NCrunch ###
+# NCrunch
+*.ncrunch*
+_NCrunch_*
+*.crunch.xml
+*.ncrunchsolution*
+nCrunchTemp_*
+
+debug.log

.markdownlint.json

@@ -0,0 +1,7 @@
+{
+    "MD024": false,
+    "MD022": false,
+    "MD032": false,
+    "MD013": false,
+    "MD001": true
+}