automatic 14.12.2 → 26.08

data/VERSION

@@ -1 +1 @@
-14.12.2
+26.08

data/automatic.gemspec

@@ -1,254 +1,115 @@
-# Generated by jeweler
-# DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
-# -*- encoding: utf-8 -*-
-# stub: automatic 14.12.2 ruby lib
+# -*- coding: utf-8 -*-
+# Name::        automatic.gemspec
+# Author:       id774 (More info: http://id774.net)
+# Source Code:: https://github.com/id774/automaticruby
+# License::     The GPL version 3, or LGPL version 3 (Dual License).
+# Contact::     idnanashi@gmail.com
+# Created::     Mar  7, 2012
+# Updated::     Aug 14, 2026
+# Copyright::   Copyright (c) 2012-2026 Automatic Ruby Developers.
+#
+# This file is maintained by hand. It was generated by Jeweler until v14.12.2;
+# the generator is no longer maintained and the file is now source. See
+# doc/POLICY.md section 9.4.
 
-Gem::Specification.new do |s|
-  s.name = "automatic"
-  s.version = "14.12.2"
+Gem::Specification.new do |spec|
+  spec.name        = 'automatic'
+  spec.version     = File.read(File.expand_path('VERSION', __dir__)).strip
+  spec.authors     = ['id774']
+  spec.email       = ['idnanashi@gmail.com']
 
