station 0.0.145 → 0.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bf19ece7e99c058c80d1e930a5ba8a764043085f80cbcc5cd5aa89e4fcb6121e
-  data.tar.gz: 9e9fc51a8579f6b77b2a112616c35547b8f12b4c75bed40aed71ce736dfef727
+  metadata.gz: 7026b61938f7c15334d21fba932497479059ee788f8929e6dff75fa5f6952644
+  data.tar.gz: 9fc137c36e9f86be4b77b0299136393043ec3f871e8dc44d2e0c0ce5dacf1431
 SHA512:
-  metadata.gz: 76b4e6cfca0ece477ff5855ee40d8b21e9a5252927cfa9ef3a9218cda1a49d917fbb100293df679a288094b2baa4aef9c9c3873c06e7aab614140077dcd161bb
-  data.tar.gz: 3badd1111779f92524c07921d20ce7d99cf6750441d31e220b974745c9e5d0920a04df19c52f8bb1bb204fdc5b55720ad1936cfdd582faecd781670813249e40
+  metadata.gz: ece3452d41faa4062cd7da89547c5f6d2d39155e062f041c68b2e5f94761cdf0a6f529a8df7a83dbbf4c37ac0989b4a0b30d2750dc0962a7363112bde20f0450
+  data.tar.gz: d7f55344de98ad0f64ad8e30f9b232e58a8648d7f9d35a1be10e7fbe5bc3a68a7b0438cf787cdf1085b33ab31f8e7eb56daee112030892d81c81de53773fd15e

data/lib/nexmo_developer/Gemfile

@@ -95,6 +95,11 @@ gem 'bootsnap', require: false
 # Convenient diffing in ruby
 gem 'diffy', require: false
 
+# Provides estimated reading times (for our Blog)
+gem 'readingtime'
+
+gem 'addressable', '~> 2.8', require: false
+
 # Automatic Ruby code style checking tool. Aims to enforce the community-driven Ruby Style Guide.
 gem 'rubocop', '~> 1.10.0', require: false
 gem 'rubocop-rails', '~> 2.9', require: false
@@ -146,6 +151,7 @@ group :development, :test do
   # Call 'byebug' anywhere in the code to stop execution and get a debugger console
   gem 'byebug', platform: :mri
   gem 'pry', require: false
+  gem 'rails-controller-testing'
   gem 'rawler', git: 'https://github.com/oscardelben/rawler.git', require: false
   gem 'rspec-collection_matchers'
   gem 'rspec-rails', '~> 5.0'

data/lib/nexmo_developer/Gemfile.lock

@@ -409,6 +409,10 @@ GEM
       bundler (>= 1.15.0)
       railties (= 6.1.4)
       sprockets-rails (>= 2.0.0)
+    rails-controller-testing (1.0.5)
+      actionpack (>= 5.0.1.rc1)
+      actionview (>= 5.0.1.rc1)
+      activesupport (>= 5.0.1.rc1)
     rails-dom-testing (2.0.3)
       activesupport (>= 4.2.0)
       nokogiri (>= 1.6)
@@ -429,6 +433,7 @@ GEM
     rb-fsevent (0.11.0)
     rb-inotify (0.10.1)
       ffi (~> 1.0)
+    readingtime (0.4.0)
     recaptcha (5.8.1)
       json
     redcarpet (3.5.1)
@@ -617,6 +622,7 @@ PLATFORMS
 DEPENDENCIES
   actionpack-page_caching!
   activeadmin (~> 2.9)
+  addressable (~> 2.8)
   algoliasearch
   apparition
   awesome_print
@@ -659,7 +665,9 @@ DEPENDENCIES
   puma (>= 5.3.1)
   rack (>= 2.0.6)
   rails (~> 6.1.4)
+  rails-controller-testing
   rawler!
+  readingtime
   recaptcha
   redis
   rest-client

data/lib/nexmo_developer/app/assets/stylesheets/{application.css → application.scss}

@@ -1,5 +1,7 @@
 //= require stylesheets/nexmo-oas-renderer
 
