Metadata-Version: 2.1
Name: cubicweb
Version: 3.28.3
Summary: a repository of entities / relations for knowledge management
Home-page: https://www.cubicweb.org
Author: Logilab
Author-email: contact@logilab.fr
License: LGPL
Platform: UNKNOWN
Requires-Python: >=3.6
Requires-Dist: logilab-common (>=1.5.2)
Requires-Dist: logilab-mtconverter (>=0.8.0)
Requires-Dist: rql (>=0.34.0)
Requires-Dist: yams (>=0.45.0)
Requires-Dist: lxml
Requires-Dist: logilab-database (>=1.15.0)
Requires-Dist: passlib (>=1.7)
Requires-Dist: pytz
Requires-Dist: Markdown
Requires-Dist: filelock
Requires-Dist: rdflib
Requires-Dist: rdflib-jsonld
Provides-Extra: captcha
Requires-Dist: Pillow ; extra == 'captcha'
Provides-Extra: crypto
Requires-Dist: pycryptodomex ; extra == 'crypto'
Provides-Extra: ext
Requires-Dist: docutils (>=0.6) ; extra == 'ext'
Provides-Extra: ical
Requires-Dist: vobject (>=0.6.0) ; extra == 'ical'
Provides-Extra: pyramid
Requires-Dist: pyramid (<2.0.0,>=1.5.0) ; extra == 'pyramid'
Requires-Dist: waitress (>=0.8.9) ; extra == 'pyramid'
Requires-Dist: wsgicors (>=0.3) ; extra == 'pyramid'
Requires-Dist: pyramid-multiauth ; extra == 'pyramid'
Requires-Dist: repoze.lru ; extra == 'pyramid'
Provides-Extra: sparql
Requires-Dist: fyzz (>=0.1.0) ; extra == 'sparql'
Provides-Extra: zmq
Requires-Dist: pyzmq ; extra == 'zmq'

CubicWeb semantic web framework
===============================

CubicWeb is a entities / relations based knowledge management system
developped at Logilab.

This package contains:

- a repository server
- a RQL command line client to the repository
- an adaptative modpython interface to the server
- a bunch of other management tools

Install
-------

More details at https://cubicweb.readthedocs.io/en/latest/book/admin/setup

Getting started
---------------

Execute::

 python3 -m venv venv
 source venv/bin/activate
 pip install 'cubicweb[pyramid]' cubicweb-blog
 cubicweb-ctl create blog myblog
 # read how to create your ~/etc/cubicweb.d/myblog/pyramid.ini file here:
 # https://cubicweb.readthedocs.io/en/latest/book/pyramid/settings/#pyramid-settings-file
 # then start your instance:
 cubicweb-ctl pyramid -D myblog
 sensible-browser http://localhost:8080/

Details at https://cubicweb.readthedocs.io/en/latest/tutorials/base/blog-in-five-minutes

You can also look at the latest builds on Logilab's forge:
https://forge.extranet.logilab.fr/cubicweb/cubicweb

Test
----

Simply run the `tox` command in the root folder of this repository:

    tox

How to install tox: https://tox.readthedocs.io/en/latest/install.html

Documentation
-------------

Look in the doc/ subdirectory or read https://cubicweb.readthedocs.io/en/latest/


CubicWeb includes the Entypo pictograms by Daniel Bruce — http://www.entypo.com

Contributing
------------

Patches can be submitted on Logilab's forge (https://forge.extranet.logilab.fr).
If you do not have a write-access, please contact us at contact@logilab.fr

If you have any questions you can also come on Logilab's public XMPP room using
a XMPP client: public@conference.jabber.logilab.org

--

Alternatively, patches could be submitted by email at the
cubicweb-devel@lists.cubicweb.org mailing list in order to get reviewed by
project integrators or any community member.  The simplest way of send patches
is to use the ``hg email`` command available through the *patchbomb* extension
of Mercurial. Preferably, patches should be *in the message body* of emails.
When submitting a revised version of a patch series, a prefix indicating the
iteration number ``<n>`` of the series should be added to email subject
prefixes; this can be achieved by specifying a ``--flag v<n>`` option to ``hg
email`` command. If needed you can also use the --in-reply-to option.

Examples:

    hg email --to cubicweb-devel@lists.cubicweb.org --intro -r <start>::<end>
    hg email --flag V2 --to cubicweb-devel@lists.cubicweb.org -r <start>::<end>

Mailing list: https://lists.cubicweb.org/mailman/listinfo/cubicweb-devel
Patchbomb extension: https://www.mercurial-scm.org/wiki/PatchbombExtension
Good practice on sending email patches: https://www.mercurial-scm.org/wiki/ContributingChanges#Emailing_patches