-  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
-  s.require_paths = ["lib"]
-  s.authors = ["id774"]
-  s.date = "2015-01-04"
-  s.description = "Ruby framework for the general-purpose automatic processing"
-  s.email = "idnanashi@gmail.com"
-  s.executables = ["automatic"]
-  s.extra_rdoc_files = [
-    "README.md"
-  ]
-  s.files = [
-    "Gemfile",
-    "README.md",
-    "Rakefile",
-    "VERSION",
-    "assets/siteinfo/items_all.json",
-    "automatic.gemspec",
-    "bin/automatic",
-    "config/feed2console.yml",
-    "db/.gitkeep",
-    "doc/AUTHORS",
-    "doc/COPYING",
-    "doc/ChangeLog",
-    "doc/PLUGINS",
-    "doc/PLUGINS.ja",
-    "doc/README",
-    "doc/README.ja",
-    "lib/automatic.rb",
-    "lib/automatic/environment.rb",
-    "lib/automatic/feed_maker.rb",
-    "lib/automatic/feed_parser.rb",
-    "lib/automatic/log.rb",
-    "lib/automatic/opml.rb",
-    "lib/automatic/pipeline.rb",
-    "lib/automatic/recipe.rb",
-    "lib/automatic/version.rb",
-    "plugins/custom_feed/svn_log.rb",
-    "plugins/filter/absolute_uri.rb",
-    "plugins/filter/accept.rb",
-    "plugins/filter/clear.rb",
-    "plugins/filter/description_link.rb",
-    "plugins/filter/full_feed.rb",
-    "plugins/filter/github_feed.rb",
-    "plugins/filter/google_news.rb",
-    "plugins/filter/ignore.rb",
-    "plugins/filter/image.rb",
-    "plugins/filter/image_source.rb",
-    "plugins/filter/one.rb",
-    "plugins/filter/rand.rb",
-    "plugins/filter/sanitize.rb",
-    "plugins/filter/sort.rb",
-    "plugins/filter/tumblr_resize.rb",
-    "plugins/notify/ikachan.rb",
-    "plugins/provide/fluentd.rb",
-    "plugins/publish/amazon_s3.rb",
-    "plugins/publish/console.rb",
-    "plugins/publish/console_link.rb",
-    "plugins/publish/eject.rb",
-    "plugins/publish/fluentd.rb",
-    "plugins/publish/google_calendar.rb",
-    "plugins/publish/hatena_bookmark.rb",
-    "plugins/publish/hipchat.rb",
-    "plugins/publish/instapaper.rb",
-    "plugins/publish/memcached.rb",
-    "plugins/publish/pocket.rb",
-    "plugins/publish/twitter.rb",
-    "plugins/store/database.rb",
-    "plugins/store/file.rb",
-    "plugins/store/full_text.rb",
-    "plugins/store/permalink.rb",
-    "plugins/subscription/chan_toru.rb",
-    "plugins/subscription/feed.rb",
-    "plugins/subscription/g_guide.rb",
-    "plugins/subscription/link.rb",
-    "plugins/subscription/pocket.rb",
-    "plugins/subscription/text.rb",
-    "plugins/subscription/tumblr.rb",
-    "plugins/subscription/twitter.rb",
-    "plugins/subscription/twitter_search.rb",
-    "plugins/subscription/weather.rb",
-    "plugins/subscription/xml.rb",
-    "script/build",
-    "spec/fixtures/sampleFeeds.tsv",
-    "spec/fixtures/sampleFeeds2.tsv",
-    "spec/fixtures/sampleRecipe.yml",
-    "spec/lib/automatic/log_spec.rb",
-    "spec/lib/automatic/pipeline_spec.rb",
-    "spec/lib/automatic/recipe_spec.rb",
-    "spec/lib/automatic_spec.rb",
-    "spec/plugins/custom_feed/svn_log_spec.rb",
-    "spec/plugins/filter/absolute_uri_spec.rb",
-    "spec/plugins/filter/accept_spec.rb",
-    "spec/plugins/filter/clear_spec.rb",
-    "spec/plugins/filter/description_link_spec.rb",
-    "spec/plugins/filter/full_feed_spec.rb",
-    "spec/plugins/filter/github_feed_spec.rb",
-    "spec/plugins/filter/google_news_spec.rb",
-    "spec/plugins/filter/ignore_spec.rb",
-    "spec/plugins/filter/image_source_spec.rb",
-    "spec/plugins/filter/image_spec.rb",
-    "spec/plugins/filter/one_spec.rb",
-    "spec/plugins/filter/rand_spec.rb",
-    "spec/plugins/filter/sanitize_spec.rb",
-    "spec/plugins/filter/sort_spec.rb",
-    "spec/plugins/filter/tumblr_resize_spec.rb",
-    "spec/plugins/notify/ikachan_spec.rb",
-    "spec/plugins/provide/fluentd_spec.rb",
-    "spec/plugins/publish/amazon_s3_spec.rb",
-    "spec/plugins/publish/console_spec.rb",
-    "spec/plugins/publish/eject_spec.rb",
-    "spec/plugins/publish/fluentd_spec.rb",
-    "spec/plugins/publish/google_calendar_spec.rb",
-    "spec/plugins/publish/hatena_bookmark_spec.rb",
-    "spec/plugins/publish/hipchat_spec.rb",
-    "spec/plugins/publish/instapaper_spec.rb",
-    "spec/plugins/publish/memcached_spec.rb",
-    "spec/plugins/publish/pocket_spec.rb",
-    "spec/plugins/publish/twitter_spec.rb",
-    "spec/plugins/store/file_spec.rb",
-    "spec/plugins/store/full_text_spec.rb",
-    "spec/plugins/store/permalink_spec.rb",
-    "spec/plugins/subscription/chan_toru_spec.rb",
-    "spec/plugins/subscription/feed_spec.rb",
-    "spec/plugins/subscription/g_guide_spec.rb",
-    "spec/plugins/subscription/link_spec.rb",
-    "spec/plugins/subscription/pocket_spec.rb",
-    "spec/plugins/subscription/text_spec.rb",
-    "spec/plugins/subscription/tumblr_spec.rb",
-    "spec/plugins/subscription/twitter_search_spec.rb",
-    "spec/plugins/subscription/twitter_spec.rb",
-    "spec/plugins/subscription/weather_spec.rb",
-    "spec/plugins/subscription/xml_spec.rb",
-    "spec/spec_helper.rb",
-    "spec/user_dir/plugins/store/mock.rb",
-    "test/fixtures/sampleOPML.xml",
-    "test/integration/test_absoluteurl.yml",
-    "test/integration/test_activerecord.yml",
-    "test/integration/test_add_pocket.yml",
-    "test/integration/test_chan_toru.yml",
-    "test/integration/test_descriptionlink.yml",
-    "test/integration/test_fluentd.yml",
-    "test/integration/test_fulltext.yml",
-    "test/integration/test_google_news.yml",
-    "test/integration/test_googlealert.yml",
-    "test/integration/test_hatenabookmark.yml",
-    "test/integration/test_ignore.yml",
-    "test/integration/test_ignore2.yml",
-    "test/integration/test_image2local.yml",
-    "test/integration/test_instapaper.yml",
-    "test/integration/test_link2local.yml",
-    "test/integration/test_one.yml",
-    "test/integration/test_pocket.yml",
-    "test/integration/test_rand.yml",
-    "test/integration/test_sanitize.yml",
-    "test/integration/test_sort.yml",
-    "test/integration/test_svnlog.yml",
-    "test/integration/test_text2feed.yml",
-    "test/integration/test_tumblr2local.yml",
-    "test/integration/test_twitter_search.yml",
-    "test/integration/test_weather.yml",
-    "test/integration/test_xml2fluentd.yml",
-    "vendor/.gitkeep"
-  ]
-  s.homepage = "http://github.com/automaticruby/automaticruby"
-  s.licenses = ["GPL"]
-  s.rubygems_version = "2.4.5"
-  s.summary = "Automatic Ruby"
+  spec.summary     = 'Automatic Ruby'
+  spec.description = <<~DESC
+    A Ruby framework for general-purpose automatic processing. A job is
+    described in a YAML file called a Recipe, which names plugins in order;
+    each plugin receives the previous one's output and returns the next one's
+    input. Subscribing, filtering, storing and publishing are all plugins, and
+    a plugin is found by name on a search path rather than registered.
+  DESC
 
