pantry/README.md

This pantry† represents the most essential open source packages in the world. We promise to prioritize fixes, updates and robustness for these packages. We will not lightly accept additions, and thus suggest submitting your pull request against pantry.extra first.

† see pantry.zero for “what is a pantry”

Use with tea/cli

tea/cli clones/updates this pantry and pantry.extra when installed with the installer or when you run tea --sync.

At this time pantries are not versioned.

Contributing

Firstly, clone this repository, you’ll edit files here.

Note that packages are split across multiple pantries, so to see the package.yml files for all your dependencies you may want to open another editor at ~/.tea/tea.xyz/var/pantry

Create new package.yml files namespaced as per our current patterns under the ./projects/ folder.

The package.yml format is not documented, but it is not complex, pick an existing entry for tips.

You should verify that your package builds before submitting it. At this time we require that we build all packages ourselves†. tea requires that packages are built to /opt to minimize potential build problems. You do not need to install tea to opt first, but you may need to make /opt writable first (sudo chmod g+w /opt).

export GITHUB_TOKEN=…   # you need a (zero permissions) [PAT]
export TEA_PREFIX=/opt
export TEA_PANTRY_PATH="$PWD"
./scripts/build.ts pkg.com
# ^^ you will need to have installed all dependencies *manually* first

Packages require a test YAML node. This script should thoroughly verify all the functionality of the package is working. You can run the test with:

./scripts/test.ts pkg.com

tea requires all packages be relocatable. Our CI will verify this for you. You can check locally by moving the installation from /opt to ~/.tea and running the test again.

† we intend to relax this and accept pre-built binaries from third parties however we will require third party verification for security reasons.

Now make a pull request! We’ll test on all platforms we support in the PR. If it passes both CI and review we’ll merge.

Packaging Guide

Our wiki is our packaging knowledge base. For other assistance, start a discussion.

After Your Contribution

We build “bottles” (tar’d binaries) and upload them to both our centralized bottle storage and decentralized IPFS.

tea automatically builds new releases of packages as soon as they are released (usually starting the builds within seconds). There is no need to submit PRs for updates.

 

Meta

Dependencies

Project	Version
deno.land	^1.27
tea.xyz	^0

Build All

scripts/ls.ts | scripts/sort.ts | scripts/build.ts

Typecheck

for x in scripts/*.ts src/app.ts; do
  deno check --unstable --import-map=$SRCROOT/import-map.json $x
done