Browse Source

Merge branch 'master' of git.labocleo.org:lodel2

Conflicts:
	examples/em_test.pickle
	plugins/webui/run.py
prieto 8 years ago
parent
commit
0b7271529c

+ 5
- 0
AUTHORS View File

@@ -0,0 +1,5 @@
1
+Arnaud Corider
2
+Roland Haroutiounian
3
+Mathieu Orban
4
+Hélène Prieto
5
+Yann Weber

+ 674
- 0
COPYING View File

@@ -0,0 +1,674 @@
1
+                    GNU GENERAL PUBLIC LICENSE
2
+                       Version 3, 29 June 2007
3
+
4
+ Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
5
+ Everyone is permitted to copy and distribute verbatim copies
6
+ of this license document, but changing it is not allowed.
7
+
8
+                            Preamble
9
+
10
+  The GNU General Public License is a free, copyleft license for
11
+software and other kinds of works.
12
+
13
+  The licenses for most software and other practical works are designed
14
+to take away your freedom to share and change the works.  By contrast,
15
+the GNU General Public License is intended to guarantee your freedom to
16
+share and change all versions of a program--to make sure it remains free
17
+software for all its users.  We, the Free Software Foundation, use the
18
+GNU General Public License for most of our software; it applies also to
19
+any other work released this way by its authors.  You can apply it to
20
+your programs, too.
21
+
22
+  When we speak of free software, we are referring to freedom, not
23
+price.  Our General Public Licenses are designed to make sure that you
24
+have the freedom to distribute copies of free software (and charge for
25
+them if you wish), that you receive source code or can get it if you
26
+want it, that you can change the software or use pieces of it in new
27
+free programs, and that you know you can do these things.
28
+
29
+  To protect your rights, we need to prevent others from denying you
30
+these rights or asking you to surrender the rights.  Therefore, you have
31
+certain responsibilities if you distribute copies of the software, or if
32
+you modify it: responsibilities to respect the freedom of others.
33
+
34
+  For example, if you distribute copies of such a program, whether
35
+gratis or for a fee, you must pass on to the recipients the same
36
+freedoms that you received.  You must make sure that they, too, receive
37
+or can get the source code.  And you must show them these terms so they
38
+know their rights.
39
+
40
+  Developers that use the GNU GPL protect your rights with two steps:
41
+(1) assert copyright on the software, and (2) offer you this License
42
+giving you legal permission to copy, distribute and/or modify it.
43
+
44
+  For the developers' and authors' protection, the GPL clearly explains
45
+that there is no warranty for this free software.  For both users' and
46
+authors' sake, the GPL requires that modified versions be marked as
47
+changed, so that their problems will not be attributed erroneously to
48
+authors of previous versions.
49
+
50
+  Some devices are designed to deny users access to install or run
51
+modified versions of the software inside them, although the manufacturer
52
+can do so.  This is fundamentally incompatible with the aim of
53
+protecting users' freedom to change the software.  The systematic
54
+pattern of such abuse occurs in the area of products for individuals to
55
+use, which is precisely where it is most unacceptable.  Therefore, we
56
+have designed this version of the GPL to prohibit the practice for those
57
+products.  If such problems arise substantially in other domains, we
58
+stand ready to extend this provision to those domains in future versions
59
+of the GPL, as needed to protect the freedom of users.
60
+
61
+  Finally, every program is threatened constantly by software patents.
62
+States should not allow patents to restrict development and use of
63
+software on general-purpose computers, but in those that do, we wish to
64
+avoid the special danger that patents applied to a free program could
65
+make it effectively proprietary.  To prevent this, the GPL assures that
66
+patents cannot be used to render the program non-free.
67
+
68
+  The precise terms and conditions for copying, distribution and
69
+modification follow.
70
+
71
+                       TERMS AND CONDITIONS
72
+
73
+  0. Definitions.
74
+
75
+  "This License" refers to version 3 of the GNU General Public License.
76
+
77
+  "Copyright" also means copyright-like laws that apply to other kinds of
78
+works, such as semiconductor masks.
79
+
80
+  "The Program" refers to any copyrightable work licensed under this
81
+License.  Each licensee is addressed as "you".  "Licensees" and
82
+"recipients" may be individuals or organizations.
83
+
84
+  To "modify" a work means to copy from or adapt all or part of the work
85
+in a fashion requiring copyright permission, other than the making of an
86
+exact copy.  The resulting work is called a "modified version" of the
87
+earlier work or a work "based on" the earlier work.
88
+
89
+  A "covered work" means either the unmodified Program or a work based
90
+on the Program.
91
+
92
+  To "propagate" a work means to do anything with it that, without
93
+permission, would make you directly or secondarily liable for
94
+infringement under applicable copyright law, except executing it on a
95
+computer or modifying a private copy.  Propagation includes copying,
96
+distribution (with or without modification), making available to the
97
+public, and in some countries other activities as well.
98
+
99
+  To "convey" a work means any kind of propagation that enables other
100
+parties to make or receive copies.  Mere interaction with a user through
101
+a computer network, with no transfer of a copy, is not conveying.
102
+
103
+  An interactive user interface displays "Appropriate Legal Notices"
104
+to the extent that it includes a convenient and prominently visible
105
+feature that (1) displays an appropriate copyright notice, and (2)
106
+tells the user that there is no warranty for the work (except to the
107
+extent that warranties are provided), that licensees may convey the
108
+work under this License, and how to view a copy of this License.  If
109
+the interface presents a list of user commands or options, such as a
110
+menu, a prominent item in the list meets this criterion.
111
+
112
+  1. Source Code.
113
+
114
+  The "source code" for a work means the preferred form of the work
115
+for making modifications to it.  "Object code" means any non-source
116
+form of a work.
117
+
118
+  A "Standard Interface" means an interface that either is an official
119
+standard defined by a recognized standards body, or, in the case of
120
+interfaces specified for a particular programming language, one that
121
+is widely used among developers working in that language.
122
+
123
+  The "System Libraries" of an executable work include anything, other
124
+than the work as a whole, that (a) is included in the normal form of
125
+packaging a Major Component, but which is not part of that Major
126
+Component, and (b) serves only to enable use of the work with that
127
+Major Component, or to implement a Standard Interface for which an
128
+implementation is available to the public in source code form.  A
129
+"Major Component", in this context, means a major essential component
130
+(kernel, window system, and so on) of the specific operating system
131
+(if any) on which the executable work runs, or a compiler used to
132
+produce the work, or an object code interpreter used to run it.
133
+
134
+  The "Corresponding Source" for a work in object code form means all
135
+the source code needed to generate, install, and (for an executable
136
+work) run the object code and to modify the work, including scripts to
137
+control those activities.  However, it does not include the work's
138
+System Libraries, or general-purpose tools or generally available free
139
+programs which are used unmodified in performing those activities but
140
+which are not part of the work.  For example, Corresponding Source
141
+includes interface definition files associated with source files for
142
+the work, and the source code for shared libraries and dynamically
143
+linked subprograms that the work is specifically designed to require,
144
+such as by intimate data communication or control flow between those
145
+subprograms and other parts of the work.
146
+
147
+  The Corresponding Source need not include anything that users
148
+can regenerate automatically from other parts of the Corresponding
149
+Source.
150
+
151
+  The Corresponding Source for a work in source code form is that
152
+same work.
153
+
154
+  2. Basic Permissions.
155
+
156
+  All rights granted under this License are granted for the term of
157
+copyright on the Program, and are irrevocable provided the stated
158
+conditions are met.  This License explicitly affirms your unlimited
159
+permission to run the unmodified Program.  The output from running a
160
+covered work is covered by this License only if the output, given its
161
+content, constitutes a covered work.  This License acknowledges your
162
+rights of fair use or other equivalent, as provided by copyright law.
163
+
164
+  You may make, run and propagate covered works that you do not
165
+convey, without conditions so long as your license otherwise remains
166
+in force.  You may convey covered works to others for the sole purpose
167
+of having them make modifications exclusively for you, or provide you
168
+with facilities for running those works, provided that you comply with
169
+the terms of this License in conveying all material for which you do
170
+not control copyright.  Those thus making or running the covered works
171
+for you must do so exclusively on your behalf, under your direction
172
+and control, on terms that prohibit them from making any copies of
173
+your copyrighted material outside their relationship with you.
174
+
175
+  Conveying under any other circumstances is permitted solely under
176
+the conditions stated below.  Sublicensing is not allowed; section 10
177
+makes it unnecessary.
178
+
179
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
180
+
181
+  No covered work shall be deemed part of an effective technological
182
+measure under any applicable law fulfilling obligations under article
183
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
184
+similar laws prohibiting or restricting circumvention of such
185
+measures.
186
+
187
+  When you convey a covered work, you waive any legal power to forbid
188
+circumvention of technological measures to the extent such circumvention
189
+is effected by exercising rights under this License with respect to
190
+the covered work, and you disclaim any intention to limit operation or
191
+modification of the work as a means of enforcing, against the work's
192
+users, your or third parties' legal rights to forbid circumvention of
193
+technological measures.
194
+
195
+  4. Conveying Verbatim Copies.
196
+
197
+  You may convey verbatim copies of the Program's source code as you
198
+receive it, in any medium, provided that you conspicuously and
199
+appropriately publish on each copy an appropriate copyright notice;
200
+keep intact all notices stating that this License and any
201
+non-permissive terms added in accord with section 7 apply to the code;
202
+keep intact all notices of the absence of any warranty; and give all
203
+recipients a copy of this License along with the Program.
204
+
205
+  You may charge any price or no price for each copy that you convey,
206
+and you may offer support or warranty protection for a fee.
207
+
208
+  5. Conveying Modified Source Versions.
209
+
210
+  You may convey a work based on the Program, or the modifications to
211
+produce it from the Program, in the form of source code under the
212
+terms of section 4, provided that you also meet all of these conditions:
213
+
214
+    a) The work must carry prominent notices stating that you modified
215
+    it, and giving a relevant date.
216
+
217
+    b) The work must carry prominent notices stating that it is
218
+    released under this License and any conditions added under section
219
+    7.  This requirement modifies the requirement in section 4 to
220
+    "keep intact all notices".
221
+
222
+    c) You must license the entire work, as a whole, under this
223
+    License to anyone who comes into possession of a copy.  This
224
+    License will therefore apply, along with any applicable section 7
225
+    additional terms, to the whole of the work, and all its parts,
226
+    regardless of how they are packaged.  This License gives no
227
+    permission to license the work in any other way, but it does not
228
+    invalidate such permission if you have separately received it.
229
+
230
+    d) If the work has interactive user interfaces, each must display
231
+    Appropriate Legal Notices; however, if the Program has interactive
232
+    interfaces that do not display Appropriate Legal Notices, your
233
+    work need not make them do so.
234
+
235
+  A compilation of a covered work with other separate and independent
236
+works, which are not by their nature extensions of the covered work,
237
+and which are not combined with it such as to form a larger program,
238
+in or on a volume of a storage or distribution medium, is called an
239
+"aggregate" if the compilation and its resulting copyright are not
240
+used to limit the access or legal rights of the compilation's users
241
+beyond what the individual works permit.  Inclusion of a covered work
242
+in an aggregate does not cause this License to apply to the other
243
+parts of the aggregate.
244
+
245
+  6. Conveying Non-Source Forms.
246
+
247
+  You may convey a covered work in object code form under the terms
248
+of sections 4 and 5, provided that you also convey the
249
+machine-readable Corresponding Source under the terms of this License,
250
+in one of these ways:
251
+
252
+    a) Convey the object code in, or embodied in, a physical product
253
+    (including a physical distribution medium), accompanied by the
254
+    Corresponding Source fixed on a durable physical medium
255
+    customarily used for software interchange.
256
+
257
+    b) Convey the object code in, or embodied in, a physical product
258
+    (including a physical distribution medium), accompanied by a
259
+    written offer, valid for at least three years and valid for as
260
+    long as you offer spare parts or customer support for that product
261
+    model, to give anyone who possesses the object code either (1) a
262
+    copy of the Corresponding Source for all the software in the
263
+    product that is covered by this License, on a durable physical
264
+    medium customarily used for software interchange, for a price no
265
+    more than your reasonable cost of physically performing this
266
+    conveying of source, or (2) access to copy the
267
+    Corresponding Source from a network server at no charge.
268
+
269
+    c) Convey individual copies of the object code with a copy of the
270
+    written offer to provide the Corresponding Source.  This
271
+    alternative is allowed only occasionally and noncommercially, and
272
+    only if you received the object code with such an offer, in accord
273
+    with subsection 6b.
274
+
275
+    d) Convey the object code by offering access from a designated
276
+    place (gratis or for a charge), and offer equivalent access to the
277
+    Corresponding Source in the same way through the same place at no
278
+    further charge.  You need not require recipients to copy the
279
+    Corresponding Source along with the object code.  If the place to
280
+    copy the object code is a network server, the Corresponding Source
281
+    may be on a different server (operated by you or a third party)
282
+    that supports equivalent copying facilities, provided you maintain
283
+    clear directions next to the object code saying where to find the
284
+    Corresponding Source.  Regardless of what server hosts the
285
+    Corresponding Source, you remain obligated to ensure that it is
286
+    available for as long as needed to satisfy these requirements.
287
+
288
+    e) Convey the object code using peer-to-peer transmission, provided
289
+    you inform other peers where the object code and Corresponding
290
+    Source of the work are being offered to the general public at no
291
+    charge under subsection 6d.
292
+
293
+  A separable portion of the object code, whose source code is excluded
294
+from the Corresponding Source as a System Library, need not be
295
+included in conveying the object code work.
296
+
297
+  A "User Product" is either (1) a "consumer product", which means any
298
+tangible personal property which is normally used for personal, family,
299
+or household purposes, or (2) anything designed or sold for incorporation
300
+into a dwelling.  In determining whether a product is a consumer product,
301
+doubtful cases shall be resolved in favor of coverage.  For a particular
302
+product received by a particular user, "normally used" refers to a
303
+typical or common use of that class of product, regardless of the status
304
+of the particular user or of the way in which the particular user
305
+actually uses, or expects or is expected to use, the product.  A product
306
+is a consumer product regardless of whether the product has substantial
307
+commercial, industrial or non-consumer uses, unless such uses represent
308
+the only significant mode of use of the product.
309
+
310
+  "Installation Information" for a User Product means any methods,
311
+procedures, authorization keys, or other information required to install
312
+and execute modified versions of a covered work in that User Product from
313
+a modified version of its Corresponding Source.  The information must
314
+suffice to ensure that the continued functioning of the modified object
315
+code is in no case prevented or interfered with solely because
316
+modification has been made.
317
+
318
+  If you convey an object code work under this section in, or with, or
319
+specifically for use in, a User Product, and the conveying occurs as
320
+part of a transaction in which the right of possession and use of the
321
+User Product is transferred to the recipient in perpetuity or for a
322
+fixed term (regardless of how the transaction is characterized), the
323
+Corresponding Source conveyed under this section must be accompanied
324
+by the Installation Information.  But this requirement does not apply
325
+if neither you nor any third party retains the ability to install
326
+modified object code on the User Product (for example, the work has
327
+been installed in ROM).
328
+
329
+  The requirement to provide Installation Information does not include a
330
+requirement to continue to provide support service, warranty, or updates
331
+for a work that has been modified or installed by the recipient, or for
332
+the User Product in which it has been modified or installed.  Access to a
333
+network may be denied when the modification itself materially and
334
+adversely affects the operation of the network or violates the rules and
335
+protocols for communication across the network.
336
+
337
+  Corresponding Source conveyed, and Installation Information provided,
338
+in accord with this section must be in a format that is publicly
339
+documented (and with an implementation available to the public in
340
+source code form), and must require no special password or key for
341
+unpacking, reading or copying.
342
+
343
+  7. Additional Terms.
344
+
345
+  "Additional permissions" are terms that supplement the terms of this
346
+License by making exceptions from one or more of its conditions.
347
+Additional permissions that are applicable to the entire Program shall
348
+be treated as though they were included in this License, to the extent
349
+that they are valid under applicable law.  If additional permissions
350
+apply only to part of the Program, that part may be used separately
351
+under those permissions, but the entire Program remains governed by
352
+this License without regard to the additional permissions.
353
+
354
+  When you convey a copy of a covered work, you may at your option
355
+remove any additional permissions from that copy, or from any part of
356
+it.  (Additional permissions may be written to require their own
357
+removal in certain cases when you modify the work.)  You may place
358
+additional permissions on material, added by you to a covered work,
359
+for which you have or can give appropriate copyright permission.
360
+
361
+  Notwithstanding any other provision of this License, for material you
362
+add to a covered work, you may (if authorized by the copyright holders of
363
+that material) supplement the terms of this License with terms:
364
+
365
+    a) Disclaiming warranty or limiting liability differently from the
366
+    terms of sections 15 and 16 of this License; or
367
+
368
+    b) Requiring preservation of specified reasonable legal notices or
369
+    author attributions in that material or in the Appropriate Legal
370
+    Notices displayed by works containing it; or
371
+
372
+    c) Prohibiting misrepresentation of the origin of that material, or
373
+    requiring that modified versions of such material be marked in
374
+    reasonable ways as different from the original version; or
375
+
376
+    d) Limiting the use for publicity purposes of names of licensors or
377
+    authors of the material; or
378
+
379
+    e) Declining to grant rights under trademark law for use of some
380
+    trade names, trademarks, or service marks; or
381
+
382
+    f) Requiring indemnification of licensors and authors of that
383
+    material by anyone who conveys the material (or modified versions of
384
+    it) with contractual assumptions of liability to the recipient, for
385
+    any liability that these contractual assumptions directly impose on
386
+    those licensors and authors.
387
+
388
+  All other non-permissive additional terms are considered "further
389
+restrictions" within the meaning of section 10.  If the Program as you
390
+received it, or any part of it, contains a notice stating that it is
391
+governed by this License along with a term that is a further
392
+restriction, you may remove that term.  If a license document contains
393
+a further restriction but permits relicensing or conveying under this
394
+License, you may add to a covered work material governed by the terms
395
+of that license document, provided that the further restriction does
396
+not survive such relicensing or conveying.
397
+
398
+  If you add terms to a covered work in accord with this section, you
399
+must place, in the relevant source files, a statement of the
400
+additional terms that apply to those files, or a notice indicating
401
+where to find the applicable terms.
402
+
403
+  Additional terms, permissive or non-permissive, may be stated in the
404
+form of a separately written license, or stated as exceptions;
405
+the above requirements apply either way.
406
+
407
+  8. Termination.
408
+
409
+  You may not propagate or modify a covered work except as expressly
410
+provided under this License.  Any attempt otherwise to propagate or
411
+modify it is void, and will automatically terminate your rights under
412
+this License (including any patent licenses granted under the third
413
+paragraph of section 11).
414
+
415
+  However, if you cease all violation of this License, then your
416
+license from a particular copyright holder is reinstated (a)
417
+provisionally, unless and until the copyright holder explicitly and
418
+finally terminates your license, and (b) permanently, if the copyright
419
+holder fails to notify you of the violation by some reasonable means
420
+prior to 60 days after the cessation.
421
+
422
+  Moreover, your license from a particular copyright holder is
423
+reinstated permanently if the copyright holder notifies you of the
424
+violation by some reasonable means, this is the first time you have
425
+received notice of violation of this License (for any work) from that
426
+copyright holder, and you cure the violation prior to 30 days after
427
+your receipt of the notice.
428
+
429
+  Termination of your rights under this section does not terminate the
430
+licenses of parties who have received copies or rights from you under
431
+this License.  If your rights have been terminated and not permanently
432
+reinstated, you do not qualify to receive new licenses for the same
433
+material under section 10.
434
+
435
+  9. Acceptance Not Required for Having Copies.
436
+
437
+  You are not required to accept this License in order to receive or
438
+run a copy of the Program.  Ancillary propagation of a covered work
439
+occurring solely as a consequence of using peer-to-peer transmission
440
+to receive a copy likewise does not require acceptance.  However,
441
+nothing other than this License grants you permission to propagate or
442
+modify any covered work.  These actions infringe copyright if you do
443
+not accept this License.  Therefore, by modifying or propagating a
444
+covered work, you indicate your acceptance of this License to do so.
445
+
446
+  10. Automatic Licensing of Downstream Recipients.
447
+
448
+  Each time you convey a covered work, the recipient automatically
449
+receives a license from the original licensors, to run, modify and
450
+propagate that work, subject to this License.  You are not responsible
451
+for enforcing compliance by third parties with this License.
452
+
453
+  An "entity transaction" is a transaction transferring control of an
454
+organization, or substantially all assets of one, or subdividing an
455
+organization, or merging organizations.  If propagation of a covered
456
+work results from an entity transaction, each party to that
457
+transaction who receives a copy of the work also receives whatever
458
+licenses to the work the party's predecessor in interest had or could
459
+give under the previous paragraph, plus a right to possession of the
460
+Corresponding Source of the work from the predecessor in interest, if
461
+the predecessor has it or can get it with reasonable efforts.
462
+
463
+  You may not impose any further restrictions on the exercise of the
464
+rights granted or affirmed under this License.  For example, you may
465
+not impose a license fee, royalty, or other charge for exercise of
466
+rights granted under this License, and you may not initiate litigation
467
+(including a cross-claim or counterclaim in a lawsuit) alleging that
468
+any patent claim is infringed by making, using, selling, offering for
469
+sale, or importing the Program or any portion of it.
470
+
471
+  11. Patents.
472
+
473
+  A "contributor" is a copyright holder who authorizes use under this
474
+License of the Program or a work on which the Program is based.  The
475
+work thus licensed is called the contributor's "contributor version".
476
+
477
+  A contributor's "essential patent claims" are all patent claims
478
+owned or controlled by the contributor, whether already acquired or
479
+hereafter acquired, that would be infringed by some manner, permitted
480
+by this License, of making, using, or selling its contributor version,
481
+but do not include claims that would be infringed only as a
482
+consequence of further modification of the contributor version.  For
483
+purposes of this definition, "control" includes the right to grant
484
+patent sublicenses in a manner consistent with the requirements of
485
+this License.
486
+
487
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
488
+patent license under the contributor's essential patent claims, to
489
+make, use, sell, offer for sale, import and otherwise run, modify and
490
+propagate the contents of its contributor version.
491
+
492
+  In the following three paragraphs, a "patent license" is any express
493
+agreement or commitment, however denominated, not to enforce a patent
494
+(such as an express permission to practice a patent or covenant not to
495
+sue for patent infringement).  To "grant" such a patent license to a
496
+party means to make such an agreement or commitment not to enforce a
497
+patent against the party.
498
+
499
+  If you convey a covered work, knowingly relying on a patent license,
500
+and the Corresponding Source of the work is not available for anyone
501
+to copy, free of charge and under the terms of this License, through a
502
+publicly available network server or other readily accessible means,
503
+then you must either (1) cause the Corresponding Source to be so
504
+available, or (2) arrange to deprive yourself of the benefit of the
505
+patent license for this particular work, or (3) arrange, in a manner
506
+consistent with the requirements of this License, to extend the patent
507
+license to downstream recipients.  "Knowingly relying" means you have
508
+actual knowledge that, but for the patent license, your conveying the
509
+covered work in a country, or your recipient's use of the covered work
510
+in a country, would infringe one or more identifiable patents in that
511
+country that you have reason to believe are valid.
512
+
513
+  If, pursuant to or in connection with a single transaction or
514
+arrangement, you convey, or propagate by procuring conveyance of, a
515
+covered work, and grant a patent license to some of the parties
516
+receiving the covered work authorizing them to use, propagate, modify
517
+or convey a specific copy of the covered work, then the patent license
518
+you grant is automatically extended to all recipients of the covered
519
+work and works based on it.
520
+
521
+  A patent license is "discriminatory" if it does not include within
522
+the scope of its coverage, prohibits the exercise of, or is
523
+conditioned on the non-exercise of one or more of the rights that are
524
+specifically granted under this License.  You may not convey a covered
525
+work if you are a party to an arrangement with a third party that is
526
+in the business of distributing software, under which you make payment
527
+to the third party based on the extent of your activity of conveying
528
+the work, and under which the third party grants, to any of the
529
+parties who would receive the covered work from you, a discriminatory
530
+patent license (a) in connection with copies of the covered work
531
+conveyed by you (or copies made from those copies), or (b) primarily
532
+for and in connection with specific products or compilations that
533
+contain the covered work, unless you entered into that arrangement,
534
+or that patent license was granted, prior to 28 March 2007.
535
+
536
+  Nothing in this License shall be construed as excluding or limiting
537
+any implied license or other defenses to infringement that may
538
+otherwise be available to you under applicable patent law.
539
+
540
+  12. No Surrender of Others' Freedom.
541
+
542
+  If conditions are imposed on you (whether by court order, agreement or
543
+otherwise) that contradict the conditions of this License, they do not
544
+excuse you from the conditions of this License.  If you cannot convey a
545
+covered work so as to satisfy simultaneously your obligations under this
546
+License and any other pertinent obligations, then as a consequence you may
547
+not convey it at all.  For example, if you agree to terms that obligate you
548
+to collect a royalty for further conveying from those to whom you convey
549
+the Program, the only way you could satisfy both those terms and this
550
+License would be to refrain entirely from conveying the Program.
551
+
552
+  13. Use with the GNU Affero General Public License.
553
+
554
+  Notwithstanding any other provision of this License, you have
555
+permission to link or combine any covered work with a work licensed
556
+under version 3 of the GNU Affero General Public License into a single
557
+combined work, and to convey the resulting work.  The terms of this
558
+License will continue to apply to the part which is the covered work,
559
+but the special requirements of the GNU Affero General Public License,
560
+section 13, concerning interaction through a network will apply to the
561
+combination as such.
562
+
563
+  14. Revised Versions of this License.
564
+
565
+  The Free Software Foundation may publish revised and/or new versions of
566
+the GNU General Public License from time to time.  Such new versions will
567
+be similar in spirit to the present version, but may differ in detail to
568
+address new problems or concerns.
569
+
570
+  Each version is given a distinguishing version number.  If the
571
+Program specifies that a certain numbered version of the GNU General
572
+Public License "or any later version" applies to it, you have the
573
+option of following the terms and conditions either of that numbered
574
+version or of any later version published by the Free Software
575
+Foundation.  If the Program does not specify a version number of the
576
+GNU General Public License, you may choose any version ever published
577
+by the Free Software Foundation.
578
+
579
+  If the Program specifies that a proxy can decide which future
580
+versions of the GNU General Public License can be used, that proxy's
581
+public statement of acceptance of a version permanently authorizes you
582
+to choose that version for the Program.
583
+
584
+  Later license versions may give you additional or different
585
+permissions.  However, no additional obligations are imposed on any
586
+author or copyright holder as a result of your choosing to follow a
587
+later version.
588
+
589
+  15. Disclaimer of Warranty.
590
+
591
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
592
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
593
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
594
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
595
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
596
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
597
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
598
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
599
+
600
+  16. Limitation of Liability.
601
+
602
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
603
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
604
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
605
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
606
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
607
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
608
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
609
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
610
+SUCH DAMAGES.
611
+
612
+  17. Interpretation of Sections 15 and 16.
613
+
614
+  If the disclaimer of warranty and limitation of liability provided
615
+above cannot be given local legal effect according to their terms,
616
+reviewing courts shall apply local law that most closely approximates
617
+an absolute waiver of all civil liability in connection with the
618
+Program, unless a warranty or assumption of liability accompanies a
619
+copy of the Program in return for a fee.
620
+
621
+                     END OF TERMS AND CONDITIONS
622
+
623
+            How to Apply These Terms to Your New Programs
624
+
625
+  If you develop a new program, and you want it to be of the greatest
626
+possible use to the public, the best way to achieve this is to make it
627
+free software which everyone can redistribute and change under these terms.
628
+
629
+  To do so, attach the following notices to the program.  It is safest
630
+to attach them to the start of each source file to most effectively
631
+state the exclusion of warranty; and each file should have at least
632
+the "copyright" line and a pointer to where the full notice is found.
633
+
634
+    <one line to give the program's name and a brief idea of what it does.>
635
+    Copyright (C) <year>  <name of author>
636
+
637
+    This program is free software: you can redistribute it and/or modify
638
+    it under the terms of the GNU General Public License as published by
639
+    the Free Software Foundation, either version 3 of the License, or
640
+    (at your option) any later version.
641
+
642
+    This program is distributed in the hope that it will be useful,
643
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
644
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
645
+    GNU General Public License for more details.
646
+
647
+    You should have received a copy of the GNU General Public License
648
+    along with this program.  If not, see <http://www.gnu.org/licenses/>.
649
+
650
+Also add information on how to contact you by electronic and paper mail.
651
+
652
+  If the program does terminal interaction, make it output a short
653
+notice like this when it starts in an interactive mode:
654
+
655
+    <program>  Copyright (C) <year>  <name of author>
656
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
657
+    This is free software, and you are welcome to redistribute it
658
+    under certain conditions; type `show c' for details.
659
+
660
+The hypothetical commands `show w' and `show c' should show the appropriate
661
+parts of the General Public License.  Of course, your program's commands
662
+might be different; for a GUI interface, you would use an "about box".
663
+
664
+  You should also get your employer (if you work as a programmer) or school,
665
+if any, to sign a "copyright disclaimer" for the program, if necessary.
666
+For more information on this, and how to apply and follow the GNU GPL, see
667
+<http://www.gnu.org/licenses/>.
668
+
669
+  The GNU General Public License does not permit incorporating your program
670
+into proprietary programs.  If your program is a subroutine library, you
671
+may consider it more useful to permit linking proprietary applications with
672
+the library.  If this is what you want to do, use the GNU Lesser General
673
+Public License instead of this License.  But first, please read
674
+<http://www.gnu.org/philosophy/why-not-lgpl.html>.

