Changing files permissions (due to ... ?)

This commit is contained in:
Fred Pauchet 2022-09-10 14:26:47 +02:00
parent db8bafa349
commit a64032fd48
222 changed files with 43 additions and 20 deletions

0
.drone.yml Normal file → Executable file
View File

0
.gitignore vendored Normal file → Executable file
View File

0
CONTRIBUTING.md Normal file → Executable file
View File

0
Makefile Normal file → Executable file
View File

View File

@ -6,6 +6,9 @@ Ce livre peut être compilé avec une image Docker personnalisée, basée sur Mi
Pygments est également installé.
Elle peut être compilée avec Docker ou Podman, grâce à l'une des commandes suivantes:
* `docker build - < Dockerfile`
* `docker build .`
* `docker build -t miktex-pygments .`
Pour compiler le manuel en PDF:
* `./docker-miktex.sh`

0
annexes/grafana.tex Normal file → Executable file
View File

0
annexes/snippets.tex Normal file → Executable file
View File

0
annexes/sonar.tex Normal file → Executable file
View File

0
chapters/administration.tex Normal file → Executable file
View File

0
chapters/api.tex Normal file → Executable file
View File

0
chapters/architecture.tex Normal file → Executable file
View File

0
chapters/authentication.tex Normal file → Executable file
View File

0
chapters/contexts-processors.tex Normal file → Executable file
View File

0
chapters/continuous-integration.tex Normal file → Executable file
View File

0
chapters/debian.tex Normal file → Executable file
View File

0
chapters/deployment-processes.tex Normal file → Executable file
View File

0
chapters/deployment-tools.tex Normal file → Executable file
View File

0
chapters/docker-compose.tex Normal file → Executable file
View File

0
chapters/filters.tex Normal file → Executable file
View File

0
chapters/forms.tex Normal file → Executable file
View File

0
chapters/gdpr.tex Normal file → Executable file
View File

0
chapters/gwift.tex Normal file → Executable file
View File

0
chapters/heroku.tex Normal file → Executable file
View File

0
chapters/i18n.tex Normal file → Executable file
View File

0
chapters/infrastructure.tex Normal file → Executable file
View File

40
chapters/introduction.tex Normal file → Executable file
View File