-  if s.respond_to? :specification_version then
-    s.specification_version = 4
+  spec.homepage = 'https://github.com/id774/automaticruby'
+  spec.licenses = ['GPL-3.0-only', 'LGPL-3.0-only']
 
-    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<json>, ["~> 1.8.1"])
-      s.add_runtime_dependency(%q<sqlite3>, ["~> 1.3.10"])
-      s.add_runtime_dependency(%q<activesupport>, ["~> 4.1.8"])
-      s.add_runtime_dependency(%q<activerecord>, ["~> 4.1.8"])
-      s.add_runtime_dependency(%q<hashie>, ["~> 3.3.2"])
-      s.add_runtime_dependency(%q<gcalapi>, ["~> 0.1.2"])
-      s.add_runtime_dependency(%q<xml-simple>, ["~> 1.1.4"])
-      s.add_runtime_dependency(%q<feedbag>, ["~> 0.9.5"])
-      s.add_runtime_dependency(%q<nokogiri>, ["~> 1.6.5"])
-      s.add_runtime_dependency(%q<sanitize>, ["~> 3.1.0"])
-      s.add_runtime_dependency(%q<faraday>, ["~> 0.8.9"])
-      s.add_runtime_dependency(%q<twitter>, ["~> 4.8.0"])
-      s.add_runtime_dependency(%q<pocket-ruby>, ["~> 0.0.5"])
-      s.add_runtime_dependency(%q<weather_hacker>, ["~> 0.1.7"])
-      s.add_runtime_dependency(%q<hipchat>, ["~> 1.4.0"])
-      s.add_runtime_dependency(%q<fluent-logger>, ["~> 0.4.7"])
-      s.add_runtime_dependency(%q<dalli>, ["~> 2.7.2"])
-      s.add_runtime_dependency(%q<aws-sdk>, ["~> 1.60.2"])
-      s.add_development_dependency(%q<cucumber>, [">= 0"])
-      s.add_development_dependency(%q<bundler>, [">= 0"])
-      s.add_development_dependency(%q<builder>, [">= 0"])
-      s.add_development_dependency(%q<jeweler>, [">= 0"])
-    else
-      s.add_dependency(%q<json>, ["~> 1.8.1"])
-      s.add_dependency(%q<sqlite3>, ["~> 1.3.10"])
-      s.add_dependency(%q<activesupport>, ["~> 4.1.8"])
-      s.add_dependency(%q<activerecord>, ["~> 4.1.8"])
-      s.add_dependency(%q<hashie>, ["~> 3.3.2"])
-      s.add_dependency(%q<gcalapi>, ["~> 0.1.2"])
-      s.add_dependency(%q<xml-simple>, ["~> 1.1.4"])
-      s.add_dependency(%q<feedbag>, ["~> 0.9.5"])
-      s.add_dependency(%q<nokogiri>, ["~> 1.6.5"])
-      s.add_dependency(%q<sanitize>, ["~> 3.1.0"])
-      s.add_dependency(%q<faraday>, ["~> 0.8.9"])
-      s.add_dependency(%q<twitter>, ["~> 4.8.0"])
-      s.add_dependency(%q<pocket-ruby>, ["~> 0.0.5"])
-      s.add_dependency(%q<weather_hacker>, ["~> 0.1.7"])
-      s.add_dependency(%q<hipchat>, ["~> 1.4.0"])
-      s.add_dependency(%q<fluent-logger>, ["~> 0.4.7"])
-      s.add_dependency(%q<dalli>, ["~> 2.7.2"])
-      s.add_dependency(%q<aws-sdk>, ["~> 1.60.2"])
-      s.add_dependency(%q<cucumber>, [">= 0"])
-      s.add_dependency(%q<bundler>, [">= 0"])
-      s.add_dependency(%q<builder>, [">= 0"])
-      s.add_dependency(%q<jeweler>, [">= 0"])
+  spec.metadata = {
+    'source_code_uri'   => spec.homepage,
+    'bug_tracker_uri'   => "#{spec.homepage}/issues",
+    'changelog_uri'     => "#{spec.homepage}/blob/master/doc/VERSIONS",
+    'documentation_uri' => "#{spec.homepage}/blob/master/README.md",
+    'rubygems_mfa_required' => 'true'
+  }
+
+  # Ruby 3.3 is the floor: the oldest maintained release the dependencies are
+  # resolved and tested against. The code is written for Ruby 3.3 through 4.0.
+  #
+  # A lower bound only, and deliberately so. An upper bound would refuse a Ruby
+  # this code has every reason to work on, on the day it is released, and the
+  # only way to lift it would be a new release of this gem. What CI validates
+  # is a separate and narrower statement; see doc/REQUIREMENTS.md section 20.
+  spec.required_ruby_version = '>= 3.3.0'
+
+  # Shipped files. Derived from what Git sees, so that the list cannot drift
+  # from the repository; the Dir fallback is for building outside a checkout.
+  #
+  # --others --exclude-standard includes a file that has been created but not
+  # yet added, while still honouring .gitignore. Listing only --cached silently
+  # omits a new file from the built gem, which is a trap worth avoiding.
+  tracked =
+    begin
+      Dir.chdir(__dir__) {
+        `git ls-files -z --cached --others --exclude-standard`.split("\x0")
+      }
+    rescue StandardError
+      []
     end
