LaravelCBV

A package for Laravel implementing Django's Class-Based Views (CBV).

It keeps a 1:1 mapping with Django 2.0 codebase, behavior and naming while using Laravel's native features.

Table of Contents

• Setup
  • PHP
  • Laravel
  • Requirements
• Usage
  • Example
• Development
  • General
  • Code
  • Setup
  • Testing
• Contributing
• Author
• License
• Acknowledgments
  • Inspiration

Setup

PHP

Tested and developed on version: 7.2.*

Laravel

Tested and developed on version: 5.8.*

Requirements

Use Composer to install the requirements needed

composer install

Usage

The class View (which is the base class for the others CBVs) extends Illuminate's Controller.

Any LaravelCBV can be used as a common Laravel controller while inheriting all the very same feature of the corresponding Django's Class-Based Views.

Development

General

All the needed commands are listed as GNU make target rules in the Makefile file.
Each subfolder could contain a local Makefile file, if needed.

Code

The source code is hosted on GitHub.

Setup

Use Composer to install also the requirements for development and testing (Composer's default behavior)

composer install

or use the make rule:

make develop

Testing

Tests are executed using PHPUnit also for coverage.

Orchestral Testbench is used as support for testing the behavior of the package in a Laravel project.

Additional Integration and End-To-End tests can be done using an host Laravel project and local test cases.

Contributing

Pull requests are welcome!

For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Author

Nicola Costantino

License

MIT as listed in LICENSE file
Copyright (c) 2019 Nicola Costantino