pltr-cli 0.11.0__tar.gz → 0.12.0__tar.gz

pltr_cli-0.12.0/.github/workflows/claude-code-review.yml

@@ -0,0 +1,56 @@
+name: Claude Code Review
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    # Optional: Only run on specific file changes
+    # paths:
+    #   - "src/**/*.ts"
+    #   - "src/**/*.tsx"
+    #   - "src/**/*.js"
+    #   - "src/**/*.jsx"
+
+jobs:
+  claude-review:
+    # Optional: Filter by PR author
+    # if: |
+    #   github.event.pull_request.user.login == 'external-contributor' ||
+    #   github.event.pull_request.user.login == 'new-developer' ||
+    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
+
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code Review
+        id: claude-review
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          prompt: |
+            REPO: ${{ github.repository }}
+            PR NUMBER: ${{ github.event.pull_request.number }}
+
+            Please review this pull request and provide feedback on:
+            - Code quality and best practices
+            - Potential bugs or issues
+            - Performance considerations
+            - Security concerns
+            - Test coverage
+
+            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
+
+            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
+
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'

pltr_cli-0.12.0/.github/workflows/claude.yml

@@ -0,0 +1,49 @@
+name: Claude Code
+
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+  issues:
+    types: [opened, assigned]
+  pull_request_review:
+    types: [submitted]
+
+jobs:
+  claude:
+    if: |
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
+      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
+      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      issues: read
+      id-token: write
+      actions: read # Required for Claude to read CI results on PRs
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 1
+
+      - name: Run Claude Code
+        id: claude
+        uses: anthropics/claude-code-action@v1
+        with:
+          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+
+          # This is an optional setting that allows Claude to read CI results on PRs
+          additional_permissions: |
+            actions: read
+
+          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
+          # prompt: 'Update the pull request description to include a summary of changes.'
+
+          # Optional: Add claude_args to customize behavior and configuration
+          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
+          # or https://docs.claude.com/en/docs/claude-code/cli-reference for available options
+          # claude_args: '--allowed-tools Bash(gh pr:*)'

{pltr_cli-0.11.0 → pltr_cli-0.12.0}/.gitignore

@@ -144,5 +144,12 @@ cython_debug/
 config.ini
 credentials.json
 
