Plus Code/latlong/query to iOS-Shortcuts-like shareable text
Go to file
2023-06-03 07:43:50 +00:00
.github/workflows ci: use devbox gh action instead 2023-06-03 07:43:50 +00:00
.gitignore meta: add files, 1.0.0 2023-06-02 19:39:25 +00:00
devbox.json meta: add files, 1.0.0 2023-06-02 19:39:25 +00:00
devbox.lock meta: add files, 1.0.0 2023-06-02 19:39:25 +00:00
poetry.lock meta: add files, 1.0.0 2023-06-02 19:39:25 +00:00
pyproject.toml meta: add files, 1.0.0 2023-06-02 19:39:25 +00:00
README.md meta: add files, 1.0.0 2023-06-02 19:39:25 +00:00
requirements.txt meta: add files, 1.0.0 2023-06-02 19:39:25 +00:00
surplus.py code: lint 2023-06-02 19:50:46 +00:00
UNLICENCE meta: add files, 1.0.0 2023-06-02 19:39:25 +00:00

surplus

plus code to iOS-Shortcuts-like shareable text

  • Installing
  • Usage
  • Licence
$ surplus 6PH59R3J+R9
surplus version 1.0.0
Thomson Plaza
301 Upper Thomson Road, Bishan
574408
Singapore
>>> import surplus
>>> surplus.surplus("6PH58RPQ+JW")
(True, 'Caldecott Stn Exit 4\nToa Payoh Link\n298106\nSingapore')

Installing

Install surplus directly from GitHub using pip:

pip install git+https://github.com/markjoshwel/surplus

Usage

usage: surplus [-h] [-d] pluscode

plus code to iOS-Shortcuts-like shareable text

positional arguments:
  pluscode     full-length plus code including area code, e.g.: 6PH58QMF+FX

options:
  -h, --help   show this help message and exit
  -d, --debug  prints lat, long and reverser response dict to stderr

Developing

Prerequisites:

Alternatively, use devbox for a hermetic development environment powered by Nix.

devbox shell    # skip this if you aren't using devbox
poetry install
poetry shell

Licence

surplus is free and unencumbered software released into the public domain. For more information, please refer to the UNLICENCE, http://unlicense.org/ or the Python module docstring.