camping 2.1.532 → 3.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: '052823190781b546bd66ebc9b1e2a164f865d9ad458bb22d81ce44b283644765'
+  data.tar.gz: 4508bee443828152aaa80195e8444a69dcce31fd4d29327b1cab0fa33956d263
+SHA512:
+  metadata.gz: 8601001442164208e68d09f7d3f03f966c9a421bb4ad0e6b52358557732e785ec8ee838e3a951f07f1b6d021197bdcc5eb7b395ae8eba5f328fa589324cbad10
+  data.tar.gz: 061ff21f2a306316d99dfc601a3581f940bffdda253904ffbbe60a283fa43a3c7f876ddb3ef3e4d19ab96006437af9575056e52dbfa663ec262c948854d01213

data/README.md

@@ -1,96 +1,115 @@
-[![Build Status](https://secure.travis-ci.org/camping/camping.png)](http://travis-ci.org/camping/camping)
+![Build Status](https://github.com/camping/camping/actions/workflows/ruby.yml/badge.svg)
 
-#Camping, a Microframework
+# Camping, a Microframework
 
-Camping is a web framework which consistently stays at less than 4kB of code.
+Camping is a micro web framework which stays as small as possible.
 You can probably view the complete source code on a single page. But, you
-know, it's so small that, if you think about it, what can it really do?
+know, it's so small that, if you think about it, what can it really do? Apparently
+it can do a lot. It's pretty swell.
 
 The idea here is to store a complete fledgling web application in a single
 file like many small CGIs. But to organize it as a Model-View-Controller
-application like Rails does. You can then easily move it to Rails once you've
-got it going.
+application. And with time, you can move your Models, Views, and Controllers into
+other files as your app grows.
 
-##A Camping Skeleton
+Camping supports multiple *apps*, capsuled code that runs together. Each app can
+have independent models, routes, and controllers.
+
+Pack your gear when you go Camping! With a simple plugin system, Camping is easily
+extensible. Add all sorts of useful and silly things.
+
+## A Camping Skeleton
 
 A skeletal Camping blog could look like this:
 
-    require 'camping'
-  
-    Camping.goes :Blog
+```ruby
+require 'camping'
 
-    module Blog::Models
-      class Post < Base; belongs_to :user; end
-      class Comment < Base; belongs_to :user; end
-      class User < Base; end
-    end
+Camping.goes :Blog
 
-    module Blog::Controllers
-      class Index
-        def get
-          @posts = Post.find :all
-          render :index
-        end
-      end
-    end
+module Blog::Models
+  class Post < Base; belongs_to :user; end
+  class Comment < Base; belongs_to :user; end
+  class User < Base; end
+end
 
-    module Blog::Views
-      def layout
-        html do
-          head { title "My Blog" }
-          body do
-            h1 "My Blog"
-            self << yield
-          end
-        end
+module Blog::Controllers
+  class Index
+    def get
+      @posts = Post.find :all
+      render :index
+    end
+  end
+end
+
+module Blog::Views
+  def layout
+    html do
+      head { title "My Blog" }
+      body do
+        h1 "My Blog"
+        self << yield
       end
+    end
+  end
 
-      def index
-        @posts.each do |post|
-          h1 post.title
-        end
-      end
+  def index
+    @posts.each do |post|
+      h1 post.title
     end
-  
-##Installation
+  end
+end
+```
+
+## Installation
 
 Interested yet?  Luckily it's quite easy to install Camping.  We'll be using
 a tool called RubyGems, so if you don't have that installed yet, go grab it!
 Once that's sorted out, open up a Terminal or Command Line and enter:
 
-    gem install camping
+```
+gem install camping
+```
 
-Even better, install the Camping Omnibus, a full package of recommended libs:
+~~Even better, install the Camping Omnibus, a full package of recommended libs:~~ Camping Omnibus will return for summer vacation.
 
-    gem install camping-omnibus --source http://gems.judofyr.net
+```
+gem install camping-omnibus
+```
 
 If not, you should be aware of that Camping itself only depends on
-[Rack](http://rack.rubyforge.org), and if you're going to use the views you also
-need to install **[markaby](http://markaby.github.com/)**, and if you're going to use the database you need
+[Rack](https://github.com/rack/rack), and if you're going to use the views you also
+need to install **[markaby](https://github.com/markaby/markaby)**, and if you're going to use the database you need
 **activerecord** as well.
 
-    gem install markaby
-    gem install activerecord
- 
-##Learning
+```
+gem install markaby
+gem install activerecord
+```
 
-First of all, you should read [the first chapters](camping/blob/master/book/01_introduction.md)
+## Learning
+
+First of all, you should read [the first chapters](/book/01_introduction.md)
 of The Camping Book. It should hopefully get you started pretty quick. While
 you're doing that, you should be aware of the _reference_ which contains
 documentation for all the different parts of Camping.
 
-[The wiki](http://wiki.github.com/camping/camping) is the place for all tiny,
+[The wiki](https://github.com/camping/camping/wiki) is the place for all tiny,
 useful tricks that we've collected over the years.  Don't be afraid to share
 your own discoveries; the more, the better!
 
-And if there's anything you're wondering about, don't be shy, but rather 
+And if there's anything you're wondering about, don't be shy, but rather
 subscribe to [the mailing list](http://rubyforge.org/mailman/listinfo/camping-list)
 and ask there.  We also have an IRC channel over at Freenode, so if you feel
 like chatting with us, you should join [#camping @ irc.freenode.net](http://java.freenode.net/?channel=camping).
 
-##Authors
+## Running Tests
+
+Tests should be run using bundler and rake: `bundle exec rake`.
+
+## Authors
 
 Camping was originally crafted by [why the lucky stiff](http://en.wikipedia.org/wiki/Why_the_lucky_stiff),
 but is now maintained by the _community_.  This simply means that if we like your
 patch, it will be applied.  Everything is managed through [the mailing list](http://rubyforge.org/mailman/listinfo/camping-list),
-so just subscribe and you can instantly take a part in shaping Camping.
+so just subscribe and you can instantly take part in shaping Camping.

data/Rakefile

@@ -44,17 +44,17 @@ else
     require 'rdoc/generator/singledarkfish'
     rdoc.options += ['-f', 'singledarkfish', *RDOC_OPTS]
     rdoc.template = "flipbook"
-    
+
     rdoc.rdoc_dir = 'doc'
     rdoc.title = "Camping, a Microframework"
     rdoc.rdoc_files.add ['README', 'lib/camping-unabridged.rb', 'lib/camping/**/*.rb', 'book/*']
   end
 end
 
-  
+
 task :rubygems_docs do
   require 'rubygems/doc_manager'
-  
+
   def spec.installation_path; '.' end
   def spec.full_gem_path;     '.' end
   manager = Gem::DocManager.new(spec)
@@ -67,26 +67,29 @@ task :package => :clean
 ## Tests
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
-  t.test_files = FileList['test/app_*.rb']
+  t.test_files = FileList['test/app_*.rb', 'test/gear/gear_*.rb']
 end
 
 ## Diff
 desc "Compare camping and camping-unabridged"
 task :diff do
-  require 'ruby2ruby'
-  require 'ruby_parser'
+  require 'parser/current'
+  require 'unparser'
+  require 'pp'
   u = Tempfile.new('unabridged')
   m = Tempfile.new('mural')
-  
-  u << Ruby2Ruby.new.process(RubyParser.new.parse(File.read("lib/camping.rb")))
-  mtext = Ruby2Ruby.new.process(RubyParser.new.parse(File.read("lib/camping-unabridged.rb")))
-  m << mtext.gsub(/^\s*#.*\n/, '')
-  
+
+  usexp = Parser::CurrentRuby.parse(File.read("lib/camping-unabridged.rb"))
+  msexp = Parser::CurrentRuby.parse(File.read("lib/camping.rb"))
+
+  u << Unparser.unparse(usexp)
+  m << Unparser.unparse(msexp)
+
   u.flush
   m.flush
-  
+
   sh "diff -u #{u.path} #{m.path} | less"
-  
+
   u.delete
   m.delete
 end
@@ -107,23 +110,25 @@ namespace :check do
     require 'ruby_parser'
     u = RubyParser.new.parse(File.read("lib/camping-unabridged.rb"))
     m = RubyParser.new.parse(File.read("lib/camping.rb"))
-    
+
     u.reject! do |sexp|
       sexp.is_a?(Sexp) and sexp[1] == s(:gvar, :$LOADED_FEATURES)
     end
-    
+
     unless u == m
       STDERR.puts "camping.rb and camping-unabridged.rb are not synchronized."
       error = true
+    else
+      puts "✅ synchronized....."
     end
   end
 
-  SIZE_LIMIT = 4096
+  SIZE_LIMIT = 6144
   desc "Compare camping sizes to unabridged"
   task :size do
     FileList["lib/camping*.rb"].each do |path|
       s = File.size(path)
-      puts "%21s : % 6d % 4d%" % [File.basename(path), s, (100 * s / SIZE_LIMIT)]
+      puts "%21s : % 6d % 4d%%" % [File.basename(path), s, (100 * s / SIZE_LIMIT)]
     end
     if File.size("lib/camping.rb") > SIZE_LIMIT
       STDERR.puts "lib/camping.rb: file is too big (> #{SIZE_LIMIT})"
@@ -131,18 +136,18 @@ namespace :check do
     end
   end
 
-  desc "Verify that line lenght doesn't exceed 80 chars for camping.rb"
+  desc "Verify that line length doesn't exceed 80 (120) chars for camping.rb"
   task :lines do
     i = 1
     File.open("lib/camping.rb").each_line do |line|
-      if line.size > 81 # 1 added for \n
+      if line.size > 121 # 1 added for \n
         error = true
         STDERR.puts "lib/camping.rb:#{i}: line too long (#{line[-10..-1].inspect})"
       end
       i += 1
     end
   end
-  
+
   task :exit do
     exit 1 if error
   end

data/bin/camping

@@ -3,6 +3,7 @@
 $:.unshift File.dirname(__FILE__) + "/../lib"
 
 require 'camping'
+# require 'camping-unabridged' # comment out the above line and uncomment this line to run camping unabridged with all sorts of stuff in it.
 require 'camping/server'
 
 begin

data/book/01_introduction.md

@@ -1,10 +1,10 @@
-#Introduction
+# Introduction
 
-Camping is a small web framework, less than 4k, a little white blood cell in
-the vein of Rails. This little book will start with a tutorial which takes
+Camping is a small, micro web framework, less than 5k, a little white blood cell in
+the vein of Ruby. This little book will start with a tutorial which takes
 about fifteen minutes - by the end you should have a little Camping site up.
-The following chapters will eventually go deeper into how both Camping, HTTP
-and Rack works.
+The following chapters will eventually go deeper into how Camping, HTTP and
+Rack work.
 
 ("Eventually", because these chapters are not written yet. This book is
 currently a very much work in progress, and we'll be very grateful if you want
@@ -14,6 +14,6 @@ If you at any moment need some help or have any questions or comments, we
 highly recommend [the mailing list](http://rubyforge.org/mailman/listinfo/camping-list)
 which got plenty of nice people willing to help. We also have an IRC-channel
 at [#camping @ irc.freenode.net](http://java.freenode.net/?channel=camping)
-if you're into that sort of things.
+if you're into that sort of thing.
 
 Enough talk. Ready? Let's ["get started"](02_getting_started.md).