-  else
-    s.add_dependency(%q<json>, ["~> 1.8.1"])
-    s.add_dependency(%q<sqlite3>, ["~> 1.3.10"])
-    s.add_dependency(%q<activesupport>, ["~> 4.1.8"])
-    s.add_dependency(%q<activerecord>, ["~> 4.1.8"])
-    s.add_dependency(%q<hashie>, ["~> 3.3.2"])
-    s.add_dependency(%q<gcalapi>, ["~> 0.1.2"])
-    s.add_dependency(%q<xml-simple>, ["~> 1.1.4"])
-    s.add_dependency(%q<feedbag>, ["~> 0.9.5"])
-    s.add_dependency(%q<nokogiri>, ["~> 1.6.5"])
-    s.add_dependency(%q<sanitize>, ["~> 3.1.0"])
-    s.add_dependency(%q<faraday>, ["~> 0.8.9"])
-    s.add_dependency(%q<twitter>, ["~> 4.8.0"])
-    s.add_dependency(%q<pocket-ruby>, ["~> 0.0.5"])
-    s.add_dependency(%q<weather_hacker>, ["~> 0.1.7"])
-    s.add_dependency(%q<hipchat>, ["~> 1.4.0"])
-    s.add_dependency(%q<fluent-logger>, ["~> 0.4.7"])
-    s.add_dependency(%q<dalli>, ["~> 2.7.2"])
-    s.add_dependency(%q<aws-sdk>, ["~> 1.60.2"])
-    s.add_dependency(%q<cucumber>, [">= 0"])
-    s.add_dependency(%q<bundler>, [">= 0"])
-    s.add_dependency(%q<builder>, [">= 0"])
-    s.add_dependency(%q<jeweler>, [">= 0"])
-  end
-end
 
