jposta

Crates.iojposta
lib.rsjposta
version
sourcesrc
created_at2024-12-03 14:03:45.670497
updated_at2024-12-03 14:03:45.670497
descriptionA fast and intuitive Terminal User Interface (TUI) tool for searching Japanese postal codes and addresses
homepage
repositoryhttps://github.com/nwiizo/jposta
max_upload_size
id1470012
Cargo.toml error:TOML parse error at line 17, column 1 | 17 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include`
size0
Shuya Motouchi (nwiizo)

documentation

https://docs.rs/jposta

README

jposta ๐Ÿ“ฎ

A fast and intuitive Terminal User Interface (TUI) tool for searching Japanese postal codes and addresses. ๐Ÿ—พ

jposta_demo

โœจ Features

  • ๐Ÿ” Real-time postal code lookup with partial matching
  • ๐Ÿˆฏ Address search with Japanese text (kanji/kana)
  • โŒจ๏ธ Interactive TUI with keyboard navigation
  • ๐Ÿ“œ Scrollable results with formatting
  • ๐Ÿ”„ Dual search modes

๐Ÿš€ Installation

cargo install jposta

๐ŸŽฎ Usage

Start the application:

jposta

โŒจ๏ธ Keyboard Controls

  • Tab: Toggle between postal code and address search modes
  • โ†‘/โ†“: Scroll through results
  • Backspace: Delete input
  • Esc: Exit

๐Ÿ” Search Modes

  1. Postal Code Search ๐Ÿ“ซ

    • Enter numbers (e.g., "100" for all codes starting with 100)
    • Results show full addresses with kana readings
  2. Address Search ๐Ÿข

    • Enter text in Japanese (e.g., "ๆธ‹่ฐท" or "ใ‚ทใƒ–ใƒค")
    • Matches any part of the address

๐Ÿ“ Example Output

ใ€’1000001
ๆฑไบฌ้ƒฝๅƒไปฃ็”ฐๅŒบๅƒไปฃ็”ฐ
ใƒˆใ‚ฆใ‚ญใƒงใ‚ฆใƒˆใƒใƒจใƒ€ใ‚ฏใƒใƒจใƒ€

๐Ÿ› ๏ธ Building from Source

git clone https://github.com/nwiizo/jposta
cd jposta
cargo build --release

๐Ÿ“ฆ Dependencies

  • ๐Ÿ–ฅ๏ธ ratatui
  • โšก crossterm
  • ๐Ÿ“จ jpostcode_rs

๐Ÿ“œ License

MIT License

๐Ÿค Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a Pull Request

๐Ÿ™ Acknowledgments

  • Based on the jpostcode_rs library
  • Japanese postal code data provided by Japan Post

๐Ÿ‘ค Author

nwiizo

Commit count: 5

cargo fmt