Class: TreeReader

Inherits:
Object
  • Object
show all
Includes:
LogUtils::Logging
Defined in:
lib/worlddb/tree_reader.rb

Overview

fix: move into TextUtils namespace/module!!

Defined Under Namespace

Classes: TreeItem

Constant Summary collapse

KEY_REGEX = 
/
    ([0-9][0-9A-Za-z]*)   ## key starting with a nummer
      |
    ([a-z]+)   ## key all lowercase e.g. bt,n,etc.
      |
    ([A-Z]+)   ## key all uppercase e.g. BT,N,etc
/x
LEVEL_REGEX =

e.g. .. or .… etc.

/\.+/

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(text) ⇒ TreeReader

Returns a new instance of TreeReader.



21
22
23
 
# File 'lib/worlddb/tree_reader.rb', line 21

def initialize( text )
  @text = text
end

Class Method Details

.from_file(path) ⇒ Object 



10
11
12
13
14
15
 
# File 'lib/worlddb/tree_reader.rb', line 10

def self.from_file( path )
  ## nb: assume/enfore utf-8 encoding (with or without BOM - byte order mark)
  ## - see textutils/utils.rb
 text = File.read_utf8( path )
 self.from_string( text )
end

.from_string(text) ⇒ Object 



17
18
19
 
# File 'lib/worlddb/tree_reader.rb', line 17

def self.from_string( text )
  self.new( text )
end

Instance Method Details

#each_line ⇒ Object 



38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
 
# File 'lib/worlddb/tree_reader.rb', line 38

def each_line  
  stack    = []     # note: last_level  => stack.size; starts w/ 0
  times    = 2      # assume two indents factor (e.g. .. =2, ....=3 etc. ) for now

  reader = LineReader.from_string( @text )
  reader.each_line do |line|

    logger.debug "[TreeReader]  line (before) => >#{line}<"

    s = StringScanner.new( line )
    s.skip( /[ \t]+/ )   # remove whitespace

    key = s.scan( KEY_REGEX )
    if key
      s.skip( /[ \t]+/ )   # remove whitespace
    end

    level_str = s.scan( LEVEL_REGEX )
    if level_str
      ## FIX!! todo/check: make sure level_str.size is a multiple of two !! (e.g. 2,4,6,etc.)
      level = (level_str.size/times)+1
      s.skip( /[ \t]+/ )   # remove whitespace
    else
      level = 1   ## no level found; assume top level (start w/ 1)
    end

    ## assume rest is record
    rest = s.rest  ## was: s.scan( /.+/ )

    level_diff = level - stack.size

    if level_diff > 0
      logger.debug "[TreeReader]    up  +#{level_diff}"
      ## FIX!!! todo/check/verify/assert: always must be +1
    elsif level_diff < 0
      logger.debug "[TreeReader]    down #{level_diff}"
      level_diff.abs.times { stack.pop }
      stack.pop
    else
      ## same level
      stack.pop
    end

    item = TreeItem.new
    item.level = level
    item.key   = key
    item.value = rest

    stack.push( item )

    ## for debugging - show tree item (note) hierarchy 
    names = stack.map { |it| "(#{it.level}) #{it.value}" }
    logger.debug "[TreeReader]    #{names.join( ' › ' )}  -- key: >#{key}<, level: >#{level}<, rest: >#{rest}<"

    yield( stack )
  end
end