Struct AfdCli 

pub struct AfdCli { /* private fields */ }

Agent-First PostgreSQL client.

Interface Policy

• default mode is canonical agent-first CLI
• --mode psql is argument translation only; runtime output stays JSONL
• stdout carries protocol events; stderr is not a protocol channel

Query Sources and Parameters

• use --sql for inline SQL or --sql-file for a file
• use repeatable --param N=value for positional binds
• placeholder count is validated from prepared-statement metadata, not by SQL text scanning

Connection Sources

• --dsn-secret for a PostgreSQL URI
• --conninfo-secret for libpq-style conninfo
• or discrete --host, --port, --user, --dbname, --password-secret
• agent-first environment fallbacks: AFPSQL_*
• PostgreSQL environment fallbacks: PGHOST, PGPORT, PGUSER, PGDATABASE

Result Shaping

• default mode buffers a bounded inline result
• use --stream-rows for large result sets, with --batch-rows and --batch-bytes to tune chunk size
• --output json|yaml|plain changes rendering only, not the runtime schema

Examples

afpsql --sql "select now() as now_rfc3339"
afpsql --sql-file ./query.sql
afpsql --sql "select * from users where id = $1" --param 1=123
afpsql --dsn-secret "postgresql://app:secret@127.0.0.1:5432/appdb" --sql "select 1"
afpsql --mode psql -h 127.0.0.1 -p 5432 -U app -d appdb -c "select 1"
afpsql --sql "select * from big_table" --stream-rows --batch-rows 1000
afpsql --mode pipe

Exit Codes

• 0: query completed successfully
• 1: SQL error or runtime error
• 2: invalid CLI arguments

Trait Implementations

impl Args for AfdCli

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl CommandFactory for AfdCli

fn command<'b>() -> Command

Build a Command that can instantiate Self.

fn command_for_update<'b>() -> Command

Build a Command that can update self.

impl FromArgMatches for AfdCli

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Parser for AfdCli

fn parse() -> Self

Parse from std::env::args_os(), exit on error.

fn try_parse() -> Result<Self, Error>

Parse from std::env::args_os(), return Err on error.

fn parse_from<I, T>(itr: I) -> Self

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, exit on error.

fn try_parse_from<I, T>(itr: I) -> Result<Self, Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Parse from iterator, return Err on error.

fn update_from<I, T>(&mut self, itr: I)

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, exit on error.

fn try_update_from<I, T>(&mut self, itr: I) -> Result<(), Error>

where I: IntoIterator<Item = T>, T: Into<OsString> + Clone,

Update from iterator, return Err on error.