Lorem Text Generator

0.1.1 · maintenance · verified Sat Apr 11

The `lorem` library (version 0.1.1) is a lightweight Python package designed to generate random text that resembles Latin, commonly known as 'Lorem Ipsum'. It provides simple functions for generating words, sentences, and paragraphs, as well as a more configurable class for advanced text generation. The project has not seen updates since 2016, indicating a stable but inactive development cadence.

Warnings

gotcha The `lorem` package (0.1.1) has not been updated since June 2016. While functional for basic needs, it lacks modern features, ongoing maintenance, and explicit Python 3.6+ compatibility statements beyond its initial release era (Python 3.3, 3.4, 3.5). Users requiring active development or extensive features should consider alternative libraries.
Fix: For basic Lorem Ipsum, this library is sufficient. For more robust or actively maintained solutions, consider alternatives like `lorem_text` or `lipsum`.
gotcha There are multiple Python packages available on PyPI with 'lorem' or 'lorem ipsum' in their names (e.g., `lorem_text`, `pyloremgen`, `lipsum`, `loremipsum`). Ensure you are installing and importing the correct package (`pip install lorem`) to avoid unexpected behavior or compatibility issues.
Fix: Always verify the PyPI project name (`lorem`) and the expected import statements (`import lorem` or `from lorem.text import TextLorem`) against the official documentation or the GitHub repository (`sfischer13/python-lorem`).
gotcha The `lorem` library's `TextLorem` class offers customization options like `wsep` (word separator), `srange` (sentence length range), and `words` (custom word list). Failing to properly format `words` as a list of strings (e.g., `"A B C".split()`) can lead to unexpected output or errors.
Fix: When using the `words` parameter in `TextLorem`, always provide a list of strings, e.g., `words=['word1', 'word2', 'word3']` or `words='word1 word2 word3'.split()`.

Install

pip install lorem Install stable version

Imports

lorem
```
import lorem
```
For direct access to simple text generation functions.
TextLorem
```
from lorem.text import TextLorem
```
For creating a configurable text generator instance.

Quickstart

This quickstart demonstrates both the direct utility functions for basic Lorem Ipsum generation and the `TextLorem` class for more customized output, such as specific word separators or sentence length ranges.

import lorem
from lorem.text import TextLorem

# Simple usage
sentence = lorem.sentence()
paragraph = lorem.paragraph()
text = lorem.text()

print(f"Sentence: {sentence}")
print(f"Paragraph: {paragraph}")
print(f"Text (multiple paragraphs): {text}")

# Complex usage with TextLorem for custom generation
custom_lorem = TextLorem(wsep='-', srange=(2,3), words="alpha beta gamma delta".split())
custom_sentence = custom_lorem.sentence()
print(f"Custom sentence: {custom_sentence}")

view raw JSON →