Permit header object generation from PyCObjects
[tools/librpm-tizen.git] / python / header-py.c
1 #include "rpmsystem-py.h"
2
3 #include <rpm/rpmlib.h>         /* rpmvercmp */
4 #include <rpm/rpmtag.h>
5 #include <rpm/rpmstring.h>
6 #include <rpm/rpmts.h>  /* XXX rpmtsCreate/rpmtsFree */
7
8 #include "header-py.h"
9 #include "rpmds-py.h"
10 #include "rpmfd-py.h"
11 #include "rpmfi-py.h"
12 #include "rpmtd-py.h"
13
14 #include "debug.h"
15
16 /** \ingroup python
17  * \class Rpm
18  * \brief START HERE / RPM base module for the Python API
19  *
20  * The rpm base module provides the main starting point for
21  * accessing RPM from Python. For most usage, call
22  * the TransactionSet method to get a transaction set (rpmts).
23  *
24  * For example:
25  * \code
26  *      import rpm
27  *
28  *      ts = rpm.TransactionSet()
29  * \endcode
30  *
31  * The transaction set will open the RPM database as needed, so
32  * in most cases, you do not need to explicitly open the
33  * database. The transaction set is the workhorse of RPM.
34  *
35  * You can open another RPM database, such as one that holds
36  * all packages for a given Linux distribution, to provide
37  * packages used to solve dependencies. To do this, use
38  * the following code:
39  *
40  * \code
41  * rpm.addMacro('_dbpath', '/path/to/alternate/database')
42  * solvets = rpm.TransactionSet()
43  * solvets.openDB()
44  * rpm.delMacro('_dbpath')
45  *
46  * # Open default database
47  * ts = rpm.TransactionSet()
48  * \endcode
49  *
50  * This code gives you access to two RPM databases through
51  * two transaction sets (rpmts): ts is a transaction set
52  * associated with the default RPM database and solvets
53  * is a transaction set tied to an alternate database, which
54  * is very useful for resolving dependencies.
55  *
56  * The rpm methods used here are:
57  *
58  * - addMacro(macro, value)
59  * @param macro   Name of macro to add
60  * @param value   Value for the macro
61  *
62  * - delMacro(macro)
63  * @param macro   Name of macro to delete
64  *
65  */
66
67 /** \ingroup python
68  * \class Rpmhdr
69  * \brief A python header object represents an RPM package header.
70  *
71  * All RPM packages have headers that provide metadata for the package.
72  * Header objects can be returned by database queries or loaded from a
73  * binary package on disk.
74  *
75  * The ts.hdrFromFdno() function returns the package header from a
76  * package on disk, verifying package signatures and digests of the
77  * package while reading.
78  *
79  * Note: The older method rpm.headerFromPackage() which has been replaced
80  * by ts.hdrFromFdno() used to return a (hdr, isSource) tuple.
81  *
82  * If you need to distinguish source/binary headers, do:
83  * \code
84  *      import os, rpm
85  *
86  *      ts = rpm.TransactionSet()
87  *      fdno = os.open("/tmp/foo-1.0-1.i386.rpm", os.O_RDONLY)
88  *      hdr = ts.hdrFromFdno(fdno)
89  *      os.close(fdno)
90  *      if hdr[rpm.RPMTAG_SOURCEPACKAGE]:
91  *         print "header is from a source package"
92  *      else:
93  *         print "header is from a binary package"
94  * \endcode
95  *
96  * The Python interface to the header data is quite elegant.  It
97  * presents the data in a dictionary form.  We'll take the header we
98  * just loaded and access the data within it:
99  * \code
100  *      print hdr[rpm.RPMTAG_NAME]
101  *      print hdr[rpm.RPMTAG_VERSION]
102  *      print hdr[rpm.RPMTAG_RELEASE]
103  * \endcode
104  * in the case of our "foo-1.0-1.i386.rpm" package, this code would
105  * output:
106 \verbatim
107         foo
108         1.0
109         1
110 \endverbatim
111  *
112  * You make also access the header data by string name:
113  * \code
114  *      print hdr['name']
115  *      print hdr['version']
116  *      print hdr['release']
117  * \endcode
118  *
119  * This method of access is a teensy bit slower because the name must be
120  * translated into the tag number dynamically. You also must make sure
121  * the strings in header lookups don't get translated, or the lookups
122  * will fail.
123  */
124
125 /** \ingroup python
126  * \name Class: rpm.hdr
127  */
128
129 struct hdrObject_s {
130     PyObject_HEAD
131     Header h;
132     HeaderIterator hi;
133 };
134
135 static PyObject * hdrKeyList(hdrObject * s)
136 {
137     PyObject * keys = PyList_New(0);
138     HeaderIterator hi = headerInitIterator(s->h);
139     rpmTag tag;
140
141     while ((tag = headerNextTag(hi)) != RPMTAG_NOT_FOUND) {
142         PyList_Append(keys, PyInt_FromLong(tag));
143     }
144     headerFreeIterator(hi);
145
146     return keys;
147 }
148
149 static PyObject * hdrUnload(hdrObject * s, PyObject * args, PyObject *keywords)
150 {
151     char * buf;
152     PyObject * rc;
153     int len, legacy = 0;
154     Header h;
155     static char *kwlist[] = { "legacyHeader", NULL};
156
157     if (!PyArg_ParseTupleAndKeywords(args, keywords, "|i", kwlist, &legacy))
158         return NULL;
159
160     h = headerLink(s->h);
161     /* XXX this legacy switch is a hack, needs to be removed. */
162     if (legacy) {
163         h = headerCopy(s->h);   /* XXX strip region tags, etc */
164         headerFree(s->h);
165     }
166     len = headerSizeof(h, 0);
167     buf = headerUnload(h);
168     h = headerFree(h);
169
170     if (buf == NULL || len == 0) {
171         PyErr_SetString(pyrpmError, "can't unload bad header\n");
172         return NULL;
173     }
174
175     rc = PyBytes_FromStringAndSize(buf, len);
176     buf = _free(buf);
177
178     return rc;
179 }
180
181 static PyObject * hdrExpandFilelist(hdrObject * s)
182 {
183     DEPRECATED_METHOD("use hdr.convert() instead");
184     headerConvert(s->h, HEADERCONV_EXPANDFILELIST);
185
186     Py_RETURN_NONE;
187 }
188
189 static PyObject * hdrCompressFilelist(hdrObject * s)
190 {
191     DEPRECATED_METHOD("use hdr.convert() instead");
192     headerConvert(s->h, HEADERCONV_COMPRESSFILELIST);
193
194     Py_RETURN_NONE;
195 }
196
197 /* make a header with _all_ the tags we need */
198 static PyObject * hdrFullFilelist(hdrObject * s)
199 {
200     rpmtd fileNames = rpmtdNew();
201     Header h = s->h;
202
203     DEPRECATED_METHOD("obsolete method");
204     if (!headerIsEntry (h, RPMTAG_BASENAMES)
205         || !headerIsEntry (h, RPMTAG_DIRNAMES)
206         || !headerIsEntry (h, RPMTAG_DIRINDEXES))
207         headerConvert(h, HEADERCONV_COMPRESSFILELIST);
208
209     if (headerGet(h, RPMTAG_FILENAMES, fileNames, HEADERGET_EXT)) {
210         rpmtdSetTag(fileNames, RPMTAG_OLDFILENAMES);
211         headerPut(h, fileNames, HEADERPUT_DEFAULT);
212         rpmtdFreeData(fileNames);
213     }
214     rpmtdFree(fileNames);
215
216     Py_RETURN_NONE;
217 }
218
219 static PyObject * hdrFormat(hdrObject * s, PyObject * args, PyObject * kwds)
220 {
221     char * fmt;
222     char * r;
223     errmsg_t err;
224     PyObject * result;
225     char * kwlist[] = {"format", NULL};
226
227     if (!PyArg_ParseTupleAndKeywords(args, kwds, "s", kwlist, &fmt))
228         return NULL;
229
230     r = headerFormat(s->h, fmt, &err);
231     if (!r) {
232         PyErr_SetString(pyrpmError, err);
233         return NULL;
234     }
235
236     result = Py_BuildValue("s", r);
237     r = _free(r);
238
239     return result;
240 }
241
242 static PyObject *hdrInstance(hdrObject *s)
243 {
244     return Py_BuildValue("i", headerGetInstance(s->h));
245 }
246
247 static PyObject *hdrIsSource(hdrObject *s)
248 {
249     return PyBool_FromLong(headerIsSource(s->h));
250 }
251
252 static PyObject *hdrHasKey(hdrObject *s, PyObject *pytag)
253 {
254     rpmTag tag;
255     if (!tagNumFromPyObject(pytag, &tag)) return NULL;
256
257     return PyBool_FromLong(headerIsEntry(s->h, tag));
258 }
259
260 static PyObject *hdrConvert(hdrObject *self, PyObject *args, PyObject *kwds)
261 {
262     char *kwlist[] = {"op", NULL};
263     headerConvOps op = -1;
264
265     if (!PyArg_ParseTupleAndKeywords(args, kwds, "i", kwlist, &op)) {
266         return NULL;
267     }
268     return PyBool_FromLong(headerConvert(self->h, op));
269 }
270
271 static PyObject * hdrWrite(hdrObject *s, PyObject *args, PyObject *kwds)
272 {
273     char *kwlist[] = { "file", "magic", NULL };
274     int magic = 1;
275     rpmfdObject *fdo = NULL;
276     int rc;
277
278     if (!PyArg_ParseTupleAndKeywords(args, kwds, "O&|i", kwlist,
279                                      rpmfdFromPyObject, &fdo, &magic))
280         return NULL;
281
282     Py_BEGIN_ALLOW_THREADS;
283     rc = headerWrite(rpmfdGetFd(fdo), s->h,
284                      magic ? HEADER_MAGIC_YES : HEADER_MAGIC_NO);
285     Py_END_ALLOW_THREADS;
286
287     if (rc) PyErr_SetFromErrno(PyExc_IOError);
288     Py_XDECREF(fdo); /* avoid messing up errno with file close  */
289     if (rc) return NULL;
290
291     Py_RETURN_NONE;
292 }
293
294 static PyObject * hdr_fiFromHeader(PyObject * s, PyObject * args, PyObject * kwds)
295 {
296     /* XXX this isn't quite right wrt arg passing */
297     return PyObject_Call((PyObject *) &rpmfi_Type,
298                          Py_BuildValue("(O)", s), kwds);
299 }
300
301 static PyObject * hdr_dsFromHeader(PyObject * s, PyObject * args, PyObject * kwds)
302 {
303     /* XXX this isn't quite right wrt arg passing */
304     return PyObject_Call((PyObject *) &rpmds_Type,
305                          Py_BuildValue("(O)", s), kwds);
306 }
307
308 static PyObject * hdr_dsOfHeader(PyObject * s)
309 {
310     return PyObject_Call((PyObject *) &rpmds_Type,
311                         Py_BuildValue("(Oi)", s, RPMTAG_NEVR), NULL);
312 }
313
314 static long hdr_hash(PyObject * h)
315 {
316     return (long) h;
317 }
318
319 static struct PyMethodDef hdr_methods[] = {
320     {"keys",            (PyCFunction) hdrKeyList,       METH_NOARGS,
321         NULL },
322     {"unload",          (PyCFunction) hdrUnload,        METH_VARARGS|METH_KEYWORDS,
323         NULL },
324     {"expandFilelist",  (PyCFunction) hdrExpandFilelist,METH_NOARGS,
325         NULL },
326     {"compressFilelist",(PyCFunction) hdrCompressFilelist,METH_NOARGS,
327         NULL },
328     {"fullFilelist",    (PyCFunction) hdrFullFilelist,  METH_NOARGS,
329         NULL },
330     {"convert",         (PyCFunction) hdrConvert,       METH_VARARGS|METH_KEYWORDS,
331         NULL },
332     {"format",          (PyCFunction) hdrFormat,        METH_VARARGS|METH_KEYWORDS,
333         NULL },
334     {"has_key",         (PyCFunction) hdrHasKey,        METH_O,
335         NULL },
336     {"sprintf",         (PyCFunction) hdrFormat,        METH_VARARGS|METH_KEYWORDS,
337         NULL },
338     {"instance",        (PyCFunction)hdrInstance,       METH_NOARGS,
339         NULL },
340     {"isSource",        (PyCFunction)hdrIsSource,       METH_NOARGS, 
341         NULL },
342     {"write",           (PyCFunction)hdrWrite,          METH_VARARGS|METH_KEYWORDS,
343         NULL },
344     {"dsOfHeader",      (PyCFunction)hdr_dsOfHeader,    METH_NOARGS,
345         NULL},
346     {"dsFromHeader",    (PyCFunction)hdr_dsFromHeader,  METH_VARARGS|METH_KEYWORDS,
347         NULL},
348     {"fiFromHeader",    (PyCFunction)hdr_fiFromHeader,  METH_VARARGS|METH_KEYWORDS,
349         NULL},
350
351     {NULL,              NULL}           /* sentinel */
352 };
353
354 /* TODO: permit keyring check + retrofits on copy/load */
355 static PyObject *hdr_new(PyTypeObject *subtype, PyObject *args, PyObject *kwds)
356 {
357     PyObject *obj = NULL;
358     rpmfdObject *fdo = NULL;
359     Header h = NULL;
360     char *kwlist[] = { "obj", NULL };
361
362     if (!PyArg_ParseTupleAndKeywords(args, kwds, "|O", kwlist, &obj)) {
363         return NULL;
364     }
365
366     if (obj == NULL) {
367         h = headerNew();
368     } else if (PyCObject_Check(obj)) {
369         h = PyCObject_AsVoidPtr(obj);
370     } else if (hdrObject_Check(obj)) {
371         h = headerCopy(((hdrObject*) obj)->h);
372     } else if (PyBytes_Check(obj)) {
373         h = headerCopyLoad(PyBytes_AsString(obj));
374     } else if (rpmfdFromPyObject(obj, &fdo)) {
375         Py_BEGIN_ALLOW_THREADS;
376         h = headerRead(rpmfdGetFd(fdo), HEADER_MAGIC_YES);
377         Py_END_ALLOW_THREADS;
378         Py_XDECREF(fdo);
379     } else {
380         PyErr_SetString(PyExc_TypeError, "header, blob or file expected");
381         return NULL;
382     }
383
384     if (h == NULL) {
385         PyErr_SetString(pyrpmError, "bad header");
386         return NULL;
387     }
388     
389     return hdr_Wrap(subtype, h);
390 }
391
392 static void hdr_dealloc(hdrObject * s)
393 {
394     if (s->h) headerFree(s->h);
395     Py_TYPE(s)->tp_free((PyObject *)s);
396 }
397
398 static PyObject * hdr_iternext(hdrObject *s)
399 {
400     PyObject *res = NULL;
401     rpmTag tag;
402
403     if (s->hi == NULL) s->hi = headerInitIterator(s->h);
404
405     if ((tag = headerNextTag(s->hi)) != RPMTAG_NOT_FOUND) {
406         int raw = 1;
407         res = PyObject_Call((PyObject *) &rpmtd_Type,
408                             Py_BuildValue("(Oii)", s, tag, raw), NULL);
409     } else {
410         s->hi = headerFreeIterator(s->hi);
411     }
412     return res;
413 }
414
415 int utf8FromPyObject(PyObject *item, PyObject **str)
416 {
417     PyObject *res = NULL;
418     if (PyBytes_Check(item)) {
419         Py_XINCREF(item);
420         res = item;
421     } else if (PyUnicode_Check(item)) {
422         res = PyUnicode_AsUTF8String(item);
423     }
424     if (res == NULL) return 0;
425
426     *str = res;
427     return 1;
428 }
429
430 int tagNumFromPyObject (PyObject *item, rpmTag *tagp)
431 {
432     rpmTag tag = RPMTAG_NOT_FOUND;
433     PyObject *str = NULL;
434
435     if (PyInt_Check(item)) {
436         /* XXX we should probably validate tag numbers too */
437         tag = PyInt_AsLong(item);
438     } else if (utf8FromPyObject(item, &str)) {
439         tag = rpmTagGetValue(PyBytes_AsString(str));
440         Py_DECREF(str);
441     } else {
442         PyErr_SetString(PyExc_TypeError, "expected a string or integer");
443         return 0;
444     }
445     if (tag == RPMTAG_NOT_FOUND) {
446         PyErr_SetString(PyExc_ValueError, "unknown header tag");
447         return 0;
448     }
449
450     *tagp = tag;
451     return 1;
452 }
453
454 static PyObject * hdrGetTag(Header h, rpmTag tag)
455 {
456     PyObject *res = NULL;
457     struct rpmtd_s td;
458
459     /* rpmtd_AsPyObj() knows how to handle empty containers and all */
460     (void) headerGet(h, tag, &td, HEADERGET_EXT);
461     res = rpmtd_AsPyobj(&td);
462     rpmtdFreeData(&td);
463     return res;
464 }
465
466 static PyObject * hdr_subscript(hdrObject * s, PyObject * item)
467 {
468     rpmTag tag;
469
470     if (!tagNumFromPyObject(item, &tag)) return NULL;
471     return hdrGetTag(s->h, tag);
472 }
473
474 static int hdr_ass_subscript(hdrObject *s, PyObject *key, PyObject *value)
475 {
476     rpmTag tag;
477     rpmtd td;
478     if (!tagNumFromPyObject(key, &tag)) return -1;
479
480     if (value == NULL) {
481         /* XXX should failure raise key error? */
482         headerDel(s->h, tag);
483     } else if (rpmtdFromPyObject(value, &td)) {
484         headerPut(s->h, td, HEADERPUT_DEFAULT);
485     } else {
486         return -1;
487     }
488     return 0;
489 }
490
491 static PyObject * hdr_getattro(hdrObject * s, PyObject * n)
492 {
493     PyObject *res = PyObject_GenericGetAttr((PyObject *) s, n);
494     if (res == NULL) {
495         rpmTag tag;
496         if (tagNumFromPyObject(n, &tag)) {
497             PyErr_Clear();
498             res = hdrGetTag(s->h, tag);
499         }
500     }
501     return res;
502 }
503
504 static int hdr_setattro(PyObject * o, PyObject * n, PyObject * v)
505 {
506     return PyObject_GenericSetAttr(o, n, v);
507 }
508
509 static PyMappingMethods hdr_as_mapping = {
510         (lenfunc) 0,                    /* mp_length */
511         (binaryfunc) hdr_subscript,     /* mp_subscript */
512         (objobjargproc)hdr_ass_subscript,/* mp_ass_subscript */
513 };
514
515 static char hdr_doc[] =
516 "";
517
518 PyTypeObject hdr_Type = {
519         PyVarObject_HEAD_INIT(&PyType_Type, 0)
520         "rpm.hdr",                      /* tp_name */
521         sizeof(hdrObject),              /* tp_size */
522         0,                              /* tp_itemsize */
523         (destructor) hdr_dealloc,       /* tp_dealloc */
524         0,                              /* tp_print */
525         (getattrfunc) 0,                /* tp_getattr */
526         0,                              /* tp_setattr */
527         0,                              /* tp_compare */
528         0,                              /* tp_repr */
529         0,                              /* tp_as_number */
530         0,                              /* tp_as_sequence */
531         &hdr_as_mapping,                /* tp_as_mapping */
532         hdr_hash,                       /* tp_hash */
533         0,                              /* tp_call */
534         0,                              /* tp_str */
535         (getattrofunc) hdr_getattro,    /* tp_getattro */
536         (setattrofunc) hdr_setattro,    /* tp_setattro */
537         0,                              /* tp_as_buffer */
538         Py_TPFLAGS_DEFAULT|Py_TPFLAGS_BASETYPE, /* tp_flags */
539         hdr_doc,                        /* tp_doc */
540         0,                              /* tp_traverse */
541         0,                              /* tp_clear */
542         0,                              /* tp_richcompare */
543         0,                              /* tp_weaklistoffset */
544         PyObject_SelfIter,              /* tp_iter */
545         (iternextfunc)hdr_iternext,     /* tp_iternext */
546         hdr_methods,                    /* tp_methods */
547         0,                              /* tp_members */
548         0,                              /* tp_getset */
549         0,                              /* tp_base */
550         0,                              /* tp_dict */
551         0,                              /* tp_descr_get */
552         0,                              /* tp_descr_set */
553         0,                              /* tp_dictoffset */
554         0,                              /* tp_init */
555         0,                              /* tp_alloc */
556         hdr_new,                        /* tp_new */
557         0,                              /* tp_free */
558         0,                              /* tp_is_gc */
559 };
560
561 PyObject * hdr_Wrap(PyTypeObject *subtype, Header h)
562 {
563     hdrObject * hdr = (hdrObject *)subtype->tp_alloc(subtype, 0);
564     if (hdr == NULL) return NULL;
565
566     hdr->h = headerLink(h);
567     return (PyObject *) hdr;
568 }
569
570 int hdrFromPyObject(PyObject *item, Header *hptr)
571 {
572     if (hdrObject_Check(item)) {
573         *hptr = ((hdrObject *) item)->h;
574         return 1;
575     } else {
576         PyErr_SetString(PyExc_TypeError, "header object expected");
577         return 0;
578     }
579 }
580
581 /**
582  * This assumes the order of list matches the order of the new headers, and
583  * throws an exception if that isn't true.
584  */
585 static int rpmMergeHeaders(PyObject * list, FD_t fd, int matchTag)
586 {
587     Header h;
588     HeaderIterator hi;
589     rpmTag newMatch, oldMatch;
590     hdrObject * hdr;
591     rpm_count_t count = 0;
592     int rc = 1; /* assume failure */
593     rpmtd td = rpmtdNew();
594
595     Py_BEGIN_ALLOW_THREADS
596     h = headerRead(fd, HEADER_MAGIC_YES);
597     Py_END_ALLOW_THREADS
598
599     while (h) {
600         if (!headerGet(h, matchTag, td, HEADERGET_MINMEM)) {
601             PyErr_SetString(pyrpmError, "match tag missing in new header");
602             goto exit;
603         }
604         newMatch = rpmtdTag(td);
605         rpmtdFreeData(td);
606
607         hdr = (hdrObject *) PyList_GetItem(list, count++);
608         if (!hdr) goto exit;
609
610         if (!headerGet(hdr->h, matchTag, td, HEADERGET_MINMEM)) {
611             PyErr_SetString(pyrpmError, "match tag missing in new header");
612             goto exit;
613         }
614         oldMatch = rpmtdTag(td);
615         rpmtdFreeData(td);
616
617         if (newMatch != oldMatch) {
618             PyErr_SetString(pyrpmError, "match tag mismatch");
619             goto exit;
620         }
621
622         for (hi = headerInitIterator(h); headerNext(hi, td); rpmtdFreeData(td))
623         {
624             /* could be dupes */
625             headerDel(hdr->h, rpmtdTag(td));
626             headerPut(hdr->h, td, HEADERPUT_DEFAULT);
627         }
628
629         headerFreeIterator(hi);
630         h = headerFree(h);
631
632         Py_BEGIN_ALLOW_THREADS
633         h = headerRead(fd, HEADER_MAGIC_YES);
634         Py_END_ALLOW_THREADS
635     }
636     rc = 0;
637
638 exit:
639     rpmtdFree(td);
640     return rc;
641 }
642
643 PyObject *
644 rpmMergeHeadersFromFD(PyObject * self, PyObject * args, PyObject * kwds)
645 {
646     FD_t fd;
647     int fileno;
648     PyObject * list;
649     int rc;
650     int matchTag;
651     char * kwlist[] = {"list", "fd", "matchTag", NULL};
652
653     if (!PyArg_ParseTupleAndKeywords(args, kwds, "Oii", kwlist, &list,
654             &fileno, &matchTag))
655         return NULL;
656
657     if (!PyList_Check(list)) {
658         PyErr_SetString(PyExc_TypeError, "first parameter must be a list");
659         return NULL;
660     }
661
662     fd = fdDup(fileno);
663
664     rc = rpmMergeHeaders (list, fd, matchTag);
665     Fclose(fd);
666
667     if (rc) {
668         return NULL;
669     }
670
671     Py_RETURN_NONE;
672 }
673
674 PyObject * versionCompare (PyObject * self, PyObject * args, PyObject * kwds)
675 {
676     hdrObject * h1, * h2;
677     char * kwlist[] = {"version0", "version1", NULL};
678
679     if (!PyArg_ParseTupleAndKeywords(args, kwds, "O!O!", kwlist, &hdr_Type,
680             &h1, &hdr_Type, &h2))
681         return NULL;
682
683     return Py_BuildValue("i", rpmVersionCompare(h1->h, h2->h));
684 }
685
686 static int compare_values(const char *str1, const char *str2)
687 {
688     if (!str1 && !str2)
689         return 0;
690     else if (str1 && !str2)
691         return 1;
692     else if (!str1 && str2)
693         return -1;
694     return rpmvercmp(str1, str2);
695 }
696
697 PyObject * labelCompare (PyObject * self, PyObject * args)
698 {
699     char *v1, *r1, *v2, *r2;
700     const char *e1, *e2;
701     int rc;
702
703     if (!PyArg_ParseTuple(args, "(zzz)(zzz)",
704                         &e1, &v1, &r1, &e2, &v2, &r2))
705         return NULL;
706
707     if (e1 == NULL)     e1 = "0";
708     if (e2 == NULL)     e2 = "0";
709
710     rc = compare_values(e1, e2);
711     if (!rc) {
712         rc = compare_values(v1, v2);
713         if (!rc)
714             rc = compare_values(r1, r2);
715     }
716     return Py_BuildValue("i", rc);
717 }
718