number_station 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7074376c291002a254430a7f9d9126e4fd1004f77db7d3d063e8ab0cee401332
-  data.tar.gz: d9262e7c76cf7c457835084e794ddb5d92816009a50cfbb6ec8bd88ba98daf1f
+  metadata.gz: d9d58534a90398f402d7fad891415ab81782d96aaa440964703c6d33a1e89f37
+  data.tar.gz: 7ca3efa06033aacc95db71c8bd9622f9869f82caa1e535a50f592d72b2f39a5e
 SHA512:
-  metadata.gz: e016902c9071daea7cee1fe57a367674638f81397dabc73b3b3ec8d1db77161cf905d0a8c84e51b6b5a95568967b274af00dacc19aa928fe932f6201a0481354
-  data.tar.gz: 228de828a66a1fbd85878ff33487b85522d4e30a628fd64c0cf9098a3ac26610fcd1d9ceeac918aa46e64e3c15aa890fb7d800af839351d6e067e34f3205b39a
+  metadata.gz: 73577af7d0e0e2d6b383398dc3c49dee4d2cfe816d0a6e5d19da5947409108bb79343ddc9fade867209f4dc4973c33d4083ea8098bf691766a2edb81ebd1391b
+  data.tar.gz: fff53ecba16b4b3d77674148f2982aa2022cae2e8f5ad0d4995a103562663a4b3bd0aae3337a7be0089c1bfcb152814453f8692456c8ca2af5f932ab5d04198e

data/README.asciidoc

@@ -1,11 +1,15 @@
 == 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
+[source,bash]
+----
+gem install number_station
+----
 
 === Usage ===
 
@@ -13,7 +17,10 @@ image:https://badge.fury.io/rb/number_station.svg["Gem Version", link="https://b
 
 Create the initial configuration:
 
-  number_station create_config
+[source,bash]
+----
+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.
 
