pltr-cli 0.1.2__tar.gz → 0.3.0__tar.gz

{pltr_cli-0.1.2 → pltr_cli-0.3.0}/.github/workflows/ci.yml

@@ -41,7 +41,8 @@ jobs:
 
     - name: Run tests with coverage
       run: |
-        uv run pytest --cov=pltr --cov-report=xml --cov-report=term
+        # Run all tests including integration tests (import issues fixed)
+        uv run pytest tests/ --cov=pltr --cov-report=xml --cov-report=term
 
     - name: Upload coverage to Codecov
       uses: codecov/codecov-action@v4
@@ -77,4 +78,4 @@ jobs:
     - name: Run security checks (if configured)
       run: |
         # Add security scanning tools here if needed
-        echo "Security checks placeholder - add tools like bandit, safety, etc."
+        echo "Security checks placeholder - add tools like bandit, safety, etc."

{pltr_cli-0.1.2 → pltr_cli-0.3.0}/.github/workflows/publish.yml

@@ -62,7 +62,7 @@ jobs:
     if: startsWith(github.ref, 'refs/tags/')
     needs: build
     runs-on: ubuntu-latest
-    environment: 
+    environment:
       name: pypi
       url: https://pypi.org/project/pltr-cli/
     permissions:
@@ -90,7 +90,7 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
-        
+
       - name: Download distribution artifacts
         uses: actions/download-artifact@v4
         with:
@@ -126,4 +126,4 @@ jobs:
           body: ${{ steps.changelog.outputs.CHANGELOG }}
           draft: false
           prerelease: false
-          generate_release_notes: true
+          generate_release_notes: true

{pltr_cli-0.1.2 → pltr_cli-0.3.0}/.github/workflows/test-publish.yml

@@ -20,7 +20,7 @@ jobs:
   test-build:
     name: Test build and publish to TestPyPI
     runs-on: ubuntu-latest
-    environment: 
+    environment:
       name: testpypi
       url: https://test.pypi.org/project/pltr/
     permissions:
@@ -46,7 +46,8 @@ jobs:
 
       - name: Run tests
         run: |
-          uv run pytest --cov=pltr --cov-report=xml --cov-report=term
+          # Run all tests including integration tests (import issues fixed)
+          uv run pytest tests/ --cov=pltr --cov-report=xml --cov-report=term
 
       - name: Run linting
         run: |
@@ -85,12 +86,12 @@ jobs:
           # Create a temporary pyproject.toml with test version
           uv run python -c "
           import tomllib, tomli_w
-          
+
           with open('pyproject.toml', 'rb') as f:
               config = tomllib.load(f)
-          
+
           config['project']['version'] = '${{ steps.test_version.outputs.TEST_VERSION }}'
-          
+
           with open('pyproject.toml', 'wb') as f:
               tomli_w.dump(config, f)
           "
@@ -118,12 +119,12 @@ jobs:
         run: |
           # Wait a moment for TestPyPI to process the upload
           sleep 30
-          
+
           # Try to install the package from TestPyPI
           uv run pip install --index-url https://test.pypi.org/simple/ \
                             --extra-index-url https://pypi.org/simple/ \
                             pltr-cli==${{ steps.test_version.outputs.TEST_VERSION }}
-          
+
           # Test basic import and CLI functionality
           uv run python -c "import pltr; print('Package import successful')"
           uv run pltr --help
@@ -138,4 +139,4 @@ jobs:
             echo "- **Status**: ✅ Successfully published and tested" >> $GITHUB_STEP_SUMMARY
           else
             echo "- **Status**: ❌ Test failed" >> $GITHUB_STEP_SUMMARY
-          fi
+          fi

{pltr_cli-0.1.2 → pltr_cli-0.3.0}/.gitignore

@@ -145,4 +145,4 @@ config.ini
 credentials.json
 
 # ruff
-.ruff_cache/
+.ruff_cache/

