acrylic 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: ffa3dcf17f46e9e75b17e95c9ca52b0e82dd7bed3ce4f637cbbab1032f97826b
+  data.tar.gz: 5c4a8b1143cdb8c4d0a78287b2b60fde38873f5b7570b73e7fbe8227aceefe86
+SHA512:
+  metadata.gz: cec1122bf513bce029509915c01c649675c830bc23509a593389a92124266b5d4e2a7d0f8c4124cc25099986dc599f0dd83ad4cae195b8a1fc0f0055f7d5ce1b
+  data.tar.gz: 9a3303e5e18660ffec7c13a484db93be42e6d4e37f345ef0cd5394fff2002ae0896678451da7247dc964a6e274116f241c32ece1e6cd5799b77d8e2a9266ff46

data/COPYING.md

@@ -0,0 +1,31 @@
+This project is licensed under the PICO License v1.3, © (project author) (current year)
+
+## TERMINOLOGY
+
+- accessibility through the network: to be involved in (and not as part of the underlying operating system) the creation, modification, presentation, and/or distribution of online content over the internet. 
+- assets: any sort of textual or binary files (or unique fragments of files where applicable) which are part of a project, and included either as a processed output (e.g. through a preprocessing tool, assembler, or compiler) or directly, inside or alongside the main finished output of a project, and/or any intermediate stage.
+
+## REQUISITES (for a project)
+
+For a project (original or derived) to be licensed under this license, its complete source code must be publicly available in a way that can be used, modified, and set up by anyone, without the prerequisite of any tools or configuration settings not available to the public, except when sharing said settings could compromise the security of the existing instance(s) (in which case sufficient documentation must be provided to allow users to replace said settings with valid values that let the application function).
+
+If the project does not follow these requirements, this license shall be considered void, and thus cannot be used to license said project.
+
+## TERMS AND CONDITIONS (for the user)
+
+Users are granted an irrevocable, perpetual, and royalty-free right to use, distribute, view, reverse-engineer, and modify this project and its assets in any way allowed by law both for non-commercial and commercial purposes with the following clauses:
+	
+1. Distribution, embedding, and static or dynamic linking of the entire project or assets in binary or source form requires attribution.
+
+2. If the project is accessible through the network either privately or publicly, attribution must be given as per the distribution clause.
+
+3. Attribution must be in the form of a piece of text accessible to the end user (e.g. through the Help menu in a GUI application) indicating the original project name, author(s), and a link to the complete source code of the project.
+
+4. A project derived from the original project must:
+	- be licensed under the exact same license, or any later version;
+	- and provide attribution to the original author(s) as well as the derived project's.
+
+5. Large language models (such as ChatGPT, Claude, or Gemini) or any other generative AI models which train off of publicly available assets are explicitly forbidden from using the project's assets or intellectual property for training.
+
+The project is provided "as-is", without any warranty of any kind.
+The author(s) have made their best effort to make sure the product is safe, although no guarantees are offered regarding potential damages that may result from the usage of this project.

data/README.md

@@ -0,0 +1,3 @@
+# Acrylic
+
+Acrylic is a Ruby web framework inspired by Django which handles all the tedious work (e.g. making migrations) so that you can focus on your web app's functionality.

data/VERSION.md

@@ -0,0 +1,15 @@
+## AcrylicVer
+
+```
+<MAJOR>.<MINOR><PATCH>
+```
+
+examples: '1.5j', `3.14`, `0.2a`
+
+PATCH is omitted for the first release.
+
+PATCH shall be incremented for small changes.
+
+MINOR shall be incremented for feature additions.
+
+MAJOR shall be incremented for large changes (e.g. total API revamps) and/or milestones.

data/lib/acrylic.rb

@@ -0,0 +1,3 @@
+require 'rack'
+require_relative 'bits'
+require_relative 'cascade'

data/lib/bits.rb

@@ -0,0 +1,17 @@
+class Object
+    def containerize
+        if self.is_a? Array then self else [self].compact end
+    end
+end
+
+class Class
+    def new_from object
+        if object.is_a? self then object else new object end
+    end
+end
+
+class Hash
+    def self.from_keys keys
+        keys.map do |k| [k, nil] end.to_h
+    end
+end

data/lib/cascade/errors.rb

