The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Twitter::API::Trait::DecodeHtmlEntities - Decode HTML entities in strings

VERSION

version 1.0006

SYNOPSIS

    use Twitter::API;
    use open qw/:std :utf8/;

    my $client = Twitter::API->new_with_traits(
        traits => [ qw/ApiMethods DecodeHtmlEntites/ ],
        %other_options
    );

    my $status = $client->show_status(801814387723935744);
    say $status->{text};

    # output:
    # Test DecodeHtmlEntities trait. < & > ⚠️ 🏉 'single' "double"
    #
    # output without the DecodeHtmlEntities trait:
    # Test DecodeHtmlEntities trait. &lt; &amp; &gt; ⚠️ 🏉 'single' "double"

DESCRIPTION

Twitter has trust issues. They assume you're going to push the text you receive in API responses to a web page without HTML encoding it. But you HTML encode all of your output right? And Twitter's lack of trust has you double encoding entities.

So, include this trait and Twitter::API will decode HTML entities in all of the text returned by the API.

You're welcome.

AUTHOR

Marc Mims <marc@questright.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015-2021 by Marc Mims.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.