+ 0
- 0
ChangeLog View File


+ 6
- 1
Doxyfile View File

@@ -824,7 +824,12 @@ FILE_PATTERNS          = *.c \
824 824
                          *.ucf \
825 825
                          *.qsf \
826 826
                          *.as \
827
-                         *.js
827
+                         *.js \
828
+			 *.m4 \
829
+			 *.patch \
830
+			 *.ac \
831
+			 *.am \
832
+			 *.in
828 833
 
829 834
 # The RECURSIVE tag can be used to specify whether or not subdirectories should
830 835
 # be searched for input files as well.

+ 370
- 0
INSTALL View File

@@ -0,0 +1,370 @@
1
+Installation Instructions
2
+*************************
3
+
4
+Copyright (C) 1994-1996, 1999-2002, 2004-2013 Free Software Foundation,
5
+Inc.
6
+
7
+   Copying and distribution of this file, with or without modification,
8
+are permitted in any medium without royalty provided the copyright
9
+notice and this notice are preserved.  This file is offered as-is,
10
+without warranty of any kind.
11
+
12
+Basic Installation
13
+==================
14
+
15
+   Briefly, the shell command `./configure && make && make install'
16
+should configure, build, and install this package.  The following
17
+more-detailed instructions are generic; see the `README' file for
18
+instructions specific to this package.  Some packages provide this
19
+`INSTALL' file but do not implement all of the features documented
20
+below.  The lack of an optional feature in a given package is not
21
+necessarily a bug.  More recommendations for GNU packages can be found
22
+in *note Makefile Conventions: (standards)Makefile Conventions.
23
+
24
+   The `configure' shell script attempts to guess correct values for
25
+various system-dependent variables used during compilation.  It uses
26
+those values to create a `Makefile' in each directory of the package.
27
+It may also create one or more `.h' files containing system-dependent
28
+definitions.  Finally, it creates a shell script `config.status' that
29
+you can run in the future to recreate the current configuration, and a
30
+file `config.log' containing compiler output (useful mainly for
31
+debugging `configure').
32
+
33
+   It can also use an optional file (typically called `config.cache'
34
+and enabled with `--cache-file=config.cache' or simply `-C') that saves
35
+the results of its tests to speed up reconfiguring.  Caching is
36
+disabled by default to prevent problems with accidental use of stale
37
+cache files.
38
+
39
+   If you need to do unusual things to compile the package, please try
40
+to figure out how `configure' could check whether to do them, and mail
41
+diffs or instructions to the address given in the `README' so they can
42
+be considered for the next release.  If you are using the cache, and at
43
+some point `config.cache' contains results you don't want to keep, you
44
+may remove or edit it.
45
+
46
+   The file `configure.ac' (or `configure.in') is used to create
47
+`configure' by a program called `autoconf'.  You need `configure.ac' if
48
+you want to change it or regenerate `configure' using a newer version
49
+of `autoconf'.
50
+
51
+   The simplest way to compile this package is:
52
+
53
+  1. `cd' to the directory containing the package's source code and type
54
+     `./configure' to configure the package for your system.
55
+
56
+     Running `configure' might take a while.  While running, it prints
57
+     some messages telling which features it is checking for.
58
+
59
+  2. Type `make' to compile the package.
60
+
61
+  3. Optionally, type `make check' to run any self-tests that come with
62
+     the package, generally using the just-built uninstalled binaries.
63
+
64
+  4. Type `make install' to install the programs and any data files and
65
+     documentation.  When installing into a prefix owned by root, it is
66
+     recommended that the package be configured and built as a regular
67
+     user, and only the `make install' phase executed with root
68
+     privileges.
69
+
70
+  5. Optionally, type `make installcheck' to repeat any self-tests, but
71
+     this time using the binaries in their final installed location.
72
+     This target does not install anything.  Running this target as a
73
+     regular user, particularly if the prior `make install' required
74
+     root privileges, verifies that the installation completed
75
+     correctly.
76
+
77
+  6. You can remove the program binaries and object files from the
78
+     source code directory by typing `make clean'.  To also remove the
79
+     files that `configure' created (so you can compile the package for
80
+     a different kind of computer), type `make distclean'.  There is
81
+     also a `make maintainer-clean' target, but that is intended mainly
82
+     for the package's developers.  If you use it, you may have to get
83
+     all sorts of other programs in order to regenerate files that came
84
+     with the distribution.
85
+
86
+  7. Often, you can also type `make uninstall' to remove the installed
87
+     files again.  In practice, not all packages have tested that
88
+     uninstallation works correctly, even though it is required by the
89
+     GNU Coding Standards.
90
+
91
+  8. Some packages, particularly those that use Automake, provide `make
92
+     distcheck', which can by used by developers to test that all other
93
+     targets like `make install' and `make uninstall' work correctly.
94
+     This target is generally not run by end users.
95
+
96
+Compilers and Options
97
+=====================
98
+
99
+   Some systems require unusual options for compilation or linking that
100
+the `configure' script does not know about.  Run `./configure --help'
101
+for details on some of the pertinent environment variables.
102
+
103
+   You can give `configure' initial values for configuration parameters
104
+by setting variables in the command line or in the environment.  Here
105
+is an example:
106
+
107
+     ./configure CC=c99 CFLAGS=-g LIBS=-lposix
108
+
109
+   *Note Defining Variables::, for more details.
110
+
111
+Compiling For Multiple Architectures
112
+====================================
113
+
114
+   You can compile the package for more than one kind of computer at the
115
+same time, by placing the object files for each architecture in their
116
+own directory.  To do this, you can use GNU `make'.  `cd' to the
117
+directory where you want the object files and executables to go and run
118
+the `configure' script.  `configure' automatically checks for the
119
+source code in the directory that `configure' is in and in `..'.  This
120
+is known as a "VPATH" build.
121
+
122
+   With a non-GNU `make', it is safer to compile the package for one
123
+architecture at a time in the source code directory.  After you have
124
+installed the package for one architecture, use `make distclean' before
125
+reconfiguring for another architecture.
126
+
127
+   On MacOS X 10.5 and later systems, you can create libraries and
128
+executables that work on multiple system types--known as "fat" or
129
+"universal" binaries--by specifying multiple `-arch' options to the
130
+compiler but only a single `-arch' option to the preprocessor.  Like
131
+this:
132
+
133
+     ./configure CC="gcc -arch i386 -arch x86_64 -arch ppc -arch ppc64" \
134
+                 CXX="g++ -arch i386 -arch x86_64 -arch ppc -arch ppc64" \
135
+                 CPP="gcc -E" CXXCPP="g++ -E"
136
+
137
+   This is not guaranteed to produce working output in all cases, you
138
+may have to build one architecture at a time and combine the results
139
+using the `lipo' tool if you have problems.
140
+
141
+Installation Names
142
+==================
143
+
144
+   By default, `make install' installs the package's commands under
145
+`/usr/local/bin', include files under `/usr/local/include', etc.  You
146
+can specify an installation prefix other than `/usr/local' by giving
147
+`configure' the option `--prefix=PREFIX', where PREFIX must be an
148
+absolute file name.
149
+
150
+   You can specify separate installation prefixes for
151
+architecture-specific files and architecture-independent files.  If you
152
+pass the option `--exec-prefix=PREFIX' to `configure', the package uses
153
+PREFIX as the prefix for installing programs and libraries.
154
+Documentation and other data files still use the regular prefix.
155
+
156
+   In addition, if you use an unusual directory layout you can give
157
+options like `--bindir=DIR' to specify different values for particular
158
+kinds of files.  Run `configure --help' for a list of the directories
159
+you can set and what kinds of files go in them.  In general, the
160
+default for these options is expressed in terms of `${prefix}', so that
161
+specifying just `--prefix' will affect all of the other directory
162
+specifications that were not explicitly provided.
163
+
164
+   The most portable way to affect installation locations is to pass the
165
+correct locations to `configure'; however, many packages provide one or
166
+both of the following shortcuts of passing variable assignments to the
167
+`make install' command line to change installation locations without
168
+having to reconfigure or recompile.
169
+
170
+   The first method involves providing an override variable for each
171
+affected directory.  For example, `make install
172
+prefix=/alternate/directory' will choose an alternate location for all
173
+directory configuration variables that were expressed in terms of
174
+`${prefix}'.  Any directories that were specified during `configure',
175
+but not in terms of `${prefix}', must each be overridden at install
176
+time for the entire installation to be relocated.  The approach of
177
+makefile variable overrides for each directory variable is required by
178
+the GNU Coding Standards, and ideally causes no recompilation.
179
+However, some platforms have known limitations with the semantics of
180
+shared libraries that end up requiring recompilation when using this
181
+method, particularly noticeable in packages that use GNU Libtool.
182
+
183
+   The second method involves providing the `DESTDIR' variable.  For
184
+example, `make install DESTDIR=/alternate/directory' will prepend
185
+`/alternate/directory' before all installation names.  The approach of
186
+`DESTDIR' overrides is not required by the GNU Coding Standards, and
187
+does not work on platforms that have drive letters.  On the other hand,
188
+it does better at avoiding recompilation issues, and works well even
189
+when some directory options were not specified in terms of `${prefix}'
190
+at `configure' time.
191
+
192
+Optional Features
193
+=================
194
+
195
+   If the package supports it, you can cause programs to be installed
196
+with an extra prefix or suffix on their names by giving `configure' the
197
+option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
198
+
199
+   Some packages pay attention to `--enable-FEATURE' options to
200
+`configure', where FEATURE indicates an optional part of the package.
201
+They may also pay attention to `--with-PACKAGE' options, where PACKAGE
202
+is something like `gnu-as' or `x' (for the X Window System).  The
203
+`README' should mention any `--enable-' and `--with-' options that the
204
+package recognizes.
205
+
206
+   For packages that use the X Window System, `configure' can usually
207
+find the X include and library files automatically, but if it doesn't,
208
+you can use the `configure' options `--x-includes=DIR' and
209
+`--x-libraries=DIR' to specify their locations.
210
+
211
+   Some packages offer the ability to configure how verbose the
212
+execution of `make' will be.  For these packages, running `./configure
213
+--enable-silent-rules' sets the default to minimal output, which can be
214
+overridden with `make V=1'; while running `./configure
215
+--disable-silent-rules' sets the default to verbose, which can be
216
+overridden with `make V=0'.
217
+
218
+Particular systems
219
+==================
220
+
221
+   On HP-UX, the default C compiler is not ANSI C compatible.  If GNU
222
+CC is not installed, it is recommended to use the following options in
223
+order to use an ANSI C compiler:
224
+
225
+     ./configure CC="cc -Ae -D_XOPEN_SOURCE=500"
226
+
227
+and if that doesn't work, install pre-built binaries of GCC for HP-UX.
228
+
229
+   HP-UX `make' updates targets which have the same time stamps as
230
+their prerequisites, which makes it generally unusable when shipped
231
+generated files such as `configure' are involved.  Use GNU `make'
232
+instead.
233
+
234
+   On OSF/1 a.k.a. Tru64, some versions of the default C compiler cannot
235
+parse its `<wchar.h>' header file.  The option `-nodtk' can be used as
236
+a workaround.  If GNU CC is not installed, it is therefore recommended
237
+to try
238
+
239
+     ./configure CC="cc"
240
+
241
+and if that doesn't work, try
242
+
243
+     ./configure CC="cc -nodtk"
244
+
245
+   On Solaris, don't put `/usr/ucb' early in your `PATH'.  This
246
+directory contains several dysfunctional programs; working variants of
247
+these programs are available in `/usr/bin'.  So, if you need `/usr/ucb'
248
+in your `PATH', put it _after_ `/usr/bin'.
249
+
250
+   On Haiku, software installed for all users goes in `/boot/common',
251
+not `/usr/local'.  It is recommended to use the following options:
252
+
253
+     ./configure --prefix=/boot/common
254
+
255
+Specifying the System Type
256
+==========================
257
+
258
+   There may be some features `configure' cannot figure out
259
+automatically, but needs to determine by the type of machine the package
260
+will run on.  Usually, assuming the package is built to be run on the
261
+_same_ architectures, `configure' can figure that out, but if it prints
262
+a message saying it cannot guess the machine type, give it the
263
+`--build=TYPE' option.  TYPE can either be a short name for the system
264
+type, such as `sun4', or a canonical name which has the form:
265
+
266
+     CPU-COMPANY-SYSTEM
267
+
268
+where SYSTEM can have one of these forms:
269
+
270
+     OS
271
+     KERNEL-OS
272
+
273
+   See the file `config.sub' for the possible values of each field.  If
274
+`config.sub' isn't included in this package, then this package doesn't
275
+need to know the machine type.
276
+
277
+   If you are _building_ compiler tools for cross-compiling, you should
278
+use the option `--target=TYPE' to select the type of system they will
279
+produce code for.
280
+
281
+   If you want to _use_ a cross compiler, that generates code for a
282
+platform different from the build platform, you should specify the
283
+"host" platform (i.e., that on which the generated programs will
284
+eventually be run) with `--host=TYPE'.
285
+
286
+Sharing Defaults
287
+================
288
+
289
+   If you want to set default values for `configure' scripts to share,
290
+you can create a site shell script called `config.site' that gives
291
+default values for variables like `CC', `cache_file', and `prefix'.
292
+`configure' looks for `PREFIX/share/config.site' if it exists, then
293
+`PREFIX/etc/config.site' if it exists.  Or, you can set the
294
+`CONFIG_SITE' environment variable to the location of the site script.
295
+A warning: not all `configure' scripts look for a site script.
296
+
297
+Defining Variables
298
+==================
299
+
300
+   Variables not defined in a site shell script can be set in the
301
+environment passed to `configure'.  However, some packages may run
302
+configure again during the build, and the customized values of these
303
+variables may be lost.  In order to avoid this problem, you should set
304
+them in the `configure' command line, using `VAR=value'.  For example:
305
+
306
+     ./configure CC=/usr/local2/bin/gcc
307
+
308
+causes the specified `gcc' to be used as the C compiler (unless it is
309
+overridden in the site shell script).
310
+
311
+Unfortunately, this technique does not work for `CONFIG_SHELL' due to
312
+an Autoconf limitation.  Until the limitation is lifted, you can use
313
+this workaround:
314
+
315
+     CONFIG_SHELL=/bin/bash ./configure CONFIG_SHELL=/bin/bash
316
+
317
+`configure' Invocation
318
+======================
319
+
320
+   `configure' recognizes the following options to control how it
321
+operates.
322
+
323
+`--help'
324
+`-h'
325
+     Print a summary of all of the options to `configure', and exit.
326
+
327
+`--help=short'
328
+`--help=recursive'
329
+     Print a summary of the options unique to this package's
330
+     `configure', and exit.  The `short' variant lists options used
331
+     only in the top level, while the `recursive' variant lists options
332
+     also present in any nested packages.
333
+
334
+`--version'
335
+`-V'
336
+     Print the version of Autoconf used to generate the `configure'
337
+     script, and exit.
338
+
339
+`--cache-file=FILE'
340
+     Enable the cache: use and save the results of the tests in FILE,
341
+     traditionally `config.cache'.  FILE defaults to `/dev/null' to
342
+     disable caching.
343
+
344
+`--config-cache'
345
+`-C'
346
+     Alias for `--cache-file=config.cache'.
347
+
348
+`--quiet'
349
+`--silent'
350
+`-q'
351
+     Do not print messages saying which checks are being made.  To
352
+     suppress all normal output, redirect it to `/dev/null' (any error
353
+     messages will still be shown).
354
+
355
+`--srcdir=DIR'
356
+     Look for the package's source code in directory DIR.  Usually
357
+     `configure' can determine that directory automatically.
358
+
359
+`--prefix=DIR'
360
+     Use DIR as the installation prefix.  *note Installation Names::
361
+     for more details, including other options available for fine-tuning
362
+     the installation locations.
363
+
364
+`--no-create'
365
+`-n'
366
+     Run the configure checks, but stop before creating any output
367
+     files.
368
+
369
+`configure' also accepts some other, not widely useful, options.  Run
370
+`configure --help' for more details.

