tessl/npm-locutus

JavaScript library that ports standard library functions from other programming languages (PHP, C, Go, Python, Ruby) to JavaScript

—

Pending

Quality

Pending

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Securityby

Pending

The risk profile of this skill

Overview

Eval results

Files

Python Functions

Name: tessl/npm-locutus
Author: tessl

Python standard library functions ported to JavaScript. This module contains 5 string-related constants and functions from Python's string module.

Capabilities

String Module (5 functions/constants)

String constants and utility functions from Python's string standard library module.

/**
 * Python string module constants and functions
 */
python.string.ascii_letters()   // Function returning all ASCII letters
python.string.ascii_lowercase() // Function returning lowercase ASCII letters
python.string.ascii_uppercase() // Function returning uppercase ASCII letters
python.string.capwords(s)       // Capitalize words in string (whitespace separated)
python.string.punctuation()     // Function returning ASCII punctuation characters

Usage Examples:

const locutus = require('locutus');

// String constants (functions that return strings)
console.log(locutus.python.string.ascii_letters());
// 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'

console.log(locutus.python.string.ascii_lowercase());
// 'abcdefghijklmnopqrstuvwxyz'

console.log(locutus.python.string.ascii_uppercase());
// 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'

console.log(locutus.python.string.punctuation());
// '!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~'

// Capitalize words
const capitalized = locutus.python.string.capwords('hello world'); // 'Hello World'

Function Details

ascii_letters

A function that returns a string containing all ASCII letters (both lowercase and uppercase).

/**
 * Function returning string containing all ASCII letters
 * @returns {string} All ASCII letters
 */
python.string.ascii_letters()  // Returns 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'

Returns:

(string): 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'

ascii_lowercase

A function that returns a string containing lowercase ASCII letters.

/**
 * Function returning lowercase ASCII letters
 * @returns {string} Lowercase ASCII letters
 */
python.string.ascii_lowercase()  // Returns 'abcdefghijklmnopqrstuvwxyz'

Returns:

(string): 'abcdefghijklmnopqrstuvwxyz'

ascii_uppercase

A function that returns a string containing uppercase ASCII letters.

/**
 * Function returning uppercase ASCII letters
 * @returns {string} Uppercase ASCII letters
 */
python.string.ascii_uppercase()  // Returns 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'

Returns:

(string): 'ABCDEFGHIJKLMNOPQRSTUVWXYZ'

punctuation

A function that returns a string containing ASCII punctuation characters.

/**
 * Function returning ASCII punctuation characters
 * @returns {string} ASCII punctuation characters
 */
python.string.punctuation()  // Returns '!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~'

Returns:

(string): '!"#$%&\'()*+,-./:;<=>?@[\\]^_{|}~'`

capwords(s)

Return a capitalized version of the string where words are separated by whitespace.

/**
 * Return a capitalized version of the string
 * @param {string} s - The string to capitalize
 * @returns {string} String with capitalized words
 */
python.string.capwords(s)

Parameters:

s (string): The string to capitalize

Returns:

(string): A string with the first character of each word capitalized

Examples:

const locutus = require('locutus');

// Whitespace separation
locutus.python.string.capwords('hello world');           // 'Hello World'
locutus.python.string.capwords('the quick brown fox');   // 'The Quick Brown Fox'
locutus.python.string.capwords('  hello   world  ');     // 'Hello   World  '

// Edge cases
locutus.python.string.capwords('');                      // ''
locutus.python.string.capwords('hello');                 // 'Hello'
locutus.python.string.capwords('HELLO WORLD');           // 'HELLO WORLD'

Use Cases

Python string functions are useful for:

Character Set Validation: Checking if strings contain only specific character types
Text Processing: Capitalizing text with custom separators
Data Sanitization: Filtering out unwanted characters using punctuation constants
Form Validation: Validating input against allowed character sets
Template Processing: Using constants for character class matching

const locutus = require('locutus');

// Validate that string contains only letters
function isAlphabetic(text) {
  const letters = locutus.python.string.ascii_letters();
  return text.split('').every(char => letters.includes(char));
}

// Remove punctuation from text
function removePunctuation(text) {
  const punct = locutus.python.string.punctuation();
  return text.split('').filter(char => !punct.includes(char)).join('');
}

// Generate random string from character set
function randomString(length, charSet = locutus.python.string.ascii_letters()) {
  let result = '';
  for (let i = 0; i < length; i++) {
    result += charSet.charAt(Math.floor(Math.random() * charSet.length));
  }
  return result;
}

// Capitalize text (whitespace separated only)
function capitalizeText(text) {
  return locutus.python.string.capwords(text);
}

// Examples
console.log(isAlphabetic('HelloWorld'));          // true
console.log(isAlphabetic('Hello123'));            // false
console.log(removePunctuation('Hello, World!'));  // 'Hello World'
console.log(randomString(8));                     // e.g., 'aBcDeFgH'
console.log(capitalizeText('hello world test')); // 'Hello World Test'

Import Patterns

// Full module access
const locutus = require('locutus');
locutus.python.string.capwords('hello world');
console.log(locutus.python.string.ascii_letters());

// Individual function import
const capwords = require('locutus/python/string/capwords');
const ascii_letters = require('locutus/python/string/ascii_letters');
const punctuation = require('locutus/python/string/punctuation');

capwords('hello world');     // 'Hello World'
console.log(ascii_letters());  // 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ'
console.log(punctuation());    // '!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~'