angeldollface / zeppo

Convert between numbers of different bases. 🔮 🎸

ZEPPO 🔮 🎸

Convert between numbers of different bases. 🔮 🎸

ABOUT 📚

Roughly a year ago, I set myself the challenge of implementing a set of functions that could convert between numbers of different bases. I implemented this in Dart and decided to re-write this implementation in Javascript. The Dart implementation can be found here. The bases this library handles are: base 10, base 2, and base 16.

USAGE 🔨

APIs

Zeppo offers the following functions:

• letterIndex(letter): Gets the index of a letter in the alphabet. Returns zero if the letter isn't in the alphabet.
• getLetterFromIndex(index): Gets the letter from a supplied index. Returns an empty string if a letter cannot be found.
• binToDec(binaryNumber): Converts a base 2 number to a base 10 number.
• decToBin(decimalNumber): Converts a base 10 number to a base 2 number.
• hexToDec(hexNumber): Converts a base 16 number to a base 10 number.
• isBin(expr): Checks whether the supplied string is a binary number or not.
• isInt(expr): Checks whether the supplied string is an integer or not.
• isHex(expr): Checks whether the supplied string is a hexadecimal number or not.

Use Zeppo in a Deno project 🦖

• 1.) Create a Typescript file.

• 2.) To use Zeppo in a Deno project, add this line of code to your Typescript file(s) (functionName represents any of the function signatures above.):

import { functionName } from 'https://deno.land/x/zeppo/mod.ts';

• 3.) You can now use any of the function signatures above.

• 4.) You can run the Typescript file with Deno using this command (your_script.ts represents your Typescript file.):

deno run your_script.ts

CHANGELOG ✒️

Version 1.0.0

• Initial release.
• Upload to GitHub.
• Upload to NPM.

Version 1.1.0

• New license file.
• Better documentation.

Version 1.2.0

• Updated documentation.
• Added a function to check whether a string is a binary number or not.

Version 1.3.0

• Updated documentation.
• Added a function to check whether a string is an integer or not.

Version 1.4.0

• Updated documentation.
• Updated, published, and uploaded under my new name.

Version 1.5.0

• Fixed some administrative issues.
• Fixed some formatting issues.

Version 1.6.0

• Updated export statement.
• Updated documentation for Typescript.

Version 1.7.0

• Added support for Deno.

Version 1.8.0

• Removed the reverseArray function.
• Removed the testAll function.
• Added unit tests with Deno.
• Added a function to check whether a string is a hexadecimal number or not.
• Rewrote the project in Typescript.
• Migrated this project from Node.js to Deno.
• Relicensed the project under the DSL v1.

NOTE 📜

• Zeppo 🔮 🎸 by Alexander Abraham 🖤 a.k.a. "Angel Dollface" 🎎 🎀
• Licensed under the DSL v1.