This CLI tool is used to install, restore, update and remove includes/dependecies

Make sure to install .NET Runtime (minimum version 6.0)

If you are on Windows or Linux you can use the install-spm.ps1 script to install.
This needs both Powershell 7 and .NET Runtime installed.

1. download the latest script from Releases
2. move it into the directory where you want spm installed.
3. execute the install-spm.ps1 script (this will download and extract spm into the current directory and adds it to your PATH)

1. download the latest zip file matching your operation system from Releases
2. extract the zip into a directory
3. (optional, but recommended) add the directory to your PATH

spm should be run from the base folder of your plugin project.
Use the --working-directory option to run spm from an other directory.
You can use the --github-token option once to save a GitHubToken, that will be used to increase rate limits for the GitHub-API.

aliases: ls, l

lists all already installed includes. Reads the spm.json and outputs all installed includes with the specified Versionrange.

The includes are numbered in the output. These numbers can be used with spm remove to easily remove already installed includes.

Usage: spm list

aliases: i

installs a include file. Adding it to the spm.json and the spm.lock.json.

Following sub-commands are available when installing:

aliases: i ghtf

installs include-file from github identified by a git-tag.

Usage: spm install github-tag-file <owner> <repository> <versionRange> <assetName> [options]

Example: spm install github-tag-file nosoop tf2attributes 1.* tf2attributes.inc
installs the file tf2attributes.inc from the latest 1.* version of https://github.com/nosoop/tf2attributes/tags

aliases: i ghtz

installs include-file from a zip on github identified by a git-tag.

Usage: spm install github-tag-zip <owner> <repository> <versionRange> <assetName> <fileInZip> [options]

Example: spm install github-tag-zip nosoop SM-TFCustAttr 8.* package.zip scripting/include/tf_custom_attributes.inc
downloads the zip-file package.zip and extracts the file scripting/include/tf_custom_attributes.inc from the latest 8.* version of https://github.com/nosoop/SM-TFCustAttr/tags

aliases: i su

installs include-file from a static url. (Does not support versioning/updating.)

Usage: spm install static-url <url> [options]

Example: spm install static-url https://raw.githubusercontent.com/JoinedSenses/SourceMod-IncludeLibrary/master/include/morecolors.inc
installs morecolors.inc from https://raw.githubusercontent.com/JoinedSenses/SourceMod-IncludeLibrary/master/include/morecolors.inc

aliases: r

restores installed includes according to spm.json and spm.lock.json.
Will not update versions while the include-version is locked.

Used to bring the includes to the same version as your team/contributers.

Usage: spm restore

aliases: u

updates installed includes to the latest version according to spm.json.
Will ignore locks and update to the highest available version within the specified VersionRange for each include.

Usage: spm update

aliases: rm

removes a already installed include from disk, spm.json and spm.lock.json.

Usage: spm update <Id>

The <Id> can be either the Id or the Index of the include-file (both are output by spm list).

aliases: sl

displays copyright/license information.

Usage: spm show-license

These options can be used with any command

spm will look for spm.json in the current working directory. If spm.json is located in an other directory, use --working-directory <working-directory> to specify this directory.

spm will not change/create/delete any files, if --dry-run is specified.
Can be used to test to see what a certain command would do, if executed without --dry-run.

will be used to authenticate API calls, increasing the rate limit. Unauthorized calles are limited by GitHub to 60 requests per hour.
If git-credential-manager is installed, the token will be saved there after the first successful API call. So the token does not have to be provided for further spm executions.

By default only errors and the result of the executed command will be output. To output additional logging messages use the -v flags. Specifying more v's will increase the level at which log messages will be output (-vvvv being the most verbose).

spm install and spm update will lock the installed/updated version of the include-file, by writing them into a file called spm.lock.json.
This file is used to prevent unintended updates of the installed include-file version.
When executing spm restore include-files will be installed with the locked version, to make sure all contributers use the same version.
spm update is only used to update the used version of installed include-files (according to the VersionRange specified for the include-file) and write the new version to spm.lock.json.

Both spm.json and spm.lock.json should be added to your versioncontrol, to make sure other contributers will work with the same versions of include-files.

When installing a include you can specify a range of allowed versions.

This action restores include files defined in spm.json.

To use the GitHub Action, you'll need to add it as a step in your Workflow file.
restore is the default action for the GitHub Action, so no further configuration is needed:

on: push

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v1
      - uses: eisbaer66/spm@v1

You can set any or all of the following input parameters:

on: push

jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v1
      - uses: eisbaer66/spm@v1
        with:
          action: update
          working-directory: ./src
          verbosity: 4
          github-token: ${{ secrets.GITHUB_TOKEN }}

spm exposes some output variables, which you can use in later steps of your workflow. To access the output variables, you'll need to set an id for the spm step.

steps:
  - id: spm
    uses: eisbaer66/spm@v1
    
  - if: steps.spm.outputs.dependency-count != 0
    run: |
      echo "${{ steps.spm.outputs.message }}"
  
  - if: steps.spm.outputs.exit-code != 0
    run: |
      echo "restore failed with exit-code ${{ steps.spm.outputs.exit-code }}: ${{ steps.spm.outputs.message }}"

Copyright (C) 2022 icebear [email protected]

SourcePawnManager (spm) is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

SourcePawnManager (spm) is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more details.

You should have received a copy of the GNU Affero General Public License along with SourcePawnManager (spm). If not, see https://www.gnu.org/licenses/.