File: HACKING.rst

package info (click to toggle)
python-pyld 0.6.8-1
  • links: PTS, VCS
  • area: main
  • in suites: buster, stretch
  • size: 316 kB
  • ctags: 241
  • sloc: python: 3,203; makefile: 111
file content (39 lines) | stat: -rw-r--r-- 1,034 bytes parent folder | download | duplicates (3)
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
Hacking on PyLD
===============

Want to hack on PyLD? Great! Here are a few notes:

Code
----

* In general, follow the common [PEP 8 Style Guide][].
* Try to make the code pass [flake8][] checks.
  * `flake8 lib/pyld/jsonld.py`
* Use version X.Y.Z-dev in dev mode.
* Use version X.Y.Z for releases.

Versioning
----------

* Follow the [Semantic Versioning][] guidelines.

Release Process
---------------

* commit changes
* `$EDITOR lib/pyld/jsonld.py`: update to release version and remove `-dev`
  suffix.
* `git commit lib/pyld/jsonld.py -m "Release {version}."`
* `git tag {version}`
* `$EDITOR lib/pyld/jsonld.py`: update to next version and add `-dev` suffix.
* `git commit lib/pyld/jsonld.py -m "Start {next-version}."`
* `git push --tags`

To ensure a clean upload, use a clean checkout, and run the following:

* `git checkout {version}`
* `python setup.py sdist upload`

[PEP 8 Style Guide]: http://www.python.org/dev/peps/pep-0008/
[flake8]: https://pypi.python.org/pypi/flake8
[Semantic Versioning]: http://semver.org/