This directory contains files related to distribution of Flood. Some are being used by continuous integration scripts of this project to release a certain version of Flood. Some are merely examples that have been created to make it easier for potential contributors to maintain a package of Flood for their distributions.

In general, Flood has two release channels: master and latest:

• master (rolling) channel is handled by CI scripts that are triggered whenever there is a push to master branch.
• latest (release) channel is versioned (eg. 4.0.0), in accordance with semver.

npm is the primary method of distribution. Flood is published to two packages:

• master -> npmjs.com/@jesec/flood
• latest -> npmjs.com/flood

Other distribution methods may rely on builds published on npm.

Flood uses pkg to generate self-contained executables that bundles Flood with Node.js runtime. Generated executables are published to two locations:

• master -> Github Actions (permalink via nightly.link)
• latest -> Github Releases

Other distribution methods may rely on generated standalone executables.

containers folder hosts files required to build a container image. Currently there are three variants that are published in two stages:

Variants:

• Default (latest, master, versioned tags): Node.js Current on Alpine Linux (parent image: node:alpine)
• Debugging (*-dbg): Node.js Current on Alpine Linux (parent image: node:alpine)
  • Contains full sources (not minimized) and development dependencies
• Distroless (*-distroless): Node.js Active LTS (no parent image)
  • Contains only flood and its runtime dependencies
  • No shell, no package manager, no libc, no coreutils

Stages:

• flood (jesec/flood)
• rtorrent-flood (jesec/rtorrent-flood)
  • Bundles rtorrent

shared folder hosts files that may be useful in a package, in addition to (at the root of project):

CHANGELOG.md
LICENSE
README.md
SECURITY.md

However, there might be more recent ones in user-contributed wiki of this project.

Notwithstanding GPL 3 license applied to other parts of this project, files in this folder are licensed under BSD 0-Clause License (SPDX: 0BSD), which is a public domain equivalent license.

Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted.

THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

TBD.

Contributions are welcome. There are many ways to contribute. For instance:

Add a link here if you are maintaining a package of Flood in the official repository of your distribution/platform, so people know there is such an option and may assist with your efforts.

Contribute the files needed to build a package for your distribution.

Tweak or add continuous integration workflows to support your distribution.