Returns Versions Save

Announcing article: https://sobolevn.me/2020/02/typed-functional-dependency-injection

Features

• Breaking: renames join to flatten, sorry!

• Breaking: renames box to bind and moves it to returns.pointfree

• Breaking: removes Maybe.rescue and Maybe.fix methods

• Breaking: renames io_squash to squash_io and moves it to returns.converters

• Breaking: moves all interfaces from returns.primitives.container to returns.primitives.interfaces

• Adds rescue pointfree function

• Adds ResultE alias for Result[..., Exception]

• Adds RequiresContext container and Context helper class

• Adds RequiresContext support for bind pointfree function

• Adds RequiresContext support for flatten function

• Adds RequiresContextResult container

• Adds RequiresContextResultE alias

• Adds ReaderResult and ReaderResultE aliases for RequiresContextResult[..., ..., Exception]

• Adds RequiresContextResult support for bind and rescue

• Adds RequiresContextResult support for flatten

• Adds IOResult helper to work better with IO[Result[a, b]]

• Adds IOResultE alias for IOResult[a, Exception]

• Adds IOResult support for bind

• Adds IOResult support for flatten

• Adds IOResult support for @pipeline

• Adds IOResult support for coalesce

• Adds IOResult support for is_successful

• Adds RequiresContextIOResult container

• Adds RequiresContextIOResultE alias

• Adds ReaderIOResult and ReaderIOResultE aliases for RequiresContextIOResult[..., ..., Exception]

• Adds RequiresContextIOResult support for bind and rescue

• Adds RequiresContextIOResult support for flatten

• Adds Result.lift, Maybe.lift, RequiresContext.lift, and RequiresContextResult.lift functions in addition to IO.lift

• Adds Immutable primitive type

• Adds Unitable protocol and .from_success() and .from_failure() methods for all Result realted classes

• Adds Instanceable protocol and .from_value() method for IO and RequiresContext

• Adds flow function, which is similar to pipe

• Adds swap coverter for Result and IOResult

• Adds squash_context function to squash RequiresContext similar to IO

Bugfixes

• Now Success and Failure (both io and pure) return Any and not NoReturn
• Fixes how flatten works, also adds more tests and docs about Failure case
• Fixes Unwrappable type being parametrized with only one TypeVar
• Changes Success and Failure to return Any instead of NoReturn

Misc

• Updates poetry version in travis
• Imporves pipe docs with lambda and Generic problem
• Improves docs in several places
• Now examples in docs tries to be docstests where possible
• Changes how tests are checked with mypy in CI

Features

• Breaking: now @pipeline requires a container type when created: @pipeline(Result) or @pipeline(Maybe)
• Maybe and Result now has success_type and failure_type aliases
• Adds Result.unify utility method for better error type composition
• We now support dry-python/classes as a first-class citizen
• Adds io_squash to squash several IO containers into one container with a tuple inside, currently works with 9 containers max at a time
• Adds untap function which does convert return type to None

Bugfixes

• Fixes that containers were not usable with multiprocessing
• Changes the inheritance order, now BaseContainer is the first child
• Fixes that Nothing had incorrect docstrings

Misc

• Now generated package is protected
• Updates poetry to 1.0

Features

• Breaking: now pipe() does not require argument to be the first value, instead it is required to use: pipe(f1, f2, f3, f4)(value)
• Breaking: dropped everything from returns/__init__.py, because we now have quite a lot of stuff
• Breaking: dropped support of zero argument functions for Nothing.fix
• Breaking: dropped support of zero argument functions for Nothing.rescue
• Maybe now has .failure() to match the same API as Result
• Adds identity function
• Adds tap function
• Now pipe allows to pipe 8 steps
• Adds coalesce_result and coalesce_maybe coverters

Bugfixes

• Fixes that code inside .fix and .rescue of Maybe might be called twice

Misc

• Now all methods have doctests
• Updates docs about Success and _Success, Failure and _Failure
• Updates docs about @pipeline
• Typechecks async functions and decorators inside typesafety/ tests

Features

• Breaking: python>=3.7,<=3.7.2 are not supported anymore, because of a bug inside typing module
• Breaking: Now bind does not change the type of an error
• Breaking: Now rescue does not change the type of a value
• Breaking: Renames map_failure to alt
• Adds box() function with the ability to box function for direct container composition like: a -> Container[b] to Container[a] -> Container[b]
• Adds IO.lift() function to lift a -> a to IO[a] -> IO[a]
• Adds pipe() function to pipeline.py
• Adds __hash__() magic methods to all containers

Bugfixes

• Changes Any to NoReturn in Success and Failure
• Now all type parameters in Result, Maybe, and IO are covariant

Misc

• Massive docs rewrite
• Updates mypy version
• Updates wemake-python-styleguide and introduces nitpick
• Updates pytest-plugin-mypy, all tests now use yml

Features

• Provides a bunch of primitive interfaces to write your own containers
• Adds .map_failure() method
• Adds join() function to join nested containers

Bugfixes

• Fixes type of Maybe.fix and Maybe.rescue to work with both lambda: 1 and lambda _: 1

Misc

• Improves README

Features

• Reintroduces the Maybe monad, typed!
• Introduces converters from one type to another
• Adds mypy plugin to type decorators
• Complete rewrite of Result types
• Partial API change, now Success and Failure are not types, but functions
• New internal types introduced: FixableContainer and ValueUnwrapContainer

Bugfixes

• Fixes issue when you could return IO container from Result.bind
• Fixes @pipeline return type

Misc

• Reapplied all types to .py files
• Improved docs about IO and Container concept
• Adds docs about container composition
• Moves from Alpha to Beta

Features

• Adds IO marker
• Adds unsafe module with unsafe functions
• Changes how functions are located inside the project

Bugfixes

• Fixes container type in @pipeline
• Now is_successful is public
• Now raise_exception is public

Misc

• Changes how str() function works for container types
• Total rename to "container" in the source code

Features

• safe and pipeline now supports asyncio
• is_successful now returns Literal types if possible

Features

• Adds compose helper function
• Adds public API to import returns
• Adds raise_exception helper function
• Adds full traceback to .unwrap()

Misc

• Updates multiple dev-dependencies, including mypy
• Now search in the docs is working again
• Relicenses this project to BSD
• Fixes copyright notice in the docs

Features

• Moves all types to .pyi files
• Renames all classes according to new naming pattern
• HUGE improvement of types
• Renames fmap to map
• Renames do_notation to pipeline, moves it to functions.py
• Renames ebind to rescue
• Renames efmap to fix
• Renames Monad to Container
• Removes Maybe monad, since typing does not have NonNullable type