Giter VIP home page Giter VIP logo

freckle-command's Introduction

freck

A friendly command-line interface for Freckle

freck is a command-line tool that makes it easy to enter data to Freckle.

The first time you run it, freck will prompt you for your account details and current project. Then logging your time is as easy as:

freck 2h

or

freck 6h "debugging the frobnicator"

You can add tags as well:

freck "2 days" refactoring spifflication "refactoring the spifflication engine"

As usual with Freckle, an argument that is two words or fewer is treated as a tag, and longer arguments are treated as description.

If you work on more than one project concurrently, you can specify the project name using the -p option. You can even create new projects right from the command line using -c, which tells freck to create the named project if it doesn’t already exist.

If your project has standard tags that need to be applied to most of your tasks, you can specify a default set of tags that will be included unless overridden with the -t option.

Installation

freck has no library dependencies. It requires only Python 2.6 or later, present by default on current Linux and Mac distributions. Installation is as simple as downloading the script to your bin directory and marking it executable, e.g.

curl -Lo ~/bin/freck https://github.com/robinhouston/freckle-command/raw/master/freck
chmod 755 ~/bin/freck

Usage

Options:
  -h, --help            show this help message and exit
  --version             print version number and exit
  -l, --list-projects   list all available projects
  -L, --list-tags       list all available tags
  -t TAGS, --tags=TAGS  additional tags, overriding the default if any
  -d DATE, --date=DATE  the date this task was done, if not today: yyyy-mm-dd
  -u USER, --user=USER  email address of user to record time for, if not you
  -p PROJECT, --project=PROJECT
                        the name of the project. If you have specified a
                        default you can miss this out
  -c, --create          create the project if it does not exist
  -v, --verbose         print detailed logging messages
  -s, --silent          print no informational messages

Feedback

Please let me know if you find this useful, or if you have ideas for improvement. My email address is in my GitHub profile.

freckle-command's People

Contributors

bkaney avatar robinhouston avatar ways avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

freckle-command's Issues

Generate autocomplete file?

This is a feature request.

I'd like it to be possible to i.e. run something like:

freck autocomplete projects
freck autocomplete tags

which would download existing projects and tags, and generate an autocomplete file for them. Zsh, bash, I don't care. What ever's easiest.

I'll look into this soon if I get the time, but let me know if you've got a better solution for this.

Unicode error in project list

Hi

Love the script, but got this:

± ./freck -l > projects
Traceback (most recent call last):
File "./freck", line 279, in
Freckle().list_projects()
File "./freck", line 189, in list_projects
print " " + project
UnicodeEncodeError: 'ascii' codec can't encode character u'\xe5' in position 19: ordinal not in range(128)

List tags

Hi

I'd like the possibility for listing tags, like one can list projects.

Partly to avoid creating duplicate, similar tags, and partly for use in #3

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.