m-housh/swift-bump-version

Overview

Use the plugins by including as a package to your project and declaring in the plugins section of your target.

Note: You must use swift-tools version 5.6 or greater for package plugins and target macOS(.v10_15) or greater.

// swift-tools-version: 5.7

import PackageDescription

let package = Package(
  platforms:[.macOS(.v10_15)],
  dependencies: [
    ...,
    .package(url: "https://github.com/m-housh/swift-cli-version.git", from: "0.1.0")
  ],
  targets: [
    .executableTarget(
      name: "<target name>",
      dependencies: [...],
      plugins: [ 
        .plugin(name: "BuildWithVersionPlugin", package: "swift-cli-version")
      ]
    )
  ]
)

The above example uses the build tool plugin. The BuildWithVersionPlugin will give you access to a VERSION variable in your project that you can use to supply the version of the tool.

Example

import ArgumentParser

@main
struct MyCliTool: ParsableCommand { 
  static let configuration = CommandConfiguration(
    abstract: "My awesome cli tool",
    version: VERSION
  )

  func run() throws { 
    print("Version: \(VERSION)")
  }
}

After you enable the plugin, you will have access to the VERSION string variable even though it is not declared in your source files.

Documentation

You can view the latest documentation here.

Dependencies

This project relys on the following dependencies:

• swift-argument-parser
• swift-dependencies
• swift-shell-client

Package Metadata

Repository: m-housh/swift-bump-version

Default branch: main

README: README.md