@@ -0,0 +1,44 @@
+# Provides customizable error pages for Cascade.
+#   when an error like 404 is encountered, cascade (and the application)
+#   should return just an error code, which will be transformed into a
+#   response with an empty body.
+#   to add content to this empty response, Cascade.error_page will
+#   use a similar route definition system to regular Cascade routes to create error pages.
+
+module Acrylic
+    ERROR_ROUTES = []
+
+    class ErrorRoute < Route
+        attr_reader :code
+
+        def initialize code, args, handler
+            @code = code
+            super args, handler
+        end
+
+        def match? code, req
+            (@code == code) and super req
+        end
+    end
+
+    class Cascade
+        def default_error_body code, req
+            
+        end
+        
+        # returns body of response.
+        def error_body code, req
+            route = ERROR_ROUTES.find do |route| route.match? code, req end
+            body = if route.nil? then default_error_page code, req else route.call req end
+            
+            raise TypeError("return value of error_handler body must be a string") unless body.is_a? String
+            body
+        end
+    end
+end
+
+# route should return body of response
+def error_handler code, *wargs, **kwargs, &route
+    args = (Hash.from_keys wargs).merge kwargs
+    Acrylic::ERROR_ROUTES << (Acrylic::ErrorRoute.new code, args, route)
+end

data/lib/cascade.rb

@@ -0,0 +1,89 @@
+require 'rack'
+
+module Acrylic
+    ROUTES = []
+
+    class Route
+        # list of HTTP verbs the request will be matched against.
+        attr_reader :verbs
+
+        # list of path rules (wildcards or regexps)
+        attr_reader :paths
+
+        def initialize args, handler
+            @handler = handler
+
+            @paths  = args.fetch(:path).containerize
+            @verbs  = (args[:verb] or :GET).containerize.map do |verb| verb.downcase.to_sym end
+        end
+
+        # checks if a path matches one of the rules.
+        def path_match? path
+            @paths.each do |rule|
+                if     ((rule.is_a? Regexp) and (rule.match? path)) \
+                    or ((rule.is_a? Proc)   and (rule.call path))   \
+                    or ((rule.is_a? String) and (File.fnmatch rule, path, File::Constants::FNM_EXTGLOB | File::Constants::FNM_PATHNAME))
+                then return true end
+            end
+
+            return false
+        end
+
+        def match? req
+            # match against paths
+            (path_match? req.path) and (@verbs.include? req.request_method.downcase.to_sym )
+        end
+
+        def call req
+            @handler.call req
+        end
+    end
+
+    class Cascade
+        # returns a response based on the defined routes.
+        # if the response is empty, it shall be passed through Cascade.ServeError
+        def self.handle req
+            headers = {}
+
+            # loop through all the routes to find a final one
+            Acrylic::ROUTES.each do |route|
+                next unless route.match? req
+                
+                res = route.call req
+                res = case true
+                    when (res.nil?)          then next
+                    when (res.is_a? String)  then Rack::Response.new      res
+                    when (res.is_a? Integer) then Rack::Response.new nil, res
+                end
+
+                # if the returned route has a body, return it. else, add its headers to the existing response.
+                if res.is_a? Rack::Response
+                    res.headers.merge! headers
+                    return res
+                elsif res.is_a? Hash
+                    headers.merge! res.headers
+                end
+            end
+
+            # if no route returned a response, return a 404
+            return Rack::Response.new nil, 404
+        end
+
+
+        def self.serve env
+            req = Rack::Request.new env
+
+            res = handle req
+            res.body = error_page res.status, req if res.body.nil?
+            res
+        end
+    end
+end
+
+
+def route *wargs, **kwargs, &route
+    args = (Hash.from_keys wargs).merge kwargs
+    Acrylic::ROUTES << (Acrylic::Route.new args, route)
+end
+
+require 'cascade/errors'

data/lib/version.rb

@@ -0,0 +1,15 @@
+module Acrylic
+  class Version
+    MAJOR = 0
+    MINOR = 1
+    HOTFIX = 0
+
+    def self.semver
+      "#{MAJOR}.#{MINOR}.#{HOTFIX}"
+    end
+
+    def self.version
+      "#{MAJOR}.#{MINOR}#{(HOTFIX - 1 + 'a'.ord).chr if HOTFIX > 0}"
+    end
+  end
+end

metadata

@@ -0,0 +1,62 @@
+--- !ruby/object:Gem::Specification
+name: acrylic
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- fmixolydian
+bindir: bin
+cert_chain: []
+date: 2025-12-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+description: |2
+      Acrylic is a web framework that simplifies your life by automatically generating migrations,
+      as well as providing several macros for repeating common operations (e.g. defining REST APIs).
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- COPYING.md
+- README.md
+- VERSION.md
+- lib/acrylic.rb
+- lib/bits.rb
+- lib/cascade.rb
+- lib/cascade/errors.rb
+- lib/version.rb
+homepage: https://codeberg.org/fmixolydian/acrylic
+licenses:
+- LicenseRef-COPYING.md
+metadata: {}
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.3
+specification_version: 4
+summary: The web framework that makes your life easier
+test_files: []