| cbbff016 |
[Python]: https://www.python.org
## Usage
`bygglogistik-utils --help`:
```
bygglogistik-utils 1.0.0
Scrape intranet.bygglogistik.se.
Usage:
bygglogistik-utils pay [--tax=<tax>]
bygglogistik-utils personnel
bygglogistik-utils report [<date_from>] [<date_to>] [<region>] [<project>]
bygglogistik-utils path
bygglogistik-utils -h|--help
bygglogistik-utils --version
Arguments:
<date_from>
The date (in a ISO 8601 format) from which to gather reports (inclusive).
Defaults to yesterday.
<date_to>
The date (in a ISO 8601 format) to which to gather reports (inclusive).
Defaults to <date_from>.
<region>
The region of the report.
Defaults to the region of the logged in user.
<project>
The project of the report.
Default to all projects.
Options:
--tax=<tax>
The tax rate, between 0.0 and 1.0.
Defaults to 0.30.
```
Data is stored in a path retrievable by running `bygglogistik-utils path`. This
path can be overridden with the [environment variable][] `BYGGLOGISTIK_PATH`.
Login uses the credentials in the file `$BYGGLOGISTIK_PATH/login` which should
be in [JSON][] format consisting of an object with the keys `email` and
`password`:
```json
{
"email": "name@example.com",
"password": "mysupersecretpassword"
}
```
Login credentials can be overridden by the [environment variable][]s
`BYGGLOGISTIK_EMAIL` and `BYGGLOGISTIK_PASSWORD`.
[environment variable]: https://en.wikipedia.org/wiki/Environment_variable
[JSON]: https://en.wikipedia.org/wiki/JSON
### `pay` command
Stores and summarizes personal payment data by parsing the table "Genomförda
intransporter" on the page "Mina sidor".
Since only the most recent data is shown in the table it then stores it locally
in `$BYGGLOGISTIK_PATH/pay` to enable accumulation over time (e.g. from a
[cron][] job). The format is [tab-separated values][], human and machine
readable and suitable for use with spreadsheet software.
Lastly, the expected pay, after taxes (which rate can be given with `--tax`,
defaults to `0.3`), for the months where data is available is printed, in
reverse chronological order.
[cron]: https://en.wikipedia.org/wiki/Cron
[tab-separated values]: https://en.wikipedia.org/wiki/Tab-separated_values
### `personnel` command
Prints the name, telephone number and position in the organization separated by
tab, one person per row, by parsing the table "Användare" on the page
"Användare".
Only tested on accounts that have the "Leveransplanerare" access permissions!
### `report` command
Prints statistics of a given report.
Only tested on accounts that have the "Leveransplanerare" access permissions!
|
| d31c5eab |
## Install
Make sure [Python is installed][Python download], [`pip`][] is available and
the [`pip`][], [`setuptools`][] and [`wheel`][] packages are up to date:
```sh
python3 -m pip install --user --upgrade pip setuptools wheel
```
Reference: [Python Packaging User Guide: Requirements for Installing
Packages][].
[Python download]: https://python.org/download
[`pip`]: https://pip.readthedocs.io
[`setuptools`]: https://setuptools.readthedocs.io
[`wheel`]: https://wheel.readthedocs.io
[Python Packaging User Guide: Requirements for Installing Packages]: https://packaging.python.org/tutorials/installing-packages/#requirements-for-installing-packages
### With [`pipx`][], for users
Make sure [`pipx`][] is installed:
```sh
python3 -m pip install --user pipx
```
Install `bygglogistik-utils`:
```sh
pipx install "git+https://git.rcrnstn.net/rcrnstn/bygglogistik-utils"
```
`bygglogistik-utils` should now be in your [`PATH`][] (if not, run `python3 -m
pipx ensurepath`).
Reference: [Python Packaging User Guide: Installing stand alone command line
tools][].
[`pipx`]: https://pipxproject.github.io/pipx/
[`PATH`]: https://en.wikipedia.org/wiki/PATH_(variable)
[Python Packaging User Guide: Installing stand alone command line tools]: https://packaging.python.org/guides/installing-stand-alone-command-line-tools/
### Into [`venv`][], for developers
Clone and install into a repository [`venv`][] virtual environment:
```sh
git clone "https://git.rcrnstn.net/rcrnstn/bygglogistik-utils"
cd "bygglogistik-utils"
python3 -m venv .venv
. .venv/bin/activate
python3 -m pip install --editable .
```
`bygglogistik-utils` should now be in your (virtual environment) [`PATH`][].
Reference: [Python Packaging User Guide: Installing packages using pip and
virtual environments][].
[`venv`]: https://docs.python.org/3/library/venv.html
[Python Packaging User Guide: Installing packages using pip and virtual environments]: https://packaging.python.org/guides/installing-using-pip-and-virtual-environments/
|
git.rcrnstn.net