postfix_admin 0.2.1 → 0.3.0

data/lib/postfix_admin/runner.rb

@@ -24,36 +24,41 @@ module PostfixAdmin
       runner { puts PostfixAdmin::Doveadm.schemes.join(' ') }
     end
 
-    desc "show [example.com | admin@example.com | user@example.com]", "Show domains or admins or mailboxes"
+    desc "show [example.com | admin@example.com | user@example.com]",
+         "Display details about domains, admins, or accounts"
     def show(name = nil)
       runner { @cli.show(name) }
     end
 
-    desc "setup example.com password", "Setup a domain"
+    desc "setup example.com password", "Set up a domain"
     def setup(domain_name, password)
       runner { @cli.setup_domain(domain_name, password) }
     end
 
-    desc "admin_passwd admin@example.com new_password", "Change password of admin"
+    desc "admin_passwd admin@example.com new_password",
+         "Change the password of an admin user"
     def admin_passwd(user_name, password)
       runner { @cli.change_admin_password(user_name, password) }
     end
 
-    desc "account_passwd user@example.com new_password", "Change password of account"
+    desc "account_passwd user@example.com new_password",
+         "Change the password of an account"
     def account_passwd(user_name, password)
       runner { @cli.change_account_password(user_name, password) }
     end
 
-    desc "add_domain example.com", "Add a domain"
+    desc "add_domain example.com", "Add a new domain"
+    method_option :description, type: :string, aliases: "-d", desc: "description"
     def add_domain(domain_name)
-      runner { @cli.add_domain(domain_name) }
+      runner { @cli.add_domain(domain_name, description: options[:description]) }
     end
 
-    desc "edit_domain example.com", "Edit a domain limitation"
+    desc "edit_domain example.com", "Edit a domain"
     method_option :aliases,   type: :numeric, aliases: "-a", desc: "Edit aliases limitation"
     method_option :mailboxes, type: :numeric, aliases: "-m", desc: "Edit mailboxes limitation"
     method_option :maxquota,  type: :numeric, aliases: "-q", desc: "Edit max quota limitation"
     method_option :active, type: :boolean, desc: "Update active status"
+    method_option :description, type: :string, aliases: "-d", desc: "Edit description"
     def edit_domain(domain_name)
       runner do
         if options.size == 0
@@ -70,7 +75,7 @@ module PostfixAdmin
       runner { @cli.delete_domain(domain_name) }
     end
 
-    desc "delete_admin admin@example.com", "Delete an admin"
+    desc "delete_admin admin@example.com", "Delete an admin user"
     def delete_admin(user_name)
       runner { @cli.delete_admin(user_name) }
     end
@@ -80,7 +85,7 @@ module PostfixAdmin
       runner { @cli.delete_account(address) }
     end
 
-    desc "add_account user@example.com password", "Add an account"
+    desc "add_account user@example.com password", "Add a new account"
     method_option :scheme, type: :string, aliases: "-s", desc: "password scheme"
     method_option :name,   type: :string, aliases: "-n", desc: "full name"
     def add_account(address, password)
@@ -100,10 +105,14 @@ module PostfixAdmin
     end
 
     desc "edit_account user@example.com", "Edit an account"
-    method_option :goto,  type: :string,  aliases: "-g", desc: "mailboxes, addresses e-mails are delivered to"
-    method_option :quota, type: :numeric, aliases: "-q", desc: "quota limitation (MB)"
-    method_option :name,  type: :string,  aliases: "-n", desc: "full name"
-    method_option :active, type: :boolean, desc: "Update active status"
+    method_option :goto,  type: :string,  aliases: "-g",
+                  desc: "mailboxes, addresses e-mails are delivered to"
+    method_option :quota, type: :numeric, aliases: "-q",
+                  desc: "quota limitation (MB)"
+    method_option :name,  type: :string,  aliases: "-n",
+                  desc: "full name"
+    method_option :active, type: :boolean,
+                  desc: "Update active status"
     def edit_account(address)
       runner do
         if options.size == 0
@@ -134,7 +143,7 @@ module PostfixAdmin
       end
     end
 
