1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
..
Copyright (c) 2015, Red Hat, Inc. and/or its affiliates
Licensed under CC-BY-SA-3.0; see the license file
py3c: Python 2/3 compatibility layer for C extensions
=====================================================
This is *py3c*, a library for easing porting C extensions to Python 3,
providing macros for *single-source compatibility* between
Python 2.6, 2.7, and 3.3+.
It could be described as "the `six <https://pypi.python.org/pypi/six>`_
for C extensions".
Pick the docs you wish to read:
* :doc:`Porting guide <guide>`
A detailed **walkthrough** for porting to Python 3.
Read if you wish to start porting a C extension to Python 3.
* :doc:`Cheatsheet <cheatsheet>`
A **quick reference**, helpful if you're in the middle of porting.
Also useful if you find yourself working on a project that someone else
is porting, and don't understand what's going on.
If you want something to print out a stick on your wall,
use this – compared to the other docs, you'll save trees.
* :doc:`Definition Summary <defs>`
A **table** summarizing how py3c's macros are defined.
Convenient if you already know the differences between Python 2 and 3,
or before a dive into py3c's internals.
Also serves as a summary of where py3c provides the
Python 3 API, and where it resorts to inventing its own macros.
* :doc:`Reference <reference>`
Lists **every macro** py3c defines.
The search will point you here when it finds a term.
* :ref:`Index <genindex>` and :ref:`Search <search>`
Head here if you're looking for something specific.
Project info
============
The py3c library is available under the MIT license.
This documentation is available under the Creative Commons Attribution-ShareAlike 3.0 Unported license.
May they serve you well.
The high-level history of py3c is chronicled in the :doc:`Changelog <changelog>`.
If you'd like to contribute code, words, suggestions, bug reports, or anything else,
do so at `the Github page <http://github.com/encukou/py3c>`_.
For more info, see :doc:`Contributing <contributing>`.
Oh, and you should pronounce "py3c" with a hard "c", if you can manage to do so.
.. toctree::
:hidden:
guide
cheatsheet
defs
reference
special-guides
contributing
changelog
|
