Metadata-Version: 2.1
Name: django-nacos-microservice
Version: 1.0.0
Summary: A Django tool is designed to simplify the usage of Nacos in a microservices system.
Home-page: https://github.com/lcoolcool/django-nacos-microservice
Author: lcoolcool
Author-email: shuaishuai_zhai@163.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: django>=2.2.0
Requires-Dist: nacos-sdk-python==1.0.0

# django-nacos-microservice

A Django tool is designed to simplify the usage of Nacos in a microservices system architecture.

Nacos OpenAPI see: https://nacos.io/docs/latest/guide/user/open-api/

[![Pypi Version](https://badge.fury.io/py/django-nacos-microservice.svg)](https://badge.fury.io/py/django-nacos-microservice)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/lcoolcool/django-nacos-microservice/blob/main/LICENSE)

### **Supported Nacos version:**

Nacos 0.8.0+ 
Nacos 1.x 
Nacos 2.x with http protocol

### **Supported Django version:**

Django 2.2+

### **Installation**

```shell
pip install django-nacos-microservice
```
## Unified Configuration Management
#### **Getting Started**

```python
# django project settings.py

# Get it through django-nacos-microservice
NACOS_SERVER_ADDRESSES = 'server addresses split by comma'
NACOS_SERVER_NAMESPACE = 'namespace id'
NACOS_SERVER_USERNAME = 'username'
NACOS_SERVER_PASSWORD = 'password'
NACOS_SERVER_GROUP = 'group id' # default group is DEFAULT_GROUP
CONFIG_SERVER_DATA_ID = "data id"

from django_microservice_nacos.nacos import get_config
config = get_config()  # return Dict
print(config)

# Example
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': config.get('DATABASES_NAME'),
        'USER': config.get('DATABASES_USER'),
        'PASSWORD': config.get('DATABASES_PASSWORD'),
        'HOST': config.get('DATABASES_HOST')
    }
}
```

#### **In Django projects, use a more elegant configuration method.**

* Step 1: Update the `settings.py` file.
    ```python
    # django project settings.py
    # Get it through django-nacos-microservice
    NACOS_SERVER_ADDRESSES = 'server addresses split by comma'
    NACOS_SERVER_NAMESPACE = 'namespace id'
    NACOS_SERVER_USERNAME = 'username'
    NACOS_SERVER_PASSWORD = 'password'
    CONFIG_SERVER_DATA_ID = "data id"
    
    from .env import env
    
    # Example
    DATABASES = {
        'default': {
            'ENGINE': 'django.db.backends.mysql',
            'NAME': env('DATABASES_NAME'),
            'USER': env('DATABASES_USER'),
            'PASSWORD': env('DATABASES_PASSWORD'),
            'HOST': env('DATABASES_HOST')
        }
    }
    ```
* Step 2: Create a file named `env.py` in the project, in the same directory as `settings.py`, and put the following content in the file.
    ```python
    from django_microservice_nacos.nacos import get_config
    from .env_default import DEFAULT_SETTINGS
   
    NACOS_SETTINGS = get_config()
    
    
    def env(key: str):
        return NACOS_SETTINGS.get(key) or DEFAULT_SETTINGS.get(key)
    ```

* Step 3: Create a file named `env_default.py` in the project as the default settings, in the same directory as `env.py`, and put the following content in the file.
    ```python
    # if not django-nacos-microservice config, use default settings
    DEFAULT_SETTINGS = {
        'DATABASES_NAME': 'db_name',
        'DATABASES_USER': 'db_user',
        'DATABASES_PASSWORD': 'db_password',
        'DATABASES_HOST': 'db_host',
        # ...
    }
    ```
## **Service Liveness Probe Http Url**
**Note**:This method is the same as the regular Django path, and may block and wait when serving high concurrency.
#### **Beat Check**
* Step 1: Update the `urls.py` file in the project.
    ```python
    from django.urls import path, include
  
  
    urlpatterns = [
        # ...
        # add the path
        path('check/', include('django_nacos_microservice.urls')),
        # ...
    ]
    ```
* Step 2: Run django server, test beat check.
    ```bash
    curl -X GET http://127.0.0.1:8000/check/beat/
    ```
    Liveness Response: http status code 200
