:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
use anyhow::Result;
use clap::Subcommand;
use crate::sourcemaps::{
args::{
FileSelectionArgs, ReleaseArgs, ReleaseMode, UploadConcurrencyArgs, UploadConflictArgs,
},
inject::InjectArgs,
};
pub mod inject;
pub mod upload;
#[derive(Subcommand)]
pub enum SourcemapCommand {
/// Inject each bundled chunk with a posthog chunk ID
Inject(InjectArgs),
/// Upload the bundled chunks to PostHog
Upload(upload::Args),
/// Run inject and upload in one command
Process(ProcessArgs),
}
#[derive(clap::Args)]
pub struct ProcessArgs {
#[clap(flatten)]
pub file_selection: FileSelectionArgs,
/// If your bundler adds a public path prefix to sourcemap URLs,
/// we need to ignore it while searching for them
/// For use alongside e.g. esbuilds "publicPath" config setting.
#[arg(short, long)]
pub public_path_prefix: Option<String>,
#[clap(flatten)]
pub release: ReleaseArgs,
/// Whether to delete the source map files and strip sourceMappingURL comments after uploading them
/// [default: false]
#[arg(long, default_value = "false")]
pub delete_after: bool,
/// The maximum number of chunks to upload in a single batch
#[arg(long, default_value = "50")]
pub batch_size: usize,
#[clap(flatten)]
pub conflict: UploadConflictArgs,
#[clap(flatten)]
pub upload_concurrency: UploadConcurrencyArgs,
/// How the release is associated with exceptions. `event` (the default) injects the release
/// id into each chunk as `_posthogReleaseId` (alongside content-addressed chunk ids) so the
/// SDK reports the release per event; symbol sets stay release-independent. `symbol-set`
/// stamps the release id onto the uploaded symbol sets instead. Also settable via
/// `POSTHOG_RELEASE_MODE`.
#[arg(
long,
env = "POSTHOG_RELEASE_MODE",
value_enum,
default_value = "event"
)]
pub release_mode: ReleaseMode,
}
impl ProcessArgs {
/// Resolve stdin paths once so they can be shared between inject and upload.
pub fn resolve_stdin(mut self) -> Result<Self> {
self.file_selection = self.file_selection.resolve_stdin()?;
Ok(self)
}
}
impl From<ProcessArgs> for (InjectArgs, upload::Args) {
fn from(args: ProcessArgs) -> Self {
let inject_args = InjectArgs {
file_selection: args.file_selection.clone(),
release: args.release.clone(),
public_path_prefix: args.public_path_prefix.clone(),
release_mode: args.release_mode,
};
let upload_args = upload::Args {
file_selection: args.file_selection,
public_path_prefix: args.public_path_prefix,
delete_after: args.delete_after,
skip_ssl_verification: false,
batch_size: args.batch_size,
release: args.release,
conflict: args.conflict,
upload_concurrency: args.upload_concurrency,
release_mode: args.release_mode,
};
(inject_args, upload_args)
}
}
#[cfg(test)]
mod tests {
use super::*;
use clap::Parser;
#[derive(Parser)]
struct SourcemapCli {
#[command(subcommand)]
command: SourcemapCommand,
}
#[test]
fn process_accepts_concurrency_override() {
let parsed = SourcemapCli::try_parse_from([
"test",
"process",
"--directory",
".",
"--concurrency",
"18",
])
.expect("process args should parse");
let SourcemapCommand::Process(args) = parsed.command else {
panic!("expected process command");
};
assert_eq!(args.upload_concurrency.concurrency.get(), 18);
}
#[test]
fn upload_accepts_concurrency_override() {
let parsed = SourcemapCli::try_parse_from([
"test",
"upload",
"--directory",
".",
"--concurrency",
"24",
])
.expect("upload args should parse");
let SourcemapCommand::Upload(args) = parsed.command else {
panic!("expected upload command");
};
assert_eq!(args.upload_concurrency.concurrency.get(), 24);
}
}