number_station 0.1.1 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 377a40f8d4aaf4f86503a468bcbb133b10b738d4553e5da6849490150ce41b98
-  data.tar.gz: 0ba471edeabe6cee234897cc18913aacad818417c39bc5cbc7c5e639e7af6c1e
+  metadata.gz: 7074376c291002a254430a7f9d9126e4fd1004f77db7d3d063e8ab0cee401332
+  data.tar.gz: d9262e7c76cf7c457835084e794ddb5d92816009a50cfbb6ec8bd88ba98daf1f
 SHA512:
-  metadata.gz: cd740ab71dc7da9f01d81e844c7a71fa6ba5afa6c02eb332f3eb995f71fe6b768617f73149c625b3d0e9d5f1833cc7d0221a66b8f9f13233eeca0b17f89246f8
-  data.tar.gz: 21d407d3f8db3aa68dfc81265235553d39f6474c96bbdc483960d31396043a12a3d724319b2fc80ccef5de7cbed4227a68847e00b71738d4daf8d17ce71f7ec9
+  metadata.gz: e016902c9071daea7cee1fe57a367674638f81397dabc73b3b3ec8d1db77161cf905d0a8c84e51b6b5a95568967b274af00dacc19aa928fe932f6201a0481354
+  data.tar.gz: 228de828a66a1fbd85878ff33487b85522d4e30a628fd64c0cf9098a3ac26610fcd1d9ceeac918aa46e64e3c15aa890fb7d800af839351d6e067e34f3205b39a

data/README.asciidoc

@@ -1,8 +1,88 @@
 == number_station ==
-This gem (WIP) contains a number of utilities to aid in the running of a number station.
+This gem contains utilities to aid in the running of a number station.
 
 image:https://badge.fury.io/rb/number_station.svg["Gem Version", link="https://badge.fury.io/rb/number_station"]
 
+=== Installation ===
+
+  gem install number_station
+
+=== Usage ===
+
+==== Configuration ====
+
+Create the initial configuration:
+
+  number_station create_config
+
+This creates `~/number_station/conf.yaml` and copies template files (`intro_message.txt`, `outro_message.txt`, `repeat_message.txt`) to the same directory.
+
+==== Agent Management ====
+
+Manage agents using the `agents` subcommand:
+
+*Create an agent:*
+  number_station agents create NAME [--location LOCATION] [--handler HANDLER]
+
+*Activate/Deactivate:*
+  number_station agents activate NAME [--start-date DATE]
+  number_station agents deactivate NAME [--end-date DATE]
+
+*Update handler codeword:*
+  number_station agents update-handler NAME HANDLER
+
+*View agents:*
+  number_station agents list              # Active agents only
+  number_station agents list-all          # All agents with history
+  number_station agents stats             # Detailed statistics
+
+==== One-Time Pads ====
+
+*Create pads:*
+  number_station pad create [--name AGENT] [--numpads NUM] [--length LENGTH]
+
+If `--name` is provided, creates pad in `~/number_station/pads/AGENT/` directory.
+Defaults: 500 pads, 500 characters (rounded up to nearest multiple of 5).
+
+*View pad statistics:*
+  number_station pad stats [--path PATH]
+
+Shows pad statistics grouped by agent, including unconsumed pad counts.
+
+==== Message Encryption/Decryption ====
+
+*Encrypt:*
+  number_station encrypt [MESSAGE] [--file FILE] [--agent AGENT] [--padpath PADPATH] [--numpad NUMPAD]
+
+If `--agent` is provided, searches for oldest pad in agent-specific directory.
+Only active agents can encrypt messages.
+
+*Decrypt:*
+  number_station decrypt [MESSAGE] [--file FILE] [--padpath PADPATH] [--numpad NUMPAD]
+
+==== Phonetic Conversion ====
+
+*Convert to phonetic:*
+  number_station convert_to_phonetic FILE [--intro INTRO_FILE] [--outro OUTRO_FILE] [--repeat REPEAT_FILE]
+
+Converts encrypted message to phonetic alphabet. Output saved as `FILENAME_phonetic.txt`.
+Intro, outro, and repeat messages are included as-is (not converted).
+
+*Convert to espeak XML:*
+  number_station convert_to_espeak PHONETIC_FILE
+
+Generates GLaDOS-style espeak XML file. Output saved as `FILENAME.xml`.
+
+*Generate MP3:*
+  number_station convert_to_mp3 XML_FILE
+
+Converts XML to MP3 using espeak and ffmpeg. Output saved as `FILENAME.mp3`.
+
+*Play audio:*
+  number_station espeak XML_FILE
+
+Plays the XML file using espeak with GLaDOS voice settings.
+
 === Contributing ===
 Contributions are welcome, please fork the repo, create a branch, add your code, and make a PR
 against master on this repo. For more information see _CONTRIBUTING.asciidoc_
@@ -14,5 +94,3 @@ file.
 === Number Station Resources ===
 
 - https://linuxcoffee.com/numbers/
