brut 0.5.0 → 0.8.0

data/docs/assets/overview.md.iMnwLO4x.js

@@ -1 +0,0 @@
-import{_ as t,c as a,o as r,ag as s}from"./chunks/framework.1L-BeKqY.js";const o="/assets/OverviewMetro.DUS-5fUZ.png",g=JSON.parse('{"title":"Conceptual Overview","description":"","frontmatter":{},"headers":[],"relativePath":"overview.md","filePath":"overview.md"}'),i={name:"overview.md"};function n(l,e,c,d,h,u){return r(),a("div",null,e[0]||(e[0]=[s('<h1 id="conceptual-overview" tabindex="-1">Conceptual Overview <a class="header-anchor" href="#conceptual-overview" aria-label="Permalink to &quot;Conceptual Overview&quot;">​</a></h1><p>Brut is a way to build web apps that generate HTML, have JavaScript and CSS, and interact with a Database. It&#39;s built on Ruby standard libraries and community libraries like <a href="https://sequel.jeremyevans.net/" target="_blank" rel="noreferrer">Sequel</a> and <a href="https://phlex.fun" target="_blank" rel="noreferrer">Phlex</a>.</p><p>Brut&#39;s approach and design are built on three core values:</p><ul><li><strong>Leverage Standards</strong> - The web platform is great, and Brut wants you to use it.</li><li><strong>There&#39;s One Best Way To Do It</strong> - Flexibility leads to chaos.</li><li><strong>Simple over Easy</strong> - Verbose code that can be quickly understood beats impenetrable compact DSLs every day.</li></ul><p>Brut&#39;s abstractions tend to mirror concepts found in the domain of web sites. For example, a browser serves up a web page at a URL. In Brut, that&#39;s called a <em>page</em> and you&#39;d create a subclass of <a href="/api/Brut/FrontEnd/Page.html" target="_self" rel="noopener" data-no-router><code>Brut::FrontEnd::Page</code></a> to implement it.</p><p>Brut tries to avoid abstractions that simply translate existing standards into a more aestheticly pleasing form. You already need to know CSS, HTML, the Web Platform, and SQL, so there&#39;s little to gain by requiring you to learn a different way to use them.</p><h2 id="basic-elements" tabindex="-1">Basic Elements <a class="header-anchor" href="#basic-elements" aria-label="Permalink to &quot;Basic Elements&quot;">​</a></h2><p>Brut organizes its code and behavior around four basic concepts:</p><ul><li><strong>Client</strong> or <em>Client Side</em> is the web browser (or HTTP client). This is where CSS is applied to HTML and where JavaScript is executed. HTTP requests are initiated here.</li><li><strong>Server</strong> or <em>Server Side</em> is where any code not in the browser runs. In Brut, this includes HTML generation, SQL queries, and everything in between.</li><li><strong>Front End</strong> is the code that deals with producing your user interface or HTTP API. A lot of this code runs on the <em>server side</em>, however it exists to provide a user interface of some sort.</li><li><strong>Back End</strong> is the code that deals with everything else, such as accessing a database, executing business logic, or managing background jobs.</li></ul><p><img src="'+o+'" alt="Architectural Overview"></p><ul><li><strong>Visitor</strong> is someone visiting your web site or app.</li><li><strong>Browser</strong> is, well, a web browser</li><li><a href="/pages.html"><strong>Pages</strong></a> generate web pages, which is what happens when a browser&#39;s UI navigates to a URL.</li><li><a href="/forms.html"><strong>Forms</strong></a> are submitted by the browser to the server. In Brut, a form describes the contents of a <code>&lt;form&gt;</code> as well as provides access to the submitted data.</li><li><a href="/handlers.html"><strong>Handlers</strong></a> receive non-GET HTTP requests from the browser, notably form submissions.</li><li><a href="/components.html"><strong>Components</strong></a> generate HTML fragments and are used to generate the HTML of a page or for re-use across pages.</li><li><a href="/javascript.html"><strong>JavaScript</strong></a> and <a href="/assets.html"><strong>Assets</strong></a> (including <a href="/css.html">CSS</a>) are bundled on the server and sent to the client.</li><li><a href="/business-logic.html"><strong>Domain Logic</strong></a> as where your business and domain logic lives and can be implemented however you like.</li><li><a href="/database-access.html"><strong>DB Models</strong></a> are objects that provide access to your database.</li><li><strong>Relational Database</strong> is your database, where data is stored.</li></ul><p>Brut doesn&#39;t prevent the addition of more pieces of infrastructure or code. You can add a Redis cache, a Sidekiq job backend, or integrate with third party APIs.</p><h2 id="brut-is-not-mvc" tabindex="-1">Brut is Not MVC <a class="header-anchor" href="#brut-is-not-mvc" aria-label="Permalink to &quot;Brut is Not MVC&quot;">​</a></h2><p>Brut is <em>not</em> an MVC framework, nor does it use the concept of <em>resources</em> as an abstraction. Although HTTP does include this concept, we find it&#39;s not as useful for managing web apps as it may seem.</p><p>We&#39;ve found that teams often struggle with mapping what everyone else calls pages to resources and HTTP verbs. We also find that the consonance of features, resources, actions, and database tables never materializes. We&#39;re basically not going to debate what the meaning of the <code>DELETE</code> verb on the <code>widgets</code> resource is actually supposed to mean.</p><h2 id="brut-is-hippocratic-licensed" tabindex="-1">Brut is Hippocratic Licensed <a class="header-anchor" href="#brut-is-hippocratic-licensed" aria-label="Permalink to &quot;Brut is Hippocratic Licensed&quot;">​</a></h2><p>It&#39;s important to me that Brut is used to make the world a better place. Please take a note of <a href="https://firstdonoharm.dev/version/3/0/cl-eco-media-my-tal-xuar.txt" target="_blank" rel="noreferrer">its license</a></p>',17)]))}const m=t(i,[["render",n]]);export{g as __pageData,m as default};

