zijizhang-cli 0.0.11__tar.gz

zijizhang_cli-0.0.11/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.4
+Name: zijizhang-cli
+Version: 0.0.11
+Summary: Cli tool for zijizhang
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: annotated-doc==0.0.4
+Requires-Dist: anyio==4.12.1
+Requires-Dist: certifi==2026.2.25
+Requires-Dist: click==8.1.8
+Requires-Dist: exceptiongroup==1.3.1
+Requires-Dist: h11==0.16.0
+Requires-Dist: httpcore==1.0.9
+Requires-Dist: httpx==0.28.1
+Requires-Dist: idna==3.11
+Requires-Dist: markdown-it-py==3.0.0
+Requires-Dist: mdurl==0.1.2
+Requires-Dist: Pygments==2.20.0
+Requires-Dist: rich==14.3.3
+Requires-Dist: shellingham==1.5.4
+Requires-Dist: typer==0.23.2
+Requires-Dist: typing_extensions==4.15.0
+
+# zjz-cli
+
+Cli tool for zjz
+
+## Requirements
+
+- Python 3 or higher – [Download Python](https://www.python.org/downloads/)
+
+## Installation
+
+It is **strongly recommended** to install this tool inside a Python virtual environment to avoid dependency conflicts with other Python projects on your system.
+
+You can choose **one** of the following installation methods:
+
+- Use Python's built-in `venv`
+- Use `uv`
+
+You only need to follow one method, not both.
+
+### Option 1: Install with `venv`
+
+#### Step 1: Create a virtual environment
+
+Open your terminal and choose a location for the environment. A common practice is to place it in your home directory as a hidden folder (e.g., `~/.my-cli-tool-env`). Run:
+
+```shell
+python3 -m venv ~/.my-cli-tool-env
+```
+
+#### Step 2: Activate the virtual environment
+
+- Linux / macOS:
+
+```shell
+source ~/.my-cli-tool-env/bin/activate
+```
+
+- Windows (Command Prompt):
+
+```bash
+.my-cli-tool-env\Scripts\activate.bat
+```
+
+- Windows (PowerShell):
+
+```bash
+.my-cli-tool-env\Scripts\Activate.ps1
+```
+
+You will see (`.my-cli-tool-env`) appear at the beginning of your command prompt, indicating the virtual environment is active.
+
+#### Step 3: Install the tool
+
+With the virtual environment activated, install the package from PyPI:
+
+```shell
+pip install --upgrade zjz-cli
+```
+
+That's it! The CLI command `zjz-cli` is now available inside this virtual environment.
+
+### Option 2: Install with `uv`
+
+If you prefer using `uv`, you can create and manage the virtual environment with it instead.
+
+#### Step 1: Install `uv`
+
+Follow the official guide to install `uv`:
+
+[Install uv](https://docs.astral.sh/uv/getting-started/installation/)
+
+#### Step 2: Create a virtual environment
+
+```shell
+uv venv ~/.my-cli-tool-env
+```
+
+#### Step 3: Activate the virtual environment
+
+- Linux / macOS:
+
+```shell
+source ~/.my-cli-tool-env/bin/activate
+```
+
+- Windows (Command Prompt):
+
+```bash
+.my-cli-tool-env\Scripts\activate.bat
+```
+
+- Windows (PowerShell):
+
+```bash
+.my-cli-tool-env\Scripts\Activate.ps1
+```
+
+#### Step 4: Install the tool
+
+With the virtual environment activated, install the package with `uv`:
+
+```shell
+uv pip install --upgrade zjz-cli
+```
+
+That's it! The CLI command `zjz-cli` is now available inside this virtual environment.
+
+### Usage
+
+Once the virtual environment is activated, you can run the tool:
+
+```shell
+zjz-cli --help
+```
+
+## Why a virtual environment?
+
+Using a virtual environment prevents version clashes between Python packages required by this tool and other Python applications on your system. It also keeps your global Python installation clean. For more background, see [Python Virtual Environments: A Primer](https://realpython.com/python-virtual-environments-a-primer/).

zijizhang_cli-0.0.11/README.md

@@ -0,0 +1,118 @@
+# zjz-cli
+
+Cli tool for zjz
+
+## Requirements
+
+- Python 3 or higher – [Download Python](https://www.python.org/downloads/)
+
+## Installation
+
+It is **strongly recommended** to install this tool inside a Python virtual environment to avoid dependency conflicts with other Python projects on your system.
+
+You can choose **one** of the following installation methods:
+
+- Use Python's built-in `venv`
+- Use `uv`
+
+You only need to follow one method, not both.
+
+### Option 1: Install with `venv`
+
+#### Step 1: Create a virtual environment
+
+Open your terminal and choose a location for the environment. A common practice is to place it in your home directory as a hidden folder (e.g., `~/.my-cli-tool-env`). Run:
+
+```shell
+python3 -m venv ~/.my-cli-tool-env
+```
+
+#### Step 2: Activate the virtual environment
+
+- Linux / macOS:
+
+```shell
+source ~/.my-cli-tool-env/bin/activate
+```
+
+- Windows (Command Prompt):
+
+```bash
+.my-cli-tool-env\Scripts\activate.bat
+```
+
+- Windows (PowerShell):
+
+```bash
+.my-cli-tool-env\Scripts\Activate.ps1
+```
+
+You will see (`.my-cli-tool-env`) appear at the beginning of your command prompt, indicating the virtual environment is active.
+
+#### Step 3: Install the tool
+
+With the virtual environment activated, install the package from PyPI:
+
+```shell
+pip install --upgrade zjz-cli
+```
+
+That's it! The CLI command `zjz-cli` is now available inside this virtual environment.
+
+### Option 2: Install with `uv`
+
+If you prefer using `uv`, you can create and manage the virtual environment with it instead.
+
+#### Step 1: Install `uv`
+
+Follow the official guide to install `uv`:
+
+[Install uv](https://docs.astral.sh/uv/getting-started/installation/)
+
+#### Step 2: Create a virtual environment
+
+```shell
+uv venv ~/.my-cli-tool-env
+```
+
+#### Step 3: Activate the virtual environment
+
+- Linux / macOS:
+
+```shell
+source ~/.my-cli-tool-env/bin/activate
+```
+
+- Windows (Command Prompt):
+
+```bash
+.my-cli-tool-env\Scripts\activate.bat
+```
+
+- Windows (PowerShell):
+
+```bash
+.my-cli-tool-env\Scripts\Activate.ps1
+```
+
+#### Step 4: Install the tool
+
+With the virtual environment activated, install the package with `uv`:
+
+```shell
+uv pip install --upgrade zjz-cli
+```
+
+That's it! The CLI command `zjz-cli` is now available inside this virtual environment.
+
+### Usage
+
+Once the virtual environment is activated, you can run the tool:
+
+```shell
+zjz-cli --help
+```
+
+## Why a virtual environment?
+
+Using a virtual environment prevents version clashes between Python packages required by this tool and other Python applications on your system. It also keeps your global Python installation clean. For more background, see [Python Virtual Environments: A Primer](https://realpython.com/python-virtual-environments-a-primer/).

zijizhang_cli-0.0.11/app/api/zjz_api.py

@@ -0,0 +1,267 @@
+from app.api.zjz_req import zjz_req
+from pathlib import Path
+
+
+def sms_verify_code(phone: str) -> dict:
+    return zjz_req.get_client().post_json('login/sms', {
+        'phone': phone,
+    })
+
+
+def verify_sms_code(phone: str, code: str) -> dict:
+    return zjz_req.get_client().post_json('login/sms-2-token', {
+        'phone': phone,
+        'sms': code,
+    })
+
+
+def get_employee_list(uid: str = None, keyword: str = '', page: int = 1) -> dict:
+    if not page or page < 1:
+        page = 1
+    return zjz_req.get_client().get('ryxx', params={
+        'uid': uid,
+        'keyword': keyword,
+        'page': page
+    })
+
+
+def add_employee(uid: str, data: dict) -> dict:
+    data['uid'] = uid
+    return zjz_req.get_client().post_json('ryxx', data)
+
+
+def update_employee(employee_id: str, data: dict) -> dict:
+    return zjz_req.get_client().put('ryxx', {
+        'id': employee_id,
+        'data': data,
+    })
+
+
+def get_payroll(uid: str, year: int, month: int) -> dict:
+    month_str = f"{year}-{month:02d}"
+    return zjz_req.get_client().get('payroll', params={
+        'uid': uid,
+        'month': month_str
+    })
+
+
+def get_payroll_creation_status(uid: str, year: int, month: int) -> dict:
+    month_str = f"{year}-{month:02d}"
+    return zjz_req.get_client().get('payroll/creation-status', params={
+        'uid': uid,
+        'month': month_str
+    })
+
+
+def get_preview_payroll(uid: str, year: int, month: int) -> dict:
+    month_str = f"{year}-{month:02d}"
+    return zjz_req.get_client().get('payroll/preview', params={
+        'uid': uid,
+        'month': month_str
+    })
+
+
+def create_payroll(uid: str, year: int, month: int, data: list) -> dict:
+    month_str = f"{year}-{month:02d}"
+    return zjz_req.get_client().post_json('payroll', {
+        'uid': uid,
+        'month': month_str,
+        'data': data
+    })
+
+
+def get_sales_invoice_data_list(uid: str, current: int = 1, invoice_number: str = '', invoice_date_begin: str = '', invoice_date_end: str = '', status: str = '') -> dict:
+    return zjz_req.get_client().get('invoice/sales_invoice_data_list', params={
+        'uid': uid,
+        'current': current,
+        'invoice_number': invoice_number,
+        'invoice_date_begin': invoice_date_begin,
+        'invoice_date_end': invoice_date_end,
+        'status': status,
+    })
+
+
+def set_month_no_sales_invoice(uid: str, year: int, month: int) -> dict:
+    return zjz_req.get_client().post_json('invoice/set_month_no_sales_invoice', {
+        'uid': uid,
+        'year': year,
+        'month': month,
+    })
+
+
+def get_income_invoice_data_list(uid: str, current: int = 1, invoice_number: str = '', invoice_date_begin: str = '', invoice_date_end: str = '', status: str = '') -> dict:
+    return zjz_req.get_client().get('invoice/income_invoice_data_list', params={
+        'uid': uid,
+        'current': current,
+        'invoice_number': invoice_number,
+        'invoice_date_begin': invoice_date_begin,
+        'invoice_date_end': invoice_date_end,
+        'status': status,
+    })
+
+
+def set_month_no_invoice(uid: str, year: int, month: int) -> dict:
+    return zjz_req.get_client().post_json('invoice/set_month_no_invoice', {
+        'uid': uid,
+        'year': year,
+        'month': month,
+    })
+
+
+def invoice_can_choose_use_list(uid: str, goods_name: str, total_tax_price: str, total_money: str) -> dict:
+    return zjz_req.get_client().get('invoice/invoice_can_choose_use_list', params={
+        'uid': uid,
+        'goods_name': goods_name,
+        'total_tax_price': total_tax_price,
+        'total_money': total_money,
+    })
+
+
+def invoice_choose_use(uid: str, invoice_id: int, category: str, is_pay: str, payee: str) -> dict:
+    return zjz_req.get_client().post_json('invoice/invoice_choose_use', {
+        'uid': uid,
+        'invoice_id': invoice_id,
+        'category': category,
+        'is_pay': is_pay,
+        'payee': payee,
+    })
+
+
+def upload_invoice_file(uid: str, file_path: str) -> dict:
+    p = Path(file_path)
+    suffix = p.suffix.lower()
+    content_type = 'application/octet-stream'
+    if suffix == '.pdf':
+        content_type = 'application/pdf'
+    elif suffix == '.ofd':
+        content_type = 'application/ofd'
+
+    with p.open('rb') as f:
+        return zjz_req.get_client().post_file('invoice/upload_invoice_file', files={
+            'file': (p.name, f, content_type),
+        }, data={
+            'uid': uid,
+        })
+
+
+def invoice_file_list(uid: str, current: int = 1) -> dict:
+    if not current or current < 1:
+        current = 1
+    params = {
+        'current': current,
+        'uid': uid,
+    }
+    return zjz_req.get_client().get('invoice/invoice_file_list', params=params)
+
+
+def get_todo_list(uid: str) -> dict:
+    params = {
+        'uid': uid,
+    }
+    return zjz_req.get_client().get('todo-list', params=params)
+
+
+def before_set_month_audited(year: int, month: int, uid: str) -> dict:
+    params = {
+        'year': year,
+        'month': month,
+        'uid': uid,
+    }
+    return zjz_req.get_client().get('audit/before_set_month_audited', params=params)
+
+
+def set_month_audited(year: int, month: int, uid: str) -> dict:
+    payload = {
+        'year': year,
+        'month': month,
+        'uid': uid,
+    }
+    return zjz_req.get_client().post_json('audit/set_month_audited', payload)
+
+
+def get_bank_bill_data_list(uid: str, current: int = 1, date_begin: str = '', date_end: str = '') -> dict:
+    params = {
+        'current': current,
+        'date_begin': date_begin,
+        'date_end': date_end,
+        'uid': uid,
+    }
+    return zjz_req.get_client().get('bank/bill_data_list', params=params)
+
+
+def choose_bank_use(uid: str, bill_id: int, rule_text: str) -> dict:
+    payload = {
+        'id': bill_id,
+        'rule_text': rule_text,
+        'uid': uid,
+    }
+    return zjz_req.get_client().post_json('bank/bank_bill_choose_use', payload)
+
+
+def set_month_bank_no_water(uid: str, year: int, month: int) -> dict:
+    payload = {
+        'year': year,
+        'month': month,
+        'uid': uid,
+    }
+    return zjz_req.get_client().post_json('bank/set_month_no_water', payload)
+
+
+def support_bank_list() -> dict:
+    return zjz_req.get_client().get('bank/support_bank_list')
+
+
+def bank_account_number_list(uid: str) -> dict:
+    params = {
+        'uid': uid,
+    }
+    return zjz_req.get_client().get('bank/bank_account_number_list', params=params)
+
+
+def add_bank_account_number(uid: str, bank_id: int, bank_number: str) -> dict:
+    payload = {
+        'bank_id': bank_id,
+        'bank_number': bank_number,
+        'uid': uid,
+    }
+    return zjz_req.get_client().post_json('bank/add_bank_account_number', payload)
+
+
+def del_bank_account_number(uid: str, bank_id: int, bank_number: str) -> dict:
+    payload = {
+        'bank_id': bank_id,
+        'bank_number': bank_number,
+        'uid': uid,
+    }
+    return zjz_req.get_client().post_json('bank/del_bank_account_number', payload)
+
+
+def bank_file_list(uid: str, current: int = 1) -> dict:
+    if not current or current < 1:
+        current = 1
+    params = {
+        'current': current,
+        'uid': uid,
+    }
+    return zjz_req.get_client().get('bank/bank_file_list', params=params)
+
+
+def upload_bank_file(uid: str, file_path: str, file_type: str, bank_account_number_id: int, billing_cycle: str) -> dict:
+    p = Path(file_path)
+    suffix = p.suffix.lower()
+    content_type = 'application/octet-stream'
+    if suffix == '.pdf':
+        content_type = 'application/pdf'
+    elif suffix == '.xls':
+        content_type = 'application/vnd.ms-excel'
+    elif suffix == '.xlsx':
+        content_type = 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet'
+    with p.open('rb') as f:
+        return zjz_req.get_client().post_file('bank/upload_bank_file', files={
+            'file': (p.name, f, content_type),
+        }, data={
+            'uid': uid,
+            'file_type': file_type,
+            'bank_account_number_id': str(bank_account_number_id),
+            'billing_cycle': billing_cycle,
+        })

zijizhang_cli-0.0.11/app/api/zjz_req.py

@@ -0,0 +1,22 @@
+from app.service.config_manager import cfg_mgr
+from app.util.http_client import HttpClient
+
+
+class ZjzReq:
+    def __init__(self):
+        self.headers = {}
+        self.base_url: str = "https://www.zijizhang.com/ai/skill"
+        self.client = None
+
+    def get_client(self):
+        auth_token = self.headers.get('Authorization')
+        if not auth_token:
+            token = cfg_mgr.get_config('token')
+            if token:
+                self.headers['Authorization'] = f'Bearer {token}'
+                self.client = None
+        if not self.client:
+            self.client = HttpClient(base_url=self.base_url, headers=self.headers)
+        return self.client
+
+zjz_req = ZjzReq()

zijizhang_cli-0.0.11/app/module/account.py

@@ -0,0 +1,59 @@
+import typer
+
+from app.service.account_service import AccountService
+from app.util import echo_util
+
+account_app = typer.Typer()
+
+
+@account_app.command(
+    name='get_sms_verify_code',
+    help='获取登录的短信验证码',
+    no_args_is_help=True,
+    epilog="""使用示例
+
+zijizhang-cli account get_sms_verify_code 17199999999""")
+def get_sms_verify_code(phone: str = typer.Argument(..., help='自记账的登录手机号')):
+    service = AccountService()
+    res = service.sms_verify_code(phone)
+    echo_util.echo_http_res(res)
+
+
+@account_app.command(
+    name='verify_sms_code',
+    help='通过短信验证码登录',
+    no_args_is_help=True,
+    epilog="""使用示例
+
+zijizhang-cli account verify_sms_code 17199999999 5799""")
+def verify_sms_code(
+        phone: str = typer.Argument(..., help='手机号'),
+        code: str = typer.Argument(..., help='短信验证码')):
+    service = AccountService()
+    res = service.sms_code_login(phone, code)
+    echo_util.echo_http_res(res)
+
+
+@account_app.command(
+    name='get_switchable_users',
+    help='获取可切换的公司列表',
+    epilog="""使用示例
+
+zijizhang-cli account get_switchable_users""")
+def get_switchable_users():
+    service = AccountService()
+    res = service.get_switchable_user()
+    echo_util.echo_http_res(res)
+
+
+@account_app.command(
+    name='switch_to',
+    help='切换公司',
+    no_args_is_help=True,
+    epilog="""使用示例
+
+zijizhang-cli account switch_to 123451c07f47435e12a34111""")
+def switch_to(uid: str = typer.Argument(..., help='公司唯一标识uid')):
+    service = AccountService()
+    res = service.switch_to(uid)
+    echo_util.echo_http_res(res)