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
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
|
======================
History of API Changes
======================
ddaa@ddaa.net--2004/pyarch--ddaa--0.5--patch-175
================================================
Finished the deprecation of the getter methods in Patchlog.
Deprecated usage | Recommended replacement
------------------------------+------------------------
patchlog.get_description() | patchlog.description
patchlog.get_date() | patchlog.date
patchlog.get_creator() | patchlog.creator
patchlog.get_continuation() | patchlog.continuation_of
patchlog.continuation | patchlog.continuation_of
patchlog.get_new_patches() | patchlog.new_patches
patchlog.get_merged_patches() | patchlog.merged_patches
patchlog.get_new_files() | patchlog.new_files
patchlog.get_modified_files() | patchlog.modified_files
patchlog.get_renamed_files() | patchlog.renamed_files
patchlog.get_removed_files() | patchlog.removed_files
Before ddaa@ddaa.net--2004/pyarch--ddaa--0.5--patch-175
=======================================================
Date: 2004-01-16
Deprecate numerous methods and functions in favour of simpler syntaxes.
Deprecated arch.arch module
---------------------------
The arch.arch module has been deprecated, and some trouble has been
taken so that the high-level interface appears documented as part of
the arch package.
Deprecated usage | Recommended replacement
------------------------------+------------------------
from arch import arch | import arch
Deprecated getters in favour of properties
------------------------------------------
Read-only values which are normally immutable, and which are thus
susceptible to memoization, are represented in PyArch as properties.
Many of those properties were originally defined using public getter
methods. Now, they are defined using protected methods and the public
methods are deprecated.
Deprecated usage | Recommended replacement
------------------------------+------------------------
category.get_archive() | category.archive
branch.get_archive() | branch.archive
version.get_archive() | version.archive
revision.get_archive() | revision.archive
|
category.get_nonarch() | category.nonarch
branch.get_nonarch() | branch.nonarch
version.get_nonarch() | version.nonarch
revision.get_nonarch() | revision.nonarch
|
archive.get_fullname() | archive.fullname
category.get_fullname() | category.fullname
branch.get_fullname() | branch.fullname
version.get_fullname() | version.fullname
revision.get_fullname() | revision.fullname
|
version.get_branch() | version.branch
revision.get_branch() | revision.branch
|
revision.get_version() | revision.version
revision.get_patchlevel() | revision.patchlevel
|
archive.get_name() | archive.name
archive.get_location() | archive.location
archive.get_is_mirror() | archive.is_mirror
archive.get_official_name() | archive.official_name
archive.get_is_signed() | archive.is_signed
archive.get_has_listings() | archive.has_listings
|
revision.get_patchlog() | revision.patchlog
revision.get_ancestor() | revision.ancestor
revision.get_previous() | revision.previous
|
patchlog.get_revision() | patchlog.revision
patchlog.get_summary() | patchlog.summary
Deprecated instance sequences in favour of iterators
----------------------------------------------------
Methods which return sequences have been deprecated in favour of
similar methods returning iterators.
Also a few properties returning non-memoisable sequences (categories,
branches, versions, revisions) have been deprecated in the same way.
Deprecated usage | Recommended replacement
---------------------------------+------------------------
archive.get_categories() | list(archive.iter_categories())
archive.categories | list(archive.iter_categories())
archive.get_library_categories() | list(archive.iter_library_categories())
archive.library_categories | list(archive.iter_library_categories())
|
category.get_branches() | list(category.iter_branches())
category.branches | list(category.iter_branches())
category.get_library_branches() | list(category.iter_library_branches())
category.library_branches | list(category.iter_library_branches())
|
branch.get_versions() | list(category.iter_versions())
branch.versions | list(category.iter_versions())
|
branch.get_library_versions() | list(branch.iter_library_versions())
branch.library_versions | list(branch.iter_library_versions())
|
version.get_revisions() | list(version.iter_revisions())
version.revisions | list(version.iter_revisions())
|
version.get_library_revisions() | list(version.iter_library_revisions())
version.library_revisions | list(version.iter_library_revisions())
Deprecated package conversion
-----------------------------
The as_version() and as_revision() methods where introduced to make it
possible to indifferently process branches, versions, or revisions. It
turned out to be a bad idea. In useful cases, those methods just were
named in a way that did not say what they do, and in the other cases
they were just foolish consistency.
Deprecated usage | Recommended replacement
---------------------------------+------------------------
branch.as_version() | branch.latest_version()
version.as_version() | version
|
branch.as_revision() | branch.latest_revision()
version.as_revision() | version.latest_revision()
revision.as_revision() | revision
Deprecated function usage
-------------------------
Explicit is better than implicit, and in addition these methods are often used
as part of input validation, so it's better to be explicit when the current
directory is used.
Deprecated usage | Recommended replacement
---------------------------------+------------------------
arch.in_source_tree() | arch.in_source_tree('.')
arch.tree_root() | arch.tree_root('.')
Removed functions
-----------------
Several functions are now superseded by more generic functions,
iterator forms, or methods.
Deprecated usage | Recommended replacement
---------------------------------+------------------------
arch.changeset(orig, mod, dest) | arch.delta(ArchSourceTree(orig),
| ArchSourceTree(mod), dest)
arch.archives() | list(arch.iter_archives())
arch.library_archives() | list(arch.iter_library_archives())
arch.make_continuation(rev, vsn) | rev.make_continuation(vsn)
arch.get(revision, dir, link) | revision.get(dir, link)
arch.get_patch(revision, dir) | revision.get_patch(dir)
Removed functions without replacement
-------------------------------------
These functions are trivial or do not belong in generic library bindings.
I wrote them early in the development of pyrach for experimentation purposes.
arch.filter_archive_logs(limit, pred)
arch.filter_revisions(limit, pred)
arch.grep_summary(limit, rx)
arch.grep_summary_interactive(limit)
arch.suspected_move(limit)
arch.revisions_merging(limit, rev)
arch.temphack(revision)
arch.revision_which_created(file, revision)
arch.last_revision(tree)
arch.map_name_id(tree)
|