-    desc "add_admin admin@example.com password", "Add an admin user"
+    desc "add_admin admin@example.com password", "Add a new admin user"
     method_option :super, type: :boolean, aliases: "-S", desc: "register as a super admin"
     method_option :scheme, type: :string, aliases: "-s", desc: "password scheme"
     def add_admin(user_name, password)
@@ -148,12 +157,14 @@ module PostfixAdmin
       end
     end
 
-    desc "add_admin_domain admin@example.com example.com", "Add admin_domain"
+    desc "add_admin_domain admin@example.com example.com",
+         "Grant an admin user access to a specific domain"
     def add_admin_domain(user_name, domain_name)
       runner { @cli.add_admin_domain(user_name, domain_name) }
     end
 
-    desc "delete_admin_domain admin@example.com example.com", "Delete admin_domain"
+    desc "delete_admin_domain admin@example.com example.com",
+         "Revoke an admin user's access to a specific domain"
     def delete_admin_domain(user_name, domain_name)
       runner { @cli.delete_admin_domain(user_name, domain_name) }
     end
@@ -173,7 +184,7 @@ module PostfixAdmin
       end
     end
 
-    desc "add_alias alias@example.com goto@example.net", "Add an alias"
+    desc "add_alias alias@example.com goto@example.net", "Add a new alias"
     def add_alias(address, goto)
       runner { @cli.add_alias(address, goto) }
     end
@@ -183,9 +194,11 @@ module PostfixAdmin
       runner { @cli.delete_alias(address) }
     end
 
-    desc "log", "Show action logs"
+    desc "log", "Display action logs"
+    method_option :domain, type: :string, aliases: "-d", desc: "Filter by domain"
+    method_option :last,   type: :numeric, aliases: "-l", desc: "Display the last N lines"
     def log
-      runner { @cli.log }
+      runner { @cli.log(domain: options[:domain], last: options[:last]) }
     end
 
     desc "dump", "Dump all data"
@@ -193,7 +206,7 @@ module PostfixAdmin
       runner { @cli.dump }
     end
 
-    desc "version", "Show postfix_admin version"
+    desc "version", "Display the version of postfix_admin"
     def version
       require 'postfix_admin/version'
       runner { say "postfix_admin #{VERSION}" }
@@ -201,9 +214,9 @@ module PostfixAdmin
 
     private
 
-    def runner
+    def runner(&block)
       @cli.db_setup
-      yield
+      block.call
     rescue StandardError => e
       abort "Error: #{e.message}"
     end

data/lib/postfix_admin/version.rb

@@ -1,3 +1,3 @@
 module PostfixAdmin
-  VERSION = "0.2.1"
+  VERSION = "0.3.0"
 end

data/postfix_admin.gemspec

@@ -1,4 +1,4 @@
-require File.expand_path('../lib/postfix_admin/version', __FILE__)
+require File.expand_path("../lib/postfix_admin/version", __FILE__)
 
 Gem::Specification.new do |gem|
   gem.name          = "postfix_admin"
@@ -10,19 +10,21 @@ Gem::Specification.new do |gem|
   gem.description   = %q{Command Line Tools for Postfix Admin}
   gem.homepage      = "https://github.com/krhitoshi/postfix_admin"
 
-  gem.required_ruby_version = ">= 2.5.0"
+  gem.required_ruby_version = ">= 2.6.0"
 
