# w_common 2.1.0

General utilities for Dart projects.




## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir
flutter pub add 'w_common:2.1.0'
```
Published: 2022-11-07T22:17:34.990975Z
Expected archive SHA-256: fe15c170e184d0a8194cd900656813913897d3246595e83ae403c22cfc7a9ac4

Available in cache; verification: upstream_checksum
## Direct dependencies
- intl: >=0.15.8 <0.18.0
- js: ^0.6.3
- logging: >=0.11.3+2 <2.0.0
- meta: ^1.3.0

## Package README (untrusted upstream documentation)
# w_common

A collection of helpful utilities for use in Dart projects. Right now, it
includes the following:

  * `Disposable` interface / mixin to assist with cleaning up streams and other
  data structures that won't necessarily be garbage collected without some
  manual intervention.
  * A simple typedef that can be parameterized to represent a zero-arity
  callback that returns a particular type.
  * `InvalidationMixin` mixin used to mark a class as requiring validation.
  * `JsonSerializable` interface to indicate that something can be serialized
  to JSON.
## Changelog
## [2.0.0](https://github.com/Workiva/w_common/compare/1.21.8...2.0.0)
_June 14, 2022_

**Breaking Changes:**
- Removes sass compilation tool from w_common. Use w_common_tools instead.
- Removes `DisposableManager`, `DisposableManagerV2`, `DisposableManagerV3`, 
`DisposableManagerV4`, `DisposableManagerV5`, and `DisposableManagerV6`. Use 
`DisposableManagerV7` instead.
- Removes `w_common.dart` entrypoint. Use the specific entrypoint related to 
the pieces of w_common you want to use instead. For example, 
`package:w_common/disposable.dart`.
- Changes to `Cache`:
  - Removes `keys` getter. Use `liveKeys` and `releasedKeys` instead.
  - Removes `values` getter. Use `liveValues` instead.
  - Removes `containsKey` method. Use `.contains` on `liveKeys` and `releasedKeys`
  instead.
- Changes to `Disposable`:
  - Removes `isDisposedOrDisposing`. Use `isOrWillBeDisposed` instead. This also returns
  true when the `Disposable` instance is in the "awaiting disposal" state that 
  is entered as soon as [dispose] is called.
  - Removes `isDisposing`. Use `isOrWillBeDisposed` instead.
  - Removes `manageAndReturnDisposable`. Use `manageAndReturnTypedDisposable` instead.
  - Removes `manageDisposer`. Use `getManagedDisposer` instead.
  - Removes `manageStreamSubscription`. Use `listenToStream` instead.


## [1.21.8](https://github.com/Workiva/w_common/compare/1.21.7...1.21.8)
_June 2, 2022_ 

- Added w_common_tools as a separate package.