AWSRES(1)

💖 AWSRES(1) 💖

ok so this is the manual page for awsres, straight outta the AWS User's Guide. pull up a chair bestie, we're embedding pictures into executables today 🎀

---

✨ NAME ✨

awsres — build resource files for Ada Web Server applications 🦋

---

✨ SYNOPSIS ✨

awsres [-h] [-r unit] [-q] file...

---

✨ DESCRIPTION ✨

okok so. The Ada Web Server is a library that lets you embed a whole web server inside your Ada application. it's giving main character energy honestly — not just HTTP but also SOAP, WSDL and a bunch of other facilities too. so yes, you can absolutely write full-fledged web applications with it. 💅

and awsres? she's the one that lets you embed resources, like pictures, directly into your final executable. so your executable is completely self-contained and does not need to read other files at run time. no external file drama, no missing asset at 3am, we love to see it. 🫶

here's how she works: awsres creates Ada source files that contain the data for your resources as arrays of bytes. you then compile those Ada source files into your executable. at run time, the AWS library automatically loads the resources from the executable whenever they're available. it just knows. ✨

so the package structure is very demure, very mindful: awsres creates one parent Ada package named, by default, res, and one child package for each of the files given on the command line. the package res registers each resource when your application starts. and to link res into your executable you simply add a with res; statement in one of your source files. that's it. that's the whole vibe. 🎀

---

🌸 EXAMPLE 🌸

$ ls
image.png
$ awsres image.png
AWSRes - Resource Creator v1.0

creating image.png...
 -> registered

$ ls
res.adb  res.ads  res-image_png.ads  image.png

look at those three new files. she ate. 👑

---

✨ OPTIONS ✨

• -h — display the help message. the "bestie what do i do" button 💖
• -r name — set the root unit name. the default is res. 🦋
• -q — quiet mode. for when you want her to work in silence 🤫

---

🔥 SEE ALSO 🔥

• wsdl2aws(1)
• The Ada Web Server User's Guide in package aws-doc.

---

💜 AUTHOR 💜

awsres was written by Dmitriy Anisimkov <anisimkov@yahoo.com> and Pascal Obry <p.obry@wanadoo.fr> as part of the Ada Web Server. iconic duo behavior fr fr 🫶

this manual page was written by Ludovic Brenta <ludovic.brenta@insalien.org> for Debian GNU/Linux. adopted by Pavel Zhukov <landgraf@fedoraproject.org> for Fedora Project. 💅

---

and that's the whole page bestie!! this one came from GNU Ada Tools, dated 29 JAN 2004, and she lives under the name AWSRES(1). go forth and embed your little pngs. no cap. 💖✨🎀