Metadata-Version: 2.1
Name: py2be
Version: 0.0.1
Summary: Simple Python library determining whether strings indicate truey or falsy values
Home-page: https://github.com/synesissoftware/diagnosticism.Python
Author: Matt Wilson
Author-email: matthew@synesis.com.au
License: BSD-3-Clause
Keywords: configuration environment string traits
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
License-File: LICENSE

# py2be <!-- omit in toc -->

Simple Python library determining whether strings indicate truey or falsy values.

[![PyPI version](https://badge.fury.io/py/py2be.svg)](https://badge.fury.io/py/py2be)


## Introduction

**to-be** is a library providing facilities for determine whether the truthyness of strings. It implemented in several languages: **py2be** is the **Python** implementation.


## Table of Contents <!-- omit in toc -->


- [Introduction](#introduction)
- [Terminology](#terminology)
- [Project Information](#project-information)
	- [Where to get help](#where-to-get-help)
	- [Contribution guidelines](#contribution-guidelines)
	- [Dependencies](#dependencies)
		- [Dev Dependencies](#dev-dependencies)
	- [Related projects](#related-projects)
	- [License](#license)


## Terminology

The term "*truthy*" is an unhelpfully overloaded term in the programming world, insofar as it is used to refer to the notion of "truthyness" - whether something can be _deemed to be_ interpretable as truth - and also the true side of that interpretation. In this library, the former interpretation is used, leaving us with the following terms:

* "*truthy*" - whether something can be can be _deemed to be_ interpretable as having truth;
* "*falsey*" - whether an object can be _deemed to be_ interpretable as being false;
* "*truey*" - whether an object can be _deemed to be_ interpretable as being true;

For example, consider the following **Python** program:

```Python
from py2be import (
	string_is_falsey,
	string_is_truey,
	string_is_truthy,
)

s1 = "no"
s2 = "True"
s3 = "orange"

# "no" is validly truthy, and is falsey
assert string_is_falsey(s1)
assert !string_is_truey(s1)
assert string_is_truthy(s1)

# "True" is validly truthy, and is truey
assert !string_is_falsey(s2)
assert string_is_truey(s2)
assert string_is_truthy(s2)

# "orange" is not validly truthy, and is neither falsey nor truey
assert !string_is_falsey(s3)
assert !string_is_falsey(s3)
assert !string_is_truthy(s3)
```


## Project Information

### Where to get help

[GitHub Page](https://github.com/synesissoftware/py2be "GitHub Page")


### Contribution guidelines

Defect reports, feature requests, and pull requests are welcome on https://github.com/synesissoftware/py2be.


### Dependencies

**py2be** has no (non-development) dependencies.


#### Dev Dependencies

**py2be** has no (additional) development dependencies.


### Related projects

* [**to-be**](https://github.com/synesissoftware/to-be) (**C**);
* [**to-be.Ruby**](https://github.com/synesissoftware/to-be.Ruby);
* [**to-be.Rust**](https://github.com/synesissoftware/to-be.Rust);


### License

**py2be** is released under the 3-clause BSD license. See [LICENSE](./LICENSE) for details.


<!-- ########################### end of file ########################### -->



