Metadata-Version: 2.4
Name: jobtty
Version: 0.3.5
Summary: 🚀 Terminal Job Board - Find your next role from the command line
Home-page: https://github.com/croscomsoftware/jobtty
Author: Croscom Software
Author-email: Croscom Software <konrad.zdzieba@croscomsoftware.com>
Project-URL: Homepage, https://github.com/croscomsoftware/jobtty
Project-URL: Documentation, https://github.com/croscomsoftware/jobtty/blob/main/README.md
Project-URL: Repository, https://github.com/croscomsoftware/jobtty.git
Project-URL: Issues, https://github.com/croscomsoftware/jobtty/issues
Classifier: Development Status :: 3 - Alpha
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.8
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 :: Internet :: WWW/HTTP
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: rich>=13.0.0
Requires-Dist: requests>=2.28.0
Requires-Dist: stripe>=5.0.0
Requires-Dist: keyring>=23.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: qrcode[pil]>=7.0.0
Provides-Extra: git
Requires-Dist: GitPython>=3.1.0; extra == "git"
Provides-Extra: collaboration
Requires-Dist: websockets>=11.0.0; extra == "collaboration"
Provides-Extra: challenges
Requires-Dist: docker>=6.0.0; extra == "challenges"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: pytest-mock>=3.10.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"
Provides-Extra: all
Requires-Dist: GitPython>=3.1.0; extra == "all"
Requires-Dist: websockets>=11.0.0; extra == "all"
Requires-Dist: docker>=6.0.0; extra == "all"
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# 🚀 Jobtty.io - Terminal Job Board

Find your next role from the command line! A beautiful, interactive terminal interface for job searching across multiple platforms.

```
     ██╗ ██████╗ ██████╗ ████████╗████████╗██╗   ██╗
     ██║██╔═══██╗██╔══██╗╚══██╔══╝╚══██╔══╝╚██╗ ██╔╝
     ██║██║   ██║██████╔╝   ██║      ██║    ╚████╔╝ 
██   ██║██║   ██║██╔══██╗   ██║      ██║     ╚██╔╝  
╚█████╔╝╚██████╔╝██████╔╝   ██║      ██║      ██║   
 ╚════╝  ╚═════╝ ╚═════╝    ╚═╝      ╚═╝      ╚═╝   
                                                     
    🚀 Terminal Job Board • Find your next role
```

## Features

- 🔍 **Multi-platform Search**: Search jobs across ThamesAI.co.uk, Flutter.pl, and FlutterLondon.com
- 💳 **Premium Features**: Stripe-powered premium job postings and featured listings
- 🎨 **Beautiful Terminal UI**: Rich colors, ASCII art, and interactive menus
- 🔐 **Secure Authentication**: Keyring-based secure token storage
- 📊 **Analytics**: Track your applications and job posting performance
- 🔖 **Bookmarking**: Save jobs for later review
- ⚙️ **Configurable**: Customize location, currency, and search preferences

## Installation

```bash
pip install jobtty
```

Or install from source:
```bash
git clone https://github.com/croscomsoftware/jobtty.git
cd jobtty
pip install -e .
```

## Quick Start

```bash
# Interactive mode
jobtty

# Search for jobs
jobtty search "python developer"
jobtty search "flutter" --remote --salary 80k

# Authentication
jobtty login
jobtty whoami

# Job posting
jobtty post --interactive

# Premium features
jobtty buy premium-listing --duration 30d
```

## Commands

### Authentication
```bash
jobtty login                    # Login to job board services
jobtty logout                   # Logout from all services
jobtty whoami                   # Show current user info
```

### Job Search
```bash
jobtty search "query"           # Search all job boards
jobtty search --remote          # Remote jobs only
jobtty search --location "City" # Location filter
jobtty search --salary 80k      # Minimum salary filter
jobtty show 42                  # Show job details
jobtty save 42                  # Bookmark job
jobtty list --saved             # Show saved jobs
```

### Job Posting
```bash
jobtty post                     # Interactive job posting
jobtty post --title "Developer" --company "TechCorp"
jobtty my-posts                 # Show your job postings
```

### Premium Features
```bash
jobtty buy                      # Browse premium catalog
jobtty buy premium-listing      # Upgrade to premium
jobtty buy featured-post --job-id 123
jobtty billing --history       # Payment history
```

### Configuration
```bash
jobtty config --location "Warsaw"
jobtty config --currency "EUR"
jobtty config --show           # Show all settings
```

## API Integration

Jobtty integrates with:

- **Jobtty.io Production API**: Main job board with 50+ companies (Meta, Google, Apple, Microsoft, Amazon, Spotify, etc.)
- **ThamesAI.co.uk**: AI and technology jobs in London
- **Flutter.pl**: Flutter and mobile development jobs in Poland  
- **FlutterLondon.com**: Flutter community jobs in London

### Real-time Notifications

Get job alerts directly in your terminal while coding:

```bash
# Start the notification daemon
jobtty daemon start

# Continue coding... 
# 🎯 NEW JOB MATCH! (94% match)
# 🏢 Google - Senior React Developer
# 📍 London 🏠 Remote | 💰 £90K-120K
# 🚀 jobtty apply ext_001
```

## Premium Features

### 💎 Premium Listings (£29/month)
- Featured placement in search results
- 3x more visibility
- Priority positioning
- Advanced analytics

### 🚀 Featured Posts (£49/month)
- Top of search results
- Highlighted appearance
- Social media promotion
- Extended duration (45 days)

### 📊 Analytics Pro (£19/month)
- Detailed application metrics
- Candidate source tracking
- Performance benchmarking
- Export capabilities

### 🎨 Company Branding (£99/month)
- Custom brand colors
- Company logo integration
- Branded company page
- Custom email templates

## Configuration

Jobtty stores configuration in `~/.jobtty/`:
- `config.json`: User preferences and settings
- `user.json`: Current user information
- Secure tokens stored in system keyring

Default configuration:
```json
{
  "location": "London, UK",
  "currency": "GBP", 
  "remote_only": false,
  "salary_min": 0,
  "preferred_sources": ["thamesai", "flutter_pl", "flutter_london"],
  "display_mode": "table",
  "auto_save_searches": true,
  "theme": "cyber"
}
```

## Development

```bash
# Setup development environment
git clone https://github.com/croscomsoftware/jobtty.git
cd jobtty
pip install -e .
pip install -r requirements-dev.txt

# Run tests
pytest

# Run CLI in development
python -m jobtty.cli
```

## Contributing

We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

## License

MIT License - see [LICENSE](LICENSE) file.

## Support

- 🌐 Website: https://jobtty.io
- 📧 Email: support@jobtty.io
- 🐛 Issues: https://github.com/croscomsoftware/jobtty/issues

---

Made with ❤️ by [Croscom Software](https://croscomsoftware.com)