@@ -22,64 +29,147 @@ This creates `~/number_station/conf.yaml` and copies template files (`intro_mess
 Manage agents using the `agents` subcommand:
 
 *Create an agent:*
-  number_station agents create NAME [--location LOCATION] [--handler HANDLER]
+
+[source,bash]
+----
+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]
+
+[source,bash]
+----
+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
+
+[source,bash]
+----
+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
+
+[source,bash]
+----
+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]
+
+[source,bash]
+----
+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).
+Defaults: 500 pads, 500 characters. Pad length is automatically rounded up to the nearest multiple of 5.
 
 *View pad statistics:*
-  number_station pad stats [--path PATH]
+
+[source,bash]
+----
+number_station pad stats [--path PATH]
+----
 
 Shows pad statistics grouped by agent, including unconsumed pad counts.
 
+*Convert pad to AsciiDoc:*
+
+[source,bash]
+----
+number_station convert_pad_to_asciidoc --padpath PAD_FILE
+----
+
+Converts a pad file to AsciiDoc format with each pad as a chapter. Output saved as `FILENAME.asciidoc`.
+Pads are formatted in groups of 5 characters with page breaks after every 2nd pad.
+
+*Convert pad to LaTeX:*
+
+[source,bash]
+----
+number_station convert_pad_to_latex --padpath PAD_FILE
+----
+
+Converts a pad file to LaTeX format with landscape orientation. Output saved as `FILENAME.tex`.
+Pads are formatted in groups of 5 characters, arranged in a 2x2 grid (4 pads per page), with each pad taking up one quadrant of the page.
+
+*Convert to PDF:*
+
+[source,bash]
+----
+number_station convert_to_pdf INPUT_FILE
+----
+
+Converts an AsciiDoc (`.asciidoc` or `.adoc`) or LaTeX (`.tex`) file to PDF.
++
+For AsciiDoc files: Uses asciidoctor-pdf. Requires asciidoctor-pdf gem to be installed.
++
+For LaTeX files: Uses pdflatex. Requires a LaTeX distribution (e.g., texlive) to be installed.
++
+Output saved as `FILENAME.pdf` in the same directory.
+
 ==== Message Encryption/Decryption ====
 
 *Encrypt:*
-  number_station encrypt [MESSAGE] [--file FILE] [--agent AGENT] [--padpath PADPATH] [--numpad NUMPAD]
+
+[source,bash]
+----
+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]
+
+[source,bash]
+----
+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]
+
+[source,bash]
+----
+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
+
+[source,bash]
+----
+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
+
+[source,bash]
+----
+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
+
+[source,bash]
+----
+number_station espeak XML_FILE
+----
 
 Plays the XML file using espeak with GLaDOS voice settings.
 

data/lib/number_station/cli.rb

@@ -22,6 +22,7 @@
 require 'thor'
 require 'fileutils'
 require 'date'
+require 'json'
 
 module NumberStation
   class Pad < Thor
@@ -38,13 +39,16 @@ module NumberStation
       --name NAME - Agent name to associate with this pad. Creates subdirectory ~/number_station/pads/NAME/ if --path is not provided
       --path PATH - Directory where the pad file will be created (defaults to current directory, or ~/number_station/pads/NAME/ if --name is provided)
       --numpads NUM - Number of pads to generate (defaults to 500)
-      --length LENGTH - Length of each pad in characters (defaults to 500)
+      --length LENGTH - Length of each pad in characters (defaults to 500, rounded up to nearest multiple of 5)
 
     If no parameters are passed it will generate 500 one time pads in the current
     directory of size 500 characters.
     
     If --name is provided without --path, the pad will be created in ~/number_station/pads/NAME/
     
+    Note: Pad length is automatically rounded up to the nearest multiple of 5 to ensure
+    proper formatting in 5-character groups.
+    
     Examples:
       number_station pad create --name Shadow --numpads 1000 --length 1000
       number_station pad create --name Shadow
@@ -419,7 +423,7 @@ module NumberStation
 
     desc "activate NAME", "Activate an agent"
     long_desc <<-ACTIVATE_AGENT_LONG_DESC
-    Activate an agent by name. Sets active status to true and optionally sets start_date.
+    Activate an agent by name. Sets active status to true, optionally sets start_date, and resets end_date to null.
     
     Parameters:
       NAME - The agent name (required)
@@ -427,6 +431,8 @@ module NumberStation
     Options:
       --start-date DATE - Set the start date (defaults to today if not specified)
     
+    When activating an agent, the end_date is automatically reset to null (clearing any previous end date).
+    
     Examples:
       number_station agents activate Shadow
       number_station agents activate Shadow --start-date "2024-01-15"
@@ -676,6 +682,300 @@ module NumberStation
       puts "Generated GLaDOS espeak XML: #{output_path}"
     end
 
+    desc "convert_pad_to_asciidoc --padpath PADPATH", "Convert a pad file to AsciiDoc format"
+    long_desc <<-CONVERT_PAD_TO_ASCIIDOC_LONG_DESC
+    Convert a one-time pad file to AsciiDoc format with each pad as a chapter.
+    
+    Parameters:
+      --padpath PADPATH - Path to pad file (e.g., ~/number_station/pads/Shadow/Shadow-2026-01-12.json)
+    
+    Each pad in the file is converted to groups of 5 characters, separated by spaces.
+    Output saved as FILENAME.asciidoc in the same directory.
+    
+    Example:
+      number_station convert_pad_to_asciidoc --padpath ~/number_station/pads/Shadow/Shadow-2026-01-12.json
+    CONVERT_PAD_TO_ASCIIDOC_LONG_DESC
+    option :padpath, type: :string, required: true
+    def convert_pad_to_asciidoc
+      ensure_config_loaded
+      
+      pad_path = options[:padpath]
+      unless File.exist?(pad_path)
+        raise Thor::Error, "Pad file not found: #{pad_path}"
+      end
+      
+      # Read pad file
+      pad_data = JSON.parse(File.read(pad_path))
+      pad_id = pad_data["id"]
+      pads_hash = pad_data["pads"]
+      
+      if pads_hash.nil? || pads_hash.empty?
+        raise Thor::Error, "No pads found in file: #{pad_path}"
+      end
+      
+      # Generate output filename: replace .json extension with .asciidoc
+      input_basename = File.basename(pad_path, File.extname(pad_path))
+      output_filename = "#{input_basename}.asciidoc"
+      output_path = File.join(File.dirname(pad_path), output_filename)
+      
+      # Build AsciiDoc content
+      asciidoc_content = []
+      asciidoc_content << "= One-Time Pad: #{input_basename}"
+      asciidoc_content << ""
+      
+      # Process each pad
+      pads_hash.sort_by { |k, v| k.to_i }.each do |pad_num, pad_info|
+        hex_key = pad_info["key"]
+        
+        # Convert hex string to groups of 5 characters, separated by spaces
+        # Remove any existing formatting and group by 5
+        cleaned_hex = hex_key.gsub(/[\s\n\r]/, '')
+        grouped_hex = cleaned_hex.chars.each_slice(5).map(&:join).join(' ')
+        
+        # Add chapter heading for this pad
+        asciidoc_content << "== Pad #{pad_num}"
+        asciidoc_content << ""
+        asciidoc_content << "[source]"
+        asciidoc_content << "----"
+        asciidoc_content << grouped_hex
+        asciidoc_content << "----"
+        asciidoc_content << ""
+        
+        # Add page break after every 2nd pad (after pad 1, 3, 5, etc.)
+        if pad_num.to_i % 2 == 1
+          asciidoc_content << "<<<"
+          asciidoc_content << ""
+        end
+      end
+      
+      # Write AsciiDoc file
+      File.write(output_path, asciidoc_content.join("\n"))
+      puts "Generated AsciiDoc file: #{output_path}"
+    end
+
+    desc "convert_pad_to_latex --padpath PADPATH", "Convert a pad file to LaTeX format"
+    long_desc <<-CONVERT_PAD_TO_LATEX_LONG_DESC
+    Convert a one-time pad file to LaTeX format with landscape orientation.
+    
+    Parameters:
+      --padpath PADPATH - Path to pad file (e.g., ~/number_station/pads/Shadow/Shadow-2026-01-12.json)
+    
+    Each pad in the file is converted to groups of 5 characters, separated by spaces.
+    Pads are arranged in a 2x2 grid (4 pads per page), with each pad taking up one quadrant.
+    Output saved as FILENAME.tex in the same directory.
+    
+    The LaTeX file uses landscape orientation and can be converted to PDF using convert_to_pdf.
+    
+    Example:
+      number_station convert_pad_to_latex --padpath ~/number_station/pads/Shadow/Shadow-2026-01-12.json
+    CONVERT_PAD_TO_LATEX_LONG_DESC
+    option :padpath, type: :string, required: true
+    def convert_pad_to_latex
+      ensure_config_loaded
+      
+      pad_path = options[:padpath]
+      unless File.exist?(pad_path)
+        raise Thor::Error, "Pad file not found: #{pad_path}"
+      end
+      
+      # Read pad file
+      pad_data = JSON.parse(File.read(pad_path))
+      pad_id = pad_data["id"]
+      pads_hash = pad_data["pads"]
+      
+      if pads_hash.nil? || pads_hash.empty?
+        raise Thor::Error, "No pads found in file: #{pad_path}"
+      end
+      
+      # Generate output filename: replace .json extension with .tex
+      input_basename = File.basename(pad_path, File.extname(pad_path))
+      output_filename = "#{input_basename}.tex"
+      output_path = File.join(File.dirname(pad_path), output_filename)
+      
+      # Build LaTeX content
+      latex_content = []
+      latex_content << "\\documentclass[10pt]{article}"
+      latex_content << "\\usepackage[utf8]{inputenc}"
+      latex_content << "\\usepackage[landscape,margin=0.5in]{geometry}"
+      latex_content << "\\usepackage{fancyhdr}"
+      latex_content << "\\usepackage{listings}"
+      latex_content << "\\lstset{"
+      latex_content << "  basicstyle=\\ttfamily\\small,"
+      latex_content << "  breaklines=true,"
+      latex_content << "  breakatwhitespace=false,"
+      latex_content << "  columns=fullflexible,"
+      latex_content << "  frame=none,"
+      latex_content << "  showstringspaces=false"
+      latex_content << "}"
+      latex_content << "\\pagestyle{fancy}"
+      latex_content << "\\fancyhf{}"
+      latex_content << "\\fancyfoot[C]{One-Time Pad: #{input_basename}}"
+      latex_content << "\\renewcommand{\\headrulewidth}{0pt}"
+      latex_content << "\\renewcommand{\\footrulewidth}{0pt}"
+      latex_content << "\\begin{document}"
+      latex_content << ""
+      
+      # Process pads in groups of 4 (one page = 4 quadrants)
+      pads_array = pads_hash.sort_by { |k, v| k.to_i }
+      pads_array.each_slice(4).with_index do |pad_group, index|
+        # Start a new page for each group of 4 pads (except the first)
+        if index > 0
+          latex_content << "\\newpage"
+          latex_content << ""
+        end
+        
+        # Create 2x2 grid using minipage environments
+        latex_content << "\\noindent"
+        latex_content << "\\begin{minipage}[t]{0.48\\textwidth}"
+        latex_content << "\\vspace{0pt}"
+        
+        # Top-left quadrant (pad 0)
+        if pad_group[0]
+          pad_num, pad_info = pad_group[0]
+          hex_key = pad_info["key"]
+          cleaned_hex = hex_key.gsub(/[\s\n\r]/, '')
+          grouped_hex = cleaned_hex.chars.each_slice(5).map(&:join).join(' ')
+          latex_content << "\\textbf{Pad #{pad_num}}\\\\"
+          latex_content << "\\begin{lstlisting}"
+          latex_content << grouped_hex
+          latex_content << "\\end{lstlisting}"
+        end
+        
+        latex_content << "\\end{minipage}"
+        latex_content << "\\hfill"
+        latex_content << "\\begin{minipage}[t]{0.48\\textwidth}"
+        latex_content << "\\vspace{0pt}"
+        
+        # Top-right quadrant (pad 1)
+        if pad_group[1]
+          pad_num, pad_info = pad_group[1]
+          hex_key = pad_info["key"]
+          cleaned_hex = hex_key.gsub(/[\s\n\r]/, '')
+          grouped_hex = cleaned_hex.chars.each_slice(5).map(&:join).join(' ')
+          latex_content << "\\textbf{Pad #{pad_num}}\\\\"
+          latex_content << "\\begin{lstlisting}"
+          latex_content << grouped_hex
+          latex_content << "\\end{lstlisting}"
+        end
+        
+        latex_content << "\\end{minipage}"
+        latex_content << ""
+        latex_content << "\\\\[1cm]"
+        latex_content << ""
+        latex_content << "\\noindent"
+        latex_content << "\\begin{minipage}[t]{0.48\\textwidth}"
+        latex_content << "\\vspace{0pt}"
+        
+        # Bottom-left quadrant (pad 2)
+        if pad_group[2]
+          pad_num, pad_info = pad_group[2]
+          hex_key = pad_info["key"]
+          cleaned_hex = hex_key.gsub(/[\s\n\r]/, '')
+          grouped_hex = cleaned_hex.chars.each_slice(5).map(&:join).join(' ')
+          latex_content << "\\textbf{Pad #{pad_num}}\\\\"
+          latex_content << "\\begin{lstlisting}"
+          latex_content << grouped_hex
+          latex_content << "\\end{lstlisting}"
+        end
+        
+        latex_content << "\\end{minipage}"
+        latex_content << "\\hfill"
+        latex_content << "\\begin{minipage}[t]{0.48\\textwidth}"
+        latex_content << "\\vspace{0pt}"
+        
+        # Bottom-right quadrant (pad 3)
+        if pad_group[3]
+          pad_num, pad_info = pad_group[3]
+          hex_key = pad_info["key"]
+          cleaned_hex = hex_key.gsub(/[\s\n\r]/, '')
+          grouped_hex = cleaned_hex.chars.each_slice(5).map(&:join).join(' ')
+          latex_content << "\\textbf{Pad #{pad_num}}\\\\"
+          latex_content << "\\begin{lstlisting}"
+          latex_content << grouped_hex
+          latex_content << "\\end{lstlisting}"
+        end
+        
+        latex_content << "\\end{minipage}"
+        latex_content << ""
+      end
+      
+      latex_content << "\\end{document}"
+      
+      # Write LaTeX file
+      File.write(output_path, latex_content.join("\n"))
+      puts "Generated LaTeX file: #{output_path}"
+    end
+
+    desc "convert_to_pdf INPUT_FILE", "Convert an AsciiDoc or LaTeX file to PDF"
+    long_desc <<-CONVERT_TO_PDF_LONG_DESC
+    Convert an AsciiDoc or LaTeX file to PDF format.
+    
+    Parameters:
+      INPUT_FILE - Path to AsciiDoc file (e.g., Shadow-2026-01-12.asciidoc) or LaTeX file (e.g., Shadow-2026-01-12.tex)
+    
+    For AsciiDoc files:
+      Uses asciidoctor-pdf (checks availability before executing).
+      Output saved as FILENAME.pdf in the same directory.
+    
+    For LaTeX files:
+      Uses pdflatex (checks availability before executing).
+      Output saved as FILENAME.pdf in the same directory.
+    
+    Examples:
+      number_station convert_to_pdf Shadow-2026-01-12.asciidoc
+      number_station convert_to_pdf Shadow-2026-01-12.tex
+    CONVERT_TO_PDF_LONG_DESC
+    def convert_to_pdf(input_file)
+      ensure_config_loaded
+      
+      unless File.exist?(input_file)
+        raise Thor::Error, "File not found: #{input_file}"
+      end
+      
+      file_ext = File.extname(input_file).downcase
+      input_basename = File.basename(input_file, file_ext)
+      output_filename = "#{input_basename}.pdf"
+      output_path = File.join(File.dirname(input_file), output_filename)
+      
+      if file_ext == '.tex'
+        # LaTeX file - use pdflatex
+        unless NumberStation.command?('pdflatex')
+          raise Thor::Error, "pdflatex is not available. Please install a LaTeX distribution (e.g., texlive)"
+        end
+        
+        # Run pdflatex in the directory containing the .tex file
+        file_dir = File.dirname(input_file)
+        file_name = File.basename(input_file)
+        cmd = "cd #{file_dir} && pdflatex -interaction=nonstopmode #{file_name}"
+        NumberStation.log.info "Running: #{cmd}"
+        system(cmd)
+        
+        unless $?.success?
+          raise Thor::Error, "PDF conversion failed with exit code #{$?.exitstatus}"
+        end
+        
+        puts "Generated PDF file: #{output_path}"
+      elsif file_ext == '.asciidoc' || file_ext == '.adoc'
+        # AsciiDoc file - use asciidoctor-pdf
+        unless NumberStation.command?('asciidoctor-pdf')
+          raise Thor::Error, "asciidoctor-pdf is not available. Please install it with: gem install asciidoctor-pdf"
+        end
+        
+        # Convert using asciidoctor-pdf command
+        cmd = "asciidoctor-pdf #{input_file} -o #{output_path}"
+        NumberStation.log.info "Running: #{cmd}"
+        system(cmd)
+        
+        unless $?.success?
+          raise Thor::Error, "PDF conversion failed with exit code #{$?.exitstatus}"
+        end
+        
+        puts "Generated PDF file: #{output_path}"
+      else
+        raise Thor::Error, "Unsupported file type: #{file_ext}. Supported types: .asciidoc, .adoc, .tex"
+      end
+    end
+
     desc "espeak XML_FILE", "Use espeak to read an XML file"
     long_desc <<-ESPEAK_LONG_DESC
     Use the espeak utility to read an XML file with GLaDOS-style voice settings.
@@ -772,6 +1072,7 @@ module NumberStation
 
     If --agent is provided, the system will search for the oldest pad with unconsumed pads
     in the agent-specific directory (~/number_station/pads/AGENT/).
+    Note: The agent must be active. Encryption will fail if the agent is inactive.
     
     If --agent is not provided and --padpath/--numpad are not specified, the system will
     search for the oldest pad with unconsumed pads in ~/number_station/pads/.

data/lib/number_station/version.rb

@@ -20,5 +20,5 @@
 =end
 
 module NumberStation
-  VERSION = "0.3.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: number_station
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.5.0
 platform: ruby
 authors:
 - David Kirwan