I recently started working on a project using Google’s Go programming language. As I had previously only completed the tour and a few minor tasks, this was my first experience using it for a larger project. Over the course of the project, I am essentially creating a web app (linked to a PostgreSQL database). I won’t go into the details of the actual project, but I will be sharing what I’ve learned so far.
J'ai commencé récemment à travailler sur un projet utilisant le langage de programmation Go de Google. Comme je ne l'avait regardé que brièvement et fait quelques tâches mineures auparavant, c'était ma première expérience de son utilisation sur un grand projet. Durant le projet, j'ai principalement créé une appli Web (liée à une base de données PostgreSQL). Je ne rentrerai pas dans les détails du véritable projet, mais je vais partager ce que j'ai déjà appris.
The Setup You can install Go using apt: sudo apt-get install golang-go If you want a more recent version of Go, there are more instructions on their GitHub page: https://github.com/golang/go/wiki/Ubuntu
Le paramétrage
Vous pouvez installer Go en utilisant apt :
sudo apt-get install golang-go
Si vous voulez une version plus récente de Go, il y a des instructions supplémentaires sur leur page GitHub : https://github.com/golang/go/wiki/Ubuntu
Example Code I’ve thrown together a small set of sample code into a Gist, which can be found here: https://gist.github.com/lswest/feed0fb8685b0d9bed03e864a78f7f1a If you decide to download the files, be sure to place the two html files in a subdirectory called “tmpl”, or update the path in the app.go file.
Exemple de code
J'ai regroupé un petit jeu d'exemples de code dans un Gist, que vous pouvez trouver ici : https://gist.github.com/lswest/feed0fb8685b0d9bed03e864a78f7f1a
Si vous décidez de télécharger les fichiers, veillez à placer les deux fichiers html dans un sous-répertoire appelé « tmpl » ou mettez à jour le chemin dans le fichier app.go.
The Basics There is a tour over at https://tour.golang.org/welcome/1 which is a very good spot to start. Naturally, you can also follow other tutorials or books. Once you’ve written your code, you can either compile it using go build or run it locally using go run. While Go can be used for other projects besides web-based apps, I won’t be going into detail for those uses.
Les bases
Il y a une présentation sur https://tour.golang.org/welcome/1 qui est un très bon point de départ. Naturellement, vous pouvez suivre aussi d'autres tutoriels ou livres.
Une fois que vous avez écrit votre code, vous pouvez, soit le compiler en utilisant « go build », soit le lancer localement en utilisant « go run ». Même si Go peut être utilisé pour des projets autres que les applis basées sur le Web, je ne vais pas rentrer dans le détail pour ces utilisations.
Templating The above example code is essentially a ‘hello world’ application, but covering a few aspects that I had trouble implementing correctly right off the bat. A few important notes: • On line 23 (https://gist.github.com/lswest/feed0fb8685b0d9bed03e864a78f7f1a#file-app-go-L23) the Funcs(funcMap) section adds in customized filters for use in the template (in this case, enabling the use of a ToLower filter). • On the same line, the ParseGlob line is necessary for working with partial templates, as, without it, the define_header line would not be parsed, leading to errors. If you’re not using a tmpl directory, ParseGlob(“*”) should work. Generally, this templating works pretty much like Jinja2, for anyone who has used that. Dynamic elements (such as those loaded from structs) are in curly braces, and all fields begin with a “.”, indicating that you’re expecting to find the variable in the current object. Filters are attached to variables via a pipe. Stringing multiple filters together should work (though I haven’t tested it).
Les modèles
le code exemple ci-dessus est principalement une application « hello world », mais recouvrant quelques aspects que j'ai eu du mal à implémenter correctement d'entrée de jeu. Quelques notes importantes : • À la ligne 23 (https://gist.github.com/lswest/feed0fb8685b0d9bed03e864a78f7f1a#file-app-go-L23), la section Funcs(funcMap) incorpore des filtres personnalisés à utiliser dans le modèle (dans ce cas, cela active le filtre ToLower). • Sur la même ligne, la ligne ParseGlob est nécessaire pour travailler avec des modèles partiels, car, sans cela, la ligne define_header ne sera pas analysée, conduisant à des erreurs. Si vous n'utilisez pas un répertoire tmpl, ParseGlob(“*”) devrait fonctionner.
De manière générale, cette préparation de modèles fonctionne de manière proche de Jinja2, pour tous ceux qui l'ont utilisé. Les éléments dynamiques (tels que ceux chargés à partir de « structs ») sont entre accolades, et tous les champs commencent par un « . », indiquant que vous vous attendez à trouver la variable dans l'objet courant. Les filtres sont attachés aux variables via un pipe. Mettre plusieurs filtres à la queue leu-leu devrait fonctionner (bien que je ne l'aie pas testé).
URLs If you execute ‘go run’ in the project directory, navigating to http://localhost:8081/ will yield a generic looking “Hello World” file. If, however, you head to http://localhost:8081/Lucas, the page will instead greet the name given in the URL. The example is very basic - if you want some “homework,” try to (for example) correctly capitalize the name, even if it’s lowercase in the URL. The code itself is relatively straightforward - on line 15, I set up the generic page, and then I check if the length of the URL Path (everything after the domain) is longer than the length of “/” (so, 1). If the length is longer, that means there is a parameter given (in this case, the name), and the ‘hello’ variable gets overwritten with the new title/content. If it’s shorter or equal to 1, then it should just be the fallback page, so nothing changes (as there is no ‘else’ statement). After the ‘if’ statement, the rest of the viewHandler function is dictated by the templates package. The funcMap contains a map (for anyone who uses Python, they can be thought of as dictionaries) of filter names and the functions they map to. This could be used for custom functions as well. Afterwards, the template files are loaded. The function ‘template.Must’ simply ensures that the program throws an error and a panic if no template files are found. And lastly, the ExecuteTemplate function asks for a ResponseWriter (“w”), the name of the template to load (based off the filename), and the object to load (“hello”).
Les URL
Si vous lancez « go run » dans le répertoire du projet, une navigation à http://localhost:8081/ restituera un fichier « hello world » d'aspect habituel. Si, cependant, vous regardez à http://localhost:8081/Lucas, au lieu de ça, la page vous accueillera avec le nom donné dans l'URL.
L'exemple est très basique - si vous voulez un peu de travail personnel, essayez (par exemple) de mettre correctement le nom en majuscules, même s'il est en minuscules dans l'URL.
Le code lui-même est relativement simple - à la ligne 15, je paramètre la page générique et, ensuite, je vérifie que la longueur du chemin du L'URL (tout ce qui est après le domaine) est plus grande que la longueur de « / » (soit 1). Si cette longueur est plus grande, cela signifie qu'un paramètre est transmis (dans ce cas, le nom) et la variable « hello » est écrasée par le nouveau titre/contenu. Si elle plus courte ou égale à 1, alors il s'agit juste de la page de secours, sans aucun changement (car il n'y a pas de déclaration « else »).
Après la déclaration » if », le reste de la fonction viewHandler est dicté par le paquet de modèles. funcMap contient un « map » ( pour toute personne qui utilise Python, ça ressemble aux dictionnaires) de noms de filtres et les fonctions vers lesquelles ils dirigent. Ils peuvent être aussi utilisés dans des fonctions personnalisées. Après cela, les fichiers de modèles sont chargés. La fonction « template.Must » assure simplement que le programme lance une erreur et une panique si aucun fichier de modèle n'est trouvé. Enfin, la fonction ExecuteTemplate réclame un ResponseWriter (« w »), le nom du modèle à charger (sur la base de son nom de fichier) et l'objet à charger (« hello »).
Structs Lines 9-12 create a struct called “Page” which contains two string fields - Title and Content. This is essentially creating a special data type. Structs can be initialized via Page{Title, Content}. Naturally, the more variables you include, the longer the initialization is.
Structs
Les lignes 9-12 créent un struct nommé « Page » qui contient deux champs de chaînes de caractères : Title (titre) et Content (contenu). Principalement, ça crée un type de donnée spécial. les « structs » peuvent être initialisées via Page{Title, Content}. Naturellement, plus il y a de variables incluses, plus l'initialisation est longue.
Debugging If you run into issues, you can import the “fmt” package, and use fmt.Printf to print formatted text to the terminal.
Débogage
Si, en fonctionnement, vous tombez sur des problèmes, vous pouvez importer le paquet « fmt » et utiliser « fmt.Printf » pour imprimer du texte formaté dans un terminal.
Conclusion This is a very basic example, but should still serve as a jumping in point for anyone interested in working with Go. If anyone runs into issues, or has suggestions how to complete any of the steps in a more “Go Fashion”, feel free to let me know at lswest34+fcm@gmail.com. Similarly, if you have any requests for article topics I should cover, you can let me know via email.
Conclusion
Ceci est un exemple très basique, mais il devrait servir de point d'entrée à quiconque voudrait travailler avec Go. Si quelqu'un tombe sur des problèmes, ou a des suggestions pour finaliser l'une des étapes dans une version plus « à la mode de Go », n'hésitez pas à me le faire savoir à lswest34+fcm@gmail.com. De même, si vous avez une quelconque demande pour un sujet d'article que je pourrais traiter, vous pouvez me le dire par mail.