Skip to main content

saizeriya

PyPI Release Package CI

ghcr latest ghcr size

Unofficial Saizeriya Client, inspired by saizeriya.js

Installation

# from mise
mise use pipx:saizeriya               # CLI only
mise use 'pipx:saizeriya[extras=tui]' # CLI+TUI

# from pipx
pipx install saizeriya        # CLI only
pipx install 'saizeriya[tui]' # CLI+TUI

# from pip
pip install saizeriya        # CLI only
pip install 'saizeriya[tui]' # CLI+TUI

Usage

CLI

saizeriya --help
$ saizeriya --help
usage: saizeriya [-h] <command> ...

Saizeriya order CLI.

positional arguments:
  <command>
    start       Start a new ordering session
    use         Resume a saved session
    list        List saved sessions
    rm          Remove a saved session
    tui         Launch the Textual TUI (requires the 'tui' extra)
    fetch-menu  Crawl menu data for shops

options:
  -h, --help    show this help message and exit

available commands in start/use REPL:
   state
    Show current session state
   people <count>
    Set number of people at the table
   lookup <code>
    Look up an item by code
   add [--mod-id MOD_ID] [--mod-count MOD_COUNT] [--reorder] <code> [<count>]
    Add an item to the cart
   cart
    Show cart contents
   cart-page
    Navigate to the cart page
   remove <index>
    Remove an item from the cart by index
   submit
    Submit the current order
   account
    Show account summary
   receipt
    Show receipt
   call [{staff,dessert}]
    Call staff or dessert service
   menu
    Navigate to the menu page
   history
    Navigate to order history
   reorder <code>
    Reorder a previously ordered item
   alcohol
    Confirm alcohol order
   check {order,last,midnight}
    Check order/last-order/midnight status
   help
    Show this help message
   exit
    Exit the REPL
   quit
    Exit the REPL

To start session named lunch and ener REPL:

saizeriya start lunch "https://ioes03.saizeriya.co.jp/saizeriya3/?..."

TUI

# on the terminal
saizeriya tui

# on the web
saizeriya tui --serve

Docker

docker run --rm -it ghcr.io/eggplants/saizeriya

Library

import saizeriya

# check version
print(saizeriya.__version__)

# create client instance
client = saizeriya.SaizeriyaClient(
  qr_url_source="https://ioes03.saizeriya.co.jp/saizeriya3/?...",
  people_count=2,
)

# add new item to cart
in_cart_items = client.add_item('1202').cart

# check in-cart items
print(in_cart_items)

Mock server (saizeriya._mock)

pip install saizeriya[mock]
saizeriya-mock-server

Then, visit http://localhost:8080/.

License

MIT License

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

saizeriya-0.3.0.tar.gz (1.8 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

saizeriya-0.3.0-py3-none-any.whl (1.8 MB view details)

Uploaded Python 3

File details

Details for the file saizeriya-0.3.0.tar.gz.

File metadata

  • Download URL: saizeriya-0.3.0.tar.gz
  • Upload date:
  • Size: 1.8 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for saizeriya-0.3.0.tar.gz
Algorithm Hash digest
SHA256 4a83e878c1ba466485701234e7a4a8cde75f8ea863f2aab93bc22a03af9e8fd8
MD5 fc73796908b716300f461eaa4b39d488
BLAKE2b-256 596ba96ffcefbf6d29e586a547832183e39e094032fcd405a210b4d8f8bb5132

See more details on using hashes here.

File details

Details for the file saizeriya-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: saizeriya-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 1.8 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for saizeriya-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3bdcdf265e6303a03c2b75b33ec0703ae80860b6d51eab6f96845528ddca738d
MD5 af8a0e564a522c42c5329dab3e2756d1
BLAKE2b-256 0ea26caaec20af407707eeb3a771be79bfdc3f7c0d633752e2ef4ba01aeb1e03

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 files

0.2.0

2 files

0.1.5

2 files

0.1.4

2 files

0.1.3

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

0.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page