Type: Package
Title: A Collection of Lovecraftian Tales and Texts
Version: 1.2.0
Maintainer: Ruff Sergej <serijnh@gmail.com>
Description: A curated collection of Howard Phillips Lovecraft's complete stories, collected for the purpose of text analysis.
License: GPL (≥ 3)
URL: https://github.com/SergejRuff/lovecraftr
BugReports: https://github.com/SergejRuff/lovecraftr/issues
Encoding: UTF-8
LazyData: true
Depends: R (≥ 2.10)
RoxygenNote: 7.3.2
Imports: magrittr, rvest, stringr
NeedsCompilation: no
Packaged: 2024-12-14 12:49:56 UTC; sergej
Author: Ruff Sergej ORCID iD [aut, cre]
Repository: CRAN
Date/Publication: 2024-12-14 13:00:02 UTC

Lovecraftr: A Collection of H.P. Lovecraft's Classic Stories

Description

The lovecraftr package offers a collection of H.P. Lovecraft's most renowned stories, formatted for easy access and text analysis. This package is intended for literary study, text analysis, and exploration of Lovecraft’s unique themes and style within the horror genre.

List of Stories Included in the lovecraftr Package:

At the Mountains of Madness - MM
Azathoth - AZA
Beyond the Wall of Sleep - BWS
Celephais - C
Cool Air - air
Dagon - D
He - HE
Herbert West—Reanimator - HWR
The Alchemist - ALC
The Beast in the Cave - BIC
The Book - book
The Call of Cthulhu - CC
The Case of Charles Dexter Ward - CDW
The Cats of Ulthar - cat
The Colour Out of Space - CS
The Descendant - DE
The Doom That Came to Sarnath - DS
The Dreams in the Witch House - DWH
The Dream-Quest of Unknown Kadath - DQ
The Dunwich Horror - DW
The Festival - FE
The Haunter of the Dark - haunter
The Horror at Red Hook - RH
The Hound - H
The Lurking Fear - LURK
The Music of Erich Zann - MEZ
The Nameless City - NC
The Outsider - O
The Quest of Iranon - IRA
The Shadow out of Time - SOT
The Shadow over Innsmouth - SOI
The Shunned House - TSH
The Silver Key - key
The Temple - TE
The Thing on the Doorstep - door
Writings in the United Amateur - WUA

Author(s)

Maintainer: Sergej Ruff (serijnh@gmail.com)

If you have any questions, suggestions, or issues, please feel free to contact me (serijnh@gmail.com).

See Also

Useful links:

The text of H.P. Lovecraft's "Cool air"

Description

A dataset containing the full text of H.P. Lovecraft's "Cool air". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

air

Format

A character vector with 339 elements

Source

<https://www.gutenberg.org/ebooks/73177>

The text of H.P. Lovecraft's "The Alchemist"

Description

A dataset containing the full text of H.P. Lovecraft's "The Alchemist". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

alchemist

Format

A character vector with 223 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/a.aspx>

The text of H.P. Lovecraft's "Azathoth"

Description

A dataset containing the full text of H.P. Lovecraft's "Azathoth". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

azathoth

Format

A character vector with 34 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/az.aspx>

The text of H.P. Lovecraft's "The Beast in the Cave"

Description

A dataset containing the full text of H.P. Lovecraft's "The Beast in the Cave". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

beast_cave

Format

A character vector with 153 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/bc.aspx>

The text of H.P. Lovecraft's "The Book"

Description

A dataset containing the full text of H.P. Lovecraft's "The Book". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

book

Format

A character vector with 75 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/b.aspx>

The text of H.P. Lovecraft's "The Call of Cthulhu"

Description

A dataset containing the full text of H.P. Lovecraft's story "The Call of Cthulhu". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

call_of_cthulhu

Format

A character vector with 1194 elements

Source

<https://www.gutenberg.org/ebooks/68283>

The text of H.P. Lovecraft's "The Cats of Ulthar"

Description

A dataset containing the full text of H.P. Lovecraft's "The Cats of Ulthar". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

cats

Format

A character vector with 82 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/cu.aspx>

The text of H.P. Lovecraft's "Celephaïs"

Description

A dataset containing the full text of H.P. Lovecraft's "Celephaïs". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

celephais

Format

A character vector with 153 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/c.aspx>

The text of H.P. Lovecraft's "The Case of Charles Dexter Ward"

Description

A dataset containing the full text of H.P. Lovecraft's story "The Case of Charles Dexter Ward". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

charles_dexter

Format

A character vector with 4379 elements

Source

