Metadata-Version: 2.4
Name: xplorer
Version: 1.0.3
Summary: Enterprise-Grade Spark & Pandas Data Explorer: High-performance interactive data exploration tool.
Project-URL: Homepage, https://github.com/imsonuparmar/Xplorer
Project-URL: Issues, https://github.com/imsonuparmar/Xplorer/issues
Author: Sonu Parmar (imsonuparmar)
License: # XPLORER — PROPRIETARY SOFTWARE LICENSE AGREEMENT
        
        Copyright (c) 2026 Sonu Parmar (imsonuparmar). All rights reserved.
        
        ## 1. DEFINITIONS
        
        - "Software" means the Xplorer source code, documentation, compiled packages, and all associated files distributed under this license.
        - "Author" means Sonu Parmar (imsonuparmar), the sole copyright holder.
        - "You" / "User" means any individual or entity that downloads, installs, or uses the Software.
        - "Commercial Purpose" means any use intended for or directed toward commercial advantage or monetary compensation, including but not limited to use within a for-profit organization, integration into commercial products or services, or use to generate revenue.
        
        ## 2. OWNERSHIP
        
        The Software is proprietary and the exclusive intellectual property of the Author. All rights, titles, and interests in and to the Software — including but not limited to copyrights, trade secrets, and any associated intellectual property — remain solely with the Author. Nothing in this license transfers ownership to You.
        
        ## 3. GRANT OF USE
        
        Subject to the terms and restrictions below, You are granted a limited, non-exclusive, non-transferable, non-sublicensable, revocable license to:
        
        - Download and install the Software from the Python Package Index (PyPI) or other Author-authorized distribution channels.
        - Use the Software for **personal, educational, and non-commercial purposes only** (e.g., academic research, learning, personal data exploration).
        
        This grant is provided free of charge for non-commercial use only.
        
        ## 4. COMMERCIAL USE
        
        Any use of the Software for a Commercial Purpose requires **prior written permission** from the Author. To obtain a commercial license, contact the Author at the repository listed in the project metadata.
        
        Unauthorized commercial use constitutes a material breach of this license and may result in legal action.
        
        ## 5. RESTRICTIONS
        
        You are strictly prohibited from:
        
        ### 5.1 Plagiarism and Misappropriation
        - Claiming authorship of, or presenting the Software (in whole or in part) as Your own work.
        - Incorporating any portion of the Software's source code, logic, templates, or design into another project without written permission.
        
        ### 5.2 Modification and Reverse Engineering
        - Modifying, adapting, translating, or creating derivative works based on the Software.
        - Decompiling, disassembling, reverse-engineering, or otherwise attempting to derive the source code or underlying algorithms of the Software.
        
        ### 5.3 Redistribution
        - Redistributing, sublicensing, renting, leasing, selling, or otherwise transferring the Software or access to it, in source or compiled form, without express written permission from the Author.
        - Repackaging the Software under a different name or as part of another distribution.
        
        ### 5.4 AI / ML Training Prohibition
        - Using the Software's source code, documentation, outputs, or any associated materials as training data, fine-tuning data, evaluation data, or input for any artificial intelligence, machine learning, large language model, neural network, or automated code-generation system.
        - Scraping, indexing, or crawling the Software's repository or distribution artifacts for the purpose of building datasets used in AI/ML training or evaluation.
        
        This prohibition applies regardless of whether the AI/ML use is commercial or non-commercial.
        
        ### 5.5 Competing Use
        - Using the Software or knowledge derived from it to build, improve, or contribute to a competing product or service.
        
        ## 6. PYPI DISTRIBUTION
        
        The Author publishes the Software on PyPI solely for the convenience of end-user installation. Publication on PyPI does **not** constitute a grant of rights beyond those explicitly stated in this license. PyPI mirrors and downstream package indexes are permitted to cache and serve the Software's published artifacts solely for the purpose of facilitating `pip install` by end users.
        
        ## 7. NO WARRANTY
        
        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 AUTHOR 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.
        
        ## 8. LIMITATION OF LIABILITY
        
        TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, THE AUTHOR SHALL NOT BE LIABLE FOR ANY INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, OR PUNITIVE DAMAGES, OR ANY LOSS OF PROFITS OR REVENUES, WHETHER INCURRED DIRECTLY OR INDIRECTLY, OR ANY LOSS OF DATA, USE, GOODWILL, OR OTHER INTANGIBLE LOSSES RESULTING FROM YOUR USE OR INABILITY TO USE THE SOFTWARE.
        
        ## 9. INDEMNIFICATION
        
        You agree to indemnify, defend, and hold harmless the Author from and against any claims, liabilities, damages, losses, and expenses (including reasonable legal fees) arising out of or in any way connected with Your use of the Software or violation of this license.
        
        ## 10. TERMINATION
        
        - This license is effective until terminated.
        - The Author may terminate this license at any time, with or without cause, upon notice.
        - This license terminates automatically and immediately if You breach any of its terms.
        - Upon termination, You must cease all use of the Software and destroy all copies in Your possession.
        - Sections 1, 2, 5.4, 7, 8, 9, and 11 survive termination.
        
        ## 11. ENFORCEMENT AND LEGAL CONSEQUENCES
        
        Any unauthorized use of the Software — including but not limited to unauthorized commercial use, plagiarism, redistribution, or use for AI/ML training — constitutes a violation of this license and applicable intellectual property laws. The Author reserves the right to pursue all available legal remedies, including injunctive relief and monetary damages.
        
        ## 12. GOVERNING LAW
        
        This license shall be governed by and construed in accordance with the laws of India, without regard to its conflict of law provisions. Any disputes arising under this license shall be subject to the exclusive jurisdiction of the courts in India.
        
        ## 13. SEVERABILITY
        
        If any provision of this license is found to be unenforceable or invalid, that provision shall be limited or eliminated to the minimum extent necessary so that the remaining provisions remain in full force and effect.
        
        ## 14. ENTIRE AGREEMENT
        
        This license constitutes the entire agreement between You and the Author regarding the Software and supersedes all prior agreements or understandings. No amendment to this license is effective unless in writing and signed by the Author.
        
        ---
        
        For commercial licensing inquiries or permissions, contact the Author via the project repository:
        https://github.com/imsonuparmar/Xplorer