+ 0
- 39
Makefile View File

@@ -1,39 +0,0 @@
1
-python=python3
2
-dyncode_filename='lodel/leapi/dyncode.py'
3
-
4
-all: tests doc dyncode
5
-
6
-# generate doxygen documentation
7
-doc: cleandoc doc_graphviz
8
-	doxygen
9
-
10
-doc_graphviz:
11
-	cd doc/img/graphviz; make
12
-
13
-# Test em update ( examples/em_test.pickle )
14
-em_test:
15
-	$(python) em_test.py
16
-
17
-# generate leapi dynamic code
18
-dyncode: clean_dyn em_test
19
-	$(python) scripts/refreshdyn.py examples/em_test.pickle $(dyncode_filename) && echo -e "\n\nCode generated in $(dyncode_filename)"
20
-
21
-# run tests
22
-tests:
23
-	./runtest -v
24
-
25
-.PHONY: clean clean_dyn cleandoc cleanpyc tests
26
-
27
-clean: clean_dyn cleandoc cleanpyc
28
-
29
-cleanpyc:
30
-	-find ./ |grep -E "\.pyc$$" |xargs rm -f 2>/dev/null
31
-cleanpycache:
32
-	-find ./ -type d |grep '__pycache__' | xargs rmdir -f 2>/dev/null
33
-
34
-cleandoc:
35
-	-rm -R doc/html doc/doxygen_sqlite3.db
36
-
37
-clean_dyn:
38
-	-rm $(dyncode_filename)
39
-	

+ 41
- 0
Makefile.am View File

@@ -0,0 +1,41 @@
1
+SUBDIRS=lodel
2
+
3
+#python=/usr/bin/env python3
4
+python=@PYTHON@
5
+dyncode_filename='lodel/leapi/dyncode.py'
6
+
7
+# Doxygen doc generation targets
8
+doc:
9
+	test -z "@DOCOK@" && echo -e "\n\nUnable to generate documentation. See ./configure output for details\n\n" >&2 || make generate-doc
10
+
11
+generate-doc: clean doc_graphviz
12
+	doxygen
13
+
14
+doc_graphviz:
15
+	cd doc/img/graphviz; make
16
+
17
+# Test em update ( examples/em_test.pickle )
18
+em_test: em_test.py
19
+	$(python) em_test.py
20
+
21
+# generate leapi dynamic code
22
+dyncode: examples/em_test.pickle
23
+	$(python) scripts/refreshdyn.py examples/em_test.pickle $(dyncode_filename) && echo -e "\n\nCode generated in $(dyncode_filename)"
24
+
25
+# run tests
26
+tests:
27
+	./runtest -v
28
+
29
+check: tests
30
+checks: tests
31
+
32
+#Cleaning documentation and dyncode
33
+clean-local: cleandoc
34
+	-rm -R doc/html doc/doxygen_sqlite3.db
35
+cleandoc:
36
+	-rm $(dyncode_filename)
37
+
38
+distclean-local:
39
+	-rm -R Makefile Makefile.in autom4te.cache/ aclocal.m4 install-sh missing py-compile configure
40
+
41
+.PHONY: cleandoc tests doc

+ 0
- 0
NEWS View File


README.txt → README View File

@@ -1,6 +1,15 @@
1 1
 Dependencies :
2
-	with pip : see requirements.txt
3
-	debian stable : python3 python3-lxml python3-jinja2 python3-werkzeug python3-pymongo uwsgi-plugin-python3 mongodbd
2
+	lodel2 :
3
+		with pip : see requirements.txt
4
+		debian stable : python3 python3-lxml python3-jinja2 python3-werkzeug python3-pymongo uwsgi-plugin-python3 mongodbd
5
+	build & install :
6
+		debian stable : autoconf automake make
7
+
8
+Build & install :
9
+	./bootstrap.sh
10
+	./configure
11
+	make
12
+	make install
4 13
 
5 14
 Doxygen documentation generation :
6 15
 	dependencies: doxypy doxygen graphviz

+ 3
- 0
bootstrap.sh View File

@@ -0,0 +1,3 @@
1
+#!/bin/bash
2
+
3
+autoreconf -fvi

+ 86
- 0
configure.ac View File

