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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
|
.. _utils:
************************************************
Astropy Core Package Utilities (`astropy.utils`)
************************************************
Introduction
============
The `astropy.utils` package contains general-purpose utility functions and
classes. Examples include data structures, tools for downloading and caching
from URLs, and version intercompatibility functions.
This functionality is not astronomy-specific, but is intended primarily for
use by Astropy developers. It is all safe for users to use, but the functions
and classes are typically more complicated or specific to a particular need of
Astropy.
Because of the mostly standalone and grab-bag nature of these utilities, they
are generally best understood through their docstrings, and hence this
documentation generally does not have detailed sections like the other packages.
The exception is below:
.. toctree::
:maxdepth: 1
iers
.. note:: The ``astropy.utils.compat`` subpackage is not included in this
documentation. It contains utility modules for compatibility with
older/newer versions of python and numpy, as well as including some
bugfixes for the stdlib that are important for Astropy. It is recommended
that developers at least glance over the source code for this subpackage,
but most of it cannot be reliably included here because of the large
amount of version-specific code it contains. For numpy, however, there are
:ref:`instructions <numpy-compatibility>` on how to deal with issues of
compatibility between different versions.
Reference/API
=============
.. module:: astropy.utils
.. automodapi:: astropy.utils.codegen
:no-inheritance-diagram:
.. automodapi:: astropy.utils.collections
:no-inheritance-diagram:
.. automodapi:: astropy.utils.console
:no-inheritance-diagram:
.. automodapi:: astropy.utils.data_info
:no-inheritance-diagram:
.. automodapi:: astropy.utils.decorators
:no-inheritance-diagram:
.. automodapi:: astropy.utils.diff
:no-inheritance-diagram:
.. automodapi:: astropy.utils.exceptions
:no-inheritance-diagram:
.. automodapi:: astropy.utils.iers
:no-inheritance-diagram:
.. automodapi:: astropy.utils.introspection
:no-inheritance-diagram:
.. automodapi:: astropy.utils.metadata
:no-inheritance-diagram:
.. automodapi:: astropy.utils.misc
:no-inheritance-diagram:
.. automodapi:: astropy.utils.state
:no-inheritance-diagram:
.. automodapi:: astropy.utils.timer
:no-inheritance-diagram:
File Downloads
--------------
.. automodapi:: astropy.utils.data
:no-inheritance-diagram:
XML
---
The ``astropy.utils.xml.*`` modules provide various
`XML <http://www.w3.org/XML/>`_ processing tools.
.. automodapi:: astropy.utils.xml.check
:no-inheritance-diagram:
:headings: ^"
.. automodapi:: astropy.utils.xml.iterparser
:no-inheritance-diagram:
:headings: ^"
.. automodapi:: astropy.utils.xml.unescaper
:no-inheritance-diagram:
:headings: ^"
.. automodapi:: astropy.utils.xml.validate
:no-inheritance-diagram:
:headings: ^"
.. automodapi:: astropy.utils.xml.writer
:no-inheritance-diagram:
:headings: ^"
|