-- http://users.telenet.be/d.rijmenants/en/onetimepad.htm
-- https://www.numbers-stations.com/

data/Rakefile

@@ -21,20 +21,74 @@
 
 require 'bundler'
 require 'fileutils'
+
+# Ensure we load from local lib directory, not installed gem
+# This must happen before requiring number_station/version
+lib = File.expand_path('lib', __FILE__)
+# Remove gem paths that might interfere
+gem_paths = $LOAD_PATH.select { |p| p.include?('gems') && p.include?('number_station') }
+gem_paths.each { |p| $LOAD_PATH.delete(p) }
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+
+# Load version from local source
+require_relative 'lib/number_station/version'
+
 Bundler::GemHelper.install_tasks
 
 task :default => :menu
 
+desc "Show available rake tasks"
 task :menu do
-  puts welcomeMsg = <<-MSG
-rake build    # Build number_station-x.x.x.gem into the pkg directory
-rake install  # Build and install number_station-x.x.x.gem into system gems
-rake release  # Create tag vx.x.x and build and push number_station-x.x.x.gem to http://rubygems.org/
+  puts <<-MSG
+Available tasks:
+
+  rake build      # Build number_station-x.x.x.gem into the pkg directory
+  rake install    # Build and install number_station-x.x.x.gem into system gems
+  rake release    # Create tag vx.x.x and build and push number_station-x.x.x.gem to http://rubygems.org/
+  rake clean      # Clean up build artifacts (.gem files and pkg directory)
+  rake version    # Show the current version
+  rake validate   # Validate the gemspec
+  rake console    # Start an interactive console with the gem loaded
+
 MSG
 end
 
 desc "Clean up build artifacts"
 task :clean do
   FileUtils.rm_rf("./pkg/")
+  FileUtils.rm_f(Dir.glob("*.gem"))
+  puts "Cleaned build artifacts"
+end
+
+desc "Show the current version"
+task :version do
+  puts "number_station version: #{NumberStation::VERSION}"
+end
+
+desc "Validate the gemspec"
+task :validate do
+  require 'rubygems/specification'
+  
+  begin
+    spec = Gem::Specification.load('number_station.gemspec')
+    puts "✓ Gemspec is valid"
+    puts "  Name: #{spec.name}"
+    puts "  Version: #{spec.version}"
+    puts "  Dependencies: #{spec.dependencies.map(&:name).join(', ')}"
+  rescue => e
+    puts "✗ Gemspec validation failed: #{e.message}"
+    exit 1
+  end
 end
 
+desc "Start an interactive console"
+task :console do
+  require 'irb'
+  require 'number_station'
+  ARGV.clear
+  IRB.start
+end
+
+# Clean before building
+task :build => :clean
+

data/lib/number_station/GLaDOS_espeak.rb

@@ -0,0 +1,79 @@
+=begin
+ Ruby Number Station
+ Author: David Kirwan https://gitub.com/davidkirwan
+ Licence: GPL 3.0
+ NumberStation is a collection of utilities to aid in the running of a number station
+    Copyright (C) 2018  David Kirwan
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program 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 General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+=end
+
+module NumberStation
+  def self.generate_glados_espeak(input_file_path)
+    # Read message from file
+    message = File.read(input_file_path)
+    
+    # Generate output filename: remove .txt extension and append .xml
+    input_basename = File.basename(input_file_path, File.extname(input_file_path))
+    output_filename = "#{input_basename}.xml"
+    output_path = File.join(File.dirname(input_file_path), output_filename)
+    
+    # Process message into GLaDOS-style XML
+    # Split by whitespace but preserve the structure - handle spaces and newlines
+    # Split on whitespace boundaries but keep track of what was between words
+    sentence = "<speak version=\"1.0\" xmlns=\"\" xmlns:xsi=\"\" xsi:schemaLocation=\"\" xml:lang=\"\"><voice gender=\"female\">"
+    sentenceend = "</voice></speak>"
+
+    # Split message into words, preserving spacing structure
+    # Use a regex that captures words and the whitespace after them
+    parts = message.split(/(\s+)/)
+    
+    parts.each do |part|
+      if part.match?(/^\s+$/)
+        # This is whitespace - preserve it (spaces or newlines)
+        sentence += part
+      elsif !part.empty?
+        # This is a word - wrap it in prosody tags
+        sentence += template(part)
+      end
+    end
+
+    final = sentence + sentenceend
+
+    # Write XML file
+    File.write(output_path, final)
+    if NumberStation.respond_to?(:log) && NumberStation.log
+      NumberStation.log.info "Generated GLaDOS espeak XML: #{output_path}"
+    end
+    
+    output_path
+  end
+
+  private
+
+  def self.template(word)
+    sign = randomsign() || ""
+    "<prosody pitch=\"#{sign + rand(0..80).to_s}\">#{word}</prosody>"
+  end
+
+  def self.randomsign()
+    rnum = rand(0..1)
+
+    if rnum == 0
+      return "-"
+    else
+      return "+"
+    end
+  end
+end