Création et gestion de démarches en ligne
Go to file
Frédéric Péters 66ca6a5298
gitea/wcs/pipeline/head This commit looks good Details
forms: allow displaying no elements in management sidebar (#88807)
2024-03-28 11:56:34 +01:00
data misc: remove legacy css (#75768) 2023-03-27 17:37:00 +02:00
debian misc: add |convert_image_format filter tag (#86003) 2024-03-01 09:29:50 +01:00
help/fr forms: add option to control max number of drafts per user (#88237) 2024-03-21 11:41:47 +01:00
po general: switch i18n to django (#6735) 2017-08-12 15:13:57 +02:00
tests forms: allow displaying no elements in management sidebar (#88807) 2024-03-28 11:56:34 +01:00
wcs forms: allow displaying no elements in management sidebar (#88807) 2024-03-28 11:56:34 +01:00
.coveragerc jenkins: show execution context in coverage reports (#60446) 2022-01-11 15:17:18 +01:00
.git-blame-ignore-revs misc: update git-blame-ignore-revs to ignore quote changes (#80309) 2023-08-07 14:15:16 +02:00
.gitignore misc: .gitignore update (#80235) 2023-08-11 11:16:30 +02:00
.pre-commit-config.yaml misc: add pre commit hook to force single quotes (#80309) 2023-08-07 14:13:09 +02:00
COPYING Updated version of COPYING 2007-01-26 16:02:00 +00:00
INSTALL switch to django request/response handling (#6735) 2017-08-12 15:13:57 +02:00
Jenkinsfile ci: build deb package for bookworm (#78968) 2023-06-23 17:55:01 +02:00
MANIFEST.in general: remove legacy theming code (#70128) 2022-10-14 11:09:40 +02:00
NEWS [release] 1.5 2009-10-28 12:38:57 +00:00
README misc: add django-upgrade files/notes (#69809) 2022-10-04 11:22:31 +02:00
getlasso.sh update tox for django 1.11 and correct dependencies 2018-01-03 15:00:26 +01:00
getlasso3.sh misc: remove sitepackages=True from tox.ini (#70163) 2022-10-17 14:27:34 +02:00
manage.py misc: apply double-quote-string-fixer (#80309) 2023-08-07 14:14:12 +02:00
pylint.rc general: revert switch to lxml, go back to ElementTree (#78824) 2023-06-21 17:15:52 +02:00
pylint.sh ci: speed up CI using multiple processes with pylint (#67057) 2022-07-07 08:40:08 +02:00
setup.py general: finish removal of wcsctl (#86980) 2024-02-23 19:05:24 +01:00
tox.ini ci: pass JOB_NAME to tox (#88209) 2024-03-15 10:18:50 +01:00
wcs.cfg-sample misc: remove automatic tenant creation (#47823) 2020-10-23 08:57:57 +02:00

README

w.c.s.
======

Description
-----------

w.c.s. is a web application which allows to design and set up online forms. It
gives a user the ability to create web forms easily without requiring any other
skill than familiarity with web surfing. It is released under the GNU GPL
Licence. 

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

 * README, as you are doing now;

 * INSTALL provides installation procedure, details about software
   dependencies and configuration;

Testing
-------

First you need to install py.test, you can use pip:

  pip install pytest

Then you need to run the tests

  PYTHONPATH=$(pwd) py.test tests/

It is possible to pass a --without-postgresql-tests parameter to skip the
PostgreSQL tests.


Code Style
----------

black is used to format the code, using thoses parameters:

    black --target-version py37 --skip-string-normalization --line-length 110

isort is used to format the imports, using those parameters:

    isort --profile black --line-length 110

pyupgrade is used to automatically upgrade syntax, using those parameters:

    pyupgrade --keep-percent-format --py37-plus

djhtml is used to automatically indent html files, using those parameters:

    djhtml --tabwidth 2

django-upgrade is used to automatically upgrade Django syntax, using those parameters:

    django-upgrade --target-version 2.2

There is .pre-commit-config.yaml to use pre-commit to automatically run these tools
before commits. (execute `pre-commit install` to install the git hook.)


Copyright
---------

w.c.s. is copyrighted by Entr'ouvert and is licensed through the GNU General
Public Licence.  Read the COPYING file for the complete license text.  Read the
AUTHORS file for additional credits.

w.c.s. incorporates some other pieces of code, with their own authors and
copyright notices :

Some artwork from GTK+:
 # http://www.gtk.org/
 #
 # This library is free software; you can redistribute it and/or
 # modify it under the terms of the GNU Lesser General Public
 # License as published by the Free Software Foundation; either
 # version 2 of the License, or (at your option) any later
 # version.

Some artwork from Dotclear:
 # http://www.dotclear.net
 #
 # DotClear is free software; you can redistribute it and/or
 # modify it under the terms of the GNU General Public License as
 # published by the Free Software Foundation; either version 2 of
 # the License, or (at your option) any later version.

Image from the unDraw project:
 # https://undraw.co/
 #
 # All images, assets and vectors published on unDraw can be used for free. You
 # can use them for noncommercial and commercial purposes. You do not need to ask
 # permission from or provide credit to the creator or unDraw.
 #
 # More precisely, unDraw grants you an nonexclusive, worldwide copyright
 # license to download, copy, modify, distribute, perform, and use the assets
 # provided from unDraw for free, including for commercial purposes, without
 # permission from or attributing the creator or unDraw. This license does not
 # include the right to compile assets, vectors or images from unDraw to
 # replicate a similar or competing service, in any form or distribute the assets
 # in packs. This extends to automated and non-automated ways to link, embed,
 # scrape, search or download the assets included on the website without our
 # consent.

Universal Feed Parser:
 # __license__ = """Copyright (c) 2002-2007, Mark Pilgrim, All rights reserved.
 # 
 # Redistribution and use in source and binary forms, with or without modification,
 # are permitted provided that the following conditions are met:
 # 
 # * Redistributions of source code must retain the above copyright notice,
 #   this list of conditions and the following disclaimer.
 # * Redistributions in binary form must reproduce the above copyright notice,
 #   this list of conditions and the following disclaimer in the documentation
 #   and/or other materials provided with the distribution.
 # 
 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
 # AND ANY EXPRESS 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 OWNER OR CONTRIBUTORS 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."""

Timeout Socket:
 # Copyright 2000,2001 by Timothy O'Malley <timo@alum.mit.edu>
 # 
 #                All Rights Reserved
 # 
 # Permission to use, copy, modify, and distribute this software
 # and its documentation for any purpose and without fee is hereby
 # granted, provided that the above copyright notice appear in all
 # copies and that both that copyright notice and this permission
 # notice appear in supporting documentation, and that the name of
 # Timothy O'Malley  not be used in advertising or publicity
 # pertaining to distribution of the software without specific, written
 # prior permission. 
 # 
 # Timothy O'Malley DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
 # SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
 # AND FITNESS, IN NO EVENT SHALL Timothy O'Malley BE LIABLE FOR
 # ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
 # WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
 # ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 # PERFORMANCE OF THIS SOFTWARE. 

Locket (wcs/qommon/vendor/locket.py):
 # Copyright (c) 2012, Michael Williamson
 # Licensed under the BSD 2-clause license (http://opensource.org/licenses/BSD-2-Clause)

jQuery JavaScript Library:
 # Copyright (c) 2009 John Resig
 # Dual licensed under the MIT and GPL licenses.
 # http://docs.jquery.com/License

TableSorter 2.0 - Client-side table sorting with ease!:
 # Copyright (c) 2007 Christian Bach
 # Dual licensed under the MIT and GPL licenses:

SimpleModal @VERSION - jQuery Plugin:
 # Copyright (c) 2007 Eric Martin - http://ericmmartin.com
 #
 # Dual licensed under the MIT (MIT-LICENSE.txt)
 # and GPL (GPL-LICENSE.txt) licenses.

WYSIWYG - jQuery plugin 0.3
 # Copyright (c) 2008 Juan M Martinez
 # http://plugins.jquery.com/project/jWYSIWYG
 #
 # Dual licensed under the MIT and GPL licenses:

svg-pan-zoom:
 # Copyright 2009-2010 Andrea Leofreddi <a.leofreddi@itcharm.com>
 # Licensed under the BSD 2-clause license (http://opensource.org/licenses/BSD-2-Clause)

FontAwesome:
 Files: wcs/qommon/static/css/dc2/fontawesome*
 Copyright: (c) 2012-2014, Dave Gandy <drgandy@alum.mit.edu>
 License: OFL-1.1
 Comment:
  Upstream doesn't specify which version of OFL instead simply links to
  OFL page. Hence latest version of OFL is considered.