🛑 As of 2023-09-27, this project was deprecated by the new CC Legal Tools (cc-legal-tools-app, cc-legal-tools-data) and Chooser.
Date: | |
---|---|
Version: | |
Author: | Nathan R. Yergler <[email protected]> |
Organization: | Creative Commons |
Copyright: | 2007, Nathan R. Yergler, Creative Commons; licensed to the public under the Expat/MIT License. |
cc.engine provides the Creative Commons license engine along with a set of related scripts. The scripts can be used for generating static versions of the license deeds.
Much of the documentation associated with this project is no longer accurate!
NOTE: Unless you are installing this in Development Mode
, you will need to
run sudo ./bin/buildout
(with root privileges), because the script needs to
create directories in /etc
and /var
.
cc.engine uses zc.buildout to assemble the software and its dependencies. For example
$ python bootstrap/bootstrap.py $ ./bin/buildout
After the buildout process completes the application may be started using the generated init script
# /etc/init.d/cc_engine-run-cc_engine start
You can prevent the service from detaching from the console as a daemon with
the fg
argument (instead of ``start'')
# /etc/init.d/cc_engine-run-cc_engine fg
If you get a UnicodeDecodeError from the cc.engine (you'll see this if it's running in the foreground) when you try to access the http://host:9080/license/ then it's likely that the install of python you are using is set to use ASCII as it's default output. You can change this to UTF-8 by creating the file /usr/lib/python<version>/sitecustomize.py and adding these lines:
import sys sys.setdefaultencoding("utf-8")
If you are working on developing cc.engine, a special buildout configuration is provided. This configuration differs from the default in the following ways:
- Zope is configured to run in
devmode
. - A XXX report is generated at time of buildout.
You can build cc.engine for development by specifying the buildout configuration on the command line
$ ./bin/buildout -c dev.buildout.cfg
cc.engine relies of lxml, which is a Python
wrapper for libxml2 and libxslt1. If you system has older versions of these
libraries installed, cc.engine may fail with Unknown symbol
errors. A
specialized buildout configuration is provided to download and build a
local version of libxml2, libxslt1 and lxml if needed. To use this, specify
the configuration on the command line
$ ./bin/buildout -c lxml.buildout.cfg
Note that this builds in production mode.
python-cssselect
python-flup
(includes required patches, not available upstream)python-librdf