pltr-cli 0.1.0__py3-none-any.whl

pltr_cli-0.1.0.dist-info/METADATA

@@ -0,0 +1,203 @@
+Metadata-Version: 2.4
+Name: pltr-cli
+Version: 0.1.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: 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 command-line interface tool for interacting with Palantir Foundry APIs.
+
+## Overview
+
+`pltr-cli` provides a streamlined way to interact with Palantir Foundry services from the command line. Built on top of the official `foundry-platform-sdk`, it offers intuitive commands for dataset management, ontology operations, SQL queries, and more.
+
+## Features
+
+- 🔐 **Secure Authentication**: Support for both token and OAuth2 authentication with secure credential storage
+- 📊 **Dataset Management**: List, create, upload, and download datasets with progress indicators
+- 🔍 **Ontology Operations**: Search and interact with ontology objects and actions
+- 📝 **SQL Queries**: Execute SQL queries directly from the command line
+- 🎨 **Rich Output**: Beautiful terminal output with table formatting and color support
+- 👤 **Multi-Profile Support**: Manage multiple Foundry environments with profile configurations
+
+## Installation
+
+### Using pip
+
+```bash
+pip install pltr
+```
+
+### 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
+
+### Configure Authentication
+
+Set up your Foundry credentials:
+
+```bash
+pltr configure --profile production
+```
+
+This will prompt you for:
+- Foundry host URL
+- Authentication method (token or OAuth2)
+- Credentials
+
+### Basic Usage
+
+```bash
+# List datasets
+pltr dataset list
+
+# Upload a file to a dataset
+pltr dataset upload <dataset-id> path/to/file.csv
+
+# Execute a SQL query
+pltr sql execute "SELECT * FROM dataset LIMIT 10"
+
+# Search ontology objects
+pltr ontology object search "customer name:John"
+```
+
+## Command Reference
+
+### Dataset Commands
+
+- `pltr dataset list` - List all accessible datasets
+- `pltr dataset get <id>` - Get dataset details
+- `pltr dataset upload <id> <file>` - Upload file to dataset
+- `pltr dataset download <id>` - Download dataset files
+
+### Ontology Commands
+
+- `pltr ontology object search <query>` - Search for objects
+- `pltr ontology object get <id>` - Get specific object
+- `pltr ontology action execute <action>` - Execute ontology action
+
+### SQL Commands
+
+- `pltr sql execute <query>` - Execute SQL query
+- `pltr sql export <query> --output <file>` - Export query results
+
+### Configuration Commands
+
+- `pltr configure` - Set up authentication
+- `pltr configure --profile <name>` - Configure named profile
+
+## Configuration
+
+Configuration files are stored in `~/.pltr/`:
+- `~/.pltr/config` - Profile configurations
+- Credentials are stored securely in your system keyring
+
+### Environment Variables
+
+You can also configure authentication via environment variables:
+
+```bash
+export FOUNDRY_HOST=https://your-foundry.palantir.com
+export FOUNDRY_TOKEN=your-token-here
+```
+
+## Development
+
+### Prerequisites
+
+- Python 3.9+
+- [uv](https://github.com/astral-sh/uv) for dependency management
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/anjor/pltr-cli.git
+cd pltr-cli
+
+# Install dependencies
+uv sync
+
+# Run tests
+uv run pytest
+
+# Format code
+uv run ruff format
+uv run ruff check --fix
+```
+
+### Project Structure
+
+```
+pltr-cli/
+├── src/
+│   └── pltr/
+│       ├── cli.py           # Main CLI entry point
+│       ├── auth/            # Authentication handling
+│       ├── commands/        # CLI command implementations
+│       ├── services/        # Foundry service wrappers
+│       ├── config/          # Configuration management
+│       └── utils/           # Utilities and helpers
+└── tests/                   # Test suite
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'feat: add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 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).

pltr_cli-0.1.0.dist-info/RECORD

@@ -0,0 +1,28 @@
+pltr/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
+pltr/cli.py,sha256=lfbVMIvlr1HwSfblEIEr-_Rppe4J1_erydJkv2S4Tk0,1302
+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
+pltr/auth/oauth.py,sha256=uTl5T3MSPlq8Jb3c45hib0vj-GQoyLxmS_NbnKez5dI,2844
+pltr/auth/storage.py,sha256=C7I3-22CJcnrKGNdxk9nXjphsnqQVguT5gNfAnR78Ok,2474
+pltr/auth/token.py,sha256=V48kxGn7CFbNGo17er5oI_ZA3xJ3iS9TsFjphZYqS2s,1925
+pltr/commands/__init__.py,sha256=iOLJ1ql4mz-3-4nz21hAqjd-9IjpYAIxr9SJQKHNFxM,29
+pltr/commands/configure.py,sha256=oYj-VlOEj3MDwtB2RC4bYOYzI_sXTanPnz7y1GmMTqY,4800
+pltr/commands/dataset.py,sha256=igllutiTPeUvKnIErBc2W5_RCGg39SsHN71VSaZ5La8,3250
+pltr/commands/verify.py,sha256=60DE2Tb-uk8D5c2xFswOflks0Y0GAlQKl-tYVBfmbJY,6610
+pltr/config/__init__.py,sha256=Y6gARy5lUHy-OJaOUxtfXoeQVNZV5QHLl6uKHQ8tpTk,41
+pltr/config/profiles.py,sha256=XMUIp6Ez5LNC6rGXZe2JLH7IKepXhARtuc8ASUA9FYA,3431
+pltr/config/settings.py,sha256=bfIiosPqH_W73TOHS71DvgZdAHka4fJDopU1SvBRFuQ,2908
+pltr/services/__init__.py,sha256=dZeDOZkXHXx16OJwzqfgII-MjODLb5s1cDxlIh2utEQ,40
+pltr/services/base.py,sha256=R2G781FI-sXtjUyLd91bVnmLb4cYZI3G8U5ndR9NLA4,1593
+pltr/services/dataset.py,sha256=W3zoh-9YIJ6HBsDijejVEngKvpudFoZinYtHDmAXCOc,2785
+pltr/services/dataset_full.py,sha256=FyMiwOSyX1cUrYXaK0T_1iq5G_X0e5iZTibJHuEmMeE,9869
+pltr/services/dataset_v2.py,sha256=_uhcVJ91w_Y07glceqHceccAwPWr6q1TWSIqcP1FU8I,4259
+pltr/utils/__init__.py,sha256=DF7TigL1XbKVGM5VjgU8_8AGIszofkdO80oCzLGGnTE,38
+pltr/utils/formatting.py,sha256=UhUch5SAOOb8l3nx2CcNQmMuzhbvo0WqqmVppYNkXoU,11105
+pltr/utils/progress.py,sha256=6ayZ6s4z9wJ3rcS_ILmeuOe_iLRBXN6DU1AYGmgpBwU,9055
+pltr_cli-0.1.0.dist-info/METADATA,sha256=iCbd94Do5dCxHHxMJIrmP8Zseahw_Pj9n4s1RxqXKyU,5744
+pltr_cli-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+pltr_cli-0.1.0.dist-info/entry_points.txt,sha256=8tvEcW04kA_oAE2Dwwu-Og9efjl4ESJvs4AzlP2KBdQ,38
+pltr_cli-0.1.0.dist-info/licenses/LICENSE,sha256=6VUFd_ytnOBD2O1tmkKrA-smigi9QEhYr_tge4h4z8Y,1070
+pltr_cli-0.1.0.dist-info/RECORD,,

pltr_cli-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

pltr_cli-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pltr = pltr.cli:app

pltr_cli-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Anjor Kanekar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.