@@ -0,0 +1,86 @@
1
+AC_INIT([lodel], [0.1], [contact@openedition.org])
2
+
3
+AM_INIT_AUTOMAKE
4
+
5
+AC_CONFIG_FILES([Makefile \
6
+	lodel/buildconf.py \
7
+	lodel/Makefile \
8
+	lodel/auth/Makefile \
9
+	lodel/editorial_model/Makefile \
10
+		lodel/editorial_model/translator/Makefile \
11
+	lodel/leapi/Makefile \
12
+		lodel/leapi/datahandlers/Makefile \
13
+	lodel/plugin/Makefile \
14
+	lodel/settings/Makefile \
15
+	lodel/utils/Makefile \
16
+])
17
+
18
+
19
+###
20
+#Kind of dangerous mix between default aclocal's macro and pyconfigure macros...
21
+#
22
+#pyconfigure macros are prefixed by PC_
23
+###
24
+m4_include([m4/python.m4]) # Patched version of aclocal python.m4 file
25
+m4_include([m4/python_pyconfigure.m4]) #Renamed because we use a patched version of aclocal python.m4 file
26
+m4_define(python_min_ver, 3.4.2)
27
+
28
+AM_PATH_PYTHON([3.4.2]) #init aclocal's default python support
29
+PC_INIT([3.4.2], [3.5]) #init pyconfigure aclocal's macro
30
+
31
+PC_PYTHON_VERIFY_VERSION([>=], python_min_ver, ,
32
+	[AC_MSG_ERROR(Python interpreter too old)])
33
+
34
+AC_ARG_VAR([SITEPACKAGES], [If installed in /usr or /System* specify the name of the site directory (default value "site-packages"])
35
+
36
+PC_PYTHON_CHECK_MODULE([lxml], ,
37
+	AC_MSG_ERROR([Module lxml not found but mandatory for lodel2]))
38
+#Webui deps
39
+AC_SUBST([WEBUI], 'True')
40
+PC_PYTHON_CHECK_MODULE_VERSION([jinja2], [2.7.3], [], ,
41
+	AC_MSG_WARN([Module jinja2 not found but mandatory for default web interface])
42
+	AC_SUBST([WEBUI], 'False'))
43
+PC_PYTHON_CHECK_MODULE_VERSION([werkzeug], [0.9], [], , 
44
+	AC_MSG_WARN([Module werkzeug not found but mandatory for default web interface])
45
+	AC_SUBST([WEBUI], 'False'))
46
+#Mongo datasource deps
47
+AC_SUBST([PYMONGO], 'True') #Can be found in lodel/buildconf.py
48
+PC_PYTHON_CHECK_MODULE_VERSION([pymongo], [2.7], [2.8], ,
49
+	AC_MSG_WARN([Module pymongo not found. The mongodb datasource will not be able to work])
50
+	AC_SUBST([PYMONGO], 'False')
51
+)
52
+
53
+#Documentation checks
54
+AC_SUBST([DOCOK], 'OK')
55
+AC_CHECK_PROGS([DOXYGEN], [doxygen])
56
+if test -z "$DOXYGEN";
57
+then
58
+	AC_MSG_WARN([Doxygen not found - You will not be able to generate documentation])
59
+	AC_SUBST([DOCOK], '')
60
+fi
61
+AC_CHECK_PROGS([GRAPHVIZ], [dot neato twopi])
62
+if test -z "$GRAPHVIZ";
63
+then
64
+	AC_MSG_WARN([Graphviz not found (dot executable missing) - You will not be able to generate documentation])
65
+	AC_SUBST([DOCOK], '')
66
+fi
67
+AC_CHECK_PROGS([DOXYPY], [doxypy])
68
+if test -z "$DOXYPY";
69
+then
70
+	AC_MSG_WARN([Doxypy script not found (https://pypi.python.org/pypi/doxypy/0.3) - You will not be able to generate documentation])
71
+	AC_SUBST([DOCOK], '')
72
+fi
73
+
74
+AC_OUTPUT
75
+
76
+if test -z "$DOCOK";
77
+	then AC_MSG_WARN([You will not be able to generate doxygen documentation. See up for reasons])
78
+fi
79
+
80
+if test "$WEBUI" = 'False';
81
+	then AC_MSG_WARN([Mandatory components are missing for running default web UI. See up for reasons])
82
+fi
83
+
84
+if test "$PYMONGO" = 'False';
85
+	then AC_MSG_WARN([You will not be able to user mongodb datasource. See up for reasons])
86
+fi

+ 1
- 1
install/Makefile View File

@@ -11,5 +11,5 @@ init_db:
11 11
 list_hooks: dyncode
12 12
 	$(python) -c 'import lodel_admin; lodel_admin.list_registered_hooks()'
13 13
 
14
-discover_plugins:
14
+refresh_plugins:
15 15
 	$(python) -c 'import lodel_admin; lodel_admin.update_plugin_discover_cache()'

+ 0
- 2
install/conf.d/lodel2.ini View File

@@ -1,8 +1,6 @@
1 1
 [lodel2]
2 2
 debug = False
3 3
 sitename = noname
4
-plugins_path = /foo/plugins
5
-plugins = dummy, webui, dummy_datasource
6 4
 
7 5
 [lodel2.logging.stderr]
8 6
 level = DEBUG

+ 9
- 0
lodel/Makefile.am View File

@@ -0,0 +1,9 @@
1
+SUBDIRS=auth editorial_model leapi plugin settings utils
2
+
3
+lodel_PYTHON = *.py
4
+
5
+lodeldir=$(pkgpythondir)/
6
+
7
+distclean-local:
8
+	-rm Makefile Makefile.in
9
+

+ 176
- 0
lodel/__init__.py View File

@@ -14,3 +14,179 @@ dyncode = None
14 14
 # 4. "lodel2_bootstraped" hooks are called
15 15
 # 5. "lodel2_loader_main" hooks are called (if runned from loader.py as main executable)
16 16
 #
17
+
18
+##@page lodel2_instance_admin Lodel2 instance administration
19
+#
20
+#@section lodel2_instance_adm_tools Tools
21
+#
22
+#@subsection lodel2_instance_makefile Makefile
23
+#
24
+#The Makefile allows to run automated without arguments such as :
25
+#- refresh the dynamic code using conf + EM (target **dyncode**)
26
+#- update databases (target **init_db**)
27
+#- refresh plugins list (target **refresh_plugins**)
28
+#
29
+#@subsection lodel2_instance_adm_scripts lodel_admin.py scripts
30
+#
31
+#In all instances you find a symlink named lodel_admin.py . This script
32
+#contains the code run by @ref lodel2_instance_makefile "Makefile targets"
33
+#and a main function that allows to run it as a CLI script.
34
+#
35
+#@par Script help
36
+#<pre>
37
+#usage: lodel_admin.py [-h] [-L] [ACTION] [OPTIONS [OPTIONS ...]]
38
+#
39
+#Lodel2 script runner
40
+#
41
+#positional arguments:
42
+#  ACTION              One of the following actions : discover-plugin [...]
43
+#  OPTIONS             Action options. Use lodel_admin.py ACTION -h to have
44
+#                      help on a specific action
45
+#
46
+#optional arguments:
47
+#  -h, --help          show this help message and exit
48
+#  -L, --list-actions  List available actions
49
+#</pre>
50
+#
51
+#@par Script customization
52
+#
53
+#See @ref lodel2_script_doc "Lodel2 scripting"
54
+#
55
+#
56
+
57
+##@defgroup lodel2_deployment Diffusion and deployment
58
+
59
+##@page lodel2_autotools Lodel2 and autotools integration
60
+#@ingroup lodel2_deployment
61
+#
62
+#Autotools provide a way to distribute a software on Posix platforms.
63
+#
64
+#@section lodel2_autotools_howto Howto use them
65
+#
66
+#Basically you have to run :
67
+#- <code>./bootstrap.sh</code> to generate the configure script( run 
68
+#approximatly <code>aclocal; autoconf; automake</code> or 
69
+#<code>autoreconf</code> )
70
+#- <code>./configure</code> to generate Makefile s
71
+#- <code>make</code> to build lodel2 (actually to generate lodel/buildconf.py
72
+#from @ref lodel/buildconf.py.in )
73
+#
74
+#Here is a list of most usefull targets provided by lodel2's Makefile :
75
+#- automake targets
76
+# - **all** compile the sources (don't do a lot for a script langage)
77
+# - **clean** delete compiled files (don't do a lot for a script langage)
78
+# - **distclean** enhanced comportment compared to default (delete compiled 
79
+#files and generated binary). Here it deletes everything generated by
80
+#<code>./bootstrap.sh && ./configure && make</code>
81
+# - **install** Install lodel2 (for the moment copy the lodel dir in 
82
+#the good path (configurable when running ./configure ) )
83
+# - **uninstall** Remove installed files
84
+#- lodel2 specific targets 
85
+# - **tests**, **check** and **checks** are aliases for running tests
86
+# - **doc** generate the doxygen documentation
87
+# - **em_test** refresh the example/em_test.pickle file using em_test.py
88
+# - **dyncode** generate a dyncode.py file using lefactory in
89
+#lodel/leapi/dyncode.py
90
+#
91
+#@section lodel2_autotools_why Why using autotools
92
+#
93
+#Python has a lot of packaging and distributing solutions, but none of them
94
+#is as convinent, complete, portable as GNU autotools. For example setup.py 
95
+#with distutils has no uninstall target; pip, wheel, easy-install etc brokes 
96
+#totally your distribution packaging/upgrade system etc.
97
+#
98
+#Autotools are portable, integrated by debian packaging system ( see 
99
+#checkinstall) and can support multi langages.
100
+#
101
+#@section lodel2_autotools_whatfor For doing what
102
+#
103
+#Autotools are here to allow distributing and installing Lodel2 on 
104
+#Posix OS. 
105
+#
106
+#The distribution mechanisms handles dependencies checking (NO AUTO INSTALL
107
+#WITH BINARY BLOBS !!!), compiling .py files to pyc and pyo, and copy all files
108
+#in the good directories (python libs, doc, scripts etc)
109
+#
110
+#@section lodel2_autotools_how How autotools are integrated
111
+#
112
+#What we call autotools is in fact a lot of software. In our case we use only
113
+#both of them : 
114
+#<a href="https://www.gnu.org/software/autoconf/autoconf.html#documentation">
115
+#autoconf</a> and 
116
+#<a href="https://www.gnu.org/software/automake/#documentation">automake</a>
117
+#
118
+#A python file is generated ( lodel/buildconf.py from 
119
+#@ref lodel/buildconf.py.in) containing various informations gathered during
120
+#the build process (for example the presence of pymongo or the precense of
121
+#the dependency needed by webui etc.)
122
+#
123
+#@subsection lodel2_autoconf Autoconf
124
+#
125
+#Autoconf job is to handle configure.ac file and generated the configure
126
+#script.
127
+#
128
+#@par Configure script
129
+#The configure script job is to check all dependencies fetch all
130
+#path etc. And when runned it generates all Makefile from the Makefile.in files
131
+#(see @ref lodel2_automake "below" )
132
+#
133
+#@par Autoconf macros
134
+#We use both macro family :
135
+#- <a href="https://www.gnu.org/software/automake/manual/html_node/Python.html">
136
+#default autoconf python macro</a>
137
+#- <a href="https://www.gnu.org/software/pyconfigure/manual/">
138
+#pyconfigure autoconf macros</a>
139
+#@see lodel2_autotools_problems
140
+#
141
+#@subsection lodel2_automake Automake
142
+#
143
+#Automake job is to transform the Makefile.am files into Makefile.in files.
144
+#It handles all target creation for build, clean, install, uninstall etc.
145
+#
146
+#@section lodel2_autotools_problems Encontered problems
147
+#
148
+#@ref lodel2_autoconf "Autoconf" use macro "written in m4" (not sure if m4
149
+#is the macro langage). We use two macros sources : automake default python 
150
+#support & pyconfigure automake macros.
151
+#
152
+#Those macros are broken with python3 (see 
153
+#<a href="https://bugs.launchpad.net/ubuntu/+source/python3-defaults/+bug/1408092">
154
+#the python3 sysconfig bug with debian OS</a> ). There is patched version of 
155
+#these macro in the m4 directory (and the associated patches : 
156
+#@ref m4/python.m4.patch "for automake python macros patch" and 
157
+#@ref m4/python_pyconfigure.m4.patch "for pyconfigure python macros patch")
158
+
159
+##@file m4/python.m4.patch
160
+#@ingroup lodel2_deployment
161
+#@brief Patch of automake python macro to solve a bug in pythondir retrieval 
162
+#on debian
163
+#@see https://bugs.launchpad.net/ubuntu/+source/python3-defaults/+bug/1408092
164
+
165
+##@file m4/python_pyconfigure.m4.patch
166
+#@ingroup lodel2_deployment
167
+#@brief Patch to solve a bug in pyconfigure ac macros in pythondir retrieval 
168
+#on debian
169
+#@see https://bugs.launchpad.net/ubuntu/+source/python3-defaults/+bug/1408092
170
+
171
+##@file m4/python.m4
172
+#@ingroup lodel2_deployment
173
+#@brief Automake macro for python (patched version)
174
+#@see m4/python.m4.patch
175
+
176
+
177
+##@file m4/python_pyconfigure.m4
178
+#@brief Pyconfigure automake macro (patched version)
179
+#@see m4/python_pyconfigure.m4.patch
180
+
181
+##@file configure.ac
182
+#@brief configure script model for autoconf
183
+#@ingroup lodel2_deployment
184
+
185
+##@file Makefile.am
186
+#@brief Makefile model for autotools
187
+#@ingroup lodel2_deployment
188
+
189
+##@file lodel/Makefile.am
190
+#@brief Makefile model for autotools
191
+#@ingroup lodel2_deployment
192
+

+ 5
- 0
lodel/auth/Makefile.am View File

@@ -0,0 +1,5 @@
1
+auth_PYTHON = *.py
2
+authdir=$(pkgpythondir)/auth
3
+
4
+distclean-local:
5
+	-rm Makefile Makefile.in

+ 5
- 0
lodel/buildconf.py.in View File

@@ -0,0 +1,5 @@
1
+##@brief Stores constant evaluated at build time
2
+#@note Populated by ./configure
3
+
4
+PYMONGO=@PYMONGO@
5
+WEBUI=@WEBUI@

+ 7
- 0
lodel/editorial_model/Makefile.am View File

@@ -0,0 +1,7 @@
1
+SUBDIRS=translator
2
+
3
+em_PYTHON=*.py
4
+emdir=$(pkgpythondir)/editorial_model
5
+
6
+distclean-local:
7
+	-rm Makefile Makefile.in

+ 5
- 0
lodel/editorial_model/translator/Makefile.am View File

@@ -0,0 +1,5 @@
1
+translator_PYTHON=*.py
2
+translatordir=$(pkgpythondir)/editorial_model/translator
3
+
4
+distclean-local:
5
+	-rm Makefile Makefile.in

+ 7
- 0
lodel/leapi/Makefile.am View File

@@ -0,0 +1,7 @@
1
+SUBDIRS=datahandlers
2
+
3
+leapi_PYTHON= *.py
4
+leapidir=$(pkgpythondir)/leapi
5
+
6
+distclean-local:
7
+	-rm Makefile Makefile.in

+ 5
- 0
lodel/leapi/datahandlers/Makefile.am View File

@@ -0,0 +1,5 @@
1
+dh_PYTHON=*.py
2
+dhdir=$(pkgpythondir)/leapi/datahandlers
3
+
4
+distclean-local:
5
+	-rm Makefile Makefile.in

+ 11
- 10
lodel/leapi/datahandlers/base_classes.py View File

@@ -31,7 +31,6 @@ class DataHandler(object):
31 31
     ##@brief List fields that will be exposed to the construct_data_method
32 32
     _construct_datas_deps = []
33 33
     
34
-    directly_editable = True
35 34
     ##@brief constructor
36 35
     # @param internal False | str : define whether or not a field is internal
37 36
     # @param immutable bool : indicates if the fieldtype has to be defined in child classes of LeObject or if it is
@@ -251,15 +250,11 @@ class Reference(DataHandler):
251 250
     # @param internal bool : if False, the field is not internal
252 251
     # @param **kwargs : other arguments
253 252
     def __init__(self, allowed_classes = None, back_reference = None, internal=False, **kwargs):
253
+        ##@brief set of allowed LeObject child classes
254 254
         self.__allowed_classes = set() if allowed_classes is None else set(allowed_classes)
255
-        self.allowed_classes = list() if allowed_classes is None else allowed_classes
256
-        
257
-        if back_reference is not None:
258
-            if len(back_reference) != 2:
259
-                raise ValueError("A tuple (classname, fieldname) expected but got '%s'" % back_reference)
260
-            #if not issubclass(lodel.leapi.leobject.LeObject, back_reference[0]) or not isinstance(back_reference[1], str):
261
-            #    raise TypeError("Back reference was expected to be a tuple(<class LeObject>, str) but got : (%s, %s)" % (back_reference[0], back_reference[1]))
262
-        self.__back_reference = back_reference
255
+        ##@brief Stores back references informations
256
+        self.__back_reference = None
257
+        self.__set_back_reference(back_reference)
263 258
         super().__init__(internal=internal, **kwargs)
264 259
     
265 260
     @property
@@ -271,7 +266,13 @@ class Reference(DataHandler):
271 266
         return copy.copy(self.__allowed_classes)
272 267
 
273 268
     ##@brief Set the back reference for this field.
274
-    def _set_back_reference(self, back_reference):
269
+    def __set_back_reference(self, back_reference):
270
+        if back_reference is None:
271
+            return
272
+        if len(back_reference) != 2:
273
+            raise LodelDataHandlerException("A tuple(LeObjectChild, fieldname) \
274
+expected but got '%s'" % back_reference)
275
+        
275 276
         self.__back_reference = back_reference
276 277
 
277 278
     ##@brief Check value

+ 1
- 1
lodel/leapi/datahandlers/references.py View File

@@ -74,7 +74,6 @@ class Map(MultipleRef):
74 74
 ##@brief This Reference class is designed to handler hierarchy with some constraint
75 75
 class Hierarch(MultipleRef):
76 76
     
77
-    directly_editable = False
78 77
     ##@brief Instanciate a data handler handling hierarchical relation with constraints
79 78
     # @param back_reference tuple : Here it is mandatory to have a back ref (like a parent field)
80 79
     # @param max_depth int | None :  limit of depth
@@ -91,3 +90,4 @@ class Hierarch(MultipleRef):
91 90
         else:
92 91
             return None, FieldValidationError("Set or string expected for a set field")
93 92
         return val, expt
93
+

+ 5
- 0
lodel/plugin/Makefile.am View File

@@ -0,0 +1,5 @@
1
+plugin_PYTHON=*.py
2
+plugindir=$(pkgythondir)/plugin
3
+
4
+distclean-local:
5
+	-rm Makefile Makefile.in

+ 1
- 0
lodel/plugin/__init__.py View File

@@ -1,6 +1,7 @@
1 1
 #-*- coding: utf-8 -*-
2 2
 
3 3
 ##@defgroup lodel2_plugins Plugins
4
+#@ingroup lodel2_leapi
4 5
 #
5 6
 #Groups all stuff that concerns plugins
6 7
 

+ 28
- 1
lodel/plugin/core_scripts.py View File

@@ -6,7 +6,7 @@ import lodel.plugin.scripts as lodel_script
6 6
 #@ingroup lodel2_script
7 7
 
8 8
 
9
-##@brief Implements lodel_admin.py discover-plugin action
9
+##@brief Implements lodel_admin.py **discover-plugin** action
10 10
 #@ingroup lodel2_plugins
11 11
 #@ingroup lodel2_script
12 12
 #
@@ -38,4 +38,31 @@ without modifying existing cache")
38 38
             print("\t- %s(%s) in %s" % (
39 39
                 pname, pinfos['version'], pinfos['path']))
40 40
             
41
+##@brief Implements lodel_admin.py **hooks-list** action
42
+#@ingroup lodel2_script
43
+#@ingroup lodel2_hooks
44
+class ListHooks(lodel_script.LodelScript):
45
+    _action = 'hooks-list'
46
+    _description = 'Generate a list of registered hooks once instance started'
47
+
48
+    @classmethod
49
+    def argparser_config(cls, parser):
50
+        pass
51
+
52
+    @classmethod
53
+    def run(cls, args):
54
+        import loader
55
+        loader.start()
56
+        from lodel.plugin.hooks import LodelHook
57
+        hlist = LodelHook.hook_list()
58
+        print("Registered hooks : ")
59
+        for name in sorted(hlist.keys()):
60
+            print("\t- %s is registered by :" % name)
61
+            for hfun, priority in hlist[name]:
62
+                msg = "\t\t- {modname}.{funname} with priority : {priority}"
63
+                print(msg.format(
64
+                    modname = hfun.__module__,
65
+                    funname = hfun.__name__,
66
+                    priority = priority))
67
+            print("\n")
41 68
 

+ 9
- 0
lodel/plugin/interface.py View File

@@ -25,3 +25,12 @@ class InterfacePlugin(Plugin):
25 25
             raise PluginError("Maximum one interface allowed")
26 26
         super().__init__(name)
27 27
         self._instance = self
28
+
29
+    ##@brief Clear class
30
+    #@see plugins.Plugin::clear()
31
+    @classmethod
32
+    def clear_cls(cls):
33
+        if cls._instance is not None:
34
+            inst = cls._instance
35
+            cls._instance = None
36
+            del(inst)

+ 24
- 4
lodel/plugin/plugins.py View File

@@ -7,7 +7,6 @@ import copy
7 7
 import json
8 8
 from importlib.machinery import SourceFileLoader, SourcelessFileLoader
9 9
 
10
-import plugins
11 10
 from lodel import logger
12 11
 from lodel.settings.utils import SettingsError
13 12
 from .exceptions import *
@@ -216,6 +215,13 @@ class MetaPlugType(type):
216 215
         if ptype_name not in cls._all_ptypes:
217 216
             raise PluginError("Unknown plugin type '%s'" % ptype_name)
218 217
         return cls._all_ptypes[ptype_name]
218
+    
219
+    ##@brief Call the clear classmethod on each child classes
220
+    @classmethod
221
+    def clear_cls(cls):
222
+        for pcls in cls._all_ptypes.values():
223
+            pcls.clear_cls()
224
+        
219 225
 
220 226
 ##@brief Handle plugins
221 227
 #@ingroup lodel2_plugins
@@ -254,6 +260,12 @@ class Plugin(object, metaclass=MetaPlugType):
254 260
     #None in abstract classes and implemented by child classes
255 261
     _type_conf_name = None
256 262
 
263
+    ##@brief Stores virtual modules uniq key
264
+    #@note When testing if a dir contains a plugin, if we reimport the __init__
265
+    #in a module with the same name, all non existing value (plugin_type for
266
+    #example) are replaced by previous plugin values
267
+    _mod_cnt = 0
268
+
257 269
     ##@brief Plugin class constructor
258 270
     #
259 271
     # Called by setting in early stage of lodel2 boot sequence using classmethod
@@ -656,6 +668,12 @@ file : '%s'. Running discover again..." % DISCOVER_CACHE_FILENAME)
656 668
             cls._plugin_instances = dict()
657 669
         if cls._load_called != []:
658 670
             cls._load_called = []
671
+        MetaPlugType.clear_cls()
672
+    
673
+    ##@brief Designed to be implemented by child classes
674
+    @classmethod
675
+    def clear_cls(cls):
676
+        pass
659 677
     
660 678
     ##@brief Reccursively walk throught paths to find plugin, then stores
661 679
     #found plugin in a file...
@@ -684,6 +702,7 @@ file : '%s'. Running discover again..." % DISCOVER_CACHE_FILENAME)
684 702
                 #dropped
685 703
                 pass
686 704
         result = {'path_list': paths, 'plugins': result}
705
+        print("DEUG ",result['plugins'])
687 706
         #Writing to cache
688 707
         if not no_cache:
689 708
             with open(DISCOVER_CACHE_FILENAME, 'w+') as pdcache:
@@ -789,11 +808,12 @@ file : '%s'. Running discover again..." % DISCOVER_CACHE_FILENAME)
789 808
     #@param path str : Directory path
790 809
     #@return a tuple (init_module, module_name)
791 810
     @classmethod
792
-    def import_init(self, path):
811
+    def import_init(cls, path):
812
+        cls._mod_cnt += 1 # in order to ensure module name unicity
793 813
         init_source = os.path.join(path, INIT_FILENAME)
794
-        temp_module = '%s.%s.%s' % (
814
+        temp_module = '%s.%s.%s%d' % (
795 815
             VIRTUAL_TEMP_PACKAGE_NAME, os.path.basename(os.path.dirname(path)),
796
-            'test_init')
816
+            'test_init', cls._mod_cnt)
797 817
         try:
798 818
             loader = SourceFileLoader(temp_module, init_source)
799 819
         except (ImportError, FileNotFoundError) as e:

+ 42
- 1
lodel/plugin/scripts.py View File

@@ -21,7 +21,7 @@ __registered_scripts = dict()
21 21
 #@ingroup lodel2_script
22 22
 #@ingroup lodel2_plugins
23 23
 #
24
-#Automatic script registration on child class declaration
24
+#Automatic action registration on child class declaration
25 25
 class MetaLodelScript(type):
26 26
     
27 27
     def __init__(self, name, bases, attrs):
@@ -177,3 +177,44 @@ def main_run():
177 177
     ret = script._run()
178 178
     ret = 0 if ret is None else ret
179 179
     exit(ret)
180
+
181
+##@page lodel2_script_doc Lodel2 scripting
182
+#@ingroup lodel2_script
183
+#
184
+#@section lodel2_script_adm Lodel2 instance administration scripts
185
+#
186
+#Lodel2 provides instance administration operation using Makefiles or 
187
+#lodel_admin.py script ( see @ref lodel2_instance_admin ).
188
+#
189
+#The lodel_admin.py script take as first option an action. Each action
190
+#correspond to a sub-script with it's own options etc. To get a list
191
+#of all available action run <code>python3 lodel_admin.py -L</code>.
192
+#
193
+#@section lodel2_script_action lodel_admin.py actions
194
+#
195
+#Action implementation is done by class inheritance. To create a new action
196
+#write a @ref lodel.plugin.scripts.LodelScript "LodelScript" derived class (
197
+#see @ref lodel.plugin.core_scripts "core_scripts.py" file as example )
198
+#
199
+#@subsection lodel2_script_inheritance LodelScript inheritance
200
+#
201
+#In order to implement properly a new action you have to write a new 
202
+#@ref lodel.plugin.scripts.LodelScript "LodelScript" derivated class.
203
+#Some methods and attributes are mandatory to write a fully functionnal
204
+#derivated class. Here is a list :
205
+#
206
+#- mandatory methods
207
+# - @ref plugin.scripts.LodelScript.argparser_config() "argparser_config()" :
208
+#(classmethod) initialize argparse.Parser
209
+# - @ref plugin.scripts.LodelScript.run() "run()" : (classmethod) contains the
210
+#code that runs to perform the action
211
+#- mandatory attributes
212
+# - @ref plugin.scripts.LodelScript::_action "_action" : (class attribute)
213
+#stores action name
214
+# - @ref plugin.scripts.LodelScript::_description "_description" : (class 
215
+#attribute) sotres a short action description
216
+#
217
+#@note On script's action registration : once child class is written you only
218
+#need to import it to trigger script's action registration (see
219
+#@ref plugin.scripts.MetaLodelScript )
220
+#

+ 9
- 0
lodel/plugin/sessionhandler.py View File

@@ -57,3 +57,12 @@ class SessionHandlerPlugin(Plugin, metaclass=SessionPluginWrapper):
57 57
             self.__class__._instance = self
58 58
         else:
59 59
             raise RuntimeError("A SessionHandler Plugin is already plug")
60
+    
61
+    ##@brief Clear class
62
+    #@see plugins.Plugin::clear()
63
+    @classmethod
64
+    def clear_cls(cls):
65
+        if cls._instance is not None:
66
+            inst = cls._instance
67
+            cls._instance = None
68
+            del(inst)

+ 5
- 0
lodel/settings/Makefile.am View File

@@ -0,0 +1,5 @@
1
+settings_PYTHON=*.py
2
+settingsdir=$(pkgpythondir)/settings
3
+
4
+distclean-local:
5
+	-rm Makefile Makefile.in

+ 5
- 0
lodel/utils/Makefile.am View File

@@ -0,0 +1,5 @@
1
+utils_PYTHON=*.py
2
+utilsdir=$(pkgpythondir)/utils
3
+
4
+distclean-local:
5
+	-rm Makefile Makefile.in

+ 243
- 0
m4/python.m4 View File

@@ -0,0 +1,243 @@
1
+## ------------------------                                 -*- Autoconf -*-
2
+## Python file handling
3
+## From Andrew Dalke
4
+## Updated by James Henstridge
5
+## ------------------------
6
+# Copyright (C) 1999-2013 Free Software Foundation, Inc.
7
+#
8
+# This file is free software; the Free Software Foundation
9
+# gives unlimited permission to copy and/or distribute it,
10
+# with or without modifications, as long as this notice is preserved.
11
+
12
+
13
+# AM_PATH_PYTHON([MINIMUM-VERSION], [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])
14
+# ---------------------------------------------------------------------------
15
+# Adds support for distributing Python modules and packages.  To
16
+# install modules, copy them to $(pythondir), using the python_PYTHON
17
+# automake variable.  To install a package with the same name as the
18
+# automake package, install to $(pkgpythondir), or use the
19
+# pkgpython_PYTHON automake variable.
20
+#
21
+# The variables $(pyexecdir) and $(pkgpyexecdir) are provided as
22
+# locations to install python extension modules (shared libraries).
23
+# Another macro is required to find the appropriate flags to compile
24
+# extension modules.
25
+#
26
+# If your package is configured with a different prefix to python,
27
+# users will have to add the install directory to the PYTHONPATH
28
+# environment variable, or create a .pth file (see the python
29
+# documentation for details).
30
+#
31
+# If the MINIMUM-VERSION argument is passed, AM_PATH_PYTHON will
32
+# cause an error if the version of python installed on the system
33
+# doesn't meet the requirement.  MINIMUM-VERSION should consist of
34
+# numbers and dots only.
35
+AC_DEFUN([AM_PATH_PYTHON],
36
+ [
37
+  dnl Find a Python interpreter.  Python versions prior to 2.0 are not
38
+  dnl supported. (2.0 was released on October 16, 2000).
39
+  m4_define_default([_AM_PYTHON_INTERPRETER_LIST],
40
+[python python2 python3 python3.3 python3.2 python3.1 python3.0 python2.7 dnl
41
+ python2.6 python2.5 python2.4 python2.3 python2.2 python2.1 python2.0])
42
+
43
+  AC_ARG_VAR([PYTHON], [the Python interpreter])
44
+
45
+  m4_if([$1],[],[
46
+    dnl No version check is needed.
47
+    # Find any Python interpreter.
48
+    if test -z "$PYTHON"; then
49
+      AC_PATH_PROGS([PYTHON], _AM_PYTHON_INTERPRETER_LIST, :)
50
+    fi
51
+    am_display_PYTHON=python
52
+  ], [
53
+    dnl A version check is needed.
54
+    if test -n "$PYTHON"; then
55
+      # If the user set $PYTHON, use it and don't search something else.
56
+      AC_MSG_CHECKING([whether $PYTHON version is >= $1])
57
+      AM_PYTHON_CHECK_VERSION([$PYTHON], [$1],
58
+			      [AC_MSG_RESULT([yes])],
59
+			      [AC_MSG_RESULT([no])
60
+			       AC_MSG_ERROR([Python interpreter is too old])])
61
+      am_display_PYTHON=$PYTHON
62
+    else
63
+      # Otherwise, try each interpreter until we find one that satisfies
64
+      # VERSION.
65
+      AC_CACHE_CHECK([for a Python interpreter with version >= $1],
66
+	[am_cv_pathless_PYTHON],[
67
+	for am_cv_pathless_PYTHON in _AM_PYTHON_INTERPRETER_LIST none; do
68
+	  test "$am_cv_pathless_PYTHON" = none && break
69
+	  AM_PYTHON_CHECK_VERSION([$am_cv_pathless_PYTHON], [$1], [break])
70
+	done])
71
+      # Set $PYTHON to the absolute path of $am_cv_pathless_PYTHON.
72
+      if test "$am_cv_pathless_PYTHON" = none; then
73
+	PYTHON=:
74
+      else
75
+        AC_PATH_PROG([PYTHON], [$am_cv_pathless_PYTHON])
76
+      fi
77
+      am_display_PYTHON=$am_cv_pathless_PYTHON
78
+    fi
79
+  ])
80
+
81
+  if test "$PYTHON" = :; then
82
+  dnl Run any user-specified action, or abort.
83
+    m4_default([$3], [AC_MSG_ERROR([no suitable Python interpreter found])])
84
+  else
85
+
86
+  dnl Query Python for its version number.  Getting [:3] seems to be
87
+  dnl the best way to do this; it's what "site.py" does in the standard
88
+  dnl library.
89
+
90
+  AC_CACHE_CHECK([for $am_display_PYTHON version], [am_cv_python_version],
91
+    [am_cv_python_version=`$PYTHON -c "import sys; sys.stdout.write(sys.version[[:3]])"`])
92
+  AC_SUBST([PYTHON_VERSION], [$am_cv_python_version])
93
+
94
+  dnl Use the values of $prefix and $exec_prefix for the corresponding
95
+  dnl values of PYTHON_PREFIX and PYTHON_EXEC_PREFIX.  These are made
96
+  dnl distinct variables so they can be overridden if need be.  However,
97
+  dnl general consensus is that you shouldn't need this ability.
98
+
99
+  AC_SUBST([PYTHON_PREFIX], ['${prefix}'])
100
+  AC_SUBST([PYTHON_EXEC_PREFIX], ['${exec_prefix}'])
101
+
102
+  dnl At times (like when building shared libraries) you may want
103
+  dnl to know which OS platform Python thinks this is.
104
+
105
+  AC_CACHE_CHECK([for $am_display_PYTHON platform], [am_cv_python_platform],
106
+    [am_cv_python_platform=`$PYTHON -c "import sys; sys.stdout.write(sys.platform)"`])
107
+  AC_SUBST([PYTHON_PLATFORM], [$am_cv_python_platform])
108
+
109
+  # Just factor out some code duplication.
110
+  am_python_setup_sysconfig="\
111
+import sys
112
+# Prefer sysconfig over distutils.sysconfig, for better compatibility
113
+# with python 3.x.  See automake bug#10227.
114
+# But not see <https://bugs.launchpad.net/ubuntu/+source/python3-defaults/+bug/1408092>
115
+try:
116
+    import sysconfig
117
+except ImportError:
118
+    can_use_sysconfig = 0
119
+else:
120
+    can_use_sysconfig = 1
121
+# Can't use sysconfig in CPython 2.7, since it's broken in virtualenvs:
122
+# <https://github.com/pypa/virtualenv/issues/118>
123
+# Can't use sysconfig in CPython > 3.0 in debian since it's broken :
124
+# <https://bugs.launchpad.net/ubuntu/+source/python3-defaults/+bug/1408092>
125
+try:
126
+    from platform import python_implementation
127
+    if python_implementation() == 'CPython' and ( \
128
+            float(sys.version[[:3]]) > 3.0 or sys.version[[:3]] == '2.7'):
129
+        can_use_sysconfig = 0
130
+except ImportError:
131
+    pass"
132
+
133
+  dnl Set up 4 directories:
134
+
135
+  dnl pythondir -- where to install python scripts.  This is the
136
+  dnl   site-packages directory, not the python standard library
137
+  dnl   directory like in previous automake betas.  This behavior
138
+  dnl   is more consistent with lispdir.m4 for example.
139
+  dnl Query distutils for this directory.
140
+  AC_CACHE_CHECK([for $am_display_PYTHON script directory],
141
+    [am_cv_python_pythondir],
142
+    [if test "x$prefix" = xNONE
143
+     then
144
+       am_py_prefix=$ac_default_prefix
145
+     else
146
+       am_py_prefix=$prefix
147
+     fi
148
+     am_cv_python_pythondir=`$PYTHON -c "
149
+$am_python_setup_sysconfig
150
+if can_use_sysconfig:
151
+    sitedir = sysconfig.get_path('purelib', vars={'base':'$am_py_prefix'})
152
+else:
153
+    from distutils import sysconfig
154
+    sitedir = sysconfig.get_python_lib(0, 0, prefix='$am_py_prefix')
155
+sys.stdout.write(sitedir)"`
156
+     case $am_cv_python_pythondir in
157
+     $am_py_prefix*)
158
+       am__strip_prefix=`echo "$am_py_prefix" | sed 's|.|.|g'`
159
+       am_cv_python_pythondir=`echo "$am_cv_python_pythondir" | sed "s,^$am__strip_prefix,$PYTHON_PREFIX,"`
160
+       ;;
161
+     *)
162
+       case $am_py_prefix in
163
+         /usr|/System*) ;;
164
+         *)
165
+	  am_cv_python_pythondir=$PYTHON_PREFIX/lib/python$PYTHON_VERSION/site-packages
166
+	  ;;
167
+       esac
168
+       ;;
169
+     esac
170
+    ])
171
+  AC_SUBST([pythondir], [$am_cv_python_pythondir])
172
+
173
+  dnl pkgpythondir -- $PACKAGE directory under pythondir.  Was
174
+  dnl   PYTHON_SITE_PACKAGE in previous betas, but this naming is
175
+  dnl   more consistent with the rest of automake.
176
+
177
+  AC_SUBST([pkgpythondir], [\${pythondir}/$PACKAGE])
178
+
179
+  dnl pyexecdir -- directory for installing python extension modules
180
+  dnl   (shared libraries)
181
+  dnl Query distutils for this directory.
182
+  AC_CACHE_CHECK([for $am_display_PYTHON extension module directory],
183
+    [am_cv_python_pyexecdir],
184
+    [if test "x$exec_prefix" = xNONE
185
+     then
186
+       am_py_exec_prefix=$am_py_prefix
187
+     else
188
+       am_py_exec_prefix=$exec_prefix
189
+     fi
190
+     am_cv_python_pyexecdir=`$PYTHON -c "
191
+$am_python_setup_sysconfig
192
+if can_use_sysconfig:
193
+    sitedir = sysconfig.get_path('platlib', vars={'platbase':'$am_py_prefix'})
194
+else:
195
+    from distutils import sysconfig
196
+    sitedir = sysconfig.get_python_lib(1, 0, prefix='$am_py_prefix')
197
+sys.stdout.write(sitedir)"`
198
+     case $am_cv_python_pyexecdir in
199
+     $am_py_exec_prefix*)
200
+       am__strip_prefix=`echo "$am_py_exec_prefix" | sed 's|.|.|g'`
201
+       am_cv_python_pyexecdir=`echo "$am_cv_python_pyexecdir" | sed "s,^$am__strip_prefix,$PYTHON_EXEC_PREFIX,"`
202
+       ;;
203
+     *)
204
+       case $am_py_exec_prefix in
205
+         /usr|/System*) ;;
206
+         *)
207
+	   am_cv_python_pyexecdir=$PYTHON_EXEC_PREFIX/lib/python$PYTHON_VERSION/site-packages
208
+	   ;;
209
+       esac
210
+       ;;
211
+     esac
212
+    ])
213
+  AC_SUBST([pyexecdir], [$am_cv_python_pyexecdir])
214
+
215
+  dnl pkgpyexecdir -- $(pyexecdir)/$(PACKAGE)
216
+
217
+  AC_SUBST([pkgpyexecdir], [\${pyexecdir}/$PACKAGE])
218
+
219
+  dnl Run any user-specified action.
220
+  $2
221
+  fi
222
+
223
+])
224
+
225
+
226
+# AM_PYTHON_CHECK_VERSION(PROG, VERSION, [ACTION-IF-TRUE], [ACTION-IF-FALSE])
227
+# ---------------------------------------------------------------------------
228
+# Run ACTION-IF-TRUE if the Python interpreter PROG has version >= VERSION.
229
+# Run ACTION-IF-FALSE otherwise.
230
+# This test uses sys.hexversion instead of the string equivalent (first
231
+# word of sys.version), in order to cope with versions such as 2.2c1.
232
+# This supports Python 2.0 or higher. (2.0 was released on October 16, 2000).
233
+AC_DEFUN([AM_PYTHON_CHECK_VERSION],
234
+ [prog="import sys
235
+# split strings by '.' and convert to numeric.  Append some zeros
236
+# because we need at least 4 digits for the hex conversion.
237
+# map returns an iterator in Python 3.0 and a list in 2.x
238
+minver = list(map(int, '$2'.split('.'))) + [[0, 0, 0]]
239
+minverhex = 0
240
+# xrange is not present in Python 3.0 and range returns an iterator
241
+for i in list(range(0, 4)): minverhex = (minverhex << 8) + minver[[i]]
242
+sys.exit(sys.hexversion < minverhex)"
243
+  AS_IF([AM_RUN_LOG([$1 -c "$prog"])], [$3], [$4])])

