rk.stringr: String Manipulation Tools for RKWard

This repository contains the source code for rk.stringr, an RKWard plugin package that provides a user-friendly graphical interface for the powerful stringr package. This plugin brings modern, consistent, and intuitive string manipulation directly into your RKWard workflow.

It is designed for common data cleaning and preparation tasks, allowing you to perform a wide range of text transformations without writing code. A key design feature is that all operations are vectorized and preserve the length of the input data, making them safe and predictable to use when transforming columns in a data frame.

🌍 Internationalization

As of version 0.1.1, this plugin is fully localized. The interface automatically adapts to the language settings of your RKWard installation.

Supported Languages:

• 🇺🇸 English (Default)
• 🇪🇸 Spanish (es)
• 🇫🇷 French (fr)
• 🇩🇪 German (de)
• 🇧🇷 Portuguese (Brazil) (pt_BR)

Features

The plugin is organized into several modules accessible from the RKWard menu, each targeting a specific category of string operations:

Detect & Locate Matches

Use regular expressions to find patterns within your text.

• Check if strings contain a pattern (str_detect).
• Verify if strings start or end with specific text (str_starts, str_ends).
• Count the number of times a pattern occurs (str_count).
• Find the exact start and end positions of matches (str_locate, str_locate_all).

Mutate Strings

Easily change the case of your text for standardization.

• Convert to lower, UPPER, Title, or Sentence case.

Extract from Strings

Pull out specific pieces of your strings.

• Extract substrings by character position (str_sub).
• Extract text that matches a pattern, including specific capture groups (str_extract, str_match).

Split Strings

Break strings into multiple pieces based on a delimiter.

• Split strings into a list of substrings (str_split).
• Split strings into a fixed number of columns in a matrix (str_split_fixed).

Manage String Length

Standardize the length and padding of your strings.

• Get the number of characters in each string (str_length).
• Remove leading/trailing and excess internal whitespace (str_trim, str_squish).
• Pad strings with characters to a uniform length (str_pad).
• Truncate strings that are too long (str_trunc).

Installation

With remotes (Recommended)

You can install this plugin directly from the repository using the remotes package in R.

local({
## Preparar
require(remotes)
## Computar
  install_github(
    repo="AlfCano/rk.stringr"
  )
## Imprimir el resultado
rk.header ("Resultados de Instalar desde git")
})

Manual Installation

1. Download this repository as a .zip file.
2. In RKWard, go to Settings -> R Packages -> Install package(s) from local zip file(s) and select the downloaded file.
3. Restart RKWard.

Usage

Once installed, the plugin components can be found in the RKWard menu under:

Data > String Manipulation (stringr)

From there, you can select the desired operation (e.g., "Mutate Strings", "Split Strings", etc.) to open its dialog window.

Dependencies

• RKWard: Version 0.7.0 or greater.
• R: Version 3.5.0 or greater.
• R Package: stringr (version 1.4.0 or greater), which will be installed from CRAN if not already present.

Author & License

• Author: Alfonso Cano (alfonso.cano@correo.buap.mx)
• Assisted by: Gemini, a large language model from Google.
• License: GPL (>= 3)