Metadata-Version: 2.4
Name: clipper-dev
Version: 0.1.3
Summary: A powerful, cross-platform clipboard manager for developers
Author-email: Rishit Kar <rishitkar@example.com>
Maintainer-email: Rishit Kar <rishitkar@example.com>
License: MIT
Project-URL: Homepage, https://github.com/Rklearns/clipper-dev
Project-URL: Documentation, https://github.com/Rklearns/clipper-dev#readme
Project-URL: Repository, https://github.com/Rklearns/clipper-dev.git
Project-URL: Bug Tracker, https://github.com/Rklearns/clipper-dev/issues
Project-URL: Release Notes, https://github.com/Rklearns/clipper-dev/releases
Keywords: clipboard,manager,terminal,cli,productivity,developer-tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Desktop Environment
Classifier: Topic :: Utilities
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: pyperclip>=1.8.2
Requires-Dist: rapidfuzz>=3.0.0
Requires-Dist: textual>=0.40.0
Requires-Dist: click>=8.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: flake8>=6.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: pre-commit>=3.0.0; extra == "dev"
Provides-Extra: test
Requires-Dist: pytest>=7.0.0; extra == "test"
Requires-Dist: pytest-cov>=4.0.0; extra == "test"
Requires-Dist: pytest-mock>=3.10.0; extra == "test"
Dynamic: license-file

#  Clipper-dev

> **The Ultimate Cross-Platform Clipboard Manager for Developers**