@ -1,7 +1,7 @@
\chapter{Introduction}
\begin{quote}
The only way to go fast, is to go well
\textit{The only way to go fast, is to go well}
--- Robert C. Martin
\end{quote}
@ -19,15 +19,14 @@ Les quelques idées ci-dessous de jeter les bases d'un bon développement, en
\end{itemize}
Ces idées ne s'appliquent pas uniquement à Django et à son cadre de travail, ni même au langage Python en particulier.
Dans \href{http://blog.codinghorror.com/why-ruby/}{un article de blog}, Jeff Atwood, développeur .Net expérimenté, a décrit sa décision de développer Discourse en utilisant le language Ruby \cite[p. 27]{roads_and_bridges}.
La même réflexion s'applique sans effort à Python et Django:
Dans un article de blog \footnote{\url{http://blog.codinghorror.com/why-ruby/}}, Jeff Atwood, développeur .Net expérimenté, a décrit sa décision de développer Discourse en utilisant le language Ruby \cite[p. 27]{roads_and_bridges}:
\begin{quote}
Getting up and running with a Microsoft stack is just plain too hard for a developer in, say, Argentina, or Nepal, or Bulgaria.
Open source operating systems, languages, and tool chaines are the great equializer, the basis for the next great generation of programmers all over the world who are goind to help us change the world.
\textit{Getting up and running with a Microsoft stack is just plain too hard for a developer in, say, Argentina, or Nepal, or Bulgaria.
Open source operating systems, languages, and tool chaines are the great equializer, the basis for the next great generation of programmers all over the world who are goind to help us change the world.}
\end{quote}
L'organisation \textit{Django Girls} a par exemple formé plus de 2000 femmes dans le monde, réparties dans plus de 49 pays \footnote{https://djangogirls.com}.
La même réflexion s'applique sans effort à Python et Django: l'organisation \textit{Django Girls} a par exemple formé plus de 2000 femmes dans le monde, réparties dans plus de 49 pays \footnote{https://djangogirls.com}.
Django n'a pas été développé par cette organisation elle-même, mais étant \textit{open source}, ce framework peut être téléchargé, utilisé et étudié gratuitement. \cite[p. 28]{roads_and_bridges}.
Si ces morceaux logiciels n'étaient pas libres et accessibles, ils ne pourraient pas être déconstruits, analysés, étudiés et publiés, ni aider certaines personnes à exercer leur propre métier. \footnote{Les termes \textit{free software} et \textit{open source} sont généralement accolés l'un à l'autre; ils ont cependant une conotation politique distincte: le premier est étroitement associé à l'éthique tandis que le second est plus pragmatique. \textit{Open source is a development methodology; free software is a social movement.}\cite{gnu}}
L'ouverture de ces langages et frameworks en fait également un modèle bien défini de documentation et de flexibilité.
@ -51,8 +50,6 @@ Mis côte à côte, le suivi de ces principes permet une bonne stabilité du pro
Sans être parfait, Django offre une énorme flexibilité qui permet de conserver un maximum d'options ouvertes et de facilement expérimenter différentes pistes, jusqu'au moment de prendre une vraie décision.
Pour la (grande) majorité des problèmes rencontrés lors du développement d'une application Web, Django proposera une solution pragmatique, compréhensible et facile à mettre en place: pour tout problème communément connu, vous disposerez d'une solution logique.
Tout pour plaire à n'importe quel directeur IT.
\textbf{Dans la première partie}, nous verrons comment partir d'un environnement sain, comment le configurer correctement, comment installer Django de manière isolée et comment démarrer un nouveau projet.
Nous verrons rapidement comment gérer les dépendances, les versions et comment appliquer et suivre un score de qualité de notre code.
Ces quelques points pourront être appliqués pour n'importe quel langage ou cadre de travail.
@ -62,7 +59,7 @@ Pour cela, nous présenterons différents outils, la rédaction de tests unitair
A la fin de cette partie, vous disposerez d'un code propre et d'un projet fonctionnel, bien qu'encore un peu inutile.
textbf{Dans la deuxième partie}, nous aborderons les grands principes de modélisation, en suivant les lignes de conduites du cadre de travail.
\textbf{Dans la deuxième partie}, nous aborderons les grands principes de modélisation, en suivant les lignes de conduites du cadre de travail.
Nous aborderons les concepts clés qui permettent à une application de rester maintenable, les formulaires, leurs validations, comment gérer les données en entrée, les migrations de données et l'administration.
\textbf{Dans la troisième partie}, nous détaillerons précisément les étapes de déploiement, avec la description et la configuration de l'infrastructure, des exemples concrets de mise à disposition sur deux distributions principales (Debian et CentOS), sur une \emph{*Plateform as a Service*}, ainsi que l'utilisation de Docker et Docker-Compose.
@ -73,18 +70,26 @@ Nous aborderons également la supervision et la mise à jour d'une application e
\textbf{Dans la cinquième partie}, nous mettrons ces concepts en pratique en présentant le développement en pratique de deux applications, avec la description de problèmes rencontrés et la solution qui a été choisie: définition des tables, gestion des utilisateurs, \ldots\hspace{0pt} et mise à disposition.
\subsection{Pour qui ?}
\subsection*{Pour qui ?}
Avant tout, pour moi.
Comme le disait le Pr Richard Feynman: "\emph{Si vous ne savez pas expliquer quelque chose simplement, c'est que vous ne l'avez pas compris}".
\footnote{Et comme l'ajoutait Aurélie Jean dans de L'autre côté de la machine: \emph{"Si personne ne vous pose de questions suite à votre explication, c'est que vous n'avez pas été suffisamment clair !"} \cite{other_side}}
Ce livre s'adresse autant au néophyte qui souhaite se lancer dans le développement Web qu'à l'artisan qui a besoin d'un aide-mémoire et qui ne se rappelle plus toujours du bon ordre des paramètres, ou à l'expert qui souhaiterait avoir un aperçu d'une autre technologie que son domaine privilégié de compétences.
Ensuite, ce livre s'adresse autant
Beaucoup de concepts présentés peuvent être oubliés ou restés inconnus jusqu'au moment où ils seront réellement nécessaires.
A ce moment-là, pour peu que votre mémoire ait déjà entraperçu le terme, il vous sera plus facile d'y revenir et de l'appliquer.
\begin{enumerate}
\item
au néophyte qui souhaite se lancer dans le développement Web
\item
qu'à l'artisan qui a besoin d'un aide-mémoire et qui ne se rappelle plus toujours du bon ordre des paramètres,
\item
ou à l'expert qui souhaiterait avoir un aperçu d'une autre technologie que son domaine privilégié de compétences.
\end{enumerate}
\subsection{Pour aller plus loin}
Beaucoup de concepts présentés peuvent être oubliés ou restés inconnus jusqu'au moment où ils seront réellement nécessaires: à ce moment-là, pour peu que votre mémoire ait déjà entraperçu le terme, il vous sera plus facile d'y revenir et de l'appliquer.
\subsection*{Pour aller plus loin}
Il existe énormément de ressources, autant spécifiques à Django que plus généralistes.
Il ne sera pas possible de toutes les détailler; faites un tour sur
@ -100,7 +105,7 @@ Il ne sera pas possible de toutes les détailler; faites un tour sur
Restez curieux, ne vous enclavez pas dans une technologie en particulie et gardez une bonne ouverture d'esprit.
\subsection{Conventions}
\subsection*{Conventions}
Les notes indiquent des anecdotes.
Les conseils indiquent des éléments utiles, mais pas spécialemen indispensables.
@ -125,7 +130,8 @@ Les morceaux de code source seront présentés de la manière suivante:
\end{minted}
\end{listing}
Chaque extrait de code reprendra
Chaque extrait de code reprend:
\begin{itemize}
\item l'emplacement du fichier, présenté sous forme de commentaire (ligne 1),
\item Des commentaires au niveau des fonctions et méthodes, si cela s'avère nécessaire
@ -133,7 +139,7 @@ Chaque extrait de code reprendra
\end{itemize}
La plupart des commandes qui seront présentées dans ce livre le seront depuis un shell sous GNU/Linux.
Certaines d'entre elles pourraient devoir être adaptées si vous utilisez un autre système d'exploitation (macOS) ou n'importe quelle autre grosse bouse commerciale.
Certaines d'entre elles pourraient devoir être adaptées si vous utilisez un autre système d'exploitation (macOS ou Microsoft Windows).
Les morceaux de code que vous trouverez ci-dessous seront développés pour Python3.9+ et Django 3.2+.
Ils nécessiteront peut-être quelques adaptations pour fonctionner sur une version antérieure.

0
chapters/khana.tex Normal file → Executable file
View File

0
chapters/kubernetes.tex Normal file → Executable file
View File

0
chapters/licence.tex Normal file → Executable file
View File

0
chapters/maintenability.tex Normal file → Executable file
View File

0
chapters/migrations.tex Normal file → Executable file
View File

0
chapters/models.tex Normal file → Executable file
View File

0
chapters/new-project.tex Normal file → Executable file
View File

0
chapters/python.tex Normal file → Executable file
View File

0
chapters/resources.tex Normal file → Executable file
View File

0
chapters/security.tex Normal file → Executable file
View File

0
chapters/svelte.tex Normal file → Executable file
View File

0
chapters/templates.tex Normal file → Executable file
View File

0
chapters/tests.tex Normal file → Executable file
View File

0
chapters/thanks.tex Normal file → Executable file
View File

14
chapters/tools.tex Normal file → Executable file
View File

@ -204,6 +204,20 @@ Il est possible de suivre les recommandations de \textit{Conventional Commits} \
Rendre l'accès au code plus lisible, en facilitant l'exploration du code au travers de commits mieux structurés.
\end{enumerate}
\subsubsection{<type>}
\subsubsection{<scope>}
\subsubsection{<description>}
\subsubsection{<body>}
\subsubsection{<footer(s)>}
\subsubsection{CHANGELOG}
Une fois les changements décrits en suivant ces conventions, et sous réserve qu'elles soient bien respectées, permet de générer un CHANGELOG \footnote{\url{https://github.com/conventional-changelog/standard-version}}.
\subsection{Nommer ses branches}

0
chapters/trees.tex Normal file → Executable file
View File

0
chapters/urls.tex Normal file → Executable file
View File

0
chapters/views.tex Normal file → Executable file
View File

2
chapters/working-in-isolation.tex Normal file → Executable file
View File

@ -151,7 +151,7 @@ a manière recommandée pour la gestion des dépendances consiste à les épingl
Ce fichier reprend, ligne par ligne, chaque dépendance et la version nécessaire.
Cet épinglage est cependant relativement basique, dans la mesure où les opérateurs disponibles sont ==, et \textgreater=.
Poetry propose un épinglage basé sur SemVer.
Poetry propose un épinglage basé sur SemVer\index{Semantic Versioning}.
Les contraintes qui peuvent être appliquées aux dépendances sont plus touffues que ce que proposent pip -r, avec la présence du curseur \^{}, qui ne modifiera pas le nombre différent de zéro le plus à gauche:
\begin{verbatim}

0
code_samples/shapes.py Normal file → Executable file
View File

0
diagrams/books-foreign-keys-example Normal file → Executable file
View File

0
diagrams/books-foreign-keys-example.drawio.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 29 KiB

After

Width:  |  Height:  |  Size: 29 KiB

0
ideas/21-10-01 21-30-54 1890.jpg Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 3.3 MiB

After

Width:  |  Height:  |  Size: 3.3 MiB

0
ideas/21-10-01 21-31-20 1891.jpg Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 3.1 MiB

After

Width:  |  Height:  |  Size: 3.1 MiB

0
ideas/libs.rst Normal file → Executable file
View File

0
ideas/resources.md Normal file → Executable file
View File

0
ideas/tests.asciidoc Normal file → Executable file
View File

0
images/12factors/attached-resources.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 55 KiB

After

Width:  |  Height:  |  Size: 55 KiB

0
images/12factors/process-type-chronology.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 27 KiB

0
images/12factors/process-types.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 21 KiB

After

Width:  |  Height:  |  Size: 21 KiB

0
images/12factors/release.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 14 KiB

After

Width:  |  Height:  |  Size: 14 KiB

0
images/amazon-s3-arch.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 186 KiB

After

Width:  |  Height:  |  Size: 186 KiB

0
images/arch-comp-modules.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 18 KiB

0
images/arch-structure Normal file → Executable file
View File

0
images/calvin/time-machine.jpg Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 57 KiB

After

Width:  |  Height:  |  Size: 57 KiB

0
images/commistrip/versions.jpg Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 272 KiB

After

Width:  |  Height:  |  Size: 272 KiB

0
images/db/link-book-category-fk.drawio Normal file → Executable file
View File

0
images/db/link-book-category-fk.drawio.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 11 KiB

After

Width:  |  Height:  |  Size: 11 KiB

0
images/db/link-book-category-m2m.drawio.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 40 KiB

After

Width:  |  Height:  |  Size: 40 KiB

0
images/db/migrations-0001-to-0002.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 116 KiB

After

Width:  |  Height:  |  Size: 116 KiB

0
images/db/migrations-0002-many-to-many.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 129 KiB

After

Width:  |  Height:  |  Size: 129 KiB

View File

Before

Width:  |  Height:  |  Size: 62 KiB

After

Width:  |  Height:  |  Size: 62 KiB

0
images/db/~$link-book-category-fk.drawio.dtmp Normal file → Executable file
View File

0
images/deployment/disallowed_hosts.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 77 KiB

After

Width:  |  Height:  |  Size: 77 KiB

0
images/deployment/gwift-cloud-s3.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 75 KiB

After

Width:  |  Height:  |  Size: 75 KiB

0
images/deployment/heroku-app-created.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 23 KiB

After

Width:  |  Height:  |  Size: 23 KiB

0
images/deployment/heroku-new-app.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 57 KiB

After

Width:  |  Height:  |  Size: 57 KiB

0
images/deployment/heroku-vars-reveal.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 29 KiB

After

Width:  |  Height:  |  Size: 29 KiB

0
images/deployment/heroku.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

0
images/deployment/iaas_focus-paas-saas-diagram.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 51 KiB

After

Width:  |  Height:  |  Size: 51 KiB

0
images/deployment/scaleway-api-key.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 37 KiB

After

Width:  |  Height:  |  Size: 37 KiB

0
images/deployment/scaleway-object-storage-bucket.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 109 KiB

After

Width:  |  Height:  |  Size: 109 KiB

0
images/diagrams/12-factors-1 Normal file → Executable file
View File

0
images/diagrams/12-factors-1.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 54 KiB

After

Width:  |  Height:  |  Size: 54 KiB

0
images/diagrams/12-factors-7 Normal file → Executable file
View File

0
images/diagrams/12-factors-7.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

0
images/diagrams/12factors-codebase-deploys.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 25 KiB

0
images/diagrams/architecture.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 38 KiB

After

Width:  |  Height:  |  Size: 38 KiB

0
images/diagrams/basic-automation.drawio.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 18 KiB

After

Width:  |  Height:  |  Size: 18 KiB

0
images/diagrams/deploy-without-hassle.drawio.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

0
images/diagrams/django-how-it-works.drawio Normal file → Executable file
View File

0
images/diagrams/django-how-it-works.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 156 KiB

After

Width:  |  Height:  |  Size: 156 KiB

0
images/diagrams/django-migrations-db-schema.drawio Normal file → Executable file
View File

0
images/diagrams/django-process.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 21 KiB

After

Width:  |  Height:  |  Size: 21 KiB

0
images/diagrams/django-project-vs-apps-gwift.drawio Normal file → Executable file
View File

0
images/diagrams/django-project-vs-apps-khana.drawio Normal file → Executable file
View File

0
images/diagrams/django-project-vs-apps.drawio Normal file → Executable file
View File

0
images/diagrams/git-workflow.drawio Normal file → Executable file
View File

0
images/diagrams/git-workflow.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 172 KiB

After

Width:  |  Height:  |  Size: 172 KiB

0
images/diagrams/host-structure Normal file → Executable file
View File

0
images/diagrams/infrastructure-base.drawio Normal file → Executable file
View File

0
images/diagrams/infrastructure.drawio.png Normal file → Executable file
View File

Before

Width:  |  Height:  |  Size: 60 KiB

After

Width:  |  Height:  |  Size: 60 KiB

0
images/diagrams/views-services-managers-models.drawio Normal file → Executable file
View File

View File

Before

Width:  |  Height:  |  Size: 7.6 KiB

After

Width:  |  Height:  |  Size: 7.6 KiB

Some files were not shown because too many files have changed in this diff Show More