+  tracked = Dir.chdir(__dir__) {
+    Dir.glob(
+      [
+        'bin/*', 'lib/**/*.rb', 'plugins/**/*.rb', 'config/*.yml',
+        'assets/**/*', 'doc/*', 'README.md', 'VERSION', 'automatic.gemspec'
+      ]
+    )
+  } if tracked.empty?
+
+  # Gemfile and Rakefile are development files and are deliberately not
+  # shipped: lib/automatic/environment.rb treats the presence of a Gemfile
+  # beside lib/ as "this is a source checkout", so shipping one would make an
+  # installed gem impose its own bundle on the program requiring it.
+  excluded = %w[.gitignore .github Gemfile Rakefile script spec test vendor]
+  spec.files = tracked.reject { |path|
+    path.end_with?('.gem') ||
+      excluded.any? { |prefix| path == prefix || path.start_with?("#{prefix}/") }
+  }.select { |path| File.file?(File.join(__dir__, path)) }
+
+  spec.bindir             = 'bin'
+  spec.executables        = ['automatic']
+  spec.require_paths      = ['lib']
+  spec.extra_rdoc_files   = ['README.md', 'doc/LICENSE.md']
+
+  # Runtime dependencies: what the framework in lib/ requires, and nothing
+  # else. Requiring `automatic`, loading a Recipe, loading a plugin, running a
+  # pipeline and the CLI's own work are what these four are for.
+  #
+  # A gem needed by a plugin is NOT declared here, however useful that plugin
+  # is. It is required inside the plugin's own file and installed by the
+  # operator who uses the plugin: `gem install automatic` therefore installs no
+  # HTML parser, no database and no service client. The optional gems, which
+  # plugin needs which, and how to install them are in the Gemfile's optional
+  # groups, doc/DEPLOYMENT.md and doc/POLICY.md section 9.1.
+  #
+  # rexml and rss left the standard library and became gems over the 3.x
+  # series. Each gem listed here is listed because a file in lib/ requires it,
+  # and a library's move out of the standard library is not by itself a reason
+  # to declare it: a library only a plugin needs goes in the Gemfile's optional
+  # groups instead.
+  spec.add_dependency 'activesupport', '>= 7.1', '< 9.0'   # plugin loader, XML subscription
+  spec.add_dependency 'hashie',        '>= 4.0', '< 6.0'   # Recipe
+  spec.add_dependency 'rexml',         '>= 3.2', '< 4.0'   # OPML parser
+  spec.add_dependency 'rss',           '>= 0.3', '< 1.0'   # the pipeline value
+
+  spec.add_development_dependency 'rake',                      '~> 13.0'
+  spec.add_development_dependency 'rspec',                     '~> 3.13'
+  spec.add_development_dependency 'rspec-collection_matchers', '~> 1.2'
+  spec.add_development_dependency 'rspec-its',                 '>= 1.3', '< 3.0'
+  spec.add_development_dependency 'simplecov',                 '>= 0.22', '< 2.0'
+end

data/bin/automatic

@@ -1,141 +1,22 @@
 #!/usr/bin/env ruby
 # -*- coding: utf-8 -*-
