程序诞生的那些事儿

先聊聊背景资料档案..

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

除了自家公司给定的每月标准时间外,现场公司也有自己的规定,每天正常上班的工作时间长度,例如通常的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. Jenkins: 配置信息变更历史

    像 Jenkins 这样的系统,使用的过程就是配置文件变更的过程.如果能够对配置文件的变更进行跟踪管理,将极大的提高系统的可用性.Job Configuration History 插件就是这么一款实 ...

  2. CentOS 6.5安装JDK、Tomcat、Mysql

    安装JDK 1.下载JDK7 下载jdk-7u79-linux-x64.tar.gz 百度网盘下载地址:https://pan.baidu.com/s/1c1JZo2k 在Linux上新建/usr/j ...

  3. webgl自学笔记——矩阵变换

    这章主要探讨矩阵,这些矩阵代表了应用在我们场景上的变换,允许我们移动物体.然而在webGL api中并没有一个专门的camera对象,只有矩阵.好消息是使用矩阵来取代相机对象能让webgl在很多复杂动 ...

  4. SVProgressHUD源码解读(2.0.3)

    SVProgressHUD是iOS开发中比较常用的一个三方库,用来在执行耗时操作或者指示用户操作结果的场合,由于使用简单,功能丰富,交互友好,被广泛应用.本文从源码的角度,解读一下实现的过程,希望能起 ...

  5. 在Android中使用枚举注解而不是枚举

    Enums often require more than twice as much memory as static constants. You should strictly avoid us ...

  6. UI设计|PS软件操作应用——GIF动图

      前  言 JRedu 在之前的分享中,跟大家主要讲解了PS软件工具的基本操作,对主要的图层.蒙版.通道和滤镜都有一些介绍,希望对大家有所帮助,在介绍这些工具时也提到过GIF,而在本次分享中就跟大家 ...

  7. Linux学习总结(七)—— CentOS软件包管理:脚本安装

    脚本安装就是软件编写者写好一个shell脚本或者java脚本,你只需要输入一些简单的信息便可直接安装.这种安装方式方便简单,类似于Windows下软件的安装方式. 下面以webmin的安装为例讲解脚本 ...

  8. wpf软件某些分辨率下文字模糊解决方法

    软件测试过程中发现在一台1600*900的分辨率电脑上文字模糊,甚至某些个文字出现压缩扭曲 经过实践,发现按下面方法能解决一点问题: 在窗口或控件上设置字体属性就可以了,如下: <UserCon ...

  9. 面试的妹纸问我:web缓存设置不是后台的事情吗?

    背景介绍 团队最近在招前端开发,早上收到一封简历,是个妹纸,从技能点来看还算符合要求,于是约了下午3点过来面试. 整个面试过程持续了大约40分钟,问的题目也比较常规,其中一道题就是"常见的性 ...

  10. 【MD5解密】免费帮大家解MD5

    除睡觉时间外最慢2小时内回复!结合各种国内外免费收费引擎和高效彩虹表,需要解的在评论下方评论即可