+@import "blog/*";
+
 .Adp-use-cases__background {
   filter: blur(100px);
 }

data/lib/nexmo_developer/app/assets/stylesheets/blog/badge.scss

@@ -0,0 +1,245 @@
+.Vlt-badge--dispatch-api,
+.Vlt-badge--messages-api,
+.Vlt-badge--messages-api-sandbox,
+.Vlt-badge--number-insight-api,
+.Vlt-badge--number-api,
+.Vlt-badge--reports-api,
+.Vlt-badge--account-api,
+.Vlt-badge--pricing-api,
+.Vlt-badge--external-accounts-api,
+.Vlt-badge--redact-api,
+.Vlt-badge--audit-api,
+.Vlt-badge--verify-api,
+.Vlt-badge--media-api,
+.Vlt-badge--voice-api,
+.Vlt-badge--conversation-api,
+.Vlt-badge--video-api,
+.Vlt-badge--sms-api,
+.Vlt-badge--station {
+  background: black;
+  color: white;
+}
+
+.Vlt-badge--spotlight {
+  background-color: rgba(135, 31, 255, 1);
+  color: white;
+}
+
+.Vlt-badge--voyagers {
+  background-color: rgba(135, 31, 255, 1);
+  color: white;
+}
+
+.Vlt-badge--slack {
+  background: rgba(74, 21, 75, 0.4);
+  color: black;
+}
+
+.Vlt-badge--faunadb {
+  background: rgba(50, 63, 203, 0.4);
+  color: black;
+}
+
+.Vlt-badge--vue {
+  background-color: rgba(65, 184, 131, 0.4);
+  color: rgba(53, 73, 94, 1);
+}
+
+.Vlt-badge--nuxt {
+  background-color: rgba(0, 197, 142, 0.4);
+  color: black;
+}
+
+.Vlt-badge--ruby-on-rails,
+.Vlt-badge--ruby {
+  background-color: rgba(204, 52, 45, 0.4);
+  color: black;
+}
+
+.Vlt-badge--javascript {
+  background-color: rgba(247, 223, 30, 0.4);
+  color: black;
+}
+
+.Vlt-badge--typescript {
+  background-color: rgba(49, 120, 198, 0.4);
+  color: black;
+}
+
+.Vlt-badge--dotnet {
+  background-color: rgba(93, 37, 144, 0.4);
+  color: black;
+}
+
+.Vlt-badge--node {
+  background-color: rgba(61, 136, 54, 0.4);
+  color: black;
+}
+
+.Vlt-badge--deno {
+  background: rgba(22, 30, 46, 0.4);
+  color: black;
+}
+
+.Vlt-badge--node-red {
+  background-color: rgba(142, 1, 0, 0.4);
+  color: black;
+}
+
+.Vlt-badge--azure {
+  background-color: rgba(0, 127, 255, 0.4);
+  color: black;
+}
+
+.Vlt-badge--zapier {
+  background-color: rgba(255, 74, 0, 0.4);
+  color: black;
+}
+
+.Vlt-badge--go {
+  background-color: rgba(224, 235, 245, 0.4);
+  color: black;
+}
+
+.Vlt-badge--php {
+  background-color: rgba(35, 161, 170, 0.4);
+  color: black;
+}
+
+.Vlt-badge--aws {
+  background-color: rgba(33, 43, 58, 0.4);
+  color: black;
+}
+
+.Vlt-badge--firebase {
+  background-color: rgba(255, 202, 40, 0.4);
+  color: black;
+}
+
+.Vlt-badge--zendesk {
+  background-color: rgba(3, 54, 61, 0.4);
+  color: black;
+}
+
+.Vlt-badge--ibm-watson {
+  background-color: rgba(0, 98, 255, 0.4);
+  color: black;
+}
+
+.Vlt-badge--git {
+  background-color: rgba(241, 78, 50, 0.4);
+  color: black;
+}
+
+.Vlt-badge--github {
+  content: 'GitHub';
+  background-color: rgba(51, 51, 51, 0.4);
+  color: black;
+}
+
+.Vlt-badge--hacktoberfest {
+  background-color: rgba(7, 37, 64, 0.4);
+  color: black;
+}
+
+.Vlt-badge--digitalocean {
+  background-color: rgba(0, 105, 255, 0.4);
+  color: black;
+}
+
+.Vlt-badge--java {
+  background-color: rgba(1, 71, 110, 0.4);
+  color: black;
+}
+
+.Vlt-badge--python {
+  background-color: rgba(30, 56, 187, 0.4);
+  color: black;
+}
+
+.Vlt-badge--mongodb {
+  background-color: rgba(19, 170, 82, 0.4);
+  color: black;
+}
+
+.Vlt-badge--netlify {
+  background: linear-gradient(
+    to bottom,
+    rgba(35, 194, 184, 0.4),
+    rgba(55, 175, 188, 0.4)
+  );
+  color: black;
+}
+
+.Vlt-badge--postman {
+  background: rgba(255, 108, 55, 0.4);
+  color: black;
+}
+
+.Vlt-badge--opensource {
+  background: rgba(61, 166, 57, 0.4);
+  color: black;
+}
+
+.Vlt-badge--react-native,
+.Vlt-badge--react {
+  background: rgba(97, 218, 251, 0.4);
+  color: black;
+}
+
+.Vlt-badge--open-api {
+  background: rgba(56, 184, 50, 0.4);
+  color: black;
+}
+
+.Vlt-badge--inclusion {
+  background: linear-gradient(
+    90deg,
+    black,
+    black 12.5%,
+    rgba(117, 77, 21, 1) 12.5%,
+    rgba(117, 77, 21, 1) 25%,
+    rgba(240, 0, 0, 1) 25%,
+    rgba(240, 0, 0, 1) 37.5%,
+    rgba(255, 128, 0, 1) 37.5%,
+    rgba(255, 128, 0, 1) 50%,
+    rgba(255, 255, 0, 1) 50%,
+    rgba(255, 255, 0, 1) 62.5%,
+    rgba(0, 121, 64, 1) 62.5%,
+    rgba(0, 121, 64, 1) 75%,
+    rgba(64, 64, 255, 1) 75%,
+    rgba(64, 64, 255, 1) 87.5%,
+    rgba(160, 0, 192, 1) 87.5%,
+    rgba(160, 0, 192, 1)
+  );
+  color: white;
+  text-shadow: 1px 1px 2px rgba(0, 0, 0, 0.5), -1px -1px 2px rgba(0, 0, 0, 0.5),
+    -1px 1px 2px rgba(0, 0, 0, 0.5), 1px -1px 2px rgba(0, 0, 0, 0.5);
+}
+
+.Vlt-badge--diversity {
+  background: linear-gradient(
+    90deg,
+    rgba(85, 205, 252, 1),
+    rgba(85, 205, 252, 1) 20%,
+    rgba(247, 168, 184, 1) 20%,
+    rgba(247, 168, 184, 1) 40%,
+    white 40%,
+    white 60%,
+    rgba(247, 168, 184, 1) 60%,
+    rgba(247, 168, 184, 1) 80%,
+    rgba(85, 205, 252, 1) 80%,
+    rgba(85, 205, 252, 1) 100%
+  );
+  color: black;
+  text-shadow: 1px 1px 2px rgba(255, 255, 255, 0.5),
+    -1px -1px 2px rgba(255, 255, 255, 0.5),
+    -1px 1px 2px rgba(255, 255, 255, 0.5), 1px -1px 2px rgba(255, 255, 255, 0.5);
+}
+
+// HOVER effect for TAG labels
+a small[class*="Vlt-badge--"] {
+  transition: all .2s ease-in-out;
+
+  &:hover { transform: scale(1.1); }
+}

