S-Expression parsing facilities

Introduced classes

class SExp

sexp :: SExp

A full S-Expression, delimited by ( and )
class SExpDQString

sexp :: SExpDQString

A Double-quoted String
abstract class SExpEntity

sexp :: SExpEntity

Any S-Expression entity
class SExpError

sexp :: SExpError

An error parsing S-Expressions
class SExpFloat

sexp :: SExpFloat

A float-value
class SExpId

sexp :: SExpId

Any Identifier, non string and non-float
class SExpProcessor

sexp :: SExpProcessor

S-Expression processor

Redefined classes

redef abstract class Text

sexp :: sexp $ Text

High-level abstraction for all text representations

All class definitions

class SExp

sexp $ SExp

A full S-Expression, delimited by ( and )
class SExpDQString

sexp $ SExpDQString

A Double-quoted String
abstract class SExpEntity

sexp $ SExpEntity

Any S-Expression entity
class SExpError

sexp $ SExpError

An error parsing S-Expressions
class SExpFloat

sexp $ SExpFloat

A float-value
class SExpId

sexp $ SExpId

Any Identifier, non string and non-float
class SExpProcessor

sexp $ SExpProcessor

S-Expression processor
redef abstract class Text

sexp :: sexp $ Text

High-level abstraction for all text representations
package_diagram sexp::sexp sexp parser_base parser_base sexp::sexp->parser_base serialization serialization parser_base->serialization ...serialization ... ...serialization->serialization a_star-m a_star-m a_star-m->sexp::sexp

Ancestors

module abstract_collection

core :: abstract_collection

Abstract collection classes and services.
module abstract_text

core :: abstract_text

Abstract class for manipulation of sequences of characters
module array

core :: array

This module introduces the standard array structure.
module bitset

core :: bitset

Services to handle BitSet
module bytes

core :: bytes

Services for byte streams and arrays
module caching

serialization :: caching

Services for caching serialization engines
module circular_array

core :: circular_array

Efficient data structure to access both end of the sequence.
module codec_base

core :: codec_base

Base for codecs to use with streams
module codecs

core :: codecs

Group module for all codec-related manipulations
module collection

core :: collection

This module define several collection classes.
module core

core :: core

Standard classes and methods used by default by Nit programs and libraries.
module engine_tools

serialization :: engine_tools

Advanced services for serialization engines
module environ

core :: environ

Access to the environment variables of the process
module error

core :: error

Standard error-management infrastructure.
module exec

core :: exec

Invocation and management of operating system sub-processes.
module file

core :: file

File manipulations (create, read, write, etc.)
module fixed_ints

core :: fixed_ints

Basic integers of fixed-precision
module fixed_ints_text

core :: fixed_ints_text

Text services to complement fixed_ints
module flat

core :: flat

All the array-based text representations
module gc

core :: gc

Access to the Nit internal garbage collection mechanism
module hash_collection

core :: hash_collection

Introduce HashMap and HashSet.
module inspect

serialization :: inspect

Refine Serializable::inspect to show more useful information
module iso8859_1

core :: iso8859_1

Codec for ISO8859-1 I/O
module kernel

core :: kernel

Most basic classes and methods.
module list

core :: list

This module handle double linked lists
module math

core :: math

Mathematical operations
module meta

meta :: meta

Simple user-defined meta-level to manipulate types of instances as object.
module native

core :: native

Native structures for text and bytes
module numeric

core :: numeric

Advanced services for Numeric types
module protocol

core :: protocol

module queue

core :: queue

Queuing data structures and wrappers
module range

core :: range

Module for range of discrete objects.
module re

core :: re

Regular expression support for all services based on Pattern
module ropes

core :: ropes

Tree-based representation of a String.
module serialization

serialization :: serialization

General serialization services
module serialization_core

serialization :: serialization_core

Abstract services to serialize Nit objects to different formats
module sorter

core :: sorter

This module contains classes used to compare things and sorts arrays.
module stream

core :: stream

Input and output streams of characters
module text

core :: text