+# Test data files (avoid committing test outputs to root)
+/children.csv
+/folder_info.json
+/folders.json
+/*.csv
+/*.json
+
 # ruff
 .ruff_cache/

{pltr_cli-0.11.0 → pltr_cli-0.12.0}/.pre-commit-config.yaml

@@ -41,7 +41,7 @@ repos:
 
   # Python code formatting with Ruff
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.9
+    rev: v0.12.8
     hooks:
       - id: ruff
         name: Ruff linter

{pltr_cli-0.11.0 → pltr_cli-0.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pltr-cli
-Version: 0.11.0
+Version: 0.12.0
 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
@@ -29,6 +29,7 @@ Requires-Python: >=3.9
 Requires-Dist: click-repl>=0.3.0
 Requires-Dist: foundry-platform-sdk>=1.27.0
 Requires-Dist: keyring>=25.6.0
+Requires-Dist: pandas>=2.0.0
 Requires-Dist: python-dotenv>=1.1.1
 Requires-Dist: requests>=2.32.4
 Requires-Dist: rich>=14.1.0
@@ -37,7 +38,7 @@ Description-Content-Type: text/markdown
 
 # pltr-cli
 
-A comprehensive command-line interface for Palantir Foundry APIs, providing 80+ commands for data analysis, dataset management, ontology operations, orchestration, SQL queries, folder management, and administrative tasks.
+A comprehensive command-line interface for Palantir Foundry APIs, providing 81+ commands for data analysis, dataset management, ontology operations, orchestration, SQL queries, folder management, and administrative tasks.
 
 ## Overview
 
@@ -215,6 +216,7 @@ pltr connectivity import table <conn-rid> <table-name> <dataset-rid> --execute
 # Administrative
 pltr admin user current        # Current user info
 pltr admin user list          # List users
+pltr third-party-apps get <rid>  # Get third-party application details
 
 # Interactive & Tools
 pltr shell                    # Interactive mode
@@ -470,7 +472,7 @@ See **[API Wrapper Documentation](docs/api/wrapper.md)** for detailed architectu
 
 pltr-cli is **production-ready** with comprehensive features:
 
-- ✅ **80+ Commands** across 10 command groups
+- ✅ **81+ Commands** across 11 command groups
 - ✅ **273 Unit Tests** with 67% code coverage
 - ✅ **Published on PyPI** with automated releases
 - ✅ **Cross-Platform** support (Windows, macOS, Linux)

{pltr_cli-0.11.0 → pltr_cli-0.12.0}/README.md

@@ -1,6 +1,6 @@
 # pltr-cli
 
-A comprehensive command-line interface for Palantir Foundry APIs, providing 80+ commands for data analysis, dataset management, ontology operations, orchestration, SQL queries, folder management, and administrative tasks.
+A comprehensive command-line interface for Palantir Foundry APIs, providing 81+ commands for data analysis, dataset management, ontology operations, orchestration, SQL queries, folder management, and administrative tasks.
 
 ## Overview
 
@@ -178,6 +178,7 @@ pltr connectivity import table <conn-rid> <table-name> <dataset-rid> --execute
 # Administrative
 pltr admin user current        # Current user info
 pltr admin user list          # List users
+pltr third-party-apps get <rid>  # Get third-party application details
 
 # Interactive & Tools
 pltr shell                    # Interactive mode
@@ -433,7 +434,7 @@ See **[API Wrapper Documentation](docs/api/wrapper.md)** for detailed architectu
 
 pltr-cli is **production-ready** with comprehensive features:
 
-- ✅ **80+ Commands** across 10 command groups
+- ✅ **81+ Commands** across 11 command groups
 - ✅ **273 Unit Tests** with 67% code coverage
 - ✅ **Published on PyPI** with automated releases
 - ✅ **Cross-Platform** support (Windows, macOS, Linux)

pltr_cli-0.12.0/claude_skill/README.md

@@ -0,0 +1,51 @@
+# pltr-cli Claude Code Skill
+
+This directory contains a Claude Code skill for working with Palantir Foundry using the pltr-cli.
+
+## Installation
+
+### Use Within This Repository
+
+The skill is automatically available when using Claude Code in this repository.
+
+### Install Globally
+
+```bash
+cp -r claude_skill ~/.claude/skills/pltr
+```
+
+## Structure
+
+```
+claude_skill/
+├── SKILL.md                    # Main skill definition
+├── reference/                  # Command references (loaded on-demand)
+│   ├── quick-start.md         # Setup and authentication
+│   ├── dataset-commands.md    # Dataset operations
+│   ├── sql-commands.md        # SQL queries
+│   ├── orchestration-commands.md  # Builds, jobs, schedules
+│   ├── ontology-commands.md   # Ontology operations
+│   ├── admin-commands.md      # User/group management
+│   ├── filesystem-commands.md # Folders, spaces, projects
+│   ├── connectivity-commands.md   # Connections, imports
+│   └── mediasets-commands.md  # Media operations
+└── workflows/                  # Common patterns
+    ├── data-analysis.md       # Analysis workflows
+    ├── data-pipeline.md       # ETL and pipelines
+    └── permission-management.md   # Access control
+```
+
+## Usage
+
+Ask Claude Code questions about Foundry tasks:
+
+- "How do I query a dataset?"
+- "Help me set up a daily build schedule"
+- "Grant viewer access to john.doe on my dataset"
+- "Execute SQL query to count rows"
+
+Claude will automatically use this skill to provide accurate guidance.
+
+## Documentation
+
+See [docs/user-guide/claude-skill.md](../docs/user-guide/claude-skill.md) for full documentation.

pltr_cli-0.12.0/claude_skill/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: pltr-cli
+description: Helps you work with Palantir Foundry using the pltr CLI. Use this when you need to query datasets, manage orchestration builds, work with ontologies, run SQL queries, manage folders/spaces/projects, copy datasets, or perform admin operations in Foundry. Triggers: Foundry, pltr, dataset, SQL query, ontology, build, schedule, RID.
+---
+
+# pltr-cli: Palantir Foundry CLI
+
+This skill helps you use the pltr-cli to interact with Palantir Foundry effectively.
+
+## Compatibility
+
+- **Skill version**: 1.0.0
+- **pltr-cli version**: 0.11.0+
+- **Python**: 3.9, 3.10, 3.11, 3.12
+- **Dependencies**: foundry-platform-sdk >= 1.27.0
+
+## Overview
+
+pltr-cli is a comprehensive CLI with 80+ commands for:
+- **Dataset operations**: Get info, list files, download files, manage branches and transactions
+- **SQL queries**: Execute queries, export results, manage async queries
+- **Ontology**: List ontologies, object types, objects, execute actions and queries
+- **Orchestration**: Manage builds, jobs, and schedules
+- **Filesystem**: Folders, spaces, projects, resources
+- **Admin**: User, group, role management
+- **Connectivity**: External connections and data imports
+- **MediaSets**: Media file management
+
+## Critical Concepts
+
+### RID-Based API
+The Foundry API is **RID-based** (Resource Identifier). Most commands require RIDs:
+- **Datasets**: `ri.foundry.main.dataset.{uuid}`
+- **Folders**: `ri.compass.main.folder.{uuid}` (root: `ri.compass.main.folder.0`)
+- **Builds**: `ri.orchestration.main.build.{uuid}`
+- **Schedules**: `ri.orchestration.main.schedule.{uuid}`
+- **Ontologies**: `ri.ontology.main.ontology.{uuid}`
+
+Users must know RIDs in advance (from Foundry web UI or previous API calls).
+
+### Authentication
+Before using any command, ensure authentication is configured:
+```bash
+# Configure interactively
+pltr configure configure
+
+# Or use environment variables
+export FOUNDRY_TOKEN="your-token"
+export FOUNDRY_HOST="foundry.company.com"
+
+# Verify connection
+pltr verify
+```
+
+### Output Formats
+All commands support multiple output formats:
+```bash
+pltr <command> --format table    # Default: Rich table
+pltr <command> --format json     # JSON output
+pltr <command> --format csv      # CSV format
+pltr <command> --output file.csv # Save to file
+```
+
+### Profile Selection
+Use `--profile` to switch between Foundry instances:
+```bash
+pltr <command> --profile production
+pltr <command> --profile development
+```
+
+## Reference Files
+
+Load these files based on the user's task:
+
+| Task Type | Reference File |
+|-----------|----------------|
+| Setup, authentication, getting started | `reference/quick-start.md` |
+| Dataset operations (get, files, branches, transactions) | `reference/dataset-commands.md` |
+| SQL queries | `reference/sql-commands.md` |
+| Builds, jobs, schedules | `reference/orchestration-commands.md` |
+| Ontologies, objects, actions | `reference/ontology-commands.md` |
+| Users, groups, roles, orgs | `reference/admin-commands.md` |
+| Folders, spaces, projects, resources, permissions | `reference/filesystem-commands.md` |
+| Connections, imports | `reference/connectivity-commands.md` |
+| Media sets, media items | `reference/mediasets-commands.md` |
+
+## Workflow Files
+
+For common multi-step tasks:
+
+| Workflow | File |
+|----------|------|
+| Data exploration, SQL analysis, ontology queries | `workflows/data-analysis.md` |
+| ETL pipelines, scheduled jobs, data quality | `workflows/data-pipeline.md` |
+| Setting up permissions, resource roles, access control | `workflows/permission-management.md` |
+
+## Common Commands Quick Reference
+
+```bash
+# Verify setup
+pltr verify
+
+# Current user info
+pltr admin user current
+
+# Execute SQL query
+pltr sql execute "SELECT * FROM my_table LIMIT 10"
+
+# Get dataset info
+pltr dataset get ri.foundry.main.dataset.abc123
+
+# List files in dataset
+pltr dataset files list ri.foundry.main.dataset.abc123
+
+# Download file from dataset
+pltr dataset files get ri.foundry.main.dataset.abc123 "/path/file.csv" "./local.csv"
+
+# Copy dataset to another folder
+pltr cp ri.foundry.main.dataset.abc123 ri.compass.main.folder.target456
+
+# List folder contents
+pltr folder list ri.compass.main.folder.0  # root folder
+
+# Search builds
+pltr orchestration builds search
+
+# Interactive shell mode
+pltr shell
+```
+
+## Best Practices
+
+1. **Always verify authentication first**: Run `pltr verify` before starting work
+2. **Use appropriate output format**: JSON for programmatic use, CSV for spreadsheets, table for readability
+3. **Use async for large queries**: `pltr sql submit` + `pltr sql wait` for long-running queries
+4. **Export results**: Use `--output` to save results for further analysis
+5. **Use shell mode for exploration**: `pltr shell` provides tab completion and history
+
+## Getting Help
+
+```bash
+pltr --help                    # All commands
+pltr <command> --help          # Command help
+pltr <command> <sub> --help    # Subcommand help
+```

pltr_cli-0.12.0/claude_skill/reference/admin-commands.md

@@ -0,0 +1,311 @@
+# Admin Commands
+
+User, group, role, and organization management. **Requires admin permissions**.
+
+## User Commands
+
+### List Users
+
+```bash
+pltr admin user list [--page-size N] [--page-token TEXT] [--format FORMAT]
+
+# Example
+pltr admin user list --page-size 50 --format csv --output users.csv
+```
+
+### Get User Info
+
+```bash
+pltr admin user get USER_ID [--format FORMAT]
+
+# Example
+pltr admin user get john.doe@company.com
+```
+
+### Current User
+
+```bash
+pltr admin user current [--format FORMAT]
+
+# Example
+pltr admin user current --format json
+```
+
+### Search Users
+
+```bash
+pltr admin user search QUERY [--page-size N] [--format FORMAT]
+
+# Example
+pltr admin user search "john" --page-size 20
+```
+
+### Get User Markings/Permissions
+
+```bash
+pltr admin user markings USER_ID [--format FORMAT]
+
+# Example
+pltr admin user markings john.doe@company.com
+```
+
+### Revoke User Tokens
+
+```bash
+pltr admin user revoke-tokens USER_ID [--confirm]
+
+# Example
+pltr admin user revoke-tokens john.doe@company.com --confirm
+```
+
+### Delete User
+
+```bash
+pltr admin user delete USER_ID [--confirm]
+
+# Example
+pltr admin user delete john.doe@company.com --confirm
+```
+
+### Batch Get Users
+
+```bash
+pltr admin user batch-get USER_IDS...
+
+# Max 500 user IDs
+
+# Example
+pltr admin user batch-get user1@company.com user2@company.com user3@company.com
+```
+
+## Group Commands
+
+### List Groups
+
+```bash
+pltr admin group list [--format FORMAT]
+
+# Example
+pltr admin group list
+```
+
+### Get Group Info
+
+```bash
+pltr admin group get GROUP_ID [--format FORMAT]
+
+# Example
+pltr admin group get engineering-team
+```
+
+### Search Groups
+
+```bash
+pltr admin group search QUERY [--format FORMAT]
+
+# Example
+pltr admin group search "engineering"
+```
+
+### Create Group
+
+```bash
+pltr admin group create NAME [--description TEXT] [--org-rid TEXT]
+
+# Example
+pltr admin group create "Data Science Team" --description "Team for ML and analytics"
+```
+
+### Delete Group
+
+```bash
+pltr admin group delete GROUP_ID [--confirm]
+
+# Example
+pltr admin group delete old-team --confirm
+```
+
+### Batch Get Groups
+
+```bash
+pltr admin group batch-get GROUP_IDS...
+
+# Max 500 group IDs
+
+# Example
+pltr admin group batch-get engineering-team data-team security-team
+```
+
+## Role Commands
+
+### Get Role Info
+
+```bash
+pltr admin role get ROLE_ID [--format FORMAT]
+
+# Example
+pltr admin role get admin-role
+```
+
+### Batch Get Roles
+
+```bash
+pltr admin role batch-get ROLE_IDS...
+
+# Max 500 role IDs
+
+# Example
+pltr admin role batch-get admin-role editor-role viewer-role
+```
+
+## Organization Commands
+
+### Get Organization Info
+
+```bash
+pltr admin org get ORGANIZATION_ID [--format FORMAT]
+
+# Example
+pltr admin org get my-organization
+```
+
+### Create Organization
+
+```bash
+pltr admin org create NAME --enrollment-rid ENROLLMENT_RID [OPTIONS]
+
+# Options:
+#   --admin-id TEXT    Admin user IDs (can specify multiple)
+
+# Example
+pltr admin org create "New Organization" --enrollment-rid ri.enrollment.main.123 \
+  --admin-id admin1@company.com --admin-id admin2@company.com
+```
+
+### Replace Organization
+
+```bash
+pltr admin org replace ORGANIZATION_RID NAME [OPTIONS]
+
+# Options:
+#   --description TEXT    New organization description
+#   --confirm             Skip confirmation prompt
+
+# Example
+pltr admin org replace ri.compass.main.org.123 "Updated Org Name" \
+  --description "Updated description" --confirm
+```
+
+### List Available Roles for Organization
+
+```bash
+pltr admin org available-roles ORGANIZATION_RID [--page-size N] [--page-token TEXT]
+
+# Example
+pltr admin org available-roles ri.compass.main.org.123 --page-size 50
+```
+
+## Marking Commands
+
+### List Markings
+
+```bash
+pltr admin marking list [--page-size N] [--page-token TEXT] [--format FORMAT]
+
+# Example
+pltr admin marking list --format json --output markings.json
+```
+
+### Get Marking Info
+
+```bash
+pltr admin marking get MARKING_ID [--format FORMAT]
+
+# Example
+pltr admin marking get marking-confidential
+```
+
+### Create Marking
+
+```bash
+pltr admin marking create NAME [OPTIONS]
+
+# Options:
+#   --description TEXT    Marking description
+#   --category-id TEXT    Category ID for the marking
+
+# Example
+pltr admin marking create "Confidential" --description "Confidential data marking"
+```
+
+### Replace Marking
+
+```bash
+pltr admin marking replace MARKING_ID NAME [OPTIONS]
+
+# Options:
+#   --description TEXT    New marking description
+#   --confirm             Skip confirmation prompt
+
+# Example
+pltr admin marking replace marking-123 "Updated Name" --description "New description" --confirm
+```
+
+### Batch Get Markings
+
+```bash
+pltr admin marking batch-get MARKING_IDS...
+
+# Max 500 marking IDs
+
+# Example
+pltr admin marking batch-get marking-1 marking-2 marking-3
+```
+
+## Common Patterns
+
+### Audit users
+```bash
+# Export all users
+pltr admin user list --format csv --output all_users.csv
+
+# Search for admin users
+pltr admin user search "admin" --format csv --output admins.csv
+```
+
+### User management workflow
+```bash
+# Get current user info
+pltr admin user current
+
+# Check user permissions
+pltr admin user markings john.doe@company.com
+
+# Search for specific users
+pltr admin user search "data scientist"
+```
+
+### Group management
+```bash
+# List all groups
+pltr admin group list --format json --output groups.json
+
+# Create new team group
+pltr admin group create "Analytics Team" --description "Business analytics team"
+
+# Get group details
+pltr admin group get analytics-team
+```
+
+### Security audit script
+```bash
+#!/bin/bash
+# Export users and groups for audit
+DATE=$(date +%Y%m%d)
+
+pltr admin user list --format json --output "audit_users_${DATE}.json"
+pltr admin group list --format json --output "audit_groups_${DATE}.json"
+pltr admin user search "admin" --format csv --output "potential_admins_${DATE}.csv"
+
+echo "Audit files generated for $DATE"
+```