1 BASIC UNIX INSTALLATION INSTRUCTIONS FOR THE WEATHER UTILITY
3 Copyright (c) 2006 Jeremy Stanley <fungi@yuggoth.org>, all rights reserved.
4 Licensed per terms in the LICENSE file distributed with this software.
9 You need the Python interpreter installed somewhere in your path
10 (most modern UNIX derivatives come with one already). If you need to
11 get Python, it can be obtained from http://www.python.org/ (but
12 chances are your operating system at least provides some sort of
13 native package for it, which you should probably install in whatever
14 means is recommended by your OS vendor/distributor).
19 An easy way to try it out is to unpack the tarball and change to the
22 tar xzf weather-*.tar.gz
28 ./weather --forecast --no-conditions --city=charlotte --st=nc
31 ...and so on. The weather utility, included Python module and
32 documentation are all fully functional when kept together in one
33 directory, if somewhat inconvenient.
36 INSTALLING THE UTILITY
38 The file named weather should be made executable and put somewhere
39 in your path (/usr/local/bin/ or ~/bin/ for example). Similarly,
40 weather.py needs to be somewhere in Python's include path. You can
41 see your Python interpreter's default include path by running:
43 python -c "import sys ; print sys.path"
48 The weatherrc file should go in /etc/ or you can save it in your
49 home directory as a dotfile (~/.weatherrc) to support user-specific
50 alias configuration and overrides of the global /etc/weatherrc file.
55 Optionally, the weather.1 and weatherrc.5 files can be placed in
56 sane locations for TROFF/NROFF manual files on your system (for
57 example, /usr/local/share/man/ or ~/man/).