data/docs/assets/overview.md.iMnwLO4x.lean.js

@@ -1 +0,0 @@
-import{_ as t,c as a,o as r,ag as s}from"./chunks/framework.1L-BeKqY.js";const o="/assets/OverviewMetro.DUS-5fUZ.png",g=JSON.parse('{"title":"Conceptual Overview","description":"","frontmatter":{},"headers":[],"relativePath":"overview.md","filePath":"overview.md"}'),i={name:"overview.md"};function n(l,e,c,d,h,u){return r(),a("div",null,e[0]||(e[0]=[s("",17)]))}const m=t(i,[["render",n]]);export{g as __pageData,m as default};

data/docs/assets/tutorial.md.BYXj4cOu.js

@@ -1 +0,0 @@
-import{_ as r,c as l,o,j as e,a as t}from"./chunks/framework.1L-BeKqY.js";const h=JSON.parse('{"title":"Tutorial","description":"","frontmatter":{},"headers":[],"relativePath":"tutorial.md","filePath":"tutorial.md"}'),n={name:"tutorial.md"};function i(s,a,u,c,d,p){return o(),l("div",null,a[0]||(a[0]=[e("h1",{id:"tutorial",tabindex:"-1"},[t("Tutorial "),e("a",{class:"header-anchor",href:"#tutorial","aria-label":'Permalink to "Tutorial"'},"​")],-1),e("p",null,"A real tutorial will appear here eventually.",-1),e("p",null,[t("In the mean time, "),e("a",{href:"https://github.com/thirdtank/adrs.cloud",target:"_blank",rel:"noreferrer"},"ADRs.cloud"),t(" is a full-fledge Brut app you can examine to see how things work. You can be running it locally in minutes, once you install Docker.")],-1)]))}const f=r(n,[["render",i]]);export{h as __pageData,f as default};

data/docs/assets/tutorial.md.BYXj4cOu.lean.js

@@ -1 +0,0 @@
-import{_ as r,c as l,o,j as e,a as t}from"./chunks/framework.1L-BeKqY.js";const h=JSON.parse('{"title":"Tutorial","description":"","frontmatter":{},"headers":[],"relativePath":"tutorial.md","filePath":"tutorial.md"}'),n={name:"tutorial.md"};function i(s,a,u,c,d,p){return o(),l("div",null,a[0]||(a[0]=[e("h1",{id:"tutorial",tabindex:"-1"},[t("Tutorial "),e("a",{class:"header-anchor",href:"#tutorial","aria-label":'Permalink to "Tutorial"'},"​")],-1),e("p",null,"A real tutorial will appear here eventually.",-1),e("p",null,[t("In the mean time, "),e("a",{href:"https://github.com/thirdtank/adrs.cloud",target:"_blank",rel:"noreferrer"},"ADRs.cloud"),t(" is a full-fledge Brut app you can examine to see how things work. You can be running it locally in minutes, once you install Docker.")],-1)]))}const f=r(n,[["render",i]]);export{h as __pageData,f as default};