Summary

Latest Version	Unknown
License	MIT
CI Status	Failing
Downloads	0
Last Indexed	2026-07-21 05:24

Installation

nimble install jestercookiemsgs

choosenim install jestercookiemsgs

git clone https://github.com/JohnAD/jestercookiemsgs

OS Compatibility

Platform	Linux	macOS	Windows	FreeBSD	OpenBSD	NetBSD	Android	iOS	WASM	Embedded
jestercookiemsgs	✓	✓	✓	-	-	-	-	-	-	-

Source

Repository	https://github.com/JohnAD/jestercookiemsgs
Homepage	https://github.com/JohnAD/jestercookiemsgs
Registry Source	nimble_official

README

Introduction to jestercookiemsgs

ver 1.0.1

.. image:: https://raw.githubusercontent.com/yglukhov/nimble-tag/master/nimble.png :height: 34 :width: 131 :alt: nimble :target: https://nimble.directory/pkg/jestercookiemsgs

.. image:: https://repo.support/img/rst-banner.png :height: 34 :width: 131 :alt: repo.support :target: https://repo.support/gh/JohnAD/jestercookiemsgs

This is a plugin for the nim web framework Jester <https://github.com/dom96/jester>__. It enables easy message passing between web pages using browser cookies.

HOW TO USE

Include the plugin cookieMsgs() at the top of your main routes or primary router. This will enable the plugin for the whole web site.
Use the object variable created to access the say and related procedures.
Add the display of your messages to each web page should such a message be ready. (Again, using the object variable created.)

EXAMPLE

.. code:: nim

import htmlgen
import strutils
import jester
import jestercookiemsgs


const indexTemplate = """<html>
  <title>My Website</title>
  <body>
    <div class="header">
      <ul>
        $1
      </ul>
    </div>
    <p>
      $2
    </p>
    <form action="" method="POST">
      <input type="text" name="name" value="" />
      <button type="submit">Send Name</button>
    </form>
  </body>
</html>
"""

const helloTemplate = """<html>
  <title>My Website</title>
  <body>
    <div class="header">
      <ul>
        $1
      </ul>
    </div>
    <p>
      $2
    </p>
  </body>
</html>
"""

proc indexPage(cm: CookieObj): string =
  let messages = cm.htmlListItems()
  let main = "This is my Website"
  result = indexTemplate % [messages, main]


proc helloPage(name: string, cm: CookieObj): string =
  let messages = cm.htmlListItems()
  let main = "Welcome, $1" % [name]
  result = helloTemplate % [messages, main]


routes:
  plugin cm <- cookieMsgs()
  get "/":
    resp indexPage(cm)
  post "/":
    if request.params["name"] == "Joe":
      cm.say("success", "I like that name.")
      redirect "/hello/$1" % [request.params["name"]]
    else:
      cm.say("danger", "That isn't a name I like.")
      redirect "/"
  get "/hello/@name":
    resp helloPage(@"name", cm)

HOW IT WORKS

Whenever request is received by the Jester web server, the plugin first checks for a cookie labeled "messages". If it finds that cookie, it decodes the messages from the previous page and stores them in created variable as part of the fromRequest array,.

Then the route runs as normally. If any new say procedures are run, those new messages are stored in the fromRoute array.

When the route ends, if it terminates with:

resp, then it is assumed that your template displayed the routes and the plugin empties the contents of the "messages" cookie.
redirect, then all messages found in both fromRequest and fromRoute are encoded by the plugin into a new "messages" cookie for the next page to find.

jestercookiemsgs