Skip to content

Conversation

rossiam
Copy link
Collaborator

@rossiam rossiam commented Sep 25, 2025

This PR includes stuff to prepare for a yargs/ES modules prerelease:

  • Updates to documentation
    • Removed old oclif stuff
    • Updated installation instructions a bit
    • Wrote a new little script update-readme.ts that lists commands in the README; for now, it just lists commands with their descriptions
    • Updated configuration.md with updated config file location info
  • package.json
    • update version
    • remove references to old pkg tool
    • readme command/script now runs new update-readme script
    • package command/readme now runs new build-binaries script
    • zip-binaries has been rolled into package and has been remove
  • Make use of yargs .completion option which adds a completion command
  • Disable Node deprecation notices for now. For some reason, after packing with ncc, we get these
  • Updated temporary notes some and converted them to changes in CHANGELOG.md
  • Updated a couple of dependencies

Copy link

changeset-bot bot commented Sep 25, 2025

⚠️ No Changeset found

Latest commit: 80b5426

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@rossiam rossiam marked this pull request as draft September 25, 2025 14:37
@rossiam rossiam force-pushed the prerelease-prep branch 11 times, most recently from 78cfb49 to c633832 Compare September 29, 2025 14:44
@rossiam rossiam marked this pull request as ready for review September 29, 2025 14:48
@rossiam rossiam requested a review from a team September 29, 2025 14:49
CHANGELOG.md Outdated
* All commands now have examples in their help (`smartthings <command> --help`).
* args that require enum-like types are now case-insensitive. e.g. You can now list zigbee devices
with `smartthings devices --type zigbee`.
* The config file location is now determined by https://www.npmjs.com/package/env-paths[envPaths] library

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Markdown syntax error on the URL.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Heh, oops. That was asciidoc format. Fixed.

CHANGELOG.md Outdated
rather than an argument. e.g. `smartthings capabilities myteam.myCapability --capability-version 1`
instead of `smartthings capabilities myteam.myCapability 1`. Note that the version is always one,
so this flag is not necessary at this time.
* We now use ES modules.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Probably can replace these with something more generic since they don't impact end user features.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Fixed this.


The CLI can be used on any platform that supports Node 24.

First, install at least [Node version 24.8.0](https://nodejs.org/en/download/current) on your machine.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This link will likely change to something else in the near future rather than node 24. Do you want to just say latest Node or did you need it to say 24 specifically? If so maybe there is a direct link to node24 that can be used.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As discussed in chat, I'm just going to leave this. It's okay if they install a newer version.

name: 'smartthings',
input: packFile,
resources: ['package.json'],
remote: 'https://github.com/SmartThingsCommunity/cli-nexe-builds/releases/download/1.0.0',

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doesn't seem to resolve? Should the 1.0.0 be the node version?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is correct. It is true that it doesn't resolve in a web browser but I don't think nexe ever tries to resolve this URL by itself. It's adding the asset name to it and resolving that.

(Look at the URLs for the assets on this page:

https://github.com/SmartThingsCommunity/cli-nexe-builds/releases/tag/1.0.0

It's the base of all of them.)

@rossiam rossiam force-pushed the prerelease-prep branch 2 times, most recently from a9d4baa to be98ce5 Compare September 30, 2025 19:49
@rossiam rossiam merged commit b246a84 into SmartThingsCommunity:yargs Sep 30, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants