Parse social media attributes from url or construct url from attributes.
Add this line to your application's Gemfile:
gem 'social_media_parser'
And then execute:
$ bundle
Or install it yourself as:
$ gem install social_media_parser
parser = SocialMediaParser.parse "https://www.facebook.com/teamcoco"
=> #<SocialMediaParser::Provider::Facebook:0x007fe014ef0f78 @url="https://www.facebook.com/teamcoco">
parser.username
=> "teamcoco"
parser.provider
=> "facebook"
parser.url
=> "https://www.facebook.com/teamcoco"
SocialMediaParser.parse
accepts either a url string or a hash, that accepts
{
username: "teamcoco",
provider: "facebook",
url: "https://www.facebook.com/teamcoco",
url_or_username: "teamcoco"
}
The url_or_username
option can be used when you're not sure of the input, like the screenshot below for instance. This gem is built to take user input directly.
If the input provided isn't enough for SocialMediaParser to figure out which provider it is, it returns a SocialMediaParser::Link
object instead.
link = SocialMediaParser.parse "www.ruby-lang.org/en/"
=> #<SocialMediaParser::Link:0x007fe014fd8350 @url="https://www.ruby-lang.org/en/">
link.url
=> "http://www.ruby-lang.org/en/"
The url
method will always return a clean url, prepending http schema if needed and validating the top domain, using public_suffix.
We use this gem to provide a unified way to describe a social media object, from any given input. Most notably, if you're working with Traackr Api, you'll know they don't provide a url to a social media profile, whereas input directly from a user will likely only have a url.
Ruby > 1.9