commit df3cc0d153d990bb0f94fd0f46af69defe94d30c Author: François Poulain Date: Thu Jul 16 17:44:31 2020 +0200 commit initial diff --git a/.editorconfig b/.editorconfig new file mode 100644 index 0000000..206bb73 --- /dev/null +++ b/.editorconfig @@ -0,0 +1,29 @@ +# http://editorconfig.org + +root = true + +[*] +charset = utf-8 +end_of_line = lf +insert_final_newline = true +trim_trailing_whitespace = true + +[*.{py,rst,ini}] +indent_style = space +indent_size = 4 + +[*.py] +line_length = 80 +known_first_party = drupal2spip_lal +multi_line_output = 3 +default_section = THIRDPARTY + +[*.{html,css,scss,js,json,yml}] +indent_style = space +indent_size = 2 + +[*.md] +trim_trailing_whitespace = false + +[Makefile] +indent_style = tab diff --git a/.gitattributes b/.gitattributes new file mode 100644 index 0000000..efd7a91 --- /dev/null +++ b/.gitattributes @@ -0,0 +1,3 @@ +drupal2spip_lal/static/** -diff +assets/img/** -diff +assets/fonts/** -diff diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..6b42237 --- /dev/null +++ b/.gitignore @@ -0,0 +1,40 @@ +# Editors +*~ +*.sw[po] + +# Python +*.py[cod] +__pycache__ + +# Virtual environment +.env +venv + +# Logs +logs +*.log +pip-log.txt + +# Unit test / coverage reports +.coverage +.tox +nosetests.xml +htmlcov + +# Translations +*.mo +*.pot + +# Builds +drupal2spip_lal/static/ +docs/build/ + +# Databases +sqlite.db + +# Local configuration +config.env + +# Local overrides and variable content +local/ +var/ diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..fb5cdc0 --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,8 @@ +# Changelog +All notable changes to drupal2spip_lal will be documented in this file. + +The format is based on [Keep a Changelog](http://keepachangelog.com/) +and this project adheres to [Semantic Versioning](http://semver.org/). + +## [Unreleased] +### Added diff --git a/CONTRIBUTORS.txt b/CONTRIBUTORS.txt new file mode 100644 index 0000000..61d40a9 --- /dev/null +++ b/CONTRIBUTORS.txt @@ -0,0 +1,2 @@ +This software is developped by François Poulain (April). +Its basis comes from https://forge.cliss21.org/cliss21/cookiecutter-django/ diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..dba13ed --- /dev/null +++ b/LICENSE @@ -0,0 +1,661 @@ + GNU AFFERO GENERAL PUBLIC LICENSE + Version 3, 19 November 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU Affero General Public License is a free, copyleft license for +software and other kinds of works, specifically designed to ensure +cooperation with the community in the case of network server software. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +our General Public Licenses are intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + Developers that use our General Public Licenses protect your rights +with two steps: (1) assert copyright on the software, and (2) offer +you this License which gives you legal permission to copy, distribute +and/or modify the software. + + A secondary benefit of defending all users' freedom is that +improvements made in alternate versions of the program, if they +receive widespread use, become available for other developers to +incorporate. Many developers of free software are heartened and +encouraged by the resulting cooperation. However, in the case of +software used on network servers, this result may fail to come about. +The GNU General Public License permits making a modified version and +letting the public access it on a server without ever releasing its +source code to the public. + + The GNU Affero General Public License is designed specifically to +ensure that, in such cases, the modified source code becomes available +to the community. It requires the operator of a network server to +provide the source code of the modified version running there to the +users of that server. Therefore, public use of a modified version, on +a publicly accessible server, gives the public access to the source +code of the modified version. + + An older license, called the Affero General Public License and +published by Affero, was designed to accomplish similar goals. This is +a different license, not a version of the Affero GPL, but Affero has +released a new version of the Affero GPL which permits relicensing under +this license. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU Affero General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Remote Network Interaction; Use with the GNU General Public License. + + Notwithstanding any other provision of this License, if you modify the +Program, your modified version must prominently offer all users +interacting with it remotely through a computer network (if your version +supports such interaction) an opportunity to receive the Corresponding +Source of your version by providing access to the Corresponding Source +from a network server at no charge, through some standard or customary +means of facilitating copying of software. This Corresponding Source +shall include the Corresponding Source for any work covered by version 3 +of the GNU General Public License that is incorporated pursuant to the +following paragraph. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the work with which it is combined will remain governed by version +3 of the GNU General Public License. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU Affero General Public License from time to time. Such new versions +will be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU Affero General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU Affero General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU Affero General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU Affero General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU Affero General Public License for more details. + + You should have received a copy of the GNU Affero General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If your software can interact with users remotely through a computer +network, you should also make sure that it provides a way for users to +get its source. For example, if your program is a web application, its +interface could display a "Source" link that leads users to an archive +of the code. There are many ways you could offer source, and different +solutions will be better for different programs; see section 13 for the +specific requirements. + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU AGPL, see +. diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..2b7998d --- /dev/null +++ b/Makefile @@ -0,0 +1,162 @@ +# -*- mode: makefile-gmake -*- +## Définition des variables +# Le nom de l'exécutable Python à utiliser ou son chemin absolu +# (ex. : python ou python3). +PYTHON_EXE := python3 +# S'il faut utiliser un environnement virtuel (y ou n). +USE_VENV := y +# Configuration de l'environnement virtuel. +VENV_DIR := venv +VENV_OPT := --system-site-packages + +# Définis les chemins et options des exécutables. +PYTHON_EXE_BASENAME := $(shell basename $(PYTHON_EXE)) +VENV_PYTHON := --python=$(PYTHON_EXE_BASENAME) +ifeq ($(USE_VENV), y) + PYTHON := $(VENV_DIR)/bin/$(PYTHON_EXE_BASENAME) + PIP := $(VENV_DIR)/bin/pip +else + PYTHON := $(shell which $(PYTHON_EXE)) + PIP := $(shell which pip) +endif + +# Détermine si black est présent. +USE_BLACK := $(shell $(PYTHON) -c 'import black; print("1")' 2>/dev/null) + +# Détermine s'il faut charger le fichier de configuration. +ifneq ($(READ_CONFIG_FILE), 0) + READ_CONFIG_FILE := 1 +else + READ_CONFIG_FILE := 0 +endif + +# Détermine l'environnement à utiliser. +DEFAULT_ENV := production +ifndef ENV + ifeq ($(READ_CONFIG_FILE), 1) + # Commence par chercher la dernière valeur de DJANGO_SETTINGS_MODULE, + # puis de ENV s'il n'y en a pas, ou utilise l'environnement par défaut. + ENV = $(shell \ + sed -n -e '/^DJANGO_SETTINGS_MODULE/s/[^.]*\.settings\.\([^.]*\)/\1/p' \ + -e '/^ENV/s/[^=]*=\(.*\)/\1/p' config.env 2> /dev/null \ + | tail -n 1 | grep -Ee '^..*' || echo "$(DEFAULT_ENV)") + else + ifdef DJANGO_SETTINGS_MODULE + ENV = $(shell echo $(DJANGO_SETTINGS_MODULE) | cut -d. -f3) + else + ENV := $(DEFAULT_ENV) + endif # ifdef DJANGO_SETTINGS_MODULE + endif # ifeq READ_CONFIG_FILE +endif # ifndef ENV + +# Définis EDITOR pour l'édition interactive. +ifndef EDITOR + ifdef VISUAL + EDITOR := $(VISUAL) + else + EDITOR := vi + endif +endif + +# Définition des cibles ------------------------------------------------------- + +.PHONY: clean-pyc clean-build clean-static clear-venv help check check-config +.DEFAULT_GOAL := help + +# Commentaire d'une cible : #-> interne ##-> aide production+dev ###-> aide dev +help: ## affiche cette aide +ifeq ($(ENV), production) + @perl -nle'print $& if m{^[a-zA-Z_-]+:[^#]*?## .*$$}' $(MAKEFILE_LIST) \ + | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}' +else + @perl -nle'print $& if m{^[a-zA-Z_-]+:[^#]*?###? .*$$}' $(MAKEFILE_LIST) \ + | sort | awk 'BEGIN {FS = ":.*?###? "}; {printf "\033[36m%-15s\033[0m %s\n", $$1, $$2}' +endif + +clean: clean-build clean-pyc clean-static ## nettoie tous les fichiers temporaires + +clean-build: ### nettoie les fichiers de construction du paquet + rm -rf build/ + rm -rf dist/ + rm -rf *.egg-info + +clean-pyc: ### nettoie les fichiers temporaires python + find drupal2spip_lal/ \ + \( -name '*.pyc' -o -name '*.pyo' -o -name '*~' \) -exec rm -f {} + + +clean-static: ### nettoie les fichiers "static" collectés + rm -rf var/static + +init: create-venv config.env update ## initialise l'environnement et l'application + +config.env: +ifeq ($(READ_CONFIG_FILE), 1) + cp config.env.example config.env + chmod go-rwx config.env + $(EDITOR) config.env +endif + +update: check-config install-deps migrate static ## mets à jour l'application et ses dépendances + touch drupal2spip_lal/wsgi.py + +check: check-config ## vérifie la configuration de l'instance + $(PYTHON) manage.py check + +check-config: + @find . -maxdepth 1 -name config.env -perm /o+rwx -exec false {} + || \ + { echo "\033[31mErreur :\033[0m les permissions de config.env ne sont pas bonnes, \ + vous devriez au moins faire : chmod o-rwx config.env"; false; } + +install-deps: ## installe les dépendances de l'application + $(PIP) install --upgrade --requirement requirements/$(ENV).txt + +migrate: ## mets à jour le schéma de la base de données + $(PYTHON) manage.py migrate + +static: ## collecte les fichiers statiques +ifeq ($(ENV), production) + @echo "Collecte des fichiers statiques..." + $(PYTHON) manage.py collectstatic --no-input --verbosity 0 +endif + +## Cibles liées à l'environnement virtuel + +create-venv: $(PYTHON) + +$(PYTHON): +ifeq ($(USE_VENV), y) + virtualenv $(VENV_OPT) $(VENV_PYTHON) $(VENV_DIR) +else + @echo "\033[31mErreur !\033[0m Impossible de trouver l'exécutable Python $(PYTHON)" + @exit 1 +endif + +clear-venv: ## supprime l'environnement virtuel + -rm -rf $(VENV_DIR) + +## Cibles pour le développement + +serve: ### démarre un serveur local pour l'application + $(PYTHON) manage.py runserver + +test: ### lance les tests de l'application + $(PYTHON) -m pytest --cov --cov-report=term:skip-covered + +cov: test ### vérifie la couverture de code + $(PYTHON) -m coverage html + @echo open htmlcov/index.html + +lint: ### vérifie la syntaxe et le code python + @$(PYTHON) -m flake8 drupal2spip_lal \ + || echo "\033[31m[flake8]\033[0m Veuillez corriger les erreurs ci-dessus." + @$(PYTHON) -m isort --check drupal2spip_lal \ + || echo "\033[31m[isort]\033[0m Veuillez corriger l'ordre des imports avec : make fix-lint" +ifdef USE_BLACK + @$(PYTHON) -m black --check drupal2spip_lal +endif + +fix-lint: ### corrige la syntaxe et ordonne les imports python + $(PYTHON) -m isort drupal2spip_lal +ifdef USE_BLACK + $(PYTHON) -m black drupal2spip_lal +endif diff --git a/README.md b/README.md new file mode 100644 index 0000000..5e0dbf5 --- /dev/null +++ b/README.md @@ -0,0 +1,191 @@ +# drupal2spip_lal + +Convertisseur Drupal 6 vers SPIP pour le site web libre à lire + +**Table of content** + +- [Give a try](#give-a-try) +- [Installation](#installation) +- [Deployment](#deployment) +- [Structure](#structure) +- [Development](#development) + +## Give a try + +On a Debian-based host - running at least Debian Stretch: + +``` +$ sudo apt install python3 virtualenv git make +$ git clone https://forge.april.org/siteweb/drupal2spip_lal +$ cd drupal2spip_lal/ +$ make init + +A configuration will be created interactively; uncomment +ENV=development + +$ make test # optional +$ make serve +``` + +Then visit [http://127.0.0.1:8000/](http://127.0.0.1:8000/) in your web browser. + +## Installation +### Requirements + +On a Debian-based host - running at least Debian Stretch, you will need the +following packages: +- python3 +- virtualenv +- make +- git (recommended for getting the source) +- python3-mysqldb (optional, in case of a MySQL / MariaDB database) +- python3-psycopg2 (optional, in case of a PostgreSQL database) + +### Quick start + +It assumes that you already have the application source code locally - the best +way is by cloning this repository - and that you are in this folder. + +1. Define your local configuration in a file named `config.env`, which can be + copied from `config.env.example` and edited to suits your needs. + + Depending on your environment, you will have to create your database and the + user at first. + +2. Run `make init`. + + Note that if there is no `config.env` file, it will be created interactively. + +That's it! Your environment is now initialized with the application installed. +To update it, once the source code is checked out, simply run `make update`. + +You can also check that your application is well configured by running +`make check`. + +### Manual installation + +If you don't want to use the `Makefile` facilities, here is what is done behind the scene. + +It assumes that you have downloaded the last release of drupal2spip_lal, +extracted it and that you moved to that folder. + +1. Start by creating a new virtual environment under `./venv` and activate it: + + $ virtualenv --system-site-packages ./venv + $ source ./venv/bin/activate + +2. Install the required Python packages depending on your environment: + + $ pip install -r requirements/production.txt + ... or ... + $ pip install -r requirements/development.txt + +3. Configure the application by setting the proper environment variables + depending on your environment. You can use the `config.env.example` which + give you the main variables with example values. + + $ cp config.env.example config.env + $ nano config.env + $ chmod go-rwx config.env + + Note that this `./config.env` file will be loaded by default when the + application starts. If you don't want that, just move this file away or set + the `READ_CONFIG_FILE` environment variable to `0`. + +4. Create the database tables - it assumes that you have created the database + and set the proper configuration to use it: + + $ ./manage.py migrate + +That's it! You should now be able to start the Django development server to +check that everything is working fine with: + + $ ./manage.py runserver + +## Deployment + +Here is an example deployment using NGINX - as the Web server - and uWSGI - as +the application server. + +The uWSGI configuration doesn't require a special configuration, except that we +are using Python 3 and a virtual environment. Note that if you serve the +application on a sub-location, you will have to add `route-run = fixpathinfo:` +to your uWSGI configuration (from +[v2.0.11](https://uwsgi-docs.readthedocs.io/en/latest/Changelog-2.0.11.html#fixpathinfo-routing-action)). + +In the `server` block of your NGINX configuration, add the following blocks and +set the path to your application instance and to the uWSGI socket: + +``` +location / { + include uwsgi_params; + uwsgi_pass unix:; +} +location /media { + alias /var/media; +} +location /static { + alias /var/static; + # Optional: don't log access to assets + access_log off; +} +location = /favicon.ico { + alias /var/static/favicon/favicon.ico; + # Optional: don't log access to the favicon + access_log off; +} +``` + +## Structure +### Overview + +All the application files - e.g. Django code including settings, templates and +statics - are located into `drupal2spip_lal/`. + +Two environments are defined - either for requirements and settings: +- `development`: for local application development and testing. It uses a + SQLite3 database and enable debugging by default, add some useful settings + and applications for development purpose - i.e. the `django-debug-toolbar`. +- `production`: for production. It checks that configuration is set and + correct, try to optimize performances and enforce some settings - i.e. HTTPS + related ones. + +### Local changes + +You can override and extend statics and templates locally. This can be useful +if you have to change the logo for a specific instance for example. For that, +just put your files under the `local/static/` and `local/templates/` folders. + +Regarding the statics, do not forget to collect them after that. Note also that +the `local/` folder is ignored by *git*. + +### Variable content + +All the variable content - e.g. user-uploaded media, collected statics - are +stored inside the `var/` folder. It is also ignored by *git* as it's specific +to each application installation. + +So, you will have to configure your Web server to serve the `var/media/` and +`var/static/` folders, which should point to `/media/` and `/static/`, +respectively. + +## Development + +The easiest way to deploy a development environment is by using the `Makefile`. + +Before running `make init`, ensure that you have either set `ENV=development` +in the `config.env` file or have this environment variable. Note that you can +still change this variable later and run `make init` again. + +There is some additional rules when developing, which are mainly wrappers for +`manage.py`. You can list all of them by running `make help`. Here are the main ones: +- `make serve`: run a development server +- `make test`: test the whole application +- `make lint`: check the Python code syntax + + + +## License + +drupal2spip_lal is developed by François Poulain (April) and licensed under the +[AGPLv3+](LICENSE). Its basis comes from https://forge.cliss21.org/cliss21/cookiecutter-django/ diff --git a/config.env.example b/config.env.example new file mode 100644 index 0000000..d2999ee --- /dev/null +++ b/config.env.example @@ -0,0 +1,105 @@ +########################################################### +# # +# Edit the following configuration to suits your needs. # +# # +########################################################### + +############################################################################### +# MAINS SETTINGS +############################################################################### + +# Environment to use within the application. +# +# The environment is used to load the proper settings for your application +# instance. There is two ways for defining it, with the following precedence: +# - DJANGO_SETTINGS_MODULE: the Python path to the settings module to use. It +# allows you to define and use your own settings module. Use it with care! +# Note: the module name will be used as the environment. +# - ENV: the environment to use, which is one of 'production' or 'development'. +# +# Default is the 'production' environment. +#ENV=production +#ENV=development + +# The secret key used to provide cryptographic signing. +# +# It should be set to a unique, unpredictable value. On a GNU/Linux system, you +# could generate a new one with: +# +# $ head -c50 /dev/urandom | base64 +# +# /!\ Required in production. +#DJANGO_SECRET_KEY=CHANGEME!!! + +# A coma-separated string representing the host/domain names that this +# application instance can serve. +# +# /!\ Required in production. +#DJANGO_ALLOWED_HOSTS=example.org, + +############################################################################### +# DATABASE SETTINGS +############################################################################### + +# Database configuration, as an URI. +# +# In production, the recommended database backend for better performances is +# PostgreSQL - or MySQL if you prefer. +# +# Default is a SQLite database in development only. +# +# /!\ Required in production. +#DJANGO_DATABASE_URL=postgres://user:password@127.0.0.1:5432/drupal2spip_lal +#DJANGO_DATABASE_URL=mysql://user:password@127.0.0.1:3306/drupal2spip_lal + +############################################################################### +# EMAILS SETTINGS +############################################################################### + +# Email configuration for sending messages, as an URI. +# +# In production, you should either use a local SMTP server or a relay one. The +# URI will be in that case of the form: +# +# PROTOCOL://[USER:PASSWORD@]HOST[:PORT] +# +# PROTOCOL can be smtp, smtp+ssl or smtp+tls. Note that special characters +# in USER and PASSWORD - e.g. @ - must be escaped. It can be achieve with: +# +# $ python3 -c 'from urllib.parse import quote as q;print(q("USER")+":"+q("PASSWORD"))' +# +# Default is the local SMTP server in production and the console in development. +#DJANGO_EMAIL_URL=smtp://localhost:25 + +# Default email address to use for various automated correspondence. +# +# /!\ Required in production. +#DEFAULT_FROM_EMAIL=webmaster@example.org + +# A comma separated list of all the people who get production error +# notifications, following rfc2822 format +#ADMINS='François Poulain (April) ' + +############################################################################### +# MISC SETTINGS +############################################################################### + +# URL prefix on which the application is served. +# +# This is used to generate the static and media URLs, but also links to the +# application which require an absolute URL. +# +# Default is '/', e.g. at the domain root. +#APP_LOCATION=/ + +# Base directory of the app instance, where the local and var folders are +# located. +# +# Default is the current directory. +#BASE_DIR= + +# Turn on/off debug mode. +# +# Note that it's always disabled in production. +#DJANGO_DEBUG=off +#DJANGO_DEBUG_TOOLBAR=on diff --git a/drupal2spip_lal/__init__.py b/drupal2spip_lal/__init__.py new file mode 100644 index 0000000..b794fd4 --- /dev/null +++ b/drupal2spip_lal/__init__.py @@ -0,0 +1 @@ +__version__ = '0.1.0' diff --git a/drupal2spip_lal/base/__init__.py b/drupal2spip_lal/base/__init__.py new file mode 100644 index 0000000..ab04291 --- /dev/null +++ b/drupal2spip_lal/base/__init__.py @@ -0,0 +1 @@ +default_app_config = 'drupal2spip_lal.base.apps.BaseConfig' diff --git a/drupal2spip_lal/base/apps.py b/drupal2spip_lal/base/apps.py new file mode 100644 index 0000000..cd9faf9 --- /dev/null +++ b/drupal2spip_lal/base/apps.py @@ -0,0 +1,6 @@ +from django.apps import AppConfig + + +class BaseConfig(AppConfig): + name = 'drupal2spip_lal.base' + verbose_name = "Base" diff --git a/drupal2spip_lal/base/templatetags/__init__.py b/drupal2spip_lal/base/templatetags/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/drupal2spip_lal/base/templatetags/minified.py b/drupal2spip_lal/base/templatetags/minified.py new file mode 100644 index 0000000..dc20e1c --- /dev/null +++ b/drupal2spip_lal/base/templatetags/minified.py @@ -0,0 +1,33 @@ +import functools +import os.path + +from django import template +from django.conf import settings +from django.contrib.staticfiles import finders +from django.templatetags.static import static + +register = template.Library() + + +@functools.lru_cache(maxsize=None) +def get_minified_static_path(path): + """Retourne de préférence le chemin d'un fichier compressé. + + Détermine et retourne le chemin relatif à utiliser pour le fichier + statique `path`, en fonction de l'environnement. Si elle existe, la + version compressée (e.g. avec le suffixe `.min` avant l'extension) du + fichier sera retournée quand le débogage est désactivé. + """ + if settings.DEBUG: + return path + root, ext = os.path.splitext(path) + min_path = '{}.min{}'.format(root, ext or '') + if finders.find(min_path): + return min_path + return path + + +@register.simple_tag +def minified(path): + """Retourne le chemin absolu d'un fichier statique compressé.""" + return static(get_minified_static_path(path)) diff --git a/drupal2spip_lal/base/tests/__init__.py b/drupal2spip_lal/base/tests/__init__.py new file mode 100644 index 0000000..e69de29 diff --git a/drupal2spip_lal/base/tests/test_templatetags.py b/drupal2spip_lal/base/tests/test_templatetags.py new file mode 100644 index 0000000..d19851f --- /dev/null +++ b/drupal2spip_lal/base/tests/test_templatetags.py @@ -0,0 +1,43 @@ +from django.template import Context, Template + +import pytest + +from ..templatetags.minified import get_minified_static_path + + +@pytest.fixture +def mock_static_find(monkeypatch): + def find(*args, **kwargs): + return True + + # patch pour trouver n'importe quel fichier dans les statics + monkeypatch.setattr('django.contrib.staticfiles.finders.find', find) + + +class TestMinified: + def setup(self): + # vide le cache avant chaque test + get_minified_static_path.cache_clear() + + def test_get_path_debug(self, mock_static_find, settings): + settings.DEBUG = True + assert get_minified_static_path('test/debug.css') == 'test/debug.css' + + @pytest.mark.parametrize( + 'path, result', + [ + ('test/app.css', 'test/app.min.css'), + ('test/no_extension', 'test/no_extension.min'), + ], + ) + def test_get_path_exists(self, mock_static_find, path, result): + assert get_minified_static_path(path) == result + + def test_get_path_not_found(self): + assert get_minified_static_path('unknown.txt') == 'unknown.txt' + + def test_tag(self, mock_static_find, settings): + rendered = Template( + '{% load minified %}{% minified "test/tag.css" %}' + ).render(Context()) + assert rendered == settings.STATIC_URL + 'test/tag.min.css' diff --git a/drupal2spip_lal/base/urls.py b/drupal2spip_lal/base/urls.py new file mode 100644 index 0000000..22f51b4 --- /dev/null +++ b/drupal2spip_lal/base/urls.py @@ -0,0 +1,7 @@ +from django.urls import path +from django.views.generic import TemplateView + +urlpatterns = [ + path('', TemplateView.as_view(template_name='pages/home.html'), + name='home'), +] diff --git a/drupal2spip_lal/settings/__init__.py b/drupal2spip_lal/settings/__init__.py new file mode 100644 index 0000000..c6f0421 --- /dev/null +++ b/drupal2spip_lal/settings/__init__.py @@ -0,0 +1,25 @@ +import environ + +"""The default environment to use.""" +DEFAULT_ENVIRONMENT = 'production' + +"""The environment variables of the app instance.""" +env = environ.Env() + +"""Path to the package root - e.g. Django project.""" +root_dir = environ.Path(__file__) - 2 + +"""Path to the base directory of the app instance.""" +base_dir = env.path('BASE_DIR', default=str(root_dir - 1)) + +# Load config.env, OS environment variables will take precedence +if env.bool('READ_CONFIG_FILE', default=True): + env.read_env(str(base_dir.path('config.env'))) + +"""The Django settings module's name to use.""" +DJANGO_SETTINGS_MODULE = env( + 'DJANGO_SETTINGS_MODULE', + default='drupal2spip_lal.settings.{}'.format( + env('ENV', default=DEFAULT_ENVIRONMENT) + ), +) diff --git a/drupal2spip_lal/settings/base.py b/drupal2spip_lal/settings/base.py new file mode 100644 index 0000000..36ccf41 --- /dev/null +++ b/drupal2spip_lal/settings/base.py @@ -0,0 +1,235 @@ +""" +Django settings for drupal2spip_lal project. + +For more information on this file, see +https://docs.djangoproject.com/en/stable/topics/settings/ + +For the full list of settings and their values, see +https://docs.djangoproject.com/en/stable/ref/settings/ +""" +import os.path +from email.utils import getaddresses + +from . import base_dir, env, root_dir + +# ENVIRONMENT VARIABLES AND PATHS +# ------------------------------------------------------------------------------ + +# Local directory used for static and templates overrides +local_dir = base_dir.path('local') + +# Directory for variable stuffs, i.e. user-uploaded media +var_dir = base_dir.path('var') +if not os.path.isdir(var_dir()): + os.mkdir(var_dir(), mode=0o755) + +# Location on which the application is served +APP_LOCATION = env('APP_LOCATION', default='/') + +# GENERAL +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#debug +DEBUG = env.bool('DJANGO_DEBUG', default=True) + +# Local time zone for this installation +TIME_ZONE = 'Europe/Paris' + +# https://docs.djangoproject.com/en/stable/ref/settings/#language-code +LANGUAGE_CODE = 'fr' + +# https://docs.djangoproject.com/en/dev/ref/settings/#site-id +SITE_ID = 1 + +# https://docs.djangoproject.com/en/stable/ref/settings/#use-i18n +USE_I18N = True +# https://docs.djangoproject.com/en/stable/ref/settings/#use-l10n +USE_L10N = True +# https://docs.djangoproject.com/en/stable/ref/settings/#use-tz +USE_TZ = True + +# DATABASES +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#databases +# https://django-environ.readthedocs.io/en/stable/#supported-types +DATABASES = { + 'default': env.db( + 'DJANGO_DATABASE_URL', + default='sqlite:///{}'.format(base_dir('sqlite.db')), + ) +} + +# URLS +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#root-urlconf +ROOT_URLCONF = 'drupal2spip_lal.urls' +# https://docs.djangoproject.com/en/stable/ref/settings/#wsgi-application +WSGI_APPLICATION = 'drupal2spip_lal.wsgi.application' + +# APP CONFIGURATION +# ------------------------------------------------------------------------------ +DJANGO_APPS = [ + 'django.contrib.admin', + 'django.contrib.auth', + 'django.contrib.contenttypes', + 'django.contrib.sessions', + 'django.contrib.messages', + 'django.contrib.staticfiles', +] + +# Project dependencies +THIRD_PARTY_APPS = [] + +# Project applications +LOCAL_APPS = ['drupal2spip_lal.base'] + +# https://docs.djangoproject.com/en/stable/ref/settings/#installed-apps +INSTALLED_APPS = DJANGO_APPS + THIRD_PARTY_APPS + LOCAL_APPS + +# PASSWORDS +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#password-hashers +PASSWORD_HASHERS = [ + # https://docs.djangoproject.com/en/stable/topics/auth/passwords/#using-argon2-with-django + # 'django.contrib.auth.hashers.Argon2PasswordHasher', + 'django.contrib.auth.hashers.PBKDF2PasswordHasher', + 'django.contrib.auth.hashers.PBKDF2SHA1PasswordHasher', + 'django.contrib.auth.hashers.BCryptSHA256PasswordHasher', + 'django.contrib.auth.hashers.BCryptPasswordHasher', +] + +# https://docs.djangoproject.com/en/stable/topics/auth/passwords/#password-validation +AUTH_PASSWORD_VALIDATORS = [ + { + 'NAME': ( + 'django.contrib.auth.password_validation.' + 'UserAttributeSimilarityValidator' + ) + }, + { + 'NAME': ( + 'django.contrib.auth.password_validation.MinimumLengthValidator' + ) + }, + { + 'NAME': ( + 'django.contrib.auth.password_validation.' + 'CommonPasswordValidator' + ) + }, + { + 'NAME': ( + 'django.contrib.auth.password_validation.' + 'NumericPasswordValidator' + ) + }, +] + +# MIDDLEWARE +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#middleware +MIDDLEWARE = [ + 'django.middleware.security.SecurityMiddleware', + 'django.contrib.sessions.middleware.SessionMiddleware', + 'django.middleware.common.CommonMiddleware', + 'django.middleware.csrf.CsrfViewMiddleware', + 'django.contrib.auth.middleware.AuthenticationMiddleware', + 'django.contrib.messages.middleware.MessageMiddleware', + 'django.middleware.clickjacking.XFrameOptionsMiddleware', +] + +# STATIC +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#static-files +STATIC_ROOT = var_dir('static') + +# https://docs.djangoproject.com/en/stable/ref/settings/#static-url +STATIC_URL = os.path.join(APP_LOCATION, 'static/') + +# https://docs.djangoproject.com/en/stable/ref/settings/#staticfiles-dirs +STATICFILES_DIRS = [root_dir('static')] +if os.path.isdir(local_dir('static')): + STATICFILES_DIRS.insert(0, local_dir('static')) + +# https://docs.djangoproject.com/en/stable/ref/contrib/staticfiles/#staticfiles-finders +STATICFILES_FINDERS = [ + 'django.contrib.staticfiles.finders.FileSystemFinder', + 'django.contrib.staticfiles.finders.AppDirectoriesFinder', +] + +# MEDIA +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#media-root +MEDIA_ROOT = var_dir('media') + +# https://docs.djangoproject.com/en/stable/ref/settings/#media-url +MEDIA_URL = os.path.join(APP_LOCATION, 'media/') + +# https://docs.djangoproject.com/en/stable/ref/settings/#file-upload-directory-permissions +FILE_UPLOAD_DIRECTORY_PERMISSIONS = 0o755 +# https://docs.djangoproject.com/en/stable/ref/settings/#file-upload-permissions +FILE_UPLOAD_PERMISSIONS = 0o644 + +# TEMPLATES +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#templates +TEMPLATES = [ + { + 'BACKEND': 'django.template.backends.django.DjangoTemplates', + 'DIRS': [root_dir('templates')], + 'OPTIONS': { + 'debug': DEBUG, + 'loaders': [ + 'django.template.loaders.filesystem.Loader', + 'django.template.loaders.app_directories.Loader', + ], + 'context_processors': [ + 'django.template.context_processors.debug', + 'django.template.context_processors.request', + 'django.contrib.auth.context_processors.auth', + 'django.template.context_processors.media', + 'django.template.context_processors.static', + 'django.template.context_processors.tz', + 'django.contrib.messages.context_processors.messages', + ], + }, + } +] +if os.path.isdir(local_dir('templates')): + TEMPLATES[0]['DIRS'].insert(0, local_dir('templates')) + +# FIXTURES +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#fixture-dirs +FIXTURE_DIRS = [root_dir('fixtures')] + +# EMAIL +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/topics/email/#email-backends +# https://django-environ.readthedocs.io/en/stable/#supported-types +vars().update(env.email_url('DJANGO_EMAIL_URL', default='smtp://localhost:25')) + +DEFAULT_FROM_EMAIL = env('DEFAULT_FROM_EMAIL', default='webmaster@localhost') +# Use the same email address for error messages +SERVER_EMAIL = DEFAULT_FROM_EMAIL + +# ADMIN +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#admins +ADMINS = getaddresses( + [env('ADMINS', default='François Poulain (April) ')] +) + +# https://docs.djangoproject.com/en/stable/ref/settings/#managers +MANAGERS = ADMINS + +# SESSIONS AND COOKIES +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#session-cookie-path +SESSION_COOKIE_PATH = APP_LOCATION + +# https://docs.djangoproject.com/en/stable/ref/settings/#csrf-cookie-path +CSRF_COOKIE_PATH = APP_LOCATION + +# ------------------------------------------------------------------------------ +# APPLICATION AND 3RD PARTY LIBRARY SETTINGS +# ------------------------------------------------------------------------------ diff --git a/drupal2spip_lal/settings/development.py b/drupal2spip_lal/settings/development.py new file mode 100644 index 0000000..5fb0c58 --- /dev/null +++ b/drupal2spip_lal/settings/development.py @@ -0,0 +1,45 @@ +""" +Development settings. + +- use Console backend for emails sending by default +- add the django-debug-toolbar +""" +from .base import * # noqa +from .base import INSTALLED_APPS, MIDDLEWARE, env + +# GENERAL +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#secret-key +SECRET_KEY = env('DJANGO_SECRET_KEY', default='CHANGEME!!!') + +# https://docs.djangoproject.com/en/stable/ref/settings/#allowed-hosts +ALLOWED_HOSTS = env.list( + 'DJANGO_ALLOWED_HOSTS', default=['localhost', '0.0.0.0', '127.0.0.1'] +) + +# EMAIL +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/topics/email/#email-backends +# https://django-environ.readthedocs.io/en/stable/#supported-types +vars().update(env.email_url('DJANGO_EMAIL_URL', default='consolemail://')) + +# ------------------------------------------------------------------------------ +# APPLICATION AND 3RD PARTY LIBRARY SETTINGS +# ------------------------------------------------------------------------------ + +# DJANGO DEBUG TOOLBAR +# ------------------------------------------------------------------------------ +# https://django-debug-toolbar.readthedocs.io/en/stable/installation.html +if env.bool('DJANGO_DEBUG_TOOLBAR', default=False): + MIDDLEWARE += ['debug_toolbar.middleware.DebugToolbarMiddleware'] + INSTALLED_APPS += ['debug_toolbar'] + INTERNAL_IPS = ['127.0.0.1'] + DEBUG_TOOLBAR_CONFIG = { + 'DISABLE_PANELS': ['debug_toolbar.panels.redirects.RedirectsPanel'], + 'SHOW_TEMPLATE_CONTEXT': True, + } + +# DJANGO EXTENSIONS +# ------------------------------------------------------------------------------ +# https://django-extensions.readthedocs.io/en/stable/index.html +INSTALLED_APPS += ['django_extensions'] diff --git a/drupal2spip_lal/settings/production.py b/drupal2spip_lal/settings/production.py new file mode 100644 index 0000000..906b0f8 --- /dev/null +++ b/drupal2spip_lal/settings/production.py @@ -0,0 +1,106 @@ +""" +Production settings. + +- validate the configuration +- disable debug mode +- load secret key from environment variables +- set other production configurations +""" +import os + +from django.core.exceptions import ImproperlyConfigured + +from .base import * # noqa +from .base import TEMPLATES, env, var_dir + +# CONFIGURATION VALIDATION +# ------------------------------------------------------------------------------ +# Ensure that the database configuration has been set +if not env('DJANGO_DATABASE_URL', default=None): + raise ImproperlyConfigured( + "No database configuration has been set, you should check " + "the value of your DATABASE_URL environment variable." + ) + +# Ensure that the default email address has been set +if not env('DEFAULT_FROM_EMAIL', default=None): + raise ImproperlyConfigured( + "No default email address has been set, you should check " + "the value of your DEFAULT_FROM_EMAIL environment variable." + ) + +# GENERAL +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#debug +DEBUG = False + +# https://docs.djangoproject.com/en/stable/ref/settings/#secret-key +SECRET_KEY = env('DJANGO_SECRET_KEY') + +# https://docs.djangoproject.com/en/stable/ref/settings/#allowed-hosts +ALLOWED_HOSTS = env.list('DJANGO_ALLOWED_HOSTS', default=[]) + +# TEMPLATES +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#templates +TEMPLATES[0]['OPTIONS']['debug'] = DEBUG +TEMPLATES[0]['OPTIONS']['loaders'] = [ + ( + 'django.template.loaders.cached.Loader', + [ + 'django.template.loaders.filesystem.Loader', + 'django.template.loaders.app_directories.Loader', + ], + ) +] + +# LOGGING +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/topics/logging/ +LOGGING = { + 'version': 1, + 'disable_existing_loggers': False, + 'formatters': { + 'verbose': { + 'format': '%(asctime)s - %(levelname)s - %(module)s: %(message)s' + } + }, + 'handlers': { + 'mail_admins': { + 'level': 'ERROR', + 'class': 'django.utils.log.AdminEmailHandler', + }, + 'file': { + 'level': 'DEBUG', + 'class': 'logging.handlers.TimedRotatingFileHandler', + 'filename': var_dir('log/drupal2spip_lal.log'), + 'formatter': 'verbose', + 'when': 'midnight', + 'interval': 1, + 'backupCount': 30, + }, + }, + 'loggers': { + 'django': { + 'level': 'WARNING', + 'handlers': ['file'], + 'propagate': True, + }, + 'django.request': { + 'level': 'WARNING', + 'handlers': ['file', 'mail_admins'], + 'propagate': True, + }, + 'drupal2spip_lal': { + 'level': 'INFO', + 'handlers': ['file', 'mail_admins'], + 'propagate': True, + }, + }, +} +if not os.path.isdir(var_dir('log')): + os.mkdir(var_dir('log'), mode=0o750) + +# ------------------------------------------------------------------------------ +# APPLICATION AND 3RD PARTY LIBRARY SETTINGS +# ------------------------------------------------------------------------------ diff --git a/drupal2spip_lal/settings/test.py b/drupal2spip_lal/settings/test.py new file mode 100644 index 0000000..81c1364 --- /dev/null +++ b/drupal2spip_lal/settings/test.py @@ -0,0 +1,54 @@ +""" +With these settings, tests run faster. +""" +from .base import * # noqa +from .base import TEMPLATES, env + +# GENERAL +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#debug +DEBUG = False + +# https://docs.djangoproject.com/en/stable/ref/settings/#secret-key +SECRET_KEY = env('DJANGO_SECRET_KEY', default='CHANGEME!!!') + +# https://docs.djangoproject.com/en/stable/ref/settings/#test-runner +TEST_RUNNER = 'django.test.runner.DiscoverRunner' + +# CACHES +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#caches +CACHES = { + 'default': { + 'BACKEND': 'django.core.cache.backends.locmem.LocMemCache', + 'LOCATION': '', + } +} + +# PASSWORDS +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#password-hashers +PASSWORD_HASHERS = ['django.contrib.auth.hashers.MD5PasswordHasher'] + +# TEMPLATES +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#templates +TEMPLATES[0]['OPTIONS']['debug'] = DEBUG +TEMPLATES[0]['OPTIONS']['loaders'] = [ + ( + 'django.template.loaders.cached.Loader', + [ + 'django.template.loaders.filesystem.Loader', + 'django.template.loaders.app_directories.Loader', + ], + ) +] + +# EMAIL +# ------------------------------------------------------------------------------ +# https://docs.djangoproject.com/en/stable/ref/settings/#email-backend +EMAIL_BACKEND = 'django.core.mail.backends.locmem.EmailBackend' +# https://docs.djangoproject.com/en/stable/ref/settings/#email-host +EMAIL_HOST = 'localhost' +# https://docs.djangoproject.com/en/stable/ref/settings/#email-port +EMAIL_PORT = 1025 diff --git a/drupal2spip_lal/templates/404.html b/drupal2spip_lal/templates/404.html new file mode 100644 index 0000000..b71f3c5 --- /dev/null +++ b/drupal2spip_lal/templates/404.html @@ -0,0 +1,7 @@ +{% extends "base.html" %} + +{% block title %}Page introuvable{% endblock %} + +{% block content %} +

