Metadata-Version: 2.1
Name: stark-middlewares
Version: 0.2
Summary: Stark Middlewares
Home-page: UNKNOWN
Author: Stark Digital Media Services Pvt. Ltd.
Author-email: starkengg81@gmail.com
License: UNKNOWN
Keywords: stark,stark-middlewares,middlewares,stark_middlewares
Platform: UNKNOWN
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENCE.txt

# stark_middlewares

#### _Install package_
  ```
  pip install stark_middlewares
  ```

## _Usage_
##### 1. TrimMiddleware
- Add the below lines in settings.
  ```
  MIDDLEWARE += [
    stark_middlewares.middlewares.TrimMiddleware
  ]
  ```
  
##### 2. Maintenance Middleware
- Add the below lines settings.
  ```
  MIDDLEWARE += [
    stark_middlewares.middlewares.MaintenanceModeMiddleware
  ]
  ```
    i. If you want to add the site under maintenance mode set `IS_MAINTENANCE_MODE=True` in settings

    ii. You can whitelist the IP using `MAINTENANCE_IPS=[]` in settings

    iii. You can able to check the invalid IP using `SHOW_MAINTANCE_INVALID_IP=True` in settings.

##### 3. Rolewise Permission
- Add the below lines to add REST API Permission middleware
  ```
  MIDDLEWARE += [
    stark_middlewares.middlewares.UserRolePermission
  ]
    ```
  >> DEFAULT ALLOWED_METHOD_PERMISSIONS:
    ALLOWED_METHOD_PERMISSIONS = {
        "list": "view_",
        "retrieve": "view_",
        "create": "add_",
        "partial_update": "change_",
        "delete": "delete_",
        "change_status": "change_",
        "bulk_delete": "add_",
    }

    If you want to add more permission you can just add ALLOWED_METHOD_PERMISSIONS in settings.
        e.g. `ALLOWED_METHOD_PERMISSIONS = {
            'get_list': 'add_'
        }`

    >> If you want to check the permission error then add SHOW_PERMISSION_ERROR=True in settings.

## License

MIT

**Stark Digital Media Services**

