initial bit of code for foldering and cataloging

.gitignore

@@ -0,0 +1,11 @@
+*.egg
+*.egg-info
+*.pyc
+*$py.class
+*~
+.coverage
+build/
+dist/
+.tox/
+nosetests.xml
+env*/

CHANGES.txt

@@ -0,0 +1,4 @@
+0.1 (2011-08-14)
+----------------
+
+- Initial release.

CONTRIBUTORS.txt

@@ -0,0 +1,101 @@
+Pylons Project Contributor Agreement
+====================================
+
+The submitter agrees by adding his or her name within the section below named
+"Contributors" and submitting the resulting modified document to the
+canonical shared repository location for this software project (whether
+directly, as a user with "direct commit access", or via a "pull request"), he
+or she is signing a contract electronically.  The submitter becomes a
+Contributor after a) he or she signs this document by adding their name
+beneath the "Contributors" section below, and b) the resulting document is
+accepted into the canonical version control repository.
+
+Treatment of Account
+---------------------
+
+Contributor will not allow anyone other than the Contributor to use his or
+her username or source repository login to submit code to a Pylons Project
+source repository. Should Contributor become aware of any such use,
+Contributor will immediately by notifying Agendaless Consulting.
+Notification must be performed by sending an email to
+webmaster@agendaless.com.  Until such notice is received, Contributor will be
+presumed to have taken all actions made through Contributor's account. If the
+Contributor has direct commit access, Agendaless Consulting will have
+complete control and discretion over capabilities assigned to Contributor's
+account, and may disable Contributor's account for any reason at any time.
+
+Legal Effect of Contribution
+----------------------------
+
+Upon submitting a change or new work to a Pylons Project source Repository (a
+"Contribution"), you agree to assign, and hereby do assign, a one-half
+interest of all right, title and interest in and to copyright and other
+intellectual property rights with respect to your new and original portions
+of the Contribution to Agendaless Consulting. You and Agendaless Consulting
+each agree that the other shall be free to exercise any and all exclusive
+rights in and to the Contribution, without accounting to one another,
+including without limitation, the right to license the Contribution to others
+under the Repoze Public License. This agreement shall run with title to the
+Contribution. Agendaless Consulting does not convey to you any right, title
+or interest in or to the Program or such portions of the Contribution that
+were taken from the Program. Your transmission of a submission to the Pylons
+Project source Repository and marks of identification concerning the
+Contribution itself constitute your intent to contribute and your assignment
+of the work in accordance with the provisions of this Agreement.
+
+License Terms
+-------------
+
+Code committed to the Pylons Project source repository (Committed Code) must
+be governed by the Repoze Public License (http://repoze.org/LICENSE.txt, aka
+"the RPL") or another license acceptable to Agendaless Consulting.  Until
+Agendaless Consulting declares in writing an acceptable license other than
+the RPL, only the RPL shall be used.  A list of exceptions is detailed within
+the "Licensing Exceptions" section of this document, if one exists.
+
+Representations, Warranty, and Indemnification
+----------------------------------------------
+
+Contributor represents and warrants that the Committed Code does not violate
+the rights of any person or entity, and that the Contributor has legal
+authority to enter into this Agreement and legal authority over Contributed
+Code. Further, Contributor indemnifies Agendaless Consulting against
+violations.
+
+Cryptography
+------------
+
+Contributor understands that cryptographic code may be subject to government
+regulations with which Agendaless Consulting and/or entities using Committed
+Code must comply. Any code which contains any of the items listed below must
+not be checked-in until Agendaless Consulting staff has been notified and has
+approved such contribution in writing.
+
+- Cryptographic capabilities or features
+
+- Calls to cryptographic features
+
+- User interface elements which provide context relating to cryptography
+
+- Code which may, under casual inspection, appear to be cryptographic.
+
+Notices
+-------
+
+Contributor confirms that any notices required will be included in any
+Committed Code.
+
+List of Contributors
+====================
+
+The below-signed are contributors to a code repository that is part of the
+project named "substanced".  Each below-signed contributor has read,
+understand and agrees to the terms above in the section within this document
+entitled "Pylons Project Contributor Agreement" as of the date beside his or
+her name.
+
+Contributors
+------------
+
+- Chris McDonough, 2012/03/31
+

