Skip to main content

Provides a Maybe class as a Python implementation of null-aware operators.

Project description

Overview

Provides a Maybe class which serves as a pseudo-implementation of null-aware operators in python:

  • can be used to avoid common var if var is not None else handle_none(var) structures
  • Null-aware item access
  • Null-aware attribute access
  • Null-aware chained method calls
  • Can be combined with all arithmetic and bitwise operators

Installation

To install use pip:

$ pip install maybe-else

Or clone the repo:

$ git clone https://github.com/matthewgdv/maybe.git
$ python setup.py install

Usage

The simplest use-case is to wrap the value in the Maybe class and call Maybe.else_() with an alternative value. If the initial value was None, the alternative value will be returned. Otherwise the original value will be returned.

Maybe(None).else_("other")                      # "other"
Maybe("hi").else_("other")                      # "hi"

More complex uses involve chaining item/attribute access and method calls off the initial value. If at any point an IndexError or KeyError (item access), AttributeError (attribute access), or TypeError (method call) is raised, the alternative value will be returned upon calling Maybe.else_(). Other exception classes are not caught by Maybe (intentionally) and will have be to handled normally.

Maybe("hi").monkeyweasel[3].else_("other")      # "other"
Maybe({"one": "1"})["one"].isnumeric().else_("other")   # True

Most operators can be used with Maybe. Actions involving operators will ignore TypeError, but other types of exceptions will have to be handled outside the Maybe construct.

(Maybe(8) / 2).else_("other")                   # 4.0
(Maybe("hi").upper() + "!").else_("other")      # "HI!"
(Maybe(None) // 3).else_("other")               # "other"
(Maybe(11) % 4).else_("other")                  # 3

If None would be returned as a result of operations performed on the Maybe object, then None will be returned from Maybe.else_(), rather than the alternative value. This is because None is a legitimate output value, so long as it was not the original input value.

Maybe({1: "1"}).get(2).else_("other")           # None

The Maybe class will be truthy whenever it would return what it is currently holding on calling Maybe.else_(), and will be falsy when it would return the alternative.

Contributing

Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.

You can contribute in many ways:

Report Bugs

Report bugs at https://github.com/matthewgdv/maybe/issues

If you are reporting a bug, please include:

  • Your operating system name and version.
  • Any details about your local setup that might be helpful in troubleshooting.
  • Detailed steps to reproduce the bug.

Fix Bugs

Look through the GitHub issues for bugs. Anything tagged with "bug" and "help wanted" is open to whoever wants to implement a fix for it.

Implement Features

Look through the GitHub issues for features. Anything tagged with "enhancement" and "help wanted" is open to whoever wants to implement it.

Write Documentation

The repository could always use more documentation, whether as part of the official docs, in docstrings, or even on the web in blog posts, articles, and such.

Submit Feedback

The best way to send feedback is to file an issue at https://github.com/matthewgdv/maybe/issues.

If you are proposing a new feature:

  • Explain in detail how it would work.
  • Keep the scope as narrow as possible, to make it easier to implement.
  • Remember that this is a volunteer-driven project, and that contributions are welcome :)

Get Started!

Before you submit a pull request, check that it meets these guidelines:

  1. If the pull request adds functionality, it should include tests and the docs should be updated. Write docstrings for any functions that are part of the external API, and add the feature to the README.md.

  2. If the pull request fixes a bug, tests should be added proving that the bug has been fixed. However, no update to the docs is necessary for bugfixes.

  3. The pull request should work for the newest version of Python (currently 3.7). Older versions may incidentally work, but are not officially supported.

  4. Inline type hints should be used, with an emphasis on ensuring that introspection and autocompletion tools such as Jedi are able to understand the code wherever possible.

  5. PEP8 guidelines should be followed where possible, but deviations from it where it makes sense and improves legibility are encouraged. The following PEP8 error codes can be safely ignored: E121, E123, E126, E226, E24, E704, W503

  6. This repository intentionally disallows the PEP8 79-character limit. Therefore, any contributions adhering to this convention will be rejected. As a rule of thumb you should endeavor to stay under 200 characters except where going over preserves alignment, or where the line is mostly non-algorythmic code, such as extremely long strings or function calls.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

maybe-else-0.2.0.tar.gz (4.6 kB view details)

Uploaded Source

Built Distribution

maybe_else-0.2.0-py3-none-any.whl (5.5 kB view details)

Uploaded Python 3

File details

Details for the file maybe-else-0.2.0.tar.gz.

File metadata

  • Download URL: maybe-else-0.2.0.tar.gz
  • Upload date:
  • Size: 4.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for maybe-else-0.2.0.tar.gz
Algorithm Hash digest
SHA256 fe765fde32818b71e75c37935e160f50cd38367258b9d2f88bacfc13e487d284
MD5 11c11bcbdac1cf1a9e1e8866458ad3a6
BLAKE2b-256 99c16509637fb0635725ed24636c03a31bd34771d5922789000c0c517e30bbc9

See more details on using hashes here.

File details

Details for the file maybe_else-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: maybe_else-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 5.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.4.0 requests-toolbelt/0.9.1 tqdm/4.36.1 CPython/3.7.4

File hashes

Hashes for maybe_else-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 957cd509353ad970a5c1799f547c52b991e395505bb0bccd952e5c9158f4a487
MD5 017c1187fd4b9cd6e1478111647c6533
BLAKE2b-256 b62eddd2460d7c9dd7a1ce2522c093eadaff8449baa1ef263356139cf0f845af

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page