<commit_before><?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd" [
<!ENTITY aqd_version SYSTEM "../version.txt">
]>
<refentry xml:id="add_personality"
          xmlns="http://docbook.org/ns/docbook"
	  xmlns:xi="http://www.w3.org/2001/XInclude">
    <refmeta>
        <refentrytitle>add_personality</refentrytitle>
        <manvolnum>1</manvolnum>
        <refmiscinfo class="version">&aqd_version;</refmiscinfo>
        <refmiscinfo class="manual">Aquilon Commands</refmiscinfo>
    </refmeta>

    <refnamediv>
        <refname>add personality</refname>
        <refpurpose>
	    Add a new personality
        </refpurpose>
	<refclass>Aquilon</refclass>
    </refnamediv>

    <refsynopsisdiv>
	<cmdsynopsis>
	    <command>aq add personality</command>
	    <group>
		<synopfragmentref linkend="global-options">Global options</synopfragmentref>
	    </group>
	    <arg choice="plain"><option>--personality <replaceable>PERSONALITY</replaceable></option></arg>
	    <arg choice="plain"><option>--archetype <replaceable>ARCHETYPE</replaceable></option></arg>
	    <arg choice="plain"><option>--host_environment <replaceable>HOSTENV</replaceable></option></arg>
	    <group choice="req">
		<arg choice="plain"><option>--grn <replaceable>GRN</replaceable></option></arg>
		<arg choice="plain"><option>--eon_id <replaceable>EON_ID</replaceable></option></arg>
	    </group>
	    <group choice="opt">
	         <arg choice="plain"><option>--cluster_required</option></arg>
	         <arg choice="plain"><option>--nocluster_required</option></arg>
	    </group>
	    <arg choice="opt"><option>--comments <replaceable>COMMENTS</replaceable></option></arg>
	    <arg choice="opt"><option>--copy_from <replaceable>COPY_FROM</replaceable></option></arg>
	    <group choice="opt">
	          <arg choice="plain"><option>--config_override</option></arg>
	          <arg choice="plain"><option>--noconfig_override</option></arg>
	    </group>
	    <xi:include href="../common/global_options.xml"/>
	</cmdsynopsis>
    </refsynopsisdiv>

    <refsect1>
        <title>Description</title>
	<para>
	    The <command>aq add personality</command> Command creates a new personality.
	    A default template will be created. This default templatie will be used for host plenary
	    generation only if no personality templates have been defined within the template domain.
	</para>
    </refsect1>

    <refsect1>
        <title>Options</title>
	<variablelist>
	    <title>Command-specific options</title>
	    <varlistentry>
	        <term>
		    <option>--personality <replaceable>PERSONALITY</replaceable></option>
		</term>
		<listitem>
		    <para>
			The name of the personality to create.
		    </para>
		</listitem>
	    </varlistentry>
	    <varlistentry>
	        <term>
                    <option>--archetype <replaceable>ARCHETYPE</replaceable></option>
		</term>
		<listitem>
		    <para>
                        The name of the archteype.
		    </para>
		</listitem>
	    </varlistentry>
	    <varlistentry>
	        <term>
                    <option>--host_environment <replaceable>HOSTENV</replaceable></option>
		</term>
		<listitem>
		    <para>
			The name of the environment hosts belonging to this personality will live in. The valid
			environments are: prod, uat, qa, dev, infra.
		    </para>
		</listitem>
	    </varlistentry>
	    <varlistentry>
	        <term>
		    <option>--grn <replaceable>GRN</replaceable></option>,
		    <option>--eon_id <replaceable>EON_ID</replaceable></option>
		</term>
		<listitem>
		    <para>
			The owner GRN of the personality to be created. Scripts should use the
			numeric <replaceable>EON_ID</replaceable>, the textual <replaceable>GRN</replaceable> is
			more suitable for humans.
		    </para>
		</listitem>
	    </varlistentry>
	    <varlistentry>
	        <term>
		    <option>--cluster_required</option>, <option>--nocluster_required</option><commit_msg>Fix documentation for host environment<commit_after><?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V5.0//EN"
