nhkore 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4341573213802220b2346cc1f4b413c6749e260cd175321720da5c9c255df5de
+  data.tar.gz: c521924378f5bd723b9a19fcb80322a9b038ebeb4a696cd0a5b141bdf3cc9e17
+SHA512:
+  metadata.gz: 890109ade84eeb406bf74e0bb101e79bded018d3d1988587911600a95782c010686932b9206f08413f7502168b86a867cbea1724fd0dd9b5134dd139a642e440
+  data.tar.gz: dc82cb006343c13e87011bf5408575df4f4a8e4c84b70d7cbe1db1a240248188fa1b9861c7634d6d6220b4f24c41c471ee341cf7cc76a40ef90b4df84f8e0522

data/CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog | NHKore
+
+Format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
+
+## [[Unreleased]](https://github.com/esotericpig/nhkore/compare/v0.1.1...master)
+
+## [v0.1.0] - 2020-02-24
+### Added
+- .gitignore
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- nhkore.gemspec
+- Rakefile
+- README.md
+- TODO.md
+- bin/nhkore
+- lib/nhkore.rb
+- lib/nhkore/version.rb
+- lib/nhkore/word.rb
+- test/nhkore_test.rb
+- test/nhkore_tester.rb
+- yard/templates/default/layout/html/footer.erb

data/Gemfile

