guidepost 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7f49ae1e903b58b082d906af364a401237248bab317489daf80b8a431d33ea6b
-  data.tar.gz: 9da9ee9ed5892c403f0908e34891af82e9a9666419290354e30b9642a36502eb
+  metadata.gz: cd66962286cce8f0f618a5778d333434e9606427f00921b3be6b68775adb52de
+  data.tar.gz: 998473908c96ed016f5dff6fe20d660b47ed212fcfc7f51ad3ee1a92a9374829
 SHA512:
-  metadata.gz: 40fa25c5cab3b25c0df32da32ed7fd6bdd1bab0b790a8c0f78d20bfaccd2830a47f11e54942d96347e06574f2cb538c94ce7cbdda84e8c768374c089547aa3d6
-  data.tar.gz: 7f090b43f12e5927137dad0e147754ab53e2d444173cb839affcb8fffb2abc78aa45b6db2722a136a63eb147e4979f66f56153a2e8e7874a1693574651ac36f6
+  metadata.gz: c55c394e4202705ed8c791d0d259c231c5e66f7ac32ca4a6d2c39f270ee39ce405cf0b97738733ed888754c783334e49bd9dea6105016825b3c0e56b3512b2a8
+  data.tar.gz: f3264e4bf8c58b020a6891273986a377252501293c25048d7bf6432035281231723b47e8325f81d81b428bec01fdd0f55d2f81ccf44e1e7b057979c47f77af0a

data/README.md

@@ -60,7 +60,7 @@ Make sure to have certain environmental variables set, preferrably in your `.bas
 ENV["#{YOUR_PROJECT_NAME}_GUIDEPOST_ZENDESK_EMAIL"]
 
 # The password token associated with your Zendesk subdomain
-ENV["#{YOUR_PROJECT_NAME}_GUIDEPOST_PASSWORD_TOKEN"]
+ENV["#{YOUR_PROJECT_NAME}_GUIDEPOST_ZENDESK_PASSWORD_TOKEN"]
 ```
 
 #### S3

data/lib/guidepost/provider/zendesk.rb

@@ -22,6 +22,7 @@ module Guidepost
                 return [] if query.empty?
 
                 url = "#{self.base_api_url}/help_center/articles/search.json?query=#{query}&per_page=10"
+                url += "&locale=#{options[:locale]}" if !options[:locale].nil? && !options[:locale].empty?
                 uri = URI.parse(url)
         
                 http = Net::HTTP.new(uri.host, uri.port)
@@ -52,7 +53,8 @@ module Guidepost
             def backup_all_articles(options={})
                 # Get all articles (with pagination)
                 sideload = options[:sideload] || false
-                articles = self.retrieve_all_articles(sideload: sideload)
+                all_locales = options[:all_locales] || true
+                articles = self.retrieve_all_articles(sideload: sideload, all_locales: all_locales)
         
                 # Upload to S3
                 timestamp = Time.now.strftime('%Y%m%d%H%M%S')
@@ -66,19 +68,30 @@ module Guidepost
         
             def retrieve_all_articles(options={})
                 sideload = options[:sideload] || false
+                all_locales = options[:all_locales] || true
+
                 page_next = nil
                 articles = []
                 article_attachments = nil
 
+                locales = (self.retrieve_all_locales || []).map{|locale_json| locale_json['locale'] } if all_locales
+                locales = [''] if locales.nil? || locales.empty?
+
                 if !sideload
-                    while true
-                        page_articles, page_next = self.retrieve_articles(url: page_next)
-                        break if page_articles.nil? || page_articles.empty?
-                        articles += page_articles
-                        break if page_next.nil?
-                    end
+                    article_attachments = []
+                    locales.each do |locale|
+                        page_next = nil
+                        locale_articles = []
+                        while true
+                            page_articles, page_next = self.retrieve_articles(url: page_next, locale: locale)
+                            break if page_articles.nil? || page_articles.empty?
+                            locale_articles += page_articles
+                            break if page_next.nil?
+                        end
+                        articles += locale_articles
 
