File: migrating.rst

package info (click to toggle)
dput-ng 1.44
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,052 kB
  • sloc: python: 3,927; makefile: 154; sh: 10
file content (49 lines) | stat: -rw-r--r-- 1,550 bytes parent folder | download | duplicates (10)
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
Migration guide from old-style dput
===================================

Welcome! This is a helpful starting guide for anyone looking to switch from
dput to dput-ng. dput-ng features a few interesting changes, so it's worthwhile
to run through this helpful starting guide.

Key points
----------

  * dput's configuration files *are* supported, and *will* override any
    new-style configuration file.

  * Behavior of pre-upload checks *may* be different.

  * dput-ng maintains backwards compatibility with the old dput's command line
    flags.

  * dcut has a totally revamped interface, but is similar in spirit and
    usability of dput's dcut interface.

  * This package *replaces* old style dput.

Big changes from dput
---------------------

  * Configuration can be defined in JSON. :doc:`configs` may be of
    some help.

  * More and better behaved checks are enabled by default, and more are
    ready for use out of the box, if you so wish.

  * post-upload hook and pre-upload checks (or hooks) may be written
    in Python, and have access to the objects which matter. For more on
    writing one, :doc:`hooks` may provide some insight.

Stability Notes
---------------

This *is not* finished. There are bits to be done, but this shows a decent
amount of progress being made on the tool, and is mostly ready for limited
use by technical people.

  * Bug reports are extremely welcome.

  * Ideas are extremely welcome.

  * Contributors are extremely welcome -- of all kinds (technical or
    otherwise) (see :doc:`contributing`)