-  gem.add_dependency 'thor', '~> 1.0.1'
-  gem.add_dependency 'activerecord', '~> 6.0.3'
-  gem.add_dependency 'mysql2', '>= 0.5.3'
-  gem.add_development_dependency 'pry'
-  gem.add_development_dependency 'rake', '~> 13.0.1'
-  gem.add_development_dependency 'rubocop'
-  gem.add_development_dependency 'rspec', '~> 3.9.0'
+  gem.add_dependency "thor", "~> 1.3.1"
+  gem.add_dependency "activerecord", "~> 6.1.7"
+  gem.add_dependency "mysql2", "~> 0.5"
+  gem.add_dependency "terminal-table", "~> 3.0.2"
+  gem.add_development_dependency "pry"
+  gem.add_development_dependency "factory_bot", "~> 6.3.0"
+  gem.add_development_dependency "rake", "~> 13.2.1"
+  gem.add_development_dependency "rubocop"
+  gem.add_development_dependency "rspec", "~> 3.13.0"
 
   # Specify which files should be added to the gem when it is released.
   # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  gem.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+  gem.files         = Dir.chdir(File.expand_path("..", __FILE__)) do
     `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
   end
   gem.bindir        = "exe"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: postfix_admin
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.3.0
 platform: ruby
 authors:
 - Hitoshi Kurokawa
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2020-07-18 00:00:00.000000000 Z
+date: 2024-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
@@ -16,42 +16,56 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: 1.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.0.1
+        version: 1.3.1
 - !ruby/object:Gem::Dependency
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 6.0.3
+        version: 6.1.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 6.0.3
+        version: 6.1.7
 - !ruby/object:Gem::Dependency
   name: mysql2
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.3
+        version: '0.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: terminal-table
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.5.3
+        version: 3.0.2
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -66,20 +80,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: factory_bot
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.3.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 6.3.0
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 13.0.1
+        version: 13.2.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 13.0.1
+        version: 13.2.1
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
@@ -100,14 +128,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.9.0
+        version: 3.13.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 3.9.0
+        version: 3.13.0
 description: Command Line Tools for Postfix Admin
 email:
 - hitoshi@nextseed.jp
@@ -116,7 +144,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
-- ".github/workflows/ruby.yml"
+- ".github/workflows/ci.yml"
 - ".gitignore"
 - ".rubocop.yml"
 - CHANGELOG.md
@@ -128,9 +156,7 @@ files:
 - bin/console
 - docker-admin/Dockerfile
 - docker-admin/config.local.php
-- docker-app-2.5/Dockerfile
 - docker-app/Dockerfile
-- docker-app/docker-entrypoint.sh
 - docker-app/my.cnf
 - docker-compose.yml
 - docker-db/postfix.v1841.sql
@@ -161,7 +187,7 @@ files:
 homepage: https://github.com/krhitoshi/postfix_admin
 licenses: []
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -169,15 +195,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 3.5.3
+signing_key:
 specification_version: 4
 summary: ''
 test_files: []

data/.github/workflows/ruby.yml

@@ -1,37 +0,0 @@
-# This workflow uses actions that are not certified by GitHub.
-# They are provided by a third-party and are governed by
-# separate terms of service, privacy policy, and support
-# documentation.
-# This workflow will download a prebuilt Ruby version, install dependencies and run tests with Rake
-# For more information see: https://github.com/marketplace/actions/setup-ruby-jruby-and-truffleruby
-
-name: Ruby
-
-on:
-  push:
-    branches: [ master ]
-  pull_request:
-    branches: [ master ]
-
-jobs:
-  test:
-
-    runs-on: ubuntu-latest
-
-    steps:
-    - uses: actions/checkout@v2
-    - name: Set up Ruby
-    # To automatically get bug fixes and new Ruby versions for ruby/setup-ruby,
-    # change this to (see https://github.com/ruby/setup-ruby#versioning):
-    # uses: ruby/setup-ruby@v1
-      uses: ruby/setup-ruby@ec106b438a1ff6ff109590de34ddc62c540232e0
-      with:
-        ruby-version: 2.6
-    - name: docker-compose up
-      run: docker-compose up -d
-    - name: Run tests for Ruby 2.6
-      run: docker-compose exec -T app /wait-for-it.sh db:3306 -- rake
-    - name: Remove Gemfile.lock
-      run: rm -f Gemfile.lock
-    - name: Run tests for Ruby 2.5.0
-      run: docker-compose exec -T app2.5 rake

data/docker-app/docker-entrypoint.sh

@@ -1,5 +0,0 @@
-#!/bin/bash
-
-set -eu
-
-exec "$@"

data/docker-app-2.5/Dockerfile

@@ -1,15 +0,0 @@
-FROM ruby:2.5.0
-
-RUN apt-get update && \
-    apt-get install -y dovecot-core iproute2 mariadb-client && \
-    rm -rf /var/lib/apt/lists/*
-
-WORKDIR /app
-
-COPY Gemfile postfix_admin.gemspec ./
-COPY ./lib/postfix_admin/version.rb ./lib/postfix_admin/version.rb
-
-RUN gem install bundler && bundle install
-
-COPY spec/postfix_admin.conf /root/.postfix_admin.conf
-COPY docker-app/my.cnf /root/.my.cnf