File: README.md

package info (click to toggle)
debiancontributors 0.7.8-2
  • links: PTS, VCS
  • area: main
  • in suites: bullseye, sid
  • size: 404 kB
  • sloc: python: 1,894; makefile: 18
file content (73 lines) | stat: -rw-r--r-- 2,265 bytes parent folder | download | duplicates (7)
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
debiancontributors python module
================================

See https://wiki.debian.org/DebianContributors for technical information about
contributors.debian.org

See https://wiki.debian.org/Teams/FrontDesk/DcSiteDevel for this project's page
in the Debian wiki.

## Computing and posting data using dc-tool

You can describe a data source and how to look for contribution data in a
simple configuration file, then run this to perform data mining and submit data
to the site, all in one go:

	dc-tool --mine myconfigfile --post

Without --post, it prints the results of data mining on standard output: it is
useful to test a data mining configuration.

See DATAMINING.rst and the examples/ directory for documentation and examples
for the data mining configuration.

## Posting data using dc-tool

Assuming you [created a data source in the website][newds] called
`myteam.debian.net` with authentication token 'foobar'.

Assuming you have generated a file `submission.json`, with your submission.

You can post it with `dc-tool` using:

	dc-tool --source myteam.debian.net --auth-token foobar --post submission.json

dc-tool will validate the submission for you before posting it.

You can check the contents of the submission by running `dc-tool` without
any option:

	dc-tool submission.json

## Posting data using python code

Assuming you [created a data source in the website][newds] called
`myteam.debian.net` with authentication token 'foobar'.

	import debiancontributors as dc
	from datetime import Date

	# Create a Submission
	s = dc.Submission("myteam.debian.net")

	# Add contribution data to it
	s.add_contribution(
		dc.Identifier("email", "enrico@debian.org"),
		dc.Contribution("shave_yaks", Date(2013, 1, 1), Date(2013, 12, 23)))

	# Post it to the site
	success, info = s.post("foobar")
	if not success:
		import json
		print("submission failed:")
		print(json.dumps(info, indent=1))


## Posting data the way you like

Posting a submission is just a matter of building a JSON data structure and
posting it to the site via HTTP POST. See
[DebianContributors Implementation notes](https://wiki.debian.org/DebianContributors#Implementation_notes)
for details.

[newds]: https://wiki.debian.org/DebianContributors#Creating_a_new_data_source