*.[ch]: Some preparatory reformatting for the Python 3 porting.
[catacomb-python] / field.c
CommitLineData
d7ab1bab 1/* -*-c-*-
2 *
d7ab1bab 3 * Abstract fields
4 *
5 * (c) 2004 Straylight/Edgeware
6 */
7
b2687a0a 8/*----- Licensing notice --------------------------------------------------*
d7ab1bab 9 *
10 * This file is part of the Python interface to Catacomb.
11 *
12 * Catacomb/Python is free software; you can redistribute it and/or modify
13 * it under the terms of the GNU General Public License as published by
14 * the Free Software Foundation; either version 2 of the License, or
15 * (at your option) any later version.
b2687a0a 16 *
d7ab1bab 17 * Catacomb/Python is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 * GNU General Public License for more details.
b2687a0a 21 *
d7ab1bab 22 * You should have received a copy of the GNU General Public License
23 * along with Catacomb/Python; if not, write to the Free Software Foundation,
24 * Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
25 */
26
27/*----- Header files ------------------------------------------------------*/
28
29#include "catacomb-python.h"
30
31/*----- Various utilities -------------------------------------------------*/
32
33PyTypeObject *field_pytype;
34PyTypeObject *primefield_pytype;
35PyTypeObject *niceprimefield_pytype;
36PyTypeObject *binfield_pytype;
37PyTypeObject *binpolyfield_pytype;
38PyTypeObject *binnormfield_pytype;
39PyTypeObject *fe_pytype;
40
41static PyObject *fe_pynew(PyTypeObject *ty, PyObject *arg, PyObject *kw)
42{
43 PyObject *x;
44 mp *z;
827f89d7 45 static const char *const kwlist[] = { "x", 0 };
d7ab1bab 46
827f89d7 47 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O:fe", KWLIST, &x))
d7ab1bab 48 return (0);
49 if (FE_PYCHECK(x) && FE_F(x) == FIELD_F(ty)) RETURN_OBJ(x);
50 if ((z = getmp(x)) == 0) return (0);
51 z = F_IN(FIELD_F(ty), z, z);
52 return (fe_pywrap((PyObject *)ty, z));
53}
54
55static PyObject *field_dopywrap(PyTypeObject *ty, field *f)
56{
df9f8366 57 field_pyobj *fobj = newtype(ty, 0, f->ops->name);
d7ab1bab 58 fobj->f = f;
24b3d57b
MW
59 fobj->ty.ht_type.tp_basicsize = sizeof(fe_pyobj);
60 fobj->ty.ht_type.tp_base = fe_pytype;
d7ab1bab 61 Py_INCREF(fe_pytype);
24b3d57b
MW
62 fobj->ty.ht_type.tp_flags = (Py_TPFLAGS_DEFAULT |
63 Py_TPFLAGS_BASETYPE |
64 Py_TPFLAGS_CHECKTYPES |
65 Py_TPFLAGS_HEAPTYPE);
66 fobj->ty.ht_type.tp_alloc = PyType_GenericAlloc;
67 fobj->ty.ht_type.tp_free = 0;
68 fobj->ty.ht_type.tp_new = fe_pynew;
dc075750 69 typeready(&fobj->ty.ht_type);
d7ab1bab 70 return ((PyObject *)fobj);
71}
72
73PyObject *field_pywrap(field *f)
74{
75 PyTypeObject *ty;
76
20441612
MW
77 if (STRCMP(F_NAME(f), ==, "prime")) ty = primefield_pytype;
78 else if (STRCMP(F_NAME(f), ==, "niceprime")) ty = niceprimefield_pytype;
79 else if (STRCMP(F_NAME(f), ==, "binpoly")) ty = binpolyfield_pytype;
80 else if (STRCMP(F_NAME(f), ==, "binnorm")) ty = binnormfield_pytype;
d7ab1bab 81 else abort();
82 return (field_dopywrap(ty, f));
83}
84
85field *field_copy(field *f)
86{
20441612 87 if (STRCMP(F_NAME(f), ==, "prime"))
d7ab1bab 88 f = field_prime(f->m);
20441612 89 else if (STRCMP(F_NAME(f), ==, "niceprime"))
d7ab1bab 90 f = field_niceprime(f->m);
20441612 91 else if (STRCMP(F_NAME(f), ==, "binpoly"))
d7ab1bab 92 f = field_binpoly(f->m);
20441612 93 else if (STRCMP(F_NAME(f), ==, "binnorm")) {
d7ab1bab 94 fctx_binnorm *fc = (fctx_binnorm *)f;
95 f = field_binnorm(f->m, fc->ntop.r[fc->ntop.n - 1]);
96 } else
97 abort();
98 return (f);
99}
100
101PyObject *fe_pywrap(PyObject *fobj, mp *x)
102{
103 fe_pyobj *z = PyObject_New(fe_pyobj, (PyTypeObject *)fobj);
104 z->f = FIELD_F(fobj);
105 Py_INCREF(fobj);
106 z->x = x;
107 return ((PyObject *)z);
108}
109
110static mp *tofe(field *f, PyObject *o)
111{
112 mp *x = 0, *y = 0;
113
114 if (FE_PYCHECK(o)) {
115 if (FE_F(o) != f && !field_samep(FE_F(o), f)) return (0);
c62f9ebf
MW
116 y = MP_COPY(FE_X(o));
117 } else if ((x = tomp(o)) != 0) {
d7ab1bab 118 if (MP_ZEROP(x))
c62f9ebf 119 y = MP_COPY(f->zero);
d7ab1bab 120 else if (MP_EQ(x, MP_ONE))
c62f9ebf
MW
121 y = MP_COPY(f->one);
122 else
123 y = F_IN(f, MP_NEW, x);
124 MP_DROP(x);
d7ab1bab 125 }
d7ab1bab 126 return (y);
127}
128
d7ab1bab 129/*----- Field elements ----------------------------------------------------*/
130
131static int febinop(PyObject *x, PyObject *y,
132 field **f, PyObject **fobj, mp **xx, mp **yy)
133{
134 if (FE_PYCHECK(x)) *fobj = FE_FOBJ(x);
135 else if (FE_PYCHECK(y)) *fobj = FE_FOBJ(y);
136 else return (-1);
137 *f = FIELD_F(*fobj);
138 if ((*xx = tofe(*f, x)) == 0)
139 return (-1);
140 if ((*yy = tofe(*f, y)) == 0) {
141 MP_DROP(*xx);
142 return (-1);
143 }
144 return (0);
145}
146
147#define BINOP(name) \
148 static PyObject *fe_py##name(PyObject *x, PyObject *y) { \
149 PyObject *fobj; \
150 field *ff; \
151 mp *xx, *yy, *zz; \
152 if (febinop(x, y, &ff, &fobj, &xx, &yy)) RETURN_NOTIMPL; \
153 zz = ff->ops->name(ff, MP_NEW, xx, yy); \
154 MP_DROP(xx); MP_DROP(yy); \
155 return (fe_pywrap(fobj, zz)); \
156 }
157BINOP(add)
158BINOP(sub)
159BINOP(mul)
160#undef BINOP
161
162static PyObject *fe_pydiv(PyObject *x, PyObject *y)
163{
164 PyObject *fobj;
165 field *ff;
166 mp *xx, *yy;
167 PyObject *z = 0;
168 if (febinop(x, y, &ff, &fobj, &xx, &yy)) RETURN_NOTIMPL;
169 if (F_ZEROP(ff, yy)) ZDIVERR("division by zero");
170 yy = F_INV(ff, yy, yy);
171 z = fe_pywrap(fobj, F_MUL(ff, MP_NEW, xx, yy));
172end:
173 MP_DROP(xx); MP_DROP(yy);
174 return (z);
175}
176
177static PyObject *fe_pyexp(PyObject *x, PyObject *y, PyObject *z)
178{
179 field *ff;
180 mp *xx, *yy;
181
182 if (z != Py_None || !FE_PYCHECK(x) || (yy = tomp(y)) == 0)
183 RETURN_NOTIMPL;
184 ff = FE_F(x); xx = FE_X(x); MP_COPY(xx);
185 if (MP_NEGP(yy) && F_ZEROP(ff, xx)) ZDIVERR("division by zero");
186 z = fe_pywrap(FE_FOBJ(x), field_exp(ff, MP_NEW, xx, yy));
187end:
188 MP_DROP(xx); MP_DROP(yy);
189 return (z);
190}
191
192static PyObject *fe_pyneg(PyObject *x)
193{
194 return fe_pywrap(FE_FOBJ(x), FE_F(x)->ops->neg(FE_F(x), MP_NEW, FE_X(x)));
195}
196
197static PyObject *fe_pyid(PyObject *x) { RETURN_OBJ(x); }
198
199static int fe_pynonzerop(PyObject *x) { return !F_ZEROP(FE_F(x), FE_X(x)); }
200
201static PyObject *fe_pyrichcompare(PyObject *x, PyObject *y, int op)
202{
203 PyObject *fobj;
204 field *ff;
205 mp *xx, *yy;
206 int b;
207 PyObject *rc = 0;
208
209 if (febinop(x, y, &ff, &fobj, &xx, &yy)) RETURN_NOTIMPL;
210 switch (op) {
211 case Py_EQ: b = MP_EQ(xx, yy); break;
212 case Py_NE: b = !MP_EQ(xx, yy); break;
213 default: TYERR("field elements are unordered");
214 }
215 rc = getbool(b);
216end:
217 MP_DROP(xx); MP_DROP(yy);
218 return (rc);
219}
220
d6d78edc 221static Py_hash_t fe_pyhash(PyObject *me)
ab723d73 222 { return (mphash(FE_X(me))); }
d7ab1bab 223
224static int fe_pycoerce(PyObject **x, PyObject **y)
225{
226 mp *z;
227
228 if (FE_PYCHECK(*y)) {
229 if (FE_F(*x) != FE_F(*y) && !field_samep(FE_F(*x), FE_F(*y)))
230 TYERR("field mismatch");
231 Py_INCREF(*x); Py_INCREF(*y);
232 return (0);
233 }
234 if ((z = tofe(FE_F(*x), *y)) != 0) {
235 Py_INCREF(*x);
236 *y = fe_pywrap(FE_FOBJ(*x), z);
237 return (0);
238 }
239 return (1);
240
241end:
242 return (-1);
243}
244
245static PyObject *fe_pyint(PyObject *x)
246{
247 long l;
bc243788 248 PyObject *rc;
d7ab1bab 249 mp *xx = F_OUT(FE_F(x), MP_NEW, FE_X(x));
bc243788
MW
250 if (!mp_tolong_checked(xx, &l, 0)) rc = PyInt_FromLong(l);
251 else rc = mp_topylong(xx);
d7ab1bab 252 MP_DROP(xx);
bc243788 253 return (rc);
d7ab1bab 254}
255
256static PyObject *fe_pylong(PyObject *x)
257{
258 mp *xx = F_OUT(FE_F(x), MP_NEW, FE_X(x));
f368b46e 259 PyObject *rc = mp_topylong(xx);
d7ab1bab 260 MP_DROP(xx);
261 return (rc);
262}
263
264#define BASEOP(name, radix, pre) \
265 static PyObject *fe_py##name(PyObject *x) { \
266 mp *xx = F_OUT(FE_F(x), MP_NEW, FE_X(x)); \
d9782ff0 267 PyObject *rc = mp_topystring(xx, radix, 0, pre, 0); \
d7ab1bab 268 MP_DROP(xx); \
269 return (rc); \
270 }
271BASEOP(oct, 8, "0");
272BASEOP(hex, 16, "0x");
273#undef BASEOP
274
275static void fe_pydealloc(PyObject *me)
276{
277 Py_DECREF(FE_FOBJ(me));
278 MP_DROP(FE_X(me));
3aa33042 279 FREEOBJ(me);
d7ab1bab 280}
281
282#define UNOP(name, check) \
91e56f06 283 static PyObject *femeth_##name(PyObject *me) { \
d7ab1bab 284 field *f = FE_F(me); \
285 mp *x = FE_X(me); \
d7ab1bab 286 if (!f->ops->name) TYERR(#name " not supported for this field"); \
287 check \
288 x = f->ops->name(f, MP_NEW, x); \
289 if (!x) RETURN_NONE; \
290 return (fe_pywrap(FE_FOBJ(me), x)); \
291 end: \
292 return (0); \
293 }
294UNOP(inv, if (F_ZEROP(f, x)) ZDIVERR("division by zero"); )
295UNOP(sqr, ; )
296UNOP(sqrt, ; )
297UNOP(quadsolve, ; )
298UNOP(dbl, ; )
299UNOP(tpl, ; )
300UNOP(qdl, ; )
301UNOP(hlv, ; )
302#undef UNOP
303
d7ab1bab 304static PyObject *feget_value(PyObject *me, void *hunoz)
305{
306 mp *x = F_OUT(FE_F(me), MP_NEW, FE_X(me));
307 if (F_TYPE(FE_F(me)) == FTY_BINARY)
308 return (gf_pywrap(x));
309 else
310 return (mp_pywrap(x));
311}
312
313static PyObject *feget__value(PyObject *me, void *hunoz)
314{
315 mp *x = FE_X(me);
316 MP_COPY(x);
317 if (F_TYPE(FE_F(me)) == FTY_BINARY)
318 return (gf_pywrap(x));
319 else
320 return (mp_pywrap(x));
321}
322
8e923c68
MW
323static const PyMemberDef fe_pymembers[] = {
324#define MEMBERSTRUCT fe_pyobj
325 MEMRNM(field, T_OBJECT, ob_type, READONLY,
326 "X.field -> field containing X")
327#undef MEMBERSTRUCT
328 { 0 }
329};
330
c90f712e 331static const PyGetSetDef fe_pygetset[] = {
d7ab1bab 332#define GETSETNAME(op, name) fe##op##_##name
45c4c120
MW
333 GET (value, "X.value -> `natural' MP/GF representation of X")
334 GET (_value, "X._value -> internal MP/GF representation of X")
d7ab1bab 335#undef GETSETNAME
336 { 0 }
337};
338
c90f712e 339static const PyMethodDef fe_pymethods[] = {
d7ab1bab 340#define METHNAME(func) femeth_##func
91e56f06
MW
341 NAMETH(inv, "X.inv() -> X^{-1}")
342 NAMETH(sqr, "X.sqr() -> X^2")
343 NAMETH(sqrt, "X.sqrt() -> sqrt(X)")
344 NAMETH(quadsolve, "X.quadsolve() -> Y where Y^2 + Y = X (binary only)")
345 NAMETH(dbl, "X.dbl() -> 2 * X (prime only)")
346 NAMETH(tpl, "X.tpl() -> 3 * X (prime only)")
347 NAMETH(qdl, "X.qdl() -> 4 * X (prime only)")
348 NAMETH(hlv, "X.hlv() -> X/2 (prime only)")
d7ab1bab 349#undef METHNAME
350 { 0 }
351};
352
c90f712e 353static const PyNumberMethods fe_pynumber = {
d7ab1bab 354 fe_pyadd, /* @nb_add@ */
355 fe_pysub, /* @nb_subtract@ */
356 fe_pymul, /* @nb_multiply@ */
357 fe_pydiv, /* @nb_divide@ */
358 0, /* @nb_remainder@ */
359 0, /* @nb_divmod@ */
360 fe_pyexp, /* @nb_power@ */
361 fe_pyneg, /* @nb_negative@ */
362 fe_pyid, /* @nb_positive@ */
363 0, /* @nb_absolute@ */
364 fe_pynonzerop, /* @nb_nonzero@ */
365 0, /* @nb_invert@ */
366 0, /* @nb_lshift@ */
367 0, /* @nb_rshift@ */
368 0, /* @nb_and@ */
369 0, /* @nb_xor@ */
370 0, /* @nb_or@ */
371 fe_pycoerce, /* @nb_coerce@ */
372 fe_pyint, /* @nb_int@ */
373 fe_pylong, /* @nb_long@ */
374 0 /* meaningless */, /* @nb_float@ */
375 fe_pyoct, /* @nb_oct@ */
376 fe_pyhex, /* @nb_hex@ */
377
378 0, /* @nb_inplace_add@ */
379 0, /* @nb_inplace_subtract@ */
380 0, /* @nb_inplace_multiply@ */
381 0, /* @nb_inplace_divide@ */
382 0, /* @nb_inplace_remainder@ */
383 0, /* @nb_inplace_power@ */
384 0, /* @nb_inplace_lshift@ */
385 0, /* @nb_inplace_rshift@ */
386 0, /* @nb_inplace_and@ */
387 0, /* @nb_inplace_xor@ */
388 0, /* @nb_inplace_or@ */
389
390 0, /* @nb_floor_divide@ */
391 fe_pydiv, /* @nb_true_divide@ */
392 0, /* @nb_inplace_floor_divide@ */
393 0, /* @nb_inplace_true_divide@ */
a90a9c0e
MW
394
395 fe_pyint, /* @nb_index@ */
d7ab1bab 396};
397
c263b05c 398static const PyTypeObject fe_pytype_skel = {
591bf41b 399 PyVarObject_HEAD_INIT(0, 0) /* Header */
c461c9b3 400 "FE", /* @tp_name@ */
d7ab1bab 401 sizeof(fe_pyobj), /* @tp_basicsize@ */
402 0, /* @tp_itemsize@ */
403
404 fe_pydealloc, /* @tp_dealloc@ */
405 0, /* @tp_print@ */
406 0, /* @tp_getattr@ */
407 0, /* @tp_setattr@ */
408 0, /* @tp_compare@ */
409 0, /* @tp_repr@ */
c90f712e 410 PYNUMBER(fe), /* @tp_as_number@ */
d7ab1bab 411 0, /* @tp_as_sequence@ */
412 0, /* @tp_as_mapping@ */
413 fe_pyhash, /* @tp_hash@ */
414 0, /* @tp_call@ */
415 fe_pyhex, /* @tp_str@ */
416 0, /* @tp_getattro@ */
417 0, /* @tp_setattro@ */
418 0, /* @tp_as_buffer@ */
419 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
420 Py_TPFLAGS_CHECKTYPES |
421 Py_TPFLAGS_BASETYPE,
422
423 /* @tp_doc@ */
d96c882e 424 "Finite field elements, abstract base class.",
d7ab1bab 425
426 0, /* @tp_traverse@ */
427 0, /* @tp_clear@ */
428 fe_pyrichcompare, /* @tp_richcompare@ */
429 0, /* @tp_weaklistoffset@ */
430 0, /* @tp_iter@ */
963a6148 431 0, /* @tp_iternext@ */
c90f712e 432 PYMETHODS(fe), /* @tp_methods@ */
8e923c68 433 PYMEMBERS(fe), /* @tp_members@ */
c90f712e 434 PYGETSET(fe), /* @tp_getset@ */
d7ab1bab 435 0, /* @tp_base@ */
436 0, /* @tp_dict@ */
437 0, /* @tp_descr_get@ */
438 0, /* @tp_descr_set@ */
439 0, /* @tp_dictoffset@ */
440 0, /* @tp_init@ */
441 PyType_GenericAlloc, /* @tp_alloc@ */
442 abstract_pynew, /* @tp_new@ */
3aa33042 443 0, /* @tp_free@ */
d7ab1bab 444 0 /* @tp_is_gc@ */
445};
446
447/*----- Fields ------------------------------------------------------------*/
448
449static PyObject *field_pyrichcompare(PyObject *x, PyObject *y, int op)
450{
451 int b = field_samep(FIELD_F(x), FIELD_F(y));
452 switch (op) {
453 case Py_EQ: break;
454 case Py_NE: b = !b;
455 default: TYERR("can't order fields");
456 }
457 return (getbool(b));
458end:
459 return (0);
460}
461
462static PyObject *fmeth_rand(PyObject *me, PyObject *arg, PyObject *kw)
463{
827f89d7 464 static const char *const kwlist[] = { "rng", 0 };
d7ab1bab 465 grand *r = &rand_global;
466
827f89d7 467 if (!PyArg_ParseTupleAndKeywords(arg, kw, "|O&:rand", KWLIST,
d7ab1bab 468 convgrand, &r))
469 return (0);
470 return (fe_pywrap(me, F_RAND(FIELD_F(me), MP_NEW, r)));
471}
472
473static PyObject *fmeth__adopt(PyObject *me, PyObject *arg)
474{
475 mp *xx;
476 if (!PyArg_ParseTuple(arg, "O&:_adopt", convmp, &xx)) return (0);
477 return (fe_pywrap(me, xx));
478}
479
a157093f 480static PyObject *fmeth_parse(PyObject *me, PyObject *arg)
f281293c
MW
481{
482 field *f;
483 char *p;
484 PyObject *rc = 0;
485 qd_parse qd;
486
a157093f 487 if (!PyArg_ParseTuple(arg, "s:parse", &p)) goto end;
f281293c
MW
488 qd.p = p; qd.e = 0;
489 if ((f = field_parse(&qd)) == 0) VALERR(qd.e);
490 rc = Py_BuildValue("(Ns)", field_pywrap(f), qd.p);
491end:
492 return (rc);
493}
494
d7ab1bab 495static void field_pydealloc(PyObject *me)
496{
497 F_DESTROY(FIELD_F(me));
498 PyType_Type.tp_dealloc(me);
499}
500
501static PyObject *fget_zero(PyObject *me, void *hunoz)
502 { return (fe_pywrap(me, MP_COPY(FIELD_F(me)->zero))); }
503
504static PyObject *fget_one(PyObject *me, void *hunoz)
505 { return (fe_pywrap(me, MP_COPY(FIELD_F(me)->one))); }
506
507static PyObject *fget_q(PyObject *me, void *hunoz)
508 { return (mp_pywrap(MP_COPY(FIELD_F(me)->q))); }
509
510static PyObject *fget_nbits(PyObject *me, void *hunoz)
511 { return (PyInt_FromLong(FIELD_F(me)->nbits)); }
512
513static PyObject *fget_noctets(PyObject *me, void *hunoz)
514 { return (PyInt_FromLong(FIELD_F(me)->noctets)); }
515
516static PyObject *fget_name(PyObject *me, void *hunoz)
2135a6d3 517 { return (TEXT_FROMSTR(F_NAME(FIELD_F(me)))); }
d7ab1bab 518
519static PyObject *fget_type(PyObject *me, void *hunoz)
520 { return (PyInt_FromLong(F_TYPE(FIELD_F(me)))); }
521
c90f712e 522static const PyGetSetDef field_pygetset[] = {
d7ab1bab 523#define GETSETNAME(op, name) f##op##_##name
524 GET (zero, "F.zero -> field additive identity")
525 GET (one, "F.one -> field multiplicative identity")
526 GET (q, "F.q -> number of elements in field")
527 GET (nbits, "F.nbits -> bits needed to represent element")
528 GET (noctets, "F.noctets -> octetss needed to represent element")
529 GET (name, "F.name -> name of this kind of field")
530 GET (type, "F.type -> type code of this kind of field")
531#undef GETSETNAME
532 { 0 }
533};
534
c90f712e 535static const PyMethodDef field_pymethods[] = {
d7ab1bab 536#define METHNAME(name) fmeth_##name
537 METH (_adopt, "F._adopt(X) -> FE")
1df8d5fe 538 KWMETH(rand, "F.rand([rng = rand]) -> FE, uniformly distributed")
a157093f 539 SMTH (parse, "parse(STR) -> F, REST")
d7ab1bab 540#undef METHNAME
541 { 0 }
542};
543
c263b05c 544static const PyTypeObject field_pytype_skel = {
591bf41b 545 PyVarObject_HEAD_INIT(0, 0) /* Header */
c461c9b3 546 "Field", /* @tp_name@ */
d7ab1bab 547 sizeof(field_pyobj), /* @tp_basicsize@ */
548 0, /* @tp_itemsize@ */
549
550 field_pydealloc, /* @tp_dealloc@ */
551 0, /* @tp_print@ */
552 0, /* @tp_getattr@ */
553 0, /* @tp_setattr@ */
554 0, /* @tp_compare@ */
555 0, /* @tp_repr@ */
556 0, /* @tp_as_number@ */
557 0, /* @tp_as_sequence@ */
558 0, /* @tp_as_mapping@ */
559 0, /* @tp_hash@ */
560 0, /* @tp_call@ */
561 0, /* @tp_str@ */
562 0, /* @tp_getattro@ */
563 0, /* @tp_setattro@ */
564 0, /* @tp_as_buffer@ */
565 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
566 Py_TPFLAGS_BASETYPE,
567
568 /* @tp_doc@ */
d96c882e 569 "An abstract field. This is an abstract type.",
d7ab1bab 570
571 0, /* @tp_traverse@ */
572 0, /* @tp_clear@ */
573 field_pyrichcompare, /* @tp_richcompare@ */
574 0, /* @tp_weaklistoffset@ */
575 0, /* @tp_iter@ */
963a6148 576 0, /* @tp_iternext@ */
c90f712e 577 PYMETHODS(field), /* @tp_methods@ */
d7ab1bab 578 0, /* @tp_members@ */
c90f712e 579 PYGETSET(field), /* @tp_getset@ */
d7ab1bab 580 0, /* @tp_base@ */
581 0, /* @tp_dict@ */
582 0, /* @tp_descr_get@ */
583 0, /* @tp_descr_set@ */
584 0, /* @tp_dictoffset@ */
585 0, /* @tp_init@ */
586 PyType_GenericAlloc, /* @tp_alloc@ */
587 abstract_pynew, /* @tp_new@ */
3aa33042 588 0, /* @tp_free@ */
d7ab1bab 589 0 /* @tp_is_gc@ */
590};
591
592/*----- Prime fields ------------------------------------------------------*/
593
594static PyObject *primefield_pynew(PyTypeObject *ty,
595 PyObject *arg, PyObject *kw)
596{
597 mp *xx = 0;
598 field *f;
827f89d7 599 static const char *const kwlist[] = { "p", 0 };
d7ab1bab 600
827f89d7 601 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O&:primefield", KWLIST,
d7ab1bab 602 convmp, &xx))
603 goto end;
604 if ((f = field_prime(xx)) == 0)
605 VALERR("bad prime for primefield");
606 MP_DROP(xx);
607 return (field_dopywrap(ty, f));
608end:
609 mp_drop(xx);
610 return (0);
611}
612
613static PyObject *pfget_p(PyObject *me, void *hunoz)
614 { return (mp_pywrap(MP_COPY(FIELD_F(me)->m))); }
615
c90f712e 616static const PyGetSetDef primefield_pygetset[] = {
d7ab1bab 617#define GETSETNAME(op, name) pf##op##_##name
b2687a0a 618 GET (p, "F.p -> prime field characteristic")
d7ab1bab 619#undef GETSETNAME
620};
621
c263b05c 622static const PyTypeObject primefield_pytype_skel = {
591bf41b 623 PyVarObject_HEAD_INIT(0, 0) /* Header */
c461c9b3 624 "PrimeField", /* @tp_name@ */
d7ab1bab 625 sizeof(field_pyobj), /* @tp_basicsize@ */
626 0, /* @tp_itemsize@ */
627
628 field_pydealloc, /* @tp_dealloc@ */
629 0, /* @tp_print@ */
630 0, /* @tp_getattr@ */
631 0, /* @tp_setattr@ */
632 0, /* @tp_compare@ */
633 0, /* @tp_repr@ */
634 0, /* @tp_as_number@ */
635 0, /* @tp_as_sequence@ */
636 0, /* @tp_as_mapping@ */
637 0, /* @tp_hash@ */
638 0, /* @tp_call@ */
639 0, /* @tp_str@ */
640 0, /* @tp_getattro@ */
641 0, /* @tp_setattro@ */
642 0, /* @tp_as_buffer@ */
643 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
644 Py_TPFLAGS_BASETYPE,
645
646 /* @tp_doc@ */
d96c882e 647 "PrimeField(P): prime fields.",
d7ab1bab 648
649 0, /* @tp_traverse@ */
650 0, /* @tp_clear@ */
e6ed58c7 651 0, /* @tp_richcompare@ */
d7ab1bab 652 0, /* @tp_weaklistoffset@ */
653 0, /* @tp_iter@ */
963a6148 654 0, /* @tp_iternext@ */
d7ab1bab 655 0, /* @tp_methods@ */
656 0, /* @tp_members@ */
c90f712e 657 PYGETSET(primefield), /* @tp_getset@ */
d7ab1bab 658 0, /* @tp_base@ */
659 0, /* @tp_dict@ */
660 0, /* @tp_descr_get@ */
661 0, /* @tp_descr_set@ */
662 0, /* @tp_dictoffset@ */
663 0, /* @tp_init@ */
664 PyType_GenericAlloc, /* @tp_alloc@ */
665 primefield_pynew, /* @tp_new@ */
3aa33042 666 0, /* @tp_free@ */
d7ab1bab 667 0 /* @tp_is_gc@ */
668};
669
670static PyObject *niceprimefield_pynew(PyTypeObject *ty,
671 PyObject *arg, PyObject *kw)
672{
673 mp *xx = 0;
674 field *f;
827f89d7 675 static const char *const kwlist[] = { "p", 0 };
d7ab1bab 676
677 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O&:niceprimefield",
827f89d7 678 KWLIST, convmp, &xx))
d7ab1bab 679 goto end;
680 if ((f = field_niceprime(xx)) == 0)
681 VALERR("bad prime for niceprimefield");
682 MP_DROP(xx);
683 return (field_dopywrap(ty, f));
684end:
685 mp_drop(xx);
686 return (0);
687}
688
c263b05c 689static const PyTypeObject niceprimefield_pytype_skel = {
591bf41b 690 PyVarObject_HEAD_INIT(0, 0) /* Header */
c461c9b3 691 "NicePrimeField", /* @tp_name@ */
d7ab1bab 692 sizeof(field_pyobj), /* @tp_basicsize@ */
693 0, /* @tp_itemsize@ */
694
695 field_pydealloc, /* @tp_dealloc@ */
696 0, /* @tp_print@ */
697 0, /* @tp_getattr@ */
698 0, /* @tp_setattr@ */
699 0, /* @tp_compare@ */
700 0, /* @tp_repr@ */
701 0, /* @tp_as_number@ */
702 0, /* @tp_as_sequence@ */
703 0, /* @tp_as_mapping@ */
704 0, /* @tp_hash@ */
705 0, /* @tp_call@ */
706 0, /* @tp_str@ */
707 0, /* @tp_getattro@ */
708 0, /* @tp_setattro@ */
709 0, /* @tp_as_buffer@ */
710 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
711 Py_TPFLAGS_BASETYPE,
712
713 /* @tp_doc@ */
d96c882e 714 "NicePrimeField(P): prime field using Solinas reduction.",
d7ab1bab 715
716 0, /* @tp_traverse@ */
717 0, /* @tp_clear@ */
e6ed58c7 718 0, /* @tp_richcompare@ */
d7ab1bab 719 0, /* @tp_weaklistoffset@ */
720 0, /* @tp_iter@ */
963a6148 721 0, /* @tp_iternext@ */
d7ab1bab 722 0, /* @tp_methods@ */
723 0, /* @tp_members@ */
724 0, /* @tp_getset@ */
725 0, /* @tp_base@ */
726 0, /* @tp_dict@ */
727 0, /* @tp_descr_get@ */
728 0, /* @tp_descr_set@ */
729 0, /* @tp_dictoffset@ */
730 0, /* @tp_init@ */
731 PyType_GenericAlloc, /* @tp_alloc@ */
732 niceprimefield_pynew, /* @tp_new@ */
3aa33042 733 0, /* @tp_free@ */
d7ab1bab 734 0 /* @tp_is_gc@ */
735};
736
737/*----- Binary fields -----------------------------------------------------*/
738
739static PyObject *bfget_m(PyObject *me, void *hunoz)
740 { return (PyInt_FromLong(FIELD_F(me)->nbits)); }
741
05711e04
MW
742static PyObject *bfget_p(PyObject *me, void *hunoz)
743 { return (gf_pywrap(MP_COPY(FIELD_F(me)->m))); }
744
c90f712e 745static const PyGetSetDef binfield_pygetset[] = {
d7ab1bab 746#define GETSETNAME(op, name) bf##op##_##name
b2687a0a 747 GET (m, "F.m -> field polynomial degree")
05711e04 748 GET (p, "F.p -> field polynomial")
d7ab1bab 749#undef GETSETNAME
750 { 0 }
751};
752
c263b05c 753static const PyTypeObject binfield_pytype_skel = {
591bf41b 754 PyVarObject_HEAD_INIT(0, 0) /* Header */
c461c9b3 755 "BinField", /* @tp_name@ */
d7ab1bab 756 sizeof(field_pyobj), /* @tp_basicsize@ */
757 0, /* @tp_itemsize@ */
758
759 field_pydealloc, /* @tp_dealloc@ */
760 0, /* @tp_print@ */
761 0, /* @tp_getattr@ */
762 0, /* @tp_setattr@ */
763 0, /* @tp_compare@ */
764 0, /* @tp_repr@ */
765 0, /* @tp_as_number@ */
766 0, /* @tp_as_sequence@ */
767 0, /* @tp_as_mapping@ */
768 0, /* @tp_hash@ */
769 0, /* @tp_call@ */
770 0, /* @tp_str@ */
771 0, /* @tp_getattro@ */
772 0, /* @tp_setattro@ */
773 0, /* @tp_as_buffer@ */
774 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
775 Py_TPFLAGS_BASETYPE,
776
777 /* @tp_doc@ */
d96c882e 778 "Binary fields. Abstract class.",
d7ab1bab 779
780 0, /* @tp_traverse@ */
781 0, /* @tp_clear@ */
e6ed58c7 782 0, /* @tp_richcompare@ */
d7ab1bab 783 0, /* @tp_weaklistoffset@ */
784 0, /* @tp_iter@ */
963a6148 785 0, /* @tp_iternext@ */
d7ab1bab 786 0, /* @tp_methods@ */
787 0, /* @tp_members@ */
c90f712e 788 PYGETSET(binfield), /* @tp_getset@ */
d7ab1bab 789 0, /* @tp_base@ */
790 0, /* @tp_dict@ */
791 0, /* @tp_descr_get@ */
792 0, /* @tp_descr_set@ */
793 0, /* @tp_dictoffset@ */
794 0, /* @tp_init@ */
795 PyType_GenericAlloc, /* @tp_alloc@ */
796 abstract_pynew, /* @tp_new@ */
3aa33042 797 0, /* @tp_free@ */
d7ab1bab 798 0 /* @tp_is_gc@ */
799};
800
801static PyObject *binpolyfield_pynew(PyTypeObject *ty,
802 PyObject *arg, PyObject *kw)
803{
804 mp *xx = 0;
805 field *f;
827f89d7 806 static const char *const kwlist[] = { "p", 0 };
d7ab1bab 807
827f89d7 808 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O&:binpolyfield", KWLIST,
d7ab1bab 809 convgf, &xx))
810 goto end;
811 if ((f = field_binpoly(xx)) == 0) VALERR("bad poly for binpolyfield");
812 MP_DROP(xx);
813 return (field_dopywrap(ty, f));
814end:
815 mp_drop(xx);
816 return (0);
817}
818
c263b05c 819static const PyTypeObject binpolyfield_pytype_skel = {
591bf41b 820 PyVarObject_HEAD_INIT(0, 0) /* Header */
c461c9b3 821 "BinPolyField", /* @tp_name@ */
d7ab1bab 822 sizeof(field_pyobj), /* @tp_basicsize@ */
823 0, /* @tp_itemsize@ */
824
825 field_pydealloc, /* @tp_dealloc@ */
826 0, /* @tp_print@ */
827 0, /* @tp_getattr@ */
828 0, /* @tp_setattr@ */
829 0, /* @tp_compare@ */
830 0, /* @tp_repr@ */
831 0, /* @tp_as_number@ */
832 0, /* @tp_as_sequence@ */
833 0, /* @tp_as_mapping@ */
834 0, /* @tp_hash@ */
835 0, /* @tp_call@ */
836 0, /* @tp_str@ */
837 0, /* @tp_getattro@ */
838 0, /* @tp_setattro@ */
839 0, /* @tp_as_buffer@ */
840 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
841 Py_TPFLAGS_BASETYPE,
842
843 /* @tp_doc@ */
d96c882e 844 "BinPolyField(P): binary fields with polynomial basis representation.",
d7ab1bab 845
846 0, /* @tp_traverse@ */
847 0, /* @tp_clear@ */
e6ed58c7 848 0, /* @tp_richcompare@ */
d7ab1bab 849 0, /* @tp_weaklistoffset@ */
850 0, /* @tp_iter@ */
963a6148 851 0, /* @tp_iternext@ */
d7ab1bab 852 0, /* @tp_methods@ */
853 0, /* @tp_members@ */
05711e04 854 0, /* @tp_getset@ */
d7ab1bab 855 0, /* @tp_base@ */
856 0, /* @tp_dict@ */
857 0, /* @tp_descr_get@ */
858 0, /* @tp_descr_set@ */
859 0, /* @tp_dictoffset@ */
860 0, /* @tp_init@ */
861 PyType_GenericAlloc, /* @tp_alloc@ */
862 binpolyfield_pynew, /* @tp_new@ */
3aa33042 863 0, /* @tp_free@ */
d7ab1bab 864 0 /* @tp_is_gc@ */
865};
866
867static PyObject *binnormfield_pynew(PyTypeObject *ty,
868 PyObject *arg, PyObject *kw)
869{
870 mp *xx = 0, *yy = 0;
871 field *f;
827f89d7 872 static const char *const kwlist[] = { "p", "beta", 0 };
d7ab1bab 873
874 if (!PyArg_ParseTupleAndKeywords(arg, kw, "O&O&:binnormfield",
827f89d7 875 KWLIST, convgf, &xx, convgf, &yy))
d7ab1bab 876 goto end;
877 if ((f = field_binnorm(xx, yy)) == 0) VALERR("bad args for binnormfield");
878 MP_DROP(xx); MP_DROP(yy);
879 return (field_dopywrap(ty, f));
880end:
881 mp_drop(xx); mp_drop(yy);
882 return (0);
883}
884
885static PyObject *bnfget_beta(PyObject *me, void *hunoz)
886{
887 fctx_binnorm *fc = (fctx_binnorm *)FIELD_F(me);
888 return (gf_pywrap(MP_COPY(fc->ntop.r[fc->ntop.n - 1])));
889}
890
c90f712e 891static const PyGetSetDef binnormfield_pygetset[] = {
d7ab1bab 892#define GETSETNAME(op, name) bnf##op##_##name
b2687a0a 893 GET (beta, "F.beta -> conversion factor")
d7ab1bab 894#undef GETSETNAME
895 { 0 }
896};
897
c263b05c 898static const PyTypeObject binnormfield_pytype_skel = {
591bf41b 899 PyVarObject_HEAD_INIT(0, 0) /* Header */
c461c9b3 900 "BinNormField", /* @tp_name@ */
d7ab1bab 901 sizeof(field_pyobj), /* @tp_basicsize@ */
902 0, /* @tp_itemsize@ */
903
904 field_pydealloc, /* @tp_dealloc@ */
905 0, /* @tp_print@ */
906 0, /* @tp_getattr@ */
907 0, /* @tp_setattr@ */
908 0, /* @tp_compare@ */
909 0, /* @tp_repr@ */
910 0, /* @tp_as_number@ */
911 0, /* @tp_as_sequence@ */
912 0, /* @tp_as_mapping@ */
913 0, /* @tp_hash@ */
914 0, /* @tp_call@ */
915 0, /* @tp_str@ */
916 0, /* @tp_getattro@ */
917 0, /* @tp_setattro@ */
918 0, /* @tp_as_buffer@ */
919 Py_TPFLAGS_DEFAULT | /* @tp_flags@ */
920 Py_TPFLAGS_BASETYPE,
921
922 /* @tp_doc@ */
d96c882e 923 "BinNormField(P, BETA): binary fields with normal basis representation.",
d7ab1bab 924
925 0, /* @tp_traverse@ */
926 0, /* @tp_clear@ */
e6ed58c7 927 0, /* @tp_richcompare@ */
d7ab1bab 928 0, /* @tp_weaklistoffset@ */
929 0, /* @tp_iter@ */
963a6148 930 0, /* @tp_iternext@ */
d7ab1bab 931 0, /* @tp_methods@ */
932 0, /* @tp_members@ */
c90f712e 933 PYGETSET(binnormfield), /* @tp_getset@ */
d7ab1bab 934 0, /* @tp_base@ */
935 0, /* @tp_dict@ */
936 0, /* @tp_descr_get@ */
937 0, /* @tp_descr_set@ */
938 0, /* @tp_dictoffset@ */
939 0, /* @tp_init@ */
940 PyType_GenericAlloc, /* @tp_alloc@ */
941 binnormfield_pynew, /* @tp_new@ */
3aa33042 942 0, /* @tp_free@ */
d7ab1bab 943 0 /* @tp_is_gc@ */
944};
945
946/*----- Setup -------------------------------------------------------------*/
947
810542b0
MW
948static const struct nameval consts[] = {
949 CONST(FTY_PRIME), CONST(FTY_BINARY),
950 { 0 }
951};
952
d7ab1bab 953void field_pyinit(void)
954{
955 INITTYPE(fe, root);
956 INITTYPE(field, type);
957 INITTYPE(primefield, field);
958 INITTYPE(niceprimefield, primefield);
959 INITTYPE(binfield, field);
960 INITTYPE(binpolyfield, binfield);
961 INITTYPE(binnormfield, binfield);
d7ab1bab 962}
963
964void field_pyinsert(PyObject *mod)
965{
966 INSERT("FE", fe_pytype);
967 INSERT("Field", field_pytype);
968 INSERT("PrimeField", primefield_pytype);
969 INSERT("NicePrimeField", niceprimefield_pytype);
970 INSERT("BinField", binfield_pytype);
971 INSERT("BinPolyField", binpolyfield_pytype);
972 INSERT("BinNormField", binnormfield_pytype);
810542b0 973 setconstants(mod, consts);
d7ab1bab 974}
975
976/*----- That's all, folks -------------------------------------------------*/