Metadata-Version: 2.4
Name: notgiven
Version: 0.0.2
Summary: Micro library that defines NotGiven and NOT_GIVEN
Author-email: Ryan Young <dev@ryayoung.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.12
Description-Content-Type: text/markdown

## `NotGiven` and `NOT_GIVEN`

```
pip install notgiven
```

```python
from notgiven import (
    NotGiven,
    NOT_GIVEN,
    is_given,
    is_not_given,
    is_given_guard,
    is_not_given_guard,
)
```

### The details

- `NOT_GIVEN` is the only instance of `NotGiven`
- `NOT_GIVEN` is falsy (`if NOT_GIVEN` always returns False)
- Pickling/unpickling, copying, and deepcopying `NOT_GIVEN` all return the same value.
- `NOT_GIVEN`'s string representation is `"NOT_GIVEN"`
- `NOT_GIVEN` has no slots, so attributes may not be set on it.
- Cannot instantiate `NotGiven`
- Cannot subclass `NotGiven`
