Metadata-Version: 2.1
Name: Mconfig
Version: 1.1.5
Summary: .py 配置文件！Python最好用的配置文件！
Home-page: https://github.com/EVA-JianJun/Mconfig
Author: jianjun
Author-email: 910667956@qq.com
Description-Content-Type: text/markdown
License-File: LICENSE

# Mconfig - ModifyConfig

**.py 配置文件！Python最好用的配置文件！**

用完 Mconfig 后，感觉以前用的什么 yaml、ini、toml、json 之类的配置文件格式都是垃圾.

传统的配置文件有这么几个问题：

* 不易修改：导入前就得提前设定好，不能在程序运行中修改配置文件或者修改特别麻烦.
* 读写风险：同时读写配置造成配置混乱或系统异常.
* 差异化大：一种格式对应一个包，导入进来各种花里胡哨的功能，函数一堆，参数一堆，实际能用到的不多.
* 学习成本：学习成本其实也不多，就额外花点时间学下语法格式，看下数据转换存储，再花点时间看看对应包的使用.

`Mconfig` 解决了上面所有的问题，又对功能做了极大的加强！不是说加了很多函数需要你来学习.

**它没有任何函数，没有任何方法，没有任何属性，只有Python语法！**

让你用着爽，什么都不用管，像写Python一样使用配置文件！

## 安装

    pip install Mconfig

## 使用

    import Mconfig
    mc = Mconfig()

只需要两行代码，就可以得到一个使用简便并且功能强大的配置文件对象.

![Mconfig][1]

* **原生语法支持**：Python 语法直接写配置文件，支持 Python 原生所有数据类型，并支持自定义类；
* **高效简易使用**：增、删、改、查，全部通过 Python 语法实现，没有任何的函数方法，优雅自然；
* **双向自动同步**：文件或者内存配置的修改会双向自动同步，自动修改源代码，自动读取文件更新；
* **全局线程安全**：全线程，全对象，随意操作，全局锁数据不丢失，文件错误自动处理；

配置文件默认为 mconfig.py ，如果不存在会在当前目录下新建默认的 mconfig.py 配置文件：

![Mconfig][2]

**设置成其他文件名且配置文件不存在时创建空文件.**

支持 **数字、字符串、布尔、列表、元组、集合、字典、时间、自定义类** 数据类型.

其中自定义类的使用相当于是为配置指定了一个域，不同类型的配置可以写在对应的自定义类里，不同类里的变量名可以重名.

也可以手动为Mconfig指定一个配置文件路径作为参数：

    mc = Mconfig("myconfig.py")

    mc_2 = Mconfig("config/mconfig.py")

## 增删改查

### 增：

    In [1]: mc.new_variable = "i'm a new variable!"

    In [2]: mc.new_variable
    Out[2]: "i'm a new variable!"

### 删：

    In [3]: del mc.M_tuple

    In [4]: del mc.M_num

### 改：

    In [5]: mc.M_bool = False

    In [6]: mc.M_bool
    Out[6]: False

    In [7]: mc.M_bool = True

    In [8]: mc.M_List
    Out[8]: [1, 2, 3]

    In [9]: mc.M_bool = mc.M_List

    In [10]: mc.M_bool
    Out[10]: [1, 2, 3]

### 查：

    In [11]: mc.M_str
    Out[11]: 'Hello Mconfig!'

    In [12]: mc.M_List
    Out[12]: [1, 2, 3]

    In [13]: mc.M_bool
    Out[13]: True

    In [14]: mc.M_dict
    Out[14]: {'a': 1, 'b': 2}

### 对自定义类下的变量操作：

就是多访问了一层，操作和上面一样

    In [15]: mc.M_SomeConfigClass_a.variable_new = "i'm a new class variable!"

    In [16]: del mc.M_SomeConfigClass_a.variable_b

    In [17]: mc.M_SomeConfigClass_a.variable_c = True

    In [18]: mc.M_SomeConfigClass_a.variable_a
    Out[18]: 1

### 修改自定义类 & 增加自定义类
在内存中有如下的自定义类

    class USER_INFO():

        name = "Harry Potter"

        Academy = "Gryffindor"

可以直接修改原配置中的现存类

    In [19]: mc.M_SomeConfigClass_a = USER_INFO

或者可以在配置中新建自定义类 USER_INFO ：

    In [20]: mc.USER_INFO = USER_INFO


**以上的所有操作只要配置信息发生改变都会同步到 mconfig.py 源文件中**

* 用户修改 mconfig.py 后会自动同步所有的 mc 对象.
* 任意的 mc 对象的改变会自动修改 mconfig.py 源文件.

**无论创建了几个 mc 实例，只要 mc 使用的配置文件一致，当任意配置发生改变，所有的 mc 的配置信息会自动进行同步，并同步修改源文件，所有的 mc 对象指向同一个地址.**

## 更新

# V1.1.0

增加一个用户自定义加工变量的功能，有时候用户需要的变量需要从原始变量加工成其他的.

最典型的例子是，配置文件中的代码时面向用户的，给人看的，而给机器看的又是另外一种，所以用户肯定不希望在配置文件中写入机器看的一些不那么美观的代码，所以加了这个功能让 `Mconfig` 从配置文件中读取原配置自动生成需要的机器配置

    In [1]: import Mconfig

    # mc为配置文件对象，save为一个保存对象
    # 把原配置 mc.M_num 乘以 2 保存为一个新的自定义加工对象 save.my_num
    In [2]:def processing_func(mc, save):
       ...:    save.my_num = mc.M_num * 2

    In [3]: mc = Mconfig("intervene_position_config.py", processing_func)

    In [4]: mc.M_num
    Out[4]: 1

    In [5]: mc.my_num
    Out[5]: 2

自动加工是自动完成的，所有的操作都会自动出发自动加工，让所有的配置保持最新，具体需求请自由发挥.

## 注意事项

1. 同一个进程中配置文件不能重名，会被识别为同一个配置文件而出错.

    有如下目录:

        path1/mconfig.py
        path2/mconfig.py

    不可以这样:

        mc_1 = Mconfig("path1/mconfig.py")
        mc_2 = Mconfig("path1/mconfig.py")

    请使用不同的文件名，或者把所有的配置写在同一个配置文件下

2. 不支持嵌套自定义类，就是不能出现类中类，这只是个配置文件，请保持优雅.

    请不要这样写:

        class A():
            class B():
                pass

3. 全局进程锁现在还不支持，因为考虑到使用的情况也不多，且如果增加此功能可能需要调度端口，或者增加一个包的依赖.

## 使用包

yapf 0.31.0 https://pypi.org/project/yapf/ (不需要安装，已经集成)

## TODO

* 进程锁支持
* 分布式配置文件


  [1]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/Mconfig_0.png
  [2]: https://raw.githubusercontent.com/EVA-JianJun/GitPigBed/master/blog_files/img/Mconfig_2.png
