install-info and deps

Author: Matteljay

CONTACT.md

@@ -1,4 +1,4 @@
-# LabelPush
+# Contact Info
 
 - Author: Matteljay
 - E-mail: Matteljay-at-pm-dot-me

README.md

@@ -1,116 +1,105 @@
-# LabelPush - Lightweight label printing app
+# LabelPush
+## Simple lightweight label printing app
 
 - License: MIT License
 - Author: Matteljay
 - Language: Python (>= 3.5)
 - Homepage: https://github.com/Matteljay
 
+
 ## Screenshots
 
 ![](screenshots/01_welcome.png)
 ![](screenshots/02_hello_serif.png)
 ![](screenshots/03_hello_double_bold.png)
 ![](screenshots/04_settings.png)
 
-## Getting started
 
-LabelPush is a lightweight label printing application written in Python.
-It is built to be fast and simple to use. The CUPS printing system is
-used. So make sure the printer is correctly installed with all default
-settings such as label size. This link should take you to your local
+## Introduction
+
+LabelPush is a simple lightweight label printing application written in Python.
+It is built to be fast and simple to use. The CUPS printing system is used.
+Please make sure the printer is correctly installed with all correct
+settings such as label/paper size. This link should take you to your local
 settings: [CUPS-localhost](http://localhost:631/printers/)
 
+
 ## Installation
 
-Two libraries, the Kivy cross-platform GUI and Pillow imaging library
-are required for LabelPush. Arch Linux (Manjaro) is very up-to-date,
-installation will be very quick. This will be briefly explained below.
+Package dependencies are kept to a minimum. The proper installation guides
+for your system can be found via these links:
 
-Unfortunately most Debian-based systems like Linux Mint and Ubuntu Linux
-do not have the required up-to-date versions of these libraries.
+- [Kivy](https://kivy.org/doc/stable/installation/installation.html) & [Pillow](https://python-pillow.org/)
+Version 1.10.1 with SDL2 window provider are required! (NOT 1.9 with PyGame).
+An updated Python Imaging Library is always recommended with a graphical Python program. And definitely required for LabelPush.
 
-However the requirements can be compiled and installed via the Python
-package management system 'pip'. To be able to compile, install at least
-these system packages via apt-get or the Synaptic Package Manager:
+- [pip3](https://github.com/pypa/pip) & [setuptools](https://github.com/pypa/setuptools)
+These are Python 3 installation tools. Universally useful!
 
-    sudo apt-get install python3-pip python3-dev python3-setuptools \
-    libgl1-mesa-dev xclip
+- [CUPS](https://www.cups.org/)
+Printer server for macOS and other UNIX-like operating systems.
 
-### Option 1
+### Debian Linux
 
-Now, get a copy of LabelPush. The 'whl' file from the
-[releases-page](https://github.com/Matteljay/labelpush/releases) is
-the easiest to work with. It does not require extracting, simply run:
+For most up-to-date Debian based systems like Ubuntu Linux and Linux Mint this should work *as root*:
 
-    sudo pip3 install /path/to/file.whl
+    add-apt-repository ppa:kivy-team/kivy
+    apt-get install python3-kivy python3-pip python3-setuptools
+    pip3 install --upgrade pillow labelpush
 
-All of the requirements should now get downloaded, compiled and
-automatically installed. This can take a while. When finished, the
-shortcut can be found from your menu-bar in the 'Office' category.
-If the icon does not show up, you may need to restart your desktop.
+### Arch Linux
 
-### Option 2
+For the more up-to-date Arch Linux (Manjaro) simply run *as root*:
 
-Alternatively, you can install from tar.gz or the GitHub master tree.
-First, extract the archive. Then run from within the extracted folder:
+    pacman -S python-kivy python-pillow python-pip python-setuptools
+    pip3 install labelpush
 
-    sudo pip3 install .
 
-### Option 3
+## How to launch
 
-Alternatively, you can run it without installing to the root
-filesystem. Again, extract the downloaded archive. Then run:
+When finished, the shortcut icon can be found from your menu-bar in the **Office** category.
+If the icon does not show up, you may need to restart your desktop.
+Alternatively, open your graphical user terminal and type **labelpush.py**
 
-    pip3 install --user -r requirements.txt
-    ./labelpush.py
 
-### Arch Linux
+## For developers, hackers and testers
 
-Now, let's have a look at Arch Linux. Install these packages:
+Other ways to install are explained below. The above dependencies are still required!
+Only use the info below if you know what you are doing.
 
-    sudo pacman -S python-kivy python-pillow python-setuptools cython
+### Option 1
 
-You can now choose from the 3 methods above, they will execute much
-faster as no compilations are required:
+You can install from tar.gz or the GitHub master tree.
+First, download and extract the archive from the [releases](https://github.com/Matteljay/labelpush/releases) page.
+Then run from within the extracted folder:
 
-    sudo pip3 install /path/to/file.whl
     sudo pip3 install .
-    ./labelpush.py
-
 
-## Development version
-
-Optionally, you can use git:
-
-    git clone git://github.com/Matteljay/labelpush.git
-    cd labelpush
+### Option 2
 
-This should install dependencies:
+Alternatively, you can run it without installing to the root
+filesystem. Again, extract the downloaded archive. Then run:
 
     pip3 install --user -r requirements.txt
+    ./labelpush.py
 
 
-## Other platforms
-
-
-### Linux distributions
-
-This application should work on other up-to-date flavors of Linux like
-Slackware, Gentoo, openSUSE, Fedora, Red Hat, Mandriva, CentOS,...
+## More platforms
 
-FreeBSD (TrueOS) and macOS are Linux based but are also untested.
+### Other UNIX
 
+Other flavors of Linux are untested but there is no reason for them
+not to work. Slackware, Gentoo, openSUSE, Fedora, Red Hat, Mandriva, CentOS,...
 
-### Windows
+### Android, iPhone and Windows
 
-Although Python and the required libraries are cross-platform, this
-application will not work on Windows due to the big difference in
-printer software (no CUPS). If a strong desire exists, find a way to
+These platforms probably won't work as they feature different printer
+software (no CUPS). If a strong desire exists, find a way to
 motivate me :-)
 
 
-## Contact info & Donations
+## Contact info & donations
 
-See [contact](CONTACT.md) file.
+See the [contact](CONTACT.md) file on GitHub.
 
 

labelpush.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- mode: python -*-
 #
-# LabelPush - lightweight label printing app
+# LabelPush - Simple lightweight label printing app
 # Copyright (C) 2018 Matteljay-at-pm-dot-me
 #
 # Permission is hereby granted, free of charge, to any person
@@ -64,7 +64,7 @@
 import shutil
 
 name = 'labelpush'
-version = '2018.11.27'
+version = '2018.12.11'
 def_defaultcfg = {
     'lpname': 'default', # printer name
     'labw': 637, # labelwidth
@@ -81,9 +81,9 @@
     { "type": "options", "title": "lp printername", "desc": "List of available printers from 'lpstat'",
     "section": "settings", "key": "lpname", "options": ["default"] },
     { "type": "title", "title": "Label size and style" },
-    { "type": "numeric", "title": "Label width", "desc": "300 dpi -> 300 dots per 25.4 mm -> 1 mm = 11.8 dots",
+    { "type": "numeric", "title": "Label width", "desc": "Horizontal resolution, paper size is set via CUPS! http://localhost:631",
     "section": "settings", "key": "labw" },
-    { "type": "numeric", "title": "Label height", "desc": "Example: 2+1/8 x 1 inch or approx 54 x 25 mm",
+    { "type": "numeric", "title": "Label height", "desc": "Vertical resolution, current ratio set for 2+1/8 x 1 inch or 54x25 mm",
     "section": "settings", "key": "labh" },
     { "type": "options", "title": "Font selection", "desc": "Pick a font from 'fc-list :fontformat=TrueType'",
     "section": "settings", "key": "font", "options": ["DejaVuSans"] },
@@ -581,7 +581,7 @@ def normalize(v):
     pymod_versioncheck('pillow', PILLOW_VERSION, '5.3.0') # DO NOT USE the old python-pil, i tried and it sucks
     # Kivy handles command line arguments :-)
     #from argparse import ArgumentParser
-    #parser = ArgumentParser(description='Lightweight label printing app')
+    #parser = ArgumentParser(description='Simple lightweight label printing app')
     #parser.add_argument('-c', '--config', default=['~/.config/labelpush.ini'], dest='FILE', help='configuration file to use')
     #print(parser.parse_args())
     # GUI settings

requirements.txt

@@ -1,5 +1,4 @@
-setuptools >= 40.4.3
-Cython >= 0.28.5
-Pygame >= 1.9.4
+setuptools >= 20.7.0
 Kivy >= 1.10.1
 Pillow >= 5.3.0
+

screenshots/04_settings.png

@@ -1,6 +1,6 @@
 #!/usr/bin/env python3
 # to install directly, invoke via pip: sudo pip3 install .
-# to generate a whl file: ./setup.py bdist_wheel
+# packages for PyPI.org: ./setup.py sdist bdist_wheel && twine upload dist/*
 
 import setuptools
 import os, sys, re
@@ -30,7 +30,7 @@
     version = extracted_version,
     author = 'Matteljay',
     author_email = '[email protected]',
-    description = 'Lightweight label printing app',
+    description = 'Simple lightweight label printing app',
     long_description = long_description,
     long_description_content_type = 'text/markdown',
     url = 'https://github.com/Matteljay/labelpush',