0.0.5 • Published 5 months ago
cf-script v0.0.5
What is this ?
When working with cloudflare worker and cloudflare platform locally we don't have any easy way to directly access Worker bindings such has (kv, r2, d1, ...).
This is by the nature of the secure cloudflare design where the bindings are provided to the app and not directly accessible.
So cf-script allow to run piece of code (scripts) that have access to your local cloudflare worker bindings. This can allow you to:
- Run one time sql query against your D1 database
- List, debug, write value in your KV database
- Download a file from your R2 bucket
How To Use
1. Install
npm install cf-script # For local project install
# or
npm install cf-script -g # For global install2. Write your first script
In order to write script you need to create a new file either (.ts or .js) and make it export by default a function
export default (env, args) => {
console.log("Running script with following bindings ", env)
console.log("And following args ", args)
}3. Run your script
cf-script ./scripts/my-first-script.tsAnd that it 🎉
You can check examples in the /dogfood folder (including one using typescript)
CLI args
| Name | Description | Default | Example |
|---|---|---|---|
--env | Environment to run the script in | undefined (default wrangler env) | --env staging |
--wcp | Path to the wrangler config file | undefined (by default it will look for the closest one from cwd) | --wcp ./wrangler.toml |
--cwd | Current working directory | process.cwd() | --cwd ./my-project |
--sa | Args that will be passed to the executed script | undefined (no args) | --sa foo:bar or --sa foo:bar biz:baz |
Credits
This software uses the following open source packages:
License
MIT
GitHub @Thomascogez · X @Thomascogez