./devel/py-deprecation, Library to handle automated deprecations

[ CVSweb ] [ Homepage ] [ RSS ] [ Required by ] [ Add to tracker ]


Branch: CURRENT, Version: 2.0.5, Package name: py27-deprecation-2.0.5, Maintainer: pkgsrc-users

The deprecation library provides a deprecated decorator and a
fail_if_not_removed decorator for your tests. Together, the two enable the
automation of several things:

1. The docstring of a deprecated method gets the deprecation details appended to
the end of it. If you generate your API docs direct from your source, you don't
need to worry about writing your own notification. You also don't need to worry
about forgetting to write it. It's done for you.

2. Rather than having code live on forever because you only deprecated it but
never actually moved on from it, you can have your tests tell you when it's
time to remove the code. The @deprecated decorator can be told when it's time
to entirely remove the code, which causes @fail_if_not_removed to raise an
AssertionError, causing either your unittest or py.test tests to fail.


Required to run:
[devel/py-setuptools] [lang/python27] [devel/py-packaging]

Required to build:
[pkgtools/cwrappers]

Master sites:

SHA1: f3437509318a5f6990bcd92afc73753a07a7f584
RMD160: 5270638f7212cec1e9ae4df3024c28a0289a3192
Filesize: 12.901 KB

Version history: (Expand)


CVS history: (Expand)


   2018-07-06 12:35:41 by Adam Ciarcinski | Files touched by this commit (2) | Package updated
Log message:
py-deprecation: updated to 2.0.5

2.0.5:
Bug fixes.
   2018-06-21 08:43:05 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-deprecation: updated to 2.0.4

2.0.4:
Bug fixes.
   2018-06-18 09:47:40 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-deprecation: updated to 2.0.3

2.0.3:
Bug fixes.
   2018-04-14 10:46:28 by Adam Ciarcinski | Files touched by this commit (2) | Package updated
Log message:
py-deprecation: updated to 2.0.2

2.0.2:
Bug fixes.
   2018-04-11 21:49:38 by Adam Ciarcinski | Files touched by this commit (2) | Package updated
Log message:
py-deprecation: updated to 2.0.1

2.0.1:
Bug fixes.
   2018-02-27 08:56:38 by Adam Ciarcinski | Files touched by this commit (2) | Package updated
Log message:
py-deprecation: updated to 2.0

2.0:
Unknown changes.
   2018-02-05 14:18:04 by Adam Ciarcinski | Files touched by this commit (3) | Package updated
Log message:
py-deprecation: updated to 1.1

1.1:
Unknown changes.
   2017-12-31 19:47:08 by Adam Ciarcinski | Files touched by this commit (4)
Log message:
py-deprecation: added version 1.0.1

The deprecation library provides a deprecated decorator and a
fail_if_not_removed decorator for your tests. Together, the two enable the
automation of several things:

1. The docstring of a deprecated method gets the deprecation details appended to
the end of it. If you generate your API docs direct from your source, you don't
need to worry about writing your own notification. You also don't need to worry
about forgetting to write it. It's done for you.

2. Rather than having code live on forever because you only deprecated it but
never actually moved on from it, you can have your tests tell you when it's
time to remove the code. The @deprecated decorator can be told when it's time
to entirely remove the code, which causes @fail_if_not_removed to raise an
AssertionError, causing either your unittest or py.test tests to fail.