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
|
Download & Install
==================
Prerequisite: CastXML
---------------------
`CastXML`_ needs to be installed on your system.
1) If you are on linux or mac, your package manager may already provide a "castxml" package.
2) You can download pre-compiled binaries for `Linux`_, for `OS X`_ and for `Windows`_.
3) You can compile CastXML from source, either with the `SuperBuild`_, or by following the `full install instructions`_ .
Installation of pygccxml
------------------------
You can use pip to install pygccxml:
.. code-block:: shell
pip install pygccxml
To install from source, you can use the usual procedure:
.. code-block:: shell
pip install .
For development
%%%%%%%%%%%%%%%
You should use a ``virtualenv`` when possible. Example recipe:
.. code-block:: shell
cd pygccxml # git root
python -m virtualenv ./venv
source ./venv/bin/activate
pip install --editable .[test]
GCC-XML (Legacy)
----------------
These instructions are only here for historical reasons. `GCC-XML`_ was the tool used
to generate the xml files before CastXML existed.
**From version v1.8.0 on, pygccxml uses CastXML by default.
The support for GCC-XML was finally dropped in pygccxml v2.0.0.**
There are few different ways to install GCC-XML on your system:
1) Most Linux system provide the "gccxml" package through their package manager.
2) See the `instructions`_ to install GCC-XML from source.
.. _`instructions`: http://gccxml.org/HTML/Install.html
.. _`GCC-XML`: http://www.gccxml.org
.. _`CastXML`: https://github.com/CastXML/CastXML
.. _`Linux`: https://github.com/CastXML/CastXMLSuperbuild/releases/latest
.. _`OS X`: https://github.com/CastXML/CastXMLSuperbuild/releases/latest
.. _`Windows`: https://github.com/CastXML/CastXMLSuperbuild/releases/latest
.. _`SuperBuild`: https://github.com/thewtex/CastXMLSuperbuild
.. _`full install instructions`: https://github.com/CastXML/CastXML#build
|
