Metadata-Version: 2.1
Name: evolve-words
Version: 0.2.1
Summary: A simple illustration of mutation aiding evolution
Home-page: https://github.com/davep/evolve-words
Author: Dave Pearson
Author-email: davep@davep.org
Maintainer: Dave Pearson
Maintainer-email: davep@davep.org
License: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Project-URL: Documentation, https://github.com/davep/evolve-words/blob/main/README.md
Project-URL: Source, https://github.com/davep/evolve-words
Project-URL: Issues, https://github.com/davep/evolve-words/issues
Project-URL: Discussions, https://github.com/davep/evolve-words/discussions
Keywords: evolution,science,example,illustration
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Environment :: Console
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Terminals
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: textual>=0.40.0
Requires-Dist: textual-plotext>=0.2.1

# Evolve Words

## Introduction

Many moons ago, back in 2008, while in a debate on an atheist-oriented phpBB
site (as was the fashion back then), I ended up writing [a couple of
scripts](https://github.com/davep/selection), in ruby, to illustrate a point
about how mutation and selection can, given enough time, result in something
with the appearance of design.

The code was far from a mic-drop body of evidence (it wasn't meant to be), I
think it did an okay job of showing how nothing more than just mutating
something and selecting for the "fitter" options can get you somewhere
meaningful given enough time.

No matter, either you get the illustration or you don't. That's not
important.

Fast forward 15 years and I was thinking that a Textual version of the code
might be fun.

![Evolve Words](https://raw.githubusercontent.com/davep/evolve-words/main/evolve-words.png)

This is a version of
[`selection2`](https://github.com/davep/selection/blob/master/selection2).
Turns out it *is* fun!

## Installation

If you want to play with this, the best method is going to be to install
with `pipx`:

```sh
$ pipx install evolve-words
```

then simply run `evolve-words`.

## Requirements

While this code *should* work fine on any operating system, it's really
coded to work on a system that provides one of the two following files:

- `/usr/dict/words`
- `/usr/share/dict/words`

That does, of course, mean it's unlikely to work fine on Windows given
neither of them will be there. At some point in the very near future I'll
add support for loading words from a file whose name is passed on the
command line, or something similar.

[//]: # (README.md ends here)
