typesum 0.2.0

Generate useful functions for a sumtype

This can generate both the usual `as, as_mut, into` as well as `try` variants
(which return a `Result` rather than `Option`). The methods that get generated
can be configured by passing different arguments to the `sumtype` invocation,
either at the top level (which sets the default) or on a per variant basis

```rust,compile_fail
use typesum::{sumtype, TryIntoError};
#[sumtype(is = false)]
enum MySum {
    I(i64),
    B(bool),
}
MySum::I(50).is_i() // uh oh, we disabled this one
```

## Options

| Function name   | Argument name | Return           | Default |
| --------------- | ------------- | ---------------- | ------- |
| `try_as_{}`     | `try_as`      | `Result<&T>`     | `true`  |
| `try_as_{}_mut` | `try_as_mut`  | `Result<&mut T>` | `true`  |
| `try_into_{}`   | `try_into`    | `Result<T>`      | `true`  |
| `as_{}`         | `as`          | `Option<&T>`     | `true`  |
| `as_{}_mut`     | `as_mut`      | `Option<&mut T>` | `true`  |
| `into_{}`       | `into`        | `Option<T>`      | `true`  |
| `is_{}`         | `is`          | `bool`           | `true`  |

where `{}` is the name of the variant in snake_case

Also the impls

| Trait        | Argument name   | Default |
| ------------ | --------------- | ------- |
| `From<T>`    | `from`          | `true`  |
| `TryInto<T>` | `impl_try_into` | `false` |

This is a total of 7 functions and 2 impls per enum variant, which
can explode pretty quick

```rust
use typesum::{sumtype, TryIntoError};
#[sumtype(impl_try_into)]
enum MySum {
    I(i64),
    B(bool),
}
let v = MySum::B(true);
let r: Result<i64, _> = v.try_into();
assert_eq!(r, Err(TryIntoError::new("MySum", "B", "I")));

```

### `all` and `ignore`

You can turn on and off everything with the `all` option (`ignore` is an alias
for `all = false`):

```rust
use typesum::{sumtype, TryIntoError};
#[sumtype(all = false, is = true)]
enum MySum {
    I(i64),
    B(bool),
}
let m = MySum::B(true);
assert!(!m.is_i());
```

This of course works at the level of variants, inheriting as usual

```rust
use typesum::{sumtype, TryIntoError};
#[sumtype(all = false)]
enum MySum {
    I(i64),
    #[sumtype(all)]
    B(bool),
}
let m = MySum::B(true);
assert_eq!(m.into_b(), Some(true));
```

But you are not allowed to have a sumtype annotation that doesn't do anything

```rust,compile_fail
use typesum::{sumtype, TryIntoError};
#[sumtype]
enum MySum {
    #[sumtype(ignore)]
    I(i64),
    #[sumtype(ignore)]
    B(bool),
}
```

In any way

```rust,compile_fail
use typesum::{sumtype, TryIntoError};
#[sumtype(all = false)]
enum MySum {
    I(i64),
    B(bool),
}
```

### `only`

There is also a special `only = attr` field for an argument. This is the same as `(all = false, attr = true)` e.g.

```rust
use typesum::sumtype;
#[sumtype]
enum VeryFunny {
    NonUnit(()),
    #[sumtype(only = is)]
    Unit,
}
let funny = VeryFunny::Unit;
assert!(funny.is_unit());
```

This would fail if we didn't only derive `is` since anything else requires it to be a unit variant.

You also are not allowed to set `only` to an invalid property :p

```rust,compile_fail
use typesum::sumtype;
#[sumtype]
enum NiceTry {
    #[sumtype(only = oopsie)]
    Try(()),
}
```

## TryInto and generic types

Because of the blanket impl on `TryInto` in the standard library, it is not possible to
implement `TryInto` for generic types. For this reason `TryInto` implementations will not
be generated for generic enum's. The `try_into_{}` method is still generated though

```rust
use typesum::{sumtype, TryIntoError};
#[sumtype(from = false)]
enum Either<L, R> {
    Left(L),
    Right(R),
}
let left = Either::<u64, &str>::Left(5);
assert_eq!(left.try_into_right(), Err(TryIntoError::new("Either", "Left", "Right")));
```

## `From` with overlapping types

If there are multiple valid `from` targets, you will get a compile error. You need to
explicitly annotate with `#[sumtype(from = false)]`, this is a design decision over
the alternative of simply silently not generating the `From` implementations on a
conflict.

```rust,compile_fail
#[sumtype(from = true)]
enum Overlapping {
    Int1(i64),
    Int2(i64),
}
```

## Compile times with large enums

For every `try_` function and `impl TryInto`, `n` matches need to be generated
(where `n` is the number of variants in your enum, _including_ ignored variants).
This means that on the default settings `3n^2` matches will be generated, and
if you also ask it to generate the `TryInto`'s it becomes `4n^2`. This isn't
noticeable for normal sized enums (like 5-10 variants) but due to the exponential
scaling you may start to notice compile time impacts with large ones.

If you do encounter this you should annotate the variants you don't need with
`#[sumtype(try_as = false, try_into = false, try_as_mut = false)]` (or put it
in the top-level one to disable them entirely).