summaryrefslogtreecommitdiffstats
path: root/python/macholib/doc/framework.rst
blob: b58b5751cae712f984c43461fa6dd79758f80557 (plain)
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
:mod:`macholib.framework` --- Generic framework path manipulation
==========================================================================

.. module:: macholib.framework
   :synopsis: Generic framework path manipulation


This module defines a function :func:`framework_info` that can extract
useful information from the name of a dynamic library in a framework.

.. function:: framework_info(filename)

   A framework name can take one of the following four forms:

   * ``Location/Name.framework/Versions/SomeVersion/Name_Suffix``

   * ``Location/Name.framework/Versions/SomeVersion/Name``

   * ``Location/Name.framework/Name_Suffix``

   * ``Location/Name.framework/Name``

   Returns ``None`` if not found, or a mapping equivalent to::

      dict(
          location='Location',
          name='Name.framework/Versions/SomeVersion/Name_Suffix',
          shortname='Name',
          version='SomeVersion',
          suffix='Suffix',
      )

  .. note:: *SomeVersion* and *Suffix* are optional and may be None
     if not present.