b755668b64
* Release 1.1. * weather: Switched to "#!/usr/bin/env python" instead for portability. * weather.1, weather.5, weather.py: Implemented the --omit-forecast option to cancel --forecast. * weather.py: Calling with undefined aliases now throws an error and exits. Aliases, options and default overrides operate more logically. Upped the version to 1.1. * weatherrc: Added 214 standard aliases.
59 lines
1.8 KiB
Plaintext
59 lines
1.8 KiB
Plaintext
BASIC UNIX INSTALLATION INSTRUCTIONS FOR THE WEATHER UTILITY
|
|
|
|
Copyright (c) 2006 Jeremy Stanley <fungi@yuggoth.org>, all rights reserved.
|
|
Licensed per terms in the LICENSE file distributed with this software.
|
|
|
|
|
|
PREREQUISITES
|
|
|
|
You need the Python interpreter installed somewhere in your path
|
|
(most modern UNIX derivatives come with one already). If you need to
|
|
get Python, it can be obtained from http://www.python.org/ (but
|
|
chances are your operating system at least provides some sort of
|
|
native package for it, which you should probably install in whatever
|
|
means is recommended by your OS vendor/distributor).
|
|
|
|
|
|
RUNNING IN PLACE
|
|
|
|
An easy way to try it out is to unpack the tarball and change to the
|
|
resulting directory:
|
|
|
|
tar xzf weather-*.tar.gz
|
|
cd weather
|
|
./weather --version
|
|
./weather --help
|
|
man ./weather.1
|
|
man ./weatherrc.5
|
|
./weather --forecast --no-conditions --city=charlotte --st=nc
|
|
./weather ord sea
|
|
|
|
...and so on. The weather utility, included Python module and
|
|
documentation are all fully functional when kept together in one
|
|
directory, if somewhat inconvenient.
|
|
|
|
|
|
INSTALLING THE UTILITY
|
|
|
|
The file named weather should be made executable and put somewhere
|
|
in your path (/usr/local/bin/ or ~/bin/ for example). Similarly,
|
|
weather.py needs to be somewhere in Python's include path. You can
|
|
see your Python interpreter's default include path by running:
|
|
|
|
python -c "import sys ; print sys.path"
|
|
|
|
|
|
CONFIGURATION
|
|
|
|
The weatherrc file should go in /etc/ or you can save it in your
|
|
home directory as a dotfile (~/.weatherrc) to support user-specific
|
|
alias configuration and overrides of the global /etc/weatherrc file.
|
|
|
|
|
|
MANUALS
|
|
|
|
Optionally, the weather.1 and weatherrc.5 files can be placed in
|
|
sane locations for TROFF/NROFF manual files on your system (for
|
|
example, /usr/local/share/man/ or ~/man/).
|
|
|