README for Fake Dalmatians

:Authors:

* **Anna Wilcox**

:Status:

Released

:Copyright:

© 2026 Anna Wilcox.  NCSA open source license.
.. image

img.shields.io/badge/license-NCSA-lightgrey.svg

:target: LICENSE

Introduction

This repository contains the code for faker-dal, a plugin for the ‘Faker RubyGem`_ that adds the most important category possible to it: the Hundred and One Dalmatians.

This includes every known, named dog from all known incarnations of this series in media, and every episode title from both television series!

It also includes

.. _`Faker RubyGem`: rubygems.org/gems/faker

License “““‘ This Gem is provided under the NCSA open source license.

The names of the characters are assumed to be copyrighted by either the estate of Dodie Smith and/or Disney, but it is believed this is Fair Use because:

  • The purpose and character of this use is not for commercial nature; it is strictly of a non-profit nature.

  • The nature of the work(s) are books, films, and television series. This is a computer programming library used for generating fake names for test data.

  • The amount of the copyrighted work(s) used is extremely small. It is just the names of the characters, and the titles of the episodes. No actual creative content besides the names is present.

  • The effect of the use on the market: It may actually increase it, because more people will be thinking about Dalmatians!

Changes “““‘ Any changes to this repository must be reviewed before being pushed to the current branch. There are no exceptions to this rule. For security-sensitive updates, contact Anna Wilcox, preferrably using PGP-encrypted email or via Signal. Reach out to me for contact information.

Though I’m not certain what security updates could be needed for a Gem about dogs. If we escape the kennels, we’ll just come back for dinner time.

Usage

The entirety of the Gem is contained in the “Faker::Creature::Dog::Dalmatian“ class. There are a number of methods:

  • “name“

    Produce a random name for a Dalmatian. This could be any of them.

  • “classic_name“

    Produce a random name for a Dalmatian, limited to the original 101 (or, really, 65). This might be what you want for familiarity’s sake.

  • “popular_name“

    Produce a random name for a Dalmatian, limited to those who have developed personalities. This includes the ones with speaking roles in the book, films, and series. This is probably what you actually want if you’re using this.

  • “street_name“

    Produce a random name for a Dalmatian, limited to 101 Dalmatian Street.

  • “one_hundred_and_two_name“

    Produce a random name for a Dalmatian, limited to 102 Dalmatians.

  • “series_episode“

    Produce a random episode title from *101 Dalmatians: The Series* (1997).

  • “street_episode“

    Produce a random episode title from *101 Dalmatian Street*.

Supported Environments

It’s just a RubyGem. It should work on any version of Ruby that “faker“ supports, and that should include alternate runtimes like JRuby.

I do the majority of my testing on my Apple Silicon Mac (aarch64) running both the Mac OS and Adélie Linux.

Building

“gem build“

Reporting Issues

If you’re wanting to report an issue, please go for it, but I’m not sure what it would be about. If you have some sort of source that provides more names for the Dalmatians, that would be a great issue to report.