Contents
Installing Depspec
Premade Packages
Gentoo
Note: At the moment you'll most likely need an ~arch system to run depspec because of the py 2.5 and snakeoil deps.
There is an ebuild for depspec in my overlay, you could do something like the following to install it:
- mkdir /usr/local/overlays
- cd /usr/local/overlays
- svn co svn://tfkyle.dyndns.org/ebuilds/projects tfkyles_projects
- add /usr/local/overlays/tfkyles_projects to PORTDIR_OVERLAY in /etc/make.conf, if you havn't specified it already (and aren't sourcing layman's make.conf) you can specify it fresh like PORTDIR_OVERLAY="/usr/local/overlays/tfkyles_projects". (if using layman you'd want to use PORTDIR_OVERLAY="$PORTDIR_OVERLAY ...."
- add the following to /etc/portage/package.keywords (if it doesn't exist it's fine to create it):
- {{{=dev-python/tfplib-9999 **
=dev-python/depspec-9999 **}}}
- emerge -av depspec
Standalone Binaries
Standalone binaries are binaries that bundle most things needed to run, these typically aren't the best to use for hacking on depspec, but can be useful for trying it out.
Windows
There's a Standalone windows binary for an older version of depspec here, just unrar and run depspec/depspec.exe to use it .
Installing Manually
if there's no Package or Standalone Binary for your OS/Distro or you want to hack on depspec you'll have to install depspec manually, this can be either decently hard or fairly easy/simple depending on the system.
Installing Python Packages
First we'll start with a bit of knowledge on python packages (if you know much about python you can probably skip this), there's a few ways to install a python package so it is available for other python code to use:
install (well, copy) it into the site-packages dir of your python distribution, python setup.py install does this (as well as other things, some setup.py's also compile C code which the python code uses for example)
unix-like systems only: add a symlink in the site-packages dir pointing at the package dir, this is what I do most of the time when hacking on depspec in linux (easier to cd to ~/Projects/depspec instead of /usr/lib/python2.5/site-packages/depspec or doing the sudo python setup.py install dance (even though it's fairly simple) every time I modify it)
- Change the PYTHONPATH environment variable to include the directory with your package directory in, it's a : (or ; in windows) separated list of dirs that python package directories are in
These methods apply to most python modules I'll mention here, though there's a few special cases (pygobject/pygtk/... uses autotools).
Dependencies
So let's start with installing deps, there's a few things I won't cover here:
installing Python 2.5 in non-windows environments, most OSes/distros should include it these days - have a look at http://python.org if yours doesn't
installing subversion outside of windows, again most OSes/distros I've came across have it (though I havn't looked too far) - check http://subversion.tigris.org
installing gtk/pygtk outside of windows, hopefully most unixes atleast package gtk and pygtk - if not check http://gtk.org and http://pygtk.org
Python (Windows)
It should be pretty simple to install python in windows, just download the Python 2.5.x installer from http://python.org/download/ . it's also probably a good idea to add the python install dir to your PATH (C:\Python25 by default, if you change it or it goes somewhere else on the system use the other path in the following instructions), to do that you could:
Open the control panel (My Computer -> Control Panel, or in XP+ Start Menu -> Control Panel)
- In XP+ Change to classic mode if you're not in it already (should have an option on the left side menu)
System -> Advanced Tab -> Environment Variables -> scroll down the System variables pane until you see the PATH Variable, double click it to edit it
- add ;C:\Python25 to the end of it (the ; is a directory separator, it specifies that one directory path has ended and the next has started)
start up a Command Prompt (Start Menu -> (All Programs in XP, Programs otherwise) -> Accessories -> Command Prompt) and make sure python -V works and prints out Python 2.5.x
PyWin32 (Windows)
This should be fairly simple as well, after installing python just download the newest installer .exe from here with a -py2.5 suffix and run it going through the steps.
Gtk+ (Windows)
This one can be the killer, it's pretty awkward to install manually and requires quite a bit of time, luckily you might be able to cheat and just install an existing runtime package like the one here (the 2.10.x runtimes and 2.12 ones should be fine)
TODO: Expand on this.
PyGtk (Windows)
assuming you've got a proper install of gtk already this should be fine, just get the newest installers for PyCairo, PyGObject and PyGTK from here and install them. At this point it might be a good idea to make sure you can atleast import gtk, open up a python prompt (either by using the menu item or starting a command prompt and then running python) and doing import gtk in it, if there's no output it should be fine, if there's an exception you've got a problem
tfplib
TODO
depspec
TODO