-# Name::      Automatic::Ruby
-# Author::    774 <http://id774.net>
-# Created::   Feb 18, 2012
-# Updated::   Feb 21, 2014
-# Copyright:: Copyright (c) 2012-2014 Automatic Ruby Developers.
-# License::   Licensed under the GNU GENERAL PUBLIC LICENSE, Version 3.0.
-
-root_dir = File.expand_path("..", File.dirname(__FILE__))
-$:.unshift root_dir
-$:.unshift root_dir + '/lib'
-
-require 'automatic'
-require 'rubygems'
-require 'optparse'
-require 'fileutils'
-require 'feedbag'
-require 'pp'
-
-recipe_path = ""
-
-def abort_with_usage(subcommand, message)
-  top_filename = File.basename($0)
-  abort("Usage: #{top_filename} #{subcommand} #{message}")
-end
-
-subparsers = {
-  'scaffold' => lambda {|argv|
-    Dir::entries(root_dir + '/plugins').sort.each {|path|
-      dir = (File.expand_path('~/.automatic/plugins/' + path))
-      unless File.exist?(dir)
-        FileUtils.mkdir_p(dir)
-        puts "Creating #{dir}"
-      end
-    }
-    dir = (File.expand_path('~/.automatic/assets'))
-    unless File.exist?(dir)
-      FileUtils.mkdir_p(dir)
-      FileUtils.cp_r(root_dir + '/assets/siteinfo', dir + '/siteinfo')
-      puts "Creating #{dir}"
-    end
-    dir = (File.expand_path('~/.automatic/config'))
-    unless File.exist?(dir)
-      FileUtils.mkdir_p(dir)
-      FileUtils.cp_r(root_dir + '/config', dir + '/example')
-      puts "Creating #{dir}"
-    end
-    dir = (File.expand_path('~/.automatic/db'))
-    unless File.exist?(dir)
-      FileUtils.mkdir_p(dir)
-      puts "Creating #{dir}"
-    end
-  },
-  'unscaffold' => lambda {|argv|
-    dir = (File.expand_path('~/.automatic'))
-    if File.directory?(dir)
-      puts "Removing #{dir}"
-      FileUtils.rm_r(dir)
-    end
-  },
-  'autodiscovery' => lambda {|argv|
-    url = argv.shift || abort_with_usage("autodiscovery", "<url>")
-    pp Feedbag.find(url)
-  },
-  'feedparser' => lambda {|argv|
-    require 'automatic/feed_parser'
-    url = argv.shift || abort_with_usage("feedparser", "<url>")
-    rss_results = Automatic::FeedParser.get_url(url)
-    pp rss_results
-  },
-  'inspect' => lambda {|argv|
-    require 'automatic/feed_parser'
-    url = argv.shift || abort_with_usage("inspect", "<url>")
-    feeds = Feedbag.find(url)
-    pp feeds
-    rss_results = Automatic::FeedParser.get_url(feeds.pop)
-    pp rss_results
-  },
-  'opmlparser' => lambda {|argv|
-    require 'automatic/opml'
-    path = argv.shift
-    if path.nil?
-      abort_with_usage("opmlparser", "<opml path>")
-    end
-    parser = Automatic::OPML::Parser.new(File.read(path))
-    parser.each_outline {|opml, o|
-      puts "#{o.xmlUrl}"
-    }
-  },
-  'log' => lambda {|argv|
-    require 'automatic/log'
-    level = argv.shift || abort_with_usage("log", "<level> <message>")
-    message = ARGV.shift
-    Automatic::Log.puts(level, message)
-  }
-}
-
-parser = OptionParser.new {|parser|
-  parser.version = Automatic.const_get(:VERSION)
-  parser.banner = "Automatic #{parser.version}
-    Usage: automatic [options] [subcommand]"
-  parser.separator "SubCommands:"
-  subparsers.keys.each {|key|
-    parser.separator "    " + key
-  }
-    #{subparsers.keys.join(", ")}"
-  parser.separator "Options:"
-  parser.on('-c', '--config FILE', String,
-            "recipe YAML file"){|c| recipe_path = c}
-  parser.on('-h', '--help', "show this message") {
-    puts parser
-    exit 1
-  }
-}
-
-begin
-  Automatic::Log.puts("info", "Loading #{recipe_path}") unless recipe_path.empty?
-  parser.parse!
-rescue OptionParser::ParseError => err
-  $stderr.puts err.message
-  $stderr.puts parser.help
-  exit 2
-end
-
-unless recipe_path.to_s.empty?
-  recipe = Automatic::Recipe.new(recipe_path)
-  Automatic.run(:recipe   => recipe,
-                :root_dir => root_dir)
-else
-  parser.order!(ARGV)
-  unless ARGV.empty?
-    Hash.new {|h, k|
-      puts "No such subcommand: #{k}"
-      exit 1
-    }.update(subparsers)[ARGV.shift].call(ARGV)
-  else
-    puts parser
-    exit 1
-  end
-end
+# Name::        automatic
+# Author:       id774 (More info: http://id774.net)
+# Source Code:: https://github.com/id774/automaticruby
+# License::     The GPL version 3, or LGPL version 3 (Dual License).
+# Contact::     idnanashi@gmail.com
+# Created::     Feb 18, 2012
+# Updated::     Aug 14, 2026
+# Copyright::   Copyright (c) 2012-2026 Automatic Ruby Developers.
+#
+# The process entry point, and deliberately almost empty: everything that can
+# be tested lives in Automatic::CLI, which returns a status instead of exiting.
+# See doc/BASIC_DESIGN.md section 4.1.
+
+root_dir = File.expand_path('..', __dir__)
+lib_dir  = File.join(root_dir, 'lib')
+$LOAD_PATH.unshift(lib_dir) if File.directory?(lib_dir) && !$LOAD_PATH.include?(lib_dir)
+
+require 'automatic/cli'
+
+exit Automatic::CLI.run(ARGV, root_dir: root_dir)

