https://github.com/hayd/deno-udd
Update Deno Dependencies - update dependency urls to their latest published versions
https://github.com/hayd/deno-udd
Last synced: about 1 year ago
JSON representation
Update Deno Dependencies - update dependency urls to their latest published versions
- Host: GitHub
- URL: https://github.com/hayd/deno-udd
- Owner: hayd
- License: mit
- Created: 2020-03-06T04:34:14.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-04-25T19:45:17.000Z (almost 2 years ago)
- Last Synced: 2025-03-29T14:07:31.952Z (about 1 year ago)
- Language: TypeScript
- Homepage:
- Size: 117 KB
- Stars: 331
- Watchers: 7
- Forks: 19
- Open Issues: 36
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-deno-cn - @hayd/deno-udd
- awesome-deno - udd - Update Deno dependencies: updates import statements to their latest published version. (Tools / Online Playgrounds)
- awesome-deno - udd - Update Deno dependencies: updates import statements to their latest published version. (Tools / XML)
- awesome-deno - udd - 更新Deno依赖：将导入语句更新为最新发布的版本。 (Uncategorized / Uncategorized)
- awesome-deno - udd - 自动更新依赖的工具，比如你导入的模块出了新版本，跑个命令就能一键升级，省得手动改版本号。 (核心模块与框架（按需求挑） / 开发工具（提升效率用）)
README
# Update Deno Dependencies
Run this script to update your dependency urls to their latest published
versions. Optionally run --test(s) to ensure that each dependency update is
non-breaking.
Note: udd is **fundamentally different** from something like npm or yarn. Other
tools do a "distributed update" i.e. _every user updates_ independently (and
potentially to untested versions/configurations of dependencies). With udd
precisely _one person updates_ (a maintainer), and they can ensure that the new
dependencies pass the test suite before commiting/releasing a new version. With
udd every user has a fixed version of the dependencies.
[Semantic versioning fragments](https://github.com/hayd/deno-udd#semantic-versioning)
are _purely_ a convenience for the maintainer, and do not affect users.
## Installation
Use deno
[`install`](https://deno.land/std/manual.md#installing-executable-scripts) to
install or update udd:
```sh
deno install -rf --allow-read=. --allow-write=. --allow-net https://deno.land/x/udd/main.ts
```
_You may need to include the deno bin directory in your PATH._
## Usage
For example, to update url imports inside `deps.ts` run:
```sh
udd deps.ts
```
To update all the ts files in your directory:
```sh
udd *.ts
```
To ensure that `deno test` is successful when updating each dependency:
```sh
udd deps.ts --test="deno test"
```
## Scheduled github action
You might like to use a [github action](https://docs.github.com/en/actions) to
execute udd each day, check whether there are dependency updates, and - if there
are - create a pull request to your repository.
As an example see the
[`.github/workflows/udd.yml`](https://github.com/hayd/deno-udd/blob/master/.github/workflows/udd.yml)
file in the udd repository.
_Thanks to [Eliaz Bobadilla](https://github.com/UltiRequiem) for the initial
action implementation._
## Semantic versioning
If you append a fragment `#${token}${version}` to your urls you can manage their
update behavior:
| Token | Name | udd updates to the latest version such that |
| :---- | :------------ | -------------------------------------------------------------: |
| ^ | Compatible | major version is the same (if major=0 then same minor version) |
| ~ | Approximately | major and minor version are the same (or both major=0) |
| < | Less than | less than the provided version |
| = | Equal | it's exactly this version |
The version argument is optional for `^`, `~` and `=` (the version passed is the
version in the url).
### Examples
```diff
-export { Application } from "https://deno.land/x/oak@v2.4.0/mod.ts#^";
+export { Application } from "https://deno.land/x/oak@v2.10.0/mod.ts#^"; // 3.x.y is not chosen
-export { decode } from "https://deno.land/std@v0.34.0/strings/decode.ts#=";
+export { decode } from "https://deno.land/std@v0.34.0/strings/decode.ts#="; // no change
-export { Application } from "https://deno.land/x/abc@v0.1.10/mod.ts#<0.2.0";
+export { Application } from "https://deno.land/x/abc@v0.1.11/mod.ts#<0.2.0"; // 0.2.x is not chosen
-export { encode } from "https://deno.land/std@v0.34.0/strings/encode.ts#~";
+export { encode } from "https://deno.land/std@v0.36.0/strings/encode.ts#~"; // update to latest compatible
```
## Supported domains
udd supports the following registry domains:
- https://deno.land/std
- https://deno.land/x
- https://denopkg.com
- https://dev.jspm.io
- https://cdn.pika.dev
- https://cdn.skypack.dev
- https://esm.sh
- https://unpkg.com
- https://raw.githubusercontent.com
- https://gitlab.com/:user/:repo/-/raw
- https://cdn.jsdelivr.net
- https://x.nest.land
- https://pax.deno.dev
_Create an issue to request additional registries._
---
_Logo by [Drake Sauer](http://clipart-library.com/clipart/6ir6AMoKT.htm)._