camping 3.2.4 → 3.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6eb683f17e8a1026e536396b517135abfeae0597453b99202662a7ad92e055d5
-  data.tar.gz: 4f38e1736732750ff070e988863dd7de1410ec18e5f81a3176469ace840016d3
+  metadata.gz: 915bc9e71d2023113e730ce571ac0b6327946cc9d230eb4f3f4c5803b71551ec
+  data.tar.gz: 0b7246146b74d7937ae77115c093605cd59a2e505465968effeacfe95ab3a666
 SHA512:
-  metadata.gz: d11e1328dd9c227b030bc5bf5594f5ce59b370ea850a2439d10c128cf472f7afc2b7f75bd8e49305b3944b2a28f128f6d719d936e3125249fb05376cdd60e70f
-  data.tar.gz: 6197f2e9a11a19a3f85a4b71c254ae055c85d61c98717d85aec5efb1d8005498750b68dd2291d284f454352ee10fa3b343dc05885232b6141996eab4cd4a851d
+  metadata.gz: af96a7f36ce4893de7af94c448cd96013fe7a85812abc2e55a98932129a4575cd3513dbc7894f49f3a312ba2c248a41180684897034a976577db18c840181ab6
+  data.tar.gz: cb1d95c481f217eb848934fe022a5409a21b9bb31e4f7d6eb3874ba9774797a32470fd9c4179e006879948f76c6a682063ed962294feb170753b3f77beb6d0b3

data/README.md

