From 7b4afc91dd74f21418506e77b3bb199d361efe7a Mon Sep 17 00:00:00 2001 From: Runxi Yu Date: Wed, 19 Mar 2025 12:45:49 +0800 Subject: [PATCH] Remove the example --- example/.gitignore | 2 -- example/LICENSE | 122 ----------------------------------------------------- example/Makefile | 5 ----- example/README.md | 13 ------------- example/main.ha | 71 ----------------------------------------------------- example/templates/_head_common.htmpl | 3 --- example/templates/index.htmpl | 14 -------------- diff --git a/example/.gitignore b/example/.gitignore deleted file mode 100644 index d5fd897be11a5d805034f54af7eed2e16ecb7a52..0000000000000000000000000000000000000000 --- a/example/.gitignore +++ /dev/null @@ -1,2 +0,0 @@ -/example -/templates.ha diff --git a/example/LICENSE b/example/LICENSE deleted file mode 100644 index 6ca207ef004cb69d03041e7e5c288a2be4968045..0000000000000000000000000000000000000000 --- a/example/LICENSE +++ /dev/null @@ -1,122 +0,0 @@ -Creative Commons Legal Code - -CC0 1.0 Universal - - CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE - LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN - ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS - INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES - REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS - PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM - THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED - HEREUNDER. - -Statement of Purpose - -The laws of most jurisdictions throughout the world automatically confer -exclusive Copyright and Related Rights (defined below) upon the creator -and subsequent owner(s) (each and all, an "owner") of an original work of -authorship and/or a database (each, a "Work"). - -Certain owners wish to permanently relinquish those rights to a Work for -the purpose of contributing to a commons of creative, cultural and -scientific works ("Commons") that the public can reliably and without fear -of later claims of infringement build upon, modify, incorporate in other -works, reuse and redistribute as freely as possible in any form whatsoever -and for any purposes, including without limitation commercial purposes. -These owners may contribute to the Commons to promote the ideal of a free -culture and the further production of creative, cultural and scientific -works, or to gain reputation or greater distribution for their Work in -part through the use and efforts of others. - -For these and/or other purposes and motivations, and without any -expectation of additional consideration or compensation, the person -associating CC0 with a Work (the "Affirmer"), to the extent that he or she -is an owner of Copyright and Related Rights in the Work, voluntarily -elects to apply CC0 to the Work and publicly distribute the Work under its -terms, with knowledge of his or her Copyright and Related Rights in the -Work and the meaning and intended legal effect of CC0 on those rights. - -1. Copyright and Related Rights. A Work made available under CC0 may be -protected by copyright and related or neighboring rights ("Copyright and -Related Rights"). Copyright and Related Rights include, but are not -limited to, the following: - - i. the right to reproduce, adapt, distribute, perform, display, - communicate, and translate a Work; - ii. moral rights retained by the original author(s) and/or performer(s); -iii. publicity and privacy rights pertaining to a person's image or - likeness depicted in a Work; - iv. rights protecting against unfair competition in regards to a Work, - subject to the limitations in paragraph 4(a), below; - v. rights protecting the extraction, dissemination, use and reuse of data - in a Work; - vi. database rights (such as those arising under Directive 96/9/EC of the - European Parliament and of the Council of 11 March 1996 on the legal - protection of databases, and under any national implementation - thereof, including any amended or successor version of such - directive); and -vii. other similar, equivalent or corresponding rights throughout the - world based on applicable law or treaty, and any national - implementations thereof. - -2. Waiver. To the greatest extent permitted by, but not in contravention -of, applicable law, Affirmer hereby overtly, fully, permanently, -irrevocably and unconditionally waives, abandons, and surrenders all of -Affirmer's Copyright and Related Rights and associated claims and causes -of action, whether now known or unknown (including existing as well as -future claims and causes of action), in the Work (i) in all territories -worldwide, (ii) for the maximum duration provided by applicable law or -treaty (including future time extensions), (iii) in any current or future -medium and for any number of copies, and (iv) for any purpose whatsoever, -including without limitation commercial, advertising or promotional -purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each -member of the public at large and to the detriment of Affirmer's heirs and -successors, fully intending that such Waiver shall not be subject to -revocation, rescission, cancellation, termination, or any other legal or -equitable action to disrupt the quiet enjoyment of the Work by the public -as contemplated by Affirmer's express Statement of Purpose. - -3. Public License Fallback. Should any part of the Waiver for any reason -be judged legally invalid or ineffective under applicable law, then the -Waiver shall be preserved to the maximum extent permitted taking into -account Affirmer's express Statement of Purpose. In addition, to the -extent the Waiver is so judged Affirmer hereby grants to each affected -person a royalty-free, non transferable, non sublicensable, non exclusive, -irrevocable and unconditional license to exercise Affirmer's Copyright and -Related Rights in the Work (i) in all territories worldwide, (ii) for the -maximum duration provided by applicable law or treaty (including future -time extensions), (iii) in any current or future medium and for any number -of copies, and (iv) for any purpose whatsoever, including without -limitation commercial, advertising or promotional purposes (the -"License"). The License shall be deemed effective as of the date CC0 was -applied by Affirmer to the Work. Should any part of the License for any -reason be judged legally invalid or ineffective under applicable law, such -partial invalidity or ineffectiveness shall not invalidate the remainder -of the License, and in such case Affirmer hereby affirms that he or she -will not (i) exercise any of his or her remaining Copyright and Related -Rights in the Work or (ii) assert any associated claims and causes of -action with respect to the Work, in either case contrary to Affirmer's -express Statement of Purpose. - -4. Limitations and Disclaimers. - - a. No trademark or patent rights held by Affirmer are waived, abandoned, - surrendered, licensed or otherwise affected by this document. - b. Affirmer offers the Work as-is and makes no representations or - warranties of any kind concerning the Work, express, implied, - statutory or otherwise, including without limitation warranties of - title, merchantability, fitness for a particular purpose, non - infringement, or the absence of latent or other defects, accuracy, or - the present or absence of errors, whether or not discoverable, all to - the greatest extent permissible under applicable law. - c. Affirmer disclaims responsibility for clearing rights of other persons - that may apply to the Work or any use thereof, including without - limitation any person's Copyright and Related Rights in the Work. - Further, Affirmer disclaims responsibility for obtaining any necessary - consents, permissions or other rights required for any use of the - Work. - d. Affirmer understands and acknowledges that Creative Commons is not a - party to this document and has no duty or obligation with respect to - this CC0 or use of the Work. - diff --git a/example/Makefile b/example/Makefile deleted file mode 100644 index 0c4783b9e5a560aef257467674ef5194992cc77f..0000000000000000000000000000000000000000 --- a/example/Makefile +++ /dev/null @@ -1,5 +0,0 @@ -example: main.ha templates.ha - hare build -o $@ . - -templates.ha: templates/*.htmpl - htmplgen -o $@ $^ diff --git a/example/README.md b/example/README.md deleted file mode 100644 index a72ab11002918492ca3ddc7ccbad4811690c0cb1..0000000000000000000000000000000000000000 --- a/example/README.md +++ /dev/null @@ -1,13 +0,0 @@ -# Example for using the templating engine - -## Dependencies - -- A relatively new version of Hare (March 2025) -- [hare-http](https://git.sr.ht/~sircmpwn/hare-http) - (you'll need - [a patch](https://lists.sr.ht/~sircmpwn/hare-users/%3C20250313030745.663128-1-me@runxiyu.org%3E/raw) - to make it work with modern Hare) - -## Licensing - -This example is released into the public domain. diff --git a/example/main.ha b/example/main.ha deleted file mode 100644 index bfaf7b4825b06dd7d8e6ada539585e44d59db248..0000000000000000000000000000000000000000 --- a/example/main.ha +++ /dev/null @@ -1,71 +0,0 @@ -// SPDX-License-Identifier: CC0-1.0 -// By Runxi Yu -// Adapted from template by Willow Barraco - -use getopt; -use htmpl; -use log; -use net; -use net::ip; -use net::http; -use net::dial; -use os; -use memio; -use io; -use fmt; -use bufio; -use strings; - -const usage: [_]getopt::help = [ - "HTTP server", - ('a', "address", "listened address") -]; - -export fn main() void = { - const cmd = getopt::parse(os::args, usage...); - defer getopt::finish(&cmd); - - let port: u16 = 8080; - let ip_addr: ip::addr4 = [127, 0, 0, 1]; - - for (let opt .. cmd.opts) { - switch (opt.0) { - case 'a' => - match (dial::splitaddr(opt.1, "")) { - case let value: (str, u16) => - ip_addr = ip::parsev4(value.0)!; - port = value.1; - case dial::invalid_address => - abort("invalid address"); - }; - case => abort(); // unreachable - }; - }; - - const server = match (http::listen(ip_addr, port)) { - case let this: *http::server => - yield this; - case net::error => abort("failure while listening"); - }; - defer http::server_finish(server); - - for (true) { - const serv_req = match (http::serve(server)) { - case let this: *http::server_request => - yield this; - case net::error => abort("failure while serving"); - }; - defer http::serve_finish(serv_req); - - match (handlereq(serv_req.socket, &serv_req.request)) { - case void => yield; - case io::error => log::println("error while handling request"); - }; - }; -}; - -export fn handlereq(conn: io::handle, request: *http::request) (void | io::error | nomem) = { - htmpl::write(conn, "HTTP/1.1 200 OK\r\n")?; - htmpl::write(conn, "Content-Type: text/html\r\n\r\n")?; - tp_index(conn)?; -}; diff --git a/example/templates/_head_common.htmpl b/example/templates/_head_common.htmpl deleted file mode 100644 index 6fcfea1ae8a39eb5c04cd26e8b4ded3b0236cf19..0000000000000000000000000000000000000000 --- a/example/templates/_head_common.htmpl +++ /dev/null @@ -1,3 +0,0 @@ -{{ define _tp_head_common(handle: io::handle, title: str = "Untitled") (void | io::error | nomem) }} -{{ title }} -{{ end }} diff --git a/example/templates/index.htmpl b/example/templates/index.htmpl deleted file mode 100644 index 092b951156f1bd0b84ddd69c1a29000a697313f8..0000000000000000000000000000000000000000 --- a/example/templates/index.htmpl +++ /dev/null @@ -1,14 +0,0 @@ -{{ define tp_index(handle: io::handle) (void | io::error | nomem) }} -{! - let title: str = "Index"; -!} - - - - {{ render _tp_head_common(handle, title) }} - - -

{{ title }}

- - -{{ end }} -- 2.48.1