<https://www.gutenberg.org/ebooks/73547>

The text of H.P. Lovecraft's "The Nameless City"

Description

A dataset containing the full text of H.P. Lovecraft's "The Nameless City". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

city

Format

A character vector with 299 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/nc.aspx>

The text of H.P. Lovecraft's "The Colour Out of Space"

Description

A dataset containing the full text of H.P. Lovecraft's story "The Colour Out of Space". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

colour_space

Format

A character vector with 1110 elements

Source

<https://www.gutenberg.org/ebooks/68236>

The text of H.P. Lovecraft's "Dagon"

Description

A dataset containing the full text of H.P. Lovecraft's "Dagon". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

dagon

Format

A character vector with 133 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/d.aspx>

The text of H.P. Lovecraft's "The Descendant"

Description

A dataset containing the full text of H.P. Lovecraft's "The Descendant". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

descendant

Format

A character vector with 92 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/de.aspx>

The text of H.P. Lovecraft's "The Doom That Came to Sarnath"

Description

A dataset containing the full text of H.P. Lovecraft's "The Doom That Came to Sarnath". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

doom

Format

A character vector with 160 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/ds.aspx>

The text of H.P. Lovecraft's "The thing on the door-step"

Description

A dataset containing the full text of H.P. Lovecraft's "The thing on the door-step". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

door_step

Format

A character vector with 1081 elements

Source

<https://www.gutenberg.org/ebooks/73230>

The text of H.P. Lovecraft's "The Dunwich Horror"

Description

A dataset containing the full text of H.P. Lovecraft's story "The Dunwich Horror". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

dunwich_horror

Format

A character vector with 1694 elements

Source

<https://www.gutenberg.org/ebooks/50133>

The text of H.P. Lovecraft's "The Music of Erich Zann"

Description

A dataset containing the full text of H.P. Lovecraft's "The Music of Erich Zann". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

erich_zann

Format

A character vector with 198 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/mez.aspx>

The text of H.P. Lovecraft's "The festival"

Description

A dataset containing the full text of H.P. Lovecraft's "The festival". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

festival

Format

A character vector with 345 elements

Source

<https://www.gutenberg.org/ebooks/68553>

Fetch Lovecraft's Stories from the H.P. Lovecraft Archive

Description

The 'fetch_lovecraft' function retrieves text from stories by H.P. Lovecraft from the H.P. Lovecraft Archive. If no URL is provided, it returns a data frame listing all available stories with download links. If a valid URL is given, it fetches and returns the text from that specific story.

Usage

fetch_lovecraft(url = NULL, trim = NULL)

Arguments

url

A character string containing the URL of a specific H.P. Lovecraft story. If 'NULL', the function returns a list of available stories and their links.

trim

A vector of indices specifying which lines of the text to keep/trim. If 'NULL', all lines of the text are returned.

Value

If a valid URL is provided, the function returns a data frame with two columns:

text

A vector containing the story's text split into lines.

title

The title of the story.

If no URL is provided, the function returns a data frame with two columns:

name

The name of the story.

link

The URL from which the story can be downloaded.

References

H.P. Lovecraft Archive: https://www.hplovecraft.com/.

Examples




#' # List all available stories
fetch_lovecraft()

# Retrieve a story
fetch_lovecraft("https://www.hplovecraft.com/writings/texts/fiction/mm.aspx")

The text of H.P. Lovecraft's "The haunter of the dark"

Description

A dataset containing the full text of H.P. Lovecraft's "The haunter of the dark". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

haunter_dark

Format

A character vector with 954 elements

Source

<https://www.gutenberg.org/ebooks/73233>

The text of H.P. Lovecraft's "He"

Description

A dataset containing the full text of H.P. Lovecraft's "He". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

he

Format

A character vector with 419 elements

Source

<https://www.gutenberg.org/ebooks/68547>

The text of H.P. Lovecraft's "The Hound"

Description

A dataset containing the full text of H.P. Lovecraft's "The Hound". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

hound

Format

A character vector with 189 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/h.aspx>

The text of H.P. Lovecraft's "The quest of Iranon"

Description

A dataset containing the full text of H.P. Lovecraft's "The quest of Iranon". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

iranon

Format

A character vector with 258 elements

Source

<https://www.gutenberg.org/ebooks/73182>

The text of H.P. Lovecraft's "The silver key"

Description

A dataset containing the full text of H.P. Lovecraft's "The silver key". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

key

Format

A character vector with 472 elements

Source

<https://www.gutenberg.org/ebooks/70478>

The text of H.P. Lovecraft's "The lurking fear"