[![PyPI Downloads](https://static.pepy.tech/personalized-badge/clipper-dev?period=total&units=ABBREVIATION&left_color=GREY&right_color=MAGENTA&left_text=downloads)](https://pepy.tech/projects/clipper-dev)
[![PyPI version](https://badge.fury.io/py/clipper-dev.svg)](https://badge.fury.io/py/clipper-dev)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey.svg)](https://github.com/Rklearns/clipper-dev)

<div align="center">


**Never lose your clipboard content again. Clipper is the developer's best friend for managing clipboard history with style.**

[**Documentation**](#-features) • [ **Quick Start**](#-quick-start) • [ **Examples**](#-examples) • [ **Contributing**](#-contributing) • [ **License**](#-license)

</div>

---

##  Why Clipper-dev?

**Clipper-dev** is not just another clipboard manager—it's a **developer productivity powerhouse** designed from the ground up for modern development workflows.

###  **Built for Developers, by Developers**

- **Lightning Fast**: Instant search across thousands of clipboard entries
- **Beautiful UI**: Rich terminal output that makes your terminal look professional
- **Smart Search**: Fuzzy search with intelligent ranking and highlighting
- **Cross-Platform**: Seamless experience across macOS, Linux, and Windows
- **Real-time Monitoring**: Automatic clipboard tracking with configurable intervals
- **Interactive TUI**: Beautiful terminal user interface for power users

###  **What Makes Clipper Special**

| Feature | Clipper | Others |
|---------|-----------|---------|
| **Speed** |  Instant |  Slow |
| **Search** |  Fuzzy + Smart |  Basic |
| **UI** |  Rich + Beautiful |  Plain |
| **Cross-Platform** |  All OS |  Limited |
| **Developer Focus** |  Built for devs |  Generic |

---

##  Quick Start

###  **Installation**

```bash
# Install from PyPI (recommended)
pip install clipper-dev

# Or install from source
git clone https://github.com/Rklearns/clipper-dev.git
cd clipper-dev
pip install -e .
```

###  **First Steps**

```bash
# Save current clipboard content
clipper add

# View your clipboard history
clipper list

# Search for specific content
clipper search "python code"

# Restore the last copied item
clipper pop
```

---

##  Features

###  **Core Functionality**

- **Smart History**: Intelligent duplicate detection and content organization
- **Advanced Search**: Fuzzy search with configurable algorithms and scoring
- **Real-time Monitoring**: Automatic clipboard tracking with customizable intervals
- **Content Types**: Automatic detection and categorization of different content types
- **Rich Statistics**: Comprehensive analytics and usage insights

### **User Experience**

- **Rich Terminal Output**: Beautiful, colorful interface using Rich library
- **Interactive TUI**: Full-featured terminal user interface
- **Configurable**: Extensive customization options
- **Cross-Platform**: Consistent experience across all operating systems
- **Performance**: Optimized for speed and efficiency

###  **Developer Tools**

- **Easy Packaging**: Simple setup for distribution and deployment
- **Comprehensive Testing**: Full test coverage with pytest
- **Documentation**: Extensive inline documentation and examples
- **Configuration**: Flexible configuration management
- **Monitoring**: Built-in performance and usage monitoring

---

##  Command Reference

###  **Essential Commands**

| Command | Description | Example |
|---------|-------------|---------|
| `add` | Save current clipboard content | `clipper add` |
| `list` | Display clipboard history | `clipper list` |
| `search <query>` | Fuzzy search history | `clipper search "api key"` |
| `pop` | Restore last item | `clipper pop` |
| `restore <index>` | Restore specific item | `clipper restore 3` |

###  **Advanced Commands**

| Command | Description | Example |
|---------|-------------|---------|
| `peek` | Show last copied item | `clipper peek` |
| `clear` | Clear entire history | `clipper clear` |
| `export <file>` | Export to JSON/CSV | `clipper export backup.json` |
| `import-history <file>` | Import from JSON/CSV | `clipper import-history backup.json` |
| `stats` | Show usage statistics | `clipper stats` |
| `info` | System information | `clipper info` |
| `tui` | Interactive terminal UI | `clipper tui` |
| `monitor` | Start clipboard monitoring | `clipper monitor` |

---

##  Interactive TUI

Experience Clipper in its full glory with our beautiful terminal user interface:

```bash
clipper tui
```

**Features:**
- **History Browser**: Navigate through your clipboard history
- **Live Search**: Real-time search with instant results
- **Auto Refresh**: Reloads automatically when clipboard history changes on disk
- **Statistics Dashboard**: Visual representation of your usage
- **Settings Panel**: Configure Clipper to your preferences
- **Rich Interface**: Beautiful colors and formatting

---

##  Configuration

###  **Configuration Files**

Clipper currently persists its clipboard history in:
- **History**: `~/.clipper.json`

###  **Customization Options**

```toml
# Future configuration shape
[storage]
max_history = 200
storage_type = "json"  # or "sqlite" (future)

[display]
max_preview_length = 80
show_timestamps = true
color_scheme = "auto"

[clipboard]
auto_track = true
track_interval = 1.0
```

Configuration file loading is not wired up yet, so today the active persisted file is the history file above.

---

##  Development

###  **Setting Up Development Environment**

```bash
# Clone the repository
git clone https://github.com/Rklearns/clipper-dev.git
cd clipper-dev

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -r requirements-dev.txt

# Install in development mode
pip install -e .
```

###  **Running Tests**

```bash
# Run all tests
pytest

# Run with coverage
pytest --cov=clipper --cov-report=html

# Run specific test file
pytest tests/test_clipboard.py
```

###  **Code Quality**

```bash
# Format code
black clipper/ tests/

# Lint code
flake8 clipper/ tests/

# Type checking
mypy clipper/

# Run all quality checks
make check
```

---

##  Contributing

We love contributions! Here's how you can help make Clipper even better:

###  **Ways to Contribute**

-  **Report Bugs**: Open an issue with detailed bug reports
- �**Suggest Features**: Share your ideas for new features
-  **Improve Documentation**: Help make our docs even better
-  **Fix Issues**: Pick up issues and submit pull requests
-  **Star the Project**: Show your support by starring

###  **Contribution Guidelines**

1. **Fork** the repository
2. **Create** a feature branch (`git checkout -b feature/amazing-feature`)
3. **Commit** your changes (`git commit -m 'Add amazing feature'`)
4. **Push** to the branch (`git push origin feature/amazing-feature`)
5. **Open** a Pull Request

###  **Development Setup**

```bash
# Install pre-commit hooks
pre-commit install

# Run pre-commit on all files
pre-commit run --all-files
```

---



##  Show Your Support

If Clipper has helped you become more productive, please consider:

-  **Starring** this repository
-  **Sharing** with your developer friends
-  **Joining** our community discussions
-  **Buying us a coffee** (if you're feeling generous)

---

##  License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

**MIT License** means you can:
- Use Clipper commercially
- Modify and distribute
- Use privately
- Sublicense


---

##  Acknowledgments

- **Rich**: For beautiful terminal output
- **Typer**: For excellent CLI framework
- **Textual**: For amazing TUI capabilities
- **pyperclip**: For cross-platform clipboard access
- **rapidfuzz**: For lightning-fast fuzzy search

---


<div align="center">

**Made with ❤️ by developers, for developers**



</div>