@@ -0,0 +1,25 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of NHKore.
+# Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)
+# 
+# NHKore is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# NHKore is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with NHKore.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,165 @@
+                   GNU LESSER GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+
+  This version of the GNU Lesser General Public License incorporates
+the terms and conditions of version 3 of the GNU General Public
+License, supplemented by the additional permissions listed below.
+
+  0. Additional Definitions.
+
+  As used herein, "this License" refers to version 3 of the GNU Lesser
+General Public License, and the "GNU GPL" refers to version 3 of the GNU
+General Public License.
+
+  "The Library" refers to a covered work governed by this License,
+other than an Application or a Combined Work as defined below.
+
+  An "Application" is any work that makes use of an interface provided
+by the Library, but which is not otherwise based on the Library.
+Defining a subclass of a class defined by the Library is deemed a mode
+of using an interface provided by the Library.
+
+  A "Combined Work" is a work produced by combining or linking an
+Application with the Library.  The particular version of the Library
+with which the Combined Work was made is also called the "Linked
+Version".
+
+  The "Minimal Corresponding Source" for a Combined Work means the
+Corresponding Source for the Combined Work, excluding any source code
+for portions of the Combined Work that, considered in isolation, are
+based on the Application, and not on the Linked Version.
+
+  The "Corresponding Application Code" for a Combined Work means the
+object code and/or source code for the Application, including any data
+and utility programs needed for reproducing the Combined Work from the
+Application, but excluding the System Libraries of the Combined Work.
+
+  1. Exception to Section 3 of the GNU GPL.
+
+  You may convey a covered work under sections 3 and 4 of this License
+without being bound by section 3 of the GNU GPL.
+
+  2. Conveying Modified Versions.
+
+  If you modify a copy of the Library, and, in your modifications, a
+facility refers to a function or data to be supplied by an Application
+that uses the facility (other than as an argument passed when the
+facility is invoked), then you may convey a copy of the modified
+version:
+
+   a) under this License, provided that you make a good faith effort to
+   ensure that, in the event an Application does not supply the
+   function or data, the facility still operates, and performs
+   whatever part of its purpose remains meaningful, or
+
+   b) under the GNU GPL, with none of the additional permissions of
+   this License applicable to that copy.
+
+  3. Object Code Incorporating Material from Library Header Files.
+
+  The object code form of an Application may incorporate material from
+a header file that is part of the Library.  You may convey such object
+code under terms of your choice, provided that, if the incorporated
+material is not limited to numerical parameters, data structure
+layouts and accessors, or small macros, inline functions and templates
+(ten or fewer lines in length), you do both of the following:
+
+   a) Give prominent notice with each copy of the object code that the
+   Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the object code with a copy of the GNU GPL and this license
+   document.
+
+  4. Combined Works.
+
+  You may convey a Combined Work under terms of your choice that,
+taken together, effectively do not restrict modification of the
+portions of the Library contained in the Combined Work and reverse
+engineering for debugging such modifications, if you also do each of
+the following:
+
+   a) Give prominent notice with each copy of the Combined Work that
+   the Library is used in it and that the Library and its use are
+   covered by this License.
+
+   b) Accompany the Combined Work with a copy of the GNU GPL and this license
+   document.
+
+   c) For a Combined Work that displays copyright notices during
+   execution, include the copyright notice for the Library among
+   these notices, as well as a reference directing the user to the
+   copies of the GNU GPL and this license document.
+
+   d) Do one of the following:
+
+       0) Convey the Minimal Corresponding Source under the terms of this
+       License, and the Corresponding Application Code in a form
+       suitable for, and under terms that permit, the user to
+       recombine or relink the Application with a modified version of
+       the Linked Version to produce a modified Combined Work, in the
+       manner specified by section 6 of the GNU GPL for conveying
+       Corresponding Source.
+
+       1) Use a suitable shared library mechanism for linking with the
+       Library.  A suitable mechanism is one that (a) uses at run time
+       a copy of the Library already present on the user's computer
+       system, and (b) will operate properly with a modified version
+       of the Library that is interface-compatible with the Linked
+       Version.
+
+   e) Provide Installation Information, but only if you would otherwise
+   be required to provide such information under section 6 of the
+   GNU GPL, and only to the extent that such information is
+   necessary to install and execute a modified version of the
+   Combined Work produced by recombining or relinking the
+   Application with a modified version of the Linked Version. (If
+   you use option 4d0, the Installation Information must accompany
+   the Minimal Corresponding Source and Corresponding Application
+   Code. If you use option 4d1, you must provide the Installation
+   Information in the manner specified by section 6 of the GNU GPL
+   for conveying Corresponding Source.)
+
+  5. Combined Libraries.
+
+  You may place library facilities that are a work based on the
+Library side by side in a single library together with other library
+facilities that are not Applications and are not covered by this
+License, and convey such a combined library under terms of your
+choice, if you do both of the following:
+
+   a) Accompany the combined library with a copy of the same work based
+   on the Library, uncombined with any other library facilities,
+   conveyed under the terms of this License.
+
+   b) Give prominent notice with the combined library that part of it
+   is a work based on the Library, and explaining where to find the
+   accompanying uncombined form of the same work.
+
+  6. Revised Versions of the GNU Lesser General Public License.
+
+  The Free Software Foundation may publish revised and/or new versions
+of the GNU Lesser General Public License from time to time. Such new
+versions will be similar in spirit to the present version, but may
+differ in detail to address new problems or concerns.
+
+  Each version is given a distinguishing version number. If the
+Library as you received it specifies that a certain numbered version
+of the GNU Lesser General Public License "or any later version"
+applies to it, you have the option of following the terms and
+conditions either of that published version or of any later version
+published by the Free Software Foundation. If the Library as you
+received it does not specify a version number of the GNU Lesser
+General Public License, you may choose any version of the GNU Lesser
+General Public License ever published by the Free Software Foundation.
+
+  If the Library as you received it specifies that a proxy can decide
+whether future versions of the GNU Lesser General Public License shall
+apply, that proxy's public statement of acceptance of any version is
+permanent authorization for you to choose that version for the
+Library.

data/README.md