-                    article_attachments = self.retrieve_all_article_attachments(articles: articles)
+                        article_attachments += self.retrieve_all_article_attachments(articles: locale_articles, locale: locale)
+                    end
 
                     return {
                         articles: articles,
@@ -89,50 +102,57 @@ module Guidepost
                 else
                     sections = []
                     categories = []
+                    article_attachments = []
 
                     section_urls = Hash.new
                     category_urls = Hash.new
 
-                    while true
-                        page, page_next = self.retrieve_articles(url: page_next, sideload: true)
+                    locales.each do |locale|
+                        page_next = nil
+                        locales_articles = []
 
-                        articles_from_page = page["articles"]
-                        sections_from_page = page["sections"]
-                        categories_from_page = page["categories"]
+                        while true
+                            page, page_next = self.retrieve_articles(url: page_next, sideload: true, locale: locale)
 
-                        no_more_articles = articles_from_page.nil? || articles_from_page.empty?
-                        no_more_sections = sections_from_page.nil? || sections_from_page.empty?
-                        no_more_categories = categories_from_page.nil? || categories_from_page.empty?
+                            articles_from_page = page["articles"]
+                            sections_from_page = page["sections"]
+                            categories_from_page = page["categories"]
 
-                        break if no_more_articles && no_more_sections && no_more_categories
+                            no_more_articles = articles_from_page.nil? || articles_from_page.empty?
+                            no_more_sections = sections_from_page.nil? || sections_from_page.empty?
+                            no_more_categories = categories_from_page.nil? || categories_from_page.empty?
 
-                        articles += articles_from_page
+                            break if no_more_articles && no_more_sections && no_more_categories
 
-                        sections_from_page.each do |s|
-                            url = s["url"]
-                            if !section_urls.has_key?(url)
-                                section_urls[url] = 1
-                            else
-                                section_urls[url] += 1
+                            locales_articles += articles_from_page
+
+                            sections_from_page.each do |s|
+                                url = s["url"]
+                                if !section_urls.has_key?(url)
+                                    section_urls[url] = 1
+                                else
+                                    section_urls[url] += 1
+                                end
+                                sections << s if section_urls[url] == 1
                             end
-                            sections << s if section_urls[url] == 1
-                        end
 
-                        categories_from_page.each do |c|
-                            url = c["url"]
-                            if !category_urls.has_key?(url)
-                                category_urls[url] = 1
-                            else
-                                category_urls[url] += 1
+                            categories_from_page.each do |c|
+                                url = c["url"]
+                                if !category_urls.has_key?(url)
+                                    category_urls[url] = 1
+                                else
+                                    category_urls[url] += 1
+                                end
+                                categories << c if category_urls[url] == 1
                             end
-                            categories << c if category_urls[url] == 1
-                        end
 
-                        break if page_next.nil?
+                            break if page_next.nil?
+                        end
+                        articles += locales_articles
+                        
+                        article_attachments += self.retrieve_all_article_attachments(articles: locales_articles, locale: locale)
                     end
 
-                    article_attachments = self.retrieve_all_article_attachments(articles: articles)
-
                     return { 
                         categories: categories, 
                         category_count: categories.count, 
@@ -148,12 +168,13 @@ module Guidepost
         
             def retrieve_articles(options={})
                 url = options[:url]
+                locale = (options[:locale] || "").downcase
                 sideload = options[:sideload] || false
 
                 if !sideload
-                    url = "#{self.base_api_url}/help_center/articles.json?per_page=25&page=1" if url.nil?
+                    url = "#{self.base_api_url}/help_center/#{locale}/articles.json?per_page=25&page=1" if url.nil?
                 else
-                    url = "#{self.base_api_url}/help_center/articles.json?include=sections,categories&per_page=25&page=1" if url.nil?
+                    url = "#{self.base_api_url}/help_center/#{locale}/articles.json?include=sections,categories&per_page=25&page=1" if url.nil?
                 end
                 
                 uri = URI.parse(url)
@@ -252,7 +273,7 @@ module Guidepost
                 articles = options[:articles]
                 articles.each do |article|
                     while true
-                        attachments, next_page = self.retrieve_article_attachments(for_article: article)
+                        attachments, next_page = self.retrieve_article_attachments(for_article: article, url: next_page, locale: options[:locale])
                         break if attachments.nil? || attachments.empty?
                         article_attachments += attachments
                         break if next_page.nil?
@@ -263,9 +284,11 @@ module Guidepost
             end
 
             def retrieve_article_attachments(options={})
+                url = options[:url]
                 article = options[:for_article]
+                locale = (options[:locale] || "").downcase
 
-                url = "#{self.base_api_url}/help_center/articles/#{article["id"]}/attachments.json?per_page=25&page=1" if url.nil?
+                url = "#{self.base_api_url}/help_center/#{locale}/articles/#{article["id"]}/attachments.json?per_page=25&page=1" if url.nil?
                 uri = URI.parse(url)
         
                 http = Net::HTTP.new(uri.host, uri.port)
@@ -283,6 +306,78 @@ module Guidepost
                 return j_body["article_attachments"], j_body["next_page"]
             end
 
+            def retrieve_all_locales(options={})
+                locales = []
+                next_page = nil
+
+                while true
+                    tmp_locales, next_page = self.retrieve_locales(url: next_page)
+                    break if tmp_locales.nil? || tmp_locales.empty?
+                    locales += tmp_locales
+                    break if next_page.nil?
+                end
+
+                locales
+            end
+
+            def retrieve_locales(options={})
+                url = options[:url]
+
+                url = "#{self.base_api_url}/locales.json" if url.nil?
+                uri = URI.parse(url)
+        
+                http = Net::HTTP.new(uri.host, uri.port)
+                http.use_ssl = true
+                http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        
+                request = Net::HTTP::Get.new(uri.request_uri)
+                request.basic_auth(@email, @password)
+                response = http.request(request)
+        
+                body = response.body.force_encoding("UTF-8")
+
+                j_body = JSON.parse(body)
+
+                return j_body["locales"], j_body["next_page"]
+            end
+
+            def retrieve_all_translations(options={})
+                translations = []
+                next_page = nil
+                article = options[:for_article]
+
+                while true
+                    tmp_translations, next_page = self.retrieve_translations(url: next_page, for_article: article)
+                    break if tmp_translations.nil? || tmp_translations.empty?
+                    translations += tmp_translations
+                    break if next_page.nil?
+                end
+
+                translations
+            end
+
+            def retrieve_translations(options={})
+                url = options[:url]
+                article = options[:for_article]
+
+                url = "#{self.base_api_url}/help_center/articles/#{article['id']}/translations.json" if url.nil?
+                uri = URI.parse(url)
+        
+                http = Net::HTTP.new(uri.host, uri.port)
+                http.use_ssl = true
+                http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+        
+                request = Net::HTTP::Get.new(uri.request_uri)
+                request.basic_auth(@email, @password)
+                response = http.request(request)
+        
+                body = response.body.force_encoding("UTF-8")
+
+                j_body = JSON.parse(body)
+
+                return j_body["translations"], j_body["next_page"]
+            end
+
             def base_api_url
                 "https://#{self.subdomain}.zendesk.com/api/v2"
             end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: guidepost
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Kiren Srinivasan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-05-18 00:00:00.000000000 Z
+date: 2019-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk