pltr-cli 0.5.0__tar.gz → 0.5.1__tar.gz

{pltr_cli-0.5.0 → pltr_cli-0.5.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pltr-cli
-Version: 0.5.0
+Version: 0.5.1
 Summary: Command-line interface for Palantir Foundry APIs
 Project-URL: Homepage, https://github.com/anjor/pltr-cli
 Project-URL: Repository, https://github.com/anjor/pltr-cli
@@ -47,7 +47,11 @@ A comprehensive command-line interface for Palantir Foundry APIs, providing 80+
 
 - 🔐 **Secure Authentication**: Token and OAuth2 support with encrypted credential storage
 - 📊 **Dataset Operations**: Complete dataset management with branches, files, transactions, and views (RID-based API)
-- 📁 **Folder Management**: Create, explore, and manage Foundry filesystem structure
+- 📁 **Filesystem Management**: Complete filesystem operations including folders, projects, spaces, and resources
+- 🏗️ **Project Management**: Create, update, and manage Foundry projects within spaces
+- 🌐 **Space Management**: Administer spaces, manage members, and control access
+- 🔐 **Resource Permissions**: Grant, revoke, and manage role-based access to resources
+- 🔗 **Connectivity & Imports**: Manage external connections and import files/tables from various data sources
 - 🎯 **Comprehensive Ontology Access**: 13 commands for objects, actions, and queries
 - 🏗️ **Orchestration Management**: Create, manage, and monitor builds, jobs, and schedules
 - 🎬 **MediaSets Operations**: Upload, download, and manage media content with transaction support
@@ -121,6 +125,15 @@ pltr folder create "My Project"
 # List root folder contents
 pltr folder list ri.compass.main.folder.0
 
+# Manage spaces and projects
+pltr space list
+pltr project create "My Project" ri.compass.main.space.123
+pltr project list --space-rid ri.compass.main.space.123
+
+# Manage resource permissions
+pltr resource-role grant ri.compass.main.dataset.123 user123 User viewer
+pltr resource-role list ri.compass.main.dataset.123
+
 # Execute a simple SQL query
 pltr sql execute "SELECT 1 as test"
 
@@ -129,6 +142,11 @@ pltr dataset get ri.foundry.main.dataset.abc123
 pltr dataset branches list ri.foundry.main.dataset.abc123
 pltr dataset files list ri.foundry.main.dataset.abc123
 
+# Dataset transaction management
+pltr dataset transactions start ri.foundry.main.dataset.abc123
+pltr dataset transactions commit ri.foundry.main.dataset.abc123 <transaction-rid>
+pltr dataset files upload myfile.csv ri.foundry.main.dataset.abc123 --transaction-rid <rid>
+
 # Start interactive mode for exploration
 pltr shell
 ```
@@ -171,6 +189,13 @@ pltr sql execute "SELECT * FROM table"  # Run SQL queries
 pltr ontology list             # List ontologies
 pltr dataset get <rid>         # Get dataset info
 
+# Filesystem Management
+pltr folder create "My Project"         # Create folders
+pltr space create "Team Space" <org-rid> # Create spaces
+pltr project create "New Project" <space-rid> # Create projects
+pltr resource search "dataset name"     # Search resources
+pltr resource-role grant <resource-rid> <user-id> User viewer # Grant permissions
+
 # Orchestration
 pltr orchestration builds search       # Search builds
 pltr orchestration jobs get <job-rid>  # Get job details
@@ -181,6 +206,12 @@ pltr media-sets get <set-rid> <item-rid>  # Get media item info
 pltr media-sets upload <set-rid> file.jpg "/path/file.jpg" <txn-id>  # Upload media
 pltr media-sets download <set-rid> <item-rid> output.jpg  # Download media
 
+# Connectivity & Data Imports
+pltr connectivity connection list              # List available connections
+pltr connectivity connection get <conn-rid>    # Get connection details
+pltr connectivity import file <conn-rid> <source-path> <dataset-rid> --execute  # Import file
+pltr connectivity import table <conn-rid> <table-name> <dataset-rid> --execute  # Import table
+
 # Administrative
 pltr admin user current        # Current user info
 pltr admin user list          # List users
@@ -301,6 +332,74 @@ pltr media-sets download ri.mediasets.main.media-set.abc \
 - Preview mode (`--preview`)
 - Transaction-based upload workflow
 
+### 📊 Dataset Transaction Management
+
+pltr-cli provides comprehensive transaction management for datasets, allowing atomic operations with rollback capability:
+
+#### Transaction Lifecycle
+```bash
+# Start a new transaction
+pltr dataset transactions start ri.foundry.main.dataset.abc123 --branch master --type APPEND
+# Returns transaction RID for use in subsequent operations
+
+# Check transaction status
+pltr dataset transactions status ri.foundry.main.dataset.abc123 ri.foundry.main.transaction.xyz
+
+# List all transactions for a dataset
+pltr dataset transactions list ri.foundry.main.dataset.abc123 --branch master
+
+# Commit a transaction (make changes permanent)
+pltr dataset transactions commit ri.foundry.main.dataset.abc123 ri.foundry.main.transaction.xyz
+
+# Abort a transaction (discard all changes)
+pltr dataset transactions abort ri.foundry.main.dataset.abc123 ri.foundry.main.transaction.xyz --yes
+```
+
+#### File Operations with Transactions
+```bash
+# Upload files within a transaction
+pltr dataset files upload data.csv ri.foundry.main.dataset.abc123 \
+  --transaction-rid ri.foundry.main.transaction.xyz
+
+# Multiple file uploads in same transaction
+pltr dataset files upload file1.csv ri.foundry.main.dataset.abc123 \
+  --transaction-rid ri.foundry.main.transaction.xyz
+pltr dataset files upload file2.csv ri.foundry.main.dataset.abc123 \
+  --transaction-rid ri.foundry.main.transaction.xyz
+
+# Commit when ready
+pltr dataset transactions commit ri.foundry.main.dataset.abc123 ri.foundry.main.transaction.xyz
+```
+
+#### Transaction Types
+- **APPEND**: Add new files to dataset
+- **UPDATE**: Add new files and overwrite existing ones
+- **SNAPSHOT**: Replace entire dataset with new files
+- **DELETE**: Remove files from dataset
+
+#### Example Workflow
+```bash
+# Start a transaction for bulk data update
+TRANSACTION=$(pltr dataset transactions start ri.foundry.main.dataset.abc123 \
+  --type UPDATE --format json | jq -r '.transaction_rid')
+
+# Upload multiple files
+pltr dataset files upload data1.csv ri.foundry.main.dataset.abc123 --transaction-rid $TRANSACTION
+pltr dataset files upload data2.csv ri.foundry.main.dataset.abc123 --transaction-rid $TRANSACTION
+
+# Check status before committing
+pltr dataset transactions status ri.foundry.main.dataset.abc123 $TRANSACTION
+
+# Commit if everything looks good
+pltr dataset transactions commit ri.foundry.main.dataset.abc123 $TRANSACTION
+```
+
+**Benefits:**
+- **Data Integrity**: Atomic operations with rollback capability
+- **Error Recovery**: Clean rollback from failed operations
+- **Collaboration**: Better concurrent modification handling
+- **Automation**: Reliable data pipeline operations
+
 ## ⚙️ Configuration
 
 pltr-cli stores configuration securely using industry best practices:

{pltr_cli-0.5.0 → pltr_cli-0.5.1}/README.md

@@ -10,7 +10,11 @@ A comprehensive command-line interface for Palantir Foundry APIs, providing 80+
 
 - 🔐 **Secure Authentication**: Token and OAuth2 support with encrypted credential storage
 - 📊 **Dataset Operations**: Complete dataset management with branches, files, transactions, and views (RID-based API)
-- 📁 **Folder Management**: Create, explore, and manage Foundry filesystem structure
+- 📁 **Filesystem Management**: Complete filesystem operations including folders, projects, spaces, and resources
+- 🏗️ **Project Management**: Create, update, and manage Foundry projects within spaces
+- 🌐 **Space Management**: Administer spaces, manage members, and control access
+- 🔐 **Resource Permissions**: Grant, revoke, and manage role-based access to resources
+- 🔗 **Connectivity & Imports**: Manage external connections and import files/tables from various data sources
 - 🎯 **Comprehensive Ontology Access**: 13 commands for objects, actions, and queries
 - 🏗️ **Orchestration Management**: Create, manage, and monitor builds, jobs, and schedules
 - 🎬 **MediaSets Operations**: Upload, download, and manage media content with transaction support
@@ -84,6 +88,15 @@ pltr folder create "My Project"
 # List root folder contents
 pltr folder list ri.compass.main.folder.0
 
+# Manage spaces and projects
+pltr space list
+pltr project create "My Project" ri.compass.main.space.123
+pltr project list --space-rid ri.compass.main.space.123
+
+# Manage resource permissions
+pltr resource-role grant ri.compass.main.dataset.123 user123 User viewer
+pltr resource-role list ri.compass.main.dataset.123
+
 # Execute a simple SQL query
 pltr sql execute "SELECT 1 as test"
 
@@ -92,6 +105,11 @@ pltr dataset get ri.foundry.main.dataset.abc123
 pltr dataset branches list ri.foundry.main.dataset.abc123
 pltr dataset files list ri.foundry.main.dataset.abc123
 
+# Dataset transaction management
+pltr dataset transactions start ri.foundry.main.dataset.abc123
+pltr dataset transactions commit ri.foundry.main.dataset.abc123 <transaction-rid>
+pltr dataset files upload myfile.csv ri.foundry.main.dataset.abc123 --transaction-rid <rid>
+
 # Start interactive mode for exploration
 pltr shell
 ```
@@ -134,6 +152,13 @@ pltr sql execute "SELECT * FROM table"  # Run SQL queries
 pltr ontology list             # List ontologies
 pltr dataset get <rid>         # Get dataset info
 
+# Filesystem Management
+pltr folder create "My Project"         # Create folders
+pltr space create "Team Space" <org-rid> # Create spaces
+pltr project create "New Project" <space-rid> # Create projects
+pltr resource search "dataset name"     # Search resources
+pltr resource-role grant <resource-rid> <user-id> User viewer # Grant permissions
+
 # Orchestration
 pltr orchestration builds search       # Search builds
 pltr orchestration jobs get <job-rid>  # Get job details
@@ -144,6 +169,12 @@ pltr media-sets get <set-rid> <item-rid>  # Get media item info
 pltr media-sets upload <set-rid> file.jpg "/path/file.jpg" <txn-id>  # Upload media
 pltr media-sets download <set-rid> <item-rid> output.jpg  # Download media
 
+# Connectivity & Data Imports
+pltr connectivity connection list              # List available connections
+pltr connectivity connection get <conn-rid>    # Get connection details
+pltr connectivity import file <conn-rid> <source-path> <dataset-rid> --execute  # Import file
+pltr connectivity import table <conn-rid> <table-name> <dataset-rid> --execute  # Import table
+
 # Administrative
 pltr admin user current        # Current user info
 pltr admin user list          # List users
@@ -264,6 +295,74 @@ pltr media-sets download ri.mediasets.main.media-set.abc \
 - Preview mode (`--preview`)
 - Transaction-based upload workflow
 
+### 📊 Dataset Transaction Management
+
+pltr-cli provides comprehensive transaction management for datasets, allowing atomic operations with rollback capability:
+
+#### Transaction Lifecycle
+```bash
+# Start a new transaction
+pltr dataset transactions start ri.foundry.main.dataset.abc123 --branch master --type APPEND
+# Returns transaction RID for use in subsequent operations
+
+# Check transaction status
+pltr dataset transactions status ri.foundry.main.dataset.abc123 ri.foundry.main.transaction.xyz
+
+# List all transactions for a dataset
+pltr dataset transactions list ri.foundry.main.dataset.abc123 --branch master
+
+# Commit a transaction (make changes permanent)
+pltr dataset transactions commit ri.foundry.main.dataset.abc123 ri.foundry.main.transaction.xyz
+
+# Abort a transaction (discard all changes)
+pltr dataset transactions abort ri.foundry.main.dataset.abc123 ri.foundry.main.transaction.xyz --yes
+```
+
+#### File Operations with Transactions
+```bash
+# Upload files within a transaction
+pltr dataset files upload data.csv ri.foundry.main.dataset.abc123 \
+  --transaction-rid ri.foundry.main.transaction.xyz
+
+# Multiple file uploads in same transaction
+pltr dataset files upload file1.csv ri.foundry.main.dataset.abc123 \
+  --transaction-rid ri.foundry.main.transaction.xyz
+pltr dataset files upload file2.csv ri.foundry.main.dataset.abc123 \
+  --transaction-rid ri.foundry.main.transaction.xyz
+
+# Commit when ready
+pltr dataset transactions commit ri.foundry.main.dataset.abc123 ri.foundry.main.transaction.xyz
+```
+
+#### Transaction Types
+- **APPEND**: Add new files to dataset
+- **UPDATE**: Add new files and overwrite existing ones
+- **SNAPSHOT**: Replace entire dataset with new files
+- **DELETE**: Remove files from dataset
+
+#### Example Workflow
+```bash
+# Start a transaction for bulk data update
+TRANSACTION=$(pltr dataset transactions start ri.foundry.main.dataset.abc123 \
+  --type UPDATE --format json | jq -r '.transaction_rid')
+
+# Upload multiple files
+pltr dataset files upload data1.csv ri.foundry.main.dataset.abc123 --transaction-rid $TRANSACTION
+pltr dataset files upload data2.csv ri.foundry.main.dataset.abc123 --transaction-rid $TRANSACTION
+
+# Check status before committing
+pltr dataset transactions status ri.foundry.main.dataset.abc123 $TRANSACTION
+
+# Commit if everything looks good
+pltr dataset transactions commit ri.foundry.main.dataset.abc123 $TRANSACTION
+```
+
+**Benefits:**
+- **Data Integrity**: Atomic operations with rollback capability
+- **Error Recovery**: Clean rollback from failed operations
+- **Collaboration**: Better concurrent modification handling
+- **Automation**: Reliable data pipeline operations
+
 ## ⚙️ Configuration
 
 pltr-cli stores configuration securely using industry best practices: