README
author Denis Laxalde <denis.laxalde@logilab.fr>
Fri, 05 Apr 2019 17:58:19 +0200
changeset 12567 26744ad37953
parent 12532 38004d09d178
child 12570 82bf85157b53
permissions -rw-r--r--
Drop python2 support This mostly consists in removing the dependency on "six" and updating the code to use only Python3 idioms. Notice that we previously used TemporaryDirectory from cubicweb.devtools.testlib for compatibility with Python2. We now directly import it from tempfile.
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2562
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
     1
CubicWeb semantic web framework
0
b97547f5f1fa Showtime !
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
diff changeset
     2
===============================
2562
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
     3
5024
9e718abe3fde add egg support with dependencies auto-installation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 2562
diff changeset
     4
CubicWeb is a entities / relations based knowledge management system
9e718abe3fde add egg support with dependencies auto-installation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 2562
diff changeset
     5
developped at Logilab.
9e718abe3fde add egg support with dependencies auto-installation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 2562
diff changeset
     6
9e718abe3fde add egg support with dependencies auto-installation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 2562
diff changeset
     7
This package contains:
7741
45251e611209 [doc] fix ReST in README file (make pypi happier)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7613
diff changeset
     8
45251e611209 [doc] fix ReST in README file (make pypi happier)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7613
diff changeset
     9
- a repository server
45251e611209 [doc] fix ReST in README file (make pypi happier)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7613
diff changeset
    10
- a RQL command line client to the repository
45251e611209 [doc] fix ReST in README file (make pypi happier)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7613
diff changeset
    11
- an adaptative modpython interface to the server
45251e611209 [doc] fix ReST in README file (make pypi happier)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7613
diff changeset
    12
- a bunch of other management tools
5024
9e718abe3fde add egg support with dependencies auto-installation
Alain Leufroy <alain.leufroy@logilab.fr>
parents: 2562
diff changeset
    13
0
b97547f5f1fa Showtime !
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
diff changeset
    14
Install
b97547f5f1fa Showtime !
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
diff changeset
    15
-------
2562
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    16
12262
282bc6fb50fd Link to "3.26" docs in README
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12141
diff changeset
    17
More details at https://cubicweb.readthedocs.io/en/3.26/book/admin/setup
2562
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    18
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    19
Getting started
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    20
---------------
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    21
7741
45251e611209 [doc] fix ReST in README file (make pypi happier)
Sylvain Thénault <sylvain.thenault@logilab.fr>
parents: 7613
diff changeset
    22
Execute::
0
b97547f5f1fa Showtime !
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
diff changeset
    23
12532
38004d09d178 [doc] Update README "Getting started"
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents: 12375
diff changeset
    24
 python3 -m venv venv
38004d09d178 [doc] Update README "Getting started"
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents: 12375
diff changeset
    25
 source venv/bin/activate
38004d09d178 [doc] Update README "Getting started"
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents: 12375
diff changeset
    26
 pip install 'cubicweb[pyramid]' cubicweb-blog
2562
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    27
 cubicweb-ctl create blog myblog
12532
38004d09d178 [doc] Update README "Getting started"
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents: 12375
diff changeset
    28
 # read how to create your ~/etc/cubicweb.d/myblog/pyramid.ini file here:
38004d09d178 [doc] Update README "Getting started"
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents: 12375
diff changeset
    29
 # https://cubicweb.readthedocs.io/en/latest/book/pyramid/settings/#pyramid-settings-file
38004d09d178 [doc] Update README "Getting started"
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents: 12375
diff changeset
    30
 # then start your instance:
38004d09d178 [doc] Update README "Getting started"
Philippe Pepiot <philippe.pepiot@logilab.fr>
parents: 12375
diff changeset
    31
 cubicweb-ctl pyramid -D myblog
2562
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    32
 sensible-browser http://localhost:8080/
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    33
12262
282bc6fb50fd Link to "3.26" docs in README
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12141
diff changeset
    34
Details at https://cubicweb.readthedocs.io/en/3.26/tutorials/base/blog-in-five-minutes
2562
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    35
12372
392aa430bf96 [README] point to logilab's jenkins in tests section
Laurent Peuch <cortex@worlddomination.be>
parents: 12262
diff changeset
    36
You can also look at the latest builds on Logilab's jenkins:
392aa430bf96 [README] point to logilab's jenkins in tests section
Laurent Peuch <cortex@worlddomination.be>
parents: 12262
diff changeset
    37
https://jenkins.logilab.org/
392aa430bf96 [README] point to logilab's jenkins in tests section
Laurent Peuch <cortex@worlddomination.be>
parents: 12262
diff changeset
    38
0
b97547f5f1fa Showtime !
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
diff changeset
    39
Documentation
b97547f5f1fa Showtime !
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
diff changeset
    40
-------------
2562
dd76d0f88796 [doc] #120075 quickstart (was proposed structure)
Nicolas Chauvat <nicolas.chauvat@logilab.fr>
parents: 0
diff changeset
    41
12262
282bc6fb50fd Link to "3.26" docs in README
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12141
diff changeset
    42
Look in the doc/ subdirectory or read https://cubicweb.readthedocs.io/en/3.26/
0
b97547f5f1fa Showtime !
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
diff changeset
    43
b97547f5f1fa Showtime !
Adrien Di Mascio <Adrien.DiMascio@logilab.fr>
parents:
diff changeset
    44
12106
eeb2b2ec1928 Make entypo link a true URL in README
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12105
diff changeset
    45
CubicWeb includes the Entypo pictograms by Daniel Bruce — http://www.entypo.com
12141
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    46
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    47
Contributing
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    48
------------
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    49
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    50
Patches should be submitted by email at the cubicweb-devel@lists.cubicweb.org
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    51
mailing list in order to get reviewed by project integrators or any community
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    52
member.
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    53
The simplest way of send patches is to use the ``hg email`` command available
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    54
through the *patchbomb* extension of Mercurial. Preferably, patches should be
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    55
*in the message body* of emails. When submitting a revised version of a patch
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    56
series, a prefix indicating the iteration number ``<n>`` of the series should
29d032bb70d8 Add a "Contributing" section to README with patch submission guidelines
Denis Laxalde <denis.laxalde@logilab.fr>
parents: 12106
diff changeset
    57
be added to email subject prefixes; this can be achieved by specifying a
12373
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    58
``--flag v<n>`` option to ``hg email`` command. If needed you can also use the
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    59
--in-reply-to option.
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    60
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    61
Examples:
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    62
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    63
    hg email --to cubicweb-devel@lists.cubicweb.org --intro -r <start>::<end>
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    64
    hg email --flag V2 --to cubicweb-devel@lists.cubicweb.org -r <start>::<end>
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    65
12375
e7221f2123e6 [README] point to xmpp room for contributors
Laurent Peuch <cortex@worlddomination.be>
parents: 12373
diff changeset
    66
If you have any questions you can also come on Logilab's public XMPP room using
e7221f2123e6 [README] point to xmpp room for contributors
Laurent Peuch <cortex@worlddomination.be>
parents: 12373
diff changeset
    67
a XMPP client: public@conference.jabber.logilab.org
e7221f2123e6 [README] point to xmpp room for contributors
Laurent Peuch <cortex@worlddomination.be>
parents: 12373
diff changeset
    68
12373
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    69
Mailing list: https://lists.cubicweb.org/mailman/listinfo/cubicweb-devel
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    70
Patchbomb extension: https://www.mercurial-scm.org/wiki/PatchbombExtension
e7ef70b3a0eb [README] improve contribution section with links and command examples
Laurent Peuch <cortex@worlddomination.be>
parents: 12372
diff changeset
    71
Good practice on sending email patches: https://www.mercurial-scm.org/wiki/ContributingChanges#Emailing_patches