Description

A dataset containing the full text of H.P. Lovecraft's "The lurking fear". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

lurking

Format

A character vector with 791 elements

Source

<https://www.gutenberg.org/ebooks/70486>

The text of H.P. Lovecraft's "At the Mountains of Madness"

Description

A dataset containing the full text of H.P. Lovecraft's story "At the Mountains of Madness". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

mountain_madness

Format

A character vector with 4618 elements

Source

<https://www.gutenberg.org/ebooks/70652>

The text of H.P. Lovecraft's "The Outsider"

Description

A dataset containing the full text of H.P. Lovecraft's "The Outsider". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

outsider

Format

A character vector with 211 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/o.aspx>

The text of H.P. Lovecraft's "Herbert West—Reanimator"

Description

A dataset containing the full text of H.P. Lovecraft's "Herbert West—Reanimator". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

reanimator

Format

A character vector with 739 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/hwr.aspx>

The text of H.P. Lovecraft's "The Horror at Red Hook"

Description

A dataset containing the full text of H.P. Lovecraft's story "The Horror at Red Hook". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

red_hook

Format

A character vector with 873 elements

Source

<https://www.gutenberg.org/ebooks/72966>

The text of H.P. Lovecraft's "The Shadow Over Innsmouth"

Description

A dataset containing the full text of H.P. Lovecraft's story "The Shadow Over Innsmouth". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

shadow_innsmouth

Format

A character vector with 1708 elements

Source

<https://www.gutenberg.org/ebooks/73181>

The text of H.P. Lovecraft's "The Shadow out of Time"

Description

A dataset containing the full text of H.P. Lovecraft's "The Shadow out of Time". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

shadow_time

Format

A character vector with 1528 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/sot.aspx>

The text of H.P. Lovecraft's "The Shunned House"

Description

A dataset containing the full text of H.P. Lovecraft's story "The Shunned House". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

shunned_house

Format

A character vector with 1048 elements

Source

<https://www.gutenberg.org/ebooks/31469>

The text of H.P. Lovecraft's "The Temple"

Description

A dataset containing the full text of H.P. Lovecraft's "The Temple". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

temple

Format

A character vector with 319 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/te.aspx>

Retrieve Lovecraftian Tales by Name or abbreviation

Description

Search for and retrieve text from a collection of Lovecraft stories.

Usage

unearth_lovecraftian_tales(book = NULL)

Arguments

book

A character string representing the full name or abbreviation of the Lovecraft story to search for. The search is case-insensitive. If NULL, the function returns a list of all available stories and their abbreviations.

Value

If a valid book is selected, a data frame with the following columns:

text

The text of the selected story.

title

The title of the selected Lovecraft story.

abbreviation

The abbreviation corresponding to the story.

If no book is specified, the function returns a data frame with two columns:

story

The name of the available story.

abbreviation

The corresponding abbreviation for each story.

Examples

# List all available stories
unearth_lovecraftian_tales()

# Retrieve a story by full name (case-insensitive)
unearth_lovecraftian_tales("The shadow over innsmouth")

# Retrieve a story by abbreviation (case-insensitive)
unearth_lovecraftian_tales("soi")

# Retrieve a story with partial name or abbreviation (case-insensitive)
unearth_lovecraftian_tales("call")

# Retrieve a story by abbreviation
unearth_lovecraftian_tales("RH")

The text of H.P. Lovecraft's "Writings in the United Amateur"

Description

A dataset containing the full text of H.P. Lovecraft's "Writings in the United Amateur". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

united_amateur

Format

A character vector with 10749 elements

Source

<https://www.gutenberg.org/ebooks/30637>

The text of H.P. Lovecraft's "The Dream-Quest of Unknown Kadath"

Description

A dataset containing the full text of H.P. Lovecraft's "The Dream-Quest of Unknown Kadath". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

unknown_kadath

Format

A character vector with 2483 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/dq.aspx>

The text of H.P. Lovecraft's "Beyond the Wall of Sleep"

Description

A dataset containing the full text of H.P. Lovecraft's "Beyond the Wall of Sleep". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

wall_sleep

Format

A character vector with 274 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/bws.aspx>

The text of H.P. Lovecraft's "The Dreams in the Witch House"

Description

A dataset containing the full text of H.P. Lovecraft's "The Dreams in the Witch House". The text is provided as a character vector, with each element representing a chunk of the full text.

Usage

witch_house

Format

A character vector with 892 elements

Source

<https://www.hplovecraft.com/writings/texts/fiction/dwh.aspx>