La page que vous demandez semble introuvable...

+{% endblock %} diff --git a/drupal2spip_lal/templates/500.html b/drupal2spip_lal/templates/500.html new file mode 100644 index 0000000..c673090 --- /dev/null +++ b/drupal2spip_lal/templates/500.html @@ -0,0 +1,7 @@ +{% extends "base.html" %} + +{% block title %}Erreur interne{% endblock %} + +{% block content %} +

Une erreur inattendue est survenue...

+{% endblock %} diff --git a/drupal2spip_lal/templates/base.html b/drupal2spip_lal/templates/base.html new file mode 100644 index 0000000..34e0449 --- /dev/null +++ b/drupal2spip_lal/templates/base.html @@ -0,0 +1,44 @@ +{% load minified %} + + + + + + + + {% block title %}{% endblock %} + {% block title_suffix %}- drupal2spip_lal{% endblock %} + + + + + + {% block css %} + + + {% endblock %} + + {% block extra_head %}{% endblock %} + + +
+ + {% if messages %} + {% for message in messages %} +
{{ message }}
+ {% endfor %} + {% endif %} + + {% block content %} +

Utilisez ce modèle pour démarrer rapidement une nouvelle application.

+ {% endblock %} + +
+ + {% block modal %}{% endblock %} + + {% block javascript %} + + {% endblock %} + + diff --git a/drupal2spip_lal/templates/pages/home.html b/drupal2spip_lal/templates/pages/home.html new file mode 100644 index 0000000..bea3e3a --- /dev/null +++ b/drupal2spip_lal/templates/pages/home.html @@ -0,0 +1,8 @@ +{% extends "base.html" %} + +{% block title %}Accueil{% endblock %} + +{% block content %} +

