pakyow 1.0.0.rc5 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2c05bf4ba6673d5a62c402fa8ae29a7d58b34cafdba727e23aad5e455fc1b7d8
-  data.tar.gz: b4d67e55979a5699dbd4b0c87c754f9e020f03c2b4f9aa38c098dc3f0cb9d7ee
+  metadata.gz: acb9e6aaa7b416a1a549777f618c0f064f13aaa5f6aeb3b6d8dbbfa37586d76a
+  data.tar.gz: 10490dfd50ea26917eddc5c05e2c67e3d65224790fd81b63ccdc1233ff8b594e
 SHA512:
-  metadata.gz: e0e109f5a47c4ab650ad49ef6aba9de5f30a9e5635f5bd2ea40877552a42a66424ad67ab4b9b7c2b3e660cfd86d115c5347e02ffc4845710b7f685ee9489cd1c
-  data.tar.gz: 39b5ab41b84d8f69be28a6fb18099757cafb45d5898a1168b222a23f35fdc2a90bc6360b1891c63e130c7f18980e6ddadf3d6679b1ae033e90a5bc9e636b9773
+  metadata.gz: bee3420fb62c1f7d5f0d856d6a7038a3e552321ed91deb782135dd2c8b3089dfa1a30abe420476d6b186994b7b1380b05080e239bdbb6be45cca202e502b08ae
+  data.tar.gz: b4f0bb6062ad0686e02e7ab8a6ffb2340e5d5805c2228b5428a4025f99dc8ada7ebf15c1d67d947e4126fda4cfb6216956debfb35ab1bb64a7a96c96691284c9

data/CHANGELOG.md

@@ -1,28 +1,5 @@
-# 0.11.0
+# UNRELEASED
 
-  * Generated app updates:
-    * Uses dotenv for config management
-    * Breaks middleware into pluggable pieces
-    * Dynamically sets app name in config
-    * Creates a random session secret
-    * Updates Ring to 0.2.4
-  * Evaluates app template as erb
-  * Improves CLI, including new `version` command
-  * Moves everything into the Pakyow namespace
-  * Adds ASCII art to `server` command \o/
+# 1.0
 
-# 0.10.2 / 2015-11-15
-
-  * Updates Ring to latest in generator
-
-# 0.10.01 / 2015-10-19
-
-  * Use semantic versioning for Pakyow in generated Gemfile
-
-# 0.10.0 / 2015-10-19
-
-  * Rename `app.rb` to `setup/app.rb`
-  * Adds Pakyow icons to generated app
-  * Adds Ring to generated app
-  * Updates Pakyow CSS in generated app
-  * Adds session middleware to generated app
+  * Hello, Web

data/README.md

@@ -1,143 +1,116 @@
-[gem]: https://rubygems.org/gems/pakyow
-[travis]: https://travis-ci.org/pakyow/pakyow
+# <img src="https://pakyow.com/marketing/logo.svg" height="42" alt="Pakyow">
 
-# Pakyow Web Framework [![Gitter chat](https://badges.gitter.im/pakyow/chat.svg)](https://gitter.im/pakyow/chat)
+**Hello, Web.** Pakyow is a web framework that helps you turn your html into a complete web app. We set out to design a better way to build for the web. This is the result&mdash;a full stack of open-source frameworks that offers a simpler, design-first approach. We want to help you do more with what you already know, whether you're just starting out or have been building for the web for years.
 
-*Build modern web applications that don't break the web.*
+Here's how it works:
 
-Pakyow is a Ruby web framework that lets you create fantastic experiences for your users
-without writing any client-side code. Build modern server-driven applications that don't
-compromise on speed or usability.
+1. Prototype: Create an in-browser prototype without writing any backend code. Use composable, plain-html view templates to define how your app looks and behaves, then sprinkle data bindings on top to describe the semantic intent behind your interface.
 
-## Realtime UIs
+2. Reflect: While you prototype, Pakyow reflects on your views to bootstrap a complete backend to make your interface work—including routes, data models, presenters, and more. The reflection integrates seamlessly with your frontend, giving you a solid foundation to continue building on.
 
