renamed
Official Rust SDK for the renamed.to API.
AI-powered document renaming, PDF splitting, and data extraction.
Installation
Add to your Cargo.toml:
[]
= "0.1"
= { = "1", = ["full"] }
Quick Start
use ;
async
Examples
See runnable examples in the SDK repo: examples/rust (basic_usage.rs).
Features
Rename Files
Analyze document content and get AI-suggested filenames:
use ;
let client = new;
// Basic usage
let result = client.rename.await?;
println!;
println!;
// With custom template
let options = new
.with_template;
let result = client.rename.await?;
Split PDFs
Split multi-page PDFs into separate documents:
use ;
let client = new;
// Auto-detect document boundaries
let job = client.pdf_split.await?;
// Wait with progress updates
let result = job.wait.await?;
// Download split documents
for doc in result.documents
Split modes:
SplitMode::Auto- AI detects document boundaries (default)SplitMode::Pages- Split every N pagesSplitMode::Blank- Split at blank pages
Extract Data
Extract structured data from documents:
use ;
let client = new;
let options = new
.with_prompt;
let result = client.extract.await?;
println!;
println!;
Error Handling
The SDK provides specific error types for different failure modes:
use ;
let client = new;
match client.get_user.await
Error variants:
Authentication- Invalid or missing API key (401)InsufficientCredits- Not enough credits (402)RateLimit- Too many requests (429)Validation- Invalid request parameters (400/422)Network- Connection failuresTimeout- Request timeoutJob- Async job failureApi- Other API errors
Configuration
Use the builder pattern for custom configuration:
use RenamedClient;
use Duration;
let client = builder
.base_url
.timeout
.max_retries
.with_debug // Enable debug logging
.build;
Debug Logging
Enable debug logging to see HTTP request details for troubleshooting:
let client = builder
.with_debug
.build;
// Output (via log crate):
// [Renamed] POST /rename -> 200 (234ms)
// [Renamed] Upload: document.pdf (1.2 MB)
The SDK uses the log crate. Add a logging implementation like env_logger to see output:
[]
= "0.10"
Working with Bytes
All file methods have _bytes variants for working with in-memory data:
let content = read?;
let result = client.rename_bytes.await?;
License
MIT