File: README.source

package info (click to toggle)
streamlink 1.0.0%2Bdfsg-1
  • links: PTS, VCS
  • area: main
  • in suites: buster
  • size: 3,588 kB
  • sloc: python: 31,121; makefile: 141; sh: 93
file content (72 lines) | stat: -rw-r--r-- 2,684 bytes parent folder | download
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
# Build procedure

Here are the commands to manage the package:
- Import upstream version and update Debian branch with new upstream release:
  - `gbp import-orig --uscan`

- Refresh patches:
  - `gbp pq import && gbp pq export`

- Check for important changes that may need other package changes (copyright, new patch, ...):
  - `https://github.com/streamlink/streamlink/compare/<old_tag>...<new_tag>`

- Build and test the package:
  - `debuild`

- Release version with `low` urgency:
  - `gbp dch -Ra --commit -U low`

- Build source package and tag Debian branch:
  - `gbp buildpackage --git-tag --git-sign-tags -nc -S`

- Build package using sbuild:
  - `sbuild -As ../streamlink_<version>.dsc -d unstable`
  - `gbp buildpackage "--git-builder=sbuild -v -As -d unstable --run-lintian --lintian-opts=\"-EviIL +pedantic\" --run-autopkgtest --autopkgtest-root-args= --autopkgtest-opts=\"-- schroot %r-%a-sbuild\""`

- Run lintian:
  - `lintian -EviIL +pedantic  ./streamlink_<version>_amd64.changes`

- Don't forget to push `master` and `upstream` branches along with new tags (`debian/<version>`, `upstream/<version>`)

# Changes checks

Check copyrights
Check dependencies in https://streamlink.github.io/install.html
Check doc dependencies:
	- libjs-modernizr
	- fonts-font-awesome
	- fonts-lato
	- fonts-inconsolata
	- fonts-roboto-slab
Check supported players in https://streamlink.github.io/players.html

# Building package from streamlink unreleased version

- Checkout master (andd update it if needed)
- Ensure git status return no modification (no dirty working copy)
- Generate python tarball: python3 ./setup.py sdist
- Import with gbp and filtering: `gbp import-orig --interactive --verbose --rollback ../streamlink_0.14.2-170-g3946184.orig.tar.gz --filter-pristine-tar --filter=docs/_themes/sphinx_rtd_theme_violet/static/fonts`


# Packages structure

## streamlink

This package contains the command line tool which use the public Python module available in python3-streamlink package.

This package contains the Python module `streamlink_cli` which is private and so goes to /usr/share/streamlink.
The command line script is also in /usr/share/streamlink so it can find the Python module.
/usr/bin/streamlink is a symlink to the command line script.

See also an advice about why not putting the command line script in /usr/bin:
  https://lists.debian.org/debian-python/2016/05/msg00046.html

As recommended in dh_installman manpage, manpage installation is defined in streamlink.manpages.

## python3-streamlink

This package contains the public Python module `streamlink`.

## python3-streamlink-doc

This package contains streamlink documentation in html format.