Giter Site home page Giter Site logo

doozer's Introduction

What is Doozer?

Project Inspiration

  • Doozer was initially a project I started working on for Google App Engine. It was eventually abandoned since GAE lacked (at the time and may still) proper support for migrations. I ported some of the code to Ruby mainly to learn the internals of Rack back in December 2008.

  • Rails conventions and methodologies (mostly the application structure, configuration, nomenclature, scripts, and a few viewhelper methods).

  • Clustering ala Mongrel::Cluster

Requirements

  • Ruby < 1.9 (untested on Ruby 1.9 as of now)

  • Rack (rack.rubyforge.org) gem (0.9.1, 1.0.0, or 1.0.1)

  • Any http server supported by Rack out of the box (CGI, FastCGI, Mongrel, EventedMongrel, SwiftipliedMongrel, WEBrick, LSWS, SCGI, or Thin)

  • ActiveRecord, DataMapper, or Sequel (only if you need DB support)

Gems

  • As of version >= 0.2.0, the doozer gem is now distributed via gemcutter.

  • The project homepage is here: gemcutter.org/gems/doozer

Getting Started

  1. Install the gem(s):

- gem sources -a gemcutter.org (if you haven’t already) - sudo gem install rack - sudo gem install doozer

  1. Run ‘doozer test-app’ to generate the base application skeleton.

  2. Fire up the application in development mode

- cd test-app - script/cluster -C start

  1. Navigate to localhost:9292

Configuration

  • Doozer is configurable to use an ORM library of your choosing: ActiveRecord, DataMapper, or Sequel.

  • By default, routes are handled by Doozer controllers or you can define other Rack compatible applications which handle specific request paths.

  • Http server of your liking (Mongrel, Thin, Lighttpd, or anything supported by Rack).

  • Multiple appservers.

  • Static directories.

Useful Scripts

  • Generate an application skeleton. Run ‘doozer test-app’ (see Getting Started).

  • Generate views, controllers, and models (depending on the configured ORM). Run ‘doozer generate -h’ for more info.

  • start/stop/restart your web server(s). Run ‘script/cluster -h’ for more info.

  • Migrations up or down. ‘script/migrate -h’.

  • Tasks. Run ‘script/task -h’ for more info

  • There is a rudimentary test command which allows you to run your own test suite for your application. Run ‘script/test -h’ for more info.

Current limitations:

  • Doozer has no test suite. Tsk-tsk I know. In the works.

  • Right now, it doesn’t keep track of migration versions.

  • Magic routes are turned off. Still debating adding them back.

  • Not all the documentation is in place.

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don’t break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.

Copyright © 2009 Greg Melton. See LICENSE for details.

doozer's People

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.