Включение одного ps1 в другой?

Question

[NewDevLab]

Кто как подключает файлы без установки пакетов?
Самое универсальное, что сделал, это

.(Join-Path -Path (Split-Path $script:MyInvocation.MyCommand.Path -Parent) -ChildPath ".\any.ps1")

Хотелось бы

.(Join-Path -Path (Split-Path $script:MyInvocation.MyCommand.Path -Parent) -ChildPath ".\PS.Get-Include.ps1")
Get-Include ".\any1.ps1"
...
Get-Include ".\any2.ps1"

но область видимости, видимо, страдает от такого включения.
Может есть какой дефолтный пакет для подобного поведения или как?

Comments

[MaxKozlov]

А зачем это всё ?

[NewDevLab]

MaxKozlov, чтобы листинги сделать более читаемыми, определить зону ответственности, инкапсуляция, переиспользуемость. Зачем обычно в проекте не один исходный файл?

[MaxKozlov]

Так собственные модули для этого лучше подходят :)

но вопрос в том, зачем в одном скрипте вместо прямого запуска другого скрипта делать .dotsource ?

если у вас в одном файле одна функция - прямой запуск, если несколько - модуль
Если очень не хочется модуль - уже давно есть $PSScriptRoot вместо ковыряния с MyInvocation.MyCommand.Path

[NewDevLab]

MaxKozlov,
.dotsource в смысле вызова функции, а не просто подключения скрипта? чтобы вызывать функцию несколько раз.
на этапе разработки, модули же не удобно использовать. всё время публиковать? или как?
$PSScriptRoot ну хорошо, от этого легче?

т.е. вот ситуация, папка с какими-то библиотечными скриптами с функциями. откуда-то вызывается точка входа в эту папку, или несколько точек. скрипты должны работать. что не так?

[MaxKozlov]

- если скрипт - это скрипт с параметрами, его никто не мешает использовать "как функцию", вызывая точно также
- если же у тебя скрипт начинается с function ... - его суём в модуль

модули точно также можно копировать как и сами скрипты, куда-то их специально публиковать стоит только если нужно жёсткое версионирование.

всё что надо лежит в папочках рядом с профилем
структура такая:

WindowsPowerShell/
  Modules/
  Scripts/
  Microsoft.PowerShell_profile.ps1

при этом в профиле

$home = Split-Path $profile
$env:Path += (";{0}\Scripts" -f $home)

Всё чего бы хотелось - вызывается. Вся структура простым копированием может распространяться куда угодно

При этом модуль-склад может выглядеть как-то так

pomoika/
  assorted/
  pomoika.psd1 (содержимое опущено)
  pomoika.pm1:

Try {
    Get-ChildItem "$PSScriptRoot\assorted\*.ps1" -Exclude *.tests.ps1, *profile.ps1 | ForEach-Object {
        $Function = $_.Name
        . $_.FullName
    }
} Catch {
    Write-Warning ("{0}: {1}" -f $Function,$_.Exception.Message)
    Continue
}

тогда все функции можно просто скопом навалить в assorted как вам и хотелось, а вызываться они будут сами
единственный минус - в Get-Module pomoika -list не будет видно имён функций, в нём находящихся (но у вас их и так нигде не видно в существующей структуре)

распространять, повторюсь, можно простым копированием, как и ваши скрипты

[NewDevLab]

MaxKozlov, Спасибо, многого не знаю, помогаешь.
Насчёт подключения всех скопом я понял, но, по-моему, если обернуть это в функцию, то функции не будут доступны извне. У меня же сейчас так и сделано в Get-Include. И после этого извне функция не вызывается - не видна.
Ещё но
- пользовательский профиль не хочется трогать совсем, как и переменные окружения,
- скрипт не хотелось бы вызывать с аргументами командной строки.
Натолкнуло, Import-Module не видел, что его можно загружать по пути. Это наглядно.
Но функции из модуля не видятся, т.е.

Import-Module "$PSScriptRoot\PS.Get-Include.ps1"
Get-Include ".\Gui.Reset-Console.ps1"

Ошибка
Get-Include : Имя "Get-Include" не распознано как имя командлета, функции, файла сценария или выполняемой программы.

В чём особенность модуля и как сделать глобальную видимость?
условный пример.

[NewDevLab]

MaxKozlov, в принципе с $PSScriptRoot сделал всё изящней, типа так
."$PSScriptRoot\$pathToLibrary"
а Linux нас поддержит на этом пути?
я в смысле разделителя путей.

[MaxKozlov]

Линуксу, конечно, надо нечто другое, но всегда можно использовать Join-Path
пример psm1 части модуля я уже привёл, доложу ещё psd1
все закомментареные поля поскипаны для краткости

@{
ModuleVersion = '1.0'
GUID = '72d739dd-bddf-4d7c-a358-1a40e2ff961d'
Description = 'test module'
NestedModules = @('testmodule.psm1')
}

примеро функции, лежащей в папочке (assorted\get-tf1.ps1):

function get-tf1 {
  'tf1'
}

guid, естественно надо сделать свой через [guid]::NewGuid()

вот этих трёх файлов достаточно чтобы получить рабочий модуль (когда он загружен, даже все функции видны.)
А если он лежит в путях ($env:PSModulePath) ему даже import-module не обязательно делать

[NewDevLab]

MaxKozlov, я вот из этих соображений и делал Join-Path.
насчёт модулей, понял. пока не такой большой поток абстракций, чтобы так вот заморачиваться.
я бы считал этот весь диалог ответом.

[MaxKozlov]

Да всех заморочек на пару файлов :)
могу в качестве ответа оформить пример модуля

[NewDevLab]

давай, мы, русские, должны помогать друх друху.

Answer 1

[MaxKozlov]

Часто используемые функции можно сложить в модуль
Пример структуры:

MyUtils/
  MyUtils.psd1
  MyUtils.psm1
  functions/
    Get-Something.ps1
    Get-SomethingOther.ps1

Содержимое MyUtils.psd1, минимальный вариант. только заполненные поля

@{
  ModuleVersion = '1.0'
  GUID = '72d739dd-bddf-4d7c-a358-1a40e2ff961d'
  Description = 'MyUtils module'
  NestedModules = @('MyUtils.psm1')
}

Guid необходимо сгенерировать через [guid]::NewGuid()
Содержимое MyUtils.psm1

Try {
    Get-ChildItem "$PSScriptRoot\functions\*.ps1" -Exclude *.tests.ps1, *profile.ps1 |
    ForEach-Object {
      $Function = $_.Name
      . $_.FullName
    }
} Catch {
    Write-Warning ("{0}: {1}" -f $Function,$_.Exception.Message)
    Continue
}

Пример содержимого одной из функций

function Get-Something {
param(
  $parameter
)
  Write-Host "I'm Get-Something with $parameter"
}

Все дополнительные функции можно разрабатывать отдельно, а потом просто переносить в папку MyUtils\functions.
и они будут сами подключаться к модулю при его повторной загрузке вместе с powershell
или через Import-Module MyUtils -Force

Сам модуль в виде папки можно таскать простым копированием в одно из мест, определяемых через $env:PSModulePath

Comments

[NewDevLab]

спасибо