pltr_cli-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,109 @@
+# Pre-commit hooks for pltr-cli
+# See https://pre-commit.com for more information
+
+repos:
+  # General file fixes
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+        name: Fix trailing whitespace
+        description: Removes trailing whitespace
+      - id: end-of-file-fixer
+        name: Fix end of files
+        description: Ensures files end with a newline
+      - id: check-yaml
+        name: Check YAML files
+        description: Validates YAML file syntax
+      - id: check-added-large-files
+        name: Check for large files
+        description: Prevents large files from being committed
+        args: ['--maxkb=1000']
+      - id: check-toml
+        name: Check TOML files
+        description: Validates TOML file syntax
+      - id: check-json
+        name: Check JSON files
+        description: Validates JSON file syntax
+      - id: check-merge-conflict
+        name: Check merge conflicts
+        description: Checks for merge conflict markers
+      - id: check-ast
+        name: Check Python syntax
+        description: Validates Python file syntax
+      - id: debug-statements
+        name: Check for debug statements
+        description: Checks for Python debug statements
+      - id: mixed-line-ending
+        name: Fix mixed line endings
+        description: Checks for mixed line ending
+        args: ['--fix=lf']
+
+  # Python code formatting with Ruff
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.1.9
+    hooks:
+      - id: ruff
+        name: Ruff linter
+        description: Fast Python linter
+        args: [--fix]
+      - id: ruff-format
+        name: Ruff formatter
+        description: Fast Python formatter
+
+  # Type checking with mypy
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.8.0
+    hooks:
+      - id: mypy
+        name: mypy type checker
+        description: Static type checker for Python
+        additional_dependencies:
+          - types-requests
+          - types-setuptools
+        args: [--ignore-missing-imports, --no-strict-optional, --explicit-package-bases]
+        files: ^src/
+
+  # Security checks
+  - repo: https://github.com/PyCQA/bandit
+    rev: 1.7.6
+    hooks:
+      - id: bandit
+        name: Bandit security linter
+        description: Security linter for Python
+        args: ['-ll', '--skip', 'B101,B601']
+        files: ^src/
+
+
+# Configuration
+default_language_version:
+  python: python3.9
+
+# Run hooks on all files by default
+default_install_hook_types: [pre-commit, pre-push]
+
+# Exclude directories
+exclude: |
+  (?x)^(
+    \.git/|
+    \.venv/|
+    venv/|
+    \.env/|
+    env/|
+    __pycache__/|
+    \.pytest_cache/|
+    \.mypy_cache/|
+    \.ruff_cache/|
+    build/|
+    dist/|
+    \.eggs/|
+    .*\.egg-info/|
+    uv\.lock
+  )
+
+# CI configuration
+ci:
+  autofix_prs: true
+  autofix_commit_msg: '[pre-commit.ci] auto fixes from pre-commit hooks'
+  autoupdate_schedule: weekly
+  autoupdate_commit_msg: '[pre-commit.ci] pre-commit autoupdate'

{pltr_cli-0.1.2 → pltr_cli-0.3.0}/CLAUDE.md

@@ -1,11 +1,11 @@
-## Dependency Management
-
-Use uv for dependency management
-
-
 ## Development tips
 
-Always keep @DEVELOPMENT_PLAN.md up to date
+Always keep @DEVELOPMENT_PLAN.md up to date.
+The basis of the SDK is https://github.com/palantir/foundry-platform-python . This is a
+CLI that wraps around the SDK to give a CLI interface.
+
+Use uv for dependency management.
+Use uv to run python scripts.
 
 ## General Guidance
 

pltr_cli-0.3.0/PKG-INFO

