From ae26402c03d042960fe94d687bb142cab3c9c723 Mon Sep 17 00:00:00 2001 From: Ibraheem Ahmed Date: Fri, 8 Nov 2024 03:02:41 -0500 Subject: [PATCH 1/2] add alternatives section to readme --- README.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/README.md b/README.md index 9f9ee98..160ecd2 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,12 @@ under the `jsr166/` subdirectory for easy reference. The port was developed as part of a series of [live coding streams] kicked off by [this tweet]. +## Better Alternatives + +Flurry currently suffers performance and memory usage issues under load. +You may wish to consider [papaya] or [dashmap] as alternatives if this is +important to you. + ## License Licensed under either of @@ -36,3 +42,5 @@ dual licensed as above, without any additional terms or conditions. [live coding streams]: https://www.youtube.com/playlist?list=PLqbS7AVVErFj824-6QgnK_Za1187rNfnl [this tweet]: https://twitter.com/jonhoo/status/1194969578855714816 [upstream tests]: https://hg.openjdk.java.net/jdk/jdk13/file/tip/test/jdk/java/util/concurrent/ConcurrentHashMap + [papaya]: https://github.com/ibraheemdev/papaya + [dashmap]: https://github.com/xacrimon/dashmap From 3df8c41c2db63be92ad8165a30f75304fa6a751c Mon Sep 17 00:00:00 2001 From: Ibraheem Ahmed Date: Fri, 8 Nov 2024 03:04:17 -0500 Subject: [PATCH 2/2] add alternatives section to crate docs --- src/lib.rs | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/src/lib.rs b/src/lib.rs index 24d4b77..1c9333e 100644 --- a/src/lib.rs +++ b/src/lib.rs @@ -5,6 +5,12 @@ //! most part has a similar API. Even though all operations on the map are thread-safe and operate //! on shared references, retrieval operations do *not* entail locking, and there is *not* any //! support for locking the entire table in a way that prevents all access. +//! +//! # Better Alternatives +//! +//! Flurry currently suffers performance and memory usage issues under load. +//! You may wish to consider [`papaya`] or [`dashmap`] as alternatives if this is +//! important to you. //! //! # A note on `Guard` and memory use //! @@ -232,6 +238,8 @@ //! operation than if every individual value had to be atomically reference-counted. //! //! [`seize`]: https://docs.rs/seize +//! [`papaya`]: https://docs.rs/papaya +//! [`dashmap`]: https://docs.rs/dashmap #![deny( missing_docs, missing_debug_implementations,