Download the PHP package webhubworks/overtimely without Composer

On this page you can find all versions of the php package webhubworks/overtimely. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of webhubworks/overtimely

Informations about the package overtimely

overtimely

A simple CLI tool that interacts with the Timely API to fetch the relevant data and calculate your overtime balance from it.

Built with Laravel Zero.

Requirements

Installation

This app is bundled into a standalone PHAR you can download via composer:

Confirm installation:

Setup

Your Timely accounts admin needs to configure a new OAuth2 application with an OOB redirect URI.\ You'll need the following from them to use this tool:

Once you've received these details, run the following command and follow the instructions:

Usage

Run overtimely to get a list of the available commands and use the --help option with a command to see its description, arguments and options.

Date Formats

Any and all date inputs accept all formats supported by PHP. This enables even relative formats like for example "last friday" to be used as option values and default settings.

Fetching Modes

Throughout the app you will find it referencing fetching modes.

The app features two different modes for fetching your logged hours from Timely's API, those being:

Totals

Fetches Timely's reports, which directly include the total duration of logged hours for a given period. Aggregated by Timely based on time entry durations.

Events

Fetches individual events (aka time entries with their individual timestamps) for a given period and merges overlapping timestamps.\ This takes much longer. But it solves the issue of parallel timestamps counting fully towards the total working time.

[!NOTE] In essence:\ Two parallel timestamps of one hour will result in the Totals mode counting two hours, while the Events mode will only count one hour of working time. Use whichever mode is applicable to your situation.

Development

Local development

To run the app locally, you have to prefix it with PHP while in the project directory:

You can use an .env file to set/override the user configuration values which are set by the config:setup and config:set commands. Have a look at the .env.example file to see the available environment variables.

Releasing a build

This app is distributed as a PHAR, so you need to make a new build including your changes to actually release them.

To facilitate this, the project has a Makefile. So after you have committed all of your changes (remember to update the changelog as well!), you can run the following:

This will build, commit, tag and push a new PHAR all in one go.

For deciding on the correct build_version to use: This project adheres to Semantic Versioning.

All versions of overtimely with dependencies

PHP Build Version
Package Version
Requires php Version ^8.5
ext-intl Version *
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package webhubworks/overtimely contains the following files

Loading the files please wait ...