Initial commit

Author: monouno

.gitignore

@@ -0,0 +1,22 @@
+*.egg-info
+dist/
+build/
+docs/build
+docs/source/.doctrees/
+__pycache__/
+.cache
+*.sqlite3
+.tox/
+*.swp
+*.pyc
+.coverage*
+.pytest_cache
+node_modules
+venv/
+
+# IDE and Tooling files
+.idea/*
+*~
+
+# macOS
+.DS_Store

.travis.yml

@@ -0,0 +1,27 @@
+language: python
+cache: pip
+sudo: required
+matrix:
+  fast_finish: true
+  include:
+    - { python: "3.6", env: DJANGO=2.0 }
+    - { python: "3.6", env: DJANGO=2.1 }
+    - { python: "3.7", env: DJANGO=2.0 }
+    - { python: "3.7", env: DJANGO=2.1 }
+    - { python: "3.7", env: TOXENV=lint }
+    - { python: "3.7", env: TOXENV=docs }
+  allow_failures:
+    - env: TOXENV=docs
+services:
+  - docker
+install:
+  - pip install '.[dev]' tox-travis
+before_script:
+  - docker-compose -f dev/docker-compose.yml up -d
+script:
+  - tox
+after_success:
+    - pip install codecov
+    - codecov -e TOXENV,DJANGO
+notifications:
+    email: false

CONTRIBUTING.rst

@@ -0,0 +1,48 @@
+Contributing Guidelines
+=======================
+
+Issue tracker
+-------------
+您可以通过 `issue tracker <https://github.com/chaitin/django-pg-timepart/issue>`_ 提交改进建议、缺陷报告或功能需求，但 **必须** 遵守以下规范：
+
+* **请勿** 重复提交相似的主题或内容。
+* **请勿** 讨论任何与本项目无关的内容。
+* 我们非常欢迎您提交程序缺陷报告，但在此之前，请确保您已经完整阅读过相关文档，并已经做了一些必要的调查，确定错误并非您自身造成的。在您编写程序缺陷报告时，
+  请详细描述您所出现的问题和复现步骤，并附带详细的信息，以便我们能尽快定位问题。
+
+----
+
+You can submit improvement suggestions, bug reports, or feature requests through the `issue tracker <https://github.com/chaitin/django-pg-timepart/issue>`_,
+but you **MUST** adhere to the following specifications:
+
+* **Do not** submit similar topics or content repeatedly.
+* **Do not** discuss any content not related to this project.
+* We welcome you to submit a bug report, but before doing so, please make sure that you have read the documentation in its entirety and
+  have done some necessary investigations to determine that the error is not yours. When you write a bug report, Please describe in detail
+  the problem and recurring steps that you have with detailed information so that we can locate the problem as quickly as possible.
+
+Code guidelines
+---------------
+* 本项目采用 `语义化版本 2.0.0 <https://semver.org/spec/v2.0.0.html>`_
+* 本项目使用了 `flask8` `isort` `black` 等代码静态检查工具。提交的代码 **必须** 通过 `lint` 工具检查。某些特殊情况不符合规范的部分，需要按照检查工具要求的方式具体标记出来。
+* 公开的 API **必须** 使用 Type Hint 并编写 Docstrings，其他部分 **建议** 使用并在必要的地方为代码编写注释，增强代码的可读性。
+* **必须** 限定非 Development 的外部依赖的模块版本为某一个完全兼容的系列。
+
+相关文档:
+
+| `Google Python Style Guide <https://github.com/google/styleguide/blob/gh-pages/pyguide.md>`_
+| `PEP 8 Style Guide for Python Code <https://www.python.org/dev/peps/pep-0008/>`_
+
+----
+
+* This project uses a `Semantic Version 2.0.0 <https://semver.org/spec/v2.0.0.html>`_
+* This project uses a code static check tool such as `flask8` `isort` `black`. The submitted code **MUST** be checked by the `lint` tool.
+  Some special cases that do not meet the specifications need to be specifically marked in the way required by the inspection tool.
+* The public API **MUST** use Type Hint and write Docstrings, other parts **SHOULD** use it and write comments to the code where necessary
+  to enhance the readability of code.
+* External dependencies published with the project **MUST** at least define a fully compatible version family.
+
+Related documents:
+
+| `Google Python Style Guide <https://github.com/google/styleguide/blob/gh-pages/pyguide.md>`_
+| `PEP 8 Style Guide for Python Code <https://www.python.org/dev/peps/pep-0008/>`_

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2019 Chaitin Tech Co., Ltd.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
+DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
+OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.

README.rst

@@ -0,0 +1,39 @@
+django-pg-timepart
+==================
+.. image:: https://img.shields.io/badge/License-MIT-orange.svg?style=flat-square
+   :target: https://raw.githubusercontent.com/chaitin/django-partitioning/master/LICENSE
+.. image:: https://img.shields.io/badge/Django-2.0_2.1-green.svg?style=flat-square&logo=django
+   :target: https://www.djangoproject.com/
+.. image:: https://img.shields.io/badge/PostgreSQL-11-lightgrey.svg?style=flat-square&logo=postgresql
+   :target: https://www.postgresql.org/
+
+一个实现 PostgreSQL 表基于日期进行分区和管理的 Django 扩展。
+它适用于像记录日志、消息或文章等具有时间列的巨型表进行分区管理，定期创建新的分区并归档旧的分区。
+
+----
+
+A Django extension that implements PostgreSQL tables for partitioning and management based on dates.
+It is suitable for partition management of giant tables with time columns like logging, messages or articles,
+periodically creating new partitions and archiving old partitions.
+
+Documentation
+  https://django-pg-timepart.readthedocs.io/en/latest/
+
+Contributing
+------------
+
+如果您有意为本开源项目出一份力，我们十分欢迎！在此之前，请首先阅读我们的 `Contributing Guidelines <https://raw.githubusercontent.com/chaitin/django-partitioning/master/CONTRIBUTING>`__。
+
+----
+
+If you want to contribute to a project and make it better, you help is very welcome!
+Please read through `Contributing Guidelines <https://raw.githubusercontent.com/chaitin/django-pg-timepart/master/CONTRIBUTING>`__.
+
+License
+-------
+
+django-pg-timepart 使用 MIT 开源协议。协议文本请阅读 LICENSE。
+
+----
+
+django-pg-timepart is licensed under the MIT. Please see `LICENSE <https://raw.githubusercontent.com/chaitin/django-pg-timepart/master/LICENSE>`_.

codecov.yml

@@ -0,0 +1,11 @@
+coverage:
+  precision: 2
+  round: down
+  range: "80...100"
+
+  status:
+    project: yes
+    patch: no
+    changes: no
+
+comment: off

dev/docker-compose.yml

@@ -0,0 +1,14 @@
+version: "3"
+services:
+  postgres:
+    image: postgres:11.1-alpine
+    container_name: postgres
+    restart: always
+    volumes:
+      - ./postgres_init.sh:/docker-entrypoint-initdb.d/postgres_init.sh
+    environment:
+      - POSTGRES_DB=test
+      - POSTGRES_USER=test
+      - POSTGRES_PASSWORD=test
+    ports:
+      - "127.0.0.1:5432:5432"

dev/postgres_init.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+
+mkdir /tmp/data1 /tmp/data2
+psql -U test -c "CREATE TABLESPACE data1 LOCATION '/tmp/data1'"
+psql -U test -c "CREATE TABLESPACE data2 LOCATION '/tmp/data2'"

docs/Makefile

@@ -0,0 +1,26 @@
+# Minimal makefile for Sphinx documentation
+
+
+# You can set these variables from the command line.
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+SPHINXPROJ    = django-partitioning
+SOURCEDIR     = source
+BUILDDIR      = _build
+
+
+.PHONY: all
+all:
+	@$(SPHINXBUILD) "$(SOURCEDIR)" "$(BUILDDIR)/"
+
+
+.PHONY: help
+help:
+	@$(SPHINXBUILD) -M help "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+
+
+.PHONY: Makefile
+# Catch-all target: route all unknown targets to Sphinx using the new
+# "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
+%: Makefile
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)