data/lib/nexmo_developer/app/assets/stylesheets/blog/blog.scss

@@ -0,0 +1,209 @@
+.max-w-screen-xl {
+  max-width: 1280px;
+}
+.mx-auto {
+  margin-left: auto;
+  margin-right: auto;
+}
+
+
+// Author info column
+#author-column {
+  width: 25%;
+  display: flex;
+  align-items: center;
+  flex-direction: column;
+}
+
+
+// High opacity gradient BG
+.gradient-bg {
+  // background: linear-gradient(to right, rgba(127, 198, 244, .1), rgba(213, 39, 155, .1));
+  background: linear-gradient(135deg, rgba(127, 198, 244, 0.3), rgba(213, 39, 155, 0.1));
+  background-attachment: fixed;
+  min-height: 100vh;
+}
+
+
+// border-top gradient for Author BIO
+.gradient-border-left {
+  border-left: 2px solid;
+  padding-left: 4px;
+  border-image:   linear-gradient(to bottom, rgba(127, 198, 244, .8), rgba(213, 39, 155, .8)) 5;
+}
+
+
+// Category titles separator
+.Vlt-text-separator span::before,
+.Vlt-text-separator span::after {
+  background: linear-gradient(to right, #7fc6f4, #d5279b) !important;
+}
+
+
+// Header IMG on blogpost_with_image card
+.card-header-image {
+  width: 100%;
+  height: 26rem;
+  background-size: cover;
+  background-position: center;
+}
+
+
+// Border radius top for blogpost_with_image partial
+.border-radius-top {
+  border-top-right-radius: 8px  !important;
+  border-top-left-radius: 8px   !important;
+  border-bottom-left-radius: 0  !important;
+  border-bottom-right-radius: 0 !important;
+}
+
+
+// Center Author name
+.center-author-name {
+  display: flex;
+  justify-content: center;
+}
+
+
+// image_tag Author
+.image-tag-author {
+  display: block; 
+  width: 4.5rem; 
+  height: 4.5rem; 
+  border-radius: 50%;
+}
+
+// < CATEGORY /> tag on blogposts
+.category-name {
+  display: block;
+  
+  padding: 16px 16px 0 16px;
+  
+  font-size: 1.5rem;
+  line-height: 3.25rem;
+  font-weight: bold;
+  text-transform: uppercase;
+  
+  // HOVER effect for CATEGORY labels
+  position: relative;
+  left: 0;
+  transition: all .2s ease-in-out;
+
+  &:hover { left: 5px; }
+}
+
+
+// Centering orizontally V-icon with text
+.fix-position-V-icon {
+  position: relative;
+  left: 2px;
+}
+
+
+// Centering orizontally V-icon with text
+.social-links {
+  text-align: center;
+}
+
+
+// Raw blogpost content in SHOW
+.raw_blopost_content {
+  margin-top: 3em;
+  
+  p {
+    font-size: 1.8rem;
+    letter-spacing: 0.5px;
+    color: #374151;
+    margin: 1em 0;
+    
+    strong {
+      display: inline-block;
+      margin: 1em 0;
+    }
+  }
+}
+
+
+// Blogpost card content
+.blogpost_card_content {
+  display: flex;
+  justify-content: space-between;
+  flex-direction: column;
+  flex-grow: 1;
+}
+
+
+// Category header separator
+.author-title {
+  margin-bottom:16px;
+  text-align: center;
+}
+
+
+// Category header separator
+.header-separator {
+  opacity: .6;
+  letter-spacing: .1em;
+}
+
+
+// display flex for card content
+.d-flex-column {
+  display: flex;
+  justify-content: space-between;
+  flex-direction: column;
+}
+
+
+// CUSTOM GRID 
+.my-2col-grid {
+  display: grid !important;
+  grid-template-columns: repeat(2, 1fr) !important;
+  grid-auto-rows: 1fr !important;
+  grid-column-gap: 10px !important;
+  grid-row-gap: 10px !important;
+  
+  .Vlt-card:hover {
+    -webkit-transform: none;
+    transform: none;
+    -webkit-box-shadow: 0 10px 30px rgba(19, 20, 21, .1);
+    box-shadow: 0 10px 30px rgba(19, 20, 21, .1);
+    transform: none;
+  }
+  
+  .Vlt-card {
+    -webkit-box-shadow: none;
+    box-shadow: none;
+    border: 1px solid #e6e6e6;
+    -webkit-transition: -webkit-box-shadow ease-in 0.25s;
+    transition: -webkit-box-shadow ease-in 0.25s;
+    transition: box-shadow ease-in 0.25s;
+    transition: box-shadow ease-in 0.25s, -webkit-box-shadow ease-in 0.25s;
+  }
+}
+
+.my-3col-grid {
+  display: grid !important;
+  grid-template-columns: repeat(3, 1fr) !important;
+  grid-auto-rows: 1fr !important;
+  grid-column-gap: 10px !important;
+  grid-row-gap: 10px !important;
+  
+  .Vlt-card:hover {
+    -webkit-transform: none;
+    transform: none;
+    -webkit-box-shadow: 0 10px 30px rgba(19, 20, 21, .1);
+    box-shadow: 0 10px 30px rgba(19, 20, 21, .1);
+    transform: none;
+  }
+  
+  .Vlt-card {
+    -webkit-box-shadow: none;
+    box-shadow: none;
+    border: 1px solid #e6e6e6;
+    -webkit-transition: -webkit-box-shadow ease-in 0.25s;
+    transition: -webkit-box-shadow ease-in 0.25s;
+    transition: box-shadow ease-in 0.25s;
+    transition: box-shadow ease-in 0.25s, -webkit-box-shadow ease-in 0.25s;
+  }
+}

data/lib/nexmo_developer/app/controllers/blog/authors_controller.rb

@@ -0,0 +1,8 @@
+class Blog::AuthorsController < Blog::MainController
+  def show
+    data       = BlogpostParser.fetch_all.select { |b| b['published'] && !b['outdated'] }
+    attributes = AuthorParser.fetch_author(params[:name]) || {}
+
+    @author    = Blog::Author.new(attributes).build_all_blogposts_from_author(data)
+  end
+end

data/lib/nexmo_developer/app/controllers/blog/blogpost_controller.rb

@@ -0,0 +1,32 @@
+class Blog::BlogpostController < Blog::MainController
+  LATEST_FOR_PREVIEW    = 2
+  BLOGPOSTS_FOR_PREVIEW = 6
+  RELATED_FOR_PREVIEW   = 3
+
+  def index
+    #   Fetch data as Json
+    data = BlogpostParser.fetch_all
+                         .select { |b| b['published'] && !b['outdated'] }
+
+    @authors = AuthorParser.fetch_all_authors
+    categories = CategoryParser.fetch_all_categories
+
+    #  Build Blogposts by category
+    @categories_with_blogposts = categories.map do |category|
+      Blog::Category.new(category).build_n_blogposts_by_category(data, BLOGPOSTS_FOR_PREVIEW)
+    end
+
+    #   Build latest Blogposts
+    @latest_blogposts = data.first(LATEST_FOR_PREVIEW)
+                            .map { |attributes| Blog::Blogpost.new(attributes) }
+  end
+
+  def show
+    data = BlogpostParser.fetch_all
+    @blogpost = Blog::Blogpost.build_blogpost_from_path(params[:blog_path], 'en')
+    @related_blogposts = data.select { |b| b['category']['slug'] == @blogpost.category.slug && b['title'] != @blogpost.title && b['published'] && !b['outdated'] }
+                             .first(RELATED_FOR_PREVIEW)
+                             .sort_by { |b| b['updated_at'] }.reverse
+                             .map { |attributes| Blog::Blogpost.new attributes }
+  end
+end

data/lib/nexmo_developer/app/controllers/blog/categories_controller.rb

@@ -0,0 +1,8 @@
+class Blog::CategoriesController < Blog::MainController
+  def show
+    data = BlogpostParser.fetch_all.select { |b| b['published'] && !b['outdated'] }
+    attributes = CategoryParser.fetch_category(params[:slug])
+
+    @category_with_all_blogposts = Blog::Category.new(attributes).build_n_blogposts_by_category(data)
+  end
+end

data/lib/nexmo_developer/app/controllers/blog/main_controller.rb

@@ -0,0 +1,9 @@
+class Blog::MainController < ApplicationController
+  before_action :add_gradient_bg
+
+  private
+
+  def add_gradient_bg
+    @gradient_bg = true
+  end
+end

data/lib/nexmo_developer/app/controllers/blog/tags_controller.rb

@@ -0,0 +1,8 @@
+class Blog::TagsController < Blog::MainController
+  def show
+    @tag = params['slug']
+
+    blogposts = TagParser.fetch_blogposts_with_tag(params[:slug])
+    @blogposts = blogposts.map { |attributes| Blog::Blogpost.new attributes }
+  end
+end

data/lib/nexmo_developer/app/helpers/blog_helper.rb

@@ -0,0 +1,7 @@
+module BlogHelper
+  def readind_time_without_code_tags(content)
+    regexp = Regexp.new(%r{<pre class=.*main-code(.*?)</code></pre>}m)
+
+    "#{content.gsub(regexp, '').reading_time format: :approx} read"
+  end
+end

data/lib/nexmo_developer/app/models/blog/author.rb

@@ -0,0 +1,59 @@
+class Blog::Author
+  attr_reader :name, :title, :bio, :short_name, :email, :image_url,
+              :author, :alumni, :team, :hidden, :spotlight, :noteworthy,
+              :website_url, :twitter, :linkedin_url, :github_url, :youtube_url,
+              :facebook_url, :stackoverflow_url, :twitch_url, :blogposts, :url
+
+  DEFAULT_AVATAR = 'https://s3.eu-west-1.amazonaws.com/developer.vonage.com/vonage-logo-images/vonage-square-logo.png'.freeze
+
+  def initialize(attributes = {})
+    @name       = attributes['name']           || 'Vonage Team Member'
+    @title      = attributes['title']          || 'Vonage Team Member'
+    @bio        = attributes['bio']            || ''
+    @short_name = attributes['short_name']     || 'vonage_team_member'
+    @email      = attributes['email']          || ''
+    @image_url  = attributes['image_url']      || ''
+
+    @author     = attributes['author']         || ''
+    @alumni     = attributes['alumni']         || false
+    @team       = attributes['team']           || false
+    @hidden     = attributes['hidden']         || false
+    @spotlight  = attributes['spotlight']      || false
+    @noteworthy = attributes['noteworthy']     || ''
+
+    @website_url  = attributes['website_url']  || ''
+    @twitter      = attributes['twitter']      || ''
+    @linkedin_url = attributes['linkedin_url'] || ''
+    @github_url   = attributes['github_url']   || ''
+    @youtube_url  = attributes['youtube_url']  || ''
+    @facebook_url = attributes['facebook_url'] || ''
+    @twitch_url   = attributes['twitch_url']   || ''
+    @stackoverflow_url = attributes['stackoverflow_url'] || ''
+
+    @blogposts = []
+    @url       = build_avatar_url
+  end
+
+  def build_all_blogposts_from_author(blogposts_json)
+    # TODO: How to handle authors with no Json info? (assay-and-roy)
+    @blogposts = blogposts_json.select do |b|
+      if b['author'] && b['author']['short_name'].present?
+        b['author']['short_name'].downcase == @short_name.downcase
+      end
+    end
+
+    @blogposts = @blogposts.map { |b| Blog::Blogpost.new b }
+
+    self
+  end
+
+  def build_avatar_url
+    return DEFAULT_AVATAR if image_url.blank?
+
+    if image_url.include?('gravatar') || image_url.include?('https://github.com/') || image_url.include?('https://ca.slack-edge.com/')
+      image_url
+    else
+      "#{Blog::Blogpost::CLOUDFRONT_BLOG_URL}authors/#{image_url.gsub('/content/images/', '')}"
+    end
+  end
+end