-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
187 additions
and
21 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,37 +1,203 @@ | ||
## Welcome to GitHub Pages | ||
# Django Simplify | ||
|
||
You can use the [editor on GitHub](https://github.com/tushortz/django-simplify/edit/master/docs/index.md) to maintain and preview the content for your website in Markdown files. | ||
## Introduction | ||
|
||
Whenever you commit to this repository, GitHub Pages will run [Jekyll](https://jekyllrb.com/) to rebuild the pages in your site, from the content in your Markdown files. | ||
Django simplify provides Ruby on Rails-like command line functionalities, models and helper functions so you can focus on development and removes the pain of repeating frequent actions. | ||
|
||
### Markdown | ||
## Requirements | ||
|
||
Markdown is a lightweight and easy-to-use syntax for styling your writing. It includes conventions for | ||
* Python `3.6` and above | ||
* Django (tested with 3.1, probably works with any version that supports | ||
Python 3) | ||
|
||
```markdown | ||
Syntax highlighted code block | ||
|
||
# Header 1 | ||
## Header 2 | ||
### Header 3 | ||
## Installation | ||
|
||
- Bulleted | ||
- List | ||
**django-simplify** can be installed via pip. | ||
|
||
1. Numbered | ||
2. List | ||
|
||
**Bold** and _Italic_ and `Code` text | ||
```bash | ||
$ pip install django-simplify | ||
``` | ||
|
||
Then just add `simplify` to your `INSTALLED_APPS`. | ||
|
||
|
||
Below are several example commands you can run. | ||
|
||
```sh | ||
$ python manage.py create_app <app_name> | ||
``` | ||
|
||
## Features | ||
|
||
* timestamp for every model | ||
* alphabetic filter for admin | ||
* model, view, template and url route generator | ||
* automatic import | ||
|
||
|
||
### Helper models | ||
|
||
- simplify.helpers.model_helper.TimeBasedModel | ||
- Provides the `created_at` and `updated_at` fields for timestamp | ||
|
||
- simplify.helpers.model_helper.NamedTimeBasedModel | ||
- Provides the `name`, `created_at` and `updated_at` fields. | ||
|
||
- simplify.helpers.admin_helper.AlphaNumericFilterAdmin | ||
- when subclassed, it allows the items to be filtered alphabetically by either A-Z or 0-9 | ||
- **Note**: for this to work, you must specify values for `alphanumeric_filter` in the model admin. | ||
|
||
|
||
#### Usage | ||
|
||
|
||
```python | ||
# models.py | ||
from simplify.helpers.model_helper import TimeBasedModel, NamedTimeBasedModel | ||
|
||
class MyModel(TimeBasedModel): | ||
extra_fields = .... | ||
``` | ||
|
||
|
||
```python | ||
# admin.py | ||
from simplify.helpers.admin_helper import AlphaNumericFilterAdmin | ||
|
||
class MemberAdmin(AlphaNumericFilterAdmin): | ||
alphanumeric_filter = ["first_name", "last_name", 'age'] # this part is what creates the filter | ||
list_filter = ['age'] | ||
list_display = ['first_name', 'last_name',] | ||
``` | ||
|
||
|
||
### Management commands | ||
|
||
**1. create_app** | ||
|
||
- automatically adds a `urls.py` file after app is created. | ||
- adds newly created app in the settings.py file under `INSTALLED_APPS` | ||
- creates `index`, `edit`, `create` and `detail` view and respective templates | ||
- adds the app route to your project's `urls.py` file | ||
|
||
|
||
#### Usage | ||
|
||
```bash | ||
$ python manage.py create_app <app_name> | ||
``` | ||
|
||
**2. create_model** | ||
|
||
Creates a model and their respective fields. the following types maps to respective Django model fields. It will also add the app to the django admin too. | ||
|
||
|
||
- 121, o2o or set -> OneToOneField | ||
- bool -> BooleanField | ||
- date -> DateField | ||
- datetime or dt -> DateTimeField | ||
- dict or m2m -> ManyToManyField | ||
- email -> EmailField | ||
- file -> FileField | ||
- list or fk -> ForeignKey | ||
- float -> FloatField | ||
- dec -> DecimalField | ||
- img or image -> ImageField | ||
- int -> IntegerField | ||
- str or char -> CharField | ||
- txt or text -> TextField | ||
|
||
|
||
#### Usage | ||
|
||
```bash | ||
$ python manage.py create_app <app_name> <model_name> field_name:type field_name:type ... | ||
``` | ||
|
||
#### an example | ||
|
||
```bash | ||
$ python manage.py create_app member Member first_name:text last_name:text age:int | ||
``` | ||
|
||
will generate the following code in the `member/models.py` file | ||
|
||
```python | ||
|
||
class Member(TimeBasedModel): | ||
first_name = models.CharField(max_length=50) | ||
last_name = models.CharField(max_length=50) | ||
age = models.IntegerField(default=0) | ||
|
||
def __str__(self): | ||
return self.first_name | ||
``` | ||
|
||
> **note** The command uses the first specified field as the `__str__` default. | ||
|
||
### Specifying relationships | ||
|
||
|
||
Specifying `ForeignKey`, `OneToOneField` or `ManyToManyField` is quite easy. just add an `=<related_model>`. See example | ||
|
||
```bash | ||
$ python manage.py create_app <app_name> <model_name> field_name:type=related_model | ||
``` | ||
|
||
if the related model is in the same models.py file, specify it as app_name.Model | ||
|
||
[Link](url) and ![Image](src) | ||
```sh | ||
$ python manage.py create_app author Author name:char books:fk=Book # or | ||
$ python manage.py create_app author Author name:char books:fk=author.Book | ||
``` | ||
|
||
For more details see [GitHub Flavored Markdown](https://guides.github.com/features/mastering-markdown/). | ||
if in a different app. (say book model), obviously you should be able to substitute fk with m2m, o2o, 121 | ||
|
||
```sh | ||
$ python manage.py create_app author Author name:char books:fk=book.Book | ||
``` | ||
|
||
will create the following | ||
|
||
```bash | ||
class Author(TimeBasedModel): | ||
name = models.CharField(max_length=50) | ||
books = models.ForeignKey('book.Book', on_delete=models.CASCADE) | ||
|
||
def __str__(self): | ||
return self.name | ||
``` | ||
|
||
|
||
**3. create_view** | ||
|
||
Creates a view, generate its respective template and adds the path in the urls.py file | ||
|
||
### Usage | ||
|
||
```bash | ||
$ python manage.py create_view <app_name> <view_name> | ||
``` | ||
|
||
#### example | ||
|
||
```bash | ||
$ python manage.py create_view member MemberDetail | ||
``` | ||
|
||
|
||
## Todo | ||
|
||
- add more helper functions | ||
- add documentation | ||
|
||
|
||
### Jekyll Themes | ||
> **Note**: This is still in early development mode. might have bugs. It works fine if you write good code and follow the django style of development. Please fork the project to make contributions | ||
Your Pages site will use the layout and styles from the Jekyll theme you have selected in your [repository settings](https://github.com/tushortz/django-simplify/settings/pages). The name of this theme is saved in the Jekyll `_config.yml` configuration file. | ||
|
||
### Support or Contact | ||
## Acknowledgements | ||
|
||
Having trouble with Pages? Check out our [documentation](https://docs.github.com/categories/github-pages-basics/) or [contact support](https://support.github.com/contact) and we’ll help you sort it out. | ||
I'd like to say a big thank you to God without which this wouldn't be possible. I would also like to say thanks to everyone who has and will contribute to this in the future. |