ed2k_python - a python framework for manipulating .part.met files

Most of the information on this page has been shamelessly copied from the README file. You might want to check it out to get the scoop on things like data structures, api details, etc.

The code was developed on Mac OS X, but as it's written in a cross-platform scripting language, it should work fine without modification anywhere where there is a Python interpreter. These are available for Windows, and should already be present on most *BSD or GNU/Linux systems. It probably runs on more platforms than Overnet / ed2k does.

If you need help setting up python itself or running python scripts on your platform, you're probably better off looking for help at Python.org. If you execute these scripts as bourne shell scripts, they assume Python is in /usr/bin. Python must be, as far as I know, at least version 2.2, but might work with 2.1.

Description

This code represents a python framework for easy manipulation of .part.met files (edonkey and overnet download meta-information). This set of classes allows for rapid development of ed2k tools, using a very simple API.

Included example programs:

Of course, you might not be aiming to write something with the library, just to use the useful example programs. These are as follows:

fix_sofar.py - the Overnet 0.46 and 0.47 series ( at least ) on MacOSX have a disturbing habit of wiping the downloaded bytes counter every time you restart them. This program will create a ".part.met.new" for every ".part.met" specified on the command line, which will have this corrected ( recalculated from the file gapping information ). You may wish to copy these .new files back over the top of the originals.
make_met.py - This simple program takes the location of your Overnet / edonkey temp directory and an ed2k:// link as arguments, and will produce a .part.met file in that directory, in the first un-used download id, for this link. Useful if your client ( linux / MacOSX ) doesn't have browser integration, or you want to add things to a download list without firing up Overnet / edonkey.
retrieve_link.py - for every .part.met file specified on the command line, it produces the ed2k:// link associated with it. Sort of the opposite of make_met.py.
temp_summary.py - this takes each .part.met file on the command line, and shows how much has been downloaded against the total size - it uses the gapping data for this calculation, so it will work fine even with the faulty MacOSX builds. It then gives a grand total. Now with sexy progress bars!

Download python code via CVS

The latest code for ed2k_python is always available from CVS by checking out the 'ed2k_python' module from our CVS server:

cvs -d:pserver:anonymous@cvs.ed2k-tools.sourceforge.net:/cvsroot/ed2k-tools login

You will be prompted for a password. Just hit enter here. After anonymously logging in:

cvs -z3 -d:pserver:anonymous@cvs.ed2k-tools.sourceforge.net:/cvsroot/ed2k-tools co ed2k_python

This will create a new directory named 'ed2k_python' in your current working directory and contain the framework and example programs.

Download python code via the Sourceforge Release System

After a month or so in CVS, with no major bugs coming to light, I've produced the inaugral release of ed2k_python: 0.1. You can snag it from the sourceforge mirrors via the downloads page.

License

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.

(This BSD style license was lifted from dlCompat, thank you.)

Mad propz to Optimus Rhyme for stopping me from going mad while coding.