Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

@google-cloud/typeless-sample-bot

googleapis563Apache-2.03.0.0TypeScript support: included

Google Cloud GitHub bot that converts TypeScript snippets into JavaScript

readme

typeless-sample-bot

This bot will automatically convert sample snippets written in TypeScript into JavaScript sample snippets. This lets you focus on writing TypeScript samples instead of having to do only JavaScript, or having to maintain both.

Installation

You will want to install this library as a globally-available, standalone binary.

npm i @google-cloud/typeless-sample-bot -g

Usage

The bot can convert single files or an entire tree of files. In the latter case, it will attempt to guess which files are actually snippets before doing anything with them.

For individual files, you can specify them as targets:

typeless-sample-bot --targets file1.ts,file2.ts,etc

The output will be written with the same filename stem, but a js extension.

You can also ask for recursive processing:

typeless-sample-bot --targets samples --recursive

Note that -t may be an array, still, for processing multiple recursive trees.

Various utility flags are also available:

# turn on verbose output
typeless-sample-bot --verbose

# turn on full debug output
typeless-sample-bot --debug

# turn off ANSI colour/emojis
typeless-sample-bot --no-art

Options

Option Description Default
targets List of target files or directory trees Required
recursive If set, targets will be directory trees processed recursively False
verbose If set, verbose output will be enabled False
debug If set, full debug output will be enabled False
art If set, ANSI colour and emojis will be used in the command output True, use --no-art to cancel

Running tests:

npm test

Contributing

If you have suggestions for how typeless-sample-bot could be improved, or want to report a bug, open an issue! We'd love all and any contributions.

For more, check out the Contributing Guide.

License: Apache 2.0

© 2022 Google LLC.

changelog

Changelog

3.0.0 (2025-03-18)

⚠ BREAKING CHANGES

  • upgrade to Node 18 (#6096)

Miscellaneous Chores

2.1.0 (2024-05-21)

Features

  • [Many APIs] update Nodejs generator to send API versions in headers for GAPICs (#5351) (01f48fc)
  • [Many APIs] update Nodejs generator to send API versions in headers for GAPICs (#5354) (a9784ed)

2.0.0 (2023-08-06)

⚠ BREAKING CHANGES

  • migrate to Node 14 (#4443)

Miscellaneous Chores

1.3.3 (2023-05-26)

Bug Fixes

  • deps: Update dependency recast to ^0.23.0 (#4277) (b6ae70d)

1.3.2 (2023-05-11)

Bug Fixes

1.3.1 (2023-04-13)

Bug Fixes

  • Minify JSON and JS files, and remove .map files (#4143) (170f7d5)

1.3.0 (2023-01-28)

Features

  • Add support for converting optional chaining to regular chaining (#3891) (f8414ac)

1.2.0 (2022-12-16)

Features

  • Add comments about generation and 'use strict' to transformed samples (#3696) (db012f5)
  • Add downconversion from ?? to || (#3722) (4a0a105)

Bug Fixes

  • deps: Update dependency recast to ^0.22.0 (#3745) (a9f6b83)

1.1.0 (2022-11-10)

Features

  • typeless-sample-bot: Add output path flag, and another pass at module resolution fixing (#3498) (192659d)

1.0.3 (2022-11-03)

Bug Fixes

  • Explicitly provide path to babel plugins (#3482) (6d34a3d)

1.0.2 (2022-10-28)

Bug Fixes

  • Update typeless bot build to compile before pack (#3463) (6f6fb2e)

1.0.1 (2022-10-27)

Bug Fixes

  • Typeless bot updates for a fully functioning packaged version (#3461) (8e93229)

1.0.0 (2022-08-25)

Features