@@ -0,0 +1,280 @@
+Metadata-Version: 2.4
+Name: pltr-cli
+Version: 0.3.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
+Project-URL: Issues, https://github.com/anjor/pltr-cli/issues
+Project-URL: Changelog, https://github.com/anjor/pltr-cli/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/anjor/pltr-cli/blob/main/README.md
+Author-email: anjor <anjor@umd.edu>
+License: MIT
+License-File: LICENSE
+Keywords: api,cli,data,foundry,ontology,palantir
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Topic :: Utilities
+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: python-dotenv>=1.1.1
+Requires-Dist: requests>=2.32.4
+Requires-Dist: rich>=14.1.0
+Requires-Dist: typer>=0.16.0
+Description-Content-Type: text/markdown
+
+# pltr-cli
+
+A comprehensive command-line interface for Palantir Foundry APIs, providing 65+ commands for data analysis, ontology operations, SQL queries, and administrative tasks.
+
+## Overview
+
+`pltr-cli` provides a powerful and intuitive way to interact with Palantir Foundry from the command line. Built on top of the official `foundry-platform-sdk`, it offers comprehensive access to Foundry's capabilities with a focus on productivity and ease of use.
+
+## ✨ Key Features
+
+- 🔐 **Secure Authentication**: Token and OAuth2 support with encrypted credential storage
+- 📊 **Dataset Operations**: Get dataset information and create new datasets (RID-based API)
+- 🎯 **Comprehensive Ontology Access**: 13 commands for objects, actions, and queries
+- 📝 **Full SQL Support**: Execute, submit, monitor, and export query results
+- 👥 **Admin Operations**: User, group, role, and organization management (16 commands)
+- 💻 **Interactive Shell**: REPL mode with tab completion and command history
+- ⚡ **Shell Completion**: Auto-completion for bash, zsh, and fish
+- 🎨 **Rich Output**: Beautiful terminal formatting with multiple export formats (table, JSON, CSV)
+- 👤 **Multi-Profile Support**: Manage multiple Foundry environments seamlessly
+
+## Installation
+
+### Using pip
+
+```bash
+pip install pltr-cli
+```
+
+### From source
+
+```bash
+# Clone the repository
+git clone https://github.com/anjor/pltr-cli.git
+cd pltr-cli
+
+# Install with uv
+uv sync
+
+# Run the CLI
+uv run pltr --help
+```
+
+## 🚀 Quick Start
+
+### 1. Configure Authentication
+
+Set up your Foundry credentials:
+
+```bash
+pltr configure configure
+```
+
+Follow the interactive prompts to enter:
+- Foundry hostname (e.g., `foundry.company.com`)
+- Authentication method (token or OAuth2)
+- Your credentials
+
+### 2. Verify Connection
+
+Test your setup:
+
+```bash
+pltr verify
+```
+
+### 3. Start Exploring
+
+```bash
+# Check current user
+pltr admin user current
+
+# List available ontologies
+pltr ontology list
+
+# Execute a simple SQL query
+pltr sql execute "SELECT 1 as test"
+
+# Start interactive mode for exploration
+pltr shell
+```
+
+### 4. Enable Shell Completion
+
+For the best experience:
+
+```bash
+pltr completion install
+```
+
+📖 **Need more help?** See the **[Quick Start Guide](docs/user-guide/quick-start.md)** for detailed setup instructions.
+
+## 📚 Documentation
+
+pltr-cli provides comprehensive documentation to help you get the most out of the tool:
+
+### 📖 User Guides
+- **[Quick Start Guide](docs/user-guide/quick-start.md)** - Get up and running in 5 minutes
+- **[Authentication Setup](docs/user-guide/authentication.md)** - Complete guide to token and OAuth2 setup
+- **[Command Reference](docs/user-guide/commands.md)** - Complete reference for all 65+ commands
+- **[Common Workflows](docs/user-guide/workflows.md)** - Real-world data analysis patterns
+- **[Troubleshooting](docs/user-guide/troubleshooting.md)** - Solutions to common issues
+
+### 🔧 Developer Resources
+- **[API Wrapper Documentation](docs/api/wrapper.md)** - Architecture and extension guide
+- **[Examples Gallery](docs/examples/gallery.md)** - Real-world use cases and automation scripts
+
+### 🎯 Quick Command Overview
+
+**Most Common Commands:**
+```bash
+# Authentication & Setup
+pltr configure configure        # Set up authentication
+pltr verify                    # Test connection
+
+# Data Analysis
+pltr sql execute "SELECT * FROM table"  # Run SQL queries
+pltr ontology list             # List ontologies
+pltr dataset get <rid>         # Get dataset info
+
+# Administrative
+pltr admin user current        # Current user info
+pltr admin user list          # List users
+
+# Interactive & Tools
+pltr shell                    # Interactive mode
+pltr completion install       # Enable tab completion
+```
+
+💡 **Tip**: Use `pltr --help` or `pltr <command> --help` for detailed command help.
+
+For the complete command reference with examples, see **[Command Reference](docs/user-guide/commands.md)**.
+
+## ⚙️ Configuration
+
+pltr-cli stores configuration securely using industry best practices:
+
+- **Profile Configuration**: `~/.config/pltr/profiles.json`
+- **Credentials**: Encrypted in system keyring (never stored in plain text)
+- **Shell History**: `~/.config/pltr/repl_history` (for interactive mode)
+
+### Environment Variables
+
+For CI/CD and automation, use environment variables:
+
+```bash
+# Token authentication
+export FOUNDRY_TOKEN="your-api-token"
+export FOUNDRY_HOST="foundry.company.com"
+
+# OAuth2 authentication
+export FOUNDRY_CLIENT_ID="your-client-id"
+export FOUNDRY_CLIENT_SECRET="your-client-secret"
+export FOUNDRY_HOST="foundry.company.com"
+```
+
+See **[Authentication Setup](docs/user-guide/authentication.md)** for complete configuration options.
+
+## 🔧 Development
+
+### Prerequisites
+
+- Python 3.9+
+- [uv](https://github.com/astral-sh/uv) for dependency management
+
+### Quick Development Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/anjor/pltr-cli.git
+cd pltr-cli
+
+# Install dependencies and development tools
+uv sync
+
+# Install pre-commit hooks
+uv run pre-commit install
+
+# Run tests
+uv run pytest
+
+# Run linting and formatting
+uv run ruff check src/
+uv run ruff format src/
+uv run mypy src/
+```
+
+### Project Architecture
+
+pltr-cli uses a layered architecture:
+
+- **CLI Layer** (Typer): Command-line interface and argument parsing
+- **Command Layer**: Command implementations with validation
+- **Service Layer**: Business logic and foundry-platform-sdk integration
+- **Auth Layer**: Secure authentication and credential management
+- **Utils Layer**: Formatting, progress, and helper functions
+
+See **[API Wrapper Documentation](docs/api/wrapper.md)** for detailed architecture information and extension guides.
+
+## 📊 Current Status
+
+pltr-cli is **production-ready** with comprehensive features:
+
+- ✅ **65+ Commands** across 8 command groups
+- ✅ **273 Unit Tests** with 67% code coverage
+- ✅ **Published on PyPI** with automated releases
+- ✅ **Cross-Platform** support (Windows, macOS, Linux)
+- ✅ **Comprehensive Documentation** (Quick start, guides, examples)
+- ✅ **Interactive Shell** with tab completion and history
+- ✅ **CI/CD Ready** with environment variable support
+
+**Latest Release**: Available on [PyPI](https://pypi.org/project/pltr-cli/)
+
+## 🤝 Contributing
+
+Contributions are welcome! Whether you're fixing bugs, adding features, or improving documentation.
+
+### Getting Started
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feature/amazing-feature`)
+3. Make your changes following the existing patterns
+4. Add tests for new functionality
+5. Run the test suite and linting
+6. Commit using conventional commit format (`feat:`, `fix:`, `docs:`, etc.)
+7. Push to your branch and create a Pull Request
+
+### Development Guidelines
+
+- Follow existing code patterns and architecture
+- Add tests for new functionality
+- Update documentation for user-facing changes
+- Use type hints throughout
+- Follow the existing error handling patterns
+
+See **[API Wrapper Documentation](docs/api/wrapper.md)** for detailed development guidelines.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.
+
+## Acknowledgments
+
+Built on top of the official [Palantir Foundry Platform Python SDK](https://github.com/palantir/foundry-platform-python).