"http://docbook.org/xml/5.0/dtd/docbook.dtd" [
<!ENTITY aqd_version SYSTEM "../version.txt">
]>
<refentry xml:id="add_personality"
          xmlns="http://docbook.org/ns/docbook"
	  xmlns:xi="http://www.w3.org/2001/XInclude">
    <refmeta>
        <refentrytitle>add_personality</refentrytitle>
        <manvolnum>1</manvolnum>
        <refmiscinfo class="version">&aqd_version;</refmiscinfo>
        <refmiscinfo class="manual">Aquilon Commands</refmiscinfo>
    </refmeta>

    <refnamediv>
        <refname>add personality</refname>
        <refpurpose>
	    Add a new personality
        </refpurpose>
	<refclass>Aquilon</refclass>
    </refnamediv>

    <refsynopsisdiv>
	<cmdsynopsis>
	    <command>aq add personality</command>
	    <group>
		<synopfragmentref linkend="global-options">Global options</synopfragmentref>
	    </group>
	    <arg choice="plain"><option>--personality <replaceable>PERSONALITY</replaceable></option></arg>
	    <arg choice="plain"><option>--archetype <replaceable>ARCHETYPE</replaceable></option></arg>
	    <group choice="req">
		<arg choice="plain"><option>--grn <replaceable>GRN</replaceable></option></arg>
		<arg choice="plain"><option>--eon_id <replaceable>EON_ID</replaceable></option></arg>
	    </group>
	    <group choice="opt">
	         <arg choice="plain"><option>--cluster_required</option></arg>
	         <arg choice="plain"><option>--nocluster_required</option></arg>
	    </group>
	    <arg choice="opt"><option>--comments <replaceable>COMMENTS</replaceable></option></arg>
	    <arg choice="opt"><option>--copy_from <replaceable>COPY_FROM</replaceable></option></arg>
	    <arg choice="opt"><option>--host_environment <replaceable>HOSTENV</replaceable></option></arg>
	    <group choice="opt">
	          <arg choice="plain"><option>--config_override</option></arg>
	          <arg choice="plain"><option>--noconfig_override</option></arg>
	    </group>
	    <xi:include href="../common/global_options.xml"/>
	</cmdsynopsis>
    </refsynopsisdiv>

    <refsect1>
        <title>Description</title>
	<para>
	    The <command>aq add personality</command> Command creates a new personality.
	    A default template will be created. This default templatie will be used for host plenary
	    generation only if no personality templates have been defined within the template domain.
	</para>
    </refsect1>

    <refsect1>
        <title>Options</title>
	<variablelist>
	    <title>Command-specific options</title>
	    <varlistentry>
	        <term>
		    <option>--personality <replaceable>PERSONALITY</replaceable></option>
		</term>
		<listitem>
		    <para>
			The name of the personality to create.
		    </para>
		</listitem>
	    </varlistentry>
	    <varlistentry>
	        <term>
                    <option>--archetype <replaceable>ARCHETYPE</replaceable></option>
		</term>
		<listitem>
		    <para>
                        The name of the archteype.
		    </para>
		</listitem>
	    </varlistentry>
	    <varlistentry>
	        <term>
                    <option>--host_environment <replaceable>HOSTENV</replaceable></option>
		</term>
		<listitem>
		    <para>
			The name of the environment hosts for belonging to this personality. The valid
			environments are: prod, uat, qa, dev, infra. For all purposes it is a required
			field but archetypes can have a default env set which will be used during creating
			personality. This can be set as default_environment key in the
			<literal>archetype_&lt;archetype name&gt;</literal> section of the broker configuration.
		    </para>
		</listitem>
	    </varlistentry>
	    <varlistentry>
	        <term>
		    <option>--grn <replaceable>GRN</replaceable></option>,
		    <option>--eon_id <replaceable>EON_ID</replaceable></option>
		</term>
		<listitem>
		    <para>
			The owner GRN of the personality to be created. Scripts should use the
			numeric <replaceable>EON_ID</replaceable>, the textual <replaceable>GRN</replaceable> is
			more suitable for humans.
		    </para>
		</listitem>
	    </varlistentry>
	    <varlistentry>
	        <term>
		    <option>--cluster_required</option>, <option>--nocluster_required</option>
{'fraction_non_alphanumeric': 0.14923747276688454, 'fraction_numerical': 0.0036310820624546117, 'mean_word_length': 3.2029501525940995, 'pattern_counts': {'":': 0, '<': 351, '<?xml version=': 2, '>': 351, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 12}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3929723', 'n_tokens_mistral': 2799, 'n_tokens_neox': 2537, 'n_words': 520}