Metadata-Version: 2.4
Name: itjobs
Version: 0.2.2
Summary: Analyze IT job offers from justjoin.it — salary stats, top companies, benefits
Author: Michal Grzesiak
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/m-grzesiak/IT-job-offers-analyzer
Project-URL: Repository, https://github.com/m-grzesiak/IT-job-offers-analyzer
Project-URL: Issues, https://github.com/m-grzesiak/IT-job-offers-analyzer/issues
Keywords: jobs,salary,analysis,justjoin,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
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: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: rich>=13.0
Requires-Dist: prompt_toolkit>=3.0
Provides-Extra: test
Requires-Dist: pytest>=8.0; extra == "test"
Dynamic: license-file

# IT Job Offers Analyzer

Analyze IT job offers from [justjoin.it](https://justjoin.it) — a Polish job board for the tech industry.

![itjobs CLI demo](demo.svg)

Features:
- Filter offers by city, category, experience, workplace, employment type
- Statistical salary analysis with percentile distribution
- IQR-based outlier detection
- Top-paying companies ranking
- B2B benefits analysis (paid vacation, sick leave)
- Interactive REPL with tab-completion and session caching

## Requirements

- Python 3.10+
- [rich](https://github.com/Textualize/rich) — terminal formatting
- [prompt_toolkit](https://github.com/prompt-toolkit/python-prompt-toolkit) — interactive REPL

All dependencies are installed automatically via `pip`.

## Installation

```bash
pip install itjobs
```

## Usage

### Interactive CLI (recommended)

```bash
itjobs
```

Commands auto-fetch data when needed:

```
/analyze Kraków python senior b2b
/top b2b >P75
/benefits Kraków python senior
/show
/help
```

## Development

```bash
git clone https://github.com/m-grzesiak/IT-job-offers-analyzer.git
cd IT-job-offers-analyzer
python -m venv .venv && source .venv/bin/activate
pip install -e .
```

## Disclaimer

This project is intended for educational and personal use only. It is not affiliated with or endorsed by justjoin.it. No scraped data is stored or redistributed — all analysis happens locally in your terminal session. Use responsibly and in accordance with the target website's terms of service.

## License

Apache License 2.0
