mirror of
https://github.com/gui-cs/Terminal.Gui.git
synced 2025-12-26 07:47:54 +01:00
Add README.md for Scripts directory
This commit is contained in:
46
Scripts/README.md
Normal file
46
Scripts/README.md
Normal file
@@ -0,0 +1,46 @@
|
||||
## Development and Design-Time PowerShell Modules
|
||||
This directory contains PowerShell modules for use when working with Terminal.sln
|
||||
|
||||
### Purpose
|
||||
These modules will be modifed and extended as time goes on, whenever someone decides to add something to make life easier.
|
||||
|
||||
### Requirements
|
||||
These modules are designed for **PowerShell Core, version 7.4 or higher**, on any platform, and must be run directly within a pwsh process.\
|
||||
If you want to use them from within another application, such as PowerShell hosted inside VSCode, you must first run `pwsh` in that terminal.
|
||||
|
||||
As the primary development environment for Terminal.Gui is Visual Studio 2022+, some functionality may be limited, unavailable, or not work on platforms other than Windows.\
|
||||
Most should still work on Linux, however.\
|
||||
Functions which are platform-specific will be documented as such in their Get-Help documentation.
|
||||
|
||||
Specific requirements for each module can be found in the module manifests and will be automatically imported or, if unavailable, PowerShell will tell you what's missing.
|
||||
|
||||
### Usage
|
||||
From a PowerShell 7.4 or higher prompt, navigate to your Terminal.Gui repository directory, and then into the Scripts directory (the same directory as this document).
|
||||
|
||||
#### Import Module and Configure Environment
|
||||
Run the following command to import all Terminal.Gui.PowerShell.* modules:
|
||||
```powershell
|
||||
Import-Module ./Terminal.Gui.PowerShell.psd1
|
||||
```
|
||||
If the environment meets the requirements, the modules will now be loaded into the current powershell session and exported commands will be immediately available for use.
|
||||
|
||||
#### Getting Help
|
||||
All exported functions and commandlets are provided with full PowerShell help annotations compatible with `Get-Help`.
|
||||
|
||||
See [The Get-Help documentation at Microsoft Learn]([https://](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/get-help?view=powershell-7.4)) for Get-Help information.
|
||||
|
||||
#### Cleaning Up/Resetting Environment
|
||||
No environment changes made by the modules on import are persistent.
|
||||
|
||||
When you are finished using the modules, you can optionally unload the modules, which will also reset the configuration changes made on import, by simply exiting the PowerShell session (`exit`) or by running the following command:\
|
||||
**NOTE DIFFERENT TEXT FROM IMPORT COMMAND!**
|
||||
```powershell
|
||||
Remove-Module Terminal.Gui.PowerShell
|
||||
```
|
||||
|
||||
### LICENSE
|
||||
MIT License
|
||||
|
||||
Original Author: Brandon Thetford (@dodexahedron)
|
||||
|
||||
See COPYRIGHT in this directory for license text.
|
||||
Reference in New Issue
Block a user