kolay-cli 0.1.0__tar.gz

kolay_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tunc Aucer
+
+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.

kolay_cli-0.1.0/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: kolay-cli
+Version: 0.1.0
+Summary: Command-line interface for Kolay IK (https://apidocs.kolayik.com)
+Author: Tunc Aucer
+License: MIT
+Project-URL: Homepage, https://github.com/ezapmar/kolay-cli
+Project-URL: Repository, https://github.com/ezapmar/kolay-cli
+Project-URL: Issues, https://github.com/ezapmar/kolay-cli/issues
+Keywords: kolay,hr,cli,kolayik,human-resources
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+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 :: Office/Business
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.4.2
+Dynamic: license-file
+
+# Kolay CLI
+
+```
+                        +************
+                       +*+        **+
+                      +*+       +*+      %%               #%%
+                     +*+       +*+       %%   *#*  #%%#   #%%   #%%#*#*+**    **+
+                   +**+       +*+        %% #%%* %%%##%%% #%% %%%#*%%%% %%#  #%%
+                    **+      +**+        %%%%#  %%#    %%##%%#%%    %%%  %%##%%#
+                     +*+    +*++*+       %%#%%# %%%    %%##%%*%%    #%%   %%%%#
+                      +*+  **   +*+      %%  #%% *%%%%%%# #%% #%%%%%%%%   *%%%
+                       +*+**      **+                                     #%%
+                        +************                                   #%%%
+```
+
+A powerful, user-friendly command-line interface for the [Kolay IK API](https://apidocs.kolayik.com). Manage your HR operations directly from the terminal.
+
+## ✨ Features
+
+| Module | Commands | Description |
+|--------|----------|-------------|
+| **Auth** | `login`, `status` | Securely store and manage your API token |
+| **Person** | `list`, `view`, `leave-status`, `terminate` | List employees, view structured profiles, check leave balances, terminate with SGK codes |
+| **Leave** | `list`, `view`, `create` | List leave records, view details, create leaves with interactive type picker |
+
+### Highlights
+
+- 🎨 **Rich terminal output** — Structured tables, panels, and color-coded statuses
+- 🔐 **Secure token storage** — Config file with restricted permissions (`0600`)
+- 🇹🇷 **Turkish HR aware** — SGK termination codes, DD.MM.YYYY date format support
+- ⚡ **Smart prompts** — Leave type picker, today's date defaults, active employee pre-checks
+
+## 📦 Installation
+
+### Using pipx (Recommended)
+```bash
+pipx install kolay-cli
+```
+
+### From source
+```bash
+git clone https://github.com/ezapmar/kolay-cli.git
+cd kolay-cli
+pip install -e .
+```
+
+## 🚀 Quick Start
+
+### 1. Authenticate
+Generate an API token from [Kolay Developer Settings](https://app.kolayik.com/settings/developer-settings), then:
+```bash
+kolay auth login
+```
+
+### 2. List your employees
+```bash
+kolay person list
+```
+
+### 3. View someone's profile
+```bash
+kolay person view <person-id>
+```
+
+### 4. Check leave balances
+```bash
+kolay person leave-status <person-id>
+```
+
+### 5. Create a leave request
+```bash
+kolay leave create
+```
+The CLI will interactively show available leave types and let you pick by number.
+
+## 📖 Command Reference
+
+### Auth
+```bash
+kolay auth login          # Save your API token (prompted securely)
+kolay auth status         # Check if you're logged in
+```
+
+### Person
+```bash
+kolay person list                          # List active employees
+kolay person list --status inactive        # List inactive employees
+kolay person list --page 2                 # Paginate results
+kolay person view <id>                     # Structured profile view
+kolay person leave-status <id>             # Leave balances table
+kolay person terminate <id>                # Terminate with SGK reason codes
+```
+
+### Leave
+```bash
+kolay leave list                           # List approved leaves (current year)
+kolay leave list --status waiting          # List pending leaves
+kolay leave list --person-id <id>          # Filter by person
+kolay leave list --start-date "2025-01-01 00:00:00" --end-date "2025-12-31 23:59:59"
+kolay leave view <leave-id>               # View leave record details
+kolay leave create                         # Interactive leave creation
+```
+
+## ⚙️ Configuration
+
+The CLI stores its configuration at `~/.config/kolay/config.json` with restricted file permissions.
+
+You can also use environment variables (they take precedence):
+```bash
+export KOLAY_API_TOKEN="your-token-here"
+export KOLAY_BASE_URL="https://api.kolayik.com"  # optional
+```
+
+## 🛠 Development
+
+```bash
+# Clone and setup
+git clone https://github.com/ezapmar/kolay-cli.git
+cd kolay-cli
+python -m venv .venv
+source .venv/bin/activate   # or .venv\Scripts\activate on Windows
+pip install -e .
+
+# Run
+kolay --help
+```
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE) — use it freely, modify it, share it. See the `LICENSE` file for details.

kolay_cli-0.1.0/README.md

@@ -0,0 +1,130 @@
+# Kolay CLI
+
+```
+                        +************
+                       +*+        **+
+                      +*+       +*+      %%               #%%
+                     +*+       +*+       %%   *#*  #%%#   #%%   #%%#*#*+**    **+
+                   +**+       +*+        %% #%%* %%%##%%% #%% %%%#*%%%% %%#  #%%
+                    **+      +**+        %%%%#  %%#    %%##%%#%%    %%%  %%##%%#
+                     +*+    +*++*+       %%#%%# %%%    %%##%%*%%    #%%   %%%%#
+                      +*+  **   +*+      %%  #%% *%%%%%%# #%% #%%%%%%%%   *%%%
+                       +*+**      **+                                     #%%
+                        +************                                   #%%%
+```
+
+A powerful, user-friendly command-line interface for the [Kolay IK API](https://apidocs.kolayik.com). Manage your HR operations directly from the terminal.
+
+## ✨ Features
+
+| Module | Commands | Description |
+|--------|----------|-------------|
+| **Auth** | `login`, `status` | Securely store and manage your API token |
+| **Person** | `list`, `view`, `leave-status`, `terminate` | List employees, view structured profiles, check leave balances, terminate with SGK codes |
+| **Leave** | `list`, `view`, `create` | List leave records, view details, create leaves with interactive type picker |
+
+### Highlights
+
+- 🎨 **Rich terminal output** — Structured tables, panels, and color-coded statuses
+- 🔐 **Secure token storage** — Config file with restricted permissions (`0600`)
+- 🇹🇷 **Turkish HR aware** — SGK termination codes, DD.MM.YYYY date format support
+- ⚡ **Smart prompts** — Leave type picker, today's date defaults, active employee pre-checks
+
+## 📦 Installation
+
+### Using pipx (Recommended)
+```bash
+pipx install kolay-cli
+```
+
+### From source
+```bash
+git clone https://github.com/ezapmar/kolay-cli.git
+cd kolay-cli
+pip install -e .
+```
+
+## 🚀 Quick Start
+
+### 1. Authenticate
+Generate an API token from [Kolay Developer Settings](https://app.kolayik.com/settings/developer-settings), then:
+```bash
+kolay auth login
+```
+
+### 2. List your employees
+```bash
+kolay person list
+```
+
+### 3. View someone's profile
+```bash
+kolay person view <person-id>
+```
+
+### 4. Check leave balances
+```bash
+kolay person leave-status <person-id>
+```
+
+### 5. Create a leave request
+```bash
+kolay leave create
+```
+The CLI will interactively show available leave types and let you pick by number.
+
+## 📖 Command Reference
+
+### Auth
+```bash
+kolay auth login          # Save your API token (prompted securely)
+kolay auth status         # Check if you're logged in
+```
+
+### Person
+```bash
+kolay person list                          # List active employees
+kolay person list --status inactive        # List inactive employees
+kolay person list --page 2                 # Paginate results
+kolay person view <id>                     # Structured profile view
+kolay person leave-status <id>             # Leave balances table
+kolay person terminate <id>                # Terminate with SGK reason codes
+```
+
+### Leave
+```bash
+kolay leave list                           # List approved leaves (current year)
+kolay leave list --status waiting          # List pending leaves
+kolay leave list --person-id <id>          # Filter by person
+kolay leave list --start-date "2025-01-01 00:00:00" --end-date "2025-12-31 23:59:59"
+kolay leave view <leave-id>               # View leave record details
+kolay leave create                         # Interactive leave creation
+```
+
+## ⚙️ Configuration
+
+The CLI stores its configuration at `~/.config/kolay/config.json` with restricted file permissions.
+
+You can also use environment variables (they take precedence):
+```bash
+export KOLAY_API_TOKEN="your-token-here"
+export KOLAY_BASE_URL="https://api.kolayik.com"  # optional
+```
+
+## 🛠 Development
+
+```bash
+# Clone and setup
+git clone https://github.com/ezapmar/kolay-cli.git
+cd kolay-cli
+python -m venv .venv
+source .venv/bin/activate   # or .venv\Scripts\activate on Windows
+pip install -e .
+
+# Run
+kolay --help
+```
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE) — use it freely, modify it, share it. See the `LICENSE` file for details.

kolay_cli-0.1.0/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kolay-cli"
+version = "0.1.0"
+description = "Command-line interface for Kolay IK (https://apidocs.kolayik.com)"
+authors = [
+    {name = "Tunc Aucer"}
+]
+readme = "README.md"
+requires-python = ">=3.9"
+dependencies = [
+    "typer>=0.9.0",
+    "requests>=2.31.0",
+    "rich>=13.4.2"
+]
+license = {text = "MIT"}
+keywords = ["kolay", "hr", "cli", "kolayik", "human-resources"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: System Administrators",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business",
+]
+
+[project.urls]
+Homepage = "https://github.com/ezapmar/kolay-cli"
+Repository = "https://github.com/ezapmar/kolay-cli"
+Issues = "https://github.com/ezapmar/kolay-cli/issues"
+
+[project.scripts]
+kolay = "kolay_cli.cli:app"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

kolay_cli-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kolay_cli-0.1.0/src/kolay_cli/__init__.py

@@ -0,0 +1,4 @@
+"""
+Kolay CLI
+"""
+__version__ = "0.1.0"

kolay_cli-0.1.0/src/kolay_cli/api.py

@@ -0,0 +1,56 @@
+import requests
+from typing import Dict, Any, Optional
+
+from . import config
+
+class APIError(Exception):
+    pass
+
+class KolayClient:
+    def __init__(self, token: Optional[str] = None, base_url: Optional[str] = None):
+        self.token = token or config.get_api_token()
+        self.base_url = (base_url or config.get_base_url()).rstrip("/")
+        
+        if not self.token:
+            raise APIError("API token is required. Please set it using 'kolay auth login' or the KOLAY_API_TOKEN environment variable.")
+        
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Authorization": f"Bearer {self.token}",
+            "Accept": "application/json",
+            "Content-Type": "application/json"
+        })
+
+    def get(self, endpoint: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        return self._request("GET", endpoint, params=params)
+
+    def post(self, endpoint: str, data: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        return self._request("POST", endpoint, json=data)
+
+    def put(self, endpoint: str, data: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        return self._request("PUT", endpoint, json=data)
+
+    def delete(self, endpoint: str, params: Optional[Dict[str, Any]] = None) -> Dict[str, Any]:
+        return self._request("DELETE", endpoint, params=params)
+
+    def _request(self, method: str, endpoint: str, **kwargs) -> Dict[str, Any]:
+        url = f"{self.base_url}/{endpoint.lstrip('/')}"
+        
+        try:
+            response = self.session.request(method, url, **kwargs)
+            response.raise_for_status()
+            # Most Kolay API responses return a json payload
+            if response.content:
+                return response.json()
+            return {}
+        except requests.exceptions.HTTPError as e:
+            msg = f"API Error: {e.response.status_code}"
+            try:
+                error_data = e.response.json()
+                if "message" in error_data:
+                    msg += f" - {error_data['message']}"
+            except Exception:
+                msg += f" - {e.response.text}"
+            raise APIError(msg)
+        except Exception as e:
+            raise APIError(f"Request failed: {str(e)}")

kolay_cli-0.1.0/src/kolay_cli/cli.py

@@ -0,0 +1,47 @@
+import typer
+
+from . import __version__
+from .commands import auth, person, leave
+from rich.console import Console
+
+LOGO = """\b
+[bold cyan]                        +************                                                               [/bold cyan]
+[bold cyan]                       +*+        **+                                                               [/bold cyan]
+[bold cyan]                      +*+       +*+      %%               #%%                                       [/bold cyan]
+[bold cyan]                     +*+       +*+       %%   *#*  #%%#   #%%   #%%#*#*+**    **+                   [/bold cyan]
+[bold cyan]                   +**+       +*+        %% #%%* %%%##%%% #%% %%%#*%%%% %%#  #%%                    [/bold cyan]
+[bold cyan]                    **+      +**+        %%%%#  %%#    %%##%%#%%    %%%  %%##%%#                    [/bold cyan]
+[bold cyan]                     +*+    +*++*+       %%#%%# %%%    %%##%%*%%    #%%   %%%%#                     [/bold cyan]
+[bold cyan]                      +*+  **   +*+      %%  #%% *%%%%%%# #%% #%%%%%%%%   *%%%                      [/bold cyan]
+[bold cyan]                       +*+**      **+                                     #%%                       [/bold cyan]
+[bold cyan]                        +************                                   #%%%                    [/bold cyan]
+
+Kolay CLI - A command-line interface for the Kolay IK API.
+"""
+
+app = typer.Typer(
+    no_args_is_help=True,
+    rich_markup_mode="rich"
+)
+console = Console()
+
+app.add_typer(auth.app, name="auth")
+app.add_typer(person.app, name="person")
+app.add_typer(leave.app, name="leave")
+
+@app.callback(invoke_without_command=True, help=LOGO)
+def main(
+    version: bool = typer.Option(
+        False,
+        "--version",
+        "-v",
+        help="Print the CLI version.",
+        is_eager=True,
+    )
+):
+    if version:
+        console.print(f"Kolay CLI version: [bold cyan]{__version__}[/bold cyan]")
+        raise typer.Exit()
+
+if __name__ == "__main__":
+    app()

kolay_cli-0.1.0/src/kolay_cli/commands/__init__.py

@@ -0,0 +1,3 @@
+from . import auth, person, leave
+
+__all__ = ["auth", "person", "leave"]

kolay_cli-0.1.0/src/kolay_cli/commands/auth.py

@@ -0,0 +1,26 @@
+import typer
+from ..config import set_config_value, get_api_token
+from rich.console import Console
+
+app = typer.Typer(help="Auth commands for the Kolay CLI.")
+console = Console()
+
+@app.command()
+def login(token: str = typer.Option(..., prompt="Please enter your Kolay API token", hide_input=True)):
+    """
+    Save your Kolay API token for future CLI use.
+    """
+    # Simple check if token works (maybe we can hit a profile endpoint later, for now we just save it)
+    set_config_value("api_token", token)
+    console.print(f"[green]Successfully saved API token to your configuration.[/green]")
+
+@app.command()
+def status():
+    """
+    Check if you are currently logged in.
+    """
+    token = get_api_token()
+    if token:
+        console.print(f"[green]You are logged in.[/green] (Token: ...{token[-4:] if len(token) > 4 else ''})")
+    else:
+        console.print("[red]You are NOT logged in.[/red] Please run [bold cyan]kolay auth login[/bold cyan].")

kolay_cli-0.1.0/src/kolay_cli/commands/leave.py

@@ -0,0 +1,204 @@
+import typer
+from typing import Optional
+from rich.console import Console
+from rich.table import Table
+import json
+
+from ..api import KolayClient, APIError
+
+app = typer.Typer(help="Manage leave records in Kolay.")
+console = Console()
+
+
+@app.command(name="list")
+def list_leaves(
+    status: str = typer.Option("approved", help="Filter by status: approved, waiting, rejected, cancelled"),
+    start_date: Optional[str] = typer.Option(None, help="Start date filter (YYYY-MM-DD HH:MM:SS). Defaults to Jan 1 of current year."),
+    end_date: Optional[str] = typer.Option(None, help="End date filter (YYYY-MM-DD HH:MM:SS). Defaults to Dec 31 of current year."),
+    person_id: Optional[str] = typer.Option(None, help="Filter by person ID"),
+    limit: int = typer.Option(100, help="Max number of records to return"),
+    include_inactive: bool = typer.Option(False, help="Include inactive employees"),
+):
+    """
+    List leave records. Filter by status, date range, or person.
+    """
+    from datetime import datetime
+
+    try:
+        client = KolayClient()
+
+        # API requires startDate and endDate — default to current year
+        now = datetime.now()
+        if not start_date:
+            start_date = f"{now.year}-01-01 00:00:00"
+        if not end_date:
+            end_date = f"{now.year}-12-31 23:59:59"
+
+        params: dict = {
+            "status": status,
+            "startDate": start_date,
+            "endDate": end_date,
+            "limit": limit,
+        }
+        if include_inactive:
+            params["include_inactive_employees"] = "true"
+        if person_id:
+            params["personId"] = person_id
+
+        console.print(f"Fetching leave records ({status}, {start_date[:10]} → {end_date[:10]})...")
+        response = client.get("v2/leave/list", params=params)
+
+        data = response.get("data", [])
+        if not data:
+            console.print("[yellow]No leave records found.[/yellow]")
+            return
+
+        table = Table(title="Leave Records")
+        table.add_column("ID", style="cyan", no_wrap=True)
+        table.add_column("Person", style="magenta")
+        table.add_column("Type", style="yellow")
+        table.add_column("Start", style="green")
+        table.add_column("End", style="green")
+        table.add_column("Status", style="bold")
+
+        for leave in data:
+            lid = str(leave.get("id", "N/A"))
+
+            person = leave.get("person", {})
+            if isinstance(person, dict):
+                person_name = person.get("name", "N/A")
+            else:
+                person_name = str(leave.get("personId", "N/A"))
+
+            leave_type = leave.get("type", leave.get("leaveType", {}))
+            type_name = leave_type.get("name", "N/A") if isinstance(leave_type, dict) else str(leave_type)
+
+            start = leave.get("startDate", "N/A")
+            end = leave.get("endDate", "N/A")
+            lstatus = leave.get("status", "N/A")
+
+            status_color = {
+                "approved": "[green]approved[/green]",
+                "waiting": "[yellow]waiting[/yellow]",
+                "rejected": "[red]rejected[/red]",
+                "cancelled": "[dim]cancelled[/dim]",
+            }.get(str(lstatus).lower(), lstatus)
+
+            table.add_row(lid, person_name, type_name, start, end, status_color)
+
+        console.print(table)
+    except APIError as e:
+        console.print(f"[bold red]API Error:[/bold red] {e}")
+        raise typer.Exit(1)
+
+
+@app.command(name="view")
+def view_leave(
+    leave_id: str = typer.Argument(..., help="ID of the leave record to view"),
+):
+    """
+    View the details of a specific leave record.
+    """
+    try:
+        client = KolayClient()
+        response = client.get(f"v2/leave/view/{leave_id}")
+
+        data = response.get("data", {})
+        if not data:
+            console.print(f"[yellow]Leave record '{leave_id}' not found or permission denied.[/yellow]")
+            return
+
+        console.print(f"\n[bold cyan]Leave Record ({leave_id})[/bold cyan]")
+        console.print(json.dumps(data, indent=2, ensure_ascii=False))
+    except APIError as e:
+        console.print(f"[bold red]API Error:[/bold red] {e}")
+        raise typer.Exit(1)
+
+
+@app.command(name="create")
+def create_leave(
+    person_id: Optional[str] = typer.Option(None, help="Person ID to create leave for"),
+    leave_type_id: Optional[str] = typer.Option(None, help="Leave type ID (auto-listed if omitted)"),
+    start_date: Optional[str] = typer.Option(None, help="Start datetime (YYYY-MM-DD HH:MM:SS)"),
+    end_date: Optional[str] = typer.Option(None, help="End datetime (YYYY-MM-DD HH:MM:SS)"),
+    comment: Optional[str] = typer.Option(None, help="Optional comment"),
+    replacement_person_id: Optional[str] = typer.Option(None, help="Optional replacement person ID"),
+):
+    """
+    Create a new leave record. Shows available leave types for the person.
+    """
+
+    try:
+        client = KolayClient()
+
+        # 1. Get person ID
+        if not person_id:
+            person_id = typer.prompt("Person ID")
+
+        # 2. Fetch available leave types for this person
+        if not leave_type_id:
+            console.print(f"\nFetching available leave types for person {person_id}...")
+            try:
+                status_resp = client.get(f"v2/person/leave-status/{person_id}")
+                leave_types = status_resp.get("data", [])
+            except APIError:
+                leave_types = []
+
+            if leave_types:
+                table = Table(title="Available Leave Types", header_style="bold cyan")
+                table.add_column("#", style="bold white", width=3)
+                table.add_column("Name")
+                table.add_column("Remaining", justify="right", style="green")
+                table.add_column("ID", style="dim")
+
+                for i, lt in enumerate(leave_types, 1):
+                    name = lt.get("name", "N/A")
+                    if lt.get("primary"):
+                        name = f"⭐ {name}"
+                    unused = lt.get("unused")
+                    remaining = str(unused) if unused is not None else "∞"
+                    table.add_row(str(i), name, remaining, lt.get("id", "N/A"))
+
+                console.print(table)
+
+                choice = typer.prompt("Pick a leave type (enter # or ID)")
+                # If user entered a number, map it
+                try:
+                    idx = int(choice) - 1
+                    if 0 <= idx < len(leave_types):
+                        leave_type_id = leave_types[idx].get("id")
+                    else:
+                        leave_type_id = choice
+                except ValueError:
+                    leave_type_id = choice
+            else:
+                leave_type_id = typer.prompt("Leave type ID")
+
+        # 3. Get dates
+        if not start_date:
+            start_date = typer.prompt("Start datetime (YYYY-MM-DD HH:MM:SS)")
+        if not end_date:
+            end_date = typer.prompt("End datetime (YYYY-MM-DD HH:MM:SS)")
+
+        # 4. Build payload and create
+        params: dict = {
+            "personId": person_id,
+            "leaveTypeId": leave_type_id,
+            "startDate": start_date,
+            "endDate": end_date,
+        }
+        if comment:
+            params["comment"] = comment
+        if replacement_person_id:
+            params["replacementPersonId"] = replacement_person_id
+
+        console.print("Creating leave record...")
+        response = client.post("v2/leave/create", data=params)
+
+        data = response.get("data", {})
+        leave_id = data.get("id", "N/A") if isinstance(data, dict) else "N/A"
+        console.print(f"[bold green]Leave record created![/bold green] ID: [cyan]{leave_id}[/cyan]")
+    except APIError as e:
+        console.print(f"[bold red]API Error:[/bold red] {e}")
+        raise typer.Exit(1)
+

kolay_cli-0.1.0/src/kolay_cli/commands/person.py

@@ -0,0 +1,340 @@
+import typer
+from typing import Optional
+from rich.console import Console
+from rich.table import Table
+import json
+
+from ..api import KolayClient, APIError
+
+app = typer.Typer(help="Manage person/employee records in Kolay.")
+console = Console()
+
+@app.command(name="list")
+def list_people(page: int = 1, status: str = "active"):
+    """
+    List people from the Kolay API.
+    By default, it lists active employees.
+    """
+    try:
+        client = KolayClient()
+        console.print(f"Fetching people... (Page {page}, Status: {status})")
+        # Kolay uses POST for v2/person/list
+        payload = {"page": page, "status": status}
+        response = client.post("v2/person/list", data=payload)
+        
+        data_resp = response.get("data", {})
+        if isinstance(data_resp, dict):
+            items = data_resp.get("items", [])
+        else:
+            items = data_resp
+
+        if not items:
+            console.print("[yellow]No people found.[/yellow]")
+            return
+
+        table = Table(title=f"Kolay Personnel ({status})")
+        table.add_column("ID", style="cyan", no_wrap=True)
+        table.add_column("Name", style="magenta")
+        table.add_column("Email", style="green")
+        table.add_column("Title", style="yellow")
+
+        for person in items:
+            # Person object depends on Kolay API response structure
+            # Usually has id, firstName, lastName, workEmail etc
+            # Fallback to get them gracefully
+            pid = str(person.get("id", "N/A"))
+            fname = person.get("firstName", person.get("first_name", ""))
+            lname = person.get("lastName", person.get("last_name", ""))
+            name = f"{fname} {lname}".strip() or person.get("name", "N/A")
+            
+            email = person.get("workEmail", person.get("email", "N/A"))
+            
+            # Extract title if present in unitList or another field
+            title = person.get("title", "N/A")
+            if title == "N/A" and "unitList" in person:
+                for unit in person.get("unitList", []):
+                    if unit.get("default") or unit.get("active"):
+                        for item in unit.get("items", []):
+                            if item.get("unitName") == "Unvan":
+                                title = item.get("unitItemName", title)
+
+            table.add_row(pid, name, email, title)
+
+        console.print(table)
+    except APIError as e:
+        console.print(f"[bold red]API Error:[/bold red] {e}")
+        raise typer.Exit(1)
+
+@app.command(name="view")
+def view_person(person_id: str = typer.Argument(..., help="ID of the person to view")):
+    """
+    View structured details of a specific person.
+    """
+    from rich.panel import Panel
+    from rich.columns import Columns
+    
+    try:
+        client = KolayClient()
+        response = client.get(f"v2/person/view/{person_id}")
+        
+        data = response.get("data", {})
+        person = data.get("person", data) if isinstance(data, dict) else data
+
+        if not person:
+            console.print(f"[yellow]Person {person_id} not found or permission denied.[/yellow]")
+            return
+            
+        # Basic Info
+        full_name = f"{person.get('firstName', '')} {person.get('lastName', '')}".strip()
+        status_val = person.get('status', 'N/A')
+        status_color = "green" if status_val == "active" else "red"
+        
+        console.print(f"\n[bold cyan]Person Profile:[/bold cyan] [bold white]{full_name}[/bold white] [[{status_color}]{status_val}[/{status_color}]]")
+        
+        # 1. Personal Info Table
+        personal_table = Table(show_header=False, box=None)
+        personal_table.add_row("[bold]ID:[/bold]", person.get("id"))
+        personal_table.add_row("[bold]Email:[/bold]", person.get("workEmail") or person.get("email") or "N/A")
+        personal_table.add_row("[bold]Phone:[/bold]", person.get("mobilePhone") or "N/A")
+        personal_table.add_row("[bold]Birthday:[/bold]", person.get("birthday") or "N/A")
+        personal_table.add_row("[bold]Gender:[/bold]", person.get("gender") or "N/A")
+        personal_table.add_row("[bold]ID Number:[/bold]", person.get("idNumber") or "N/A")
+        
+        # 2. Employment Table
+        employment_table = Table(show_header=False, box=None)
+        employment_table.add_row("[bold]Start Date:[/bold]", person.get("employmentStartDate") or "N/A")
+        
+        # Extract unit info
+        units = person.get("unitList", [])
+        active_unit = next((u for u in units if u.get("active") or u.get("default")), {})
+        if active_unit:
+            employment_table.add_row("[bold]Type:[/bold]", active_unit.get("employmentType", "N/A"))
+            for item in active_unit.get("items", []):
+                employment_table.add_row(f"[bold]{item.get('unitName')}:[/bold]", item.get("unitItemName"))
+
+        console.print(Columns([
+            Panel(personal_table, title="Personal Information", border_style="blue", expand=True),
+            Panel(employment_table, title="Employment", border_style="magenta", expand=True)
+        ]))
+
+        # 3. Custom Fields (Data List)
+        custom_data = person.get("dataList", [])
+        # Filter only non-empty values
+        non_empty_custom = [f for f in custom_data if f.get("value")]
+        
+        if non_empty_custom:
+            custom_table = Table(title="Custom Fields", box=None, show_header=True, header_style="bold cyan")
+            custom_table.add_column("Field")
+            custom_table.add_column("Value")
+            for field in non_empty_custom:
+                custom_table.add_row(field.get("fieldToken", "N/A"), str(field.get("value")))
+            
+            console.print(Panel(custom_table, border_style="dim"))
+
+    except APIError as e:
+        console.print(f"[bold red]API Error:[/bold red] {e}")
+        raise typer.Exit(1)
+
+@app.command(name="leave-status")
+def view_leave_status(person_id: str = typer.Argument(..., help="ID of the person to view leave status for")):
+    """
+    Get structured leave status and balances for a specific person.
+    """
+    try:
+        client = KolayClient()
+        response = client.get(f"v2/person/leave-status/{person_id}")
+        
+        data = response.get("data", [])
+        if not data:
+            console.print(f"[yellow]No leave status data for person {person_id}.[/yellow]")
+            return
+            
+        console.print(f"\n[bold cyan]Leave Status & Balances:[/bold cyan] (ID: {person_id})")
+        
+        table = Table(title=None, box=None, header_style="bold cyan")
+        table.add_column("Leave Type")
+        table.add_column("Paid?", justify="center")
+        table.add_column("Total", justify="right")
+        table.add_column("Used", justify="right")
+        table.add_column("Upcoming", justify="right")
+        table.add_column("Remaining", justify="right", style="bold green")
+        table.add_column("Next Accrual", justify="center")
+
+        def fmt(val):
+            if val is None: return "-"
+            try:
+                return str(int(val)) if float(val) == int(val) else str(val)
+            except (ValueError, TypeError):
+                return str(val)
+
+        for leave in data:
+            name = leave.get("name", "N/A")
+            if leave.get("primary"):
+                name = f"[bold white]⭐ {name}[/bold white]"
+            
+            is_paid = "[green]Yes[/green]" if leave.get("isPaid") else "[red]No[/red]"
+
+            used = leave.get("used", 0)
+            upcoming = leave.get("totalUpcoming", 0)
+            total = leave.get("total", leave.get("dayLimit", "∞"))
+            unused = leave.get("unused")
+            
+            # If unused is missing, try to calculate or show -
+            remaining = fmt(unused) if unused is not None else "∞"
+            
+            next_date = leave.get("nextAccrualDate", "-")
+            
+            table.add_row(
+                name,
+                is_paid,
+                fmt(total),
+                fmt(used),
+                fmt(upcoming),
+                remaining,
+                next_date
+            )
+
+        console.print(table)
+        console.print("\n[dim]Note: ⭐ indicates Primary Leave Type.[/dim]")
+
+    except APIError as e:
+        console.print(f"[bold red]API Error:[/bold red] {e}")
+        raise typer.Exit(1)
+        
+@app.command(name="terminate")
+def terminate_person(
+    person_id: str = typer.Argument(..., help="ID of the person to terminate"),
+    termination_date: Optional[str] = typer.Option(
+        None, 
+        help="Termination date (YYYY-MM-DD)",
+        show_default=False
+    ),
+    reason: Optional[str] = typer.Option(None, help="Termination reason")
+):
+    """
+    Terminate employment of a person.
+    """
+    from datetime import datetime
+    
+    try:
+        client = KolayClient()
+        # Pre-check if person exists and is active
+        console.print(f"Checking status for person {person_id}...")
+        resp = client.get(f"v2/person/view/{person_id}")
+        person_data = resp.get("data", {})
+        person = person_data.get("person", person_data) if isinstance(person_data, dict) else person_data
+
+        if not person:
+             console.print(f"[red]Error: Person {person_id} not found.[/red]")
+             return
+             
+        status = person.get("status")
+        if status != "active":
+            name = f"{person.get('firstName', '')} {person.get('lastName', '')}".strip()
+            console.print(f"[bold red]Stop![/bold red] {name or person_id} is currently [bold yellow]{status}[/bold yellow].")
+            console.print("Only active employees can be terminated.")
+            return
+            
+    except APIError as e:
+        console.print(f"[bold red]Error checking person status:[/bold red] {e}")
+        raise typer.Exit(1)
+    
+    # Get today's date as default
+    today = datetime.now().strftime("%Y-%m-%d")
+    
+    if termination_date is None:
+        termination_date = typer.prompt("Termination date", default=today)
+    
+    # Try to handle common formats like DD.MM.YYYY
+    if "." in termination_date:
+        try:
+            parts = termination_date.split(".")
+            if len(parts) == 3:
+                # Convert DD.MM.YYYY to YYYY-MM-DD
+                d, m, y = parts
+                termination_date = f"{y}-{m.zfill(2)}-{d.zfill(2)}"
+        except:
+            pass
+
+    REASON_CODES = {
+        "01": "Deneme süreli iş sözleşmesinin işverence feshi",
+        "02": "Deneme süreli iş sözleşmesinin işçi tarafından feshi",
+        "03": "Belirsiz süreli iş sözleşmesinin işçi tarafından feshi (İstifa)",
+        "04": "Belirsiz süreli iş sözleşmesinin işveren tarafından haklı sebep bildirilmeden feshi",
+        "05": "Belirli süreli iş sözleşmesinin sona ermesi",
+        "08": "Emeklilik (Yaşlılık) veya Toptan Ödeme Nedeniyle",
+        "09": "Maluliyet Nedeniyle",
+        "10": "Ölüm",
+        "11": "İş Kazası Sonucu Ölüm",
+        "12": "Askerlik",
+        "13": "Kadın İşçinin Evlenmesi",
+        "14": "Emeklilik İçin Yaş Dışında Diğer Şartların Tamamlanması",
+        "15": "Toplu İşçi Çıkarma",
+        "17": "İşyerinin Kapanması",
+        "18": "İşin Sona Ermesi",
+        "19": "Mevsimlik İşin Sona Ermesi",
+        "20": "Kampanya İşinin Sona Ermesi",
+        "21": "Statü Değişikliği",
+        "22": "Diğer Nedenler",
+        "23": "İşçi Kuruluşunda Görev Alınması",
+        "24": "Sözleşme Başlamadan Fesih",
+        "25": "İşçi Tarafından Zorunlu Nedenle Fesih",
+        "26": "İşçi Tarafından İşverenin Ahlak ve İyi Niyet Kurallarına Aykırı Davranışı Nedeniyle Fesih",
+        "27": "İşveren Tarafından İşçinin Ahlak ve İyi Niyet Kurallarına Aykırı Davranışı Nedeniyle Fesih",
+        "28": "Sağlık Nedeniyle İşçi Tarafından Fesih",
+        "29": "Sağlık Nedeniyle İşveren Tarafından Fesih",
+        "30": "Vize Süresinin Sona Ermesi",
+        "31": "Borçlar Kanunu, Sendikalar Kanunu, Grev ve Lokavt Kanunu Kapsamında Fesih",
+        "32": "4046 Sayılı Kanun Kapsamında Özelleştirme Nedeniyle Fesih",
+        "33": "Gazeteci Tarafından Sözleşmenin Feshi",
+        "34": "İşyerinin Devri, İşin veya İşyerinin Niteliğinin Değişmesi Nedeniyle Fesih",
+        "36": "KHK ile Kamu Görevinden Çıkarılma",
+        "37": "KHK ile Kamu Görevinden İade Edilme",
+        "40": "696 Sayılı KHK ile Kamu İşçiliğine Geçiş",
+        "41": "696 Sayılı KHK ile Kamu İşçiliğine Geçişte Başarısızlık",
+    }
+
+    if reason is None:
+        console.print("\n[bold cyan]Turkish Termination (SGK) Reason Codes:[/bold cyan]")
+        codes_table = Table(box=None, header_style="bold magenta", padding=(0, 2))
+        codes_table.add_column("Code", width=4)
+        codes_table.add_column("Description")
+        
+        # Show top common codes first or just a selection
+        for c in ["01", "03", "04", "05", "12", "13", "17", "22", "27"]:
+            codes_table.add_row(c, REASON_CODES[c])
+        codes_table.add_row("..", "Enter 'all' to see all codes")
+        
+        console.print(codes_table)
+        
+        reason_code = typer.prompt("Reason Code", default="03")
+        if reason_code.lower() == "all":
+            full_table = Table(title="All Reason Codes", header_style="bold magenta")
+            full_table.add_column("Code")
+            full_table.add_column("Description")
+            for c, desc in sorted(REASON_CODES.items()):
+                full_table.add_row(c, desc)
+            console.print(full_table)
+            reason_code = typer.prompt("Reason Code", default="03")
+            
+        details = typer.prompt("Details", default=REASON_CODES.get(reason_code, ""))
+    else:
+        reason_code = "03"
+        details = reason
+
+    try:
+        client = KolayClient()
+        payload = {
+            "personId": person_id,
+            "date": termination_date,
+            "reasonCode": reason_code,
+            "details": details
+        }
+        
+        console.print(f"Terminating person {person_id} with date [bold cyan]{termination_date}[/bold cyan] and reason code [bold magenta]{reason_code}[/bold magenta]...")
+        client.post("v2/person/terminate", data=payload)
+        console.print("[bold green]Success![/bold green] Operation completed.")
+        
+    except APIError as e:
+        console.print(f"[bold red]API Error:[/bold red] {e}")
+        raise typer.Exit(1)

kolay_cli-0.1.0/src/kolay_cli/config.py

@@ -0,0 +1,54 @@
+import json
+import os
+from pathlib import Path
+from typing import Optional
+
+CONFIG_DIR = Path.home() / ".config" / "kolay"
+CONFIG_FILE = CONFIG_DIR / "config.json"
+
+def get_config_value(key: str) -> Optional[str]:
+    """Get a value from the config file or environment variables."""
+    # Environment variables have precedence
+    env_val = os.getenv(f"KOLAY_{key.upper()}")
+    if env_val:
+        return env_val
+
+    if not CONFIG_FILE.exists():
+        return None
+
+    try:
+        with open(CONFIG_FILE, "r") as f:
+            data = json.load(f)
+            return data.get(key)
+    except Exception:
+        return None
+
+def set_config_value(key: str, value: str):
+    """Set a value in the config file and ensure restricted permissions."""
+    CONFIG_DIR.mkdir(parents=True, exist_ok=True)
+    
+    data = {}
+    if CONFIG_FILE.exists():
+        try:
+            with open(CONFIG_FILE, "r") as f:
+                data = json.load(f)
+        except Exception:
+            pass
+            
+    data[key] = value
+    
+    # Create or overwrite file with restricted permissions
+    # We use a temp file or just write it then chmod
+    with open(CONFIG_FILE, "w") as f:
+        json.dump(data, f, indent=4)
+    
+    try:
+        os.chmod(CONFIG_FILE, 0o600)
+    except Exception:
+        pass # Fallback for environments where chmod might fail
+
+def get_api_token() -> Optional[str]:
+    return get_config_value("api_token")
+
+def get_base_url() -> str:
+    return get_config_value("base_url") or "https://api.kolayik.com"

kolay_cli-0.1.0/src/kolay_cli.egg-info/PKG-INFO

@@ -0,0 +1,159 @@
+Metadata-Version: 2.4
+Name: kolay-cli
+Version: 0.1.0
+Summary: Command-line interface for Kolay IK (https://apidocs.kolayik.com)
+Author: Tunc Aucer
+License: MIT
+Project-URL: Homepage, https://github.com/ezapmar/kolay-cli
+Project-URL: Repository, https://github.com/ezapmar/kolay-cli
+Project-URL: Issues, https://github.com/ezapmar/kolay-cli/issues
+Keywords: kolay,hr,cli,kolayik,human-resources
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: License :: OSI Approved :: MIT License
+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 :: Office/Business
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer>=0.9.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: rich>=13.4.2
+Dynamic: license-file
+
+# Kolay CLI
+
+```
+                        +************
+                       +*+        **+
+                      +*+       +*+      %%               #%%
+                     +*+       +*+       %%   *#*  #%%#   #%%   #%%#*#*+**    **+
+                   +**+       +*+        %% #%%* %%%##%%% #%% %%%#*%%%% %%#  #%%
+                    **+      +**+        %%%%#  %%#    %%##%%#%%    %%%  %%##%%#
+                     +*+    +*++*+       %%#%%# %%%    %%##%%*%%    #%%   %%%%#
+                      +*+  **   +*+      %%  #%% *%%%%%%# #%% #%%%%%%%%   *%%%
+                       +*+**      **+                                     #%%
+                        +************                                   #%%%
+```
+
+A powerful, user-friendly command-line interface for the [Kolay IK API](https://apidocs.kolayik.com). Manage your HR operations directly from the terminal.
+
+## ✨ Features
+
+| Module | Commands | Description |
+|--------|----------|-------------|
+| **Auth** | `login`, `status` | Securely store and manage your API token |
+| **Person** | `list`, `view`, `leave-status`, `terminate` | List employees, view structured profiles, check leave balances, terminate with SGK codes |
+| **Leave** | `list`, `view`, `create` | List leave records, view details, create leaves with interactive type picker |
+
+### Highlights
+
+- 🎨 **Rich terminal output** — Structured tables, panels, and color-coded statuses
+- 🔐 **Secure token storage** — Config file with restricted permissions (`0600`)
+- 🇹🇷 **Turkish HR aware** — SGK termination codes, DD.MM.YYYY date format support
+- ⚡ **Smart prompts** — Leave type picker, today's date defaults, active employee pre-checks
+
+## 📦 Installation
+
+### Using pipx (Recommended)
+```bash
+pipx install kolay-cli
+```
+
+### From source
+```bash
+git clone https://github.com/ezapmar/kolay-cli.git
+cd kolay-cli
+pip install -e .
+```
+
+## 🚀 Quick Start
+
+### 1. Authenticate
+Generate an API token from [Kolay Developer Settings](https://app.kolayik.com/settings/developer-settings), then:
+```bash
+kolay auth login
+```
+
+### 2. List your employees
+```bash
+kolay person list
+```
+
+### 3. View someone's profile
+```bash
+kolay person view <person-id>
+```
+
+### 4. Check leave balances
+```bash
+kolay person leave-status <person-id>
+```
+
+### 5. Create a leave request
+```bash
+kolay leave create
+```
+The CLI will interactively show available leave types and let you pick by number.
+
+## 📖 Command Reference
+
+### Auth
+```bash
+kolay auth login          # Save your API token (prompted securely)
+kolay auth status         # Check if you're logged in
+```
+
+### Person
+```bash
+kolay person list                          # List active employees
+kolay person list --status inactive        # List inactive employees
+kolay person list --page 2                 # Paginate results
+kolay person view <id>                     # Structured profile view
+kolay person leave-status <id>             # Leave balances table
+kolay person terminate <id>                # Terminate with SGK reason codes
+```
+
+### Leave
+```bash
+kolay leave list                           # List approved leaves (current year)
+kolay leave list --status waiting          # List pending leaves
+kolay leave list --person-id <id>          # Filter by person
+kolay leave list --start-date "2025-01-01 00:00:00" --end-date "2025-12-31 23:59:59"
+kolay leave view <leave-id>               # View leave record details
+kolay leave create                         # Interactive leave creation
+```
+
+## ⚙️ Configuration
+
+The CLI stores its configuration at `~/.config/kolay/config.json` with restricted file permissions.
+
+You can also use environment variables (they take precedence):
+```bash
+export KOLAY_API_TOKEN="your-token-here"
+export KOLAY_BASE_URL="https://api.kolayik.com"  # optional
+```
+
+## 🛠 Development
+
+```bash
+# Clone and setup
+git clone https://github.com/ezapmar/kolay-cli.git
+cd kolay-cli
+python -m venv .venv
+source .venv/bin/activate   # or .venv\Scripts\activate on Windows
+pip install -e .
+
+# Run
+kolay --help
+```
+
+## 📄 License
+
+This project is licensed under the [MIT License](LICENSE) — use it freely, modify it, share it. See the `LICENSE` file for details.

kolay_cli-0.1.0/src/kolay_cli.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+pyproject.toml
+src/kolay_cli/__init__.py
+src/kolay_cli/api.py
+src/kolay_cli/cli.py
+src/kolay_cli/config.py
+src/kolay_cli.egg-info/PKG-INFO
+src/kolay_cli.egg-info/SOURCES.txt
+src/kolay_cli.egg-info/dependency_links.txt
+src/kolay_cli.egg-info/entry_points.txt
+src/kolay_cli.egg-info/requires.txt
+src/kolay_cli.egg-info/top_level.txt
+src/kolay_cli/commands/__init__.py
+src/kolay_cli/commands/auth.py
+src/kolay_cli/commands/leave.py
+src/kolay_cli/commands/person.py

kolay_cli-0.1.0/src/kolay_cli.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kolay_cli-0.1.0/src/kolay_cli.egg-info/entry_points.txt

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

kolay_cli-0.1.0/src/kolay_cli.egg-info/requires.txt

@@ -0,0 +1,3 @@
+typer>=0.9.0
+requests>=2.31.0
+rich>=13.4.2

kolay_cli-0.1.0/src/kolay_cli.egg-info/top_level.txt

@@ -0,0 +1 @@
+kolay_cli