9 Commits

Author SHA1 Message Date
Stephen Finucane
2d4025b002 Remove unnecessary 'coding' lines
Everything is unicode in Python 3. No need for these anymore.

Signed-off-by: Stephen Finucane <stephenfin@redhat.com>
Change-Id: I722095c41c8e014b38bfbb16aaecae0023fcf3a8
2021-11-04 10:45:02 +00:00
Thomas Goirand
aa426abafe Restore reproducibility in docs
The documentation is writting the date in its copyright. This is
considered bad practice, because this kills reproducibility. If
you don't know about reproducible build, please read on:

https: //reproducible-builds.org/
Change-Id: I6427c83af06ac58da32898f00d3f99dc6ba1ae93
2021-09-07 10:54:30 +02:00
liyou01
4c26e72d61 remove unicode from code
Change-Id: I65d63c955dec439fc599754624d3dc9b96f3f6c3
2021-05-18 11:26:49 +08:00
Hervé Beraud
be7bc9ecf9 Adding pre-commit
Introduced changes:
- pre-commit config and rules
- Add pre-commit to pep8 gate, Flake8 is covered in the pre-commit hooks.
- Applying fixes for pre-commit compliance in all code.

Also commit hash will be used instead of version tags in pre-commit to
prevend arbitrary code from running in developer's machines.

pre-commit will be used to:
- trailing whitespace;
- Replaces or checks mixed line ending (mixed-line-ending);
- Forbid files which have a UTF-8 byte-order marker (check-byte-order-marker);
- Checks that non-binary executables have a proper
  shebang (check-executables-have-shebangs);
- Check for files that contain merge conflict strings (check-merge-conflict);
- Check for debugger imports and py37+ breakpoint()
  calls in python source (debug-statements);
- Attempts to load all yaml files to verify syntax (check-yaml);
- Run flake8 checks (flake8) (local)

For further details about tests please refer to:
https://github.com/pre-commit/pre-commit-hooks

Change-Id: I382aa79f7357a86af11783f59e0f1680d5bed8d0
Signed-off-by: Moisés Guimarães de Medeiros <moguimar@redhat.com>
2020-09-22 10:37:04 +02:00
Andreas Jaeger
d5bc18e320 Switch to newer openstackdocstheme and reno versions
Switch to openstackdocstheme 2.2.1 and reno 3.1.0 versions. Using
these versions will allow especially:
* Linking from HTML to PDF document
* Allow parallel building of documents
* Fix some rendering problems

Update Sphinx version as well.

Disable openstackdocs_auto_name to use 'project' variable as name.

Change pygments_style to 'native' since old theme version always used
'native' and the theme now respects the setting and using 'sphinx' can
lead to some strange rendering.

openstackdocstheme renames some variables, so follow the renames
before the next release removes them. A couple of variables are also
not needed anymore, remove them.

See also
http://lists.openstack.org/pipermail/openstack-discuss/2020-May/014971.html

Change-Id: I6974f7131d7ac43b427f8ac6381aff80b9dcb884
2020-05-26 08:56:49 +02:00
Akihiro Motoki
b77c77f03e switch from oslosphinx to openstackdocstheme
Change-Id: I0dd253f90dfa2c4e5afd8d5fae3657a64788f1cf
2017-07-01 18:59:13 +09:00
Joshua Harlow
7e3f6d41d7 Add doctested examples into the documentation
To make it more easy for those to see how to use
this library, start adding some basic examples that
show the common usage patterns.

Change-Id: Ieda04d0c3402cb3d9d7e55ecfd737571520ffbcb
2015-02-06 18:32:45 -08:00
Joshua Harlow
9f0f114b27 Fix up the docs into reasonable shape
Make the docs include the exposed API's and be formatted
better so that they are useful to users of debtcollector instead
of not being useful.

Change-Id: I6b1bdda206927d1475cabb1872a3fe21a178b125
2015-02-02 12:09:30 -08:00
Joshua Harlow
2c4e7d58dd Initial commit 2014-12-12 22:26:59 -08:00