-Pakyow automatically keeps your presentation layer in sync with state of the server.
-Works out of the box.
+3. Iterate: With the boilerplate taken care of, focus on building what makes your app unique. Any custom code you add runs right alongside the reflection, giving you flexibility where you need it and a secure, standards-based fallback for everything else.
 
-## Quick & Easy Prototypes
+This is what a Pakyow view template looks like:
 
-Create a working prototype of your project with plain HTML. Later, build right on
-top of the prototype without throwing it out.
+```html
+<form binding="message">
+  <input binding="content" type="text">
+  <input type="submit">
+</form>
 
-## Build a Friendlier Web
+<article binding="message">
+  <p binding="content">
+    content goes here
+  </p>
+</article>
 
-We think that a simpler web leads to a democratic web. Pakyow optimizes for
-simplicity, making it easier to start and leading to long-term productivity.
+<p binding="message" version="empty">
+  nothing here yet
+</p>
+```
 
----
-
-[![Gem Version](https://badge.fury.io/rb/pakyow.svg)][gem]
-[![Build Status](https://travis-ci.org/pakyow/pakyow.svg?branch=master)][travis]
-
----
-
-# Getting Started
+Pakyow can attach quite a bit of default behavior to an app just based on this template.
 
-1. Install Pakyow:
+* [Get an overview in the 5-minute app guide &rarr;](https://pakyow.com/docs/hello/example)
 
-    `gem install pakyow`
+## Designed for the designers.
 
-2. Create a new Pakyow project from the command line:
+Pakyow lets designers play an active part in building the things they design. Interfaces are built right in the web browser using HTML and CSS, and then extended to become a complete application.
 
-    `pakyow new webapp`
+## Live views without breaking a sweat.
 
-3. Move to the new directory and start the server:
+Pakyow UIs stay in sync with server-side state right out of the box. There's nothing new to learn and no frontend framework to adopt. The UI is rendered on the server like in a traditional stack, but once presented in a browser it automatically reflects new changes without a page refresh.
 
-    `cd webapp; bundle exec pakyow server`
+## Backed by a complete framework.
 
-4. You'll find your project running at [http://localhost:3000](http://localhost:3000)!
+Pakyow includes everything you need to create a complete web app or website. The core primitives that Pakyow uses internally are available to you as you need them. Pakyow's backend, built on Ruby, is designed to make custom code fun to write and easier to maintain long term.
 
-# Next Steps
+## Responsibly Open-Source
 
-- [Read the overview](https://pakyow.org/docs/overview) to better understand the goals and architecture of Pakyow.
-- [Follow the warmup](https://pakyow.org/docs/warmup) to build and deploy your first project.
-- [Browse the docs](https://pakyow.org/docs) to learn more about presentation, routing, realtime channels, and more.
-- [Check out the code](https://github.com/pakyow/pakyow) on Github.
+Pakyow is released free and open-source under the terms of the LGPLv3 license. We offer paid team subscriptions that remove some of the restrictions of the LGPL. Team subscriptions also include access to expert help for you and your team through a private support channel.
 
-We'd love to have you involved. Here are a few places to start:
+Giving Pakyow away for free and charging for the extra bits on top lets us embrace the open-source ethos in a responsible and sustainable way. Pakyow is our full-time job&mdash;we're in this for the long haul.
 
-- [Give us a star](https://github.com/pakyow/pakyow)
-- [Participate in chat](https://gitter.im/pakyow/chat)
-- [Join the forums](http://forums.pakyow.org/)
-- [Work on a starter issue](https://github.com/pakyow/pakyow/labels/Starter)
-- [Report problems](https://github.com/pakyow/pakyow/issues)
-- [Tell your friends](https://twitter.com/share?text=Pakyow,%20build%20modern%20apps%20that%20don%27t%20break%20the%20web&hashtags=pakyow&url=https://pakyow.org)
+* [Learn more about subscriptions &rarr;](https://pakyow.com/pricing/)
 
-# License
+## Getting Help
 
-Pakyow is free and open-source under the [LGPLv3 license](https://choosealicense.com/licenses/lgpl-3.0/).
+Have a question about Pakyow? Connect with other users in the [community](https://pakyow.com/community/). Encountered a bug? Report it on the [issue tracker](https://github.com/pakyow/pakyow/issues/) and we'll hep you out. Find a security concern? **Don't report it publicly. Email security@pakyow.com and we'll work with you to confirm the issue, establish a fix, and release a patch.**
 
-# Overview
+## Technical Overview
 
-*[Read the docs](https://www.pakyow.org/docs) if you want the full skinny.*
+Pakyow apps run almost entirely on the server side, with a minimal client-side framework to support things like live view updates and components. Everything on the server is written in [Ruby](https://www.ruby-lang.org/), a beautifully designed programming language optimized for the happiness of beginners and experienced developers alike!
 
-Pakyow is designed to be modular, with each library handling one aspect of the
-framework. Here's a list of the libraries that Pakyow ships with by default:
+Pakyow is implemented across several independent frameworks, each released as its own gem. This modularity lets us provide a helpful set of default behavior while providing flexibility for advanced users to decide what behavior they want to run in their projects. Pakyow's default set of frameworks can be found in the `pakyow/pakyow` repository:
 
-- Routing: Routes requests to endpoints within an app.
-- Presenter: Handles logicless view presentation, including data binding.
-- Mailer: Delivers logicless views over email, rather than http.
-- Realtime: Adds WebSocket support and realtime channels.
-- UI: Automatically keeps rendered views in sync with server-side state.
-- Test: Provides helpers that make it easy to test various aspects of an app.
-- Support: Provides helpers used throughout the framework.
-- Rake: Adds several tasks that are useful alongside an app.
+* Routing: Controllers, Input Verification, and Error Handling
+* Presenter: View Composition, Data Presentation
+* Assets: Compiling Styles, JavaScript, and Images
+* Realtime: Pub/Sub Channels via WebSockets
+* UI: Server-Side Integration with Web Browsers
+* JS: Client-Side Presentation, UI Components
+* Data: Persistence Layer, Query Subscriptions
+* Mailer: Sending Email, Delivering Views
+* Forms: Rendering Forms, Processing Submissions
+* Reflection: Generates View Reflections
+* Support: Supporting Code, Utilities
 
-There are many secondary libraries that add additional functionality, including:
+Foundational concepts used across frameworks are defined in the main `pakyow-core` gem, including:
 
-- Markdown: Adds support for writing view templates in Markdown.
-- Slim: Adds support for writing view templates in Slim.
-- Haml: Adds support for writing view templates in Haml.
-- Bindr: Introduces the concept of recursive data binding.
+**Environment:** The master process that runs one or more mounted apps. Most of the time you'll be mounting an instance of `Pakyow::App`, however you can mount any object that responds to `call`. Note that the environment is the only global object that exists in the framework.
 
-It's standard that every Pakyow-related library is prefixed with `pakyow-*`.
+* [Read more about environment &rarr;](https://github.com/pakyow/pakyow/blob/master/pakyow-core/lib/pakyow/environment.rb)
 
----
+**Application:** An endpoint mounted at a specific path within the environment. Each application defines various aspects, including controllers, presenters, and data sources. These aspects are used to fulfill requests that the environment directs to the application.
 
-The primary library (named simply `pakyow`) handles concerns shared across the
-Pakyow ecosystem. It glues everything together. Read below for a summary.
+* [Read more about application &rarr;](https://github.com/pakyow/pakyow/blob/master/pakyow-core/lib/pakyow/application.rb)
 
-## Environment
+**Connection:** Contains all of the knowledge about the current request lifecycle, including headers, body, status, etc. It also contains a key/value store for passing request state between frameworks. The environment has a connection object used for every request. When the connection is directed to an application, the application can wrap the environment connection with its own behavior.
 
-Makes it possible to run multiple Rack-compatible endpoints (including Pakyow
-apps) with the consistency of a single environment.
+* [Read more about connection &rarr;](https://github.com/pakyow/pakyow/blob/master/pakyow-core/lib/pakyow/connection.rb)
 
-[Browse the source &raquo;](https://github.com/pakyow/pakyow/blob/environment/lib/pakyow/environment.rb)
-
-## Request Logger
-
-Adds request-level logging, with a human-friendly formatter for development and
-a logfmt formatter for production environments.
-
-[Browse the source &raquo;](https://github.com/pakyow/pakyow/blob/environment/lib/pakyow/logger/request_logger.rb)
-
-## Default Middleware
+---
 
-Introduces a default middleware stack for all apps within the environment,
-including request path normalization and json body parsing.
+There's a lot more to the main gem, including process management for development environments, configuration, and integrations. We encourage you to walk through the code yourself--it's a great way to learn!
 
-[Browse the source &raquo;](https://github.com/pakyow/pakyow/blob/environment/lib/pakyow/environment.rb#L145)
+* [Browse the code &rarr;](https://github.com/pakyow/pakyow/tree/master/lib/pakyow)
 
-## App Template
+You might also be interested in `pakyow/design`, which applies design-first principles to the design of the framework itself. It's a great way to see how all of the features in a Pakyow app work together.
 
-Ships with the default template for generated Pakyow apps.
+* [Browse pakyow/design &rarr;](https://github.com/pakyow/design)
 
-[Browse the source &raquo;](https://github.com/pakyow/pakyow/tree/environment/lib/generators/pakyow/app/templates)
+## Common Patterns
 
-## Command Line Interface (CLI)
+You'll find several implementation patterns throughout the codebase, including:
 
-Adds a CLI for creating Pakyow apps and running the environment.
+### Pipelines
 
-[Browse the source &raquo;](https://github.com/pakyow/pakyow/blob/environment/lib/pakyow/cli.r://github.com/pakyow/pakyow/blob/environment/lib/pakyow/cli.rb)
+Pipelines allow one or more actions to be defined and then called in order. Each action can modify the state and/or halt execution of the pipeline, at which point the final state is returned. This pattern makes it much easier to understand the path a request takes through the system. For example, Pakyow::Controller is implemented using pipelines.
 
-# Official Documentation
+* [Read more about pipelines &rarr;](https://github.com/pakyow/pakyow/blob/master/pakyow-support/lib/pakyow/support/pipelined.rb)
 
-The official documentation can be found
-[here](https://github.com/pakyow/pakyow/tree/environment/docs). We bundle the
-docs with the code so that they evolve together.
+### Behavior Extensions
 
-# Canonical Example
+Throughout the framework you'll find extension modules in a `behavior` directory. When included, each behavior module extends the including object with its defined behavior. This pattern lets us isolate complex behavior and use composition to define how a particular object in the system should behave. For example, `Pakyow::App` includes several behavior extensions, such as [error handling](https://github.com/pakyow/pakyow/blob/master/pakyow-core/lib/pakyow/core/controller/behavior/error_handling.rb).
 
-The canonical example for Pakyow can be found
-[here](https://github.com/pakyow/pakyow/tree/environment/example). We try and
-keep it current to reflect the entire feature-set across the framework.
+* [Read more about extensions &rarr;](https://github.com/pakyow/pakyow/blob/master/pakyow-support/lib/pakyow/support/extension.rb)

data/lib/pakyow/version.rb

@@ -3,5 +3,5 @@
 module Pakyow
   # Pakyow's current version.
   #
-  VERSION = "1.0.0.rc5"
+  VERSION = "1.0.0"
 end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pakyow
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc5
+  version: 1.0.0
 platform: ruby
 authors:
 - Bryan Powell
-- Bret Young
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-15 00:00:00.000000000 Z
+date: 2019-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: pakyow-assets
@@ -17,156 +16,156 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-data
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-form
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-mailer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-presenter
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-realtime
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-reflection
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-routing
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-support
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: pakyow-ui
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 1.0.0.rc5
+        version: 1.0.0
 description: Modern web framework for Ruby
-email: bryan@metabahn.com
+email: bryan@bryanp.org
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -176,7 +175,7 @@ files:
 - README.md
 - lib/pakyow/all.rb
 - lib/pakyow/version.rb
-homepage: https://pakyow.org
+homepage: https://pakyow.com
 licenses:
 - LGPL-3.0
 metadata: {}
@@ -191,9 +190,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.0.3
 signing_key: