程序诞生的那些事儿

先聊聊背景资料档案..

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

除了自家公司给定的每月标准时间外,现场公司也有自己的规定,每天正常上班的工作时间长度,例如通常的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 完事了以后再调用一下检查日程表,实际上在调用这个命令的时候才真正根据你的设定来重新计算时间..

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

发布一个Python小程序:ManHourCalendar的更多相关文章

  1. Day1:第一个python小程序

    Day1:第一个python小程序与开发工具Pycharm 一.Hello World C:\Users\wenxh>python Python 3.6.2 (v3.6.2:5fd33b5, J ...

  2. 【转】我的第一个Python小程序

    原文网址:http://blog.csdn.net/randyqiu/article/details/4484089 人的每个第一次都有点特别的意义,所以下面这个小程序我把他记录下来做个纪念. 因为要 ...

  3. 写一个python小程序

    在windows环境下进行操作 window+R 输入cmd  创建一个文件夹 mkdir pytxt 创建一个py文件 py.py  用notepad或者记事本等工具进行编辑 或 首先声明pytho ...

  4. 我的第一个Python小程序

    猜年龄,如果大了提示小点,如果小了,提示大点 涉及的知识点: 1.变量 2.注释 3.接收交互式的输入 4.类型转换 5.while循环 6.if..elif..else多条件分支语句 # Autho ...

  5. 怎么样通过编写Python小程序来统计测试脚本的关键字

    怎么样通过编写Python小程序来统计测试脚本的关键字 通常自动化测试项目到了一定的程序,编写的测试代码自然就会很多,如果很早已经编写的测试脚本现在某些基础函数.业务函数需要修改,那么势必要找出那些引 ...

  6. Python 小程序,对文件操作及其它

    以下是自己写的几个对文件操作的小程序,里面涉及到文件操作,列表(集合,字典)的运用等.比方说,从文件里读取一行数据.分别存放于列表中,再对列表进行操作.如去掉里面的反复项.排序等操作. 常见对文件里行 ...

  7. 手把手教你写一个RN小程序!

    时间过得真快,眨眼已经快3年了! 1.我的第一个App 还记得我14年初写的第一个iOS小程序,当时是给别人写的一个单机的相册,也是我开发的第一个完整的app,虽然功能挺少,但是耐不住心中的激动啊,现 ...

  8. 使用PyQt来编写第一个Python GUI程序

    原文:使用PyQt来编写第一个Python GUI程序 本文由 伯乐在线 - Lane 翻译,Daetalus 校稿.未经许可,禁止转载!英文出处:pythonforengineers.com.欢迎加 ...

  9. 如何快速地开发一个微信小程序

    如何快速地开发一个微信小程序呢?我觉得作为初学者,最好能有一个模板,然后改这个模板. 同样作为初学者,刚开始的时候我有下面的几个问题,后来通过问同学,我弄清楚了. 微信小程序可以连接MySQL或者Sq ...

随机推荐

  1. Modular javascript(javascript模块化编程)

    <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/ ...

  2. There are two sorted arrays nums1 and nums2 of size m and n respectively. Find the median of the two sorted arrays. The overall run time complexity should be O(log (m+n)).

    解题思路:合并两个数组,创建一个 Map对象,用以存放排好顺序的键值对,键为序号,值为数组值,中位数的结果分两种情况讨论: 1.m+n为奇数:(m+n)/2为中位数 2.m+n为偶数:(((m+n)/ ...

  3. JavaScript数组遍历(迭代)方法 8种

    最近工作中经常涉及到数据的处理,数组尤其常见,经常需要对其进行遍历.转换操作,网上的文章零零散散,不得已自己又找出红宝书来翻出来看,顺便记一笔,便于以后查询. 数组常用的方法 ECMAScript5为 ...

  4. RabbitMQ --- Work Queues(工作队列)

    目录 RabbitMQ --- Hello Mr.Tua 前言 Work Queues 即工作队列,它表示一个 Producer 对应多个 Consumer,包括两种分发模式:轮循分发(Round-r ...

  5. 优化hexo访问速度-将hexo部署到云主机VPS

    写在开始 一开始将自己hexo部署到github,结果发现打开页面速度有点慢,然后又将其同时部署到coding,实现双线路访问,国内解析记录到coding,国外解析到github,这样确实网站的速度能 ...

  6. HDU 2094解题报告

    刚学完set,准备做个简单题目实践一下.结果半天都WA. 下面指出WA原因. 方法是这样的,把所有输的赢的都插入a1,输的插入a2: 那么如果最后name1-name2=1,则说明只有他没输过,能判断 ...

  7. java类的继承,多态,抽象类与接口

    知识点梳理:     1,怎样定义自己的类. MyStarFrame,MyStarPanel 类中定义: (1)属性(数据),变量. (2)方法(函数),行为. (3)构造方法(特征,作用,何时被调用 ...

  8. CSS3基础(3)——CSS3 布局属性全接触

    一. 弹性盒模型 1.弹性盒子模型介绍 弹性盒模型(Flexible Box或Flexbox)是一个CSS3新增布局模块,官方称为CSS Flexible Box Layout Module,用于实现 ...

  9. mysql日期函数 当前日期 curdate() , 当前年 year(curdate()), 取date的年份 year(date) ,取date的月份 month(date)

    获取系统当前日期时间: sysdate() 获取系统当前日期:curdate() 获取系统当前时间:curtime() 获取给定日期的年份: year(date) 获取给定日期的月份:month(da ...

  10. Attribute(特性)与AOP

    提到特性,好多人都会疑惑特性(attribute),和注释有什么区别,简单来说,特性是给机器看的,而注释是给人看的. 特性不仅可以影响编译还可以影响运行,而注释只是为了让人更加容易理解.看懂代码而特别 ...