Gathering detailed insights and metrics for @cocktailpeanut/node-pty-prebuilt-multiarch
Gathering detailed insights and metrics for @cocktailpeanut/node-pty-prebuilt-multiarch
A parallel fork of node-pty providing ia32, amd64, arm, and aarch64 prebuilt packages for macOS, Windows and Linux (glibc and musl libc).
Installations
npm install @cocktailpeanut/node-pty-prebuilt-multiarchDeveloper Guide
BETA
Typescript
Yes
Module System
CommonJS
Node Version
20.16.0
NPM Version
10.8.1
Releases
3
Languages
6
TypeScript
C++
JavaScript
Shell
Python
C
TypeScript (47.3%)
C++ (34.93%)
JavaScript (9.09%)
Shell (5.49%)
Python (2.08%)
C (1.1%)
Developer
Download Statistics
Total Downloads
3,051
Last Day
3
Last Week
26
Last Month
146
Last Year
3,051
GitHub Statistics
NOASSERTION License
1,239 Commits
2 Branches
Updated on Aug 23, 2024
Maintainers
1
Package Meta Information
Latest Version
0.11.16
Package Id
@cocktailpeanut/node-pty-prebuilt-multiarch@0.11.16
Unpacked Size
55.77 MB
Size
8.69 MB
File Count
2,679
NPM Version
10.8.1
Node Version
20.16.0
Published on
Aug 23, 2024
Total Downloads
Cumulative downloads
Total Downloads
3,051
Last Day
-50%
3
Compared to previous day
Last Week
-18.8%
26
Compared to previous week
Last Month
-47.9%
146
Compared to previous month
Last Year
0%
3,051
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
node-pty-prebuilt-multiarch
This project is a parallel fork of node-pty providing prebuilt packages for certain Node.js and Electron versions.
Inspired by daviwil/node-pty-prebuilt.
Usage
Thanks to the excellent prebuild, prebuild-install modules, and prebuildify using this module is extremely easy.
You merely have to change your node-pty dependency to @homebridge/node-pty-prebuilt-multiarch and then change any require statements in your code from require('node-pty') to require('@homebridge/node-pty-prebuilt-multiarch').
NOTE: We started shipping prebuilds as of node-pty version 0.8.1, no prior versions are provided! If you were using an earlier version of
node-ptyyou will need to update your code to account for any API changes that may have occurred.
How It Works
We maintain a parallel fork of the node-pty codebase that will be updated as new releases are shipped.
When we merge new updates to the code into the prebuilt-multiarch branch, new prebuilt packages for our supported Node.js and Electron versions are updated to the corresponding GitHub release.
When @homebridge/node-pty-prebuilt-multiarch is installed as a package dependency, the installation script checks to see if there's a prebuilt package on this repo for the OS, ABI version, and architecture of the current process and then downloads it, extracting it into the module path.
If a corresponding prebuilt package is not found, node-gyp is invoked to build the package for the current platform.
Prebuilt Versions
| OS | Architectures |
|---|---|
| macOS | x64, arm64 |
| Linux (glibc) | ia32, x64, armv6, aarch64 |
| Linux (musl) | x64, armv6, aarch64 |
| Windows | ia32, x64 |
We only provide prebuilt binaries for Node.js 16 and Electron 16.0.0 or higher. Pls note that prebuilds for Electron 28 are not supplied due to build issues.
Build / Package
Please note releasing this package uses GitHub actions.
This flows takes the branch selected from the workflow start drop down, and creates a GitHub and NPM Release containing the prebuild artifacts.
The version of the Release comes from the package.json, and in the case of a BETA release automatically appends the beta release version.
During processing, it leverages a branch called release-candidate as a holding area for prebuilds.
When running the job, most times a couple of the instances of the sub step Commit & Push Changes within Prebuild NPM and GitHub Release artifacts fails.
When this occurs just re-run. This is due to concurrency issues between the steps and GitHub.
A typical run has 3-4 steps fail.
- Create branch
release-candidateif not existing (the script deletes it before starting and will fail if it isn't present) - Ensure version tag within package.json reflects version you want to publish, please note beta tags are added by the action.
- Run Action
Run prebuild's and Create GitHub and NPM release, and select branch you wish to publish, and if it needs to be BETA tagged and versioned - This will run for about an hour, and create a GitHub release with the prebuild artifacts attached, and a npm release with the prebuild artifacts attached
1# Install dependencies and build C++ 2npm install 3# Compile TypeScript -> JavaScript 4npm run build
Dependencies
Node.JS 16 or Electron 19 is required to use node-pty. What version of node is supported is currently mostly bound to whatever version Visual Studio Code is using.
Linux (apt)
1sudo apt install -y make python build-essential
macOS
Xcode is needed to compile the sources, this can be installed from the App Store.
Windows
npm install requires some tools to be present in the system like Python and C++ compiler. Windows users can easily install them by running the following command in PowerShell as administrator. For more information see https://github.com/felixrieseberg/windows-build-tools:
1npm install --global --production windows-build-tools
The following are also needed:
- Windows SDK - only the "Desktop C++ Apps" components are needed to be installed
- Spectre-mitigated libraries - In order to avoid the build error "MSB8040: Spectre-mitigated libraries are required for this project", open the Visual Studio Installer, press the Modify button, navigate to the "Individual components" tab, search "Spectre", and install an option like "MSVC v143 - VS 2022 C++ x64/x86 Spectre-mitigated libs (Latest)" (the exact option to install will depend on your version of Visual Studio as well as your operating system architecture)
Debugging
The wiki contains instructions for debugging node-pty.
Security
All processes launched from node-pty will launch at the same permission level of the parent process. Take care particularly when using node-pty inside a server that's accessible on the internet. We recommend launching the pty inside a container to protect your host machine.
Thread Safety
Note that node-pty is not thread safe so running it across multiple worker threads in node.js could cause issues.
Flow Control
Automatic flow control can be enabled by either providing handleFlowControl = true in the constructor options or setting it later on:
1const PAUSE = '\x13'; // XOFF 2const RESUME = '\x11'; // XON 3 4const ptyProcess = pty.spawn(shell, [], {handleFlowControl: true}); 5 6// flow control in action 7ptyProcess.write(PAUSE); // pty will block and pause the child program 8... 9ptyProcess.write(RESUME); // pty will enter flow mode and resume the child program 10 11// temporarily disable/re-enable flow control 12ptyProcess.handleFlowControl = false; 13... 14ptyProcess.handleFlowControl = true;
By default PAUSE and RESUME are XON/XOFF control codes (as shown above). To avoid conflicts in environments that use these control codes for different purposes the messages can be customized as flowControlPause: string and flowControlResume: string in the constructor options. PAUSE and RESUME are not passed to the underlying pseudoterminal if flow control is enabled.
Troubleshooting
Powershell gives error 8009001d
Internal Windows PowerShell error. Loading managed Windows PowerShell failed with error 8009001d.
This happens when PowerShell is launched with no SystemRoot environment variable present.
ConnectNamedPipe failed: Windows error 232
This error can occur due to anti-virus software intercepting winpty from creating a pty. To workaround this you can exclude this file from your anti-virus scanning node-pty\build\Release\winpty-agent.exe
pty.js
This project is forked from chjj/pty.js with the primary goals being to provide better support for later Node.js versions and Windows.
License
- Copyright (c) 2012-2015, Christopher Jeffrey (MIT License).
- Copyright (c) 2016, Daniel Imms (MIT License).
- Copyright (c) 2018, Microsoft Corporation (MIT License).
- Copyright (c) 2018, David Wilson (MIT License).
- Copyright (c) 2018, oznu (MIT License).
- Copyright (c) 2023, Homebridge (MIT License).
No vulnerabilities found.