[![Actions Status](https://github.com/sanko/Acme-Free-Advice-Slip/actions/workflows/ci.yml/badge.svg)](https://github.com/sanko/Acme-Free-Advice-Slip/actions) [![MetaCPAN Release](https://badge.fury.io/pl/Acme-Free-Advice-Slip.svg)](https://metacpan.org/release/Acme-Free-Advice-Slip)
# NAME

Acme::Free::Advice::Slip - Seek Advice from the Advice Slip API

# SYNOPSIS

```perl
use Acme::Free::Advice::Slip qw[advice];
say advice( 224 )->{advice};
```

# DESCRIPTION

Acme::Free::Advice::Slip provides wisdom from [AdviceSlip.com](https://adviceslip.com/).

# METHODS

These functions may be imported by name or with the `:all` tag.

## `advice( [...] )`

```perl
my $widsom = advice( ); # Random advice
my $advice = advice( 20 ); # Advice by ID
```

Seek advice.

You may request specific advice by ID.

Advice is provided as a hash reference containing the following keys:

- `advice`

    The sage advice you were looking for.

- `id`

    The advice's ID in case you'd like to request it again in the future.

## `search( ... )`

```perl
my @slips = search( 'time' );
```

Seek topical advice.

Advice is provided as a list of hash references containing the following keys:

- `advice`

    The sage advice you were looking for.

- `date`

    The date the wisdom was added to the database. It's in YYYY-MM-DD.

    I'm not sure why this isn't also returned when requesting advice by ID but that's how the backend works.

- `id`

    The advice's ID in case you'd like to request it again in the future.

# LICENSE & LEGAL

Copyright (C) Sanko Robinson.

This library is free software; you can redistribute it and/or modify it under the terms found in the Artistic License
2\. Other copyrights, terms, and conditions may apply to data transmitted through this module.

[AdviceSlip.com](https://adviceslip.com/) is brought to you by [Tom Kiss](https://tomkiss.net/).

# AUTHOR

Sanko Robinson <sanko@cpan.org>

## ...but why?

I'm inflicting this upon the world because [oodler577](https://github.com/oodler577/) invited me to help expand Perl's
coverage of smaller open APIs. Blame them or [join us](https://github.com/oodler577/FreePublicPerlAPIs) in the effort.