mirror of
https://github.com/ivabus/pantry
synced 2024-11-30 12:15:06 +03:00
107 lines
3.3 KiB
Markdown
107 lines
3.3 KiB
Markdown
|
||
|
||
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`).
|
||
|
||
```sh
|
||
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:
|
||
|
||
```sh
|
||
./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
|
||
|
||
```sh
|
||
scripts/ls.ts | scripts/sort.ts | scripts/build.ts
|
||
```
|
||
|
||
## Typecheck
|
||
|
||
```sh
|
||
for x in scripts/*.ts src/app.ts; do
|
||
deno check --unstable --import-map=$SRCROOT/import-map.json $x
|
||
done
|
||
```
|
||
|
||
[pantry.zero]: ../../../pantry.zero
|
||
[pantry.extra]: ../../../pantry.extra
|
||
[`./projects/`]: ./projects
|
||
[IPFS]: https://ipfs.tech
|
||
[PAT]: https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token
|
||
[wiki]: ../../../pantry.zero/wiki
|
||
[discussion]: https://github.com/orgs/teaxyz/discussions
|