+ 24
- 0
m4/python.m4.patch View File

@@ -0,0 +1,24 @@
1
+--- /usr/share/aclocal-1.14/python.m4	2014-10-27 05:45:43.000000000 +0100
2
++++ python.m4	2016-08-30 17:20:03.690623000 +0200
3
+@@ -111,6 +111,7 @@ AC_DEFUN([AM_PATH_PYTHON],
4
+ import sys
5
+ # Prefer sysconfig over distutils.sysconfig, for better compatibility
6
+ # with python 3.x.  See automake bug#10227.
7
++# But not see <https://bugs.launchpad.net/ubuntu/+source/python3-defaults/+bug/1408092>
8
+ try:
9
+     import sysconfig
10
+ except ImportError:
11
+@@ -119,9 +120,12 @@ else:
12
+     can_use_sysconfig = 1
13
+ # Can't use sysconfig in CPython 2.7, since it's broken in virtualenvs:
14
+ # <https://github.com/pypa/virtualenv/issues/118>
15
++# Can't use sysconfig in CPython > 3.0 in debian since it's broken :
16
++# <https://bugs.launchpad.net/ubuntu/+source/python3-defaults/+bug/1408092>
17
+ try:
18
+     from platform import python_implementation
19
+-    if python_implementation() == 'CPython' and sys.version[[:3]] == '2.7':
20
++    if python_implementation() == 'CPython' and ( \
21
++            float(sys.version[[:3]]) > 3.0 or sys.version[[:3]] == '2.7'):
22
+         can_use_sysconfig = 0
23
+ except ImportError:
24
+     pass"

+ 755
- 0
m4/python_pyconfigure.m4 View File

@@ -0,0 +1,755 @@
1
+# Copyright 2012, 2013, 2014 Brandon Invergo <brandon@invergo.net>
2
+#
3
+# This file is part of pyconfigure.  This program is free
4
+# software; you can redistribute it and/or modify it under the
5
+# terms of the GNU General Public License as published by the
6
+# Free Software Foundation, either version 3 of the License, or
7
+# (at your option) any later version.
8
+#
9
+# This program is distributed in the hope that it will be useful,
10
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
11
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12
+# GNU General Public License for more details.
13
+#
14
+# Under Section 7 of GPL version 3, you are granted additional
15
+# permissions described in the Autoconf Configure Script Exception,
16
+# version 3.0, as published by the Free Software Foundation.
17
+#
18
+# You should have received a copy of the GNU General Public License
19
+# and a copy of the Autoconf Configure Script Exception along with
20
+# this program; see the files COPYINGv3 and COPYING.EXCEPTION
21
+# respectively.  If not, see <http://www.gnu.org/licenses/>.
22
+
23
+
24
+# Many of these macros were adapted from ones written by Andrew Dalke
25
+# and James Henstridge and are included with the Automake utility
26
+# under the following copyright terms:
27
+#
28
+# Copyright (C) 1999-2012 Free Software Foundation, Inc.
29
+#
30
+# This file is free software; the Free Software Foundation
31
+# gives unlimited permission to copy and/or distribute it,
32
+# with or without modifications, as long as this notice is preserved.
33
+
34
+# Table of Contents:
35
+#
36
+# 1. Language selection
37
+#    and routines to produce programs in a given language.
38
+#
39
+# 2. Producing programs in a given language.
40
+#
41
+# 3. Looking for a compiler
42
+#    And possibly the associated preprocessor.
43
+#
44
+# 4. Looking for specific libs & functionality
45
+
46
+
47
+## ----------------------- ##
48
+## 1. Language selection.  ##
49
+## ----------------------- ##
50
+
51
+
52
+# AC_LANG(Python)
53
+# ---------------
54
+AC_LANG_DEFINE([Python], [py], [PY], [PYTHON], [],
55
+[ac_ext=py
56
+ac_compile='chmod +x conftest.$ac_ext >&AS_MESSAGE_LOG_FD'
57
+ac_link='chmod +x conftest.$ac_ext && cp conftest.$ac_ext conftest >&AS_MESSAGE_LOG_FD'
58
+])
59
+
60
+
61
+# AC_LANG_PYTHON
62
+# --------------
63
+AU_DEFUN([AC_LANG_PYTHON], [AC_LANG(Python)])
64
+
65
+
66
+## ----------------------- ##
67
+## 2. Producing programs.  ##
68
+## ----------------------- ##
69
+
70
+
71
+# AC_LANG_PROGRAM(Python)([PROLOGUE], [BODY])
72
+# -------------------------------------------
73
+m4_define([AC_LANG_PROGRAM(Python)], [dnl
74
+@%:@!$PYTHON
75
+$1
76
+m4_if([$2], [], [], [dnl
77
+if __name__ == '__main__':
78
+$2])])
79
+
80
+
81
+# _AC_LANG_IO_PROGRAM(Python)
82
+# ---------------------------
83
+# Produce source that performs I/O.
84
+m4_define([_AC_LANG_IO_PROGRAM(Python)],
85
+[AC_LANG_PROGRAM([dnl
86
+import sys
87
+try:
88
+    h = open('conftest.out')
89
+except:
90
+    sys.exit(1)
91
+else:
92
+    close(h)
93
+    sys.exit(0)
94
+], [])])
95
+
96
+
97
+# _AC_LANG_CALL(Python)([PROLOGUE], [FUNCTION])
98
+# ---------------------
99
+# Produce source that calls FUNCTION
100
+m4_define([_AC_LANG_CALL(Python)],
101
+[AC_LANG_PROGRAM([$1], [$2])])
102
+
103
+
104
+## -------------------------------------------- ##
105
+## 3. Looking for Compilers and Interpreters.   ##
106
+## -------------------------------------------- ##
107
+
108
+
109
+AC_DEFUN([AC_LANG_COMPILER(Python)],
110
+[AC_REQUIRE([PC_PROG_PYTHON])])
111
+
112
+
113
+# PC_INIT([MIN-VERSION], [MAX-VERSION]) 
114
+# -----------------------------
115
+# Initialize pyconfigure, finding a Python interpreter with a given
116
+# minimum and/or maximum version. 
117
+AC_DEFUN([PC_INIT],
118
+[PC_PROG_PYTHON([], [$1], [$2])
119
+dnl If we found something, do a sanity check that the interpreter really
120
+dnl has the version its name would suggest.
121
+m4_ifval([PYTHON],
122
+        [PC_PYTHON_VERIFY_VERSION([>=], [pc_min_ver], [],
123
+                  [AC_MSG_FAILURE([No compatible Python interpreter found. If you're sure that you have one, try setting the PYTHON environment variable to the location of the interpreter.])])])
124
+m4_ifval([PYTHON],
125
+        [PC_PYTHON_VERIFY_VERSION([<=], [pc_max_ver], [],
126
+                  [AC_MSG_FAILURE([No compatible Python interpreter found. If you're sure that you have one, try setting the PYTHON environment variable to the location of the interpreter.])])])
127
+])# PC_INIT
128
+
129
+# PC_PROG_PYTHON([PROG-TO-CHECK-FOR], [MIN-VERSION], [MAX-VERSION])
130
+# ---------------------------------
131
+# Find a Python interpreter.  Python versions prior to 2.0 are not
132
+# supported. (2.0 was released on October 16, 2000).
133
+AC_DEFUN_ONCE([PC_PROG_PYTHON],
134
+[AC_ARG_VAR([PYTHON], [the Python interpreter])
135
+dnl The default minimum version is 2.0
136
+m4_define_default([pc_min_ver], m4_ifval([$2], [$2], [2.0]))
137
+dnl The default maximum version is 3.3
138
+m4_define_default([pc_max_ver], m4_ifval([$3], [$3], [4.0]))
139
+dnl Build up a list of possible interpreter names. 
140
+m4_define_default([_PC_PYTHON_INTERPRETER_LIST],
141
+    [dnl If we want some Python 3 versions (max version >= 3.0), 
142
+dnl also search for "python3"
143
+     m4_if(m4_version_compare(pc_max_ver, [2.9]), [1], [python3], []) \
144
+dnl If we want some Python 2 versions (min version <= 2.7),
145
+dnl also search for "python2".
146
+     m4_if(m4_version_compare(pc_min_ver, [2.8]), [-1], [python2], []) \
147
+dnl Construct a comma-separated list of interpreter names (python2.6, 
148
+dnl python2.7, etc). We only care about the first 3 characters of the
149
+dnl version strings (major-dot-minor; not 
150
+dnl major-dot-minor-dot-bugfix[-dot-whatever])
151
+     m4_foreach([pc_ver], 
152
+                    m4_esyscmd_s(seq -s[[", "]] -f["[[%.1f]]"] m4_substr(pc_max_ver, [0], [3]) -0.1 m4_substr(pc_min_ver, [0], [3])),
153
+dnl Remove python2.8 and python2.9 since they will never exist
154
+                    [m4_bmatch(pc_ver, [2.[89]], [], [python]pc_ver)]) \
155
+     [python]])
156
+dnl Do the actual search at last.
157
+m4_ifval([$1],
158
+	[AC_PATH_PROGS(PYTHON, [$1 _PC_PYTHON_INTERPRETER_LIST])],
159
+	[AC_PATH_PROGS(PYTHON, [_PC_PYTHON_INTERPRETER_LIST])])
160
+])# PC_PROG_PYTHON
161
+  
162
+
163
+# PC_PYTHON_PROG_PYTHON_CONFIG(PROG-TO-CHECK-FOR)
164
+# ----------------------------------------------
165
+# Find the python-config program
166
+AC_DEFUN([PC_PYTHON_PROG_PYTHON_CONFIG],
167
+[AC_REQUIRE([PC_PROG_PYTHON])[]dnl
168
+AC_ARG_VAR([PYTHON_CONFIG], [the Python-config program])
169
+dnl python-config's binary name is normally based on the Python interpreter's
170
+dnl binary name (i.e. python2.7 -> python2.7-config)
171
+m4_define([_PYTHON_BASENAME], [`basename $PYTHON`])
172
+m4_ifval([$1],
173
+	[AC_PATH_PROGS(PYTHON_CONFIG, [$1 _PYTHON_BASENAME-config])],
174
+	[AC_PATH_PROG(PYTHON_CONFIG, _PYTHON_BASENAME-config)])
175
+]) # PC_PYTHON_PROG_PYTHON_CONFIG
176
+
177
+
178
+# PC_PYTHON_VERIFY_VERSION([RELATION], [VERSION], [ACTION-IF-TRUE], [ACTION-IF-FALSE])
179
+# ---------------------------------------------------------------------------
180
+# Run ACTION-IF-TRUE if the Python interpreter PROG has version [RELATION] VERSION.
181
+# i.e if RELATION is "<", check if PROG has a version number less than VERSION.
182
+# Run ACTION-IF-FALSE otherwise.
183
+# Specify RELATION as any mathematical comparison "<", ">", "<=", ">=", "==" or "!="
184
+# This test uses sys.hexversion instead of the string equivalent (first
185
+# word of sys.version), in order to cope with versions such as 2.2c1.
186
+# This supports Python 2.0 or higher. (2.0 was released on October 16, 2000).
187
+AC_DEFUN([PC_PYTHON_VERIFY_VERSION],
188
+[m4_define([pc_python_safe_ver], m4_bpatsubsts($2, [\.], [_]))
189
+AC_CACHE_CHECK([if Python $1 '$2'],
190
+    [[pc_cv_python_req_version_]pc_python_safe_ver],
191
+    [AC_LANG_PUSH(Python)[]dnl
192
+     AC_RUN_IFELSE(
193
+        [AC_LANG_PROGRAM([dnl
194
+import sys
195
+], [dnl
196
+    # split strings by '.' and convert to numeric.  Append some zeros
197
+    # because we need at least 4 digits for the hex conversion.
198
+    # map returns an iterator in Python 3.0 and a list in 2.x
199
+    reqver = list(map(int, '$2'.split('.'))) + [[0, 0, 0]]
200
+    reqverhex = 0
201
+    # xrange is not present in Python 3.0 and range returns an iterator
202
+    for i in list(range(4)):
203
+        reqverhex = (reqverhex << 8) + reqver[[i]]
204
+    # the final 8 bits are "0xf0" for final versions, which are all
205
+    # we'll test against, since it's doubtful that a released software
206
+    # will depend on an alpha- or beta-state Python.
207
+    reqverhex += 0xf0
208
+    if sys.hexversion $1 reqverhex:
209
+        sys.exit()
210
+    else:
211
+        sys.exit(1)
212
+])], 
213
+         [[pc_cv_python_req_version_]pc_python_safe_ver=yes], 
214
+         [[pc_cv_python_req_version_]pc_python_safe_ver=no])
215
+     AC_LANG_POP(Python)[]dnl
216
+    ])
217
+AS_IF([test "$[pc_cv_python_req_version_]pc_python_safe_ver" = "no"], [$4], [$3])
218
+])# PC_PYTHON_VERIFY_VERSION
219
+
220
+
221
+# PC_PYTHON_CHECK_VERSION
222
+# -----------------------
223
+# Query Python for its version number.  Getting [:3] seems to be
224
+# the best way to do this; it's what "site.py" does in the standard
225
+# library.
226
+AC_DEFUN([PC_PYTHON_CHECK_VERSION],
227
+[AC_REQUIRE([PC_PROG_PYTHON])[]dnl
228
+AC_CACHE_CHECK([for $1 version], 
229
+    [pc_cv_python_version],
230
+    [AC_LANG_PUSH(Python)[]dnl
231
+     AC_LINK_IFELSE([AC_LANG_PROGRAM([dnl
232
+import sys
233
+], [dnl
234
+    sys.stdout.write(sys.version[[:3]])
235
+])],
236
+                   [pc_cv_python_version=`./conftest`],
237
+                   [AC_MSG_FAILURE([failed to run Python program])])
238
+     AC_LANG_POP(Python)[]dnl
239
+    ])
240
+AC_SUBST([PYTHON_VERSION], [$pc_cv_python_version])
241
+])# PC_PYTHON_CHECK_VERSION
242
+
243
+
244
+# PC_PYTHON_CHECK_PREFIX
245
+# ----------------------
246
+# Use the value of $prefix for the corresponding value of
247
+# PYTHON_PREFIX. This is made a distinct variable so it can be
248
+# overridden if need be.  However, general consensus is that you
249
+# shouldn't need this ability. 
250
+AC_DEFUN([PC_PYTHON_CHECK_PREFIX],
251
+[AC_REQUIRE([PC_PYTHON_PROG_PYTHON_CONFIG])[]dnl
252
+dnl Try to get it with python-config otherwise do it from within Python
253
+AC_CACHE_CHECK([for Python prefix], [pc_cv_python_prefix],
254
+[if test -x "$PYTHON_CONFIG"; then
255
+    pc_cv_python_prefix=`$PYTHON_CONFIG --prefix 2>&AS_MESSAGE_LOG_FD`
256
+else
257
+    AC_LANG_PUSH(Python)[]dnl
258
+    AC_LINK_IFELSE([AC_LANG_PROGRAM([dnl
259
+import sys
260
+], [dnl
261
+    sys.stdout.write(sys.prefix)
262
+])], [pc_cv_python_prefix=`./conftest`;
263
+      if test $? != 0; then
264
+         AC_MSG_FAILURE([could not determine Python prefix])
265
+      fi],
266
+      [AC_MSG_FAILURE([failed to run Python program])])
267
+    AC_LANG_POP(Python)[]dnl
268
+fi])
269
+AC_SUBST([PYTHON_PREFIX], [$pc_cv_python_prefix])])
270
+
271
+
272
+# PC_PYTHON_CHECK_EXEC_PREFIX
273
+# --------------------------
274
+# Like above, but for $exec_prefix
275
+AC_DEFUN([PC_PYTHON_CHECK_EXEC_PREFIX],
276
+[AC_REQUIRE([PC_PYTHON_PROG_PYTHON_CONFIG])[]dnl
277
+dnl Try to get it with python-config otherwise do it from within Python
278
+AC_CACHE_CHECK([for Python exec-prefix], [pc_cv_python_exec_prefix],
279
+[if test -x "$PYTHON_CONFIG"; then
280
+    pc_cv_python_exec_prefix=`$PYTHON_CONFIG --exec-prefix 2>&AS_MESSAGE_LOG_FD`
281
+else
282
+    AC_LANG_PUSH(Python)[]dnl
283
+    AC_LINK_IFELSE([AC_LANG_PROGRAM([dnl
284
+import sys
285
+], [dnl
286
+    sys.stdout.write(sys.exec_prefix)
287
+])],
288
+        [pc_cv_python_exec_prefix=`./conftest`;
289
+         if test $? != 0; then
290
+            AC_MSG_FAILURE([could not determine Python exec_prefix])
291
+         fi],
292
+         [AC_MSG_FAILURE([failed to run Python program])])
293
+    AC_LANG_POP(Python)[]dnl
294
+fi
295
+])
296
+AC_SUBST([PYTHON_EXEC_PREFIX], [$pc_cv_python_exec_prefix])])
297
+
298
+
299
+# PC_PYTHON_CHECK_INCLUDES
300
+# ------------------------
301
+# Find the Python header file include flags (ie
302
+# '-I/usr/include/python')
303
+AC_DEFUN([PC_PYTHON_CHECK_INCLUDES],
304
+[AC_REQUIRE([PC_PYTHON_PROG_PYTHON_CONFIG])[]dnl
305
+dnl Try to find the headers location with python-config otherwise guess
306
+AC_CACHE_CHECK([for Python includes], [pc_cv_python_includes],
307
+[if test -x "$PYTHON_CONFIG"; then
308
+    pc_cv_python_includes=`$PYTHON_CONFIG --includes 2>&AS_MESSAGE_LOG_FD`
309
+else
310
+    pc_cv_python_includes="[-I$includedir/$_PYTHON_BASENAME]m4_ifdef(PYTHON_ABI_FLAGS,
311
+    PYTHON_ABI_FLAGS,)"
312
+fi
313
+])
314
+AC_SUBST([PYTHON_INCLUDES], [$pc_cv_python_includes])])
315
+
316
+
317
+# PC_PYTHON_CHECK_HEADERS([ACTION-IF-PRESENT], [ACTION-IF-ABSENT])
318
+# -----------------------
319
+# Check for the presence and usability of Python.h
320
+AC_DEFUN([PC_PYTHON_CHECK_HEADERS],
321
+[AC_REQUIRE([PC_PYTHON_CHECK_INCLUDES])[]dnl
322
+pc_cflags_store=$CPPFLAGS
323
+CPPFLAGS="$CFLAGS $PYTHON_INCLUDES"
324
+AC_CHECK_HEADER([Python.h], [$1], [$2])
325
+CPPFLAGS=$pc_cflags_store
326
+])
327
+
328
+
329
+# PC_PYTHON_CHECK_LIBS
330
+# --------------------
331
+# Find the Python lib flags (ie '-lpython')
332
+AC_DEFUN([PC_PYTHON_CHECK_LIBS],
333
+[AC_REQUIRE([PC_PYTHON_PROG_PYTHON_CONFIG])[]dnl
334
+dnl Try to find the lib flags with python-config otherwise guess
335
+AC_CACHE_CHECK([for Python libs], [pc_cv_python_libs],
336
+[if test -x "$PYTHON_CONFIG"; then
337
+    pc_cv_python_libs=`$PYTHON_CONFIG --libs 2>&AS_MESSAGE_LOG_FD`
338
+else
339
+    pc_cv_python_libs="[-l$_PYTHON_BASENAME]m4_ifdef(PYTHON_ABI_FLAGS, PYTHON_ABI_FLAGS,)"
340
+fi
341
+])
342
+AC_SUBST([PYTHON_LIBS], [$pc_cv_python_libs])])
343
+
344
+
345
+# PC_PYTHON_TEST_LIBS(LIBRARY-FUNCTION, [ACTION-IF-PRESENT], [ACTION-IF-ABSENT])
346
+# -------------------
347
+# Verify that the Python libs can be loaded
348
+AC_DEFUN([PC_PYTHON_TEST_LIBS],
349
+[AC_REQUIRE([PC_PYTHON_CHECK_LIBS])[]dnl
350
+pc_libflags_store=$LIBS
351
+for lflag in $PYTHON_LIBS; do
352
+    case $lflag in
353
+    	 -lpython*@:}@
354
+		LIBS="$LIBS $lflag"
355
+		pc_libpython=`echo $lflag | sed -e 's/^-l//'`
356
+		;;
357
+         *@:}@;;
358
+    esac
359
+done
360
+AC_CHECK_LIB([$pc_libpython], [$1], [$2], [$3])])
361
+
362
+
363
+# PC_PYTHON_CHECK_CFLAGS
364
+# ----------------------
365
+# Find the Python CFLAGS
366
+AC_DEFUN([PC_PYTHON_CHECK_CFLAGS],
367
+[AC_REQUIRE([PC_PYTHON_PROG_PYTHON_CONFIG])[]dnl
368
+dnl Try to find the CFLAGS with python-config otherwise give up
369
+AC_CACHE_CHECK([for Python CFLAGS], [pc_cv_python_cflags],
370
+[if test -x "$PYTHON_CONFIG"; then
371
+    pc_cv_python_cflags=`$PYTHON_CONFIG --cflags 2>&AS_MESSAGE_LOG_FD`
372
+else
373
+    pc_cv_python_cflags=
374
+fi
375
+])
376
+AC_SUBST([PYTHON_CFLAGS], [$pc_cv_python_cflags])])
377
+
378
+
379
+# PC_PYTHON_CHECK_LDFLAGS
380
+# -----------------------
381
+# Find the Python LDFLAGS
382
+AC_DEFUN([PC_PYTHON_CHECK_LDFLAGS],
383
+[AC_REQUIRE([PC_PYTHON_PROG_PYTHON_CONFIG])[]dnl
384
+dnl Try to find the LDFLAGS with python-config otherwise give up
385
+AC_CACHE_CHECK([for Python LDFLAGS], [pc_cv_python_ldflags],
386
+[if test -x "$PYTHON_CONFIG"; then
387
+    pc_cv_python_ldflags=`$PYTHON_CONFIG --ldflags 2>&AS_MESSAGE_LOG_FD`
388
+else
389
+    pc_cv_python_ldflags=
390
+fi
391
+])
392
+AC_SUBST([PYTHON_LDFLAGS], [$pc_cv_python_ldflags])])
393
+
394
+
395
+# PC_PYTHON_CHECK_EXTENSION_SUFFIX
396
+# --------------------------------
397
+# Find the Python extension suffix (i.e. '.cpython-32.so')
398
+AC_DEFUN([PC_PYTHON_CHECK_EXTENSION_SUFFIX],
399
+[AC_REQUIRE([PC_PYTHON_PROG_PYTHON_CONFIG])[]dnl
400
+dnl Try to find the suffix with python-config otherwise give up
401
+AC_CACHE_CHECK([for Python extension suffix], [pc_cv_python_extension_suffix],
402
+[if test -x "$PYTHON_CONFIG"; then
403
+     pc_cv_python_extension_suffix=`$PYTHON_CONFIG --extension-suffix 2>&AS_MESSAGE_LOG_FD`
404
+else
405
+    pc_cv_python_extension_suffix=
406
+fi
407
+])
408
+AC_SUBST([PYTHON_EXTENSION_SUFFIX], [$pc_cv_python_extension_suffix])])
409
+
410
+
411
+# PC_PYTHON_CHECK_ABI_FLAGS
412
+# -------------------------
413
+# Find the Python ABI flags
414
+AC_DEFUN([PC_PYTHON_CHECK_ABI_FLAGS],
415
+[AC_REQUIRE([PC_PYTHON_PROG_PYTHON_CONFIG])[]dnl
416
+dnl Try to find the ABI flags with python-config otherwise give up
417
+AC_CACHE_CHECK([for Python ABI flags], [pc_cv_python_abi_flags],
418
+[if test -x "$PYTHON_CONFIG"; then
419
+     pc_cv_python_abi_flags=`$PYTHON_CONFIG --abiflags 2>&AS_MESSAGE_LOG_FD`
420
+else
421
+    pc_cv_python_abi_flags=
422
+fi
423
+])
424
+AC_SUBST([PYTHON_ABI_FLAGS], [$pc_cv_python_abi_flags])])
425
+
426
+
427
+# PC_PYTHON_CHECK_PLATFORM
428
+# ------------------------
429
+# At times (like when building shared libraries) you may want
430
+# to know which OS platform Python thinks this is.
431
+AC_DEFUN([PC_PYTHON_CHECK_PLATFORM],
432
+[AC_REQUIRE([PC_PROG_PYTHON])[]dnl
433
+dnl Get the platform from within Python (sys.platform)
434
+AC_CACHE_CHECK([for Python platform], [pc_cv_python_platform],
435
+    [AC_LANG_PUSH(Python)[]dnl
436
+     AC_LINK_IFELSE([AC_LANG_PROGRAM([dnl
437
+import sys
438
+], [dnl
439
+    sys.stdout.write(sys.platform)
440
+])], [pc_cv_python_platform=`./conftest`;
441
+     if test $? != 0; then
442
+        AC_MSG_FAILURE([could not determine Python platform])
443
+     fi],
444
+     [AC_MSG_FAILURE([failed to run Python program])])
445
+    AC_LANG_POP(Python)[]dnl
446
+   ])
447
+AC_SUBST([PYTHON_PLATFORM], [$pc_cv_python_platform])
448
+])
449
+
450
+
451
+# PC_PYTHON_CHECK_SITE_DIR
452
+# ---------------------
453
+# The directory to which new libraries are installed (i.e. the
454
+# "site-packages" directory.
455
+AC_DEFUN([PC_PYTHON_CHECK_SITE_DIR],
456
+[AC_REQUIRE([PC_PROG_PYTHON])AC_REQUIRE([PC_PYTHON_CHECK_PREFIX])[]dnl
457
+AC_CACHE_CHECK([for Python site-packages directory],
458
+    [pc_cv_python_site_dir],
459
+    [AC_LANG_PUSH(Python)[]dnl
460
+    if test "x$prefix" = xNONE
461
+     then
462
+       pc_py_prefix=$ac_default_prefix
463
+     else
464
+       pc_py_prefix=$prefix
465
+     fi
466
+     AC_LINK_IFELSE([AC_LANG_PROGRAM([dnl
467
+import sys
468
+from platform import python_implementation
469
+# sysconfig in CPython 2.7 doesn't work in virtualenv
470
+# <https://github.com/pypa/virtualenv/issues/118>
471
+try:
472
+    import sysconfig
473
+except:
474
+    can_use_sysconfig = False
475
+else:
476
+    can_use_sysconfig = True
477
+if can_use_sysconfig:
478
+    # Can't use sysconfig in CPython > 3.0 in debian since it's broken :
479
+    # <https://bugs.launchpad.net/ubuntu/+source/python3-defaults/+bug/1408092>
480
+    if python_implementation() == "CPython" (
481
+            float(sys.version[[:3]]) > 3.0 or sys.version[[:3]] == '2.7'):
482
+        can_use_sysconfig = False
483
+if not can_use_sysconfig:        
484
+    from distutils import sysconfig
485
+    sitedir = sysconfig.get_python_lib(False, False, prefix='$pc_py_prefix')
486
+else:
487
+    sitedir = sysconfig.get_path('purelib', vars={'base':'$pc_py_prefix'})
488
+], [dnl
489
+    sys.stdout.write(sitedir)
490
+])], [pc_cv_python_site_dir=`./conftest`],
491
+     [AC_MSG_FAILURE([failed to run Python program])])
492
+     AC_LANG_POP(Python)[]dnl
493
+     case $pc_cv_python_site_dir in
494
+     $pc_py_prefix*)
495
+       pc__strip_prefix=`echo "$pc_py_prefix" | sed 's|.|.|g'`
496
+       pc_cv_python_site_dir=`echo "$pc_cv_python_site_dir" | sed "s,^$pc__strip_prefix/,,"`
497
+       ;;
498
+     *)
499
+       case $pc_py_prefix in
500
+         /usr|/System*) ;;
501
+         *)
502
+	  pc_cv_python_site_dir=lib/python$PYTHON_VERSION/site-packages
503
+	  ;;
504
+       esac
505
+       ;;
506
+     esac
507
+     ])
508
+AC_SUBST([pythondir], [\${prefix}/$pc_cv_python_site_dir])])# PC_PYTHON_CHECK_SITE_DIR
509
+
510
+# PC_PYTHON_SITE_PACKAGE_DIR
511
+# --------------------------
512
+# $PACKAGE directory under PYTHON_SITE_DIR
513
+AC_DEFUN([PC_PYTHON_SITE_PACKAGE_DIR],
514
+[AC_REQUIRE([PC_PYTHON_CHECK_SITE_DIR])[]dnl
515
+AC_SUBST([pkgpythondir], [\${pythondir}/$PACKAGE_NAME])])
516
+
517
+
518
+# PC_PYTHON_CHECK_EXEC_DIR
519
+# ------------------------
520
+# directory for installing python extension modules (shared libraries)
521
+AC_DEFUN([PC_PYTHON_CHECK_EXEC_DIR],
522
+[AC_REQUIRE([PC_PROG_PYTHON])AC_REQUIRE([PC_PYTHON_CHECK_EXEC_PREFIX])[]dnl
523
+  AC_CACHE_CHECK([for Python extension module directory],
524
+    [pc_cv_python_exec_dir],
525
+    [AC_LANG_PUSH(Python)[]dnl
526
+    if test "x$pc_cv_python_exec_prefix" = xNONE
527
+     then
528
+       pc_py_exec_prefix=$pc_cv_python_prefix
529
+     else
530
+       pc_py_exec_prefix=$pc_cv_python_exec_prefix
531
+     fi
532
+     AC_LINK_IFELSE([AC_LANG_PROGRAM([dnl
533
+import sys
534
+from platform import python_implementation
535
+# sysconfig in CPython 2.7 doesn't work in virtualenv
536
+# <https://github.com/pypa/virtualenv/issues/118>
537
+try:
538
+    import sysconfig
539
+except:
540
+    can_use_sysconfig = False
541
+else:
542
+    can_use_sysconfig = True
543
+if can_use_sysconfig:
544
+    if python_implementation() == "CPython" and sys.version[[:3]] == '2.7':
545
+        can_use_sysconfig = False
546
+if not can_use_sysconfig:        
547
+    from distutils import sysconfig
548
+    sitedir = sysconfig.get_python_lib(False, False, prefix='$pc_py__exec_prefix')
549
+else:
550
+    sitedir = sysconfig.get_path('purelib', vars={'platbase':'$pc_py_exec_prefix'})
551
+], [dnl
552
+    sys.stdout.write(sitedir)
553
+])], [pc_cv_python_exec_dir=`./conftest`],
554
+     [AC_MSG_FAILURE([failed to run Python program])])
555
+     AC_LANG_POP(Python)[]dnl
556
+     case $pc_cv_python_exec_dir in
557
+     $pc_py_exec_prefix*)
558
+       pc__strip_prefix=`echo "$pc_py_exec_prefix" | sed 's|.|.|g'`
559
+       pc_cv_python_exec_dir=`echo "$pc_cv_python_exec_dir" | sed "s,^$pc__strip_prefix/,,"`
560
+       ;;
561
+     *)
562
+       case $pc_py_exec_prefix in
563
+         /usr|/System*) ;;
564
+         *)
565
+	   pc_cv_python_exec_dir=lib/python$PYTHON_VERSION/site-packages
566
+	   ;;
567
+       esac
568
+       ;;
569
+     esac
570
+    ])
571
+AC_SUBST([pyexecdir], [\${exec_prefix}/$pc_cv_python_pyexecdir])]) #PY_PYTHON_CHECK_EXEC_LIB_DIR
572
+
573
+
574
+# PC_PYTHON_EXEC_PACKAGE_DIR
575
+# --------------------------
576
+# $PACKAGE directory under PYTHON_SITE_DIR
577
+AC_DEFUN([PC_PYTHON_EXEC_PACKAGE_DIR],
578
+[AC_REQUIRE([PC_PYTHON_CHECK_EXEC_DIR])[]dnl
579
+AC_SUBST([pkgpyexecdir], [\${pyexecdir}/$PACKAGE_NAME])])
580
+
581
+
582
+## -------------------------------------------- ##
583
+## 4. Looking for specific libs & functionality ##
584
+## -------------------------------------------- ##
585
+
586
+
587
+# PC_PYTHON_CHECK_MODULE(LIBRARY, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])
588
+# ----------------------------------------------------------------------
589
+# Macro for checking if a Python library is installed
590
+AC_DEFUN([PC_PYTHON_CHECK_MODULE],
591
+[AC_REQUIRE([PC_PROG_PYTHON])[]dnl
592
+m4_define([pc_python_safe_mod], m4_bpatsubsts($1, [\.], [_]))
593
+AC_CACHE_CHECK([for Python '$1' library],
594
+    [[pc_cv_python_module_]pc_python_safe_mod],
595
+    [AC_LANG_PUSH(Python)[]dnl
596
+     AC_RUN_IFELSE(
597
+	[AC_LANG_PROGRAM([dnl
598
+import sys
599
+try:
600
+    import $1
601
+except:
602
+    sys.exit(1)
603
+else:
604
+    sys.exit(0)
605
+], [])],
606
+	[[pc_cv_python_module_]pc_python_safe_mod="yes"],
607
+	[[pc_cv_python_module_]pc_python_safe_mod="no"])
608
+     AC_LANG_POP(Python)[]dnl
609
+    ])
610
+AS_IF([test "$[pc_cv_python_module_]pc_python_safe_mod" = "no"], [$3], [$2])
611
+])# PC_PYTHON_CHECK_MODULE
612
+
613
+
614
+# PC_PYTHON_CHECK_FUNC([LIBRARY], FUNCTION, ARGS, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND])
615
+# ---------------------------------------------------------------------------------------
616
+# Check to see if a given function call, optionally from a module, can
617
+# be successfully called
618
+AC_DEFUN([PC_PYTHON_CHECK_FUNC],
619
+[AC_REQUIRE([PC_PROG_PYTHON])[]dnl
620
+m4_define([pc_python_safe_mod], m4_bpatsubsts($1, [\.], [_]))
621
+AC_CACHE_CHECK([for Python m4_ifnblank($1, '$1.$2()', '$2()') function],
622
+    [[pc_cv_python_func_]pc_python_safe_mod[_$2]],
623
+    [AC_LANG_PUSH(Python)[]dnl
624
+     AC_RUN_IFELSE(
625
+	[AC_LANG_PROGRAM([dnl
626
+import sys
627
+m4_ifnblank([$1], [dnl
628
+try:
629
+    import $1
630
+except:
631
+    sys.exit(1)
632
+], [])], 
633
+[
634
+m4_ifnblank([$1], [
635
+    try:
636
+        $1.$2($3)], [
637
+    try:
638
+        $2($3)])
639
+    except:
640
+        sys.exit(1)
641
+    else:
642
+        sys.exit(0)
643
+])],
644
+	[[pc_cv_python_func_]pc_python_safe_mod[_$2]="yes"],
645
+	[[pc_cv_python_func_]pc_python_safe_mod[_$2]="no"])
646
+     AC_LANG_POP(Python)[]dnl
647
+    ])
648
+AS_IF([test "$[pc_cv_python_func_]pc_python_safe_mod[_$2]" = "no"], [$5], [$4])
649
+])# PC_PYTHON_CHECK_FUNC
650
+
651
+# PC_PYTHON_CHECK_MODULE_MATCH_VERSION(LIBRARY, VERSION, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND)
652
+# -------------------------------------------------
653
+# Macro for checking if a Python library with this version is installed
654
+#
655
+AC_DEFUN([PC_PYTHON_CHECK_MODULE_MATCH_VERSION],
656
+[AC_REQUIRE([PC_PROG_PYTHON])[]dnl
657
+m4_define([pc_python_safe_mod], m4_bpatsubsts($1, [\.], [_]))
658
+AC_CACHE_CHECK([for Python '$1' library version '$2'],
659
+    [[pc_cv_python_module_version]pc_python_safe_mod],
660
+    [AC_LANG_PUSH(Python)[]dnl
661
+     AC_LINK_IFELSE(
662
+	[AC_LANG_PROGRAM([dnl
663
+import sys
664
+try:
665
+    import $1
666
+except:
667
+    version='no'
668
+else:
669
+    for vers_attr in ('__version__', 'version', 'version_info'):
670
+        if hasattr($1, vers_attr):
671
+            version = getattr($1, vers_attr)
672
+            break
673
+    else:
674
+        version = 'unknown'
675
+sys.stdout.write(version)
676
+], [])], 
677
+	[[pc_cv_python_module_version]pc_python_safe_mod=`./conftest`],
678
+	[AC_MSG_FAILURE([failed to run Python program])])
679
+	AC_LANG_POP(Python)[]dnl
680
+	])
681
+
682
+AS_IF([test "x$[pc_cv_python_module_version]pc_python_safe_mod" = "x$2" ],
683
+	[$3],
684
+	[	AS_IF(
685
+			[test "x$[pc_cv_python_module_version]pc_python_safe_mod" = 'unknown'],
686
+			AC_MSG_WARN([Unable to fetch version of Python module $1]))
687
+		[$4]
688
+	])
689
+])# PC_PYTHON_CHECK_MODULE_VERSION
690
+
691
+
692
+# PC_PYTHON_CHECK_MODULE_VERSION(LIBRARY, MIN-VERSION, MAX-VERSION, [ACTION-IF-FOUND], [ACTION-IF-NOT-FOUND)
693
+# -------------------------------------------------
694
+# Macro for checking if a Python library with this version is installed
695
+#
696
+AC_DEFUN([PC_PYTHON_CHECK_MODULE_VERSION],
697
+[AC_REQUIRE([PC_PROG_PYTHON])[]dnl
698
+m4_define([pc_python_safe_mod], m4_bpatsubsts($1, [\.], [_]))
699
+m4_append([pc_python_safe_mod], m4_bpatsubsts($2, [\.], [_]))
700
+m4_append([pc_python_safe_mod], m4_bpatsubsts($3, [\.], [_]))
701
+AC_CACHE_CHECK(
702
+    [for Python '$1' library m4_ifnblank([$2],['$2' <= ]) version m4_ifnblank([$3], [<= '$3'])],
703
+    [[pc_cv_python_module_version]pc_python_safe_mod],
704
+    [AC_LANG_PUSH(Python)[]dnl
705
+     AC_LINK_IFELSE(
706
+	[AC_LANG_PROGRAM([dnl
707
+import sys
708
+def cmp_vers(v1,v2):
709
+    v1 = v1.split('.')
710
+    v2 = v2.split('.')
711
+    for i in range(max([len](v1), [len](v2))):
712
+        v1v = int(v1[[i]] if i < [len](v1) else 0)
713
+        v2v = int(v2[[i]] if i < [len](v2) else 0)
714
+        if v1v > v2v:
715
+            return 1
716
+        if v1v < v2v:
717
+            return -1
718
+    return 0
719
+try:
720
+    import $1
721
+except:
722
+    result='not found'
723
+else:
724
+    result='yes'
725
+    vmin = '$2'
726
+    vmax = '$3'
727
+    for vers_attr in ('__version__', 'version', 'version_info'):
728
+        if hasattr($1, vers_attr):
729
+            version = getattr($1, vers_attr)
730
+            break
731
+    else:
732
+        result = 'unknown'
733
+    if version not in ('unknonwn', 'no'):
734
+        failmsg = "but "+ version + " found"
735
+        if [len](vmin) > 0:
736
+            if cmp_vers(version, vmin) < 0:
737
+                result = failmsg
738
+        if [len](vmax) > 0:
739
+            if cmp_vers(version, vmax) > 0:
740
+                result = failmsg
741
+
742
+sys.stdout.write(result)
743
+], [])], 
744
+	[[pc_cv_python_module_version]pc_python_safe_mod=`./conftest`],
745
+	[AC_MSG_FAILURE([failed to run Python program])])
746
+	AC_LANG_POP(Python)[]dnl
747
+	])
748
+AS_IF(	[test "$[pc_cv_python_module_version]pc_python_safe_mod" = "yes"],
749
+	[$4],
750
+	[	AS_IF(
751
+			[test "x$[pc_cv_python_module_version]pc_python_safe_mod" = 'unknown'],
752
+			AC_MSG_WARN([Unable to fetch version of Python module $1]))
753
+		[$5]
754
+	])
755
+])# PC_PYTHON_CHECK_MODULE_VERSION

+ 14
- 0
m4/python_pyconfigure.m4.patch_bugfix View File

@@ -0,0 +1,14 @@
1
+--- /usr/share/pyconfigure/m4/python.m4	2016-04-27 05:19:12.000000000 +0200
2
++++ python_pyconfigure.m4	2016-08-30 17:21:56.810623000 +0200
3
+@@ -475,7 +475,10 @@ except:
4
+ else:
5
+     can_use_sysconfig = True
6
+ if can_use_sysconfig:
7
+-    if python_implementation() == "CPython" and sys.version[[:3]] == '2.7':
8
++    # Can't use sysconfig in CPython > 3.0 in debian since it's broken :
9
++    # <https://bugs.launchpad.net/ubuntu/+source/python3-defaults/+bug/1408092>
10
++    if python_implementation() == "CPython" (
11
++            float(sys.version[[:3]]) > 3.0 or sys.version[[:3]] == '2.7'):
12
+         can_use_sysconfig = False
13
+ if not can_use_sysconfig:        
14
+     from distutils import sysconfig

+ 2
- 1
plugins/mongodb_datasource/__init__.py View File

@@ -17,4 +17,5 @@ __fullname__ = "MongoDB plugin"
17 17
 #
18 18
 # @return bool|str : True if all the checks are OK, an error message if not
19 19
 def _activate():
20
-    return True
20
+    from lodel import buildconf
21
+    return buildconf.PYMONGO

+ 6
- 0
plugins/webui/run.py View File

@@ -44,12 +44,18 @@ def cookie_hash(token):
44 44
 #@return None or a session token
45 45
 def load_cookie(request):
46 46
     token = request.cookies.get(COOKIE_SESSION_ID)
47
+<<<<<<< HEAD
47 48
     
48 49
     if token is None or len(token) == 0:
49 50
         return None
50 51
     
51 52
     token=token.encode()
52 53
     
54
+=======
55
+    if token is None or len(token) == 0:
56
+        return None
57
+    token=token.encode()
58
+>>>>>>> 0fc8616c02ad999204e1e4926e9007c0ae7e035b
53 59
     hashtok = request.cookies.get(COOKIE_SESSION_HASH)
54 60
     if hashtok is None:
55 61
         raise ClientAuthenticationFailure(

+ 1
- 0
runtest View File

@@ -54,6 +54,7 @@ cp -R tests $testdir
54 54
 cd $testdir
55 55
 rm -R conf.d && mv tests/tests_conf.d conf.d
56 56
 make
57
+make refresh_plugins
57 58
 python3 loader.py $@
58 59
 
59 60
 rm -Rf $testdir

+ 26
- 20
tests/migration_handler/test_db_init.py View File

@@ -1,26 +1,32 @@
1 1
 # -*- coding: utf-8 -*-
2
-import unittest
3
-from plugins.mongodb_datasource.migration_handler import *
4 2
 
5
-class MongoDbMigrationHandlerTestCase(unittest.TestCase):
3
+from lodel import buildconf
6 4
 
7
-    def test_check_connection_args(self):
8
-        empty_connection_args = {}
9
-        with self.assertRaises(TypeError):
10
-            MigrationHandler(empty_connection_args)
5
+if not buildconf.PYMONGO:
6
+    import warnings
7
+    warnings.warn("Skipping tests about mongodb datasource. Pymongo not installed")
8
+else:
9
+    import unittest
10
+    from plugins.mongodb_datasource.migration_handler import *
11
+    class MongoDbMigrationHandlerTestCase(unittest.TestCase):
11 12
 
12
-        bad_connection_args_dicts = [
13
-            {'host': 'localhost', 'port': 20030},
14
-            {'host': 'localhost', 'port': 28015},
15
-            {'host': 'localhost', 'port': 28015, 'login':'lodel', 'password': 'lap'}
16
-        ]
17
-        for bad_connection_args_dict in bad_connection_args_dicts:
13
+        def test_check_connection_args(self):
14
+            empty_connection_args = {}
18 15
             with self.assertRaises(TypeError):
19
-                MigrationHandler(bad_connection_args_dict)
16
+                MigrationHandler(empty_connection_args)
20 17
 
21
-    ## @todo pass the connection arguments in the settings
22
-    @unittest.skip
23
-    def test_init_db(self):
24
-        correct_connection_args = {'host': 'localhost', 'port': 28015, 'username': 'lodel_admin', 'password': 'lapwd', 'db_name': 'lodel'}
25
-        migration_handler = MigrationHandler(correct_connection_args)
26
-        migration_handler.init_db()
18
+            bad_connection_args_dicts = [
19
+                {'host': 'localhost', 'port': 20030},
20
+                {'host': 'localhost', 'port': 28015},
21
+                {'host': 'localhost', 'port': 28015, 'login':'lodel', 'password': 'lap'}
22
+            ]
23
+            for bad_connection_args_dict in bad_connection_args_dicts:
24
+                with self.assertRaises(TypeError):
25
+                    MigrationHandler(bad_connection_args_dict)
26
+
27
+        ## @todo pass the connection arguments in the settings
28
+        @unittest.skip
29
+        def test_init_db(self):
30
+            correct_connection_args = {'host': 'localhost', 'port': 28015, 'username': 'lodel_admin', 'password': 'lapwd', 'db_name': 'lodel'}
31
+            migration_handler = MigrationHandler(correct_connection_args)
32
+            migration_handler.init_db()

+ 0
- 0
tests/plugin/__init__.py View File


+ 50
- 49
tests/plugin/test_plugin.py View File

@@ -3,62 +3,63 @@
3 3
 import unittest
4 4
 
5 5
 from lodel.plugin.plugins import Plugin, PluginError
6
+from lodel.plugin.datasource_plugin import DatasourcePlugin
7
+from lodel.plugin.sessionhandler import SessionHandlerPlugin
8
+from lodel.plugin.interface import InterfacePlugin
9
+from lodel.plugin.extensions import Extension
6 10
 from lodel.settings.settings import Settings
7 11
 import tests.loader_utils
8 12
 
13
+##@todo write tests about discovering
9 14
 class PluginTestCase(unittest.TestCase):
15
+    """ Test case grouping all tests on Plugin class init procedures """
10 16
 
11
-    def test_plugin_init_right_name(self):
12
-        Plugin.start(['/home/helene/lodel2/plugins'],['dummy'])
17
+    def setUp(self):
13 18
         Plugin.clear()
14
-        
15
-    # With a wrong plugin name, a NameError Exception has to be raised at line 318 of plugin.py
16
-    def test_plugin_init_wrong_name(self):
17
-        with self.assertRaises(NameError):
18
-            Plugin.start(['/home/helene/lodel2/plugins', '/home/helene/lodel2/tests/tests_plugins' ],['wrong_plugin_name'])
19
-        Plugin.clear()
20
-        
21
-    # With a wrong plugin name, a NameError Exception has to be raised at line 318 of plugin.py
22
-    def test_plugin_init_right_wrong_name(self):
23
-        with self.assertRaises(NameError):
24
-            Plugin.start(['/home/helene/lodel2/plugins', '/home/helene/lodel2/tests/tests_plugins'],['dummy', 'wrong_plugin_name'])
19
+
20
+    def test_start(self):
21
+        """ Testing plugin registration with a valid list of plugins name """
22
+        Plugin.start(['dummy', 'dummy_datasource'])
23
+
24
+    def test_double_start(self):
25
+        """ Testing clas behavior when starting it twice """
26
+        Plugin.start(['dummy', 'dummy_datasource'])
27
+        with self.assertRaises(PluginError):
28
+            Plugin.start(['dummy', 'dummy_datasource'])
29
+
30
+    def test_clear(self):
31
+        """ Testing that clear allow to start again Plugin """
32
+        Plugin.start(['dummy', 'dummy_datasource'])
25 33
         Plugin.clear()
26
-    
27
-    def test_plugin_started(self):
28
-        with self.assertRaises(RuntimeError):
29
-            Plugin.started()
30
-            
31
-    def test_plugin_plugin_path(self):
32
-        Plugin.start(['/home/helene/lodel2/plugins', '/home/helene/lodel2/tests/tests_plugins'],['dummy'])
33
-        self.assertEqual(Plugin.plugin_path('dummy'), '/home/helene/lodel2/plugins/dummy/')
34
+        Plugin.start(['dummy', 'dummy_datasource'])
35
+
36
+class PluginStartedTestCase(unittest.TestCase):
37
+    """ Test case grouping all tests on a started Plugin class """
38
+
39
+    @classmethod
40
+    def setUpClass(cls):
34 41
         Plugin.clear()
35
-        
36
-    def test_plugin_get(self):
37
-        Plugin.start(['/home/helene/lodel2/plugins', '/home/helene/lodel2/tests/tests_plugins'],['dummy'])
38
-        with self.assertRaises(PluginError):
39
-            Plugin.get('wrong_plugin_name')
40
-        self.assertTrue(isinstance(Plugin.get('dummy'), Plugin))
42
+        Plugin.start(['dummy', 'dummy_datasource', 'webui', 'ram_session'])
43
+
44
+    @classmethod
45
+    def tearDownClass(cls):
41 46
         Plugin.clear()
42
-        
43
-    def test_plugin_register(self):
44
-        with self.assertRaises(RuntimeError):
45
-            Plugin.register('dummy')
46
-        Plugin.start(['/home/helene/lodel2/plugins'],['dummy'])
47
+
48
+    def test_construct(self):
49
+        """ Testing plugin instanciation """
50
+        pname_type = {
51
+            'dummy': Extension,
52
+            'dummy_datasource': DatasourcePlugin,
53
+            #'webui': InterfacePlugin, #singleton, cannot reinstanciate
54
+            #'ram_session': SessionHandlerPlugin, #singleton, cannot resintanciate
55
+            }
56
+        for pname, ptype in pname_type.items():
57
+            pinstance = Plugin.get(pname)
58
+            self.assertIsInstance(pinstance, ptype, "Expected plugin '%s' \
59
+to be in an %s instance but found an %s instance" % (
60
+                pname, ptype, pinstance.__class__))
61
+
62
+    def test_construct_invalid(self):
63
+        """ Testing plugin instanciation with a non existing name """
47 64
         with self.assertRaises(PluginError):
48
-            Plugin.register('dummy')
49
-        Plugin.clear()
50
-        
51
-    def test_plugin_load_all(self):
52
-        #Plugin.start(['/home/helene/lodel2/plugins'],['dummynotactivable'])
53
-        #Plugin.load_all()
54
-        pass
55
-        
56
-    
57
-     
58
-        
59
-        
60
-        
61
-        
62
-        
63
-        
64
-        
65
+            Plugin.get("fljkhsfh")

+ 63
- 0
tests/plugin/tests_hooks.py View File

@@ -0,0 +1,63 @@
1
+#-*- coding: utf-8 -*-
2
+
3
+import unittest
4
+from unittest.mock import MagicMock
5
+
6
+from lodel.plugin.plugins import Plugin, PluginError
7
+from lodel.plugin.hooks import LodelHook
8
+
9
+testhook = 'are_we_sure_that_this_name_is_uniq'
10
+
11
+class HookTestCase(unittest.TestCase):
12
+
13
+    def setUp(self):
14
+        LodelHook.__reset__()
15
+
16
+    def test_registration(self):
17
+        """ Testing hook registration using decorator (checking using hook_list() """
18
+        hook_list = LodelHook.hook_list(testhook)
19
+        self.assertEqual({}, hook_list)
20
+        #hook_registration
21
+        @LodelHook(testhook,42)
22
+        def funny_fun_test_hook(hook_name, caller, payload):
23
+            pass
24
+        hook_list = LodelHook.hook_list(testhook)
25
+        self.assertEqual({testhook: [(funny_fun_test_hook, 42)]}, hook_list)
26
+
27
+    def test_call(self):
28
+        """ Testing LodelHook.call_hook() """
29
+        #manual registration using a mock
30
+        mmock = MagicMock(return_value = '4242')
31
+        mmock.__name__ = 'mmock'
32
+        hooking = LodelHook(testhook, 1337)
33
+        hooking(mmock)
34
+        res = LodelHook.call_hook(testhook, 'Caller', 'payload')
35
+        #Check returned value
36
+        self.assertEqual(
37
+            res,
38
+            '4242',
39
+            'Expected value was "4242" but found %s' % res)
40
+        #Checks call
41
+        mmock.assert_called_once_with(testhook, 'Caller', 'payload')
42
+
43
+    def test_priority_call(self):
44
+        """ Testing priority to ensure a call order """
45
+        @LodelHook(testhook, 1)
46
+        def stage_1_hook(name, caller, payload):
47
+            return '4'+payload
48
+
49
+        @LodelHook(testhook, 10)
50
+        def stage_1_hook(name, caller, payload):
51
+            return '3'+payload
52
+
53
+        @LodelHook(testhook, 20)
54
+        def stage_1_hook(name, caller, payload):
55
+            return '1'+payload
56
+
57
+        @LodelHook(testhook, 15)
58
+        def stage_1_hook(name, caller, payload):
59
+            return '2'+payload
60
+
61
+        result = LodelHook.call_hook(testhook, 'me', 'WootWoot')
62
+        self.assertEqual(result, '1234WootWoot')
63
+

Loading…
Cancel
Save