Bienvenue !

+

Cette page ne dira pas grand chose de plus, à vous de la personnaliser.

+{% endblock content %} diff --git a/drupal2spip_lal/urls.py b/drupal2spip_lal/urls.py new file mode 100644 index 0000000..9143e08 --- /dev/null +++ b/drupal2spip_lal/urls.py @@ -0,0 +1,37 @@ +from django.conf import settings +from django.contrib import admin +from django.urls import include, path + +from .base import urls as base_urls + +urlpatterns = [ + path('admin/', admin.site.urls), + + # Local applications + # ... +] + +if settings.DEBUG: + from django.conf.urls.static import static + from django.views import defaults as default_views + + # This allows the error pages to be debugged during development, just visit + # these url in browser to see how these error pages look like. + urlpatterns += [ + path('400/', default_views.bad_request, + kwargs={'exception': Exception('Bad Request!')}), + path('403/', default_views.permission_denied, + kwargs={'exception': Exception('Permission Denied')}), + path('404/', default_views.page_not_found, + kwargs={'exception': Exception('Page not Found')}), + path('500/', default_views.server_error), + ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT) + + if 'debug_toolbar' in settings.INSTALLED_APPS: + import debug_toolbar + urlpatterns.insert(0, path('__debug__/', include(debug_toolbar.urls))) + +# Root application +urlpatterns += [ + path('', include(base_urls)), +] diff --git a/drupal2spip_lal/wsgi.py b/drupal2spip_lal/wsgi.py new file mode 100644 index 0000000..e72c4fb --- /dev/null +++ b/drupal2spip_lal/wsgi.py @@ -0,0 +1,21 @@ +""" +WSGI config for drupal2spip_lal project. + +This module contains the WSGI application used by Django's development server +and any production WSGI deployments. It should expose a module-level variable +named ``application``. Django's ``runserver`` and ``runfcgi`` commands discover +this application via the ``WSGI_APPLICATION`` setting. +""" +import os + +from django.core.wsgi import get_wsgi_application + +from drupal2spip_lal.settings import DJANGO_SETTINGS_MODULE + +# Set the default settings module to use. +os.environ.setdefault('DJANGO_SETTINGS_MODULE', DJANGO_SETTINGS_MODULE) + +# This application object is used by any WSGI server configured to use this +# file. This includes Django's development server, if the WSGI_APPLICATION +# setting points here. +application = get_wsgi_application() diff --git a/manage.py b/manage.py new file mode 100755 index 0000000..c723c7c --- /dev/null +++ b/manage.py @@ -0,0 +1,27 @@ +#!/usr/bin/env python +import os +import sys + +from drupal2spip_lal.settings import DJANGO_SETTINGS_MODULE + +if __name__ == "__main__": + # Set the default settings module to use. + os.environ.setdefault('DJANGO_SETTINGS_MODULE', DJANGO_SETTINGS_MODULE) + + try: + from django.core.management import execute_from_command_line + except ImportError: + # The above import may fail for some other reason. Ensure that the + # issue is really that Django is missing to avoid masking other + # exceptions on Python 2. + try: + import django # noqa + except ImportError: + raise ImportError( + "Couldn't import Django. Are you sure it's installed and " + "available on your PYTHONPATH environment variable? Did you " + "forget to activate a virtual environment?" + ) + raise + + execute_from_command_line(sys.argv) diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..e5a8d2e --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,15 @@ +[tool.black] +line-length = 79 +skip-string-normalization = true +exclude = ''' +/( + \.git + | venv + | local + | var + | migrations + | node_modules + | assets +)/ +| urls(|_.+|/.+).py +''' diff --git a/requirements.txt b/requirements.txt new file mode 100644 index 0000000..0b95660 --- /dev/null +++ b/requirements.txt @@ -0,0 +1,3 @@ +# This file is here because many Platforms as a Service look for +# requirements.txt in the root directory of a project. +-r requirements/production.txt diff --git a/requirements/base.txt b/requirements/base.txt new file mode 100644 index 0000000..e3702db --- /dev/null +++ b/requirements/base.txt @@ -0,0 +1,4 @@ +# Django +# ------------------------------------------------------------------------------ +django >=3.0,<3.1 # https://www.djangoproject.com/ +django-environ ==0.4.5 # https://github.com/joke2k/django-environ diff --git a/requirements/development.txt b/requirements/development.txt new file mode 100644 index 0000000..ff541a4 --- /dev/null +++ b/requirements/development.txt @@ -0,0 +1,6 @@ +-r test.txt + +# Django +# ------------------------------------------------------------------------------ +django-debug-toolbar # https://github.com/jazzband/django-debug-toolbar +django-extensions # https://github.com/django-extensions/django-extensions diff --git a/requirements/production.txt b/requirements/production.txt new file mode 100644 index 0000000..9b36138 --- /dev/null +++ b/requirements/production.txt @@ -0,0 +1,3 @@ +-r base.txt + +# PRECAUTION: avoid production dependencies that aren't in development. diff --git a/requirements/test.txt b/requirements/test.txt new file mode 100644 index 0000000..1f75bf1 --- /dev/null +++ b/requirements/test.txt @@ -0,0 +1,16 @@ +-r base.txt + +# Testing +# ------------------------------------------------------------------------------ +pytest # https://github.com/pytest-dev/pytest + +# Code quality +# ------------------------------------------------------------------------------ +black; python_version>'3.5' # https://github.com/python/black +flake8 >=3.5.0 # https://github.com/pycqa/flake8 +isort # https://github.com/timothycrosley/isort +pytest-cov # https://github.com/pytest-dev/pytest-cov + +# Django +# ------------------------------------------------------------------------------ +pytest-django # https://github.com/pytest-dev/pytest-django diff --git a/setup.cfg b/setup.cfg new file mode 100644 index 0000000..e127498 --- /dev/null +++ b/setup.cfg @@ -0,0 +1,45 @@ +[tool:pytest] +addopts = --ds=drupal2spip_lal.settings.test +python_files = tests.py test_*.py +testpaths = drupal2spip_lal + +[coverage:run] +branch = True +source = + drupal2spip_lal +omit = + drupal2spip_lal/*tests*, + drupal2spip_lal/*/migrations/*, + drupal2spip_lal/settings/*, + drupal2spip_lal/wsgi.py + +[coverage:report] +exclude_lines = + pragma: no cover + if settings.DEBUG: + raise NotImplementedError +show_missing = True + +[flake8] +exclude = + .git, + .tox, + venv, + */migrations/*, + */static/*, + assets, + build, + dist, + docs, + node_modules +max-line-length = 80 + +[isort] +line_length = 80 +known_first_party = drupal2spip_lal +multi_line_output = 3 +default_section = THIRDPARTY +known_django = django +sections = FUTURE,STDLIB,DJANGO,THIRDPARTY,FIRSTPARTY,LOCALFOLDER +skip_glob = **/migrations/*.py +include_trailing_comma = True