lita-yandex-domains 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fc217e9272589c57bae5d1c92afeba46dfe55275
+  data.tar.gz: 2bffa086fafacd6bd8b82c6f371c3e7adf11f281
+SHA512:
+  metadata.gz: 8e23c5407b2eb05ff525858854b44a8f1f8bea5508b295bacd05a7a2d6c15eae787e482ad4077e0929745fc50d940e7bb9c5dbc3eede4a8b7768351a30b6bab1
+  data.tar.gz: 2f2be7c5110f34b7d249699a1dd8925839c16419367a7be3550eb7bd7c904cf3a04d8dea2e0ac6aeb06b4d820bb404581bc152d511bd25c18ea95d6d0c4c7a88

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+rvm:
+  - 2.3.0
+script: bundle exec rake
+before_install:
+  - gem update --system
+services:
+  - redis-server
+

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/README.md

@@ -0,0 +1,55 @@
+# lita-yandex-domains
+
+[![Build Status](https://travis-ci.org/DevicoSolutions/lita-yandex-domains.svg?branch=master)](https://travis-ci.org/DevicoSolutions/lita-yandex-domains)
+[![Coverage Status](https://coveralls.io/repos/github/DevicoSolutions/lita-yandex-domains/badge.svg?branch=master)](https://coveralls.io/github/DevicoSolutions/lita-yandex-domains?branch=master)
+
+Lita handler to interact with yandex domain API
+
+## Installation
+
+Add lita-yandex-domains to your Lita instance's Gemfile:
+
+``` ruby
+gem 'lita-yandex-domains'
+```
+
+## Configuration
+
+### Required attributes
+
+[How to get PDD token](https://tech.yandex.com/domain/doc/concepts/access-docpage/)
+
+* `pdd_token` (String) - Yandex PDD Token. Default: `nil`.
+ 
+* `domain` (String) - Your domain name that is linked to yandex domain service. Default: `nil`.
+
+### Example
+
+``` ruby
+Lita.configure do |config|
+  config.handlers.yandex_domains.pdd_token  = 'XXXXXXX'
+  config.handlers.yandex_domains.domain = 'example.com'
+  config.robot.yandex_admins = ["XXXXX"]
+end
+```
+
+## Usage
+
+Please note 
+
+```
+yandex show all human emails - Show all emails that not include mailing lists
+yandex show all maillists - Show all maillists
+yandex add email <email> - Add email with random generated password
+yandex delete email <email> - Delete user email
+yandex add maillist <email> - Add maillist
+yandex delete maillist <email> - Delete maillist
+yandex add <email> to maillist <email> - Add subcriber to maillist
+yandex delete <email> from maillist <email> - Remove subcriber from maillist
+```
+
+*Note:* The above commands except show commands require that the user be a member of the `:yandex_admins` authorization group.
+
+## License
+
+[MIT](http://opensource.org/licenses/MIT)

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/lib/lita-yandex-domains.rb

@@ -0,0 +1,15 @@
+require 'lita'
+
+require 'yandexhelper/regex'
+require 'yandex-pdd-2'
+
+Lita.load_locales Dir[File.expand_path(
+  File.join("..", "..", "locales", "*.yml"), __FILE__
+)]
+
+require 'lita/handlers/yandex_domains'
+
+Lita::Handlers::YandexDomains.template_root File.expand_path(
+  File.join("..", "..", "templates"),
+ __FILE__
+)

data/lib/lita/handlers/yandex_domains.rb

@@ -0,0 +1,181 @@
+module Lita
+  module Handlers
+    class YandexDomains < Handler
+
+      config :pdd_token, required: false, type: String, default: 'NAHCRSUVLHFRSILELDIJGPK2KTAWD5K7RTKYKPOG2XIB462LKTRQ'
+      config :domain, required: false, type: String, default: 'devico.io'
+
+      include ::YandexHelper::Regex
+
+      def yandex_client
+        @yandex_client ||= Yandex::Pdd::Client.new(config.pdd_token)
+      end
+
+      route(
+          /^yandex\screate\semail\s#{EMAIL_PATTERN}$/,
+          :create_email,
+          command: true,
+          restrict_to: :yandex_admins,
+          help: {
+              t('help.create_email.syntax') => t('help.create_email.desc')
+          }
+      )
+
+      route(
+          /^yandex\sdelete\semail\s#{EMAIL_PATTERN}$/,
+          :delete_email,
+          command: true,
+          restrict_to: :yandex_admins,
+          help: {
+              t('help.delete_email.syntax') => t('help.delete_email.desc')
+          }
+      )
+
+      route(
+          /^yandex\sshow\sall\shuman\semails$/,
+          :show_all_emails,
+          command: true,
+          help: {
+              t('help.show_human_emails.syntax') => t('help.show_human_emails.desc')
+          }
+      )
+
+      route(
+          /^yandex\screate\smaillist\s#{MAILLIST_PATTERN}$/,
+          :create_maillist,
+          command: true,
+          restrict_to: :yandex_admins,
+          help: {
+              t('help.create_maillist.syntax') => t('help.create_maillist.desc')
+          }
+      )
+
+      route(
+          /^yandex\sdelete\smaillist\s#{MAILLIST_PATTERN}$/,
+          :delete_maillist,
+          command: true,
+          restrict_to: :yandex_admins,
+          help: {
+              t('help.delete_maillist.syntax') => t('help.delete_maillist.desc')
+          }
+      )
+
+      route(
+          /^yandex\sshow\sall\smaillists$/,
+          :show_all_maillists,
+          command: true,
+          help: {
+              t('help.show_maillists.syntax') => t('help.show_maillists.desc')
+          }
+      )
+
+      route(
+          /^yandex\sadd\s#{EMAIL_PATTERN}\sto\smaillist\s#{MAILLIST_PATTERN}$/,
+          :add_subscriber,
+          command: true,
+          restrict_to: :yandex_admins,
+          help: {
+              t('help.add_subscriber.syntax') => t('help.add_subscriber.desc')
+          }
+      )
+
+      route(
+          /^yandex\sdelete\s#{EMAIL_PATTERN}\sfrom\smaillist\s#{MAILLIST_PATTERN}$/,
+          :remove_subscriber,
+          command: true,
+          restrict_to: :yandex_admins,
+          help: {
+              t('help.delete_subscriber.syntax') => t('help.delete_subscriber.desc')
+          }
+      )
+
+      def create_email(response)
+        email = response.match_data['email']
+        domain = email.split('@').last
+        if domain == config.domain
+          password = generate_passwd
+          status = yandex_client.mailbox_add(options = { domain: config.domain, login: email, password: password })
+          if status['success'] == 'error'
+            message = status
+          else
+            message = "Email #{email} with password #{password} was successfully created. Please login to mailbox using https//mail.#{domain}"
+          end
+        else
+          message = error_message(domain)
+        end
+        response.reply(message)
+      end
+
+      def delete_email(response)
+        email = response.match_data['email']
+        message = yandex_client.mailbox_delete(options = { domain: config.domain, login: email })
+        response.reply(message)
+      end
+
+      def show_all_emails(response)
+        show_emails(response, maillist='no')
+      end
+
+      def create_maillist(response)
+        email = response.match_data['maillist']
+        domain = email.split('@').last
+        message = nil
+        if domain == config.domain
+          status = yandex_client.maillist_add(options = { domain: config.domain, login: email })
+          message = status if status['success'] == 'error'
+        else
+          message = error_message(domain)
+        end
+        response.reply(message)
+      end
+
+      def delete_maillist(response)
+        email = response.match_data['maillist']
+        message = yandex_client.maillist_delete(options = { domain: config.domain, maillist: email })
+        response.reply(message)
+      end
+
+      def show_all_maillists(response)
+        show_emails(response, maillist='yes')
+      end
+
+      def add_subscriber(response)
+        email = response.match_data['email']
+        maillist = response.match_data['maillist']
+        message = yandex_client.subscription_add(options = { domain: config.domain, maillist: maillist, subscriber: email })
+        response.reply(message)
+      end
+
+      def remove_subscriber(response)
+        email = response.match_data['email']
+        maillist = response.match_data['maillist']
+        message = yandex_client.subscription_destroy(options = { domain: config.domain, maillist: maillist, subscriber: email })
+        response.reply(message)
+      end
+
+
+      Lita.register_handler(self)
+
+      private
+
+      def show_emails(response, maillist)
+        emails = []
+        accounts = yandex_client.mailbox_list(config.domain, page=1, on_page=500)
+        accounts['accounts'].each do |account|
+          emails.push(account['login']) if account['maillist'] == maillist
+        end
+        response.reply(emails)
+      end
+
+      def error_message(domain)
+        "Domain '#{domain}' is not valid. You authorize to manage emails only for #{config.domain} domain"
+      end
+
+      def generate_passwd(length=8)
+        chars = 'abcdefghjkmnpqrstuvwxyzABCDEFGHJKLMNOPQRSTUVWXYZ23456789'
+        Array.new(length) { chars[rand(chars.length)].chr }.join
+      end
+
+    end
+  end
+end

data/lib/yandexhelper/regex.rb

@@ -0,0 +1,7 @@
+module YandexHelper
+  module Regex
+    EMAIL_PATTERN = /(?<email>[\w+\-.]+@[a-z\d\-]+(\.[a-z]+)*\.[a-z]+)/i
+    MAILLIST_PATTERN = /(?<maillist>[\w+\-.]+@[a-z\d\-]+(\.[a-z]+)*\.[a-z]+)/i
+
+  end
+end

data/lita-yandex-domains.gemspec

@@ -0,0 +1,29 @@
+Gem::Specification.new do |spec|
+  spec.name          = "lita-yandex-domains"
+  spec.version       = "0.1.0"
+  spec.authors       = ["Devico Solutions"]
+  spec.email         = ["info@devico.io"]
+  spec.description   = "Lita handler to interact with yandex domain API"
+  spec.summary       = ""
+  spec.homepage      = "https://github.com/DevicoSolutions/lita-yandex-domains"
+  spec.license       = "MIT"
+  spec.metadata      = { "lita_plugin_type" => "handler" }
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = '>= 2.3.0'
+
+  spec.add_runtime_dependency 'lita', '>= 4.7'
+  spec.add_runtime_dependency 'yandex-pdd-2', '~> 0.1.3'
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'pry-byebug'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rack-test'
+  spec.add_development_dependency 'rspec', '>= 3.0.0'
+  spec.add_development_dependency 'simplecov'
+  spec.add_development_dependency 'coveralls'
+end

data/locales/en.yml

@@ -0,0 +1,29 @@
+en:
+  lita:
+    handlers:
+      yandex_domains:
+        help:
+          show_human_emails:
+            syntax: yandex show all human emails
+            desc: Show all emails that not include mailing lists
+          show_maillists:
+            syntax: yandex show all maillists
+            desc: Show all maillists
+          create_email:
+            syntax: yandex add email <email>
+            desc: Add email with random generated password
+          delete_email:
+            syntax: yandex delete email <email>
+            desc: Delete user email
+          create_maillist:
+            syntax: yandex add maillist <email>
+            desc: Add maillist
+          delete_maillist:
+            syntax: yandex delete maillist <email>
+            desc: Delete maillist
+          add_subscriber:
+            syntax: yandex add <email> to maillist <email>
+            desc: Add subcriber to maillist
+          delete_subscriber:
+            syntax: yandex delete <email> from maillist <email>
+            desc: Remove subcriber from maillist

data/spec/lita/handlers/yandex_domains_spec.rb

@@ -0,0 +1,20 @@
+require "spec_helper"
+
+describe Lita::Handlers::YandexDomains, lita_handler: true do
+
+  before do
+    robot.auth.add_user_to_group!(user, :yandex_admins)
+  end
+
+  describe 'lita routes' do
+    it { is_expected.to route_command('yandex create email test@test.com').to(:create_email).with_authorization_for(:yandex_admins) }
+    it { is_expected.to route_command('yandex delete email test@test.com').to(:delete_email).with_authorization_for(:yandex_admins) }
+    it { is_expected.to route_command('yandex show all human emails').to(:show_all_emails) }
+    it { is_expected.to route_command('yandex create maillist maillist@test.com').to(:create_maillist).with_authorization_for(:yandex_admins) }
+    it { is_expected.to route_command('yandex delete maillist maillist@test.com').to(:delete_maillist).with_authorization_for(:yandex_admins) }
+    it { is_expected.to route_command('yandex show all maillists').to(:show_all_maillists) }
+    it { is_expected.to route_command('yandex add test@devico.io to maillist maillist@test.com').to(:add_subscriber).with_authorization_for(:yandex_admins) }
+    it { is_expected.to route_command('yandex delete test@devico.io from maillist maillist@test.com').to(:remove_subscriber).with_authorization_for(:yandex_admins) }
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require "simplecov"
+require "coveralls"
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start { add_filter "/spec/" }
+
+require "lita-yandex-domains"
+require "lita/rspec"
+
+# A compatibility mode is provided for older plugins upgrading from Lita 3. Since this plugin
+# was generated with Lita 4, the compatibility mode should be left disabled.
+Lita.version_3_compatibility_mode = false

metadata

@@ -0,0 +1,186 @@
+--- !ruby/object:Gem::Specification
+name: lita-yandex-domains
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Devico Solutions
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-12-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: lita
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '4.7'
+- !ruby/object:Gem::Dependency
+  name: yandex-pdd-2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: pry-byebug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Lita handler to interact with yandex domain API
+email:
+- info@devico.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- Gemfile
+- README.md
+- Rakefile
+- lib/lita-yandex-domains.rb
+- lib/lita/handlers/yandex_domains.rb
+- lib/yandexhelper/regex.rb
+- lita-yandex-domains.gemspec
+- locales/en.yml
+- spec/lita/handlers/yandex_domains_spec.rb
+- spec/spec_helper.rb
+- templates/.gitkeep
+homepage: https://github.com/DevicoSolutions/lita-yandex-domains
+licenses:
+- MIT
+metadata:
+  lita_plugin_type: handler
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: ''
+test_files:
+- spec/lita/handlers/yandex_domains_spec.rb
+- spec/spec_helper.rb