COPYRIGHT.txt

@@ -0,0 +1,2 @@
+Copyright (c) 2008-2012 Agendaless Consulting and Contributors.
+(http://www.agendaless.com), All Rights Reserved

LICENSE.txt

@@ -0,0 +1,38 @@
+A copyright notice accompanies this license document that identifies
+the copyright holders.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+1.  Redistributions in source code must retain the accompanying
+    copyright notice, this list of conditions, and the following
+    disclaimer.
+
+2.  Redistributions in binary form must reproduce the accompanying
+    copyright notice, this list of conditions, and the following
+    disclaimer in the documentation and/or other materials provided
+    with the distribution.
+
+3.  Names of the copyright holders must not be used to endorse or
+    promote products derived from this software without prior
+    written permission from the copyright holders.
+
+4.  If any files are modified, you must cause the modified files to
+    carry prominent notices stating that you changed the files and
+    the date of any change.
+
+Disclaimer
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND
+  ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+  TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
+  PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+  HOLDERS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+  EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED
+  TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+  DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+  ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR
+  TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF
+  THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+  SUCH DAMAGE.

README.rst

@@ -0,0 +1,10 @@
+Substance D
+===========
+
+A Zope2-like system built upon the Pyramid web application server.  It
+provides integration between ZODB, ``repoze.catalog``, ``repoze.folder`` and
+other subsystems.
+
+See the documentation at
+http://docs.pylonsproject.org/projects/substanced/en/latest/ for more
+information.

docs/.gitignore

@@ -0,0 +1,2 @@
+_themes/
+_build/

docs/Makefile

@@ -0,0 +1,86 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+SPHINXOPTS    = -W
+SPHINXBUILD   = sphinx-build
+PAPER         =
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d _build/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html web pickle htmlhelp latex changes linkcheck
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html      to make standalone HTML files"
+	@echo "  pickle    to make pickle files (usable by e.g. sphinx-web)"
+	@echo "  htmlhelp  to make HTML files and a HTML help project"
+	@echo "  latex     to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  changes   to make an overview over all changed/added/deprecated items"
+	@echo "  linkcheck to check all external links for integrity"
+
+clean:
+	-rm -rf _build/*
+
+html:
+	mkdir -p _build/html _build/doctrees
+	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) _build/html
+	@echo
+	@echo "Build finished. The HTML pages are in _build/html."
+
+text:
+	mkdir -p _build/text _build/doctrees
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) _build/text
+	@echo
+	@echo "Build finished. The HTML pages are in _build/text."
+
+pickle:
+	mkdir -p _build/pickle _build/doctrees
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) _build/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files or run"
+	@echo "  sphinx-web _build/pickle"
+	@echo "to start the sphinx-web server."
+
+web: pickle
+
+htmlhelp:
+	mkdir -p _build/htmlhelp _build/doctrees
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) _build/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in _build/htmlhelp."
+
+latex:
+	mkdir -p _build/latex _build/doctrees
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) _build/latex
+	cp _static/*.png _build/latex
+	./convert_images.sh
+	cp _static/latex-warning.png _build/latex
+	cp _static/latex-note.png _build/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in _build/latex."
+	@echo "Run \`make all-pdf' or \`make all-ps' in that directory to" \
+	      "run these through (pdf)latex."
+
+changes:
+	mkdir -p _build/changes _build/doctrees
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) _build/changes
+	@echo
+	@echo "The overview file is in _build/changes."
+
+linkcheck:
+	mkdir -p _build/linkcheck _build/doctrees
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) _build/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in _build/linkcheck/output.txt."
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) _build/epub
+	@echo
+	@echo "Build finished. The epub file is in _build/epub."
+

docs/api.rst

@@ -0,0 +1,11 @@
+.. _pyramid_catalog_api:
+
+:mod:`pyramid_catalog` API
+---------------------------
+
+.. automodule:: pyramid_catalog
+
+.. autofunction:: includeme
+
+
+