semvec/pypi-packages huggingface dataset:
vmnlcli 0.2.0
command line interface for some dutch velomobile websites
License: MIT
Requires Python: >=3.5
Keywords: velomobile odometer cli velomobiel.nl intercitybike.nl welmers.net

# vmnlcli

This is a command line interface for these dutch velomobile web sites:
- http://www.velomobiel.nl
- https://www.intercitybike.nl

It might also work for other velomobile sites hosted at welmers.net which use the same server side software.

Using it, you can script updating / publishing your velomobile's odometer value (overall km distance of your velomobile),
so you do not need to manually log in / fill out a form / log out.


## Installation

You need to have Python >= 3.5 installed.
See https://www.python.org/ if you don't have it already.

On a shell (linux terminal, windows cmd.exe), enter this to install the vmnlcli software:

    pip3 install vmnlcli         # system-wide installation, might require root/admin
    or
    pip3 install --user vmnlcli  # install into user's home/profile directory

Only once, you need to find out the VMID (internal numerical identifier for your velomobile):

    vmnlcli --site http://www.velomobiel.nl --email 'you@example.org' --password 'CarsS*ck' vmid

Let's assume it displayed that your VMID is 12345678.

Now you can write 2 small wrapper scripts (they slightly differ for linux vs. windows).

### Linux wrapper scripts

#### myvm-now-km

    vmnlcli --site http://www.velomobiel.nl --email 'you@example.org' --password 'CarsS*ck' --vmid 12345678 update $1

#### myvm-date-km

    vmnlcli --site http://www.velomobiel.nl --email 'you@example.org' --password 'CarsS*ck' --vmid 12345678 update --date $1 $2

### Windows wrapper scripts

#### myvm-now-km.cmd

    vmnlcli --site http://www.velomobiel.nl --email 'you@example.org' --password 'CarsS*ck' --vmid 12345678 update %1

#### myvm-date-km.cmd

    vmnlcli --site http://www.velomobiel.nl --email 'you@example.org' --password 'CarsS*ck' --vmid 12345678 update --date %1 %2

## Usage

You just came home, odometer showed 4321 km and you want to update the site:

    myvm-now-km 4321

Or, you noted that your odometer showed 4321 km at 2019-12-31 and you want to update the site with that:

    myvm-date-km 2019-12-31 4321