https://github.com/o-az/xtsz
a TypeScript and JavaScript (Node.js) runner that supports HTTP/S imports. It can run ESM and CJS: .ts, .js, .cjs, .mjs.
https://github.com/o-az/xtsz
cli esbuild https-import javascript nodejs ts-node tsx typescript
Last synced: 9 months ago
JSON representation
a TypeScript and JavaScript (Node.js) runner that supports HTTP/S imports. It can run ESM and CJS: .ts, .js, .cjs, .mjs.
- Host: GitHub
- URL: https://github.com/o-az/xtsz
- Owner: o-az
- Created: 2023-04-22T17:36:51.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-13T07:10:25.000Z (almost 3 years ago)
- Last Synced: 2025-06-08T23:36:33.942Z (10 months ago)
- Topics: cli, esbuild, https-import, javascript, nodejs, ts-node, tsx, typescript
- Language: TypeScript
- Homepage: https://www.npmjs.com/package/xtsz
- Size: 1.35 MB
- Stars: 13
- Watchers: 3
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
_**NOTE: youmust be on Node.js LTS (v18) or higher**_
This is like [tsx](https://github.com/esbuild-kit/tsx) but with https imports support `+`
ability to run external files directly from CLI `+`
only 1 dependency: `esbuild`
If file is `.js`, `.cjs`, `.mjs`, `.ts`, `.cts`, or `.mts`, it will bundled with `esbuild` on the fly then executed with `Node.js`.
If the file is `css`, `txt`, `md`, `html`, `svg`, `xml`, `yaml`, `yml`, `toml`, `csv`, `sql`, `graphql`, or `gql` it will be read and printed to the console.
# **`xtsz`**
### Install
```sh
# pnpm
pnpm add --global xtsz@latest
```
```sh
# yarn
yarn global add xtsz@latest
```
```sh
# npm
npm install --global xtsz@latest
```
### Run
```sh
xtsz ./path/to/file.ts
```
#### as a `devDependency`
```sh
# install
pnpm add --save-dev xtsz@latest
# run
pnpm dlx xtsz ./path/to/file.ts
# or
xtsz https://gist.githubusercontent.com/o-az/e8ed1e89fde52af306099ed28e297cae/raw/f997df001ee197f638af14d09309eb3c060240b0/sample-iife.js
```
```sh
xtsz is a TypeScript and JavaScript (Node.js) file runner that supports https-imports and running external files directly from CLI.
It can run ESM and CJS: .ts, .js, .cjs, .mjs.
Usage:
$ xtsz
$ xtsz
Options:
-f, --file The file to run. Can be passed as a flag or as the only argument with no other flags.
-u, --url The url to run. Can be passed as a flag or as the only argument with no other flags.
-h, --help Show this help message.
Examples:
$ xtsz ./src/index.ts
$ xtsz --file ./src/index.cjs
$ xtsz https://gist.githubusercontent.com/o-az/e8ed1e89fde52af306099ed28e297cae/raw/f997df001ee197f638af14d09309eb3c060240b0/sample-iife.js
$ xtsz help, --help, -h
- "What is https imports?"
See https://nodejs.org/api/esm.html#https-and-http-imports
- "How does this package work?"
It uses a custom esbuild plugin to handle https imports and uses Node.js to run TypeScript & ESM.
BUGS
https://github.com/o-az/xtsz/issues
```