data/config/feed2console.yml

@@ -1,7 +1,13 @@
+# Print a public feed to the terminal.
+#
+#   automatic -c ~/.automatic/config/example/feed2console.yml
+#
+# The same pipeline as feed2markdown.yml with a different last plugin, which
+# is the plugin to end a Recipe with while you are still writing it. Nothing
+# here needs an account, a credential or a gem beyond the ones
+# `gem install automatic` brings.
+
 global:
-  timezone: Asia/Tokyo
-  cache:
-    base: /tmp
   log:
     level: info
 
@@ -9,6 +15,6 @@ plugins:
   - module: SubscriptionFeed
     config:
       feeds:
-        - http://blog.id774.net/post/feed/
+        - https://www.ruby-lang.org/en/feeds/news.rss
 
   - module: PublishConsole

data/config/feed2markdown.yml

@@ -0,0 +1,41 @@
+# Collect public information and leave the result as a Markdown document.
+#
+#   automatic -c ~/.automatic/config/example/feed2markdown.yml
+#
+# The document is readable as it stands, searchable with grep, worth keeping in
+# version control, and ready to hand to a program that takes text as input.
+# Nothing here needs an account, a credential, a service or a gem beyond the
+# ones `gem install automatic` brings: the Recipe is the framework's core and
+# two plugins that need nothing of their own.
+#
+# Running it twice appends the same items twice. To collect only what is new,
+# put a store plugin in front of the publisher -- it records what has already
+# been written, which is also what makes a Recipe safe to run from cron:
+#
+#   - module: StorePermalink
+#     config:
+#       db: feed2markdown.db
+#
+# The store plugins keep their records in SQLite through ActiveRecord, which is
+# an optional dependency rather than a framework one:
+#
+#   gem install activerecord sqlite3
+#
+# See doc/DEPLOYMENT.md for the optional plugin dependencies, and
+# doc/QUICKSTART.md for a first run taken step by step.
+#
+# To send the document to standard output instead, drop the PublishMarkdown
+# config and set the log level to none, so that only the document is written:
+#
+#   automatic -c feed2markdown.yml > today.md
+
+plugins:
+  - module: SubscriptionFeed
+    config:
+      feeds:
+        - https://www.ruby-lang.org/en/feeds/news.rss
+
+  - module: PublishMarkdown
+    config:
+      file: ~/.automatic/markdown/feeds.md
+      mode: append