Class InventoryParser

java.lang.Object

com.scivicslab.actoriac.InventoryParser

public class InventoryParser
extends Object

Parser for Ansible inventory files in INI format.

This parser supports a subset of Ansible inventory file format. actor-IaC supports both Ansible-compatible syntax (ansible_*) and native syntax (actoriac_*).

Supported Features

• Groups: [groupname]
• Group variables: [groupname:vars]
• Global variables: [all:vars]
• Host-specific variables: hostname key=value
• Comments: lines starting with # or ;

Supported Variables

Supported inventory variables

actor-IaC	Ansible	Description
actoriac_host	ansible_host	Actual hostname/IP to connect
actoriac_user	ansible_user	SSH username
actoriac_port	ansible_port	SSH port
actoriac_connection	ansible_connection	Connection type (ssh/local)

Unsupported Ansible Features

The following Ansible features are NOT supported and will generate warnings:

• Children groups: [group:children]
• Range patterns: web[01:50].example.com
• Privilege escalation: ansible_become, ansible_become_user
• Python interpreter: ansible_python_interpreter

Author:

devteam@scivicslab.com

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	InventoryParser.Inventory	Represents a parsed Ansible inventory.
static class	InventoryParser.ParseResult	Result of parsing an inventory file.

Field Summary

Fields

Modifier and Type	Field	Description
private static final Pattern	RANGE_PATTERN	Pattern to detect Ansible range notation like [01:50] or [a:z]
private static final Set<String>	SUPPORTED_VAR_SUFFIXES	Set of supported variable suffixes (without prefix)
private static final Set<String>	UNSUPPORTED_ANSIBLE_VARS	Set of known unsupported Ansible variables that should trigger warnings

Constructor Summary

Constructors

Constructor	Description
InventoryParser()

Method Summary

Modifier and Type	Method	Description
private static void	checkUnsupportedVariable(String key, int lineNumber, Set<String> warnedVars, List<String> warnings)	Checks if a variable is unsupported and adds a warning if so.
private static String	getUnsupportedVarSuggestion(String key)	Returns a helpful suggestion for unsupported Ansible variables.
static InventoryParser.ParseResult	parse(InputStream input)	Parses an Ansible inventory file.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

RANGE_PATTERN

private static final Pattern RANGE_PATTERN

Pattern to detect Ansible range notation like [01:50] or [a:z]

SUPPORTED_VAR_SUFFIXES

private static final Set<String> SUPPORTED_VAR_SUFFIXES

Set of supported variable suffixes (without prefix)

UNSUPPORTED_ANSIBLE_VARS

private static final Set<String> UNSUPPORTED_ANSIBLE_VARS

Set of known unsupported Ansible variables that should trigger warnings

Constructor Details

InventoryParser

public InventoryParser()

Method Details

parse

public static InventoryParser.ParseResult parse(InputStream input)
                                         throws IOException

Parses an Ansible inventory file.

This method collects warnings for unsupported Ansible features. Warnings are stored in the returned InventoryParser.ParseResult and should be logged by the caller using the appropriate logging mechanism (e.g., DistributedLogStore).

Parameters:

input - the input stream of the inventory file

Returns:

the parse result containing inventory and any warnings

Throws:

IOException - if reading the file fails

checkUnsupportedVariable

private static void checkUnsupportedVariable(String key,
 int lineNumber,
 Set<String> warnedVars,
 List<String> warnings)

Checks if a variable is unsupported and adds a warning if so.

Parameters:

key - the variable name

lineNumber - the line number for error reporting

warnedVars - set of already warned variables (to avoid duplicate warnings)

warnings - list to add warnings to

getUnsupportedVarSuggestion

private static String getUnsupportedVarSuggestion(String key)

Returns a helpful suggestion for unsupported Ansible variables.