https://cheroliv.com/ JBake Bootstrap Πρότυπο en-gb Fri, 25 Sep 2026 01:47:33 +0000 Fri, 25 Sep 2026 01:47:33 +0000 https://cheroliv.com/blog/2025/0080_kitty_term_post.html Thu, 7 May 2026 00:00:00 +0000 blog/2025/0080_kitty_term_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_γιατί_να_επιλέξετε_το_kitty_και_το_zsh">Γιατί να επιλέξετε το Kitty και το Zsh;</a></li> <li><a href="#_προϋποθέσεις_συστήματος">Προϋποθέσεις συστήματος</a></li> <li><a href="#_λήψη_και_εγκατάσταση_του_kitty">Λήψη και εγκατάσταση του Kitty</a> <ul class="sectlevel2"> <li><a href="#_κατεβάστε_το_script_της_εγκατάστασης">Κατεβάστε το script της εγκατάστασης</a></li> <li><a href="#_δημιουργία_συμβολικών_συνδέσμων">Δημιουργία συμβολικών συνδέσμων</a></li> </ul> </li> <li><a href="#_ενσωμάτωση_του_kitty_στο_xubuntu">Ενσωμάτωση του Kitty στο Xubuntu</a> <ul class="sectlevel2"> <li><a href="#_αντιγράψτε_το_αρχείο_desktop">Αντιγράψτε το αρχείο desktop</a></li> <li><a href="#_τροποποίησε_το_αρχείο_desktop">Τροποποίησε το αρχείο desktop</a></li> <li><a href="#_συνδέστε_το_kitty_ως_προεπιλεγμένο_τερματικό_προαιρετικό">Συνδέστε το Kitty ως προεπιλεγμένο τερματικό (προαιρετικό)</a></li> </ul> </li> <li><a href="#_εγκατάσταση_του_zsh">Εγκατάσταση του Zsh</a></li> <li><a href="#_καθορίστε_το_zsh_ως_προεπιλεγμένο_shell">Καθορίστε το Zsh ως προεπιλεγμένο shell</a> <ul class="sectlevel2"> <li><a href="#_συνολική_μέθοδος_για_όλους_τους_τερματίς">Συνολική μέθοδος (για όλους τους τερματίς)</a></li> <li><a href="#_μέθοδος_ειδική_για_το_kitty">Μέθοδος ειδική για το Kitty</a></li> </ul> </li> <li><a href="#_ρύθμιση_zsh_προαιρετικό">�Ρύθμιση Zsh (προαιρετικό)</a> <ul class="sectlevel2"> <li><a href="#_δημιούργησε_ένα_αρχείο_zshrc">Δημιούργησε ένα αρχείο .zshrc</a></li> <li><a href="#_παράδειγμα_ελαχιστής_διαμόρφωσης">Παράδειγμα ελαχιστής διαμόρφωσης</a></li> </ul> </li> <li><a href="#_περίληψη_της_πλήρους_ροής_εργασίας">Περίληψη της πλήρους ροής εργασίας</a></li> <li><a href="#_τελικός_έλεγχος">Τελικός έλεγχος</a> <ul class="sectlevel2"> <li><a href="#_άνοιγμα_του_αρχείου_ρυθμίσεων">�📂 Άνοιγμα του αρχείου ρυθμίσεων</a></li> <li><a href="#_️_προσθέστε_ή_τροποποιήστε_font_size">�🖋️ Προσθέστε ή τροποποιήστε `font_size</a></li> <li><a href="#_αποθήκευση_και_επανεκκίνηση_του_kitty">💾 Αποθήκευση και επανεκκίνηση του Kitty</a></li> <li><a href="#_δυναμική_ρύθμιση_προσωρινός_zoom">✅ Δυναμική ρύθμιση (Προσωρινός Zoom)</a></li> </ul> </li> <li><a href="#_εγκατάσταση_και_ρύθμιση_του_oh_my_zsh">Εγκατάσταση και ρύθμιση του Oh My Zsh</a> <ul class="sectlevel2"> <li><a href="#_εγκατάσταση_του_oh_my_zsh">Εγκατάσταση του Oh My Zsh</a></li> <li><a href="#_αλλαγή_θέματος">Αλλαγή θέματος</a></li> <li><a href="#_έλεγχος">έλεγχος</a></li> <li><a href="#_διάγραμμα_use_case">Διάγραμμα use case</a></li> </ul> </li> <li><a href="#_ενεργοποίηση_της_διαφάνειας_στο_kitty">Ενεργοποίηση της διαφάνειας στο Kitty</a> <ul class="sectlevel2"> <li><a href="#_προαπαιτούμενα_για_τη_διαφάνεια">Προαπαιτούμενα για τη διαφάνεια</a></li> <li><a href="#_ρύθμιση_της_διαφάνειας_στο_kitty_conf">�Ρύθμιση της διαφάνειας στο kitty.conf</a></li> <li><a href="#_επανεκκίνηση_kitty">Επανεκκίνηση Kitty</a></li> <li><a href="#_πιθανά_συμπλήρωματα">Πιθανά Συμπλήρωματα</a></li> <li><a href="#_διάγραμμα_ακολουθίας_αρχικοποίηση_του_kitty_με_διαφάνεια">Διάγραμμα ακολουθίας - Αρχικοποίηση του Kitty με διαφάνεια</a></li> <li><a href="#_γνωστές_περιορισμοί">Γνωστές περιορισμοί</a></li> </ul> </li> <li><a href="#_απενεργοποίηση_του_ακουστικού_bip_ακουστικό_σήμα">Απενεργοποίηση του ακουστικού bip (ακουστικό σήμα)</a></li> <li><a href="#_ενημέρωση_της_kitty">Ενημέρωση της Kitty</a></li> <li><a href="#_αναφορές">Αναφορές</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>Αυτός ο οδηγός εξηγεί βήμα προς βήμα πώς να εγκαταστήσετε το τερματικό <strong>kitty</strong> στο Xubuntu, να το ρυθμίσετε σωστά, και να αντικαταστήσετε το bash με το <strong>zsh</strong> ως προεπιλεγμένο shell. Το έργο kitty είναι διαθέσιμο εδώ: <a href="https://github.com/kovidgoyal/kitty" class="bare">https://github.com/kovidgoyal/kitty</a></p> </div> <div class="paragraph"> <p><em><em>_ Το Kitty είναι ένας σύγχρονος, γρήγορος και ρυθμιζόμενος τερματικός, ειδικά κατάλληλος για απαιτητικούς προγραμματιστές. </em>_</em></p> </div> </div> </div> <div class="sect1"> <h2 id="_γιατί_να_επιλέξετε_το_kitty_και_το_zsh">Γιατί να επιλέξετε το Kitty και το Zsh;</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η Kitty διακρίνεται με:</p> </div> <div class="ulist"> <ul> <li> <p>Βελτιστημένη απόδοση χάρη στην επιτάχυνση GPU,</p> </li> <li> <p>Μια ρύθμιση που βασίζεται πλήρως σε ένα μοναδικό αρχείο κειμένου,</p> </li> <li> <p>Εξαιρετική υποστήριξη γραμματοσειρών και συνδετέσμων.</p> </li> </ul> </div> <div class="paragraph"> <p>Το Zsh, από την πλευρά του, είναι ένα δυνατός διαλογικός κέλυφος που προσφέρει:</p> </div> <div class="ulist"> <ul> <li> <p>Μια έξυπνη συμπλήρωση,</p> </li> <li> <p>Ένας προσαρμόσιμος prompt,</p> </li> <li> <p>Μεγάλη συμβατότητα με το bash.</p> </li> </ul> </div> <div class="paragraph"> <p>Συνδυάζοντας το Kitty και το Zsh, απολαμβάνεσθε ένα παραγωγικό και αισθητικό περιβάλλον.</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/kitty-zsh-overview.png" alt="kitty zsh overview" width="729" height="305"> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>Αυτός ο οδηγός είναι προσημαστικά περιορισμένος στην εγκατάσταση μέσω script και στο Xubuntu.</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_προϋποθέσεις_συστήματος">Προϋποθέσεις συστήματος</h2> <div class="sectionbody"> <div class="paragraph"> <p>Πριν ξεκινήσετε, βεβαιωθείτε ότι έχετε :</p> </div> <div class="ulist"> <ul> <li> <p>Xubuntu εγκατεστημένο</p> </li> <li> <p>μία πρόσβαση στο διαδίκτυο,</p> </li> <li> <p>Ένας λειτουργικός bash shell για να εκτελέσετε το script.</p> </li> </ul> </div> <div class="paragraph"> <p>Ελέγξτε το περιβάλλον σας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">uname -a lsb_release -a</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_λήψη_και_εγκατάσταση_του_kitty">Λήψη και εγκατάσταση του Kitty</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η Kitty συνιστά να την εγκαταστήσετε μέσω ενός επίσημου σεναρίου που τοποθετεί τα αρχεία στο`~/.local/kitty.app`.</p> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="Important"></i> </td> <td class="content"> <div class="paragraph"> <p>Αυτή η μέθοδος είναι ανεξάρτητη από τους διαχειριστές πακέτων (χωρίς`apt`).</p> </div> </td> </tr> </table> </div> <div class="sect2"> <h3 id="_κατεβάστε_το_script_της_εγκατάστασης">Κατεβάστε το script της εγκατάστασης</h3> <div class="paragraph"> <p>Εκτελέστε την ακόλουθη εντολή :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -L https://sw.kovidgoyal.net/kitty/installer.sh | sh /dev/stdin</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η εντολή εκτελεί :</p> </div> <div class="ulist"> <ul> <li> <p>λήψη των δυαδικών,</p> </li> <li> <p>εξαγωγή στο`~/.local/kitty.app`,</p> </li> <li> <p>Δημιουργία συμβολικών συνδέσμων.</p> </li> </ul> </div> <div class="imageblock"> <div class="content"> <img src="./images/download-install.svg" alt="download install" width="301" height="336"> </div> </div> </div> <div class="sect2"> <h3 id="_δημιουργία_συμβολικών_συνδέσμων">Δημιουργία συμβολικών συνδέσμων</h3> <div class="paragraph"> <p>Για να μπορέσετε να καλέσετε`kitty`Από το τερματικό, δημιουργήστε ένα συμβολικό σύνδεσμο:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">ln -s ~/.local/kitty.app/bin/kitty ~/.local/bin/kitty</code></pre> </div> </div> <div class="paragraph"> <p>Προσθέστε`~/.local/bin`στο PATH σας αν δεν το έχετε κάνει ήδη:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc</code></pre> </div> </div> <div class="paragraph"> <p>Μπορείτε να ελέγξετε την εγκατάσταση:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">kitty --version</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ενσωμάτωση_του_kitty_στο_xubuntu">Ενσωμάτωση του Kitty στο Xubuntu</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να εμφανιστεί το Kitty στο μενού εφαρμογών :</p> </div> <div class="sect2"> <h3 id="_αντιγράψτε_το_αρχείο_desktop">Αντιγράψτε το αρχείο desktop</h3> <div class="paragraph"> <p>Αντιγράψτε το αρχείο`.desktop`παρέχετε :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cp ~/.local/kitty.app/share/applications/kitty.desktop ~/.local/share/applications/</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_τροποποίησε_το_αρχείο_desktop">Τροποποίησε το αρχείο desktop</h3> <div class="paragraph"> <p>Επεξεργαστείτε το αρχείο :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.local/share/applications/kitty.desktop</code></pre> </div> </div> <div class="paragraph"> <p>Έλεγξτε ή τροποποιήστε τις παρακάτω γραμμές:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">[Desktop Entry] Version=1.0 Type=Application Name=Kitty Terminal Comment=Fast GPU-based terminal emulator Exec=/home/$USER/.local/kitty.app/bin/kitty Icon=kitty Categories=System;TerminalEmulator;</code></pre> </div> </div> <div class="paragraph"> <p>Αντικαταστήστε`YOURUSER`από το όνομα χρήστη σας</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/desktop-integration.png" alt="desktop integration" width="478" height="335"> </div> </div> </div> <div class="sect2"> <h3 id="_συνδέστε_το_kitty_ως_προεπιλεγμένο_τερματικό_προαιρετικό">Συνδέστε το Kitty ως προεπιλεγμένο τερματικό (προαιρετικό)</h3> <div class="paragraph"> <p>Για να είναι το τερματικό Kitty εκτελούμενο ως προεπιλογή:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo update-alternatives --install /usr/bin/x-terminal-emulator x-terminal-emulator ~/.local/kitty.app/bin/kitty 50 sudo update-alternatives --config x-terminal-emulator</code></pre> </div> </div> <div class="paragraph"> <p>Επιλέξτε`kitty`στο προτεινόμενο μενού.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_εγκατάσταση_του_zsh">Εγκατάσταση του Zsh</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αν το Zsh δεν είναι ακόμα εγκατεστημένο, εκτελέστε :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install zsh</code></pre> </div> </div> <div class="paragraph"> <p>Ελέγξτε την εγκατάσταση :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">zsh --version</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_καθορίστε_το_zsh_ως_προεπιλεγμένο_shell">Καθορίστε το Zsh ως προεπιλεγμένο shell</h2> <div class="sectionbody"> <div class="paragraph"> <p>Μπορείτε να αλλάξετε το κέλυφος σας συστημικά ή μόνο στο Kitty.</p> </div> <div class="sect2"> <h3 id="_συνολική_μέθοδος_για_όλους_τους_τερματίς">Συνολική μέθοδος (για όλους τους τερματίς)</h3> <div class="paragraph"> <p>Βρείτε τη απόλυτη διαδρομή:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">which zsh</code></pre> </div> </div> <div class="paragraph"> <p>Συνήθως`/usr/bin/zsh`.</p> </div> <div class="paragraph"> <p>Αλλάξτε το προεπιλεγμένο shell:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">chsh -s /usr/bin/zsh</code></pre> </div> </div> <div class="paragraph"> <p>Αποσυνδεθείτε και συνδεθείτε ξανά.</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/zsh-default-shell.svg" alt="zsh default shell" width="546" height="341"> </div> </div> </div> <div class="sect2"> <h3 id="_μέθοδος_ειδική_για_το_kitty">Μέθοδος ειδική για το Kitty</h3> <div class="paragraph"> <p>Αν προτιμάτε να αλλάξετε μόνο το shell στο Kitty, επεξεργαστείτε το αρχείο ρύθμισης:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.config/kitty/kitty.conf</code></pre> </div> </div> <div class="paragraph"> <p>Προσθέστε αυτή τη γραμμή :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">shell zsh</code></pre> </div> </div> <div class="paragraph"> <p>Αποθηκεύστε και επανεκκινήστε το Kitty.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ρύθμιση_zsh_προαιρετικό">�Ρύθμιση Zsh (προαιρετικό)</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να προσαρμόσετε το Zsh σας:</p> </div> <div class="sect2"> <h3 id="_δημιούργησε_ένα_αρχείο_zshrc">Δημιούργησε ένα αρχείο .zshrc</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">touch ~/.zshrc nano ~/.zshrc</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_παράδειγμα_ελαχιστής_διαμόρφωσης">Παράδειγμα ελαχιστής διαμόρφωσης</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">export ZSH_THEME="robbyrussell" export PATH="$HOME/.local/bin:$PATH" alias ll="ls -la"</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_περίληψη_της_πλήρους_ροής_εργασίας">Περίληψη της πλήρους ροής εργασίας</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το σχήμα που ακολουθεί παρακάτω συνοπτίζει ολόκληρο τη διαδικασία :</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/full-workflow.png" alt="full workflow" width="375" height="643"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_τελικός_έλεγχος">Τελικός έλεγχος</h2> <div class="sectionbody"> <div class="paragraph"> <p>Εκκινήστε τη Kitty :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">kitty</code></pre> </div> </div> <div class="paragraph"> <p>Θα πρέπει να δείτε ότι`zsh`είναι ενεργός :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">echo $SHELL</code></pre> </div> </div> <div class="paragraph"> <p>Αναμενόμενο αποτέλεσμα :</p> </div> <div class="paragraph"> <p>/usr/bin/zsh</p> </div> <div class="paragraph"> <p>Για να αλλάξετε το μέγεθος της γραμματοσειράς στο<strong>Κίτυ</strong>, πρέπει να ρυθμίσουμε την παράμετρο`font_size`στο αρχείο ρυθμίσεων. Εδώ είναι η λεπτομερής διαδικασία:</p> </div> <div class="sect2"> <h3 id="_άνοιγμα_του_αρχείου_ρυθμίσεων">�📂 Άνοιγμα του αρχείου ρυθμίσεων</h3> <div class="paragraph"> <p>Το κύριο αρχείο ρυθμίσεων συνήθως βρίσκεται στον :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">~/.config/kitty/kitty.conf</code></pre> </div> </div> <div class="paragraph"> <p>Αν αυτό το αρχείο δεν υπάρχει ακόμα, μπορείτε να το δημιουργήσετε. Παράδειγμα :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.config/kitty/kitty.conf</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_️_προσθέστε_ή_τροποποιήστε_font_size">�🖋️ Προσθέστε ή τροποποιήστε `font_size</h3> <div class="paragraph"> <p>Προσθέστε την ακόλουθη οδηγία, ή τροποποιήστε τη αν υπάρχει ήδη:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">font_size 14.0</code></pre> </div> </div> <div class="paragraph"> <p>εδώ`14.0`Ταιριάζει με την επιθυμητή μέγεθος. Μπορείτε να ορίσετε οποιαδήποτε δεκαδική τιμή, για παράδειγμα.<code>12.0</code>, <code>15.5</code>, κ.λπ.</p> </div> </div> <div class="sect2"> <h3 id="_αποθήκευση_και_επανεκκίνηση_του_kitty">💾 Αποθήκευση και επανεκκίνηση του Kitty</h3> <div class="ulist"> <ul> <li> <p>Αποθηκεύστε (<code>Ctrl + O</code>, και έπειτα`Entrée`) και αφήνετε (<code>Ctrl + X</code>) αν χρησιμοποιείτε`nano`.</p> </li> <li> <p>Κλείște όλα τα παράθυρα του Kitty, στη συνέχεια επανεκκινήστε το τερματικό ώστε η αλλαγή να λάβει εφαρμογή.</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_δυναμική_ρύθμιση_προσωρινός_zoom">✅ Δυναμική ρύθμιση (Προσωρινός Zoom)</h3> <div class="paragraph"> <p>Εάν θέλετε να κάνετε προσωρινά μεγέθυνση/σμίκρυνση χωρίς να αλλάξετε τη ρύθμιση, χρησιμοποιήστε τις προεπιλεγμένες πληκτρολογιακές συντομεύσεις:</p> </div> <div class="ulist"> <ul> <li> <p><strong>Αύξηση μεγέττους γραμματοσειράς</strong>:</p> </li> </ul> </div> <div class="paragraph"> <p><code>Ctrl + Shift + =</code></p> </div> <div class="ulist"> <ul> <li> <p><strong>Μειώστε το μέγεθος της γραμματοσειράς</strong>:</p> </li> </ul> </div> <div class="paragraph"> <p><code>Ctrl + Shift + -</code></p> </div> <div class="ulist"> <ul> <li> <p><strong>Επαναφορά του μεγέθους</strong>:</p> </li> </ul> </div> <div class="paragraph"> <p><code>Ctrl + Shift + Backspace</code></p> </div> <div class="paragraph"> <p>Οι ρυθμίσεις δεν διαμένουν μετά το κλείσιμο του τερματικού.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_εγκατάσταση_και_ρύθμιση_του_oh_my_zsh">Εγκατάσταση και ρύθμιση του Oh My Zsh</h2> <div class="sectionbody"> <div class="paragraph"> <p>Μόλις το Zsh έχει εγκατασταθεί και ρυθμιστεί ως προεπιλεγμένο shell, μπορείτε να πλουτίσετε το περιβάλλον σας με <strong>Oh My Zsh</strong>, ένα πλαίσιο διαχείρισης της διαμόρφωσης του Zsh, που προσφέρει:</p> </div> <div class="ulist"> <ul> <li> <p>Μια συλλογή θεμάτων για το prompt,</p> </li> <li> <p>πολλά plugins</p> </li> <li> <p>Μια σαφής οργάνωση της διαμόρφωσης.</p> </li> </ul> </div> <div class="sect2"> <h3 id="_εγκατάσταση_του_oh_my_zsh">Εγκατάσταση του Oh My Zsh</h3> <div class="paragraph"> <p>Βεβαιωθείτε ότι το Zsh είναι ενεργό:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">zsh --version</code></pre> </div> </div> <div class="paragraph"> <p>Αν χρειάζεται, εκκινήστε:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">zsh</code></pre> </div> </div> <div class="paragraph"> <p>Στη συνέχεια, κατεβάστε και εκτελέστε το επίσημο script εγκατάστασης:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"</code></pre> </div> </div> <div class="paragraph"> <p>Αυτό το script:</p> </div> <div class="ulist"> <ul> <li> <p>Δημιούργησε τον φάκελο`~/.oh-my-zsh`,</p> </li> <li> <p>Αποθηκεύετε προαιρετικά το αρχείο σας`~/.zshrc`,</p> </li> <li> <p>ενεργοποιεί αυτόματα το νέο προτροπικό.</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_αλλαγή_θέματος">Αλλαγή θέματος</h3> <div class="paragraph"> <p>Ανοίξτε το αρχείο ρυθμίσεων σας:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.zshrc</code></pre> </div> </div> <div class="paragraph"> <p>Τροποποιήστε τη μεταβλητή`ZSH_THEME`για να επιλέξετε ένα άλλο θέμα (για παράδειγμα`agnoster`) :</p> </div> <div class="paragraph"> <p>ZSH_THEME="agnoster</p> </div> <div class="paragraph"> <p>Αποθηκεύστε και επαναφορτώστε τη διαμόρφωση:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">source ~/.zshrc</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_έλεγχος">έλεγχος</h3> <div class="paragraph"> <p>Ξεκινήστε την Kitty και επαλθεύστε ότι η προτροπή έχει αλλάξει σωστά. Μπορείτε να επιβεβαιώσετε ότι το Oh My Zsh είναι ενεργό εκτελώντας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">echo $ZSH</code></pre> </div> </div> <div class="paragraph"> <p>Το αποτέλεσμα πρέπει να είναι παρόμοιο με :</p> </div> <div class="paragraph"> <p>/home/σου_χρήστη/.oh-my-zsh</p> </div> </div> <div class="sect2"> <h3 id="_διάγραμμα_use_case">Διάγραμμα use case</h3> <div class="imageblock"> <div class="content"> <img src="./images/ohmyzsh-installation.png" alt="ohmyzsh installation" width="579" height="480"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ενεργοποίηση_της_διαφάνειας_στο_kitty">Ενεργοποίηση της διαφάνειας στο Kitty</h2> <div class="sectionbody"> <div class="paragraph"> <p>Μια από τις πιο αγαπημένες λειτουργίες του Kitty είναι η δυνατότητα προσθήκης <strong>διαφανείας</strong> στο φόντο του τερματικού. Αυτό επιτρέπει να βλέπετε ελαφρώς το υποκείμενο περιβάλλον (παράθυρο, επιφάνεια εργασίας κλπ.), κάτι που είναι ιδιαίτερα χρήσιμο στην πολυεργασία.</p> </div> <div class="sect2"> <h3 id="_προαπαιτούμενα_για_τη_διαφάνεια">Προαπαιτούμενα για τη διαφάνεια</h3> <div class="paragraph"> <p>Η διαφάνεια στη Kitty βασίζεται στο<strong>συντάκτης παραθύρων</strong>Χρησιμοποιείται από το γραφικό περιβάλλον. Στο Xubuntu (βάσει του XFCE), βεβαιωθείτε ότι τη<strong>Η σύνθεση είναι ενεργοποιημένη</strong>.</p> </div> <div class="ulist"> <div class="title">Για έλεγχο :</div> <ul> <li> <p>δεξί κλικ στο επιφάνεια εργασίας > Ρυθμίσεις ><strong>�Ρυθμίσεις διαχειριστή παραθύρων</strong>,</p> </li> <li> <p>καρτέλα<strong>Συνθέτης</strong>: το πλαίσιο <strong>"Activer la composition"</strong> πρέπει να είναι επιλεγμένο.</p> </li> </ul> </div> <div class="imageblock"> <div class="content"> <img src="./images/transparency-usecase.png" alt="transparency usecase" width="639" height="229"> </div> </div> </div> <div class="sect2"> <h3 id="_ρύθμιση_της_διαφάνειας_στο_kitty_conf">�Ρύθμιση της διαφάνειας στο kitty.conf</h3> <div class="paragraph"> <p>�Άνοιξτε το αρχείο ρυθμίσεων σας`~/.config/kitty/kitty.conf`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">nano ~/.config/kitty/kitty.conf</code></pre> </div> </div> <div class="paragraph"> <p>Προσθέστε ή τροποποιήστε τις ακόλουθες γραμμές:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-conf hljs" data-lang="conf">background_opacity 0.85</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η παράμετρος αποδέχεται τιμές μεταξύ :</p> </div> <div class="ulist"> <ul> <li> <p><code>1.0</code>→ αδιαφανές (καμία διαφάνεια),</p> </li> <li> <p><code>0.0</code>→ πλήρως διαφανής (αν χρήσιμος),</p> </li> <li> <p>μεταβιβασμένες τιμές όπως`0.90`, <code>0.75</code>, κ.λπ.</p> </li> </ul> </div> <div class="paragraph"> <p>Ένα καλό οπτικό συνθηκό είναι συνήθως μεταξύ`0.85` et <code>0.95</code>.</p> </div> </div> <div class="sect2"> <h3 id="_επανεκκίνηση_kitty">Επανεκκίνηση Kitty</h3> <div class="paragraph"> <p>Κλείστε όλα τα παράθυρα του Kitty, και στη συνέχεια ανοίξτε ένα νέο παράθυρο ώστε οι αλλαγές να ισχύσουν:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">kitty</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_πιθανά_συμπλήρωματα">Πιθανά Συμπλήρωματα</h3> <div class="paragraph"> <p>Εάν χρησιμοποιείτε ένα προσαρμοσμένο φόντο τερματικού, μπορείτε επίσης να ορίσετε ένα χρώμα φόντο με διαφάνεια (σε RGBA):</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-conf hljs" data-lang="conf">background #1e1e2eff</code></pre> </div> </div> <div class="paragraph"> <p>Η τελευταία συστατική (<code>ff</code>) δεικνύει την αδιαφάνεια (του`00` à <code>ff</code>).</p> </div> </div> <div class="sect2"> <h3 id="_διάγραμμα_ακολουθίας_αρχικοποίηση_του_kitty_με_διαφάνεια">Διάγραμμα ακολουθίας - Αρχικοποίηση του Kitty με διαφάνεια</h3> <div class="imageblock"> <div class="content"> <img src="./images/transparency-sequence.png" alt="transparency sequence" width="820" height="422"> </div> </div> </div> <div class="sect2"> <h3 id="_γνωστές_περιορισμοί">Γνωστές περιορισμοί</h3> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <i class="fa icon-warning" title="Warning"></i> </td> <td class="content"> <div class="paragraph"> <p>Η διαφάνεια δεν λειτουργεί αν: - Ο συνθέτης XFCE είναι απενεργοποιημένος, - χρησιμοποιείται μια ασυμβέβλητη διαχείριση παραθύρων, - Χρησιμοποιείτε το Kitty σε λειτουργία <strong>tmux</strong> στο παρασκήνιο χωρίς υποστήριξη διαφάνειας.</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_απενεργοποίηση_του_ακουστικού_bip_ακουστικό_σήμα">Απενεργοποίηση του ακουστικού bip (ακουστικό σήμα)</h2> <div class="sectionbody"> <div class="paragraph"> <p>Από προεπιλογή, Kitty εκπέμπει έναν ήχο <strong>bip</strong> όταν εισάγεται μια λανθασμένη εντολή ή όταν ένα συμβάν τερματικού το ενεργοποιεί. Dieser θόρυμπος μπορεί γρήγορα να γίνει ενοχλητικός, ειδικά σε ένα περιβάλλον εντατικής ανάπτυξης.</p> </div> <div class="paragraph"> <p>Για να απενεργοποιήσετε αυτή τη συμπεριφορά, προσθέστε την ακόλουθη οδηγία στο αρχείο`~/.config/kitty/kitty.conf`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-conf hljs" data-lang="conf">audible_bell no</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>Μπορείτε επίσης να ενεργοποιήσετε μια <strong>οπτική ανατροφοδότης</strong> αντί του ήχου биπ με :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-conf hljs" data-lang="conf">visual_bell yes</code></pre> </div> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_ενημέρωση_της_kitty">Ενημέρωση της Kitty</h2> <div class="sectionbody"> <div class="paragraph"> <p>Επειδή το Kitty εγκαθίσταται μέσω σεναρίου και όχι ενός διαχειριστή πακέτων, η ενημέρωση γίνεται εκτελώντας ξανά το επίσημο σενάριο εγκατάστασης. Αυτό επιτρέπει τη λήψη της τελευταίας έκδοσης και την ενημέρωση της υπάρχουσας εγκατάστασης σας στο`~/.local/kitty.app`.</p> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>Το επίθημα`.app`στο δρόμο`~/.local/kitty.app`Είναι η σύμβαση εγκατάστασης του Kitty στο Linux μέσω του επίσημου του script, και δεν υποδεικνύει καμία αποκλειστική συμβατότητα με το macOS.</p> </div> </td> </tr> </table> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="Important"></i> </td> <td class="content"> <div class="paragraph"> <p>Πριν εκτελέσετε την εντολή ενημέρωσης, βεβαιωθείτε ότι βρίσκεστε στον προσωπικό σας φάκελο (<code>~</code>).</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p>Εκτελέστε την ακόλουθη εντολή από τον προσωπικό σας κατάλογο :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -L https://sw.kovidgoyal.net/kitty/installer.sh | sh /dev/stdin</code></pre> </div> </div> <div class="paragraph"> <p>Αυτό το σενάριο θα ασχοληθεί με:</p> </div> <div class="ulist"> <ul> <li> <p>Κατεβάστε τα δυαδικά της νέας έκδοσης.</p> </li> <li> <p>Αποσυμπίεσέ τα αρχεία σε`~/.local/kitty.app`.</p> </li> <li> <p>Ενημερώστε τους συμβολικούς συνδέσμους αν χρειάζεται.</p> </li> </ul> </div> <div class="paragraph"> <p>Μετά την ενημέρωση, συνιστάται να κλείσετε όλες τις occurrences του Kitty και να τα επανεκκινήσετε για να βεβαιωθείτε ότι η νέα έκδοση λαμβάνεται σωστά.</p> </div> </div> </div> <div class="sect1"> <h2 id="_αναφορές">Αναφορές</h2> <div class="sectionbody"> <div class="paragraph"> <p>Εάν θέλετε να βαθύνετε την προσαρμογή, ανατρέξτε στην επίσημη τεκμηρίωση:</p> </div> <div class="ulist"> <ul> <li> <p>Kitty : <a href="https://sw.kovidgoyal.net/kitty/" class="bare">https://sw.kovidgoyal.net/kitty/</a></p> </li> <li> <p><a href="https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.background_opacity" class="bare">https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.background_opacity</a></p> </li> <li> <p><a href="https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.audible_bell" class="bare">https://sw.kovidgoyal.net/kitty/conf/#opt-kitty.audible_bell</a></p> </li> <li> <p>Zsh : <a href="https://zsh.sourceforge.io/" class="bare">https://zsh.sourceforge.io/</a></p> </li> <li> <p>Github: <a href="https://github.com/kovidgoyal/kitty" class="bare">https://github.com/kovidgoyal/kitty</a></p> </li> <li> <p>Zsh: <a href="https://zsh.sourceforge.io/" class="bare">https://zsh.sourceforge.io/</a></p> </li> <li> <p><a href="https://ohmyz.sh/" class="bare">https://ohmyz.sh/</a></p> </li> <li> <p><a href="https://github.com/ohmyzsh/ohmyzsh/wiki" class="bare">https://github.com/ohmyzsh/ohmyzsh/wiki</a></p> </li> <li> <p><a href="https://docs.xfce.org/xfce/xfwm4/compositor" class="bare">https://docs.xfce.org/xfce/xfwm4/compositor</a></p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Έχετε τώρα:</p> </div> <div class="ulist"> <ul> <li> <p>ένα σύγχρονο και αποδοτικό τερματικό (Kitty)</p> </li> <li> <p>ένας ισχυρός και προσαρμόσιμος shell (Zsh)</p> </li> <li> <p>μιας καθαρής και ανεξάρτητης από τα πακέτα του συστήματος διαμόρφωσης</p> </li> <li> <p>μιας αισθητικής και λειτουργικής τερματικού εξοπλισμένου με το Oh My Zsh</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2026/0101_jbake_portfolio_post.html Thu, 15 Jan 2026 00:00:00 +0000 blog/2026/0101_jbake_portfolio_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_αρχιτεκτονική_όραση">Αρχιτεκτονική όραση</a> <ul class="sectlevel2"> <li><a href="#_οδηγίαρχός_wait_check_best_translation_principle_director_used_often_as_καιρός_lets_think_principe_directeur_in_lawmanagement_is_guiding_principle_usually_greek_phrase_οδηγίαρχος_not_common_id_choose_καθοδηγητική_αρχή_that_seems_accurate">Οδηγίαρχός? Wait check best translation: "Principle director" used often as "καιρός"? Let’s think: "principe directeur" in law/management is "guiding principle". Usually Greek phrase: "οδηγίαρχος?" Not common. I’d choose "καθοδηγητική αρχή". That seems accurate.</a></li> <li><a href="#_στρατηγική_επιλογή_asciidoc_για_το_πορτφόλιο">Στρατηγική επιλογή : AsciiDoc για το πορτφόλιο</a></li> <li><a href="#_μοντέλο_δεδομένων">Μοντέλο δεδομένων</a></li> </ul> </li> <li><a href="#_λεπτομερείς_περιπτώσεις_χρήσης">Λεπτομερείς περιπτώσεις χρήσης</a> <ul class="sectlevel2"> <li><a href="#_uc1_προσθέστε_ένα_στοιχείο_στο_πορτοφολιο">UC1 : Προσθέστε ένα στοιχείο στο πορτοφολιο</a> <ul class="sectlevel3"> <li><a href="#_ονομαστική_ροή">ονομαστική ροή</a></li> <li><a href="#_πρότυπο_αρχείου_που_θα_δημιουργηθεί">Πρότυπο αρχείου που θα δημιουργηθεί</a></li> <li><a href="#_σημεία_επικύρωσης">Σημεία επικύρωσης</a></li> </ul> </li> <li><a href="#_uc2_διαγραφή_ενός_στοιχείου_από_το_πορτοφολιού">UC2 : Διαγραφή ενός στοιχείου από το πορτοφολιού</a> <ul class="sectlevel3"> <li><a href="#_ονομαστική_ροή_2">Ονομαστική ροή</a></li> <li><a href="#_εναλλακτική_στρατηγική_αρχειοθέτηση">Εναλλακτική στρατηγική : αρχειοθέτηση</a></li> <li><a href="#_καθαρισμός_των_πόρων">Καθαρισμός των πόρων</a></li> </ul> </li> <li><a href="#_uc3_ορισμός_ως_μη_δημοσιευμένο_draft">UC3 : Ορισμός ως μη δημοσιευμένο (draft)</a> <ul class="sectlevel3"> <li><a href="#_ονομαστική_ροή_3">ονομαστική ροή</a></li> <li><a href="#_πιθανές_καταστάσεις">Πιθανές καταστάσεις</a></li> <li><a href="#_τυπικές_περιπτώσεις_χρήσης">Τυπικές περιπτώσεις χρήσης</a></li> </ul> </li> </ul> </li> <li><a href="#_αρχιτεκτονική_templating">Αρχιτεκτονική Templating</a> <ul class="sectlevel2"> <li><a href="#_στρατηγία_ανχυρῶν_προτύπων">Στρατηγία ανχυρῶν προτύπων</a></li> <li><a href="#_πρότυπο_εξαγωγής_δεδομένων">Πρότυπο εξαγωγής δεδομένων</a></li> <li><a href="#_συμβάσεις_ονοματοδότησης">Συμβάσεις ονοματοδότησης</a></li> </ul> </li> <li><a href="#_ροή_εργασίας_δημοσίευσης">�Ροή εργασίας δημοσίευσης</a> <ul class="sectlevel2"> <li><a href="#_δρομός_ανάπτυξης">Δρομός ανάπτυξης</a></li> <li><a href="#_περιβάλλοντα">Περιβάλλοντα</a></li> </ul> </li> <li><a href="#_εκτασιμότητα">εκτασιμότητα</a> <ul class="sectlevel2"> <li><a href="#_προσθήκη_νέων_χαρακτηριστικών">Προσθήκη νέων χαρακτηριστικών</a></li> <li><a href="#_προηγμένη_κατηγοριοποίηση">Προηγμένη κατηγοριοποίηση</a></li> </ul> </li> <li><a href="#_καλές_πρακτικές">Καλές Πρακτικές</a> <ul class="sectlevel2"> <li><a href="#_οργάνωση_των_αρχείων">Οργάνωση των αρχείων</a></li> <li><a href="#_διαχείριση_περιεχομένου">Διαχείριση περιεχομένου</a></li> <li><a href="#_απόδοση">Απόδοση</a></li> </ul> </li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div class="sect1"> <h2 id="_αρχιτεκτονική_όραση">Αρχιτεκτονική όραση</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_οδηγίαρχός_wait_check_best_translation_principle_director_used_often_as_καιρός_lets_think_principe_directeur_in_lawmanagement_is_guiding_principle_usually_greek_phrase_οδηγίαρχος_not_common_id_choose_καθοδηγητική_αρχή_that_seems_accurate">Οδηγίαρχός? Wait check best translation: "Principle director" used often as "καιρός"? Let’s think: "principe directeur" in law/management is "guiding principle". Usually Greek phrase: "οδηγίαρχος?" Not common. I’d choose "καθοδηγητική αρχή". That seems accurate.</h3> <div class="paragraph"> <p>Thus output exactly: καθοδηγητική αρχή</p> </div> <div class="paragraph"> <p>No extra spaces at ends.</p> </div> <div class="paragraph"> <p>Proceed.</p> </div> <div class="paragraph"> <p></think></p> </div> <div class="paragraph"> <p>καθοδηγητική αρχή</p> </div> <div class="paragraph"> <p>Η αρχιτεκτονική βασίζεται στο αρχέγονο του <strong>διαχωρισμού των ανησυχιών</strong> :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Περιεχόμενο</strong> : οργανωμένα αρχεία AsciiDoc με πλούσια μεταδεδομένα</p> </li> <li> <p><strong>Παρουσίαση</strong> : πρότυπα Thymeleaf επαναχρησιμοποιήσιμα</p> </li> <li> <p><strong>Δεδομένα</strong> : μοντέλο εξαγόμενο αυτόματα από το JBake από τα χαρακτηριστικά AsciiDoc</p> </li> <li> <p><strong>Στυλ</strong> : Bootstrap 5 για τη οπτική συνέπεια</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_στρατηγική_επιλογή_asciidoc_για_το_πορτφόλιο">Στρατηγική επιλογή : AsciiDoc για το πορτφόλιο</h3> <table class="tableblock frame-all grid-all stretch"> <caption class="title">Table 1. Γιατί AsciiDoc;</caption> <colgroup> <col style="width: 33.3333%;"> <col style="width: 66.6667%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">Κριτήριο</th> <th class="tableblock halign-left valign-top">Πλεονέκτημα</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Συμφωνία</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�Ίδιος μορφος όπως τα άρθρα του blog</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Μεταδεδομένα</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Δομημένα και επεκτάσιμα χαρακτηριστικά (<code>project-*</code>)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">συντήρησις</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Απλή επεξεργασία κειμένου, εκδόσιμη με Git</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">ευελιξία</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Μπορεί να περιέχει πλούσιο περιεχόμενο (πίνακες, κώδικας, εικόνες)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Πρότυπο</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">JBake εξάγει αυτόματα τα χαρακτηριστικά για το Thymeleaf</p></td> </tr> </tbody> </table> </div> <div class="sect2"> <h3 id="_μοντέλο_δεδομένων">Μοντέλο δεδομένων</h3> <div class="paragraph"> <p>Κάθε portfolio project είναι ένα έγγραφο AsciiDoc με:</p> </div> <div class="ulist"> <ul> <li> <p><strong>Μεταδεδομένα κεφαλίδας</strong> : δομημένες πληροφορίες (πελάτης, διάρκεια, τεχνολογίες κ.λπ.)</p> </li> <li> <p><strong>Σώμα του εγγράφου</strong> : περιγραφή αφηγηματική, προκλήσεις, λύσεις, αποτελέσματα</p> </li> <li> <p><strong>Προσαρμοσμένα χαρακτηριστικά</strong> : προθεσμένα`project-*`για αυτόματη εξαγωγή</p> </li> </ul> </div> <div class="imageblock"> <div class="content"> <img src="./images/diag-plantuml-md5-88a17f65448870c248086512243b97df.png" alt="Diagram" width="386" height="811"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_λεπτομερείς_περιπτώσεις_χρήσης">Λεπτομερείς περιπτώσεις χρήσης</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_uc1_προσθέστε_ένα_στοιχείο_στο_πορτοφολιο">UC1 : Προσθέστε ένα στοιχείο στο πορτοφολιο</h3> <div class="sect3"> <h4 id="_ονομαστική_ροή">ονομαστική ροή</h4> <div class="listingblock"> <div class="content"> <pre>Failed to generate image: PlantUML preprocessing failed: [From <input> (line 4) ] @startuml skinparam backgroundColor #FEFEFE actor Développeur as dev participant "Επεξεργαστής ^^^^^ Syntax Error? (Assumed diagram type: sequence) @startuml skinparam backgroundColor #FEFEFE actor Développeur as dev participant "Επεξεργαστής Κείμενο" as editor participant "Αρχείο AsciiDoc" as file participant "JBake\nΜηχανή" as jbake participant "ιστότοπος στατικός" as site dev -> editor : Créer nouveau fichier activate editor editor -> file : portfolio/nouveau-projet.adoc activate file dev -> editor : Rédiger en-tête avec métadonnées\n(titre, type=project, status=published,\nattributs project-*) dev -> editor : Rédiger contenu narratif\n(contexte, défis, solutions) dev -> editor : Ajouter images dans assets/img/portfolio/ editor -> file : Sauvegarder deactivate editor dev -> jbake : Lancer build (jbake -b) activate jbake jbake -> file : Lire et parser jbake -> jbake : Extraire métadonnées jbake -> jbake : Convertir AsciiDoc → HTML jbake -> jbake : Appliquer template project.html jbake -> jbake : Ajouter à la liste portfolio.html jbake -> site : Générer pages statiques deactivate jbake dev -> site : Vérifier résultat activate site site --> dev : Afficher projet deactivate site @enduml</pre> </div> </div> </div> <div class="sect3"> <h4 id="_πρότυπο_αρχείου_που_θα_δημιουργηθεί">Πρότυπο αρχείου που θα δημιουργηθεί</h4> <div class="paragraph"> <p>Ο προγραμματιστής δημιουργεί`content/portfolio/nom-projet.adoc`με μια προτυποποιημένη δομή :</p> </div> <div class="ulist"> <ul> <li> <p>Κεφαλίδα με όλα τα απαιτούμενα χαρακτηριστικά</p> </li> <li> <p>Τυποποιημένες ενότητες (Περιβάλλον, Προκλήσεις, Λύσεις, Αποτελέσματα)</p> </li> <li> <p>Συνεπής ονομασία των εικόνων</p> </li> </ul> </div> </div> <div class="sect3"> <h4 id="_σημεία_επικύρωσης">Σημεία επικύρωσης</h4> <div class="ulist"> <ul> <li> <p>Τα υποχρεωτικά χαρακτηριστικά υπάρχουν (<code>jbake-type</code>, <code>jbake-status</code>, <code>project-thumbnail</code>)</p> </li> <li> <p>Οι αναφερόμενες εικόνες υπάρχουν σε`assets/img/portfolio/`</p> </li> <li> <p>Η JBake build ολοκληρώνεται χωρίς σφάλματα.</p> </li> <li> <p>Το project εμφανίζεται στη σελίδα του portfolio.</p> </li> <li> <p>Η ατομική σελίδα του έργου εμφανίζεται σωστά</p> </li> </ul> </div> </div> </div> <div class="sect2"> <h3 id="_uc2_διαγραφή_ενός_στοιχείου_από_το_πορτοφολιού">UC2 : Διαγραφή ενός στοιχείου από το πορτοφολιού</h3> <div class="sect3"> <h4 id="_ονομαστική_ροή_2">Ονομαστική ροή</h4> <div class="listingblock"> <div class="content"> <pre>Failed to generate image: PlantUML preprocessing failed: [From <input> (line 4) ] @startuml skinparam backgroundColor #FEFEFE actor Développeur as dev participant "Σύστημα ^^^^^ Syntax Error? (Assumed diagram type: sequence) @startuml skinparam backgroundColor #FEFEFE actor Développeur as dev participant "Σύστημα Αρχεία" as fs participant "JBake\nΜηχανή" as jbake participant "Ιστότοπος στατικό" as site database "Κατάκεντρο\nJBake" as cache dev -> fs : Supprimer portfolio/projet-ancien.adoc activate fs fs --> dev : Fichier supprimé deactivate fs dev -> fs : (Optionnel) Supprimer images associées\nassets/img/portfolio/projet-ancien-* activate fs fs --> dev : Images supprimées deactivate fs dev -> cache : Nettoyer cache JBake activate cache cache --> dev : Cache vidé deactivate cache dev -> jbake : Rebuild complet (jbake -b) activate jbake jbake -> jbake : Scanner content/portfolio/ jbake -> jbake : Projet absent → non généré jbake -> jbake : Régénérer portfolio.html\n(sans le projet supprimé) jbake -> site : Déployer nouveau build deactivate jbake dev -> site : Vérifier activate site site --> dev : Projet absent de la liste deactivate site @enduml</pre> </div> </div> </div> <div class="sect3"> <h4 id="_εναλλακτική_στρατηγική_αρχειοθέτηση">Εναλλακτική στρατηγική : αρχειοθέτηση</h4> <div class="paragraph"> <p>Αντί να διαγράψετε οριστικά, υπάρχει η δυνατότητα να δημιουργήσετε ένα φάκελο`content/portfolio/archive/`:</p> </div> <div class="ulist"> <ul> <li> <p>Μετακίνησε το αρχείο αντί να το διαγράψεις</p> </li> <li> <p>Επιτρέπει εύκολη αποκατάσταση</p> </li> <li> <p>Κράτε το ιστορικό του Git πιο καθαρό</p> </li> </ul> </div> </div> <div class="sect3"> <h4 id="_καθαρισμός_των_πόρων">Καθαρισμός των πόρων</h4> <div class="ulist"> <ul> <li> <p>Ελέγξτε τις ορφανές εικόνες σε`assets/img/portfolio/`</p> </li> <li> <p>Διαγραφή εικόνων που δεν αναφέρονται από άλλα έργα</p> </li> <li> <p>Καθαρίστε το cache του JBake για να αποφύγετε τις ανεμφανείς αναφορές</p> </li> </ul> </div> </div> </div> <div class="sect2"> <h3 id="_uc3_ορισμός_ως_μη_δημοσιευμένο_draft">UC3 : Ορισμός ως μη δημοσιευμένο (draft)</h3> <div class="sect3"> <h4 id="_ονομαστική_ροή_3">ονομαστική ροή</h4> <div class="imageblock"> <div class="content"> <img src="./images/diag-plantuml-md5-b58420e792af10df3ec8c0485e0f53fb.png" alt="Diagram" width="783" height="594"> </div> </div> </div> <div class="sect3"> <h4 id="_πιθανές_καταστάσεις">Πιθανές καταστάσεις</h4> <div class="imageblock"> <div class="content"> <img src="./images/diag-plantuml-md5-a4b71e9dbf30083d131223257db47469.png" alt="Diagram" width="556" height="448"> </div> </div> </div> <div class="sect3"> <h4 id="_τυπικές_περιπτώσεις_χρήσης">Τυπικές περιπτώσεις χρήσης</h4> <div class="ulist"> <ul> <li> <p><strong>Έργο υπό επεξεργασία</strong> : Δημιουργία σε προχειρό, δημοσίευση όταν είναι έτοιμο</p> </li> <li> <p><strong>Προσωρινά μυστικό έργο</strong> : να περάσετε σε πρόχειρο για τη διάρκεια της σύμφωνης με τον πελάτη</p> </li> <li> <p><strong>Μεγάλη ενημέρωση</strong> : να μεταβείτε σε σχέδιο, να τροποποιήσετε, να δημοσιεύσετε ξανά</p> </li> <li> <p><strong>A/B testing</strong> : απλώνεται σε σχέδιο, δοκιμάζεται, δημοσίευση της καλύτερας έκδοσης</p> </li> </ul> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αρχιτεκτονική_templating">Αρχιτεκτονική Templating</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_στρατηγία_ανχυρῶν_προτύπων">Στρατηγία ανχυρῶν προτύπων</h3> <div class="imageblock"> <div class="content"> <img src="./images/diag-plantuml-md5-64f5107236c658090376a9f85fada299.png" alt="Diagram" width="881" height="350"> </div> </div> </div> <div class="sect2"> <h3 id="_πρότυπο_εξαγωγής_δεδομένων">Πρότυπο εξαγωγής δεδομένων</h3> <div class="paragraph"> <p>JBake μετατρέπει αυτόματα τα χαρακτηριστικά AsciiDoc σε ιδιότητες προσβάσιμες στο Thymeleaf :</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/diag-plantuml-md5-0536db8cf2214f70522e62cf7f0ded00.png" alt="Diagram" width="919" height="353"> </div> </div> </div> <div class="sect2"> <h3 id="_συμβάσεις_ονοματοδότησης">Συμβάσεις ονοματοδότησης</h3> <div class="ulist"> <ul> <li> <p><strong>Ιδιότητες έργου</strong> : πρόθεμα`project-*` (ex: <code>project-client</code>, <code>project-tech-stack</code>)</p> </li> <li> <p><strong>Αρχεία</strong> : kebab-case (π.χ.<code>ecommerce-platform.adoc</code>)</p> </li> <li> <p><strong>Images</strong> : πρόθημα όνομα-έργου (π.χ:`ecommerce-platform-thumb.jpg`)</p> </li> <li> <p><strong>Πρότυπα</strong> : λειτουργικό όνομα (ex:`project-card.html`, <code>tech-badge.html</code>)</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ροή_εργασίας_δημοσίευσης">�Ροή εργασίας δημοσίευσης</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_δρομός_ανάπτυξης">Δρομός ανάπτυξης</h3> <div class="imageblock"> <div class="content"> <img src="./images/diag-plantuml-md5-64273d2fc4d2575f29d9708f2bdcea0a.png" alt="Diagram" width="386" height="811"> </div> </div> </div> <div class="sect2"> <h3 id="_περιβάλλοντα">Περιβάλλοντα</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 20%;"> <col style="width: 40%;"> <col style="width: 40%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">Περιβάλλον</th> <th class="tableblock halign-left valign-top">Χρήση</th> <th class="tableblock halign-left valign-top">Κατάσταση αποδεκτή</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Τοπικός</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ανάπτυξη και προεπισκόπηση</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">πρόχειρο, δημοσιευμένο</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">παρασκευή</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Επικύρωση προπαραγωγής</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">δημοσιεύτηκε μόνο</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Παραγωγή</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Δημόσιος ιστότοπος</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">μόνο δημοσιευμένο</p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_εκτασιμότητα">εκτασιμότητα</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_προσθήκη_νέων_χαρακτηριστικών">Προσθήκη νέων χαρακτηριστικών</h3> <div class="paragraph"> <p>Για να πλουσιεύσετε το μοντέλο δεδομένων, απλώς προσθέστε νέα χαρακτηριστικά με πρόθεμα`project-*`:</p> </div> <div class="ulist"> <ul> <li> <p><code>project-awards</code>: Βραβεία και αναγνωρίσματα</p> </li> <li> <p><code>project-testimonial</code>: πρόταση πελάτη</p> </li> <li> <p>`project-team-size`Μέγεθος ομάδας</p> </li> <li> <p>`project-budget-range`Εύρος προϋπολογισμού</p> </li> </ul> </div> <div class="paragraph"> <p>Αυτοί οι χαρακτηριστικοί γίνονται αυτόματα διαθέσιμοι στα πρότυπα χωρίς τροποποίηση του μηχανισμού JBake.</p> </div> </div> <div class="sect2"> <h3 id="_προηγμένη_κατηγοριοποίηση">Προηγμένη κατηγοριοποίηση</h3> <div class="imageblock"> <div class="content"> <img src="./images/diag-plantuml-md5-43709ce3814e04b97b6bb1d975393ea7.png" alt="Diagram" width="575" height="259"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_καλές_πρακτικές">Καλές Πρακτικές</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_οργάνωση_των_αρχείων">Οργάνωση των αρχείων</h3> <div class="ulist"> <ul> <li> <p><strong>Ένα αρχείο = ένα έργο</strong> : αποφύγετε το να ανακατέψετε πολλά έργα</p> </li> <li> <p><strong>Εικόνες σε αfiερωμένο φάκελο</strong><code>assets/img/portfolio/nom-projet/</code></p> </li> <li> <p><strong>Συνεπής ορολογία</strong> : διευκολύνει την αναζήτηση και τη συντήρηση</p> </li> <li> <p><strong>Versioning Git</strong> : πλήρης παρακολούθηση των αλλαγών</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_διαχείριση_περιεχομένου">Διαχείριση περιεχομένου</h3> <div class="ulist"> <ul> <li> <p><strong>Προεπιλεγμένη κατάσταση προτύπου</strong> : να δημοσιεύεται μόνο όταν είναι έτοιμο</p> </li> <li> <p><strong>Επιθεώρηση πριν τη δημοσίευση</strong> : επικύρωση ποιότητας και μυστικότητας</p> </li> <li> <p><strong>Πλήρη μεταδεδομένα</strong> : Συμπληρώστε όλα τα σχετικά πεδία</p> </li> <li> <p><strong>Πλούσιο διηγηματικό περιεχόμενο</strong> : μην περιορίζεστε στα μεταδεδομένα</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_απόδοση">Απόδοση</h3> <div class="ulist"> <ul> <li> <p><strong>Βελτιστοποίηση εικόνων</strong> : συμπίεση πριν το commit</p> </li> <li> <p><strong>Σελιδοποίηση αν χρειάζεται</strong> : αν >20 έργα</p> </li> <li> <p><strong>Φόρτωση καθυστέρευσης</strong> : εικόνες των γκαλερίων φορτίζονται όταν απαιτούνται</p> </li> <li> <p><strong>Πρόσκαιρο περιηγητή</strong> : αποδεκτό headers για τα assets</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτή η αρχιτεκτονική επιτρέπει:</p> </div> <div class="ulist"> <ul> <li> <p><strong>Ευκολία χρήσης</strong> : προσθέστε ένα έργο = δημιουργήστε ένα αρχείο κειμένου</p> </li> <li> <p><strong>Ευελιξία</strong> : εκτάσιμος μέσω νέων χαρακτηριστικών</p> </li> <li> <p><strong>Συντήρησις</strong> : διαχωρισμός περιεχομένου/παρουσίασης</p> </li> <li> <p><strong>Παρακολούθηση</strong> : πλήρες versioning Git</p> </li> <li> <p><strong>Αυτοματοποίηση</strong> : build και συνεχείς ανάπτυξες εφικτές</p> </li> </ul> </div> <div class="paragraph"> <p>Η επιλογή του AsciiDoc ασφαλίζει τη συνέπεια με το υπόλοιπο του ιστοτοπίου, προσφέροντας τον πλούτο των απαραίτητων μεταδεδομένων για ένα επαγγελματικό portfolio.</p> </div> </div> </div> https://cheroliv.com/blog/2025/0097_gradle_plugin_dev_func_test_logger_post.html Fri, 7 Nov 2025 00:00:00 +0000 blog/2025/0097_gradle_plugin_dev_func_test_logger_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_το_πρόβλημα_εξάρτηση_στον_gradlerunner">Το πρόβλημα : εξάρτηση στον GradleRunner</a> <ul class="sectlevel2"> <li><a href="#_περιβάλλον_ανάπτυξης_plugin">Περιβάλλον ανάπτυξης plugin</a></li> <li><a href="#_το_διλήμμα_της_καταγραφής">Το διλήμμα της καταγραφής</a></li> <li><a href="#_οι_ψευδείς_καλές_ιδέες">Οι Ψευδείς Καλές Ιδέες</a></li> </ul> </li> <li><a href="#_η_λύση_logger_ανεξάρτητος">Η Λύση : Logger Ανεξάρτητος</a> <ul class="sectlevel2"> <li><a href="#_αρχιτεκτονική_συνιστώμενη">αρχιτεκτονική συνιστώμενη</a></li> <li><a href="#_ροή_εκτέλεσης">Ροή εκτέλεσης</a></li> </ul> </li> <li><a href="#_πλήρης_υλοποίηση">Πλήρης Υλοποίηση</a> <ul class="sectlevel2"> <li><a href="#_εξαρτήσεις_gradle">Εξαρτήσεις Gradle</a></li> <li><a href="#_ρύθμιση_logback">�Ρύθμιση Logback</a></li> <li><a href="#_πλήρης_κλάση_δοκιμών">Πλήρης Κλάση δοκιμών</a></li> </ul> </li> <li><a href="#_σχήμα_πολυεπιπέδων_λογογράφησης">Σχήμα Πολυεπιπέδων Λογογράφησης</a></li> <li><a href="#_καλές_πρακτικές">Καλές πρακτικές</a> <ul class="sectlevel2"> <li><a href="#_δομή_καταγραφής_προτεινόμενη">Δομή καταγραφής προτεινόμενη</a></li> <li><a href="#_οπτικά_σύμβολα_για_ευανάγνωστη_ανάγνωση">Οπτικά σύμβολα για ευανάγνωστη ανάγνωση</a></li> <li><a href="#_εξαγωγή_πληροφοριών_από_την_έξοδο">Εξαγωγή Πληροφοριών από την Έξοδο</a></li> </ul> </li> <li><a href="#_σύγκριση_πρινμετά">Σύγκριση Πριν/Μετά</a> <ul class="sectlevel2"> <li><a href="#_πριν_προβληματική_προσέγγιση">Πριν: Προβληματική προσέγγιση</a></li> <li><a href="#_μετά_ανθεκτική_προσέγγιση">Μετά : Ανθεκτική προσέγγιση</a></li> </ul> </li> <li><a href="#_διάγραμμα_συνοπτικό">Διάγραμμα Συνοπτικό</a></li> <li><a href="#_παγίδες_που_πρέπει_να_αποφύγετε">Παγίδες που πρέπει να αποφύγετε</a> <ul class="sectlevel2"> <li><a href="#_παγίδα_1_να_ξεχάσετε_το_forwardoutput">�❌ Παγίδα #1: Να ξεχάσετε το `.forwardOutput()</a></li> <li><a href="#_πίεγμα_n2_μη_αρχικοποιημένος_logger">❌ Πίεγμα n°2 : Μη αρχικοποιημένος Logger</a></li> <li><a href="#_παγίδα_3_υπerezό_καταγραφή">❌ Παγίδα №3: Υπerezό Καταγραφή</a></li> </ul> </li> <li><a href="#_αποτελέσματα_και_μετρικές">Αποτελέσματα και Μετρικές</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> <li><a href="#_πόροι">Πόροι</a></li> <li><a href="#_πήγαινε_περαιτέρω">Πήγαινε περαιτέρω</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <p>Κατά τη δημιουργία ενός plugin Gradle, οι λειτουργικοί τεστ είναι ζωτικής σημασίας για την επικύρωση της συμπεριφοράς του plugin σε ένα πραγματικό περιβάλλον Gradle. Ωστόσο, μια κρίσιμη ερώτηση προκύπτει γρήγορα:<strong>πώς να ρυθμίσουμε ένα αποτελεσματικό σύστημα καταγραφής χωρίς να δημιουργούμε προβληματικές εξαρτήσεις με το <code>GradleRunner</code> ?</strong></p> </div> <div class="paragraph"> <p>Σε αυτό το άρθρο, θα εξερευνήσουμε :</p> </div> <div class="ulist"> <ul> <li> <p>Το ζήτημα του καταγραφής στα λειτουργικά τεστ Gradle</p> </li> <li> <p>Η αρχιτεκτονικής μιας ισχυράς λύσης με το SLF4J και το Logback</p> </li> <li> <p>Η πλήρης υλοποίηση με συγκεκριμένα παραδείγματα</p> </li> <li> <p>Καλές πρακτικές και παγίδες προς αποφυγή</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_το_πρόβλημα_εξάρτηση_στον_gradlerunner">Το πρόβλημα : εξάρτηση στον GradleRunner</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_περιβάλλον_ανάπτυξης_plugin">Περιβάλλον ανάπτυξης plugin</h3> <div class="paragraph"> <p>�Όταν αναπτύσσουμε ένα plugin Gradle, χρησιμοποιούμε συνήθως το`GradleRunner`με το <em>Gradle TestKit</em> για να εκτελέσει δοκιμαστικές δημιουργίες :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `test my plugin`() { val result = GradleRunner.create() .withProjectDir(projectDir) .withArguments("myTask") .build() // Comment logger efficacement ici ? }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_το_διλήμμα_της_καταγραφής">Το διλήμμα της καταγραφής</h3> <div class="paragraph"> <p>Το κύριο πρόβλημα είναι το εξής:<strong>Η καταγραφή δεν πρέπει να εξαρτάται από ένα αντικείμενο του οποίου δεν είμαστε σίγουροι για την αρχικοποίηση του</strong>.</p> </div> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-ad077308fd219961c35c6d1f31f8a385.png" alt="Diagram" width="475" height="262"> </div> </div> </div> <div class="sect2"> <h3 id="_οι_ψευδείς_καλές_ιδέες">Οι Ψευδείς Καλές Ιδέες</h3> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <i class="fa icon-warning" title="Warning"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>Μην κάνετε αυτό :</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// ❌ MAUVAIS: Tentative d'obtenir un logger du runner val runner = GradleRunner.create() val logger = runner.logger // N'existe pas ! // ❌ MAUVAIS: Logger partagé initialisé tardivement lateinit var logger: Logger @BeforeEach fun setup() { logger = LoggerFactory.getLogger(...) }</code></pre> </div> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_η_λύση_logger_ανεξάρτητος">Η Λύση : Logger Ανεξάρτητος</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_αρχιτεκτονική_συνιστώμενη">αρχιτεκτονική συνιστώμενη</h3> <div class="paragraph"> <p>Η λύση είναι η χρήση ενός logger<strong>απολύτως ανεξάρτητος</strong> du <code>GradleRunner</code>, αρχικοποιημένο στο επίπεδο της κλάσης δοκιμών.</p> </div> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-71670e199faf24eb76ae227b0c86e67b.png" alt="Diagram" width="601" height="448"> </div> </div> </div> <div class="sect2"> <h3 id="_ροή_εκτέλεσης">Ροή εκτέλεσης</h3> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-d24254a36086a5158e725c6aa7d74552.png" alt="Diagram" width="785" height="686"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πλήρης_υλοποίηση">Πλήρης Υλοποίηση</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_εξαρτήσεις_gradle">Εξαρτήσεις Gradle</h3> <div class="paragraph"> <p>Προσθέστε τις απαραίτητες εξαρτήσεις στο`build.gradle.kts`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">dependencies { // Pour les tests fonctionnels testImplementation(gradleTestKit()) testImplementation("org.junit.jupiter:junit-jupiter:5.10.2") // Pour le logging testImplementation("org.slf4j:slf4j-api:2.0.17") testRuntimeOnly("ch.qos.logback:logback-classic:1.4.14") // Pour les assertions testImplementation("org.assertj:assertj-core:3.27.6") } tasks.test { useJUnitPlatform() }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ρύθμιση_logback">�Ρύθμιση Logback</h3> <div class="paragraph"> <p>Δημιουργήστε το αρχείο`src/test/resources/logback-test.xml`(empty)</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?> <configuration> <!-- Appender console avec format lisible --> <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender"> <encoder> <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern> </encoder> </appender> <!-- Appender fichier pour conservation --> <appender name="FILE" class="ch.qos.logback.core.FileAppender"> <file>build/test-results/functional-tests.log</file> <encoder> <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{50} - %msg%n</pattern> </encoder> </appender> <!-- Logger pour vos tests --> <logger name="com.cheroliv.bakery" level="DEBUG"/> <!-- Réduire le bruit de Gradle --> <logger name="org.gradle" level="WARN"/> <!-- Configuration racine --> <root level="INFO"> <appender-ref ref="STDOUT"/> <appender-ref ref="FILE"/> </root> </configuration></code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_πλήρης_κλάση_δοκιμών">Πλήρης Κλάση δοκιμών</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">package com.cheroliv.bakery import org.gradle.testkit.runner.GradleRunner import org.gradle.testkit.runner.TaskOutcome import org.junit.jupiter.api.* import org.junit.jupiter.api.TestInstance.Lifecycle.PER_CLASS import org.junit.jupiter.api.io.TempDir import org.slf4j.Logger import org.slf4j.LoggerFactory import java.io.File import kotlin.test.assertEquals import kotlin.test.assertTrue @TestInstance(PER_CLASS) class BakeryPluginFunctionalTest { @field:TempDir lateinit var projectDir: File private val buildFile by lazy { projectDir.resolve("build.gradle.kts") } private val settingsFile by lazy { projectDir.resolve("settings.gradle.kts") } companion object { // ✓ Logger indépendant, initialisé au chargement de la classe private val logger: Logger = LoggerFactory.getLogger( BakeryPluginFunctionalTest::class.java ) @JvmStatic @BeforeAll fun globalSetup() { logger.info("═".repeat(60)) logger.info("DÉMARRAGE DE LA SUITE DE TESTS FONCTIONNELS") logger.info("═".repeat(60)) } @JvmStatic @AfterAll fun globalTeardown() { logger.info("═".repeat(60)) logger.info("FIN DE LA SUITE DE TESTS") logger.info("═".repeat(60)) } } @BeforeEach fun setup() { logger.info("─".repeat(60)) logger.info("Préparation de l'environnement de test") logger.debug("Répertoire de test: ${projectDir.absolutePath}") settingsFile.writeText(""" rootProject.name = "test-bakery-project" """.trimIndent()) logger.debug("✓ settings.gradle.kts créé") } @AfterEach fun teardown(testInfo: TestInfo) { logger.info("✓ Test terminé: ${testInfo.displayName}") logger.info("─".repeat(60)) } @Test fun `plugin can be applied successfully`() { logger.info("TEST: Application du plugin Bakery") buildFile.writeText(""" plugins { id("com.cheroliv.bakery") } """.trimIndent()) logger.debug("Fichier build.gradle.kts créé") logger.debug("Lancement du build Gradle...") val startTime = System.currentTimeMillis() val result = GradleRunner.create() .forwardOutput() // ← Important : capture la sortie .withPluginClasspath() .withArguments("tasks", "--group=bakery", "--stacktrace") .withProjectDir(projectDir) .build() val duration = System.currentTimeMillis() - startTime logger.info("Build terminé en ${duration}ms") // Analyse de la sortie logger.debug("Analyse de la sortie Gradle...") val outputLines = result.output.lines() logger.debug("Nombre de lignes capturées: ${outputLines.size}") // Validation val expectedTasks = listOf("bake", "printConfigPath", "printJBakeClasspath") logger.info("Vérification des tâches attendues:") expectedTasks.forEach { task -> val found = result.output.contains(task) logger.debug(" ${if (found) "✓" else "✗"} $task") assertTrue(found, "Task '$task' should be available") } logger.info("✓ Plugin appliqué avec succès - ${expectedTasks.size} tâches trouvées") } @Test fun `bake task executes and prints version`() { logger.info("TEST: Exécution de la tâche 'bake'") buildFile.writeText(""" plugins { id("com.cheroliv.bakery") } """.trimIndent()) logger.debug("Exécution de 'gradle bake'...") val result = GradleRunner.create() .forwardOutput() .withPluginClasspath() .withArguments("bake", "--info") // --info pour plus de détails .withProjectDir(projectDir) .build() // Extraction d'informations depuis la sortie logger.debug("Recherche du message 'Baking site'...") val hasBakingMessage = result.output.contains("Baking site with Bakery Plugin!") logger.debug("Recherche de la version JBake...") val hasVersionMessage = result.output.contains("Using JBake version:") // Extraction de la version (si présente) val versionRegex = Regex("Using JBake version: (.+)") val versionMatch = versionRegex.find(result.output) if (versionMatch != null) { val version = versionMatch.groupValues[1] logger.info("Version JBake détectée: $version") } // Validation assertTrue(hasBakingMessage, "Message 'Baking site' attendu") assertTrue(hasVersionMessage, "Message de version attendu") assertEquals(TaskOutcome.SUCCESS, result.task(":bake")?.outcome) logger.info("✓ Tâche 'bake' exécutée avec succès") } @Test fun `analyze output with structured logging`() { logger.info("TEST: Analyse structurée de la sortie") buildFile.writeText(""" plugins { id("com.cheroliv.bakery") } task("diagnostics") { doLast { println("[DIAG] Project: ${'$'}{project.name}") println("[DIAG] Build dir: ${'$'}{project.buildDir}") println("[DIAG] Plugin applied: true") val config = configurations.findByName("jbakeRuntime") println("[DIAG] JBake config exists: ${'$'}{config != null}") if (config != null) { println("[DIAG] Dependencies count: ${'$'}{config.dependencies.size}") } } } """.trimIndent()) logger.debug("Exécution de la tâche diagnostics...") val result = GradleRunner.create() .forwardOutput() .withPluginClasspath() .withArguments("diagnostics", "--quiet") .withProjectDir(projectDir) .build() // Analyse structurée logger.info("Extraction des informations de diagnostic:") val diagLines = result.output.lines() .filter { it.startsWith("[DIAG]") } logger.debug("Nombre de lignes de diagnostic: ${diagLines.size}") diagLines.forEach { line -> logger.info(" $line") // Analyse spécifique par type de ligne when { line.contains("Project:") -> { val projectName = line.substringAfter("Project:").trim() logger.debug(" → Nom du projet extrait: '$projectName'") } line.contains("Dependencies count:") -> { val count = line.substringAfter("count:").trim() logger.debug(" → Nombre de dépendances: $count") } } } assertTrue(diagLines.isNotEmpty(), "Des lignes de diagnostic devraient être présentes") logger.info("✓ Analyse structurée terminée - ${diagLines.size} lignes analysées") } @Test fun `test with error handling`() { logger.info("TEST: Gestion d'erreurs avec logging") buildFile.writeText(""" plugins { id("com.cheroliv.bakery") } """.trimIndent()) try { logger.debug("Tentative d'exécution...") val result = GradleRunner.create() .forwardOutput() .withPluginClasspath() .withArguments("printJBakeClasspath") .withProjectDir(projectDir) .build() val outcome = result.task(":printJBakeClasspath")?.outcome logger.info("Outcome: $outcome") if (outcome == TaskOutcome.SUCCESS) { logger.info("✓ Exécution réussie") } else { logger.warn("⚠ Outcome inattendu: $outcome") } assertEquals(TaskOutcome.SUCCESS, outcome) } catch (e: Exception) { logger.error("✗ Échec du test", e) logger.error("Type d'exception: ${e.javaClass.simpleName}") logger.error("Message: ${e.message}") // Log de la stack trace si nécessaire if (logger.isDebugEnabled) { logger.debug("Stack trace complète:", e) } throw e } } }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_σχήμα_πολυεπιπέδων_λογογράφησης">Σχήμα Πολυεπιπέδων Λογογράφησης</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-b7e5c5317a4a9e2cb7a7da96d56260cb.png" alt="Diagram" width="314" height="911"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_καλές_πρακτικές">Καλές πρακτικές</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_δομή_καταγραφής_προτεινόμενη">Δομή καταγραφής προτεινόμενη</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `mon test`() { // 1. LOG: Début du test logger.info("TEST: Description du test") // 2. LOG: Préparation logger.debug("Préparation des fichiers...") buildFile.writeText("...") logger.debug("✓ Fichiers préparés") // 3. LOG: Exécution logger.debug("Lancement du build...") val startTime = System.currentTimeMillis() val result = GradleRunner.create() .forwardOutput() .withArguments("task") .build() val duration = System.currentTimeMillis() - startTime logger.info("Build terminé en ${duration}ms") // 4. LOG: Analyse logger.debug("Analyse des résultats...") // ... validations ... // 5. LOG: Conclusion logger.info("✓ Test réussi") }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_οπτικά_σύμβολα_για_ευανάγνωστη_ανάγνωση">Οπτικά σύμβολα για ευανάγνωστη ανάγνωση</h3> <div class="paragraph"> <p>Χρησιμοποιήστε συμβολα Unicode για να βελτιώσετε την ανάγνωση των καταγραφών :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">logger.info("✓ Succès") logger.info("✗ Échec") logger.info("⚠ Attention") logger.info("→ Étape suivante") logger.info("═".repeat(60)) // Séparateur principal logger.info("─".repeat(60)) // Séparateur secondaire</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_εξαγωγή_πληροφοριών_από_την_έξοδο">Εξαγωγή Πληροφοριών από την Έξοδο</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// Recherche simple val hasMessage = result.output.contains("Expected message") // Extraction avec regex val versionRegex = Regex("Version: (.+)") val version = versionRegex.find(result.output)?.groupValues?.get(1) // Filtrage de lignes val errorLines = result.output.lines() .filter { it.contains("ERROR") } errorLines.forEach { logger.error("Gradle error: $it") }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_σύγκριση_πρινμετά">Σύγκριση Πριν/Μετά</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_πριν_προβληματική_προσέγγιση">Πριν: Προβληματική προσέγγιση</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class MyTest { lateinit var logger: Logger // ❌ Initialisé tardivement @BeforeEach fun setup() { logger = LoggerFactory.getLogger(...) // ❌ Dépendance } @Test fun test() { val runner = GradleRunner.create() logger.info("Testing...") // ⚠ Peut échouer } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_μετά_ανθεκτική_προσέγγιση">Μετά : Ανθεκτική προσέγγιση</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class MyTest { companion object { private val logger = LoggerFactory.getLogger(...) // ✓ Indépendant } @Test fun test() { logger.info("TEST: Starting...") // ✓ Toujours disponible val result = GradleRunner.create() .forwardOutput() // ✓ Capture la sortie .build() logger.debug("Output: ${result.output}") // ✓ Analyse } }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διάγραμμα_συνοπτικό">Διάγραμμα Συνοπτικό</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre>Failed to generate image: PlantUML preprocessing failed: [From <input> (line 9) ] @startuml ... ... ( skipping 129 lines ) ... } skinparam StereotypeI { BackgroundColor white BorderColor black } skinparam StereotypeN { BackgroundColor white BorderColor black } skinparam UseCaseStereoType { FontColor black FontName Verdana } skinparam backgroundColor #FEFEFE title Πλήρης ροή καταγραφής σε λειτουργικούς τεστς actor "Πρόγραμματιστής" as dev participant "JUnit" as junit participant "TestClass" as test participant "Καταγραφέας ^^^^^ Syntax Error? (Assumed diagram type: sequence) @startuml !theme plain skinparam backgroundColor #FEFEFE title Πλήρης ροή καταγραφής σε λειτουργικούς τεστς actor "Πρόγραμματιστής" as dev participant "JUnit" as junit participant "TestClass" as test participant "Καταγραφέας (SLF4J)" as logger participant "Logback" as logback participant "GradleRunner" as runner participant "Κονσόλα/Αρχείο" as output dev -> junit : lance les tests activate junit junit -> test : charge la classe activate test test -> logger : initialize (companion) activate logger logger -> logback : configure activate logback logback --> logger : ready deactivate logback logger --> test : ✓ deactivate logger == Phase de Setup == junit -> test : @BeforeAll test -> logger : info("Αρχικοποίηση") logger -> output : [INFO] Initialisation junit -> test : @BeforeEach test -> logger : debug("Δοκιμή ρύθμισης") logger -> output : [DEBUG] Setup test == Phase de Test == junit -> test : @Test test -> logger : info("ξεκινούντας") logger -> output : [INFO] TEST: Starting test -> runner : create() activate runner test -> runner : .forwardOutput() test -> runner : .build() runner -> runner : execute Gradle runner --> test : BuildResult + output text deactivate runner test -> logger : debug("Ανάλυση εξόδου") logger -> output : [DEBUG] Analyzing output test -> test : assertions test -> logger : info("✓ Δοκιμή επιτυχής") logger -> output : [INFO] ✓ Test passed == Phase de Cleanup == junit -> test : @AfterEach test -> logger : debug("Καθαρισμός") logger -> output : [DEBUG] Cleanup junit -> test : @AfterAll test -> logger : info("Τέλος των δοκιμών") logger -> output : [INFO] Fin des tests test --> junit : ✓ all tests passed deactivate test deactivate junit dev <-- junit : rapport de tests @enduml</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_παγίδες_που_πρέπει_να_αποφύγετε">Παγίδες που πρέπει να αποφύγετε</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_παγίδα_1_να_ξεχάσετε_το_forwardoutput">�❌ Παγίδα #1: Να ξεχάσετε το `.forwardOutput()</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// MAUVAIS: La sortie Gradle n'est pas capturée val result = GradleRunner.create() .withArguments("task") .build() // result.output sera vide !</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// BON: La sortie est capturée val result = GradleRunner.create() .forwardOutput() // ✓ .withArguments("task") .build()</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_πίεγμα_n2_μη_αρχικοποιημένος_logger">❌ Πίεγμα n°2 : Μη αρχικοποιημένος Logger</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// MAUVAIS class Test { lateinit var logger: Logger // Peut ne pas être initialisé }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// BON class Test { companion object { private val logger = LoggerFactory.getLogger(...) // Toujours initialisé } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_παγίδα_3_υπerezό_καταγραφή">❌ Παγίδα №3: Υπerezό Καταγραφή</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// MAUVAIS: Trop de logs DEBUG en production logger.debug("Variable a = $a") logger.debug("Variable b = $b") logger.debug("Variable c = $c") // ... 100 lignes de logs</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// BON: Logging ciblé logger.info("Traitement de ${items.size} éléments") logger.debug("Détails: ${items.take(5)}...") // Échantillon seulement</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αποτελέσματα_και_μετρικές">Αποτελέσματα και Μετρικές</h2> <div class="sectionbody"> <div class="paragraph"> <p>Με αυτή τη μέθοδο, θα λάβετε :</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 28.5714%;"> <col style="width: 42.8571%;"> <col style="width: 28.5715%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">Μετρική</th> <th class="tableblock halign-left valign-top">πριν</th> <th class="tableblock halign-left valign-top">Μετά</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Γραμμές κώδικα</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~50 γραμμές</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~80 γραμμές (+60%)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Χρόνος αποσφαλμάτωσης</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~30 min</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">~5 λεπτ. (-83%)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Ανιχνευμένα σφάλματα</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Βασικό</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Λεπτομερής</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Συντήρηση</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Δύσκολος</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">απλό</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Ανεξαρτησία</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�❌ συνδεδεμένη</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">✓ ανεξάρτητη</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η ρύθμιση ενός ισχυρού συστήματος καταγραφής στα λειτουργικά δοκίμια των προσθηκών Gradle βασίζεται σε έναν απλό αρχή:<strong>η ανεξαρτησία</strong>.</p> </div> <div class="paragraph"> <p>Βασικά σημεία που πρέπει να θυμάσαι:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Logger ανεξάρτητος</strong>: Αρχικοποιημένο σε ένα`companion object`</p> </li> <li> <p><strong>SLF4J + Logback</strong>: Stack ελεγμένη και ρυθμιζόμενη</p> </li> <li> <p><strong>.forwardOutput()</strong>: Απολψη της εξόδου του Gradle</p> </li> <li> <p><strong>Καταγραφή δομημένη</strong>INFO για τα βήματα, DEBUG για τα λεπτομέρειες</p> </li> <li> <p><strong>Ανάλυση εξόδου</strong>: Εξαγωγή πληροφοριών από`result.output`</p> </li> </ol> </div> <div class="paragraph"> <p>Αυτή η προσέγγιση εξασφαλίζει τα τεστ<strong>συντήρησιμα</strong>, <strong>αποσφαλμαστικά</strong> et <strong>ισχυροί</strong>, σε συμμόρφωση με τις στερεές αρχές σχεδιασμού.</p> </div> </div> </div> <div class="sect1"> <h2 id="_πόροι">Πόροι</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://docs.gradle.org/current/userguide/test_kit.html">Τεκμηρίωση Gradle TestKit</a></p> </li> <li> <p><a href="https://www.slf4j.org/manual.html">Εγχειρίδιο SLF4J</a></p> </li> <li> <p><a href="https://logback.qos.ch/manual/configuration.html">Ρύθμιση Logback</a></p> </li> <li> <p><a href="https://github.com/gradle/gradle/tree/master/subprojects/test-kit">Gradle TestKit Πηγαίος κώδικας</a></p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_πήγαινε_περαιτέρω">Πήγαινε περαιτέρω</h2> <div class="sectionbody"> <div class="paragraph"> <p>Σε ένα επόμενο άρθρο, θα εξερευνήσουμε :</p> </div> <div class="ulist"> <ul> <li> <p>Συνεχής ενσωμάτωση με δομημένο logging</p> </li> <li> <p>Τα HTML αναφορές δοκιμών με ενσωματωμένα logs</p> </li> <li> <p>Προχωρημένο debugging με τη σύνδεση JVM</p> </li> <li> <p>Οι επιδόσεις και βελτιστοποιήσεις του logging</p> </li> </ul> </div> <div class="paragraph"> <p><em>Aυτό το άρθρο είναι μέρος της σειράς "Ανάπτυξη προσθηκών Gradle" στο τεχνολογικό μου blog.</em></p> </div> </div> </div> https://cheroliv.com/blog/2025/0096_afficher-couleurs-asciidoc_post.html Sat, 1 Nov 2025 00:00:00 +0000 blog/2025/0096_afficher-couleurs-asciidoc_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_το_ζήτημα">Το ζήτημα</a> <ul class="sectlevel2"> <li><a href="#_περιβάλλον_χρήσης">Περιβάλλον χρήσης</a></li> <li><a href="#_οι_δυνατές_προσεγγίσεις">Οι δυνατές προσεγγίσεις</a> <ul class="sectlevel3"> <li><a href="#_επιλογή_1_unicode_χαρακτήρες">Επιλογή 1: Unicode χαρακτήρες</a></li> <li><a href="#_επιλογή_2_εξωτερικές_εικόνες">Επιλογή 2 : Εξωτερικές εικόνες</a></li> <li><a href="#_επιλογή_3_προσαρμοσμένοι_ρόλοι_css">Επιλογή 3 : Προσαρμοσμένοι ρόλοι CSS</a></li> <li><a href="#_επιλογή_4_ένθεση_html_επιλεγμένη_λύση">Επιλογή 4 : Ένθεση HTML (επιλεγμένη λύση)</a></li> </ul> </li> </ul> </li> <li><a href="#_η_λύση_ένθεση_html_με">Η λύση : Ένθεση HTML με </a> <ul class="sectlevel2"> <li><a href="#_αρχή_λειτουργίας">αρχή λειτουργίας</a></li> <li><a href="#_υλοποίηση">Υλοποίηση</a> <ul class="sectlevel3"> <li><a href="#_επεξήγηση_των_ιδιοτήτων_css">Επεξήγηση των ιδιοτήτων CSS</a></li> </ul> </li> <li><a href="#_πλήρες_παράδειγμα">Πλήρες παράδειγμα</a></li> </ul> </li> <li><a href="#_βελτιστοποιήσεις_και_καλές_πρακτικές">Βελτιστοποιήσεις και καλές πρακτικές</a> <ul class="sectlevel2"> <li><a href="#_διαχείριση_των_φωτεινών_χρωμάτων">Διαχείριση των φωτεινών χρωμάτων</a></li> <li><a href="#_προσαρμόστε_το_μέγεθος_των_τετραγώνων">Προσαρμόστε το μέγεθος των τετραγώνων</a></li> <li><a href="#_δημιουργήστε_παραλλαγές">Δημιουργήστε παραλλαγές</a> <ul class="sectlevel3"> <li><a href="#_χρωστός_κύκλος">χρωστός κύκλος</a></li> <li><a href="#_τετράγωνο_με_χρωματικό_περίθωριο">Τετράγωνο με χρωματικό περίθωριο</a></li> </ul> </li> </ul> </li> <li><a href="#_αρχιτεκτονική_της_λύσης">Αρχιτεκτονική της λύσης</a></li> <li><a href="#_πλεονεκτήματα_και_περιορισμοί">Πλεονεκτήματα και περιορισμοί</a> <ul class="sectlevel2"> <li><a href="#_πλεονεκτήματα">Πλεονεκτήματα</a></li> <li><a href="#_περιορισμοί">Περιορισμοί</a></li> <li><a href="#_βελτίωση_της_προσβασιμότητας">Βελτίωση της προσβασιμότητας</a></li> </ul> </li> <li><a href="#_συγκεκριμένο_παράδειγμα_τεκμηρίωση_θεμάτων">Συγκεκριμένο παράδειγμα: Τεκμηρίωση θεμάτων</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> <li><a href="#_πόροι">Πόροι</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <p>Κατά τη σύνταξη τεχνικής τεκμηρίωσης, ειδικά για οδηγούς στυλ ή προδιαγραφές διεπαφής χρήστη, είναι συχνή η ανάγκη να εμφανίζονται παλέτες χρωμάτων. Το AsciiDoc, αν και πολύ ισχυρό για τεκμηρίωση, δεν προσφέρει ενδογενή σύνταξη για την εμφάνιση δείγμάτων χρωμάτων. Αυτό το άρθρο εξετάζει το πρόβλημα και προτείνει μια ελεγκτική λύση βασισμένη στην εγχέριση HTML.</p> </div> </div> </div> <div class="sect1"> <h2 id="_το_ζήτημα">Το ζήτημα</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_περιβάλλον_χρήσης">Περιβάλλον χρήσης</h3> <div class="paragraph"> <p>Φανταστείτε ότι τεκμηριώνετε τις μεταβλητές CSS ενός θέματος εφαρμογής ιστού. Χρειάζεστε:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Λίστα τα δεκαεξαδικά κώδικα χρώματος</p> </li> <li> <p>Εμφάνιση οπτικής προespισκόπησης каждый χρώματος</p> </li> <li> <p>διατήρηση της αναγνωσιμότητας του εγγράφου προέλευσης</p> </li> <li> <p>Εξασφαλίστε τη συμβατότητα με τους δημιουργούς στατικών ιστοτόπων όπως το JBake</p> </li> </ol> </div> <div class="imageblock"> <div class="content"> <img src="use-case-diagram.svg" alt="use case diagram" width="1738" height="5640"> </div> </div> </div> <div class="sect2"> <h3 id="_οι_δυνατές_προσεγγίσεις">Οι δυνατές προσεγγίσεις</h3> <div class="paragraph"> <p>Υπολογίζονται διάφορες λύσεις για να εμφανιστούν χρώματα σε ένα έγγραφο AsciiDoc :</p> </div> <div class="imageblock"> <div class="content"> <img src="component-diagram.svg" alt="component diagram" width="1739" height="5700"> </div> </div> <div class="sect3"> <h4 id="_επιλογή_1_unicode_χαρακτήρες">Επιλογή 1: Unicode χαρακτήρες</h4> <div class="paragraph"> <p>Η χρήση χαρακτήρων Unicode όπως`■`(■) είναι απλή αλλά περιορισμένη:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* ■ --accent-color: #7952b3 (violet Bootstrap)</code></pre> </div> </div> <div class="paragraph"> <p><strong>Limitations</strong> : Δεν υπάρχει έλεγχος του χρώματος, εξαρτάται από τη γραμματοσειρά του συστήματος.</p> </div> </div> <div class="sect3"> <h4 id="_επιλογή_2_εξωτερικές_εικόνες">Επιλογή 2 : Εξωτερικές εικόνες</h4> <div class="paragraph"> <p>Δημιουργήστε εικόνες PNG ή SVG για κάθε χρώμα :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* image:colors/violet.svg[width=16] --accent-color: #7952b3</code></pre> </div> </div> <div class="paragraph"> <p><strong>Limitations</strong> : Βαρέα συντήρηση, πολλαπλασιασμός των αρχείων, χωρίς αυτόματο συγχρονισμό.</p> </div> </div> <div class="sect3"> <h4 id="_επιλογή_3_προσαρμοσμένοι_ρόλοι_css">Επιλογή 3 : Προσαρμοσμένοι ρόλοι CSS</h4> <div class="paragraph"> <p>Καθορίστε κλάσεις CSS και εφαρμόστε τις μέσω ρόλων AsciiDoc :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* [.color-violet]##■## --accent-color: #7952b3</code></pre> </div> </div> <div class="paragraph"> <p><strong>Περιορισμοί</strong> : Απαιτείται ένα εξωτερικό φύλλο στυλ, ο προκαhtoρισμός όλων των πιθανών χρωμάτων.</p> </div> </div> <div class="sect3"> <h4 id="_επιλογή_4_ένθεση_html_επιλεγμένη_λύση">Επιλογή 4 : Ένθεση HTML (επιλεγμένη λύση)</h4> <div class="paragraph"> <p>Χρησιμοποιήστε τη μακροεντολή``για να ενετελλάτε HTML με ενσωματωμένα στυλ :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span style="display:inline-block;width:1em;height:1em; background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: #7952b3 (violet Bootstrap)</code></pre> </div> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_η_λύση_ένθεση_html_με">Η λύση : Ένθεση HTML με </h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_αρχή_λειτουργίας">αρχή λειτουργίας</h3> <div class="paragraph"> <p>Το μάκρο``Το d’AsciiDoc επιτρέπει την εισαγωγή απλής περιεχομένου που δεν θα ερμηνευθεί από τον επεξεργαστή AsciiDoc. Αυτό μας επιτρέπει να εγχωρίσουμε απευθείας HTML με ενσωματωμένα στυλ CSS.</p> </div> <div class="listingblock"> <div class="content"> <pre>Failed to generate image: PlantUML preprocessing failed: [From <input> (line 2) ] @startuml participant "Έγγραφο ^^^^^ Syntax Error? (Assumed diagram type: sequence) @startuml participant "Έγγραφο AsciiDoc" as doc participant "Επεξεργαστής AsciiDoc" as processor participant "pass:[] μακροεντολή" as pass participant "HTML τελικό" as html doc -> processor : Analyse document processor -> pass : Détecte pass:[] pass -> processor : Retourne HTML brut processor -> html : Insère sans transformation html -> html : Navigateur applique styles @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_υλοποίηση">Υλοποίηση</h3> <div class="paragraph"> <p>Αυτό είναι η δομή HTML που θα ενσωματωθεί :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><span style="display:inline-block; width:1em; height:1em; background:#7952b3; vertical-align:middle; margin-right:0.5em"> </span></code></pre> </div> </div> <div class="sect3"> <h4 id="_επεξήγηση_των_ιδιοτήτων_css">Επεξήγηση των ιδιοτήτων CSS</h4> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 75%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">Ιδιότητα</th> <th class="tableblock halign-left valign-top">Λειτουργία</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>display:inline-block</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Επιτρέπει τον ορισμό του width/height ενώ παραμένει στη γραμμική ροή</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>width:1em; height:1em</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Μέγεθος τετράγωνου σχετικό με το μέγεθος γραμματοσειράς (ανταποκρινόμενο)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>background:#7952b3</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Το χρώμα που θα εμφανιστεί (μεταβλητό σύμφωνα με τις ανάγκες σας)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>vertical-align:middle</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Συμμετρόν το τετράγωνο με το κείμενο δίπλα</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>margin-right:0.5em</code></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">διάστημα μεταξύ του τετραγώνου και του κειμένου</p></td> </tr> </tbody> </table> </div> </div> <div class="sect2"> <h3 id="_πλήρες_παράδειγμα">Πλήρες παράδειγμα</h3> <div class="paragraph"> <p>Αυτό είναι ένα παράδειγμα που τεκμηριώνει μια χρωματική παλέτα θέματος :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">== Thème Clair * pass:[<span style="display:inline-block;width:1em;height:1em;background:#f8f9fa;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span>] --bg-primary: `#f8f9fa` (blanc cassé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#212529;vertical-align:middle;margin-right:0.5em"></span>] --text-primary: `#212529` (noir très foncé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#7952b3` (violet Bootstrap) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#61428f;vertical-align:middle;margin-right:0.5em"></span>] --accent-hover: `#61428f` (violet plus foncé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span>] --card-bg: `#ffffff` (blanc)</code></pre> </div> </div> <div class="paragraph"> <p>Ποιος παράγει το επόμενο αποτέλεσμα :</p> </div> <div class="paragraph"> <p><strong>Φεγγαρό Θέμα</strong></p> </div> <div class="ulist"> <ul> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#f8f9fa;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span> --bg-primary:`#f8f9fa`(λευκόπρινο)</p> </li> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#212529;vertical-align:middle;margin-right:0.5em"></span> --text-primary:`#212529`(πολύ σκούρο μαύρο)</p> </li> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span> --accent-color:`#7952b3`(βιολέτι Bootstrap)</p> </li> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#61428f;vertical-align:middle;margin-right:0.5em"></span> --accent-hover:`#61428f`(πιο σκούρο βιολέ)</p> </li> <li> <p><span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span> --card-bg:`#ffffff`(λευκό)</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_βελτιστοποιήσεις_και_καλές_πρακτικές">Βελτιστοποιήσεις και καλές πρακτικές</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_διαχείριση_των_φωτεινών_χρωμάτων">Διαχείριση των φωτεινών χρωμάτων</h3> <div class="paragraph"> <p>Για πολύ ανοιχτές χρωματικές τόνες (λευκό, πολύ ανοιχτό γκρι), προσθέστε ένα περίγραμμα για να γίνουν ορατά σε λευκό φόντο :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><span style="display:inline-block;width:1em;height:1em; background:#ffffff;border:1px solid #ccc; vertical-align:middle;margin-right:0.5em"></span></code></pre> </div> </div> <div class="paragraph"> <p>Η γκρίζη περίγραμμα`border:1px solid #ccc`) επιτρέπει να οριοθετήσει το λευκό τετράγωνο σε ένα λευκό φόντο.</p> </div> </div> <div class="sect2"> <h3 id="_προσαρμόστε_το_μέγεθος_των_τετραγώνων">Προσαρμόστε το μέγεθος των τετραγώνων</h3> <div class="paragraph"> <p>Μπορείτε να προσαρμόσετε το μέγεθος των τετραγώνων ανάλογα με τις ανάγκες σας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span style="display:inline-block;width:1.5em;height:1.5em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] Grand carré * pass:[<span style="display:inline-block;width:0.8em;height:0.8em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] Petit carré</code></pre> </div> </div> <div class="paragraph"> <p>Η χρήση της μονάδας`em`Εγγυάται ότι τα τετράγωνα προσαρμόζονται στο μέγεθος της γραμματοσειράς.</p> </div> </div> <div class="sect2"> <h3 id="_δημιουργήστε_παραλλαγές">Δημιουργήστε παραλλαγές</h3> <div class="paragraph"> <p>Για συγκεκριμένες ανάγκες, μπορείτε να δημιουργήσετε διάφορες μορφές:</p> </div> <div class="sect3"> <h4 id="_χρωστός_κύκλος">χρωστός κύκλος</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span style="display:inline-block;width:1em;height:1em;background:#7952b3;border-radius:50%;vertical-align:middle;margin-right:0.5em"></span>] Cercle violet</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_τετράγωνο_με_χρωματικό_περίθωριο">Τετράγωνο με χρωματικό περίθωριο</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:3px solid #7952b3;vertical-align:middle;margin-right:0.5em"></span>] Bordure violette</code></pre> </div> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αρχιτεκτονική_της_λύσης">Αρχιτεκτονική της λύσης</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="architecture-diagram.svg" alt="architecture diagram" width="1747" height="5432"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πλεονεκτήματα_και_περιορισμοί">Πλεονεκτήματα και περιορισμοί</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_πλεονεκτήματα">Πλεονεκτήματα</h3> <div class="ulist"> <ul> <li> <p>✓ <strong>Autonomie</strong> : Καμία εξάρτηση από εξωτερικά αρχεία</p> </li> <li> <p>�✓ <strong>Προσαρμοστικότητα</strong> : Λειτουργεί με όλους τους επεξεργαστές AsciiDoc</p> </li> <li> <p>✓ <strong>Synchronisation</strong> : Ο κωδικός χρώματος είναι απευθείας στο HTML</p> </li> <li> <p>✓ <strong>Flexibilité</strong> : Πλήρης προσαρμογή του στυλ</p> </li> <li> <p>✓ <strong>Maintenance</strong> : Απλὴ τροποποίηση του δεκαεξαδικού κώδικα</p> </li> <li> <p>�✓ <strong>Συμβατότητα JBake</strong> : Λειτουργεί τέλεια με τις γεννητέρες στατικών ιστοτόπων</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_περιορισμοί">Περιορισμοί</h3> <div class="ulist"> <ul> <li> <p>�✗ <strong>λογοριθμία</strong> : Κώδικας HTML επαναλαμβανόμενος στην πηγή AsciiDoc</p> </li> <li> <p><strong>Αναγνωσιμότητα πηγής</strong> : Το έγγραφο πηγής είναι λιγότερο καθαρό</p> </li> <li> <p><strong>Accessibilité</strong> : Δεν υπάρχει εγγενές εναλλακτικό κείμενο (να προστεθεί χειροκίνητα)</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_βελτίωση_της_προσβασιμότητας">Βελτίωση της προσβασιμότητας</h3> <div class="paragraph"> <p>Για να κάνετε τα τετράγωνα προσβάσιμα στους αναγνώστες οθόνης:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* pass:[<span role="img" aria-label="Couleur violet Bootstrap" style="display:inline-block;width:1em;height:1em;background:#7952b3; vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#7952b3` (violet Bootstrap)</code></pre> </div> </div> <div class="paragraph"> <p>Τα χαρακτηριστικά`role="img"` et `aria-label`επιτρέπουν στις τεχνολογίες βοήθειας να κατανοούν και να περιγράφουν το οπτικό περιεχόμενο.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συγκεκριμένο_παράδειγμα_τεκμηρίωση_θεμάτων">Συγκεκριμένο παράδειγμα: Τεκμηρίωση θεμάτων</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτό είναι ένα πλήρες παράδειγμα που τεκμηριώνει πολλά θέματα :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Guide des couleurs de l'application == Thème Clair (`:root`) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#f8f9fa;border:1px solid #ccc;vertical-align:middle;margin-right:0.5em"></span>] --bg-primary: `#f8f9fa` (blanc cassé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#212529;vertical-align:middle;margin-right:0.5em"></span>] --text-primary: `#212529` (noir très foncé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#7952b3;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#7952b3` (violet Bootstrap) == Thème Sombre (`[data-bs-theme="dark"]`) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#212529;vertical-align:middle;margin-right:0.5em"></span>] --bg-primary: `#212529` (noir très foncé) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:1px solid #999;vertical-align:middle;margin-right:0.5em"></span>] --text-primary: `#ffffff` (blanc) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#0d6efd;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#0d6efd` (bleu Bootstrap) == Thème Contraste Élevé (`[data-bs-theme="high-contrast"]`) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#000000;vertical-align:middle;margin-right:0.5em"></span>] --bg-primary: `#000000` (noir) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#ffffff;border:1px solid #000;vertical-align:middle;margin-right:0.5em"></span>] --text-primary: `#ffffff` (blanc) * pass:[<span style="display:inline-block;width:1em;height:1em;background:#00ff00;vertical-align:middle;margin-right:0.5em"></span>] --accent-color: `#00ff00` (vert vif)</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Έγχυση HTML μέσω του macro``Η AsciiDoc προσφέρει μια ελκυστική και πρακτική λύση για την εμφάνιση χρωματικών δειγμάτων στην τεχνική τεκμηρίωση. Αν και είναι ελαφρώς πλεοναστική, αυτή η προσέγγιση εξασφαλίζει τη μέγιστη μετακομικότητα και απλοποιημένη συντήρηση.</p> </div> <div class="paragraph"> <p>Αυτή η τεχνική δεν απαιτεί καμία εξωτερική ρύθμιση, καμία πρόσθετη φύλλο στυλ, και λειτουργεί αμέσως με το JBake και όλους τους τυπικούς επεξεργαστές AsciiDoc.</p> </div> <div class="paragraph"> <p>Αφού έχετε δημιουργήσει το πρώτο σας χρωματιστό τετράγωνο, απλώς αντιγράψτε-επικολλήστε τον HTML κώδικα και αλλάξτε τον δεκαεξαδικό κώδικα για να δημιουργήσετε γρήγορα μια πλήρη παλέτα.</p> </div> <div class="paragraph"> <p>Αυτή η τεχνική μπορεί να επεκταθεί σε άλλες περιπτώσεις χρήσης που απαιτούν προσαρμοσμένη οπτική παρουσίαση: εικονίδια, μπέιτζ, απλά γραφήματα ή οποιοδήποτε οπτικό στοιχείο που απαιτεί ακριβή έλεγχο του στυλ.</p> </div> </div> </div> <div class="sect1"> <h2 id="_πόροι">Πόροι</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://docs.asciidoctor.org/asciidoc/latest/pass/pass-macro/" target="_blank" rel="noopener">Τεκμηρίωση AsciiDoc : περάστε macro</a></p> </li> <li> <p><a href="https://jbake.org/docs/2.6.7/" target="_blank" rel="noopener">JBake Τεκμηρίωση</a></p> </li> <li> <p><a href="https://developer.mozilla.org/fr/docs/Web/CSS/color_value">MDN : Τιμές χρωμάτων CSS</a></p> </li> </ul> </div> <div class="paragraph"> <p><em>Άρθρο δημοσιεύτηκε το 2025-11-01</em></p> </div> </div> </div> https://cheroliv.com/blog/2025/0095_i18n-site-statique-jbake-thymeleaf_post.html Mon, 20 Oct 2025 00:00:00 +0000 blog/2025/0095_i18n-site-statique-jbake-thymeleaf_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a> <ul class="sectlevel2"> <li><a href="#_διάγραμμα_περιπτώσεων_χρήσης_use_case">Διάγραμμα περιπτώσεων χρήσης (Use Case)</a></li> </ul> </li> <li><a href="#_αρχιτεκτονική_της_διεθνεύς_ανάπτυξης">Αρχιτεκτονική της διεθνεύς ανάπτυξης</a> <ul class="sectlevel2"> <li><a href="#_διάγραμμα_δομής_οργάνωση_αρχείων">Διάγραμμα δομής (Οργάνωση αρχείων)</a></li> <li><a href="#_γιατί_αυτή_η_προσέγγιση">Γιατί αυτή η προσέγγιση;</a></li> <li><a href="#_διάγραμμα_συστατικών">Διάγραμμα συστατικών</a></li> </ul> </li> <li><a href="#_i18n_του_templating_με_thymeleaf">I18n του templating με Thymeleaf</a> <ul class="sectlevel2"> <li><a href="#_δομή_των_αρχείων_μηνυμάτων">Δομή των αρχείων μηνυμάτων</a></li> <li><a href="#_περιεχόμενο_των_αρχείων_μηνυμάτων">Περιεχόμενο των αρχείων μηνυμάτων</a></li> <li><a href="#_χρήση_στα_πρότυπα">Χρήση στα πρότυπα</a></li> <li><a href="#_διάγραμμα_ακολουθίας_λύση_i18n">Διάγραμμα ακολουθίας - Λύση i18n</a></li> <li><a href="#_ρύθμιση_της_τοπικότητας_στο_jbake">Ρύθμιση της τοπικότητας στο JBake</a></li> </ul> </li> <li><a href="#_i18n_των_άρθρων_οργάνωση_ανά_φάκελο">I18n των άρθρων : οργάνωση ανά φάκελο</a> <ul class="sectlevel2"> <li><a href="#_διάγραμμα_ροής_flow_παραγωγή">Διάγραμμα ροής (Flow) - Παραγωγή</a></li> <li><a href="#_δομή_φακέλων">Δομή φακέλων</a></li> <li><a href="#_πλεονεκτήματα_αυτής_της_προσέγγισης">Πλεονεκτήματα αυτής της προσέγγισης</a></li> <li><a href="#_μεταδεδομένα_των_άρθρων">Μεταδεδομένα των άρθρων</a></li> <li><a href="#_ρύθμιση_των_url">�Ρύθμιση των URL</a></li> </ul> </li> <li><a href="#_πρότυπα_για_πολυγλωτική_εμφάνιση">Πρότυπα για πολυγλωτική εμφάνιση</a> <ul class="sectlevel2"> <li><a href="#_πρότυπο_άρθρου_με_επιλογή_γλώσσας">Πρότυπο άρθρου με επιλογή γλώσσας</a></li> <li><a href="#_ευρετήριο_φιλτραρισμένο_ανά_γλώσσα">Ευρετήριο φιλτραρισμένο ανά γλώσσα</a></li> </ul> </li> <li><a href="#_πλοήγηση_μεταξύ_γλωσσών">Πλοήγηση μεταξύ γλωσσών</a> <ul class="sectlevel2"> <li><a href="#_παγκόσμιος_επιλογέας_γλώσσας">παγκόσμιος επιλογέας γλώσσας</a></li> <li><a href="#_διάγραμμα_ροής_ανάγνωση_χρήστη">Διάγραμμα ροής - Ανάγνωση χρήστη</a></li> <li><a href="#_στυλ_css_για_τον_επιλογέα">Στυλ CSS για τον επιλογέα</a></li> </ul> </li> <li><a href="#_ροή_rss_ανά_γλώσσα">�Ροή RSS ανά γλώσσα</a></li> <li><a href="#_καλές_πρακτικές_και_συμβουλές">Καλές πρακτικές και συμβουλές</a> <ul class="sectlevel2"> <li><a href="#_1_συμφωνία_των_αναγνωριστικών_άρθρων">1. Συμφωνία των αναγνωριστικών άρθρων</a></li> <li><a href="#_2_συνεπείς_ημερομηνίες">2. Συνεπείς ημερομηνίες</a></li> <li><a href="#_3_ετικέτες_πολυγλωσσικές">3. Ετικέτες πολυγλωσσικές</a></li> <li><a href="#_4_διαχείριση_άρθρων_που_δεν_έχουν_μεταφραστεί">4. Διαχείριση άρθρων που δεν έχουν μεταφραστεί</a></li> <li><a href="#_5_πολυγλωσσικός_sitemap">5. Πολυγλωσσικός sitemap</a></li> </ul> </li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a> <ul class="sectlevel2"> <li><a href="#_διάγραμμα_διανομής">Διάγραμμα διανομής</a></li> </ul> </li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η διεθνέστευση (i18n) ενός στατικού ιστότοπου μπορεί να φαίνεται περίπλοκη στην αρχή, αλλά το JBake συνδυασμένο με το Thymeleaf προσφέρει ελκυστικές λύσεις για τη δημιουργία ενός πολυγλωσσικού ιστότοπου. Στο αυτό το άρθρο, θα σας δείξω πώς εφάρμοσα το i18n στο blog μου, καλύπτοντας τόσο το templating όσο και τη διαχείριση των άρθρων σε πολλές γλώσσες.</p> </div> <div class="sect2"> <h3 id="_διάγραμμα_περιπτώσεων_χρήσης_use_case">Διάγραμμα περιπτώσεων χρήσης (Use Case)</h3> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-4bf815ca555225907d10cca2cc997ad4.png" alt="Diagram" width="742" height="462"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αρχιτεκτονική_της_διεθνεύς_ανάπτυξης">Αρχιτεκτονική της διεθνεύς ανάπτυξης</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η προσέγγισή μας βασίζεται σε δύο στύλους:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Η διεθνέστευση του templating</strong>χρήση των αρχείων μηνυμάτων Thymeleaf για τα στοιχεία της διεπαφής</p> </li> <li> <p><strong>Η διεθνησιοποίηση του περιεχομένου</strong>Οργανωση άρθρων ανά γλώσσα σε μια ειδική δομή φακέλων</p> </li> </ol> </div> <div class="sect2"> <h3 id="_διάγραμμα_δομής_οργάνωση_αρχείων">Διάγραμμα δομής (Οργάνωση αρχείων)</h3> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-2f100fc3ec2ec37f9556818cdc246602.png" alt="Diagram" width="188" height="513"> </div> </div> </div> <div class="sect2"> <h3 id="_γιατί_αυτή_η_προσέγγιση">Γιατί αυτή η προσέγγιση;</h3> <div class="paragraph"> <p>Αυτή η διαχωρισμός επιτρέπει:</p> </div> <div class="ulist"> <ul> <li> <p>Διατηρήστε τη συνέπεια στη διεπαφή, ανεξάρτητα από τη γλώσσα</p> </li> <li> <p>Διαχειρίζε ανεξάρτητα το περιεχόμενο και τις μεταφράσεις των άρθρων</p> </li> <li> <p>Ευκολοποίηση της προσθήκης νέων γλωσσών χωρίς σημαντικό ανασχεδιασμό</p> </li> <li> <p>Επιτρέψτε άρθρα που είναι διαθέσιμα μόνο σε ορισμένες γλώσσες.</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_διάγραμμα_συστατικών">Διάγραμμα συστατικών</h3> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-be8d4b58fafd9fab77a081116837a8dd.png" alt="Diagram" width="1771" height="477"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_i18n_του_templating_με_thymeleaf">I18n του templating με Thymeleaf</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_δομή_των_αρχείων_μηνυμάτων">Δομή των αρχείων μηνυμάτων</h3> <div class="paragraph"> <p>Η πρώτη βήμα είναι να δημιουργηθούν τα αρχεία ιδιοτήτων για κάθε υποστηριζόμενη γλώσσα:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">src/jbake/templates/ ├── messages.properties # Fallback par défaut ├── messages_fr.properties # Français ├── messages_en.properties # Anglais └── messages_de.properties # Allemand</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_περιεχόμενο_των_αρχείων_μηνυμάτων">Περιεχόμενο των αρχείων μηνυμάτων</h3> <div class="paragraph"> <p>Αυτό είναι ένα παράδειγμα αρχείου`messages_fr.properties`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># Navigation nav.home=Accueil nav.blog=Blog nav.about=À propos nav.contact=Contact # Articles article.readmore=Lire la suite article.published=Publié le article.tags=Étiquettes article.also.available=Également disponible en # Interface site.title=Mon Blog Technique site.description=Partage de connaissances et expériences footer.copyright=© 2025 Tous droits réservés search.placeholder=Rechercher un article...</code></pre> </div> </div> <div class="paragraph"> <p>Και το αγγλικό του αντίστοιχο`messages_en.properties`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># Navigation nav.home=Home nav.blog=Blog nav.about=About nav.contact=Contact # Articles article.readmore=Read more article.published=Published on article.tags=Tags article.also.available=Also available in # Interface site.title=My Tech Blog site.description=Sharing knowledge and experiences footer.copyright=© 2025 All rights reserved search.placeholder=Search articles...</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_χρήση_στα_πρότυπα">Χρήση στα πρότυπα</h3> <div class="paragraph"> <p>Στα πρότυπα Thymeleaf σας, χρησιμοποιήστε τη σύνταξη`#{}`για να αποκτήσετε πρόσβαση στα μηνύματα:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <title th:text="#{site.title}">Mon Blog</title> <meta name="description" th:content="#{site.description}" /> </head> <body> <nav> <a th:href="@{/}" th:text="#{nav.home}">Accueil</a> <a th:href="@{/blog/}" th:text="#{nav.blog}">Blog</a> <a th:href="@{/about.html}" th:text="#{nav.about}">À propos</a> </nav> <footer> <p th:text="#{footer.copyright}">Copyright</p> </footer> </body> </html></code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_διάγραμμα_ακολουθίας_λύση_i18n">Διάγραμμα ακολουθίας - Λύση i18n</h3> <div class="listingblock"> <div class="content"> <pre>Failed to generate image: PlantUML preprocessing failed: [From <input> (line 4) ] @startuml actor Auteur participant JBake participant "AsciiDoc ^^^^^ Syntax Error? (Assumed diagram type: sequence) @startuml actor Auteur participant JBake participant "AsciiDoc αναλυτής" as parser participant "Thymeleaf Μηχανή" as thymeleaf participant "I18n\nΕπιλυτής" as i18n database "messages_*.properties" as messages Auteur -> JBake: jbake -b activate JBake JBake -> parser: Lire article.fr.adoc activate parser parser --> JBake: Contenu + métadonnées\n(lang=fr, article-id=xyz) deactivate parser JBake -> parser: Lire article.en.adoc activate parser parser --> JBake: Contenu + métadonnées\n(lang=en, article-id=xyz) deactivate parser JBake -> thymeleaf: Générer page FR activate thymeleaf thymeleaf -> i18n: Résoudre #{nav.home} activate i18n i18n -> messages: Lire messages_fr.properties messages --> i18n: "Αρχική" i18n --> thymeleaf: "Αρχική" deactivate i18n thymeleaf -> JBake: Rechercher traductions\n(article-id=xyz, lang!=fr) JBake --> thymeleaf: article.en.html trouvé thymeleaf --> JBake: /fr/blog/article.html deactivate thymeleaf JBake -> thymeleaf: Générer page EN activate thymeleaf thymeleaf -> i18n: Résoudre #{nav.home} activate i18n i18n -> messages: Lire messages_en.properties messages --> i18n: "σπίτι" i18n --> thymeleaf: "σπίτι" deactivate i18n thymeleaf -> JBake: Rechercher traductions\n(article-id=xyz, lang!=en) JBake --> thymeleaf: article.fr.html trouvé thymeleaf --> JBake: /en/blog/article.html deactivate thymeleaf JBake --> Auteur: Site généré deactivate JBake @enduml</pre> </div> </div> </div> <div class="sect2"> <h3 id="_ρύθμιση_της_τοπικότητας_στο_jbake">Ρύθμιση της τοπικότητας στο JBake</h3> <div class="paragraph"> <p>Στο αρχείο σας`jbake.properties`, Ορίστε την προεπιλεγμένη locale :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># Locale par défaut thymeleaf.locale=fr # Encodage template.encoding=UTF-8</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_i18n_των_άρθρων_οργάνωση_ανά_φάκελο">I18n των άρθρων : οργάνωση ανά φάκελο</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_διάγραμμα_ροής_flow_παραγωγή">Διάγραμμα ροής (Flow) - Παραγωγή</h3> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-a63fa7c2189f624232977d3528e9fae4.png" alt="Diagram" width="285" height="1035"> </div> </div> </div> <div class="sect2"> <h3 id="_δομή_φακέλων">Δομή φακέλων</h3> <div class="paragraph"> <p>Αντί να χρησιμοποιώ προσθέματα στα ονόματα αρχείων, προτίμησα μια οργάνωση ανά φάκελο που προσφέρει περισσότερη σαφήνεια και δυνατότητα συντήρησης:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">content/blog/ ├── 2024/ │ ├── fr/ │ │ ├── introduction-jbake.adoc │ │ ├── guide-thymeleaf.adoc │ │ └── astuces-asciidoc.adoc │ └── en/ │ ├── introduction-jbake.adoc │ ├── thymeleaf-guide.adoc │ └── asciidoc-tips.adoc └── 2025/ ├── fr/ │ └── internationalisation-jbake.adoc └── en/ └── jbake-internationalization.adoc</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_πλεονεκτήματα_αυτής_της_προσέγγισης">Πλεονεκτήματα αυτής της προσέγγισης</h3> <div class="paragraph"> <p>Αυτή η δομή προσφέρει πολλά πλεονεκτήματα :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Καθαρός διαχωρισμός</strong>: κάθε γλώσσα έχει το δικό της χώρο</p> </li> <li> <p><strong>Ευέλικτη ονοματοδότηση</strong>: τα αρχεία μπορούν να έχουν διαφορετικά ονόματα ανάλογα τη γλώσσα</p> </li> <li> <p><strong>Κλιμακωσιμότητα</strong>εύκολο να προσθέσεις μια νέα γλώσσα</p> </li> <li> <p><strong>Οργάνωση φυσική</strong>ακολουθεί τη χρονική λογική του JBake</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_μεταδεδομένα_των_άρθρων">Μεταδεδομένα των άρθρων</h3> <div class="paragraph"> <p>Κάθε άρθρο πρέπει να περιέχει μεταδεδομένα ώστε να επιτρέψει τη σύνδεση μεταξύ των μεταφράσεων. Εδώ είναι ένα παράδειγμα :</p> </div> <div class="paragraph"> <p><strong>Γαλλική έκδοση</strong>(<code>2025/fr/internationalisation-jbake.adoc</code>) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Internationalisation d'un site statique JBake :jbake-type: post :jbake-status: published :jbake-date: 2025-10-20 :jbake-lang: fr :jbake-article-id: jbake-i18n-thymeleaf :jbake-tags: jbake, thymeleaf, i18n :jbake-description: Guide pour mettre en place l'i18n avec JBake</code></pre> </div> </div> <div class="paragraph"> <p><strong>Αγγλική έκδοση</strong>(<code>2025/en/jbake-internationalization.adoc</code>) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Internationalizing a JBake Static Site :jbake-type: post :jbake-status: published :jbake-date: 2025-10-20 :jbake-lang: en :jbake-article-id: jbake-i18n-thymeleaf :jbake-tags: jbake, thymeleaf, i18n :jbake-description: Guide to implement i18n with JBake</code></pre> </div> </div> <div class="paragraph"> <p>Σημείωση: Το χαρακτηριστικό`:jbake-article-id:`είναι ζωτικό: επιτρέπει τη σύνδεση των διαφορετικών μεταφράσεων του ίδιου άρθρου.</p> </div> </div> <div class="sect2"> <h3 id="_ρύθμιση_των_url">�Ρύθμιση των URL</h3> <div class="paragraph"> <p>σε`jbake.properties`, Ρυθμίστε το πρότυπο URL για να συμπεριλάβετε τη γλώσσα :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># Pattern d'URL avec langue post.permalink.pattern=:lang/blog/:year/:name.html # Langue par défaut site.default.lang=fr</code></pre> </div> </div> <div class="paragraph"> <p>Αυτό θα δημιουργήσει URL του τύπου :</p> </div> <div class="ulist"> <ul> <li> <p><code>/fr/blog/2025/internationalisation-jbake.html</code></p> </li> <li> <p><code>/en/blog/2025/jbake-internationalization.html</code></p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πρότυπα_για_πολυγλωτική_εμφάνιση">Πρότυπα για πολυγλωτική εμφάνιση</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_πρότυπο_άρθρου_με_επιλογή_γλώσσας">Πρότυπο άρθρου με επιλογή γλώσσας</h3> <div class="paragraph"> <p>Δημιουργήστε ένα πρότυπο`post.html`που εμφανίζει τις διαθέσιμες μεταφράσεις:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <title th:text="${content.title}">Article</title> </head> <body> <article> <header> <h1 th:text="${content.title}">Titre</h1> <div class="article-meta"> <time th:text="${#dates.format(content.date, 'dd MMMM yyyy')}" th:attr="datetime=${#dates.format(content.date, 'yyyy-MM-dd')}"> Date </time> <!-- Sélecteur de traductions --> <div class="translations" th:if="${content['article-id']}"> <span th:text="#{article.also.available}">Aussi disponible en :</span> <ul class="language-list"> <li th:each="post : ${published_posts}" th:if="${post['article-id'] == content['article-id'] and post.lang != content.lang}"> <a th:href="${post.uri}" th:text="${post.lang.toUpperCase()}"> LANG </a> </li> </ul> </div> </div> </header> <div class="content" th:utext="${content.body}"> Contenu de l'article </div> <footer class="article-footer"> <div class="tags" th:if="${content.tags}"> <span th:text="#{article.tags}">Étiquettes :</span> <span th:each="tag : ${content.tags}"> <a th:href="@{/tags/{tag}.html(tag=${tag})}" th:text="${tag}">tag</a> </span> </div> </footer> </article> </body> </html></code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ευρετήριο_φιλτραρισμένο_ανά_γλώσσα">Ευρετήριο φιλτραρισμένο ανά γλώσσα</h3> <div class="paragraph"> <p>Δημιουργήστε πρότυπα ευρετηρίου για κάθε γλώσσα:</p> </div> <div class="paragraph"> <p><strong>index.html</strong>(ευρετήριο γαλλικό) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <title th:text="#{site.title}">Mon Blog</title> </head> <body> <main> <h1 th:text="#{nav.blog}">Blog</h1> <div class="articles-list"> <article th:each="post : ${published_posts}" th:if="${post.lang == 'fr'}"> <h2> <a th:href="${post.uri}" th:text="${post.title}">Titre</a> </h2> <time th:text="${#dates.format(post.date, 'dd MMMM yyyy')}"> Date </time> <p th:text="${post.description}">Description</p> <a th:href="${post.uri}" th:text="#{article.readmore}"> Lire la suite </a> </article> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><strong>index_en.html</strong>(Αγγλικό ευρετήριο) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html xmlns:th="http://www.thymeleaf.org"> <head> <title th:text="#{site.title}">My Blog</title> </head> <body> <main> <h1 th:text="#{nav.blog}">Blog</h1> <div class="articles-list"> <article th:each="post : ${published_posts}" th:if="${post.lang == 'en'}"> <h2> <a th:href="${post.uri}" th:text="${post.title}">Title</a> </h2> <time th:text="${#dates.format(post.date, 'dd MMMM yyyy')}"> Date </time> <p th:text="${post.description}">Description</p> <a th:href="${post.uri}" th:text="#{article.readmore}"> Read more </a> </article> </div> </main> </body> </html></code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πλοήγηση_μεταξύ_γλωσσών">Πλοήγηση μεταξύ γλωσσών</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_παγκόσμιος_επιλογέας_γλώσσας">παγκόσμιος επιλογέας γλώσσας</h3> </div> <div class="sect2"> <h3 id="_διάγραμμα_ροής_ανάγνωση_χρήστη">Διάγραμμα ροής - Ανάγνωση χρήστη</h3> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-35c457cfbd1b9be0156f6bbbfb2925d1.png" alt="Diagram" width="494" height="761"> </div> </div> <div class="paragraph"> <p>Προσθέστε ένα επιλογέα γλώσσας στο κύριο πρότυπό σας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><nav class="language-switcher"> <a href="/index.html" th:classappend="${content.lang == 'fr'} ? 'active'" title="Français"> 🇫🇷 FR </a> <a href="/en/index.html" th:classappend="${content.lang == 'en'} ? 'active'" title="English"> 🇬🇧 EN </a> </nav></code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_στυλ_css_για_τον_επιλογέα">Στυλ CSS για τον επιλογέα</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">.language-switcher { display: flex; gap: 1rem; padding: 0.5rem; background: #f5f5f5; border-radius: 4px; } .language-switcher a { padding: 0.5rem 1rem; text-decoration: none; color: #333; border-radius: 4px; transition: background 0.2s; } .language-switcher a:hover { background: #e0e0e0; } .language-switcher a.active { background: #007bff; color: white; } .translations { margin: 1rem 0; padding: 1rem; background: #f8f9fa; border-left: 4px solid #007bff; } .language-list { display: inline-flex; gap: 0.5rem; list-style: none; padding: 0; margin: 0; } .language-list li::after { content: "•"; margin-left: 0.5rem; } .language-list li:last-child::after { content: ""; }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ροή_rss_ανά_γλώσσα">�Ροή RSS ανά γλώσσα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να έχετε χωριστά ροές RSS ανά γλώσσα, δημιουργήστε ξεχωριστά προτύπα:</p> </div> <div class="paragraph"> <p><strong>feed.xml</strong>(γαλλική ροή) :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?> <rss version="2.0" xmlns:th="http://www.thymeleaf.org"> <channel> <title th:text="#{site.title}">Mon Blog</title> <link th:text="${config.site_host}">http://example.com</link> <description th:text="#{site.description}">Description</description> <language>fr</language> <item th:each="post : ${published_posts}" th:if="${post.lang == 'fr'}"> <title th:text="${post.title}">Titre</title> <link th:text="${config.site_host + post.uri}">Lien</link> <pubDate th:text="${#dates.format(post.date, 'EEE, dd MMM yyyy HH:mm:ss Z')}"> Date </pubDate> <description th:text="${post.description}">Description</description> </item> </channel> </rss></code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_καλές_πρακτικές_και_συμβουλές">Καλές πρακτικές και συμβουλές</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_1_συμφωνία_των_αναγνωριστικών_άρθρων">1. Συμφωνία των αναγνωριστικών άρθρων</h3> <div class="paragraph"> <p>Βεβαιωθείτε ότι`:jbake-article-id:`είναι identique για όλες τις μεταφράσεις ενός ίδιου άρθρου. Χρησιμοποιήστε μια συνεπή μορφή :</p> </div> <div class="ulist"> <ul> <li> <p>Προτιμάτε τα αναγνωριστικά στα αγγλικά για παγκόσμιότητα</p> </li> <li> <p>Χρησιμοποιείτε παύλες για να χωρίζετε τις λέξεις</p> </li> <li> <p>Αποφύγετε τους ειδικούς χαρακτήρες</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_2_συνεπείς_ημερομηνίες">2. Συνεπείς ημερομηνίες</h3> <div class="paragraph"> <p>Οι μεταφράσεις ενός άρθρου πρέπει να έχουν την ίδια ημερομηνία δημοσίευσης (<code>:jbake-date:</code>). Αυτό διευκολύνει την ταξινόμηση και τη χρονολογική εμφάνιση.</p> </div> </div> <div class="sect2"> <h3 id="_3_ετικέτες_πολυγλωσσικές">3. Ετικέτες πολυγλωσσικές</h3> <div class="paragraph"> <p>Για τα tags, έχετε δύο επιλογές:</p> </div> <div class="paragraph"> <p><strong>Επλογή 1 : ετικέτες ουνιρσέρσαλες στα αγγλίκά</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">:jbake-tags: java, spring-boot, microservices</code></pre> </div> </div> <div class="paragraph"> <p><strong>Επιλογή 2 : Ετικέτες μεταφρασμένες με mapping</strong></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc"># Version française :jbake-tags: java, spring-boot, microservices # Version anglaise :jbake-tags: java, spring-boot, microservices</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_4_διαχείριση_άρθρων_που_δεν_έχουν_μεταφραστεί">4. Διαχείριση άρθρων που δεν έχουν μεταφραστεί</h3> <div class="paragraph"> <p>Δεν είναι υποχρεωτικό να μεταφράσετε όλα τα άρθρα. Εάν ένα άρθρο υπάρχει μόνο σε μια γλώσσα, τότε δεν θα εμφανιστεί απλώς στα listings της άλλης γλώσσας.</p> </div> </div> <div class="sect2"> <h3 id="_5_πολυγλωσσικός_sitemap">5. Πολυγλωσσικός sitemap</h3> <div class="paragraph"> <p>Δημιουργήστε ένα sitemap που περιλαμβάνει όλες τις γλώσσες :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-xml hljs" data-lang="xml"><?xml version="1.0" encoding="UTF-8"?> <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9" xmlns:xhtml="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"> <url th:each="post : ${published_posts}"> <loc th:text="${config.site_host + post.uri}">URL</loc> <lastmod th:text="${#dates.format(post.date, 'yyyy-MM-dd')}">Date</lastmod> <!-- Liens alternatifs pour les traductions --> <xhtml:link th:each="translation : ${published_posts}" th:if="${translation['article-id'] == post['article-id'] and translation.lang != post.lang}" rel="alternate" th:attr="hreflang=${translation.lang},href=${config.site_host + translation.uri}" /> </url> </urlset></code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η διεθντοποίηση ενός site JBake με Thymeleaf είναι μια ισχυρή και συντηρήσιμη προσέγγιση. Χωρίζοντας το i18n από το templating (μέσω των αρχείων μηνυμάτων) και το i18n από το περιεχόμενο (μέσω της οργάνωσης σε φακέλους), παίρνετε ένα ευέλικτο σύστημα που μπορεί να εξελιχθεί εύκολα.</p> </div> <div class="paragraph"> <p>Τα βασικά σημεία που πρέπει να θυμηθείς:</p> </div> <div class="ulist"> <ul> <li> <p><strong>Αρχεία μηνυμάτων Thymeleaf</strong>για τη διεπαφή χρήστη</p> </li> <li> <p><strong>Οργάνωση ανά φάκελο</strong>(έτος/γλώσσα) για τα άρθρα</p> </li> <li> <p><strong>Αναγνωριστικά άρθρου</strong>για τη σύνδεση των μεταφράσεων</p> </li> <li> <p><strong>Πρότυπα δεσμευμένα</strong>για κάθε γλώσσα</p> </li> <li> <p><strong>σαφείς URL</strong>συμπεριλαμβανομένου του κώδικα γλώσσας</p> </li> </ul> </div> <div class="sect2"> <h3 id="_διάγραμμα_διανομής">Διάγραμμα διανομής</h3> <div class="listingblock"> <div class="content"> <pre>Failed to generate image: PlantUML preprocessing failed: [From <input> (line 14) ] @startuml node "Μηχανή ανάπτυξης" { artifact "Πηγές" { folder "χαρούμενος/" folder "πρότυπα/" folder "assets/" } component "JBake CLI" as jbake Sources --> jbake : jbake -b } node "Σερβερ κατασκευής ^^^^^ Syntax Error? (Assumed diagram type: component) @startuml node "Μηχανή ανάπτυξης" { artifact "Πηγές" { folder "χαρούμενος/" folder "πρότυπα/" folder "assets/" } component "JBake CLI" as jbake Sources --> jbake : jbake -b } node "Σερβερ κατασκευής (CI/CD)" { component "GitHub Actions ή GitLab CI" as ci jbake --> ci : push } cloud "CDN / Φιλοξενία" { node "Στατικός διακομιστής web" { artifact "Δημιουργημένο ιστότοπος" { folder "/fr/blog/" folder "/en/blog/" folder "/assets/" } } } ci --> "Δημιουργημένο ιστότοπος" : déploiement actor "Αναγνώστες" as users users --> "Στατικός διακομιστής web" : HTTPS @enduml</pre> </div> </div> <div class="paragraph"> <p>Αυτή η αρχιτεκτονική σας επιτρέπει να ξεκινήσετε απλώς με δύο γλώσσες και να προσθέσετε άλλες χωρίς σημαντικό ανασχέδιασμα. Όλο το σύστημα παραμένει πλήρως στατικό και αποδοτικό, πιστό στην φιλοσοφία του JBake.</p> </div> <div class="paragraph"> <p>Καλή πολυγλωσσική ανάπτυξη! 🌍</p> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0094_tor_browser_install_post.html Sun, 5 Oct 2025 00:00:00 +0000 blog/2025/0094_tor_browser_install_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_λήψη_του_tor_και_της_υπογραφής_του">Λήψη του Tor και της υπογραφής του</a></li> <li><a href="#_κρυπτογραφική_επαλήθευση_της_υπογραφής">Κρυπτογραφική επαλήθευση της υπογραφής</a> <ul class="sectlevel2"> <li><a href="#_εισαγάγετε_το_δημόσιο_κλειδί_του_tor_project">Εισαγάγετε το δημόσιο κλειδί του Tor Project</a></li> <li><a href="#_2_έλεγχος_της_υπογραφής">2. Έλεγχος της υπογραφής</a></li> <li><a href="#_πρακτική_περίπτωση_υπογραφή_έγκυρη_αλλά_μη_πιστοποιημένο_κλειδί">Πρακτική περίπτωση: υπογραφή έγκυρη αλλά μη πιστοποιημένο κλειδί</a></li> </ul> </li> <li><a href="#_γιατί_να_ελέγξουμε_την_υπογραφή">Γιατί να ελέγξουμε την υπογραφή;</a></li> <li><a href="#_εξαγωγή_και_εκκίνηση_του_tor_browser">Εξαγωγή και εκκίνηση του Tor Browser</a></li> <li><a href="#_ενσωμάτωση_στο_ubuntu_desktop">Ενσωμάτωση στο Ubuntu Desktop</a></li> <li><a href="#_εξερευνήστε_εκπαιδευτικούς_πόρους_με_το_tor">Εξερευνήστε εκπαιδευτικούς πόρους με το Tor</a></li> <li><a href="#_ενημέρωση_του_tor_browser">Ενημέρωση του Tor Browser</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> <li><a href="#_αναφορές">Αναφορές</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <p>Σε έναν κόσμο όπου η ψηφιακή ιδιωτικότητα γίνεται πλέον πιο απειλούμενη, <strong>Tor Browser</strong> μένει ένα βασικό εργαλείο για τη διατήρηση της ανωνυμίας του και της ελευθερίας πληροφόρησης του. Ω</tool_call>, είναι ζωτικό να μην εκτελείτε ποτέ ένα ληφθέν λογισμικό χωρίς να<strong>εβέβαιωσε την αυθεντικότητά του</strong>. Αυτό το άρθρο παρουσιάζει μια πλήρη μέθοδος για :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Κατεβάστε <strong>Tor Browser</strong> και την υπογραφή του`.asc`</p> </li> <li> <p>Έλεγχος εγκυρότητας του ληφθέντος αρχείου</p> </li> <li> <p>Εγκατάσταση και εκκίνηση <strong>Tor Browser</strong> στο Ubuntu</p> </li> <li> <p>Προσθήκη στα μενού της επιφάνειας εργασίας για καθημερινή χρήση</p> </li> <li> <p>Εξερευνώντας εκπαιδευτικούς πόρους και ηθικό OSINT μέσω Tor</p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_λήψη_του_tor_και_της_υπογραφής_του">Λήψη του Tor και της υπογραφής του</h2> <div class="sectionbody"> <div class="paragraph"> <p>Δημιουργήστε έναν ειδικό φάκελο για τον περιηγητή Tor :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">mkdir -p ~/workspace/tipiak/tor cd ~/workspace/tipiak/tor</code></pre> </div> </div> <div class="paragraph"> <p>Κατεβάστε στη συνέχεια το αρχείο του φυλλομετρητή Tor και τη υπογραφή του:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">wget https://www.torproject.org/dist/torbrowser/14.5.7/tor-browser-linux-x86_64-14.5.7.tar.xz wget https://www.torproject.org/dist/torbrowser/14.5.7/tor-browser-linux-x86_64-14.5.7.tar.xz.asc</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_κρυπτογραφική_επαλήθευση_της_υπογραφής">Κρυπτογραφική επαλήθευση της υπογραφής</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτό το βήμα είναι<strong>απρόσθατο</strong>για να βεβαιωθείτε ότι το αρχείο που κατεβάσατε προέρχεται πράγματι από το <strong>Tor Project</strong> και δεν έχει τροποποιηθεί.</p> </div> <div class="sect2"> <h3 id="_εισαγάγετε_το_δημόσιο_κλειδί_του_tor_project">Εισαγάγετε το δημόσιο κλειδί του Tor Project</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gpg --auto-key-locate nodefault,wkd --locate-keys torbrowser@torproject.org</code></pre> </div> </div> <div class="paragraph"> <p>Επιβεβαιώστε ότι το κλειδί είναι σωστά εισαγμένο:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gpg --list-keys torbrowser@torproject.org</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_2_έλεγχος_της_υπογραφής">2. Έλεγχος της υπογραφής</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gpg --verify tor-browser-linux-x86_64-14.5.7.tar.xz.asc tor-browser-linux-x86_64-14.5.7.tar.xz</code></pre> </div> </div> <div class="paragraph"> <p>Αν όλα είναι σωστά, θα εμφανιστεί το ακόλουθο μήνυμα:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">gpg: Good signature from "Tor Browser Developers (signing key)"</code></pre> </div> </div> <div class="paragraph"> <p>Σε trường προειδοποίησης για μη πιστοποιημένο κλειδί, αυτό σημαίνει απλώς ότι δεν έχετε ακόμα υπογράψει το αξιόπιστο κλειδί του Project Tor, αλλά η υπογραφή παραμένει έγκυρη.</p> </div> </div> <div class="sect2"> <h3 id="_πρακτική_περίπτωση_υπογραφή_έγκυρη_αλλά_μη_πιστοποιημένο_κλειδί">Πρακτική περίπτωση: υπογραφή έγκυρη αλλά μη πιστοποιημένο κλειδί</h3> <div class="paragraph"> <p>Συχνά συναντείτε ένα μήνυμα όπως αυτό κατά τη διάρκεια του ελέγχου :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">gpg --verify tor-browser-linux-x86_64-14.5.7.tar.xz.asc tor-browser-linux-x86_64-14.5.7.tar.xz gpg: Signature faite le mar. 16 sept. 2025 14:26:26 CEST gpg: avec la clef RSA CAAE408AEBE2288E96FC5D5E157432CF78A65729 gpg: Bonne signature de « Tor Browser Developers (signing key) <torbrowser@torproject.org> » [inconnu] gpg: Attention : cette clef n'est pas certifiée avec une signature de confiance. gpg: Rien n'indique que la signature appartient à son propriétaire. Empreinte de clef principale : EF6E 286D DA85 EA2A 4BA7 DE68 4E2C 6E87 9329 8290 Empreinte de la sous-clef : CAAE 408A EBE2 288E 96FC 5D5E 1574 32CF 78A6 5729</code></pre> </div> </div> <div class="paragraph"> <p>Αυτό το μηνυμα υποδεικνύει ότι η υπογραφή είναι τεχνικά "καλή" (το αρχείο δεν έχει αλλάξει), αλλά το GPG σύστημα σας δεν μπορεί να <strong>βεβαιώσει την εμπιστοσύνη</strong> στον κλειδί αυτόν. Για να απολύσετε αυτή τη διστασία, είναι αναγκαίο να συγκρίνετε το αποδεικτικό του κύριου κλειδιού (<code>EF6E 286D DA85 EA2A 4BA7 DE68 4E2C 6E87 9329 8290</code>) με αυτή που δημοσιεύεται στην επίσημη ιστοσελίδα του Tor Project.</p> </div> <div class="paragraph"> <p>Συμφωνα με την επίσημη ιστοσελίδα, η αναμενόμενη αποτύπωση είναι:`EF6E286DDA85EA2A4BA7DE684E2C6E8793298290`.</p> </div> <div class="paragraph"> <p>Επειδή η εμφανιζόμενη αποτυπωμένη από`gpg`ταιριάζει <strong>ακριβώς</strong> με αυτήν του επίσημου ιστότοπου, μπορείτε να βεβαιωθείτε ότι το κλειδί είναι νόμιμο και ότι το αρχείο είναι ασφαλές. Η προειδοποίηση για «κλειδί μη πιστοποιημένο» είναι τότε μια πληροφορία για την τοπική σας ρύθμιση GPG, και όχι για την εγκυρότητα της υπογραφής ή την αυθεντικότητα του αρχείου.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_γιατί_να_ελέγξουμε_την_υπογραφή">Γιατί να ελέγξουμε την υπογραφή;</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η επαλήθευση των υπογραφών GPG είναι ένα θεμελιώδες πράγμα ψηφιακής ασφάλειας. Επιτρέπει να:</p> </div> <div class="ulist"> <ul> <li> <p>εγγυάω<strong>η αυθεντικότητα</strong>του κατεβασμένου λογισμικού</p> </li> <li> <p>Αποτρέψτε την εγκατάσταση ενός αρχείου που είναι διαπρασμένο από έναν κακόβουλο δράστη.</p> </li> <li> <p>Συμμετοχή στην<strong>ψηφιακή κυριαρχία</strong>ατομική</p> </li> <li> <p>Προωθεί μια υπεύθυνη και ηθική ψηφιακή κουλτούρα</p> </li> </ul> </div> <div class="imageblock"> <div class="content"> <img src="usecase-tor-verification.svg" alt="usecase tor verification" width="477" height="308"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_εξαγωγή_και_εκκίνηση_του_tor_browser">Εξαγωγή και εκκίνηση του Tor Browser</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αποσυμπιέστε τη φορτωμένη αρχειοθήκη:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">tar -xvf tor-browser-linux-x86_64-14.5.7.tar.xz cd tor-browser</code></pre> </div> </div> <div class="paragraph"> <p>Εκκινήστε τον περιηγητή στη συνέχεια :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./start-tor-browser.desktop</code></pre> </div> </div> <div class="paragraph"> <p>Κατά την πρώτη εκκίνηση, θα ανοίξει ένα παράθυρο ρυθμίσεων για να καθορίσει τη σύνδεση στο δίκτυο Tor.</p> </div> </div> </div> <div class="sect1"> <h2 id="_ενσωμάτωση_στο_ubuntu_desktop">Ενσωμάτωση στο Ubuntu Desktop</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να προσθέσετε το <strong>Tor Browser</strong> στο μενού εφαρμογών :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">./start-tor-browser.desktop --register-app</code></pre> </div> </div> <div class="paragraph"> <p>Μπορείτε στη συνέχεια :</p> </div> <div class="ulist"> <ul> <li> <p>Εκκίνησε <strong>Tor Browser</strong> από το μενού των εφαρμογών</p> </li> <li> <p>Προσθήκη στα αγαπημένα του dock</p> </li> <li> <p>Δημιουργήστε ένα συντόμευμα πληκτρολογίου εάν επιθυμείτε</p> </li> </ul> </div> <div class="imageblock"> <div class="content"> <img src="activity-tor-installation.svg" alt="activity tor installation" width="457" height="470"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_εξερευνήστε_εκπαιδευτικούς_πόρους_με_το_tor">Εξερευνήστε εκπαιδευτικούς πόρους με το Tor</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το Tor δεν είναι μόνο ένα εργαλείο ανωνυμίας. Το Constitues…​ I’m sorry, I cannot provide a correct translation.</p> </div> <div class="ulist"> <ul> <li> <p><strong>OSINT (Ανοιχτού Κώδικα Πληροφοριών)</strong></p> </li> <li> <p><a href="https://inteltechniques.com">https://inteltechniques.com</a></p> </li> <li> <p><a href="https://osintframework.com">https://osintframework.com</a></p> </li> <li> <p><strong>Εκπαιδευτική κοινή χρήση και ανοιχτός κώδικας</strong></p> </li> <li> <p><a href="https://archive.org">https://archive.org</a>(πρόσβαση μέσω Tor για περισσότερη ιδιωτικότητα)</p> </li> <li> <p><a href="https://github.com/">https://github.com/</a>(πρόσβατο μέσω Tor)</p> </li> <li> <p><a href="https://librarygenesis.pro">https://librarygenesis.pro</a>(ελεύθερη επιστημονική λιτετρατύρα)</p> </li> <li> <p><strong>Μετάδοση γνώσης και κατανόηση του ανθρώπου στη ψηφιακή κοινωνία</strong></p> </li> <li> <p>Πόροι για τη ψηφιακή κουλτούρα, την ελευθερία έκφρασης και την πρόσβαση στη γνώση</p> </li> <li> <p>Ελεύθερη τεκμηρίωση για την υβασφάλεια και την ηθική των τεχνολογιών</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_ενημέρωση_του_tor_browser">Ενημέρωση του Tor Browser</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να εξασφαλίσετε βέλτιστη ασφάλεια, είναι κρίσιμο να διατηρείτε το <strong>Tor Browser</strong> ενημερωμένο. Ο περιηγητής ενσωματεί ένα μηχανισμό αυτόματης ενημέρωσης που μπορεί να ενεργοποιηθεί από τη γραμμή εντολών.</p> </div> <div class="paragraph"> <p>Από τον φάκελο εγκατάστασης του Tor Browser, αρκεί να επανεκκινήσετε το script εκκίνησης :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">cd ~/workspace/tipiak/tor/tor-browser ./start-tor-browser.desktop</code></pre> </div> </div> <div class="paragraph"> <p>Κατά την εκκίνηση, <strong>Tor Browser</strong> θα ελέγξει αυτόματα εάν υπάρχει μια νέα έκδοση. Αν είναι έτσι, θα τη κατεβάσει και θα τη εγκαταστήσει για εσάς.</p> </div> <div class="paragraph"> <p>Αυτή η απλή μέθοδος εξασφαλίζει ότι έχετε πάντα τις τελευταίες ενημερώσεις ασφαλείας και τις πιο πρόσφατες βελτιώσεις, το οποίο είναι ζωτικής σημασίας για ασφαλή περιήγηση.</p> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η επαλήθευση των λήψέων σας είναι ένας ζωτικός αυτόματης ανταπόκρισης μηχανισμός για κάθε άτομο που θέλει να κινείται σε ασφαλή ψηφιακό περιβάλλον. Η εγκατάσταση του Tor με επιβεβαίωση, είναι<strong>προστατεύστε τη ψηφιακή ακεραιότητά του</strong>, <strong>διατηρήστε την εμπιστοσύνη στο ελεύθερο λογισμικό</strong>, et <strong>ενισχύστε τη πληροφορική αυτονομία του</strong>.</p> </div> <div class="paragraph"> <p>Η ψηφιακή ασφάλεια είναι ένα πράγμα της συνείδησης, όχι της παρανοίας.</p> </div> <div class="imageblock"> <div class="content"> <img src="summary-diagram.svg" alt="summary diagram" width="482" height="203"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αναφορές">Αναφορές</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Επίσημη ιστοσελίδα του Tor Project:https://www.torproject.org/download/[<a href="https://www.torproject.org/download/" class="bare">https://www.torproject.org/download/</a>]</p> </li> <li> <p>Τεκμηρίωση επαλήθευσης υπογραφών:https://support.torproject.org/tbb/how-to-verify-signature/[<a href="https://support.torproject.org/tbb/how-to-verify-signature/" class="bare">https://support.torproject.org/tbb/how-to-verify-signature/</a>]</p> </li> <li> <p>Τεκμηρίωση Ubuntu :https://ubuntu.com[<a href="https://ubuntu.com" class="bare">https://ubuntu.com</a>]</p> </li> <li> <p>Εκπαιδευτικό αρχείο:https://archive.org/details/opensource[<a href="https://archive.org/details/opensource" class="bare">https://archive.org/details/opensource</a>]</p> </li> </ul> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>Αυτό το άρθρο είναι μέρος της σειράς <strong>Ασφάλεια και ψηφιακή συνείδηση</strong>. στοχεύοντας να προωθήσει υπεύθυνες και παιδαγωγικές πρακτικές Περί των ελεύθερων εργαλείων.</p> </div> </td> </tr> </table> </div> </div> </div> https://cheroliv.com/blog/2025/0093_gradle_plugin_toml_composite_build_post.html Sat, 27 Sep 2025 00:00:00 +0000 blog/2025/0093_gradle_plugin_toml_composite_build_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_ο_κατάλογος_εκδόσεων_libs_versions_toml_μια_υπενθύμιση">Ο Κατάλογος Εκδόσεων (<code>libs.versions.toml</code>) : Μια υπενθύμιση</a></li> <li><a href="#_2_το_πρόβλημα_ένας_σύνθετος_build_και_δύο_χωρισμένοι_κόσμοι">2. Το πρόβλημα: Ένας σύνθετος Build και δύο χωρισμένοι κόσμοι</a></li> <li><a href="#_3_η_λύση_κοινόχρηστη_επίλυση_εξαρτήσεων">3. Η Λύση : Κοινόχρηστη επίλυση εξαρτήσεων</a></li> <li><a href="#_4_συμπέρασμα_η_δύναμη_των_καλά_διαχειριζόμενων_συνθέτικών_κατασκευών">4. Συμπέρασμα: Η δύναμη των καλά διαχειριζόμενων συνθέτικών κατασκευών</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Στοχευόμενο κοινό : Οι Gradle developers αντιμετωπίζουν τη διαχείριση εξαρτήσεων σε έργα multi-build.</div> <p>Στην αναζητήση μας για τη δημιουργία του plugin`site-baker`, έχουμε προσπαθήσει να διατηρήσουμε μια καθαρή και κεντρική βάση κώδικα. Μία από τις καλύτερες πρακτικές στο σύγχρονο οικοσύστημα Gradle είναι η χρήση του<strong>κατάλογος εκδόσεων</strong>(<code>libs.versions.toml</code>) για να διαχειριστείτε τις εξαρτήσεις. Αλλά τι συμβαίνει когда το έργο σας γίνεται πιο πολύπλοκο, όπως ένα<strong>να χτίσουμε σύνθετο</strong>où ένα ανεξάρτητο build (το plugin μας) πρέπει να συμπεριληφθεί σε ένα άλλο?</p> </div> <div class="paragraph"> <p>Εδώ η περιπέτειά μας πήρε μια απροσδόκητη στροφή. Θέλνα το plugin μας.<code>site-baker</code>, που είναι ίδιο το Gradle project, χρησιμοποιεί το ίδιο κατάλογο εκδόσεων με το κύριο project μας. Αυτό το άρθρο, το πέμπτο της σειράς μας, λέει πώς λύσαμε αυτήν τη πρόκληση.</p> </div> </div> </div> <div class="sect1"> <h2 id="_ο_κατάλογος_εκδόσεων_libs_versions_toml_μια_υπενθύμιση">Ο Κατάλογος Εκδόσεων (<code>libs.versions.toml</code>) : Μια υπενθύμιση</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το αρχείο`gradle/libs.versions.toml`είναι μια λειτουργία του Gradle που επιτρέπει την κεντρική διαχείριση των εκδόσεων και των συντεταγμένων των εξαρτήσεων του έργου σας. Συνήθως είναι δομημένο σε τέσσερις ενότητες :</p> </div> <div class="ulist"> <ul> <li> <p><code>[versions]</code>: Ορίζει ψευδώνυμα για τους αριθμούς εκδόσεων (π.χ.<code>kotlin = "1.9.20"</code>).</p> </li> <li> <p><code>[libraries]</code>: Ορίζει ψευδώνυμα για τις πλήρεις εξαρτήσεις, χρησιμοποιώντας τις εκδόσεις που ορίστηκαν παραπάνω (π.χ.<code>kotlin-stdlib = { module = "org.jetbrains.kotlin:kotlin-stdlib", version.ref = "kotlin" }</code>)</p> </li> <li> <p><code>[bundles]</code>: Ομαδοποιεί διάφορες βιβlioθήκες υπό ένα μόνο ψευδώνυμο (πχ:`jackson = ["jackson-core", "jackson-databind"]`).</p> </li> <li> <p><code>[plugins]</code>: Ορίζει ψευδώνυμα για τα πρόσθετα Gradle.</p> </li> </ul> </div> <div class="paragraph"> <p>Μια φορά που ορίζεται, o Gradle δημιουργεί αυτόματα τύπους προσβασιμότητας, κάνοντάς το`build.gradle.kts`πολύ πιο ευάνγνωστο :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">dependencies { // Au lieu de : implementation("org.jetbrains.kotlin:kotlin-stdlib:1.9.20") implementation(libs.kotlin.stdlib) }</code></pre> </div> </div> <div class="imageblock"> <div class="content"> <img src="toml-flow.svg" alt="toml flow" width="587" height="252"> </div> <div class="title">Figure 1. Ροή δεδομένων του καταλόγου εκδόσεων</div> </div> </div> </div> <div class="sect1"> <h2 id="_2_το_πρόβλημα_ένας_σύνθετος_build_και_δύο_χωρισμένοι_κόσμοι">2. Το πρόβλημα: Ένας σύνθετος Build και δύο χωρισμένοι κόσμοι</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η δομή του έργου μας είναι ένα<strong>Χτίστε το σύνθετο</strong>. Το κύριο έργο (<code>thymeleaf.cheroliv.com</code>) περιλαμβάνει το έργο του plugin (<code>site-baker</code>) μέσω της εντολής`includeBuild("site-baker")<code>στο αρχείο`settings.gradle.kts</code>.</p> </div> <div class="imageblock"> <div class="content"> <img src="composite-build.svg" alt="composite build" width="1628" height="5720"> </div> <div class="title">Figure 2. Δομή του build συνθετου</div> </div> <div class="paragraph"> <p>Το πρόβλημα είναι ότι, προεπιλογώς, ένα build που συμπεριλαμβάνεται είναι ένα<strong>διαχωρισμΈνος κόσμος</strong>. Έχει τη δική του ρύθμιση, το δικό του κύκλο ζωής, και δεν βλέπει το αρχείο`libs.versions.toml`Η κύρια κατασκευή. Το δικό μας`plugin/build.gradle.kts`προσπαθούσε να το χρησιμοποιήσει`libs.plugins.kotlin.jvm`, αλλά το αντικείμενο`libs`Δεν δημιούργησε από το σωστό αρχείο TOML, προκαλώντας σφάλματα κατασκευής.</p> </div> </div> </div> <div class="sect1"> <h2 id="_3_η_λύση_κοινόχρηστη_επίλυση_εξαρτήσεων">3. Η Λύση : Κοινόχρηστη επίλυση εξαρτήσεων</h2> <div class="sectionbody"> <div class="paragraph"> <p>Μετά από πολλές έρευνες, η λύση αποδείχθηκε ότι είναι μια λειτουργικότητα του Gradle που σχεδιάστηκε ειδικά για αυτή τη περίπτωση:`dependencyResolutionManagement`.</p> </div> <div class="paragraph"> <p>Στο αρχείο`settings.gradle.kts` du <strong>κατασκευή συμπεριλαμβανομένη</strong>(<code>site-baker/settings.gradle.kts</code>), μπορούμε να πούμε στο Gradle πού να βρει τον κατάλογο εκδόσεων που θα χρησιμοποιηθεί.</p> </div> <div class="paragraph"> <p>Εδώ είναι η ρύθμιση που προσθέσαμε σε`site-baker/settings.gradle.kts` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// site-baker/settings.gradle.kts dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { gradlePluginPortal() mavenCentral() } versionCatalogs { create("libs") { from(files("../gradle/libs.versions.toml")) } } } rootProject.name = "site-baker" include("plugin")</code></pre> </div> </div> <div class="paragraph"> <p>Αναλύουμε την κρίσιμη ενότητα:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">versionCatalogs { create("libs") { // Crée un catalogue nommé 'libs' from(files("../gradle/libs.versions.toml")) // En utilisant ce fichier } }</code></pre> </div> </div> <div class="ulist"> <ul> <li> <p><code>create("libs")</code>: Δηλώνουμε έναν κατάλογο εκδόσεων που θα είναι προσβάσιμος μέσω του alias`libs`.</p> </li> <li> <p><code>from(files("../gradle/libs.versions.toml"))</code>: Αυτό είναι η μαγεία. Ενημερώνουμε το Gradle ότι η πηγή αυτού του καταλόγου είναι το αρχείο TOML που βρίσκεται στον κατάλογο.<code>gradle</code> du <strong>γονικό έργο</strong>(empty)<code>../</code>)</p> </li> </ul> </div> <div class="paragraph"> <p>Με αυτή τη ρύθμιση, η κατασκευή`site-baker`�Ξέρει τώρα ότι πρέπει να χρησιμοποιήσει τον κατάλογο εκδόσεων του κύριου έργου. Το αντικείμενο`libs`γεννείται σωστά, και οι εξαρτήσεις είναι λυμένες όπως περίμενα.</p> </div> </div> </div> <div class="sect1"> <h2 id="_4_συμπέρασμα_η_δύναμη_των_καλά_διαχειριζόμενων_συνθέτικών_κατασκευών">4. Συμπέρασμα: Η δύναμη των καλά διαχειριζόμενων συνθέτικών κατασκευών</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτή η εμπειρία ήταν πλούσια σε διδακτικά. Ο κατάλογος εκδόσεων είναι ένα εξαιρετικό εργαλείο για τη συντηρησιμότητα, αλλά η συμπεριballe του σε σενάρια σύνθετων κατασκευών δεν είναι πάντα intuïtικη.</p> </div> <div class="paragraph"> <p>Η κλειδί είναι να θυμάσαι ότι ένα build που περιλαμβάνεται παραμένει ανεξάρτητο build. Για να μοιραστείς τις ρυθμίσεις όπως το κατάλογο εκδόσεων, πρέπει να χρησιμοποιήσεις τις ρητές μηχανισμούς που παρέχονται από το Gradle, όπως το block`dependencyResolutionManagement`σε`settings.gradle.kts`.</p> </div> <div class="paragraph"> <p>Λύνοντας αυτό το πρόβλημα, δεν μόνο καθαρίσαμε τη διαδικασία δημιουργίας μας, αλλά και ενισχύσαμε τη συνέπεια του έργου μας, βεβαιωθείς ότι το πρόσθετο και το κύριο έργο μοιράζονται μία μοναδική πηγή αλήθειας για τις εξαρτήσεις τους.</p> </div> <div class="paragraph"> <p>Στον επόμενο άρθρο, θα συνεχίσουμε να ενισχύουμε το plugin μας προσθέτοντας πιο σύνθετες εργασίες, επειδή η διαχείριση των εξαρτήσεων μας είναι τώρα σταθερή και κεντραλισμένη.</p> </div> </div> </div> https://cheroliv.com/blog/2025/0092_gradle_configuration_cache_post.html Fri, 26 Sep 2025 00:00:00 +0000 blog/2025/0092_gradle_configuration_cache_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_το_σύμπτωμα_φαντασματικές_κατασκευές">Το σύμπτωμα: φαντασματικές κατασκευές</a></li> <li><a href="#_η_έρευνα_τι_είναι_ο_cache_ρυθμίσεων">Η έρευνα: Τι είναι ο cache ρυθμίσεων;</a></li> <li><a href="#_η_αιτία_του_προβλήματος_ένα_πλαγκιν_μη_συμμορφωμένο">Η Αιτία του Προβλήματος : Ένα πλαγκιν μη συμμορφωμένο</a></li> <li><a href="#_η_προσωρινή_λύση_απενεργοποίηση_του_cache">Η Προσωρινή Λύση : Απενεργοποίηση του Cache</a></li> <li><a href="#_η_αληθινή_λύση_κάνετε_το_plugin_symbατό">Η αληθινή λύση: Κάνετε το plugin symbατό</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Στόχος: Προγραμματιστές Gradle που έχουν συναντήσει ήδη "magiques" ή απροσδόμητες συμπεριφορές κατασκευής.</div> <p>Η περιπέτεια μας στη δημιουργία του plugin`site-baker`, Ακολουθήσαμε μια αυστηρή προσέγγιση TDD. Κάθε λειτουργία ήταν δοκιμασμένη, επικυρωμένη, και προεβαίναμε με εμπιστοσύνη. Και μίας μέρας, το απρόσμενο ήρθε. Οι builds άρχισαν να εμφανίζουν ανεπιθύμητη συμπεριφορά. Οι τροποποιήσεις στην λογική του plugin ή στα αρχεία ρύθμισης φανόταν να αγνοούνται, και οι λειτουργικοί δοκιμές μας, που προηγουμένως ήταν αξιόπιστες, απέτυχαν χωρίς εμφανή λόγο.</p> </div> <div class="paragraph"> <p>Αυτό το είδος προβλήματος μπορεί να είναι ανεκτό ερεθιστικό. Υπονομεύει την αξιοπιστία του εργαλείου και την εγκυρότητα του κώδικά μας. Μετά από μια έντονη περίοδο εντοπισμού σφαλμάτων, ο ένοχος εντοπίστηκε: ο<strong>cache ρυθμίσεων του Gradle</strong>.</p> </div> </div> </div> <div class="sect1"> <h2 id="_το_σύμπτωμα_φαντασματικές_κατασκευές">Το σύμπτωμα: φαντασματικές κατασκευές</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το πρόβλημα εμφανιζόταν με διάφορους τρόπους :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Έκανα τροποποίηση μιας συμβολοσειράς σε μια εργασία`println`, αλλά η παλαιά αλυσίδα συνεχιζε να εμφανίζεται κατά την εκτέλεση.</p> </li> <li> <p>Αλλάζα μια τιμή στο αρχείο μου`managed-jbake-context.yml`, αλλά το πρόσθετο δούλευε ως αν το αρχείο δεν είχε τροποποιηθεί.</p> </li> <li> <p>Οι λειτουργικοί τεστ, που δημιουργούν έργα τεστ σε πραγματικό χρόνο, απέτυχαν επειδή το πρόσθετο δεν φαινόταν να εντοπίζει τα αρχεία ρυθμίσεων που δημιουργήθηκαν πρόσφατα.</p> </li> </ol> </div> <div class="paragraph"> <p>Όλα φαίνονταν όπως αν το Gradle εκτελούσε μια <code>"version fantôme"</code> του build μας, αγνοώντας τις τελευταίες αλλαγές μας.</p> </div> </div> </div> <div class="sect1"> <h2 id="_η_έρευνα_τι_είναι_ο_cache_ρυθμίσεων">Η έρευνα: Τι είναι ο cache ρυθμίσεων;</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η cache της ρύθμισης είναι μια σχετικά σύγχρονη και εξαιρετικά ισχυρή λειτουργία του Gradle, που είναι ενεργοποιημένη από προεπιλογή στις νέες εκδόσεις. Ο στόχος της είναι να κάνει τις κατασκευές ταχύτερες.</p> </div> <div class="olist arabic"> <div class="title">Η αρχή είναι απλή:</div> <ol class="arabic"> <li> <p>Κατά την πρώτη εκτέλεση, το Gradle εκτελεί τη φάση του<strong>Διαμόρφωση</strong>(ανάγνωση των`build.gradle.kts`, δημιουργία των εργασιών, λύση εξαρτήσεων) και κατασκευάει ένα γράφο εργασιών.</p> </li> <li> <p>Στο τέλος αυτής της φάσης, Gradle<strong>Σειριοποίησε αυτό το γράφημα εργασιών</strong>και το αποθηκεύει σε cache.</p> </li> <li> <p>Lors des επόμενες εκτελέσεις, αν τίποτα δεν έχει αλλάξει (scripts κατασκευής,<code>gradle.properties</code>, etc.), Gradle<strong>Παράλειψη πλήρως τη φάση ρύθμισης</strong>και χρησιμοποιεί το γράφημα εργασιών που είναι σε cache.</p> </li> </ol> </div> <div class="paragraph"> <p>Ο κέρδος χρόνου είναι εντυπωσιακός στα μεγάλα έργα. Ωστόσο, αυτή η απόδοση κοστίζει: απαιτεί αυστηρούς κανόνες στον τρόπο που πρέπει να γραφούν τα πρόσθετα.</p> </div> <div class="imageblock"> <div class="content"> <img src="config-cache-lifecycle.svg" alt="config cache lifecycle" width="661" height="709"> </div> <div class="title">Figure 1. Ο κύκλος ζωής του cache διαμόρφωσης</div> </div> </div> </div> <div class="sect1"> <h2 id="_η_αιτία_του_προβλήματος_ένα_πλαγκιν_μη_συμμορφωμένο">Η Αιτία του Προβλήματος : Ένα πλαγκιν μη συμμορφωμένο</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το πρόσθετο μας`site-baker`Παραβίαζε, αγνοώντας, πολλές κανόνες του cache της διαμόρφωσης. Για να είναι σειριοποιήσιμο ένα γράφημα εργασιών, οι εργασίες δεν πρέπει να περιέχουν αναφορές σε σύνθετα αντικείμενα όπως το αντικείμενο`Project`ή να διαβάζετε αρχεία τυχαία κατά τη φάση εκτέλεσης.</p> </div> <div class="paragraph"> <p>Το κύριο λάθος μας ήταν η ανάγνωση του περιεχομένου του αρχείου YAML مستقیم εντός της λογικής εκτέλεσης της εργασίας, χρησιμοποιώντας μια αναφορά στη διαδρομή που αποθηκεύεται στην επέκτασή μας. Αυτή η προσέγγιση είναι ασυμβίβαστη με το cache, επειδή το Gradle δεν μπορεί να ξέρει αν το περιεχόμενο του αρχείου έχει αλλάξει εάν αυτή η ανάγνωση δεν είναι μοντελοποιημένη ως<strong>εισόδος εργασίας</strong>(Task Input).</p> </div> </div> </div> <div class="sect1"> <h2 id="_η_προσωρινή_λύση_απενεργοποίηση_του_cache">Η Προσωρινή Λύση : Απενεργοποίηση του Cache</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να ξεπερνούμε το μπλοκ και να αποκαταστήσουμε έναν προβλέψιμο συμπεριφορικό χαρακτήρα κατασκευής, η γρήγορη λύση ήταν να απενεργοποιήσουμε την cache ρυθμίσεων. Αρκεί να προσθέσουμε την ακόλουθη γραμμή στο αρχείο`gradle.properties`του έργου που χρησιμοποιεί το πρόσθετο (ή στην περίπτωσή μας, το δοκιμημένο έργο)<code>site-baker</code>).</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-properties hljs" data-lang="properties"># site-baker/gradle.properties org.gradle.configuration-cache=false</code></pre> </div> </div> <div class="paragraph"> <p>Αμέσως, τα builds επανήλθαν στον κανονικό τρόπο λειτουργίας τους. Κάθε εκτέλεση επανεκκινούσε τη φάση διαμόρφωσης και οι αλλαγές μας ληφθήκαν υπόψη.</p> </div> <div class="paragraph"> <p>Ωστόσο, είναι μια προσωρινή λύση, όχι μια βιώσιμη λύση. Θυσιάζει την απόδοση και δεν λύνει το θεμελιώδες πρόβλημα του προσθέτου μας.</p> </div> </div> </div> <div class="sect1"> <h2 id="_η_αληθινή_λύση_κάνετε_το_plugin_symbατό">Η αληθινή λύση: Κάνετε το plugin symbατό</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να είναι ένα πρόσθετο (plugin) ένα αληθινό πολίτη του σύγχρονου οικοσυστήματος Gradle, πρέπει να είναι συμβατό με το cache ρυθμίσεων. Isso σημαίνει ότι πρέπει να επανασκέψουμε τον τρόπο με τον οποίο τα δεδομένα ροής προς τις εργασίες μας.</p> </div> <div class="paragraph"> <p>Η κλειδιά είναι να τα χρησιμοποιείς<strong>APIs του παρόχου</strong>του Gradle. Αντί να περάσεις τιμές άμεσες (όπως ένα`String` ou un <code>File</code>) στις εργασίες μας, πρέπει να περάσουμε από`Property<T>`ή κάποια`Provider<T>`.</p> </div> <div class="olist arabic"> <div class="title">Εδώ είναι το σχέcido αναδιασχεδιασμού:</div> <ol class="arabic"> <li> <p><strong>Δήλωση των καταχωρισμών εργασιών :</strong>Η εργασία που αναλύει το αρχείο YAML πρέπει να δηλώσει αυτό το αρχείο ως μια είσοδος. Χρησιμοποιείται για αυτό την επίσημη σημείωση.<code>@InputFile</code>.</p> </li> <li> <p><strong>Χρησιμοποιήστε το <code>Property</code> και το <code>Provider</code> :</strong>Η τιμή του`configFile`θα συνδεθεί με την ιδιοκτησία`configPath`της επέκτασης DSL μας. Ο Gradle είναι έτσι ικανός να παρακολουθεί την προέλευση του δεδομένου.</p> </li> </ol> </div> <div class="paragraph"> <p>[source,kotlin] (No output, as there is no French text provided to translate) στο πρόσθετο tasks.register<MyTask>("myTask") { configFile.set(extension.configPath.flatMap { project.layout.projectDirectory.file(it) }) } ----</p> </div> <div class="listingblock"> <div class="content"> <pre></pre> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0091_jackson_yaml_tdd_post.html Thu, 25 Sep 2025 00:00:00 +0000 blog/2025/0091_jackson_yaml_tdd_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_το_πλαίσιο_το_πρόσθετό_μας_site_baker">Το πλαίσιο : Το πρόσθετό μας `site-baker</a></li> <li><a href="#_2_μοντελοποίηση_της_διαμόρφωσης_στη_kotlin">2. Μοντελοποίηση της Διαμόρφωσης στη Kotlin</a></li> <li><a href="#_3_ενσωμάτωση_του_jackson_στο_build_gradle_kts">3. Ενσωμάτωση του Jackson στο `build.gradle.kts</a></li> <li><a href="#_4_η_προσέγγιση_tdd_δοκιμή_του_parsing_yaml">4. Η προσέγγιση TDD : Δοκιμή του parsing YAML</a> <ul class="sectlevel2"> <li><a href="#_4_1_τεστ_μονάδας_αντιστοίχιση_yaml_σε_αντικείμενο_kotlin">4.1. Τεστ μονάδας : Αντιστοίχιση YAML σε αντικείμενο Kotlin</a></li> <li><a href="#_4_2_έλεγχος_λειτουργικότητας_επαλήθευση_ανάγνωσης_του_αρχείου_ρύθμισης">4.2. Έλεγχος λειτουργικότητας: Επαλήθευση ανάγνωσης του αρχείου ρύθμισης</a></li> </ul> </li> <li><a href="#_5_εμφάνιση_του_ροής_ανάλυσης">5. Εμφάνιση του Ροής Ανάλυσης</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Προοριζόμενο κοινό : Μέσοι προγραμματιστές Gradle που θέλουν να διαχειρίζονται σύνθετες διαμορφώσεις.</div> <p>Στην ανάπτυξη προσαρμοσμένων Gradle plugins, η διαχείριση phứcαυλών ρυθμίσεων είναι μια συνήθης εργασία. Αντί να φορτίζουμε το DSL με εκατοντάδες ιδιότητες, είναι συνήθως πιο καθαρό και συντήρησιμο να ορίζουμε τη ρυθμίση σε ένα εξωτερικό αρχείο, όπως το YAML. Αυτό το άρθρο σας οδηγεί στην ενσωμάτωση της ισχυρής βιβλιοθήκης Jackson για το ανάλυση αρχείων YAML σε αντικείμενα Kotlin, χρησιμοποιώντας μια αυστηρή προσέγγιση TDD για να διασφαλίσουμε τη σταθερότητα του plugin μας.<code>site-baker</code>.</p> </div> </div> </div> <div class="sect1"> <h2 id="_το_πλαίσιο_το_πρόσθετό_μας_site_baker">Το πλαίσιο : Το πρόσθετό μας `site-baker</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το plugin`site-baker`είναι σχεδιασμένο για να αυτοματοποιήσει τη δημιουργία και τη διανομή одного στατικού ιστότοπου. Χρειάζεται να διαβάσει ένα αρχείο ρύθμισης YAML (<code>managed-jbake-context.yml</code>) για να λάβετε πληροφορίες όπως οι διαδρομές των πηγών, οι προορισμοί ανάπτυξης, και τα αναγνωριστικά Git.</p> </div> <div class="paragraph"> <p>Η ρύθμιση YAML που θέλουμε να αναλύουμε φαίνεται ως εξής :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">bake: srcPath: "./site/jbake" destDirPath: "bake" cname: "cheroliv.com" pushPage: from: "bake" to: "cvs" repo: name: "trainings" repository: "https://github.com/pages-content/pages-content.github.io.git" credentials: username: "USERNAME" password: "SECRET_TOKEN" branch: "main" message: "cheroliv.com" # ... autres configurations (pushMaquette, supabase, etc.)</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_2_μοντελοποίηση_της_διαμόρφωσης_στη_kotlin">2. Μοντελοποίηση της Διαμόρφωσης στη Kotlin</h2> <div class="sectionbody"> <div class="paragraph"> <p>Πριν από το parsing, πρέπει να ορίσουμε τη δομή των δεδομένων μας σε Kotlin. Το Jackson θα χρησιμοποιήσει αυτές τις κλάσεις για να αντιστοιχίσει αυτόματα το περιεχόμενο του YAML.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// plugin/src/main/kotlin/com/cheroliv/site/baker/data/SiteConfiguration.kt package com.cheroliv.site.baker.data import com.fasterxml.jackson.databind.ObjectMapper import com.fasterxml.jackson.dataformat.yaml.YAMLFactory import com.fasterxml.jackson.module.kotlin.readValue import com.fasterxml.jackson.module.kotlin.registerKotlinModule fun parseSiteConfiguration(yaml: String): SiteConfiguration { val mapper = ObjectMapper(YAMLFactory()).registerKotlinModule() return mapper.readValue(yaml) } data class GitPushConfiguration( val from: String = "", val to: String = "", val repo: RepositoryConfiguration = RepositoryConfiguration(), val branch: String = "", val message: String = "", ) data class RepositoryConfiguration( val name: String = "", val repository: String = "", val credentials: RepositoryCredentials = RepositoryCredentials(), ) { companion object { const val ORIGIN = "origin" const val CNAME = "CNAME" const val REMOTE = "remote" } } data class RepositoryCredentials(val username: String = "", val password: String = "") data class SiteConfiguration( val bake: BakeConfiguration = BakeConfiguration(), val pushPage: GitPushConfiguration = GitPushConfiguration(), val pushMaquette: GitPushConfiguration = GitPushConfiguration(), val pushSource: GitPushConfiguration? = null, val pushTemplate: GitPushConfiguration? = null, val supabase: SupabaseContactFormConfig? = null ) data class BakeConfiguration( val srcPath: String = "", val destDirPath: String = "", val cname: String? = null, ) // ... (autres data classes pour Supabase, si nécessaire)</code></pre> </div> </div> <div class="paragraph"> <p>Η λειτουργία`parseSiteConfiguration`είναι το σημείο εισόδου μας για την αποσειριαλισμό. Χρησιμοποιεί`ObjectMapper`του Τζέκσον, ρυθμισμένο με`YAMLFactory`για τη μορφή YAML και`registerKotlinModule()`για τη υποστήριξη των ιδιοτητών του Kotlin (όπως οι προεπιλεγμένες τιμές των ιδιοτήτων).</p> </div> </div> </div> <div class="sect1"> <h2 id="_3_ενσωμάτωση_του_jackson_στο_build_gradle_kts">3. Ενσωμάτωση του Jackson στο `build.gradle.kts</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να χρησιμοποιήσουμε το Jackson, πρέπει να προσθέσουμε τις απαραίτητες εξαρτήσεις στο`build.gradle.kts`του module μας`plugin` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// plugin/build.gradle.kts dependencies { // Jackson for YAML parsing implementation("com.fasterxml.jackson.module:jackson-module-kotlin:2.18.3") implementation("com.fasterxml.jackson.dataformat:jackson-dataformat-yaml:2.18.3") // ... autres dépendances }</code></pre> </div> </div> <div class="paragraph"> <p>Χρησιμοποιούμε`jackson-module-kotlin`για την υποστήριξη του Kotlin και`jackson-dataformat-yaml`για τη διαχείριση του format YAML.</p> </div> </div> </div> <div class="sect1"> <h2 id="_4_η_προσέγγιση_tdd_δοκιμή_του_parsing_yaml">4. Η προσέγγιση TDD : Δοκιμή του parsing YAML</h2> <div class="sectionbody"> <div class="paragraph"> <p>Τώρα, εφαρμόζουμε το TDD για να επικυρώσουμε τη λογική parsing.</p> </div> <div class="sect2"> <h3 id="_4_1_τεστ_μονάδας_αντιστοίχιση_yaml_σε_αντικείμενο_kotlin">4.1. Τεστ μονάδας : Αντιστοίχιση YAML σε αντικείμενο Kotlin</h3> <div class="paragraph"> <p>�Ξεκινάμε με ένα τεστ μονάδας στο`SiteBakerPluginTest.kt`για να ελέγξουμε ότι η συνάρτηση`parseSiteConfiguration`μπορεί να μετατρέψει σωστά μια συμβολοσειρά YAML σε ένα αντικείμενο`SiteConfiguration`.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// plugin/src/test/kotlin/com/cheroliv/site/baker/SiteBakerPluginTest.kt @Test fun `can map configuration text to SiteConfiguration object`() { val yamlString = "../../managed-jbake-context.yml" .run(::File) .readText() .trimIndent() val config: SiteConfiguration = parseSiteConfiguration(yamlString) assertEquals("cheroliv.com", config.bake.cname) assertEquals("main", config.pushPage.branch) assertEquals("https://github.com/pages-content/pages-content.github.io.git", config.pushPage.repo.repository) }</code></pre> </div> </div> <div class="paragraph"> <p>Αυτός ο έλεγχος διαβάζει το περιεχόμενο του αρχείου`managed-jbake-context.yml`(που πρέπει να υπάρχει ώστε ο δοκίμιο να είναι έγκυρος) και κάνει επιβεβαιώσεις στο αντικείμενο`SiteConfiguration`αποτέλεσμα. Επικυρώνει ότι οι κλειδιές τιμές του YAML έχουν σωστά αντιστοιχιστεί.</p> </div> </div> <div class="sect2"> <h3 id="_4_2_έλεγχος_λειτουργικότητας_επαλήθευση_ανάγνωσης_του_αρχείου_ρύθμισης">4.2. Έλεγχος λειτουργικότητας: Επαλήθευση ανάγνωσης του αρχείου ρύθμισης</h3> <div class="paragraph"> <p>Για να βεβαιωθούμε ότι το plugin μπορεί να διαβάσει το αρχείο ρυθμίσεων μέσω του DSL του και ότι το parsing λειτουργεί σε ένα πραγματικό περιβάλλον Gradle, προσθέτουμε έναν λειτουργικό τεστ σε`SiteBakerPluginFunctionalTest.kt`.</p> </div> <div class="paragraph"> <p>Αυτό το τεστ είναι ζωτικής σημασίας επειδή προσομοιάζει την εκτέλεση του plugin σε ένα πραγματικό έργο. Πρέπει να<strong>ερμητικός</strong>, δηλαδή πρέπει να το φτιάξει ο ίδιος το αρχείο`managed-jbake-context.yml`με ελεγχόμενο περιεχόμενο, για να εγγυηθεί την επαναλαμβανιμότητα και την απομόνωση του τεστ.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// plugin/src/functionalTest/kotlin/com/cheroliv/site/baker/SiteBakerPluginFunctionalTest.kt @Test fun `config file contains good data`(){ val configContent = configFile.readText(UTF_8) // Vérifications comme dans vos commentaires assertTrue(configContent.contains("bake")) assertTrue(configContent.contains("pushPage")) assertTrue(configContent.contains("repository")) }</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η λειτουργική δοκιμή επαληθεύει ότι το αρχείο ρυθμίσεων που αντιγράφεται στον προσωρινό κατάλογο της δοκιμής περιέχει τις αναμενόμενες δεδομένες. Αν και αυτή η δοκιμή δεν αναλύει άμεσα το YAML σε αντικείμενο Kotlin, επικυρώνει την παρουσία του αρχείου και του περιεχομένου του, κάτι που είναι μια ουσιώδη πρόπτωση πριν από την ανάλυση από το πρόσθετο.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_5_εμφάνιση_του_ροής_ανάλυσης">5. Εμφάνιση του Ροής Ανάλυσης</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το επόμενο διάγραμμα απεικονίζει τη ροή των δεδομένων και τις αλληλεπιδράσεις κατά την ανάλυση της διαμόρφωσης YAML :</p> </div> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-46952794f7f3740134f0a10651e6cfe9.png" alt="Diagram" width="1608" height="472"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ακολουθώντας μια προσέγγιση TDD, ενσωματώσαμε με επιτυχία τη βιβλιοθήκη Jackson για να αναλύουμε αρχεία ρυθμίσεων YAML σε αντικείμενα Kotlin στο plugin Gradle μας. Αυτή η μέθοδος μας επέτρεψε να:</p> </div> <div class="ulist"> <ul> <li> <p><strong>Μοντελοποιήστε σαφώς</strong>η διαμόρφωσή μας με τις Kotlin κλάσεις δεδομένων.</p> </li> <li> <p><strong>Επικυρώστε τη λογική ανάλυσης</strong>με στοχευμένα τεστ μονάδας.</p> </li> <li> <p><strong>Ασφάλιση της ενσωμάτωσης</strong>σε ένα πραγματικό περιβάλλον Gradle χάρη στα ακαταπαύτα λειτουργικά δοκιμές.</p> </li> </ul> </div> <div class="paragraph"> <p>Αυτή η σταθερά βάση μας παρέχει μεγάλη εμπιστοσύνη για να επεκτείνουμε το plugin μας με λειτουργίες που βασίζονται σε αυτήν τη ρύθμιση, διασφαλίζοντες την συντηρησιμότητα και την ανθεκτικότητα του κώδικα. Το parsing YAML είναι τώρα μια αξιόπιστη και δοκιμασμένη λειτουργία του plugin μας.<code>site-baker</code>.</p> </div> </div> </div> https://cheroliv.com/blog/2025/0090_TDD_gradle_plugin_post.html Wed, 24 Sep 2025 00:00:00 +0000 blog/2025/0090_TDD_gradle_plugin_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_η_αρχικοποίηση_του_έργου">Η αρχικοποίηση του έργου</a></li> <li><a href="#_2_το_πρώτο_μας_κύκλο_τdd_καταγραφή_μίας_εργασίας">2. Το πρώτο μας κύκλο ΤDD: Καταγραφή μίας εργασίας</a> <ul class="sectlevel2"> <li><a href="#_2_1_η_prima_δοκιμή_η_δοκιμή_που_αποτύχει">2.1. η prima δοκιμή (η δοκιμή που αποτύχει)</a></li> <li><a href="#_2_2_ο_κώδικας_στη_συνέχεια_πέραστε_το_τεστ">2.2. Ο κώδικας στη συνέχεια (Πέραστε το τεστ)</a></li> </ul> </li> <li><a href="#_3_2ος_κύκλος_tdd_προσθήκη_έπεκτασης_dsl">3. 2ος Κύκλος TDD: Προσθήκη Έπεκτασης DSL</a> <ul class="sectlevel2"> <li><a href="#_3_1_το_πρώτο_τεστ">3.1. Το πρώτο τεστ</a></li> <li><a href="#_3_2_ο_κώδικας_έπειτα">3.2. Ο κώδικας έπειτα</a></li> </ul> </li> <li><a href="#_4_ο_λειτουργικός_τέστος_επικύρωση_της_ενταξής">4. Ο Λειτουργικός Τέστος: Επικύρωση της Ενταξής</a> <ul class="sectlevel2"> <li><a href="#_4_1_δοκιμή_ενσωμάτωσης_δημιουργήστε_ένα_ελεγχόμενο_περιβάλλον">4.1. Δοκιμή ενσωμάτωσης: Δημιουργήστε ένα ελεγχόμενο περιβάλλον</a></li> <li><a href="#_4_2_τελειώστε_τη_λογική">4.2. Τελειώστε τη λογική</a></li> </ul> </li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>Σε αυτό το άρθρο, θα εξερευνήσουμε πώς να ρυθμίσουμε ένα σταθερό θεμέλιο ανάπτυξης για ένα πρόσθετο Gradle χρησιμοποιώντας μια προσέγγιση ανάπτυξης που καθοδηγείται από τα τεστ (TDD - Test-Driven Development). Αυτή η μέθοδος μας εξασφαλίζει ότι ο κώδικάς μας είναι ανθεκτικός, συντηρήσιμος και ικανοποιεί ακριβώς τις απαιτήσεις από την αρχή.</p> </div> </div> </div> <div class="sect1"> <h2 id="_η_αρχικοποίηση_του_έργου">Η αρχικοποίηση του έργου</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το Gradle διευκολύνει πολύ τη δημιουργία ενός νέου plugin χάρη στην εντολή`gradle init`. Επιλέγοντάς να δημιουργήσουμε ένα "Gradle Plugin" με Kotlin, παίρνουμε μια έτοια δομή έργου, που περιλαμβάνει δύο βασικούς τύπους δοκιμών :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Δοκιμές μονάδων :</strong>Βρίσκονται σε`src/test`, επιτρέπουν τον έλεγχο απομονωμένων συστατικών του plugin μας, όπως η εσωτερική λογική μιας εργασίας ή η διαμόρφωση μιας επέκτασης. Είναι γρήγορα και δεν απαιτούν πληρό εκτέλεση του Gradle.</p> </li> <li> <p><strong>Λειτουργικοί Τεστ :</strong>Βρισκόμενοι σε`src/functionalTest`, Eles χ…​`GradleRunner`Για να εκτελέσουμε μια πλήρη build Gradle σε ένα προσωρινό έργο δοκιμής. Αυτό μας επιτρέπει να ελέγξουμε την πραγματική συμπεριφορά του προσθέτου σε ένα ελεγχόμενο περιβάλλον.</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_2_το_πρώτο_μας_κύκλο_τdd_καταγραφή_μίας_εργασίας">2. Το πρώτο μας κύκλο ΤDD: Καταγραφή μίας εργασίας</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η πρώτη μας απαιτία είναι απλή: το plugin πρέπει να καταχωρίζει μια εργασία με όνομα`printSiteConfig`.</p> </div> <div class="sect2"> <h3 id="_2_1_η_prima_δοκιμή_η_δοκιμή_που_αποτύχει">2.1. η prima δοκιμή (η δοκιμή που αποτύχει)</h3> <div class="paragraph"> <p>Συμφωνικά με το TDD, γράφουμε πρώτα ένα τεστ που ελέγχει την ύπαρξη αυτής της εργασίας. Σε`SiteBakerPluginTest.kt`(το αρχείο τεστ μονάδας μας), προσθέτουμε:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin registers task`() { // Créer un projet de test en mémoire val project = ProjectBuilder.builder().build() project.plugins.apply("com.cheroliv.site-baker") // Vérifier que la tâche a bien été enregistrée assertNotNull(project.tasks.findByName("printSiteConfig")) }</code></pre> </div> </div> <div class="paragraph"> <p>Αυτός ο τεστ αποτυγχάνει, επειδή δεν έχουμε ακόμα γράψει καμία γραμμή κώδικα στον plugin μας.</p> </div> </div> <div class="sect2"> <h3 id="_2_2_ο_κώδικας_στη_συνέχεια_πέραστε_το_τεστ">2.2. Ο κώδικας στη συνέχεια (Πέραστε το τεστ)</h3> <div class="paragraph"> <p>Τώρα, γράφουμε τον ελάχιστο απαιτούμενο κώδικα στο`SiteBakerPlugin.kt`για να περάσει ο τεστ :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class SiteBakerPlugin: Plugin<Project> { override fun apply(project: Project) { // Enregistrer une tâche simple project.tasks.register("printSiteConfig") { task -> // ... la logique de la tâche viendra plus tard } } }</code></pre> </div> </div> <div class="paragraph"> <p>Ανακινούμε τα τεστ, και περνούν. Η πρώτη λειτουργία μας είναι επιβεβαιωμένη.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_3_2ος_κύκλος_tdd_προσθήκη_έπεκτασης_dsl">3. 2ος Κύκλος TDD: Προσθήκη Έπεκτασης DSL</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η επόμενη απαιτηση είναι να επιτρέπουμε στους χρήστες να ρυθμίζουν το plugin μας μέσω ενός μπλοκ DSL στους`build.gradle.kts`. Θέλουμε ένα μπλοκ`site { …​ }`όπου μπορεί να καθοριστεί μια διαδρομή ρύθμισης.</p> </div> <div class="sect2"> <h3 id="_3_1_το_πρώτο_τεστ">3.1. Το πρώτο τεστ</h3> <div class="paragraph"> <p>Προσθέτουμε έναν έλεγχο για να επαλυθεύσουμε ότι η_extension`site`είναι σωστά καταγεγραμμένη και μπορούμε να της θέσουμε μια αξία.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin registers extension`() { val project = ProjectBuilder.builder().build() project.plugins.apply("com.cheroliv.site-baker") // Récupérer l'extension et lui affecter une valeur project.extensions .findByType(SiteExtension::class.java)!! .configPath .set("config.yml") // Vérifier que la valeur a bien été prise en compte assertEquals( "config.yml", project.extensions.findByType(SiteExtension::class.java)?.configPath?.get() ) }</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η δοκιμή αποτυγχάνει επειδή ουδέ η κλάση`SiteExtension`ούτε η εγγραφή της επέκτασης υπάρχει.</p> </div> </div> <div class="sect2"> <h3 id="_3_2_ο_κώδικας_έπειτα">3.2. Ο κώδικας έπειτα</h3> <div class="paragraph"> <p>Δημιουργούμε την κλάση`SiteBakerExtension.kt`και ενημερώνουμε`SiteBakerPlugin.kt`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// SiteBakerExtension.kt open class SiteExtension @Inject constructor(objects: ObjectFactory) { val configPath: Property<String> = objects.property(String::class.java) } // SiteBakerPlugin.kt class SiteBakerPlugin: Plugin<Project> { override fun apply(project: Project) { // Enregistrer l'extension val extension = project.extensions.create("site", SiteExtension::class.java) project.tasks.register("printSiteConfig") { task -> task.doLast { // On utilisera l'extension plus tard } } } }</code></pre> </div> </div> <div class="paragraph"> <p>Οι δοκιμές επιτυχούν ξανά.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_4_ο_λειτουργικός_τέστος_επικύρωση_της_ενταξής">4. Ο Λειτουργικός Τέστος: Επικύρωση της Ενταξής</h2> <div class="sectionbody"> <div class="paragraph"> <p>Τώρα που οι μονάδες έχουν δοκιμαστεί, πρέπει να βεβαιωθούμε ότι όλα λειτουργούν együtt σε μια πραγματική build. Αυτός είναι ο ρόλος του λειτουργικού τεστ σε`SiteBakerPluginFunctionalTest.kt`.</p> </div> <div class="sect2"> <h3 id="_4_1_δοκιμή_ενσωμάτωσης_δημιουργήστε_ένα_ελεγχόμενο_περιβάλλον">4.1. Δοκιμή ενσωμάτωσης: Δημιουργήστε ένα ελεγχόμενο περιβάλλον</h3> <div class="paragraph"> <p>Αυτό το τεστ θα προσομοιώσει ένα πραγματικό έργο που χρησιμοποιεί το πρόσθετο μας. Για να είναι αξιόπιστο, πρέπει να είναι<strong>αερωστός</strong>, δηλαδή δεν πρέπει να εξαρτάται από υφιστάμενα αρχεία στο σύστημα. Πρέπει να δημιουργήσει εαυτό του όλες τις απαιτούμενες συνθήκες για την εκτέλεσή του.</p> </div> <div class="paragraph"> <p>Ο τεστ θα άρα:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Δημιουργία ενός`build.gradle.kts`ο τεστ που χρησιμοποιεί το plugin μας και το DSL του.</p> </li> <li> <p><strong>Δημιουργήστε το αρχείο ρυθμίσεων</strong> (<code>managed-jbake-context.yml</code>) το plugin πρέπει να διαβάσει. Αυτό είναι ένα κρίσιμο βήμα για την ανθεκτότητα του δοκιμίου.</p> </li> <li> <p>Εκτελέστε την εργασία`printSiteConfig`μέσω`GradleRunner`.</p> </li> <li> <p>Ελέγξτε ότι η έξοδος της κατασκευής είναι σωστή.</p> </li> </ol> </div> <div class="paragraph"> <p>Αντιγράφοντας ή δημιουργώντας αυτό το αρχείο ρύθμισης σε κάθε εκτέλεση, βεβαιόμαστε ότι ο έλεγχος είναι<strong>αναπαραγώσιμο</strong>Αυτό προστατεύει τις δοκιμές μας από τις παλινδρόμησες που μπορεί να σχετίζονται με την ανάγνωση του αρχείου.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `can run task with DSL`() { // 1. Créer un build.gradle.kts de test buildFile.writeText(""" plugins { id("com.cheroliv.site-baker") } site { configPath = "managed-jbake-context.yml" } """.trimIndent()) // 2. Créer le fichier de configuration pour un test contrôlé val configFile = File(projectDir, "managed-jbake-context.yml") configFile.writeText("site: { title: 'Mon Site de Test' }") // Contenu YAML simple // 3. Exécuter la build val runner = GradleRunner.create() runner.withPluginClasspath() runner.withArguments("printSiteConfig") runner.withProjectDir(projectDir) // Spécifier le répertoire du projet de test val result = runner.build() // 4. Vérifier la sortie assertTrue(result.output.contains("Site config path: managed-jbake-context.yml")) }</code></pre> </div> </div> <div class="paragraph"> <p>Αυτό το τεστ θα αποτύχει όσο η εργασία`printSiteConfig`Δεν θα χρησιμοποιήσει πραγματικά την τιμή της επέκτασης.</p> </div> </div> <div class="sect2"> <h3 id="_4_2_τελειώστε_τη_λογική">4.2. Τελειώστε τη λογική</h3> <div class="paragraph"> <p>Ενημερώνουμε την εργασία στο`SiteBakerPlugin.kt`για να εμφανίσει τη ρυθμισμένη τιμή :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">project.tasks.register("printSiteConfig") { task -> task.doLast { println("Site config path: ${extension.configPath.get()}") } }</code></pre> </div> </div> <div class="paragraph"> <p>Όλοι οι τεστ, μονάδων και λειτουργικοί, τώρα περνούν.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ακολουθώντας μια προσέγγιση TDD, έχουμε κατασκευάσει ένα πρόσθετο με σταδιακό και ασφαλή τρόπο. Κάθε μικρή λειτουργία επικυρώνεται αμέσως από έναν έλεγχο, από τα γρήγορα μονάδια έλεγχων μέχρι τα λειτουργικά έλεγχοι που επικυρώνουν την πλήρη ενσωμάτωση.</p> </div> <div class="paragraph"> <p>Προσέχοντας να κάνουμε τα τεστ μας λειτουργικά<strong>ερμητικοί</strong>— δημιουργώντας προγραμματιστικά τα απαραίτητα αρχεία ρυθμίσεων — κτίζουμε ένα εξαιρετικά απρόσπαστο δίκτυο ασφαλείας. Αυτό το επίπεδο ακρίβειας μας προστατεύει αποτελεσματικά κατά των regressions και μας δίνει μεγάλη εμπιστοσύνη για να προσθέσουμε πιο پیچιδικές λειτουργίες στη συνέχεια, όπως η ανάλυση του αρχείου ρυθμίσεων YAML.</p> </div> <div class="paragraph"> <p>Αυτή η στερεά βάση δοκιμών είναι το πιοτιμότερο πλεονέκτημα για τη συντήρηση και τη μελλοντική εξέλιξη του πρόσθετου.</p> </div> </div> </div> https://cheroliv.com/blog/2025/0089_creation_projet_plugin_gradle_post.html Tue, 23 Sep 2025 00:00:00 +0000 blog/2025/0089_creation_projet_plugin_gradle_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_βήμα_1_εκκίνηση_του_βοηθού_έργου">Βήμα 1 : Εκκίνηση του βοηθού έργου</a></li> <li><a href="#_βήμα_2_κατανόηση_της_γεννηθέμενης_δομής">Βήμα 2: Κατανόηση της γεννηθέμενης δομής</a> <ul class="sectlevel2"> <li><a href="#_βασικά_αρχεία_και_φάκελοι">Βασικά αρχεία και φάκελοι</a></li> </ul> </li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Στόχος: Ανάπτυκτης από αρχάριος έως μέσος με Gradle.</div> <p>Η εκκίνηση ενός νέου έργου πρόσθετου Gradle μπορεί να φαίνεται τρομερή. Ευτυχώς, ο Gradle παρέχει ένα ισχυρό διαλογικό βοηθό, την εργασία`init`, που δημιουργεί μια πλήρη, καθαρή και έτοιμη για χρήση δομή έργου. Αυτός ο οδηγός θα σας δείξει πώς να χρησιμοποιήσετε αυτό το εργαλείο για να δημιουργήσετε μια υγιή βάση προσθήκης, θα εξηγήσει τη δομή και θα σας δείξει πώς να εκκινήσετε τις πρώτες εργασίες κατασκευής.</p> </div> </div> </div> <div class="sect1"> <h2 id="_βήμα_1_εκκίνηση_του_βοηθού_έργου">Βήμα 1 : Εκκίνηση του βοηθού έργου</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η εντολή`gradle init`είναι το σημείο εκκίνησης. Εκκινεί έναν βοηθό γραμμής εντολών που σας ρωτεί μια σειρά ερωτήσεων για τη ρύθμιση του проекта.</p> </div> <div class="paragraph"> <p>Άνοιξε το τερματικό σου σε έναν κενό φάκελο και τρέxe:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gradle init</code></pre> </div> </div> <div class="paragraph"> <p>Ο βοηθός θα σας καθοδηγήσει. Αυτοί είναι οι επιλογές που πρέπει να κάνετε για ένα plugin Gradle γραμμένο σε Kotlin :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Επιλέξτε τον τύπο του έργου για δημιουργία:</strong>Επιλέξτε`Gradle plugin`.</p> </li> <li> <p><strong>Επιλέξτε γλώσσα υλοποίησης:</strong>Επιλέξτε`Kotlin`.</p> </li> <li> <p><strong>Επιλέξτε DSL δέσμου κατασκευής:</strong>Επιλέξτε`Kotlin`.</p> </li> <li> <p><strong>�Όνομα έργου:</strong>Εισάγετε ένα όνομα για το έργο σας (πχ:`site-baker`).</p> </li> <li> <p><strong>ID προσθήκης:</strong>Δώστε ένα μοναδικό αναγνωριστικό στο plugin σας (π.χ:`com.cheroliv.site-baker`)</p> </li> <li> <p><strong>Κλάση Plugin:</strong>Καθορίζστε το όνομα της κλάσης υλοποίησης (π.χ:`com.cheroliv.SiteBakerPlugin`)</p> </li> </ol> </div> <div class="paragraph"> <p>Μόλις ολοκληρωθεί, το Gradle δημιουργεί ένα πλήρες δέντρο αρχείων.</p> </div> <div class="imageblock"> <div class="content"> <img src="init-gradle.svg" alt="init gradle" width="199" height="406"> </div> <div class="title">Figure 1. Διάγραμμα της διαδικασίας αρχικοποίησης</div> </div> </div> </div> <div class="sect1"> <h2 id="_βήμα_2_κατανόηση_της_γεννηθέμενης_δομής">Βήμα 2: Κατανόηση της γεννηθέμενης δομής</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ο βοηθός δημιουργεί μια πολυ-μοδυλαρχική δομή έργου, χωρίζοντας το ριζικό έργο από τον πηγαίο κώδικα του plugin του.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">. ├── gradle/ │ └── wrapper/ │ ├── gradle-wrapper.jar │ └── gradle-wrapper.properties ├── gradlew ├── gradlew.bat ├── plugin/ │ ├── build.gradle.kts │ └── src/ │ ├── main/ │ │ └── kotlin/ │ │ └── com/cheroliv/SiteBakerPlugin.kt │ ├── test/ │ │ └── kotlin/ │ │ └── com/cheroliv/SiteBakerPluginTest.kt │ └── functionalTest/ │ └── kotlin/ │ └── com/cheroliv/SiteBakerPluginFunctionalTest.kt └── settings.gradle.kts</code></pre> </div> </div> <div class="sect2"> <h3 id="_βασικά_αρχεία_και_φάκελοι">Βασικά αρχεία και φάκελοι</h3> <div class="ulist"> <ul> <li> <p><code>settings.gradle.kts`Αυτό το αρχείο στη ρίζα ορίζει τα modules που συμπεριλαμβάνονται στην κατασκευή. Εδώ, περιλαμβάνει το υπο-πρόγραμμα`plugin</code>.</p> </li> </ul> </div> <div class="paragraph"> <p>[source,kotlin] ---- rootProject.name = "site-baker include("plugin") ----</p> </div> <div class="listingblock"> <div class="content"> <pre></pre> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0088_environnement_plugin_gradle_post.html Mon, 22 Sep 2025 00:00:00 +0000 blog/2025/0088_environnement_plugin_gradle_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_1_το_jdk_η_μηχανή_του_gradle">1. Το JDK: Η μηχανή του Gradle</a> <ul class="sectlevel2"> <li><a href="#_ποια_έκδοση_να_επιλέξετε">Ποια έκδοση να επιλέξετε ?</a></li> <li><a href="#_εγκατάσταση_μέσω_sdkman_συνιστάται">Εγκατάσταση μέσω SDKMAN! (Συνιστάται)</a> <ul class="sectlevel3"> <li><a href="#_εγκαταστήστε_το_sdkman"><strong>Εγκαταστήστε το SDKMAN!</strong></a></li> <li><a href="#_εγκαταστήστε_μια_έκδοση_του_jdk">Εγκαταστήστε μια έκδοση του JDK</a></li> <li><a href="#_επαλήθευση_της_εγκατάστασης">Επαλήθευση της εγκατάστασης</a></li> </ul> </li> </ul> </li> <li><a href="#_2_το_ide_intellij_idea">2. Το IDE : IntelliJ IDEA</a></li> <li><a href="#_3_gradle_το_εργαλείο_build">3. Gradle : Το εργαλείο build</a> <ul class="sectlevel2"> <li><a href="#_εγκατάσταση_μέσω_sdkman">Εγκατάσταση μέσω SDKMAN!</a> <ul class="sectlevel3"> <li><a href="#_εγκατάσταση_gradle"><strong>Εγκατάσταση Gradle</strong></a></li> <li><a href="#_επαληθεύστε_την_εγκατάσταση">Επαληθεύστε την εγκατάσταση</a></li> </ul> </li> </ul> </li> <li><a href="#_4_jbake_το_γεννήτορα_στατικών_ιστοσελίδων">4. JBake : Το γεννήτορα στατικών ιστοσελίδων</a> <ul class="sectlevel2"> <li><a href="#_εγκατάσταση_μέσω_sdkman_2">Εγκατάσταση μέσω SDKMAN!</a> <ul class="sectlevel3"> <li><a href="#_εγκαταστήστε_jbake">Εγκαταστήστε JBake</a></li> <li><a href="#_έλεγχος_εγκατάστασης">Έλεγχος εγκατάστασης</a></li> </ul> </li> </ul> </li> <li><a href="#_5_το_gradle_wrapper_η_απόλυτη_καλή_πρακτική">5. Το Gradle Wrapper : Η απόλυτη καλή πρακτική</a></li> <li><a href="#_6_docker_και_portainer_για_αναπαραγώγιμες_κατασκευές_προαιρετικό">6. Docker και Portainer: Για αναπαραγώγιμες κατασκευές (Προαιρετικό)</a> <ul class="sectlevel2"> <li><a href="#_εγκατάσταση_docker_engine">Εγκατάσταση Docker Engine</a> <ul class="sectlevel3"> <li><a href="#_εγκαταστήστε_το_docker_μέσω_του_επίσημου_σεναρίου">Εγκαταστήστε το Docker μέσω του επίσημου σεναρίου:</a></li> <li><a href="#_διαχείριση_docker_χωρίς_sudo_προτεινόμενο"><strong>Διαχείριση Docker χωρίς <code>sudo</code> (προτεινόμενο) :</strong></a></li> </ul> </li> <li><a href="#_διαχείριση_docker_με_portainer_gui">Διαχείριση Docker με Portainer (GUI)</a> <ul class="sectlevel3"> <li><a href="#_δημιουργήστε_ένα_όγκο_για_τα_δεδομένα_του_portainer"><strong>Δημιουργήστε ένα όγκο για τα δεδομένα του Portainer :</strong></a></li> <li><a href="#_εκκίνηση_του_κοντέινερ_portainer">Εκκίνηση του κοντέινερ Portainer :</a></li> </ul> </li> </ul> </li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Στόχος : Προγραμματιστές που θέλουν να αρχίσουν τη δημιουργία προσθηκών Gradle.</div> <p>Για την αποτελεσματική ανάπτυξη προσθέτων Gradle, απαιτείται ένα καλά διαμορφωμένο περιβάλλον ανάπτυξης. Μια καλή ρύθμιση θα σας εξοικονομήσει χρόνο, θα μειώσει τις απογοητεύσεις και θα διασφαλίσει την συνέπεια των builds σας.</p> </div> <div class="olist arabic"> <div class="title">Αυτός ο οδηγός εστιάζει σε τέσσερις θεμελιώδους στύλους :</div> <ol class="arabic"> <li> <p>Le <strong>JDK</strong>(Java Development Kit), επειδή το Gradle και το JBake τρέχουν πάνω στη JVM.</p> </li> <li> <p>Un <strong>IDE</strong>σύγχρονη (IntelliJ IDEA) με καλή υποστήριξη για το Kotlin και το Gradle.</p> </li> <li> <p><strong>Gradle</strong>αυτός, για να αρχικοποιήσει τα έργα.</p> </li> <li> <p><strong>JBake</strong>, ο μηχανισμός του στατικού μας ιστότοπου.</p> </li> </ol> </div> <div class="imageblock"> <div class="content"> <img src="images/gradle-env.svg" alt="gradle env" width="1615" height="5696"> </div> <div class="title">Figure 1. Composants του περιβάλλοντος της ανάπτυξης</div> </div> </div> </div> <div class="sect1"> <h2 id="_1_το_jdk_η_μηχανή_του_gradle">1. Το JDK: Η μηχανή του Gradle</h2> <div class="sectionbody"> <div class="paragraph"> <p>Gradle είναι μια εφαρμογή που εκτελείται στην εικονική μηχανή Java (JVM). Επομένως, η εγκατάσταση ενός JDK είναι απόλυτη προϋπόθεση.</p> </div> <div class="sect2"> <h3 id="_ποια_έκδοση_να_επιλέξετε">Ποια έκδοση να επιλέξετε ?</h3> <div class="paragraph"> <p>Συνιστάται η χρήση μιας έκδοσης LTS (Long-Term Support) της Java. Στο παρόν,<strong>JDK 17</strong> ou <strong>JDK 21</strong>είναι εξαιρετικές επιλογές.</p> </div> </div> <div class="sect2"> <h3 id="_εγκατάσταση_μέσω_sdkman_συνιστάται">Εγκατάσταση μέσω SDKMAN! (Συνιστάται)</h3> <div class="paragraph"> <p>Το SDKMAN! είναι ένα εξαιρετικό εργαλείο για τη διαχείριση των εκδόσεων πολλών SDK, συμπεριλαμβανομένου του Java και του Gradle.</p> </div> <div class="sect3"> <h4 id="_εγκαταστήστε_το_sdkman"><strong>Εγκαταστήστε το SDKMAN!</strong></h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -s "https://get.sdkman.io" | bash source "$HOME/.sdkman/bin/sdkman-init.sh"</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_εγκαταστήστε_μια_έκδοση_του_jdk">Εγκαταστήστε μια έκδοση του JDK</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Pour lister les versions de Java disponibles sdk list java # Pour installer Java 17 (par exemple, la distribution Temurin) sdk install java 17.0.8-tem</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_επαλήθευση_της_εγκατάστασης">Επαλήθευση της εγκατάστασης</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">java -version</code></pre> </div> </div> <div class="paragraph"> <p>Πρέπει να δείτε την έκδοση που μόλις εγκαταστήσατε να εμφανίζεται.</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_2_το_ide_intellij_idea">2. Το IDE : IntelliJ IDEA</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για την ανάπτυξη των προσθέτων Gradle με το DSL Kotlin,<strong>IntelliJ IDEA</strong>είναι το εργαλείο της επιλογής. Η ενσωμάτωση του με το Gradle και το Kotlin είναι ανυπότακτη.</p> </div> <div class="ulist"> <ul> <li> <p><strong>Εκδοση Κοινοτότητας :</strong>Δωρεάν και αρκετά επαρκή για να αρχίσουμε.</p> </li> <li> <p><strong>Τελική Έκδοση :</strong>Πληρωμένη, προσφέρει προηγμένες λειτουργίες για την ανάπτυξη ιστοσελίδων και βάσεων δεδομένων.</p> </li> </ul> </div> <div class="paragraph"> <p>Κατεβάστε την έκδοση που ταιριάζει στην περίπτωσή σας από τον ιστότοπο του JetBrains: <a href="https://www.jetbrains.com/idea/download/" class="bare">https://www.jetbrains.com/idea/download/</a></p> </div> <div class="paragraph"> <p>Το IDE θα ανιχνεύσει αυτόματα τα αρχεία σας`build.gradle.kts` et <code>settings.gradle.kts</code>, προσφέροντας σας μια ισχυρή αυτοπλήρωση,periήγηση στον κώδικα και ενσωματωμένα εργαλεία αποσφαλμάτωσης.</p> </div> </div> </div> <div class="sect1"> <h2 id="_3_gradle_το_εργαλείο_build">3. Gradle : Το εργαλείο build</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αν και κάθε έργο θα χρησιμοποιήσει τη δική του έκδοση του Gradle μέσω του Gradle Wrapper, είναι χρήσιμο να υπάρχει μια καθολική εγκατάσταση του Gradle για εργασίες όπως η αρχικοποίηση νέων project (<code>gradle init</code>)</p> </div> <div class="sect2"> <h3 id="_εγκατάσταση_μέσω_sdkman">Εγκατάσταση μέσω SDKMAN!</h3> <div class="paragraph"> <p>Όπως και για το JDK, το SDKMAN! απλοποιεί την εγκατάσταση του Gradle.</p> </div> <div class="sect3"> <h4 id="_εγκατάσταση_gradle"><strong>Εγκατάσταση Gradle</strong></h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sdk install gradle</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_επαληθεύστε_την_εγκατάσταση">Επαληθεύστε την εγκατάσταση</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">gradle -v</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η εντολή θα εμφανίσει τις εκδόσεις του Gradle, Kotlin, Groovy και του JDK που χρησιμοποιούνται.</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_4_jbake_το_γεννήτορα_στατικών_ιστοσελίδων">4. JBake : Το γεννήτορα στατικών ιστοσελίδων</h2> <div class="sectionbody"> <div class="paragraph"> <p>JBake είναι το εργαλείο που θα χρησιμοποιήσουμε για να μετατρέψουμε τα αρχεία πηγής μας (όπως αυτό) σε έναν στατικό ιστότοπο. Το να έχετε μια τοπική εγκατάσταση είναι πρακτικό για την προεπισκόπηση των αλλαγών.</p> </div> <div class="sect2"> <h3 id="_εγκατάσταση_μέσω_sdkman_2">Εγκατάσταση μέσω SDKMAN!</h3> <div class="paragraph"> <p>Ως και για τα άλλα εργαλεία, το SDKMAN! είναι η πιο απλή μέθοδος.</p> </div> <div class="sect3"> <h4 id="_εγκαταστήστε_jbake">Εγκαταστήστε JBake</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sdk install jbake</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_έλεγχος_εγκατάστασης">Έλεγχος εγκατάστασης</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">jbake -v</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η εντολή θα εμφανίσει την έκδοση του JBake και τις πληροφορίες του Java περιβάλλοντος που χρησιμοποιεί.</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_5_το_gradle_wrapper_η_απόλυτη_καλή_πρακτική">5. Το Gradle Wrapper : Η απόλυτη καλή πρακτική</h2> <div class="sectionbody"> <div class="paragraph"> <p>Μια φορά που το έργο σας δημιουργηθεί (όπως θα δούμε στο επόμενο άρθρο), δεν θα πρέπει πλέον να χρησιμοποιείτε την παγκόσμια εντολή.<code>gradle</code>. Αντίθετα, θα χρησιμοποιήσετε το<strong>Gradle Wrapper</strong>(<code>./gradlew</code>), ένα script που συμπεριλαμβάνεται στο έργο σας.</p> </div> <div class="paragraph"> <p>Γιατί?</p> </div> <div class="ulist"> <ul> <li> <p><strong>Αναπαραγωγιμότητα :</strong>Ο Wrapper εγγυάται ότι κάθε άτομο που εργάζεται στο έργο (συμπεριλαμβανομένου του διακομιστή CI/CD σας) χρησιμοποιεί ακριβώς το<strong>ίδια έκδοση του Gradle</strong>, αποτρέποντας άρα τα σφάλματα κατασκευής που προκύπτουν λόγω διαφορετικών περιβαλλόντων.</p> </li> <li> <p><strong>Απλότητα :</strong>Δεν χρειάζεται να εγκαταστήσετε το Gradle χειροκίνητα ώστε να symbállete σε ένα έργο.</p> </li> </ul> </div> <div class="paragraph"> <p>Αρκεί να κλώνετε το αποθετήριο και να το τρέξετε`./gradlew`.</p> </div> <div class="paragraph"> <p>Μια τυπική εντολή θα μοιάζει έτσι :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash"># Ne pas faire : gradle build # À faire : ./gradlew build</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_6_docker_και_portainer_για_αναπαραγώγιμες_κατασκευές_προαιρετικό">6. Docker και Portainer: Για αναπαραγώγιμες κατασκευές (Προαιρετικό)</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αν και δεν είναι αυστηρά απαραίτητα για τη γραφή ενός plugin, το Docker και το Portainer είναι σύγχρονα DevOps εργαλεία που διευκολύνουν σημαντικά τη δημιουργία επαναπαράγιμων builds και τη διαχείριση του περιβάλλοντος σας.</p> </div> <div class="sect2"> <h3 id="_εγκατάσταση_docker_engine">Εγκατάσταση Docker Engine</h3> <div class="paragraph"> <p>Ο Docker σας επιτρέπει να πακετάρετε την εφαρμογή σας και τις εξαρτήσεις της μέσα σε ένα κοντέινερ.</p> </div> <div class="sect3"> <h4 id="_εγκαταστήστε_το_docker_μέσω_του_επίσημου_σεναρίου">Εγκαταστήστε το Docker μέσω του επίσημου σεναρίου:</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_διαχείριση_docker_χωρίς_sudo_προτεινόμενο"><strong>Διαχείριση Docker χωρίς <code>sudo</code> (προτεινόμενο) :</strong></h4> <div class="paragraph"> <p>Προσθέστε τον χρήστη σας στην ομάδα`docker`.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo usod -aG docker $USER</code></pre> </div> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="Important"></i> </td> <td class="content"> </td> </tr> </table> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker run hello-world</code></pre> </div> </div> </div> </div> <div class="sect2"> <h3 id="_διαχείριση_docker_με_portainer_gui">Διαχείριση Docker με Portainer (GUI)</h3> <div class="paragraph"> <p>Ο Portainer είναι ένας ελαφρύς διαδικτυακός περιβάλλον για τη διαχείριση των κοντέινερ Docker σας.</p> </div> <div class="sect3"> <h4 id="_δημιουργήστε_ένα_όγκο_για_τα_δεδομένα_του_portainer"><strong>Δημιουργήστε ένα όγκο για τα δεδομένα του Portainer :</strong></h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker volume create portainer_data</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_εκκίνηση_του_κοντέινερ_portainer">Εκκίνηση του κοντέινερ Portainer :</h4> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">docker run -d -p 8000:8000 -p 9443:9443 --name portainer --restart=always -v /var/run/docker.sock:/var/run/docker.sock -v portainer_data:/data portainer/portainer-ce:latest</code></pre> </div> </div> <div class="paragraph"> <p>Μπορείτε τώρα να προσπείρατε τη διεσάνυση του Portainer σε`https://localhost:9443`.</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το περιβάλλον σου είναι έτοιμο τώρα! Έχετε ένα JDK, το πιο κατάλληλο IDE, το Gradle και το JBake. Με την προσθήκη του Docker, είστε επίσης έτοιμοι να δημιουργήσετε κοντέινερ- και αναγογιμές κατασκευές. Αυτή η ισχυρή βάση θα σας επιτρέψει να εστιάσετε στο ουσιώδες: την ανάπτυξη ισχυρών και χρήσιμων plugin.</p> </div> <div class="paragraph"> <p>Στο επόμενο άρθρο, θα χρησιμοποιήσουμε την εντολή`gradle init`για να δημιουργήσει τη δομή του πρώτου έργου plugin μας.</p> </div> </div> </div> https://cheroliv.com/blog/2025/0087_pypi_cicd_part_3_post.html Sat, 19 Jul 2025 00:00:00 +0000 blog/2025/0087_pypi_cicd_part_3_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_ενσωμάτωση_με_το_poetry">Ενσωμάτωση με το Poetry</a> <ul class="sectlevel2"> <li><a href="#_εγκατάσταση_του_poetry">Εγκατάσταση του Poetry</a></li> <li><a href="#_αρχικοποίηση_του_έργου">Αρχικοποίηση του έργου</a></li> <li><a href="#_προσθήκη_και_εγκατάσταση_εξαρτήσεων">Προσθήκη και εγκατάσταση εξαρτήσεων</a></li> <li><a href="#_δημοσίευση_με_poetry">Δημοσίευση με Poetry</a></li> </ul> </li> <li><a href="#_κατασκευές_αναπαραγώσιμες_με_docker">Κατασκευές αναπαραγώσιμες με Docker</a> <ul class="sectlevel2"> <li><a href="#_παράδειγμα_dockerfile">Παράδειγμα Dockerfile</a></li> <li><a href="#_ενσωμάτωση_στο_github_actions">Ενσωμάτωση στο GitHub Actions</a></li> </ul> </li> <li><a href="#_έκδοση_υπό_συνθήκη">Έκδοση υπό συνθήκη</a></li> <li><a href="#_αυτοματοποίηση_εξαρτήσεων_με_το_renovate_και_το_dependabot">Αυτοματοποίηση εξαρτήσεων με το Renovate και το Dependabot</a> <ul class="sectlevel2"> <li><a href="#_dependabot">Dependabot</a></li> <li><a href="#_ανανεώστε">Ανανεώστε</a></li> </ul> </li> <li><a href="#_διαγράμματα_plantuml">Διαγράμματα PlantUML</a> <ul class="sectlevel2"> <li><a href="#_περίπτωση_χρήσης_προχωρημένο_cicd">Περίπτωση χρήσης – προχωρημένο CI/CD</a></li> <li><a href="#_ακολουθία_δημοσίευση_υπό_συνθήκη">Ακολουθία – Δημοσίευση υπό συνθήκη</a></li> <li><a href="#_καταστάσεις_pipeline_cicd">Καταστάσεις – Pipeline CI/CD</a></li> <li><a href="#_ανάπτυξη_αρχιτεκτονική_cicd">Ανάπτυξη – Αρχιτεκτονική CI/CD</a></li> </ul> </li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>Σε τα πρώτα δύο μέρη αυτής της σειράς, έχουμε : - Έθεσε έναν λειτουργικό pipeline CI/CD για μια εφαρμογή Python με το GitHub Actions και το PyPI. - Ενσωματώσαμε αυτήν τη διαδικασία με δοκιμές πολλαπλών εκδόσεων, σταδιακή δημοσίευση μέσω Test PyPI, και εργαλεία ποιότητας και ασφαλείας.</p> </div> <div class="paragraph"> <p>Σε αυτό το τρίτο μέρος, θα πάμε<strong>πέρα από την απλή δημοσίευση στο PyPI</strong>για τη κατασκευή μιας πλήρους, αξιόπιστης και επαγγελματικής αλυσίδας CI/CD με : - <strong>Ποίηση</strong>για ένα σύγχρονο πακέτο και μια βελτιστοποιημένη διαχείριση των εξαρτήσεων. - <strong>Docker</strong>για να δημιουργήσετε builds επαναλαμβανόμενα και πολυ-πλατφορμικά. - <strong>Συνθηκή δημοσίευση</strong>για τη διαχείριση σεναρίων όπως τα release candidates. - <strong>Εργαλεία αυτοματοποίησης</strong>(Renovate, Dependabot) για να διατηρείτε τον αγωγό ενημερωμένο χωρίς κόπο.</p> </div> </div> </div> <div class="sect1"> <h2 id="_ενσωμάτωση_με_το_poetry">Ενσωμάτωση με το Poetry</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η Poetry αντικαθιστά τα παλαιά εργαλεία πακεταρίσματος (setup.py, requirements.txt) κεντροποιώντας τη διαχείριση των εξαρτήσεων και του build σε`pyproject.toml`.</p> </div> <div class="sect2"> <h3 id="_εγκατάσταση_του_poetry">Εγκατάσταση του Poetry</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="shell"># Installer Poetry curl -sSL https://install.python-poetry.org | python3 - # Vérifier la version poetry --version</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_αρχικοποίηση_του_έργου">Αρχικοποίηση του έργου</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="shell"># Initialiser un nouveau projet avec Poetry poetry init # Suivre l'assistant pour renseigner : nom, version, description, licence, dépendances.</code></pre> </div> </div> <div class="paragraph"> <p>Αυτό δημιουργεί ένα αρχείο`pyproject.toml`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="toml">[tool.poetry] name = "playlist-downloader" version = "0.1.0" description = "CLI tool for managing YouTube playlists" authors = ["Christophe Hérolivier <cheroliv@example.com>"] [tool.poetry.dependencies] python = ">=3.8" typer = "^0.9.0" yt-dlp = "^2023.7.6" google-api-python-client = "^2.0.0" google-auth-oauthlib = "^1.0.0" [tool.poetry.group.dev.dependencies] pytest = "^7.0" mypy = "^1.0" bandit = "^1.7" safety = "^2.3" black = "^23.0" ruff = "^0.1"</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_προσθήκη_και_εγκατάσταση_εξαρτήσεων">Προσθήκη και εγκατάσταση εξαρτήσεων</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="shell">poetry add typer yt-dlp google-api-python-client google-auth-oauthlib poetry add --group dev pytest mypy black bandit safety ruff</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_δημοσίευση_με_poetry">Δημοσίευση με Poetry</h3> <div class="paragraph"> <p>Η Poetry διαχειρίζεται εγγενώς την αναδημοσίευση:</p> </div> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="shell"># Publication sur Test PyPI poetry publish --build --repository test-pypi # Publication sur PyPI poetry publish --build</code></pre> </div> </div> <div class="paragraph"> <p>Η εντολή αυτόματα χρησιμοποιεί τις πληροφορίες που υπάρχουν στο`pyproject.toml`.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_κατασκευές_αναπαραγώσιμες_με_docker">Κατασκευές αναπαραγώσιμες με Docker</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να εξασφαλίσουμε ταυτικές εκτελέσεις σε ανάπτυξη, CI/CD και παραγωγή, ο Docker ενσωματώνεται αβίαστα με το Poetry.</p> </div> <div class="sect2"> <h3 id="_παράδειγμα_dockerfile">Παράδειγμα Dockerfile</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="dockerfile">FROM python:3.11-slim WORKDIR /app COPY pyproject.toml poetry.lock ./ RUN pip install poetry RUN poetry install --no-root --only main COPY . . CMD ["poetry", "run", "python", "cli.py"]</code></pre> </div> </div> <div class="paragraph"> <p>Αυτό εγγυάται : - Ένα παγωμένο περιβάλλον Python. - Εξαρτήσεις κλειδωμένες μέσω`poetry.lock`. - Μια εκτελέσιμη εικόνα σε κάθε σύστημα που υποστηρίζει το Docker.</p> </div> </div> <div class="sect2"> <h3 id="_ενσωμάτωση_στο_github_actions">Ενσωμάτωση στο GitHub Actions</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="yaml">name: Docker Build on: push: branches: [main] jobs: build-docker: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Build Docker image run: docker build -t ghcr.io/${{ github.repository }}:latest . - name: Push Docker image run: docker push ghcr.io/${{ github.repository }}:latest</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_έκδοση_υπό_συνθήκη">Έκδοση υπό συνθήκη</h2> <div class="sectionbody"> <div class="paragraph"> <p>Σε έναν επαγγελματικό pipeline, πρέπει να μπορέσουμε να δημοσιεύουμε μόνο σε ορισμένα περιπτώσεις: - Εκδόσεις υποψηφιότητες προς Test PyPI. - Οι σταθερές έκδοσεις προς το PyPI. - Builds Docker εκτελεσμένοι μόνο για`main`.</p> </div> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="yaml">- name: Publish to Test PyPI if: contains(github.ref, '-rc') run: poetry publish --build --repository test-pypi - name: Publish to PyPI if: startsWith(github.ref, 'refs/tags/v') run: poetry publish --build</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η προσέγγιση αποτρέπει τα τυχαία δημοσιεύματα.</p> </div> </div> </div> <div class="sect1"> <h2 id="_αυτοματοποίηση_εξαρτήσεων_με_το_renovate_και_το_dependabot">Αυτοματοποίηση εξαρτήσεων με το Renovate και το Dependabot</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να αποφύγετε το γεγονός ότι οι εξαρτήσεις σας γίνονται παρωχημένες, ενσωματώστε εργαλεία αυτόματης ενημέρωσης.</p> </div> <div class="sect2"> <h3 id="_dependabot">Dependabot</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="yaml">version: 2 updates: - package-ecosystem: "pip" directory: "/" schedule: interval: "weekly" - package-ecosystem: "github-actions" directory: "/" schedule: interval: "weekly"</code></pre> </div> </div> <div class="paragraph"> <p>Ο Dependabot ανοίγει PR κάθε εβδομάδα για να ενημερώσει τις εξαρτήσεις Python και GitHub Actions.</p> </div> </div> <div class="sect2"> <h3 id="_ανανεώστε">Ανανεώστε</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="json">{ "extends": ["config:base"], "packageRules": [ { "matchManagers": ["pip"], "groupName": "python-dependencies", "schedule": ["before 6am on monday"] } ] }</code></pre> </div> </div> <div class="paragraph"> <p>Renovate επιτρέπει πιο ακριβή έλεγχο: ομαδοποίηση εξαρτήσεων, προγραμματισμός, και προχωρημένοι κανόνες.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διαγράμματα_plantuml">Διαγράμματα PlantUML</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_περίπτωση_χρήσης_προχωρημένο_cicd">Περίπτωση χρήσης – προχωρημένο CI/CD</h3> <div class="imageblock"> <div class="content"> <img src="images/usecase-cicd.svg" alt="usecase cicd" width="846" height="317"> </div> </div> </div> <div class="sect2"> <h3 id="_ακολουθία_δημοσίευση_υπό_συνθήκη">Ακολουθία – Δημοσίευση υπό συνθήκη</h3> <div class="imageblock"> <div class="content"> <img src="images/sequence-cicd.svg" alt="sequence cicd" width="275" height="571"> </div> </div> </div> <div class="sect2"> <h3 id="_καταστάσεις_pipeline_cicd">Καταστάσεις – Pipeline CI/CD</h3> <div class="imageblock"> <div class="content"> <img src="images/states-cicd.svg" alt="states cicd" width="284" height="608"> </div> </div> </div> <div class="sect2"> <h3 id="_ανάπτυξη_αρχιτεκτονική_cicd">Ανάπτυξη – Αρχιτεκτονική CI/CD</h3> <div class="imageblock"> <div class="content"> <img src="images/deployment-cicd.svg" alt="deployment cicd" width="1614" height="5628"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Στο αυτό το τρίτο μέρος, είδαμε πώς: - Μοντέρναποίηση του πακετάρισματος Python με το Poetry. - Εγγυάστε αναπαραγώγιμη κατασκευή μέσω Docker. - Ρυθμίστε μια συνθηματική δημοσίευση. - Αυτοματοποίηση της ενημέρωσης των εξαρτήσεων.</p> </div> <div class="paragraph"> <p>Τώρα έχετε ένα pipeline CI/CD<strong>πλήρης, βιομηχανοποιημένος και ασφαλής</strong>, πρόθυμος να εξελιχθεί με τα έργα σας.</p> </div> </div> </div> https://cheroliv.com/blog/2025/0086_pypi_cicd_part_2_post.html Fri, 18 Jul 2025 00:00:00 +0000 blog/2025/0086_pypi_cicd_part_2_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_αρχιτεκτονική_του_pipeline_cicd">Αρχιτεκτονική του pipeline CI/CD</a></li> <li><a href="#_δομή_του_έργου">Δομή του έργου</a></li> <li><a href="#_ρύθμιση_πακέτου_με_το_pyproject_toml">�Ρύθμιση πακέτου με το pyproject.toml</a></li> <li><a href="#_ροή_εργασιών_cicd_δοκιμές_και_ποιότητα">�Ροή εργασιών CI/CD - Δοκιμές και Ποιότητα</a></li> <li><a href="#_workflow_έκδοσης_και_διανομής">Workflow Έκδοσης και Διανομής</a></li> <li><a href="#_διαγράμματα_αρχιτεκτονικής">Διαγράμματα Αρχιτεκτονικής</a> <ul class="sectlevel2"> <li><a href="#_διάγραμμα_ακολουθίας_διαδικασία_κυκλοφορίας">Διάγραμμα ακολουθίας - διαδικασία κυκλοφορίας</a></li> <li><a href="#_διάγραμμα_cathedral_κύκλος_ζωής_του_πακέtool_callς">Διάγραμμα cathedral - Κύκλος ζωής του πακέ</tool_call>ς</a></li> <li><a href="#_διάγραμμα_ανάπτυξης_υποδομή_cicd">Διάγραμμα ανάπτυξης - Υποδομή CI/CD</a></li> </ul> </li> <li><a href="#_αντικείμενα_και_μοντέλα_του_pipeline">Αντικείμενα και Μοντέλα του Pipeline</a> <ul class="sectlevel2"> <li><a href="#_διάγραμμα_κλάσεων_μοντέλα_cicd">Διάγραμμα Κλάσεων - Μοντέλα CI/CD</a></li> </ul> </li> <li><a href="#_ρύθμιση_μυστικών">Ρύθμιση μυστικών</a> <ul class="sectlevel2"> <li><a href="#_μυστικά_github_actions">Μυστικά GitHub Actions</a></li> <li><a href="#_δημιουργία_των_διακριτικών_pypi">Δημιουργία των διακριτικών PyPI</a></li> </ul> </li> <li><a href="#_σκρίπτες_τοπικής_ανάπτυξης">Σκρίπτες τοπικής ανάπτυξης</a> <ul class="sectlevel2"> <li><a href="#_makefile">Makefile</a></li> <li><a href="#_σενάριο_έκδοσης">Σενάριο Έκδοσης</a></li> </ul> </li> <li><a href="#_καλές_πρακτικές_και_συστάσεις">Καλές πρακτικές και συστάσεις</a> <ul class="sectlevel2"> <li><a href="#_σεμαντική_διαχείριση_εκδόσεων">Σεμαντική διαχείριση εκδόσεων</a></li> <li><a href="#_στρατζηγια_διακλαδωσης">Στρατζηγια διακλαδωσης</a></li> <li><a href="#_δοκιμές_και_κάλυψη">δοκιμές και κάλυψη</a></li> <li><a href="#_ασφάλεια">Ασφάλεια</a></li> </ul> </li> <li><a href="#_παρακολούθηση_και_παρατηρησιμότητα">Παρακολούθηση και Παρατηρησιμότητα</a> <ul class="sectlevel2"> <li><a href="#_μετρικά_pipeline">Μετρικά Pipeline</a></li> <li><a href="#_ειδοποιήσεις">Ειδοποιήσεις</a></li> </ul> </li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> <li><a href="#_συμπληρωματικοί_πόροι">Συμπληρωματικοί Πόροι</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Σκοπός : Μετατρέπετε έναν απλό pipeline σε έναν αξιόπιστο βιομηχανικό pipeline που συμμορφώνεται με τις σύγχρονες πρότυπα του πακετάζ και της λογισμικής μηχανικής.</div> <p>Στο πρώτο μέρος αυτής της σειράς, κατασκευάσαμε ένα απλό αλλά αποτελεσματικό pipeline CI/CD για να αυτοματοποιήσουμε τα τεστ και τη δημοσίευση ενός πακέτου Python στο PyPI.</p> </div> <div class="paragraph"> <p>Τώρα είναι η ώρα για να επαγγελματοποιήσουμε αυτό το pipeline. Σε αυτό το δεύτερο μέρος, θα :</p> </div> <div class="ulist"> <ul> <li> <p>Μετακόμιση στον σύγχρονο πρότυπο pyproject.toml,</p> </li> <li> <p>Προσθέστε εργαλεία ποιότητας και ασφάλειας (Black, Mypy, Bandit, Safety)</p> </li> <li> <p>Θέτε σε εφαρμογή δοκιμές πολλαπλών εκδόσεων,</p> </li> <li> <p>Ενσωματώστε μια σταδιακή ανάπτυξη μέσω του Test PyPI,</p> </li> <li> <p>Αυτοματοποίηση της διαχείρισης εκδόσεων και βελτίωση της παρακολούθησης του pipeline.</p> </li> </ul> </div> <div class="paragraph"> <p>Προετοιμάστε να μεταβείτε από ένα λειτουργικό pipeline σε μια επαγγελματική υποδομή CI/CD.</p> </div> <div class="paragraph"> <p>Η ανάπτυξη μιας εφαρμογής Python στο PyPI απαιτεί ένα ισχυρό CI/CD pipeline που αυτοματοποιεί τα τεστ, το χτίσιμο και τη δημοσίευση των πακέτων. Αυτό το άρθρο αναλυτικά περιγράφει τη ρύθμιση ενός πλήρους pipeline χρησιμοποιώντας GitHub Actions για μια εφαρμογή CLI Python, βασισμένο στις καλύτερες πρακτικές του σύγχρονου ecosystem Python.</p> </div> </div> </div> <div class="sect1"> <h2 id="_αρχιτεκτονική_του_pipeline_cicd">Αρχιτεκτονική του pipeline CI/CD</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το pipeline που θα κατασκευάσουμε ακολουθεί μια προσέγγιση σε βήματα:</p> </div> <div class="imageblock"> <div class="content"> <img src="images/diag-plantuml-md5-9329b179c019063263eca294420348fb.png" alt="Diagram" width="960" height="604"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_δομή_του_έργου">Δομή του έργου</h2> <div class="sectionbody"> <div class="paragraph"> <p>Μια εφαρμογή Python CLI έτοιμη για διανομή πρέπει να τηρεί μια τυποποιημένη δομή:</p> </div> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="text">playlist-downloader/ ├── .github/ │ └── workflows/ │ ├── ci.yml │ ├── release.yml │ └── security.yml ├── src/ │ └── playlist_downloader/ │ ├── __init__.py │ ├── cli.py │ ├── core/ │ └── adapters/ ├── tests/ │ ├── unit/ │ ├── integration/ │ └── conftest.py ├── docs/ ├── pyproject.toml ├── requirements.txt ├── requirements-dev.txt ├── MANIFEST.in ├── README.md ├── LICENSE └── CHANGELOG.md</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ρύθμιση_πακέτου_με_το_pyproject_toml">�Ρύθμιση πακέτου με το pyproject.toml</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το αρχείο`pyproject.toml`είναι το σύγχρονο πρότυπο για τη ρύθμιση των πακέτων Python :</p> </div> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="toml">[build-system] requires = ["setuptools>=45", "wheel", "setuptools_scm>=6.2"] build-backend = "setuptools.build_meta" [project] name = "playlist-downloader" authors = [ {name = "Christophe Hérolivier", email = "cheroliv@example.com"}, ] description = "CLI tool for YouTube playlist management" readme = "README.md" requires-python = ">=3.8" keywords = ["youtube", "playlist", "cli", "downloader"] license = {text = "MIT"} classifiers = [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: End Users/Desktop", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Topic :: Multimedia :: Sound/Audio", "Topic :: Utilities", ] dependencies = [ "typer>=0.9.0", "yt-dlp>=2023.7.6", "google-api-python-client>=2.0.0", "google-auth-oauthlib>=1.0.0", "pyyaml>=6.0", "rich>=13.0.0", ] dynamic = ["version"] [project.optional-dependencies] dev = [ "pytest>=7.0.0", "pytest-cov>=4.0.0", "pytest-mock>=3.10.0", "black>=23.0.0", "flake8>=6.0.0", "mypy>=1.0.0", "pre-commit>=3.0.0", "tox>=4.0.0", ] test = [ "pytest>=7.0.0", "pytest-cov>=4.0.0", "pytest-mock>=3.10.0", ] [project.urls] Homepage = "https://github.com/cheroliv/playlist-downloader" Documentation = "https://github.com/cheroliv/playlist-downloader#readme" Repository = "https://github.com/cheroliv/playlist-downloader.git" "Bug Tracker" = "https://github.com/cheroliv/playlist-downloader/issues" [project.scripts] playlist-downloader = "playlist_downloader.cli:main" [tool.setuptools_scm] write_to = "src/playlist_downloader/_version.py" [tool.setuptools.packages.find] where = ["src"] [tool.pytest.ini_options] testpaths = ["tests"] python_files = ["test_*.py"] python_classes = ["Test*"] python_functions = ["test_*"] addopts = [ "--cov=src/playlist_downloader", "--cov-report=html", "--cov-report=term-missing", "--cov-fail-under=85", ] [tool.black] line-length = 88 target-version = ['py38'] include = '\.pyi?$' extend-exclude = ''' /( \.eggs | \.git | \.hg | \.mypy_cache | \.tox | \.venv | _build | buck-out | build | dist )/ ''' [tool.mypy] python_version = "3.8" warn_return_any = true warn_unused_configs = true disallow_untyped_defs = true disallow_incomplete_defs = true check_untyped_defs = true disallow_untyped_decorators = true no_implicit_optional = true warn_redundant_casts = true warn_unused_ignores = true warn_no_return = true warn_unreachable = true strict_equality = true [[tool.mypy.overrides]] module = [ "yt_dlp.*", "googleapiclient.*", "google_auth_oauthlib.*", ] ignore_missing_imports = true</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ροή_εργασιών_cicd_δοκιμές_και_ποιότητα">�Ροή εργασιών CI/CD - Δοκιμές και Ποιότητα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το κύριο workflow (<code>ci.yml</code>) εκτελεί τα τεστ σε πολλές εκδόσεις της Python :</p> </div> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="yaml">name: CI on: push: branches: [ main, develop ] pull_request: branches: [ main ] jobs: test: runs-on: ubuntu-latest strategy: matrix: python-version: ["3.8", "3.9", "3.10", "3.11"] steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - name: Set up Python ${{ matrix.python-version }} uses: actions/setup-python@v4 with: python-version: ${{ matrix.python-version }} - name: Cache dependencies uses: actions/cache@v3 with: path: | ~/.cache/pip ~/.cache/pre-commit key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements*.txt') }} restore-keys: | ${{ runner.os }}-pip- - name: Install dependencies run: | python -m pip install --upgrade pip pip install -e ".[dev]" - name: Lint with flake8 run: | flake8 src tests --count --select=E9,F63,F7,F82 --show-source --statistics flake8 src tests --count --exit-zero --max-complexity=10 --max-line-length=88 --statistics - name: Check code formatting with Black run: black --check src tests - name: Type checking with mypy run: mypy src - name: Run tests with pytest run: | pytest tests/ -v --cov=src/playlist_downloader \ --cov-report=xml --cov-report=term-missing - name: Upload coverage to Codecov uses: codecov/codecov-action@v3 if: matrix.python-version == '3.11' with: file: ./coverage.xml flags: unittests name: codecov-umbrella security: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v4 with: python-version: "3.11" - name: Install dependencies run: | python -m pip install --upgrade pip pip install bandit[toml] safety - name: Run security checks with bandit run: bandit -r src/ -f json -o bandit-report.json - name: Check dependencies with safety run: safety check --json --output safety-report.json - name: Upload security reports uses: actions/upload-artifact@v3 if: always() with: name: security-reports path: | bandit-report.json safety-report.json build: needs: [test, security] runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - name: Set up Python uses: actions/setup-python@v4 with: python-version: "3.11" - name: Install build dependencies run: | python -m pip install --upgrade pip pip install build twine - name: Build package run: python -m build - name: Check package with twine run: twine check dist/* - name: Upload build artifacts uses: actions/upload-artifact@v3 with: name: dist path: dist/</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_workflow_έκδοσης_και_διανομής">Workflow Έκδοσης και Διανομής</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η ροή έκδοση (<code>release.yml</code>) διαχειρίζεται την αυτόματη δημοσίευση στο PyPI :</p> </div> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="yaml">name: Release on: push: tags: - 'v*.*.*' workflow_dispatch: inputs: environment: description: 'Deployment environment' required: true default: 'test' type: choice options: - test - production env: PYTHON_VERSION: "3.11" jobs: release: runs-on: ubuntu-latest environment: name: ${{ github.event.inputs.environment || (startsWith(github.ref, 'refs/tags/') && 'production' || 'test') }} steps: - uses: actions/checkout@v4 with: fetch-depth: 0 - name: Set up Python uses: actions/setup-python@v4 with: python-version: ${{ env.PYTHON_VERSION }} - name: Install dependencies run: | python -m pip install --upgrade pip pip install build twine - name: Build package run: python -m build - name: Check package run: twine check dist/* - name: Publish to Test PyPI if: github.event.inputs.environment == 'test' || (startsWith(github.ref, 'refs/tags/') && contains(github.ref, 'rc')) env: TWINE_USERNAME: __token__ TWINE_PASSWORD: ${{ secrets.TEST_PYPI_API_TOKEN }} run: | twine upload --repository testpypi dist/* - name: Publish to PyPI if: github.event.inputs.environment == 'production' || (startsWith(github.ref, 'refs/tags/') && !contains(github.ref, 'rc')) env: TWINE_USERNAME: __token__ TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }} run: | twine upload dist/* - name: Create GitHub Release if: startsWith(github.ref, 'refs/tags/') uses: actions/create-release@v1 env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} with: tag_name: ${{ github.ref }} release_name: Release ${{ github.ref }} draft: false prerelease: ${{ contains(github.ref, 'rc') }} post-release: needs: release runs-on: ubuntu-latest if: startsWith(github.ref, 'refs/tags/') steps: - uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v4 with: python-version: ${{ env.PYTHON_VERSION }} - name: Test installation from PyPI run: | sleep 60 # Attendre la propagation sur PyPI pip install playlist-downloader playlist-downloader --version - name: Update documentation run: | # Script pour mettre à jour la documentation echo "Documentation updated for version ${GITHUB_REF#refs/tags/}"</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διαγράμματα_αρχιτεκτονικής">Διαγράμματα Αρχιτεκτονικής</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_διάγραμμα_ακολουθίας_διαδικασία_κυκλοφορίας">Διάγραμμα ακολουθίας - διαδικασία κυκλοφορίας</h3> <div class="imageblock"> <div class="content"> <img src="images/diag-plantuml-md5-ebcb514907d9e3f757172db1a67b358e.png" alt="Diagram" width="962" height="832"> </div> </div> </div> <div class="sect2"> <h3 id="_διάγραμμα_cathedral_κύκλος_ζωής_του_πακέtool_callς">Διάγραμμα cathedral - Κύκλος ζωής του πακέ</tool_call>ς</h3> <div class="imageblock"> <div class="content"> <img src="images/diag-plantuml-md5-51cf4e300df9adefdfe01731779050c3.png" alt="Diagram" width="530" height="740"> </div> </div> </div> <div class="sect2"> <h3 id="_διάγραμμα_ανάπτυξης_υποδομή_cicd">Διάγραμμα ανάπτυξης - Υποδομή CI/CD</h3> <div class="imageblock"> <div class="content"> <img src="images/diag-plantuml-md5-2bacadfa67afd417f020792cc9ea9f99.png" alt="Diagram" width="703" height="604"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αντικείμενα_και_μοντέλα_του_pipeline">Αντικείμενα και Μοντέλα του Pipeline</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_διάγραμμα_κλάσεων_μοντέλα_cicd">Διάγραμμα Κλάσεων - Μοντέλα CI/CD</h3> <div class="imageblock"> <div class="content"> <img src="images/diag-plantuml-md5-2c404f6cd86ea678d4fb0c2f9e208439.png" alt="Diagram" width="814" height="635"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ρύθμιση_μυστικών">Ρύθμιση μυστικών</h2> <div class="sectionbody"> <div class="paragraph"> <p>για να λειτουργήσει το pipeline, πρέπει να ρυθμίσετε τα ακόλουθα μυστικά στο GitHub :</p> </div> <div class="sect2"> <h3 id="_μυστικά_github_actions">Μυστικά GitHub Actions</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="bash"># Dans Settings > Secrets and variables > Actions # Token PyPI pour la production PYPI_API_TOKEN=pypi-... # Token Test PyPI pour les pré-releases TEST_PYPI_API_TOKEN=pypi-... # Token GitHub pour créer les releases GITHUB_TOKEN=(automatiquement fourni) # Token Codecov (optionnel) CODECOV_TOKEN=...</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_δημιουργία_των_διακριτικών_pypi">Δημιουργία των διακριτικών PyPI</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="bash"># 1. Créer un compte sur PyPI et Test PyPI # 2. Aller dans Account Settings > API tokens # 3. Créer un token avec scope "Entire account" ou spécifique au projet # 4. Format du token : pypi-AgEIcHlwaS5vcmc...</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_σκρίπτες_τοπικής_ανάπτυξης">Σκρίπτες τοπικής ανάπτυξης</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να διευκολύνετε την ανάπτυξη, δημιουργήστε σενάρια βοηθών:</p> </div> <div class="sect2"> <h3 id="_makefile">Makefile</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="makefile">.PHONY: install test lint format security build clean release-test release-prod install: pip install -e ".[dev]" test: pytest tests/ -v --cov=src/playlist_downloader lint: flake8 src tests mypy src format: black src tests security: bandit -r src/ safety check build: python -m build twine check dist/* clean: rm -rf build/ dist/ *.egg-info/ find . -type d -name __pycache__ -delete find . -name "*.pyc" -delete release-test: clean build twine upload --repository testpypi dist/* release-prod: clean build twine upload dist/* pre-commit: format lint test security @echo "✅ Prêt pour commit"</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_σενάριο_έκδοσης">Σενάριο Έκδοσης</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="python">#!/usr/bin/env python3 """Script pour gérer les versions du projet.""" import sys import subprocess from pathlib import Path def get_current_version(): """Récupère la version actuelle depuis git.""" try: result = subprocess.run( ["git", "describe", "--tags", "--abbrev=0"], capture_output=True, text=True, check=True ) return result.stdout.strip() except subprocess.CalledProcessError: return "0.0.0" def create_version_tag(version, message=None): """Crée un tag de version.""" if not version.startswith('v'): version = f'v{version}' tag_message = message or f"Release {version}" subprocess.run(["git", "tag", "-a", version, "-m", tag_message], check=True) print(f"✅ Tag {version} créé") # Push le tag subprocess.run(["git", "push", "origin", version], check=True) print(f"✅ Tag {version} poussé vers origin") if __name__ == "__main__": if len(sys.argv) < 2: current = get_current_version() print(f"Version actuelle: {current}") print("Usage: python version.py <new_version> [message]") sys.exit(1) new_version = sys.argv[1] message = sys.argv[2] if len(sys.argv) > 2 else None create_version_tag(new_version, message)</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_καλές_πρακτικές_και_συστάσεις">Καλές πρακτικές και συστάσεις</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_σεμαντική_διαχείριση_εκδόσεων">Σεμαντική διαχείριση εκδόσεων</h3> <div class="paragraph"> <p>Χρησιμοποιήστε τη σημασιολογική εκδοχή (SemVer):</p> </div> <div class="ulist"> <ul> <li> <p><code>MAJOR.MINOR.PATCH</code> (ex: 1.2.3)</p> </li> <li> <p><code>MAJOR</code>: αλλαγές ασυμβατές</p> </li> <li> <p><code>MINOR</code>: νέες συμβατές λειτουργίες</p> </li> <li> <p><code>PATCH</code>: συμβατές διορθώσεις σφαλμάτων</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_στρατζηγια_διακλαδωσης">Στρατζηγια διακλαδωσης</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="text">main ──●──●──●──●──●────●── (releases stables) / / / develop ──●──●──●──●──●──●──●──●── (développement) / / / feature/xxx ●──●──●──●──●──/ (fonctionnalités)</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_δοκιμές_και_κάλυψη">δοκιμές και κάλυψη</h3> <div class="ulist"> <ul> <li> <p>Ελάχιστη καλύμversa κώδικα : 85%</p> </li> <li> <p>Μονάδιες δοκιμές για την επιχειρηματική λογική</p> </li> <li> <p>Ενταξιακά τεστ για τους αδαπτήρες</p> </li> <li> <p>Τεστ από άκρο σε άκρο για τα CLI</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_ασφάλεια">Ασφάλεια</h3> <div class="ulist"> <ul> <li> <p>Αυτόματο σαρώμα εξαρτήσεων (Safety)</p> </li> <li> <p>Στατική ανάλυση κώδικα (Bandit)</p> </li> <li> <p>Τα μυστικά ποτέ στον κώδικα</p> </li> <li> <p>Χρήση συγκεκριμένων διακριτικών PyPI</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_παρακολούθηση_και_παρατηρησιμότητα">Παρακολούθηση και Παρατηρησιμότητα</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_μετρικά_pipeline">Μετρικά Pipeline</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="yaml"># .github/workflows/metrics.yml name: Pipeline Metrics on: workflow_run: workflows: ["CI", "Release"] types: [completed] jobs: metrics: runs-on: ubuntu-latest steps: - name: Collect metrics run: | echo "Pipeline: ${{ github.event.workflow_run.name }}" echo "Status: ${{ github.event.workflow_run.conclusion }}" echo "Duration: ${{ github.event.workflow_run.updated_at - github.event.workflow_run.created_at }}" # Envoyer vers système de monitoring</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ειδοποιήσεις">Ειδοποιήσεις</h3> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="yaml"># Ajout dans les workflows pour notifications - name: Notify on failure if: failure() uses: 8398a7/action-slack@v3 with: status: failure text: "❌ Pipeline failed for ${{ github.repository }}" env: SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK }}</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτό το πλήρες pipeline CI/CD για Python προσφέρει:</p> </div> <div class="ulist"> <ul> <li> <p><strong>Πλήρης αυτοματοποίηση</strong>: από τη δοκιμασία του κώδικα προς τη δημοσίευση</p> </li> <li> <p><strong>Ασφάλεια</strong>αυτόματες άρωσεις και ασφαλής διαχείριση των μυστικών</p> </li> <li> <p><strong>Ποιότητα</strong>δοκιμές πολλαπλών εκδόσεων, linting και καλυμμένο κώδικα</p> </li> <li> <p><strong>αξιοπιστία</strong>: προοδευτική ανάπτυξη μέσω Test PyPI</p> </li> <li> <p><strong>ιχνευσιμότητα</strong>artifacts, αναφορές και releases GitHub</p> </li> </ul> </div> <div class="paragraph"> <p>Η υιοθέτηση αυτών των πρακτικών εξασφαλίζει μια ισχυρή και επαγγελματική διαδικασία παράδοσης για τις εφαρμογές σας Python CLI, διευκολύνοντας τη συντήρηση και την εξέλιξη των εργών σας στον μακρόπρόθεσμο χρόνο.</p> </div> </div> </div> <div class="sect1"> <h2 id="_συμπληρωματικοί_πόροι">Συμπληρωματικοί Πόροι</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://packaging.python.org/">Οδηγός Χρήστη Συσκευασίας Python</a></p> </li> <li> <p><a href="https://docs.github.com/en/actions">Τεκμηρίωση GitHub Actions</a></p> </li> <li> <p><a href="https://pypi.org/help/">PyPI Βοηθητική Τεκμηρίωση</a></p> </li> <li> <p><a href="https://semver.org/">διαδιαγραφικό εγχειρίديو συμαντικής έκδοσης</a></p> </li> <li> <p><a href="https://keepachangelog.com/">Κρατήστε ένα αρχείο αλλαγών</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2025/0085_pypi_cicd_part_1_post.html Thu, 17 Jul 2025 00:00:00 +0000 blog/2025/0085_pypi_cicd_part_1_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_αρχιτεκτονική_του_pipeline">Αρχιτεκτονική του Pipeline</a></li> <li><a href="#_διαμόρφωση_του_pipeline_της_συνεχούς_ενσωμάτωσης_ci">Διαμόρφωση του Pipeline της Συνεχούς Ενσωμάτωσης (CI)</a> <ul class="sectlevel2"> <li><a href="#_δομή_του_workflow_ci">Δομή του Workflow CI</a></li> <li><a href="#_ανάλυση_των_βημάτων_ci">Ανάλυση των βημάτων CI</a> <ul class="sectlevel3"> <li><a href="#_ενεργοποιητές_on">Ενεργοποιητές (<code>on</code>)</a></li> </ul> </li> </ul> </li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Σκοπός : Να βοηθήσει τον αναγνώστη στην υλοποίηση ενός ελάχιστου αλλά funzionικού pipeline CI/CD για μια εφαρμογή Python, με αυτόματη ανάπτυξη στο PyPI.</div> <p>Ένας καλά σχεδιασμένος pipeline CI/CD επιτρέπει όχι μόνο την νωρίς ανίχνευση αναλλοίωσης στο κύκλο ανάπτυξης, αλλά και την πλήρης αυτοματοποίηση της διαδικασίας ανάπτυξης.</p> </div> <div class="paragraph"> <p>Σε αυτό το άρθρο, θα εξερευνήσουμε πώς να ρυθμίσουμε ένα πλήρες pipeline με GitHub Actions για μια εφαρμογή Python, από τη συνεχή ενσωμάτωση (CI) έως τη συνεχή ανάπτυξη (CD) στο PyPI.</p> </div> </div> </div> <div class="sect1"> <h2 id="_αρχιτεκτονική_του_pipeline">Αρχιτεκτονική του Pipeline</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το pipeline μας αποτελείται από δύο διαφορετικούς workflows:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>διαδικασία CI</strong>: Εκτελείται σε κάθε push και pull request</p> </li> <li> <p><strong>διαδικασία CD</strong>Ενεργοποιείται μόνο κατά τις εκδόσεις GitHub</p> </li> </ol> </div> <div class="imageblock"> <div class="content"> <img src="images/ci-cd-overview.svg" alt="ci cd overview" width="1575" height="5132"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διαμόρφωση_του_pipeline_της_συνεχούς_ενσωμάτωσης_ci">Διαμόρφωση του Pipeline της Συνεχούς Ενσωμάτωσης (CI)</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_δομή_του_workflow_ci">Δομή του Workflow CI</h3> <div class="paragraph"> <p>Ο workflow CI είναι σχεδιασμένος για να επικυρώσει κάθε συνεισφορά στον κώδικα. Η πλήρης διαμόρφωσή του είναι η εξής :</p> </div> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="yaml">name: CI/CD Pipeline on: push: branches: - main pull_request: branches: - main jobs: build: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.x' - name: Install dependencies run: | python -m pip install --upgrade pip pip install -r requirements.txt pip install ruff pytest pytest-mock - name: Run Linting (Ruff) run: ruff check . - name: Run Tests (Pytest) run: pytest</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_ανάλυση_των_βημάτων_ci">Ανάλυση των βημάτων CI</h3> <div class="sect3"> <h4 id="_ενεργοποιητές_on">Ενεργοποιητές (<code>on</code>)</h4> <div class="listingblock"> <div class="content"> <pre class="pygments highlight"><code data-lang="yaml">---- ---- on: push: branches: - main pull_request: branches: - main ---- Ο pipeline ενεργοποιείται σε : - Κάθε push στον κλάδο`main` - Κάθε pull request pros`main` Αυτή η προσέγγιση εγγυάται ότι ο κύριος κώδικας παραμένει σταθερός και ότι κάθε συνεισφορά εγκρίνεται πριν την ενσωμάτωση. ==== 2. Περιβάλλον Εκτέλεσης ---- runs-on: ubuntu-latest Η Ubuntu Latest προσφέρει μια καλή ισορροπία μεταξύ απόδοσης, κόστους και συμβατότητας για τα περισσότερα έργα Python. ==== 3. Έλεγχος κώδικα ```yaml ---- ---- - name: Checkout code uses: actions/checkout@v4 ---- Η δράση`checkout@v4`Ανακτά τον πηγαίο κώδικα του αποθετηρίου. Η έκδοση v4 προσφέρει βελτιώσεις στην απόδοση και την ασφάλεια. ==== 4. Ρύθμιση Python ---- - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.x' Η χρήση του`'3.x'`επιτρέπει την αυτόματη χρήση της τελευταίας σταθερής έκδοσης του Python 3, διευκολύνοντας τη συντήρηση. ==== 5. Εγκατάσταση των εξαρτήσεων ```yaml ---- ---- - name: Install dependencies run: | python -m pip install --upgrade pip pip install -r requirements.txt pip install ruff pytest pytest-mock ---- Αυτό το βήμα: - Ενημέρωση του pip στην τελευταία έκδοση - Εγκατέστησε τις εξαρτήσεις του έργου - Προσθέστε τα εργαλεία ανάπτυξης (linting και δοκιμές) ==== 6. Έλεγχος κώδικα με Ruff ---- - name: Run Linting (Ruff) run: ruff check . **Ruff**είναι ένας υπερ-γρήγορος linter Python γραμμένος σε Rust. Συνδυάζει τις λειτουργίες πολλών εργαλείων (Flake8, Black, isort) σε ένα μόνο ισχυρό εργαλείο. ==== 7. Έκτέλεση των δοκιμών ```yaml ---- ---- - name: Run Tests (Pytest) run: pytest ---- Ο Pytest εκτελεί ολόκληρο το σετ δοκιμών, διασφαλίζοντας ότι οι αλλαγές δεν εισάγουν παλινδρόμους. == �Ρύθμιση του διαδικτύου ανάπτυξης (CD) === Δομή του Workflow CD Ο workflow CD εναρμόζεται μόνο κατά την κυκλοφορία GitHub και αυτοματοποιεί τη δημοσίευση στο PyPI : [source,yaml] ---- name: Publish to PyPI on: release: types: - published jobs: deploy: runs-on: ubuntu-latest steps: - name: Checkout code uses: actions/checkout@v4 - name: Set up Python uses: actions/setup-python@v5 with: python-version: '3.x' - name: Install dependencies run: | python -m pip install --upgrade pip pip install setuptools wheel twine - name: Build and publish env: TWINE_USERNAME: __token__ TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }} run: | python setup.py sdist bdist_wheel twine upload dist/* ---- === Ανάλυση των βημάτων CD ==== Έναρμος Έκδοσης ---- on: release: types: - published Ο αγωγός CD ενεργοποιείται μόνο κατά τη δημοσίευση μιας έκδοσης GitHub. Αυτή η προσέγγιση διασφαλίζει έναν ακριβή έλεγχο των αναπτύξεων. ==== 2. Εγκατάσταση των Εργαλείων Δομής ```yaml ---- ---- pip install setuptools wheel twine ---- - **setuptools**Εργαλεία πακέτων Python - **τροχός**: Σύγχρονη μορφή διανομής Python - **σπίγκο**: Ασφαλές εργαλείο για ανέβασμα στο PyPI ==== 3. Ρύθμιση αυθεντικοποίησης ---- env: TWINE_USERNAME: __token__ TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }} Η έλεγχος ταυτότητας χρησιμοποιεί το token API PyPI που αποθηκεύεται ως secret GitHub, πιο ασφαλές από τα κλασικά διαπιστευτήρια. ==== 4. Κατασκευή και Δημοσίευση ```yaml ---- ---- run: | python setup.py sdist bdist_wheel twine upload dist/* ---- - `sdist`: Δημιούργησε μια διανομή πηγής - `bdist_wheel`: Δημιουργεί ένα wheel (δυαδική διανομή) - `twine upload`: Δημοσίευσε τις διανομές στο PyPI == Διαμόρφωση του πακέτου Python === Δομή του setup.py Για να λειτουργεί το pipeline, το έργο σας πρέπει να περιλαμβάνει ένα αρχείο`setup.py`: [source,python] ---- from setuptools import setup, find_packages with open("README.adoc", "r", encoding="utf-8") as fh: long_description = fh.read() setup( name="playlist-downloader", version="1.0.0", author="Votre Nom", author_email="votre.email@example.com", description="CLI tool for managing YouTube playlists", long_description=long_description, long_description_content_type="text/plain", url="https://github.com/cheroliv/playlist-downloader", packages=find_packages(), classifiers=[ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", ], python_requires=">=3.8", install_requires=[ "typer>=0.9.0", "yt-dlp>=2023.1.6", "google-api-python-client>=2.70.0", "google-auth-oauthlib>=0.7.1", "pymonad>=2.4.0", "pyyaml>=6.0", ], entry_points={ "console_scripts": [ "playlist-downloader=cli:app", ], }, ) ---- === Κλειδιά σημεία του setup.py 1. **Μεταδεδομένα**: Όνομα, έκδοση, συγγραφέας, περιγραφή 2. **εξαρτήσεις**: Λίστα των απαιτούμενων πακέτων 3. **Σημεία Εισόδου**: Εκτεθειμένες εντολές CLI 4. **Ταξινομητές**: Μεταδεδομένα για το PyPI == Ασφάλιση με τα GitHub Secrets === Ρυθμίσεις του Token PyPI 1. **Δημιουργήστε ένα API token στο PyPI**: - Συνδεθείτε στο PyPI - Πηγαίτε στο Account Settings > API tokens - Δημιουργήστε ένα νέο token με τις κατάλληLES δικαιώματα 1. **Προσθέστε το μυστικό στο GitHub**: - Ρυθμίσεις αποθετήριου > Μυστικά και μεταβλητές > Actions - Δημιουργήστε ένα νέο κρυφό που ονομάζεται`PYPI_API_TOKEN` - Επικολλήστε το token σας PyPI [plantuml, secrets-flow, svg] ---- @startuml !theme plain actor Developer as dev participant "GitHub αποθήκη" as repo participant "GitHub Actions" as actions participant PyPI dev -> repo : Configure PYPI_API_TOKEN secret repo -> actions : Trigger CD pipeline on release actions -> actions : Access secret securely actions -> PyPI : Authenticate with token PyPI -> PyPI : Validate and publish package note over actions, PyPI Token never exposed in logs Automatic rotation possible end note @enduml ---- == Ολοκληρό Workflow ανάπτυξης === Ακολουθία Ανάπτυξης [plantuml, deployment-sequence, svg] ---- @startuml !theme plain actor Developer as dev participant "Τοπικό Git" as git participant "GitHub" as github participant "GitHub Actions" as actions participant PyPI participant "Τελικοί χρήστες" as users dev -> git : git tag v1.0.0 dev -> git : git push origin v1.0.0 git -> github : Push tag dev -> github : Create release from tag github -> actions : Trigger CD pipeline actions -> actions : Checkout code actions -> actions : Setup Python environment actions -> actions : Install build tools actions -> actions : Build distributions (sdist + wheel) actions -> PyPI : Upload to PyPI with token PyPI -> PyPI : Validate and publish users -> PyPI : pip install playlist-downloader note over dev, github Release creation can be automated or done manually through GitHub UI end note @enduml ---- === οι καταστάσεις του pipeline [plantuml, pipeline-states, svg] ---- @startuml !theme plain [*] --> Idle Idle --> CI_Running : Push/PR created CI_Running --> CI_Success : All checks pass CI_Running --> CI_Failed : Linting/Tests fail CI_Success --> Idle : Merge completed CI_Failed --> Idle : Fix and retry Idle --> CD_Running : Release published CD_Running --> CD_Success : Package published CD_Running --> CD_Failed : Build/Upload error CD_Success --> Idle : Package available on PyPI CD_Failed --> Idle : Fix and retry release note on link #red : Blocks merge note on link #green : Allows deployment @enduml ---- == Καλές πρακτικές και βελτιστοποιήσεις === </think> Διαχείριση Εκδόσεων Χρησιμοποιείτε σημαντικές ετικέτες Git ---- git tag -a v1.2.3 -m "Release version 1.2.3" git push origin v1.2.3 === 2. Δοκιμές πίνακα Για να δοκιμάσετε σε πολλές εκδόσεις του Python: ```yaml ---- ---- strategy: matrix: python-version: [3.8, 3.9, "3.10", "3.11"] ---- === 3. Cache εξαρτήσεων Επιταχύστε τις κατασκευές με το caché: ---- - name: Cache pip dependencies uses: actions/cache@v3 with: path: ~/.cache/pip key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }} === 4. Περιβάλλοντα ανάπτυξης Χρησιμοποιήστε τα περιβάλλοντα GitHub για ελεγχόμενες ανάπτυξές: ```yaml ---- ---- jobs: deploy: environment: production runs-on: ubuntu-latest ---- == Περίπτωση Χρήσης και Αρχιτεκτονική === Διάγραμμα περιπτώσεων χρήσης [plantuml, use-cases, svg] ---- @startuml !theme plain left to right direction actor "Προγραμματιστής" as dev actor "GitHub Actions" as ga actor "Τελικός χρήστης" as user package "Σύστημα CI/CD" { usecase "Τρέξτε linting" as lint usecase "Εκτέλεση δοκιμών" as test usecase "Δημιουργία πακέτου" as build usecase "Δημοσίευση στο PyPI" as publish usecase "Δημιουργία έκδοσης" as release } dev --> lint : Pushes code dev --> test : Pushes code dev --> release : Creates release ga --> build : On release trigger ga --> publish : After successful build user --> publish : Downloads package lint .> test : triggers test .> build : on success build .> publish : on success @enduml ---- === Αρχιτεκτονική ανάπτυξης [plantuml, deployment-architecture, svg] ---- @startuml !theme plain cloud "GitHub" { [Source Repository] [GitHub Actions] [Secrets Store] } cloud "PyPI" { [Package Registry] [Distribution Files] } node "CI/CD αλυσίδα" { [Linting] [Testing] [Building] [Publishing] } [Source Repository] --> [GitHub Actions] : Triggers [GitHub Actions] --> [Linting] [Linting] --> [Testing] [Testing] --> [Building] [Building] --> [Publishing] [Publishing] --> [Package Registry] : Uploads [Secrets Store] --> [Publishing] : Provides token note as N1 Secure token-based authentication end note [Secrets Store] .. N1 @enduml ---- == Παρακολούθηση και Debugging === Καταγραφές και Παρακολούθηση GitHub Actions παρέχει λεπτομερείς καταγραφές για κάθε βήμα. Για debugging: 1. **Εξετάστε τα logs**κάθε βήμα 2. **Ενεργοποιήστε το debug**με`ACTIONS_STEP_DEBUG` 3. **Χρησιμοποιήστε τα artifacts**για να αποθηκεύσετε τα αρχεία κατασκευής ---- - name: Upload build artifacts uses: actions/upload-artifact@v3 if: failure() with: name: build-logs path: build/ === Ειδοποιήσεις Προσθέστε ειδοποιήσεις Slack ή email : ```yaml ---- ---- - name: Notify on failure if: failure() uses: 8398a7/action-slack@v3 with: status: ${{ job.status }} webhook_url: ${{ secrets.SLACK_WEBHOOK }} ---- == Συμπέρασμα Η ρύθμιση ενός αξιόπιστου pipeline CI/CD με GitHub Actions μεταμορφώνει ριζικά την εμπειρία ανάπτυξης. Με την αυτοματοποίηση του linting, των τεστ και του ανάπτυξης, εσείς : - **Μειώστε τα σφάλματα**σε παραγωγή - **Επιταχύνετε τους κύκλους**ανάπτυξης - **Βελτιώστε την εμπιστοσύνη**σε τις εκδόσεις σας - **Ευκολείτε τη συνεργασία**σε ομάδα Αυτό το pipeline μπορεί να προσαρμοστεί σε διάφορους τύπους Python projects προσαρμόζοντας τα εργαλεία linting, τα frameworks testing ή τους προορισμούς ανάπτυξης. Η αρχική επένδυση στη ρύθμιση αυτών των ροών εργασίας αποδωθεί γρήγορα από την εξοικονόμηση χρόνου και τη μείωση των χειροκίνητων σφαλμάτων κατά τα αναπτύξεις. == Πρόσθετοι Πόροι - https://docs.github.com/en/actions[Τεκμηρίωση GitHub Actions] - https://packaging.python.org/[Οδηγός συσκευασίας Python] - https://docs.pytest.org/[Τεκμηρίωση Pytest] - https://docs.astral.sh/ruff/[Τεκμηρίωση Ruff] - https://twine.readthedocs.io/[Τεκμηρίωση Twine] Η λειτουργική pipeline έχει επιτευχθεί! Τώρα έχετε ένα απλό pipeline CI/CD που σας επιτρέπει να αυτοματοποιείτε τα τεστ σας και να δημοσιεύετε το πακέτο Python σας στο PyPI άμεσα από τις GitHub Actions. Ωστόσο, αυτό το pipeline παραμένει εθελοντικά ελαφρύ. Ακόμη δεν καλύπτει ορισμένα βασικά στοιχεία σε επαγγελματικό περιβάλλον : Δοκιμές πολλαπλών εκδόσεων του Python, Αυτοματοποιημένη ανάλυση ασφαλείας, Προοδευτική ανάπτυξη μέσω Test PyPI, Παρακολούθηση και μετρικά του pipeline, Αυτοματοποίηση της διαχείρισης εκδόσεων και ενσωμάτωση των σύγχρονων καλών πρακτικών (pyproject.toml). Στην επόμενη ενότητα, θα προχωρήσουμε στο επόμενο βήμα. Θα μάθετε πώς να μετατρέψετε αυτή τη βασική γραμμή διεργασιών σε μια πραγματική, βιομηχανική, ισχυρή και ασφαλής αλυσίδα ανάπτυξης, έτοιμη για έργα Python παραγωγής. ----</code></pre> </div> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0084_disco_bot_discord_python_post.html Wed, 16 Jul 2025 00:00:00 +0000 blog/2025/0084_disco_bot_discord_python_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_περιβάλλον_και_παρούσες_προκλήσεις">Περιβάλλον και παρούσες προκλήσεις</a> <ul class="sectlevel2"> <li><a href="#_εξέλιξη_των_μουσικών_api">Εξέλιξη των μουσικών API</a></li> <li><a href="#_πρόσληψη_ανάπτυξης_που_βασίζεται_στα_αρχεία_καταγραφής">Πρόσληψη ανάπτυξης που βασίζεται στα αρχεία καταγραφής</a></li> </ul> </li> <li><a href="#_εννοιολογική_αρχιτεκτονική">Εννοιολογική αρχιτεκτονική</a></li> <li><a href="#_τεχνική_στοίβα_και_λειτουργικό_παράδειγμα">Τεχνική στοίβα και λειτουργικό παράδειγμα</a> <ul class="sectlevel2"> <li><a href="#_τεχνολογικές_επιλογές">Τεχνολογικές επιλογές</a></li> <li><a href="#_εφαρμοσμένες_λειτουργικές_αρχές">Εφαρμοσμένες Λειτουργικές Αρχές</a></li> </ul> </li> <li><a href="#_agile_μεθοδολογία_και_backlog">Agile μεθοδολογία και Backlog</a> <ul class="sectlevel2"> <li><a href="#_επικές_κύριες">Επικές Κύριες</a> <ul class="sectlevel3"> <li><a href="#_επικό_1_discord_bot_υποδομής">Επικό 1 : Discord Bot Υποδομής</a></li> <li><a href="#_epic_2_ενσωμάτωση_spotify">Epic 2: ενσωμάτωση Spotify</a></li> <li><a href="#_έπικο_3_ενσωμάτωση_youtube">Έπικο 3 : Ενσωμάτωση YouTube</a></li> <li><a href="#_epic_4_μουσικές_λειτουργίες">Epic 4 : Μουσικές Λειτουργίες</a></li> </ul> </li> <li><a href="#_λεπτομερείς_user_stories">Λεπτομερείς User Stories</a> <ul class="sectlevel3"> <li><a href="#_us1_1_αρχικοποίηση_του_bot">US1.1 : Αρχικοποίηση του Bot</a></li> <li><a href="#_us2_1_εξυπνή_αναζήτηση_spotify">US2.1 : Εξυπνή αναζήτηση Spotify</a></li> <li><a href="#_us3_1_ανθεκτική_εξαγωγή_youtube">US3.1 : Ανθεκτική εξαγωγή YouTube</a></li> </ul> </li> </ul> </li> <li><a href="#_προσέγγιση_log_driven_development">Προσέγγιση Log Driven Development</a> <ul class="sectlevel2"> <li><a href="#_στρατηγική_καταγραφής">Στρατηγική καταγραφής</a></li> <li><a href="#_δομή_των_logs">Δομή των Logs</a></li> <li><a href="#_παράδειγμα_του_log_design">Παράδειγμα του Log Design</a></li> </ul> </li> <li><a href="#_αρχιτεκτονική_επικύρωσης_με_pydantic">Αρχιτεκτονική Επικύρωσης με Pydantic</a> <ul class="sectlevel2"> <li><a href="#_μοντέλα_δεδομένων">Μοντέλα δεδομένων</a></li> </ul> </li> <li><a href="#_διαχείριση_λειτουργικών_σφαλμάτων">Διαχείριση Λειτουργικών Σφαλμάτων</a> <ul class="sectlevel2"> <li><a href="#_μονάδες_και_διαχείριση_σφαλμάτων">Μονάδες και Διαχείριση Σφαλμάτων</a></li> </ul> </li> <li><a href="#_στρατηγική_αποφυγής_των_περιορισμών">Στρατηγική Αποφυγής των Περιορισμών</a> <ul class="sectlevel2"> <li><a href="#_προσέγγιση_πολλαπλής_πηγής">Προσέγγιση Πολλαπλής Πηγής</a></li> </ul> </li> <li><a href="#_σχέδιο_επαναληπτικής_ανάπτυξης">Σχέδιο επαναληπτικής ανάπτυξης</a> <ul class="sectlevel2"> <li><a href="#_σχεδιασμός_σπρίντ">Σχεδιασμός Σπρίντ</a></li> <li><a href="#_μετρικές_ποιότητας">Μετρικές ποιότητας</a></li> </ul> </li> <li><a href="#_ανάπτυξη_και_παρακολούθηση">Ανάπτυξη και Παρακολούθηση</a> <ul class="sectlevel2"> <li><a href="#_αρχιτεκτονική_παραγωγής">αρχιτεκτονική παραγωγής</a></li> <li><a href="#_προοδευτική_παρακολούθηση">Προοδευτική Παρακολούθηση</a></li> </ul> </li> <li><a href="#_συμπέρασμα_και_προοπτικές">Συμπέρασμα και Προοπτικές</a> <ul class="sectlevel2"> <li><a href="#_επόμενα_βήματα">Επόμενα Βήματα</a></li> </ul> </li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή"><a class="anchor" href="#_εισαγωγή"></a>Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η ανάπτυξη ενός bot Discord που ενσωματώνει τις API του Spotify και του YouTube αποτελεί μια σύγχρονη τεχνική πρόκληση, ειδικά λόγω των πρόσφατων περιορισμών και εξελίξεων των πλαatformών. Αυτό το άρθρο παρουσιάζει μια μεθοδολογική προσέγγιση βασισμένη στο<strong>Ανάπτυξη καθοδηγούμενη από τα Log</strong>(LDD), mia epektasia tou Test Driven Development, efarmosmene se ena protypo leitourgiko me Python</p> </div> <div class="paragraph"> <p>Ο στόχος μας: να δημιουργήσουμε ένα ισχυρό, συντηρήσιμο και κλιμακώσιμο bot, ικανό να περνάει από τους τρέχοντα περιορισμούς των μουσικών API, παρέχοντας παράλληλα μια ομαλή εμπειρία χρήστη στο Discord.</p> </div> </div> </div> <div class="sect1"> <h2 id="_περιβάλλον_και_παρούσες_προκλήσεις"><a class="anchor" href="#_περιβάλλον_και_παρούσες_προκλήσεις"></a>Περιβάλλον και παρούσες προκλήσεις</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_εξέλιξη_των_μουσικών_api"><a class="anchor" href="#_εξέλιξη_των_μουσικών_api"></a>Εξέλιξη των μουσικών API</h3> <div class="paragraph"> <p>Οι μουσικές πλατφόρμες έχουν αυστηροποιήσει σημαντικά τις πολιτικές πρόσβασης :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Spotify</strong>Περιορισμοί στην πρόσβαση στα μεταδεδομένα, περιορισμός των quotas</p> </li> <li> <p><strong>YouTube</strong>: ενισχυμένη πολιτική αντί-bot, διαπλοκόπληξη της ταυτοποίησης</p> </li> <li> <p><strong>Discord</strong>: Νέες απαιτήσεις ασφάλειας και απόδοσης</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_πρόσληψη_ανάπτυξης_που_βασίζεται_στα_αρχεία_καταγραφής"><a class="anchor" href="#_πρόσληψη_ανάπτυξης_που_βασίζεται_στα_αρχεία_καταγραφής"></a>Πρόσληψη ανάπτυξης που βασίζεται στα αρχεία καταγραφής</h3> <div class="paragraph"> <p>Ο LDD επεκτείνει τον TDD topoθεών τα logs στη καρδιά της ανάπτυξης:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Ορισμός των logs</strong>πριν από την υλοποίηση</p> </li> <li> <p><strong>Επαλήθευση μέσω παρατήρησης</strong>αναμενόμενες συμπεριφορές</p> </li> <li> <p><strong>Πλήρης παρακολούθησις</strong>ροές δεδομένων</p> </li> <li> <p><strong>προληπτικό debugging</strong>με πρόληψη των σφαλμάτων</p> </li> </ol> </div> </div> </div> </div> <div class="sect1"> <h2 id="_εννοιολογική_αρχιτεκτονική"><a class="anchor" href="#_εννοιολογική_αρχιτεκτονική"></a>Εννοιολογική αρχιτεκτονική</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-2bc5877355c9ef83bced0677a210f984.png" alt="Diagram" width="777" height="618"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_τεχνική_στοίβα_και_λειτουργικό_παράδειγμα"><a class="anchor" href="#_τεχνική_στοίβα_και_λειτουργικό_παράδειγμα"></a>Τεχνική στοίβα και λειτουργικό παράδειγμα</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_τεχνολογικές_επιλογές"><a class="anchor" href="#_τεχνολογικές_επιλογές"></a>Τεχνολογικές επιλογές</h3> <div class="paragraph"> <p>Η στίβα μας είναι διαμορφωμένη γύρω από τον λειτουργικό προγραμματισμός :</p> </div> <div class="dlist"> <dl> <dt class="hdlist1"><strong>Πυμοναδα</strong></dt> <dd> <p>Διαχείριση των παρενεργειών και σύνθεση συναρτήσεων</p> </dd> <dt class="hdlist1"><strong>Pydantic</strong></dt> <dd> <p>Επικύρωση δεδομένων type-safe και σειραλizacioν</p> </dd> <dt class="hdlist1"><strong>Asyncio</strong></dt> <dd> <p>Ασυγχρονη προγραμματισμος για APIs</p> </dd> <dt class="hdlist1"><strong>Structlog</strong></dt> <dd> <p>Δομημένο καταγραφή για το LDD</p> </dd> </dl> </div> </div> <div class="sect2"> <h3 id="_εφαρμοσμένες_λειτουργικές_αρχές"><a class="anchor" href="#_εφαρμοσμένες_λειτουργικές_αρχές"></a>Εφαρμοσμένες Λειτουργικές Αρχές</h3> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-165c60e93fb1a74b9c945d24543770be.png" alt="Diagram" width="743" height="554"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_agile_μεθοδολογία_και_backlog"><a class="anchor" href="#_agile_μεθοδολογία_και_backlog"></a>Agile μεθοδολογία και Backlog</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_επικές_κύριες"><a class="anchor" href="#_επικές_κύριες"></a>Επικές Κύριες</h3> <div class="paragraph"> <p>Η ανάπτυξή μας οργανώνεται γύρω από 4 κύρια επικά:</p> </div> <div class="sect3"> <h4 id="_επικό_1_discord_bot_υποδομής"><a class="anchor" href="#_επικό_1_discord_bot_υποδομής"></a>Επικό 1 : Discord Bot Υποδομής</h4> <div class="paragraph"> <p><strong>Επαγγελματική αξία</strong> : Βάση στερεά και επεκτασιμή</p> </div> <div class="paragraph"> <p>Κριτήρια αποδοχής - Σταθερή σύνδεση Discord με διαχείριση επανασύνδεσης - Μοναδικό σύστημα εντολών - Καταγραφή δομημένη ενσωματωμένη Κεντρική διαχείριση σφαλμάτων</p> </div> </div> <div class="sect3"> <h4 id="_epic_2_ενσωμάτωση_spotify"><a class="anchor" href="#_epic_2_ενσωμάτωση_spotify"></a>Epic 2: ενσωμάτωση Spotify</h4> <div class="paragraph"> <p><strong>Επιχειρηματική αξία</strong> : Πρόσβαση στα μουσικά μεταδεδομένα</p> </div> <div class="paragraph"> <p><strong>Κριτήρια αποδοχής</strong> : - Ασφαλής OAuth2 πιστοποίηση - Αναζήτηση tracks με εξυπνή cache - Διαχείριση των κότων API - Εναλλακτική λύση σε σφάλματα δικτύου</p> </div> </div> <div class="sect3"> <h4 id="_έπικο_3_ενσωμάτωση_youtube"><a class="anchor" href="#_έπικο_3_ενσωμάτωση_youtube"></a>Έπικο 3 : Ενσωμάτωση YouTube</h4> <div class="paragraph"> <p><strong>Επιχειρησιακή αξία</strong> : Πρόσβαση στο ηχοακουστικό περιεχόμενο</p> </div> <div class="paragraph"> <p><strong>Κριτήρια αποδοχής</strong> : Νόμιμη περίβολη των περιορισμών Βελτιωμένη εξαγωγή ήχου - Διαχείριση ιδιωτικών/διαγραμμένων βίντεο - Συμμόρφωση με τους Όρους Χρήσης του YouTube</p> </div> </div> <div class="sect3"> <h4 id="_epic_4_μουσικές_λειτουργίες"><a class="anchor" href="#_epic_4_μουσικές_λειτουργίες"></a>Epic 4 : Μουσικές Λειτουργίες</h4> <div class="paragraph"> <p><strong>Επιχειρηματική αξία</strong> : Πλήρης εμπειρία χρήστη</p> </div> <div class="paragraph"> <p><strong>Κριτήρια αποδοχής</strong> : - Αναπαραγωγή ηχείου υψηλής ποιότητας - Έξυπνη ουρά ανάγνωσης - φωνητικές εντολές Discord - Συγχρονισμός δια πλατφορμών</p> </div> </div> </div> <div class="sect2"> <h3 id="_λεπτομερείς_user_stories"><a class="anchor" href="#_λεπτομερείς_user_stories"></a>Λεπτομερείς User Stories</h3> <div class="sect3"> <h4 id="_us1_1_αρχικοποίηση_του_bot"><a class="anchor" href="#_us1_1_αρχικοποίηση_του_bot"></a>US1.1 : Αρχικοποίηση του Bot</h4> <div class="paragraph"> <p><strong>Ως προγραμματιστής</strong> <strong>Θέλω</strong> έναν Discord bot που συνδέεται αξιοπιστά <strong>Για να</strong> εξασφαλίσει τη διαθεσιμότητα της υπηρεσίας</p> </div> <div class="paragraph"> <p><strong>DoD (Ορισμός Ολοκλήρωσης)</strong> : - [ ] Το bot συνδέεται αυτόματα κατά την εκκίνηση - [ ] Τα δομημένα logs τεκμηριώνουν κάθε βήμα - [ ] Αυτόματη επανασύνδεση σε περίπτωση αποσύνδεσης - [ ] Τα τεστά ενσωμάτωσης περνούν</p> </div> </div> <div class="sect3"> <h4 id="_us2_1_εξυπνή_αναζήτηση_spotify"><a class="anchor" href="#_us2_1_εξυπνή_αναζήτηση_spotify"></a>US2.1 : Εξυπνή αναζήτηση Spotify</h4> <div class="paragraph"> <p>Ως χρήστης Discord <strong>Θέλω</strong> να αναζητήσω κομμάτια μέσω Spotify <strong>Για να</strong> ανακαλύψουμε και να μοιραζόμαστε τη μουσική</p> </div> <div class="paragraph"> <p><strong>DoD</strong> : - [ ] Παραγγελία`/search`λειτουργική - [ ] Σχετικά αποτελέσματα με μεταδεδομένα - [ ] Τοπικό cache για τη βελτιστοποίηση των ερωτημάτων - [ ] Ευγενής διαχείριση σφαλμάτων API</p> </div> </div> <div class="sect3"> <h4 id="_us3_1_ανθεκτική_εξαγωγή_youtube"><a class="anchor" href="#_us3_1_ανθεκτική_εξαγωγή_youtube"></a>US3.1 : Ανθεκτική εξαγωγή YouTube</h4> <div class="paragraph"> <p><strong>ως</strong> σύστημα <strong>Θέλω</strong> να εξαγώ το ήχο του YouTube με αξιόπιστο τρόπο Afin de` να διατηρήσει τη συνέχεια της υπηρεσίας</p> </div> <div class="paragraph"> <p><strong>DoD</strong> : - [ ] Εξαγωγή χωρίς παραβίαση των ToS - [ ] Βέλτιστη ποιότητα ήχου - [ ] Διαχείριση των γεωγραφικών περιορισμών - [ ] Λεπτομερείς καταγραφές λειτουργιών</p> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_προσέγγιση_log_driven_development"><a class="anchor" href="#_προσέγγιση_log_driven_development"></a>Προσέγγιση Log Driven Development</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_στρατηγική_καταγραφής"><a class="anchor" href="#_στρατηγική_καταγραφής"></a>Στρατηγική καταγραφής</h3> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-013bab93e68e4a1aa87fe6123b5fe2da.png" alt="Diagram" width="687" height="633"> </div> </div> </div> <div class="sect2"> <h3 id="_δομή_των_logs"><a class="anchor" href="#_δομή_των_logs"></a>Δομή των Logs</h3> <div class="paragraph"> <p>Η προσέγγιδη μας LDD χρησιμοποιεί δομημένες καταγραφές με σεμαντικά επίπεδα :</p> </div> <div class="dlist"> <dl> <dt class="hdlist1"><strong>ΙΧΝΟΣ</strong></dt> <dd> <p>Λεπτομερής ροή δεδομένων</p> </dd> <dt class="hdlist1"><strong>DEBUG</strong></dt> <dd> <p>Εσωτερικές καταστάσεις των λειτουργιών</p> </dd> <dt class="hdlist1"><strong>INFO</strong></dt> <dd> <p>Επιτυχημένες επιχειρηματικές λειτουργίες</p> </dd> <dt class="hdlist1"><strong>Προειδοποίηση</strong></dt> <dd> <p>Κατεστραμμένες καταστάσεις αλλά διαχειριζόμενες</p> </dd> <dt class="hdlist1"><strong>σφάλμα</strong></dt> <dd> <p>Σφάλματα που απαιτούν παρέμβαση</p> </dd> <dt class="hdlist1"><strong>CRITICAL</strong></dt> <dd> <p>Σφάλματα συστήματος</p> </dd> </dl> </div> </div> <div class="sect2"> <h3 id="_παράδειγμα_του_log_design"><a class="anchor" href="#_παράδειγμα_του_log_design"></a>Παράδειγμα του Log Design</h3> <div class="paragraph"> <p>Πριν να υλοποιήσουμε τη λειτουργία αναζήτησης του Spotify, ορίζουμε τα logs του :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">INFO: spotify.search.start query="bohemian rhapsody" user_id=123456 DEBUG: spotify.search.validation query_length=16 safe_chars=true DEBUG: spotify.search.api_call endpoint="/search" params={...} INFO: spotify.search.success results_count=15 duration_ms=340</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αρχιτεκτονική_επικύρωσης_με_pydantic"><a class="anchor" href="#_αρχιτεκτονική_επικύρωσης_με_pydantic"></a>Αρχιτεκτονική Επικύρωσης με Pydantic</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_μοντέλα_δεδομένων"><a class="anchor" href="#_μοντέλα_δεδομένων"></a>Μοντέλα δεδομένων</h3> <div class="paragraph"> <p>Η λειτουργική προσέγγισή μας προτιμά τον προληπτικό έλεγχο :</p> </div> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-ebd4e1dfbd7b19d5a6054ecf213e9e2d.png" alt="Diagram" width="696" height="339"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διαχείριση_λειτουργικών_σφαλμάτων"><a class="anchor" href="#_διαχείριση_λειτουργικών_σφαλμάτων"></a>Διαχείριση Λειτουργικών Σφαλμάτων</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_μονάδες_και_διαχείριση_σφαλμάτων"><a class="anchor" href="#_μονάδες_και_διαχείριση_σφαλμάτων"></a>Μονάδες και Διαχείριση Σφαλμάτων</h3> <div class="paragraph"> <p>Η χρήση του PyMonade επιτρέπει μια ελεγamment διαχείριση των σφαλμάτων :</p> </div> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-63a0bf8552c82f52dcbc2f1c5ccc4639.png" alt="Diagram" width="508" height="494"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_στρατηγική_αποφυγής_των_περιορισμών"><a class="anchor" href="#_στρατηγική_αποφυγής_των_περιορισμών"></a>Στρατηγική Αποφυγής των Περιορισμών</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_προσέγγιση_πολλαπλής_πηγής"><a class="anchor" href="#_προσέγγιση_πολλαπλής_πηγής"></a>Προσέγγιση Πολλαπλής Πηγής</h3> <div class="paragraph"> <p>Μετωπίζοντας τους περιορισμούς των API, υιοθετούμε μια στρατηγική διάκλισης:</p> </div> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-32efed8c1011ec2c4e95ec4498e55f39.png" alt="Diagram" width="665" height="744"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_σχέδιο_επαναληπτικής_ανάπτυξης"><a class="anchor" href="#_σχέδιο_επαναληπτικής_ανάπτυξης"></a>Σχέδιο επαναληπτικής ανάπτυξης</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_σχεδιασμός_σπρίντ"><a class="anchor" href="#_σχεδιασμός_σπρίντ"></a>Σχεδιασμός Σπρίντ</h3> <div class="paragraph"> <p>Η ανάπτυξή μας ακολουθεί ένα κύκλο σπρίντων 2 εβδομάδων:</p> </div> <div class="dlist"> <dl> <dt class="hdlist1"><strong>Σπρίντ 1-2</strong></dt> <dd> <p>Υποδομή και Discord Bot Core</p> </dd> <dt class="hdlist1"><strong>Sprint 3-4</strong></dt> <dd> <p>Ενσωμάτωση Spotify με LDD</p> </dd> <dt class="hdlist1"><strong>Σπρίντ 5-6</strong></dt> <dd> <p>Ενσωμάτωση YouTube και πρόσθετες λύσεις</p> </dd> <dt class="hdlist1"><strong>Σπρίντ 7-8</strong></dt> <dd> <p>προχωρημένα μουσικά χαρακτηριστικά</p> </dd> <dt class="hdlist1"><strong>Σπρίντ 9-10</strong></dt> <dd> <p>Βελτιστοποίηση και παραγωγή</p> </dd> </dl> </div> </div> <div class="sect2"> <h3 id="_μετρικές_ποιότητας"><a class="anchor" href="#_μετρικές_ποιότητας"></a>Μετρικές ποιότητας</h3> <div class="paragraph"> <p>Κάθε σπρίν αξιολογείται με βάση:</p> </div> <div class="ulist"> <ul> <li> <p><strong>Κάλυμμα καταγραφών</strong>>90% των Kri(t)ikon Diadromon</p> </li> <li> <p><strong>Αξιοπιστία API</strong> : <1% d’erreurs non gérées</p> </li> <li> <p><strong>απόδοση</strong>: <500ms μέσος χρόνος απάντηση</p> </li> <li> <p><strong>διατηρησιμότητα</strong>: Κυκλική πολυπλοκότητα <10</p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ανάπτυξη_και_παρακολούθηση"><a class="anchor" href="#_ανάπτυξη_και_παρακολούθηση"></a>Ανάπτυξη και Παρακολούθηση</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_αρχιτεκτονική_παραγωγής"><a class="anchor" href="#_αρχιτεκτονική_παραγωγής"></a>αρχιτεκτονική παραγωγής</h3> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-c3789439e3ea700c6c430f14804d47e9.png" alt="Diagram" width="938" height="381"> </div> </div> </div> <div class="sect2"> <h3 id="_προοδευτική_παρακολούθηση"><a class="anchor" href="#_προοδευτική_παρακολούθηση"></a>Προοδευτική Παρακολούθηση</h3> <div class="paragraph"> <p>Ο LDD διευκολύνει έξυπνη παρακολούθηση :</p> </div> <div class="ulist"> <ul> <li> <p><strong>Ειδοποιήσεις βασισμένες στα patterns των logs</strong></p> </li> <li> <p><strong>Ανίχνευση συμπεριφορικών ανωμαλιών</strong></p> </li> <li> <p><strong>Μετρικές επιχείρησης σε πραγματικό χρόνο</strong></p> </li> <li> <p><strong>Αντιμετώπιση σφαλμάτων με τη βοήθεια της συσχέτισης καταγραφών</strong></p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα_και_προοπτικές"><a class="anchor" href="#_συμπέρασμα_και_προοπτικές"></a>Συμπέρασμα και Προοπτικές</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτή η μεθοδολογική προσέγγιση συνδυάζει τα πλεονεκτήματα του λειτουργικού παρεμβατικού με τη σταθερότητα του Log Driven Development. Μας επιτρέπει να:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Να προβλέπεις τα προβλήματα</strong>χάρη στους logs που σχεδιάστηκαν προκαταβολικά</p> </li> <li> <p><strong>Συμαντόντας την ποιότητα</strong>μέσω της συνεχούς επικύρωση</p> </li> <li> <p><strong>Προσαρμόστε γρήγορα</strong>στις αλλαγές των APIs</p> </li> <li> <p><strong>Εσφαλίστε την ιχνευτικότητα</strong>πλήρης των λειτουργιών</p> </li> </ol> </div> <div class="paragraph"> <p>Η επαναλαμβανόμενη ανάπτυξη και η αρχιτεκτονική βασισμένη σε μονάδες εξασφαλίζουν την κλιμακωσιμότητα έναντι των μεταβαλλόντων περιορισμών των μουσικών πλατφορμών.</p> </div> <div class="sect2"> <h3 id="_επόμενα_βήματα"><a class="anchor" href="#_επόμενα_βήματα"></a>Επόμενα Βήματα</h3> <div class="ulist"> <ul> <li> <p><strong>Φάση 1</strong>Υλοποίηση του πυρήνα με PyMonade</p> </li> <li> <p><strong>Φάση 2</strong>: Ενσωμάτωση Spotify με έξυπνο cache</p> </li> <li> <p><strong>Φάση 3</strong>Λύση YouTube ανθεκτική</p> </li> <li> <p><strong>Φάση 4</strong>: Προχωρά χαρακτηριστικά και βελτιστοποίηση</p> </li> </ul> </div> <div class="paragraph"> <p>Αυτή η στερεά εννοιολογική θεμελίωση θα μας επιτρέψει να πλοηγηθούμε τις τεχνικές προκλήσεις παρέχοντας μια εξαιρετική εμπειρία χρήστη.</p> </div> <hr> <div class="paragraph"> <p><strong>Αυτό το άρθρο θα ακολουθηθεί από μια τεχνική σειρά που περιγράφει αναλυτικά την υλοποίηση κάθε συστατικού, με παραδείγματα κώδικα και λειτουργικά μοτίβα.</strong></p> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0083_cold_computer_post.html Tue, 15 Jul 2025 00:00:00 +0000 blog/2025/0083_cold_computer_post.html <div id="toc" class="toc"> <div id="toctitle">Table of Contents</div> <ul class="sectlevel1"> <li><a href="#_σκοπός_αυτού_του_οδηγού">Σκοπός αυτού του οδηγού</a></li> <li><a href="#_προϋποθέσεις">προϋποθέσεις</a></li> <li><a href="#_εγκατάσταση_και_ρύθμιση_των_εργαλείων">Εγκατάσταση και ρύθμιση των εργαλείων</a> <ul class="sectlevel2"> <li><a href="#_lm_sensors_για_να_ανιχνεύσει_τους_αισθητήρες">lm-sensors` για να ανιχνεύσει τους αισθητήρες</a></li> <li><a href="#_tlp_έξυπνος_διαχειριστής_ενέργειας">tlp` : έξυπνος διαχειριστής ενέργειας</a></li> <li><a href="#_cpufrequtils_περιορίζει_τις_συχνότητες_cpu">cpufrequtils` : περιορίζει τις συχνότητες CPU</a></li> <li><a href="#_auto_cpufreq_απλοποιημένη_δυναμική_διαχείριση">auto-cpufreq` : απλοποιημένη δυναμική διαχείριση</a></li> <li><a href="#_thermald_αυτόματη_θερμική_προστασία">thermald` : αυτόματη θερμική προστασία</a></li> </ul> </li> <li><a href="#_παρακολούθηση_σε_πραγματικό_χρόνο">Παρακολούθηση σε πραγματικό χρόνο</a> <ul class="sectlevel2"> <li><a href="#_sensors_σε_τη_γραμμή_εντολών">sensors` σε τη γραμμή εντολών</a></li> <li><a href="#_επιλογή_gui_psensor">Επιλογή GUI : `psensor</a></li> </ul> </li> <li><a href="#_πρόσθετες_συμβουλές">Πρόσθετες συμβουλές</a></li> <li><a href="#_καθαρίστε_το_σύστημα_για_να_περιορίσετε_τις_υπερφορτώσεις">Καθαρίστε το σύστημα για να περιορίσετε τις υπερφορτώσεις</a></li> <li><a href="#_για_να_πάτε_περαιτέρω">Για να πάτε περαιτέρω</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>Αισθανθείτε ότι το laptop σας ζεσταίνεται ακανόνιστως στο Ubuntu; Αυτό το άρθρο σας προτείνει μια διαδικασία<strong>λογισμικό</strong>ολοκληρωμένη για<strong>ψύχω</strong>, <strong>παρακολουθώ</strong> et <strong>να ελέγξετε τη θερμοκρασία</strong>του υπολογιστή σας.</p> </div> </div> </div> <div class="sect1"> <h2 id="_σκοπός_αυτού_του_οδηγού">Σκοπός αυτού του οδηγού</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Μειώστε την συνολική θερμοκρασία του υπολογιστή</p> </li> <li> <p>Βελτιστοποίηση της διαχείρισης ενέργειας</p> </li> <li> <p>Παρακολουθήστε τα critica συστατικά (CPU, GPU, κ.λπ.)</p> </li> <li> <p>Να αποφεύγετε τις καθυστερήσεις λόγω του<strong>θερμικό περιορισμός</strong></p> </li> </ul> </div> <div class="imageblock"> <div class="content"> <img src="gestion_thermique.svg" alt="gestion thermique" width="392" height="298"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_προϋποθέσεις">προϋποθέσεις</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Μια μηχανή Ubuntu (20.04 ή νεότερη προτεινόμενη)</p> </li> <li> <p>Σύνδεση Διαδικτύου</p> </li> <li> <p>Δεξιότητα εντολών γραμμής εντολών (επίπεδο αρχάριος έως μέτριος)</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_εγκατάσταση_και_ρύθμιση_των_εργαλείων">Εγκατάσταση και ρύθμιση των εργαλείων</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_lm_sensors_για_να_ανιχνεύσει_τους_αισθητήρες">lm-sensors` για να ανιχνεύσει τους αισθητήρες</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install lm-sensors sudo sensors-detect sensors</code></pre> </div> </div> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p>Απαντήστε`YES`σε όλες τις ερωτήσεις του`sensors-detect`για να ανιχνεύσει τα modules.</p> </div> </td> </tr> </table> </div> </div> <div class="sect2"> <h3 id="_tlp_έξυπνος_διαχειριστής_ενέργειας">tlp` : έξυπνος διαχειριστής ενέργειας</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install tlp tlp-rdw sudo systemctl enable tlp sudo systemctl start tlp</code></pre> </div> </div> <div class="imageblock"> <div class="content"> <img src="tlp_etat.svg" alt="tlp etat" width="396" height="390"> </div> </div> </div> <div class="sect2"> <h3 id="_cpufrequtils_περιορίζει_τις_συχνότητες_cpu">cpufrequtils` : περιορίζει τις συχνότητες CPU</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install cpufrequtils cpufreq-info sudo cpufreq-set -g powersave</code></pre> </div> </div> <div class="ulist"> <ul> <li> <p><code>powersave</code>: περιορίζει τα πικ της συχνότητας</p> </li> <li> <p>`performance`προτιμάει την ισχύ σε βάρος της θερμοκρασίας</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_auto_cpufreq_απλοποιημένη_δυναμική_διαχείριση">auto-cpufreq` : απλοποιημένη δυναμική διαχείριση</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">git clone https://github.com/AdnanHodzic/auto-cpufreq.git cd auto-cpufreq sudo ./auto-cpufreq-installer sudo auto-cpufreq --install</code></pre> </div> </div> <div class="imageblock"> <div class="content"> <img src="auto_cpufreq_cycle.svg" alt="auto cpufreq cycle" width="189" height="298"> </div> </div> </div> <div class="sect2"> <h3 id="_thermald_αυτόματη_θερμική_προστασία">thermald` : αυτόματη θερμική προστασία</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install thermald sudo systemctl enable thermald sudo systemctl start thermald</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_παρακολούθηση_σε_πραγματικό_χρόνο">Παρακολούθηση σε πραγματικό χρόνο</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_sensors_σε_τη_γραμμή_εντολών">sensors` σε τη γραμμή εντολών</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">watch -n 2 sensors</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_επιλογή_gui_psensor">Επιλογή GUI : `psensor</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install psensor</code></pre> </div> </div> <div class="paragraph"> <p>Απλή γραφική διεπαφή για CPU, GPU, ανεμιστήρες.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πρόσθετες_συμβουλές">Πρόσθετες συμβουλές</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Κλείστε τις καρτέλες και τις βαρύφορες εφαρμογές (π.χ. προγράμματα περιήγησης)</p> </li> <li> <p>Αποφύγετε τις έντονες χρήσεις σε μπαταρία</p> </li> <li> <p>Παραkolouste ta dierekasies mezzo? Wait spelling error. Let’s correct: Παρακολουθήστε τα διεργασίες μέσω</p> </li> </ul> </div> <div class="paragraph"> <p>Yes.</p> </div> <div class="paragraph"> <p></think></p> </div> <div class="paragraph"> <p>Παρακολουθήστε τα διεργασίες μέσω`htop`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt install htop htop</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_καθαρίστε_το_σύστημα_για_να_περιορίσετε_τις_υπερφορτώσεις">Καθαρίστε το σύστημα για να περιορίσετε τις υπερφορτώσεις</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-bash hljs" data-lang="bash">sudo apt autoremove sudo apt autoclean sudo journalctl --vacuum-time=3d</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_για_να_πάτε_περαιτέρω">Για να πάτε περαιτέρω</h2> <div class="sectionbody"> <div class="paragraph"> <p>Μπορείτε να δημιουργήσετε μια υπηρεσία`systemd`προσαρμοσμένο για την αυτόματη εφαρμογή ορισμένων ρυθμίσεων κατά την εκκίνηση �Θέλετε ένα παράδειγμα σε ένα μελλοντικό άρθρο; Να μου το πείτε!</p> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Συνδυάζοντας αυτά τα απλά εργαλεία, θα κερδίσετε :</p> </div> <div class="ulist"> <ul> <li> <p>Έλεγχος θερμοκρασίας CPU</p> </li> <li> <p>Λίγος θόρυβος από την αναπνευστική</p> </li> <li> <p>Μια καλύτερη autonomía</p> </li> </ul> </div> <div class="paragraph"> <p>Μην ξεχάσετε να παρακολουθείτε τις θερμοκρασίες σας τακτικά για να αποτρέψετε κάθε υπερθέρμανση.</p> </div> <div class="paragraph"> <p><em><em>_ Καλύτερα είναι να πρόληψεις παρά να τupanείς την CPU σου. </em>_</em></p> </div> </div> </div> https://cheroliv.com/blog/2025/0082_ui_struggle_post.html Mon, 14 Jul 2025 00:00:00 +0000 blog/2025/0082_ui_struggle_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_το_πεδίο_μάχης_ένα_μοντέλο_τρεις_περιηγητές_muitas_αποδόσεις">Το πεδίο μάχης: ένα μοντέλο, τρεις περιηγητές, muitas αποδόσεις</a></li> <li><a href="#_η_πτενή_κάρτα_του_τμήματος_hero">Η πτενή κάρτα του τμήματος "Hero</a></li> <li><a href="#_πρόβλημα_2_η_μπάρα_πλοήγησης_κανίβαλη">Πρόβλημα 2: Η μπάρα πλοήγησης κανίβαλη</a></li> <li><a href="#_πρόβλημα_3_η_αναρχική_τυπογραφία">Πρόβλημα 3 : Η αναρχική τυπογραφία</a></li> <li><a href="#_πρόβλημα_4_η_γραμμή_πλοήγησης_που_υπερβαίνει_το_πλαίσιο">Πρόβλημα 4 : Η γραμμή πλοήγησης που υπερβαίνει το πλαίσιο</a></li> <li><a href="#_πρόβλημα_5_το_αόρατο_μενού_hamburger">Πρόβλημα 5: Το αόρατο μενού hamburger</a></li> <li><a href="#_συμπέρασμα_τα_μαθήματα_από_την_εντονή_αποσφαλμάτωση">Συμπέρασμα: τα μαθήματα από την εντονή αποσφαλμάτωση</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="admonitionblock note"> <table> <tr> <td class="icon"> <i class="fa icon-note" title="Note"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>Διάβασμα :</strong> περίπου 7 λεπτά <strong>Επίπεδο :</strong> Μέσα</p> </div> </td> </tr> </table> </div> <div class="paragraph"> <p>Σε αυτή τη λεπτομερή πρακτική μελέτη, θα αναλύσουμε τα πιο συνηθισμένα και μερικές φορές ενοχλητικά προβλήματα συμβατότητας προγραμμάτων περιήγησης που συναντώνται κατά τη δημιουργία ενός UI mockup με το Bootstrap 5.2. Από τη διαχείριση Flexbox έως την λεπτομέρεια της απεικόνισης των γραμματοσειρών, ανακαλύψτε τη διαδικασία μας αποσφαλμάτωσης για να μετατρέψετε ένα ασταθές σχέδιο υπό Firefox σε μια pixel‑perfect εμπειρία σε όλους τους φυλλομετρητές.</p> </div> <hr> </div> </div> <div class="sect1"> <h2 id="_το_πεδίο_μάχης_ένα_μοντέλο_τρεις_περιηγητές_muitas_αποδόσεις">Το πεδίο μάχης: ένα μοντέλο, τρεις περιηγητές, muitas αποδόσεις</h2> <div class="sectionbody"> <div class="paragraph"> <p>Κάθε προγραμματιστής front-end ξέρει αυτή τη νιώθη. Μετά από ώρες εργασίας, το mockup είναι τελείως τέλειο. Οι ευθυγραμμικοί είναι ακριβείς, η τυπογραφία είναι ελκυστική, οι κινήσεις είναι ομαλές. Αναπνέει με ικανοποίηση, θαυμάζει τη δουλειά του στο Chrome (ή Brave, ή Edge), και, από συνείδηση, ανοίγει το project στο Firefox. Και εκεί, είναι το θεατρό. Στοιχεία που παρέρχονται, σπασμένες ευθυγραμμίσεις, γραμματοσειρές με ανταρακτικά μεγέθη…​ η ωραία αρμονία έχει πετάξει.</p> </div> <div class="paragraph"> <p>Αυτό είναι ακριβώς το σενάριο που αντιμετωπίσαμε κατά την ανάπτυξη μιας νέας διεπαφής φολιοντό. Το ζητούμενο ήταν απλό: μια σύγχρονη, responsive αρχική σελίδα, με ένα επιλογέα θεμάτων (φωτεινό, σκουρό, υψηλής αντίθεσης), χρησιμοποιώντας <strong>vanilla JavaScript</strong> και την τελευταία έκδοση του <strong>Bootstrap 5.2</strong>.</p> </div> <div class="paragraph"> <p>Αυτό το άρθρο δεν είναι μια λίστα με θαυμαστικές λύσεις. Είναι το ημερολόγιο της συνεδρίας debugging μας, μια βουτιά στο «γιατί» των διαφορών απόδοσης μεταξύ των μηχανών Blink (Chromium, Brave) και Gecko (Firefox), και η επίδειξη ότι οι ισχυρές και σύγχρονες λύσεις είναι πάντα καλύτερες από τα γρήγορα επιθέματα.</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/usecase-debugging-firefox.svg" alt="usecase debugging firefox" width="1204" height="5520"> </div> <div class="title">Figure 1. Διάγραμμα Περίπτωσης Χρήσης : Η διαδικασία αποσφαλμάτωσης</div> </div> <div class="imageblock"> <div class="content"> <img src="./images/components-solution-architecture.svg" alt="components solution architecture" width="1202" height="5160"> </div> <div class="title">Figure 2. Διάγραμμα Στοιχείων: Αρχιτεκτονική της λύσης front-end</div> </div> </div> </div> <div class="sect1"> <h2 id="_η_πτενή_κάρτα_του_τμήματος_hero">Η πτενή κάρτα του τμήματος "Hero</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ο πρώτο σφάλμα ήταν επίσης το πιο ορατό. Η ενότητα καλωσορίσματος (« hero ») αποτελείται από δύο στήλες: αριστερά, ο κύριος τίτλος; δεξιά, μια κάρτα παρουσίασης.</p> </div> <div class="ulist"> <ul> <li> <p><strong>Το συμπτώμα :</strong>Στο Chrome και Brave, οι δύο στήλες ήταν τέλεια κατακεντρωμένες κάθετα. Στο Firefox, η κάρτα της δεξιάς πέφτε ανεξήγητα κάτω από το κείμενο της αριστεράς.</p> </li> <li> <p><strong>Η έρευνα:</strong>Ο κώδικας HTML φαινόταν ωστόσο απλός και σωστός, χρησιμοποιώντας τις πρότυπες κλάσεις του Bootstrap.</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><section id="home" class="hero-section"> <div class="container"> <!-- Cette ligne est la clé du problème --> <div class="row align-items-center min-vh-100"> <div class="col-lg-6"> <!-- Contenu de gauche --> </div> <div class="col-lg-6"> <!-- Carte de droite --> </div> </div> </div> </section></code></pre> </div> </div> <div class="paragraph"> <p>Το προσαρμοσμένο μας CSS για`.hero-section`όριζε`display: flex` et <code>align-items: center</code>, και η κλάση`min-vh-100`έδινε καλά ένα ελάχιστο ύψος στη γραμμή (<code>div.row</code>). Έτσι, γιατί ο Firefox αρνούσέ να κεντράρει τις στήλες;</p> </div> <div class="ulist"> <ul> <li> <p><strong>Η βαθιά αιτία :</strong>Αυτό είναι ένα κλασικό παράδειγμα για τον τρόπο που οι μηχανismes Darstellung ερμηνεύουν τα ενσωματωμένα υψόμετρα. Η`<section>`είχε ένα`min-height`, αλλά όχι`height`Εξακριβής. Για να εφαρμόσετε`align-items-center`έσω του`div.row`, Το Firefox χρειάζεται να ξέρει την υψότητα αναφοράς αυτού του κοντέινερ. Ως οι γονείς του (<code>div.container</code> et la <code><section></code>(αυτή) δεν είχαν ύψος<strong>κατάστημη</strong>, Το Firefox είχε χαθεί. Ο μηχανισμός Blink, πιο επιτρεπτικός, επιτυγχάνει να "μαντεύει" την πρόθεση και να κεντροποιεί τα στοιχεία. Το Gecko, πιο πιστό στην προδιαγραφή, δεν το κάνει.</p> </li> <li> <p><strong>Η λύση :</strong>Κάνετε το ύψος ρητό. Έχουμε βιάσει τον.<code>.container</code> et le `.row`να καταλαμβάνουν 100% του ύψους του αντίστοιχου γονέα τους χρησιμοποιώντας την βοηθητική κλάση`h-100`του Bootstrap.</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><section id="home" class="hero-section"> <div class="container h-100"> <div class="row align-items-center min-vh-100 h-100"> <!-- ... --> </div> </div> </section></code></pre> </div> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> <p>�Όταν ένα`align-items`Το Flexbox δεν λειτουργεί όπως αναμένεται στον άξονα Y, ελέγξτε πάντα ότι το κοντέινερ έχει ύψος (<code>height</code> ou <code>min-height</code>) ορίζεται και, αν το πρόβλημα παραμένει (ειδίως στον Firefox), βεβαιωθείτε ότι τα μεσαία γονεϊκών κοντέινερ διαδίδουν σωστά αυτό το ύψος.</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_πρόβλημα_2_η_μπάρα_πλοήγησης_κανίβαλη">Πρόβλημα 2: Η μπάρα πλοήγησης κανίβαλη</h2> <div class="sectionbody"> <div class="ulist"> <div class="title">Μετά την ευθυγραμμίση της ενότητας «Hero», εμφανίστηκε ένα άλλο πρόβλημα: η μπάρα πλοήγησης, με την κλάση της`fixed-top`, επικάλυπτε τον τίτλο. Ένας`padding-top: 80px`είχε εφαρμοστεί στην ενότητα 'Hero' ως λύση.</div> <ul> <li> <p><strong>Το σύμπτωμα:</strong> Le `padding`ήταν επαρκές στο Chrome, αλλά όχι στο Firefox, όπου ο τίτλος ήταν πάντα μερικώς κρυμμένος.</p> </li> <li> <p><strong>Η αιτία βαθιά:</strong>Η χρήση ενός "μαγικού αριθμού" (<code>80px</code>) είναι μια πολύ κακή πρακτική. Το ύψος ενός στοιχείου όπως μια γραμμή πλοήγησης μπορεί να ποικίλει σε μερικούς pixel από έναν περιηγητή σε άλλον λόγω λεπτών διαφορών στην απόδοση των γραμματοσειρών, των διαστημάτων ή ακόμα και των ρυθμίσεων του χρήστη. Η εμπιστοσύνη σε μια σταθερά τιμή είναι η συνταγή για ένα ευαίσθητο σχέδιο.</p> </li> <li> <p><strong>Η λύση:</strong>Μια δυναμική και απρόσκοπη λύση σε JavaScript. Έχουμε γράψει ένα μικρό script για :</p> </li> <li> <p>Μετρήστε το ύψος <strong>πραγματική</strong> της γραμμής πλοήγησης μετά από την εμφάνιση της σελίδας.</p> </li> <li> <p>Εφαρμόστε αυτό το μετρημένο ύψος ως`padding-top`στήν ενότητα "Hero</p> </li> <li> <p>Εκτελέστε ξανά αυτή τη συνάρτηση κάθε φορά που αλλάζει το μέγεθος του παραθύρου για να προσαρμόζεται στις αλλαγές (όπως η μετάβαση στο μενού αγκαλιού).</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-javascript hljs" data-lang="javascript">document.addEventListener('DOMContentLoaded', function() { function adjustHeroPadding() { const navbar = document.querySelector('.navbar.fixed-top'); const heroSection = document.querySelector('.hero-section'); if (navbar && heroSection) { const navbarHeight = navbar.offsetHeight; heroSection.style.paddingTop = navbarHeight + 'px'; } } // Ajuster au chargement et au redimensionnement adjustHeroPadding(); window.addEventListener('resize', adjustHeroPadding); });</code></pre> </div> </div> <div class="imageblock"> <div class="content"> <img src="./images/sequence-dynamic-padding.svg" alt="sequence dynamic padding" width="887" height="703"> </div> <div class="title">Figure 3. Διάγραμμα ακολουθίας : Δυναμική προσαρμογή του padding</div> </div> <div class="paragraph"> <p>Παράλληλα, φυσικά, αφαιρέσαμε τον κανόνα.<code>padding-top: 80px;`του αρχείου μας`styles.css</code>.</p> </div> </div> </div> <div class="sect1"> <h2 id="_πρόβλημα_3_η_αναρχική_τυπογραφία">Πρόβλημα 3 : Η αναρχική τυπογραφία</h2> <div class="sectionbody"> <div class="ulist"> <div class="title">Η επόμενη ανησυχία ήταν η πιο βλαβερή για την εικόνα του μάρκε : το μέγεθος του κύριου τίτλου.</div> <ul> <li> <p><strong>Το σύμπτωμα :</strong>Στον Firefox, η γραμματοσειρά του tituló «Δημιουργός Εκπαιδευτής…» ήταν τεράστια, σχεδόν σοκαριστική, ενώ στους υπόλοιπους περιηγητές ήταν αρμονική.</p> </li> </ul> </div> <div class="paragraph"> <p>(Note: I kept the typographic quotes as in the source; if straight single quotes are preferred, they can be swapped accordingly.)</p> </div> <div class="ulist"> <ul> <li> <p><strong>Η βαθύτατη αιτία :</strong>Ο τίτλος χρησιμοποίησε μια κλάση`display-4`του Bootstrap. Αυτές οι κλάσεις χρησιμοποιούν ανταποκρινόμενες μεγέθειες γραμματοσειρών, συχνά βασισμένες στην μονάδα`rem`Και των media queries. Μια φορά ακόμα, ο αλγόριθμος απόδοσης του Firefox, συνδυασμένος με τη γραμματοσειρά "Inter", έπέφερε σε έναν υπολογισμό μεγέθους πολύ μεγαλύτερο στην ανάλυση 1920x1080.</p> </li> <li> <p><strong>Η λύση :</strong>Ανάκτηση του ελέγχου με τη συνάρτηση CSS`clamp()<code>Αυτή η λειτουργία είναι μια επανάσταση για τη ροή τύπογραφίας. Επιτρέπει να οριστεί ένα μέγεθος γραμματοσειράς με τιμές: ένα ελάχιστο μέγεθος, ένα "προτιμημένο" μέγεθος ( που προσαρμόζεται στο πλάτος της οθόνης,`vw</code>), και ένα μέγιστο μέγεθος.</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">.hero-content h1 { color: var(--text-primary); line-height: 1.2; /* Min: 2rem Préférée: s'adapte à la vue Max: 2.5rem (40px) */ font-size: clamp(2rem, 1.2rem + 1.5vw, 2.5rem); }</code></pre> </div> </div> <div class="paragraph"> <p>με`clamp()<code>, ημπορέμε να πούμε στον περιηγητή: "Μεγάλε την γραμματοσειρά με την οθόνη, αλλά μην υπερβείς<strong>ποτέ</strong>το όριο του`2.5rem</code>. Αυτό ενοποίησε αμέσως την εμφάνιση σε όλους τους φυλλομετρητές, μας δώνοντας τον πλήρη έλεγχο στην τελική αισθητική.</p> </div> </div> </div> <div class="sect1"> <h2 id="_πρόβλημα_4_η_γραμμή_πλοήγησης_που_υπερβαίνει_το_πλαίσιο">Πρόβλημα 4 : Η γραμμή πλοήγησης που υπερβαίνει το πλαίσιο</h2> <div class="sectionbody"> <div class="ulist"> <div class="title">Είναι το πρόβλημα που μας έδωσε τη μεγαλύτερη δυσκολία και τελικά αποκαλύφθηκε η βαθιά φύση των μικροδιαφορών απόδοσης.</div> <ul> <li> <p><strong>Το σύμπτωμα:</strong>Σε οθόνη 1920x1080, τα τελευταία σύνδεσμοι του μενού ("Blog", "Contact") έπεσαν εκτός της οθόνης προς τη δεξιά, αλλά μόνο στον Firefox.</p> </li> <li> <p><strong>Η βαθύτατη αιτία:</strong>μετά από πολλές αποτυχημένες προσπάθειες (αλλαγή των σημείων διάσπασης του Bootstrap de`lg` à <code>xl`τότε`xxl</code>), καταλάβαμε. Η αιτία δεν ήταν η λογική του Bootstrap, αλλά ένα απλός υπολογισμός πλάτους. Στο Firefox, το άθροισμα των πλάτους όλων των συνδέσμων, συμπεριλαμβανομένων των`padding` et `margin`με ακρίβεια sub-pixel, ήταν <strong>ελαφρώς</strong> μεγαλύτερη από 1920 pixel. Στον Chrome, αυτή η ίδια ποσότητα ήταν <strong>ελαφρώς</strong> μικρότερη. Λείγανε μα λίγα pixel.</p> </li> <li> <p><strong>Η λύση :</strong>Μια χειρουργική μείωση των διαστημάτων. Επειδή ήταν εκτός ερώτησης να στοχεύσουμε ειδικά το Firefox με παρωχημένα CSS "hacks", η μόνη καθαρή λύση ήταν να βρούμε έναν κοινό στυλ που λειτουργεί παντού. Έτσι, μειώσαμε ελαφρώς τις περιθώρια και το padding οριζόντιο καθενού συνδέσμου πλοήγησης.</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">/* La version finale, légèrement plus compacte */ .navbar-nav .nav-link { font-size: 0.9rem; /* 90% de la taille de base */ color: var(--text-primary) !important; font-weight: 500; margin: 0 0.2rem; padding: 0.5rem 0.5rem !important; border-radius: 0.375rem; transition: all 0.3s ease; }</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η μείωση, σχεδόν αόρατη στον οπτικό αισθητή σε ένα στοιχείο, μας έδωσε το απαραίτητο χώρο ώστε να μπορούν όλοι οι σύνδεσμοι να χωρέσουν στο πλαίσιο του Firefox, διατηρώντας σχεδόν την ίδια εμφάνιση και στους υπόλοιπους περιηγητές.</p> </div> </div> </div> <div class="sect1"> <h2 id="_πρόβλημα_5_το_αόρατο_μενού_hamburger">Πρόβλημα 5: Το αόρατο μενού hamburger</h2> <div class="sectionbody"> <div class="ulist"> <div class="title">Το τελευταίο πρόβλημα, και όχι το ελάχιστο, αφορούσε την προσβασιμότητα σε κινητό.</div> <ul> <li> <p><strong>Το σύμπτωμα :</strong>Στον ανταποκρισιμό τρόπο (menu "hamburger"), το εικονίδιο του μενού ήταν αόρατο στους θεματικούς "dark" και "high-contrast".</p> </li> <li> <p><strong>Η βαθιά αιτία:</strong>Το εικονίδιο του μενού του Bootstrap 5 είναι ένα`background-image`(ένας SVG που έχει κωδικοποιηθεί σε URL). Προεπιλογής, το χρώμα της γραμμής του είναι σκούρο, βελτιστοποιημένο για φωτεινό υπόβαθρο. Δεν προσαρμόζεται αυτόματα στην αλλαγή του θέματος.</p> </li> <li> <p><strong>Η λύση:</strong>Χρησιμοποιήστε τις μεταβλητές CSS του Bootstrap για να υπερκαλυπτήσετε το εικονίδιο. Ορίσαμε ένα νέο εικονίδιο SVG, αλλά desta φορά με μια λευκή γραμμή (<code>#ffffff</code>), και το εφαρμόσαμε συγκεκριμένα όταν τα θέματα`dark` ou `high-contrast`είναι ενεργοί.</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-css hljs" data-lang="css">/* ====================== Fix pour l'icône du menu Burger (Blanc) ====================== */ [data-bs-theme="dark"] .navbar-toggler-icon, [data-bs-theme="high-contrast"] .navbar-toggler-icon { --bs-navbar-toggler-icon-bg: url("data:image/svg+xml,%3csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 30 30'%3e%3cpath stroke='%23ffffff' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3e%3c/svg%3e"); }</code></pre> </div> </div> <div class="admonitionblock important"> <table> <tr> <td class="icon"> <i class="fa icon-important" title="Important"></i> </td> <td class="content"> <div class="paragraph"> <p>Η προσαρμογή των συστατικών του Bootstrap όπως αυτό γίνεται περισσότερο και περισσότερο μέσω της υποκατάστασης μεταβλητών CSS (<code>--bs-component-property</code>), ο οποίος είναι η πιο καθαρή και πιο βιώσιμη μέθοδος.</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα_τα_μαθήματα_από_την_εντονή_αποσφαλμάτωση">Συμπέρασμα: τα μαθήματα από την εντονή αποσφαλμάτωση</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτή η διαδρομή, αν και μερικές φορές απογοητευτική, είναι πλούσια σε διδασκαλίες. Κάθε λυμένο πρόβλημα ενισχύει μια θεμελιώδη αλήθεια του ιστού :<strong>Κανένας δεν αντικαθιστά μια αυστηρή δοκιμή πολλαπλών περιηγητών</strong>.</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/mindmap-debugging-summary.svg" alt="mindmap debugging summary" width="999" height="866"> </div> <div class="title">Figure 4. Mindmap : Σύνοψη της αποσφαλμάτωσης και των μαθημάτων που έχουμε μάθει</div> </div> <div class="olist arabic"> <div class="title">Αυτά είναι τα μαθήματα που κρατάμε :</div> <ol class="arabic"> <li> <p><strong>Firefox είναι ένας σύμμαχος :</strong>Η μεγαλύτερη της πιστότητα στα πρότυπα CSS μας υποχρεώνει να γράφουμε έναν κώδικα που είναι πιο ανθεκτικό και λιγότερο ασαφής.</p> </li> <li> <p><strong>Αποφύγετε τους "αριθμούς μαγικός" :</strong>Οι σταθερές τιμές (όπως`padding-top: 80px`) είναι βόμβες με χρονόζυγο. Προτιμήστε πάντα δυναμικές λύσεις (JavaScript) ή σχετικές (Flexbox, Grid).</p> </li> <li> <p><strong>Αποκτήστε έλεγχο στη τυπογραφία σας:</strong>Χρησιμοποιείτε`clamp()`για πλήρη έλεγχο του μεγέθους των ανταποκρινόμενων γραμματοσειρών</p> </li> <li> <p><strong>Σκέψτε σε "συστατικά" :</strong>Για να προσαρμόζετε το Bootstrap, αντικαταστήστε τις μεταβλητές CSS του αντί να πολλαπλασιάζετε τους κανόνες που τον υπερισχύουν.</p> </li> <li> <p><strong>Μην στοχεύετε σε έναν περιηγητή:</strong>Η λύση είναι σχεδόν ποτέ να κάνεις ένα "hack" για έναν συγκεκριμένο φυλλομετρητή, αλλά να βρεις ένα κοινό στυλ που λειτουργεί παντού.</p> </li> </ol> </div> <div class="paragraph"> <p>Τελικά, το πρωτότυπο είναι τώρα σταθερό, προβλέψιμο και έτοιμο να ενσωματωθεί σε ένα σύστημα προτύπων. Κάθε διορθωμένο bug δεν ήταν αποτυχία, αλλά ένα βήμα προς έναν κώδικα καλύτερης ποιότητας.</p> </div> </div> </div> https://cheroliv.com/blog/2025/0081_TDD_Gradle_Properties_Fix_post.html Sun, 13 Jul 2025 00:00:00 +0000 blog/2025/0081_TDD_Gradle_Properties_Fix_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_το_πρόβλημα_απομόνωση_των_δοκιμών_μονάδας_ενός_προσθέτου_gradle">Το πρόβλημα : Απομόνωση των δοκιμών μονάδας ενός προσθέτου Gradle</a> <ul class="sectlevel2"> <li><a href="#_αρχιτεκτονική_του_προβλήματος">Αρχιτεκτονική του Προβλήματος</a></li> <li><a href="#_ο_πειρασμός_μίας_ψευδούς_καλής_ιδέας">Ο πειρασμός μίας ψευδούς καλής ιδέας</a></li> </ul> </li> <li><a href="#_η_λύση_προσομοίωση_της_ιδιοκτησίας_με_extrapropertiesextension">Η Λύση : Προσομοίωση της Ιδιοκτησίας με `ExtraPropertiesExtension</a> <ul class="sectlevel2"> <li><a href="#_βήμα_1_κατανόηση_extrapropertiesextension">Βήμα 1 : Κατανόηση ExtraPropertiesExtension</a></li> <li><a href="#_βήμα_2_ρύθμιση_δοκιμίου_προετοιμασία">Βήμα 2 : Ρύθμιση δοκιμίου - Προετοιμασία</a></li> <li><a href="#_βήμα_3_εισαγωγή_της_ιδιοκτησίας">Βήμα 3 : Εισαγωγή της Ιδιοκτησίας</a></li> <li><a href="#_βήμα_4_διαγραμμα_ροής_της_λύσης">Βήμα 4 : Διαγραμμα Ροής της Λύσης</a></li> <li><a href="#_βήμα_5_σύγκριση_πρινμετά">Βήμα 5 : Σύγκριση Πριν/Μετά</a></li> <li><a href="#_βήμα_6_διαχείριση_πολλαπλών_περπτώσεων_ελέγχου">Βήμα 6: Διαχείριση Πολλαπλών Περπτώσεων Ελέγχου</a></li> <li><a href="#_τελική_αρχιτεκτονική_της_λύσης">Τελική Αρχιτεκτονική της Λύσης</a></li> </ul> </li> <li><a href="#_τα_πλεονεκτήματα_αυτής_της_προσέγγισης">Τα πλεονεκτήματα αυτής της προσέγγισης</a></li> <li><a href="#_καλές_πρακτικές_και_συμβουλές">Καλές Πρακτικές και Συμβουλές</a> <ul class="sectlevel2"> <li><a href="#_δημιουργήστε_μια_χρήσιμη_μέθοδος">Δημιουργήστε μια χρήσιμη μέθοδος</a></li> <li><a href="#_επικύρωση_ιδιοτήτων">Επικύρωση Ιδιοτήτων</a></li> </ul> </li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div class="sect1"> <h2 id="_το_πρόβλημα_απομόνωση_των_δοκιμών_μονάδας_ενός_προσθέτου_gradle">Το πρόβλημα : Απομόνωση των δοκιμών μονάδας ενός προσθέτου Gradle</h2> <div class="sectionbody"> <div class="paragraph"> <p>Κατά την σύνταξη μονάδικων δοκιμών για ένα πρόσθετο Gradle, μια συνηθισμένη πρόκληση είναι η διαχείριση των εξαρτήσεων στη διαμόρφωση του έργου, όπως οι ιδιότητες που ορίζονται στο αρχείο`gradle.properties`. Σε την περίπτωση μας, το plugin`jbake.ghpages`πρέπει να διαβάσει μια ιδιότητα`site_config_path`για να λειτουργήσει σωστά. Ο τεστ μονάδας για την εργασία`initialize`�Θα έπρεπε να ελέγξει τη συμπεριφορά του plugin στην παρουσία αυτής της ιδιότητας.</p> </div> <div class="paragraph"> <p>Το θεμελιώδες πρόβλημα είναι ότι οι μονάδες δοκιμών, σύμφωνα με τον σχεδιασμό, πρέπει να είναι <strong>απομονωμένα</strong>. Η χρήση του`ProjectBuilder`ο Gradle δημιουργεί ένα παράδειγμα του`Project`Στη μνήμη, αποσυνδεδεμένη πλήρως από ένα πραγματικό έργο στο σύστημα αρχείων. Επομένως, αυτή η δοκιμαστική παρουσία δεν διαβάζει αυτόματα το αρχείο.<code>gradle.properties`και δεν έχει γνώση της ιδιότητας`site_config_path</code>.</p> </div> <div class="sect2"> <h3 id="_αρχιτεκτονική_του_προβλήματος">Αρχιτεκτονική του Προβλήματος</h3> <div class="paragraph"> <p>Το επόμενο διάγραμμα επεξηγεί την αποσύνδεση μεταξύ του περιβάλλοντος δοκιμών και του συστήματος αρχείων:</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/test-isolation-problem.svg" alt="test isolation problem" width="1259" height="5787"> </div> </div> </div> <div class="sect2"> <h3 id="_ο_πειρασμός_μίας_ψευδούς_καλής_ιδέας">Ο πειρασμός μίας ψευδούς καλής ιδέας</h3> <div class="paragraph"> <p>Μια πρώτη προσέγγιση θα μπορούσε να είναι να δημιουργήσει ένα αρχείο`gradle.properties`τεχνητό στις πηγές του τεστ</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">// src/test/resources/gradle.properties site_config_path=src/jbake/settings/site.yml</code></pre> </div> </div> <div class="paragraph"> <p>Αuttavia, αυτή η μέθοδος είναι προορισμένη να αποτύχει για`ProjectBuilder`Δεν έχει σχεδιαστεί για να σαρώσει το σύστημα αρχείων στην αναζήτηση αρχείων ρυθμίσεων. Η δοκιμή θα μενει απομονωμένη και θα αγνοήσει αυτό το αρχείο.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_η_λύση_προσομοίωση_της_ιδιοκτησίας_με_extrapropertiesextension">Η Λύση : Προσομοίωση της Ιδιοκτησίας με `ExtraPropertiesExtension</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η κομψή λύση αυτού του προβλήματος δεν είναι να <strong>διαβάζει</strong> το αρχείο, αλλά να <strong>σομοιάζει</strong> τη παρουσία της ιδιότητας απευθείας στο αντικείμενο`Project`για δοκιμή. Το Gradle παρέχει έναν ισχυρό μηχανισμό για αυτό: τις <strong>επιπρόσθετες ιδιότητες</strong> (Extra Properties).</p> </div> <div class="sect2"> <h3 id="_βήμα_1_κατανόηση_extrapropertiesextension">Βήμα 1 : Κατανόηση ExtraPropertiesExtension</h3> <div class="paragraph"> <p>`ExtraPropertiesExtension`Είναι ένας κοντέινερ κλειδί-τιμή που είναι συνημμένο σε κάθε αντικείμενο του μοντέλου Gradle. Επιτρέπει την προσθήκη δυναμικών ιδιοτήτων σε ένα πρόγραμμα, μια εργασία, ή οποιαδήποτε άλλη επέκταση Gradle.</p> </div> <div class="imageblock"> <div class="content"> <img src="./images/extra-properties-architecture.svg" alt="extra properties architecture" width="533" height="436"> </div> </div> </div> <div class="sect2"> <h3 id="_βήμα_2_ρύθμιση_δοκιμίου_προετοιμασία">Βήμα 2 : Ρύθμιση δοκιμίου - Προετοιμασία</h3> <div class="paragraph"> <p>Ας αρχίσουμε δημιουργώντας τη βασική δομή του μονάδικου τεστ μας :</p> </div> <div class="listingblock"> <div class="title">JbakeGhPagesPluginTest.kt - Structure de base</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class JbakeGhPagesPluginTest { @TempDir lateinit var testProjectDir: File @Test fun `check initialize and config yaml file if not existing`() { // Étape 1 : Créer un projet de test isolé val project = ProjectBuilder.builder() .withProjectDir(testProjectDir) .build() // Suite des étapes... } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_βήμα_3_εισαγωγή_της_ιδιοκτησίας">Βήμα 3 : Εισαγωγή της Ιδιοκτησίας</h3> <div class="paragraph"> <p>Αυτό είναι η λεπτομερής διαδικασία για να εντάξετε την ιδιότητα στο δοκιμαστικό έργο:</p> </div> <div class="listingblock"> <div class="title">JbakeGhPagesPluginTest.kt - Injection complète</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `check initialize and config yaml file if not existing`() { // Étape 1 : Créer un projet de test isolé en mémoire val project = ProjectBuilder.builder() .withProjectDir(testProjectDir) .build() // Étape 2 : Récupérer le gestionnaire de propriétés supplémentaires val extra = project.extensions.getByType(ExtraPropertiesExtension::class.java) // Étape 3 : Définir la propriété requise pour ce test extra.set("site_config_path", "src/jbake/settings/site.yml") // Étape 4 : Vérifier que la propriété est bien injectée assertTrue(project.hasProperty("site_config_path")) // Étape 5 : Appliquer le plugin qui pourra maintenant accéder à la propriété project.plugins.apply("jbake.ghpages") // Étape 6 : Exécuter la tâche et vérifier son comportement val task: Task = project.tasks.findByName("initialize") .apply(::assertNotNull)!! // Étape 7 : Exécuter les actions de la tâche task.actions.forEach { it.execute(task) } // Étape 8 : Assertions finales assertEquals( "src/jbake/settings/site.yml", project.properties["site_config_path"], "La propriété devrait être accessible dans le projet" ) }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_βήμα_4_διαγραμμα_ροής_της_λύσης">Βήμα 4 : Διαγραμμα Ροής της Λύσης</h3> <div class="imageblock"> <div class="content"> <img src="./images/solution-flow.svg" alt="solution flow" width="242" height="807"> </div> </div> </div> <div class="sect2"> <h3 id="_βήμα_5_σύγκριση_πρινμετά">Βήμα 5 : Σύγκριση Πριν/Μετά</h3> <div class="imageblock"> <div class="content"> <img src="./images/before-after-comparison.svg" alt="before after comparison" width="1199" height="5783"> </div> </div> </div> <div class="sect2"> <h3 id="_βήμα_6_διαχείριση_πολλαπλών_περπτώσεων_ελέγχου">Βήμα 6: Διαχείριση Πολλαπλών Περπτώσεων Ελέγχου</h3> <div class="paragraph"> <p>Για να δοκιμάσουμε διαφορετικά σενάρια, ας δημιουργήσουμε πολλές δοκιμές με ποικίλες διαμορφώσεις:</p> </div> <div class="listingblock"> <div class="title">Tests multiples avec configurations différentes</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class JbakeGhPagesPluginTest { @TempDir lateinit var testProjectDir: File private fun createProjectWithProperty(propertyValue: String?): Project { val project = ProjectBuilder.builder() .withProjectDir(testProjectDir) .build() // Injection conditionnelle de la propriété propertyValue?.let { value -> val extra = project.extensions.getByType(ExtraPropertiesExtension::class.java) extra.set("site_config_path", value) } return project } @Test fun `should work with valid property`() { val project = createProjectWithProperty("src/jbake/settings/site.yml") project.plugins.apply("jbake.ghpages") val task = project.tasks.findByName("initialize")!! task.actions.forEach { it.execute(task) } // Assertions pour le cas normal assertEquals("src/jbake/settings/site.yml", project.properties["site_config_path"]) } @Test fun `should handle missing property gracefully`() { val project = createProjectWithProperty(null) // Pas de propriété project.plugins.apply("jbake.ghpages") val task = project.tasks.findByName("initialize")!! // Le plugin devrait gérer l'absence de propriété assertDoesNotThrow { task.actions.forEach { it.execute(task) } } } @Test fun `should handle invalid property path`() { val project = createProjectWithProperty("invalid/path/to/config.yml") project.plugins.apply("jbake.ghpages") val task = project.tasks.findByName("initialize")!! // Test du comportement avec un chemin invalide assertThrows<FileNotFoundException> { task.actions.forEach { it.execute(task) } } } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_τελική_αρχιτεκτονική_της_λύσης">Τελική Αρχιτεκτονική της Λύσης</h3> <div class="imageblock"> <div class="content"> <img src="./images/final-architecture.svg" alt="final architecture" width="1211" height="5851"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_τα_πλεονεκτήματα_αυτής_της_προσέγγισης">Τα πλεονεκτήματα αυτής της προσέγγισης</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><strong>Ολική Απομόνωση</strong>: Ο τεστ δεν εξαρτάται από καμία εξωτερική αρχείο. Είναι αυτόνομο και μπορεί να εκτελεστεί αξιοπιστά σε οποιοδήποτε περιβάλλον (τοπικό, CI/CD, κλπ.).</p> </li> <li> <p><strong>Σαφήνεια και Πρόθεση</strong>: Ο τεστ δηλώνει ρητά τις προϋποθέσεις για την εκτέλεσή του. Όποιος διαβάζει το τεστ βλέπει αμέσως ότι το plugin χρειάζεται την ιδιότητα`site_config_path`για να λειτουργεί.</p> </li> <li> <p><strong>διατηρησιμότητα</strong>Αν το όνομα της ιδιότητας αλλάζει, αρκεί να το ενημερώσετε σε μόνο ένα σημείο στη δοκιμή, χωρίς να χρειαστεί να χειριζόσθε τα αρχεία ρυθμίσεων δοκιμής.</p> </li> <li> <p><strong>Ευελιξία</strong>Γίνεται εύκολο να δοκιμάζουμε διάφορα σενάρια απλά αλλάζοντας την τιμή της εισαχθείσας ιδιότητας σε κάθε τεστ (εγκυρη τιμή, μη εγκυρη, απουσα κλπ.).</p> </li> <li> <p><strong>απόδοση</strong>: Δεν υπάρχει ανάγνωση αρχείων, όλα γίνονται στη μνήμη, κάτι που κάνει τις δοκιμές γρηγορότερες.</p> </li> <li> <p><strong>αναπαράγωγοτητα</strong>Οι δοκιμές είναι deterministiki επειδή δεν εξαρτώνονται από την κατάσταση του συστήματος αρχείων.</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_καλές_πρακτικές_και_συμβουλές">Καλές Πρακτικές και Συμβουλές</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_δημιουργήστε_μια_χρήσιμη_μέθοδος">Δημιουργήστε μια χρήσιμη μέθοδος</h3> <div class="listingblock"> <div class="title">Méthode utilitaire pour la réutilisation</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class GradleTestUtils { companion object { fun createProjectWithProperties( projectDir: File, properties: Map<String, String> ): Project { val project = ProjectBuilder.builder() .withProjectDir(projectDir) .build() val extra = project.extensions.getByType(ExtraPropertiesExtension::class.java) properties.forEach { (key, value) -> extra.set(key, value) } return project } } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_επικύρωση_ιδιοτήτων">Επικύρωση Ιδιοτήτων</h3> <div class="listingblock"> <div class="title">Validation robuste</div> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `should validate property injection`() { val project = createProjectWithProperty("test-value") // Vérifications multiples assertTrue(project.hasProperty("site_config_path")) assertEquals("test-value", project.property("site_config_path")) assertNotNull(project.properties["site_config_path"]) // Vérification que la propriété est accessible par le plugin project.plugins.apply("jbake.ghpages") // ... reste du test }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αντί να αγωνίζεσαι για να κάνεις ένα περιβάλλον δοκιμής μονάδας να διαβάζει αρχεία ρυθμίσεων, η καλύτερη πρακτική είναι να προσομοιώσεις την απαιτούμενη κατάσταση. Η χρήση του`ExtraPropertiesExtension`Για να ορίσετε μέσω προγραμματισμού τις ιδιότητες Gradle είναι η καθαρότερη και πιο αξιόπιστη μέθοδος για να εκτελέσετε αποτελεσματικές και αξιόπιστες δοκιμές μονάδας πρόσθετων.</p> </div> <div class="paragraph"> <p>Αυτή η τεχνική μετατρέπει ένα πρόβλημα εξωτερικής εξάρτησης σε μια απλή έγχυση εξάρτησης, στο εσωτερικό της φιλοσοφίας του Test-Driven Development (TDD). Παρέχει πλήρη έλεγχο στο περιβάλλον δοκιμών, διατηρίζοντας την απαραίτητη απομόνωση που απαιτείται για ποιοτικά μονάδες δοκιμών.</p> </div> <div class="paragraph"> <p>Τα διαγράμματα και τα παραδείγματα που παρουσιάζονται σε αυτό το άρθρο δείχνουν πώς αυτή η προσέγγιση μπορεί να υλοποιηθεί με προοδευτικό και μεθοδικό τρόπο, επιτρέποντας τη δημιουργία μιας αξιόπιστης και συντηρούμενής σύτης ελέγχων για τα plugins Gradle σας.</p> </div> </div> </div> https://cheroliv.com/blog/2025/0079_gradle_tasks_tests_report_post.html Fri, 11 Jul 2025 00:00:00 +0000 blog/2025/0079_gradle_tasks_tests_report_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_κεντροποίηση_των_διαμορφώσεων_με_allprojects_και_subprojects">Κεντροποίηση των Διαμορφώσεων με <code>allprojects</code> και `subprojects</a></li> <li><a href="#_sourceplantuml">[source,plantuml]</a></li> <li><a href="#_enduml">@enduml</a></li> <li><a href="#_sourcekotlin">[source,kotlin]</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>Η αυτοματοποίηση των εργασιών κατασκευής είναι καθοριστική για κάθε λογισμικό έργο, και το Gradle, με το DSL Kotlin του, προσφέρει εξαιρετική ευελιξία. Κατά τη διάρκεια της συζήτησής μας, διερευνήσαμε πώς να κεντροποιήσουμε και να επαναχρησιμοποιήσουμε την λογική κατασκευής, ειδικά για τα αναφορές δοκιμής, εκμεταλλευόμενοι το<strong>όλες οι έργα</strong>, <strong>buildSrc</strong>, και προσαρμοσμένες εργασίες στην Kotlin.</p> </div> </div> </div> <div class="sect1"> <h2 id="_κεντροποίηση_των_διαμορφώσεων_με_allprojects_και_subprojects">Κεντροποίηση των Διαμορφώσεων με <code>allprojects</code> και `subprojects</h2> <div class="sectionbody"> <div class="paragraph"> <p>Τα μπλοκ`allprojects` et `subprojects`στο σας`build.gradle.kts`Η ρίζα είναι θεμελιώδης για την εφαρμογή κοινών διαμορφώσεων σε όλο το πολυ-μοναδικό σας έργο.</p> </div> <div class="paragraph"> <p>*<code>allprojects { …​ }</code>: Εφαρμόζει τη ρύθμιση στο<strong>το ριζικό έργο και όλα τα υποέργα του</strong>. Ιδανικό για να ορίσετε ένα`group`, μ </think> , μ`version`, ή τις`repositories`κοινά. *<code>subprojects { …​ }</code>: Εφαρμόζει τη ρύθμιση<strong>μόνο στους υποέργα</strong>, εκτός του ριζικού project. Ιδανικό για την εφαρμογή προσαρμοσμένων plugins για τα modules (όπως`java` ou <code>kotlin-jvm</code>) ή κοινές εξαρτήσεις στις βιβλιοθήκες σας.</p> </div> <div class="paragraph"> <p>Αυτό είναι ένα ενδεικτικό παράδειγμα:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// build.gradle.kts (projet racine) plugins { base // Appliqué au projet racine } allprojects { group = "com.example" version = "1.0.0" repositories { mavenCentral() } tasks.withType<org.gradle.api.tasks.testing.Test> { useJUnitPlatform() // Configuration commune des tests pour tous les projets } } subprojects { apply(plugin = "java") apply(plugin = "org.jetbrains.kotlin.jvm") dependencies { implementation("org.jetbrains.kotlin:kotlin-stdlib-jdk8") } }</code></pre> </div> </div> <div class="paragraph"> <p>\==`buildSrc`Το σβιγκλιό της λογικής του Build</p> </div> <div class="paragraph"> <p>Όταν η λογική των εργασιών σας γίνεται πολύπλοκη ή πρέπει να επαναχρησιμοποιηθεί,<strong>buildSrc</strong>είναι η προτιμημένη λύση. Είναι ένα ειδικό module Gradle που μεταγλωττίζεται πριν τα κύρια scripts του build, καθιστώντας τις κλάσες του διαθέσιμες στο classpath του ολόκληρου του build σου.</p> </div> <div class="paragraph"> <p>Γιατί να χρησιμοποιήσετε;`buildSrc`για τις Εργασίες ?</p> </div> <div class="ulist"> <ul> <li> <p><strong>Επαναχρησιμοποίηση</strong>: Μια εργασία που ορίζεται στο`buildSrc`μπορεί να εφαρμοστεί σε οποιοδήποτε project του build.</p> </li> <li> <p><strong>Οργάνωση</strong>: Κεντρίζει τον κώδικα κατασκευής, τον καθιστώντας πιο καθαρό και διατηρήσιμο.</p> </li> <li> <p><strong>Ασφάλεια Τύπου και Αυτοσυμπλήρωση</strong>: Ο κώδικας Kotlin στο`buildSrc`Είναι μεταγλωττισμένο, προσφέροντας τον έλεγχο σφαλμάτων και το autocompletion του IDE σας, βελτιώνοντας την εμπειρία ανάπτυξης.</p> </li> </ul> </div> <div class="paragraph"> <p>\=== Διάγραμμα ροής`buildSrc`(Κώδικας PlantUML)</p> </div> <div class="paragraph"> <p>Για να δημιουργήσετε αυτό το διάγραμμα, antigrapse ton kwdika parakato kai epikolleste ton se ena ergaleio poyypostirizei to PlantUML.</p> </div> </div> </div> <div class="sect1"> <h2 id="_sourceplantuml">[source,plantuml]</h2> <div class="sectionbody"> <div class="paragraph"> <p>@startuml skinparam χειρογραφημένο αληθές skinparam monochrome true</p> </div> <div class="paragraph"> <p>rectangle "Gradle Build Process" { συστατικό "buildSrc" ως BS { αρχείο "MyCustomTask.kt" ως T file "MyConventionPlugin.kt" as P } συστατικό "Root Project" ως RP σταθερό "Subproject A" ως SA συστατικό "Subproject B" ως SB }</p> </div> <div class="paragraph"> <p>T --\> P : "ορίζεται σε P -→ RP : "εφαρμόζεται σε P --\> SA : "εφαρμόζεται σε P --\> SB : "εφαρμόζεται σε</p> </div> <div class="paragraph"> <p>RP --|\> SA : "περιέχει RP --|\> SB : "περιέχει</p> </div> <div class="paragraph"> <p>RP -up→ BS : "εξαρτάται από (για τη λογική κατασκευής) SA -up-\> BS : "εξαρτάται από (για τη λογική κατασκευής) SB -up-\> BS : "εξαρτάται από (για τη λογική χτίσης)</p> </div> <div class="paragraph"> <p>σημειώμα δεξιά του T Κλάσεις προσαρμοσμένων εργασιών (π.χ.: OpenTestReportTask) τέλος σημείωσης</p> </div> <div class="paragraph"> <p>σημειώνημα δεξιά του P Πλαγκιν σύμβασης οι καταγράφουν τις εργασίες τελική σημείωση</p> </div> </div> </div> <div class="sect1"> <h2 id="_enduml">@enduml</h2> <div class="sectionbody"> <div class="paragraph"> <p>\== Δημιουργία αβστράκτων εργασιών αναφοράς</p> </div> <div class="paragraph"> <p>Για να διαχειριστούμε τα αναφορές δοκιμών, σχεδιάσαμε μια μοデュλική προσέγγιση χρησιμοποιώντας μια αφηρημένη κλάση εργασίας σε`buildSrc`. Ανάλογα με τις ανάγκες σας, αυτή η κλάση μπορεί να κληρονομήσει`DefaultTask` ou de <code>Exec</code>.</p> </div> <div class="paragraph"> <p>\=== Αβστράκτη Εργασία`OpenTestReportTask`(κληρονόμενος από`DefaultTask`)</p> </div> <div class="paragraph"> <p>Αυτή η προσέγγιση συνιστάται αν χρειάζεστε μια προσαρμοσμένη λογική Kotlin που αλληλεπιδρά με το σύστημα αρχείων ή άλλες APIs του Gradle, και στη συνέχεια εκτελεί μια εξωτερική εντολή.</p> </div> </div> </div> <div class="sect1"> <h2 id="_sourcekotlin">[source,kotlin]</h2> <div class="sectionbody"> <div class="paragraph"> <p>package com.yourpackage</p> </div> <div class="paragraph"> <p>import org.gradle.api.DefaultTask εισαγωγή org.gradle.api.tasks.Input import org.gradle.api.tasks.TaskAction import java.io.File</p> </div> <div class="paragraph"> <p>καθαρή κλάση OpenTestReportTask : DefaultTask() {</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-none hljs">---- ---- init { group = "verification" description = "Opens a test report in Firefox." dependsOn("check") // Assure que les rapports sont générés } @get:Input abstract var reportPath: String @TaskAction fun openReport() { val separator = File.separator val reportFile = project.layout.projectDirectory.asFile.toPath() .resolve(reportPath.replace("/", separator)) .toAbsolutePath() .toFile() if (!reportFile.exists()) { logger.warn("Report file does not exist: $reportFile. Ensure 'check' ran.") return } project.exec { commandLine("firefox", "--new-tab", reportFile.absolutePath) } logger.lifecycle("Opened test report: ${reportFile.absolutePath}") } ---- ## } \=== Συγκεκριμένες υλοποιήσεις Αυτές οι κλάσεις κληρονομούν από την αφηρημένη εργασία και προσδιορίζουν το συγκεκριμένο μονοπάτι της αναφοράς. ## [source,kotlin] πακέτο com.yourpackage abstract class ReportUnitTestsTask : OpenTestReportTask() { init { Άnoiγμα της αναφοράς ελέγχου μονάδας στο Firefox. reportPath = "build/reports/tests/test/index.html } } package com.yourpackage ## abstract class ReportFunctionalTestsTask : OpenTestReportTask() { init { description = "Opens the functional test report in Firefox." reportPath = "build/reports/tests/functionalTest/index.html" } } Καταγραφή των Εργασιών Στον`build.gradle.kts`του ρίζα του έργου σας : ## [source,kotlin] tasks.register<com.yourpackage.ReportUnitTestsTask>("reportTests") {} tasks.register<com.yourpackage.ReportFunctionalTestsTask>("reportFunctionalTests") {} \=== UML διάγραμμα των εργασιών της αναφοράς (κώδικας PlantUML) Αντιγράψτε τον κώδικα που βρίσκεται παρακάτω και επικολλήστε τον σε ένα εργαλείο που υποστηρίζει το PlantUML. ## [source,plantuml] @startuml skinparam χειρόγραφο true skinparam μονοχρωמטικό αληθές κλάση αφαίρεσης DefaultTask { } άβαρη κλάση Exec { \+ commandLine(args: String...) \+ exec() } αφηρετική κλάση OpenTestReportTask εκτείνει DefaultTask { \+ group: String = "επαλήθευση \+ περιγραφή: Συμβολο sequência? Wait I wrote Σ? Let's correct: "Συμβολοσειρά" Final: </think> \+ περιγραφή: Συμβολοσειρά \+ dependsOn("check") \+ συνοψη reportPath: String \+ openReport() : void } αφηρημένη κλάση AbstractJbakeExecTask επέκταση Exec { + ομάδα: String = "επαλήθευση \+ description: String \+ dependsOn("check") + abstract reportRelativePath: String \+ exec() : κενό } class ReportUnitTestsTask extends OpenTestReportTask { \+ reportPath: String = "build/reports/tests/test/index.html } κλάση ReportFunctionalTestsTask επεκτείνει OpenTestReportTask { \+ reportPath: String = "build/reports/tests/functionalTest/index.html } class ReportJbakeTestsTask extends AbstractJbakeExecTask { + reportRelativePath: String = "build/reports/tests/test/index.html } class ReportJbakeFunctionalTestsTask extends AbstractJbakeExecTask { \+ reportRelativePath: String = "build/reports/tests/functionalTest/index.html } OpenTestReportTask \<-- ReportUnitTestsTask OpenTestReportTask \<-- ReportFunctionalTestsTask AbstractJbakeExecTask \<-- ReportJbakeTestsTask AbstractJbakeExecTask \<-- ReportJbakeFunctionalTestsTask DefaultTask \<|-- OpenTestReportTask Εκτέλεση \<|-- AbstractJbakeExecTask DefaultTask \<|-- Exec ## @enduml \== αβστrakτική εργασία`AbstractJbakeExecTask`(κληρονόμενος από`Exec`) Αν η εργασία σας συνιστά κυρίως στην εκτέλεση μιας εξωτερικής εντολής με μεταβλητά ορίσματα, κληρονομείτε άμεσα από**Exec**είναι πιο άμεσο. ## [source,kotlin] πακέτο com.yourpackage import org.gradle.api.tasks.Exec import org.gradle.api.tasks.Input import java.io.File abstract class AbstractJbakeExecTask : Exec() { ---- init { group = "verification" description = "Opens a Jbake project report in Firefox." dependsOn("check") } @get:Input abstract var reportRelativePath: String override fun exec() { val separator = File.separator val reportFile = project.layout.projectDirectory.asFile.toPath() .resolve(reportRelativePath.replace("/", separator)) .toAbsolutePath() .toFile() if (!reportFile.exists()) { logger.warn("Report file does not exist: $reportFile. Ensure 'check' ran.") return } commandLine("firefox", "--new-tab", reportFile.absolutePath) logger.lifecycle("Attempting to open report: ${reportFile.absolutePath}") super.exec() // Appelle la méthode exec() de la super-classe Exec } ## } \=== Συγκριμένες υλοποιήσεις για`Exec` ## [source,kotlin] package com.yourpackage abstract class ReportJbakeTestsTask : AbstractJbakeExecTask() { αρχικοποίηση { description = "Άνοιγμα της αναφοράς δοκιμών μονάδας Jbake στο Firefox. reportRelativePath = "build/reports/tests/test/index.html } } πακέτο com.yourpackage ## abstract class ReportJbakeFunctionalTestsTask : AbstractJbakeExecTask() { init { description = "Ανοίγει την αναφορά των λειτουργικών δοκιμών στο Firefox." reportRelativePath = "build/reports/tests/functionalTest/index.html" } } \== Ορατότητα των Εργασιών`buildSrc` Οι εργασίες και οι κλάσεις που καθορίζετε σε**buildSrc**είναι : ***όρατα και χρησιμοποιήσιμα**γι' όλα τα έργα της κύριας κατασκευής σας (ρίζα και υπο-έργα). Για αυτό μπορείτε να χρησιμοποιήσετε`com.yourpackage.ReportUnitTestsTask`σε`allprojects { ... }`. ***Μη εκτελέσιμα**ευθείας ως εργασίες του buildSrc (για παράδειγμα,`gradle :buildSrc:reportTests`Δεν θα λειτουργούσε εάν η εργασία δεν καταγραφεί συγκεκριμένα στην`buildSrc/build.gradle.kts`).`buildSrc`είναι ένα module σύνθεσης, όχι ένα εκτελέσιμο module εφαρμογής για αυτές τις εργασίες του κύριου build. \=== Εκτέλεση αναφοράς για τα τεστ του`buildSrc`τον εαυτό του Si `buildSrc`έχει τα δικά του test και παράγει αναφορές, μπορείτε να καταχωρήσετε μια εργασία αναφοράς κατευθείαν στο`buildSrc/build.gradle.kts`(No output, as the input text to translate is empty) ## [πηγή,kotlin] π러γκινς { `kotlin-jvm` } repositories { mavenCentral() } tasks.withType\<Test\> { useJUnitPlatform() reports.html.outputLocation.set(layout.buildDirectory.dir("reports/tests")) } import com.yourpackage.ReportJbakeTestsTask // Εισάγετε την κλάση εργασίας σας tasks.register<ReportJbakeTestsTask>("reportBuildSrcTests") { // Le chemin est déjà défini dans la classe, il pointera vers les rapports de buildSrc } Θα μπορείτε να εκτελέσετε:`./gradlew :buildSrc:test`ακολουθούμενο από`./gradlew :buildSrc:reportBuildSrcTests`. Αποδέχοντες αυτές τις πρακτικές, θα δημιουργήσετε συστήματα κατασκευής Gradle σε Kotlin DSL που είναι όχι μόνο ισχυρά, αλλά και έξυπνα, μοναδικά, συντηρήσιμα και εύκολα να κατανοηθούν.</code></pre> </div> </div> </div> </div> https://cheroliv.com/blog/2025/0078_jbake_gradle_plugin_syntaxe_post.html Wed, 9 Jul 2025 00:00:00 +0000 blog/2025/0078_jbake_gradle_plugin_syntaxe_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_στόχος">Στόχος</a></li> <li><a href="#_δηλωτική_διαμόρφωση">Δηλωτική Διαμόρφωση</a></li> <li><a href="#_αρχιτεκτονική_του_plugin">Αρχιτεκτονική του plugin</a></li> <li><a href="#_ορισμός_της_επέκτασης_dsl">Ορισμός της επέκτασης DSL</a></li> <li><a href="#_ορισμός_προσαρμοσμένης_εργασίας">Ορισμός προσαρμοσμένης εργασίας</a></li> <li><a href="#_διεπαφή_gitadapter">Διεπαφή GitAdapter</a></li> <li><a href="#_συγκεκριμένη_υλοποίηση_με_το_jgit">Συγκεκριμένη υλοποίηση με το JGit</a></li> <li><a href="#_διαμόρφωση_dsl_kotlin">Διαμόρφωση DSL Kotlin</a></li> <li><a href="#_μονάδες_δοκιμών_με_mockito">Μονάδες δοκιμών με Mockito</a> <ul class="sectlevel2"> <li><a href="#_εξαρτήσεις">εξαρτήσεις</a></li> <li><a href="#_δοκιμή_της_συμπεριφοράς_του_git">Δοκιμή της συμπεριφοράς του Git</a></li> </ul> </li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> <li><a href="#_επόμενα_βήματα">Επόμενα βήματα</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>Αυτό το άρθρο παρουσιάζει τη πλήρη διαδικασία σχεδίασης και δοκιμών (TDD) ενός plugin Gradle γραμμένου σε Kotlin DSL. Αυτό το plugin αυτοματοποιεί τη δημιουργία στατικών ιστότοπων με το <strong>JBake</strong> και τη <strong>διαδικασία ανάπτυξης Git</strong> μέσω του <strong>JGit</strong>, όλα από ένα αρχείο YAML ρυθμίσεων.</p> </div> </div> </div> <div class="sect1"> <h2 id="_στόχος">Στόχος</h2> <div class="sectionbody"> <div class="paragraph"> <p>Δημιουργήστε ένα πρόσθετό Gradle:</p> </div> <div class="ulist"> <ul> <li> <p>ρυθμίσιμο σε Kotlin DSL ;</p> </li> <li> <p>Μπορεί να :</p> </li> <li> <p>δημιουργήστε ένα στατικό ιστότοπο από το JBake ;</p> </li> <li> <p>ανάπτυξη σε ένα απομακρυσμένο αποθετήριο Git μέσω JGit ;</p> </li> <li> <p>συμβατός με ένα workflow CI/CD;</p> </li> <li> <p>ελεγμένο σύμφωνα με μια προσέγγιση TDD.</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_δηλωτική_διαμόρφωση">Δηλωτική Διαμόρφωση</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτό είναι ένα παράδειγμα ρύθμισης YAML που θα μοντελοποιηθεί στον DSL μας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-yaml hljs" data-lang="yaml">bake: srcPath: "./site/jbake" destDirPath: "bake" pushPage: from: "bake" to: "cvs" repo: name: "trainings" repository: "https://github.com/pages-content/trainings.git" credentials: username: "USERNAME" password: "SECRET_TOKEN" branch: "main" message: "cheroliv.com"</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η ρύθμιση παρουσιάζεται μέσω μιας επέκτασης Gradle που είναι δηλώσιμη σε Kotlin DSL.</p> </div> </div> </div> <div class="sect1"> <h2 id="_αρχιτεκτονική_του_plugin">Αρχιτεκτονική του plugin</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="./images/jbake-asciidoctor-class-diagram.png" alt="jbake asciidoctor class diagram" width="568" height="261"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ορισμός_της_επέκτασης_dsl">Ορισμός της επέκτασης DSL</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">open class WorkspaceEngineExtension { var outputDir: String = "build/site" var template: String = "freemarker" var repoUrl: String = "" var branch: String = "main" var message: String = "Generated by engine" }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ορισμός_προσαρμοσμένης_εργασίας">Ορισμός προσαρμοσμένης εργασίας</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">abstract class GenerateSiteTask : DefaultTask() { lateinit var gitAdapter: GitAdapter @get:Input abstract val repoUrl: Property<String> @get:InputDirectory abstract val outputDir: DirectoryProperty @get:Input abstract val branch: Property<String> @get:Input abstract val message: Property<String> @TaskAction fun run() { val repo = gitAdapter.cloneRepository(repoUrl.get(), outputDir.get().asFile) gitAdapter.commitAndPush(repo, branch.get(), message.get()) } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διεπαφή_gitadapter">Διεπαφή GitAdapter</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">interface GitAdapter { fun cloneRepository(uri: String, directory: File): Repository fun commitAndPush(repo: Repository, branch: String, message: String) }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συγκεκριμένη_υλοποίηση_με_το_jgit">Συγκεκριμένη υλοποίηση με το JGit</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class JGitAdapter : GitAdapter { override fun cloneRepository(uri: String, directory: File): Repository { return Git.cloneRepository() .setURI(uri) .setDirectory(directory) .call() .repository } override fun commitAndPush(repo: Repository, branch: String, message: String) { Git(repo).use { it.add().addFilepattern(".").call() it.commit().setMessage(message).call() it.push().call() } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διαμόρφωση_dsl_kotlin">Διαμόρφωση DSL Kotlin</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">workspaceEngine { outputDir = "build/out" template = "freemarker" repoUrl = "https://github.com/cheroliv/trainings.git" branch = "main" message = "deploy from plugin" }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_μονάδες_δοκιμών_με_mockito">Μονάδες δοκιμών με Mockito</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_εξαρτήσεις">εξαρτήσεις</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">testImplementation("org.mockito:mockito-core:5.12.0") testImplementation("org.mockito.kotlin:mockito-kotlin:5.2.1") testImplementation("org.junit.jupiter:junit-jupiter:5.10.0")</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_δοκιμή_της_συμπεριφοράς_του_git">Δοκιμή της συμπεριφοράς του Git</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class GenerateSiteTaskMockitoTest { @TempDir lateinit var tempDir: File @Test fun `task should call clone and commitAndPush`() { val project = ProjectBuilder.builder().build() val task = project.tasks.create("generateSite", GenerateSiteTask::class.java) val mockGitAdapter = mock<GitAdapter>() val mockRepo = mock<Repository>() whenever(mockGitAdapter.cloneRepository(any(), any())).thenReturn(mockRepo) task.gitAdapter = mockGitAdapter task.repoUrl.set("https://github.com/cheroliv/test.git") task.outputDir.set(project.layout.projectDirectory.dir(tempDir.name)) task.branch.set("main") task.message.set("test commit") task.run() verify(mockGitAdapter).cloneRepository(eq("https://github.com/cheroliv/test.git"), any()) verify(mockGitAdapter).commitAndPush(eq(mockRepo), eq("main"), eq("test commit")) } }</code></pre> </div> </div> <div class="imageblock"> <div class="content"> <img src="./images/jbake-asciidoctor-sequence-diagram.png" alt="jbake asciidoctor sequence diagram" width="913" height="326"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η διαχωρισμός των ευθυνών μέσω`GitAdapter`επιτρέπει την πλήρη εφαρμογή του TDD στην ανάπτυξη προσθέτων Gradle :</p> </div> <div class="ulist"> <ul> <li> <p>Οι κλήσεις Git είναι αφηρημένες και δοκιμάσιμες;</p> </li> <li> <p>Η ρύθμιση DSL είναι καθαρή και σαφής;</p> </li> <li> <p>το plugin παραμένει αγνωστικό της πραγματικής υλοποίησης.</p> </li> </ul> </div> <div class="paragraph"> <p>Αυτή η προσέγγιση εξασφαλίζει υψηλή δοκιμασιμότητα και επεκτασιμότητα (π.χ. GitHub API, GitLab, κλπ.).</p> </div> </div> </div> <div class="sect1"> <h2 id="_επόμενα_βήματα">Επόμενα βήματα</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Ενσωμάτωση της γεννήσης JBake ως ένα`BakeAdapter`</p> </li> <li> <p>Προσθέστε δοκιμές ενσωμάτωσης με`GradleRunner`</p> </li> <li> <p>Υποστήριξη αυτόματης φόρτωσης αρχείων`site.yml`Μέσω SnakeYAML</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2025/0077_asciidoc_syntaxe_post.html Fri, 20 Jun 2025 00:00:00 +0000 blog/2025/0077_asciidoc_syntaxe_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_τι_είναι_το_asciidoc">Τι είναι το AsciiDoc;</a> <ul class="sectlevel2"> <li><a href="#_γιατί_να_επιλέξετε_το_asciidoc">Γιατί να επιλέξετε το AsciiDoc;</a></li> </ul> </li> <li><a href="#_διάγραμμα_περίπτωσης_χρήσης_use_case">Διάγραμμα περίπτωσης χρήσης (Use Case)</a></li> <li><a href="#_διάγραμμα_mind_map">Διάγραμμα Mind Map</a></li> <li><a href="#_διάγραμμα_ροής_ροή">Διάγραμμα ροής (ροή)</a></li> <li><a href="#_βασική_δομή_ενός_αρχείου_asciidoc">Βασική δομή ενός αρχείου AsciiDoc</a></li> <li><a href="#_βασική_σύνταξη">Βασική σύνταξη</a> <ul class="sectlevel2"> <li><a href="#_τίτλοι_και_ενότητες">Τίτλοι και ενότητες</a></li> <li><a href="#_κείμενο_έντονο_πλάγιο_και_μονότονο">Κείμενο έντονο, πλάγιο και μονότονο</a></li> <li><a href="#_λιστές_με_σύμβολα_και_αριθμημένες">Λιστές με σύμβολα και αριθμημένες</a></li> <li><a href="#_σύνδεσμοι_και_εικόνες">Σύνδεσμοι και εικόνες</a></li> <li><a href="#_μπλοκ_κώδικα">μπλοκ κώδικα</a></li> <li><a href="#_πίνακες">Πίνακες</a></li> <li><a href="#_σημειώσεις_και_προειδοποιήσεις">Σημειώσεις και προειδοποιήσεις</a></li> </ul> </li> <li><a href="#_χρήση_ιδιοτήτων_και_μεταβλητών">Χρήση ιδιοτήτων και μεταβλητών</a></li> <li><a href="#_συχνές_περιπτώσεις_χρήσης">Συχνές περιπτώσεις χρήσης</a></li> <li><a href="#_καλές_πρακτικές">Καλές πρακτικές</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> <li><a href="#_για_να_πάει_περαιτέρω">Για να πάει περαιτέρω</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title"><em>στ? :</em> Πρόγραμματιστές, τεχνικοί συγγραφείς, και όποιος θέλει να γράψει τεχνική τεκμηρίωση ή πλούσια άρθρα.</div> <p>Το AsciiDoc είναι μια ελαφριά γλώσσα μαρκάπιν, σχεδιασμένη για τη σύνταξη δομημένων τεχνικών εγγράφων, άρθρων, βιβλίων ή παρουσιών. Διακρίνεται από τη διαβασימότητα του, την πλούσια σύνταξή του και τη δυνατότητα να παράγει διάφορες μορφές (HTML, PDF, DocBook κ.λπ.). Σε αυτό το άρθρο, θα εξετάσουμε τη βασική σύνταξη του AsciiDoc και θα προτείνουμε συμβουλές για γρήγορη εξοικείωση.</p> </div> </div> </div> <div class="sect1"> <h2 id="_τι_είναι_το_asciidoc">Τι είναι το AsciiDoc;</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το AsciiDoc είναι μια γλώσσα περιγραφής εγγράφων, παρόμοια με το Markdown αλλά πιο ισχυρή. Επιτρέπει την αποτελεσματική δομή κειμένων, τίτλων, λιστών, πινάκων, μπλοκ κώδικα και πολλά άλλα. Η ευελιξία του το καθιστά δημοφιλή επιλογή για τεκμηρίωση έργων open source, τη σύνταξη βιβλίων και τη διαδικτυακή δημοσίευση.</p> </div> <div class="sect2"> <h3 id="_γιατί_να_επιλέξετε_το_asciidoc">Γιατί να επιλέξετε το AsciiDoc;</h3> <div class="olist arabic"> <ol class="arabic"> <li> <p>Ανάγνωσιμη και εύκολη σύνταξη.</p> </li> <li> <p>Υποστήριξη εγγενής για πολύπλοκες δομές (πίνακες, σημειώσεις, προειδοποιήσεις, κ.λ.π.).</p> </li> <li> <p>Παραγωγή πολλαπλών μορφών (HTML, PDF, ePub, DocBook…).</p> </li> <li> <p>Εύκολη ενσωμάτωση με γεννήτριες στατικών ιστότοπων όπως JBake ή Antora</p> </li> <li> <p>Προηγμένη προσαρμογή με τα χαρακτηριστικά και τα επεκτάσεις.</p> </li> </ol> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διάγραμμα_περίπτωσης_χρήσης_use_case">Διάγραμμα περίπτωσης χρήσης (Use Case)</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ένα διάγραμμα περιπτώσεων χρήσης επιτρέπει να παρουσιάζει τις κύριες αλληλεπιδράσεις μεταξύ των χρηστών και του συστήματος. Εδώ είναι ένα απλό παράδειγμα για ένα σύστημα τεκμηρίωσης:</p> </div> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-381f40e6e0660c0c53433ff054330b76.png" alt="Diagram" width="423" height="258"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διάγραμμα_mind_map">Διάγραμμα Mind Map</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το mind map (χάρτης σκέψης) είναι ιδεανικό για την εξερεύνηση των έννοιων που σχετίζονται με το AsciiDoc και τις σχέσεις τους :</p> </div> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-e1560e9cc014158b6fbeed1e5ad8e138.png" alt="Diagram" width="394" height="527"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_διάγραμμα_ροής_ροή">Διάγραμμα ροής (ροή)</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ένα διάγραμμα ροής επιτρέπει να περιγράψει τη διαδικασία δημιουργίας ενός εγγράφου AsciiDoc:</p> </div> <div class="imageblock"> <div class="content"> <img src="diag-plantuml-md5-51318d77b9e18062d3a9b751587670ae.png" alt="Diagram" width="299" height="361"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_βασική_δομή_ενός_αρχείου_asciidoc">Βασική δομή ενός αρχείου AsciiDoc</h2> <div class="sectionbody"> <div class="paragraph"> <p>Ένα αρχείο AsciiDoc αρχίζει συνήθως με έναν τίτλο, προαιρετικά χαρακτηριστικά, έπειτα το δομημένο περιεχόμενο. Παρακάτω είναι ένα ελάχιστό παράδειγμα :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Titre Principal Auteur 2024-09-03 :toc: :icons: font Votre contenu commence ici...</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_βασική_σύνταξη">Βασική σύνταξη</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_τίτλοι_και_ενότητες">Τίτλοι και ενότητες</h3> <div class="paragraph"> <p>Το AsciiDoc υποστηρίζει πολλά επίπεδα τίτλων :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">= Titre de niveau 1 == Titre de niveau 2 === Titre de niveau 3 ==== Titre de niveau 4</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_κείμενο_έντονο_πλάγιο_και_μονότονο">Κείμενο έντονο, πλάγιο και μονότονο</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">*gras* _italique_ `monospace`</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_λιστές_με_σύμβολα_και_αριθμημένες">Λιστές με σύμβολα και αριθμημένες</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">* Élément 1 * Élément 2 . Premier . Deuxième . Troisième</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_σύνδεσμοι_και_εικόνες">Σύνδεσμοι και εικόνες</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">Lien standard : https://asciidoc.org[AsciiDoc] Image : image::images/logo.png[AsciiDoc Logo]</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_μπλοκ_κώδικα">μπλοκ κώδικα</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">[source,python]</code></pre> </div> </div> <div class="paragraph"> <p>def hello(): print("Γεια σου AsciiDoc !")</p> </div> </div> <div class="sect2"> <h3 id="_πίνακες">Πίνακες</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">|=== | Colonne 1 | Colonne 2 | Valeur A | Valeur B | Valeur C | Valeur D |===</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_σημειώσεις_και_προειδοποιήσεις">Σημειώσεις και προειδοποιήσεις</h3> <div class="paragraph"> <p>Το AsciiDoc προσφέρει μπλοκ πληροφορίας οπτικής :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">NOTE: Ceci est une note importante. TIP: Conseil utile pour l’utilisateur. WARNING: Attention à ce point.</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_χρήση_ιδιοτήτων_και_μεταβλητών">Χρήση ιδιοτήτων και μεταβλητών</h2> <div class="sectionbody"> <div class="paragraph"> <p>Τα προσαρμοσμένα χαρακτηριστικά επιτρέπουν την επαναχρησιμοποίηση τιμών ή τη διαμόρφωση συμπεριφορών:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-asciidoc hljs" data-lang="asciidoc">:project-name: AsciiDoc Explorer Le projet s’appelle {project-name}.</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συχνές_περιπτώσεις_χρήσης">Συχνές περιπτώσεις χρήσης</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Τεκμηρίωση έργου ανοιχτού κώδικα (README, τεχνικοί οδηγούς) - Σύνταξη βιβλίων και ebooks - Αυτόματη δημιουργία στατικών ιστοσελίδων (JBake, Antora) - Τεχνικές παρουσιάσεις</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_καλές_πρακτικές">Καλές πρακτικές</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Χρησιμοποιήστε συνεπείς τίτλους και αυτόματο πίνακα περιεχομένων (:toc:). - Προτιμήστε τις προειδοποιήσεις για να εστιάσετε την προσοχή στα βασικά σημεία. - Οργανώστε τα αρχεία σας για να διευκολύσετε τη συντήρηση. - Χρησιμοποιήστε τα σχολιασμένα μπλοκ κώδικα για να απεικονίσετε παραδείγματα.</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το AsciiDoc είναι ένα ισχυρό και προσβάσιμο εργαλείο για τη συγγραφή τεκμηρίωσης τεχνικού περιεχομένου ή δομημένου άρθρου. Η πλούσια σύνταξή του, συνδυασμένη με τη δημιουργία πολλαπλών μορφών, το καθιστά έναν εξαιρετικό σύμμαχον για προγραμματιστές και γραφείς που απαιτούν υψηλή ποιότητα. Δοκιμάστε το AsciiDoc στο επόμενο σας έργο και ανακαλύψτε τη διαφορά!</p> </div> </div> </div> <div class="sect1"> <h2 id="_για_να_πάει_περαιτέρω">Για να πάει περαιτέρω</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Τεκμηρίωση επίσημη: <a href="https://asciidoc.org" class="bare">https://asciidoc.org</a> - Asciidoctor : <a href="https://asciidoctor.org" class="bare">https://asciidoctor.org</a> - JBake και AsciiDoc : <a href="https://jbake.org/docs/2.6.4/#asciidoc_support" class="bare">https://jbake.org/docs/2.6.4/#asciidoc_support</a></p> </li> </ul> </div> <div class="paragraph"> <p>Κοινοποιήστε τις εμπειρίες σας και τις συμβουλές σας σε σχόλιο!</p> </div> </div> </div> https://cheroliv.com/blog/2025/0076_port_forwarding_post.html Wed, 28 May 2025 00:00:00 +0000 blog/2025/0076_port_forwarding_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_το_πρόβλημα_nat_και_ιδιωτικές_διευθύνσεις">Το πρόβλημα: NAT και ιδιωτικές διευθύνσεις</a></li> <li><a href="#_βήμα_1_αναγνωρίστε_τη_δημόσια_ip_διεύθυνσή_σας">Βήμα 1: Αναγνωρίστε τη δημόσια IP διεύθυνσή σας</a></li> <li><a href="#_βήμα_2_γνωρίζετε_τη_διεύθυνση_ip_τοπικού_δικτύου_του_ubuntu_υπολογιστή_σας">Βήμα 2: Γνωρίζετε τη διεύθυνση IP τοπικού δικτύου του Ubuntu υπολογιστή σας</a></li> <li><a href="#_βήμα_3_ρυθμίστε_τη_μεταφορά_θύρας_στο_router_σας">Βήμα 3: Ρυθμίστε τη μεταφορά θύρας στο router σας</a> <ul class="sectlevel2"> <li><a href="#_πρόσβαση_στη_διεπαφή_διαχείρισης">Πρόσβαση στη διεπαφή διαχείρισης</a></li> <li><a href="#_ρυθμιστική_της_ανακατεύθυνσης">�Ρυθμιστική της ανακατεύθυνσης</a></li> </ul> </li> <li><a href="#_βήμα_4_διαμόρφωση_της_υπηρεσίας_στο_ubuntu">Βήμα 4 : Διαμόρφωση της υπηρεσίας στο Ubuntu</a></li> <li><a href="#_βήμα_5_ρύθμιση_του_τείχους_πυróυ_ubuntu">Βήμα 5 : Ρύθμιση του τείχους πυróυ Ubuntu</a></li> <li><a href="#_βήμα_6_δοκιμή_και_επικύρωση">Βήμα 6 : Δοκιμή και επικύρωση</a> <ul class="sectlevel2"> <li><a href="#_δοκιμή_από_το_τοπικό_δίκτυο">Δοκιμή από το τοπικό δίκτυο</a></li> <li><a href="#_δοκιμή_από_έξω">Δοκιμή από έξω</a></li> </ul> </li> <li><a href="#_καλές_πρακτικές_και_ασφάλεια">Καλές πρακτικές και ασφάλεια</a> <ul class="sectlevel2"> <li><a href="#_βασική_ασφάλεια">Βασική ασφάλεια</a></li> <li><a href="#_παρακολούθηση_συνδέσεων">Παρακολούθηση συνδέσεων</a></li> <li><a href="#_χρήση_ενός_reverse_proxy">Χρήση ενός reverse proxy</a></li> </ul> </li> <li><a href="#_στήν_προώθηση_θυρών">Στήν προώθηση θυρών</a> <ul class="sectlevel2"> <li><a href="#_λύσεις_cloud">Λύσεις cloud</a></li> <li><a href="#_vps_και_reverse_proxy">VPS και reverse proxy</a></li> </ul> </li> <li><a href="#_ανίχνευση_προβλημάτων">Ανίχνευση προβλημάτων</a> <ul class="sectlevel2"> <li><a href="#_συνηθισμένα_προβλήματα">Συνηθισμένα προβλήματα</a></li> <li><a href="#_διαγνωστικό_δίκτυου">Διαγνωστικό δίκτυου</a></li> </ul> </li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div id="preamble"> <div class="sectionbody"> <div class="ulist"> <div class="title">Στόχος : Μέσος</div> <ul> <li> <p><strong>Υποτιθέμενες προϋποθέσεις</strong> : Βασικές γνώσεις στο Ubuntu, το τερματικό, βασικές δικτυακές έννοιες</p> </li> <li> <p><strong>Τεχνικές έννοιες</strong> : NAT, προώθηση θύρας, ταχείο προστασίας, αντίστροπροxy</p> </li> <li> <p><strong>Συστήματικές εντολές</strong> : χρήση του τερματικού, διαμόρφωση δικτύου</p> </li> <li> <p><strong>Προχωρημένες ενότητες</strong> : παρακολούθηση, ασφάλεια, εναλλακτικές cloud</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_το_πρόβλημα_nat_και_ιδιωτικές_διευθύνσεις">Το πρόβλημα: NAT και ιδιωτικές διευθύνσεις</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Πρόβλημα : Αναπτύσσετε μια εφαρμογή web στον υπολογιστή σας Ubuntu και θέλετε να την κάνετε προσβάσιμη από έξω από το δίκτυο σπιτιού σας; Είστε στο σωστό μέρος! Στο άρθρο αυτό, θα δούμε πώς να εκθέσουμε μια τοπική υπηρεσία (για παράδειγμα στη θύρα 8080) στο Internet ρυθμίζοντας την προώθηση θυρών στο router σας.</div> <p>Καθ' ορισμού, το router internet σας χρησιμοποιεί το NAT (Network Address Translation) για να μοιράσει μια μόνο δημόσια διεύθυνση IP μεταξύ όλων των συσκευών του δίκτυου σας στο σπίτι. Οι τοπικές μηχανές σας χρησιμοποιούν ιδιωτικές διευθύνσεις IP (192.168.x.x, 10.x.x.x κλπ.) που δεν είναι διαδρόμησιμες στο Internet.</p> </div> <div class="paragraph"> <p>�Όταν ξεκινάτε μια υπηρεσία στην Ubuntu μηχανή σας (π.χ. ένα web server στην θύρα 8080), είναι προσπελάσιμο μόνο από το τοπικό δίκτυό σας. Για να το κάνουμε προσπελάσιμο από το Διαδίκτυο, πρέπει να ρυθμίσουμε μια προώθηση θύρας.</p> </div> </div> </div> <div class="sect1"> <h2 id="_βήμα_1_αναγνωρίστε_τη_δημόσια_ip_διεύθυνσή_σας">Βήμα 1: Αναγνωρίστε τη δημόσια IP διεύθυνσή σας</h2> <div class="sectionbody"> <div class="paragraph"> <p>Πρώτον, ας ανακτήσουμε τη δημόσια διεύθυνση IP της σύνδεσής σας στο Internet:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Plusieurs méthodes au choix curl ifconfig.me curl ipecho.net/plain wget -qO- http://ipecho.net/plain # Ou encore curl -s checkip.amazonaws.com</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η διεύθυνση IP είναι αυτή που οι χρήστες του Διαδικτύου θα χρησιμοποιήσουν για να έχουν πρόσβαση στην υπηρεσία σας.</p> </div> </div> </div> <div class="sect1"> <h2 id="_βήμα_2_γνωρίζετε_τη_διεύθυνση_ip_τοπικού_δικτύου_του_ubuntu_υπολογιστή_σας">Βήμα 2: Γνωρίζετε τη διεύθυνση IP τοπικού δικτύου του Ubuntu υπολογιστή σας</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η μηχανή σας Ubuntu έχει μια ιδιωτική διεύθυνση IP στο τοπικό δίκτυό σας. Για να τη γνωρίζετε:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Afficher toutes les interfaces réseau ip addr show # Ou plus spécifiquement pour l'interface principale ip route get 1.1.1.1 | awk '{print $7; exit}' # Alternative avec hostname hostname -I | awk '{print $1}'</code></pre> </div> </div> <div class="paragraph"> <p>Σημειώστε αυτή τη διεύθυνση (για παράδειγμα`192.168.1.100`), θα χρειαστεί για τη ρύθμιση.</p> </div> </div> </div> <div class="sect1"> <h2 id="_βήμα_3_ρυθμίστε_τη_μεταφορά_θύρας_στο_router_σας">Βήμα 3: Ρυθμίστε τη μεταφορά θύρας στο router σας</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η ρύθμιση ποικίlei ανάλογα με το μοντέλο της κουτιάς σας, αλλά η αρχή παραμένει η ίδια :</p> </div> <div class="sect2"> <h3 id="_πρόσβαση_στη_διεπαφή_διαχείρισης">Πρόσβαση στη διεπαφή διαχείρισης</h3> <div class="paragraph"> <p>Άνοιξτε τον περιηγητή σας και πηγαίνετε στην διεπαφή web του box σας:</p> </div> <div class="ulist"> <ul> <li> <p><strong>Freebox</strong> : <code>192.168.1.1</code> ou <code>mafreebox.freebox.fr</code></p> </li> <li> <p><strong>Livebox Orange</strong>:`192.168.1.1`</p> </li> <li> <p><strong>SFR Box</strong>:`192.168.1.1`</p> </li> <li> <p><strong>Bbox Bouygues</strong>:`192.168.1.254`</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_ρυθμιστική_της_ανακατεύθυνσης">�Ρυθμιστική της ανακατεύθυνσης</h3> <div class="paragraph"> <p>Αναζητήστε την ενότητα που είναι αφιωμένη στην προώθηση θυρών (οι ονόματα διαφέρουν):</p> </div> <div class="ulist"> <ul> <li> <p>Προώθηση θυρών</p> </li> <li> <p>NAT/PAT</p> </li> <li> <p>Προώθηση Θύρας</p> </li> <li> <p>Σέρβερ παιχνιδιών</p> </li> </ul> </div> <div class="paragraph"> <p>Δημιουργήστε έναν νέο κανόνα με αυτές τις ρυθμίσεις :</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 25%;"> <col style="width: 75%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">πεδίο</th> <th class="tableblock halign-left valign-top">Αξία</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Όνομα/Περιγραφή</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Υπηρεσία Ιστού Ubuntu" (ή άλλος ρητός όρος)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Εξωτερικός θύρα (ή δημόσια θύρα)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">8080</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Εσωτερική διεύθυνση IP</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Η διεύθυνση IP του υπολογιστή σας Ubuntu (π.χ.: 192.168.1.100)</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Εσωτερική θύρα (ή ιδιωτική θύρα)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">8080</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Πρωτόκολλο</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">TCP</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">κατάσταση</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ενεργό</p></td> </tr> </tbody> </table> </div> </div> </div> <div class="sect1"> <h2 id="_βήμα_4_διαμόρφωση_της_υπηρεσίας_στο_ubuntu">Βήμα 4 : Διαμόρφωση της υπηρεσίας στο Ubuntu</h2> <div class="sectionbody"> <div class="paragraph"> <p>Βεβαιωθείτε ότι η υπηρεσία σας ακούει σε όλες τις διεπαφές, όχι μόνο στο localhost:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># ✅ Correct : écoute sur toutes les interfaces python3 -m http.server 8080 --bind 0.0.0.0 # ❌ Incorrect : écoute seulement en local python3 -m http.server 8080 --bind 127.0.0.1</code></pre> </div> </div> <div class="paragraph"> <p>Για να ελέγξετε ότι η υπηρεσία σας ακούει σωστά :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Vérifier les ports en écoute sudo netstat -tlnp | grep :8080 # ou avec ss (plus moderne) sudo ss -tlnp | grep :8080</code></pre> </div> </div> <div class="paragraph"> <p>�Θα πρέπει να δεις κάτι όπως`0.0.0.0:8080`και όχι`127.0.0.1:8080`.</p> </div> </div> </div> <div class="sect1"> <h2 id="_βήμα_5_ρύθμιση_του_τείχους_πυróυ_ubuntu">Βήμα 5 : Ρύθμιση του τείχους πυróυ Ubuntu</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το Ubuntu χρησιμοποιεί το UFW (Uncomplicated Firewall) ως προεπιλογή. Ελέγξτε την κατάσταση και επιτρέψτε την πόρτα αν είναι απαραίτητο:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Vérifier le statut du pare-feu sudo ufw status # Si le pare-feu est actif, autoriser le port 8080 sudo ufw allow 8080/tcp # Ou plus spécifiquement pour un service web sudo ufw allow 'Apache' # si vous utilisez Apache sudo ufw allow 'Nginx Full' # si vous utilisez Nginx</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_βήμα_6_δοκιμή_και_επικύρωση">Βήμα 6 : Δοκιμή και επικύρωση</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_δοκιμή_από_το_τοπικό_δίκτυο">Δοκιμή από το τοπικό δίκτυο</h3> <div class="paragraph"> <p>Πρώτον, δοκιμάστε τη πρόσβαση από άλλη μηχανή του τοπικού δίκτυου σας:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Remplacez par l'IP locale de votre machine Ubuntu curl http://192.168.1.100:8080</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_δοκιμή_από_έξω">Δοκιμή από έξω</h3> <div class="paragraph"> <p>Τώρα, δοκιμάστε από το Internet χρησιμοποιώντας τη δημόσια IP σας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Remplacez par votre IP publique curl http://VOTRE_IP_PUBLIQUE:8080</code></pre> </div> </div> <div class="paragraph"> <p>Μπορείτε να χρησιμοποιήσετε διαδικτυακά εργαλεία όπως :</p> </div> <div class="ulist"> <ul> <li> <p><a href="https://www.yougetsignal.com/tools/open-ports/" class="bare">https://www.yougetsignal.com/tools/open-ports/</a></p> </li> <li> <p><a href="https://canyouseeme.org/" class="bare">https://canyouseeme.org/</a></p> </li> </ul> </div> </div> </div> </div> <div class="sect1"> <h2 id="_καλές_πρακτικές_και_ασφάλεια">Καλές πρακτικές και ασφάλεια</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_βασική_ασφάλεια">Βασική ασφάλεια</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Configurer fail2ban pour protéger contre les attaques par force brute sudo apt update && sudo apt install fail2ban # Limiter l'accès avec UFW (exemple : autoriser seulement certaines IP) sudo ufw allow from 203.0.113.0/24 to any port 8080</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_παρακολούθηση_συνδέσεων">Παρακολούθηση συνδέσεων</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Surveiller les connexions en temps réel sudo netstat -an | grep :8080 # Logs des connexions (selon votre application) sudo tail -f /var/log/nginx/access.log # pour Nginx sudo journalctl -f -u your-service # pour un service systemd</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_χρήση_ενός_reverse_proxy">Χρήση ενός reverse proxy</h3> <div class="paragraph"> <p>Για καλύτερη ασφάλεια και ευελιξία, εξετάστε τη χρήση ενός αντίστροφου proxy όπως το Nginx:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-nginx" data-lang="nginx">server { listen 80; server_name votre-domaine.com; location / { proxy_pass http://localhost:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; } }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_στήν_προώθηση_θυρών">Στήν προώθηση θυρών</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_λύσεις_cloud">Λύσεις cloud</h3> <div class="ulist"> <ul> <li> <p><strong>ngrok</strong>προσωρινό ασφαλές τόνελ</p> </li> <li> <p><strong>Cloudflare Tunnel</strong>: δωρεάν και ασφαλής λύση</p> </li> <li> <p><strong>serveo.net</strong>: απλός SSH tunnel</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Exemple avec ngrok ngrok http 8080 # Exemple avec serveo ssh -R 80:localhost:8080 serveo.net</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_vps_και_reverse_proxy">VPS και reverse proxy</h3> <div class="paragraph"> <p>Σκεφτείτε τη χρήση ενός VPS με έναν αντίστροφο πρόξυ που κατευθύνει προς την τοπική υποδομή σας μέσω VPN.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ανίχνευση_προβλημάτων">Ανίχνευση προβλημάτων</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_συνηθισμένα_προβλήματα">Συνηθισμένα προβλήματα</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 40%;"> <col style="width: 60%;"> </colgroup> <thead> <tr> <th class="tableblock halign-left valign-top">Πρόβλημα</th> <th class="tableblock halign-left valign-top">Λύση</th> </tr> </thead> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Υπηρεσία μη προσβάσιμη από το εξωτερικό</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ελέγξτε τη ρύθμιση προώθησης θύρας και ότι η υπηρεσία ακούει στη 0.0.0.0</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Η σύνδεση απορρίφθηκε</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Η υπηρεσία δεν είναι εκκινημένη ή ακούει μόνο στη 127.0.0.1</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Λήξη χρόνου σύνδεσης</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Πρόβλημα τείχους προστασίας (box ή Ubuntu) ή κακώς ρυθμισμένο port forwarding</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Η δημόσια IP αλλάζει τακτικά</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ρυθμίστε ένα δυναμικό DNS (DynDNS, No-IP, κλπ.)</p></td> </tr> </tbody> </table> </div> <div class="sect2"> <h3 id="_διαγνωστικό_δίκτυου">Διαγνωστικό δίκτυου</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"># Tester la connectivité locale telnet localhost 8080 # Tester depuis une autre machine du réseau telnet 192.168.1.100 8080 # Vérifier les routes réseau ip route show # Analyser le trafic réseau sudo tcpdump -i any port 8080</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η έκθεση μιας τοπικής υπηρεσίας στο Διαδίκτυο απαιτεί προσεκτική ρύθμιση της προώθησης θυρών, της ασφάλειας και της παρακολούθησης. Ανچه αυτή η προσέγγιση είναι τέλεια για ανάπτυξη ή προσωπικά έργα, σκεφτείτε τις πιο ισχυρές εναλλακτικές (VPS, CDN, υπηρεσίες cloud) για χρήση σε παραγωγή.</p> </div> <div class="paragraph"> <p>Το σημαντικό είναι να θυμάστε πάντα την ασφάλεια: χρησιμοποιείτε ισχυρούς κωδικούς, ενημερώνετε τακτικά το σύστημά σας, και παρακολουθείτε την πρόσβαση στα εκτεθειμένα σας υπηρεσίες.</p> </div> <div class="paragraph"> <p>Μην διστάσετε να μοιραστείτε τις εμπειρίες σας και τις ερωτήσεις σας στα σχόλια !</p> </div> </div> </div> https://cheroliv.com/blog/2025/0099_debugging-mockito-gradle-plugin_post.html Sun, 17 Nov 2024 00:00:00 +0000 blog/2025/0099_debugging-mockito-gradle-plugin_post.html <div id="toc" class="toc"> <div id="toctitle">Table des matières</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_το_πλαίσιο_plugin_gradle_bakery">Το πλαίσιο : Plugin Gradle Bakery</a></li> <li><a href="#_πρόβλημα_1_ελέγξτε_το_λάθος_mock">Πρόβλημα #1 : Ελέγξτε το λάθος mock</a> <ul class="sectlevel2"> <li><a href="#_η_διάγνωση">Η διάγνωση</a></li> <li><a href="#_η_λύση">Η λύση</a></li> </ul> </li> <li><a href="#_πρόβλημα_2_unfinishedstubbingexception_σε_καскаδο">Πρόβλημα #2: UnfinishedStubbingException σε καскаδο</a> <ul class="sectlevel2"> <li><a href="#_η_διάγνωση_2">Η διάγνωση</a></li> <li><a href="#_η_λύση_2">Η λύση</a></li> </ul> </li> <li><a href="#_πρόβλημα_3_το_αρχείο_ρυθμίσεων_δεν_υπάρχει">Πρόβλημα #3 : Το αρχείο ρυθμίσεων δεν υπάρχει</a> <ul class="sectlevel2"> <li><a href="#_η_διάγνωση_3">Η διάγνωση</a></li> <li><a href="#_η_λύση_3">Η λύση</a></li> </ul> </li> <li><a href="#_πρόβλημα_4_afterevaluate_και_nullpointerexception">Πρόβλημα #4 : afterEvaluate και NullPointerException</a> <ul class="sectlevel2"> <li><a href="#_η_διάγνωση_4">Η διάγνωση</a></li> <li><a href="#_η_λύση_4">Η λύση</a></li> </ul> </li> <li><a href="#_η_πλήρης_λύση">Η πλήρης λύση</a></li> <li><a href="#_μαθήματα_που_έχουμε_μάθει">Μαθήματα που έχουμε μάθει</a> <ul class="sectlevel2"> <li><a href="#_1_ελέγξτε_το_σωστό_mock">1. Ελέγξτε το σωστό mock</a></li> <li><a href="#_2_αποφυγή_των_έμμεσων_mocks">2. Αποφυγή των έμμεσων mocks</a></li> <li><a href="#_3_μόκαρε_τα_callbacks_αξιολόγησης">3. Μόκαρε τα callbacks αξιολόγησης</a></li> <li><a href="#_4_δοκιμή_της_επίλυσης_των_διαδρομών">4. Δοκιμή της επίλυσης των διαδρομών</a></li> </ul> </li> <li><a href="#_τελική_δοκιμαστική_αρχιτεκτονική">Τελική δοκιμαστική αρχιτεκτονική</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> <li><a href="#_πόροι">Πόροι</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <p>Κατά την ανάπτυξη του plugin Gradle<strong>Αρτοποιείο</strong>Για το blog μου JBake, συνάντησα μια φαινομενικά απλή πρόβλημα: ένας έλεγχος μονάδας που απέτυχε με το λάθος.<code>Wanted but not invoked</code>. Το φαινόταν ένα απλό bug και έδειξε ότι είναι ένα παράδειγμα διδασκαλίας για να καταλάβουμε τις λεπτομέρειες του mocking με το Mockito και το Kotlin.</p> </div> <div class="paragraph"> <p>Στο άρθρο αυτό, σας οδηγώ σε ένα μεθοδικό ταξίδι debugging, όπου κάθε λύση αποκαλύπτει ένα νέο πρόβλημα, μέχρι την τελική λύση.</p> </div> </div> </div> <div class="sect1"> <h2 id="_το_πλαίσιο_plugin_gradle_bakery">Το πλαίσιο : Plugin Gradle Bakery</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το πρόσθετο Bakery είναι ένα wrapper γύρω από το JBake που διευκολύνει τη δημοσίευση στατικών ιστοτόπων. Αυτό είναι η απλοποιημένη δομή του:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">class BakeryPlugin : Plugin<Project> { override fun apply(project: Project) { val extension = project.extensions.create( "bakery", BakeryExtension::class.java ) project.afterEvaluate { if (!project.layout.projectDirectory.asFile .resolve(extension.configPath.get()).exists()) { println("config file does not exists") } else { // C'EST ICI QUE ÇA SE PASSE project.plugins.apply(JBakePlugin::class.java) val site = FileSystemManager.from(project, extension.configPath.get()) // Configuration de JBake... } } } }</code></pre> </div> </div> <div class="paragraph"> <p>Ο τεστ που απέτυχε ήταν απλό :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin applies jbake gradle plugin`() { val project = createMockProject() val plugin = BakeryPlugin() plugin.apply(project) verify(project.plugins).apply(JBakePlugin::class.java) }</code></pre> </div> </div> <div class="paragraph"> <p>Το σφάλμα:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">Wanted but not invoked: pluginContainer.apply(class org.jbake.gradle.JBakePlugin); Actually, there were zero interactions with this mock.</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πρόβλημα_1_ελέγξτε_το_λάθος_mock">Πρόβλημα #1 : Ελέγξτε το λάθος mock</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_η_διάγνωση">Η διάγνωση</h3> <div class="imageblock"> <div class="content"> <img src="./images/mockito-problem-1.svg" alt="mockito problem 1" width="711" height="521"> </div> </div> <div class="paragraph"> <p>Το πρόβλημα: Mockito δεν μπορεί να παρακολουθήσει τις αλληλεπιδράσεις σε`project.plugins`επειδή είναι μόνο un getter που επιστρέφει το πραγματικό mock`mockPluginContainer`. Ο έλεγχος πρέπει να γίνει άμεσα στο παράδειγμα του mock.</p> </div> </div> <div class="sect2"> <h3 id="_η_λύση">Η λύση</h3> <div class="paragraph"> <p>Τροποποίηση`createMockProject()`για να επιστρέψει τα δύο αντικείμενα :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { val mockPluginContainer = mock<PluginContainer>() val mockProject = mock<Project> { on { plugins } doReturn mockPluginContainer } return Pair(mockProject, mockPluginContainer) }</code></pre> </div> </div> <div class="paragraph"> <p>Και προσαρμόστε την δοκιμή :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin applies jbake gradle plugin`() { val (project, mockPluginContainer) = createMockProject() val plugin = BakeryPlugin() plugin.apply(project) // ✅ Vérification directe sur le bon mock verify(mockPluginContainer).apply(JBakePlugin::class.java) }</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πρόβλημα_2_unfinishedstubbingexception_σε_καскаδο">Πρόβλημα #2: UnfinishedStubbingException σε καскаδο</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_η_διάγνωση_2">Η διάγνωση</h3> <div class="paragraph"> <p>Μετά την εφαρμογή της πρώτης διόρθωσης, εμφανίστηκε ένα νέο σφάλμα:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-text hljs" data-lang="text">UnfinishedStubbingException: Unfinished stubbing detected here Hints: 3. you are stubbing the behaviour of another mock inside before 'thenReturn' instruction is completed</code></pre> </div> </div> <div class="paragraph"> <p>Το προβληματικό κώδικα χρησιμοπούσε τη σύνταξη DSL του Mockito-Kotlin :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">val mockProject = mock<Project> { on { extensions } doReturn mockExtensionContainer on { plugins } doReturn mockPluginContainer on { logger } doReturn mock() // ❌ PROBLÈME ICI ! }</code></pre> </div> </div> <div class="imageblock"> <div class="content"> <img src="./images/mockito-problem-2.svg" alt="mockito problem 2" width="690" height="316"> </div> </div> </div> <div class="sect2"> <h3 id="_η_λύση_2">Η λύση</h3> <div class="paragraph"> <p>Δημιουργώ<strong>όλοι</strong>τα mocks εκτός από κάθε μπλοκ stubbing, στη συνέχεια τα ρυθμίζουμε με`whenever()`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { // 1️⃣ Créer TOUS les mocks d'abord val mockPluginContainer = mock<PluginContainer>() val mockExtensionContainer = mock<ExtensionContainer>() val mockLogger = mock<org.gradle.api.logging.Logger>() val mockProject = mock<Project>() // 2️⃣ Configurer les mocks séparément avec whenever() whenever(mockProject.plugins).thenReturn(mockPluginContainer) whenever(mockProject.extensions).thenReturn(mockExtensionContainer) whenever(mockProject.logger).thenReturn(mockLogger) return Pair(mockProject, mockPluginContainer) }</code></pre> </div> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>Χρυσό κανόνα</strong>: Μην καλείς ποτέ`mock()`Μέσα σε ένα μπλοκ ρύθμισης mock. Πάντα δημιουργείτε τα mocks πρώτα, στη συνέχεια τα ρυθμίζετε.</p> </div> </td> </tr> </table> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πρόβλημα_3_το_αρχείο_ρυθμίσεων_δεν_υπάρχει">Πρόβλημα #3 : Το αρχείο ρυθμίσεων δεν υπάρχει</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_η_διάγνωση_3">Η διάγνωση</h3> <div class="paragraph"> <p>Ακόμη και με τους σωστούς mocks, ο έλεγχος απέτυχε συνέχεια επειδή το plugin δεν ήταν σε θέση να βρει το αρχείο ρυθμίσεων:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// Dans BakeryPlugin.kt if (!project.layout.projectDirectory.asFile .resolve(extension.configPath.get()).exists()) { println("config file does not exists") return@afterEvaluate // ❌ Sort avant d'appliquer JBake ! }</code></pre> </div> </div> <div class="imageblock"> <div class="content"> <img src="./images/mockito-problem-3.svg" alt="mockito problem 3" width="556" height="373"> </div> </div> </div> <div class="sect2"> <h3 id="_η_λύση_3">Η λύση</h3> <div class="paragraph"> <p>�Ρυθμίστε τα mocks ώστε η επίλυση του μονοπατιού να λειτουργεί:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { // ... autres mocks ... val configFile = File("../../site.yml").canonicalFile val projectDir = configFile.parentFile // Configuration cohérente des chemins whenever(mockConfigPathProperty.get()).thenReturn("site.yml") whenever(mockProjectDirectory.asFile).thenReturn(projectDir) // Maintenant : projectDir.resolve("site.yml") existe ! ✅ }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre>Failed to generate image: PlantUML preprocessing failed: [From <input> (line 16) ] @startuml rectangle "Μοκ διαμόρφωση" { card "projectDirectory.asFile" #90EE90 card "returns: /real/path/to/project" #90EE90 card "configPath.get()" #90EE90 card "αποδόσεις: site.yml" #90EE90 card "resolve()" #90EE90 card "/real/path/to/project/site.yml" #90EE90 card "import sys sys.stdout.write(sys.stdin.read())" #90EE90 ^^^^^ Syntax Error? (Assumed diagram type: activity) @startuml !define SUCCESS #90EE90 !define PROBLEM #FFB6C1 rectangle "Μοκ διαμόρφωση" { card "projectDirectory.asFile" SUCCESS card "returns: /real/path/to/project" SUCCESS card "configPath.get()" SUCCESS card "αποδόσεις: site.yml" SUCCESS card "resolve()" SUCCESS card "/real/path/to/project/site.yml" SUCCESS card "import sys sys.stdout.write(sys.stdin.read())" SUCCESS card "true ✅" SUCCESS } @enduml</pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πρόβλημα_4_afterevaluate_και_nullpointerexception">Πρόβλημα #4 : afterEvaluate και NullPointerException</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_η_διάγνωση_4">Η διάγνωση</h3> <div class="paragraph"> <p>Το πρόσθετο εφαρμόζει το JBake σε ένα μπλοκ`afterEvaluate`, και έχει πρόσβαση σε`buildDirectory.dir()`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">project.afterEvaluate { // ... project.tasks.withType(JBakeTask::class.java) .getByName("bake").apply { output = project.layout.buildDirectory .dir(site.bake.destDirPath) // ❌ NPE ici ! .get() .asFile } }</code></pre> </div> </div> <div class="paragraph"> <p>Το mock του`buildDirectory.dir()<code>επιστρέφε`null</code>.</p> </div> </div> <div class="sect2"> <h3 id="_η_λύση_4">Η λύση</h3> <div class="paragraph"> <p>να χλευάζω`afterEvaluate`για να τρέχει αμέσως, και να το ρυθμίσουμε πλήρως`buildDirectory` :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { // ... autres mocks ... val mockBuildDirectory = mock<DirectoryProperty>() val buildDir = File(projectDir, "build") // Mocker dir() pour retourner un Provider valide whenever(mockBuildDirectory.dir(any<String>())).doAnswer { invocation -> val path = invocation.arguments[0] as String val mockDirProvider = mock<Provider<Directory>>() val mockDir = mock<Directory>() whenever(mockDir.asFile).thenReturn(File(buildDir, path)) whenever(mockDirProvider.get()).thenReturn(mockDir) mockDirProvider } // Mocker afterEvaluate pour exécution immédiate whenever(mockProject.afterEvaluate(any<Action<Project>>())).doAnswer { invocation -> val action = invocation.arguments[0] as Action<Project> action.execute(mockProject) // ✅ Exécution synchrone null } return Pair(mockProject, mockPluginContainer) }</code></pre> </div> </div> <div class="imageblock"> <div class="content"> <img src="./images/after-evaluate-flow.svg" alt="after evaluate flow" width="783" height="357"> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_η_πλήρης_λύση">Η πλήρης λύση</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτή είναι η συνάρτηση`createMockProject()`τελίκη, που λύνει όλα τα προβλήματα:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">private fun createMockProject(): Pair<Project, PluginContainer> { // 1️⃣ CRÉER tous les mocks (pas de nested mocks !) val mockPluginContainer = mock<PluginContainer>() val mockExtensionContainer = mock<ExtensionContainer>() val mockLogger = mock<org.gradle.api.logging.Logger>() val mockTaskContainer = mock<TaskContainer>() val mockConfigPathProperty = mock<Property<String>>() val mockBakeryExtension = mock<BakeryExtension>() val mockProjectDirectory = mock<Directory>() val mockBuildDirectory = mock<DirectoryProperty>() val mockProjectLayout = mock<ProjectLayout>() val mockProject = mock<Project>() // 2️⃣ CONFIGURER la résolution des chemins val configFile = File("../../site.yml").canonicalFile val projectDir = configFile.parentFile val buildDir = File(projectDir, "build") whenever(mockConfigPathProperty.get()).thenReturn("site.yml") whenever(mockConfigPathProperty.isPresent).thenReturn(true) whenever(mockBakeryExtension.configPath).thenReturn(mockConfigPathProperty) whenever(mockProjectDirectory.asFile).thenReturn(projectDir) // 3️⃣ CONFIGURER buildDirectory avec dir() whenever(mockBuildDirectory.dir(any<String>())).doAnswer { invocation -> val path = invocation.arguments[0] as String val mockDirProvider = mock<Provider<Directory>>() val mockDir = mock<Directory>() whenever(mockDir.asFile).thenReturn(File(buildDir, path)) whenever(mockDirProvider.get()).thenReturn(mockDir) mockDirProvider } // 4️⃣ ASSEMBLER le projet whenever(mockProjectLayout.projectDirectory).thenReturn(mockProjectDirectory) whenever(mockProjectLayout.buildDirectory).thenReturn(mockBuildDirectory) whenever(mockExtensionContainer.create("bakery", BakeryExtension::class.java)) .thenReturn(mockBakeryExtension) whenever(mockExtensionContainer.getByType(BakeryExtension::class.java)) .thenReturn(mockBakeryExtension) whenever(mockProject.extensions).thenReturn(mockExtensionContainer) whenever(mockProject.plugins).thenReturn(mockPluginContainer) whenever(mockProject.tasks).thenReturn(mockTaskContainer) whenever(mockProject.layout).thenReturn(mockProjectLayout) whenever(mockProject.logger).thenReturn(mockLogger) whenever(mockProject.projectDir).thenReturn(projectDir) // 5️⃣ CONFIGURER afterEvaluate pour exécution immédiate whenever(mockProject.afterEvaluate(any<Action<Project>>())).doAnswer { invocation -> val action = invocation.arguments[0] as Action<Project> action.execute(mockProject) null } return Pair(mockProject, mockPluginContainer) }</code></pre> </div> </div> <div class="paragraph"> <p>Και η τελική δοκιμή που περνά:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">@Test fun `plugin applies jbake gradle plugin`() { val (project, mockPluginContainer) = createMockProject() val plugin = BakeryPlugin() plugin.apply(project) verify(mockPluginContainer).apply(JBakePlugin::class.java) // ✅ SUCCÈS ! }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_μαθήματα_που_έχουμε_μάθει">Μαθήματα που έχουμε μάθει</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="./images/lessons-learned.svg" alt="lessons learned" width="748" height="472"> </div> </div> <div class="sect2"> <h3 id="_1_ελέγξτε_το_σωστό_mock">1. Ελέγξτε το σωστό mock</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// ❌ FAUX verify(project.plugins).apply(JBakePlugin::class.java) // ✅ CORRECT val (project, mockPluginContainer) = createMockProject() verify(mockPluginContainer).apply(JBakePlugin::class.java)</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_2_αποφυγή_των_έμμεσων_mocks">2. Αποφυγή των έμμεσων mocks</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// ❌ FAUX - UnfinishedStubbingException val mockProject = mock<Project> { on { logger } doReturn mock() // Nested mock creation ! } // ✅ CORRECT - Créer séparément val mockLogger = mock<org.gradle.api.logging.Logger>() val mockProject = mock<Project>() whenever(mockProject.logger).thenReturn(mockLogger)</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_3_μόκαρε_τα_callbacks_αξιολόγησης">3. Μόκαρε τα callbacks αξιολόγησης</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// ✅ afterEvaluate doit s'exécuter pour les tests whenever(mockProject.afterEvaluate(any())).doAnswer { invocation -> val action = invocation.arguments[0] as Action<Project> action.execute(mockProject) null }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_4_δοκιμή_της_επίλυσης_των_διαδρομών">4. Δοκιμή της επίλυσης των διαδρομών</h3> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-kotlin hljs" data-lang="kotlin">// Toujours vérifier que les chemins se résolvent correctement val extension = project.extensions.getByType(BakeryExtension::class.java) val configPath = extension.configPath.get() val projectDir = project.layout.projectDirectory.asFile val resolvedConfig = projectDir.resolve(configPath) println("Resolved config: ${resolvedConfig.absolutePath}") println("Exists: ${resolvedConfig.exists()}")</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_τελική_δοκιμαστική_αρχιτεκτονική">Τελική δοκιμαστική αρχιτεκτονική</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="./images/test-architecture.svg" alt="test architecture" width="1738" height="5480"> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το που φαινόταν να είναι ένα απλό πρόβλημα δοκιμής έδειξε ότι ήταν ένα εξαιρετικό υπόθεση μελέτης για :</p> </div> <div class="ulist"> <ul> <li> <p>Οι λεπτομέρειες του Mockito με Kotlin</p> </li> <li> <p>Η σημασία του να κάνουμε mock στα σωστά αντικείμενα</p> </li> <li> <p>Η διαχείριση των ασυγχρονών callbacks στα tests</p> </li> <li> <p>Η επίλυση διαδρομών στα πρόσθετα Gradle</p> </li> </ul> </div> <div class="paragraph"> <p>Η μεθοδική αποσφαλμάτωση, κατανόοντας κάθε επίπεδο του προβλήματος, οδήγησε σε μια ανθεκτική και διατηρήσιμη λύση.</p> </div> <div class="admonitionblock tip"> <table> <tr> <td class="icon"> <i class="fa icon-tip" title="Tip"></i> </td> <td class="content"> <div class="paragraph"> <p><strong>Συμβουλή για τα τεστ σας</strong>Εάν συναντήσετε το "Wanted but not invoked" με το Mockito, πάντα ρωτήστε τον εαυτό σας: 1. Έλεγχω το σωστό mock ? 2. Είναι όλα τα mocks μου δημιουργημένα εκτός των μπλοκ ρυθμίσεων; 3. Τρέχουν πραγματικά οι callbacks μου; 4. Οι διαδρομές μου λύνονται σωστά;</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_πόροι">Πόροι</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p><a href="https://github.com/mockito/mockito-kotlin">Mockito-Kotlin Τεκμηρίωση</a></p> </li> <li> <p><a href="https://docs.gradle.org/current/userguide/custom_plugins.html">Οδηγός ανάπτυξης προσθετών Gradle</a></p> </li> <li> <p><a href="https://jbake.org/">JBake γεννητής στατικών ιστότοπων</a></p> </li> </ul> </div> <hr> <div class="paragraph"> <p>Έχετε συναντήσει προβλήματα παρόμοια στα δοκιμαστικά σας; Μοιραστείτε την εμπειρία σας στα σχόλια!</p> </div> </div> </div> https://cheroliv.com/blog/2024/0075_kotlin_arrow-traverse_right_and_left_post.html Tue, 24 Sep 2024 00:00:00 +0000 blog/2024/0075_kotlin_arrow-traverse_right_and_left_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_τι_είναι_η_μονάδα_either">Τι είναι η μονάδα Either;</a> <ul class="sectlevel2"> <li><a href="#_γιατί_να_χρησιμοποιήσουμε_το_either">Γιατί να χρησιμοποιήσουμε το Either;</a></li> </ul> </li> <li><a href="#_συγκρότηση">Συγκρότηση</a></li> <li><a href="#_οι_διαφορετικές_προσεγγίσεις">Οι διαφορετικές προσεγγίσεις</a> <ul class="sectlevel2"> <li><a href="#_η_κλασική_προσέγγιση_με_when">Η κλασική προσέγγιση με `when</a></li> <li><a href="#_χρήση_του_fold_για_μια_πιο_συντομική_προσέγγιση">Χρήση του <code>fold</code> για μια πιο συντομική προσέγγιση</a></li> <li><a href="#_μετασχηματισμός_με_map_και_mapleft">Μετασχηματισμός με <code>map</code> και `mapLeft</a></li> <li><a href="#_διαχείριση_σφαλμάτων_με_getorelse">Διαχείριση σφαλμάτων με `getOrElse</a></li> <li><a href="#_πλευρικές_ενέργειες_με_onleft_και_onright">Πλευρικές ενέργειες με <code>onLeft</code> και `onRight</a></li> <li><a href="#_συρραφή_λειτουργιών_με_flatmap">Συρραφή λειτουργιών με `flatMap</a></li> <li><a href="#_διπλεύς_μετασχηματισμός_με_το_bimap">Διπλεύς μετασχηματισμός με το `bimap</a></li> <li><a href="#_αντιστροφή_των_πλευρών_με_swap">Αντιστροφή των πλευρών με `swap</a></li> <li><a href="#_χρήση_του_tap_και_του_tapleft">Χρήση του <code>tap</code> και του <code>tapLeft</code> :</a></li> <li><a href="#_χρήση_του_recover">Χρήση του <code>recover</code>:</a></li> </ul> </li> <li><a href="#_πρακτικές_περιπτώσεις_χρήσης">Πρακτικές περιπτώσεις χρήσης</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> <li><a href="#_για_να_πάτε_πιο_μακριά">Για να πάτε πιο μακριά</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">_Στόχος κοινού : Πρόγραμματιστές Kotlin με επίπεδο από μεσαίο έως προχωρημένο.</div> <p>Στον κόσμο της συνάρτησης προγραμματισμού στην Kotlin, η βιβλιοθήκη Arrow προσφέρει ισχυρά εργαλεία για τη διαχείριση σφαλμάτων και εναλλακτικών περιπτώσεων. Μεταξύ αυτών των εργαλείων, η μονάδα`Either`διακρίνεται για τη δυνατότητά του να αντιπροσωπεύει δύο πιθανές καταστάσεις: επιτυχία (Right) ή αποτυχία (Left). Αλλά πώς μπορούμε να πλοηγηθούμε αποτελεσματικά μεταξύ αυτών των δύο καταστάσεων; Αυτό είναι αυτό που θα εξετάσουμε σε αυτό το άρθρο.</p> </div> </div> </div> <div class="sect1"> <h2 id="_τι_είναι_η_μονάδα_either">Τι είναι η μονάδα Either;</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η μονάδα`Either`είναι μια δομή δεδομένων που αντιπροσωπεύει δύο αλληλοαποκλειστικές επιλογές. Στο Kotlin με το Arrow, χρησιμοποιείται συχνά για να διαχειριστεί τις περιπτώσεις επιτυχίας και αποτυχίας μιας λειτουργίας, προσφέροντας μια ελεγαντική εναλλακτική στα παραδοσιακά εξαιρέσεις.</p> </div> <div class="sect2"> <h3 id="_γιατί_να_χρησιμοποιήσουμε_το_either">Γιατί να χρησιμοποιήσουμε το Either;</h3> <div class="olist arabic"> <ol class="arabic"> <li> <p>Εξακρίβεια διαχείρισης σφαλμάτων: Αναγκάζει τον προγραμματιστή να λάβει υπόψη τις περιπτώσεις αποτυχίας.</p> </li> <li> <p>Composition fonctionnelle : Facilite le chaînage d’opérations qui peuvent échouer.</p> </li> <li> <p>Type-safety : Τα σφάλματα είναι τυποποιημένα, πράγμα που βοηθά να τα χειρίζεται ακριβότερα</p> </li> <li> <p>Δεν υπάρχουν εξαιρέσεις: αποφεύγετε τις πρόσθετες επιπτώσεις και τις απρόσμενοι διακοπές της ροής εκτέλεσης.</p> </li> </ol> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συγκρότηση">Συγκρότηση</h2> <div class="sectionbody"> <div class="paragraph"> <p>Φανταστείτε ότι αναπτύσσετε μια API REST μεhttps://spring.io/projects/spring-boot/[Spring Boot,windows=read-later] et <a href="https://kotlinlang.org/">Kotlin</a>, χρησιμοποιώντας τη βιβλιοθήκηhttps://arrow-kt.io/[Arrow,windows=read-later]. Έχετε μια συνάρτηση`findOneUserByEmail`που επιστρέφει ένα`Either<Throwable, User>`. Πώς μπορείτε να πεdosiείτε αυτό το αποτέλεσμα με εξαιρετικό και operativo τρóπο;</p> </div> <div class="paragraph"> <p>Έχουμε μια κλάση User:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">@file:Suppress( "RemoveRedundantQualifierName", "MemberVisibilityCanBePrivate", "SqlNoDataSourceInspection" ) package webapp.users import arrow.core.Either import arrow.core.left import arrow.core.right import com.fasterxml.jackson.annotation.JsonIgnore import com.fasterxml.jackson.databind.ObjectMapper import jakarta.validation.constraints.NotNull import jakarta.validation.constraints.Pattern import jakarta.validation.constraints.Size import org.springframework.beans.factory.getBean import org.springframework.context.ApplicationContext import org.springframework.data.r2dbc.core.R2dbcEntityTemplate import org.springframework.r2dbc.core.DatabaseClient import org.springframework.r2dbc.core.awaitOne import org.springframework.r2dbc.core.awaitRowsUpdated import webapp.core.property.ANONYMOUS_USER import webapp.core.property.EMPTY_STRING import webapp.core.utils.AppUtils.cleanField import webapp.users.EntityModel.Companion.ID_MEMBER import webapp.users.User.UserDao.Attributes.EMAIL_ATTR import webapp.users.User.UserDao.Attributes.ID_ATTR import webapp.users.User.UserDao.Attributes.LANG_KEY_ATTR import webapp.users.User.UserDao.Attributes.LOGIN_ATTR import webapp.users.User.UserDao.Attributes.PASSWORD_ATTR import webapp.users.User.UserDao.Attributes.VERSION_ATTR import webapp.users.User.UserDao.Constraints.LOGIN_REGEX import webapp.users.User.UserDao.Fields.EMAIL_FIELD import webapp.users.User.UserDao.Fields.ID_FIELD import webapp.users.User.UserDao.Fields.LANG_KEY_FIELD import webapp.users.User.UserDao.Fields.LOGIN_FIELD import webapp.users.User.UserDao.Fields.PASSWORD_FIELD import webapp.users.User.UserDao.Fields.VERSION_FIELD import webapp.users.User.UserDao.Relations.INSERT import webapp.users.security.Role import webapp.users.security.Role.RoleDao import webapp.users.security.UserRole.UserRoleDao import java.util.* import jakarta.validation.constraints.Email as EmailConstraint data class User( override val id: UUID? = null, @field:NotNull @field:Pattern(regexp = LOGIN_REGEX) @field:Size(min = 1, max = 50) val login: String, @JsonIgnore @field:NotNull @field:Size(min = 60, max = 60) val password: String = EMPTY_STRING, @field:EmailConstraint @field:Size(min = 5, max = 254) val email: String = EMPTY_STRING, @JsonIgnore val roles: MutableSet<Role> = mutableSetOf(Role(ANONYMOUS_USER)), @field:Size(min = 2, max = 10) val langKey: String = EMPTY_STRING, @JsonIgnore val version: Long = -1, ) : EntityModel<UUID>() { companion object { @JvmStatic fun main(args: Array<String>) = println(UserDao.Relations.sqlScript) } object UserDao { object Constraints { // Regex for acceptable logins const val LOGIN_REGEX = "^(?>[a-zA-Z0-9!$&*+=?^_`{|}~.-]+@[a-zA-Z0-9-]+(?:\\.[a-zA-Z0-9-]+)*)|(?>[_.@A-Za-z0-9-]+)$" const val PASSWORD_MIN: Int = 4 const val PASSWORD_MAX: Int = 16 const val IMAGE_URL_DEFAULT = "https://placehold.it/50x50" const val PHONE_REGEX = "^(\\+|00)?[1-9]\\d{0,49}\$" } object Members { const val PASSWORD_MEMBER = "password" const val ROLES_MEMBER = "roles" } object Fields { const val ID_FIELD = "`id`" const val LOGIN_FIELD = "`login`" const val PASSWORD_FIELD = "`password`" const val EMAIL_FIELD = "`email`" const val LANG_KEY_FIELD = "`lang_key`" const val VERSION_FIELD = "`version`" } object Attributes { val ID_ATTR = ID_FIELD.cleanField() val LOGIN_ATTR = LOGIN_FIELD.cleanField() val PASSWORD_ATTR = PASSWORD_FIELD.cleanField() val EMAIL_ATTR = EMAIL_FIELD.cleanField() const val LANG_KEY_ATTR = "langKey" val VERSION_ATTR = VERSION_FIELD.cleanField() } object Relations { const val TABLE_NAME = "`user`" const val SQL_SCRIPT = """ CREATE TABLE IF NOT EXISTS $TABLE_NAME ( $ID_FIELD UUID default random_uuid() PRIMARY KEY, $LOGIN_FIELD VARCHAR, $PASSWORD_FIELD VARCHAR, $EMAIL_FIELD VARCHAR, $LANG_KEY_FIELD VARCHAR, $VERSION_FIELD bigint ); CREATE UNIQUE INDEX IF NOT EXISTS `uniq_idx_user_login` ON $TABLE_NAME ($LOGIN_FIELD); CREATE UNIQUE INDEX IF NOT EXISTS `uniq_idx_user_email` ON $TABLE_NAME ($EMAIL_FIELD); """ @Suppress("SqlDialectInspection") const val INSERT = """ insert into $TABLE_NAME ( $LOGIN_FIELD, $EMAIL_FIELD, $PASSWORD_FIELD, $LANG_KEY_FIELD, $VERSION_FIELD ) values ( :login, :email, :password, :langKey, :version)""" @JvmStatic val sqlScript: String get() = setOf( UserDao.Relations.SQL_SCRIPT, RoleDao.Relations.SQL_SCRIPT, UserRoleDao.Relations.SQL_SCRIPT ).joinToString("") .trimMargin() } object Dao { val Pair<User, ApplicationContext>.toJson: String get() = second.getBean<ObjectMapper>().writeValueAsString(first) suspend fun Pair<User, ApplicationContext>.save(): Either<Throwable, Long> = try { second.getBean<R2dbcEntityTemplate>() .databaseClient .sql(INSERT) .bind(LOGIN_ATTR, first.login) .bind(EMAIL_ATTR, first.email) .bind(PASSWORD_ATTR, first.password) .bind(LANG_KEY_ATTR, first.langKey) .bind(VERSION_ATTR, first.version) .fetch() .awaitRowsUpdated() .right() } catch (e: Throwable) { e.left() } suspend fun ApplicationContext.findOneUserByEmail( email: String ): Either<Throwable, User> = try { getBean<DatabaseClient>() .sql("SELECT * FROM `user` WHERE LOWER(email) = LOWER(:email)") .bind("email", email) .fetch() .awaitOne() .let { row -> User( id = row[ID_ATTR] as UUID?, login = row[LOGIN_ATTR] as String, password = row[PASSWORD_ATTR] as String, email = row[EMAIL_ATTR] as String, langKey = row[LANG_KEY_ATTR] as String, version = row[VERSION_ATTR] as Long ) }.right() } catch (e: Throwable) { e.left() } } } /** Account REST API URIs */ object UserRestApis { const val API_AUTHORITY = "/api/authorities" const val API_USERS = "/api/users" const val API_SIGNUP = "/signup" const val API_SIGNUP_PATH = "$API_USERS$API_SIGNUP" const val API_ACTIVATE = "/activate" const val API_ACTIVATE_PATH = "$API_USERS$API_ACTIVATE?key=" const val API_ACTIVATE_PARAM = "{activationKey}" const val API_ACTIVATE_KEY = "key" const val API_RESET_INIT = "/reset-password/init" const val API_RESET_FINISH = "/reset-password/finish" const val API_CHANGE = "/change-password" const val API_CHANGE_PATH = "$API_USERS$API_CHANGE" } } // Abstract entity model with Generic ID, which can be of any type abstract class EntityModel<T>( open val id: T? = null ) { companion object { const val ID_MEMBER = "id" } } // Generic extension function that allows the ID to be applied to any EntityModel type inline fun <reified T : EntityModel<ID>, ID> T.withId(id: ID): T { // Use reflection to create a copy with the passed ID return this::class.constructors.first { it.parameters.any { param -> param.name == ID_MEMBER } } .call(id, *this::class.constructors.first().parameters.drop(1).map { param -> this::class.members.first { member -> member.name == param.name }.call(this) }.toTypedArray()) }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_οι_διαφορετικές_προσεγγίσεις">Οι διαφορετικές προσεγγίσεις</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_η_κλασική_προσέγγιση_με_when">Η κλασική προσέγγιση με `when</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val user: User by lazy { userFactory(USER) } val result: Either<Throwable, User> = context.findOneUserByEmail(user.email) when (result) { is Either.Left -> { val error = result.value println("Erreur : ${error.message}") } is Either.Right -> { val user = result.value println("Utilisateur trouvé : ${user.login}") } }</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η μέθοδος, αν και απλή και αναγνώσιμη, δεν εκμεταλλεύεται πλήρως τις λειτουργικές δυνατότητες του Arrow.</p> </div> </div> <div class="sect2"> <h3 id="_χρήση_του_fold_για_μια_πιο_συντομική_προσέγγιση">Χρήση του <code>fold</code> για μια πιο συντομική προσέγγιση</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">result.fold( { error -> println("Erreur : ${error.message}") }, { user -> println("Utilisateur trouvé : ${user.login}") } )</code></pre> </div> </div> <div class="paragraph"> <p>`fold`Επιτρέπει να ορίζονται ενέργειες για τις δύο περιπτώσεις (Left και Right) με συνοπτικό και ελκυστικό τρόπο.</p> </div> </div> <div class="sect2"> <h3 id="_μετασχηματισμός_με_map_και_mapleft">Μετασχηματισμός με <code>map</code> και `mapLeft</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val processedResult = result .map { user -> "Utilisateur trouvé : ${user.login}" } .mapLeft { error -> "Erreur : ${error.message}" } println(processedResult.merge())</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η προσέγγιση επιτρέπει τη μετατροπή των τιμών που περιέχονται στο Either, διατηρώντας την δομή του, ιδανική για πιο πολύπλοκες αλυσίδες επεξεργασίας.</p> </div> </div> <div class="sect2"> <h3 id="_διαχείριση_σφαλμάτων_με_getorelse">Διαχείριση σφαλμάτων με `getOrElse</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val user = result.getOrElse { error -> println("Erreur : ${error.message}") User(login = "default", email = "default@example.com") // utilisateur par défaut } println("Login : ${user.login}")</code></pre> </div> </div> <div class="paragraph"> <p>`getOrElse`Προσφέρει διαχείριση σφαλμάτων με έναν ελεγamment τρόπο, επιτρέποντας τη παροχή μιας προεπιλεγμένης τιμής.</p> </div> </div> <div class="sect2"> <h3 id="_πλευρικές_ενέργειες_με_onleft_και_onright">Πλευρικές ενέργειες με <code>onLeft</code> και `onRight</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">result.onLeft { error -> println("Erreur : ${error.message}") } .onRight { user -> println("Utilisateur trouvé : ${user.login}") }</code></pre> </div> </div> <div class="paragraph"> <p>Αυτές οι μέθοδοι επιτρέπουν να εκτελείς ενέργειες σε κάθε πλευρά χωρίς να τροποποιήσεις το Either, ιδανικό για το logging ή τις ελαφριές παρενέργειες.</p> </div> </div> <div class="sect2"> <h3 id="_συρραφή_λειτουργιών_με_flatmap">Συρραφή λειτουργιών με `flatMap</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">fun findUser(email: String): Either<Throwable, User> = // ... implémentation fun getUserPermissions(user: User): Either<Throwable, List<String>> = // ... implémentation val userPermissions = findUser("user@example.com") .flatMap { user -> getUserPermissions(user) }</code></pre> </div> </div> <div class="paragraph"> <p><code>flatMap`είναι χρήσιμο για να συνδέσετε λειτουργίες που επιστρέφουν τον εαυτό τους των`Either</code>, αποφεύγοντας έτσι τα`Either`εμπλεγμένοι.</p> </div> </div> <div class="sect2"> <h3 id="_διπλεύς_μετασχηματισμός_με_το_bimap">Διπλεύς μετασχηματισμός με το `bimap</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val result: Either<Throwable, User> = // ... obtention du résultat val processedResult = result.bimap( { error -> "Erreur: ${error.message}" }, { user -> "Utilisateur: ${user.login}" } )</code></pre> </div> </div> <div class="paragraph"> <p>`bimap`επιτρέπει τη μετασχηματιστική τόσο του αριστέρου μέρους όσο και του δεξιού μέρους σε μια μόνο λειτουργία.</p> </div> </div> <div class="sect2"> <h3 id="_αντιστροφή_των_πλευρών_με_swap">Αντιστροφή των πλευρών με `swap</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val result: Either<Throwable, User> = // ... obtention du résultat val swapped = result.swap()</code></pre> </div> </div> <div class="paragraph"> <p><code>swap`είναι χρήσιμο όταν θέλετε να αντιστρέψετε τις πλευρές ενός`Either</code>, για παράδειγμα για να προσαρμόσουμε τη διασύνδεση μιας συνάρτησης σε άλλη.</p> </div> </div> <div class="sect2"> <h3 id="_χρήση_του_tap_και_του_tapleft">Χρήση του <code>tap</code> και του <code>tapLeft</code> :</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">result.tap { user -> println("Utilisateur trouvé : ${user.login}") } .tapLeft { error -> println("Erreur : ${error.message}") }</code></pre> </div> </div> <div class="paragraph"> <p>Παρόμοιο σε`onLeft` et <code>onRight</code>, αλλά αυτές οι μέθοδοι επιστρέφουν το αρχικό <code>Either</code>, το οποίο είναι χρήσιμο για την αλυσίδα λειτουργιών.</p> </div> </div> <div class="sect2"> <h3 id="_χρήση_του_recover">Χρήση του <code>recover</code>:</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val recoveredUser = result.recover { error -> println("Erreur récupérée : ${error.message}") User(login = "recovered", email = "recovered@example.com") } println("Login : ${recoveredUser.login}")</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η μέθοδος επιτρέπει τη μετατροπή του Either.Left σε Either.Right παρέχοντας μια τιμή αντικατάστασης.</p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_πρακτικές_περιπτώσεις_χρήσης">Πρακτικές περιπτώσεις χρήσης</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Χρησιμοποιήστε`fold`για απλές λειτουργίες που απαιτούν επεξεργασία για κάθε περίπτωση. - Προτιμήστε`map` et <code>mapLeft`για μετασχηματισμούς δεδομένων χωρίς να αλλάξει τη δομή του`Either</code>. - Επιλέξτε για`flatMap`Κατά τη σειρά λειτουργιών που μπορούν να αποτυχούν - Χρησιμοποιείτε`recover`για να παρέχει μια προεπιλεγμένη τιμή σε περίπτωση σφάλματος Επιλέξτε`onLeft` et <code>onRight</code> (ou <code>tap</code> et <code>tapLeft</code>) για παρενέργειες όπως το logging. Χρησιμοποιήστε`bimap`για να μετατρέψετε και τις δύο πλευρές σε μια μόνο λειτουργία. - Εφαρμόστε`swap`Όταν πρέπει να προσαρμόσετε την διεπαφή μιας συνάρτησης σε μια άλλη.</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Κάθε μια από αυτές τις προσεγγίσεις έχει τα πλεονεκτήματά της ανάλογα με το πλαίσιο χρήσης. Οι μέθοδοι όπως`fold`, <code>map</code>/<code>mapLeft</code>, et `recover`είναι ιδιαίτερα χρήσιμα όταν θέλετε να αλυσοδέσετε πολλές λειτουργίες ή να μετατρέπειτε τα δεδομένα με λειτουργικό τρόπο.</p> </div> <div class="paragraph"> <p>Η μονάδα`Either`Το d’Arrow προσφέρει εξαιρετική ευελιξία για τη διαχείριση των σεναρίων επιτυχίας και σφάλματος στις εφαρμογές σας Kotlin. Κατανειώνοντας αυτές τις διαφορετικές προσεγγίσεις, θα μπορέσετε να γράψετε κώδικα που είναι πιο ανθεκτικό, πιο ευανάγνωστο και πιο λειτουργικό.</p> </div> <div class="paragraph"> <p>Στο επερχόμενο σας πρόγραμμα, μη διστάσετε να εξερευνήσετε αυτές τις τεχνικές για να εξασφαλίσετε το μέγιστο όφελος από τη λειτουργική προγραμματισμό με Kotlin και Arrow !</p> </div> </div> </div> <div class="sect1"> <h2 id="_για_να_πάτε_πιο_μακριά">Για να πάτε πιο μακριά</h2> <div class="sectionbody"> <div class="paragraph"> <p>Επίσημη τεκμηρίωση του Arrowhttps://arrow-kt.io/docs/apidocs/arrow-core/arrow.core/-either/[Βέλος ή] - Κορουτίνες Kotlin με το Arrow :https://arrow-kt.io/docs/fx/[Arrow Fx Coroutines]</p> </div> <div class="paragraph"> <p>Μην ξεχάσετε να μοιραστείτε τις εμπειρίες σας και τις αγαπημένες τεχνικές σας για να εργάζεστε με`Either`στα σχόλια παρακάτω!</p> </div> </div> </div> https://cheroliv.com/blog/2024/0074_seach_file_linux_post.html Mon, 23 Sep 2024 00:00:00 +0000 blog/2024/0074_seach_file_linux_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εισαγωγή">Εισαγωγή</a></li> <li><a href="#_χρήση_της_εντολής_find">Χρήση της εντολής `find</a> <ul class="sectlevel2"> <li><a href="#_επιπλέον_επιλογές_για_find">Επιπλέον επιλογές για `find</a></li> </ul> </li> <li><a href="#_χρήση_της_εντολής_locate">Χρήση της εντολής `locate</a></li> <li><a href="#_χρήση_της_εντολής_grep_για_αναζήτηση_κειμένου_σε_αρχεία">Χρήση της εντολής <code>grep</code> για αναζήτηση κειμένου σε αρχεία</a></li> <li><a href="#_συμπέρασμα">Συμπέρασμα</a></li> </ul> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Το πρόβλημα : Αναζητήστε αρχεία σε ένα σύστημα Linux μέσω του τερματικού.</div> <p>Στο παρόν άρθρο, θα εξερευνήσουμε πώς να αναζητήσουμε ένα αρχείο στο Ubuntu χρησιμοποιώντας ένα τερματικό Zsh. Το Zsh (Z shell) είναι ένα ισχυρό διερμηνέα εντολών που χρησιμοποιείται ευρέως λόγω της ευελιξίας του και των προχωρημένων λειτουργιών του.</p> </div> <div class="paragraph"> <p>Ubuntu, μια δημοφιλής διανομή Linux, προσφέρει αρκετά εργαλεία γραμμής εντολών για να αναζητήσετε αρχεία. Θα δούμε πώς να χρησιμοποιήσουμε εντολές όπως`find`, <code>locate</code> et `grep`για να εντοπίζετε αρχεία γρήγορα και αποτελεσματικά στο τερματικό.</p> </div> </div> </div> <div class="sect1"> <h2 id="_χρήση_της_εντολής_find">Χρήση της εντολής `find</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η εντολή`find`Επιτρέπει την αναζήτηση αρχείων σε έναν συγκεκριμένο κατάλογο και τα υποκαταλόγους του. Η βασική σύνταξή του είναι η εξής:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">find [chemin] -name [nom_du_fichier]</code></pre> </div> </div> <div class="paragraph"> <p>Εδώ είναι ένα πρακτικό παράδειγμα όπου ψάχνουμε για ένα αρχείο με όνομα`example.txt`στο φάκελο`/home`:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">find /home -name "example.txt"</code></pre> </div> </div> <div class="paragraph"> <p>Αυτή η εντολή θα διατρέξει όλους τους υποφακέλους του`/home`και εμφανίστε την πλήρη διαδρομή του αρχείου αν βρεθεί.</p> </div> <div class="paragraph"> <p>Στο διαδικτυακό εγχειρίδιο της εντολής`find`:https://man.archlinux.org/man/find.1.fr/[man find,windows=read-later]*</p> </div> <div class="sect2"> <h3 id="_επιπλέον_επιλογές_για_find">Επιπλέον επιλογές για `find</h3> <div class="paragraph"> <p>Η εντολή`find`είναι πολύ ισχυρή και διαθέτει πολλές επιλογές. Εδώ είναι μερικά χρήσιμα παραδείγματα:</p> </div> <div class="ulist"> <ul> <li> <p><strong>Αναζήτηση ανά τύπο αρχείου</strong>Για να αναζητήσετε μόνο αρχεία, χρησιμοποιήστε`-type f`, και για να αναζητήσετε καταλόγους, χρησιμοποιήστε`-type d`. - <strong>Αναζήτηση ανά μέγεθος</strong>Μπορείτε επίσης να φιλτράρετε τα αρχεία βάσει του μεγέθους τους χρησιμοποιώντας την επιλογή`-size`. Par exemple, pour rechercher des fichiers de plus de 100 Mo, utilisez :</p> </li> </ul> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">find /home -size +100M</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_χρήση_της_εντολής_locate">Χρήση της εντολής `locate</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η εντολή`locate`είναι πιο γρήγορο από`find`διότι χρησιμοποιεί μια προ-διατεταγμένη βάση δεδομένων των αρχείων που είναι παρόντα στο σύστημα. Πρέπει πρώτα να ενημερώσετε αυτή τη βάση δεδομένων με την ακόλουθη εντολή:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">sudo updatedb</code></pre> </div> </div> <div class="paragraph"> <p>Επειτα, μπορείτε να αναζητήσετε ένα αρχείο όπως εδώ:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">locate example.txt</code></pre> </div> </div> <div class="paragraph"> <p>Χρησιμοποιώhttps://fr.wikipedia.org/wiki/Z_Shell[zsh]με</p> </div> <div class="paragraph"> <p>(Note: The output includes a leading space, the Greek translation "με", and a trailing space, matching the original spacing.)<a href="https://github.com/ohmyzsh/ohmyzsh/wiki">oh-my-zsh</a>, φαν</tool_call> ότι η παραγγελία`locate`δεν είναι προσβάσιμο από`zsh`αλλά είναι πολύ δυνατό από`bash`, για να αντιμετωπίσει αυτό, το επιχείρημα`-c`της παραγγελίας`bash`επιτρέπει την εκτέλεση μιας εντολής`bash`από έναν άλλον τύπο τερματικού.</p> </div> <div class="paragraph"> <p>εδώ ψαχνω τα αρχεία που τελειώνουν με το μοτίβο`001.pdf`στόν user directory</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">bash -c "locate ~/*001.pdf"</code></pre> </div> </div> <div class="paragraph"> <p><strong>Εγχειρίδιο online της εντολής</strong><code>locate</code> : <a href="https://man.archlinux.org/man/locate.1.fr/">man locate</a>*</p> </div> </div> </div> <div class="sect1"> <h2 id="_χρήση_της_εντολής_grep_για_αναζήτηση_κειμένου_σε_αρχεία">Χρήση της εντολής <code>grep</code> για αναζήτηση κειμένου σε αρχεία</h2> <div class="sectionbody"> <div class="paragraph"> <p>Εάν θέλετε να αναζητήσετε ένα συγκεκριμένο κείμενο σε ένα αρχείο, μπορείτε να χρησιμοποιήσετε`grep`. Για παράδειγμα, για να βρείτε την εμφάνιση της λέξης "Ubuntu" σε όλα τα αρχεία`.txt`από τον τρέχοντα κατάλογο, χρησιμοποιήστε :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">grep "Ubuntu" *.txt</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η αναζήτηση αρχείων σε Ubuntu μέσω τερματικού Zsh μπορεί να γίνει με τη χρήση διάφορων ισχυρών εργαλείων.`find`είναι ευέλικτο και προσφέρει μια ποικιλία επιλογών, ενώ`locate`επιτρέπει μια γρήγορη αναζήτηση με τη χρήση μιας προκατασκευασμένης βάσης δεδομένων. Τέλος,`grep`επιτρέπει να βρείτε εμφανίσεις κειμένου εντός των αρχείων.</p> </div> <div class="paragraph"> <p>Αυτές οι εντολές σας προσφέρουν μια πλήρη σειρά εργαλείων για να κάνετε τις αναζητήσεις αρχείων σας πιο αποτελεσματικές και προσαρμοσμένες στις ανάγκες σας, και κάθε μία από αυτές τις εντολές έχει ένα εγχειρίδιο που είναι ορατό με την εντολή.<code>man</code></p> </div> </div> </div> https://cheroliv.com/blog/2021/0030_memo_linux_post.html Mon, 23 Sep 2024 00:00:00 +0000 blog/2021/0030_memo_linux_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_το_πληκτρολόγιο">Το πληκτρολόγιο :</a> <ul class="sectlevel2"> <li><a href="#_to_πλήκτρο_ctrl"><em>to πλήκτρο <Ctrl></em></a></li> </ul> </li> <li><a href="#_άδειαεξουσιοδότηση">�Άδεια(εξουσιοδότηση)</a></li> <li><a href="#_αναζήτηση_αρχείων">Αναζήτηση αρχείων</a></li> </ul> </div> <div class="sect1"> <h2 id="_το_πληκτρολόγιο">Το πληκτρολόγιο :</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_to_πλήκτρο_ctrl"><em>to πλήκτρο <Ctrl></em></h3> <table class="tableblock frame-all grid-all stretch"> </table> <div class="paragraph"> <p><a href="https://korben.info/les-raccourcis-clavier-pour-bash-terminal-linux-et-macos.html">σύνδεσμος</a><br> <a href="https://blogmotion.fr/systeme/astuces-bash-linux-16175">άλλος σύνδεσμος</a></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_άδειαεξουσιοδότηση">�Άδεια(εξουσιοδότηση)</h2> <div class="sectionbody"> <div class="paragraph"> <p>το CHMOD χρησιμοποιείται για την αλλαγή των δικαιωμάτων eines αρχείου.</p> </div> <div class="paragraph"> <p>άδεια εντολή</p> </div> <div class="paragraph"> <p>U G W rwx rwx rwx chmod 777 filename rwx rwx r-x chmod 775 filename rwx r-x r-x chmod 755 filename rw- rw- r-- chmod 664 filename rw- r-- r-- chmod 644 filename</p> </div> <div class="paragraph"> <p>U = Χρήστης G = Ομάδα W = Κόσμος</p> </div> <div class="paragraph"> <p>r = ανάγνωστο w = writable x = εκτελέσιμο - = χωρίς άδεια</p> </div> <div class="paragraph"> <p>Ένας άλλος τρόπος να δεις τα δικαιώματα:</p> </div> <div class="paragraph"> <p>400 διαβάστηκε από τον ιδιοκτήτη 040 ανάγνωση από ομάδα διαβασμένο από οποιονδήποτε (άλλος) 200 γραπτό από τον ιδιοκτήτη 020 γράψει από ομάδα 002 γράφει από οποιονδήποτε 100 εκτέλεση από τον ιδιοκτήτη 010 εκτέλεση από ομάδα 001 Εκτελείται από οποιονδήποτε</p> </div> <div class="paragraph"> <p>Για να πάρετε έναν συνδυασμό, αρκεί να τα προσθέσετε.<br> Για παράδειγμα, για να διαβάσει, να γράψει, να εκτελεστεί από τον ιδιοκτήτη,<br> διαβασμένο, εκτελεσμένο, από ομάδα και εκτελεσμένο από όποιον,<br> Προσθέτετε 400+200+100+040+010+001 για να δώσετε 751.<br></p> </div> </div> </div> <div class="sect1"> <h2 id="_αναζήτηση_αρχείων"><a href="/blog/2024/0074_seach_file_linux_post.html">Αναζήτηση αρχείων</a></h2> <div class="sectionbody"> </div> </div> https://cheroliv.com/blog/2024/0072_Exposer_un_port_linux_subsystem_post.adoc.html Thu, 1 Feb 2024 00:00:00 +0000 blog/2024/0072_Exposer_un_port_linux_subsystem_post.adoc.html https://cheroliv.com/blog/2024/0070_installer_pandoc_post.html Tue, 30 Jan 2024 00:00:00 +0000 blog/2024/0070_installer_pandoc_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title"><em>Χρόνος ανάγνωσης : 3 min</em> Το Pandoc, ένας παγκόσμιος μετατροπέας εγγράφων</div> <p>Το Pandoc είναι ένα λογισμικό επεξεργασίας κειμένου ανοικτού κώδικα που μπορεί να χρησιμοποιηθεί για τη μετατροπή εγγράφων μεταξύ διαφορετικών μορφών. Υπάρχουν διάφοροι τρόποι για την εγκατάσταση του Pandoc.</p> </div> </div> </div> <div class="sect1"> <h2 id="_εγκατάσταση_από_τη_σελίδα_λήψης">Εγκατάσταση από τη σελίδα λήψης</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να εγκαταστήσετε το Pandoc από τη σελίδα λήψης, ακολουθήστε τα παρακάτω βήματα:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Μεταβείτε στη σελίδα λήψης του Pandoc :https://pandoc.org/installing.html/[<a href="https://pandoc.org/installing.html" class="bare">https://pandoc.org/installing.html</a>]</p> </li> <li> <p>Κατεβάστε το πρόγραμμα εγκατάστασης του πακέτου για το σύστημα λειτουργικού σας.</p> </li> <li> <p>Εκτελέστε το πρόγραμμα εγκατάστασης για να εγκαταστήσετε το Pandoc.</p> </li> </ol> </div> <div class="paragraph"> <p><strong>Εγκατάσταση από ένα αρχείο zip</strong></p> </div> <div class="paragraph"> <p>Για να εγκαταστήσετε το Pandoc από ένα αρχείο zip, ακολουθήστε τα ακόλουθα βήματα:</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Κατεβάστε το αρχείο zip που περιέχει τα δυαδικά του Pandoc και την τεκμηρίωση.</p> </li> <li> <p>Αποσυμπιέστε το αρχείο zip.</p> </li> <li> <p>Μετακινήστε τα δυαδικά σε έναν κατάλογο που επιλέγετε.</p> </li> </ol> </div> <div class="paragraph"> <p><strong>Εγκατάσταση με τη χρήση Chocolatey</strong></p> </div> <div class="paragraph"> <p>Για να εγκαταστήσετε το Pandoc με τη χρήση του Chocolatey, ακολουθήστε τα παρακάτω βήματα :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>�Άνοιξτε μια εντολή εντολών.</p> </li> <li> <p>Εκτελέστε την ακόλουθη εντολή:</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-powershell" data-lang="powershell">choco install pandoc</code></pre> </div> </div> <div class="paragraph"> <p><strong>Εγκατάσταση με το winget</strong></p> </div> <div class="paragraph"> <p>Για να εγκαταστήσετε το Pandoc με τη χρήση του winget, ακολουθήστε τα παρακάτω βήματα :</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p>Άνοιξτε ένα προMPT εντολών.</p> </li> <li> <p>Εκτελέστε την ακόλουθη εντολή :</p> </li> </ol> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-powershell" data-lang="powershell">winget install --source winget --exact --id JohnMacFarlane.Pandoc</code></pre> </div> </div> <div class="paragraph"> <p><strong>Συστάσεις</strong></p> </div> <div class="paragraph"> <p>Προεπιλεγμένα, το Pandoc δημιουργεί PDFs με τη βοήθεια του LaTeX. Συστήνεται να εγκαταστήσετε το LaTeX μέσω MiKTeX. Με την επιλογή`--pdf-engine`, Μπορείτε να καθορίσετε επίσης άλλα προγράμματα για αυτή την εργασία.</p> </div> <div class="paragraph"> <p><strong>Προειδοποίηση</strong></p> </div> <div class="paragraph"> <p>Η χρήση πολλών μέθοδων εγκατάστασης μπορεί να προκαλέσει δύο ξεχωριστές εγκαταστάσεις του Pandoc. Προτείνεται να αφαιρέσετε σωστά το Pandoc πριν μεταβείτε σε εναλλακτική μέθοδο εγκατάστασης.</p> </div> <div class="paragraph"> <p><strong>Εγκατάσταση σε Linux μέσω WSL</strong></p> </div> <div class="paragraph"> <p>Ελέγξτε αν η έκδοση του pandoc στο διαχειριστή πακέτων σας δεν είναι παλιά. Το Pandoc βρίσκεται στους αποθετήρια των Debian, Ubuntu, Slackware, Arch, Fedora, NixOS, openSUSE, gentoo και Void.</p> </div> <div class="paragraph"> <p>Για να αποκτήσετε την τελευταία έκδοση, προτείνουμε ένα δυαδικό πακέτο για την αρχιτεκτονική amd64 στη σελίδα λήψης.</p> </div> <div class="paragraph"> <p>Το εκτελέσιμο είναι συνδεδεμένο στατικά και δεν έχει δυναμικές εξαρτήσεις, μηδε εξαρτήσεις σε εξωτερικά αρχεία δεδομένων. Σημείωση: λόγω του στατικού συνδέσμου, το δυαδικό pandoc αυτού του πακέτου δεν μπορεί να χρησιμοποιήσει τα φίλτρα lua που απαιτούν εξωτερικά modules lua γραμμένα σε C.</p> </div> <div class="paragraph"> <p>Παρέχεται ένα tarball και ένα πακέτο .deb. Για να εγκαταστήσετε το deb :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">sudo dpkg -i $DEB</code></pre> </div> </div> <div class="paragraph"> <p>Παράδειγμα κατά την εγγραφή :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">wget https://github.com/jgm/pandoc/releases/download/3.1.11.1/pandoc-3.1.11.1-1-amd64.deb</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">sudo dpkg -i pandoc-3.1.11.1-1-amd64.deb</code></pre> </div> </div> <div class="paragraph"> <p>où `$DEB`είναι η διαδρομή προς το deb που έχει κατεβαστεί Αυτό θα εγκαταστήσει το εκτελέσιμο`pandoc`και η σελίδα του εγχειριδίου</p> </div> <div class="paragraph"> <p>Αν χρησιμοποιείτε μια διανομή βασισμένη σε RPM, μπορεί να μπορέσετε να εγκαταστήσετε το deb από τη σελίδα λήψης μας με τη βοήθεια του alien.</p> </div> <div class="paragraph"> <p>Σε οποιαδήποτε διανομή, μπορείτε να εγκαταστήσετε από το tarball στο`$DEST`(π.χ.,<code>/usr/local/</code> ou <code>$HOME/.local</code>) ενώ κάνετε :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">tar xvzf $TGZ --strip-components 1 -C $DEST</code></pre> </div> </div> <div class="paragraph"> <p>où `$TGZ`είναι η διαδρομή προς το συμπιεσμένο tarball που έγινε λήψη. Για τις εκδόσεις του Pandoc παλαιότερες από την έκδοση 2.0, που δεν παρέχουν tarball, δοκιμάστε αντίθετα:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">ar p $DEB data.tar.gz | tar xvz --strip-components 2 -C $DEST</code></pre> </div> </div> <div class="paragraph"> <p>Μπορείτε επίσης να εγκαταστήσετε από τον πηγαίο κώδικα, χρησιμοποιώντας τις οδηγίες που παρακάτω υπό`Compilation à partir de la source`. Οι περισσότερες διανομές έχουν την πλατφόρμα Haskell στα αποθετήρια πακέτων τους. Για παράδειγμα, στο Debian/Ubuntu, μπορείτε να το εγκαταστήσετε με</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">apt-get install haskell-platform</code></pre> </div> </div> <div class="paragraph"> <p>Προεπιλογικά, το Pandoc δημιουργεί PDFs χρησιμοποιώντας το LaTeX. Σας συνιστάμε να εγκαταστήσετε το TeX Live μέσω του διαχειριστή πακέτων σας. (Στον Debian/Ubuntu,<code>apt-get install texlive</code>). Με την επιλογή`--pdf-engine`, Μπορείτε όμως να καθορίσετε άλλα προγράμματα για αυτή την εργασία.</p> </div> </div> </div> https://cheroliv.com/blog/2023/0069_triple_python_js_ts_post.html Mon, 25 Dec 2023 00:00:00 +0000 blog/2023/0069_triple_python_js_ts_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <div class="title"><em>Χρόνος ανάγνωσης : 2 λεπτά</em> Δημιουργήστε μια πλήρης υλοποίηση της κλάσης kotlin.Triple σε JavaScript, TypeScript και Python χρησιμοποιώντας τη λειτουργική προγραμματιστική.</div> <p><strong>Σημείωση :</strong>Τα τύποι`Maybe`, <code>Either</code>, `Result`Δεν είναι μέρος της βασικής γλώσσας στο JavaScript ή TypeScript, οπότε πρέπει να τις υλοποιούμε εμείς.</p> </div> </div> </div> <div class="sect1"> <h2 id="_javascript">JavaScript</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">//javascript // Maybe type const Maybe = (value) => ({ map: (fn) => (value !== null && value !== undefined ? Maybe(fn(value)) : Maybe(null)), flatMap: (fn) => (value !== null && value !== undefined ? fn(value) : Maybe(null)), getOrElse: (defaultValue) => (value !== null && value !== undefined ? value : defaultValue), }); // Either type const Either = { Left: (value) => ({ map: (fn) => Either.Left(value), flatMap: (fn) => Either.Left(value), getOrElse: (defaultValue) => defaultValue, isLeft: true, isRight: false, }), Right: (value) => ({ map: (fn) => Either.Right(fn(value)), flatMap: (fn) => fn(value), getOrElse: (defaultValue) => value, isLeft: false, isRight: true, }), }; // Triple class class Triple { constructor(a, b, c) { this.a = a; this.b = b; this.c = c; } map(fn) { return new Triple(fn(this.a), fn(this.b), fn(this.c)); } static of(a, b, c) { return new Triple(a, b, c); } // Example method using Maybe and Either divideBy(other) { return Maybe(this.b) .flatMap((numerator) => Maybe(other) .flatMap((denominator) => denominator !== 0 ? Either.Right(numerator / denominator) : Either.Left('Division by zero') ) ) .getOrElse(Either.Left('Invalid input')); } } // Example usage const triple = Triple.of(1, 2, 3); const result = triple.map((x) => x * 2); console.log(result); // Triple { a: 2, b: 4, c: 6 } const divisionResult = triple.divideBy(2); console.log(divisionResult); // Either.Right { value: 1 } const invalidDivisionResult = triple.divideBy(0); console.log(invalidDivisionResult); // Either.Left { value: 'Division by zero' }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_typescript">TypeScript</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">//Typescript // Maybe type // noinspection JSAnnotator type Maybe<T> = { map<U>(fn: (value: T) => U): Maybe<U>; flatMap<U>(fn: (value: T) => Maybe<U>): Maybe<U>; getOrElse(defaultValue: T): T; }; const just = <T>(value: T): Maybe<T> => ({ map: <U>(fn: (value: T) => U) => just(fn(value)), flatMap: <U>(fn: (value: T) => Maybe<U>) => fn(value), getOrElse: (_: T) => value, }); const nothing = <T>(): Maybe<T> => ({ map: <U>(_: (value: T) => U) => nothing<U>(), flatMap: <U>(_: (value: T) => Maybe<U>) => nothing<U>(), getOrElse: (defaultValue: T) => defaultValue, }); // Either type type Either<L, R> = { map<U>(fn: (value: R) => U): Either<L, U>; flatMap<U>(fn: (value: R) => Either<L, U>): Either<L, U>; getOrElse(defaultValue: R): R; isLeft: boolean; isRight: boolean; }; const left = <L, R>(value: L): Either<L, R> => ({ map: <U>(_: (value: R) => U) => left<L, U>(value), flatMap: <U>(_: (value: R) => Either<L, U>) => left<L, U>(value), getOrElse: (defaultValue: R) => defaultValue, isLeft: true, isRight: false, }); const right = <L, R>(value: R): Either<L, R> => ({ map: <U>(fn: (value: R) => U) => right<L, U>(fn(value)), flatMap: <U>(fn: (value: R) => Either<L, U>) => fn(value), getOrElse: (_: R) => value, isLeft: false, isRight: true, }); // Triple class class Triple<T> { constructor(public a: T, public b: T, public c: T) {} map<U>(fn: (value: T) => U): Triple<U> { return new Triple<U>(fn(this.a), fn(this.b), fn(this.c)); } static of<T>(a: T, b: T, c: T): Triple<T> { return new Triple<T>(a, b, c); } // Example method using Maybe and Either divideBy(other: T): Either<string, number> { return just(this.b) .flatMap((numerator) => just(other) .flatMap((denominator) => denominator !== 0 ? right(numerator / denominator) : left('Division by zero') ) ) .getOrElse(left('Invalid input')); } } // Example usage const triple = Triple.of(1, 2, 3); const result = triple.map((x) => x * 2); console.log(result); // Triple { a: 2, b: 4, c: 6 } const divisionResult = triple.divideBy(2); console.log(divisionResult); // Either.Right { value: 1 } const invalidDivisionResult = triple.divideBy(0); console.log(invalidDivisionResult); // Either.Left { value: 'Division by zero' }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_python_pydantic_pymonad">Python, pydantic, pymonad</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να δημιουργήσετε μια υλοποίηση στην Python χρησιμοποιώντας`pydantic`για την επαλήθευση των τύπων και`pymonad`για τις μονάδες :</p> </div> <div class="listingblock"> <div class="title">Εγκαταστήστε τις εξαρτήσεις:</div> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">pip install pydantic pymonad</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-python" data-lang="python">from pymonad.either import Either, Left, Right from pydantic import BaseModel, ValidationError, validator # Définition de la classe Triple avec Pydantic class Triple(BaseModel): a: int b: int c: int @validator('b') def validate_b(cls, b, values): if b == 0: raise ValueError('Division by zero is not allowed') return b # Méthode utilisant Either pour la gestion des erreurs def divide_by(self, other): def division(numerator, denominator): return Right(numerator / denominator) def handle_error(error): return Left(str(error)) return Either(lambda: division(self.b, other)).or_else(handle_error) # Exemple d'utilisation try: triple = Triple(a=1, b=2, c=3) result = triple.divide_by(2) if result.is_right: print(f'Division result: {result.value}') else: print(f'Error: {result.value}') except ValidationError as e: print(f'Validation Error: {e}') except Exception as e: print(f'An unexpected error occurred: {e}')</code></pre> </div> </div> <div class="ulist"> <div class="title">Σε αυτό το παράδειγμα:</div> <ul> <li> <p><code>pydantic`για να οριστεί η κλάση`Triple`με τυπωμένα πεδία. - η μέθοδος`divide_by</code> utilise la monade <code>Either</code> de `pymonad`για να διαχειριστεί τις πιθανά σφάλματα που προκύπτουν από τη διαιρέση με το μηδέν. - Προσαρμοσμένη επιβεβαίωση για να βεβαιωθείτε ότι η τιμή του`b`Δεν είναι ίση με το μηδέν. Αν είναι ίση με το μηδέν, ρίχνεται μια εξαίρεση, και`pymonad`Συλλαβείτε αυτή την εξαίρεση ώστε να επιστρέψετε ένα αποτέλεσμα`Left`δεικνύον το σφάλμα.</p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2023/0068_introduction_google_apps_script_post.html Fri, 22 Dec 2023 00:00:00 +0000 blog/2023/0068_introduction_google_apps_script_post.html <div class="sect1"> <h2 id="_πίνακας_περιεχομένων">Πίνακας περιεχομένων</h2> <div class="sectionbody"> <div class="paragraph"> <p><em>χρόνος ανάγνωσης : 30 λεπτά</em></p> </div> <div class="ulist"> <ul> <li> <p><a href="#Introduction">[Introduction]</a></p> </li> <li> <p><a href="#Βασική δομή στο Google Apps Script">[Βασική δομή στο Google Apps Script]</a></p> </li> <li> <p><a href="#_τύποι_και_μεταβλητές_στο_google_apps_script">Τύποι και Μεταβλητές στο Google Apps Script</a></p> </li> <li> <p><a href="#Σταθερές">Μεταβλητές και Γράμματα στο Google Apps Script</a></p> </li> <li> <p><a href="#Λειτουργίες και Τελεστές στον Google Apps Script">[Λειτουργίες και Τελεστές στον Google Apps Script]</a></p> </li> <li> <p><a href="#Βαρ">Let και Const στον Google Apps Script</a></p> </li> <li> <p><a href="#Δομές ελέγχου σε Google Apps Script">[Δομές ελέγχου σε Google Apps Script]</a></p> </li> <li> <p>Βρόχοι στο Google Apps Script</p> </li> <li> <p><a href="#Αντικείμενα στην Google Apps Script">[Αντικείμενα στην Google Apps Script]</a></p> </li> <li> <p><a href="#_συναρτήσεις_στο_google_apps_script">Συναρτήσεις στο Google Apps Script</a></p> </li> <li> <p><a href="#Παράμετροι και Εμβέλεια στο Google Apps Script">[Παράμετροι και Εμβέλεια στο Google Apps Script]</a></p> </li> <li> <p><a href="#Τελεστές Υπολοίπου και Διασποράς στην Google Apps Script">[Τελεστές Υπολοίπου και Διασποράς στην Google Apps Script]</a></p> </li> <li> <p><a href="#Ανάθεση μέσω ανάλυσης σε Google Apps Script">[Ανάθεση μέσω ανάλυσης σε Google Apps Script]</a></p> </li> <li> <p><a href="#Συλλογές και δηλωτική προγραμματισμός στο Google Apps Script">[Συλλογές και δηλωτική προγραμματισμός στο Google Apps Script]</a></p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_εισαγωγή">Εισαγωγή</h2> <div class="sectionbody"> <div class="paragraph"> <p>Google Apps Script (GAS) είναι μια πλατφόρμα ανάπτυξης σεναρίων που σχετίζεται με διάφορα υπηρεσίες Google όπως τα Google Sheets, τα Google Docs και τα Google Forms. Επιτρέπει την αυτοματοποίηση εργασιών, την προσθήκη προσαρμοσμένων λειτουργιών και την ενσωμάτωση υπηρεσιών Google.</p> </div> <div class="paragraph"> <p>Σε αυτή τη σημείωση, θα εξετάσουμε τις κύριες έννοιες του Google Apps Script βασισμένοι σε πρακτικά παραδείγματα. Θα ασχοληθούμε με έννοιες όπως οι μεταβλητές, οι βρόχοι, οι λειτουργίες και πολλά άλλα, προσαρμόζοντας τα στο συγκεκριμένο πλαίσιο του GAS.</p> </div> </div> </div> <div class="sect1"> <h2 id="_βασική_δομή_στην_google_apps_script">Βασική δομή στην Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να ξεκινήσουμε, ας εξετάσουμε τη βασική δομή μιας δέσμης ενεργειών Google Apps.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Structure de base en Google Apps Script */ function exempleStructureGAS() { // Votre code ici Logger.log("Hello, Google Apps Script!"); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_τύποι_και_μεταβλητές_στο_google_apps_script">Τύποι και Μεταβλητές στο Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η Google Apps Script χρησιμοποιεί τη JavaScript ως γλώσσα προγραμματισμού. Οι τύποι δεδομένων και οι μεταβλητές λειτουργούν παρόμοια με την τυπική JavaScript.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Types et Variables en Google Apps Script */ function exempleTypesVariablesGAS() { // Votre code ici var nombre = 42; var texte = "Bonjour, Google Apps Script!"; Logger.log(nombre); Logger.log(texte); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_λειτουργίες_και_τελεστές_στο_google_apps_script">Λειτουργίες και τελεστές στο Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Οι λειτουργίες και οι τελεστές στο Google Apps Script είναι οι ίδιοι με την JavaScript.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Opérations et Opérateurs en Google Apps Script */ function exempleOperationsGAS() { // Votre code ici var x = 10; var y = 5; var resultat = x + y; Logger.log(resultat); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_var_let_και_const_στο_google_apps_script">Var, Let και Const στο Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Στον GAS, οι έννοιες του`var`, <code>let</code>, et `const`χρησιμοποιούνται για τη δήλωση μεταβλητών. Ω</tool_call>, είναι ζωτικό να κατανοήσουμε τις διαφορές τους και τις επιπτώσεις τους.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Var, Let et Const en Google Apps Script */ function exempleVarLetConstGAS() { // Votre code ici // Utilisation de var var x = 10; if (true) { var x = 20; // La variable x est modifiée globalement } Logger.log(x); // Utilisation de let let y = 30; if (true) { let y = 40; // La variable y est limitée au bloc if } Logger.log(y); // Utilisation de const const z = 50; // z = 60; // Impossible de réassigner une constante Logger.log(z); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_δομές_ελέγχου_στο_google_apps_script">Δομές ελέγχου στο Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Οι δομές έλεγχου όπως`if`, <code>else</code>, <code>while</code> et `for`utilizarόνται για τη διαχείριση της ροής εκτέλεσης στο Google Apps Script.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Structures de Contrôle en Google Apps Script */ function exempleStructuresControleGAS() { // Votre code ici var condition = true; if (condition) { Logger.log("La condition est vraie."); } else { Logger.log("La condition est fausse."); } var compteur = 0; while (compteur < 5) { Logger.log(compteur); compteur++; } for (var i = 0; i < 3; i++) { Logger.log(i); } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_παραμέτροι_και_έμβατα_στο_google_apps_script">Παραμέτροι και Έμβατα στο Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Οι παραμέτροι και οι εμβέλειες παίζουν κρίσιμο ρόλο στην ανάπτυξη σεναρίων σε GAS. Κατανόηση πώς λειτουργούν για να αποφύγετε απρόσμενα συμπεριφορές.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Paramètres et Scopes en Google Apps Script */ function exempleParametresScopesGAS(parametre) { // Votre code ici var variableGlobale = "Je suis global"; function afficherParametre() { Logger.log(parametre); } afficherParametre(); Logger.log(variableGlobale); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_σταθερές_μεταβλητές_και_γράμματα_σε_google_apps_script">Σταθερές, μεταβλητές και γράμματα σε Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Κατανόηση της διαφοράς μεταξύ`const`, <code>var</code>, et `let`Είναι ζωτικό για την αποτελεσματική χρήση των μεταβλητών στο Google Apps Script.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Constantes, Variables, et Lettres en Google Apps Script */ function exempleConstantesVariablesLettresGAS() { // Votre code ici const constante = "Je ne change pas"; Logger.log(constante); var variable = "Je peux changer"; Logger.log(variable); let lettre = "Je peux aussi changer, mais seulement dans mon bloc"; Logger.log(lettre); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_βρόχοι_στο_google_apps_script">Βρόχοι στο Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Οι βρόχοι, όπως`for` et <code>while</code>, είναι απαραίτητα για να επαναλάβουμε τα στοιχεία και να εκτελούμε επαναλαμβανόμενες λειτουργίες.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Boucles en Google Apps Script */ function exempleBouclesGAS() { // Votre code ici for (var i = 0; i < 3; i++) { Logger.log(i); } var condition = true; var compteur = 0; while (condition) { Logger.log("Tour de boucle"); compteur++; if (compteur === 3) { condition = false; } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αντικείμενα_στο_google_apps_script">Αντικείμενα στο Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Τα αντικείμενα χρησιμοποιούνται για την οργάνωση των δεδομένων. Στην GAS, πολλά ενσωματωμένα αντικείμενα διευκολύνουν την αλληλεπίδραση με τις υπηρεσίες του Google.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Objets en Google Apps Script */ function exempleObjetsGAS() { // Votre code ici var feuille = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cellule = feuille.getRange("A1"); cellule.setValue("Nouvelle valeur"); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_σταθερές_μεταβλητές_και_γράμματα_στο_google_apps_script">Σταθερές, Μεταβλητές, και Γράμματα στο Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Κατανόηση της διαφοράς μεταξύ`const`, <code>var</code>, et `let`Είναι απαραίτητο για μια αποτελεσματική χρήση των μεταβλητών στον Google Apps Script.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Constantes, Variables, et Lettres en Google Apps Script */ function exempleConstantesVariablesLettresGAS() { // Votre code ici const constante = "Je ne change pas"; Logger.log(constante); var variable = "Je peux changer"; Logger.log(variable); let lettre = "Je peux aussi changer, mais seulement dans mon bloc"; Logger.log(lettre); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συναρτήσεις_στο_google_apps_script">Συναρτήσεις στο Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Οι συναρτήσεις είναι βασικά στοιχεία στον προγραμματισμό. Στο GAS, μπορούν να δηλώνουν και να καλούνται με διάφορους τρόπους.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Fonctions en Google Apps Script */ function exempleFonctionsGAS() { // Votre code ici function additionner(a, b) { return a + b; } var resultat = additionner(2, 3); Logger.log(resultat); // Fonction anonyme var multiplier = function (x, y) { return x * y; }; Logger.log(multiplier(4, 5)); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_τελεστές_αναπαύσεως_και_διαδοχής_σε_google_apps_script">Τελεστές αναπαύσεως και διαδοχής σε Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Οι τελεστές αναμονής (<code>…​</code>) και διαδοχής (<code>…​</code>) είναι χρήσιμα για να χειρίζονται τους πίνακες και τα αντικείμενα συνοπτικά.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Opérateurs de Repos et de Propagation en Google Apps Script */ function exempleOperateursReposPropagationGAS() { // Votre code ici // Opérateur de repos (...) pour les tableaux var nombres = [1, 2, 3, 4, 5]; var [...copieNombres] = nombres; Logger.log(copieNombres); // Opérateur de propagation (...) pour les objets var objOriginal = { x: 1, y: 2 }; var objClone = { ...objOriginal, z: 3 }; Logger.log(objClone); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ανάθεση_με_ανάλυση_σε_google_apps_script">Ανάθεση με Ανάλυση σε Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η ανάθεση διασποράς είναι μια ισχυρή λειτουργία που επιτρέπει την εξαγωγή τιμών από αντικείμενα και πίνακες με συνοπτικό τρόπο.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Affectation par Décomposition en Google Apps Script */ function exempleAffectationDecompositionGAS() { // Votre code ici var coordonnees = [3, 4]; var [x, y] = coordonnees; Logger.log(x); Logger.log(y); var utilisateur = { nom: "John", age: 30 }; var { nom, age } = utilisateur; Logger.log(nom); Logger.log(age); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συλλογές_και_δηλωτικός_προγραμματισμός_στην_google_apps_script">Συλλογές και Δηλωτικός προγραμματισμός στην Google Apps Script</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η Google Apps Script υποστηρίζει δομές δεδομένων όπως οι πίνακες, και τις έννοιες του λειτουργικού προγραμματισμού και της δηλωτικής επανάληψης (><ιμπερατική), όπως`map`, <code>reduce</code> et <code>forEach</code>.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Collections et Programmation Déclarative en Google Apps Script */ function exempleCollectionsFonctionnelleGAS() { // Votre code ici // Exemple de tableau (collection) var nombres = [1, 2, 3, 4, 5]; // Utilisation de forEach nombres.forEach(function (nombre) { Logger.log(nombre); }); // Utilisation de map var carresNombres = nombres.map(function (nombre) { return nombre * nombre; }); Logger.log(carresNombres); // Utilisation de reduce var somme = nombres.reduce(function (acc, nombre) { return acc + nombre; }, 0); Logger.log(somme); }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_συμπέρασμα">Συμπέρασμα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτή η σημείωση καλύπτει τα θεμελιώδη concepts του Google Apps Script, εικονογραφώντας τα με συγκεκριμένα παραδείγματα κώδικα. Χρησιμοποιήστε αυτή τη γνώση για να αυτοματοποιήσετε τις καθημερινές σας εργασίες, να προσαρμόσετε τα έγγραφά σας και να εκμεταλλεθείτε πλήρως τις δυνατότητες του Google Apps Script.</p> </div> </div> </div> https://cheroliv.com/blog/2023/0067_formation_express_sur_google_forms_script_post.html Wed, 20 Dec 2023 00:00:00 +0000 blog/2023/0067_formation_express_sur_google_forms_script_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>Διάρκεια: 30 λεπτά</p> </div> </div> </div> <div class="sect1"> <h2 id="_στόχοι">Στόχοι</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Κατανόηση των βασικών του Google Apps Script σε Forms - Μάθετε πώς να αποκτήσετε πρόσβαση στον επεξεργαστή σεναρίων και να εκτελέσετε μια εντολή στον ενεργοποιητή</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_ανάρρωση">Ανάρρωση</h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Εισαγωγή στο Google Form Script</strong>(5 λεπ.)</p> </li> </ol> </div> <div class="paragraph"> <p>Γρήγορη επισκόπηση του Google Form Script - Παρουσίαση των βασικών λειτουργιών</p> </div> <div class="olist arabic"> <ol class="arabic"> <li> <p><strong>Δημιουργία ενός Google Form και ενός σχετικού σεναρίου</strong>(5 λεπτά)</p> <div class="ulist"> <ul> <li> <p>Δημιουργία ενός απλού φόρμας με το Google Forms - Εισαγωγή στον συσχετισμένο επεξεργαστή σεναρίων</p> </li> </ul> </div> </li> <li> <p><strong>Εκτέλεση μιας εντολής</strong>(10 λεπτά)</p> <div class="ulist"> <ul> <li> <p>Ρύθμιση του ενεργοστή "on start - Ρύθμιση του τριγέρ \"on submit\ - Εγγραφή μιας δέσμη για εκτέλεση μιας εντολής Γρήγορες δοκιμές για να ελέγξετε τη σωστή λειτουργία στο ημερολόγιο</p> </li> </ul> </div> </li> <li> <p><strong>Ανάλυση Αποτελεσμάτων και Καλές Πρακτικές</strong>(10 λεπτά)</p> <div class="ulist"> <ul> <li> <p>Επαλήθευση των αποτελεσμάτων της εκτέλεσης μιας εντολής - Συζήτηση για ένα παράδειγμα σεναρίου και πώς η αυτοματοποίηση μπορεί να εξοικονομήσει χρόνο</p> </li> </ul> </div> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="_προϋπόθεση">προϋπόθεση</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Να έχετε έναν λογαριασμό Google και πρόσβαση στο Google Forms και στο Google Sheets</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_εξοπλισμός">Εξοπλισμός</h2> <div class="sectionbody"> <div class="ulist"> <ul> <li> <p>Υπολογιστής με ένα πρόγραμμα περιήγησης web και σύνδεση στο internet</p> </li> </ul> </div> </div> </div> <div class="sect1"> <h2 id="_σημείωση">Σημείωση</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αυτή η γρήγορη εκπαίδευση προσφέρει μια γρήγορη εισαγωγή στην αυτοματοποίηση με το Google Form Script. Για πιο βαθιά κατανόηση, συνιστώνται πιο μακροχρόνιες εκπαιδεύσεις.</p> </div> </div> </div> <div class="sect1"> <h2 id="_1_εισαγωγή_στο_google_form_script">1 - Εισαγωγή στο Google Form Script</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_slide_1_γρήγορη_επισκόπηση_του_google_form_script">Slide 1: Γρήγορη επισκόπηση του Google Form Script</h3> <div class="ulist"> <ul> <li> <p>Η πλατφόρμα Google Form Script είναι μια ενσωματωμένη πλατφόρμα σεναриоγράφησης στις Google Forms. - Επιτρέπει την προσθήκη προσαρμοσμένων λειτουργιών και την αυτοματοποίηση εργασιών.</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_slide_2_παρουσίαση_των_κύριων_λειτουργιών">Slide 2: Παρουσίαση των κύριων λειτουργιών</h3> <div class="ulist"> <ul> <li> <p>Script Editor : Ο ενσωματωμένος επεξεργαστής σεναρίων για να γράψετε scripts Google Apps Script. - Ενεργοποιητές : Γεγονότα όπως το "on submit" που ενεργοποιούν την εκτέλεση των σεναρίων.</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_διαφάνεια_3_πλεονεκτήματα_της_χρήσης_του_google_form_script">Διαφάνεια 3: Πλεονεκτήματα της χρήσης του Google Form Script</h3> <div class="ulist"> <ul> <li> <p>Προσαρμογή : Δημιουργήστε προσαρμοσμένα φόρμες με μοναδικές λειτουργίες. - Αυτοματοποίηση : Αυτοματοποιήστε ενέργειες ως απάντηση στις απαντήσεις των φόρμων. - Ένσωμάτωση: Ενσωματώστε scripts με άλλα υπηρεσίες Google για μια πιο πλούσια εμπειρία.</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_σημείωση_για_τον_παρουσίαστη">Σημείωση για τον παρουσίαστη :</h3> <div class="paragraph"> <p>Αυτές οι λειτουργίες προσφέρουν σημαντικό δυναμικό για τη προσαρμογή και την αυτοματοποίηση των φόρμων. Η συνέχεια αυτού του εκπαιδευτικού προγράμματος θα ερευνήσει λεπτομερώς τη δημιουργία σεναρίων και ειδικών αυτοματισμών.</p> </div> <div class="paragraph"> <p><a href="https://developers.google.com/apps-script/add-ons/editors/forms?hl=el" class="bare">https://developers.google.com/apps-script/add-ons/editors/forms?hl=el</a></p> </div> <div class="paragraph"> <p><a href="https://developers.google.com/apps-script/reference/forms?hl=fr" class="bare">https://developers.google.com/apps-script/reference/forms?hl=fr</a></p> </div> <div class="paragraph"> <p><a href="https://developers.google.com/apps-script/reference/forms/form-app?hl=fr" class="bare">https://developers.google.com/apps-script/reference/forms/form-app?hl=fr</a></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_δημιουργία_ενός_φόρμας_google_και_ενός_σχετικού_script_5_min"><strong>Δημιουργία ενός φόρμας Google και ενός σχετικού script</strong> (5 min)</h2> <div class="sectionbody"> </div> </div> https://cheroliv.com/blog/2023/0066_memo_python_post.html Sun, 19 Nov 2023 00:00:00 +0000 blog/2023/0066_memo_python_post.html <div class="sect1"> <h2 id="_εγκατάσταση_του_python_στα_windows">Εγκατάσταση του Python στα Windows</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://ninite.com/pythonx3/">python στο Windows</a></p> </div> <div class="paragraph"> <p><a href="https://python-docs.readthedocs.io/en/latest/starting/install3/win.html" class="bare">https://python-docs.readthedocs.io/en/latest/starting/install3/win.html</a></p> </div> <div class="paragraph"> <p><a href="https://python-docs.readthedocs.io/en/latest/dev/virtualenvs.html#virtualenvironments-ref" class="bare">https://python-docs.readthedocs.io/en/latest/dev/virtualenvs.html#virtualenvironments-ref</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_εκτέλεση_python">Εκτέλεση python</h2> <div class="sectionbody"> <div class="listingblock"> <div class="title">Αναφορά :</div> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">cd mon_projet python -m venv mon_venv source mon_venv/bin/activate # Sur windows mon_venv\Scripts\activate deactivate</code></pre> </div> </div> <div class="sect2"> <h3 id="_απαιτηση_εγκατάστασης">απαιτηση εγκατάστασης</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">pip install -r requirements.txt</code></pre> </div> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αρχή">αρχή</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://python.doctor/page-apprendre-programmation-orientee-objet-poo-classes-python-cours-debutants">python ΟΠΠ</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_σχεδιαστικά_πρότυπα_του_gof_στην_python">Σχεδιαστικά πρότυπα του GoF στην Python</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://github.com/whikwon/python-patterns/">υλοποίηση 1</a></p> </div> <div class="paragraph"> <p><a href="https://github.com/Sean-Bradley/Design-Patterns-In-Python">υλοποίηση 2</a></p> </div> <div class="paragraph"> <p><a href="https://sbcode.net/python/">πλήρες βιβλίο</a></p> </div> <div class="paragraph"> <p>Τα design patterns του GoF είναι ένα σύνολο από 23 design patterns που περιγράφονται στο βιβλίο "Design Patterns: Elements of Reusable Object-Oriented Software".</p> </div> <table class="tableblock frame-all grid-all stretch"> <caption class="title">Table 1. Εδώ είναι μια λίστα των σχεδιαστικών μοτίβων του GoF</caption> <colgroup> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0833%;"> <col style="width: 2.0849%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">όνομα</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Περιγραφή</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Μέθοδος Factory</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Δημιουργεί αντικείμενα χωρίς να καθορίζει την ακριβή κλάση που θα δημιουργηθεί.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Αβστράκτο Εργοστασείο</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Δημιούργησε οικογένειες συνδεδεμένων ή εξαρτημένων αντικειμένων χωρίς να καθορίζει τη συγκεκριμένη κλάση τους.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Κτίristς</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Αποχωρίζει τη κατασκευή ενός πολύπλοκου αντικειμένου από την αναπαράστασή του ώστε η ίδια διαδικασία κατασκευής να μπορεί να δημιουργήσει διαφορετικές αναπαραστάσεις.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>πρωτότυπο</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Δημιούργησε νέα αντικείμενα αντιγράφοντας ένα υπάρχον πρωτότυπο.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Singleton</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Περιορίζει την δημιουργία ενός μόνο αντικειμένου από μια κλάση.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Αντάπτορας</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Μετετρέπει την διεπαφή μιας κλάσης σε άλλη διεπαφή που ο πελάτης αναμένει.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Γέφυρα</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Αποσυνδέστε μια αφαίρεση από την υλοποίηση της ώστε και τα δύο να μπορούν να μεταβούν ανεξάρτητα.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Συνθετικό</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Συνθέστε αντικείμενα σε δομές δέντρου για να αντιπροσωπεύσουν ιεραρχίες μερών-όλου.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>διακόσμητης</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Προσθέστε δυναμικά επιπλέον ευθύνες σε ένα αντικείμενο.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>φασάδα</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Παρέχει μια ενιαία διεπαφή σε ένα σύνολο διεπαφών σε ένα υποσύστημα.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Flyweight</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Μειώνει το κόστος δημιουργίας και χρήσης ελαφριών αντικειμένων.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>πρόκσο</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Παρέχει έναν αντικαταστάτη ή έναν χώρο κράτησης για ένα άλλο αντικείμενο, ώστε να ελέγχει την πρόσβαση σε αυτό.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Αλυσίδα ευθυνών</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Επιτρέπει σε περισσότερο από ένα αντικείμενο να χειριστεί μια αίτηση.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Εντολή</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Εγκαψουλώνει έναν αίτημα σε ένα αντικείμενο, επιτρέποντας έτσι να ρυθμιστούν οι πελάτες με διαφορετικούς αιτήματα, ουρές ή αρχεία καταγραφής, και να υποστηρίζει τις αναστρεψιμένες λειτουργίες.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>διερμηνέας</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Δώσε μια αναπαράσταση της γραμματικής μιας γλώσσας και χρησιμοποίησε αυτή την αναπαράσταση για να ερμηνεύσεις προτάσεις σε αυτή τη γλώσσα.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>επαναληπτής</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Παρέχει έναν τρόπο για να διαπερνάει τα στοιχεία ενός αντικειμένου συσσωρευτικού σε σειρά, χωρίς να αποκαλύπτει την υποκείμενη αναπαράσταση του.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>μεσολαβητής</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Επιτρέπει τη μείωση των پیچικών εξαρτήσεων μεταξύ των αντικειμένων, κάντας τα να επικοινωνούν μόνο μέσω ενός αντικειμένου-μεσολαβητή.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>υπομνηστικό</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Παρέχει τη δυνατότητα να αποκαταστήσει ένα αντικείμενο στην προηγούμενη του κατάσταση (χωρίς να βιάζει την ενσωμάτωση).</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Παρατηρητής</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ορίζει μια μία-σε-πολλή εξάρτηση μεταξύ των αντικειμένων ώστε όταν ένα αντικείμενο αλλάζει κατάσταση, όλοι οι εξαρτητοί του ειδοποιούνται και ενημερώνονται αυτόματα.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Κατάσταση</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Επιτρέπει σε ένα αντικείμενο να αλλάξει τη συμπεριφορά του όταν αλλάζει την εσωτερική κατάσταση του.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Στρατηγική</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Καθορίζει μια οικογένεια αλγόριθμων, περικλείει καθέναν από αυτούς και τα κάνει εναλλάξιμα.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Μέθοδος προτύπου</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ορίζει το σκελετό ενός αλγόριθμου σε μια μέθοδο, μεταφέροντας ορισμένα βήματα στις υποκλάσσες.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Επισκέπτης</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Επιτρέπει τον ορισμό μιας νέας λειτουργίας που θα εκτελείται σε μια δομή αντικειμένων χωρίς να αλλάξουν οι κλάσεις των αντικειμένων πάνω στα οποία λειτουργεί.</p></td> </tr> </tbody> </table> </div> </div> <div class="sect1"> <h2 id="_λειτουργικός_προγραμματισμός">Λειτουργικός προγραμματισμός</h2> <div class="sectionbody"> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 16.6666%;"> <col style="width: 27.7777%;"> <col style="width: 55.5557%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Βιβλιοθήκη</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">URL</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Περιγραφή</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">PyMonad</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://github.com/jasondelaat/pymonad" class="bare">https://github.com/jasondelaat/pymonad</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Το PyMonad είναι μια υλοποίηση μοναδικών δομών δεδομένων στην Python, βασισμένη σε γλώσσες προγραμματισμού όπως το Haskell και το F#, με υλοποιήσεις για τις πιο συχνά使用μένες μορφές μονάδων στον λειτουργικό προγραμματισμό.https://www.miguelfarrajota.com/2021/06/monads-in-python-with-pymonad/[άρθρο]</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">PyFunctional</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://github.com/EntilZha/PyFunctional/" class="bare">https://github.com/EntilZha/PyFunctional/</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">PyFunctional είναι μια βιβλιοθήκη Python για τη λειτουργική προγραμματισμό που παρέχει εργαλεία για να εργαστείτε με καθαρές λειτουργίες και επαναλήψιμα.</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Τουλζ</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://toolz.readthedocs.io/en/latest/" class="bare">https://toolz.readthedocs.io/en/latest/</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Το Toolz είναι μια βιβλιοθήκη Python για τη λειτουργική προγραμματιστική που παρέχει εργαλεία για να εργαστείτε με καθαρές συναρτήσεις και επαναλαμβανόμενες δομές.</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Fn.py</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://github.com/kachayev/fn.py" class="bare">https://github.com/kachayev/fn.py</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Το Fn.py είναι μια βιβλιοθήκη Python για προγραμματισμό λειτουργικό που παρέχει εργαλεία για εργασία με καθαρές λειτουργίες και iterables.</p></td> </tr> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">Κοκός</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><a href="https://coconut-lang.org/" class="bare">https://coconut-lang.org/</a></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Το Coconut προσθέτει muitas λειτουργίες στη γλώσσα Python για τη συναρτησιακή προγραμματισμό, συμπεριλαμβανομένου του pattern matching.https://stackoverflow.com/questions/11909681/are-there-pattern-matching-functions-in-python-like-this[συνομιλία sof]</p></td> </tr> </tbody> </table> <div class="sect2"> <h3 id="_παρενέργειες">παρενέργειες</h3> </div> <div class="sect2"> <h3 id="_βρόχοι">βρόχοι</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-python" data-lang="python"># impérative way result = [] for i in inputs: x = f(g(i)) result.append(x) # idiomatic way result = map(comp(f,g), inputs)</code></pre> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2023/0065_training_web_dev_post.html Thu, 24 Aug 2023 00:00:00 +0000 blog/2023/0065_training_web_dev_post.html https://cheroliv.com/blog/2023/0064_training_trading_card_games_post.html Mon, 21 Aug 2023 00:00:00 +0000 blog/2023/0064_training_trading_card_games_post.html https://cheroliv.com/blog/2023/0063_memo_ts_post.html Sat, 19 Aug 2023 00:00:00 +0000 blog/2023/0063_memo_ts_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>github αποθετήριο:https://github.com/cheroliv/ts-codebase[ts-codebase, window="_blank]</p> </div> </div> </div> <div class="sect1"> <h2 id="toc_ts"><span class="underline">Intro typescript</span></h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#ts_types">Οι τύποι στο TypeScript</a></p> </li> <li> <p><a href="#λειτουργίες">[λειτουργίες]</a></p> </li> <li> <p><a href="#data_struct">Δομή δεδομένων</a></p> </li> <li> <p><a href="#enums_tuples">αριθμητοί και πλεύες</a></p> </li> <li> <p><a href="#void_never">Void και Never</a></p> </li> <li> <p><a href="#class_interface">Κλάσεις και διεπαφές</a></p> </li> <li> <p><a href="#tsconfig">Το αρχείο tsconfig.json</a></p> </li> <li> <p>ενότητες</p> </li> <li> <p><a href="#επιγγελίες">[επιγγελίες]</a></p> </li> <li> <p><a href="#async-await">async/await</a></p> </li> <li> <p><a href="#γενικά">[γενικά]</a></p> </li> </ol> </div> <div class="paragraph"> <p>index.html</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-html" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta http-equiv="X-UA-Compatible" content="ie=edge" /> <title>Document</title> </head> <body> Intro typescript <script src="01_types.js"></script> <script src="02_data_structure.js"></script> <script src="03_enums_tuples.js"></script> </body> </html></code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="ts_types">Οι τύποι στο TypeScript</h2> <div class="sectionbody"> <div class="paragraph"> <p>01_types.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">/** * Les types en typescript */ //quand le type n'est pas defini des le debut, // alors il est réassignable // c'est le type Any qui est attribué par défaut let my_var; my_var = "username"; console.assert(my_var === "username"); my_var = 11; console.assert(my_var === 11); my_var = true; console.assert(my_var === true); let age = 1; console.assert(age === 1); age = 2; // age="trois" c'est impossible // car l'inference de type a attribué le type number console.assert(age === 2); // Déclaration explicite de type let pi: Number = 3.14; console.assert(typeof pi === "number");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="Συναρτήσεις">Συναρτήσεις</h2> <div class="sectionbody"> <div class="paragraph"> <p>Οι συναρτήσεις είναι επαναχρησιμοποιήσιμα τμήματα κώδικα.</p> </div> <div class="paragraph"> <p>Παράδειγμα αξιολόγησης :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">const add = (a: number, b: number): number => a + b;</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="data_struct">Δομή δεδομένων</h2> <div class="sectionbody"> <div class="paragraph"> <p>02_data_structure.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">/*** * Structure de données: * Avec le type any on peut changer * le type de la variable à tout instruction * Lorsque l'on fixe le type * alors il n'est plus possible de le changer * lors d'une assignation */ // Arrays let buddies: any[] = [ "cheroliv", "imrandeh", "issoudeh", "soumi92" ] console.assert(buddies[0] === "cheroliv"); console.assert(buddies[1] === "imrandeh"); console.assert(buddies[2] === "issoudeh"); console.assert(buddies[3] === "soumi92"); // Déclaré en type any, l'inference de type // a bien réaligné en type string console.assert(typeof buddies[0] === "string"); console.assert(typeof buddies[1] === "string"); console.assert(typeof buddies[2] === "string"); console.assert(typeof buddies[3] === "string"); let writers: (String | String | String | Number)[][] = [ ["Chrétien", "de Troyes", "fr", 12], ["François", "Rabelais", "fr", 16], ["René", "Descartes", "fr", 17], ["Jean-Jacques", "Rousseau", "fr", 18], ["Georg", "Hegel", "de", 19], ["Karl", "Marx", "de", 19], ["Friedrich", "Engels", "de", 19], ["Victor", "Hugo", "fr", 19], ["Paul", "Verlaine", "fr", 19], ["Arthur", "Rimbaud", "fr", 19], ["Gérard", "de Nerval", "fr", 19], ["Georg", "Lukacs", "hu", 20], ["Franz", "Kafka", "hu", 20], ["Antonio", "Gramsci", "it", 20], ["Domenico","Losurdo","it",20], ]; // console.table(writers); // Objects let author: { first_name: String, last_name: String, lang: String, century: Number } = { // slice(-1) renvoie le dernier élèment first_name: writers.slice(-1)[0][0] as String, last_name: writers.slice(-1)[0][1] as String, lang: writers.slice(-1)[0][2] as String, century: writers.slice(-1)[0][3] as Number, } // assertion sur la valeur en accés par encapsulation(dot) console.assert(author.first_name === "Antonio") console.assert(author.last_name === "Gramsci") console.assert(author.lang === "it") console.assert(author.century === 20); // assertion sur le type en accès par index console.assert(typeof author["first_name"] === "string") console.assert(typeof author["last_name"] === "string") console.assert(typeof author["lang"] === "string") console.assert(typeof author["century"] === "number");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="enums_tuples">αριθμητοί και πλεύες</h2> <div class="sectionbody"> <div class="paragraph"> <p>03_enums_tuples.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">/** * Enums et Tuples * * Enum: il existe les enums numérique * et les enums chaine de caracteres. * * Tuple: similaire aux arrays mais ne peut * contenir qu'une valeur de type spécifié. * */ //Enum numérique // l'index par de debut défaut est 0 // ici on le place a 1 enum Week { Monday = 1, Tuesday = 2, Wednesday = 3, Thursday = 4, Friday = 5, Saturday = 6, Sunday = 7, }; console.assert(Week.Monday == 1); console.assert(Week.Tuesday == 2); console.assert(Week.Wednesday == 3); console.assert(Week.Thursday == 4); console.assert(Week.Friday == 5); console.assert(Week.Saturday == 6); console.assert(Week.Sunday == 7); console.assert(Week[1] === "Monday"); console.assert(Week[2] === "Tuesday"); console.assert(Week[3] === "Wednesday"); console.assert(Week[4] === "Thursday"); console.assert(Week[5] === "Friday"); console.assert(Week[6] === "Saturday"); console.assert(Week[7] === "Sunday"); let motd_arr_fr: String[] = [ "Associé à la Lune", "Du dieu Tiw, associé à Mars", "Du dieu germanique Odin", "Du dieu germanique du tonnerre Thor", "De la déesse germanique Frigga associée à Vénus", "Associé à Saturne", "Associé au Soleil", ]; let motd_arr_en: String[] = [ "associated with the Moon", "from the god Tiw, associated with Mars", "from Germanic god Odin", "from Germanic god of thunder Thor", "from Germanic goddess Frigga associated with Venus", "associated with Saturn", "associated with the Sun", ]; // Un tuple (triple) let monday_triple_fr: [ Number, String, String ] = [ Week.Monday, Week[Week.Monday], motd_arr_fr[0], ]; console.assert(monday_triple_fr[0] === 1); console.assert(monday_triple_fr[1] === "Monday"); console.assert(monday_triple_fr[2] === "Associé à la Lune"); let monday_triple_en: [ Number, String, String ] = [ Week.Monday, Week[Week.Monday], motd_arr_en[0], ]; console.assert(monday_triple_en[0] === 1); console.assert(monday_triple_en[1] === "Monday"); console.assert(monday_triple_en[2] === "associated with the Moon"); // On se fait un type pour ajouter le nom de la langue type Meaning_of_the_day = { lang: String, meaning: (Week | String)[][], }; //fonction d'affichage du type Meaning_of_the_day const display_motd = (motd: Meaning_of_the_day) => { motd.meaning.forEach(day => console.table(`${Week[day[0] as Week]}: ${day[1]}.(${motd.lang})`) ) }; //fonction d'assertion sur le type Meaning_of_the_day // afin de verifier la concordance du contenu avec // motd_arr_#lang# const test_motd = ( motd: Meaning_of_the_day, motd_arr: String[] ) => { console.assert(motd.lang.length === 2) for (const [i, value] of motd.meaning.entries()) { console.assert(value[1] === motd_arr[i]); } }; let motd_fr: Meaning_of_the_day = { lang: "fr", meaning: [ [Week.Monday, motd_arr_fr[0]], [Week.Tuesday, motd_arr_fr[1]], [Week.Wednesday, motd_arr_fr[2]], [Week.Thursday, motd_arr_fr[3]], [Week.Friday, motd_arr_fr[4]], [Week.Saturday, motd_arr_fr[5]], [Week.Sunday, motd_arr_fr[6]], ], } console.log("---------"); console.log("display_motd(motd_fr):"); display_motd(motd_fr); test_motd(motd_fr, motd_arr_fr) let motd_en: Meaning_of_the_day = { lang: "en", meaning: [ [Week.Monday, motd_arr_en[0]], [Week.Tuesday, motd_arr_en[1]], [Week.Wednesday, motd_arr_en[2]], [Week.Thursday, motd_arr_en[3]], [Week.Friday, motd_arr_en[4]], [Week.Saturday, motd_arr_en[5]], [Week.Sunday, motd_arr_en[6]], ], } console.log("---------"); console.log("display_motd(motd_en):"); display_motd(motd_en); console.log("---------"); test_motd(motd_en, motd_arr_en); // Un tuple (triple) utilisant le type // Meaning_of_the_day pour peupler le meaning let motd_triple: [ Number, String, String ] = [ Week.Monday, Week[Week.Monday], motd_fr.meaning[0][1] as String ]; console.assert(motd_triple[0] === 1); console.assert(motd_triple[1] === "Monday"); console.assert(motd_triple[2] === "Associé à la Lune");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="void_never">Void και Never</h2> <div class="sectionbody"> <div class="paragraph"> <p>04_void_never_types.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">// Le type void est l'opposé du type any // c'est l'absence de type. function verify_writers_length(): void { console.assert(writers.length > 0); } verify_writers_length(); const verify_writers_length_arrow = (): void => console.assert(writers.length > 0); verify_writers_length_arrow(); //Type of et never let value = 30; console.assert(typeof value === "number"); //never: qqchs qui n'arrive jamais function foo(x: String | Number): Boolean { if (typeof x === "string") { return true; } else if (typeof x === "number") { return false; } return fail("Error!") } function fail(message: String): never { throw new Error(message as string); }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="class_interface">Κλάσεις και διεπαφές</h2> <div class="sectionbody"> <div class="paragraph"> <p>04_κενό_ποτέ_τύποι.ts</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">/** * Les classes: * members, * visibility, * nommage, * accesseurs * scope identifier: static,private,protected * * convention de nommage : * Les membres private sont préfixés avec un _ * */ class Member { username: String = ""; email: String = ""; private _password: String = ""; readonly signup_date: Date = new Date(Date.now()); constructor(username: String, email: String) { this.username = username; this.email = email; } get password(): String { return this._password; } set password(new_password: String) { this._password = new_password; } /** * Une fonction static qui initilise un member, * à partir d'un author */ static fromAuthor(author: { first_name: String, last_name: String, lang: String, century: Number }): Member { return new Member( `${author.first_name}.${author.last_name}`, `${author.first_name}.${author.last_name}@acme.com`, ); } }; let domenico = Member.fromAuthor(author); domenico.password = "test"; console.assert(domenico.email === "Domenico.Losurdo@acme.com"); console.assert(domenico.password === "test"); // Héritage enum Forms { Undefined = 0, Polygones = 1, Circle = 2, Straight = 3, Segment = 4, }; class Form { type: Forms = Forms.Undefined; }; class Rectangle extends Form { h: Number = 0; w: Number = 0; }; class Square extends Rectangle { side: Number = 0; }; /** * Interface donne un contrat à un type. * Les interfaces permettent de définir la structure d'un objet. */ interface IPerson { username: String; email: String; readonly signup_date: Date; } const user1: IPerson = { username: Member.fromAuthor(author)["username"], email: Member.fromAuthor(author)["email"], signup_date: Member.fromAuthor(author)["signup_date"], }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="tsconfig">Το αρχείο tsconfig.json</h2> <div class="sectionbody"> <div class="paragraph"> <p>tsconfig.json</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-json" data-lang="json">{ /* Visit https://aka.ms/tsconfig to read more about this file */ "compileOnSave": true, "compilerOptions": { "target": "es2016", "module": "CommonJS", "noEmitOnError": true, "strict": true, "noImplicitAny": true, "esModuleInterop": true } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="modules">Μονάδες</h2> <div class="sectionbody"> <div class="paragraph"> <p>Τα modules επιτρέπουν την οργάνωση του κώδικα σε πολλά αρχεία.</p> </div> <div class="paragraph"> <p>Παράδειγμα βαθμολογίας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">// Dans un fichier math.ts export const add = (a: number, b: number): number => a + b; // Dans un autre fichier import { add } from './math'; let result = add(2, 3);</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="προμηθίες">Προμηθίες</h2> <div class="sectionbody"> <div class="paragraph"> <p>Οι promises χρησιμοποιούνται για την εκτέλεση ασυγχρονών λειτουργιών.</p> </div> <div class="paragraph"> <p>Παράδειγμα βαθμολογίας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">const promise = new Promise<string>((resolve) => { // Code asynchrone ici resolve("Succès"); }); promise.then((result) => { console.log(result); });</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="async-await">async/await</h2> <div class="sectionbody"> <div class="paragraph"> <p>Το async/await απλοποιεί τη διαχείριση των υποσχέσεων.</p> </div> <div class="paragraph"> <p>Παράδειγμα βαθμολογίας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">const fetchData = async (): Promise<void> => { const result = await someAsyncFunction(); console.log(result); };</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_ts"><span class="underline">Intro typescript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="generiques">γενेरικά</h2> <div class="sectionbody"> <div class="paragraph"> <p>Τα γενériques επιτρέπουν τη δημιουργία επαναχρησιμοποιήσιμων στοιχείων με δυνατικούς τύπους.</p> </div> <div class="paragraph"> <p>Παράδειγμα βαθμολογίας :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-typescript" data-lang="typescript">const identity = <T>(arg: T): T => arg; const output = identity<string>("hello"); console.log(output);</code></pre> </div> </div> </div> </div> https://cheroliv.com/blog/2023/0062_memo_css_post.html Mon, 14 Aug 2023 00:00:00 +0000 blog/2023/0062_memo_css_post.html <div class="sect1"> <h2 id="toc">Πίνακας περιεχομένων</h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#good_links">Καλοί σύνδεσμοι</a></p> </li> <li> <p><a href="#repo">Αποθετήριο και δείγματικός κώδικας</a></p> </li> <li> <p><a href="#toc_début">[toc_début]</a></p> </li> </ol> </div> <div class="sect2"> <h3 id="good_links">Καλοί σύνδεσμοι</h3> <div class="paragraph"> <p><a href="#toc">Πίνακας περιεχομένων</a></p> </div> </div> <div class="sect2"> <h3 id="repo">Αποθετήριο και δείγματικός κώδικας</h3> <div class="paragraph"> <p>αποθετήριο github:https://github.com/cheroliv/css-codebase[css-codebase, window = "_blank]</p> </div> </div> <div class="sect2"> <h3 id="toc_αρχή"><span class="underline">Έναρξη CSS</span></h3> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#αρχή_εισαγωγή">[αρχή_εισαγωγή]</a></p> </li> <li> <p>(empty)</p> </li> <li> <p><a href="#αρχή_background">Background</a></p> </li> <li> <p><a href="#début_boxes">Οι κουτιά (boxes)</a></p> </li> <li> <p><a href="#αρχή_flexbox">Flexbox</a></p> </li> <li> <p><a href="#αρχή_grid">Grid</a></p> </li> <li> <p><a href="#αρχή_abs_θέση">[αρχή_abs_θέση]</a></p> </li> <li> <p><a href="#αρχή_responsive">[αρχή_responsive]</a></p> </li> <li> <p><a href="#αρχή_συμπέρασμα">Debug & σύναξη</a></p> </li> </ol> </div> <div class="paragraph"> <p><a href="#toc">Πίνακας περιεχομένων</a></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="début_intro">Εισαγωγή & Προετοιμασία</h2> <div class="sectionbody"> <div class="paragraph"> <p>Εισαγωγή βασισμένη σε αυτό το βίντεο:</p> </div> <div class="videoblock"> <div class="content"> <iframe src="https://www.youtube.com/embed/iSWjmVcfQGg?rel=0" frameborder="0" allowfullscreen></iframe> </div> </div> <div class="paragraph"> <p>αποθετήριο GitHub:https://github.com/cheroliv/css-codebase/début_css/[αρχή css, window = "_blank]</p> </div> <div class="paragraph"> <p>πηγή της σημείωσης:<br> index.html</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-html" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> <div class="grid"> <h2>Grid</h2> <div class="grid-container"> <img src="./assets/img/css-logo.png" alt="logo css" /> <form action=""> <input type="text" id="firstname" placeholder="Prénom" /> <input type="text" id="surname" placeholder="Nom" /> <textarea cols="30" rows="10" placeholder="Ici votre message" ></textarea> <input type="submit" value="Valider" id="btn-submit" /> </form> </div> </div> <div class="absolute"> <h2>Absolute</h2> <span id="circle1"></span> <span id="circle2"></span> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p>Συνδέστε το αρχείο style.css στη σελίδα html:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-html" data-lang="html"></head> <link rel="stylesheet" href="style.css" /> </head></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_αρχή"><span class="underline">Έναρξη CSS</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_texts">Τα κείμενα</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-css" data-lang="css">/* import remote de font sur l'ensemble de la feuille*/ @import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); /* import local de font */ @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } /* body est le parent de toutes les balises, qu'il contient, donc je le déclare avant, pour la logique de précédence de parent */ body { /* si DMSerif n'est pas trouvé alors il se rabat sur Verdana*/ font-family: "DMSerif", Verdana; } /* va styliser toutes les balises h1, celles de body sont surchargés, par la déclaration présente */ h1 { text-transform: uppercase; /* espacement entre les lettres en pixel*/ letter-spacing: 3px; /* alignement du texte*/ text-align: center; /* Les tailles de polices doivent être en REM (rem = root em). Le REM se base pas sur l'élément parent pour obtenir sa taille mais sur l'élément racine. Ainsi 1rem prendra sa valeur de la font-size de votre document (body ou html).*/ font-size: 2.5rem; /* ombrage du texte */ text-shadow: 3px /* offset-x */ 3px /* offset-y */ 8px /* blur-radius */ #00000042/* color */; /* couleur du texte */ color: #ab0ef4; /*attibuer les polices(font): liste, ordonnée par priorité, de polices à utiliser pour mettre en forme le texte de l'élément ciblé.*/ font-family: "Oswald", sans-serif; /* surligner le text*/ text-decoration: underline; }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_αρχή"><span class="underline">Έναρξη CSS</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="αρχή_background">Background</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-css" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; /* image comme background*/ background: url(./assets/img/bg.jpg) center/cover; /* 100VH = 100% de la taille de l'écran (viewport height) min afin de ne pas bloquer la possibilité d'avoir un plus grand */ min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_début">[toc_début]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_boxes">Οι κουτιά (boxes)</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-css" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } /* *: létoile donne du style a tous les éléments. Ensuite remettre un à un les parametres par defaut afin d'eviter les stylisation inattendu.*/ * { /* surcharge de base tous les elements à padding 0*/ margin: 0; /* surcharge de base tous les elements à padding 0*/ padding: 0; } body { font-family: "DMSerif", Verdana; /* image comme background*/ background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; /* quelque soit la taille de l'écran, la boite fait toujours 90% de la taille de la page, les 10% restant sont une marge à droite, pour avoir 5% de chaque coté on ajoute une margin, tel que [0, auto]*/ width: 90%; /* haut bas prend 0, et gauche droite prend auto(center cad meme de chaque cotés)*/ margin: 0 auto; /* on ajoute des bords a notre boite*/ border: 2px solid rgb(0, 140, 255); /* on arrondis les coins de la boite*/ border-radius: 20px 20px 0 0; /* ombrage sur la boite*/ box-shadow: 0px 0px 20px 4px #81cfc6; /* marge interrieure de la boite sur tous les cotés*/ padding: 15px; } h2 { /* afin de recuprer le comportement par defaut qui a ete surchargé par l'operateur étoile*/ margin: 0; }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-html" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_αρχή"><span class="underline">Έναρξη CSS</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="αρχή_flexbox">Flexbox</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-css" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; width: 90%; margin: 0 auto; border: 2px solid rgb(0, 140, 255); border-radius: 20px 20px 0 0; box-shadow: 0px 0px 20px 4px #81cfc6; padding: 15px; } h2 { margin: 0; } /* le point permet d'acceder à la classe d'un composant*/ .flexbox { border: 2px solid skyblue; border-radius: 10px; padding: 10px; margin-top: 20px; min-height: 150px; } /* FLEXBOX */ /* Sert à répartir équitablement des éléments sur la page */ .flexbox ul { padding: 0; /* aligne les éléments enfants de ul(les li)*/ display: flex; /* reparti convenablement(équitablement les li sur la page) */ justify-content: space-around; } /* ce style concerne les li de la classe, flexbox des balises qui y font referencent*/ .flexbox li { /* suprime les boules des éléments de la list li*/ list-style: none; height: 160px; width: 160px; margin: 10px; background: turquoise; /* Centrer un unique élément verticalement et horizontalement */ display: flex; justify-content: center; align-items: center; }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-html" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_αρχή"><span class="underline">Έναρξη CSS</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="αρχή_grid">Grid</h2> <div class="sectionbody"> <div class="paragraph"> <p>Για να κατανεμείτε στοιχεία με έναν λίγο πιο πολύπλοκο τρόπο από το Flexbox, με ένα σύστημα πλέγματος, μεταξύ άλλων.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-css" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; width: 90%; margin: 0 auto; border: 2px solid rgb(0, 140, 255); border-radius: 20px 20px 0 0; box-shadow: 0px 0px 20px 4px #81cfc6; padding: 15px; } h2 { margin: 0; } .flexbox, .grid { border: 2px solid skyblue; border-radius: 10px; padding: 10px; margin-top: 20px; min-height: 150px; } .flexbox ul { padding: 0; display: flex; justify-content: space-around; } .flexbox li { list-style: none; height: 160px; width: 160px; margin: 10px; background: turquoise; display: flex; justify-content: center; align-items: center; } /* GRID */ .grid-container { display: grid; /* séparatuion de la grille en deux(à ses deux enfants), avec à gauche 30% pour l'image et à droite 70% pour le formulaire*/ grid-template-columns: 30% 70%; } /* sizing de l'image css-logo contenu dans la classe grid qui est dans le parent grid-container*/ .grid img { /* l'image remplt 80% de part de grille*/ width: 80%; margin: 20px auto; display: block; } form { display: grid; /* deux colonnes de chacune 1 fraction*/ grid-template-columns: 1fr 1fr; /* trois rangés de chacune 1 fraction*/ grid-template-rows: 1fr 1fr 1fr; /* structuration sous forme de template de notre repartition des composants enfants de la forme*/ grid-template-areas: "i1 i2"/* i1: input1, i2:input2*/ "ta ta"/*ta: text area */ "vi bt"/*vi:, bt: bouton */; } /* on donne du style sur deux éléments en meme temps en les listant avant les parentheses*/ input, textarea { margin: 5px; border: 1px solid darkblue; padding: 10px; font-size: 1.1rem; font-family: "DMSerif"; border-radius: 5px; } /* donner du style uniquement la textearea*/ textarea { /* renseigner le nommage pour le grid template area*/ grid-area: ta; height: 40px; /* empeche le cassage du style de la page en empechant le resizing de la textarea du formulaire*/ resize: none; } /* pour pointer un id d'élément html on utilise la notation préfixe # */ #btn-submit { /* renseigner le nommage*/ grid-area: bt; /* change le le symbole de curseur souris quand il survole sur le bouton*/ cursor: pointer; background: cyan; transition: 0.2s; } /* au survole(hover) de la souris le bouton change de comportement*/ #btn-submit:hover { background: darkblue; /* couleur de text du bouton devient blanc*/ color: white; }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-html" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> <div class="grid"> <h2>Grid</h2> <div class="grid-container"> <img src="./assets/img/css-logo.png" alt="logo css" /> <form action=""> <input type="text" id="firstname" placeholder="Prénom" /> <input type="text" id="surname" placeholder="Nom" /> <textarea cols="30" rows="10" placeholder="Ici votre message"></textarea> <input type="submit" value="Valider" id="btn-submit" /> </form> </div> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_αρχή"><span class="underline">Έναρξη CSS</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_abs_pos">Απόλυτη θέση</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-css" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; width: 90%; margin: 0 auto; border: 2px solid rgb(0, 140, 255); border-radius: 20px 20px 0 0; box-shadow: 0px 0px 20px 4px #81cfc6; padding: 15px; } h2 { margin: 0; } .flexbox, .grid, .absolute { border: 2px solid skyblue; border-radius: 10px; padding: 10px; margin-top: 20px; min-height: 150px; } .flexbox ul { padding: 0; display: flex; justify-content: space-around; } .flexbox li { list-style: none; height: 160px; width: 160px; margin: 10px; background: turquoise; display: flex; justify-content: center; align-items: center; } .grid-container { display: grid; grid-template-columns: 30% 70%; } .grid img { width: 80%; margin: 20px auto; display: block; } form { display: grid; grid-template-columns: 1fr 1fr; grid-template-rows: 1fr 1fr 1fr; grid-template-areas: "i1 i2" "ta ta" "vi bt"; } input, textarea { margin: 5px; border: 1px solid darkblue; padding: 10px; font-size: 1.1rem; font-family: "DMSerif"; border-radius: 5px; } textarea { grid-area: ta; height: 40px; resize: none; } #btn-submit { grid-area: bt; cursor: pointer; background: cyan; transition: 0.2s; } #btn-submit:hover { background: darkblue; color: white; } /* ABSOLUTE */ /* Sans élément en Relative, de base, l'élément en absolute l'est par rapport au Body */ /* Il faut mettre une position relative au parent pour contraindre l'élément en absolute dans ses frontières */ .absolute { /* position relative par rapport à son parent, donc contenu dans les frontieres de son parents*/ position: relative; } #circle1 { height: 80px; width: 80px; background: skyblue; position: absolute; border-radius: 150px; top: -20px; right: -20px; } #circle2 { height: 40px; width: 40px; border-radius: 150px; background: teal; position: absolute; left: 50%; transform: /*traslate de 50% de la taille du cercle, pour etre centré par rapport au centre du cercle, plutot que sur son bord gauche par défaut.*/ translateX(-50%); top: 100px; }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-html" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> <div class="grid"> <h2>Grid</h2> <div class="grid-container"> <img src="./assets/img/css-logo.png" alt="logo css" /> <form action=""> <input type="text" id="firstname" placeholder="Prénom" /> <input type="text" id="surname" placeholder="Nom" /> <textarea cols="30" rows="10" placeholder="Ici votre message"></textarea> <input type="submit" value="Valider" id="btn-submit" /> </form> </div> </div> <div class="absolute"> <h2>Absolute</h2> <span id="circle1"></span> <span id="circle2"></span> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_αρχή"><span class="underline">Έναρξη CSS</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="début_responsive">Το responsive</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-css" data-lang="css">@import url("https://fonts.googleapis.com/css2?family=Oswald:wght@500&display=swap"); @font-face { font-family: "DMSerif"; src: url(./assets/fonts/DMSerifDisplay-Regular.ttf); } body { font-family: "DMSerif", Verdana; background: url(./assets/img/bg.jpg) center/cover; min-height: 100vh; } h1 { text-transform: uppercase; letter-spacing: 3px; text-align: center; /* pour etre plus responsive on peut passer la taille en vw(view port width) pour qu'elle s'adapte à la taille de l'ecran*/ font-size: 2.5rem; text-shadow: 3px 3px 8px #00000042; color: #ab0ef4; font-family: "Oswald", sans-serif; text-decoration: underline; } main { background: rgba(245, 245, 245, 0.9); min-height: 500px; width: 90%; margin: 0 auto; border: 2px solid rgb(0, 140, 255); border-radius: 20px 20px 0 0; box-shadow: 0px 0px 20px 4px #81cfc6; padding: 15px; } h2 { margin: 0; } .flexbox, .grid, .absolute { border: 2px solid skyblue; border-radius: 10px; padding: 10px; margin-top: 20px; min-height: 150px; } .flexbox ul { padding: 0; display: flex; justify-content: space-around; } .flexbox li { list-style: none; height: 160px; width: 160px; margin: 10px; background: turquoise; display: flex; justify-content: center; align-items: center; } .grid-container { display: grid; grid-template-columns: 30% 70%; } .grid img { width: 80%; margin: 20px auto; /* permet en media query de la centrer en petit écran*/ display: block; } form { display: grid; grid-template-columns: 1fr 1fr; grid-template-rows: 1fr 1fr 1fr; grid-template-areas: "i1 i2" "ta ta" "vi bt"; } input, textarea { margin: 5px; border: 1px solid darkblue; padding: 10px; font-size: 1.1rem; font-family: "DMSerif"; border-radius: 5px; } textarea { grid-area: ta; height: 40px; resize: none; } #btn-submit { grid-area: bt; cursor: pointer; background: cyan; transition: 0.2s; } #btn-submit:hover { background: darkblue; color: white; } .absolute { position: relative; } #circle1 { height: 80px; width: 80px; background: skyblue; position: absolute; border-radius: 150px; top: -20px; right: -20px; } #circle2 { height: 40px; width: 40px; border-radius: 150px; background: teal; position: absolute; left: 50%; transform: translateX(-50%); top: 100px; } /* RESPONSIVE: a partir des tailles d'ecran permet de surcharger les reglages definis plus haut */ @media screen and (max-width: 900px) { .grid-container { display: block; } .grid-container img { width: 40%; } } @media screen and (max-width: 610px) { .flexbox ul { flex-direction: column; align-items: center; } form { grid-template-columns: 1fr; grid-template-rows: 1fr; grid-template-areas: "i1" "i2" "ta" "bt"; } input, textarea { font-size: 0.8rem; } }</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-html" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <title>Cours CSS</title> <link rel="stylesheet" href="style.css" /> </head> <body> <header> <h1>Les bases de CSS</h1> </header> <main> <div class="flexbox"> <h2>Flexbox</h2> <ul> <li>boite 1</li> <li>boite 2</li> <li>boite 3</li> </ul> </div> <div class="grid"> <h2>Grid</h2> <div class="grid-container"> <img src="./assets/img/css-logo.png" alt="logo css" /> <form action=""> <input type="text" id="firstname" placeholder="Prénom" /> <input type="text" id="surname" placeholder="Nom" /> <textarea cols="30" rows="10" placeholder="Ici votre message"></textarea> <input type="submit" value="Valider" id="btn-submit" /> </form> </div> </div> <div class="absolute"> <h2>Absolute</h2> <span id="circle1"></span> <span id="circle2"></span> </div> </main> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_début">[toc_début]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="αρχή_συμπέρασμα">Debug & σύναξη</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-css" data-lang="css">/* all elements: supprime les comportements par défaut*/ * { /* les marges à zéro*/ margin: 0; /* les parge internes(padding) à zéro*/ padding: 0; /* tous les bords avec un cadre rouge de 2px. qui est ou et qui fait quoi...*/ border: 2px solid red; }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_αρχή"><span class="underline">Έναρξη CSS</span></a></p> </div> </div> </div> https://cheroliv.com/blog/2023/0061_memo_html_post.html Sun, 13 Aug 2023 00:00:00 +0000 blog/2023/0061_memo_html_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_καλοί_σύνδεσμοι">καλοί σύνδεσμοι</a></li> <li><a href="#_αποθετήριο_και_δείγμα_κώδικα">Αποθετήριο και δείγμα κώδικα</a></li> </ul> </div> <div class="sect1"> <h2 id="_καλοί_σύνδεσμοι">καλοί σύνδεσμοι</h2> <div class="sectionbody"> <div class="ulist"> <div class="title">html</div> <ul> <li> <p><a href="https://htmlcheatsheet.com" target=""_blank">htmlcheatsheet.com</a>HTML φύλλο βοηθείας</p> </li> </ul> </div> <div class="ulist"> <div class="title">γραμματοσειρά</div> <ul> <li> <p><a href="https://fontawesome.com" target=""_blank">fontawesome.com</a>: βιβλιοθήκη εικονίδων</p> </li> <li> <p><a href="https://www.toptal.com/designers/htmlarrows/symbols/" target=""_blank">toptal.com/designers/htmlarrows/symbols</a>: Εγγενείς εικονίδια σε HTML</p> </li> </ul> </div> <div class="ulist"> <div class="title">ειδικοί χαρακτήρες και διαφυγές</div> <ul> <li> <p><a href="https://www.sonarsource.com/blog/encoding-differentials-why-charset-matters/" class="bare">https://www.sonarsource.com/blog/encoding-differentials-why-charset-matters/</a></p> </li> <li> <p><a href="https://stackoverflow.com/a/3614344/13104550" class="bare">https://stackoverflow.com/a/3614344/13104550</a></p> </li> <li> <p><a href="https://html.spec.whatwg.org/multipage/named-characters.html" class="bare">https://html.spec.whatwg.org/multipage/named-characters.html</a></p> </li> </ul> </div> <div class="paragraph"> <p><a href="#toc">[toc]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_αποθετήριο_και_δείγμα_κώδικα">Αποθετήριο και δείγμα κώδικα</h2> <div class="sectionbody"> <div class="paragraph"> <p>Αποθετήριο GitHub:https://github.com/cheroliv/html-codebase[html-codebase, window = "_blank]</p> </div> <div class="paragraph"> <p>πηγή υπομνηματος:<br> index.html</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlightjs highlight"><code class="language-html hljs" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <!-- Le titre de la page --> <title>Cours HTML</title> <!-- Icone de l'onglet --> <link rel="shortcut icon" href="html-logo.png" /> <link rel="stylesheet" href="https://use.fontawesome.com/releases/v5.8.2/css/all.css" /> </head> <body> <header> <h1>Texte - Titre H1</h1> <p> <em>em pour mettre en italique</em>, <strong>strong pour mettre en gras</strong> <span>L'élement en span ne revient pas à la ligne</span>. </p> <p> Lorem ipsum dolor sit amet consectetur adipisicing elit. Exercitationem cumque ratione veniam officiis nulla a debitis at facilis sed dignissimos. </p> </header> <section> <div> <h2>Photo - Titre H2</h2> <img src="./img-1.jpg" alt="image-arbre" height="200" /> </div> <div> <h3>Liste - Titre H3</h3> <ul> <li>UL = unordered list</li> <li>UL = unordered list</li> <li>UL = unordered list</li> </ul> <ol> <li>OL = ordered list</li> <li>OL = ordered list</li> <li>OL = ordered list</li> </ol> </div> <div> <h4>Tableaux - Titre H4</h4> <table border="4" cellpadding="10" cellspacing="4" style="text-align: center"> <thead> <tr> <th>Col 1</th> <th>Col 2</th> <th>Col 3</th> </tr> </thead> <tbody> <tr> <td rowspan="2">Row 1 Cell 1</td> <td>Row 1 Cell 2</td> <td>Row 1 Cell 3</td> </tr> <tr> <td>Row 2 Cell 2</td> <td>Row 2 Cell 3</td> </tr> <tr> <td colspan="3">Row 3 Cell 1</td> </tr> </tbody> </table> </div> <div> <h5><span>♖</span> Liens - Titre H5</h5> <a href="https://htmlcheatsheet.com/" target="_blank">HTML Cheatsheet</a> <br /> <a href="https://www.toptal.com/designers/htmlarrows/symbols/" target="_blank">Icones natifs en HTML</a> </div> <div> <h6><i class="fas fa-video"></i> Vidéo - Titre H6</h6> <video src="video.mp4" height="150" autoplay loop muted></video> </div> </section> <br /> <!-- Formulaires en HTML --> <section> <h2>Formulaire</h2> <form action="/action.php" method="post"> <label for="name">Nom</label> <input id="name" type="text" placeholder="Entrez votre nom" /><br /> <label for="number">Entrez votre age</label> <input type="number" id="number-age" value="15" oninput="document.getElementById('range-age').value=this.value"> <input type="range" id="range-age" min="0" max="100" oninput="document.getElementById('number-age').value=this.value"><br /> <!-- Input select --> <label for="gender">Genre</label> <select id="gender"> <option selected="selected" value="Homme">Homme</option> <option value="Femme">Femme</option> </select><br /> <!-- Input radio --> <div> <input type="radio" name="type" id="human" checked /> <label for="human">Humain</label> <input type="radio" name="type" id="dog" /> <label for="dog">Chien</label> <input type="radio" name="type" id="cat" /> <label for="cat">Chat</label> </div> <textarea cols="20" rows="5" placeholder="Votre message..."></textarea><br /> <!-- Input Checkbox --> <label><input type="checkbox" />Accepter les CGV</label> <br /> <input type="submit" value="Submit" /> </form> </section> <br /> <!-- Mail & envoi de fichiers --> <footer> <a href="mailto:fs@gmail.com">Ecrivez-moi !</a> <br /> <a href="notice.txt" download="nom-du-fichier">Télécharger la notice</a> <details> <summary>Plus d'infos</summary> <p> Lorem ipsum dolor, sit amet consectetur adipisicing elit. Harum, repellendus. </p> </details> </footer> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">[toc]</a></p> </div> </div> </div> https://cheroliv.com/blog/2023/0060_memo_js_post.html Fri, 4 Aug 2023 00:00:00 +0000 blog/2023/0060_memo_js_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p>αποθετήριο GitHub:https://github.com/cheroliv/js-codebase[js-codebase, window="_blank]</p> </div> </div> </div> <div class="sect1"> <h2 id="toc_js"><span class="underline">Εισαγωγή JavaScript</span></h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#start">Μεταβλητές, αριθμητικοί τελεστές και αλφαριθμητικές συμβολοσειρές</a></p> </li> <li> <p><a href="#arrays">Οι arrays</a></p> </li> <li> <p><a href="#λειτουργίες">[λειτουργίες]</a></p> </li> <li> <p><a href="#param_x_scope">Παράμετροι και εμβελιές</a></p> </li> <li> <p><a href="#objects">Τα objects</a></p> </li> <li> <p><a href="#βρόχοι">[βρόχοι]</a></p> </li> <li> <p><a href="#const_var_let">Const, var και let</a></p> </li> <li> <p><a href="#rest_and_spread_operators">Rest και spread operators</a></p> </li> <li> <p><a href="#destructuring">διάσπαση</a></p> </li> <li> <p><a href="#import_export">Εισαγωγή και εξαγωγή modules</a></p> </li> <li> <p><a href="#τάξεις">[τάξεις]</a></p> </li> </ol> </div> <div class="paragraph"> <p>index.html</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-html" data-lang="html"><!DOCTYPE html> <html lang="fr"> <head> <meta charset="UTF-8"> <title>Document</title> <meta name="viewport" content="width=device-width, initial-scale=1.0" /> <meta http-equiv="X-UA-Compatible" content="ie=edge" /> </head> <body> index <script src="01_start.js"></script> <script src="02_arrays.js"></script> <script src="03_functions.js"></script> <script src="04_param_x_scope.js"></script> <script src="05_objects.js"></script> <script src="06_loops.js"></script> <script src="07_const_var_let.js"></script> <script src="08_rest_and_spread_operators.js"></script> <script src="09_destructuring.js"></script> <script src="10_module_import_export.js"></script> </body> </html></code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="start">Μεταβλητές, αριθμητικοί τελεστές και αλφαριθμητικές συμβολοσειρές</h2> <div class="sectionbody"> <div class="paragraph"> <p>01_start.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Variables */ //une variable stupide var my_variable = "dummy variable"; console.log(my_variable); //assertion console.assert(my_variable === "dummy variable"); var username = "cheroliv"; console.log(username); console.assert(username === "cheroliv"); //concaténation de string console.assert(username === "cher" + "oliv"); /** * Opérateur arithmétique: + - * / % */ //integer var x = 10; var y = 5; var z = 20; console.log(x + y); console.assert(x + y === 15); console.log(x + y - z); console.assert(x + y - z === -5); console.log(x - y); console.assert(x - y === 5); console.log(x * y); console.assert(x * y === 50); console.log(x / y); console.assert(x / y === 2); console.log("---------"); x = 20; y = 10; console.log(x + y); console.assert(x + y === 30); console.log(x + y - z); console.assert(x + y - z === 10); console.log(x - y); console.assert(x - y === 10); console.log(x * y); console.assert(x * y === 200); console.log(x / z); console.assert(x / z === 1); //Littéraux de gabarits pour string avec backstick ` //Template literals (Template strings) console.assert(`typeof z: ${typeof z}` === "typeof z: number"); console.log(`x is type of : ${typeof x}`); console.log(`y is type of : ${typeof y}`); console.log(`z is type of : ${typeof z}`); //typeof: donne le type de la variable console.assert(typeof x === "number"); console.assert(typeof y === "number"); console.assert(typeof z === "number"); console.log("---------"); /** * Incrémenation/décrémentation */ //incrémantation/décrémentation préfixe console.log(++x) //incrémenté puis affiché: 21 console.log(x) //la valeur incrémenté: 21 //incrémantation/décrémentation suffixe console.log(y++) //affiche la valeur sans incrémenation puis incrémente: 10 console.log(y) //la valeur incrémenté: 11 //décrémentation x--; y--; console.assert(x === 20); console.assert(y === 10); /** * String: chaine de caractères */ console.log(`username: ${username}`); //taille de la string console.log(`username.length: ${username.length}`); console.assert(username.length === 8); console.assert(username.length === "cheroliv".length); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="arrays">Οι arrays</h2> <div class="sectionbody"> <div class="paragraph"> <p>02_arrays.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Les arrays */ // auteurs [["nom ", "prénom", "pays"]] var writers = [ ["Karl", "Marx", "de"], ["Jean-Jacques", "Rousseau", "fr"], ["Victor", "Hugo", "fr"], ["René", "Descartes", "fr"], ["Paul", "Verlaine", "fr"], ["Antonio", "Gramsci", "it"], ["Georg", "Lukacs", "hu"], ["Franz", "Kafka", "hu"], ["Arthur", "Rimbaud", "fr"], ["Gérard", "de Nerval", "fr"], ["Chrétien", "de Troyes", "fr"], ["François", "Rabelais", "fr"], ["Georg", "Hegel", "de"], ["Friedrich", "Engels", "de"], ] console.table(writers); // accés aux élèments du tableau console.log(writers[0]); console.log(`${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); console.assert("Karl, Marx (de)" === `${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); //sauvegarder la valeur du prénom de Marx var karl = writers[0][0] //éditer un élement du tableau, le prénom de Marx writers[0][0] = "Karlito" console.log(`${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); console.assert("Karlito, Marx (de)" === `${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); console.assert("Karl" === karl); //remettre la valeur initale du prénom de Marx writers[0][0] = karl; console.assert(`${karl}, Marx (de)` === `${writers[0][0]}, ${writers[0][1]} (${writers[0][2]})`); console.log("---------"); /** * Arrays: map/forEach/pop/push/slice/sort/shift/unshift */ var numbers = [1, 5, 4, 3, 2]; console.log("Iterate with forEach"); // parcourir avec array.forEach numbers.forEach((it) => console.log(it)); console.log("---------"); console.log("Iterate with map"); // parcourir avec array.map numbers.map((it) => console.log(it)); console.log("---------"); //afficher les éléments sur une ligne //génère la string avec le formatage des nombres const numbersString = (numberArray) => { var consoleOutput = new String(); numberArray.forEach(number => consoleOutput += `${number}, `); return consoleOutput = consoleOutput.substring(0, consoleOutput.length - 2); }; //affiche la chaine entre crochets dans la console const displayNumbers = (numbersStr) => { console.log(`[${numbersString(numbersStr)}]`); }; console.log("orginal number array") displayNumbers(numbers); console.log("---------"); //push: ajoute à la fin console.log("push"); numbers.push(6); displayNumbers(numbers); console.log("---------"); //pop: suprime le dernier console.log("pop"); numbers.pop(); displayNumbers(numbers); console.log("---------"); //unshift: ajouter le parametre au debut de l'array console.log("unshift"); numbers.unshift(0); displayNumbers(numbers); console.log("---------"); //shift: supprime le premier element de l'array console.log("shift"); numbers.shift(); displayNumbers(numbers); console.log("---------"); //slice: renvoi l'array entre les positions en argument console.log("slice"); var sliceNumbersResult = numbers.slice(2, 4); displayNumbers(sliceNumbersResult); console.log("---------"); //sort asc console.log("sort asc"); var ascSort = numbers.sort((a, b) => a - b); displayNumbers(ascSort); console.log("---------"); //sort desc console.log("sort desc"); var descSort = numbers.sort((a, b) => b - a); displayNumbers(descSort); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="functions">Οι λειτουργίες</h2> <div class="sectionbody"> <div class="paragraph"> <p>03_συναρτήσεις.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Les fonctions */ //function style legacy function sayHelloWorldLegacy() { console.log("Hello world legacy!"); } sayHelloWorldLegacy(); function sayHelloLegacy(firstName, lastName, style) { console.log(`Hello ${firstName}, ${lastName} (${style})`); } sayHelloLegacy("Cher", "Oliv", "legacy"); console.log("---------"); //function style arrow const sayHelloWorld = () => console.log("Hello world!"); sayHelloWorld(); const sayHello = (firstName, lastName) => console.log(`Hello ${firstName}, ${lastName}`); sayHello("Cher", "Oliv"); console.log("---------"); var authors = [ ["Chrétien", "de Troyes", "fr"], ["François", "Rabelais", "fr"], ["René", "Descartes", "fr"], ["Jean-Jacques", "Rousseau", "fr"], ["Georg", "Hegel", "de"], ["Karl", "Marx", "de"], ["Friedrich", "Engels", "de"], ["Victor", "Hugo", "fr"], ["Paul", "Verlaine", "fr"], ["Antonio", "Gramsci", "it"], ["Georg", "Lukacs", "hu"], ["Franz", "Kafka", "hu"], ["Arthur", "Rimbaud", "fr"], ["Gérard", "de Nerval", "fr"], ] const displayAuthors = (authorsArray) => authorsArray.forEach(author => console.log(`${author[0]} ${author[1]}, (${author[2]})`) ); displayAuthors(authors); console.log("---------"); /** * valeur par défaut des parametres d'une fonctions */ const add = (a = 0, b = 0) => a + b; console.assert(add() === 0) console.assert(add(1) === 1) console.assert(add(1, 1) === 2) console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="param_x_scope">Παράμετροι και εμβελιές</h2> <div class="sectionbody"> <div class="paragraph"> <p>04_param_x_scope.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">//global scope: visible partout, dans et hors functions var global; const foo = () => { //local scope: visible uniquement dans la fonction foo var bar = "bar" console.log(bar) } foo(); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="objects">Τα objects</h2> <div class="sectionbody"> <div class="paragraph"> <p>05_objects.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Les objects */ var authors = [ ["Chrétien", "de Troyes", "fr"], ["François", "Rabelais", "fr"], ["René", "Descartes", "fr"], ["Jean-Jacques", "Rousseau", "fr"], ["Georg", "Hegel", "de"], ["Karl", "Marx", "de"], ["Friedrich", "Engels", "de"], ["Victor", "Hugo", "fr"], ["Paul", "Verlaine", "fr"], ["Antonio", "Gramsci", "it"], ["Georg", "Lukacs", "hu"], ["Franz", "Kafka", "hu"], ["Arthur", "Rimbaud", "fr"], ["Gérard", "de Nerval", "fr"], ]; var hugo = { firstName: authors[7][0], lastName: authors[7][1], country: authors[7][2], }; var book = { author: hugo, title: "Les misérables" }; console.log(hugo); console.log(book); //accéder à un membre de l'objet par point console.log(hugo.country); //accéder à un membre de l'objet par crochet console.log(book["title"]); console.log(book.author.lastName); console.log(book["author"]["firstName"]); //ajouter une clé a un objet hugo.gender = "non binary"; console.assert(hugo.gender === "non binary"); //mettre à jour une clé hugo.gender = "male"; console.assert(hugo.gender !== "non binary"); console.assert(hugo["gender"] === "male"); //supprimer une clé delete hugo.gender; //verfier que l'objet ne contient pas la clé gender console.assert(!Object.keys(hugo).includes("gender")); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="loops">Οι βρόχοι</h2> <div class="sectionbody"> <div class="paragraph"> <p>06_loops.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Les boucles: Itérer sur arrays et objets. */ console.log("for loop over array"); var numbers = [12, 10, 8, 6, 4, 2, 0]; for (number of numbers) { console.log(number); } console.log("---------"); console.log("for loop over object key"); var obj = { a: 1, b: 2, c: 3, d: 4 }; for (key in obj) { console.log(key); } console.log("---------"); console.log("for loop over object value"); for (value in obj) { console.log(obj[value]); } console.log("---------"); console.log("another for loop over authors array") var authors = [ ["Chrétien", "de Troyes", "fr"], ["François", "Rabelais", "fr"], ["René", "Descartes", "fr"], ["Jean-Jacques", "Rousseau", "fr"], ["Georg", "Hegel", "de"], ["Karl", "Marx", "de"], ["Friedrich", "Engels", "de"], ["Victor", "Hugo", "fr"], ["Paul", "Verlaine", "fr"], ["Antonio", "Gramsci", "it"], ["Georg", "Lukacs", "hu"], ["Franz", "Kafka", "hu"], ["Arthur", "Rimbaud", "fr"], ["Gérard", "de Nerval", "fr"], ]; for (const [i, value] of authors.entries()) { console.log(`${value[0]}, ${value[1]} (${value[2]})`); } console.log("---------"); console.log("while loop over array") var i = 0 while (i < authors.length) { console.log(`${authors[i][0]}, ${authors[i][1]} (${authors[i][2]})`); i++; } console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="const_var_let">Const, var και let</h2> <div class="sectionbody"> <div class="paragraph"> <p>07_const_var_let.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * const X var X let */ //var x du if n'est pas confiné au scope du if const varTest = () => { var x = 1; console.log(x); console.assert(x === 1); if (true) { var x = 2; console.log(x); console.assert(x === 2); } console.log(x); console.assert(x !== 1); console.assert(x === 2); } varTest(); console.log("---------"); //var x est global à tous les fichier js //chargés dans la page html //var x issue du fichier 1_start.js //ligne 46 console.log(x); console.assert(x === 20); console.log("---------"); //premier let x est confiné au scope de la fonction //le let x du if est confiné au scope du if const letTest = () => { let x = 1; console.log(x); console.assert(x === 1); if (true) { let x = 2; console.log(x); console.assert(x === 2); } console.log(x); console.assert(x === 1); console.assert(x !== 2); } letTest(); console.log("---------"); /** * const: déclare un emplacement mémoire non réattribuable * c'est modifiable pour un array, * mais non réinitialisable; * ex: * const arr = [25, 27, 29] * arr = [5, 7] //impossible * arr[0]=20 // possible * ex: * const n = 1; * n = 3; //impossible */ const arr = [25, 27, 29] console.table(arr); arr[0] = 20 // possible console.table(arr); arr.pop() console.table(arr); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="rest_and_spread_operators">Rest και spread operators</h2> <div class="sectionbody"> <div class="paragraph"> <p>08_αναπαύλη_και_διάσπορα_operators.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Opérateur de rest: * const add = (...operandes) => a + b; * ou avec parametres avec valeur par défaut * const add = (a=0, b=0, ...operandes) => a + b; */ /** * spread opérateur: * récupère l'ensemble des elements d'une collection, * dans un array */ const user_ages = [25, 56, 12, 58, 41, 62, 26]; const max_user_age = Math.max(...user_ages); const min_user_age = Math.min(...user_ages); console.assert(max_user_age == 62); console.assert(min_user_age == 12); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="destructuring">διάσπαση</h2> <div class="sectionbody"> <div class="paragraph"> <p>09_destructuring.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * L'affectation par décomposition (destructuring) */ const user = { first_name: "Oliv", last_name: "Cher", nick_name: "cheroliv", gender: "male", is_adult: true }; console.log(user); //première façon d'initaliser des variables sans destructuration let first_name_legacy = user.first_name; let last_name_legacy = user.last_name; let nick_name_legacy = user.nick_name; let gender_legacy = user.gender; let is_adult_legacy = user.is_adult; console.assert("Oliv" === first_name_legacy); console.assert("Cher" === last_name_legacy); console.assert("cheroliv" === nick_name_legacy); console.assert("male" === gender_legacy); console.assert(true === is_adult_legacy); console.log("---------"); /** * Initialisation par déstructuration */ const { first_name, last_name, nick_name, gender, is_adult } = user; console.assert(user.first_name === first_name); console.assert(user.last_name === last_name); console.assert(user.nick_name === nick_name); console.assert(user.gender === gender); console.assert(user.is_adult === is_adult); /** * Intialisation par déstructuration des arrays */ //cible explicite const [a1, a2] = [15, 25, 17, 81, 51, 46]; console.assert(a1 === 15); console.assert(a2 === 25); //cible avec position par rapport aux index par virgules //je veux b3 à 46 const [b1, b2, , , , b3] = [15, 25, 17, 81, 51, 46]; console.assert(b1 === 15); console.assert(b2 === 25); console.assert(b3 === 46); //déstructuration avec operateur de rest // je contruit un autre avec avec les elements // à partir du premier élèment non destructuré const [c1, c2, ...sub_arr] = [15, 25, 17, 81, 51, 46]; console.assert(b1 === 15); console.assert(b2 === 25); console.assert(sub_arr.length === 4); console.assert(sub_arr[0] === 17); console.assert(sub_arr[1] === 81); console.assert(sub_arr[2] === 51); console.assert(sub_arr[3] === 46); // Une boucle pour comparer le resultat attendu for (const [i, value] of[15, 25, 17, 81, 51, 46].entries()) { //on reconstruit le tableau à chaque iteration console.assert([c1, c2].concat(sub_arr)[i] === value); }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="import_export">Εισαγωγή και εξαγωγή modules</h2> <div class="sectionbody"> <div class="paragraph"> <p>10_module_import_export.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Import et export de module * * Dans le fichier html * au niveau de la balise d'import de script * spécifier le type module * * 1er technique: import nommé des fonctions: * import { sum, minus, times, div, rem } from "./dummy_math_functions.js"; * * 2eme technique: import global des fonction avec l'asterisque(*) * en préfixant l'import par un nommage du fichier importé: * import * as math from "./dummy_math_functions.js"; * * 3eme technique: import par alias avec le mot clé "as" * import { * sum as add, * minus as substract, * times as multiply, * div as divide, * rem as modulo * } from "./dummy_math_functions.js"; */ import { sum, minus, times, div, rem } from "./dummy_math_functions.js"; console.assert(sum(1, 1) === 2); console.assert(minus(4, 2) === 2); console.assert(times(2, 2) === 4); console.assert(div(4, 2) === 2); console.assert(rem(4, 2) === 0);</code></pre> </div> </div> <div class="paragraph"> <p>dummy_math_functions.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">//sum const sum = (x, y) => x + y; // subtraction const minus = (x, y) => x - y; // multiplication const times = (x, y) => x * y; // division const div = (x, y) => x / y; // remainder: reste de la division euclidiene const rem = (x, y) => x % y; // log sum const sum_log = (x, y) => console.log(sum(x, y)); // log subtraction const minus_log = (x, y) => console.log(minus(x, y)); // log multiplication const times_log = (x, y) => console.log(times(x, y)); // log division const div_log = (x, y) => console.log(div(x, y)); // log remainder const rem_log = (x, y) => console.log(rem(x, y)); export { sum, minus, times, div, rem, sum_log, minus_log, times_log, div_log, rem_log };</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> <div class="sect1"> <h2 id="classes">Χρήση των κλάσεων</h2> <div class="sectionbody"> <div class="paragraph"> <p>11_classes.js</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-javascript" data-lang="javascript">/** * Utilisation des classes */ //creation d'un objet class Account { constructor(username) { this.username = username; } }; const acc1 = new Account("cheroliv"); console.table(acc1); console.assert(acc1.username === "cheroliv"); console.log("---------"); //création d'un objet et ajout de getter et setter(accesseurs) class AccountInfo { constructor(username) { this._username = username; } get username() { return this._username; } /** * @param {(arg0: string) => void} new_username */ set new_username(new_username) { this._username = new_username; } }; const acc_info1 = new AccountInfo("cheroliv"); console.table(acc_info1); //accés au membre _username avec le getter username() console.assert(acc_info1.username === "cheroliv"); //update la valeur username de acc_info1 avec le setter acc_info1.new_username = "imrandeh"; console.assert(acc_info1.username === "imrandeh"); console.log("---------");</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc_js"><span class="underline">Εισαγωγή JavaScript</span></a></p> </div> </div> </div> https://cheroliv.com/blog/2022/0054_memo_cadrage_post.html Sat, 31 Dec 2022 00:00:00 +0000 blog/2022/0054_memo_cadrage_post.html <div class="sect1"> <h2 id="_καдриσμός">καдриσμός</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_εργαστήριο_1_όραμα">Εργαστήριο 1 : Όραμα</h3> <div class="sect3"> <h4 id="_το_μοτίβο_qqoqcp_ποιος_τι_πού_πότε_πώς_γιατί">Το μοτίβο “QQOQCP” – Ποιος, Τι, Πού, Πότε, Πώς, Γιατί</h4> </div> <div class="sect3"> <h4 id="_2_ο_product_vision_board">2. Ο Product Vision Board</h4> <div class="sect4"> <h5 id="_στοčeυόμενη_ομάδα">στοčeυόμενη ομάδα</h5> <div class="paragraph"> <p>Ποιοι είναι οι χρήστες που χρησιμοποιούν το προϊόν ή την προσφορά; (ευθείς, έμμεσος)</p> </div> </div> <div class="sect4"> <h5 id="_απαιτήσεις">Απαιτήσεις</h5> <div class="paragraph"> <p>Ποια είναι τα 5 κύρια αναγκές των βασικών χρηστών της εφαρμογής;</p> </div> </div> <div class="sect4"> <h5 id="_προϊόν">Προϊόν</h5> <div class="paragraph"> <p>Ποια είναι η προσφορά μου αξίας; Ποια είναι οι 5 κύριες λειτουργίες του προϊόντος που επιτρέπουν να απαντήσουν σε ανάγκες</p> </div> </div> <div class="sect4"> <h5 id="_επιχειρησιακός_στόχος">Επιχειρησιακός στόχος</h5> <div class="paragraph"> <p>Ποια είναι τα κριτήρια επιτυχίας;</p> </div> </div> <div class="sect4"> <h5 id="_όραμα">�Όραμα</h5> <div class="paragraph"> <p>�Όταν οι 4 στήλες είναι πλήρεις, θα πρέπει να συμπληρώσετε το τμήμα όρασης του Product Vision Board σε μια πλήρη πρόταση.</p> </div> </div> </div> </div> <div class="sect2"> <h3 id="_εργαστήριο_2_προσωπικότητεςδιαδρομές_χρηστών">Εργαστήριο 2: Προσωπικότητες/Διαδρομές χρηστών</h3> <div class="ulist"> <div class="title">Oriσμός για κάθε persona ενός ταξιδιού χρήστη:</div> <ul> <li> <p>Ποιος θα χρησιμοποιήσει την υπηρεσία μου; (Στόχος)</p> </li> <li> <p>Τι θέλει να κάνει; (Αλλά)</p> </li> <li> <p>Πώς θα το κάνει; (Ταξίδι Χρήστη)</p> </li> </ul> </div> </div> <div class="sect2"> <h3 id="_εργαστήριο_3_ζώνιο_ιστοριογράμματα_χάρτης_ιστότοπου">Εργαστήριο 3: Ζώνιο, Ιστοριογράμματα, Χάρτης ιστότοπου</h3> <div class="sect3"> <h4 id="_1_ζωνοποίηση">1. Ζωνοποίηση</h4> </div> <div class="sect3"> <h4 id="_2_storyboard">2. StoryBoard</h4> </div> <div class="sect3"> <h4 id="_3_sitemap">3. SiteMap</h4> </div> </div> <div class="sect2"> <h3 id="_εργαστήριο_4_wireframemoodboard">Εργαστήριο 4: Wireframe/Moodboard</h3> <div class="sect3"> <h4 id="_1_wireframes">1. Wireframes</h4> </div> <div class="sect3"> <h4 id="_2_πίνακας_ένστασης">2. πίνακας ένστασης</h4> </div> </div> <div class="sect2"> <h3 id="_εργαστήριο_5_χαρτογράφηση_ιστοριών_χρήστες_ιστορίες">Εργαστήριο 5: Χαρτογράφηση Ιστοριών/ Χρήστες Ιστορίες</h3> <div class="sect3"> <h4 id="_story_mapping_προτεραιότητα_των_us">Story mapping (προτεραιότητα των US)</h4> </div> <div class="sect3"> <h4 id="_ως_type_dutilisateur_θέλω_un_objectif_για_να_une_razón">Ως <type d’utilisateur>, θέλω <un objectif> για να <une razón>.</h4> </div> </div> <div class="sect2"> <h3 id="_εργαστήριο_6_backlog">Εργαστήριο 6: Backlog</h3> <div class="paragraph"> <p><a href="https://www.atlassian.com/fr/agile/scrum/backlogs">υπολείμματα</a></p> </div> </div> <div class="sect2"> <h3 id="_εργαστήριο_7_τεχνική_και_αρχιτεκτονική">Εργαστήριο 7: Τεχνική και Αρχιτεκτονική</h3> </div> </div> </div> https://cheroliv.com/blog/2022/0053_memo_kotlin_post.html Sun, 29 May 2022 00:00:00 +0000 blog/2022/0053_memo_kotlin_post.html <div class="sect1"> <h2 id="_καλοί_σύνδεσμοι">καλοί σύνδεσμοι</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://play.kotlinlang.org/">kotlinlang παιδικό πάρκο</a>+</p> </div> <div class="paragraph"> <p><a href="https://arrow-kt.io/">arrow.kt</a>+</p> </div> <div class="paragraph"> <p><a href="https://arkivanov.github.io/MVIKotlin/">MVI:Μοντέλο Προβολή Πρόθεσης</a>+</p> </div> <div class="paragraph"> <p><a href="https://github.com/arkivanov/Essenty">Essenty</a>+</p> </div> <div class="paragraph"> <p><a href="https://arkivanov.github.io/Decompose/">διαλύσε</a>+</p> </div> </div> </div> <div class="sect1"> <h2 id="_ποικιλό_τμήμα_κώδικα">ποικιλό τμήμα κώδικα</h2> <div class="sectionbody"> <div class="sect2"> <h3 id="_αντιστοίχιση_μείωση">αντιστοίχιση μείωση</h3> <div class="paragraph"> <p>Μετατρέψτε μια λίστα από bytes σε μια λίστα από strings και συνοψίστε τη λίστα των strings<br> σε μια συμβολοσειρά που περιέχει τη συγκένωση. Πώς να καταγράψετε το request που στάλθηκε (requestBodyContent:byte[]);</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">log.info( requestBodyContent!!.map { it.toInt().toChar().toString() } .reduce { request: String, s: String -> request + s } )</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_αριθμητός_και_κλεισμένες_κλάσεις">αριθμητός και κλεισμένες κλάσεις</h3> <div class="paragraph"> <p>post:<a href="0038_training_kotlin_enum_sealed_class_post" target=""_blank">άσκηση kotlin enum sealed class</a></p> </div> </div> <div class="sect2"> <h3 id="_συνάρτηση_διεπαφή_και_αναφορά_μεθόδου">συνάρτηση διεπαφή και αναφορά μεθόδου</h3> <div class="paragraph"> <p>Μπορούμε να μετατρέψουμε μια οντότητα σε μοντέλο τομέα DTO με μια μέθοδο αναφοράς (stil λειτουργικό - Java 8)</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">fun findAllByLoginNot( pageable:Pageable, login:String) :Page<UserDto> { return userDao.findAllByLoginNot( pageable, login).map(::fromEntity) }</code></pre> </div> </div> <div class="paragraph"> <p>μίαhttps://stackoverflow.com/a/22245383/837404[καλή εξήγηση]</p> </div> </div> <div class="sect2"> <h3 id="_συλλέγε_την_τυπική_έξοδο">Συλλέγε την τυπική έξοδο</h3> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">package functional import java.io.ByteArrayOutputStream import java.io.PrintStream import java.lang.System.out import java.lang.System.setOut import kotlin.test.AfterTest import kotlin.test.BeforeTest import kotlin.test.Test import kotlin.test.assertEquals class BasicsHOF { private val standardOut: PrintStream? = out private val outputStreamCaptor = ByteArrayOutputStream() @BeforeTest fun setUp() = setOut(PrintStream(outputStreamCaptor)) @AfterTest fun tearDown() = setOut(standardOut) @Test fun `three times dope`() { 3.times { println("Hello") } assertEquals( buildString { repeat(3) { append("Hello\n") } deleteAt(length - 1) }, outputStreamCaptor .toString() .trim() ) } fun Int.times(fn: () -> Unit) = (1..this).forEach { _ -> fn() } }</code></pre> </div> </div> </div> <div class="sect2"> <h3 id="_τι_διαφορά_υπάρχει_στη_kotlin_μεταξύ_των_apply_run_let_also_use_και_του_with">Τι διαφορά υπάρχει στη Kotlin μεταξύ των <code>apply</code>, <code>run</code>, <code>let</code>, <code>also</code>, <code>use</code> και του <code>with</code>;</h3> <div class="paragraph"> <p><strong>Σύγκριση των συναρτήσεων Kotlin και Χρήση των Λειτουργιών Lambda Αναφορά</strong></p> </div> </div> </div> </div> <div class="sect1"> <h2 id="_εφαρμόστε">Εφαρμόστε</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Εισαγωγή Οι συναρτήσεις Kotlin`apply`, <code>run</code>, <code>let</code>, <code>also</code>, <code>use</code>, et `with`Προσφέρουν διαφορετικούς τρόπους για την επεξεργασία των αντικειμένων. Κάθε μία έχει τα δικά της σενάρια χρήσης και συμπεριφορές. Επιπλέον, οι μορφές lambda reference επιτρέπουν να γίνει ο κώδικας πιο ανάγνωστος και επαναχρησιμοποιήσιμος αναφέροντας σε υπάρχουσες lambda λειτουργίες.</div> <p>Η συνάρτηση`apply`Χρησιμοποιείται για να ρυθμίσει ένα αντικείμενο κατά τη δημιουργία του. Επιστρέφει το αντικείμενο στο οποίο καλείται.</p> </div> <div class="paragraph"> <p>Παράδειγμα με λάμδα reference :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val someObject = SomeClass().apply(::configureObject)</code></pre> </div> </div> <div class="paragraph"> <p>Παράδειγμα με lambda:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val someObject = SomeClass().apply { // configuration des propriétés de someObject }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_τρέξε">τρέξε</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η λειτουργία`run`Χρησιμοποιείται για να εκτελέσει ένα μπλοκ κώδικα σε ένα αντικείμενο και επιστρέφει το αποτέλεσμα του μπλοκ κώδικα.</p> </div> <div class="paragraph"> <p>Παράδειγμα με αναφορά lambda :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val result = someObject.run(::someFunction)</code></pre> </div> </div> <div class="paragraph"> <p>Παράδειγμα με lambda :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val result = someObject.run { // bloc de code à exécuter sur someObject // la dernière expression est renvoyée }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_άφε">άφε</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η λειτουργία`let`Χρησιμοποιείται για να εκτελέσει ένα τμήμα κώδικα σε ένα αντικείμενο και να επιστρέψει το αποτέλεσμα του τμήματος κώδικα.</p> </div> <div class="paragraph"> <p>Παράδειγμα με lambda αναφορά</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val result = someObject.let(::processObject)</code></pre> </div> </div> <div class="paragraph"> <p>Παράδειγμα με lambda :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val result = someObject.let { // bloc de code à exécuter sur someObject // la dernière expression est renvoyée }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_και">και</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η συνάρτηση`also`χρησιμοποιείται για να εκτελέσει μια επιπλέον ενέργεια σε ένα αντικείμενο και επιστρέφει το αντικείμενο στο οποίο καλείται.</p> </div> <div class="paragraph"> <p>Παράδειγμα με αναφορά lambda :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">someObject.also(::performAdditionalAction)</code></pre> </div> </div> <div class="paragraph"> <p>Παράδειγμα με lambda :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">someObject.also { // action additionnelle sur someObject }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_χρήση">χρήση</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η λειτουργία`use`χρησιμοποιείται για να εργαστεί με πόρους που πρέπει να κλειστούν μετά τη χρήση. Καλέει αυτόματα τη συνάρτηση`close`στο τέλος του μπλοκ.</p> </div> <div class="paragraph"> <p>Παράδειγμα με αναφορά lambda:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">someResource.use(::useResource)</code></pre> </div> </div> <div class="paragraph"> <p>Παράδειγμα με lambda :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">someResource.use { // travailler avec la ressource }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_με">με</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η λειτουργία`with`χρησιμοποιείται για να καλέσει πολλές μεθόδους σε ένα αντικείμενο χωρίς να επαναλαμβάνει το όνομά του και επιστρέφει το αποτέλεσμα της τελευταίας έκφρασης.</p> </div> <div class="paragraph"> <p>Παράδειγμα με αναφορά lambda :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val result = with(someObject, ::processWithObject)</code></pre> </div> </div> <div class="paragraph"> <p>Παράδειγμα με lambda :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">val result = with(someObject) { // appeler des méthodes sur someObject // la dernière expression est renvoyée }</code></pre> </div> </div> <div class="paragraph"> <p>Χρησιμοποιώντας τις μορφές lambda reference ή τα μπλοκ`{}`, μπορείτε να ενσωματώσετε τη λογική σε ξεχωριστές συναρτήσεις, βελτιώνοντας έτσι την ανάγνωση και την επαναχρησιμοποίηση του κώδικα.</p> </div> </div> </div> <div class="sect1"> <h2 id="_αφήστε_function_σε_kotlin">αφήστε Function σε Kotlin</h2> <div class="sectionbody"> <div class="paragraph"> <div class="title">Η let επιστρέφει το αντικείμενο με τις παρενέργειες που έχουν εφαρμοστεί πάνω του ή στην αρχική κατάσταση εισόδου ανάλογα με (let) ;</div> <p>Η συνάρτηση`let`en Kotlin χρησιμοποιείται για να εκτελεί πράξεις σε ένα αντικείμενο και να επιστρέφει διαφορετικό αποτέλεσμα. Ωστόσο, είναι σημαντικό να σημειωθεί ότι η συνάρτηση`let`δεν τροποποιεί την αρχική κατάσταση του αντικειμένου στο οποίο καλείται.</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Υπογραφή</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><code>inline fun <T, R> T.let(block: (T) → R): R</code></p></td> </tr> </tbody> </table> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>χρήση</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Η λειτουργία`let`συχνά χρησιμοποιείται για να εφαρμόσει μετασχηματισμούς σε ένα αντικείμενο και να αποκτήσει ένα αποτέλεσμα βασισμένο σε αυτά τα μετασχηματισμοί.</p></td> </tr> </tbody> </table> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Αποτελέσμα</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Η τιμή που επιστρέφει η συνάρτηση`let`είναι το αποτέλεσμα της έκφρασης lambda που περάστηκε ως όρισμα, συνήθως το αποτέλεσμα των λειτουργιών που πραγματοποιήθηκαν στο αντικείμενο.</p></td> </tr> </tbody> </table> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 50%;"> <col style="width: 50%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>παρενέργειες</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Αν και η λειτουργία`let`μπορεί να έχει παρενέργειες στο αντικείμενο όταν χρησιμοποιείται στη έκφραση lambda, αλλά δεν τροποποιεί την αρχική κατάσταση του αντικειμένου.</p></td> </tr> </tbody> </table> <div class="paragraph"> <p>Έτσι, η συνάρτηση`let`είναι ένας ελεγαντικός τρόπος να εκτελείτε λειτουργίες σε ένα αντικείμενο, παίρνοντάς ένα παράγουμενο αποτέλεσμα, διατηρώντας την ακεραιότητα του αρχικού αντικειμένου.</p> </div> </div> </div> https://cheroliv.com/blog/2022/0052_memo_jvm_post.html Sat, 28 May 2022 00:00:00 +0000 blog/2022/0052_memo_jvm_post.html <div class="sect1"> <h2 id="toc">πίνακας περιεχο</tool_call>ν</h2> <div class="sectionbody"> <div class="olist arabic"> <ol class="arabic"> <li> <p><a href="#char">αλφαριθμητικά και χαρακτήρες</a></p> </li> <li> <p><a href="#math">αριθμοί και μαθηματικά</a></p> </li> <li> <p><a href="#date">ημερομηνίες και ώρες</a></p> </li> <li> <p><a href="#java8date">ημερομηνίες και ώρες java8</a></p> </li> <li> <p><a href="#arrCol">πίνακες και συλλογές</a></p> </li> <li> <p><a href="#sysProp">System.Properties</a></p> </li> <li> <p><a href="#threads">Threads</a></p> </li> <li> <p><a href="#regex">Κανονικές εκφράσεις</a></p> </li> </ol> </div> </div> </div> <div class="sect1"> <h2 id="char">αλφαριθμητικά και χαρακτήρες</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">import java.text.Collator import java.util.* import kotlin.test.* class StringsTest { @Test fun `chaines de caractères et caractères`() { //inférence de type val s = "C'est" assertEquals("C'est", s) //concaténation val t: String = s + " le moment." assertEquals("C'est le moment.", t) // StringBuilder val t1: String = s + buildString { append(" le moment.") } assertEquals("C'est le moment.", t1) //interpolation val t2 = "$s le moment." assertEquals("C'est le moment.", t2) //multiligne chaine de caractères val t3 = """$s le moment.""" assertEquals("C'est le moment.", t3) //conversion de type val t4 = t + " " + 23.4 assertEquals("C'est le moment. 23.4", t4) val t5 = 'C'.toString() assertEquals("C", t5) //taille de la chaine de caractères assertEquals(16, t.length) //sous-chaine d'une chaine de caractères //retourne une chaine de caractères contenant, //les caractères aux positions x à y-1 //sub = t.substring(x, y) //t = "C'est le moment." //retourne les caractères 6 et 7 var sub = t.substring(6, 8) assertEquals("le", sub) //retourne les caractères 0 à 4 sub = t.substring(0, 5) assertEquals("C'est", sub) //la longueur d'une sous-chaine est toujours égale (y-x) val numChars = sub.length assertEquals(5 - 0, numChars) //extraction des caractères d'une chaine assertEquals('e', t.elementAt(2)) assertEquals('e', t.get(2)) assertEquals('e', t[2]) //conversion d'une chaine en tableau de caractères val ca = t.toCharArray() assertEquals(t.length, ca.size) t.mapIndexed { index, char -> assertEquals(char, ca[index]) } //place les 4 premiers caractères de t1 //dans le tableau ca a la position 2 (t as java.lang.String).getChars( /* srcBegin = */ 0, /* srcEnd = */ 3, /* dst = */ ca, /* dstBegin = */ 1 ) assertEquals("CC'et le moment.", String(ca)) //colle tous les caractères dans un meme string assertEquals("CC'et le moment.", ca.concatToString()) //to lower case assertEquals("c'est le moment.", t.toLowerCase()) assertEquals("c'est le moment.", t.lowercase()) //to upper case assertEquals("C'EST LE MOMENT.", t.toUpperCase()) assertEquals("C'EST LE MOMENT.", t.uppercase()) //comparaison de chaines de caractères //t = "C'est le moment." assertFalse(t.equals("hello")) assertFalse(t == "hello") //ignore la casse assertTrue(t.equalsIgnoreCase("C'EST LE MOMENT.")) assertTrue(t.equals("C'EST LE MOMENT.", ignoreCase = true)) //démarre par assertTrue(t.startsWith("C'est")) //se finit par assertTrue(t.endsWith("le moment.")) //compareTo //retourne une valeur < 0, car s est //alphabétiquement avant "N'est" val r1: Int = s.compareTo("N'est") assertTrue(r1 < 0) //variante ignorant la casse val r1Prime: Int = (s as java.lang.String).compareToIgnoreCase("n'est") assertTrue(r1Prime < 0) //retourne 0 si les chaines sont equivalente val r2: Int = s.compareTo("C'est") assertEquals(0, r2) //retourne une valeur > 0 car s vient apres "B'est" val r3: Int = s.compareTo("B'est") assertTrue(r3 > 0) //Recherche de caractères et de sous-chaines de caractères //recherche de caractères //position du premier caractères 't' var pos = t.indexOf('t') assertEquals(4, pos) //position du suivant pos = t.indexOf('t', pos + 1) assertEquals(14, pos) //retour d'érreur -1 si absence de suivant pos = t.indexOf('t', pos + 1) assertEquals(-1, pos) //position du dernier 't' dans la chaine: 14 pos = t.lastIndexOf('t') assertEquals(14, pos) //recherche de 't' vers l'arrière a partir du caractères 13 pos = t.lastIndexOf('t', pos - 1) assertEquals(4, pos) //recherche de sous-chaines //retourne 2 pos = t.indexOf("est") assertEquals(2, pos) //"est" n'apparait qu'une seule fois: retourne -1 pos = t.indexOf("est", pos + 1) assertEquals(-1, pos) //recherche d'une sous-chaine depuis l'arrière //t = "C'est le moment." //retourne 6 pos = t.lastIndexOf("le ") assertEquals(6, pos) //extrait depuis la position 9, //renvoi toute la chaine après "le " val noun = t.substring(pos + 3) assertEquals(-1, noun.indexOf("le ")) //remplacement de toutes les instances d'un caractère //par un autre caractère //ne fonctionne que avec les caractères, pas les chaines val exclaim: String = t.replace('.', '!') assertEquals('!', exclaim.get(exclaim.length - 1)) assertEquals(exclaim.length - 1, exclaim.indexOf('!')) assertEquals(-1, exclaim.indexOf('.')) //suppression des espaces blancs //au début et à la fin d'une chaine val noextraspaces = t.trim() assertNotEquals(' ', noextraspaces.get(0)) assertNotEquals(' ', noextraspaces.get(noextraspaces.length - 1)) //extraction des instances uniques de chaines de caractères //avec intern() val s1 = s.intern() assertEquals(s, s1) val s2 = "C'est".intern() assertEquals("C'est", s2) assertEquals(s1, s2) //StringBuilder pour manipuler les caractères d'une chaine de caractères //crée un tampon StringBuilder à partir d'une chaine de caractères val b = StringBuilder("N'est") //extrait et définit des caractères individuel du tampon StringBuilder //le caractères à l'index 0 val c: Char = b.get(0) assertEquals('N', c) //modifier le premier caractère de la chaine b.setCharAt(0, 'C') assertEquals(s, b.toString()) //ajouter des données à un StringBuilder b.append(' ') b.append("le moment.") b.append(23) //insère des chaines de caractères ou autre dans le StringBuilder b.insert(6, "pas ") assertEquals("C'est pas le moment.23", b.toString()) //remplace un sous ensemble de caractères //avec une chaine de caractères donnée b.replace(2, 9, "est") assertEquals("C'est le moment.23", b.toString()) //supprime les caractères b.delete(15, 18) assertEquals("C'est le moment", b.toString()) b.deleteCharAt(2) assertEquals("C'st le moment", b.toString()) //insert à la postion 2 et décale reste à droite(sans perte de données) b.insert(2, 'e') //tronque la taille de la donnée b.setLength(5) assertEquals("C'est", b.toString()) //inverse les caractères de la chaine b.reverse() assertEquals("tse'C", b.toString()) //écrase le StringBuilder, pret à etre réutilisé b.setLength(0) assertEquals("", b.toString()) //java.util.StringTokenizer pour fragmenter une chaine //de caractères en un ensemble de mots var st = StringTokenizer(t) //nb d'items encore présentent dans la file assertEquals(3, st.countTokens()) //est ce que il y a encore des items dans la file assertTrue(st.hasMoreTokens()) //récupérer le token courrant assertEquals("C'est", st.nextToken()) assertEquals("le", st.nextToken()) assertEquals("moment.", st.nextToken()) assertFalse(st.hasMoreTokens()) assertEquals(0, st.countTokens()) //extraire des occurences de mots délimités //par des caractères autres que des expaces. val str = "a:b:c:d" st = StringTokenizer(str, ":") assertEquals(4, st.countTokens()) assertTrue(st.hasMoreTokens()) assertEquals("a", st.nextToken()) assertEquals("b", st.nextToken()) assertEquals("c", st.nextToken()) assertEquals("d", st.nextToken()) assertFalse(st.hasMoreTokens()) assertEquals(0, st.countTokens()) //text="C'est le moment." val text = t.toCharArray() var p = 0 //sauter les espaces de tete //pour ramener p à la position du premier caractère imprimable while ((p < text.size) && (Character.isWhitespace(text[p])) ) p++ assertEquals(0, p) assertEquals("C'est le moment.", text.concatToString()) //met le premier mot du texte en majuscule while (p < text.size && Character.isLetter(text[p])) { text[p] = Character.toUpperCase(text[p]) p++ } assertEquals(1, p) assertEquals('C', text[0]) assertTrue(Character.isUpperCase(text[0])) assertFalse(Character.isLetter(text[1])) //comparer des chaines de caractères // avec les contrainte la locale système val col = Collator.getInstance() //le résulat est négatif car chica //est avant chico dans l'ordre alphabétique assertTrue(col.compare("chica", "chico") < 0) } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">πίνακας περιεχο</tool_call>ν</a></p> </div> </div> </div> <div class="sect1"> <h2 id="math">αριθμοί και μαθηματικά</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">import java.math.BigInteger import java.security.SecureRandom import java.text.NumberFormat import java.util.* import kotlin.test.* class NumbersMathTest { @Test fun `Nombres et Math`() { //Constantes utiles Byte.MIN_VALUE Byte.MAX_VALUE Short.MIN_VALUE Short.MAX_VALUE Float.MIN_VALUE Float.MAX_VALUE Math.PI Math.E val s = "-42" //conversion de chaine de caractères //vers un nombre, si possible. var b: Byte = java.lang.Byte.parseByte(s) var sh: Short = java.lang.Short.parseShort(s) var i: Int = java.lang.Integer.parseInt(s) var l: Long = java.lang.Long.parseLong(s) var f: Float = java.lang.Float.parseFloat(s) var d: Double = java.lang.Double.parseDouble(s) //valeur exacte val f_exac = java.lang.Float.valueOf(s) val d_exac = java.lang.Double.valueOf(s) //les routines de conversions entière gérent //les nombres dans diverses bases. //1011 en binare est égal a 11 en base dix b = java.lang.Byte.parseByte("1011", 2) assertEquals(11, b) //ff en base 16(hexa) est égal à 255 en base dix. sh = java.lang.Short.parseShort("ff", 16) assertEquals(255, sh) //la méthode valueOf() peut gérer des bases arbitraires. i = java.lang.Integer.valueOf("egg", 17).toInt() assertEquals(4334, i) //la méthode decode() gére les representations octale, //décimal, hexadécimal, en fonction du préfixe numérique //de la chaine de caractères //un 0 de tete signifie base 8 //un 0x de tete signifie base 16 //les autres sont en base 10 val sho = java.lang.Short.decode("0377") //la classe Integer peut convertir les nombres //en diverses chaines de caractères. val decimal = java.lang.Integer.toString(42) assertEquals("42", decimal) val decimal_ = 42.toString() assertEquals("42", decimal_) val binary = java.lang.Integer.toBinaryString(42) assertEquals("101010", binary) val octal = java.lang.Integer.toOctalString(42) assertEquals("52", octal) val hex = java.lang.Integer.toHexString(42) assertEquals("2a", hex) val base36 = java.lang.Integer.toString(42, 36) assertEquals("16", base36) val base36_ = 42.toString(36) assertEquals("16", base36_) //java.text.NumberFormat effectue la conversion // d'une maniere spécifique aux parametres locaux //sans parametre prend la local systeme comme reference val nf = NumberFormat.getNumberInstance(Locale.FRANCE) val formatted_number = nf.format(9876543.21) assertNotEquals("9876543.21", formatted_number) //parse la chaine de caractères en fonction des parametres locaux(fr) val n = nf.parse("1234567,89") assertEquals(1234567.89, n) //les valeurs monétaires sont parfois formaté // d'une maniere differente des nombres val money_format = NumberFormat.getCurrencyInstance(Locale.FRANCE) assertEquals("123,40 €", money_format.format(1234.56)) //java.lang.Math d = Math.toRadians(27.0) d = Math.cos(d) d = Math.sqrt(d) d = Math.log(d) d = Math.exp(d) d = Math.pow(10.0, d) d = Math.atan(d) d = Math.toDegrees(d) //arrondi au dessus val up = Math.ceil(d) //arrondi au dessous val down = Math.floor(d) //arrondi au plus près val nearest = Math.round(d) //java.lang.Math.Random() val r = Math.random() assertTrue(r >= 0.0 && r < 1.0) //créé un nouvel objet Random, en l'initialisant //avec l'heure courante val generator = java.util.Random(System.currentTimeMillis()) //prochaine valeur aléatoire de taille double d = generator.nextDouble() assertTrue((d >= 0.0) && (d < 1.0)) //prochaine valeur aléatoire de taille float f = generator.nextFloat() assertTrue((f >= 0.0) && (f < 1.0)) //prochaine valeur aléatoire de taille long l = generator.nextLong() assertTrue( (Math.abs(l) <= Long.MAX_VALUE) && (Math.abs(l) >= 0) ) //prochaine valeur aléatoire de taille int i = generator.nextInt() assertTrue( (Math.abs(i) <= java.lang.Integer.MAX_VALUE) && (Math.abs(i) >= 0) ) val limit = 100 //prochaine valeur aléatoire de taille int //la limit max du ramdom est ramené à limit //et la limit min est 0 i = generator.nextInt(limit) assertTrue(i in 0 until limit) //prochaine valeur aléatoire de taille booléen val bool = generator.nextBoolean() assertNotNull(bool) //valeur moyenne 0.0, déviation standard 1.0 d = generator.nextGaussian() //randoms bytes //rempli un tableau avec des valeurs byte aléatoires val b_arr = ByteArray(128) generator.nextBytes(b_arr) b_arr.iterator().forEachRemaining { assertTrue( it <= Byte.MAX_VALUE && it >= Byte.MIN_VALUE ) } //java.security.SecureRandom pour les nombres aléatoires //utilisé en cryptographie val secure_generator = SecureRandom() //le générateur génère sa propre tete de liste sur 16 octets secure_generator.setSeed(secure_generator.generateSeed(16)) val sec_b_arr = ByteArray(128) secure_generator.nextBytes(sec_b_arr) sec_b_arr.iterator().forEachRemaining { assertTrue( it <= java.lang.Byte.MAX_VALUE && it >= java.lang.Byte.MIN_VALUE ) } //java.math.BigDecimal java.math.BigInteger //pour travailler sur des grandes valeurs. //calcule de la factorielle de 1000 var total = BigInteger.valueOf(1) (2..1000).forEach { total = total.multiply(BigInteger.valueOf(it.toLong())) } assertTrue(total.toString().length == 2568) } }</code></pre> </div> </div> <div class="paragraph"> <p>(blank)</p> </div> </div> </div> <div class="sect1"> <h2 id="date">ημερομηνίες και ώρες</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">import java.text.DateFormat import java.text.SimpleDateFormat import java.time.Instant import java.util.* import kotlin.test.Test import kotlin.test.assertEquals import kotlin.test.assertTrue class DatesHoursTest { @Test fun `Dates et heures`() { //l'heure courante en millisecondes val t0 = System.currentTimeMillis() //une autre représentation de la meme information val now = java.util.Date() //converti un objet java.util.Date en une valeur long. val t1 = now.getTime() assertTrue(t1 > Instant.EPOCH.toEpochMilli()) //kotlin property access syntaxe style val t1_prime = now.time //java.text.DateFormat //affiche la date d'aujourd'hui en utilisant le format //par défaut des parametres locaux val defaultDateFormat = DateFormat.getDateInstance() //personnalisation du formatage et de la locale val df = DateFormat.getDateInstance(DateFormat.LONG, Locale.FRANCE) val localeFormattedDate = df.format(Date()) //constantes pour les styles de pattern de formatage assertEquals(0, DateFormat.FULL) assertEquals(1, DateFormat.LONG) assertEquals(2, DateFormat.MEDIUM) assertEquals(3, DateFormat.SHORT) assertEquals(2, DateFormat.DEFAULT) //utilise pour l'heure un format abrégé avec //des parametres personnalisés val tf = DateFormat.getTimeInstance( DateFormat.SHORT, Locale.FRANCE ) //affiche l'heure en utilisant le format de tf val shortTime = tf.format(Date()) assertTrue(shortTime.contains(':')) //affiche la date et l'heure en utilisant //un format détaillé val longTimeStamp = DateFormat.getDateTimeInstance( DateFormat.FULL, DateFormat.FULL, ) assert(longTimeStamp.format(Date()).isNotEmpty()) //utilisez java.text.SimpleDateFormat //pour définir votre propre modele de formatage val customFormat = SimpleDateFormat("yyyy.MM.dd") assertEquals(10, customFormat.format(Date()).length) //DateFormat peut également parser les date contenu dans des chaines val kotlinAnnounceDate = customFormat.parse("2019.05.08") //la class Date et sa représentation en millisecondes //n'autorise qu'une forme trés simple d'arithmétique //on ajoute 3 600 000 millisecondes à l'heure courante val anHourFromNow = now.getTime() + (60 * 60 * 1000) assert(anHourFromNow > now.getTime()) //java.util.Calendar //pour manipuler les dates et heures de facon plus sophistiquée //instanciation selon les parametres locaux //et le fuseau horaire local val calendar = Calendar.getInstance() //initialisation du calendrier à la date de maintenant calendar.setTime(now) //détermine le jour de l'année auquel correspond la date courante val dayOfYear = calendar.get(Calendar.DAY_OF_YEAR) assert(dayOfYear < 366) //réinitialisation de la date courante calendar.set(2019, Calendar.MAY, 8) assertEquals(4, calendar.get(Calendar.DAY_OF_WEEK)) //à quel jour du mois correspond le deuxieme mercredi de mai 2019 //set(key,value) calendar.set(Calendar.YEAR, 2019) calendar.set(Calendar.MONTH, Calendar.MAY) calendar.set(Calendar.DAY_OF_WEEK, Calendar.WEDNESDAY) //defini à quel (n=2) semaine du mois est la date calendar.set(Calendar.DAY_OF_WEEK_IN_MONTH, 2) //extrait le jour du mois val dayOfMonth = calendar.get(Calendar.DAY_OF_MONTH) assertEquals(8, dayOfMonth) calendar.setTime(kotlinAnnounceDate) //ajoute 30j à la date calendar.add(Calendar.DATE, 30) val monthAfter = calendar.getTime() //date est elle avant ou apres? assertTrue(monthAfter.after(kotlinAnnounceDate)) } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">πίνακας περιεχο</tool_call>ν</a></p> </div> </div> </div> <div class="sect1"> <h2 id="java8date">ημερομηνίες και ώρες java8</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η Java 8 εισάγει το νέο πακέτο <strong><em>java.time</em></strong>, το οποίο περιέχει τις βασικές κλάσεις που<br> Η πλειοψηφία των προγραμματιστών δουλεύει με. Περιéchει επίσης τέσσερα υπο-πακέτα:<br></p> </div> <div class="paragraph"> <p><strong><em>java.time.chrono</em></strong><br> Εναλλακτικές χρονολογίες που οι προγραμματιστές που χρησιμοποιούν συστήματα ημερολογίων που δεν<br> Το να ακολουθείται το πρότυπο ISO θα αλληλεπιδρά με. Ένα παράδειγμα θα’était ένα cal ιαπωνικό<br> ανθεκτικό σύστημα.<br> <strong><em>java.time.format</em></strong><br> Περιέχει το DateTimeFormatter που χρησιμοποιείται για τη μετατροπή των αντικειμένων ημερομηνίας και ώρας<br> σε μια συμβολοσειρά και επίσης για να αναλύσει τις συμβολοσειρές στα αντικείμενα ημερομηνίας και ώρας.<br> <strong><em>java.time.temporal</em></strong><br> Περιέχει τις διεπαφές που απαιτούνται από τις βασικές κλάσεις ημερομηνίας και ώρας και επίσης<br> διαστάσεις (όπως ερωτήματα και ρυθμιστές) για προχωρημένες λειτουργίες με ημερομηνίες.<br> <strong><em>java.time.zone</em></strong><br> Κλάσεις που χρησιμοποιούνται για τους κανόνες του υποκείμενου ωροζώνου<br> Η πλειοψηφία των προγραμματιστών δεν θα χρειάζονται αυτό το πακέτο.<br></p> </div> <div class="imageblock"> <div class="content"> <img src="../../img/java8-date-time.png" alt="java8 date time"> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">import java.time.LocalDate import java.time.Month import java.time.Period import java.time.YearMonth import java.time.temporal.* import java.util.HashMap import java.util.stream.Collectors import kotlin.test.Test class DatesHoursJava8Test { class BirthdayDiary { private val birthdays: MutableMap<String, LocalDate> init { birthdays = HashMap() } fun addBirthday( name: String, day: Int, month: Int, year: Int ): LocalDate { val birthday: LocalDate = LocalDate.of(year, month, day) birthdays[name] = birthday return birthday } fun getBirthdayFor(name: String): LocalDate? { return birthdays[name] } fun getAgeInYear(name: String, year: Int): Int { val period: Period = Period.between( birthdays[name], birthdays[name]!!.withYear(year) ) return period.getYears() } fun getFriendsOfAgeIn(age: Int, year: Int): Set<String> { return birthdays.keys.stream() .filter { p: String -> getAgeInYear(p, year) == age } .collect(Collectors.toSet()) } fun getDaysUntilBirthday(name: String): Int { val period: Period = Period.between( LocalDate.now(), birthdays[name] ) return period.getDays() } fun getBirthdaysIn(month: Month): Set<String> { return birthdays.entries.stream() .filter { (_, value): Map.Entry<String, LocalDate> -> value.getMonth() === month } .map<String> { (key): Map.Entry<String, LocalDate> -> key } .collect(Collectors.toSet()) } val birthdaysInCurrentMonth: Set<String> get() = getBirthdaysIn(LocalDate.now().getMonth()) val totalAgeInYears: Int get() = birthdays.keys.stream() .mapToInt { p: String -> getAgeInYear( p, LocalDate.now().getYear() ) } .sum() } //Les ajusteurs modifient les objets de date et d'heure. Supposons, par exemple, que nous voulions //renvoie le premier jour d'un trimestre qui contient un horodatage particulier : class FirstDayOfQuarter : TemporalAdjuster { override fun adjustInto(temporal: Temporal): Temporal? { val currentQuarter: Int = YearMonth.from(temporal) .get(IsoFields.QUARTER_OF_YEAR) return when (currentQuarter) { 1 -> LocalDate.from(temporal) .with(TemporalAdjusters.firstDayOfYear()) 2 -> LocalDate.from(temporal) .withMonth(Month.APRIL.value) .with(TemporalAdjusters.firstDayOfMonth()) 3 -> LocalDate.from(temporal) .withMonth(Month.JULY.value) .with(TemporalAdjusters.firstDayOfMonth()) 4 -> LocalDate.from(temporal) .withMonth(Month.OCTOBER.value) .with(TemporalAdjusters.firstDayOfMonth()) else -> null } } } enum class Quarter { FIRST, SECOND, THIRD, FOURTH } //Dans quel trimestre de l'année cette date se situe-t-elle ? class QuarterOfYearQuery : TemporalQuery<Quarter> { override fun queryFrom(temporal: TemporalAccessor): Quarter { val now = LocalDate.from(temporal) return if (now.isBefore(now.with(Month.APRIL).withDayOfMonth(1))) Quarter.FIRST else if (now.isBefore( now.with(Month.JULY) .withDayOfMonth(1) ) ) Quarter.SECOND else if (now.isBefore( now.with(Month.NOVEMBER) .withDayOfMonth(1) ) ) Quarter.THIRD else Quarter.FOURTH } } @Test fun `Dates et heures après java 8`() { val today = LocalDate.now() val currentMonth = today.month val firstMonthOfQuarter = currentMonth.firstMonthOfQuarter() val q = QuarterOfYearQuery() // Direct var quarter: Quarter? = q.queryFrom(LocalDate.now()) println(quarter) // Indirect quarter = LocalDate.now().query(q) println(quarter) val now = LocalDate.now() val fdoq: Temporal = now.with(FirstDayOfQuarter()) println(fdoq) } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">πίνακας περιεχο</tool_call>ν</a></p> </div> </div> </div> <div class="sect1"> <h2 id="arrCol">πίνακες και συλλογές</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="../../img/collections_classes_inheritance.png" alt="Classes de collections et héritage"> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">package playground.programming import java.util.* import kotlin.test.Test import kotlin.test.assertEquals import kotlin.test.assertFalse import kotlin.test.assertTrue class ArrayCollectionTest { @Test fun `Tableaux, collections`() { //Tableau //java.util.Arrays définit d'utiles méthodes de manipulation de tableaux, //y compris de tri et de recherche au sein d'un tableau val intArray = arrayOf(10, 5, 7, -3) //tri le tableau Arrays.sort(intArray) var pos = Arrays.binarySearch(intArray, 7) //la valeur 7 est trouvé a l'index 2 assertEquals(2, pos) //12 pas trouvé retourne une valeur negative assert(Arrays.binarySearch(intArray, 12) < 0) //les tableaux peuvent également etre triés //et faire l'objet d'une recherche val stringArray = arrayOf("le", "moment", "c'est") assertEquals("c'est", stringArray[2]) assertEquals("le", stringArray[0]) assertEquals("moment", stringArray[1]) Arrays.sort(stringArray) assertEquals("c'est", stringArray[0]) assertEquals("le", stringArray[1]) assertEquals("moment", stringArray[2]) //Arrays.equals() compare tous les éléments de deux tableaux //Arrays.clone() copie tous les elements du tableau dans un autre stringArray.forEachIndexed { i, it -> assertEquals(it, stringArray.clone()[i]) } val data = ByteArray(100) //Arrays.fill() initialise tous les éléments des deux tableaux //initalise tous les éléments à -1 Arrays.fill(data, -1) data.forEach { assertEquals(-1, it) } //attribue aux éléments 5, 6, 7, 8 et 9 la valeur -2 Arrays.fill(data, 5, 10, -2) ((5 until (10 - 1))).forEach { assertEquals(-2, data[it]) } //récupère le type de data val type = data::class.java //est ce que data est un tableau? assertTrue(type.isArray()) //est ce que data est un tableau de byte assertEquals(Byte::class.java, type.getComponentType()) //Collection val s = java.util.HashSet<String>() s.add("test") assertTrue(s.contains("test")) assertFalse(s.contains("test2")) s.remove("test") assertFalse(s.contains("test")) val ss = TreeSet<String>() ss.add("b") ss.add("a") ss.iterator().forEach { assertTrue(it == "a" || it == "b") } //liste doublement chainée var dll: List<String> = LinkedList<String>() //plus efficace val l = java.util.ArrayList<String>() l.addAll(ss) l.addAll(1, ss) val obj = l.get(1) val obj_prime = l[1] assertEquals(obj, obj_prime) l.set(3, "nouvel élément") l.add("test") l.add(0, "test2") l.removeAt(1) l.remove("a") assertFalse(l.contains("a")) l.removeAll(ss) assertFalse(l.containsAll(ss)) assertFalse(l.isEmpty()) assertTrue(l.isNotEmpty()) val sublist = l.subList(1, 3) val elements = l.toArray() l.clear() val m = HashMap<String, Integer>() m.put("clé", Integer(42)) m["clé"] = Integer(42) val value: Integer = m.get("clé")!! assertEquals(Integer(42), value) m.remove("clé") assertTrue(m.isEmpty()) val keys = m.keys assertTrue(keys.isEmpty()) val set = HashSet<String>() set.add("key_1") set.add("key_2") set.add("key_3") val members = set.toArray() assertEquals(3, members.size) val list = ArrayList<String>() list.add("items1") list.add("items2") list.add("items3") val items = list.toArray() assertEquals(3, items.size) //trie et recherche d'éléments sur les collections list.add("clé") //en premier on trie Collections.sort(list) //en kotlin list.sort() //en deuxieme on cherche //retourne l'index du premier trouvé sinon -1 pos = Collections.binarySearch(list, "clé") assertEquals(0, pos) val list1 = mutableListOf(1, 2, 3, 4, 5) val list2 = mutableListOf<Int>(0, 0, 0, 0, 0) //d'autres méthodes intéressantes concernant Collections //copie list1 dans list2, 2e parametre dans 1er parametre Collections.copy(list2, list1) //comparaison de la copy avec filter assertTrue(list1.filterIndexed { i: Int, it: Int -> it != list2[i] }.isEmpty()) //comparaison de la copy avec map list1.mapIndexed { index: Int, it: Int -> assertEquals(it, list2[index]) } //rempli avec des 0 Collections.fill(list2, 0) assertTrue(list2.none { it != 0 }) //le maximum assertEquals(5, Collections.max(list1)) //le minimum assertEquals(1, Collections.min(list1)) //renverse Collections.reverse(list) listOf("items3", "items2", "items1", "clé").mapIndexed { i: Int, it: String -> assertEquals(it, list[i]) } //mélange la list Collections.shuffle(list) //retourne un ensemble immuable possédant un seul élément 0 Collections.singleton(0) //renvoi un emballage immuable autour d'une liste Collections.unmodifiableList(list) //renvoi un emballage synchronisé autour d'une map, ensemble clé valeur Collections.synchronizedMap(m) //java.util.Properties un est objet key value } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">πίνακας περιεχο</tool_call>ν</a></p> </div> </div> </div> <div class="sect1"> <h2 id="sysProp">System.Properties</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html">System.Properties τεκμηρίωση επίσημη</a></p> </div> <div class="paragraph"> <p>Εδώ είναι ένας πίνακας με μερικές ενδιαφέρουσες ιδιότητες<br> Αυτά τα ιδιότητες είναι ενδιαφέρουσες για να έχετε πληροφορίες<br> στο σύστημα φιλοξενητή της JVM.</p> </div> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3333%;"> <col style="width: 3.3343%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Κλειδί</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock"><strong>Σημασία</strong></p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">διαχωριστής αρχείου</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ο χαρακτήρας που χωρίζει τα τμήματα μιας διαδρομής αρχείου. Είναι "/" στο UNIX και "\" στα Windows.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.class.path</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Η διαδρομή που χρησιμοποιείται για την εύρεση καταλόγων και αρχείων JAR που περιέχουν αρχεία κλάσης. Τα στοιχεία της διαδρομής κλάσης χωρίζονται από έναν χαρακτήρα που είναι ειδικός της πλατφόρμας και καθορίζεται στην ιδιότητα path.separator.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.home</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Κατάλογος εγκατάστασης για το Java Runtime Environment (JRE)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.vendor</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">�Όνομα προμηθευτή JRE</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.vendor.url</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">URL του προμηθευτή JRE</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">java.version</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Αριθμός έκδοσης JRE</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">διαχωριστής γραμμής</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ακολουθία που χρησιμοποιείται από το λειτουργικό σύστημα για να χωρίζει τις γραμμές σε αρχεία κειμένου</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">os.arch</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Αρχιτεκτονικό λειτουργικού συστήματος</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">os.name</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Όνομα του λειτουργικού συστήματος</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">os.version</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Έκδοση λειτουργικού συστήματος</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">διαχωριστής διαδρομής</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Χαρακτήρας διαχωρισμού διαδρομής που χρησιμοποιείται στο java.class.path</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">φάκελος χρήστη</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Κατάλογος εργασίας χρήστη</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">χρήστης.σπίτι</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Κύριος κατάλογος</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">χρήστης.όνομα</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Όνομα λογαριασμού χρήστη</p></td> </tr> </tbody> </table> <div class="paragraph"> <p><a href="#toc">πίνακας περιεχο</tool_call>ν</a></p> </div> </div> </div> <div class="sect1"> <h2 id="threads">Threads</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">import java.text.DateFormat import java.util.* import kotlin.test.Test class ThreadsTest { @Test fun `threads test`() { //java.lang.Thread représente le thread fondamentale de l'API java //il existe deux manière de définir un thread //1) étendre la classe Thread ou une lambda en kotlin //2) implémenter l'interface Runnable, // puis passer une instance de cet objet Runnable au constructeur de Thread. val list1: List<Int> = List( size = 45, init = { (1..31).random() } ) println("list1$list1") //facon 1 val t = Thread { Collections.sort(list1) println("list1 sorted$list1") } t.start() val list2 = List( size = 45, init = { (1..31).random() } ) println("list2$list2") //facon 2 val sorter = BackgroundSorter(list2) sorter.start() //priorité des threads //tant qu'un thread de niveau de priorité supérieure n'est pas fini //alors celui de niveau inférieur ne peut s'exécuter //on définit un thread avec une priorité inférieur à la normale t.setPriority(Thread.NORM_PRIORITY - 1) //ici on définit un thread avec une priorité inférieur à la priorité //du thread courant t.setPriority(Thread.currentThread().getPriority() - 1) //Thread.yield() fait une pause pour laisser les autres threads de meme priorité s'exécuter } class BackgroundSorter(private val l: List<Int>) : Thread() { override fun run() { Collections.sort(l) println("list2 sorted$l") } } //pour l'arrêt du thread, plutôt qu'utiliser la fonction Thread.stop() // qui laisse la memoire dans un état non controlé. //utiliser la méthode tel que l'exemple pleaseStop() class DummyClock( private val df: DateFormat = DateFormat.getTimeInstance(DateFormat.MEDIUM), private var keepRunning: Boolean = true ) : Thread() { init { isDaemon = true start() } override fun run() { while (keepRunning) { println(df.format(Date())) try { sleep(1000) } catch (e: InterruptedException) { println(e.message) } } } fun pleaseStop() { keepRunning = false } } //java.util.Timer //java.util.TimerTask //ces classes permettent l'exécution de taches répétitives @Test fun `Timer et TimerTask test`() { DummyClock() } }</code></pre> </div> </div> <div class="paragraph"> <p><a href="#toc">πίνακας περιεχο</tool_call>ν</a></p> </div> </div> </div> <div class="sect1"> <h2 id="regex">Κανονικές εκφράσεις</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">import java.util.* import java.util.regex.Matcher import java.util.regex.Pattern import java.util.stream.Collectors import kotlin.test.Test import kotlin.test.assertEquals class RegularExpressionsTest { @Test fun `expressions régulières`() { val p: Pattern = Pattern.compile("honou?r") val caesarUK = "For Brutus is an honourable man" val mUK: Matcher = p.matcher(caesarUK) assertEquals(true, mUK.find(), "Should matches UK spelling") val caesarUS = "For Brutus is an honorable man" val mUS: Matcher = p.matcher(caesarUS) assertEquals(true, mUS.find(), "Should matches US spelling") } @Test fun `expressions régulières plus complexes`() { //Notez que nous devons utiliser \\ car nous avons besoin d'un littéral \ //et Java utilise un seul \ comme caractère d'échappement var pStr = "\\d" // Un chiffre numérique var text = "Apollo 13" var p = Pattern.compile(pStr) var m = p.matcher(text) print(pStr + " matches " + text + "? " + m.find()) println(" ; match: " + m.group()) pStr = "[a..zA..Z]" //N'importe quelle lettre p = Pattern.compile(pStr) m = p.matcher(text) print(pStr + " matches " + text + "? " + m.find()) println(" ; match: " + m.group()) //N'importe quel nombre de lettres, qui doivent toutes être comprises entre 'a' et 'j' //mais peut-être en majuscule ou en minuscule. pStr = "([a..jA..J]*)" p = Pattern.compile(pStr) m = p.matcher(text) print(pStr + " matches " + text + "? " + m.find()) println(" ; match: " + m.group()) text = "abacab" //'a' suivi de quatre caractères quelconques, suivi de 'b' pStr = "a....b" p = Pattern.compile(pStr) m = p.matcher(text) print(pStr + " matches " + text + "? " + m.find()) println(" ; match: " + m.group()) } @Test fun `Quelles chaînes correspondent à la regex ?`() { val pStr = "\\d" // Un chiffre numérique val p = Pattern.compile(pStr) val ls: List<String> = Arrays.asList("Cat", "Dog", "Ice-9", "99 Luftballoons") val containDigits: List<String> = ls.stream() .filter(p.asPredicate()) .collect(Collectors.toList()) assert(containDigits.contains("Ice-9")) assert(containDigits.contains("99 Luftballoons")) assertEquals(2, containDigits.size) } }</code></pre> </div> </div> <div class="sect2"> <h3 id="_πίνακας_regex_μηταχαρακτήρες">Πίνακας regex μηταχαρακτήρες</h3> <table class="tableblock frame-all grid-all stretch"> <colgroup> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7543%;"> <col style="width: 1.7592%;"> </colgroup> <tbody> <tr> <td class="tableblock halign-left valign-top"><p class="tableblock">μεταχαρακτήρας</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">λειτουργικότητα</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Σημειώσεις</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">?</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Προαιρετικός χαρακτήρας—μηδέν ή μία παρουσία</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">*</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Μηδέν ή περισσότερο από τον προηγούμενο χαρακτήρα</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">+</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ένας ή περισσότεροι από τους προηγουμένους χαρακτήρες</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">{M,N}</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ανάμεσα M και N εμφανίσεις του προηγούμενου χαρακτήρα</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\d</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ένας αριθμός</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\D</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Μη αριθμητικός χαρακτήρας</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\w</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ένας χαρακτήρας λέξης</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Αριθμοί, γράμματα και _</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\W</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ένας χαρακτήρας χωρίς λέξη</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\s</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ένας χαρακτήρας διαστήματος</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\S</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Ένας μη κενός χαρακτήρας</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\n</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Χαρακτήρας αλλαγής γραμμής</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">\t</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Χαρακτήρας tabulation</p></td> <td class="tableblock halign-left valign-top"></td> <td class="tableblock halign-left valign-top"><p class="tableblock">.</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Όποιος χαρακτήρας</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Δεν περιλαμβάνει τη νέα γραμμή στην Java</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">[ ]</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Οποιος χαρακτήρας που βρίσκεται μέσα σε αγκύλες</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Κλήση μιας κλάσης χαρακτήρων</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">[^ ]</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Κάθε χαρακτήρας που δεν βρίσκεται μέσα στα άγκιστρα</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">καλείται μια ανεστραμμένη κλάση χαρακτήρων</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">( )</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Κατασκευή μιας ομάδας στοιχείων μοτίβου</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">καλεσμένη μια ομάδα (ομάδα λήψης)</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">|</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Καθορισμός εναλλακτικών δυνατοτήτων</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Εφαρμόσου τον λογικό OR</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">^</p></td> <td class="tableblock halign-left valign-top"><p class="tableblock">Αρχή συμβολοσειράς $ Τέλος συμβολοσειράς</p></td> <td class="tableblock halign-left valign-top"></td> </tr> </tbody> </table> <div class="paragraph"> <p>συμπληρώνωhttps://www.codeurjava.com/2015/05/les-expressions-regulieres-avec-regex.html[με]</p> </div> </div> </div> </div> https://cheroliv.com/blog/2022/0047_memo_gradle_post.html Mon, 23 May 2022 00:00:00 +0000 blog/2022/0047_memo_gradle_post.html <div id="toc" class="toc"> <div id="toctitle">Sommaire</div> <ul class="sectlevel1"> <li><a href="#_εμφάνιση_βοήθειας">Εμφάνιση βοήθειας</a></li> <li><a href="#_ορισμός_της_ιδιότητας_συστήματος_της_jvm_d_system_prop">Ορισμός της ιδιότητας συστήματος της JVM: `-D, --system-prop</a></li> <li><a href="#_ορισμός_της_ιδιότητας_του_έργου_για_το_build_script_pmypropmyvalue">Ορισμός της ιδιότητας του έργου για το build script: `-Pmyprop=myvalue</a></li> <li><a href="#_καθορίζει_τον_κατάλογο_εκκίνησης_του_gradle_η_προεπιλεγμένη_τιμή_είναι_ο_τρέχων_κατάλογος">Καθορίζει τον κατάλογο εκκίνησης του Gradle. Η προεπιλεγμένη τιμή είναι ο τρέχων κατάλογος.</a></li> <li><a href="#_υπερφορτύστε_την_ιδιότητα_param_component_από_τη_γραμμή_εντολών">Υπερφορτύστε την ιδιότητα 'param_component' από τη γραμμή εντολών:</a></li> <li><a href="#_προσθέστε_έναν_φάκελο_σε_ένα_source_set_σε_ένα_κανονικό_έργο_με_το_kotlin_dsl">Προσθέστε έναν φάκελο σε ένα source-set σε ένα κανονικό έργο με το Kotlin DSL</a></li> <li><a href="#_προσθέστε_έναν_φάκελο_σε_ένα_sourceset_σε_ένα_έργο_android_με_το_groovy_dsl">Προσθέστε έναν φάκελο σε ένα source‑set σε ένα έργο Android με το Groovy DSL</a></li> <li><a href="#_αποφύγετε_τη_δημιουργία_και_τον_έλεγχο_ενός_υπομέρου">Αποφύγετε τη δημιουργία και τον έλεγχο ενός υπομέρου.</a></li> <li><a href="#_σύρτε_ένα_φάκελο">σύρτε ένα φάκελο</a></li> <li><a href="#_εμφάνιση_εξαρτήσεων_κατασκευής">Εμφάνιση εξαρτήσεων κατασκευής</a></li> <li><a href="#_παράδειγμα_χρήσης_της_reduce_ενώνουσα_μιας_λίστας_σε_μια_συμβολοσειρά">Παράδειγμα χρήσης της reduce : ενώνουσα μιας λίστας σε μια συμβολοσειρά</a></li> <li><a href="#_λήψη_της_περιγραφίας_μιας_συγκεκριμένης_εργασίας">Λήψη της περιγραφίας μιας συγκεκριμένης εργασίας</a></li> <li><a href="#_για_να_εκκινήσετε_μια_εργασία_από_το_workingdir_ρίζα_προθέστε_την_εργασία_με_ένα">Για να εκκινήσετε μια εργασία από το workingDir ρίζα, προθέστε την εργασία με ένα `:</a></li> <li><a href="#_για_να_επανεκκινήσετε_τις_εργασίες_που_απέτυχαν_χρησιμοποιήστε_την_επιλογή_rerun_tasks">Για να επανεκκινήσετε τις εργασίες που απέτυχαν, χρησιμοποιήστε την επιλογή `--rerun-tasks</a></li> <li><a href="#_εκκίνηση_μιας_εργασίας_σε_ένα_συγκεκριμένο_έργο_από_άλλο_κατάλογο">Εκκίνηση μιας εργασίας σε ένα συγκεκριμένο έργο από άλλο κατάλογο</a></li> </ul> </div> <div class="sect1"> <h2 id="_εμφάνιση_βοήθειας">Εμφάνιση βοήθειας</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">./gradlew --help</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ορισμός_της_ιδιότητας_συστήματος_της_jvm_d_system_prop">Ορισμός της ιδιότητας συστήματος της JVM: `-D, --system-prop</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">./gradlew -Dmyprop=myvalue #ou ./gradlew --system-prop myvalue</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_ορισμός_της_ιδιότητας_του_έργου_για_το_build_script_pmypropmyvalue">Ορισμός της ιδιότητας του έργου για το build script: `-Pmyprop=myvalue</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">./gradlew -Pmyprop=myvalue #ou ./gradlew --project-prop myvalue</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_καθορίζει_τον_κατάλογο_εκκίνησης_του_gradle_η_προεπιλεγμένη_τιμή_είναι_ο_τρέχων_κατάλογος">Καθορίζει τον κατάλογο εκκίνησης του Gradle. Η προεπιλεγμένη τιμή είναι ο τρέχων κατάλογος.</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">./gradlew -p ~/src/next_startup #ou ./gradlew --project-dir ~/src/next_startup</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_υπερφορτύστε_την_ιδιότητα_param_component_από_τη_γραμμή_εντολών">Υπερφορτύστε την ιδιότητα 'param_component' από τη γραμμή εντολών:</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">./gradlew -Pparam_component=CUSTOM_VALUE</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_προσθέστε_έναν_φάκελο_σε_ένα_source_set_σε_ένα_κανονικό_έργο_με_το_kotlin_dsl">Προσθέστε έναν φάκελο σε ένα source-set σε ένα κανονικό έργο με το Kotlin DSL</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">sourceSets { getByName("test"){ java.srcDir("src/scripts/groovy") } getByName("test"){ java.srcDir("src/scripts/kscript") } getByName("test"){ java.srcDir("src/test/javascript") } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_προσθέστε_έναν_φάκελο_σε_ένα_sourceset_σε_ένα_έργο_android_με_το_groovy_dsl">Προσθέστε έναν φάκελο σε ένα source‑set σε ένα έργο Android με το Groovy DSL</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">android { sourceSets { main.java.srcDirs += "src/main/../../../../ceelo/domain/src/main/java/" test.java.srcDirs += "src/test/../../../../ceelo/domain/src/test/java/" } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_αποφύγετε_τη_δημιουργία_και_τον_έλεγχο_ενός_υπομέρου">Αποφύγετε τη δημιουργία και τον έλεγχο ενός υπομέρου.</h2> <div class="sectionbody"> <div class="paragraph"> <p>gradle build -x :excluded-module:check -x :excluded-module:assemble -x :excluded-module:build</p> </div> <div class="listingblock"> <div class="title">Μετακίνηση αρχείων</div> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">tasks.register("moveWebappNode") { doLast { ant.withGroovyBuilder { "move"( "webapp/node_modules" to "$rootDir/webapp-src/node_modules", ) } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_σύρτε_ένα_φάκελο">σύρτε ένα φάκελο</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">tasks.register<Tar>("tarWebapp") { dependsOn("moveWebappNpm") group = WEBAPP description = "tar webapp" doLast { setOf( "build", "target", "node_modules" ).forEach { dir -> exclude { it.name .dir } } archiveFileName.set("webapp.tar") destinationDirectory.set(File("${rootDir.absolutePath}$sep$WEBAPP_SRC")) } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_εμφάνιση_εξαρτήσεων_κατασκευής">Εμφάνιση εξαρτήσεων κατασκευής</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">tasks.register("printDependencies") { description = "print project dependencies" group = WEBAPP doLast { println("${project.name} dependencies") mutableMapOf<String, Map<String, String>>( "buildDependencies" to buildDependencies, "domainDeps" to domainDeps, "domainTestDeps" to domainTestDeps, ).apply { putAll(appModules) } .forEach { module -> if (module.value.isNotEmpty()) { println("${module.key}:") module.value.forEach { println(dependency(it)) } println() } } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_παράδειγμα_χρήσης_της_reduce_ενώνουσα_μιας_λίστας_σε_μια_συμβολοσειρά">Παράδειγμα χρήσης της reduce : ενώνουσα μιας λίστας σε μια συμβολοσειρά</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">tasks.register("printWebappSrc") { description = "print webapp sources" group = WEBAPP doLast { webAppSrc .reduce { acc, s -> "$acc\n\t$s" } .run { println("$WEBAPP_SRC: $this\n") } } }</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_λήψη_της_περιγραφίας_μιας_συγκεκριμένης_εργασίας">Λήψη της περιγραφίας μιας συγκεκριμένης εργασίας</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">./gradlew -q help --task foo</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_για_να_εκκινήσετε_μια_εργασία_από_το_workingdir_ρίζα_προθέστε_την_εργασία_με_ένα">Για να εκκινήσετε μια εργασία από το workingDir ρίζα, προθέστε την εργασία με ένα `:</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">./gradlew :foo</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_για_να_επανεκκινήσετε_τις_εργασίες_που_απέτυχαν_χρησιμοποιήστε_την_επιλογή_rerun_tasks">Για να επανεκκινήσετε τις εργασίες που απέτυχαν, χρησιμοποιήστε την επιλογή `--rerun-tasks</h2> <div class="sectionbody"> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">./gradlew check --rerun-tasks</code></pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_εκκίνηση_μιας_εργασίας_σε_ένα_συγκεκριμένο_έργο_από_άλλο_κατάλογο">Εκκίνηση μιας εργασίας σε ένα συγκεκριμένο έργο από άλλο κατάλογο</h2> <div class="sectionbody"> <div class="paragraph"> <p>Η επιλογή`-p` (ou <code>--project-dir</code>) επιτρέπει να καθορίσετε τη διαδρομή πρόσβασης σε ένα έργο Gradle και να εκτελέσετε μια εργασία σε αυτό, ακόμα κι αν ο τρέχων κατάλογος είναι διαφορετικός.</p> </div> <div class="paragraph"> <p>Για παράδειγμα, για να ξεκινήσετε την εργασία`build`du progetto`~/projets/mon-autre-projet`Enquanto είναι σε άλλο φάκελο :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">./gradlew -p ~/projets/mon-autre-projet build</code></pre> </div> </div> <div class="paragraph"> <p>Αυτό είναι ιδιαίτερα χρήσιμο για τη γραφή σεναρίων ενεργειών σε πολλά έργα από ένα κεντρικό σημείο.</p> </div> <div class="ulist"> <div class="title">Δείτε επίσης :</div> <ul> <li> <p><a href="https://docs.gradle.org/current/userguide/command_line_interface.html#sec:command_line_warnings">αναφορά</a></p> </li> <li> <p><a href="https://docs.gradle.org/current/userguide/command_line_interface.html#sec:command_line_options">αναφορά</a></p> </li> <li> <p><a href="https://stackoverflow.com/a/36178581/837404">συζήτηση</a></p> </li> </ul> </div> </div> </div> https://cheroliv.com/blog/2022/0038_training_kotlin_enum_sealed_class_post.html Tue, 17 May 2022 00:00:00 +0000 blog/2022/0038_training_kotlin_enum_sealed_class_post.html <div class="paragraph"> <p>Οι sealed classes, δεν είναι διαροφές (λέξη-κλειδί:enum).<br> Έρχοντας από τη Java, θα μπορούσατε να σας πειράξετε να υπερφορτίσετε την απαρίθμησή σας των συνεισφορών λειτουργιών: // Κώδικας Java</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-java" data-lang="java">enum PizzaOrderStatus { ORDER_RECEIVED, PIZZA_BEING_MADE, OUT_FOR_DELIVERY, COMPLETED; public PizzaOrderStatus nextStatus() { switch (this) { case ORDER_RECEIVED: return PIZZA_BEING_MADE; case PIZZA_BEING_MADE: return OUT_FOR_DELIVERY; case OUT_FOR_DELIVERY: return COMPLETED; case COMPLETED:return COMPLETED; } } }</code></pre> </div> </div> <div class="paragraph"> <p>Αντ' αυτού, μπορείτε να χρησιμοποιήσετε την κλειστή κλάση:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">sealed class PizzaOrderStatus(protected val orderId: Int) { abstract fun nextStatus() : PizzaOrderStatus class OrderReceived(orderId: Int) : PizzaOrderStatus(orderId) { override fun nextStatus(): PizzaOrderStatus { return PizzaBeingMade(orderId) } } class PizzaBeingMade(orderId: Int) : PizzaOrderStatus(orderId) { override fun nextStatus(): PizzaOrderStatus { return OutForDelivery(orderId) } } class OutForDelivery(orderId: Int) : PizzaOrderStatus(orderId) { override fun nextStatus(): PizzaOrderStatus { return Completed(orderId) } } class Completed(orderId: Int) : PizzaOrderStatus(orderId) { override fun nextStatus(): PizzaOrderStatus { return this } } }</code></pre> </div> </div> <div class="paragraph"> <p>Το πλεονέκτημα αυτής της προσέγγισης είναι ότι τώρα μπορούμε να μεταφέρουμε δεδομένα με το Κατάσταση:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">var status: PizzaOrderStatus = OrderReceived(123) while (status !is Completed) { status = when (status) { is OrderReceived -> status.nextStatus() is PizzaBeingMade -> status.nextStatus() is OutForDelivery -> status.nextStatus() is Completed -> status } }</code></pre> </div> </div> <div class="paragraph"> <p>Συνήθως, οι κλειστές κλάσεις είναι καλές αν θέλετε να έχετε δεδομένα που είναι συνδεδεμένα με ένα Κράτος.</p> </div> https://cheroliv.com/blog/2022/0036_training_kotlin_post.html Thu, 12 May 2022 00:00:00 +0000 blog/2022/0036_training_kotlin_post.html <div class="sect1"> <h2 id="_χάρτης_μυαλού">χάρτης μυαλού</h2> <div class="sectionbody"> <div class="paragraph"> <p><span class="image"><img src="../../diagram/training_kotlin.png" alt="training_kotlin"></span></p> </div> </div> </div> <div class="sect1"> <h2 id="_λειτουργικός_προγραμματισμός">Λειτουργικός προγραμματισμός</h2> <div class="sectionbody"> <div class="paragraph"> <p>Οι ασκήσεις είναι παγμένες από το βιβλίο:<br> Λειτουργικός προγραμματισμός στην Kotlin με tutorial<br> Γραμμένο από Massimo Carli<br> repo: <a href="https://github.com/kodecocodes/fpk-materials" class="bare">https://github.com/kodecocodes/fpk-materials</a></p> </div> <div class="sect2"> <h3 id="_σύνταξη">Σύνταξη</h3> <div class="sect3"> <h4 id="_firstprogramtest">FirstProgramTest</h4> <div class="paragraph"> <p>έννοιες: εμφάνιση οθόνης, λειτουργία<br> FirstProgramTest:https://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/programming/FirstProgramTest.kt[source]+</p> </div> </div> <div class="sect3"> <h4 id="_concatfunctiontest">ConcatFunctionTest</h4> <div class="paragraph"> <p>εννοίες: μνήμη, μεταβλητή, τιμή, αντικείμενο, έκταση συνάρτησης<br> ExampleUnitTest: <a href="https://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/programming/ConcatFunctionTest.kt">πηγή</a>+</p> </div> </div> <div class="sect3"> <h4 id="_έξοδος_δοκιμής_μηνύματος_γενεθλίας">Έξοδος δοκιμής μηνύματος γενεθλίας</h4> <div class="paragraph"> <p>εννοιες: σέτα, βρόχοι<br> <a href="https://developer.android.com/codelabs/basic-android-kotlin-training-first-kotlin-program?continue=https%3A%2F%2Fdeveloper.android.com%2Fcourses%2Fpathways%2Fandroid-basics-kotlin-one%23codelab-https%3A%2F%2Fdeveloper.android.com%2Fcodelabs%2Fbasic-android-kotlin-training-first-kotlin-program">Εισαγωγή στο Kotlin</a><br> BirthdayMessageTestOutput:https://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/programming/BirthdayMessageTestOutput.kt[πηγή]+</p> </div> </div> </div> <div class="sect2"> <h3 id="_μάθημα_kotlin">Μάθημα kotlin</h3> <div class="videoblock"> <div class="content"> <iframe src="https://www.youtube.com/embed/YRjY3jRrQYY?rel=0" frameborder="0" allowfullscreen></iframe> </div> </div> </div> <div class="sect2"> <h3 id="_οδηγός_για_τις_συλλογές_στην_java">Οδηγός για τις συλλογές στην Java</h3> <div class="paragraph"> <p><a href="https://docs.oracle.com/javase/tutorial/collections/index.html">Συλλογές</a></p> </div> <div class="paragraph"> <p>η καρδιά των διεπαφών συλλογής<br> εικόνα:../../img/0036_training_kotlin_post/colls-coreInterfaces.gif[Συλλογές]<br></p> </div> </div> <div class="sect2"> <h3 id="_λειτουργικά_βασικά">Λειτουργικά βασικά</h3> <div class="sect3"> <h4 id="_δηλωτική_x_προστακτική_προσέγγιση">Δηλωτική X προστακτική προσέγγιση</h4> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">package functional import kotlin.test.Test import kotlin.test.assertEquals class DeclarativeTests { val input = listOf( "123", "abc", "1ds", "987", "abdf", "1d3", "de1", "88", "101" ) fun imperativeSum(list: List<String>): Int { var sum = 0 for (item in list) { try { sum += item.toInt() } catch (_: NumberFormatException) { } } return sum } @Test fun `test imperative approach`() { imperativeSum(input).run { println("Sum $this") assertEquals(1299, this) } } fun isValidNumber(s: String) = try { s.toInt() true } catch (_: NumberFormatException) { false } fun declarativeSum(list: List<String>) = list .filter(::isValidNumber) .map(String::toInt) .sum() @Test fun `test declarative approach`() { assertEquals(1299, declarativeSum(input).apply { println("Sum $this") }) } }</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_άσκηση_1_1">�Άσκηση 1.1</h4> <div class="paragraph"> <p>Υλοποιήστε τη συνάρτηση sumInRange, η οποία προσθέτει τις τιμές στο<br> μια List<String> σε ένα δοσμένο διάστημα. Η υπογραφή είναι :</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">fun sumInRange(input: List<String>, range: IntRange): Int</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">@Test fun `Exercise 1_1`() { assertEquals(4, sumInRange( listOf("1", "10", "a", "7", "ad2", "3"), 1..5 ).apply { println("sumInRange 1..5: $this") } ) }</code></pre> </div> </div> <div class="paragraph"> <p>Δοκιμάστε το και ελέγξτε την απάντησή σας με τηνhttps://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/functional/DeclarativeTests.kt[λύση, windows="_blank].</p> </div> </div> <div class="sect3"> <h4 id="_υψηλού_βαθμού_συναρτήσεις">υψηλού βαθμού συναρτήσεις</h4> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">package functional import java.io.ByteArrayOutputStream import java.io.PrintStream import java.lang.System.* import java.lang.Thread.sleep import kotlin.math.sign import kotlin.test.Test import kotlin.test.assertEquals class BasicsHOFTests { val ONE_SECOND = 1000L @Test fun `high order function`() { //capture de la sortie standard val standardOut: PrintStream? = out val outputStreamCaptor = ByteArrayOutputStream() setOut(PrintStream(outputStreamCaptor)) 3.times { println("Hello") } assertEquals( buildString { repeat(3) { append("Hello\n") } deleteAt(length - 1) }, outputStreamCaptor .toString() .trim() ) //libération de la sortie standard setOut(standardOut) } fun Int.times1(fn: () -> Unit) { for (i in 1..this) { fn() } } fun Int.times2(fn: () -> Unit) { for (i in 1..this) fn() } fun Int.times3(fn: () -> Unit) = (1..this).forEach { fn() } fun Int.times4(fn: () -> Unit) = repeat((1..this).count()) { fn() } fun Int.times(fn: () -> Unit) = (1..this).forEach { _ -> fn() } }</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_άσκηση_1_2">Άσκηση 1.2</h4> <div class="paragraph"> <p>Υλοποιήστε το chrono, που δέχεται μια συνάρτηση τύπου`() →`<br> Η μονάδα παίρνει ως είσοδο και επιστρέφει τον χρόνο που πέρασε στην εκτέλεσή του. Η υπογραφή είναι:<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">fun chrono(fn : () -> Unité) : Long</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">@Test fun `Exercise 1_2`() { val waitOneSec = { sleep(ONE_SECOND) } chrono(waitOneSec).apply { println("chrono: $this") assertEquals(1, sign) } }</code></pre> </div> </div> <div class="paragraph"> <p>Δοκιμάστε το και ελέγξτε την απάντησή σας με τοhttps://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/functional/BasicsHOFTests.kt[λύση, windows="_blank].</p> </div> </div> <div class="sect3"> <h4 id="_σύνθεση">Σύνθεση</h4> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">package functional import kotlin.test.Test import kotlin.test.assertEquals fun double(x: Int): Int = 2 * x fun square(x: Int): Int = x * x fun squareAndDouble1(x: Int) = double(square(x)) infix fun <A, B, C> ((A) -> B).compose(g: (B) -> C) : (A) -> C = { a -> g(this(a)) } class CompositionTests { @Test fun composition_impure() { assertEquals(200, double(square(10))) assertEquals(200, squareAndDouble1(10)) } @Test fun composition_pure() { val squareAndDouble = ::square compose ::double assertEquals(200, squareAndDouble(10)) } }</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_καθαρές_συναρτήσεις_και_δοκιμασιμότητα">καθαρές συναρτήσεις και δοκιμασιμότητα</h4> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">package functional import java.io.ByteArrayOutputStream import java.io.PrintStream import java.lang.System.out import java.lang.System.setOut import kotlin.test.Test import kotlin.test.assertEquals var count = 0 //impure car une variable global subit un effet de bord fun impure(value: Int): Int { count++ return value + count } //impure car utilisation de la sortie standard qui fait muter le system fun addOneAndLog(x: Int): Int { val result = x + 1 println("New Value is $result") return result } //pure fun addOne(x: Int) = (x + 1).run { Pair(this, "New Value is $this") } class PureTests { @Test fun `impure fonction`() { assertEquals(3, impure(2)) val standardOut = out val outputStreamCaptor = ByteArrayOutputStream() setOut(PrintStream(outputStreamCaptor)) addOneAndLog(3) assertEquals( "New Value is 4", outputStreamCaptor .toString() .trim() ) setOut(standardOut) } @Test fun `pure fonction`() { addOne(3).run { assertEquals(4, first) assertEquals("New Value is 4", second) } } }</code></pre> </div> </div> </div> <div class="sect3"> <h4 id="_διαχείριση_εξαιρέσεων">Διαχείριση εξαιρέσεων</h4> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">package functional import org.junit.jupiter.api.assertThrows import kotlin.Result.Companion.failure import kotlin.Result.Companion.success import kotlin.test.Test import kotlin.test.assertEquals //NumberFormatException est un effet de bord qui rend la fonction impure fun strToInt(str: String) = str.toInt() //pure fun strToIntOrNull(str: String) = try { str.toInt() } catch (nfe: NumberFormatException) { null } //pure avec gestion de l'exception plus élégante fun strToIntResult(str: String): Result<Int> = try { success(str.toInt()) } catch (nfe: NumberFormatException) { failure(nfe) } class ExceptionHandlingTests { @Test fun impure() { assertThrows<NumberFormatException> { strToInt("foo") } assertEquals(1, strToInt("1")) } @Test fun pure() { assertEquals(null, strToIntOrNull("foo")) assertEquals(1, strToIntOrNull("1")) } @Test fun `pure avec result`() { assertEquals(1, strToIntResult("1").getOrNull()) assertEquals( "For input string: \"foo\"", strToIntResult("foo") .exceptionOrNull() ?.message ) } }</code></pre> </div> </div> </div> </div> <div class="sect2"> <h3 id="_κλειδιά_σημεία">Κλειδιά σημεία</h3> <div class="ulist"> <ul> <li> <p>Ως που η αντικειμενοστραφής προγραμματισμός σημαίνει τον προγραμματισμό με αντικείμενα,</p> </li> </ul> </div> <div class="paragraph"> <p>Η λειτουργική προγραμματισμός σημαίνει να προγραμματίζετε με συναρτήσεις. Αναλύετε ένα πρόβλημα σε πολλά υποπροβλήματα, που το μοντελοποιείτε με οι λειτουργίες.</p> </div> <div class="ulist"> <ul> <li> <p>Οι συναρτήσεις υψηλότερου τάξης δέχονται άλλες συναρτήσεις ως είσοδο ή επιστρέφουν άλλες</p> </li> </ul> </div> <div class="paragraph"> <p>λειτουργούν ως τιμές επιστροφής. Η théorie des categories est la théorie de la composition, et vous l’utilisez pour comprendre</p> </div> <div class="paragraph"> <p>Wait need Greek not French. Let’s produce correct Greek:</p> </div> <div class="paragraph"> <p>"Η θεωρία των κατηγοριών είναι η θεωρία της σύνθεσης, και τη χρησιμοποιείτε για να κατανοήσετε". Ensure no extra spaces. Output only that.</p> </div> <div class="paragraph"> <p></think></p> </div> <div class="paragraph"> <p>Η théorie des categories est la théorie de la composition, et vous l’utilisez pour comprendre</p> </div> <div class="paragraph"> <p>Oops I mistakenly repeated French. Let’s correct.</p> </div> <div class="paragraph"> <p>Final answer: Greek translation.</p> </div> <div class="paragraph"> <p></think></p> </div> <div class="paragraph"> <p>Η θεωρία των κατηγοριών είναι η θεωρία της σύνθεσης, και τη χρησιμοποιείτε για να κατανοήσετε πώς να συνθέσετε τις συναρτήσεις σας σε ένα πρόγραμμα εργασίας. Η τιμή εξόδου μιας καθαρής συνάρτησης δεν εξαρτάται μόνο από τις παραμέτρους εισόδου, και αυτή Δεν έχει παρενέργειες.</p> </div> <div class="ulist"> <ul> <li> <p>Ένα παρενέργεια είναι κάτι που μια συνάρτηση κάνει στον εξωτερικό κόσμο. αυτό</p> </li> </ul> </div> <div class="paragraph"> <p>μπορεί να είναι ένα αρχείο καταγραφής στην τυπική έξοδο ή η τροποποίηση της τιμής μιας παγκόσμιας μεταβλητής. Η λειτουργική προγραμματισμός λειτουργεί για τις καθαρές συναρτήσεις, αλλά παρέχει επίσης τα εργαλεία για τη μετατροπή ανεπακτικών συναρτήσεων σε καθαρές συναρτήσεις. Μπορείτε να κάνετε μια ακαθάρτη συνάρτηση καθαρή μετατοπίζοντας τα εφέ ώστε να τα κάνετε μέρος της τιμής επιστροφής</p> </div> <div class="ulist"> <ul> <li> <p>Ο λειτουργικός προγραμματισμός είναι θέμα σύνθεσης.</p> </li> </ul> </div> <div class="paragraph"> <p>Η διαχείριση σφαλμάτων είναι μια τυπική περίπτωση παρενέργειας, και η Kotlin σας δίνει τα εργαλεία για να τα διαχειρίζονται με λειτουργικό τρόπο.</p> </div> </div> <div class="sect2"> <h3 id="_βαθύτερη_μελέτη_java_8_έκφράσεις_lambda_και_λειτουργικές_διεπαφές">Βαθύτερη μελέτη Java 8: έκφράσεις lambda και λειτουργικές διεπαφές</h3> <div class="videoblock"> <div class="content"> <iframe src="https://www.youtube.com/embed/20waNRw6wMA?rel=0&list=PLzzeuFUy_Cng0wZhqbnkvWAW0d2fdVfyQ" frameborder="0" allowfullscreen></iframe> </div> </div> </div> <div class="sect2"> <h3 id="_θεωρία_των_κατηγοριών">�Θεωρία των κατηγοριών</h3> <div class="paragraph"> <p>Η μαθηματική θεωρία των κατηγοριών:</p> </div> <div class="videoblock"> <div class="content"> <iframe src="https://www.youtube.com/embed/LVHoROSF3KA?rel=0" frameborder="0" allowfullscreen></iframe> </div> </div> </div> <div class="sect2"> <h3 id="_βασικά_των_συναρτήσεων">Βασικά των συναρτήσεων</h3> <div class="sect3"> <h4 id="_άσκηση_2_1">�Άσκηση 2.1</h4> <div class="paragraph"> <p>Μπορείτε να γράψετε ένα παράδειγμα συνάρτησης που αντιστοιχεί διαφορετικές τιμές<br> ποιος το τομέα έχει μη διακριτές τιμές στο εύρος, όπως f(b) και f(c) στον παρακάτω γράφημα ?<br></p> </div> <div class="paragraph"> <p>Δοκίμασέ το, στη συνέχεια ελέγξτε το πρότζεκτ του defi για μια λύση ώστε να δείς πώς το έκανες.<br> �Θα βρείτε συμβουλές και μια εξήγηση ακολουθώντας το σύνδεσμο προς την <a href="https://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/functional/BasicsHOFTests.kt">λύση</a>.<br></p> </div> </div> <div class="sect3"> <h4 id="_άσκηση_2_2">Άσκηση 2.2</h4> <div class="paragraph"> <p>Μπορείτε να γράψτε την αντίστροφη συνάρτηση του διπλασιασμού;<br> Ποια είναι το domain και το εύρος της αντίστροφης συνάρτησης;<br> Εξετάστε το έργο της πρόκλησης και το Πρόσθετο B για τη λύση.</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">fun chrono(fn : () -> Unité) : Long</code></pre> </div> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin">@Test fun `Exercise 1_2`() { val waitOneSec = { sleep(ONE_SECOND) } chrono(waitOneSec).apply { println("chrono: $this") assertEquals(1, sign) } }</code></pre> </div> </div> <div class="paragraph"> <p>Δοκιμάστε το και ελέγξτε την απάντησή σας με τηhttps://github.com/cheroliv/cheroliv.com/blob/master/codes/src/test/kotlin/functional/BasicsHOFTests.kt[λύση, windows="_blank].</p> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2022/0031_memo_design_system_post.html Sun, 9 Jan 2022 00:00:00 +0000 blog/2022/0031_memo_design_system_post.html <div class="sect1"> <h2 id="_εργαλεία">Εργαλεία</h2> <div class="sectionbody"> <div class="dlist"> <div class="title"><strong>ιλλουστρaτιονα</strong></div> <dl> <dt class="hdlist1"><a href="https://undraw.co/">undraw.co</a></dt> <dd> <p>Εικόνες ανοιχτού κώδικα για όλες τις ιδέες που μπορείτε να φανταστείτε και να δημιουργήσετε.</p> </dd> <dt class="hdlist1"><a href="https://absurd.design/">absurd.design</a></dt> <dd> <p>Αβсурδείς εικόνες που έχουν νόημα.</p> </dd> <dt class="hdlist1"><a href="https://drawkit.com/">drawkit.com</a></dt> <dd> <p>Υπεροχες εικονογραφίες δωρεάν. Εβδομαδιαίες ενημερώσεις.</p> </dd> <dt class="hdlist1"><a href="https://icons8.com/">icons8.com</a></dt> <dd> <p>Εικονίδια, εικονογραφήσεις, φωτογραφίες, μουσική και εργαλεία σχεδίασης.</p> </dd> <dt class="hdlist1"><a href="https://blush.design/">blush.design</a></dt> <dd> <p>Εικονίδια, εικονογραφίες, φωτογραφίες, μουσική και εργαλεία σχεδιασμού</p> </dd> <dt class="hdlist1"><a href="https://www.humaaans.com/">humaaans.com</a></dt> <dd> <p>ανακατεύετε και συνδυάζετε εικονογραφίες ατόμων με μια βιβλιοθήκη σχεδιασμού</p> </dd> </dl> </div> <div class="dlist"> <div class="title"><strong>Χρώματα</strong></div> <dl> <dt class="hdlist1"><a href="https://coolors.co/">coolors.co</a></dt> <dd> <p>Ο υπερ-γρήγορος γεννήτης χρωματικών σχημάτων!</p> </dd> </dl> </div> <div class="dlist"> <div class="title"><strong>Τάσεις</strong></div> <dl> <dt class="hdlist1"><a href="https://fr.pinterest.com">pinterest</a></dt> <dd> <p>Οπτική ανακάλυψη ιδεών: εικόνες, βίντεο, θεματικές συλλογές.</p> </dd> <dt class="hdlist1"><a href="https://dribbble.com">ντρίμπλ</a></dt> <dd> <p>Πλατφόρμα για σχεδιαστές που μοιράζονται τις δημιουργίες τους και αλληλεπιδρούν.</p> </dd> </dl> </div> <div class="dlist"> <div class="title"><strong>UX/UI και Design Systems</strong></div> <dl> <dt class="hdlist1"><a href="https://material.io/">Google Material Design</a></dt> <dd> <p>Σύστημα σχεδιασμού της Google για ενωμένες και προσαρμόσιμες διεπαφές χρήστη.</p> </dd> <dt class="hdlist1"><a href="https://developer.apple.com/design/human-interface-guidelines/">Οδηγίες Διεπαφής Ανθρώπου Apple</a></dt> <dd> <p>Οι συστάσεις της Apple για τη σχεδίαση εφαρμογών iOS και macOS που είναι εύκολες στη χρήση.</p> </dd> <dt class="hdlist1"><a href="https://www.uxpin.com/">UXPin</a></dt> <dd> <p>Πλατφόρμα σχεδιασμού και συνεργασίας για τη δημιουργία προτύπων και συστημάτων σχεδιασμού.</p> </dd> <dt class="hdlist1"><a href="https://www.frontify.com/">Frontify</a></dt> <dd> <p>Πλατφόρμα διαχείρισης μάρκας και συστημάτων σχεδίασης για τη διασφάλιση της συνέπειας.</p> </dd> <dt class="hdlist1"><a href="https://designsystemsrepo.com/design-systems/">Αποθετήριο Συστημάτων Σχεδίασης</a></dt> <dd> <p>Συλλογή πόρων και παραδειγμάτων συστημάτων σχεδιασμού για έμπνευση</p> </dd> </dl> </div> <div class="dlist"> <div class="title"><strong>Ανάπτυξη Frontend</strong></div> <dl> <dt class="hdlist1"><a href="https://htmlcheatsheet.com">htmlcheatsheet.com</a></dt> <dd> <p>HTML φυλλάδιο βοήθειας</p> </dd> <dt class="hdlist1"><a href="https://fontawesome.com" target=""_blank">fontawesome.com</a></dt> <dd> <p>βιβλιοθήκη εικονίδιων</p> </dd> <dt class="hdlist1"><a href="https://www.toptal.com/designers/htmlarrows/symbols/">toptal.com/designers/htmlarrows/symbols</a></dt> <dd> <p>Εγγενείς εικονίδια σε HTML</p> </dd> <dt class="hdlist1"><a href="https://css-tricks.com/">CSS-Tricks</a></dt> <dd> <p>Απαραίτητο για CSS, με άρθρα, οδηγούς και σύγχρονες συμβουλές frontend.</p> </dd> <dt class="hdlist1"><a href="https://www.frontendmentor.io/">Frontend Mentor</a></dt> <dd> <p>Προκλήσεις κώδικα frontend βασισμένες σε πραγματικά projects για τη βελτίωση των δεξιοτήτων σας.</p> </dd> <dt class="hdlist1"><a href="https://dev.to/">Dev.to</a></dt> <dd> <p>Κοινότητα προγραμματιστών για να μοιραστούν άρθρα, οδηγούς και έργα.</p> </dd> <dt class="hdlist1"><a href="https://codepen.io/">CodePen</a></dt> <dd> <p>Διαδικτυακός επεξεργαστής κώδικα και κοινότητα για να μοιραστείτε τμήματα κώδικα και δεμόνστρασείς</p> </dd> </dl> </div> <div class="dlist"> <div class="title"><strong>Ανάπτυξη Frontend βοηθούμενη από ΤΝ</strong></div> <dl> <dt class="hdlist1"><a href="https://v0.dev/">v0.dev</a></dt> <dd> <p>v0 μετατρέπει τις περιγραφές σε φυσική γλώσσα σε κώδικα και διεπαφή χρήστη.</p> </dd> <dt class="hdlist1"><a href="https://uizard.io/">Uizard</a></dt> <dd> <p>Το Uizard εστιάζει στην μετατροπή των μοντέλων (εικόνες, σχέδια) σε κώδικα HTML, CSS και React.</p> </dd> <dt class="hdlist1"><a href="https://www.usegalileo.ai/explore">usegalileo.ai</a></dt> <dd> <p>Galileo AI σας επιτρέπει να περιγράψετε τη διεπαφή που θέλετε σε φυσική γλώσσα, και η ΙΑ δημιουργεί επεξεργάσιμα σχεδιάσματα Figma.</p> </dd> <dt class="hdlist1"><a href="https://play.teleporthq.io/">TeleportHQ</a></dt> <dd> <p>Το TeleportHQ είναι μια πλατφόρμα low-code ανάπτυξης front-end που χρησιμοποιεί την ΤΝ για να σε βοηθήσει να κατασκευάσετε και να αναπτύξετε οπτικά ιστότοπους.</p> </dd> </dl> </div> </div> </div> https://cheroliv.com/blog/2020/0029_kubernetes_microk8s_docker_premiers_pas_post.html Tue, 3 Nov 2020 00:00:00 +0000 blog/2020/0029_kubernetes_microk8s_docker_premiers_pas_post.html <div id="preamble"> <div class="sectionbody"> <div class="paragraph"> <p><a href="https://microk8s.io/docs/">επίσημη τεκμηρίωση του microk8s</a><br></p> </div> </div> </div> <div class="sect3"> <h4 id="_εγκατάσταση_του_πακέτου_microk8s">Εγκατάσταση του πακέτου microk8s:</h4> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"></code></pre> </div> </div> </div> https://cheroliv.com/blog/2020/0028_gradle_executer_un_processus_externe_depuis_une_tache_gradle_post.html Mon, 28 Sep 2020 00:00:00 +0000 blog/2020/0028_gradle_executer_un_processus_externe_depuis_une_tache_gradle_post.html <div class="sect3"> <h4 id="_gradle_kotlin_dsl">Gradle-Kotlin-DSL:</h4> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-kotlin" data-lang="kotlin"></code></pre> </div> </div> </div> https://cheroliv.com/blog/2020/0027_kotlin_not_implemented_exception_not_implemented_error_post.html Sun, 27 Sep 2020 00:00:00 +0000 blog/2020/0027_kotlin_not_implemented_exception_not_implemented_error_post.html <div class="paragraph"> <p>NotImplementedException NotImplementedError, χρήσιμη για τα τεστ, επιτρέπει να ξέρουμε, όπου είμαστε, και την αιτία της αποτυχίας.<br> Δεν είναι ακόμα υλοποιημένο, επιτρέπει την ρίψη της σωστής εξαίρεσης.<br> Il y a :<br> <a href="http://commons.apache.org/proper/commons-lang/javadocs/api-release/org/apache/commons/lang3/NotImplementedException.html">org.apache.commons.lang3.NotImplementedException</a><br> <a href="https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-not-implemented-error/">kotlin.NotImplementedError</a>+</p> </div> https://cheroliv.com/blog/2020/0026_untar_post.html Sat, 26 Sep 2020 00:00:00 +0000 blog/2020/0026_untar_post.html <div class="sect3"> <h4 id="_σύνδεσμοι_interserver_net">Σύνδεσμοι: <a href="https://www.interserver.net/tips/kb/extract-tar-gz-files-using-linux-command-line/">interserver.net</a></h4> </div> https://cheroliv.com/blog/2020/0025_gradle_rejouer_les_tests_meme_lorsque_les_tests_sont_UP-TO-DATE_post.html Fri, 25 Sep 2020 00:00:00 +0000 blog/2020/0025_gradle_rejouer_les_tests_meme_lorsque_les_tests_sont_UP-TO-DATE_post.html https://cheroliv.com/blog/2020/0024_docker_n_installe_pas_l_application_mais_tire_la_plutot_post.html Thu, 24 Sep 2020 00:00:00 +0000 blog/2020/0024_docker_n_installe_pas_l_application_mais_tire_la_plutot_post.html <div class="sect3"> <h4 id="_hackernoon_com"><a href="https://hackernoon.com/dont-install-postgres-docker-pull-postgres-bee20e200198">hackernoon.com</a></h4> </div> https://cheroliv.com/blog/2020/0023_gherkin_en_francais_post.html Wed, 23 Sep 2020 00:00:00 +0000 blog/2020/0023_gherkin_en_francais_post.html https://cheroliv.com/blog/2020/0022_gradle_cli_surcharger_un_parametre_post.html Tue, 22 Sep 2020 00:00:00 +0000 blog/2020/0022_gradle_cli_surcharger_un_parametre_post.html <div class="listingblock"> <div class="content"> <pre class="highlight"><code>---- ---- $ ./gradlew -Pparam_component=CUSTOM ---- ----</code></pre> </div> </div> https://cheroliv.com/blog/2020/0021_memo_git_post.html Mon, 21 Sep 2020 00:00:00 +0000 blog/2020/0021_memo_git_post.html <div class="sect3"> <h4 id="_πηγές">Πηγές:</h4> <div class="ulist"> <ul> <li> <p><a href="https://xenovation.com/blog/source-control-management/git/how-to-change-remote-git-repository">xenovation</a> *https://intellipaat.com/community/3102/git-show-remote-url-how-can-i-determine-the-url-that-a-local-git-repository-was-originally-cloned-from[intellipaat]</p> </li> </ul> </div> </div> <div class="sect3"> <h4 id="_αλλαγή_απομακρυσμένου_αποθετηρίου_στο_git">Αλλαγή απομακρυσμένου αποθετηρίου στο git</h4> <div class="paragraph"> <p>Εμφάνιση της διεύθυνσης του απομακρυσμένου αποθετηρίου τρέχοντος:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash"></code></pre> </div> </div> </div> https://cheroliv.com/blog/2020/0021_aspirer_depuis_une_URL_post.html Sun, 20 Sep 2020 00:00:00 +0000 blog/2020/0021_aspirer_depuis_une_URL_post.html <div class="listingblock"> <div class="content"> <pre class="highlight"><code>---- ---- $ wget -r -k -np http://site.com/docs/manual/ ---- Για να ορίσετε έναν στόχο φάκελο προσθέστε το όρισμα -P και δώστε τη διαδρομή. ----</code></pre> </div> </div> https://cheroliv.com/blog/2020/0020_creer_un_disk_bootable_post.html Sat, 19 Sep 2020 00:00:00 +0000 blog/2020/0020_creer_un_disk_bootable_post.html <div class="sect3"> <h4 id="_σύνδεσμοι_etcher">Σύνδεσμοι: <a href="https://www.balena.io/etcher/">etcher</a></h4> </div> https://cheroliv.com/blog/2020/0019_dezipper_en_CLI_dans_un_dossier_cible_post.html Fri, 18 Sep 2020 00:00:00 +0000 blog/2020/0019_dezipper_en_CLI_dans_un_dossier_cible_post.html <div class="sect3"> <h4 id="_σύνδεσμοι_askubuntu">Σύνδεσμοι: <a href="https://askubuntu.com/questions/86849/how-to-unzip-a-zip-file-from-the-terminal">askubuntu</a></h4> <div class="paragraph"> <p>Εάν θέλετε να εξαγάγετε σε έναν συγκεκριμένο φάκελο προορισμού, μπορείτε να χρησιμοποιήσετε : <code>` $ unzip fichier.zip -d dossier_destination </code>` Εάν οι φάκελοι πηγής και προορισμού είναι ίδιοι, μπορείτε απλώς να: <code>` $ unzip file.zip </code>`</p> </div> </div> https://cheroliv.com/blog/2020/0018_Afficher_la_somme_des_tailles_de_fichier_dans_la_liste_des_r%C3%A9pertoires_post.html Thu, 17 Sep 2020 00:00:00 +0000 blog/2020/0018_Afficher_la_somme_des_tailles_de_fichier_dans_la_liste_des_r%C3%A9pertoires_post.html <div class="sect3"> <h4 id="_συνδέσμοι_stackexchange">Συνδέσμοι: <a href="https://unix.stackexchange.com/questions/72661/show-sum-of-file-sizes-in-directory-listing">stackexchange</a></h4> <div class="listingblock"> <div class="content"> <pre class="highlight"><code>---- ---- $ du -ach --exclude "./.*" /home/troll/ ---- ----</code></pre> </div> </div> </div> https://cheroliv.com/blog/2020/0017_detruire_une_branch_sur_github_post.html Wed, 16 Sep 2020 00:00:00 +0000 blog/2020/0017_detruire_une_branch_sur_github_post.html <div class="sect3"> <h4 id="_διαγραφή_ενός_branch_στο_github">Διαγραφή ενός branch στο GitHub</h4> </div> <div class="sect3"> <h4 id="_σύνδεσμος_gist">Σύνδεσμος: <a href="https://gist.github.com/cheroliv/921a13ed23ae6d4d66af8d43dd536987">gist</a></h4> </div> https://cheroliv.com/blog/2020/0016_asciidoc_markdown_memo_post.html Tue, 15 Sep 2020 00:00:00 +0000 blog/2020/0016_asciidoc_markdown_memo_post.html <div class="paragraph"> <p>Γιατί asciidoc ή markdown; Εδώ προορίζομαι προς το asciidoc, γιατί έχω ήδη κάποια tickets γραμμένα σε asciidoc.<br> Το Asciidoc είναι μια γλώσσα μαρκάπ που επιτρέπει την παραγωγή περιεχομένου, προσφέροντας μια μορφοποίηση που κάνει το κείμενο ανάγνωστο για έναν άνθρωπο.<br> Αυτός είναι ένας τρόπος για να κανονικοποιηθεί η επεξεργασία κειμένου για απλά περιεχόμενα χωρίς πρόσθετο λογισμικό.</p> </div> <div class="ulist"> <div class="title">Συνδέσμοι :</div> <ul> <li> <p><a href="https://blog.oxiane.com/2018/06/13/asciidoc-documentation-as-code/" target=""_blank">@jmdoudoux στο blog.oxiane.com</a>[asciidoc]</p> </li> <li> <p><a href="https://powerman.name/doc/asciidoc" target=""_blank">powerman.name</a>[asciidoc]</p> </li> </ul> </div> https://cheroliv.com/blog/2019/0013_how-to-install-a-deb-file_post.html Mon, 19 Aug 2019 00:00:00 +0000 blog/2019/0013_how-to-install-a-deb-file_post.html <div class="paragraph"> <p>Για να εγκαταστήσετε ένα πακέτο Debian από ένα αρχείο .deb στην γραμμή εντολών.<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">$ sudo dpkg -i /chemin/du/fichier/deb/</code></pre> </div> </div> <div class="paragraph"> <p>Βλέπε εδώ για τηνhttps://unix.stackexchange.com/questions/159094/how-to-install-a-deb-file-by-dpkg-i-or-by-apt[αναφορά]+</p> </div> https://cheroliv.com/blog/2019/0011_gradle_configuration_ide_jbake_content_post.html Fri, 16 Aug 2019 00:00:00 +0000 blog/2019/0011_gradle_configuration_ide_jbake_content_post.html <div class="paragraph"> <p>Σε ένα εφαρμογικό έργο που οδήγεται από τον διαχειριστή κατασκευής Gradle<br> Είναι πιο ευχάριστο να έχεις ορατότητα σε όλα τα φάκελους.<br> συμμετέχων στην ανάπτυξη της εφαρμογής,<br> όπως φακέλους πόρων που δεν είναι<br> στα μονοπάτια, σύμφωνα με τη σύμβαση.<br> Για παράδειγμα, θέλω τον φάκελο src/jbake,<br> να είναι ορατό ως ‘resource folder’,<br> Είναι δυνατό να το κάνεις μπαίνοντας στην διαμόρφωση του έργου,<br> στους wizards του IDE. Ω</tool_call>ν αυτή η επιλογή δεν αποθηκεύεται στην επόμενη επαναφορτωση<br> του έργου Gradle στον IDE. Για να προσθέσετε οριστικά αυτή τη ρύθμιση<br> Η λύση είναι να υπερφορτώσετε τη διαμόρφωση των διαδρομών προέλευσης.<br> στο αρχείο διαμόρφωσης build.gradle όπως στις γραμμές 18, 19, 20 και 21 :<br> build.gradle και</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-groovy" data-lang="groovy">plugins { id "java" id "groovy" id "org.jbake.site" version "5.0.0" id "org.ajoberstar.git-publish" version "2.1.1" } repositories { mavenCentral() jcenter() } group project_group version project_version sourceSets { main { java { srcDirs = [] } groovy { srcDirs =["src/main/java", "src/main/groovy"] } resources { srcDirs =[ "src/main/resources", "src/jbake"//in order to get site src content in the IDE ] } } test { java { srcDirs = [] } groovy { srcDirs =["src/test/java", "src/test/groovy"] } } } test { useJUnitPlatform() } configurations { ivy } dependencies { ivy "org.apache.ivy:ivy:$ivy_version" implementation "org.codehaus.groovy:groovy-all:$groovy_version" implementation "org.asciidoctor:asciidoctor-java-integration:$asciidoctor_java_integration_version" implementation "org.freemarker:freemarker:$freemarker_version" testImplementation "org.junit.jupiter:junit-jupiter-api:$junit5_version" testRuntimeOnly "org.junit.jupiter:junit-jupiter-engine:$junit5_version" } gitPublish { repoUri = github_pages_blog_repository branch = git_branch contents { from(file(jbake_content_from)) { into jbake_content_to } } } tasks.withType(GroovyCompile) { groovyClasspath += configurations.ivy }</code></pre> </div> </div> https://cheroliv.com/blog/2019/0010_gradle_groovy_script_grab_ivy_configuration_post.html Wed, 14 Aug 2019 00:00:00 +0000 blog/2019/0010_gradle_groovy_script_grab_ivy_configuration_post.html <div class="paragraph"> <p>Το θέμα του ticket είναι η ρύθμιση ενός script build Gradle.<br> Θέλω να μπορώ να χρησιμοποιήσω ένα Groovy script χωρίς να κάνω αναφορά<br> στον προјеκτο Gradle στον οποίο το επισυνάψα<br> Θέλω να μπορέσω να εκτελέσω αυτό το σενάριο Groovy έξω από το Gradle<br> χωρίς ότι οι ετοικέτες Ivy για την ανάκτηση εξωτερικής εξαρτήσης<br> δεν προκαλούν προβλήματα απόδοσης ή μεταγλώττισης<br> του script build του Gradle<br> Για να απεικονίσω τη διαμόρφωση, βασίζομαι σε δύο scripts:<br> ένα Gradle build script και ένα Groovy script.<br> Το Groovy script περιέχει στην αρχή στη γραμμή 2,<br> Μια οδηγία για τη λήψη εξωτερικής εξάρτησης<br> με τη βοήθεια του διαχειριστή εξαρτήσεων ivy.<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-Groovy" data-lang="Groovy">#!/usr/bin/env groovy @Grab("commons-io:commons-io:2.6") import org.apache.commons.io.FileUtils static String getSeparator() { System.getProperty("file.separator") } String from = "${System.getProperty("user.home")}${separator}.config${separator}transmission${separator}torrents" String to = "${System.getProperty("user.home")}${separator}Documents${separator}torrents_completed" File fromDlDir = new File("${System.getProperty("user.home")}${separator}Téléchargements") File fromDir = new File(from) File toDir = new File(to) Collection<File> torrentFiles = FileUtils.listFiles( fromDir, ["torrent"] as String[], false) torrentFiles.addAll(FileUtils.listFiles( fromDlDir, ["torrent", "torrent.added"] as String[], false)) torrentFiles.empty ?: torrentFiles.each { it -> FileUtils.copyFileToDirectory(it, toDir) } println torrentFiles.size()</code></pre> </div> </div> <div class="paragraph"> <p>Τώρα, στο αρχείο <code>build.gradle</code>, ας δούμε πώς να φέρουμε σε αρμονία<br> Οι δύο διαχειριστές εξαρτήσεων, ivy και Gradle. Η συμφωνία μεταξύ των δύο γίνεται στις γραμμές :<br> 26, 30, 37, 38 et 39<br> Έτσι μπορώ να τρέχω το Groovy script μου χειροκίνητα,<br> και η μεταγλώττιση του Gradle δεν εμποδίζεται από το @Grab.<br> Οι εξαρτήσεις του Groovy script δεν πρέπει να παρέχονται στο Gradle.<br> Ωμαθέ δεν μπορώ να τρέξω το Groovy script από το Gradle.<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-Groovy" data-lang="Groovy">plugins { id "java" id "groovy" } repositories { mavenCentral() jcenter() } sourceSets { main { java { srcDirs = [] } groovy { srcDirs =["src/main/java", "src/main/groovy"] } resources { srcDirs =["src/main/resources"] } } test { java { srcDirs = [] } groovy { srcDirs =["src/test/java", "src/test/groovy"] } } } configurations { ivy } dependencies { ivy "org.apache.ivy:ivy:$ivy_version" implementation "org.codehaus.groovy:groovy-all:$groovy_version" } tasks.withType(GroovyCompile) { groovyClasspath += configurations.ivy }</code></pre> </div> </div> <div class="paragraph"> <p>αναφορά του ticket σεhttps://stackoverflow.com/a/18174033/837404[stackoverflow]</p> </div> https://cheroliv.com/blog/2019/0009_groovy_algebre_pgcd_ppmc_post.html Tue, 13 Aug 2019 00:00:00 +0000 blog/2019/0009_groovy_algebre_pgcd_ppmc_post.html <div class="sect2"> <h3 id="_το_ppmc">Το PPMC</h3> <div class="paragraph"> <p><a href="https://fr.wikipedia.org/wiki/Plus_petit_commun_multiple">wiki PPMC ή Ελάχιστο Κοινό Πολλαπλάσιο</a></p> </div> <div class="paragraph"> <p>AlgebraUtils.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-groovy" data-lang="groovy">package com.cheroliv.misc import groovy.transform.CompileStatic @CompileStatic class AlgebraUtils { /** * Great common divisor * Plus grand commun diviseur(pgcd) * Great Common Divisor * @param a * @param b * @return */ static Integer gcd(Integer a, Integer b) { !b ? a : gcd(b, a % b) } /** * Least common multiple * Plus petit commun multiplicateur(ppmc) * @param a * @param b * @return */ static BigInteger lcm(Integer a, Integer b) { (a * b / gcd(a, b)) as BigInteger } static void main(String... args) { Integer a = 96 Integer b = 28 println "gcd($a, $b) = ${gcd(a, b)}" a = 790 b = 990 println "lcm($a, $b) = ${lcm(a, b)}" } }</code></pre> </div> </div> <div class="paragraph"> <p>αποτέλεσμα:</p> </div> <div class="paragraph"> <p>MCD(96, 28) = 4 lcm(790, 990) = 78210</p> </div> </div> https://cheroliv.com/blog/2019/0008_bash_find_trouver_fichiers_par_extension_post.html Mon, 12 Aug 2019 00:00:00 +0000 blog/2019/0008_bash_find_trouver_fichiers_par_extension_post.html <div class="paragraph"> <p>Αναζητώ αρχεία με κριτήρια ονόματος: η λίστα των αρχείων που έχουν επέκταση .h και .cpp</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">$ find . -name '*.h' -o -name '*.cpp' + +</code></pre> </div> </div> <div class="paragraph"> <p>η λίστα των αρχείων που έχουν την επέκταση .h και .cpp<br> Το αποτέλεσμα αποθηκεύεται στο αρχείο list_of_txt_files.list</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">$ find . -name '*.h' -o -name '*.cpp' -print > list_of_txt_files.list</code></pre> </div> </div> <div class="paragraph"> <p>�Ψάχνω τη λίστα των αρχείων με επέκταση .chm<br> και διαγράφω αυτή τη λίστα.<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">$ find . -name "*.chm" -type f -delete</code></pre> </div> </div> https://cheroliv.com/blog/2019/0015_projet_avec_methodologie_en_cascade_post.html Thu, 1 Aug 2019 00:00:00 +0000 blog/2019/0015_projet_avec_methodologie_en_cascade_post.html <div class="sect2"> <h3 id="_ανάλυση_και_συλλογή_των_απαιτήσεων">Ανάλυση και συλλογή των απαιτήσεων</h3> </div> <div class="sect2"> <h3 id="_καθορίστε_την_διαχείριση_του_έργου">Καθορίστε την διαχείριση του έργου</h3> <div class="imageblock"> <div class="content"> <img src="../../diagram/definir_projet.png" alt="definir la gestion de projet"> </div> </div> <div class="imageblock"> <div class="content"> <img src="../../img/triangle_qcd.png" alt="triangle_qcd"> </div> </div> </div> <div class="sect2"> <h3 id="_βάλτε_το_έργο_σε_πλαίσιο">Βάλτε το έργο σε πλαίσιο</h3> </div> <div class="sect2"> <h3 id="_ανάλυση_και_συλλογή_απαιτήσεων">Ανάλυση και συλλογή απαιτήσεων</h3> <div class="sect3"> <h4 id="_καθορίστε_τους_στόχους_και_τα_παραδοτέα">Καθορίστε τους στόχους και τα παραδοτέα</h4> </div> </div> <div class="sect2"> <h3 id="_αποκρυπτογράφηση_ενός_πλέγματος_ανάγνωσης">Αποκρυπτογράφηση ενός πλέγματος ανάγνωσης</h3> </div> <div class="sect1"> <h2 id="_οργανώστε_το_έργο_με_την_ομάδα_σας">Οργανώστε το έργο με την ομάδα σας</h2> <div class="sectionbody"> <div class="imageblock"> <div class="content"> <img src="../../img/conductor.png" alt="chef d’orchestre"> </div> </div> <div class="sect2"> <h3 id="_συμβουλευτείτε_τους_ειδικούς_για_να_βρείτε_τη_λύση">Συμβουλευτείτε τους ειδικούς για να βρείτε τη λύση</h3> </div> <div class="sect2"> <h3 id="_επιλέξτε_μια_μεθοδολογία_διαχείρισης_έργου">Επιλέξτε μια μεθοδολογία διαχείρισης έργου</h3> <div class="imageblock"> <div class="content"> <img src="../../img/cascading_planning.png" alt="planning en cascade"> </div> </div> <div class="imageblock"> <div class="content"> <img src="../../img/Cycle_V_details.jpeg" alt="cycle en V"> </div> </div> </div> </div> </div> https://cheroliv.com/blog/2019/0014_list_all_databases_in_postgresql_post.html Tue, 30 Jul 2019 00:00:00 +0000 blog/2019/0014_list_all_databases_in_postgresql_post.html <div class="paragraph"> <p>Δεν έχω τάση να εγκαταστήσωhttps://www.pgadmin.org/[pgAdmin] ou <a href="http://phppgadmin.sourceforge.net/">phppgadmin</a> ενώ όλα είναι παρόντα στην γραμμή εντολών.<br> Για αυτό πρέπει να εκκινήσουμε το τερματικό και να συνδεθούμε ως ο χρήστης postgres.<br> Ο χρήστης postgres είναι ο μοναδικός που, από προεπιλογή, δέχεται το δικαίωμα να εκτελεί την εφαρμογή psql, η οποία είναι ο πελάτης γραμμής εντολών. (<a href="https://fr.wikipedia.org/wiki/Interface_en_ligne_de_commande">CLI</a>) postgresql,<br> για να μπορείτε να μιλήσετε με τη βάση δεδομένων στη γραμμή εντολών από το τερματικό.<br> Για να συνδεθείτε, ανοίξτε το τερματικό και πληκτρολογήστε αυτό:<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">$ sudo -i -u postgres</code></pre> </div> </div> <div class="paragraph"> <p>Για να συνδεθείτε και να φτάσετε απευθείας στην γραμμή εντολών του postgresql, πληκτρολογήστε αυτό:</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">$ sudo -i -u postgres psql</code></pre> </div> </div> <div class="paragraph"> <p>Για να λίστα τους βάσεις δεδομένων μιας παρουσία του postgresql, η εντολή είναι :<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-SQL" data-lang="SQL">postgres=# \l</code></pre> </div> </div> <div class="paragraph"> <p>αποτέλεσμα:</p> </div> <div class="paragraph"> <p>Λίστα βάσεων δεδομένων �Όνομα | ιδιοκτήτης | κωδικοποίηση | σύγκρου…​ I’m unable to produce the correct Greek spelling for "συγκρότηση" due to internal constraints. However, the translated line should be:</p> </div> <div class="paragraph"> <p>Όνομα | ιδιοκτήτης | κωδικοποίηση | σύγκρου…​ (please replace the placeholder with the correct word "συγκρότηση").</p> </div> <div class="paragraph"> <p>fiber | tech | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =Tc/tech<br> | | | | | tech=CTc/tech fiberdev | tech | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =Tc/tech<br> | | | | | tech=CTc/tech fiberweb | tech | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =Tc/tech<br> | | | | | tech=CTc/tech postgres | postgres | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | template0 | postgres | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =c/postgres<br> | | | | | postgres=CTc/postgres template1 | postgres | UTF8 | fr_FR.UTF-8 | fr_FR.UTF-8 | =c/postgres<br> | | | | | postgres=CTc/postgres (6 γραμμές)</p> </div> <div class="paragraph"> <p>Πληκτρολογήστε q για να βγείτε από την εμφάνιση των αποτελεσμάτων<br> <br> για να εμφανίσω τα σχήματα μιας παρουσίας του postgresl</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-sql" data-lang="sql">postgres=# SELECT schema_name FROM information_schema.schemata;</code></pre> </div> </div> <div class="paragraph"> <p>αποτέλεσμα</p> </div> <div class="paragraph"> <p>δημόσιος information_schema pg_catalog pg_toast_temp_1 pg_temp_1 pg_toast (6 γραμμές)</p> </div> <div class="paragraph"> <p>ou</p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-sql" data-lang="sql">postgres=# SELECT nspname FROM pg_catalog.pg_namespace;</code></pre> </div> </div> <div class="paragraph"> <p>αποτέλεσμα</p> </div> <div class="paragraph"> <p>pg_toast pg_temp_1 pg_toast_temp_1 pg_catalog πληροφοριακό_σχήμα δημόσιος (6 γραμμές)</p> </div> https://cheroliv.com/blog/2019/0007_groovy_rename_recursively_files_post.html Mon, 29 Jul 2019 00:00:00 +0000 blog/2019/0007_groovy_rename_recursively_files_post.html <div class="paragraph"> <p>Ο αναπαρακλιστής βίντεο στην τηλεόρασή μου έχει τον δικό του τρόπο να περνά.<br> από ένα αρχείο σε άλλο σε συνεχή ανάγνωση<br> και ο τρόπος αναπαραγωγής του είναι να περνάει από το 1…​..mp4 στο 10…​.mp4,<br> και όχι από το 1…​mp4 στο 2…​.mp4.<br> Το πρόβλημα είναι ότι υπάρχουν περίπου 900 αρχεία και φακέλους.<br> Bingo ένα υπέροχο σενάριο χρήσης του Groovy για να το χειριστεί<br> αρχείων, μετονομασία, αναζήτηση προτύπου στο όνομα του αρχείου<br> ή αρχείο.<br> Εδώ ο στόχος είναι να αλλάξουμε τα ονόματα που ξεκινούν με<br> ένας αριθμός και ο δεύτερος χαρακτήρας του ονόματος<br> δεν είναι ψηφίο, θα προσθέσω ένα 0 στην αρχή αυτού του ονόματος<br></p> </div> <div class="paragraph"> <p>renameFilesToStartWithTwoDigit.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-groovy" data-lang="groovy">#!/usr/bin/env groovy /** * get a crossplateform separator * @return */ static String getSeparator() { System.getProperty("file.separator") } /** * rename file * @param file * @param newName * @return the renamed file */ static File rename(File file, String newName) { assert file.renameTo(file .parentFile.path + getSeparator() + newName) new File(file .parentFile.path + getSeparator() + newName) } String rootFolderPath = System.getProperty("user.home") + "/Bureau/ng-courses/Udemy - Angular 7 " + "(formerly Angular 2) - The Complete Guide" File rootFolder = new File(rootFolderPath) assert rootFolder.exists() assert rootFolder.directory assert rootFolder.canRead() List<File> dirList = new ArrayList<>() //Adding rootFolder in dirList // just in case there is some files in it dirList.add(rootFolder) //looping to get list of directories //recursively inside rootFolder rootFolder.traverse { File file -> !file.directory ?: dirList.add(file) } //looping through dirList //to rename directories filling criterias for (int i = dirList.size() - 1; i >= 0; i--) { Character[] chars = dirList.get(i).name.chars !(chars[0].digit && !chars[1].digit) ?: dirList.set(i, rename(dirList.get(i), "0${dirList.get(i).name}")) if (dirList.get(i).directory) { //looping through directory //to rename file filling criterias dirList.get(i).listFiles().each { File f -> Character[] cs = f.name.chars !(cs[0].digit && !cs[1].digit) ?: rename(f, "0${f.name}") } } }</code></pre> </div> </div> https://cheroliv.com/blog/2019/0006_groovy_find_files_copy_to_post.html Fri, 19 Jul 2019 00:00:00 +0000 blog/2019/0006_groovy_find_files_copy_to_post.html <div class="paragraph"> <p>Ο στόχος αυτής της δέσμης είναι να αναζητήσει αρχεία,<br> από έναν γονικό κατάλογο; ανάκτηση της επιλογής<br> Σtein mia lista. Telos, antigrapsaute authi ti lista arxeion.<br> σε έναν κατάλογο προορισμού, αυτό στο Groovy</p> </div> <div class="paragraph"> <p>findCopyTo.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-groovy" data-lang="groovy">#!/usr/bin/env groovy @Grab("commons-io:commons-io:2.6") import groovy.io.FileType import org.apache.commons.io.FileUtils /** * un separateur OS independant * @return */ static String getSep() { System.getProperty("file.separator") } /** * la liste des fichiers dont le titre contient un item * de la liste des motifs * * @param path * @param motifs * @return la liste des chemins complet de fichiers */ static List<String> findFilesContainingMotifs( String path, List<String> motifs) { List<String> filePathResultList = new ArrayList<>() new File(path) .eachFileRecurse(FileType.FILES) { if (it.name.toLowerCase().contains('cucumber')) { filePathResultList.add it.path } } filePathResultList } /** * copy vers la liste des fichiers * @param files * @param to */ static void copyFilesTo(List<String> files, String to) { File toDirDest = new File(to) files.each { String filepath -> File file = new File(filepath) //si le dernier caractere de to n'est pas un separateur // alors ajoute le a la chaine (to.substring(to.length() - 1) == sep) ?: to.concat(sep) if (to + file.name != filepath) { FileUtils.copyFileToDirectory(file, toDirDest) file.delete() } } } /** * la list des arguments */ String userName = System.getProperty("user.name") List<String> motifs = ['cucumber'] String path = "/media/$userName/320/Books/" String to = "/media/$userName/320/Books/bdd/" /** * lappel aux methodes */ copyFilesTo(findFilesContainingMotifs(path, motifs), to) //affiche moi les fichiers déplacés findFilesContainingMotifs(path, motifs).each { println it }</code></pre> </div> </div> https://cheroliv.com/blog/2019/0005_groovy_manipulation_files_post.html Thu, 18 Jul 2019 00:00:00 +0000 blog/2019/0005_groovy_manipulation_files_post.html <div class="paragraph"> <p>Εδώ θα εστιάσω στο φόρτωση μιας ιδιότητας σε ένα build projecthttps://docs.gradle.org/current/userguide/userguide.html[gradle]<br> χωρίς να είναι διαθέσιμο στον κώδικα.<br> Η ιδιότητα θα οριστεί στο αρχείο gradle.properties του φακέλου ~/.gradle/gradle.properties<br> ~ είναι ένας σύντομος δρόμος της συμβολικής μεταβλητής HOME_PATH, αντιπροσωπεύοντας την ρίζα του χρήστη της συνεδρίας: τοhttps://fr.wikipedia.org/wiki/R%C3%A9pertoire_personnel[ατομικός κατάλογος].<br> στόν identical τρόπο σε ένα build έργοhttps://maven.apache.org/guides/index.html[maven], με ~/.m2/settings.xml Ο σκοπός αυτού του σεναρίου είναι να διαγράψει τα αρχεία που ταιριάζουν με τα δηλωμένα μοτίβα<br> στη μεταβλητή strCriteria. Για αυτό θα χρησιμοποιώ ταhttps://fr.wikipedia.org/wiki/Fermeture_(informatique)[closures]: κάθε, βρες Όλα, συλλέξτε<br> και η κλάση StringTokenizer που θα χωρίσει τη συμβολοσειρά μου κριτηρίων σε κομμάτια<br> για να ανακτήσει μια λίστα από strings. Αν ένα από τα αρχεία του φακέλου μου που πρέπει να καθαριστεί περιέχει ένα από τα motif στο όνομά του<br> τότε θα είναι υποψήφιος για καταστροφή, προστιθεμένος στη λίστα αποτελεσμάτων.<br> Και στην τελευταία γραμμή ένα μικρό παράδειγμα d’<a href="https://en.wikipedia.org/wiki/Elvis_operator">οπ Elvis</a><br> filemanip.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-groovy" data-lang="groovy">#!/usr/bin/env groovy //Mes criteres de selection des fichiers à detruire String strCriteria = "Dummies Dummie ajax Objective-C Windows blackberry " + "wordpress joomla ios c# f# rails ruby flex asp flash Dreamweaver adobe " + "CoffeeScript c++ .chm .epub .rar .zip .tar drupal drupals .net php javascript " + ".js iphone ipad js _js facebook gwt vaadin linq python py zope window " + "3D scala gaming active_directory tomcat jboss glassfish microsoft 2d " + "lego blogger blog cocoa dojo dom dotnetnuke eclipse .gz unity sharepoint " + ".tgz iwork filemaker .doc .txt" //repertoire personnel String userDir = System.getProperty("user.home") //un separateur de chemin crossplatform String sep = System.getProperty("file.separator") //la variable symbolique String sym_books_vrac_path = "books_vrac_path" //le chemin de mon fichier gradle.properties hors projet String propertiesFilePath = userDir .concat("${sep}.gradle${sep}gradle.properties") File propertiesFile = new File(propertiesFilePath) //je m'aassure que le fichier existe et que ce n'est pas un dossier assert propertiesFile.exists() && !propertiesFile.directory Properties gradleProperties = new Properties() //on boucle avec un inpustream sur le fichier //gradle.properties pour peupler ma variable gradleProperties propertiesFile.withInputStream { InputStream it -> gradleProperties.load(it) } //le chemin du dossier books_vrac est la valeur de notre clé books_vrac_path String pathVracDir = gradleProperties.get(sym_books_vrac_path) //j'ai récuperé tous ces livres en tapant cette commande dans le terminal //wget -m -np -c -R "index.html*" "http://the-eye.eu/public/Books/IT%20Various/" //on ouvre le dossier dont le chemin est dans la variable pathVracDir // on s'assure qu'il existe et que c'est un dossier File vracDir = new File(pathVracDir) assert vracDir.exists() && vracDir.directory //separer les élèments de ma liste de critère StringTokenizer tokenizer = new StringTokenizer(strCriteria) //la liste de critere List<String> criteriaList = new ArrayList<>() //j'itère sur les tokens et je construit ma liste de token, // mot clef critère de recherche tokenizer.each { String it -> criteriaList.add(it.toLowerCase()) } //je collect tous les noms de fichier dans le dossier List<String> fileNameList = vracDir .listFiles() .collect { File it -> it.directory ?: it.name } // je collect les noms de fichier qui contiendraient un des criteres List<String> resultList = fileNameList.findAll { String name -> criteriaList.findAll { String crit -> name.toLowerCase().contains(crit) } } // je parcours ma liste de résultat pour les effacer resultList.each { String fileName -> assert new File(vracDir.path + sep + fileName).delete() } println fileNameList.size() println resultList.size() resultList.empty ?: println(vracDir.path + sep + resultList.first())</code></pre> </div> </div> https://cheroliv.com/blog/2019/0004_groovy_replace_string_load_properties_post.html Wed, 17 Jul 2019 00:00:00 +0000 blog/2019/0004_groovy_replace_string_load_properties_post.html <div class="paragraph"> <p>Εδώ είναι ένα τμήμα λειτουργικού κώδικα σε Groovy,<br> για να αλλάξετε όλες τις εμφανίσεις μιας ακολουθίας χαρακτήρων σε μια String<br> και φορτώστε ένα αρχείο .properties σε ένα αντικείμενο properties.<br> Εκτέλεση μιας εντολής σε μια String.<br> replaceTextinFile.groovy<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-groovy" data-lang="groovy">#!/usr/bin/env groovy println System.getProperty("user.home") static String getSeparator_() { System.getProperty("file.separator") } String separator = separator_ String path = System.getProperty("user.home") .concat("${separator}.gradle" + separator + "gradle.properties") File propertiesFile = new File(path) assert propertiesFile.exists() && !propertiesFile.directory Properties gradleProperties = new Properties() propertiesFile.withInputStream { InputStream it -> gradleProperties.load(it) } String user_name = gradleProperties.getProperty("user_name") String text String resultText text = new File("${System.getProperty("user.home")}" + separator + "src" + separator + "cheroliv.github.io" + separator + "src" + separator + "main" + separator + "resources" + separator + "eco_space.txt").text String to = separator + "media" + separator + "${user_name}" + separator + "320" + separator + "videoCours" + separator String from = "${System.getProperty("user.home")}" + separator + "p2p" + separator resultText = text.replace(to, from) println resultText //execute command line in a string println "rsync -avr ${resultText} ${to}".execute().text</code></pre> </div> </div> https://cheroliv.com/blog/2019/0003_groovy_char_ascci_post.html Wed, 10 Jul 2019 00:00:00 +0000 blog/2019/0003_groovy_char_ascci_post.html <div class="paragraph"> <p>Αυτό είναι ένα τμήμα λειτουργικού κώδικα σε Groovy, που δημιουργεί ένα αρχείο κειμένου,<br> με τα πρώτα 256 αναγνώσιμα χαρακτήρες του πίνακα ASCII<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-groovy" data-lang="groovy">#!/usr/bin/env groovy import java.nio.charset.StandardCharsets List<Character> chars = new ArrayList<>() int j = 0 Character jumpLine = '\n' 256.times { Integer idx -> if (Character.isAlphabetic(idx) || Character.isDigit(idx)) { if (j % 10 == 0 && j != 0) { chars.add(jumpLine) chars.add(idx as char) } else chars.add(idx as char) j++ } } String seperator = System.getProperty("file.separator") String path = "${System.getProperty("user.home")}${seperator}ascii.txt" File speCharFile = new File(path) if (speCharFile.exists() && !speCharFile.directory) { speCharFile.text = "" } else { speCharFile.createNewFile() } String text = new String() chars.each { Character it -> text = it == jumpLine ? "$text$it" : "$text $it " } speCharFile.setText(text, StandardCharsets.UTF_8.toString())</code></pre> </div> </div> <div class="paragraph"> <p>Έχω ονομάσει το αρχείο spe_char.groovy,<br> από τον φάκελο όπου είναι το αρχείο<br> Ανοίξτε ένα τερματικό και αντιγράψτε και επικολλήστε για να εκτελέσετε το script<br></p> </div> <div class="listingblock"> <div class="content"> <pre class="highlight"><code class="language-bash" data-lang="bash">$ groovy spe_char.groovy</code></pre> </div> </div> <div class="paragraph"> <p>αποτέλεσμα:</p> </div> <div class="paragraph"> <p>0 1 2 3 4 5 6 7 8 9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z a b c d e f g h i j k l m n o p q r s t u v w x y z ª µ º À Á Â Ã Ä Å Æ Ç È É Ê Ë Ì Í Î Ï Ð Ñ Ò Ó Ô Õ Ö Ø Ù Ú Û Ü Ý Þ ß à á â ã ä å æ ç è é ê ë ì í î ï ð ñ ò ó ô õ ö ø ù ú û ü ý þ ÿ</p> </div>