发布一个Python小程序：ManHourCalendar

程序诞生的那些事儿

先聊聊背景资料档案..

大约两年前，我只身前往岛国赚点外快。在那边的派遣制度工作中，存在一个大约叫每月的标准工作时间的概念，按照自家公司跟派遣目标公司（业界称为现场）的合同，规定了这个每月必须达到的总工作时间总数，然后按这个时间计算加班、结算工资。

除了自家公司给定的每月标准时间外，现场公司也有自己的规定，每天正常上班的工作时间长度，例如通常的7.5到8个小时，还可能存在一些现场规定的每天最多加班时长，又或者是自己可以接受的加班时间等等。

但是，每个自然月的休息天数、上班天数以及法定节假日并不固定，还有可能发生临时请假休息或加班的情况，所以每天的实际上班时间并不总是现场公司的额定上班时间或月标准工作时间的平均数。

以往为了维持总工作时间满足公司给定的月标准时间，每个月都得手动计算一次这个月的上班天数，以及平均每天上多少小时，加班多少小时，如果发生临时请假的情况，还得重新分配后面工作天的时间数，长期下来是有点烦心的事，因此萌生了自动化计算上班时间编排表的念头，也正是这次发布的程序的主要工作目标。

* 关于岛国赚外快的故事，有兴趣的同学可以参考这里：2015年，我从国内二线城市来到日本东京工作生活

吐槽一下这个项目

此前一段较长的时间，一直使用的语言都是JAVA，这次发布的程序是我第一次使用刚自学过来的Python写的第一个实践性项目，可以肯定的是存在很多不足甚至是JAVA的影子。

从git记录上看，到目前断断续续开发了差不多俩礼拜时间，其实真正写计算逻辑的时间大概不过2、3天，剩下的时间都在调整可恶的CLI界面上字符拼凑的伪GUI，和研究混乱的程序发布方式，虽然不断的了解了很多边边角角的资料，但是不得不说，耗了太多心力，中途几次有点不想继续弄下去，不想发布，不想写发布帖子的想法。

这次发布了以后会不会继续优化维护不好说，嘛，有bug再改吧，大概我自己都会用用的..

正儿八经的聊发布

重要的事情再提一次，这个程序为了便 捷(省事儿)，采用命令行方式运行，界面也是用字符拼凑的伪GUI，大概是个日历的样子，希望能看得出来（占的面积有点大..）

同样为了方(tou)便(lan)，没有采用数据库，而是用简单的文件把数据序列化出来了，这部分在GitHub上有提及。

按照历史传统，程序发布到Pypi上，用pip install ManHourCalendar就可以装上，但因为用的是Python3写的，没有特意去兼容2代目，装了多个python版本的同学要留意一下有没有需要改用pip3了。

关于这个程序的使用教程，GitHub上已经写的还算清楚的了，英语不好的同学们（或者嫌弃我英语不好的同学们）也可以看看中文版本，源码什么的都一股脑的丢上去了，注释可能写的没有太多，尤其算法部分，悠着点...

需要注意一点的是，这个东西默认是为岛国小朋友们开发的，所以嵌入了岛国公休日...

运行界面上的一些名词解释：

[ 15 ] 今天嘛，是个好日子，用括号提示一下

Holiday 这天岛国小朋友放羊状态，本来想直接写日文节日名字的，但是可耻的岛国汉字字长不好对称...

Schedule 这个是根据根据你设定的Job信息以及当月工作日程表，计算出的一个每天理想工作时间安排，一般是按平均分配的，如果平均时间不能按照最小的编排精度均分（例如按半个小时或15分钟为单位进行计算），则安排靠前面的日子尽量多干些活，后面的日子可以安逸一点

Overtime OT，加班时间嘛，还没checkin的工作天这个数字按Schedule时间计算，checkin过的日子就按实际checkin的时间来算

Dayoff 今天是不是休息不干活了？

Done 今天的活干完了，checkin完以后这一天就自动done掉了，代码里面用的单词是past，原谅我的飘忽不定...

Today: xxx 显示今天的日期，预计的工作时间，实际的checkin时间

Expecting: xxx 这个月的目标指数，要求的工作时长、工作天数，还有月薪

For Now: xxx 目前为止的完成指标，总共的checkin时间、剩下的工作时长、已加班的总数（这个是指过去那些日子超出正常上班时间的部分），还有目前进了口袋的应得薪酬（进没进口袋问老板）

使用方法

篇幅问题（凑字数），现在严肃的谈一谈使用方法。

pip install ManHourCalendar安装好后，使用mhcalendar命令来调用程序

mhcalendar -h 显示帮助文档，嗯，纯英文..

mhcalendar -J 月标准时 每天工作时间 时薪 每天最多加班时长 定义一下你的工作指标，4个参数很清楚，换了工作也是用这个更新

mhcalendar -M 2017 9 指定要显示哪个月份的安排表，只能选一个..默认是第一次运行程序时的那个月，这个月完了到下个月还是用这个更新

mhcalendar 上面的指定完了，可以先看一下初步的工作日程安排，可以用参数--pre 编排精度来指定最小的时间计算单位，例如按半小时（0.5）来切分，默认是1小时为单位

mhcalendar -c 7.5 checkin你今天完成的工作时间数，例如是7.5小时，这里有个坑，如果你前面几天还没有checkin，那这个命令checkin的就是你最早还没checkin的那一天（包括周末、节假日），checkin完以后这一天会标记为Done

mhcalendar -p 如果上面的命令你不清楚准备checkin的是哪一天，可以用这个命令来瞄一下

mhcalendar --dayoff -- 9 10 11 -13 要请假的话，用这个命令来指定哪几天不来上班，前面加个减号表示这天不休息了，回来努力工作赚钱，这个命令只能指定那些你还没有checkin的日子，过去的历史是不能更改的

mhcalendar 完事了以后再调用一下检查日程表，实际上在调用这个命令的时候才真正根据你的设定来重新计算时间..

嗯，就这么些东西，祝大家玩的愉快，谢谢围观。