@@ -1,6 +1,6 @@
 ![Build Status](https://github.com/camping/camping/actions/workflows/camping.yml/badge.svg) ![Build Status](https://github.com/camping/camping/actions/workflows/integration.yml/badge.svg)
 
-# Camping, a Microframework
+# ⛺️ Camping, a Microframework
 
 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
@@ -72,12 +72,6 @@ Line and enter:
 gem install camping
 ```
 
-Also make certain to have Bundler installed:
-
-```
-gem install bundler
-```
-
 ~~Even better, install the Camping Omnibus, a full package of recommended libs:~~ Camping Omnibus will return for summer vacation.
 
 Now make a new directory filled with your camp essentials using the `camping new` command:
@@ -109,10 +103,16 @@ documentation for all the different parts of Camping.
 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
-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).
+We have a Discord channel over at the Ruby Punks community, so if you feel
+like chatting with us, you should join [#camping](https://discord.gg/JSmPBsWgFt). Once our chattin' leads to action, we open up an issue on Github and move the conversation over there.
+
+## Contributing
+
+Camping is under active development, and we'd love some help!. Our current focus is bug fixes, documentation, and tests. We have a [number of issues](https://github.com/camping/camping/issues?q=is%3Aissue+is%3Aopen+label%3A%22Great+for+new+Contributors%22) open for new contributors to get crackin!
+
+To begin contributing, [Fork Camping](https://github.com/camping/camping/fork), Then make a new branch, (`git checkout -b my_branch_name`) with your changes. When you're ready to bring all that hard work on over, open a draft PR and ping Karl to take a look, He'll help you fix any issues and help you get it inside of old Camping.
+
+Have a suggestion? Open an issue with what you think we ought to be doing with our lives, and we'll talk about it. Don't be shy.
 
 ## Running Tests
 
@@ -120,11 +120,8 @@ Tests should be run using bundler and rake: `bundle exec rake`.
 
 ## Minting Releases
 
-We use Ruby Gems to distribute versions of Camping.
+We use Ruby Gems to distribute versions of Camping. When you're ready to mint a release, run: `gem build -o camping.gem`, then `gem push camping.gem`.
 
 ## 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 part in shaping Camping.
+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 this Github repo, so just [open an issue](https://github.com/camping/camping/issues/new) and you can instantly take part in shaping Camping.

data/book/01_introduction.md

@@ -11,9 +11,8 @@ currently a very much work in progress, and we'll be very grateful if you want
 to help out.)
 
 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)
+highly recommend [opening an issue](https://github.com/camping/camping/issues/new) to ask for help. We've got plenty of nice people willing to help. We also have a Discord channel
+at [rubypunks](https://discord.gg/JSmPBsWgFt)
 if you're into that sort of thing.
 
 Enough talk. Ready? Let's ["get started"](02_getting_started.md).

data/book/02_getting_started.md

@@ -1,5 +1,11 @@
 # Getting Started
 
+You'll need Ruby Gems to get camping. Install camping like so:
+
+```bash
+gem install camping
+```
+
 Start a new text file called camp.rb. Here's what you put inside:
 
 ```ruby
@@ -10,7 +16,7 @@ Camping.goes :Nuts
 Save it. Then, open a command prompt in the same directory. You'll want to
 run:
 
-```ruby
+```bash
 $ camping
 ```
 
@@ -20,8 +26,7 @@ And you should get a message which reads:
 ** Camping running on 0.0.0.0:3301.
 ```
 
-This means that right now The Camping Server is running on port 3301 on your
-machine. Open your browser and visit http://localhost:3301/.
+This means that right now The Camping Server is running on port 3301 on your machine. Open your browser and visit http://localhost:3301/.
 
 Your browser window should show:
 
@@ -31,29 +36,23 @@ Camping Problem!
 / Not found
 ```
 
-No problem with that. The Camping Server is running, but it doesn't know what
-to show. Let's tell them.
+No problem with that. The Camping Server is running, but it doesn't know what to show. Let's tell them.
 
 ## Hello clock
 
-So, you've got Camping installed and it's running. Keep it running. You can
-edit files and The Camping Server will reload automatically. When you need to
-stop the server, press Control-C.
+So, you've got Camping installed and it's running. Keep it running. You can edit files and The Camping Server will reload automatically. When you need to stop the server, press **Control-C**.
 
 Let's show something. At the bottom of camp.rb add:
 
 ```ruby
 module Nuts::Controllers
   class Index < R '/'
-    def get
-      Time.now.to_s
-    end
+    def get = Time.now.to_s
   end
 end
 ```
 
-Save the file and refresh the browser window. Your browser window should show
-the time, e.g.
+Save the file and refresh the browser window. Your browser window should show the time, e.g.
 
 ```
 Sun Jul 15 12:56:15 +0200 2007
@@ -61,9 +60,7 @@ Sun Jul 15 12:56:15 +0200 2007
 
 ## Enjoying the view
 
-The Camping microframework allows us to separate our code using the MVC
-(Model-View-Controller) design pattern. Let's add a view to our Nuts
-application. Replace the <tt>module Nuts::Controllers</tt> with:
+The Camping microframework allows us to separate our code using the MVC (Model-View-Controller) design pattern. Let's add a view to our Nuts application. Replace the <tt>module Nuts::Controllers</tt> with:
 
 ```ruby
 module Nuts::Controllers
@@ -76,6 +73,8 @@ module Nuts::Controllers
 end
 ```
 
+And below it add:
+
 ```ruby
 module Nuts::Views
   def layout
@@ -87,14 +86,11 @@ module Nuts::Views
     end
   end
 
-  def sundial
-    p "The current time is: #{@time}"
-  end
+  def sundial = p "The current time is: #{@time}"
 end
 ```
 
-Save the file, refresh your browser window and it should show a message
-like:
+Save the file, refresh your browser window and it should show a message like:
 
 ```
 The current time is: Sun Jul 15 13:05:41 +0200 2013
@@ -102,59 +98,39 @@ The current time is: Sun Jul 15 13:05:41 +0200 2013
 
 And the window title reads "Nuts And GORP".
 
-Here you can see we call <tt>render :sundial</tt> from our controller. This
-does exactly what it says, and renders our <tt>sundial</tt> method. We've also
-added a special method called <tt>layout</tt> which Camping will automatically
-wrap our sundial output in. If you're familiar with HTML, you'll see that our
-view contains what looks HTML tag names. This is Markaby, which is like
-writing HTML using Ruby!
+Here you can see we call <tt>render :sundial</tt> from our controller. This does exactly what it says, and renders our <tt>sundial</tt> method. We've also added a special method called <tt>layout</tt> which Camping will automatically wrap our sundial output in. If you're familiar with HTML, you'll see that our view contains what looks HTML tag names. This is Markaby, which is like writing HTML using Ruby!
 
-Soon enough, you'll find that you can return anything from the controller, and
-it will be sent to the browser. But let's keep that for later and start
-investigating the routes.
+Soon enough, you'll find that you can return anything from the controller, and it will be sent to the browser. But let's keep that for later and start investigating the routes.
 
 ## Routes
 
-You probably noticed the weird <tt>R '/'</tt> syntax in the previous page.
-This is an uncommon feature of Ruby that is used in our favorite
-microframework, to describe the routes which the controller can be accessed
-on.
+You probably noticed the weird <tt>R '/'</tt> syntax in the previous page. This is an uncommon feature of Ruby that is used in our favorite microframework, to describe the routes which the controller can be accessed on.
 
-These routes can be very powerful, but we're going to have look at the
-simplest ones first.
+These routes can be very powerful, but we're going to have look at the simplest ones first.
 
 ```ruby
 module Nuts::Controllers
   class Words < R '/welcome/to/my/site'
-    def get
-      "You got here by: /welcome/to/my/site"
-    end
+    def get = "You got here by: /welcome/to/my/site"
   end
 
   class Digits < R '/nuts/(\d+)'
-    def get(number)
-      "You got here by: /nuts/#{number}"
-    end
+    def get(number) = "You got here by: /nuts/#{number}"
   end
 
   class Segment < R '/gorp/([^/]+)'
-    def get(everything_else_than_a_slash)
-      "You got here by: /gorp/#{everything_else_than_a_slash}"
-    end
+    def get(everything_else_than_a_slash) = "You got here by: /gorp/#{everything_else_than_a_slash}"
   end
 
   class DigitsAndEverything < R '/nuts/(\d+)/([^/]+)'
-    def get(number, everything)
-      "You got here by: /nuts/#{number}/#{everything}"
-    end
+    def get(number, everything) = "You got here by: /nuts/#{number}/#{everything}"
   end
 end
 ```
 
-Add this to `nuts.rb` and try if you can hit all of the controllers.
+Add this to `camp.rb` and try if you can hit all of the controllers.
 
-Also notice how everything inside a parenthesis gets passed into the method,
-and is ready at your disposal.
+Also notice how everything inside a parenthesis gets passed into the method, and is ready at your disposal.
 
 ### Simpler routes
 
@@ -163,44 +139,32 @@ This just in:
 ```ruby
 module Nuts::Controllers
   class Index
-    def get
-      "You got here by: /"
-    end
+    def get = "You got here by: /"
   end
 
   class WelcomeToMySite
-    def get
-      "You got here by: /welcome/to/my/site"
-    end
+    def get = "You got here by: /welcome/to/my/site"
   end
 
   class NutsN
-    def get(number)
-      "You got here by: /nuts/#{number}"
-    end
+    def get(number)= "You got here by: /nuts/#{number}"
   end
 
   class GorpX
-    def get(everything_else_than_a_slash)
-      "You got here by: /gorp/#{everything_else_than_a_slash}"
-    end
+    def get(everything_else_than_a_slash) = "You got here by: /gorp/#{everything_else_than_a_slash}"
   end
 
   class NutsNX
-    def get(number, everything)
-      "You got here by: /nuts/#{number}/#{everything}"
-    end
+    def get(number, everything) = "You got here by: /nuts/#{number}/#{everything}"
   end
 end
 ```
 
-Drop the <tt>< R</tt>-part and it attemps to read your mind. It won't always
-succeed, but it can simplify your application once in a while.
+Drop the <tt>< R</tt>-part and it attempts to read your mind. It won't always succeed, but it can simplify your application once in a while.
 
 ## Modeling the world
 
-You can get pretty far with what you've learned now, and hopefully you've been
-playing a bit off-book, but it's time to take the next step: Storing data.
+You can get pretty far with what you've learned now, and hopefully you've been playing a bit off-book, but it's time to take the next step: Storing data.
 
 Let's start over again.
 
@@ -213,8 +177,7 @@ module Nuts::Models
 end
 ```
 
-Obviously, this won't do anything, since we don't have any controllers, but
-let's rather have a look at what we _do_ have.
+Obviously, this won't do anything, since we don't have any controllers, but let's rather have a look at what we _do_ have.
 
 We have a model named Page. This means we now can store wiki pages and
 retrieve them later. In fact, we can have as many models as we want. Need one
@@ -278,7 +241,7 @@ class AddTagColumn < V 1.1
 end
 ```
 
-Now we just need to tell Camping to use our migration. Write this at the bottom of nuts.rb
+Now we just need to tell Camping to use our migration. Write this at the bottom of camp.rb
 
 ```ruby
 def Nuts.create
@@ -292,7 +255,7 @@ we only want to create our skeleton (or upgrade if needed). Start The Camping
 Server again and observe:
 
 ```bash
-$ camping nuts.rb
+$ camping camp.rb
 ** Starting Mongrel on 0.0.0.0:3301
 -- create_table("nuts_schema_infos")
    -> 0.1035s
@@ -315,7 +278,7 @@ is good way to familiarize with your models. Test your models adding some
 data by bare hand before addin it to the application.
 
 ```bash
-$ camping -C nuts.rb
+$ camping -C camp.rb
 ** Starting console
 >>
 ```
@@ -354,8 +317,7 @@ Now I have two pages: One about hiking and one about fishing.
 
 ## Wrapping it up
 
-Wouldn't it be nice if we could show this wonderful our pages in a browser?
-Update nuts.rb so it also contains something like this:
+Wouldn't it be nice if we could show this wonderful our pages in a browser? Update camp.rb so it also contains something like this:
 
 ```ruby
 module Nuts::Controllers

data/lib/camping/loader.rb

@@ -66,10 +66,10 @@ module Camping
 
     # pass through methods to the Listener.
     # for testing purposes.
-    def processing_events?;@listener.processing? end
-    def stop;@listener.stop end
-    def pause;@listener.pause end
-    def start;@listener.start end
+    def processing_events? = @listener.processing?
+    def stop = @listener.stop
+    def pause = @listener.pause
+    def start = @listener.start
 
     def name
       @name ||= begin
@@ -108,9 +108,10 @@ module Camping
         key = app.name.to_sym
         hash[key] = app
 
-        apps.each do |app|
+        if !@apps.include?(key)
           @callback.call(app) if @callback
           app.create if app.respond_to?(:create)
+          app.kindling if app.respond_to?(:kindling)
         end
 
         hash

data/lib/camping/version.rb

@@ -1,5 +1,5 @@
 module Camping
-  VERSION = "3.2.4"
+  VERSION = "3.2.5"
   def self.version
     VERSION
   end

data/test/app_loader.rb

@@ -5,6 +5,11 @@ require 'camping/loader'
 module Donuts end
 module Loader end
 
+def Loader.create
+  puts "creating..."
+  options.my_name = "slim shady"
+end
+
 # for Reloading stuff
 module TestCaseLoaderToo
   def loader
@@ -50,4 +55,12 @@ class Donuts::Test < TestCase
     assert_equal "text/html", last_response.headers['content-type']
   end
 
+  def test_create_method
+    # Tests that our app even has a create method
+    assert(Loader.respond_to?(:create), "test/app_loader.rb: Loader doesn't respond to create method")
+
+    # Test that our create method code is actually run and that It has an effect.
+    assert_equal("slim shady", Loader.options.my_name, "test/app_loader.rb: create method wasn't even loaded.")
+  end
+
 end

data/test/config_reloader.rb

@@ -2,6 +2,9 @@ require_relative 'test_helper'
 require 'fileutils'
 require 'camping/loader'
 
+# This test file is mostly the same as reload_reloader.rb.
+# Except this checks to see if a config.ru app is reloaded correctly.
+
 $counter = 0
 
 # for Reloading stuff
@@ -16,11 +19,9 @@ module TestCaseLoader
     move_to_reloader
     loader.reload!
     assert Object.const_defined?(:Reloader), "Reloader didn't load app"
-    # puts "before_all called"
   end
 
   def after_all
-    # puts "after_all called"
     assert Object.const_defined?(:Reloader), "Test removed app"
     loader.remove_constants
     # breaks in CI for some reason.
@@ -41,7 +42,6 @@ class TestConfigRu < TestCase
     super
     $counter = 0
     loader.reload!
-    # puts "setup called"
   end
 
   def test_counter

data/test/integration/Rakefile

@@ -15,30 +15,3 @@ namespace 'test' do
   end
 end
 
-# def delete_file(filename="")
-#   return if !File.exist? filename
-#   begin
-#     f = File.open(filename, 'r')
-#   ensure
-#     f.close unless f.nil? or f.closed?
-#     File.delete(filename) if File.exist? filename
-#   end
-# end
-
-## Integration Test
-# desc "Perform an integration test"
-# task :integration do
-  # `bundle install` # remove gems
-  # `bundle clean --force` # remove gems
-  # puts Dir.pwd
-  # # `gem install` # add bundler.
-  # `bundle install` # rewrites Gemfile.lock
-  # `bundle add camping --path=../../`
-  # # `bundle add camping puma`
-  # # `bundle add minitest -g=test`
-  # # `bundle add minitest-reporters -g=test`
-  # # `bundle add rack-test -g=test`
-  # # `bundle add minitest-hooks -g=test`
-  # # t.libs << "/"
-  # # t.test_files = FileList['test/test_*.rb']
-# end

data/test/reload_reloader.rb

@@ -16,11 +16,9 @@ module TestCaseLoader
     move_to_reloader
     loader.reload!
     assert Object.const_defined?(:Reloader), "Reloader didn't load app"
-    # puts "before_all called"
   end
 
   def after_all
-    # puts "after_all called"
     assert Object.const_defined?(:Reloader), "Test removed app"
     loader.remove_constants
     assert !Object.const_defined?(:Reloader), "Loader didn't remove app"
@@ -40,7 +38,6 @@ class TestLoader < TestCase
     super
     $counter = 0
     loader.reload!
-    # puts "setup called"
   end
 
   def test_counter
@@ -71,11 +68,11 @@ class TestLoader < TestCase
   end
 end
 
-# class TestConfigRu < TestLoader
-#   BASE = File.expand_path('../apps/reloader', __FILE__)
-#   def file; BASE + '/config.ru' end
+class TestConfigRu < TestLoader
+  BASE = File.expand_path('../apps/reloader', __FILE__)
+  def file; BASE + '/config.ru' end
 
-#   def test_name
-#     assert_equal Reloader, loader.apps[:reloader]
-#   end
-# end
+  def test_name
+    assert_equal Reloader, loader.apps[:reloader]
+  end
+end

data/test/test_helper.rb

@@ -18,7 +18,6 @@ require 'minitest/reporters'
 require 'minitest/hooks'
 Minitest::Reporters.use! [Minitest::Reporters::DefaultReporter.new(:color => true)]
 
-
 module CommandLineCommands
 
   def move_to_tmp
@@ -52,25 +51,6 @@ module CommandLineCommands
     `rm -rf test/apps/reloader/lib` if File.exist?('test/apps/reloader/lib')
   end
 
-  # move_to_app
-  # Moves to an app directory,
-  # @app_name: String,
-  def move_to_app(app_name = "")
-    @original_dir = Dir.pwd
-    Dir.chdir "test"
-    Dir.chdir "apps"
-    Dir.chdir directory
-    Dir.mkdir("apps") unless Dir.exist?("apps")
-    Dir.mkdir("lib") unless Dir.exist?("lib")
-  end
-
-  def leave_app(app_name = "", purge_directorys = [])
-    Dir.chdir @original_dir
-    purge_directorys.each do |dir|
-      `rm -rf test/apps/#{app_name}/#{dir}` if File.exist?('test/apps/#{app_name}/#{dir}')
-    end
-  end
-
   # Moves to the loader directory
   def move_to_loader
     @original_dir = Dir.pwd

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: camping
 version: !ruby/object:Gem::Version
-  version: 3.2.4
+  version: 3.2.5
 platform: ruby
 authors:
 - why the lucky stiff
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-11 00:00:00.000000000 Z
+date: 2024-06-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -321,7 +321,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
+rubygems_version: 3.3.9
 signing_key:
 specification_version: 4
 summary: miniature rails for anyone