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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
|
Metadata-Version: 2.2
Name: logilab-common
Version: 2.1.0
Summary: collection of low-level Python packages and modules used by Logilab projects
Home-page: https://forge.extranet.logilab.fr/open-source/logilab-common
Author: Logilab
Author-email: contact@logilab.fr
License: LGPL
Classifier: Topic :: Utilities
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.6
License-File: COPYING
License-File: COPYING.LESSER
Requires-Dist: setuptools
Requires-Dist: mypy-extensions
Requires-Dist: typing_extensions
Requires-Dist: importlib_metadata<7,>=6; python_version < "3.10"
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: home-page
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary
Logilab's common library
========================
What's this ?
-------------
This package contains some modules used by different Logilab projects.
It is released under the GNU Lesser General Public License.
There is no documentation available yet but the source code should be clean and
well documented.
Designed to ease:
* handling command line options and configuration files
* writing interactive command line tools
* manipulation of files and character strings
* manipulation of common structures such as graph, tree, and pattern such as visitor
* generating text and HTML reports
* more...
Documentation
-------------
Documentation is available at https://logilab-common.readthedocs.io/
Installation
------------
logilab-common is available on pypi so you can install it using pip ::
pip install logilab-common
Or alternatively extract the tarball, jump into the created directory and run ::
python setup.py install
For installation options, see ::
python setup.py install --help
Building the documentation
--------------------------
Create a virtualenv and install dependencies ::
virtualenv venv
source venv/bin/activate
# you need the krb5-config command to build all dependencies
# on debian you can get it using "apt-get install libkrb5-dev"
pip install doc/requirements-doc.txt
# install logilab-common
pip install -e .
Then build the doc ::
cd doc
make html
It's now available under `doc/_build/html/`
Code style
----------
The python code is verified against *flake8* and formatted with *black*.
* You can run `tox -e black` to check that the files are well formatted.
* You can run `tox -e black-run` to format them if needed.
* You can include the `.hgrc` to your own `.hgrc` to automatically run black
before each commit/amend. This can be done by writing `%include ../.hgrc` at
the end of your `.hgrc`.
Comments, support, bug reports
------------------------------
Project page https://www.logilab.org/project/logilab-common
Use the cubicweb-devel at lists.cubicweb.org mailing list.
You can subscribe to this mailing list at
https://lists.cubicweb.org/mailman/listinfo/cubicweb-devel
Archives are available at
https://lists.cubicweb.org/pipermail/cubicweb-devel/
|
