Go to file
Chris Morgan ec57ec49be Reduce the work for rustc in the benchmarks.
This *does* mean that they no longer function as tests, which was
deliberate, but rustc is just too slow with the assertions in there as
well. If I care, I can make variants of it that actually test. For now,
I’m sufficiently happy with it.
2016-06-11 13:28:30 +10:00
src Reduce the work for rustc in the benchmarks. 2016-06-11 13:28:30 +10:00
.gitignore Ignore Cargo.lock (this is a library). 2014-08-22 19:12:54 -07:00
.travis.yml s/unstable/bench/ in travis config 2016-03-05 13:27:54 +11:00
Cargo.toml 0.12.0 2016-03-05 13:31:53 +11:00
COPYRIGHT Initial release. 2014-06-12 17:29:24 +10:00
LICENSE-APACHE Initial release. 2014-06-12 17:29:24 +10:00
LICENSE-MIT Initial release. 2014-06-12 17:29:24 +10:00
README.md Rename 'nightly' feature to 'unstable'. 2015-06-10 09:02:10 +10:00

AnyMap, a safe and convenient store for one value of each type

Build Status

If youre familiar with Go and Go web frameworks, you may have come across the common “environment” pattern for storing data related to the request. Its typically something like map[string]interface{} and is accessed with arbitrary strings which may clash and type assertions which are a little unwieldy and must be used very carefully. (Personally I would consider that it is just asking for things to blow up in your face.) In a language like Go, lacking in generics, this is the best that can be done; such a thing cannot possibly be made safe without generics.

As another example of such an interface, JavaScript objects are exactly the same—a mapping of string keys to arbitrary values. (There it is actually more dangerous, because methods and fields/attributes/properties are on the same plane.)

Fortunately, we can do better than these things in Rust. Our type system is quite equal to easy, robust expression of such problems.

The AnyMap type is a friendly wrapper around a HashMap<TypeId, Box<Any>>, exposing a nice, easy typed interface, perfectly safe and absolutely robust.

What this means is that in an AnyMap you may store zero or one values for every type.

Instructions

Cargo all the way: it is anymap on crates.io.

For users of the nightly instead of the beta of rustc there are a couple of things behind the unstable feature like a drain method on the RawAnyMap and a more efficient hashing technique which makes lookup in the map a tad faster.

Author

Chris Morgan (chris-morgan) is the primary author and maintainer of AnyMap.

License

This library is distributed under similar terms to Rust: dual licensed under the MIT license and the Apache license (version 2.0).

See LICENSE-APACHE, LICENSE-MIT, and COPYRIGHT for details.