pltr-cli 0.5.0__py3-none-any.whl → 0.5.2__py3-none-any.whl

pltr/utils/formatting.py

@@ -1084,14 +1084,121 @@ class OutputFormatter:
                 "Transaction RID": transaction.get("transaction_rid", "")[:12] + "..."
                 if transaction.get("transaction_rid")
                 else "",
+                "Status": transaction.get("status", ""),
+                "Type": transaction.get("transaction_type", ""),
+                "Branch": transaction.get("branch", ""),
                 "Created": self._format_datetime(transaction.get("created_time")),
                 "Created By": transaction.get("created_by", ""),
-                "Status": transaction.get("status", ""),
             }
             formatted_transactions.append(formatted_transaction)
 
         return self.format_output(formatted_transactions, format_type, output_file)
 
+    def format_transaction_detail(
+        self,
+        transaction: Dict[str, Any],
+        format_type: str = "table",
+        output_file: Optional[str] = None,
+    ) -> Optional[str]:
+        """
+        Format detailed transaction information.
+
+        Args:
+            transaction: Transaction dictionary
+            format_type: Output format
+            output_file: Optional output file path
+
+        Returns:
+            Formatted string if no output file specified
+        """
+        if format_type == "table":
+            details = []
+
+            property_order = [
+                ("transaction_rid", "Transaction RID"),
+                ("dataset_rid", "Dataset RID"),
+                ("status", "Status"),
+                ("transaction_type", "Type"),
+                ("branch", "Branch"),
+                ("created_time", "Created"),
+                ("created_by", "Created By"),
+                ("committed_time", "Committed"),
+                ("aborted_time", "Aborted"),
+            ]
+
+            for key, label in property_order:
+                if transaction.get(key) is not None:
+                    value = transaction[key]
+                    if "time" in key:
+                        value = self._format_datetime(value)
+                    details.append({"Property": label, "Value": str(value)})
+
+            # Add any remaining properties
+            for key, value in transaction.items():
+                if (
+                    key not in [prop[0] for prop in property_order]
+                    and value is not None
+                ):
+                    details.append(
+                        {"Property": key.replace("_", " ").title(), "Value": str(value)}
+                    )
+
+            return self.format_output(details, format_type, output_file)
+        else:
+            return self.format_output(transaction, format_type, output_file)
+
+    def format_transaction_result(
+        self,
+        result: Dict[str, Any],
+        format_type: str = "table",
+        output_file: Optional[str] = None,
+    ) -> Optional[str]:
+        """
+        Format transaction operation result.
+
+        Args:
+            result: Transaction operation result dictionary
+            format_type: Output format
+            output_file: Optional output file path
+
+        Returns:
+            Formatted string if no output file specified
+        """
+        if format_type == "table":
+            details = []
+
+            property_order = [
+                ("transaction_rid", "Transaction RID"),
+                ("dataset_rid", "Dataset RID"),
+                ("status", "Status"),
+                ("success", "Success"),
+                ("committed_time", "Committed Time"),
+                ("aborted_time", "Aborted Time"),
+            ]
+
+            for key, label in property_order:
+                if result.get(key) is not None:
+                    value = result[key]
+                    if "time" in key:
+                        value = self._format_datetime(value)
+                    elif key == "success":
+                        value = "Yes" if value else "No"
+                    details.append({"Property": label, "Value": str(value)})
+
+            # Add any remaining properties
+            for key, value in result.items():
+                if (
+                    key not in [prop[0] for prop in property_order]
+                    and value is not None
+                ):
+                    details.append(
+                        {"Property": key.replace("_", " ").title(), "Value": str(value)}
+                    )
+
+            return self.format_output(details, format_type, output_file)
+        else:
+            return self.format_output(result, format_type, output_file)
+
     def format_views(
         self,
         views: List[Dict[str, Any]],

{pltr_cli-0.5.0.dist-info → pltr_cli-0.5.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pltr-cli
-Version: 0.5.0
+Version: 0.5.2
 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.dist-info → pltr_cli-0.5.2.dist-info}/RECORD

@@ -1,6 +1,6 @@
-pltr/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+pltr/__init__.py,sha256=isJrmDBLRag7Zc2UK9ZovWGOv7ji1Oh-zJtJMNJFkXw,22
 pltr/__main__.py,sha256=HWJ49UoAYBQCf8kjuySPmBTuUjTZrOx-y6PzMTyS1KE,879
-pltr/cli.py,sha256=EIW67XC8-AttN6S2OUxaxEC2trYDxaHVy8j18G92EzU,2191
+pltr/cli.py,sha256=DikRsWsU7QWvRWHgB6wZIct916ebWyaub7PlAjKJXws,2664
 pltr/auth/__init__.py,sha256=G0V-Rh25FaJsH2nhrf146XQQG_ApdbyPJNuHJC25kgk,38
 pltr/auth/base.py,sha256=LvmCwS7A0q0CITcym8udPzdACL52_jSGusiaeCTOaE8,981
 pltr/auth/manager.py,sha256=ZqlGefr1a8MGx0g7kkQhpmiuVp0XTg3f43yMBCk-IRo,4305
@@ -12,12 +12,17 @@ pltr/commands/admin.py,sha256=foscSO-QuH6uggUR5Rmv9pTqGjEXTUzpmMFj2-8hEJs,17065
 pltr/commands/alias.py,sha256=r9xMsQNrGvaixSlspzoO2IXQ44LFXuZM4itt8vC0dRc,6862
 pltr/commands/completion.py,sha256=YTxaRL4-rDs5n7aXf3ogFsxbHVJUBo_HiBbd0fbBPZ0,10870
 pltr/commands/configure.py,sha256=oYj-VlOEj3MDwtB2RC4bYOYzI_sXTanPnz7y1GmMTqY,4800
-pltr/commands/dataset.py,sha256=3QWqClosXna7cpUxOQ93mNIYTAoHMReeePCdzY44lEk,14112
+pltr/commands/connectivity.py,sha256=m8_BYwHij_5IbrYFTU_SYYtbqLCjxA8VIQpbdlWJqHs,14758
+pltr/commands/dataset.py,sha256=6NiFnWkV_Tkx9AunV-dns6BeR_BBUNMg4tOocBBxaqI,24188
 pltr/commands/folder.py,sha256=IAPPA3Smk1IWqThneEtZ08Zp79vDKVUabSkL_nDvUWk,10679
 pltr/commands/mediasets.py,sha256=FXq7OtYU9wLgUxQFcS_fkA4i_CozGnsYKxh8GOSI0ok,15342
 pltr/commands/ontology.py,sha256=zUgSrmv8xi26SQK7GsM3qusgR9Wuka0GyzE7L8DkduE,18317
 pltr/commands/orchestration.py,sha256=4gq5nb43bU0Ub3iaKV-EgXT_ka8ilwdyxY_9M5iS84s,21958
+pltr/commands/project.py,sha256=nlfyy4OYkYK9rtjOQp9awgCnSJ1P6sgsp0vaXdvkHFY,14183
+pltr/commands/resource.py,sha256=VQsDSdeHlLoind34DU9dKu13tqSvsCUtYzxwDYULXSA,16384
+pltr/commands/resource_role.py,sha256=pM0DQxLBU9xyIYzLv1Y0sOMZG5oZ1INNSkMubYBGHJM,15394
 pltr/commands/shell.py,sha256=QLF7TEGpaau9i0A9s3VjnegvtHde-SLRqI4suJFT4WI,3622
+pltr/commands/space.py,sha256=R9TN9OQVDtFB92DOjrh81_YYajiQaqRNELsBHK4O-pI,21944
 pltr/commands/sql.py,sha256=wol0Rlvi_RplCFbOg4LCa3VXsOqmRZdFFVv7V6iVkh8,12602
 pltr/commands/verify.py,sha256=n8LWhbfGieYa-a5_l3MxqkYbdpyVf8-i0FQIL__AaPA,6650
 pltr/config/__init__.py,sha256=Y6gARy5lUHy-OJaOUxtfXoeQVNZV5QHLl6uKHQ8tpTk,41
@@ -27,19 +32,24 @@ pltr/config/settings.py,sha256=bfIiosPqH_W73TOHS71DvgZdAHka4fJDopU1SvBRFuQ,2908
 pltr/services/__init__.py,sha256=zQpgrqPdAkZI-nobi33mctU2-iGNgazzvjBVY8YRbSQ,101
 pltr/services/admin.py,sha256=8FjExmDeIKeVqkAxM83SVvpp_pH9W-Q33cgVs6BHxLQ,9957
 pltr/services/base.py,sha256=R2G781FI-sXtjUyLd91bVnmLb4cYZI3G8U5ndR9NLA4,1593
-pltr/services/dataset.py,sha256=cjl3aUhFcmWz_4ED8_h-Fl4Ym8ZMuA0dolOh89M7ufc,15412
+pltr/services/connectivity.py,sha256=34kazXhue5gNi1_2s2R5Ma4VQe6jP25CO-ztiPhCeZw,10548
+pltr/services/dataset.py,sha256=OeKRkkTRT_3uALsvipVzaFIOYRatqXUxLbLkbyCiqLc,20478
 pltr/services/folder.py,sha256=mWElyvn-wXPB5sv8Ik_dLeW5JM6jZg3g9KKBk6UcrlQ,5389
 pltr/services/mediasets.py,sha256=HgHNFWoG9r-5xupANVOxHg_h5EKsBDl6PsO8hwdbm28,9854
 pltr/services/ontology.py,sha256=iW7qRK8ptlw-u4eAwLNC-mdzLoLZzh7SRqJyok2c3GU,14883
 pltr/services/orchestration.py,sha256=t5RNC0BoKcqeYKJQ5AQAyyO_dIYCHxiHV177JVSszhM,14729
+pltr/services/project.py,sha256=nwLXBX0MWgOnVQ7CAZQHnzZtSJY_hqlGyooFngQSjcc,7740
+pltr/services/resource.py,sha256=hX1DX5ZoVx8-ZImBitHqgMS8Ver022RoMbd4ZvCt-fA,9603
+pltr/services/resource_role.py,sha256=Ootor16c6PR9TNxe6KJyd4W2lYM_HHDxJk-JvZhgRxU,10608
+pltr/services/space.py,sha256=4uea1nQ6CA-6_xWoD6n49E4Zm6KbW_7Cq9o89JorMTE,11544
 pltr/services/sql.py,sha256=19cscjlzN8WE1s8_ctiRcrOvMzCfmWRj49vjJ8Gs5Q4,11286
 pltr/utils/__init__.py,sha256=DF7TigL1XbKVGM5VjgU8_8AGIszofkdO80oCzLGGnTE,38
 pltr/utils/alias_resolver.py,sha256=DIF7P1UnUU8kqocJfIDEWjYq4s8_0KfqRZBbECeZEh8,1539
 pltr/utils/completion.py,sha256=bjeqjleEfB2YcQFpcxvF0GoQ763F6KBbULSZC4FWY_g,4980
-pltr/utils/formatting.py,sha256=uI8pkcWsO15kSH3xiOU9WxHCVfiWADEi-W1ldiXsCRY,40383
+pltr/utils/formatting.py,sha256=MuIgi8dSqvhzik7H0YQOq1sYPnY_poZOYeTVvrIY2Jk,44235
 pltr/utils/progress.py,sha256=BKYbiLO61uhQbibabU7pxvvbAWMRLRmqk4pZldBQK_g,9053
-pltr_cli-0.5.0.dist-info/METADATA,sha256=TNVMhHGMRkuRcWfds_6y4B9h6vDSkBRMr9Gt-IeYvks,13356
-pltr_cli-0.5.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-pltr_cli-0.5.0.dist-info/entry_points.txt,sha256=8tvEcW04kA_oAE2Dwwu-Og9efjl4ESJvs4AzlP2KBdQ,38
-pltr_cli-0.5.0.dist-info/licenses/LICENSE,sha256=6VUFd_ytnOBD2O1tmkKrA-smigi9QEhYr_tge4h4z8Y,1070
-pltr_cli-0.5.0.dist-info/RECORD,,
+pltr_cli-0.5.2.dist-info/METADATA,sha256=vWl7v5qxGJIOJYHLsRjY4fHdCPk6sWav2BTn-xS0F1Y,17714
+pltr_cli-0.5.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pltr_cli-0.5.2.dist-info/entry_points.txt,sha256=8tvEcW04kA_oAE2Dwwu-Og9efjl4ESJvs4AzlP2KBdQ,38
+pltr_cli-0.5.2.dist-info/licenses/LICENSE,sha256=6VUFd_ytnOBD2O1tmkKrA-smigi9QEhYr_tge4h4z8Y,1070
+pltr_cli-0.5.2.dist-info/RECORD,,