@@ -0,0 +1,69 @@
+# NHKore
+
+[![Gem Version](https://badge.fury.io/rb/nhkore.svg)](https://badge.fury.io/rb/nhkore)
+
+[![Source Code](https://img.shields.io/badge/source-github-%23A0522D.svg?style=for-the-badge)](https://github.com/esotericpig/nhkore)
+[![Changelog](https://img.shields.io/badge/changelog-md-%23A0522D.svg?style=for-the-badge)](CHANGELOG.md)
+[![License](https://img.shields.io/github/license/esotericpig/nhkore.svg?color=%23A0522D&style=for-the-badge)](LICENSE.txt)
+
+A CLI app that scrapes [NHK News Web Easy](https://www3.nhk.or.jp/news/easy/) to create a list of each word and its frequency (how many times it was used) for Japanese language learners.
+
+This is similar to a [core word/vocabulary list](https://www.fluentin3months.com/core-japanese-words/), hence the name NHKore.
+
+In the future, I would like to add the regular NHK News, using the links from the easy versions.
+
+## Contents
+
+- [Installing](#installing)
+- [Using](#using)
+- [Hacking](#hacking)
+- [License](#license)
+
+## [Installing](#contents)
+
+Pick your poison...
+
+With the RubyGems CLI package manager:
+
+`$ gem install nhkore`
+
+Manually:
+
+```
+$ git clone 'https://github.com/esotericpig/nhkore.git'
+$ cd nhkore
+$ bundle install
+$ bundle exec rake install:local
+```
+
+## [Using](#contents)
+
+TODO: using...
+
+## [Hacking](#contents)
+
+```
+$ git clone 'https://github.com/esotericpig/nhkore.git'
+$ bundle install
+$ bundle exec rake -T
+```
+
+## [License](#contents)
+
+[GNU LGPL v3+](LICENSE.txt)
+
+> NHKore (<https://github.com/esotericpig/nhkore>)  
+> Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)  
+> 
+> NHKore is free software: you can redistribute it and/or modify  
+> it under the terms of the GNU Lesser General Public License as published by  
+> the Free Software Foundation, either version 3 of the License, or  
+> (at your option) any later version.  
+> 
+> NHKore is distributed in the hope that it will be useful,  
+> but WITHOUT ANY WARRANTY; without even the implied warranty of  
+> MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the  
+> GNU Lesser General Public License for more details.  
+> 
+> You should have received a copy of the GNU Lesser General Public License  
+> along with NHKore.  If not, see <https://www.gnu.org/licenses/>.  

data/Rakefile

@@ -0,0 +1,108 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of NHKore.
+# Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)
+# 
+# NHKore is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# NHKore is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with NHKore.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+require 'bundler/gem_tasks'
+
+require 'nhkore/version'
+require 'rake/clean'
+require 'rake/testtask'
+require 'raketeer/irb'
+require 'raketeer/nokogiri_installs'
+require 'raketeer/run'
+require 'yard'
+require 'yard_ghurt'
+
+
+CORE_DIR = 'core'
+PKG_DIR = 'pkg'
+
+CLEAN.exclude('.git/','stock/',File.join(CORE_DIR,''))
+CLOBBER.include('doc/',File.join(PKG_DIR,''))
+
+
+task default: [:test]
+
+desc 'Generate documentation (YARDoc)'
+task :doc => [:yard,:yard_gfm_fix] do |task|
+end
+
+desc "Package '#{File.join(CORE_DIR,'')}' data as a Zip file into '#{File.join(PKG_DIR,'')}'"
+task :pkg_core do |task|
+  pattern = File.join(CORE_DIR,'**','*.{csv,yml}')
+  zip_name = "nhkore-core-#{NHKore::VERSION}.zip"
+  zip_file = File.join(PKG_DIR,zip_name)
+  
+  mkdir_p PKG_DIR
+  
+  Dir.glob(pattern).sort().each() do |file|
+    # Rake::PackageTask does the same thing
+    sh 'zip','-8','-r',zip_file,file
+  end
+end
+
+Rake::TestTask.new() do |task|
+  task.libs = ['lib','test']
+  task.pattern = File.join('test','**','*_test.rb')
+  task.description += ": '#{task.pattern}'"
+  task.verbose = true
+  task.warning = true
+end
+
+YARD::Rake::YardocTask.new() do |task|
+  task.files = [File.join('lib','**','*.rb')]
+  
+  task.options += ['--files','CHANGELOG.md,LICENSE.txt']
+  task.options += ['--readme','README.md']
+  
+  task.options << '--protected' # Show protected methods
+  task.options += ['--template-path',File.join('yard','templates')]
+  task.options += ['--title',"NHKore v#{NHKore::VERSION} Doc"]
+end
+
+# Execute "yard_gfm_fix" for production.
+# Execute "yard_gfm_fix[true]" for testing locally.
+YardGhurt::GFMFixTask.new() do |task|
+  task.arg_names = [:dev]
+  task.dry_run = false
+  task.fix_code_langs = true
+  task.md_files = ['index.html']
+  
+  task.before = Proc.new() do |task,args|
+    # Delete this file as it's never used (index.html is an exact copy)
+    YardGhurt::Util.rm_exist(File.join(task.doc_dir,'file.README.html'))
+    
+    # Root dir of my GitHub Page for CSS/JS
+    GHP_ROOT = YardGhurt::Util.to_bool(args.dev) ? '../../esotericpig.github.io' : '../../..'
+    
+    task.css_styles << %Q(<link rel="stylesheet" type="text/css" href="#{GHP_ROOT}/css/prism.css" />)
+    task.js_scripts << %Q(<script src="#{GHP_ROOT}/js/prism.js"></script>)
+  end
+end
+
+# Execute "rake yard_ghp_sync" for a dry run.
+# Execute "rake yard_ghp_sync[true]" for actually deploying.
+YardGhurt::GHPSyncTask.new() do |task|
+  task.description = %q(Rsync "doc/" to my GitHub Page's repo; not useful for others)
+  
+  task.ghp_dir = '../esotericpig.github.io/docs/nhkore/yardoc'
+  task.sync_args << '--delete-after'
+end

data/bin/nhkore

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of NHKore.
+# Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)
+# 
+# NHKore is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# NHKore is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with NHKore.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+require 'nhkore'
+
+
+#app = NHKore::App.new()
+
+#app.run()

data/lib/nhkore.rb

@@ -0,0 +1,80 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of NHKore.
+# Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)
+# 
+# NHKore is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# NHKore is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with NHKore.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+IS_TESTING = ($0 == __FILE__)
+
+if IS_TESTING
+  require 'rubygems'
+  require 'bundler/setup'
+end
+
+require 'nhkore/version'
+require 'nhkore/word'
+
+
+require 'nokogiri'
+require 'psychgus'
+
+# 2 files:
+# nhk_news_web_easy.yml
+# (only Dec 2019 as an example; more in release)
+# (add comment about above in this file)
+# - 2019-12-25 13:10 JST: (append 1,2,... if duplicate)
+#   - url: <url>
+#   - md5: <md5sum of content only (in case of ads)>
+#   - words:
+#     - word (kanji/kana):
+#       - kana:
+#       - freq:
+# (only Dec 2019 as an example; more in release)
+# nhk_news_web_easy_core_<search criteria>.csv
+#   word, kana, freq
+#   (sorted by freq, word, or kana [desc/asc])
+
+# nhkore --date '2019-12-01...2019-12-11'
+# nhkore --date '2019-12'
+# nhkore --date '12'    (Dec of this year)
+# nhkore --date '12-01' (Dec 1 of this year)
+
+class Article
+  attr_accessor :datetime
+  attr_accessor :futsuu_url
+  attr_accessor :md5
+  attr_accessor :url
+  attr_accessor :words
+end
+
+word = NHKore::Word.new(kana: 'banana')
+puts word.to_yaml
+
+###
+# @author Jonathan Bradley Whited (@esotericpig)
+# @since  0.1.0
+###
+module NHKore
+end
+
+# https://www3.nhk.or.jp/news/easy
+# https://www.google.com/search?q=site:https://www3.nhk.or.jp/news/easy/&tbas=0&tbs=cdr:1,cd_min:1/1/2019,cd_max:12/31/2019,sbd:1&tbm=nws&sxsrf=ALeKk01oebeT0hWvNro-vDn7WGYkRe0kxw:1582396168988&ei=CHNRXt7dO5KR0QSTnZGYCw&start=20&sa=N&ved=0ahUKEwjega-M5eXnAhWSSJQKHZNOBLM4ChDy0wMIag&biw=1028&bih=672&dpr=1.3
+
+#NHKore::App.new().run() if IS_TESTING

data/lib/nhkore/version.rb

@@ -0,0 +1,26 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of NHKore.
+# Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)
+# 
+# NHKore is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# NHKore is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with NHKore.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+module NHKore
+  VERSION = '0.1.0'
+end

data/lib/nhkore/word.rb

@@ -0,0 +1,79 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of NHKore.
+# Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)
+# 
+# NHKore is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# NHKore is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with NHKore.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+module NHKore
+  ###
+  # @author Jonathan Bradley Whited (@esotericpig)
+  # @since  0.1.0
+  ###
+  class Word
+    attr_accessor :freq
+    attr_reader :kana
+    attr_reader :word
+    
+    def initialize(word=nil,freq: 1,kana: nil,**kargs)
+      super()
+      
+      @freq = freq
+      @kana = kana
+      @word = word.nil?() ? kana : word
+      
+      raise ArgumentError,'word and kana cannot both be nil; one must be specified' if @word.nil?()
+    end
+    
+    def encode_with(coder)
+      # Ignore @word because it will be the key in the YAML/Hash.
+      # Order matters.
+      coder[:kana] = @kana
+      coder[:freq] = @freq
+    end
+    
+    def self.load_hash(key,hash)
+      word = Word.new(key,kana: hash[:kana])
+      
+      freq = hash[:freq].to_i() # nil is okay
+      word.freq = freq if freq >= 0
+      
+      return word
+    end
+    
+    def kanji?()
+      return @word != @kana
+    end
+    
+    def no_kanji?()
+      return !kanji?()
+    end
+    
+    def to_s()
+      s = ''.dup()
+      
+      s << @word
+      s << " | kana: #{@kana}"
+      s << " | freq: #{@freq}"
+      s << " | kanji? #{kanji?() ? 'yes' : 'no'}"
+      
+      return s
+    end
+  end
+end

data/nhkore.gemspec

@@ -0,0 +1,72 @@
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of NHKore.
+# Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)
+# 
+# NHKore is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# NHKore is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with NHKore.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+lib = File.expand_path(File.join('..','lib'),__FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+require 'nhkore/version'
+
+
+Gem::Specification.new() do |spec|
+  spec.name        = 'nhkore'
+  spec.version     = NHKore::VERSION
+  spec.authors     = ['Jonathan Bradley Whited (@esotericpig)']
+  spec.email       = ['bradley@esotericpig.com']
+  spec.licenses    = ['LGPL-3.0-or-later']
+  spec.homepage    = 'https://github.com/esotericpig/nhkore'
+  spec.summary     = 'NHK News Web (Easy) word frequency (core) for Japanese language learners.'
+  spec.description = 'Scrapes NHK News Web (Easy) for the word frequency (core list) for Japanese language learners.'
+  
+  spec.metadata = {
+    'bug_tracker_uri' => 'https://github.com/esotericpig/nhkore/issues',
+    'changelog_uri'   => 'https://github.com/esotericpig/nhkore/blob/master/CHANGELOG.md',
+    'homepage_uri'    => 'https://github.com/esotericpig/nhkore',
+    'source_code_uri' => 'https://github.com/esotericpig/nhkore'
+  }
+  
+  spec.require_paths = ['lib']
+  spec.bindir        = 'bin'
+  spec.executables   = [spec.name]
+  
+  spec.files = Dir.glob(File.join("{#{spec.require_paths.join(',')}}",'**','*.{erb,rb}')) +
+               Dir.glob(File.join(spec.bindir,'**',"{#{spec.executables.join(',')}}")) +
+               Dir.glob(File.join('{test,yard}','**','*.{erb,rb}')) +
+               %W( Gemfile #{spec.name}.gemspec Rakefile ) +
+               %w( CHANGELOG.md LICENSE.txt README.md )
+  
+  spec.required_ruby_version = '>= 2.4.0'
+  
+  spec.requirements << 'Nokogiri: https://www.nokogiri.org/tutorials/installing_nokogiri.html'
+  
+  spec.add_runtime_dependency 'commander','~> 4.5'  # For CLI
+  spec.add_runtime_dependency 'nokogiri' ,'~> 1.10' # For scraping/hacking
+  spec.add_runtime_dependency 'psychgus' ,'~> 1.2'  # For styling Psych YAML
+  
+  spec.add_development_dependency 'bundler'   ,'~> 2.1'
+  spec.add_development_dependency 'minitest'  ,'~> 5.14'
+  spec.add_development_dependency 'rake'      ,'~> 13.0'
+  spec.add_development_dependency 'raketeer'  ,'~> 0.2'  # For extra Rake tasks
+  spec.add_development_dependency 'yard'      ,'~> 0.9'  # For documentation
+  spec.add_development_dependency 'yard_ghurt','~> 1.1'  # For extra YARDoc Rake tasks
+  
+  spec.post_install_message = "You can now use [#{spec.executables.join(', ')}] on the command line."
+end

data/test/nhkore_test.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of NHKore.
+# Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)
+# 
+# NHKore is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# NHKore is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with NHKore.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+require 'nhkore_tester'
+
+
+class NHKoreTest < NHKoreTester
+  def setup()
+  end
+  
+  def test_something()
+  end
+end

data/test/nhkore_tester.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+#--
+# This file is part of NHKore.
+# Copyright (c) 2020 Jonathan Bradley Whited (@esotericpig)
+# 
+# NHKore is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+# 
+# NHKore is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+# 
+# You should have received a copy of the GNU Lesser General Public License
+# along with NHKore.  If not, see <https://www.gnu.org/licenses/>.
+#++
+
+
+require 'minitest/autorun'
+
+require 'nhkore'
+
+
+class NHKoreTester < Minitest::Test
+end

data/yard/templates/default/layout/html/footer.erb

@@ -0,0 +1,5 @@
+<%# To reduce number of diffs, removed time, YARD version, and Ruby version. %>
+<div id="footer">
+  Generated by
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>.
+</div>

metadata

@@ -0,0 +1,189 @@
+--- !ruby/object:Gem::Specification
+name: nhkore
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Jonathan Bradley Whited (@esotericpig)
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-02-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: commander
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.5'
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.10'
+- !ruby/object:Gem::Dependency
+  name: psychgus
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: raketeer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: yard_ghurt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+description: Scrapes NHK News Web (Easy) for the word frequency (core list) for Japanese
+  language learners.
+email:
+- bradley@esotericpig.com
+executables:
+- nhkore
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/nhkore
+- lib/nhkore.rb
+- lib/nhkore/version.rb
+- lib/nhkore/word.rb
+- nhkore.gemspec
+- test/nhkore_test.rb
+- test/nhkore_tester.rb
+- yard/templates/default/layout/html/footer.erb
+homepage: https://github.com/esotericpig/nhkore
+licenses:
+- LGPL-3.0-or-later
+metadata:
+  bug_tracker_uri: https://github.com/esotericpig/nhkore/issues
+  changelog_uri: https://github.com/esotericpig/nhkore/blob/master/CHANGELOG.md
+  homepage_uri: https://github.com/esotericpig/nhkore
+  source_code_uri: https://github.com/esotericpig/nhkore
+post_install_message: You can now use [nhkore] on the command line.
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements:
+- 'Nokogiri: https://www.nokogiri.org/tutorials/installing_nokogiri.html'
+rubygems_version: 3.1.2
+signing_key: 
+specification_version: 4
+summary: NHK News Web (Easy) word frequency (core) for Japanese language learners.
+test_files: []