Package Exports

@ghost-fvtt/foundry-publish

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@ghost-fvtt/foundry-publish) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Foundry Publish

Foundry Publish is a CLI tool that developers can use to add new versions of their packages for Foundry Virtual Tabletop to the Package Administration.

Usage

You can run Foundry Publish with npx:

npx @ghost-fvtt/foundry-publish [options]

Alternatively you can install it globally and then execute it:

npm install -g @ghost-fvtt/foundry-publish
foundry-factory [options]

Options

In order to use Foundry Publish, you need to provide several parameters. They can be provided either as environment variables or as command line options, with one exception: For security reasons, the password required to authenticate with the Package Administration can only be provided as environment variable. Additionally, a couple of options can also be read from a manifest file.

Command Line Parameter	Environment Variable	Manifest Property	Description
`--changelogURL`	`FVTT_CHANGELOG_URL`	`changelog`	The URL of the changelog of the package version being published
`--compatibleCoreVersion`	`FVTT_COMPATIBLE_CORE_VERSION`	`compatibleCoreVersion`	The maximum version of the core Foundry software beyond which compatibility of the package is not guaranteed
`--manifestURL`	`FVTT_MANIFEST_URL`	`manifest`	The URL of the manifest of the package version being published
`--manifestPath`	`FVTT_MANIFEST_PATH`		A path to a manifest file to read information from
`--minimumCoreVersion`	`FVTT_MINIMUM_CORE_VERSION`	`minimumCoreVersion`	The minimum version of the core Foundry software which is required to use the package
`--packageID`	`FVTT_PACKAGE_ID`		The numeric ID of the package
`--packageVersion`	`FVTT_PACKAGE_VERSION`	`version`	The version of the package
	`FVTT_PASSWORD`		The password of the account for accessing the Foundry VTT administration page
`--username`	`FVTT_USERNAME`		The username of the account for accessing the Foundry VTT administration page

Development

Prerequisites

In order to build this project, recent versions of node and npm are required. We recommend using the latest lts version of node. If you use nvm to manage your node versions, you can simply run

nvm install

in the project's root directory.

You also need to install the project's dependencies. To do so, run

npm install

Building

You can build the project by running

npm run build

Alternatively, you can run

npm run build:watch

to watch for changes and automatically build as necessary.

Contributing

Contributions via pull requests are very welcome. If you find any issues, please report them in the issue tracker.

Licensing

This software project is licensed under the MIT License, a copy of which can be found under LICENSE.

Acknowledgment

This project is heavily based on eXaminator's foundry-auto-release. Thanks for the great work!