Ravenports generated: 02 Oct 2023 22:25
[ravenports.git] / bucket_8D / python-freetype-py
1 # Buildsheet autogenerated by ravenadm tool -- Do not edit.
2
3 NAMEBASE=               python-freetype-py
4 VERSION=                2.4.0
5 KEYWORDS=               python
6 VARIANTS=               py310 v11
7 SDESC[py310]=           Freetype python bindings (3.10)
8 SDESC[v11]=             Freetype python bindings (3.11)
9 HOMEPAGE=               https://github.com/rougier/freetype-py
10 CONTACT=                Python_Automaton[python@ironwolf.systems]
11
12 DOWNLOAD_GROUPS=        main
13 SITES[main]=            PYPI/f/freetype-py
14 DISTFILE[1]=            freetype-py-2.4.0.zip:main
15 DF_INDEX=               1
16 SPKGS[py310]=           single
17 SPKGS[v11]=             single
18
19 OPTIONS_AVAILABLE=      PY310 PY311
20 OPTIONS_STANDARD=       none
21 VOPTS[py310]=           PY310=ON PY311=OFF
22 VOPTS[v11]=             PY310=OFF PY311=ON
23
24 DISTNAME=               freetype-py-2.4.0
25
26 GENERATED=              yes
27
28 [PY310].BUILDRUN_DEPENDS_ON=            python-setuptools-scm:single:py310
29 [PY310].USES_ON=                        python:py310,sutools
30
31 [PY311].BUILDRUN_DEPENDS_ON=            python-setuptools-scm:single:v11
32 [PY311].USES_ON=                        python:v11,sutools
33
34 [FILE:3659:descriptions/desc.single]
35 FreeType (high-level Python API)
36 ================================
37
38 Freetype Python provides bindings for the FreeType library. Only the
39 high-level API is bound.
40
41 Documentation available at: http://freetype-py.readthedocs.org/en/latest/
42
43 Installation
44 ============
45
46 **From PyPI, recommended**: `pip install freetype-py`. This will install
47 the
48 library with a bundled FreeType binary, so you're ready to go on Windows,
49 macOS and Linux (all with 32 and 64 bit x86 architecture support).
50
51 Do note: if you specify the `--no-binary` paramater to pip, or use a
52 different
53 architecture for which we don't pre-compile binaries, the package will
54 default
55 to using an external FreeType library. Specify the environment variable
56 `FREETYPEPY_BUNDLE_FT=1` before calling pip to compile a binary yourself.
57
58 Installation with compiling FreeType from source
59 ------------------------------------------------
60
61 If you don't want to or can't use the pre-built binaries, build FreeType
62 yourself: `export FREETYPEPY_BUNDLE_FT=yesplease && pip install .`.
63 This will download and compile FreeType with Harfbuzz support as specified
64 in
65 `setup-build-freetype.py`. Set the environment variable `PYTHON_ARCH` to 32
66 or
67 64 to explicitly set an architecture, default is whatever your host machine
68 uses. On macOS, we will always build a universal 32 and 64 bit Intel
69 binary.
70
71 - Windows: You need CMake and a C and C++ compiler, e.g. the Visual Code
72   Community 2017 distribution with the desktop C++ workload.
73 - macOS: You need CMake and the XCode tools (full IDE not necessary)
74 - Linux: You need CMake, gcc and g++. For building a 32 bit library on a
75   64 bit machine, you need gcc-multilib and g++-multilib (Debian) or
76   glibc-devel.i686 and libstdc++-devel.i686 (Fedora).
77
78 Installation with an external FreeType library (the default)
79 ------------------------------------------------------------
80
81 Install just the pure Python library and let it find a system-wide
82 installed
83 FreeType at runtime.
84
85 Mac users
86 ~~~~~~~~~
87
88 Freetype should be already installed on your system. If not, either install
89 it
90 using [homebrew] or compile it and place the library binary
91 file in '/usr/local/lib'.
92
93 Linux users
94 ~~~~~~~~~~~
95
96 Freetype should be already installed on your system. If not, either install
97 relevant package from your package manager or compile from sources and
98 place
99 the library binary file in '/usr/local/lib'.
100
101 Window users
102 ~~~~~~~~~~~~
103
104 There are no official Freetype binary releases available, but they offer
105 some
106 links to precompiled Windows DLLs. Please see the [FreeType Downloads
107 ] page for links.
108 You can also compile the FreeType library from source yourself.
109
110 If you are using freetype-py on Windows with a 32-Bit version of Python,
111 you
112 need the 32-Bit version of the Freetype binary. The same applies for a
113 64-Bit
114 version of Python.
115
116 Because of the way Windows searches for dll files, make sure the resulting
117 file is named 'freetype.dll' (and not something like Freetype245.dll).
118 Windows expects the library in one of the directories listed in the $PATH
119 environment variable. As it is not recommended to place the dll in a
120 Windows
121 system folder, you can choose one of the following ways to solve this:
122
123 * Place library in a folder of your choice and edit the $PATH user
124   environment variable
125 * Place library in a folder of your choice and edit the $PATH system
126   environment variable
127 * For development purpose, place the library in the working directory of
128   the application
129 * Place the library in one of the existing directories listed in $PATH
130
131 To get a complete list of all the directories in the $PATH
132 environment variable (user and system), open a command promt and type
133
134 .. code::
135
136
137 [FILE:100:distinfo]
138 8ad81195d2f8f339aba61700cebfbd77defad149c51f59b75a2a5e37833ae12e       832493 freetype-py-2.4.0.zip
139