Giter VIP home page Giter VIP logo

timestrap's Introduction

Timestrap

Build Status Coverage Status

Time tracking and invoicing you can host anywhere. Full export support in multiple formats and easily extensible.

WARNING: This app is currently very unstable as I have just started coding it. Everything may, and probably will, change.

Hello HN: Thank you for the very useful feedback during the first Show HN of Timestrap. I have/will read all the comments and take suggestions seriously for the development of Timestrap.

Quickstart

Want to get up and running quickly?

Deploy

We create a default username and password with superuser access to get you started, please change it via the admin panel:

  • Username: admin
  • Password: changeme123

Example Website

I've setup an instance on Heroku of Timestrap that resets every 10 minutes if you want to play with it. The username and password are set to the same as the Quickstart ones. If someone messes up the fun for everyone wait till the next reset or set the project up yourself.

Installation

Your system needs to have Python with virtualenv and pip installed. If you are using Ubuntu you also need to install build-essential and on Mac Xcode. If you do not want to use postgres or have a problem building because of psycopg2 remove that from your requirements.txt before pip install. In some cases you may also need to install python-dev on Ubuntu.

virtualenv .venv
source .venv/bin/activate
pip install -r requirements.txt

Testing

I'm trying to push for 100% code coverage on this project! If you want to add or change something and test that everything still works you can do so easily with:

python manage.py test

If you push code to our primary repository we test for style adherance and code coverage. If you get a failed build to either of these we won't accept your code till it's fixed.

Running Timestrap

Always make sure you are in the virtual environment before running additional commands by first running source .venv/bin/activate. If you have already done this from the previous step and have not left the environment continue on!

If you have not yet migrated your database do so by running:

python manage.py migrate

You'll need to create your first user too:

python manage.py createsuperuser

After this you can run Timestrap and access it from your browser at localhost:8000.

python manage.py runserver

Generate Fake Data

Want to see how Timestrap would look after being used a while? Run fake to generate some data. Don't run this on a production database or you'll have to do a lot of clean up.

python manage.py fake

Screenshots

Entries Dashboard

timestrap's People

Contributors

overshard avatar

Watchers

James Cloos avatar

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.