Metadata-Version: 2.4
Name: py-drivel
Version: 0.1.0
Summary: Get fun metasyntactic variable names
Project-URL: homepage, https://github.com/dusktreader/drivel
Project-URL: source, https://github.com/dusktreader/drivel
Project-URL: changelog, https://github.com/dusktreader/drivel/blob/main/CHANGELOG.md
Author-email: Tucker Beck <tucker.beck@gmail.com>
License-File: LICENSE.md
Requires-Python: >=3.10
Requires-Dist: auto-name-enum>=2.0.0
Requires-Dist: inflection>=0.5.1
Requires-Dist: loguru>=0.7.3
Requires-Dist: py-buzz>=5.0.2
Requires-Dist: pydantic>=2.10.6
Requires-Dist: pyperclip>=1.9.0
Requires-Dist: snick>=1.4.1
Requires-Dist: strictyaml>=1.7.3
Requires-Dist: toml>=0.10.2
Requires-Dist: typer>=0.15.2
Description-Content-Type: text/markdown

[![Build Status](https://github.com/dusktreader/drivel/actions/workflows/push.yaml/badge.svg)](https://github.com/dusktreader/drivel/actions/workflows/push.yaml)
[![PyPI Versions](https://img.shields.io/pypi/v/drivel?style=plastic&label=pypi-version)](https://img.shields.io/pypi/v/drivel?style=plastic&label=pypi-version)

> [!IMPORTANT]
> I'm looking for a job right now! If you know of any openings that match my skill-set,
> please let me know! You can read my resume over at my
> [cv site](https://cv.dusktreader.dev). Thanks!!

# Drivel

[//]: # (Add an asciicast)

`drivel` is a package and CLI application to provide you with
[metasyntactic](https://en.wikipedia.org/wiki/Metasyntactic_variable) name values.

It is a port/modernization of the [metasyntactic](https://github.com/ask/metasyntactic) package that is quite old and
unmaintained.

There are a few more categories added in.


## Quickstart

### Install `drivel`:

```bash
pip install drivel
```

### CLI

#### [Optional] Configure `drivel`:

To see all the configuration options, run:

```bash
drivel config --help
```

The simplest working config would look like this:

```bash
drivel config bind --default-theme=star-wars
```

#### Run `drivel`:

To get 10 metasyntactic names from the default theme, run:

```bash
drivel give 10
```


### Package

Just import in your code, and go!

```python
from drivel.themes import Theme

print(Theme.load().give())
```

## Configuration

The `drivel` CLI stores its configuration in a file so that it can use
the same settings for many runs without having a super-cluttered command line. You can
check out the location where the config file is saved in the `config.py` module.

[//]: # (Add documentation for the config subcommands here in the vein of smart-letters)
[//]: # (Add documentation for the other subcommands here in the vein of smart-letters)


## License

Distributed under the MIT License. See `LICENSE.md` for more information.
