Title: Import and Handling for 'WhatsApp' Chat Logs
Version: 0.2.4
Date: 2022-01-05
Description: A straightforward, easy-to-use and robust parsing package which aims to digest history files from the popular messenger service 'WhatsApp' in all locales and from all devices.
Depends: R (≥ 3.5.0)
License: GPL-3
Imports: stringi (≥ 1.1.7), tibble (≥ 1.4.0)
Suggests: knitr, testthat, covr, spelling, rmarkdown
URL: https://github.com/JBGruber/rwhatsapp
Encoding: UTF-8
BugReports: https://github.com/JBGruber/rwhatsapp/issues
LazyData: true
RoxygenNote: 7.1.2
VignetteBuilder: knitr
Language: en-GB
NeedsCompilation: no
Packaged: 2022-01-05 05:05:57 UTC; johannes
Author: Johannes Gruber [aut, cre]
Maintainer: Johannes Gruber <Gruber@europa-uni.de>
Repository: CRAN
Date/Publication: 2022-01-05 10:10:02 UTC

List of emojis and corresponding descriptions.

Description

A dataset containing emojis and corresponding descriptions. This dataset was collected by combining the data from the emo package with newly scraped emojis from unicode.org.

Usage

emojis

Format

A tibble with 4085 rows and 3 columns:

Details

hex_runes can be used to easily look up image files of emojis.

Source

https://github.com/hadley/emo/ and https://unicode.org/emoji/charts/


Lookup emojis from text

Description

Takes a character string or data.frame with text, looks up all emoji characters in it and also returns their description. Supports the full unicode Emoji List v13.0 (see emojis).

Usage

lookup_emoji(x, ...)

## S3 method for class 'data.frame'
lookup_emoji(x, text_field = "text", ...)

## S3 method for class 'character'
lookup_emoji(x, ...)

Arguments

x

A character vector or data.frame.

...

not currently used.

text_field

the character name or numeric index of the source 'data.frame' indicating the variable to be read in as text.


Read WhatsApp history into R

Description

Takes a history file from the “WhatsApp” messenger app (txt or zip) and returns a formatted data.frame with descriptions of the used emojis.

Usage

rwa_read(x, tz = NULL, format = NULL, verbose = FALSE, encoding = "UTF-8", ...)

Arguments

x

Path to a txt or zip file of a WhatsApp history or the history itself as character object.

tz

A time zone for date conversion. Set NULL or "" for the default time zone or a single string with a timezone identifier, see stri_timezone_list.

format

Most formats are automatically detected. If you encounter problems you can provide a custom format here. Refer to stri_datetime_parse for guidance.

verbose

A logical flag indicating whether information should be printed to the screen.

encoding

Input encoding. Should usually be "UTF-8" if files haven't changed since export from WhatsApp.

...

Further arguments passed to readLines.

Details

The history can be obtained going to the menu in a chat on the “WhatsApp” app, choosing "more", then "Export chat".

Value

A tibble with the information parsed from the history file.

Examples

history <- system.file("extdata", "sample.txt", package = "rwhatsapp")
df <- rwa_read(history)