pyscheduler

做项目的时候大家都需要的做的一个事情是排计划安排，一般有两种做法：一是用类Microsoft Project的软件，这种软件的优点是功能很强大，缺点是有点重，非文本的，想把它嵌入到比如 markdown 文档里面很难；二是自己用表格的语法直接写在一个 markdown 文件里面。我个人比较喜欢第二种做法，这种做法好处是它是纯文本的，不需要借助任务特殊软件就可以展示。它的缺点是功能比较弱：

• 你如果想要对中间某个任务的时间安排做出调整，那么这个任务后面的所有任务你需要重新排一次。
• 你无法像Microsoft Project软件那样给你展示整个项目总的资源情况。
• 你无法对整个任务安排进行筛选，让它只显示某个人的工作

这个小项目的作用就是为了解决前面提到的几个问题。

Usage

基本用法

scheduler.py [-m <man>] /path/to/work-breakdown-file.markdown

这个软件的输入是一个markdown 文件, 你在这个 markdown 文件里面定义你的项目的任务细分，比如下面这段:

# 项目基本信息
* 项目开始时间: 2014-08-21

# 任务细分
* 任务一 -- 2[James]
* 任务二 -- 1[Lucy]
* 任务三 -- 1[James]
* 任务四 -- 2[Lucy]

上面定义了我们这个项目是从2014-08-21开始做，并且定义了我们这个项目的主要工作安排，那么运行以下命令，我们可以得到如下的自动排期表(如果你的 Terminal 使用的是等宽字体的话，你会发现下面这个表格是工整对齐的):

> ./scheduler.py /tmp/test 
任务   | 责任人 | 所需人日 | 开始时间   | 结束时间   | 进度
------ | ------ | -------- | ---------- | ---------- | ----
任务一 | James  | 2.0      | 2014-08-21 | 2014-08-22 | 0%  
任务二 | Lucy   | 1.0      | 2014-08-21 | 2014-08-21 | 0%  
任务三 | James  | 1.0      | 2014-08-25 | 2014-08-25 | 0%  
任务四 | Lucy   | 2.0      | 2014-08-22 | 2014-08-25 | 0% 

大家也许注意到了，你如果把这段输出保存成一个markdown文件，它其实就形成了一个表格。也就是说你只需要维护上面提到的任务基本信息，利用这个小工具可以自动给你生成排期表。

更新任务进度

当然，随着时间的推移你可以对你的任务的进度进行更新：

# 项目基本信息
* 项目开始时间: 2014-08-21

# 任务细分
* 任务一 -- 2[James]<100%>
* 任务二 -- 1[Lucy]<80%>
* 任务三 -- 1[James]
* 任务四 -- 2[Lucy]

再次运行你会得到这样的表格:

>  ./scheduler.py /tmp/test
任务   | 责任人 | 所需人日 | 开始时间   | 结束时间   | 进度
------ | ------ | -------- | ---------- | ---------- | ----
任务一 | James  | 2.0      | 2014-08-21 | 2014-08-22 | 100%
任务二 | Lucy   | 1.0      | 2014-08-21 | 2014-08-21 | 80% 
任务三 | James  | 1.0      | 2014-08-25 | 2014-08-25 | 0%  
任务四 | Lucy   | 2.0      | 2014-08-22 | 2014-08-25 | 0% 

根据任务负责人对任务进行过滤

如果你想只看看所有分配给James的任务，那么加个参数即可:

> ./scheduler.py -m James /tmp/test
任务   | 责任人 | 所需人日 | 开始时间   | 结束时间   | 进度
------ | ------ | -------- | ---------- | ---------- | ----
任务一 | James  | 2.0      | 2014-08-21 | 2014-08-22 | 100%
任务三 | James  | 1.0      | 2014-08-25 | 2014-08-25 | 0%

有人请假怎么办？

做项目的过程中，人员难免请假，对于已经排好的计划怎么办？ 手工调整？不用，你只需要记录谁在哪天请假就好:

# 项目基本信息
* 项目开始时间: 2014-08-21

# 任务细分
* 任务一 -- 2[James]<100%>
* 任务二 -- 1[Lucy]<80%>
* 任务三 -- 1[James]
* 任务四 -- 2[Lucy]

# 请假情况
* James -- 2014-08-22

再次运行相同命令， 我们会得到如下排期:

> ./scheduler.py -m James /tmp/test
任务   | 责任人 | 所需人日 | 开始时间   | 结束时间   | 进度
------ | ------ | -------- | ---------- | ---------- | ----
任务一 | James  | 2.0      | 2014-08-21 | 2014-08-25 | 100%
任务三 | James  | 1.0      | 2014-08-26 | 2014-08-26 | 0%

更多功能？Try it yourself!