https://github.com/smkent/epoa-tools
WA EPOA pay transparency tools
https://github.com/smkent/epoa-tools
Last synced: 4 months ago
JSON representation
WA EPOA pay transparency tools
- Host: GitHub
- URL: https://github.com/smkent/epoa-tools
- Owner: smkent
- License: gpl-3.0
- Created: 2023-01-27T05:25:38.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-15T19:07:01.000Z (4 months ago)
- Last Synced: 2025-01-15T20:52:12.681Z (4 months ago)
- Language: Python
- Size: 390 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# epoa-tools: WA EPOA pay transparency tools
[][pypi]
[][pypi]
[][gh-actions]
[][codecov]
[][repo]
[Washington state's Equal Pay and Opportunities Act][li-epoa] requires pay
ranges to be included on job ads ([RCW 49.58.110][rcw]). WA L&I provides a [PDF
complaint form][li-complaint-form] for violations. `epoa-tools` automates some
of the toil around this form, such as filling out basic information, checking
the right boxes, and optionally including additional PDF files as evidence (e.g.
the related job posting without pay range information).
The output is a single PDF which can be dropped into [WA L&I's secure file
upload][li-file-upload].
## Prerequisites
`epoa-tools` depends on `pdftk` for filling out forms and joining pages.
On Debian / Ubuntu, install with:
```shell
sudo apt install pdftk-java
```
## Installation
[epoa-tools is available on PyPI][pypi]:
```
pip install epoa-tools
```
## Usage
Save a PDF file with evidence of the violation (e.g. job ad or recruiter email).
Browsers can print or save web pages as PDFs.
Then, use `epoa-job-ad` to complete the complaint form, attaching your evidence
file:
```shell
epoa-job-ad \
--name "John Q. Public" --email [email protected] \
"ACME Anti-Pay Ranges, Inc." \
saved_job_ad.pdf
```
To file anonymously, omit the `--name` argument. The complainant name on the
form will be listed as `Anonymous` and the signature line will contain
`Anonymous ([email protected])`:
```shell
epoa-job-ad \
--email [email protected] \
"ACME Anti-Pay Ranges, Inc." \
saved_job_ad.pdf
```
Optionally include additional information text about your complaint with the
`-i` / `--addinfo` / `--additional-information` option:
```shell
epoa-job-ad \
--email [email protected] \
"ACME Anti-Pay Ranges, Inc." \
saved_job_ad.pdf \
-i "This job ad is public, contains specific job requirements for a job in WA, but lists no pay range"
```
Word(s) can be redacted from evidence file attachments on a best effort basis:
```shell
epoa-job-ad \
--email [email protected] \
"ACME Anti-Pay Ranges, Inc." \
saved_job_ad.pdf \
-r remove_this_word -r also_remove_this_word
```
Each of these examples creates a file such as
`john-q-public-acme-anti-pay-ranges-inc-20230101-pay-transparency-complaint.pdf`
which can then be [uploaded to WA L&I][li-file-upload].
## Development
### [Poetry][poetry] installation
Via [`pipx`][pipx]:
```console
pip install pipx
pipx install poetry
pipx inject poetry poetry-pre-commit-plugin
```
Via `pip`:
```console
pip install poetry
poetry self add poetry-pre-commit-plugin
```
### Development tasks
* Setup: `poetry install`
* Run static checks: `poetry run poe lint` or
`poetry run pre-commit run --all-files`
* Run static checks and tests: `poetry run poe test`
---
Created from [smkent/cookie-python][cookie-python] using
[cookiecutter][cookiecutter]
[codecov]: https://codecov.io/gh/smkent/epoa-tools
[cookie-python]: https://github.com/smkent/cookie-python
[cookiecutter]: https://github.com/cookiecutter/cookiecutter
[gh-actions]: https://github.com/smkent/epoa-tools/actions?query=branch%3Amain
[li-complaint-form]: https://www.lni.wa.gov/forms-publications/F700-200-000.pdf
[li-epoa]: https://www.lni.wa.gov/workers-rights/wages/equal-pay-opportunities-act/
[li-file-upload]: https://lni.app.box.com/f/81096b771d1243c0aab00fea150f8c6a
[pipx]: https://pypa.github.io/pipx/
[poetry]: https://python-poetry.org/docs/#installation
[rcw]: https://app.leg.wa.gov/RCW/default.aspx?cite=49.58.110
[pypi]: https://pypi.org/project/epoa-tools/
[repo]: https://github.com/smkent/epoa-tools