Metadata-Version: 2.1
Name: postleid
Version: 0.6.2
Summary: Fix postal codes notation in spreadsheet documents
Author-email: Rainer Schwarzbach <undisclosed@example.com>
License: MIT License
        
        Copyright (c) 2023 Rainer Schwarzbach
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://codeberg.org/blackstream-x/postleid
Project-URL: Documentation, https://codeberg.org/blackstream-x/postleid
Project-URL: Repository, https://codeberg.org/blackstream-x/postleid.git
Project-URL: Bug Tracker, https://codeberg.org/blackstream-x/postleid/issues
Keywords: postleitzahlen,plz,postal codes,excel
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: German
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Office/Business
Classifier: Topic :: Utilities
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# Postleid Excel

Skript zum Korrigieren von Postleitzahlen in Excel

## Voraussetzungen

[Python 3](https://www.python.org/about/)

Installation der benötigten Module
(`openpyxl`, `pandas`, `xlrd` und `PyYAML`) in einem aktiven
_[Python Virtual Environment](https://docs.python.org/library/venv.html):_

```
pip install -r requirements.txt
```

## Aufruf

_ebenfalls im aktiven Virtual Environment_

```
python pl_wrapper.py EXCELDATEI
```

 – wobei `EXCELDATEI` für den Pfad zu einer Exceldatei steht –

Ausgabe von `python pl_wrapper.py -h` als Orientierung:

```
Rufe den Befehl 'python -m postleid -h' auf …
Aufruf: postleid [-h] [--version] [-v | -q] [-g] [-l] [-o AUSGABEDATEI]
                 EXCELDATEI

Postleitzahlen in Excel-Dateien korrigieren

Positionsparameter:
  EXCELDATEI            die Original-Exceldatei

Optionen:
  -h, --help            diese Meldung anzeigen und beenden
  --version             Version ausgeben und beenden
  -g, --guess-1000s     Postleitzahlen unter 1000 mit 1000 multiplizieren
                        (Achtung, für PLZs aus Bahrain liefert diese Option
                        falsche Ergebnisse!)
  -l, --list-supported-countries
                        Unterstützte Länder anzeigen (der Dateiname muss in
                        diesem Fall zwar auch angegeben werden, wird jedoch
                        ignoriert)
  -o AUSGABEDATEI, --output-file AUSGABEDATEI
                        die Ausgabedatei (Standardwert: Name der Original-
                        Exceldatei mit vorangestelltem 'fixed-')

Logging-Optionen:
  steuern die Meldungsausgaben (Standard-Loglevel: INFO)

  -v, --verbose         alle Meldungen ausgeben (Loglevel DEBUG)
  -q, --quiet           nur Warnungen und Fehler ausgeben (Loglevel WARNING)

```