License-File: LICENSE
Keywords: data-display,data-exploration,dataframe,display,jupyter,jupyter notebook,jupyterLab,pandas,pyspark,spark,spark-display
Classifier: Framework :: Jupyter
Classifier: License :: Other/Proprietary 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: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Requires-Dist: anywidget>=0.9.0
Requires-Dist: ipython>=7.0.0
Requires-Dist: ipywidgets>=8.0.0
Requires-Dist: numpy>=1.20.0
Requires-Dist: openpyxl>=3.0.0
Requires-Dist: pandas>=1.5.0
Provides-Extra: dev
Requires-Dist: build>=1.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: twine>=5.0; extra == 'dev'
Provides-Extra: spark
Requires-Dist: pyspark>=3.0.0; extra == 'spark'
Description-Content-Type: text/markdown

# Xplorer: The Enterprise-Grade Spark & Pandas Explorer

**Xplorer** is a high-performance, memory-safe, and visually stunning interactive data exploration tool designed specifically for big data workflows in Jupyter environments. It bridges the gap between massive Spark DataFrames and intuitive user experiences, allowing data scientists and engineers to inspect, profile, and interact with data without leaving their notebooks.

---

## Key Features

- **Blazing Fast Performance:** Optimized for handling large-scale Spark DataFrames with smart sampling and memory-efficient rendering.
- **Interactive UI:** A rich, responsive interface built with modern web standards, featuring dynamic sorting, filtering, and pagination.
- **Adaptive Themes:** Choose from 15+ stunning themes including *Midnight Emerald*, *Cyber Punk*, and *Lumina Frost*, or use the *Adaptive Native* mode that matches your Jupyter or VS Code environment.
- **Dual Compatibility:** Seamlessly explore both **PySpark** and **Pandas** DataFrames using a unified interface.
- **Data Profiling:** Instant insights into schema types, null counts, and data distributions.
- **Production Ready:** Built with a strict object-oriented architecture, ensuring stability and extensibility for enterprise environments.

---

## Installation

Xplorer requires a **Jupyter / IPython** environment (JupyterLab, Jupyter Notebook, or Modern IDE's (vs code, cursor, antigravity) with the Jupyter extension).

**Core install** (Pandas + Jupyter):

```bash
pip install xplorer
```

**With PySpark support:**

```bash
pip install "xplorer[spark]"
```
---

## Quick Start

```python
from xplorer import xplore

# Pandas DataFrame
xplore(pandas_df)

# PySpark DataFrame (requires xplorer[spark])
xplore(spark_df)

# Limit the number of rows explicitly
xplore(spark_df, limit=1000)

# Disable the default limit to fetch full data
# (Automatically caps at 5000 rows to prevent memory crashes)
xplore(spark_df, defaultLimit=False)
```

---

## Themes at a Glance

Xplorer isn't just functional; it's beautiful. Customize your workspace with:
- **Dark Modes:** Obsidian, Midnight Emerald, Deep Space Blue, Charcoal Carbon.
- **Light Modes:** Lumina Frost, Mint Pastel, Rose Quartz, Solar Amber.
- **Dual Tones:** Charcoal & Amber, Slate & Electric Cyan, Forest & Lime.

---

## License

Proprietary License. See the [LICENSE](https://github.com/imsonuparmar/Xplorer/blob/main/LICENSE) file for more details.
Copyright (c) 2026 Sonu Parmar (imsonuparmar).