All the classes and methods related to the manipulation of text entities
module time

core :: time

Management of time and dates
module union_find

core :: union_find

union–find algorithm using an efficient disjoint-set data structure
module utf8

core :: utf8

Codec for UTF-8 I/O

Parents

module parser_base

parser_base :: parser_base

Simple base for hand-made parsers of all kinds

Children

module a_star-m

a_star-m

# S-Expression parsing facilities
module sexp

intrude import parser_base

# Any S-Expression entity
abstract class SExpEntity

	# Location in the source document
	var location: nullable Location
end

# A full S-Expression, delimited by `(` and `)`
class SExp
	super SExpEntity

	# Children of a SExp
	var content = new Array[SExpEntity]

	redef fun to_s do return "({content.join(" ")})"

	# Returns a pretty-printable version of self
	#
	#     assert "( ( sp 12.3 ) \"DQString\")".to_sexp.as(SExp).pretty_to_s == "(\n\t(\n\t\tsp\n\t\t12.30\n\t)\n\t\"DQString\"\n)"
	fun pretty_to_s: String do return recurse_to_s(0)

	private fun recurse_to_s(depth: Int): String do
		var s = "{"\t" * depth}(\n"
		for i in content do
			if i isa SExp then
				s += i.recurse_to_s(depth + 1)
				s += "\n"
				continue
			end
			s += "\t" * (depth + 1)
			s += i.to_s
			s += "\n"
		end
		return s + "{"\t" * depth})"
	end
end

# A Double-quoted String
class SExpDQString
	super SExpEntity

	# Double-quoted string
	var content: String

	redef fun to_s do return content
end

# A float-value
class SExpFloat
	super SExpEntity

	# Floating-point value
	var content: Float

	redef fun to_s do return content.to_precision(2)
end

# Any Identifier, non string and non-float
class SExpId
	super SExpEntity

	# S-Exp compatible identifier
	var content: String

	redef fun to_s do return content
end

# An error parsing S-Expressions
class SExpError
	super SExpEntity

	# Cause of the error
	var message: String

	redef fun to_s do return "S-Expression error: {message} at {location or else "unknown location"}"
end

# S-Expression processor
class SExpProcessor
	super StringProcessor

	# Parses an S-Expression entity
	fun parse_entity: SExpEntity do
		var srclen = src.length
		var delims = once ['(', ')', '"']
		ignore_whitespaces
		if pos >= srclen then return new SExpError(new Location(line, line_offset), "Empty S-Expression")
		var c = src[pos]
		if c == '(' then
			var cnt = new SExp
			var loc = new Location(line, line_offset)
			pos += 1
			while pos < srclen and src[pos] != ')' do
				var p = parse_entity
				if p isa SExpError then break
				cnt.content.add p
				ignore_whitespaces
			end
			if pos < srclen and src[pos] == ')' then
				pos += 1
				return cnt
			else
				return new SExpError(loc, "Incomplete S-Expression")
			end
		else if c == '"' then
			var stdq = pos
			var loc = new Location(line, line_offset)
			pos += 1
			ignore_until("\"")
			pos += 1
			var endq = pos
			return new SExpDQString(loc, src.substring(stdq, endq - stdq))
		else
			var stid = pos
			var loc = new Location(line, line_offset)
			while pos < srclen and not c.is_whitespace and not delims.has(c) do
				c = src[pos]
				pos += 1
			end
			if delims.has(c) or c.is_whitespace then pos -= 1
			if pos >= srclen then return new SExpError(loc, "Invalid S-Expression")
			var endid = pos
			var cntstr = src.substring(stid, endid - stid)
			var cnt: SExpEntity
			if cntstr.is_numeric then
				cnt = new SExpFloat(loc, cntstr.to_f)
			else
				cnt = new SExpId(loc, cntstr)
			end
			return cnt
		end
	end
end

redef class Text

	# Tries to parse `self` as an S-Expression
	fun to_sexp: SExpEntity do return (new SExpProcessor(self.to_s)).parse_entity
end
lib/sexp/sexp.nit:11,1--154,3