Replace char::ANY with char::any().

The next version has breaking changes anyway, and this will allow
changing the representation of `CharStrategy` to be more efficient in
the future in order to address
#16.

Author: AltSysrq

CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ### Potential Breaking Changes
 
+- `proptest::char::ANY` replaced with `proptest::char::any()`.
+  `proptest::char::ANY` is present but deprecated, and will be removed in
+  proptest 0.5.0.
+
 - Instead of returning `-> Result<Self::Value, String>`, strategies are
   expected to return `-> Result<Self::Value, Reason>` instead. `Reason` reduces
   the amount of heap allocations, especially for `.prop_filter(..)` where you

src/char.rs

@@ -190,8 +190,18 @@ const WHOLE_RANGE: &[CharRange] = &[
     ('\x00', ::std::char::MAX)
 ];
 
-/// The `CharStrategy` which picks from literally any character, with
-/// the default biases.
+/// Creates a `CharStrategy` which picks from literally any character, with the
+/// default biases.
+pub fn any() -> CharStrategy<'static> {
+    CharStrategy {
+        special: Cow::Borrowed(DEFAULT_SPECIAL_CHARS),
+        preferred: Cow::Borrowed(DEFAULT_PREFERRED_RANGES),
+        ranges: Cow::Borrowed(WHOLE_RANGE),
+    }
+}
+
+#[allow(missing_docs)]
+#[deprecated(since="0.4.0", note="replaced with proptest::char::any()")]
 pub const ANY: CharStrategy<'static> = CharStrategy {
     special: Cow::Borrowed(DEFAULT_SPECIAL_CHARS),
     preferred: Cow::Borrowed(DEFAULT_PREFERRED_RANGES),
@@ -336,7 +346,7 @@ mod test {
         let mut runner = TestRunner::default();
 
         for _ in 0..1024 {
-            let ch = ANY.new_value(&mut runner).unwrap().current();
+            let ch = any().new_value(&mut runner).unwrap().current();
             if '🕴' == ch {
                 men_in_business_suits_levitating += 1;
             } else if ch >= ' ' && ch <= '~' {
@@ -354,7 +364,7 @@ mod test {
         let mut runner = TestRunner::default();
 
         for _ in 0..256 {
-            let mut value = ANY.new_value(&mut runner).unwrap();
+            let mut value = any().new_value(&mut runner).unwrap();
 
             if value.current() <= ' ' { continue; }
 
@@ -369,7 +379,7 @@ mod test {
 
     #[test]
     fn test_sanity() {
-        check_strategy_sanity(ANY, Some(CheckStrategySanityOptions {
+        check_strategy_sanity(any(), Some(CheckStrategySanityOptions {
             // `simplify()` can itself `complicate()` back to the starting
             // position, so the overly strict complicate-after-simplify check
             // must be disabled.

src/string.rs

@@ -123,7 +123,7 @@ pub fn bytes_regex_parsed(expr: &rs::Expr)
                          .collect::<Vec<_>>()).sboxed())
         },
 
-        AnyChar => Ok(char::ANY.prop_map(to_bytes).sboxed()),
+        AnyChar => Ok(char::any().prop_map(to_bytes).sboxed()),
         AnyCharNoNL => {
             static NONL_RANGES: &[(char,char)] = &[
                 ('\x00', '\x09'),