Byte
A TypeScript implementation of a byte (octet) allowing easy bit manipulations.
1. Description
This library provides a simple implementation of a byte (aka octet) in a TypeScript class. I developed this "library" (which consists of merely one TypeScript class) for two purposes:
- for use in my EnOcean-Core library and associated files, and
- to understand, test and (hopefully) streamline my development process for more complex projects.
Hence: Feel free to use it, if it helps, but do not expect rocket science. :)
2. Installation
This library is available as a Node.js-module. You can thus use Node.js' package manager npm to install the latest production version from the npm registry by executing
npm i @henningkerstan/byte
in your Node.js project's repository. This library does not require/install any dependencies.
3. Usage
Since this library is written in TypeScript, you can use it both with TypeScript as well as with plain JavaScript. Below you can find short examples to get you started in both languages.
The library also comes with an online documentation. A good starting point for further reading is the documentation of the Byte class. Moreover, as this documentation is generated from source code comments using TypeDoc, a supported editor (like Visual Studio Code) can provide on-the-fly information on functions, parameters, etc..
3.1 Importing the module
To use any of the functionality we need to import the module.
import { Byte } from "@henningkerstan/byte"3.2 Examples
Here are some toy examples - you can also have a look at the Jasmine spec (aka test script) for more examples.
const byte1 = Byte.allZero()
byte1.setBit(1, 3)
console.log(byte1.toStringLSB())
const byte2 = Byte.fromUInt8LSB(123)
console.log(byte2.toStringLSB())
console.log(byte2.toStringMSB())4. Contributing
Contact the main author (Henning Kerstan) if you want to contribute. More details will be available here soon.
Note that this project uses semantic versioning.
5. License
Copyright 2021 Henning Kerstan
SPDX-License-Identifier: Apache-2.0